vboxputty(8) [redhat man page]

VBOXPUTTY(8)						      System Manager's Manual						      VBOXPUTTY(8)

NAME

       vboxputty - a self-dialing/-calling vboxgetty

SYNOPSIS

       vboxputty -d device [-f config-file] [-c phonenumber] [-s ring-timeout] [-w wait] [-t redial] [-r redial-pause]

       vboxputty [-hv]

DESCRIPTION

       vboxputty  is  a  vboxgetty,  not waiting for, but triggering a call. After connect, vboxputty is acting exactly like vboxgetty.  vboxputty
       exits with 0 if a connection was established, 99 on BUSY.

OPTIONS

       -h     display a short help

       -v     display the version information

       -f config-file
	      use config-file instead of the default vboxgetty.conf

       -d device
	      use device (/dev/ttyI*) for dialout

       -c phonenumber
	      the phonenumber to be called

       -s ring-timeout
	      vboxputty will dial the phonenumber and wait ring-timeout seconds for the called party to accept the call, if  ring-timeout  seconds
	      are ellapsed before connect, vboxputty will hangup.

       -w wait
	      after the connection is established, vboxputty will wait wait seconds before starting the tcl-script

       -t redial
	      if the called party is BUSY, vboxputty will try redial times to get a connect

       -r redial-pause
	      vboxputty waits redial-pause seconds between BUSY-redials

FILES

       /usr/local/vbox/etc/vboxgetty.conf

AUTHOR

       Gerrit Pape <pape@innominate.de>

SEE ALSO

       the vbox-documentation

4th Berkeley Distribution					 13. January 2000						      VBOXPUTTY(8)

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)