vgetty



vgetty(8)                        vgetty manual                       vgetty(8)




NAME

       vgetty - voice extension to the mgetty+sendfax program



SYNOPSIS

       vgetty [options] ttydevice

       vgetty  is  not meant to be run from the command line. It should be run
       from the /etc/inittab file so it can respawn after each call. Here is a
       typical inittab entry:

       S0:345:respawn:/usr/local/sbin/vgetty ttyS0

       If  you  already have a line in your inittab file which invokes mgetty,
       replace it with vgetty, since it replaces/extends its functionality.


DESCRIPTION

       vgetty is an extension to the mgetty+sendfax program which provides  an
       interface  to  voice-capable  modems. Use it to operate your modem as a
       simple answering machine or build your own sophisticated voice  messag-
       ing  system.   vgetty  handles  all the voice-modem specific protocols,
       giving application programs a uniform, modem-independent voice library.
       Supported    modems    include   many   common   serial   modems   from
       3com/USRobotics, Elsa, Multitech, ZyXEL, and  others.   Caller  ID  and
       Distinctive  Ring  are  supported provided you have subscribed to these
       services from your phone company.   Software-based  modems  (winmodems)
       are not supported.

       vgetty  comes  with tools to convert au/wav/voc sound files to/from the
       format used by most supported modems. Basic editing  and  filtering  of
       sound files is included as well. See pvf(1) for more information.


OPTIONS

       vgetty accepts the same options as mgetty.  The one’s relevant to voice
       mode are given here.  See mgetty(8) for other options related  to  data
       and fax modes.

       -a     Use  autobauding  (change  port  speed  to modem CONNECT speed).
              There is no voice modem that needs this, the option is just doc-
              umented for completeness.

       -m â€â€™expect send ...â€â€™
              Set the chat sequence that is used to initialize the modem.  For
              an empty expect part, use empty double quotes ("").   Since  the
              sequence  contains spaces, you will have to enclose all of it in
              single quotes (’’). Example:

              vgetty -m ’"" ATH0 OK’

       -n <rings>
              Set the number of rings after which vgetty will answer the phone

       -s <speed>
              Set  the  serial port speed to use, e.g. "-s 38400". This is the
              speed  of  communication  between  the  computer  and  modem  in
              bits/sec (baud).

       -x <log level>
              Set  the log verbosity level. Zero (0) means no logging, six (6)
              is really noisy. Use level six (6) when sending problem  reports
              to the maintainer. The log file is /var/log/vgetty.ttyXX.


ENVIRONMENT

       vgetty  sets  the following environment variables when calling external
       programs:

       CALLER_ID
              The caller’s telephone number.

       CALLED_ID
              The number the caller has dialed. Useful for ISDN with  multiple
              incoming phone numbers on the same physical line.

       CONNECT
              The   connect   string   as   reported   by   the   modem  (e.g.
              "38400/V.32bis/V.42bis ... ", etc.).

       DEVICE The tty device being used (e.g. "ttyS0").  Useful  for  handling
              multiple  devices ("messages on this line are for work, messages
              on the other line are personal").


RESOURCES

       vgetty is included in the mgetty+sendfax distribution. For  the  latest
       release, go to:

       ftp://alpha.greenie.net/mgetty/source

       The vgetty maintainer’s home page is at:

       http://www-internal.alphanet.ch/~schaefer/vgetty.html

       Send problem reports to:

       vgetty-maintainer@alphanet.ch

       For information on mgetty, go to:

       http://alpha.greenie.net/mgetty

       The  mgetty  mailing list is at mgetty@muc.de. The mailing list is mir-
       rored to the de.alt.comm.mgetty newsgroup.


FILES

       /etc/mgetty+sendfax/voice.conf
              Main configuration file for vgetty.  Many options here  override
              the equivalents found in /etc/mgetty+sendfax/mgetty.config

       /etc/nologin.ttyXX
              If  this  file  exists,  vgetty  will not answer calls on device
              ttyXX.

       /var/log/vgetty.ttyXX
              Debug log file for vgetty.

       /var/spool/voice/messages/Index
              List of greeting messages to use.

       /var/spool/voice/.code
              Access code for remote playback of messages  using  the  dtmf.sh
              script

       /var/spool/voice/.flag
              vgetty touches this file when a new message is received

       /var/spool/voice/.timestamp
              Used  by the dtmf.sh script to record last time of message play-
              back



DIAGNOSTICS

       If vgetty doesn’t work they way you think  it  should,  check  the  log
       file.   By  default,  it  is  located in /var/log/vgetty.ttyXX (for the
       vgetty process handling device ttyXX, e.g. ttyS0).


BUGS

       vgetty supports most standard voice modems, but  many  modems  are  not
       fully  compliant  with  relevant standards or contain firmware bugs. If
       you have problems, try upgrading your  modem  to  the  latest  firmware
       revision.  If  you discover a bug with how vgetty reacts to your modem,
       please email the maintainer (vgetty-maintainer@alphanet.ch)  describing
       your  problem.   Include  relevant  excerpts from the log file (set log
       level to six first), and details about your modem  (including  firmware
       revision) and operating system.


SEE ALSO

       mgetty(8), pvf(1)


COPYRIGHT

       vgetty  is Copyright (c) 1997-2001 Marc Schaefer (schaefer@alphanet.ch)
       and many others, before and after.

       This program is free software; you can redistribute it and/or modify it
       under  the  terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2 of the License, or (at  your
       option) any later version.

       This  man page was written by Barry Stewart <bstewart@smyrnacable.net>,
       and has CVS version: $Id: vgetty.8,v 1.1 2001/12/22 18:43:22 marcs  Exp
       $






version 0.60             $Date: 2001/12/22 18:43:22 $                vgetty(8)

Man(1) output converted with man2html