DragonFly On-Line Manual Pages

NCIDD.WHITELIST(5)       DragonFly File Formats Manual      NCIDD.WHITELIST(5)

NAME
       ncidd.whitelist - whitelist file for ncidd hangup

DESCRIPTION
       The ncidd.whitelist file contains the expressions to match against a
       telephone call name or number.

       If the hangup option is set and if there is no match in the whitelist
       file, a match in the blacklist file will cause ncidd to automatically
       terminate the call.

       The ncidd.whitelist file understands 4 types of lines:

       blank line:   skip it

       comment line: skip it

       entry line:   process it

       Entry lines contain one or more expressions and an optional comment.
       An expression is either a string of non-blank characters or everything
       between double quotes.  Multiple expressions are separated by spaces.
       A comment must be last.

       Entry line comments are either normal comments or match name comments.

       A normal comment begins with a '#' and must not be immediately followed
       by an equals sign. Anything after the '#' is ignored.

       A match comment begins with '#=' and is followed by a name to display
       for the caller when the entry matches either the number or name of a
       call.  Do not use double quotes around the name.

       Example:  ncidd.blacklist: ^999         #= Unwanted Area code
                 ncidd.whitelist: 9995550000   #= WHT (999) 555-0000

NOTES
       o  Each expression is compared to the caller name and number.

       o  Upper and lower case letters are significant.

       o  The number must be a string of digits as they appear in
          /var/log/cidcall.log.

       o  A leading '1' is required if it is in /var/log/cidcall.log.

       o  A partial name or number can match.

       o  If regular expressions are used (regex = 1):
          * POSIX Extended Regular Expression Syntax.
            https://en.wikipedia.org/wiki/Regular_expression
          * Introduction to Regular Expressions
            http://www.regular-expressions.info/quickstart.html

       o  A '^' at the beginning of an expression means it must match at the
          start of a name or number.

       o  A "^1?" at the beginning makes a leading 1 optional.  This is only
          useful for US/Canadian numbers.

       o  If an expression is longer than the name or number field it will
          never match.

EXAMPLES
       Blacklist the unassigned 999 area code with and without a leading 1,
       but allow a call from 999-555-1212:
            ncidd.blacklist: ^1?999
            ncidd.whitelist: 9995551212

       Whitelist expression for an optional leading 1 (US/Canada only):
            ^1?9995551212

SEE ALSO
       ncidd.8, ncidd.conf.5, ncidd.alias.5, ncidd.blacklist.5

                                                            NCIDD.WHITELIST(5)