GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FAXRCVD (8)

NAME

faxrcvd - HylaFAX notification script for received facsimile

CONTENTS

Synopsis
Description
Notes
Files

SYNOPSIS

/var/spool/hylafax/bin/faxrcvd qfile devid commid error-msg [ callid-1 [ callid-2 [ ... [ callid-n ] ] ] ]

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.
callid the value of various identification indicators from the call

NOTES

This script can route facsimile directly to the intended recipient. To do this create a shell script etc/FaxDispatch in the spooling area that sets SENDTO to the receiver’s electronic mail address. 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
esac
case "$DEVICE" in
ttyS1)            SENDTO=john;;         # all faxes received on ttyS1
ttyLT0)           SENDTO=mary@home;;    # all faxes received on ttyLT0
esac
case "$CIDNUMBER" in
435*)        SENDTO=lee; FILETYPE=pdf;; # all faxes from area code 435
5059627777)  SENDTO=amy; FILETYPE=tif;; # Amy wants faxes in TIFF
esac
case "$SUBADDR" in
53)          SENDTO=FaxMaster;;         # without double-notification
roger)       SENDTO=roger;;             # possible text subaddressing
esac


Note that you must match any embedded white space. The facsimile will be sent as a MIME-encoded PostScript document as default.
CALLIDn is equivalent to the nth call identification parameter
CIDNAME is equivalent to CALLID2 above.
CIDNUMBER is equivalent to CALLID1 above.
DEVICE is equivalent to device above.
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.
FROMADDR controls the sender of the received fax notification. It is given as an e-mail address.
MSG is equivalent to error-msg above.
NOTIFY_FAXMASTER
  (an underscore ‘‘_’’ character is between NOTIFY and FAXMASTER) indicates whether or not the HylaFAX administrator should be notified regarding incoming facsimile. Default is ‘‘always’’. Also available are ‘‘never’’, which means to never send any received facsimile notification, and ‘‘errors’’, which means to send notification only if there were reception errors.
SENDER is the received TSI of the fax sender.
SENDTO controls the recipient of the received fax notification. It is given as an e-mail address, and it’s value will be passed directly to the MTA for delivery as well as being inserted into the email. If you want to send to multiple receipients in seperate messages set the variable SENDTO1...SENDTOn in addition to SENDTO. faxrcvd will process additional SENDTOn variables starting at 1, and stopping at the first empty SENDTOn variable it finds. The templates should continue to reference $SENDTO, and faxrcvd will make sure it get’s set correctly as the template is processed for each one.
SUBADDR the received subaddress value, communicated by the sender for post-reception routing purposes
TEMPLATE the template subdirectory to use when sending e-mails. HylaFAX ships with a base set of templates, and some direct translations. To use the German translated templates, set TEMPLATE=de in FaxDispatch. This is relative to the base template directory.
Other shell variables are available. Consult the faxrcvd script directly.
 

FILES


/var/spool/hylafax                spooling area
/usr/local/sbin/faxinfo           for printing information about the facsimile
/usr/local/bin/fax2ps             for converting TIFF to PostScript
/usr/sbin/sendmail                for delivering mail
/var/spool/hylafax/etc/templates/ base directory for outgoing e-mail templates

SEE ALSO

faxd(8C), hylafax-server(5F), recvq(5F)
Search for    or go to Top of page |  Section 8 |  Main Index


--> FAXRCVD (8C) May 28, 2001

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.