HylaFAX+

NAME

pollrcvd - HylaFAX script for delivering facsimile received by polling

SYNOPSIS

/var/spool/hylafax/bin/pollrcvd mailaddr faxfile devid commid error-msg

DESCRIPTION

bin/pollrcvd is the command script invoked by the HylaFAX server whenever a facsimile is received as a result of a polling operation. It is designed to be customizable by the administrator. (Ideally this is done by creating a customized pollrcvd script in a different filename or by copying the default script to a different filename, customizing that new file, and then using PollRcvdCmd in the modem config file to point faxgetty(8C) at the customized script. See hylafax-config(5F).)

The default script uses electronic mail to deliver the facsimile to the user that submitted the poll request. The arguments are:

mailaddr: the electronic mail address of the user that submitted the poll request.
faxfile: the pathname of the received TIFF file relative to the root of the spooling hierarchy.
commid: The communication identifier associated with the call (used to include a transcript when an error occurs).
devid: the modem device on which the document was received.
error-msg: an error message that is non-null if an error was encountered during the receive operation.

NOTES

The default script delivers facsimile as PostScript wrapped in MIME. This script can be customized for the intended receipient. To do this create a shell script etc/PollDispatch in the spooling area that sets

BCCTO: controls the blind copy recipient of the received fax notification. It is given as an e-mail address.
CCTO: controls the copy recipient of the received fax notification. It is given as an e-mail address.
LANG: controls the localization of the text of the received poll notification.
FILETYPE: controls the filetype of the image attachment. Current filetype options are ``ps'', ``tif'', and ``pdf''. Multiple values may be specified by separating them with whitespace. In that case a separate attachment is created for each filetype.

FILES