FAXRCVD(8)

NAME
faxrcvd - HylaFAX notification script for received facsimile

SYNOPSIS
/usr/local/spool/hylafax/bin/faxrcvd qfile devid commid error-msg

DESCRIPTION
bin/faxrcvd is the command script invoked by the facsimile server whenever a facsimile is received. The default script sends electronic mail to the FaxMaster user describing the content of the facsimile and other useful information such as the time spent receiving the document. The arguments are:

qfile
    the pathname of the received TIFF file relative to the root of the spooling hierarchy.

devid
    the modem device on which the facsimile was received.

commid
    the communication identifier for the inbound call.

error-msg
    an error message that is non-null if an error was encountered during the receive operation.

NOTES
This script can route facsimile directly to the intended receipient if the sender's identity is well-known. To do this create a shell script etc/FaxDispatch in the spooling area that sets the receiver's electronic mail address according to the sender's TSI. For example,

case "$SENDER" in
*1*510*526*1212*) SENDTO=sam;;          # Sam's test rig in Berkeley
*1*415*390*1212*) SENDTO=raster@asd;;   # 7L Xerox room, used for scanning
*5107811212)      SENDTO=peebles@mti;;  # stuff from home
*)                SENDTO=;;             # don't know who to send it to
esac

Note that you must match any embedded white space and you should direct any facsimile that are not dispatched to a ``null person''. The facsimile will be sent as a MIME-encoded PostScript document; consult the shell script for details.

FILES
/usr/local/spool/hylafax	spooling area
/usr/local/hylafax/sbin/faxinfo	for printing information about the facsimile
${TIFFBIN}/fax2ps	for converting TIFF to PostScript
/usr/lib/sendmail	for delivering mail

SEE ALSO
faxd(8), hylafax(5), recvq(5)