FAXSTATE(8C)

NAME
       faxstate  -  control  ``modem  state'' of a device used by
       HylaFAX

SYNOPSIS
       /usr/local/sbin/faxstate [ -q queue-dir ] [ -s state  ]  [
       -n ] modem

DESCRIPTION
       faxstate  sends a message to the HylaFAX faxgetty(8C) pro-
       cess servicing modem telling it to use the specified state
       when notifying the HylaFAX scheduler that a modem is ready
       and available for use.  This  is  useful  for  controlling
       outbound  use  of  a  modem; by marking a modem's state as
       busy or down the HylaFAX scheduler  will  not  assign  any
       outbound jobs to the modem.

       The  specified modem can either be the name (typically the
       last component of the terminal port the modem is  attached
       to),  or  the  full name of the associated FIFO named pipe
       file, e.g. ``FIFO.ttym2''.

       If the -n option, faxstate emulates  what  faxgetty  would
       do; sending a message directly to the faxq process marking
       the specified modem down, busy, or ready.  This  interface
       is  useful  for  send-only  environments in which faxgetty
       processes are not used.  Note that modems  manipulated  in
       this  way  must  previously  have been configured with the
       faxmodem(8C) program.

OPTIONS
       The following options are supported:

       -n        Contact faxq directly instead of faxgetty.

       -q dir    Use a spooling area other than /var/spool/fax.

       -s        Specify the state to send the faxq process  each
                 time  the  modem  becomes  ready for use; one of
                 ``busy'', ``down'', and ``ready''.  The  default
                 state to use is ready.

FILES
       Consult  hylafax(5F)  for  a  complete  discussion  of the
       structure and content of the spooling area.

SEE ALSO
       hylafax(5F) faxgetty(8C)