faxstate.8c man page

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(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, down, or exempt the HylaFAX scheduler will not assign any outbound jobs to the modem. See hylafax-config(5F) under ModemReadyState for a description of the differences between these states.

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:


Contact faxq directly instead of faxgetty.

-q dir

Use a spooling area other than /var/spool/hylafax.

-s state

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.

See Also

hylafax-server(5F), faxgetty(8C)


July 17, 1995