Content-type: text/html Manpage of NCIDD.WHITELIST

NCIDD.WHITELIST

Section: File Formats (5)
Index Return to Main Contents
 

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

Each expression is compared to the caller name and number.
Upper and lower case letters are significant.
The number must be a string of digits as they appear in /var/log/cidcall.log.
A leading '1' is required if it is in /var/log/cidcall.log.
A partial name or number can match.
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
A '^' at the beginning of an expression means it must match at the start of a name or number.
A "^1?" at the beginning makes a leading 1 optional. This is only useful for US/Canadian numbers.
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


 

Index

NAME
DESCRIPTION
NOTES
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 13:26:52 GMT, October 04, 2016