vboxgetty(8)

1vboxgetty(8)              Linux System Administration             vboxgetty(8)
2
3
4

NAME

6       vboxgetty - isdn voice box (getty)
7

SYNOPSIS

9       vboxgetty [OPTION] [OPTION] [...]
10

DESCRIPTION

12       Vboxgetty  is  the  heart of vbox: it watches the isdn system and waits
13       for incoming voice calls,
14

OPTIONS

16       -f, --file FILE
17              Config    file    to    use.     Default     is     the     file
18              '/etc/isdn/vboxgetty.conf'.
19
20       -d, --device TTY
21              ISDNdevice to use. You must use this option!
22
23       -h, --help
24              Show summary of options.
25
26       -v, --version
27              Show version of program.
28

CONFIGURING VBOX

30       vboxgetty  should be started from the init process. To do this you need
31       one line per vboxgetty in /etc/inittab like this one:
32
33       I5:2345:respawn:/usr/sbin/vboxgetty -d /dev/ttyI5
34
35       The next step is to set up a working configuration  for  all  ports  in
36       /etc/isdn/vboxgetty.conf:  read  vboxgetty.conf(5)  how  to do this and
37       look at the example config file in /usr/doc/isdnutils/examples.
38
39       You  should  then  create  the  spool  directories   for   each   user:
40       /var/spool/vbox/<user>,       /var/spool/vbox/<user>/incoming       and
41       /var/spool/vbox/<user>/messages.  Copy   the   example   config   files
42       vbox.conf   and   standard.tcl   from   /usr/doc/isdnutils/examples  to
43       /var/spool/vbox/<user>, read the man pages vbox.conf(5) and  vboxtcl(5)
44       and edit these config files.
45
46       Change  the  owner  of  all files in /var/spool/vbox/<user> with "chown
47       <user>.<group> /var/spool/vbox/<user> -Rv" and correct the  permissions
48       with "chmod o-rwx,g-rwx /var/spool/vbox/<user> -Rv".
49
50
51       The last step: run "init q" to force init to reread /etc/inittab
52

HOW IT WORKS

54       For  each  line in /etc/inittab one vboxgetty is started by init.  Make
55       sure the first field (ID) and  the  device  file  are  different.  Each
56       vboxgetty does this:
57
58       First  /etc/isdn/vbox.conf  is read, the global settings are loaded and
59       then the port specific settings. Then vboxgetty waits for  an  incoming
60       call.
61
62       On  an  incoming  call vboxgetty reads /var/spool/vbox/<user>/vbox.conf
63       (unless you change that name), and vboxgetty determines  if  it  should
64       take  that call or how many RINGs it should wait. It also gets the name
65       of the standard message, beep message, timeout message, if these should
66       be played and an alias for the current caller, if there is one.
67
68       If  vbox  has  waited  enough RINGs and the caller is still ringing, it
69       takes the call and starts the tcl  script  /var/spool/vbox/<user>/stan‐
70       dard.tcl  (unless  you  change  that name), and this script will do the
71       rest (normally: play standard and beep message, record  and  then  play
72       timeout message).
73

FILES

75       /etc/isdn/vboxgetty.conf
76              default config file
77
78       /etc/inittab
79              init starts vboxgetty via this file.
80
81       /etc/isdn/vboxgetty.conf
82              the global vbox config file
83
84       /var/spool/vbox/<user>/vbox.conf
85              the per user configuration file for this port
86
87       /var/spool/vbox/<user>/standard.tcl
88              the tcl script used to communicate with the caller
89
90       /var/run/vboxgetty-<device>.pid
91              process id of the vboxgetty
92
93       /var/log/vbox/vboxgetty-<device>.log
94              logfile of the vboxgetty
95

AUTHOR

100       This   manual   page   was  written  by  Andreas  Jellinghaus  <aj@dun‐
101       geon.inka.de>, for Debian GNU/Linux and isdn4linux.
102
103
104
105ISDN 4 Linux 3.13                 2000/09/15                      vboxgetty(8)