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


/var/spool/hylafax   spooling area
/usr/sbin/faxinfo    for printing information about the facsimile
/usr/bin/fax2ps      for converting TIFF to PostScript
/usr/sbin/sendmail   for delivering mail
 

SEE ALSO

faxq(8C), hylafax-server(5F), recvq(5F)