vboxgetty.conf(5) [redhat man page]
vboxgetty.conf(5) Linux System Administration vboxgetty.conf(5) NAME
vboxgetty.conf - config file for vboxgetty Description The file /etc/isdn/vboxgetty.conf is used to configure vboxgetty. Please read the man page vboxgetty(8) for a description of how vboxgetty works. Everything after "#" is ignored, as are empty lines. All arguments must be separated by whitespace (spaces, tabs). Arguments may not con- tain whitespace. All settings before the first port command are global settings, after a port command they only affect the current port. port <string> ISDN device to configure. modeminit <string> Command to initialize the modem. You should set the MSN/EAZ on which vboxgetty should listen for incoming calls. Default is "ATZ". user <string> Name of the user that vboxgetty will use. This user must exist in /etc/passwd and you must use this parameter. group <string> Name of the group that vboxgetty will use. This group must exist in /etc/group and you must use this parameter. umask <number> Vboxgetty will use this umask when creating new files. You must give the umask as an octal number. Default is 077. dropdtrtime <seconds> Number of milliseconds to hold the DTR-Line low to reset the modem. Default value is 800. initpause <number> Number of milliseconds to wait after initializing the modem. This is used to compensate the delay of the "NO CARRIER" response. Default value is 1500. badinitsexit <number> Maximum failures with modeminit. If this number is reached, vboxgetty exits. Default is 0. ringtimeout <number> Time in seconds to wait for a RING. If no RING is received within this time, no call is taken. Default is 5. echotimeout <number> Time in seconds to wait for the echo from the modem. Default is 4. commandtimeout <number> Time in seconds to wait for a response to a modem command. Default is 4. alivetimeout <number> After this time in seconds vboxgetty will check if the modem is still responding to modem commands. Default is 1800. compression <string> Audio compression to use to record new messages. Possible values are ADPCM-2, ADPCM-3, ADPCM-4 and ULAW. The ALAW compression mode is no longer supported. Default is ULAW. spooldir <string> Spool directory to use. This directory must exist. It's used for control files of several programs. Default is /var/spool/vbox/<user>. vboxconfig <string> Full path of the vbox config file. Default value is <spooldir>/vbox.conf. freespace <number> Number of bytes that must be available on the partition with the spool directory, so that a call may be taken. Default is 0. FILES
/etc/isdn/vboxgetty.conf this configuration file SEE ALSO
vboxgetty(8), vbox(5), vboxtcl(5) AUTHOR
This manual page was written by Andreas Jellinghaus <aj@dungeon.inka.de>, for Debian GNU/Linux and isdn4linux. ISDN 4 Linux 3.1pre4 2000/09/15 vboxgetty.conf(5)
Check Out this Related Man Page
vboxgetty(8) Linux System Administration vboxgetty(8) NAME
vboxgetty - isdn voice box (getty) SYNOPSIS
vboxgetty [OPTION] [OPTION] [...] DESCRIPTION
Vboxgetty is the heart of vbox: it watches the isdn system and waits for incoming voice calls, OPTIONS
-f, --file FILE Config file to use. Default is the file '/etc/isdn/vboxgetty.conf'. -d, --device TTY ISDNdevice to use. You must use this option! -h, --help Show summary of options. -v, --version Show version of program. CONFIGURING VBOX
vboxgetty should be started from the init process. To do this you need one line per vboxgetty in /etc/inittab like this one: I5:2345:respawn:'/usr/sbin'/vboxgetty -d /dev/ttyI5 The next step is to set up a working configuration for all ports in /etc/isdn/vboxgetty.conf: read vboxgetty.conf(5) how to do this and look at the example config file in /usr/share/doc/isdnvboxserver/examples. You should then create the spool directories for each user: /var/spool/vbox/<user>, /var/spool/vbox/<user>/incoming and /var/spool/vbox/<user>/messages. Copy the example config files vbox.conf and standard.tcl from /usr/share/isdnvboxserver/default/ to /var/spool/vbox/<user>, read the man pages vbox.conf(5) and vboxtcl(5) and edit these config files. Change the owner of all files in /var/spool/vbox/<user> with "chown <user>.<group> /var/spool/vbox/<user> -Rv" and correct the permissions with "chmod o-rwx,g-rwx /var/spool/vbox/<user> -Rv". The last step: run "init q" to force init to reread /etc/inittab HOW IT WORKS
For each line in /etc/inittab one vboxgetty is started by init. Make sure the first field (ID) and the device file are different. Each vboxgetty does this: First /etc/isdn/vbox.conf is read, the global settings are loaded and then the port specific settings. Then vboxgetty waits for an incoming call. On an incoming call vboxgetty reads /var/spool/vbox/<user>/vbox.conf (unless you change that name), and vboxgetty determines if it should take that call or how many RINGs it should wait. It also gets the name of the standard message, beep message, timeout message, if these should be played and an alias for the current caller, if there is one. If vbox has waited enough RINGs and the caller is still ringing, it takes the call and starts the tcl script /var/spool/vbox/<user>/stan- dard.tcl (unless you change that name), and this script will do the rest (normally: play standard and beep message, record and then play timeout message). FILES
/etc/isdn/vboxgetty.conf default config file /etc/inittab init starts vboxgetty via this file. /etc/isdn/vboxgetty.conf the global vbox config file /var/spool/vbox/<user>/vbox.conf the per user configuration file for this port /var/spool/vbox/<user>/standard.tcl the tcl script used to communicate with the caller /var/run/vboxgetty-<device>.pid process id of the vboxgetty /var/log/vbox/vboxgetty-<device>.log logfile of the vboxgetty SEE ALSO
vboxgetty.conf(5), vbox.conf(5), vboxtcl(5), isdntime(5) AUTHOR
This manual page was written by Andreas Jellinghaus <aj@dungeon.inka.de>, for Debian GNU/Linux and isdn4linux. ISDN 4 Linux 3.25 2000/09/15 vboxgetty(8)