CID(5F)CID(5F)NAMEcid - Caller-ID access control list
DESCRIPTION
The HylaFAX configuration parameter QualifyCID specifies
whether or not the identity of an inbound call should be
checked against an access control list before the tele-
phone is answered. If a modem is attached to a phone line
that has Caller-ID service, and QualifyCID is non-null,
then only the callers identified in the file specified by
the string (typically etc/cid) will be answered.
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 callers that should be rejected; otherwise reg-
ular expressions identify clients whose calls should be
accepted. The order of patterns in a CID file is impor-
tant. When a call is to be answered, the faxgetty process
will compare the phone number presented by the modem
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's number is used to decide whether
to accept or reject the call. If no patterns match the
phone number then the call is not answered. Thus if you
want to accept all but a restricted set of calls, the last
line in the file should be ``^.*$''.
Note that regular expression patterns should be written to
match a phone number 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 phone number. Addition-
ally, regular expression patterns should handle white
space that may appear in known locations. For example,
^([+]1){1}[ .-]*415[ .-]*555[ .-]*1212.*$
matches the following phone number strings:
+1.415.555.1212
415 555 1212
1-415-555-1212
Finally, note that regular expressions can be used to
specify many numbers with one pattern.
NOTES
The caller's telephone number is recognized by using the
December 5, 1994 1
CID(5F)CID(5F)
CIDNumber configuration parameter described in config(5F).
This parameter must be present in the per-modem configura-
tion file for Caller-ID screening to function properly.
If QualifyCID is defined, but no CIDNumber is specified,
then no phone numbers will be recognized and all incoming
calls will be ignored.
SEE ALSOfaxgetty(8C), config(5F), re_format(7).
December 5, 1994 2
