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