Attach fax document to email notification

By using this procedure, the default email (sent after receiving a fax) will be sent with the fax image attached to it.

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. Also it is possible to use a real email address instead of 'FaxMaster'.

It is possible to add the following if a sender email address is required - such as when using smart relay to send through the provider's SMTP server:

FROMADDR=youremailaddress;

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 if you do not use metamail's mimencode, also include a line like:

MIMENCODE=bin/uuencode_it;

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

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

HylaFAX 4.2.0 and later natively supports both uuencode and mimencode, which is to say if either the 'uuencode' or 'mimencode' binaries exist, they will be detected and used by HylaFAX to encode the attachment.

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.

Ubuntu 7.04 Feisty Fawn (HylaFAX 4.3.1)
Because  will define the following:

BASE64ENCODE='/usr/bin/uuencode' MIMENCODE='/usr/bin/uuencode UUENCODE='/usr/bin/uuencode'

and uuencode - GNU sharutils 4.2.1 must include the output file as an argument,  should include the following:

FILETYPE=tif SENDTO=FaxMaster BASE64ENCODE='bin/uuencode_it'

(replace  with   if desired) and   should include the following instead:

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

Note the replacement of the second  with   from the original.