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/share/doc/isdnvboxserver/exam‐
38       ples.
39
40       You   should   then   create  the  spool  directories  for  each  user:
41       /var/spool/vbox/<user>,       /var/spool/vbox/<user>/incoming       and
42       /var/spool/vbox/<user>/messages.   Copy   the   example   config  files
43       vbox.conf and standard.tcl from  /usr/share/isdnvboxserver/default/  to
44       /var/spool/vbox/<user>,  read the man pages vbox.conf(5) and vboxtcl(5)
45       and edit these config files.
46
47       Change the owner of all files  in  /var/spool/vbox/<user>  with  "chown
48       <user>.<group>  /var/spool/vbox/<user> -Rv" and correct the permissions
49       with "chmod o-rwx,g-rwx /var/spool/vbox/<user> -Rv".
50
51
52       The last step: run "init q" to force init to reread /etc/inittab
53

HOW IT WORKS

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

FILES

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

AUTHOR

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