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 $