version 1, including all changes.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
mgetty |
|
|
2 |
!!!mgetty |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
OPTIONS |
|
|
7 |
FILES |
|
|
8 |
DIAGNOSTICS |
|
|
9 |
BUGS |
|
|
10 |
SEE ALSO |
|
|
11 |
AUTHOR |
|
|
12 |
---- |
|
|
13 |
!!NAME |
|
|
14 |
|
|
|
15 |
|
|
|
16 |
mgetty - smart modem getty |
|
|
17 |
!!SYNOPSIS |
|
|
18 |
|
|
|
19 |
|
|
|
20 |
__mgetty__ [[__options__] ttydevice |
|
|
21 |
[[''gettydefs''] |
|
|
22 |
!!DESCRIPTION |
|
|
23 |
|
|
|
24 |
|
|
|
25 |
Mgetty is a ``smart'' getty replacement, designed to be used |
|
|
26 |
with hayes compatible data and data/fax modems. Mgetty knows |
|
|
27 |
about modem initialization, manual modem answering (so your |
|
|
28 |
modem doesn't answer if the machine isn't ready), UUCP |
|
|
29 |
locking (so you can use the same device for dial-in and |
|
|
30 |
dial-out). Mgetty provides very extensive logging |
|
|
31 |
facilities. |
|
|
32 |
|
|
|
33 |
|
|
|
34 |
This manpage doesn't try to detail mgetty setup in detail, |
|
|
35 |
it just lists the most important options. For detailed |
|
|
36 |
instructions, see the info file mgetty.info |
|
|
37 |
(mgetty.texi). |
|
|
38 |
!!OPTIONS |
|
|
39 |
|
|
|
40 |
|
|
|
41 |
__-k __ |
|
|
42 |
|
|
|
43 |
|
|
|
44 |
Tells ''mgetty'' to leave |
|
|
45 |
'' |
|
|
46 |
|
|
|
47 |
|
|
|
48 |
__-x __ |
|
|
49 |
|
|
|
50 |
|
|
|
51 |
Use the given level of verbosity for logging - 0 means no |
|
|
52 |
logging, 9 is really noisy. The log file is usually |
|
|
53 |
/tmp/log_mg. |
|
|
54 |
|
|
|
55 |
|
|
|
56 |
__-s __ |
|
|
57 |
|
|
|
58 |
|
|
|
59 |
Set the port speed to use, e.g. |
|
|
60 |
|
|
|
61 |
|
|
|
62 |
__-r__ |
|
|
63 |
|
|
|
64 |
|
|
|
65 |
Tells ''mgetty'' that it is running on a direct line. |
|
|
66 |
UUCP locking is done, but no modem initialization |
|
|
67 |
whatsoever. |
|
|
68 |
|
|
|
69 |
|
|
|
70 |
__-p __ |
|
|
71 |
|
|
|
72 |
|
|
|
73 |
Use the given string to prompt users for their login names. |
|
|
74 |
Various tokens are allowed in this string. These tokens are: |
|
|
75 |
@ for the system name, n, r, g, v, f, t for newline, |
|
|
76 |
carriage return, bell, vertical tab, form feed, and tab, |
|
|
77 |
respectively. P and L will expand to the tty name |
|
|
78 |
( |
|
|
79 |
|
|
|
80 |
|
|
|
81 |
The default prompt is specified at compile |
|
|
82 |
time. |
|
|
83 |
|
|
|
84 |
|
|
|
85 |
__-n #__ |
|
|
86 |
|
|
|
87 |
|
|
|
88 |
Tells ''mgetty'' to pick up the phone after the #th RING. |
|
|
89 |
Default is 1. |
|
|
90 |
|
|
|
91 |
|
|
|
92 |
__-R __ |
|
|
93 |
|
|
|
94 |
|
|
|
95 |
Tells ''mgetty'' to go into |
|
|
96 |
'' |
|
|
97 |
|
|
|
98 |
|
|
|
99 |
I do not really recommend using this, better get a second |
|
|
100 |
phone line for the modem. |
|
|
101 |
|
|
|
102 |
|
|
|
103 |
__-i __ |
|
|
104 |
|
|
|
105 |
|
|
|
106 |
Output |
|
|
107 |
|
|
|
108 |
|
|
|
109 |
__-D__ |
|
|
110 |
|
|
|
111 |
|
|
|
112 |
Tells ''mgetty'' that the modem is to be treated as a |
|
|
113 |
DATA modem, no fax initalization is attempted. |
|
|
114 |
|
|
|
115 |
|
|
|
116 |
__-F__ |
|
|
117 |
|
|
|
118 |
|
|
|
119 |
Tells ''mgetty'' that DATA calls are not allowed and the |
|
|
120 |
modem should be set to Fax-Only. |
|
|
121 |
|
|
|
122 |
|
|
|
123 |
__-C __ |
|
|
124 |
|
|
|
125 |
|
|
|
126 |
Tells ''mgetty'' how to treat the modem. Possible values |
|
|
127 |
for |
|
|
128 |
'' |
|
|
129 |
|
|
|
130 |
|
|
|
131 |
__-S __ |
|
|
132 |
|
|
|
133 |
|
|
|
134 |
If a call comes in and requests fax polling, ''mgetty'' |
|
|
135 |
will send the named file. Note: not all fax modems support |
|
|
136 |
poll sending. |
|
|
137 |
|
|
|
138 |
|
|
|
139 |
__-I __ |
|
|
140 |
|
|
|
141 |
|
|
|
142 |
Use the given fax station ID for fax identification. Not |
|
|
143 |
used for data modems. |
|
|
144 |
|
|
|
145 |
|
|
|
146 |
__-b__ |
|
|
147 |
|
|
|
148 |
|
|
|
149 |
Open the port in blocking mode. Best used in combination |
|
|
150 |
with mgetty'' is |
|
|
151 |
called as ''getty.'' You may want to use this if you want |
|
|
152 |
to make use of the two-device / kernel-locking scheme of the |
|
|
153 |
Linux and SunOS operating systems (/dev/ttyS.. and |
|
|
154 |
/dev/cua..). I do not recommend it, it's just include for |
|
|
155 |
completeness, and to be able to use mgetty as a |
|
|
156 |
full-featured getty replacement. |
|
|
157 |
|
|
|
158 |
|
|
|
159 |
__-a__ |
|
|
160 |
|
|
|
161 |
|
|
|
162 |
Use autobauding. That is, after a connection is made, |
|
|
163 |
''mgetty'' parses the |
|
|
164 |
'' |
|
|
165 |
|
|
|
166 |
|
|
|
167 |
__-m 'expect send ...'__ |
|
|
168 |
|
|
|
169 |
|
|
|
170 |
Set the |
|
|
171 |
|
|
|
172 |
|
|
|
173 |
mgetty -m ' |
|
|
174 |
!!FILES |
|
|
175 |
|
|
|
176 |
|
|
|
177 |
__/etc/mgetty/mgetty.config__ |
|
|
178 |
|
|
|
179 |
|
|
|
180 |
Main configuration file. |
|
|
181 |
|
|
|
182 |
|
|
|
183 |
__/etc/mgetty/login.config__ |
|
|
184 |
|
|
|
185 |
|
|
|
186 |
controls whether (and when) ''mgetty'' should call some |
|
|
187 |
other program for user login instead of /bin/login. How this |
|
|
188 |
is done is explained in this file. |
|
|
189 |
|
|
|
190 |
|
|
|
191 |
__/etc/mgetty/dialin.config__ |
|
|
192 |
|
|
|
193 |
|
|
|
194 |
controls acceptance/denial of incoming calls based on the |
|
|
195 |
caller's number. Available only if you have |
|
|
196 |
|
|
|
197 |
|
|
|
198 |
__/etc/nologin.ttyxx__ |
|
|
199 |
|
|
|
200 |
|
|
|
201 |
controls whether mgetty should pick up the phone upon |
|
|
202 |
incoming calls. If the file exists, calls are completely |
|
|
203 |
ignored. You can use this, for example, to stop mgetty |
|
|
204 |
during day time, and let it pick up at night only, by |
|
|
205 |
creating and removing /etc/nologin.ttyxx via the ''cron'' |
|
|
206 |
program at the appropriate time. |
|
|
207 |
|
|
|
208 |
|
|
|
209 |
__/etc/issue__ |
|
|
210 |
|
|
|
211 |
|
|
|
212 |
will be printed after a connection is established, and |
|
|
213 |
before the with the '-i' option. |
|
|
214 |
|
|
|
215 |
|
|
|
216 |
__/var/log/mgetty/mg_ttyxx.log__ |
|
|
217 |
|
|
|
218 |
|
|
|
219 |
Debug log file, see below. |
|
|
220 |
!!DIAGNOSTICS |
|
|
221 |
|
|
|
222 |
|
|
|
223 |
If ''mgetty'' doesn't work the way it should, the main |
|
|
224 |
source of diagnostic data is the ''log file.'' It can be |
|
|
225 |
found in |
|
|
226 |
'' |
|
|
227 |
|
|
|
228 |
|
|
|
229 |
Many of the common problems and solutions are discussed in |
|
|
230 |
the mgetty manual and the FAQ. Please see the WWW page at |
|
|
231 |
http://alpha.greenie.net/mgetty/ for both. |
|
|
232 |
!!BUGS |
|
|
233 |
|
|
|
234 |
|
|
|
235 |
Not all of ''mgetty'' configuration can be done at |
|
|
236 |
run-time yet. Things like flow control and file paths (log |
|
|
237 |
file / lock file) have to be configured by changing the |
|
|
238 |
source and recompiling. |
|
|
239 |
|
|
|
240 |
|
|
|
241 |
Users never read manuals... |
|
|
242 |
!!SEE ALSO |
|
|
243 |
|
|
|
244 |
|
|
|
245 |
g32pbm(1), sendfax(8), getty(8), mgettydefs(4), |
|
|
246 |
mgetty.info |
|
|
247 |
!!AUTHOR |
|
|
248 |
|
|
|
249 |
|
|
|
250 |
''mgetty'' is Copyright (C) 1993 by Gert Doering, |
|
|
251 |
'' |
|
|
252 |
---- |