POLLRCVD(${MANNUM1_8})

NAME
pollrcvd - HylaFAX program for delivering facsimile received by polling

SYNOPSIS
${SPOOL}/bin/pollrcvd mailaddr faxfile devid commid error-msg

DESCRIPTION
bin/pollrcvd is the program 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 program in a different filename or by copying the default program to a different filename, customizing that new file, and then using PollRcvdCmd in the modem config file to point faxgetty(${MANNUM1_8}) at the customized program. See hylafax-config(${MANNUM4_5}).)

The default program 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 program delivers facsimile as PostScript wrapped in MIME. This program 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
${SPOOL}	spooling area
${SBIN}/faxinfo	for printing information about the facsimile
${TIFFBIN}/fax2ps	for converting TIFF to PostScript
${SENDMAIL}	for delivering mail

SEE ALSO
faxq(${MANNUM1_8}), hylafax-server(${MANNUM4_5}), recvq(${MANNUM4_5})