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>.