1mgetty(8) mgetty+sendfax manual mgetty(8)
2
3
4
6 mgetty - smart modem getty
7
9 mgetty [options] ttydevice [gettydefs]
10
12 Mgetty is a ``smart'' getty replacement, designed for use 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
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 initialization 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 use the two-device / kernel-
97 locking scheme of the Linux and SunOS operating systems
98 (/dev/ttyS.. and /dev/cua..). I do not recommend it, it's just
99 included 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 old modems exist
109 which cannot use a fixed (locked) port speed.
110
111 -m 'expect send ...'
112 Set the "chat sequence" used to initialize the modem. For an
113 empty expect part, use empty double quotes (""). Since the
114 sequence contains spaces, you have to enclose all of it in sin‐
115 gle quotes(''). Example:
116
117 mgetty -m '"" ATH0 OK'
118
119
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.ttyxx.log
146 Debug log file, see below.
147
148
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.ttyxx.log"
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
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) must be config‐
165 ured by changing the source and recompiling.
166
167 Users never read manuals...
168
169
171 g32pbm(1), sendfax(8), getty(8), mgettydefs(4), mgetty.info
172
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)