Provided by: hylafax-server_4.2.5-1_i386 bug

NAME

       destctrls - 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 parameters 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  hylafax-config(5);  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 whitespace 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 configuration
       file.

       The following parameters may be specified on a  per-destination  basis;
       consult  hylafax-config(5)  for a description of each parameter (except
       RejectNotice which is described below).
       Tag                   Type       Default      Description
       MaxConcurrentCalls    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
       Modem                 string     Any          ModemGroup to use for destination
       RejectNotice          string     -            rejection notice for transmit job
       TimeOfDay             string     Any          default time-of-day restrictions
       VRes                  integer    -            Vertical resolution
       UseXVRes              integer    -            Usage of extended resolutions

       The Modem parameter controls which ModemGroup is used in sending  faxes
       to  the  destination.   If the user assigns a ModemGroup for a specific
       job where  all  modems  are  outside  of  this  ModemGroup  matching  a
       destination,  then  the  value  of  Modem  is  overridden by the user’s
       assignment.  Likewise, if the user assigns a ModemGroup for a  specific
       job  where  some,  but  not  all,  of  the  modems are included in this
       ModemGroup  matching  a  destination,  then  the  value  of  Modem   is
       overridden by the inclusive set of modems found in both.

       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 associated 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"

       The  VRes  parameter  controls the vertical resolution. Possible values
       are 98 (normal resolution, equivalent to sendfax  -l  option)  and  196
       (fine resolution, equivalent toi sendfax -m option).

       The  UseXVRes  parameter  is  used  to  enable  or disable the usage of
       extended resolutions supported by the receiver. Possible values  are  1
       (enable  extended  resolutions  usage, equivalent to sendfax -G option)
       and 0 (disable extended resolutions usage).  This parameter  supercedes
       the usage of VRes.

       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 example,
        .*    SessionTracing = 0x4f

       This   mechanism   also  makes  it  easy  to  control  transmit-related
       parameters according to the destination phone number.  For example,  to
       disable  use  of  ECM  and  restrict  the  transmit  speed when placing
       international phone calls one might use:
        [+][^1]    DesiredBR=3 DesiredEC=0

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 ALSO

       faxq(8), hylafax-config(5), re_format(7).

                                October 3, 1995                   DESTCTRLS(5)