File: TODO

package info (click to toggle)
mgetty 1.2.1-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 6,880 kB
  • sloc: ansic: 42,728; sh: 6,487; perl: 6,262; makefile: 1,457; tcl: 756; lisp: 283
file content (474 lines) | stat: -rw-r--r-- 17,355 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
1) make sendfax recognize "-h <file>" option to set page headers
  started 20.3.93, GD
  new idea: send "AT+FDT", then (optional) page header, then page data.
  (does not work)
  new idea: customized pbmtog3, without EOP.
  "first cut" done, 21.9.93, use "g3cat"
  Suggestion: use "-h <program>", g3cat output of that program with the
  data page (-> headers with real send time)

  see 119

2) make external configuration possible
   mostly done (1.1.95)

3) #include <config file>
   bad idea, not really useful

6) faxmail - gatway program for mail -> fax
   (started)

7) when (before) receiving a fax, check if there's enough space left
  (amount configurably) -> clewis
  generic "get spool file name", check multiple directories
  (multiple dirs done, code is ugly, clean up)

8) function for creating spool file names (->dir, prefix; <- name, fd)
  with (optional) sequence numbers

14) make mgetty (and g3cat) add an digifax header to incoming faxes (optionally).

16) tiffg3 -> raw g3 / digifax converter

17) library functions for opening / reading g3 files

18) Makefile.<system> / AutoConf?

20) tio - increase abstraction layer even more, make TIO an opaque pointer, so
        that the upper layers do not have to know *anything* about the data
        structure used by tio.c/.h
	(with old/new settings, to avoid surplus system calls)

21) additional flag: skip modem initialization and all, go directly to
    reading of login name (for callback)  (would also help Hylafax)

24) fax_notify_mail: include "realname" (from fax phone book) in Subject:

31) VSI*FAX

34) ungetty mechanism

35) utmp writing / process arguments on SunOS

45) make fax poll server more flexible

51) faxspool.c (sgid fax) -> $LIBDIR/faxspool.sh
    -> on TODO since at least June 1994
    -> 18.11.2002: *done* via "faxq-helper"

51a) have it start faxrunq immediately (configurably)

55) vhangup()? (->Linux)
    (security issues)

57) SIGUSR1 *after* answering -> hangup

59) mgetty/faxrec(): valiate incoming fax data, request retransmission
    partially done, if +FP(T)S:... returns valid values.

60) faxspool - multiple targets in one fax
    call: faxspool tgt file(s)
	  faxspool -m tgt1 tgt2 tgt3 -- file(s)
	  faxspool -M tgt-file file(s)

62) session parameter mismatch (width / length / resolution) -> correct
"on-the-fly" (integrate "smart" g3cat into sendfax.c). If the page is too
long, cut after 2050 (letter) or 2156 (A4) lines.

63) ZyXEL callback (description, "hack" in mgetty.c - ZYXEL_CALLBACK)
    (integrate in state machine)

63b) real callback

66) faxcleanup

73) locks.c: only "guess" that it's a binary lock if it doesn't consist
    entirely of " 0-9\n".

75) dialcode translations in faxspool

90) support ct 

91) g3split

96) number of RINGs changeable without /etc/inittab change
    (done). Changeable without restart?

97) BREAK -> mgetty exits (does it?)

98) fax_wait_for: accept "<junk> +FHNG:..."

107) create own fax file header, with sender ID (if known), resolution,
     and *magic byte*!

108) faxreq (re-queue, remove Status junk from JOB)
     done with "faxq -r" - really delete "Status" lines?

112) sendfax: return +FHNG in exit() code

114) callback: other lines (if available), random delay

116) use more detailed access privileges in faxspool (long distance, local)

118) modem auto-detect not only for voice but for modem type (e.g.
     MultiTech, ZyXEL, ...) in general
     12.12.97: basic work done

119) dynamically generate page headers in faxrunq
     12.12.97: integrate with class 1 work - we have to "g3cat" the page
               data anyway (for padding)

120) with 119, multicasting is easy

121) check disk space before spooling faxes

123) -DNO_MODEM?

124) if write/read in fax_send_page() fails, exit loop (kkeyte)

125) cleanup script that will rollover logs

126) if sendfax is killed, faxrunq assumes "ok" for some strange reason.
     (caused by the way exec() / wait() handle return code / signals)
     10.12.97: resolved for faxrunqd.  Still open for faxrunq???

