Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
vgetty(8)			 vgetty	manual			     vgetty(8)

       vgetty -	voice extension	to the mgetty+sendfax program

       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/local/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.

       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  messag-
       ing  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/US-
       Robotics, Elsa, Multitech, ZyXEL, and others.  Caller ID	 and  Distinc-
       tive  Ring are supported	provided you have subscribed to	these services
       from your phone company.	 Software-based	 modems	 (winmodems)  are  not

       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.

       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 doc-
	      umented 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.

       vgetty sets the following environment variables when  calling  external

	      The caller's telephone number.

	      The  number the caller has dialed. Useful	for ISDN with multiple
	      incoming phone numbers on	the same physical line.

	      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").

       vgetty  is  included in the mgetty+sendfax distribution.	For the	latest
       release,	go to:

       The vgetty maintainer's home page is at:

       Send problem reports to:

       For information on mgetty, go to:

       The mgetty mailing list is at The	mailing	list  is  mir-
       rored to	the de.alt.comm.mgetty newsgroup.

	      Main  configuration file for vgetty.  Many options here override
	      the equivalents found in /etc/mgetty+sendfax/mgetty.config

	      If this file exists, vgetty will	not  answer  calls  on	device

	      Debug log	file for vgetty.

	      List of greeting messages	to use.

	      Access  code  for	 remote	playback of messages using the

	      vgetty touches this file when a new message is received

	      Used by the script to record last	time of	message	 play-

       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).

       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 re-
       vision. If you discover a bug with how vgetty  reacts  to  your	modem,
       please  email the maintainer ( 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.

       mgetty(8), pvf(1)

       vgetty is Copyright (c) 1997-2001 Marc Schaefer	(
       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  <>,
       and  has	CVS version: $Id: vgetty.8,v 1.1 2001/12/22 18:43:22 marcs Exp

version	0.60		 $Date:	2001/12/22 18:43:22 $		     vgetty(8)


Want to link to this manual page? Use this URL:

home | help