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

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

faxstate sends a message to the faxgetty(8) process servicing modem telling it to use the specified state when notifying the 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 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.

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 ``c busy'', ``c down'', and ``c 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.

hylafax-server(5), faxgetty(8)