1TSI(5F)                                                                TSI(5F)
2
3
4

NAME

6       tsi - Transmission Subscriber Identification (TSI) access control list
7

DESCRIPTION

9       The HylaFAX configuration parameter QualifyTSI specifies whether or not
10       the identity of a calling facsimile machine should be  checked  against
11       an  access  control  list before receiving facsimile.  If QualifyTSI is
12       non-null, then only messages from facsimile machines identified in  the
13       file specified by the string (typically etc/tsi) will be accepted.
14
15       Patterns  are  specified  one  per line and must conform to the regular
16       expressions syntax specified by POSIX 1003.2; see  re_format(7).   Com‐
17       ments may be included; they are introduced with the ``#'' character and
18       extend to the end of the line.  Any trailing white space on a  line  is
19       ignored (for convenience when comments are used).
20
21       If  a  line  begins  with ``!'', then the regular expression identifies
22       clients that should be rejected; otherwise regular expressions identify
23       clients  whose transmissions should be accepted.  The order of patterns
24       in a TSI file is important.  When a facsimile is to  be  received,  the
25       fax  server  will  compare the client's TSI against the patterns in the
26       access control list in the order in which they appear in the file.  The
27       first  pattern that matches the client TSI is used to decide whether to
28       accept or reject the facsimile.  If no patterns match  the  client  TSI
29       then  the  facsimile is rejected.  Thus if you want to accept all but a
30       restricted set of TSI the last line in the file should be ``^.*$''.
31
32       Note that regular expression patterns should be written to match a  TSI
33       exactly.  That is, patterns should be of the form:
34            ^<pattern>$
35
36       where  the ``^'' and ``$'' characters are used to specify the start and
37       end of the matching TSI.   Additionally,  regular  expression  patterns
38       should  handle  white  space  that  may appear in known locations.  For
39       example,
40            ^([+]1){1}[ .-]*415[ .-]*555[ .-]*1212.*$
41
42       matches the following TSI strings:
43              +1.415.555.1212
44                  415  555  1212
45              1-415-555-1212
46
47       Finally, note that regular expressions can be used to specify many  TSI
48       with one pattern.
49

NOTES

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

SEE ALSO

57       faxgetty(8C), re_format(7), hylafax-config(5F)
58
59
60
61                               December 5, 1994                        TSI(5F)
Impressum