vbox.conf(5)						    Linux System Administration 					      vbox.conf(5)

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 CAL-
	      LERID 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  CAL-
	      LERIDS 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>.

ISDN 4 Linux 3.25						    2000/09/15							      vbox.conf(5)