DESTCTRLS(5F)DESTCTRLS(5F)NAMEdestctrls - per-destination controls for HylaFAX servers
DESCRIPTION
The HylaFAX configuration parameter DestControls specifies
whether or not to apply per-destination controls on job
characteristics such as the time-of-day to place a call.
The controls file is a simple ASCII file containing a
series of records of the form:
dest param = value ... param = value
where dest is a regular expression matched against the
canonical form of a destination phone number and parame-
ters are specified by named assignments (though the ``=''
can also be left out). Whitespace may be used freely
though it is used to identify the end of dest and the
start of the parameter list. Parameter values are parsed
exactly as specified in config(5F); i.e. values with
embedded whitespace may be enclosed in quote marks
(``"'').
Comments are introduced with a ``#'' character and extend
to the end of the line. Parameter lists may be continued
across lines by starting subsequent lines with a whites-
pace character (lines commented out with ``#'' are also
considered to be part of a continued record).
The order of entries in a file is important. When a
parameter value is needed faxq sequentially scans the file
until it finds a record that matches the canonical form of
the destination phone number. If the requested parameter
is defined in this record, then the value is returned,
otherwise a default value is used from the faxq configura-
tion file.
The following parameters may be specified on a per-desti-
nation basis; consult config(5F) for a description of each
parameter (except RejectNotice which is described below).
Tag Type Default Description
MaxConcurrentJobs integer 1 max concurrent jobs to process for a destination
MaxDials integer unlimited max phone calls to make to transmit a job
MaxSendPages integer unlimited max pages to permit in a send
MaxTries integer 3 max attempts to transmit a job
RejectNotice string - rejection notice for transmit job
TimeOfDay string Any default time-of-day restrictions
The RejectNotice parameter controls whether or not to
reject jobs to the destination. Jobs that are rejected
are done so without placing a phone call and the associ-
ated message is returned to the job submitter. This
facility can be used to disallow calling sensitive phone
numbers; for example
.*911$ RejectNotice = "Calls to emergency numbers are not permitted"
October 3, 1995 1
DESTCTRLS(5F)DESTCTRLS(5F)
In addition to the above parameters, any other parameters
that are specified are automatically accumulated and
passed to programs invoked by faxq, such as faxsend and
pagesend. This is a convenient mechanism for defining
configuration parameters for all modems without having to
modify each modem-specific configuration file. For exam-
ple,
.* SessionTracing = 0x4f
This mechanism also makes it easy to control transmit-
related parameters according to the destination phone num-
ber. For example, to disable use of ECM and restrict the
transmit speed when placing international phone calls one
might use:
[+][^1] DesiredBR=9600 DesiredEC=false
NOTES
Beware that canonical phone numbers have a leading ``+''
which is a special character for regular expressions. An
easy way to match ``+'' is with ``[+]''; e.g.
``[+]14159657824''.
SEE ALSOfaxq(8C), config(5F), re_format(7).
October 3, 1995 2
