hotfd(1M)

     NAME
          hotfd - hot folder daemon

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

     DESCRIPTION
          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
          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
          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
          /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.