faxstate - control ``modem state'' of a device used by HylaFAX
/usr/local/sbin/faxstate [ -q queue-dir ] [ -s
state ] [ -n ] modem
faxstate sends a message to the HylaFAX faxgetty(8C)
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(8C) program.
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(5F) for a complete discussion of the structure and
content of the spooling area.
hylafax-server(5F), faxgetty(8C)