The HylaFAX "How-To" Guide

Lee Howard,

v4.2.2, 19 Oct 2005

This is a detailed guide to HylaFAX installation, configuration, and troubleshooting.

4. Received Fax Delivery and Viewing

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.

4.1 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, 20 Oct 2005 05:23:30 -0600
From: The HylaFAX Receive Agent 
Subject: facsimile received from  

recvq/fax00008.tif (
    Sender: Remote Fax ID
     Pages: 1
   Quality: Fine
      Page: ISO A4
  Received: 2005:10:20 05:23:23
TimeToRecv: 0:13
SignalRate: 14400 bit/s
DataFormat: JBIG
ErrCorrect: Yes
   CallID1: 8005551212
   CallID2: Caller ID Name
   CallID3: 4475658
ReceivedOn: ttyS0
    CommID: c00000010 (
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.

4.2 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:

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 - faxsetup must be run following the installation of one of these in order to properly update setup.cache.

4.3 Common Windows Viewers

Note that in order to set a default program to "Open" a file by double-clicking it, appropriate file type configuration must be entered into Explorer/View/Folder Options.../File Types for that file extension.

4.4 Common Mac Viewers

4.5 Common *NIX Viewers