Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
TSI(5F)								       TSI(5F)

       tsi - Transmission Subscriber Identification (TSI) access control list

       The HylaFAX configuration parameter QualifyTSI specifies	whether	or not
       the identity of a calling facsimile machine should be  checked  against
       an  access  control  list before	receiving facsimile.  If QualifyTSI is
       non-null, then only messages from facsimile machines identified in  the
       file specified by the string (typically etc/tsi)	will be	accepted.

       Patterns	are specified one per line and must conform to the regular ex-
       pressions syntax	specified by POSIX 1003.2; see re_format(7).  Comments
       may  be	included; they are introduced with the ``#'' character and ex-
       tend to the end of the line.  Any trailing white	space on a line	is ig-
       nored (for convenience when comments are	used).

       If  a  line  begins  with ``!'',	then the regular expression identifies
       clients that should be rejected;	otherwise regular expressions identify
       clients	whose transmissions should be accepted.	 The order of patterns
       in a TSI	file is	important.  When a facsimile is	to  be	received,  the
       fax  server  will  compare the client's TSI against the patterns	in the
       access control list in the order	in which they appear in	the file.  The
       first  pattern that matches the client TSI is used to decide whether to
       accept or reject	the facsimile.	If no patterns match  the  client  TSI
       then  the  facsimile is rejected.  Thus if you want to accept all but a
       restricted set of TSI the last line in the file should be ``^.*$''.

       Note that regular expression patterns should be written to match	a  TSI
       exactly.	 That is, patterns should be of	the form:

       where  the ``^''	and ``$'' characters are used to specify the start and
       end of the matching TSI.	  Additionally,	 regular  expression  patterns
       should  handle white space that may appear in known locations.  For ex-
	    ^([+]1){1}[	.-]*415[ .-]*555[ .-]*1212.*$

       matches the following TSI strings:
		  415  555  1212

       Finally,	note that regular expressions can be used to specify many  TSI
       with one	pattern.

       It  would be nice if TSI	that were to be	matched	against	were placed in
       some canonical form (e.g. remove	white space and	white space-like char-
       acters).	  This	is,  however,  problematic, because some facsimile ma-
       chines permit any printable ASCII string	to be sent as a	TSI.

       faxgetty(8C), re_format(7), hylafax-config(5F)

			       December	5, 1994			       TSI(5F)


Want to link to this manual page? Use this URL:

home | help