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 $