ISDNCONF(1)
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 isd
- nconf 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>