ncidd.blacklist(5)

1NCIDD.BLACKLIST(5)                   NCID                   NCIDD.BLACKLIST(5)
2
3
4

NAME

6       ncidd.blacklist - blacklist file for ncidd hangup
7

DESCRIPTION

9       The  ncidd.blacklist  file  contains the expressions to match against a
10       telephone call name or number.
11
12       If the hangup option is set and if there is no match in  the  whitelist
13       file,  a  match in the blacklist file will cause ncidd to automatically
14       terminate the call.
15
16       The ncidd.blacklist file understands 4 types of lines:
17
18              blank line:   skip it
19
20              comment line: skip it
21
22              entry line:   process it
23
24       Entry lines contain one or more expressions and  an  optional  comment.
25       An  expression is either a string of non-blank characters or everything
26       between double quotes.  Multiple expressions are separated  by  spaces.
27       A comment must be last.
28
29       Entry line comments are either normal comments or match name comments.
30
31       A normal comment begins with a '#' and must not be immediately followed
32       by an equals sign. Anything after the '#' is ignored.
33
34       A match name comment begins with '#=' and is followed by a name to dis‐
35       play for the caller when the entry matches either the number or name of
36       a call.  Do not use double quotes around the name.
37
38              Example:    407-555-5670    #= Unwanted Marketing Call
39

NOTES

41       Each expression is compared to the caller name and number.
42
43       Upper and lower case letters are significant.
44
45       The number must be a string of digits as they appear  in  /var/log/cid‐
46       call.log.
47
48       A leading '1' is required if it is in /var/log/cidcall.log.
49
50       A partial name or number can match.
51
52       If POSIX regular expressions cwareis used (regex = 1):
53
54              POSIX Extended Regular Expression Syntax
55              https://en.wikipedia.org/wiki/Regular_expression
56
57              Introduction to Regular Expressions
58              http://www.regular-expressions.info/quickstart.html
59
60       If Perl Compatible Regular Expressions (PCRE) are used (regex = 2):
61
62              Perl regular expressions man page
63              https://perldoc.perl.org/perlre
64
65              pcre2syntax man page
66              https://www.pcre.org/current/doc/html/pcre2syntax.html
67
68       Simple and Regular Expressions:
69
70              A  '^'  at the beginning of an expression means it must match at
71              the start of a name or number.
72
73              A "^1?" at the beginning makes a leading 1  optional.   This  is
74              only useful for US/Canadian numbers.
75
76              If an expression is longer than the name or number field it will
77              never match.
78

EXAMPLES

80       Blacklist the unassigned 999 area code with and without a leading 1
81            ^1?999
82
83       Blacklist callers with the name "BAD MARKETING":
84            "BAD MARKETING"
85
86       Blacklist anything with "MARKETING" in the name:
87            MARKETING
88
89       Blacklist a caller name and a different caller number on one line:
90            Ogre 13215551212
91

NAME

DESCRIPTION

NOTES

EXAMPLES

SEE ALSO