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/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
       messaging  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 documented 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  mirrored  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 playback

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 $