传真(Fax)编程

开发平台：
C/C++

pollrcvd.1m：源码内容
							."	$Id: pollrcvd.1m,v 1.5 2007/12/23 16:16:47 faxguy Exp $
."
." HylaFAX Facsimile Software
."
." Copyright (c) 1993-1996 Sam Leffler
." Copyright (c) 1993-1996 Silicon Graphics, Inc.
." HylaFAX is a trademark of Silicon Graphics
." 
." Permission to use, copy, modify, distribute, and sell this software and 
." its documentation for any purpose is hereby granted without fee, provided
." that (i) the above copyright notices and this permission notice appear in
." all copies of the software and related documentation, and (ii) the names of
." Sam Leffler and Silicon Graphics may not be used in any advertising or
." publicity relating to the software without the specific, prior written
." permission of Sam Leffler and Silicon Graphics.
." 
." THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
." EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
." WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
." 
." IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
." ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
." OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
." WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
." LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
." OF THIS SOFTWARE.
."
.if n .po 0
.ds Fx fIHylas-1FAXs+1fP
.TH POLLRCVD ${MANNUM1_8} "May 12, 1996"
.SH NAME
pollrcvd - *(Fx script for delivering facsimile received by polling
.SH SYNOPSIS
.B ${SPOOL}/bin/pollrcvd
.I mailaddr
.I faxfile
.I devid
.I commid
.I error-msg
.SH DESCRIPTION
.B bin/pollrcvd
is the command script invoked by the *(Fx 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
.B PollRcvdCmd
in the modem config file to point
.IR faxgetty (${MANNUM1_8})
at the customized script.  See
.IR hylafax-config (${MANNUM4_5}).)
.P
The default script uses electronic mail to
deliver the facsimile
to the user that submitted the poll request.
The arguments are:
.TP 10
.B mailaddr
the electronic mail address of the user that submitted the poll request.
.TP
.B faxfile
the pathname of the received 
.SM TIFF
file relative to the root of the spooling hierarchy.
.TP
.B commid
The communication identifier associated with the call (used
to include a transcript when an error occurs).
.TP
.B devid
the modem device on which the document was received.
.TP
.B error-msg
an error message that is non-null if an error was encountered
during the receive operation.
.SH NOTES
The default script delivers facsimile as PostScript wrapped in s-1MIMEs+1.
This script can be customized for the intended receipient.
To do this create a shell script
.B etc/PollDispatch
in the spooling area that sets
.TP
.I BCCTO
controls the blind copy recipient of the received fax notification.  It is
given as an e-mail address.
.TP
.I CCTO
controls the copy recipient of the received fax notification.  It is
given as an e-mail address.
.TP
.I LANG
controls the localization of the text of the received poll notification.
.TP
.I 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.
.SH FILES
.nf
.ta w'${SBIN}/faxinfo    'u
${SPOOL}	spooling area
${SBIN}/faxinfo	for printing information about the facsimile
${TIFFBIN}/fax2ps	for converting s-1TIFFs+1 to PostScript
${SENDMAIL}	for delivering mail
.fi
.SH "SEE ALSO"
.IR faxq (${MANNUM1_8}),
.IR hylafax-server (${MANNUM4_5}),
.IR recvq (${MANNUM4_5})

						