bionic (5) vbox.conf.5.gz

Provided by: isdnvboxserver_3.25+dfsg1-9ubuntu2_amd64 bug

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