TSITEST(8C)TSITEST(8C)NAME
tsitest - HylaFAX TSI access control list checking program
SYNOPSIS
/usr/sbin/tsitest [ -q ] ACLfile
DESCRIPTION
tsitest is an interactive program for the testing of the TSI access control list (ACL) used by the faxgetty(8C) server processes to screen
incoming facsimile. The ACLfile specified on the command line is expected to contain TSI control expressions as described in tsi(5F).
Strings typed at the prompt are then checked against the list and tsitest prints out whether or not the string is an acceptable TSI.
Note that tsitest reads the control list file only when it is initially started up. This means that tsitest must be restarted for it to
recognize changes to ACLfile.
OPTIONS -q Operate quietly; tsitest will print only whether an input string is accepted or rejected.
SEE ALSO faxgetty(8C), hylafax-server(5F), hylafax-config(5F), tsi(5F)
March 3, 1995 TSITEST(8C)
Check Out this Related Man Page
TSI(5) File Formats Manual TSI(5)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 identi-
fied 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). Com-
ments 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)