Provided by: hylafax-server_4.2.5-1_i386 bug


       faxrcvd - HylaFAX notification script for received facsimile


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


       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


       This script can route facsimile directly to  the  intended  receipient.
       To  do  this create a shell script etc/FaxDispatch in the spooling area
       that sets SENDTO  to  the  receiver’s  electronic  mail  address.   For

       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
       case "$DEVICE" in
       ttyS1)            SENDTO=john;;         # all faxes received on ttyS1
       ttyLT0)           SENDTO=mary@home;;    # all faxes received on ttyLT0
       case "$CIDNUMBER" in
       435*)        SENDTO=lee; FILETYPE=pdf;; # all faxes from area code 435
       5059627777)  SENDTO=amy; FILETYPE=tif;; # Amy wants faxes in TIFF
       case "$SUBADDR" in
       53)          SENDTO=FaxMaster;;         # without double-notification
       roger)       SENDTO=roger;;             # possible text subaddressing

       Note  that you must match any embedded white space.  The facsimile will
       be sent as a MIME-encoded PostScript document as default.

              is equivalent to the nth call identification parameter

              is equivalent to CALLID2 above.

              is equivalent to CALLID1 above.

       DEVICE is equivalent to device above.

              controls the filetype of the image attachment.  Current filetype
              options are ‘‘ps’’, ‘‘tif’’, and ‘‘pdf’’.

              controls  the  sender  of  the received fax notification.  It is
              given as an e-mail address.

       MSG    is equivalent to error-msg above.

              (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.

              the received subaddress value, communicated by  the  sender  for
              post-reception routing purposes

       Other  shell  variables  are  available.   Consult  the  faxrcvd script


       /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


       faxd(8), hylafax-server(5), recvq(5)

                                 May 28, 2001                       FAXRCVD(8)