From owner-mgetty Sat Jun  4 05:04:39 1994
Return-Path: <owner-mgetty>
Received: by greenie.muc.de (/\==/\ Smail3.1.24.1 #24.2)
	id <m0q9m2I-0002BXC@greenie.muc.de>; Sat, 4 Jun 94 05:04 MEST
Return-Path: <colin!l-mgetty-owner>
Received: by greenie.muc.de (/\==/\ Smail3.1.24.1 #24.2)
	id <m0q9m2H-0001FIC@greenie.muc.de>; Sat, 4 Jun 94 05:04 MEST
Received: from reinfra.regent.e-technik.tu-muenchen.de ([129.187.231.147]) by colin.muc.de with SMTP id <136074(2)>; Sat, 4 Jun 1994 00:41:43 +0200
Received: from nyssa.wa7ipx.ampr.org ([198.187.188.2]) by reinfra.regent.e-technik.tu-muenchen.de with SMTP id <396>; Fri, 3 Jun 1994 23:04:52 +0200
Received: from lingua7 by nyssa.wa7ipx.ampr.org with uucp
	(Smail3.1.28.1 #1) id m0q9gMr-0003UqC; Fri, 3 Jun 94 14:01 PDT
Received: by work.bellingham.wa.us (Smail3.1.28.1 #14)
	id m0q9eVO-0000XWC; Fri, 3 Jun 94 12:02 PDT
Message-Id: <m0q9eVO-0000XWC@work.bellingham.wa.us>
Date:	Fri, 3 Jun 1994 21:02:00 +0200
From:	steve@work.bellingham.wa.us (Steven Work)
To:	mgetty@muc.de
Subject: Mgetty+Sendfax Answers to Frequently-Asked Questions
Status: RO

Subject: Mgetty+Sendfax with Vgetty Extensions (FAQ)            -*- Text -*-
Newsgroups: comp.dcom.fax,comp.dcom.modems,comp.answers,news.answers
Followup-To: poster
Reply-to: steve@work.bellingham.wa.us (Steven Work)
Summary: Information about mgetty+sendfax, a Unix getty replacement
Keywords: class2 fax mgetty sendfax modem digifax

Archive-name: <tbd>
Last-modified: 3 June 1994

			  ``mgetty+sendfax''
		Answers to Frequently-Asked Questions
       regarding Gert Doering's Fax-enabled getty replacement,
		with Klaus Weidner's voice extensions

			     Steven Work
		     steve@work.bellingham.wa.us

------------------------------

Subject: Introduction

This document attempts to answer the most frequently asked questions
about mgetty+sendfax/vgetty, Gert Doering's fax-enabled getty
replacement with Klaus Weidner's voice processing extensions.  

------------------------------

Subject: Table of Contents

---------------------------

Subject: Part I: "Deciding whether to use it" questions

------------------------------

Subject:  What is it?
From: steve@work.bellingham.wa.us (Steve Work)

Mgetty+sendfax is a collection of programs to send and receive
faxes in a unix environment using a class 2 faxmodem.  vgetty is an
extension to mgetty, distributed with it, that implements incoming
voice call handling for certain voice-capable modems, notably the
ZyXEL.

More specifically, the program `mgetty' allows you to use a class 2
fax modem for receiving faxes and handling external logins without
interfering with outgoing calls.  `sendfax' is a standalone program
which sends fax files.  `vgetty' is an extended version of mgetty
that can answer the telephone like an answering machine and record
a voice-mail message (if it finds one), or perform `mgetty's fax or
data call handling otherwise.  The mgetty+sendfax distribution
includes vgetty and a good-sized gob of utility programs that help
you manage faxes and voice messages.

------------------------------

Subject:  What does it look like when it runs?
From: steve@work.bellingham.wa.us (Steven Work) and the distribution
CC: clewis@ferret.ocunix.on.ca (Chris Lewis)

Like a smarter `getty'.  getty is the program that manages the
first step of the login procedure on a Unix computer; when used
with a modem, it watches for an incoming call and (ordinarily)
prints the "login:" prompt (and reads the username, and passes off
to "login").

Unlike traditional versions of getty or uugetty, which will put a
modem into auto-answer mode, mgetty does not.  When an incoming call
occurs, mgetty sees the "RING"s when they occur.  When they do occur,
mgetty tells the modem to answer, and the modem will tell mgetty what
kind of connection happens.  If it is FAX, mgetty will receive the
FAX.  If data, mgetty prompts for a userid, then hands the open line
off to login for a normal data login.

Note that it's the modem's job to distinguish a FAX call from a data
call.  Not all fax modems can do this, and if yours _can't_ there is no way
for mgetty to do this for it.  mgetty can be used with modems that
cannot distinguish a fax call from a data call, but you must tell it
ahead of time what type of call to expect.

mgetty is also configurable to select programs other than login for
special connections (eg: uucico, fido or other programs) depending
on the login userid.

mgetty also supports caller-id and can deny connections based on
originating telephone number.

vgetty is an extension to mgetty that works with voice-capable
modems to provide additional call-handling capabilities.  When the
modem reports a RING, vgetty has the modem pick up the line and
play a voice message (the greeting).  Then, as for mgetty, the
modem reports the connection type.  If it hears "noises" it can't
identify (like your mother's voice) it reports a voice connection
and vgetty records the noise as an incoming voice message.  If the
modem reports that it identifies a fax tone, vgetty acts like
mgetty and receives a fax (or answers a poll).

If instead the modem hears nothing following the greeting (a
certain level of silence that continues for a certain number of
seconds) it assumes the caller is a data modem and attempts a data
connection.

vgetty implements the normal answering-machine functions of
remote message playback as well; its operation is driven from shell
scripts, so you can extend it to a full voice-mail jail if you
wish.  (This description of voice modem behavior applies to the
ZyXELs; I [steve@work.bellingham.wa.us] assume other voice modems
are similar.)

vgetty is intended for people who want to share a phone line for
data and voice use, with the main focus being voice calls. It is
*NOT* intended for a dialup system that occasionally gets a voice
call, since some modems are confused by hearing a recorded voice
message and won't connect.

Note that the voice extensions are maintained by Klaus Weidner
(klaus@snarc.greenie.muc.de), so direct questions about them to
that address. 

More from the distribution (some edits):

This is what you can do with `sendfax' if you have a standard class
2 fax modem:

* send faxes directly or using shell scripts (easily integrated into
  other applications).

* do "fax polling", this means you can call the weather station and
  get them to send you a fax containing the current weather map.
  (Not all modem manufacturers implement this feature in their
  modems!)

* create a "fax queue", outgoing faxes get sent automatically, the
  user is informed by mail about the result.

`mgetty' allows you to use a single modem line for receiving calls
and dialing out.

* `mgetty' knows about "smart" modems, and will make sure that the
  modem is always in a defined state (specific modem initialization
  possible)

* Incoming calls are answered manually (`RING' -> `ATA' ->
  `CONNECT') instead of using auto-answer (`ATS0=1'), this way the
  modem won't pick up the phone when the machine is down or logins
  are not allowed.

* mgetty completely replaces getty and/or uugetty.  Like uugetty,
  supports lock files in a fashion compatible with almost all known
  versions of UUCP (HDB/BNU, SVR4, V7, Taylor in various flavours).
  uugetty has some features mgetty doesn't support; see "How does
  mgetty differ from uugetty?" below.

* mgetty supports System V style gettydefs terminal configurations.
 
* mgetty can receive class 2 faxes (if your modem supports it).

* mgetty knows about incoming FidoNet calls.

* mgetty has extensive logging / debugging features

* do "fax poll sending", that is, you can setup your machine as fax
  poll server, to send some fax pages to "fax poll" callers. (Send
  informations about your system, the current wheather map, ...). Be
  warned, even less modems support this feature.

* mgetty can selectively refuse calls based upon CallerID, if your
  modem supports it, and you're subscribed to the service. CallerID
  is also logged.

* mgetty has facilities to allow you to refuse incoming FAXes when
  available disk space is low.

vgetty inherits most of mgettys features, and offers some additional
ones:

* behaves like a normal answering machine for human callers

* automatic fax reception when a T.30 calling tone is detected

* If the caller isn't a human or fax, a data connect is attempted,
  if this is successful, the caller will get a normal login

* does not interfere with dialouts

* remote playback of messages via a DTMF code

* toll saver -- if there are new messages, pick up the phone
  earlier, this way you can hang up in time to avoid a useless call

* message light - the autoanswer LED of your modem (if it has one)
  is turned on if there are new messages

* easy playback - on some modems, you can play back the new messages
  just by pressing DATA/VOICE

* speech synthesizer support - add the date and time to messages
  (not included by default)

* voice conversion utilities - play messages on /dev/audio

------------------------------

Subject:  What do I need to use mgetty+sendfax/vgetty?
From: steve@work.bellingham.wa.us (Steve Work), and distribution
CC: clewis@ferret.ocunix.on.ca (Chris Lewis)

Several things.  A computer running some (most) variants of the Unix
operating system.  (The operating system must support termio.h or
termios.h; this generally rules out "pure BSD" systems.)  For support
of dial-in data connections (a la "getty"), you need a modem (probably
one somewhat compatable with the H*yes "AT" command set).  For sending
and receiving faxes, you need a modem that understands the Class 2 (or
2.0) fax command set.  For voice processing, you need a modem that is
capable of doing voice.  

The ZyXEL family of modems is fully supported; the Dolphin and Zoom
modems are supported less completely.  In particular, the voice data
format used by the Dolphin and Zoom modems is considered proprietary
by Rockwell, the manufacturer of the chipset used in these modems.
Gaining access to the internal format of the voice files used and
created by the Rockwell-chip voice modems would require signing a
non-disclosure agreement, and that in turn would prevent the source
code from being freely-distributable.  A patch exists that makes it
possible for zplay and vgetty to playback and record voice on a
Rockwell-based modem.

Mgetty has been successfully installed and run on the following
systems:

      SCO Unix 3.2.1 (ODT 1.0)                    (very well tested)
      SCO Unix 3.2.4 (ODT 2.0 + 3.0)              (very well tested)
      Linux 0.99pl1 .. 1.0                        (very well tested)
      ISC Unix 3.0                                (tested)
      SVR4 Unix                                   (well tested)
      AT&T 3B1 3.51m                              (well tested)
      HP-UX 8.x                                   (well tested)
      AIX                                         (mgetty, not vgetty)
      SunOS 4.1.1                                 (well tested)
      NetBSD / FreeBSD                            (works)
      BSDI v1.1                                   (under work, not done --
                                                         greg@wwa.com)

It should be possible to run mgetty on any other Unix with
`termio.h' or `termios.h'. For best results, `select(S)' or
`poll(S)' are recommended, but there's a workaround. (Warning: for
Unix SVR3.1 or earlier, *do not use poll()*, it will not work on
tty devices.) 

Up to now, it has been successfully used with the following modems
(no exhaustive list): 

      ZyXEL U1496
	(very well tested.  With some ROM versions, one or another
	function is not working.  ROM 6.12 works great)

      SupraFAX v32bis
        (tested, works well, no fax polling available, no voice)
  
      GVC FM144/+
  	(tested, works well, no fax polling available, no voice)
  
      TKR DM-24VF+ (Deltafax)
  	(tested, works quite well, dunno about polling, no voice)

Mgetty *should* work with all class 2 faxmodems. Maybe the DC2
character sent at the beginning of a page by `faxrec.c' must be
changed to XON, for old class 2 modems (implementing very old drafts
of the standard).  Unfortunately, each class 2 modem can be a tiny bit
different.  

Gert says, however: "Most modems worked "more-or-less", found only one
that didn't work *at all*. [...]  `Class 2.0' is the official
standard [and all "class 2.0" modems should work well with mgetty.]
The only ``modem difference'' so far is that USR implemented it in a
broken fashion, to behave similarily to all the (broken! all of them
are!) class 2 modems. ("REVERSE")

The rest of this section is a more complete list of modems together
with comments and the policy.h settings required to make them work:

Modem brand/model: 	"Dynalink 9624AP"
at+fmfr?		EXAR
at+fmdl?		9648,2,E,290X
at+frev?		10, 10, 92   REVISION  X 2.0
ati3			ADN-06
ati4			MARROW 2900KSX V2.0B 11-05-1992
tested on:		linux 0.99p10
working:		sendfax, mgetty(?)
remarks: avoid this cheap and nasty modem if you possibly can. It needs:
         delay(500) at the end of fax_open_device(), sendfax.c line 111
         delay(500) after the call to fax_send_page(), sendfax.c line 533
         "\d\d\d" in all the AT-commands in init_chat_seq, mgetty.c
contributor:		a.j.scholl@durham.ac.uk
#define DATA_FLOW	FLOW_HARD
#define FAXREC_FLOW	FLOW_HARD | FLOW_SOFT
#define FAXSEND_FLOW	FLOW_HARD 
#define FAX_SEND_BAUD 	B19200
#define FAX_MODEM_HANDSHAKE ""
#define FAX_SET_CSTOPB	1        /* for when you've added this option :-) */
----------------------------------------------------
Modem brand/model: 	"Zoltrix Platinum Series 14.4"
at+fmfr?		ROCKWELL
at+fmdl?		RC32ACL
at+frev?		V1.410-AP39
ati3			
ati6			RCV144DP; Rev CA
tested on:		linux 0.99p7
working:		mgetty, sendfax
remarks:                great modem! In my uucp network of 16 machines,
			this modem averages at 1700 bps, while other
			brand name modems such as the Trailblazer PEP
			maxes out at about 1570. 
contributor:		whome!light-house!las@planix.com
#define DATA_FLOW	FLOW_HARD
#define FAX_COMMAND_DELAY 50
#define FAXREC_FLOW	FLOW_SOFT
#define FAXSEND_FLOW	FLOW_SOFT
#define FAX_SEND_BAUD B38400
#define FAX_MODEM_HANDSHAKE "&K3"
#define MODEM_INIT_STRING	"ATS0=0V1Q0&D3&K3%C1W1"
----------------------------------------------------
Modem brand/model:      PCMCIA Modem HOTLINE 960 CC HL9672CC
AT+FMFR?                HOTLINE
AT+FMDL?                Handy 9672 CC
AT+FREV?                Version 1.03H
ATI3                    V1.03DP
ATI4                    Handy 9672 CC H1_103
AT+FDCC=?               (0,1),(0-3),(0-2),(0-2),(0,1),0,0,(0-7)
tested on:              OS: Linux, Kernel: 1.0, Distribution: Slackware 1.2.0
			Computer: Toshiba T4700C Notebook
working:                sendfax, mgetty
contributor:            lauther@zfe.siemens.de
remarks:                can only do 9600 bps

#define DEFAULT_PORTSPEED       B19200
#define MODEM_INIT_STRING       "ATS0=0Q0&D3&K3"
#define MODEM_CMD_SUFFIX        "\r"
#define DO_CHAT_SEND_DELAY      50
#define FAX_COMMAND_DELAY       50
#define DATA_FLOW               FLOW_HARD
#define FAXREC_FLOW             FLOW_HARD | FLOW_SOFT
#define FAXSEND_FLOW            FLOW_HARD | FLOW_SOFT
#define FAX_SEND_BAUD           B19200
#define FAX_MODEM_HANDSHAKE     "&K3"
----------------------------------------------------
Modem brand/model:      Creatix (1&1) Polimedia 14400 voice / fax modem
AT+FMFR?                ???
AT+FMDL?                ???
AT+FREV?                ???
ATI0			14400
ATI1			007
ATI3			V1.400/T4-DS29F
ATI4			Creatix Polymedia GmbH V1.41 29/11/93
ATI6			RCV144DPi Rev CA
AT+FDCC=?               (0,1),(0-5),(0-2),(0-2),(0,1),0,0,(0-7)
tested on:              ???
working:                sendfax, mgetty
contributor:            andreas@malcolm.in-chemnitz.de

#define DEFAULT_PORTSPEED	B38400
#define MODEM_INIT_STRING	"ATS0=0Q0&D3&K6"
#define MODEM_CMD_SUFFIX	"\r"
#define DO_CHAT_SEND_DELAY	50
#define FAX_COMMAND_DELAY	50
#define DATA_FLOW       	FLOW_HARD
#define FAXREC_FLOW     	FLOW_HARD | FLOW_SOFT
#define FAXSEND_FLOW    	FLOW_HARD | FLOW_SOFT
#define FAX_RECEIVE_USE_B19200
#define FAX_SEND_BAUD 		B19200
#define FAX_MODEM_HANDSHAKE	"&K6"
----------------------------------------------------

------------------------------

Subject: What other software do I need?
From: clewis@ferret.ocunix.on.ca (Chris Lewis)
CC: gert@greenie.muc.de (Gert Doering)

For data only, no other software is needed.

mgetty itself can only send or receive G3 (raster) format.  However,
the distribution includes tools to convert raw G3 files to or from the
format used by "pbmplus", the Portable Bitmap Toolkit.  The pbmplus
formats support (or are supported by) most raster-image programs and
file formats generally used in the Unix world.  pbmplus is available
at this URL (among others): ftp:// ??  The mgetty+sendfax distribution
contains a patch to fix pbmplus's broken pbmtog3 converter -- using
the unpatched pbmtog3 can cause errors during transmission.

GhostScript, the free Postscript page description language
interpreter, can convert PostScript to G3.  Ghostscript is available
at this URL (among others): ftp:// ??

Hp2pbm, available from ftp:// ??, can convert text
and PCL (HP Laserjet language) to G3 or PBM.  It also contains
programs for converting PBM to PostScript, PCL and Epson printers.

PBMPLUS has converters from most existing raster formats or ASCII
to PBM, and from PBM to most raster formats.  You'd use the pbmtog3
and g3topbm utilities in mgetty to convert between PBM and G3.

In essence, you can run with hp2pbm or PBMPLUS alone.  With GhostScript,
you also need PBMPLUS or hp2pbm to convert ASCII (used for page headers
etc.) to G3.

For voice you need no other software, although utilities to convert to
and from the ZyXEL voice format can be handy.  This is especially true
if you have audio output available besides the modem itself.

mgetty+sendfax includes some ZyXEL voice processing utilities in the
voice/ subdirectory.  These can translate ZyXEL voice files to and
from Sun-AU (/dev/audio), Soundblaster, some other formats.

------------------------------

Subject:  What terms cover my use of mgetty+sendfax/vgetty?

>From the distribution:

"The mgetty+sendfax package is Copyright (c) 1993 Gert Doering. You
are permitted to do anything you want with this program -
redistribute it, use parts of the code in your own programs, ...,
but you have to give me credit - do not remove my name.

"If the program works for you, and you want to honour my efforts,
you are invited to donate as much as you want.

"If you make money with mgetty, I want a share. What I mean by that
is: it's perfectly OK with me to get paid for mgetty installation
or support, but if you want to actually sell mgetty, or pack mgetty
with a modem and sell it as "unix fax package", contact me first.

"*WARNING:* This package is still BETA software. Use it at your own
risk, there is *no* warranty. If it erases all the data on your
hard disk, damages your hardware, or kills your dog, that is
entirely your problem. Anyway, the program works for me and quite a
lot of other people."

------------------------------

Subject:  Where can I get mgetty+sendfax?

The official release sites are these URLs:

  ftp://sunsite.unc.edu/pub/Linux/system/Serial/mgetty+sendfax*
  ftp://tsx-11.mit.edu/pub/linux/sources/usr.bin/... (or so)

You can certainly find them elsewhere.  The last time this paragraph
was updated, the most recent full release was 0.20.

The most recent _test_ release is generally available at this URL:

   ftp://ftp.informatik.tu-muenchen.de:/tmp/mgetty*.tar.gz

------------------------------

Subject: What image file formats does mgetty recognize?
From:	gert@greenie.muc.de (Gert Doering)

Fax input format:

   raw G3 data (according to CCITT standard T.4, 1-dimensionally
   compressed). Can be created by GhostScript's "dfaxhigh" or "dfaxlow"
   drivers (they will create raw G3 data with a 64 byte header, that
   sendfax + g3cat + g3topbm will recognize and skip) or by the "pbmtog3"
   program.
   Warning: the pbmtog3 program from the "pbmplus" distribution does *not*
   create valid G3 data according to T.4, to be precise, the lines are
   shorter than 1728 pixels and the leading EOL code is missing. To fix
   it, use the patch that is provided in "patches/pbmtog3.p1". Even
   better, use my own utility. (The patch is *NOT* needed for my pbmtog3
   program!).
   Use of a unpatched pbmtog3 will most likely cause +FHNG:50 or +FHNG:54
   error codes.

   Do not use "tiff-G3" data as input. Though the data itself is G3 encoded,
   it's wrapped into a very complex layer of TIFF headers that would
   require non-trivial parsing that's simply not needed for sendfax.
   Faxing a TIFF file will result in a warning message from sendfax, and,
   most likely, in a failed transmission...


Fax output format:

   The files that mgetty places into FAX_SPOOL_IN are in the same format
   as the files that sendfax wants to send, raw G3 data as of CCITT T.4.
   To convert them to "pbm", use the g3topbm program. To convert them to
   X-Windows xwd format, use the "contrib/g3toxwd" program.

   If the files are received without transmission errors, it is possibly
   to send received fax files without any additional conversion. Since
   some modems insert filling zero-bits, a run through "g3cat" is
   recommended anyway, this will remove any surplus stuff, and clean up
   garbled lines.

------------------------------

Subject: Why doesn't mgetty accept other file formats besides G3?

Why does mgetty only send raw G3 fax files, instead of converting
arbitrary image files (like TIFF) on the fly?

>From Chris Lewis:

"As I understand it, in addition to its own formats, TIFF can encapsulate
some number of other formats.  Put another way, TIFF is, at least to some
extent, simply a way of getting magic numbers into other formats so that
TIFF-capable converters can handle multiple formats transparently.

"Yes, you certainly can have TIFF encapsulate a G3, and mgetty wouldn't
have much trouble with that.  However, that leaves you with the question -
what does mgetty do if it's not a G3 that's been encapsulated?  It
would have to convert it.  And then we would encounter situations where
mgetty's conversion speeds couldn't meet the class II FAX transmission
timeouts, and you've wasted telephone time...  Ditto on reception.  Indeed,
there is a real possibility that mgetty would not be able to keep up
if the input or output file was anything other than a G3.

"Approaching this from another viewpoint, we should also remember that
mgetty is a transfer protocol and implementation.  *Not* conversion
software.  mgetty needs to read and write G3s, and that's all.  Leave
conversions to other software."

And from Gert Doering:

"Well, TIFF is a very complex file format, that can support dozens of
different page data encodings, different byte / bit orderings, multiple
pages per file, ... -> parsing it is very complex, look at Sam Leffler's
TIFF-Library, which is quite huge.

"On the contrary, mgetty's "g3" files are raw G3 data. No headers, no
formating, no "digging around" in the file to find the actual page
data, one page per file, simplest possible.

"Not using TIFF simplifies mgetty and sendfax enormously, but doesn't
complicate the user interface much, as long as "faxspool" or similar tools
are used that will hide the internals, that is, how the fax backend expect
its data, from the user. To be precise, to not use TIFF *simplifies* using
mgetty, because nearly every Unix program can read pbm and converting g3
-> pbm is very easy, while I haven't seen a good *multipage*-Tiff - to -
PBM converter yet."

------------------------------

Subject: Troubleshooting questions & answers
From: gert@greenie.muc.de

Q: I keep getting the error code +FHNG:50 or +FHNG:54 after sending a
   page. Sometimes it says "page bad, retrain requested" and infinitely
   resends the page.

A: This error means that something went wrong between the two machines,
   while your end was sending the page data. In the case of +FHNG:50 or
   +FHNG:54, the other end most likely simply hung up (so your modem
   couldn't get any page transfer status at all), in the other case, the
   receiver complained that it didn't like the data on the page.

   The most common reason for this behaviour is that you used a copy
   of ``pbmtog3'' that came from the ``pbmplus'' distribution and doesn't
   have my patch included (Mind you, the pbmtog3 program is required for
   the page headers that faxspool puts on top of each page!).

   If that is not the reason, there may be flow control problems, or the
   line have simply has been very noisy, or so. Get in touch with the
   receiver, and find out whether the page looks good or whether there are
   lines missing, others corrupted, ... - if there are errors, check your
   flow control setting.

   If there are no errors whatsoever, and you're sure that you use my
   version of pbmtog3 or a patched version of pbmplus', then I'm out of
   wits - something's broken in the modem. Maybe you should upgrade your
   ROM version.


Q: When receiving faxes, I get the +FCON message logged, then mgetty says
   "starting fax receiver". fax_wait_for(OK) is called, logs some random
   junk bytes, and gives up after a minute, complaining about "timeout".

A: Most likely, you have a modem that switches baud rate to 19200 bps
   right after sending the +FCON message to the host, and the normal port
   speed is something else. Check policy.h whether FAX_RECEIVE_USE_B19200
   is defined, and change the setting (if the modem does *not* change
   speed, but the define is *set*, the effect will be similar).


Q: I keep changing values in policy.h, but nothing changes.

A: maybe you've had an older version of mgetty installed to
   /usr/local/bin/mgetty and are calling this from /etc/init? Newer
   versions are installed in /usr/local/sbin/mgetty. Check the time
   stamp on the mgetty you just compiled vs. the mgetty listed in
   /etc/inittab.


Q: Half of the faxes that I receive are too short, they look as if every
   second pixel line is missing.

A: Well, they *are* short: most likely, they are received in normal
   resolution (204x98 dpi) instead of fine resolution (204x196 dpi). You
   can see it in the filename, if it starts with "ff*", it's fine, if it
   starts with "fn*", it's normal resolution. To ``stretch'' a normal
   resolution fax to proper proportions, use ``g3topbm -stretch fn...''


Q: when upgrading from mgetty 0.19 (or before) to mgetty 0.20, my
   ``mgetty.login'' configuration file doesn't work anymore.

A: Yes, the format has changed. Because of this, and to avoid confusions,
   I'v renamed the LOGIN_CFG_FILE to ``login.config''. Read the sample
   file that I provide for explantations how the configuration works.

   Do not fiddle with the ``uid'' and ``utmp'' fields unless you
   understand what they're for.


Q: login complains with ``no utmp entry, must execute login from the
   lowest level sh''

A: I *told* you not to fiddle with the ``utmp'' field... - most likely,
   in your ``login.config'' file, the utmp field for the entry calling
   /bin/login isn't "-".

   Another reason could be a faulty /etc/init (hits only Linux users) or a
   corrupted /etc/utmp file. In that case, reboot your machine.

Q: When mgetty is running and I dial out, I do not get "CONNECT" but only
   junk, as "+FCO", "+FTI:", "+FHS:20"

A: Well, yes, that's a problem with the 2.0 implementation in mgetty. That
   is: while mgetty is running, the modem is in "AT+FCLASS=2.0" mode and
   expects to connect to a fax on the remote side. (With class 2, we
   worked around this by setting +FCLASS=0;+FAA=1, but that will make the
   modem answer in class 2, not 2.0 [subject to further testing!])

   Solution: in the program dialing out, initialize the modem with
   "AT+FCLASS=0".  Most likely, a modem reset (ATZ) will also help.

Q: vgetty and zplay don't work, I can't record or play back messages.
   I'm using mgetty 0.20 and ZyXEL 6.10 ROMs, the log file shows that
   `+VIT=60' produces `no carrier'.

A: (Klaus Weidner, klaus@snarc.greenie.muc.de): My fault, I'm
   sorry. `+VIT=60' is only supported by ROMs >=6.11.  Please remove
   it from the two places it occurs in voclib.c, or get the latest
   test release from ftp.informatik.tu-muenchen.de:/tmp, or get 6.12
   ROMs.

------------------------------

Subject: My ZyXEL doesn't work right after a ROM upgrade: What's wrong?
From: felix@escape.vsse.in-berlin.de

Do a full modem reset after upgrading the firmware. This is not
described in the German ZyXEL manual (is it described in the
English one?) but should be done in any case.