127) step-by-step installation guide

128) g3topbm: use same decoder as g3view (speed/space tradeoff?)

129) g3topbm: speed up decoding by reading the file as a whole

135) for modems where AT+FAA=1 doesn't work: use SIGUSR2 to toggle
     fax/data (for people knowing what type of call comes in)

136) keep modem in data mode, switch to fax mode (+FAA=1 or 0, depending
     on -D/-F) if desired before sending ATA. Reason: dialout processes
     can safely assume "+FCLASS=0" with this setup.
136a) add signal to switch reception mode for dumb no-adaptive-answering
     modems, see 135)

137) call "new_fax" program for each page during reception (for those
     people that have a fast machine and a slow printer and want to see
     the results immediately. Hi Harald!)

139) RING during initialization -> wait for it to stop, init modem again

141) make lock/log/spool paths configurable

144) if first line in logfile is written *after* setuid() in login.c,
     no opening of LOG_PATH is possible. open log sooner? mode 666?

145) include Device/Hostname in "notify mail"
     [Device done. Do we really want the hostname?]

79) g3cat: fix line width (that is, "repair" broken T.4 files on-the-fly)
147) make "g3cat" fix line width!
     (done, but doesn't seem to work for all receivers) 

151) SCHED option?

152) get bit order for class 2 / class 2 ok / 2.0 for receiving and polling right

153) testing: add some signal that will cause a fax reception to "fail" (RTN)

154) add some way to change runtime configuration

155) fax receiver: ignore signals (USR1, USR2) more completely, only
     barf about "interrupted system call" if SIGARLM

156) if login name contains spaces, split into several arguments
     (*optionally*). Use : "login username ENV1=foo ENV2=bar".

157) add a "what to try if modem init fails" routine (try 19200 bps,
     try sending <DLE><ETX> to get modem back from voice mode, ...)
     (Julian Assange, proff@suburbia.net; ard@cstmel.hobby.nl)

     09.07.96: <DLE><ETX> done, +++ATH moved to that part as well. Baud
     rate switching still open.

160) make "dialin.config" path configurable (and all other paths
     except "login.config" as well). [not sure whether I want this]

161) make path to "mgetty.config" configurable via command line switch

163) SIGUSR2: harden all "byte-receive" functions against EINTR

168) accept error messages while sending a page

169) "faxspool -t" must be smarter: "send at 2:00 tonight" isn't possible now

170) make "waiting for lock file to disappear" smarter: wait for *PID* to
     disappear *or* mtime change [->no need to read() the file every time
     if mtime didn't change and PID still exists] (-f =remco)

171) callback: password!

174) on Dr.Neuhaus: stay in +fclass=2 mode, don't go to +fclass=0
     same for the Hayes Optima (+FAA=1 doesn't work in +fclass=0 mode)
     
175) man page documentation for "login.config" 

177) AIX, native SCO: DTR toggle needs re-open() on device

178) Linux: #ifdef PARANOID -> lock HUPCL (and CLOCAL?) flag in termios
     and do vhangup() stuff

180) switch from policy.h-dist to policy.h with "reasonable defaults"
240) do away with policy.h, make everything run-time configurable

184) make sendfax choose fax device in a "random" fashion (avoid 
     problems when the first modem in a "hunt group" dies (NO DIALTONE))
     (if faxrunqd is used, it will take care of this)

186) make "distinguished ring" run-time-option:
	dist-ring "RING 1" fax
	dist-ring "RING B" fax/data
	dist-ring "RING 3" voice
     (dynamically growing list, appended to "action" list)
	
187) clean up tio handling / gettydefs stuff in mgetty.c

188) init / DCD drop / I/O error: can we catch it with CLOCAL?

189) sendfax: log "hint" if "ignore-carrier" is not set but "should be"

191) watchit.pl: make "remail" smarter

193) makelock: check for existance of lock file *directory*, complain
     (loudly, L_FATAL!) if it doesn't exist.

194) faxspool: add switch to suppress e-mail

195) make "logging *only* to syslog" conditional compile

197) +FAP (Sub-Adressing frames) support?

199) selectively reject fax reception (on sender ID)?
     http://www.vix.com/hylafax/setup-advanced.html#QualifyTSI

200) build kind of "libiberty" with auxiliary functions [split up goodies.c]

201) make "open() on TCP/IP" socket possible in sendfax (for things like
     portmasters, that have special IP ports to access their modem cards)

