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)
If you want another [Flags] entry, simply enter the data for
another program for this number at the point where the control-D
was given above.
If you want to add another number, simply enter the data for the
next number at the Alias prompt.
You can also pipe the data into this program; the input data then
must correspond to the prompts that the program gives! Note that
you can only add one number at a time then (there’s no way of
telling isdnconf that you want to stop giving Flags info and start
giving the next Alias info).
-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.
Examples (here for -n):
"*34*" matches 123456, 345677, 1234
"34*" matches 34567, 34111 but not 1234
"34??" matches 3411, 3456
"34" matches only 34
Without the -w option, these would match:
"*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)