vgetty8

Usage

Overview

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:

[email protected]

For information on mgetty, go to:

http://alpha.greenie.net/mgetty

The mgetty mailing list is at [email protected]. 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).