203) fix ATD/ERROR problem with USR vs. ERROR response in fax_send_ppm

205) vgetty on AIX: make sure VTIME is not set != 0 while waiting with
     select() or poll() -- drivers are dumb and use VTIME for timeout, 
     not the value passed to select()... *sigh*

206) if "Dr.Neuhaus SMARTY" is detected, set some flag to prevent
     switching back to +fclass=0 ("modem_quirks |= NEED_2"?)

207) if "Telejet SaferFAX" set "cls2ok" ("modem_quirks |= PROPER_BOR");

209) faxrm - fix "call with no arguments"

210) fix cnd.c / mgetty.c: clearing of CallerID if call was rejected
     (Frank Piwarski, fpiwarsk@MyMy.com)

211) fix CLOCAL handling in mgetty (->Ted T'so)

212) faxrm: generic "removeit" subroutine, not multiple "rmdir $jobid"

213) add support for Mark Himsley (mark@mdsh.com)'s weird 2400/fax modem,
     requiring multiple baud rate switches

215) implement e-mail to fax gateway using fax addressing as in IETF
     draft "draft-ietf-fax-addressing-02.txt" (or similar)

218) check whether "ATI1" always returns version number info on the
     *first* line on ZyXEL 2864I models, instead of "checksum first"
     (like all other models) --> faxlib.c, "case 28642:"

222) fix "g3cat"'s line width correction algorithm - include black dot.

224) faxspool: permit "*" as part of the phone number -->
     faxrunq(d): make sure that "*" in $phone is never expanded as wildcard!

225) use a non-root user-id (nobody?) for "cnd-program"
225a) change "system" to "build a proper argv[], then fork/setuid/exec/wait"

226) call cnd-program after "min-rings" RINGs, and before waiting for
     the remaining number of RINGs.
     (Also, that way vgetty can control the number of RINGs depending on
     the distinctive RING number / ISDN MSN)
226a) have the cnd-program decide whether to "answer NOW", or "ask me
     again later".

     2018-03-05: sort-of done (226+226a) with cid-program / return-value
     (cid-program can set rings_wanted to "1" [now!] or "some high number",
     after which cnd-program will be run - still not fully flexible, but
     maybe that's not a real use-case anyway)

227) mgetty: add config option to call external program in the case
     of "L_AUDIT / failed" exit's?  Might be helpful for an external
     management system... (Robert Canary)

227a) external scoreboard (shared memory, etc) too keep track of things?

228) find a way to limit the number of "faxrunq"'s that can run in
     parallel (on systems with a very large fax queue, it might happen
     that faxrunq is ran often enough to overflow file/process tables,
     causing everything to break) - Graham Leggett

     WORKAROUND: use faxrunqd if you have many modems and high fax througput.

229) weird idea: use NSFs to communicate version number
     "proceeding", mgetty's own NSF vendor code assigned 2006/06/07

230) add "frontends" section to the documentation (mgetty.texi)

231) pass dist_ring and called_id as env variables to login/new_fax

232) have cndfind() signal back to ring.c if the string found was a
     "caller ID" (for speedups, Caller ID is counted as "RING", to
     avoid waiting for the next real RING which might delay answering 
     by a number of seconds)

233) have different login: prompts for callback/non-callback logins

234) make new_fax path configurable

235) build "faxspool-d" daemon that listens to network requests, plus
     "r-faxspool" client.

236) make Windows client use faxspool-d, not lpd

237) use r-faxspool/faxspool-d locally as well, to avoid world-writeable
     /var/spool/fax directory

238) show vgetty version in "vgetty -V", not only mgetty version

239) make utmp entry (CallerId/Connect) configurable from mgetty.config

241) cnd-program rework (more return codes, call after first RING)

242) document callback and login.conf v2

243) fix page lengths while sending (integrate in "send G3 file with
     byte padding" that's necessary for class 1 anyway)

244) faxrunqd / write combining: if some pages of a "combined" job
     (everything but the first) have already been renamed to f<n>.g3.done,
     sendfax will refuse cooperation ("command line error").  BUG.

245) open anon CVS for mgetty

248) include script to rotate/move log files on a regular basis
     (base on contrib/mvlog, move to tools/, run through sedscript for
     location and naming for the log files)

250) move prototype for time() to mgetty.h, remove everywhere else

252) implement backend code for mgetty/sendfax.config "*-flow" directives

