1mgetty(8)                    mgetty+sendfax manual                   mgetty(8)
2
3
4

NAME

6       mgetty - smart modem getty
7

SYNOPSIS

9       mgetty [options] ttydevice [gettydefs]
10

DESCRIPTION

12       Mgetty is a ``smart'' getty replacement, designed to be used with hayes
13       compatible data and data/fax modems.  Mgetty knows about modem initial‐
14       ization,  manual  modem  answering (so your modem doesn't answer if the
15       machine isn't ready), UUCP locking (so you can use the same device  for
16       dial-in  and dial-out).  Mgetty provides very extensive logging facili‐
17       ties.
18
19       This manpage doesn't try to detail mgetty  setup  in  detail,  it  just
20       lists  the  most  important options. For detailed instructions, see the
21       info file mgetty.info (mgetty.texi).
22
23

OPTIONS

25       -k <space>
26              Tells mgetty to leave <space> kbytes free on disk when receiving
27              a fax.
28
29       -x <debug level>
30              Use  the  given level of verbosity for logging - 0 means no log‐
31              ging,  9  is   really   noisy.   The   log   file   is   usually
32              /tmp/log_mg.<device>
33
34       -s <speed>
35              Set the port speed to use, e.g. "-s 19200".
36
37       -r     Tells  mgetty  that it is running on a direct line. UUCP locking
38              is done, but no modem initialization whatsoever.
39
40       -p <login prompt>
41              Use the given string to prompt users for their login names. Var‐
42              ious  tokens are allowed in this string. These tokens are: @ for
43              the system name, \n, \g, \f, for newline, bell, and  form  feed,
44              respectively.   \v  and  \r  will  expand  to the OS version and
45              release.  \P, \l and \L will expand to the tty  name  ("ttyS0").
46              \Y  will  give  the  Caller  ID,  \I the "CONNECT foobar" string
47              returned by the modem, and \S or \b will output the port  speed.
48              \N and \U give the number of users currently logged in.  \C will
49              be changed into the result of ctime(), and \D or \d and \t or \T
50              will  output  the date and time, respectively. Finally, \<digit>
51              will use digit as  octal/decimal/hexadecimal  representation  of
52              the character to follow.
53
54              The default prompt is specified at compile time.
55
56       -n #   Tells mgetty to pick up the phone after the #th RING. Default is
57              1.
58
59       -R <t> Tells mgetty to go into "ringback" (aka "ring-twice") mode. That
60              means:  the first call is never answered, instead the caller has
61              to hang up after the phone RINGs, wait 30 seconds, and then call
62              again  in the next <t> seconds for mgetty to pick up. If no call
63              comes, mgetty will exit.
64
65              I do not really recommend using this, better get a second  phone
66              line for the modem.
67
68       -i <issue file>
69              Output  <issue  file> instead of /etc/issue before prompting for
70              the user name. The same token substitutions as for the the login
71              prompt are done in this file.
72
73       -D     Tells mgetty that the modem is to be treated as a DATA modem, no
74              fax initalization is attempted.
75
76       -F     Tells mgetty that DATA calls  are  not  allowed  and  the  modem
77              should be set to Fax-Only.
78
79       -C <class>
80              Tells mgetty how to treat the modem. Possible values for <class>
81              are "auto" (default, try to find out whether the modem  supports
82              fax), "cls2" (use the class 2 fax command set, even if the modem
83              supports class 2.0), "c2.0" (use the class 2.0 fax command set),
84              "data" (data only, exactly as the -D switch).
85
86       -S <g3 file>
87              If  a  call  comes in and requests fax polling, mgetty will send
88              the named file. Note: not all fax modems support poll sending.
89
90       -I <fax id>
91              Use the given fax station ID for fax  identification.  Not  used
92              for data modems.
93
94       -b     Open  the  port  in blocking mode. Best used in combination with
95              "-r". This is the default if mgetty is called as getty.  You may
96              want  to  use  this  if you want to make use of the two-device /
97              kernel-locking scheme of the Linux and SunOS  operating  systems
98              (/dev/ttyS..  and  /dev/cua..). I do not recommend it, it's just
99              include for completeness, and to be able  to  use  mgetty  as  a
100              full-featured getty replacement.
101
102       -a     Use  autobauding.  That  is,  after a connection is made, mgetty
103              parses the "CONNECT foo" response code of the modem and sets the
104              port  speed  to  the  first  integer  found  after the "CONNECT"
105              string, "foo" in this example.  You  need  this  if  your  modem
106              insist on changing its DTE speed to match the line speed. I rec‐
107              ommend against using it, better leave the port speed locked at a
108              fixed  value.  The  feature  is included because there exist old
109              modems that cannot use a fixed (locked) port speed.
110
111       -m 'expect send ...'
112              Set the "chat sequence" that is used to  initialize  the  modem.
113              For  an  empty  expect part, use empty double quotes (""). Since
114              the sequence contains spaces, you have to enclose all of  it  in
115              single quotes(''). Example:
116
117              mgetty -m '"" ATH0 OK'
118
119

FILES

121       /etc/mgetty+sendfax/mgetty.config
122              Main configuration file.
123
124       /etc/mgetty+sendfax/login.config
125              controls  whether  (and when) mgetty should call some other pro‐
126              gram for user login instead of /bin/login. How this is  done  is
127              explained in this file.
128
129       /etc/mgetty+sendfax/dialin.config
130              controls  acceptance/denial of incoming calls based on the call‐
131              er's number.  Available only if you have "caller  ID"  and  your
132              modem supports it.
133
134       /etc/nologin.ttyxx
135              controls  whether  mgetty should pick up the phone upon incoming
136              calls. If the file exists, calls are completely ignored. You can
137              use  this,  for example, to stop mgetty during day time, and let
138              it pick up at night only, by creating  and  removing  /etc/nolo‐
139              gin.ttyxx via the cron program at the appropriate time.
140
141       /etc/issue
142              will  be  printed  after a connection is established, and before
143              the with the '-i' option.
144
145       /var/log/mgetty.log.ttyxx
146              Debug log file, see below.
147
148

DIAGNOSTICS

150       If mgetty doesn't work the way it should, the main source of diagnostic
151       data  is  the log file.  It can be found in "/var/log/mgetty.log.ttyxx"
152       (for the mgetty process  handling  "ttyxx").   If  it  doesn't  contain
153       enough  details,  enhance the log level with the '-x' option to mgetty,
154       e.g. "-x 5".
155
156       Many of the common problems and solutions are discussed in  the  mgetty
157       manual  and  the  FAQ.   Please  see the WWW page at http://alpha.gree
158       nie.net/mgetty/ for both.
159
160
161

BUGS

163       Not all of mgetty configuration can be done  at  run-time  yet.  Things
164       like flow control and file paths (log file / lock file) have to be con‐
165       figured by changing the source and recompiling.
166
167       Users never read manuals...
168
169

SEE ALSO

171       g32pbm(1), sendfax(8), getty(8), mgettydefs(4), mgetty.info
172

AUTHOR

174       mgetty is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>.
175
176
177
178greenie                      27 Oct 93 - 21 Jul 98                   mgetty(8)
Impressum