destctrls man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



DESTCTRLS(5F)					    DESTCTRLS(5F)

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 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 ALSO
       faxq(8C), config(5F), re_format(7).

			 October 3, 1995			2

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net