1NCIDD.BLACKLIST(5)            File Formats Manual           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
46          /var/log/cidcall.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 regular expressions are used (regex = 1):
53          * POSIX Extended Regular Expression Syntax.
54            https://en.wikipedia.org/wiki/Regular_expression
55          * Introduction to Regular Expressions
56            http://www.regular-expressions.info/quickstart.html
57
58       ·  A  '^'  at the beginning of an expression means it must match at the
59          start of a name or number.
60
61       ·  A "^1?" at the beginning makes a leading 1 optional.  This  is  only
62          useful for US/Canadian numbers.
63
64       ·  If  an  expression  is  longer than the name or number field it will
65          never match.
66

EXAMPLES

68       Blacklist the unassigned 999 area code with and without a leading 1
69            ^1?999
70
71       Blacklist callers with the name "BAD MARKETING":
72            "BAD MARKETING"
73
74       Blacklist anything with "MARKETING" in the name:
75            MARKETING
76
77       Blacklist a caller name and a different caller number on one line:
78            Ogre 13215551212
79

SEE ALSO

81       ncidd.8, ncidd.conf.5, ncidd.alias.5, ncidd.whitelist.5
82
83
84
85                                                            NCIDD.BLACKLIST(5)
Impressum