bionic (5) tsi.5.gz

Provided by: hylafax-server_6.0.6-8.1~ubuntu0.18.04.1_amd64 bug

NAME

       tsi - Transmission Subscriber Identification (TSI) access control list

DESCRIPTION

       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 expressions syntax specified by POSIX
       1003.2;  see  re_format(7).   Comments  may be included; they are introduced with the ``#'' character and
       extend to the end of the line.  Any trailing white space on a  line  is  ignored  (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:
            ^<pattern>$

       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 example,
            ^([+]1){1}[ .-]*415[ .-]*555[ .-]*1212.*$

       matches the following TSI strings:
              +1.415.555.1212
                  415  555  1212
              1-415-555-1212

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

NOTES

       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  characters).  This is, however, problematic, because some facsimile
       machines permit any printable ASCII string to be sent as a TSI.

SEE ALSO

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

                                                December 5, 1994                                          TSI(5)