vbox.conf

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 con-
       tain 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	 CAL-
		  LERID. 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  incom-
	      ing  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	 ver-
		  sion	2.0  of	 the  hisax  isdn  device driver the interval
		  between two rings is longer (now it’s nearly like  a	tele-
		  phone; 4 - 5 seconds between rings).

       user defined sections
	      Here you can make individual settings for some people. The sec-
	      tion 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/doc/isdnutils/examples/vbox.conf
	      an example.

SEE ALSO
       isdntime(5)

AUTHOR
       This   manual   page  was  written  by  Andreas	Jellinghaus  <aj@dun-
       geon.inka.de>, for Debian GNU/Linux and isdn4linux.



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