Provided by: isdnvboxserver_3.8.2005-12-06-2ubuntu4_i386 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>.