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
$