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:
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.
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 $