NAME

isdnconf - manipulate or read ISDN phone number config files.

SYNOPSIS

isdnconf

DESCRIPTION

isdnconf can manipulate or read the file /etc/isdn/callerid.conf as well as ~/.isdn. Entries can be added or removed from these files. Additionally, entries can be searched for and displayed in a way similar to grep. An entry can be an own MSN ([MSN]) or a phone number ([NUMBER]).

You can use this program to build your own phonebook. These files are used by many of the other ISDN utilities that use phone numbers, to display a number symbolicly instead of as a plain number.

OPTIONS

Note: usage of the options -A and -D is dangerous! The complete structure of the file may be changed, and all comments are removed! Make backups of your data files before trying these.

COMMAND OPTIONS:

-A

Add a new entry, which is read from standard input. The following values are asked for (here with examples):

Alias:          Fred
Number:         0815/441777
SI:             0
Zone:           4
Interface:      -
Flags:          I|O
Program:        /usr/local/bin/ring
User:           uucp
Group:          user
Interval:
Time:           8-20
Flags:          (control-D here indicates end of flags)
Alias:          (control-D here indicated end of entries)

-D

Delete one or more entries which match the data options given. How to supply the data to match is discussed below (see DATA OPTIONS).

-V

version: display the program's version and terminate.

If both -A and -D are given together, isdnconf will terminate, as this is not a valid combination.

If neither -A nor -D is given, then isdnconf will display entries which match the data given.

DATA OPTIONS: (none applicable for -A)

-n 'number'

number: match the given number. It can contain wildcards.

-a 'alias'

alias: match the given alias name. The name can contain wildcards. Note: due to a bug, use '?' instead of '-'.

-t 'SI'

SI: match the given service indicator.

-c 'code'

code: match the area code of the phone number. Only usable for displaying (not for -A nor -D).

-i

ignore case for the -n and -a options.

-w

word: the parameters for -n and -a must match the whole value, not just a substring.

"*34*" matches 123456, 345677, 1234
"34*"  matches 34567, 34111 but not 1234
"34??" matches 3411, 3456
"34"   matches only 34

"*34*" matches 123456, 345677, 1234
"34*"  matches 123456, 345677, 1234, 34567, 34111
"34??" matches 123456, 345677, 1234, 3411, 3456
"34"   matches 123456, 345677, 1234, 3411, 3456, 34567

-d

and: by default the values given to options -n, -a and -t will be combined with a logical OR. If these should be combined with a logical AND (which is probably what most people expect!) you must use this -d option. In this case you can only supply each of the -n, -a and -t options exactly once.

OTHER OPTIONS:

-q

quiet: when using the -A or -D commands, the output is suppressed. When not using the -A or -D commands, only the alias of the matching number is shown, or just the number in case the alias is not found.

-m

MSN: when used in combination with the -A command, instructs isdnconf to create a new MSN entry; the default is to create a new NUMBER entry. Only the values alias, number, SI, zone and interface are applicable to an MSN entry.

The following two options do not apply to the -A and -D commands. They only change the output format.

-s

short: only display the alias and the number.

-l

long: also display the programs to run ([START]).

-f 'filename'

file: usually isdnconf uses the /etc/isdn/callerid.conf and the ~/.isdn files. If isdnconf should be applied to another file, use this option.

-g

global: only applies to the -A and -D commands. Instead of editing ~/.isdn, /etc/isdn/callerid.conf is edited.

-1

first: only delete or display the first entry.

-M

isdnmon: used internally by isdnmon to get alias info.

AUTHOR

Andreas Kool <akool@isdn4linux.de>
manpage adapted from the README by Paul Slootman <paul@isdn4linux.de>

SEE ALSO

callerid.conf(5), isdnlog(8)