faxrcvd(8)
NAME
faxrcvd - HylaFAX notification script for received facsimile
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/sbin/faxinfo for printing information about the facsimile /usr/bin/fax2ps for converting TIFF to PostScript /usr/lib/sendmail for delivering mail /var/spool/hylafax/etc/templates/ base directory for outgoing e-mail templates
SEE ALSO
faxd(8), hylafax-server(5), recvq(5) May 28, 2001 FAXRCVD(8)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
