Handbook:Server Operation:Receiving Faxes

One of the most common customizations that is performed on HylaFAX installations is that of changing faxrcvd from the default. This is to be considered normal. Each business or fax user seems to have a unique way of getting information to its recipients as well as the manner of presentation. Faxes are no different.

Default faxrcvd Delivery

A default faxrcvd configuration from the HylaFAX installation will e-mail a notification of the received fax to FaxMaster. The notification will appear similar to this:

Date: Sat, 19 Aug 2000 23:02:08 -0600
To: FaxMaster@faxserver.mydomain.com
From: The HylaFAX Receive Agent 
Subject: facsimile received from

recvq/fax00008.tif (ftp://faxserver.mydomain.com:4559/recvq/fax00008.tif):
    Sender: Remote Fax ID
     Pages: 1
   Quality: Fine
      Page: ISO A4
  Received: 2000:08:19 23:00:27
TimeToRecv: 0:20
SignalRate: 14400 bit/s
DataFormat: 1-D MR
ReceivedOn: ttySx
CommID:     c00000010 (ftp://faxserver.mydomain.com:4559/log/c00000008)

If etc/hosts.hfaxd and RecvFileMode are configured for your access, then you should be able to view or retrieve the fax image or the CommID file by following the listed ftp link.

Attached TIFF/PostScript/PDF Mail Delivery

By using this procedure, the default mail will be sent with the fax image attached to that notification mail.

Create the file etc/FaxDispatch (usually /var/spool/hylafax/etc/FaxDispatch) so that it contains the following lines:

FILETYPE=tif;
SENDTO=FaxMaster;

Substitute pdf or ps for tif as you desire.

Note that because TIFF and PDF are binary file types, metamail, uuencode, or some other encoding program must be installed. In HylaFAX versions prior to 4.2.0 (HylaFAX 4.2.0 and later natively supports both uuencode and mimencode) if you do not use metamail's mimencode, also include a line like

MIMENCODE=bin/uuencode_it;

in your etc/FaxDispatch file where bin/uuencode_it is an executable shell script of the form

#!/bin/sh
uuencode -m $1 $1 | grep -E -v "^begin|^====$" 2>/dev/null

HylaFAX versions prior to 4.1.1 do not support the FILETYPE option in FaxDispatch, and so the attachments will always be Postscript. Users of HylaFAX versions prior to 4.1.1 (shame on you) may be interested in using the old faxrcvd-mail scripts by Noel Burton-Krahn. They can be found here. Note that these WILL NOT WORK as-is on HylaFAX versions 4.1.1 and newer.