253) rewrite modem ID code (base on ATI9, fall back to ATI if ATI9 
     doesn't work)

254) in vgetty, "voice_log_level" overrides "-x<n>" - cli args should have
     precedence!  Tricky problem (voice/libutil/config.c).

255) if faxrunq(d) can't read config file due to permission problems, don't
     ignore error but print some informative message

256) add easy way to create/remove $FAX_SPOOL_OUT/stop (fax-helper?)
     done: faxq stop / faxq start

257) generalize calling $(MAKE) in subdirs - put all $(MAKE) arguments
     in one common variable

261) faxrunqd: don't count "modem locked" as "failure" for a given job
     (but *do* delay by a certain time)
     (hmmm - maybe not.  If all modems are locked for a long period of
     time, it might be useful to flag the fax as "failed" to get people to
     notice.  Combine with 259 - should resolve problem)

262) faxrunqd: smarter algorithm for "modem is broken"
     (locked = doesn't count, can't init = +1, NO CARRIER = +0.2)

263) faxspool.rules: add sample mappings for PDF (via acroread, xpdf,
     recent ghostscript versions)

264) faxrunqd: timeout on "hanging" sendfax processes
     (timeout > 15 min + 5 minutes * number of pages, or something like that)

265) faxrunqd: write tty to acct.log (format change / WEB gui)

260) faxrunqd: bump up priority of "exit 12" jobs
266) faxunrqd: if a job fails half-way through (12), increase priority
     to re-send missing parts quickly

267) faxrunqd: sort per-modem statistics numerically (watchout: "total")

268) faxrunq+faxrunqd: have configurable counters for 
        "send-a-warning after <x> tries, fail after <y>"
     have separate counter for "modem-locked"
              costing-failures    tries-except-modem-locked    total-tries
       warning        -                     10                    10
       failure        5                     30                   100

269) faxrunqd: have configurable threshold for "everything is broken"
     -> if that threshold is reached, generate STOP file, warning e-mail, 
     and suspend itself  (like "the local in-house PABX is broken")

270) Makefile: have all paths depend on $(root)/  (->Debian)
     use $(root)/ for "make bindist"

271) rethink whole concept of "blocking yes"
	- when is this supposed to be used ("getty" replacement)
	- how is it supposed to work
     and then fix logging in mgetty.c ("waiting..." is not appropriate)

272) have a configurable delay after each "sendfax" call in faxrunq(d)
     (reason: long but not timing-critical out queue, don't starve
     incoming calls. Wouter van Marle, wouter@squirrel-systems.com)

273) update "ZyXEL" modem section in mgetty.texi-in - it's mainly specific
     to the 1496s.  More recent ZyXELs need mentioning.
     ksadil@bigpond.com reports that the U90e works well with vgetty.

274) g32sff  (based on g3cat routines)

275) sff2g3: duplicate previous line on 0xff/0x00 tag

276) fix "make beta" process (no gcc on target machine anymore)
     [26.11.05: moved to new target machine]
276a) add freshmeat net reminder

277) mg_m_init.c/mg_get_ctty() - if setsid() fails, and getppid() != 1,
     mgetty might be run from the command line.  Should we try fork()ing,
     then setsid()'ing, and then getting a new controlling tty?  
     (Things are likely to fail anyway due to missing utmp slots...)

280a) implement BREAK and dual-tilde sending in tools/microcom.c

282) add test code for ring.c, faxlib.c, and other low-level modules
     (overload mdm_read_byte() -> feed various RING strings to ring.c etc)

     t_ring.c: test "action" strings (CONNECT, ERROR, etc.)

283) mvlog: gzip

284) test function for faxq-helper?

286) faxrunqd: add hard (long) timeout to "wait for child processes" so
     that faxrunqd can recover in case something seriously gets stuck

287) run "cvs tag" automatically after "make beta"

288) change all #idents to contain @(#) prefix

289) re-do all the bitmap conversion stuff in faxspool
     (with recent netpbm versions, pgmtopbm doesn't properly work
     anymore, instead you need to use pamditherbw | pamtopnm)

290) (re-)organize fax class 1 "state" - e.g. always use fax_param_d

291) implement T.37 on-ramp and off-ramp gateways

292) implement T.38 on-ramp and off-ramp gateways

293) implement -o 'myoption arguments' flags to mgetty and sendfax, get
     rid of all these flag letters