Tag              Type       Default          Description
AutoCoverPage    boolean    Yes              automatically generate cover page
ChopThreshold    float      3.0              page chopping threshold
CoverCmd         string     see below        pathname of cover sheet program
Cover-Comments   string     -                cover page comments string
Cover-CompanyS1  string     -                cover page to-company name string
Cover-LocationS1 string     -                cover page to-company location string
Cover-Regarding  string     -                cover page regarding string
Cover-Template   string     -                cover page template filename
Cover-VoiceS1    string     -                cover page to-voice number string
Cover-From-CompanyS1        string           -cover page from-company string
Cover-From-LocationS1       string           -cover page from-location string
Cover-From-VoiceS1          string           -cover page from-voice number string
Cover-From-FaxS1 string     -                cover page from-fax number string
DateFormat       string     -                cover page date format string
DesiredEC        boolean    -                desired use of ECM
DesiredMST       string     -                desired minimum scanling time to use
DesiredSpeed     integer    -                desired signalling rate to use
DialRules        string     see below        file containing dialstring rules
From             string     -                sender's identity
HRes             float      204.             horizontal resolution
Host             string     localhost        host to contact for service
KillTime         string     -                time to expire job
MailAddr         string     -                mail address for notification messages
MaxDials         integer    12               times to retry dialing
MaxTries         integer    3                times to retry transmission
MinSpeed         integer    -                minimum acceptable signalling rate
Modem            string     -                modem to use on server
Notify           string     none             control email notification
PageChop         string     default          control page chop handling
PageLength       float      -                page length in millimeters
PageSize         string     default          page size by name
PageWidth        float      -                page width in millimeters
Port             integer    4559             port to use in contacting server
Priority         string     default          job scheduling priority
Protocol         string     tcp              protocol to use in contacting server
RetryTime        string     -                delay between failed attempts to send
SendTime         string     -                time to send job
TagLine          string     -                tagline format string
TypeRules        string     see below        file containing file typing rules
VRes             float      98.              vertical resolution
Verbose          boolean    No               whether or not to enable protocol tracing

The configuration parameters are explained below. Certain configuration parameters, notably those for setting strings on automatically generated cover pages, are defined mainly for use by other HylaFAX programs that share common code used by sendfax.

AutoCoverPage

Control whether or not a cover page is automatically generated for each job. (Equivalent to the -n option.)

ChopThreshold

The amount of white space, in inches, that must be present at the bottom of a page before HylaFAX will attempt to truncate the page transmission.

CoverCmd

The absolute pathname of the program to use to generate cover pages. The default cover sheet program is /usr/bin/faxcover.

Cover-Comments

The comments string to pass to the cover sheet program when auto-generating cover pages.

Cover-Company

The to-company name string to pass to the cover sheet program when auto-generating cover pages.

Cover-Location

The to-company location string to pass to the cover sheet program when auto-generating cover pages.

Cover-Regarding

The regarding string to pass to the cover sheet program when auto-generating cover pages.

Cover-Template

The absolute pathname of a cover sheet template file to use in auto-generating cover pages.

Cover-Voice

The to-voice number string to pass to the cover sheet program when auto-generating cover pages.

Cover-From-Company

The from-company name string to pass to the cover sheet program when auto-generating cover pages.

Cover-From-Location

The from-location string to pass to the cover sheet program when auto-generating cover pages.

Cover-From-Voice

The from-voice number string to pass to the cover sheet program when auto-generating cover pages.

Cover-From-Fax

The from-fax number string to pass to the cover sheet program when auto-generating cover pages.

DateFormat

The (3) format string to pass to the cover page command when auto-generating cover pages.

DesiredEC

Whether or not to request the use of the optional Error Correct Mode (ECM) when transmitting facsimile. (Equivalent to the -E option.)

DesiredMST

The desired minimum scanline time to use when transmitting facsimile. (Equivalent to the -M option.)

DesiredSpeed

The desired signalling rate to the use when transmitting facsimile. (Equivalent to the -B option.)

DialRules

The name of the file containing the dialstring processing rules to when preparing an externally visible representation of the dialstring (e.g. to strip credit card numbers). By default this is /etc/hylafax/dialrules.

From

The sender's identity. (Equivalent to the -f option.)

Host

The host to contact for service. (Equivalent to the -h option.)

HRes

The horizontal resolution to use when transmitting facsimile. (NB: this currently has no effect.)

KillTime

The expiration time to assign to each job. (Equivalent to the -k option.)

MailAddr

The electronic mail address to direct notification messages from the server. If this string is specified without an ``@hostname'' part then the local hostname will automatically be appended. (Equivalent to the -f option.)

MaxDials

The maximum number of times to dial the phone for each job. (Equivalent to the -T option.)

MaxTries

The maximum number of times to retry sending a job. (Equivalent to the -t option.)

MinSpeed

The minimum acceptable signalling rate to use when transmitting facsimile. (Equivalent to the -b option.)

Modem

The modem to use on the server. (Equivalent to the -h option.)

Notify

Control the email notification messages from the server. This string may be one of ``done'', ``none'', ``requeued'' or ``default'' with an optionally preceding ``when '' (e.g. ``when done''). Note that ``when requeued'' implies ``when done''. (Equivalent to the -D, -R, and -N options.)

PageChop

Control page chop handling when transmitting facsimile. This string may be one of ``none'', ``all'', or ``last' to have no pages chopped, all pages chopped, or only the last page chopped; respectively. Page chopping is controlled by the ChopThreshold parameter.

PageLength

Set the transmitted page length in millimeters.

PageSize

Set the page dimensions according to an entry in the (5F) database. (Equivalent to the -s option.)

PageWidth

Set the transmitted page width in millimeters.

Port

The network port to contact for service. (Eqvuialent to the -h option.)

Priority

The scheduling priority to assign to each job. (Equivalent to the -P option.)

Protocol

The name of the communication protocol to use when contacting a server. (Equivalent to the FAXSERVICE environment variable.)

RetryTime

The time to delay between job retries due to a communication failure. (Equivalent to the -I option.)

SendTime

The time to send jobs. (Equivalent to the -a option.)

TagLine

The tagline format string to use when transmitting facsimile. (Equivalent to the -F option.)

TypeRules

The name of the file containing file type conversion rules. By default this is /etc/hylafax/typerules.

Verbose

Control protocol tracing. (Equivalent to the -vv option.)

VRes

Set the vertical resolution in lines/inch to use when transmitting facsimile. (Equivalent to the -m and -l options.)