vbox.conf
Section: Linux System Administration (5)
Updated: 2000/09/15
Page Index
NAME
vbox.conf - config file for vbox
Description
This file is used to configure when and on what conditions calls are
taken. It can also be used to define which CALLERID is used with which
person.
Everything after the "#" is ignored, as are empty lines. All arguments
must be separated by whitespace (spaces, tabs). Arguments may not contain
whitespace.
This file consists of several sections. A section begins with
"[" NAME "]". The section name is case insensitive. A section ends at the
end of the file or at the end of a new section.
These sections exist:
- [CALLERIDS]
-
This section maps CALLERID to persons and what settings to use.
On an incoming call the CALLERID of the caller is detected and compared
with this section. The SECTION of the first match is used.
Format : PATTERN SECTION REALNAME
-
- PATTERN
-
UN*X Pattern of a CALLERID. You may not use whitespace.
- SECTION
-
Name of a user section to use. You many not use whitespace.
With a "-" STANDARD will be used, with a "*" the REALNAME will be used.
- REALNAME
-
Full name of the person that should be mapped to the CALLERID. Here you
may use spaces.
-
-
At the end of the [CALLERIDS] Section, you should have the
entry "* - *** Unknown ***", so that also calls with no or unknown CALLERID
can be processed.
- [RINGS]
-
In this section you set when and after how many RINGs a call is taken.
This section is the first to be examined when a call is incoming to
determine if the call should be taken. The number of RINGs can be
overruled in the user section.
Format : TIME DAYS RINGS
-
- TIME
-
time when the call should be taken. Read the isdntime(5) man page for
details.
- DAYS
-
days when the call should be takes. Read the isdntime(5) man page for
details.
- RINGS
-
Number of rings to wait before taking the call. With version 2.0 of the
hisax isdn device driver the interval between two rings is longer (now
it's nearly like a telephone; 4 - 5 seconds between rings).
- user defined sections
-
Here you can make individual settings for some people. The section name
has the same format as the other sections. The names CALLERIDS and RINGS
are reserved.
Format : TIME DAYS MESSAGE RECTIME [FLAG] [...]
-
- TIME
-
time when the call should be taken. Read the isdntime(5) man page for
details.
- DAYS
-
days when the call should be taken. Read the isdntime(5) man page for
details.
- MESSAGE
-
Standard message to play for this call. You must either give the
filename with full path, or a filename relative to
/var/spool/vbox/<user>/messages. Default is "standard.msg". You may
not use spaces or tabs.
- RECTIME
-
Time in seconds: how long should vboxgetty record? Default is 60
seconds.
- FLAGS
-
You can additionally give these flags:
-
- NOANSWER
-
Don't answer this call. Default is to answer.
- NORECORD
-
Don't record a message. Default is to record.
- NOTIMEOUTMSG
-
Don't play timeout message. Default is to play.
- NOBEEPMSG
-
Don't play beep message. Default is to play.
- NOSTDMSG
-
Don't play std message. Default is to play.
- RINGS=
-
Number of rings to wait before taking the call. Here you can override
the [RINGS] section.
- TOLLRINGS=
-
Number of rings to wait before answering the call, if new messages are
available. This flag overrides the section [RINGS] and the flag RINGS=
if there are new messages. The directory to search for new messages must
be given with TOLLCHECK (or you can use the default).
- TOLLCHECK=
-
Directory to search for new messages. Default is
/var/spool/vbox/<user>/incoming.
- SCRIPT=
-
TCL-Script to start after taking the call. This must be the full path or
a filename relative to /var/spool/vbox/<user>. The default is
standard.tcl.
FILES
- /var/spool/vbox/<user>/vbox.conf
-
this configuration file.
- /usr/share/doc/isdnvboxserver/examples/vbox.conf
-
an example.
SEE ALSO
isdntime(5)
AUTHOR
This manual page was written by Andreas Jellinghaus <
aj@dungeon.inka.de>,
for Debian GNU/Linux and isdn4linux.
Now maintained by Paul Slootman <
paul@debian.org>.