The trigger-expression is supplied as an argument to a ``SITE TRIGGER'' command passed to the hfaxd(8) The syntax for this expression is:
where <class> defines a class of events and is one of:
A <mask> is a 4-hex-digit mask of trigger events (see the table below). If ``*'' is specified then all events in the class are matched.
An <id> can be used to restrict matches to a specific job or modem. Eventually this will need to be generalized for job groups.
Thus an example specification that would catch any event for the modem on ttyf2 would be ``M<ttyf2>*'', and to be notified when job 1932 is requeued or completes one would use ``J<1932>4c60''.
The output from faxwatch is ASCII text that describes each event. faxwatch runs until it is interrupted.
Event Class Mask Description JOB_CREATE J 0x0001 job created JOB_SUSPEND J 0x0002 job suspended JOB_READY J 0x0004 job ready to send JOB_SLEEP J 0x0008 job sleeping awaiting time-to-send JOB_DEAD J 0x0010 job marked dead JOB_PROCESS J 0x0020 job processed by scheduler JOB_REAP J 0x0040 job corpus reaped JOB_ACTIVE J 0x0080 job activated JOB_REJECT J 0x0100 job rejected JOB_KILL J 0x0200 job killed JOB_BLOCKED J 0x0400 job blocked by other job JOB_DELAYED J 0x0800 job delayed by tod restriction or similar JOB_ALTERED¹ J 0x1000 job parameters altered JOB_TIMEDOUT J 0x2000 job kill timer expired JOB_PREP_BEGIN J 0x4000 job preparation started JOB_PREP_END J 0x8000 job preparation finished SEND_BEGIN S 0x0001 fax, send attempt started SEND_CALL S 0x0002 fax, call placed SEND_CONNECTED S 0x0004 fax, call answered by fax SEND_PAGE S 0x0008 fax, page transmit done SEND_DOC S 0x0010 fax, document transmit done SEND_POLLRCVD S 0x0020 fax, document retrieved by poll operation SEND_POLLDONE S 0x0040 fax, poll operation completed SEND_END S 0x0080 fax, send attempt finished SEND_REFORMAT S 0x0100 fax, job being reformatted SEND_REQUEUE S 0x0200 fax, job requeued SEND_DONE S 0x0400 fax, send job done RECV_BEGIN R 0x0001 fax, inbound call started RECV_START R 0x0002 fax, session started RECV_PAGE R 0x0004 fax, page receive done RECV_DOC R 0x0008 fax, document receive done RECV_END R 0x0010 fax, inbound call finished MODEM_ASSIGN M 0x0001 modem assigned to job MODEM_RELEASE M 0x0002 modem released by job MODEM_DOWN M 0x0004 modem marked down MODEM_READY M 0x0008 modem marked ready MODEM_BUSY M 0x0010 modem marked busy MODEM_WEDGED M 0x0020 modem considered wedged MODEM_INUSE M 0x0040 modem in use for outbound work MODEM_DATA_BEGIN M 0x0080 inbound data call begun MODEM_DATA_END M 0x0100 inbound data call finished MODEM_VOICE_BEGIN M 0x0200 inbound voice call begun MODEM_VOICE_END M 0x0400 inbound voice call finished MODEM_CID M 0x0800 inbound caller-ID information
¹ Event to be removed soon.