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/doc/isdnutils/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/doc/isdnu
tils/examples 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
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 mes
sage, if these should be played and an alias for the cur
rent 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>/standard.tcl (unless you change
that name), and this script will do the rest (normally:
play standard and beep message, record and then play time
out 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.
Man(1) output converted with
man2html