HOTFD(1M)	     K-Spool by	Xinet (10/14/99	10.1)	     HOTFD(1M)



     NAME    [Toc]    [Back]
	  hotfd	- hot folder daemon

     SYNOPSIS    [Toc]    [Back]
	  /usr/etc/appletalk/hotfd [ -D	| -d dblev ] [ -c configfile ]

     DESCRIPTION    [Toc]    [Back]
	  The hotfd program monitors any hot folders configured	on the
	  system.  When	files appear in	the folders, it	submits	them
	  via the local	printing system	to the appropriate printer.
	  One daemon monitors all of the folders on a single machine.
	  Hot folders are controled by a configuration file, and are
	  usually created with the Xinet GUI.  Hotfd runs as a daemon
	  in the background unless one of the debug options is given.

	  The configuration file consists of a series of text lines
	  specifying the directory to watch, the printer to pass the
	  files	to, and	some options.  The format of each line is:

	       dirpath:printqueue:options
	  where	dirpath	is the full local pathname to the directory,
	  printqueue is	the name of the	printer	queue to which files
	  will be submitted, and options is a colon-separated set of
	  key/value pairs (a la	printcap(5)).  Supported keys are as
	  follows:

	  Key  Type	 What it controls

	  as   boolean	 if OPI-replacment happens, use	ASCII picture format
	  dt   integer	 number	of seconds to wait for files to	stop being
			   modified before submitting them to the print	queue
	  ex   string	 command to use	to process the files (see below)
	  ix   string	 command to use	to process standard input (see below)
	  jp   integer	 send pictures JPEG compressed.	 The value is a	quality
			   factor (1->99).  Setting this overrides the as key.
	  kt   boolean	 retain	PC-style TIFF preview if EPS file has one
	  rp   string	 0 means don't replace,	full (the default) means
			   replace at original resolution, else	this is	the
			   (floating point) DPI	at which to replace pictures

	  If there are no hot folders configured, hotfd	will exit.
	  The GUI will start it	if it creates any hot folders.	Hotfd
	  only reads its configuration file at startup and when	it
	  recieves a HUP signal.

     CUSTOM PROCESSING    [Toc]    [Back]
	  If you do not	want to	pass the files from the	hot folder to
	  the default printing system, you may specify two custom
	  processing commands instead.	Hotfd always passes EPS	and
	  PostScript files through a pipe to Standard Input, and
	  handles all other files by giving the	processing command the
	  full pathname	to the file.  So you must include both an ex



     Page 1					    (printed 1/20/100)






     HOTFD(1M)	     K-Spool by	Xinet (10/14/99	10.1)	     HOTFD(1M)



	  and ix command string	so that	all files can be processed
	  correctly.  When using these commands, the printqueue	field
	  is ignored, but must contain at least	one character.	Keep
	  in mind that OPI-replacement is not performed	by the hotfd
	  program.  It simply primes PostScript	files with the
	  selected replacement options.

	  These	command	strings	are parsed much	like shell commands.
	  Specifically,	the quoting characters ", ' and	\ are
	  interpreted as they would be by the command shell.  After
	  parsing, the string ``$f$'' is replaced by the full pathname
	  to the file being processed (and ``$F$'' is replaced by the
	  last component of the	filename).

	  An example:  if you wanted to	use the	LPR printing system on
	  IRIX instead of the default LP, you could create an entry
	  like the following (note that	all this text must be on one
	  line in the hotfolderconf file, and the line length is
	  limited to 2048 bytes):

	      /bigdisk/submission:*:rp=150:ex=lpr -Pmyprinter $f$:
		 ix=lpr	-P myprinter -J	"bigdisk $F$":dt#20
	  This entry would cause /bigdisk/submission to	be watched
	  and, if a file there has been	untouched for at least 20
	  seconds, it would be handed to the LPR queue myprinter with
	  OPI-replacement set to 150 DPI.  EPS/PostScript jobs would
	  have their Job Name set to ``bigdisk filename''.

     FILES    [Toc]    [Back]
	  /var/adm/appletalk/hotfolderconf
	       Unless overridden by the	-c option, this	file contains
	       the configuration of the	hot folders.

	  /var/adm/appletalk/hotfd_pid
	       Place where hotfd writes	its PID, so it can be HUPped.




















     Page 2					    (printed 1/20/100)