HYLAFAX CHANGE INFORMATION

Current Version: v4.0beta011
Previous Version: v4.0beta010
Master FTP Site: sgi.com (192.48.153.1), directory sgi/fax

Note that this is a major new distribution and lots of things have changed. Consult the general overview for a high-level description of the new functionality provided in the v4.0 software.

This document describes the changes made to the software between the previous and current versions (see above). If you don't find something listed here, then it was not done in this timeframe, or it was not considered important enough to be mentioned. The following information is located here:

- General changes
- Changes in the software configuration
- Changes to hfaxd
- Changes to sendpage
- Changes to faxaddmodem
- Changes to faxmail
- Changes in the documentation
- Changes in miscellaneous stuff

GENERAL CHANGES:

- server machines must now be setup for use with the faxsetup command
- each inbound or outbound call handled by HylaFAX is now given a unique number termed a communication identifier; session logs are now written to separate files in the log directory whose names are based on the assigned communication identifier
- the format of the accounting file etc/xferfaxlog has changed to include the communication identifier and the client-specified job tag identifier (for outbound calls); the latter is useful for sites that use job tags for accounting purposes

CHANGES IN THE SOFTWARE CONFIGURATION:

- configure now emits the correct definition for `CONFIG_BADEXECVEPROTO` for AIX systems
- the check for support for memory-mapped files was corrected
- various configuration parameters now need an explicit ``auto'' setting to get configure to select a value based on the build environment
- fewer files are dependent on the build environment because of the addition of the faxsetup command and the work it does to configure the software according to the target system

CHANGES TO FAXQ:

- a new flag bit was added for tracing error messages from the TIFF library
- the calling sequence for the notify script was changed
- a new `-m` option is now passed to all document converters to indicate the maximum number of pages that should be permitted in a converted document
- faxq now returns (more) informative error messages when it recognizes that a document conversion failed but the converter program did not exit with an error
- faxq no longer assumes that document conversions overwrite the output file it creates

CHANGES TO FAXSEND:

- the calling sequence for the pollrcvd script was changed

CHANGES TO FAXGETTY:

- a bug was fixed in the Caller-ID support that caused information to be discarded in certain cases
- the calling sequence for the faxrcvd script was changed
- a bug was fixed in the Group 3 decoder's recognition of EOL codes that follow an error in the input stream

CHANGES TO HFAXD:

- the parsing of time values was made more robust
- the handling of absolute time values (e.g. `SENDTIME`) was corrected
- `RETRYTIME` values are now interpreted as minutes and seconds rather than hours and minutes
- `SENDTIME` values are now always interpreted relative to GMT
- hfaxd is now installed setuid root so that it functions correctly when started from inetd
- the SNPP support now sets the job `RETRYTIME` based on the service level; this corrects a problem where a job could time out before multiple attempts were made to complete the transmission
- a `RetryTimeMap` configuration parameter was added to control the SNPP service level-to-`RETRYTIME` mapping

CHANGES TO FAXADDMODEM:

- faxsetup must be run before configuring modems; faxaddmodem no longer does any of the basic system verification and setup work that it used to (e.g. creating a ``fax'' user)
- system-specific support for communicating with modems is now taken from the file etc/setup.modem created by faxsetup

CHANGES TO FAXMAIL:

- configuration files are now read
- the meta-header handling has been improved; it is now simpler to specify the set of headers to keep from the envelope
- headers are now matched in a case-insensitive manner
- meta-headers were added to control the fonts used to format the envelope

CHANGES IN THE DOCUMENTATION:

- the HTML documentation has been reorganized so that it can be viewed in-place in the source filesystem hierarchy
- all the documentation has been updated to reflect the current state of the software

CHANGES IN MISCELLANEOUS STUFF:

- a bug was fixed in memory-mapped file handling used for facsimile job submissions
- a bug was fixed in the SNPP client code for transmitting a `HOLD` time
- a bug was fixed in the fax client code for transmitting a `SENDTIME` value
- the System V script for starting the HylaFAX servers at boot time is now dependent on the work of faxsetup
- probemodem is now dependent on the work of faxsetup
- faxcron is now dependent on the work of faxsetup
- faxcron was updated to understand the new session log scheme
- faxmodem now accepts full device pathnames for consistency with other similar programs
- the notify script has been updated to handle the new session log scheme and to return transcripts for more errors
- xferfaxstats has new options for collating statistics by job tag and by modem device
- textfmt now reads configuration files

HylaFAX table of contents.