NAME

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

SYNOPSIS

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

DESCRIPTION

       faxstate  sends a message to the HylaFAX faxgetty(8) process 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(8)
       program.

OPTIONS

       The following options are supported:

       -n        Contact faxq directly instead of faxgetty.

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

       -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-server(5)  for  a complete discussion of the structure and content of the
       spooling area.

SEE ALSO

       hylafax-server(5), faxgetty(8)

                                          July 17, 1995                               FAXSTATE(8)