Personal tools
HylaFAX The world's most advanced open source fax server

Beta Versions

Revision as of 18:47, 27 October 2006 by Darren (talk | contribs)

The HylaFAX development team often asks other developers and interested HylaFAX users to test upcoming software releases. As these are beta versions of software they may contain more bugs than usual, and should probably not be used on production servers if your job depends on the performance of that server!

Reporting Bugs

The HylaFAX Bugzilla is located at Please file a bug report there if you can. If you prefer to send a message to the mailing lists to discuss the problem, we encourage you to subscribe to and post it there. The hylafax-users mailing list will also reach many of the right people, and is the next best thing if subscribing to -devel and filing a bug report seem like too much trouble. Bottom line - we want your bugs!!

Current release candidate (4.3.1rc1)

The source can be downloaded from:

Please refer to our Red_Hat_Packages page for a source RPM that should build on most Red Hat, Fedora and SuSE distributions.

New features of particular note

Template-based email notifications

In the past, there has been discussion about both customizing and translating the e-mails that faxrcvd and notify send. In this version of HylaFAX, we've done some work to make faxrcvd and notify use "templates" for their e-mail messages.

This means that faxrcvd and notify no longer use the "bin/dictionary" and eval "echo $..." everywhere when creating their e-mails, but now directly use a template file.

These versions continue the tradition of sourcing etc/FaxDispatch (for faxrcvd) and etc/FaxNotify (for notify) to get "command" variables that influence what they do. Of course, these shell scripts can continue to do whatever else they were doing (including calling exit to terminate normal faxrcvd/notify handling if desired).

These shell scripts can now also set the TEMPLATE variable to control the source of template files that faxrcvd/notify use to generate their e-mails. Templates are taken from (relative $SPOOL, where notify/faxrcvd are run from):

etc/templates/$TEMPLATE/<template name>

So, with TEMPLATES unset, you get the default templates. If TEMPLATES=fr, you would use the templates in:

etc/templates/fr/<template name>

We've created a basic set of templates, and a set of translations of them, based on our reading and knowledge of the current faxrcvd and notify scripts. We're sure there are problems with some of the templates, so corrections are welcome.

Templates are of the format:

	From: FAX Agent <$FROMADDR>
	Subject: Fax received from "$SENDER"
	Content-type: text/plain; charset=us-ascii

	$FILE (ftp://$HOSTNAME:4559/$FILE):                                  
		  Sender: $SENDER
		   Pages: $PAGES
		 Quality: $QUALITY
		    Size: $PAGE
		Received: $RECEIVED
	 Time To Receive: $TIMETORECV
	     Signal Rate: $SIGNALRATE
	     Data Format: $DATAFORMAT
	   Error Correct: $ERRCORRECT
		 CallID1: $CALLID1
		 CallID2: $CALLID2
	     Received On: $DEVICE
		  CommID: $COMMID (ftp://$HOSTNAME:4559/log/$COMMID)      

Templates are 2 sections, separated by a blank line. The "header" section is included in the headers of the e-mail. So the template can actually specify the content-type it is, including any charset, etc.

This means that you *can* make your template something like:

	From: ...
	Subject: ...
	Content-type: text/html



A complete list of changes from 4.3.1 is as follows:

  • Use old style lock files for OpenServer 6 (20 Oct 2006)
  • Always update on-disk qfiles for jobs when state changes to running (19 Oct 2006)
  • Change how we compile shared objects for Solaris DSO support (12 Oct 2006)
  • Base64 encoding with uuencode was broken on 3 Oct (6 Oct 2006)
  • uuencode STDERR was not redirected to $ERRORSTO (6 Oct 2006)
  • There was a small possibility of corruption a base64 output produced by uuencode if an encoded line started with "begin" (6 Oct 2006)
  • Private tmpdir was not set by faxrcvd, but used for body encoding (6 Oct 2006)
  • fax faxqclean, don't remove cover documents still referenced (4 Oct 2006)
  • Encodes email body according to template setting (3 Oct 2006)
  • Add Quoted-Printable encoding option (3 Oct 2006)
  • Add Romanian templates (29 Sep 2006)
  • faxsetup nolonger blindly removes $TMPDIR (29 Sep 2006)
  • Add Motorola SM56 USB (Apple) modem (27 Sep 2006)
  • Add HPUX 11.11 support to configure (27 Sep 2006)
  • make cover pages visible in /docq/ through hfaxd (17 Sep 2006)
  • handle +FHNG/+FNG after AT+FDT in Class 2 (15 Sep 2006)
  • Unify mime encoding between notify and faxrcvd
  • Add templates for use in faxrcvd translations (14 Aug 2006)
  • don't exit faxq with assertion failure when a job times out and is interrupted during sending (21 Jul 2006)
  • faxaddmodem: Allow identification when no AT+FMM? or AT+FMI? (21 Jul 2006)
  • fix error of accepting too-short of DCS signal (20 Jul 2006)
  • fix faxgetty hang in ECM due to missing timeouts (20 Jul 2006)
  • fix indicator when 100% non-zero TCF data is received (20 Jul 2006)
  • do Class1SwitchingCmd before sending MCF after PPS-NULL (20 Jul 2006)
  • replace Class1SendMsgDelay with Class1SwitchingCmd (20 Jul 2006)
  • fix faxaddmodem config parsing for Digicom Leonardo modems(19 Jul 2006)
  • don't skip initial NSF bytes in station ID search when no known T.35 manufacturer ID was used (18 Jul 2006)
  • Documentation updates (18 Jul 2006)
  • Fix RecvFmt string printing (Bug 805) (18 Jul 2006)
  • fix timeout on AT command sending to modem (5 Jul 2006)
  • don't use tiffcp "-r" option on JBIG TIFFs (5 Jan 2006)
  • Avoid problems when resending single ECM Frame (5 Jul 2005)
  • Improve recovery after Class 1 TCF receipt times out (4 Jul 2006)
  • Improve the handling of user aborts in Class 1 sending (4 Jul 2006)
  • Add missing From: headers to notify (4 Jul 2006)
  • correct CIELAB to be ITULAB (4 Jul 2006)
  • fix Class 2 data format parsing of +FIS response (4 Jul 2006)
  • Enhance faxinfo with formating options (2 Jul 2006)
  • Fix faxmail's handling of nested mime (14 Jun 2006)
  • Add JobProtection option to hfaxd (12 Jun 2006)
  • Enhance SHIELDED_DTMF (5 Jun 2006)
  • Add resubmit capability to faxalter (2 Jun 2006)
  • Use ] && [ instead of -a for shell portability (2 Jun 2006)
  • Add continuation support to FaxClient in libfaxutil (31 May 2006)
  • Add UseJobTagLine config option for faxsend (4 Apr 2006)

Powered by MediaWiki
Attribution-ShareAlike 2.5

Project hosted by iFAX Solutions