faxstate - control ``modem state'' of a device used by HylaFAX
/usr/sbin/faxstate [ -q queue-dir ] [ -s state ] [ -n ] modem
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 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)
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.
Consult hylafax-server(5) for a complete discussion of the structure
and content of the spooling area.
July 17, 1995