chiark / gitweb /
lowvol fixes
[inn-innduct.git] / backends / innduct.c
1 /*
2  *  innduct
3  *  tailing reliable realtime streaming feeder for inn
4  *
5  *  Copyright (C) 2010 Ian Jackson <ijackson@chiark.greenend.org.uk>
6  * 
7  *  This program is free software: you can redistribute it and/or modify
8  *  it under the terms of the GNU General Public License as published by
9  *  the Free Software Foundation, either version 3 of the License, or
10  *  (at your option) any later version.
11  * 
12  *  This program is distributed in the hope that it will be useful,
13  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  *  GNU General Public License for more details.
16  * 
17  *  You should have received a copy of the GNU General Public License
18  *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
19  *
20  *  (I believe that when you compile and link this as part of the inn2
21  *  build, with the Makefile runes I have provided, all the libraries
22  *  and files which end up included in innduct are licence-compatible
23  *  with GPLv3.  If not then please let me know.  -Ian Jackson.)
24  */
25
26 /*
27  * todo
28  *
29  *  don't mind reconnecting if we just disconnected due to idle
30  *  some weird disconnection event still investigating
31  */
32
33 /*
34  * Newsfeeds file entries should look like this:
35  *     host.name.of.site[/exclude,exclude,...]\
36  *             :pattern,pattern...[/distribution,distribution...]\
37  *             :Tf,Wnm
38  *             :
39  * or
40  *     sitename[/exclude,exclude,...]\
41  *             :pattern,pattern...[/distribution,distribution...]\
42  *             :Tf,Wnm
43  *             :host.name.of.site
44  *
45  * Four files full of
46  *    token messageid
47  * or might be blanked out
48  *    <spc><spc><spc><spc>....
49  *
50  * F site.name                 main feed file
51  *                                opened/created, then written, by innd
52  *                                read by duct
53  *                                unlinked by duct
54  *                                tokens blanked out by duct when processed
55  *   site.name_lock            lock preventing multiple ducts
56  *                                to hold lock must open,F_SETLK[W]
57  *                                  and then stat to check that locked file
58  *                                  still has name site.name_lock
59  *                                holder of this lock is "duct"
60  *                                (only) lockholder may remove the lockfile
61  * D site.name_flushing        temporary feed file during flush (or crash)
62  *                                hardlink created by duct
63  *                                unlinked by duct
64  *   site.name_defer           431'd articles, still being written,
65  *                                created, written, used by duct
66  *
67  *   site.name_backlog.<date>.<inum>
68  *                             431'd articles, ready for innxmit or duct
69  *                                created (link/mv) by duct
70  *   site.name_backlog<anything-else>  (where <anything-else> does not
71  *                                      contain '#' or '~') eg
72  *   site.name_backlog.manual
73  *                             anything the sysadmin likes (eg, feed files
74  *                             from old feeds to be merged into this one)
75  *                                created (link/mv) by admin
76  *                                may be symlinks (in which case links
77  *                                may be written through, but only links
78  *                                will be removed.
79  *
80  *                             It is safe to remove backlog files manually,
81  *                             if it's desired to throw away the backlog.
82  *
83  * Backlog files are also processed by innduct.  We find the oldest
84  * backlog file which is at least a certain amount old, and feed it
85  * back into our processing.  When every article in it has been read
86  * and processed, we unlink it and look for another backlog file.
87  *
88  * If we don't have a backlog file that we're reading, we close the
89  * defer file that we're writing and make it into a backlog file at
90  * the first convenient opportunity.
91  * -8<-
92
93
94    OVERALL STATES:
95
96                                                                 START
97                                                                   |
98      ,-->--.                                                 check F, D
99      |     |                                                      |
100      |     |                                                      |
101      |     |  <----------------<---------------------------------'|
102      |     |                                       F exists       |
103      |     |                                       D ENOENT       |
104      |     |  duct opens F                                        |
105      |     V                                                      |
106      |  Normal                                                    |
107      |   F: innd writing, duct reading                            |
108      |   D: ENOENT                                                |
109      |     |                                                      |
110      |     |  duct decides time to flush                          |
111      |     |  duct makes hardlink                                 |
112      |     |                                                      |
113      |     V                            <------------------------'|
114      |  Hardlinked                                  F==D          |
115      |   F == D: innd writing, duct reading         both exist    |
116      ^     |                                                      |
117      |     |  duct unlinks F                                      |
118      |     |                        <-----------<-------------<--'|
119      |     |                           open D         F ENOENT    |
120      |     |                           if exists                  |
121      |     |                                                      |
122      |     V                        <---------------------.       |
123      |  Moved                                             |       |
124      |   F: ENOENT                                        |       |
125      |   D: innd writing, duct reading; or ENOENT         |       |
126      |     |                                              |       |
127      |     |  duct requests flush of feed                 |       |
128      |     |   (others can too, harmlessly)               |       |
129      |     V                                              |       |
130      |  Flushing                                          |       |
131      |   F: ENOENT                                        |       |
132      |   D: innd flushing, duct; or ENOENT                |       |
133      |     |                                              |       |
134      |     |   inndcomm flush fails                       |       |
135      |     |`-------------------------->------------------'       |
136      |     |                                                      |
137      |     |   inndcomm reports no such site                      |
138      |     |`---------------------------------------------------- | -.
139      |     |                                                      |  |
140      |     |  innd finishes writing D, creates F                  |  |
141      |     |  inndcomm reports flush successful                   |  |
142      |     |                                                      |  |
143      |     V                                                      |  |
144      |  Separated                                <----------------'  |
145      |   F: innd writing                            F!=D             /
146      |   D: duct reading; or ENOENT                  both exist     /
147      |     |                                                       /
148      |     |  duct gets to the end of D                           /
149      |     |  duct opens F too                                   /
150      |     V                                                    /
151      |  Finishing                                              /
152      |   F: innd writing, duct reading                        |
153      |   D: duct finishing                                    V
154      |     |                                            Dropping
155      |     |  duct finishes processing D                 F: ENOENT
156      |     V  duct unlinks D                             D: duct reading
157      |     |                                                  |
158      `--<--'                                                  | duct finishes
159                                                               |  processing D
160                                                               | duct unlinks D
161                                                               | duct exits
162                                                               V
163                                                         Dropped
164                                                          F: ENOENT
165                                                          D: ENOENT
166                                                          duct not running
167
168    "duct reading" means innduct is reading the file but also
169    overwriting processed tokens.
170
171  * ->8- -^L-
172  *
173  * rune for printing diagrams:
174
175 perl -ne 'print if m/-8\<-/..m/-\>8-/; print "\f" if m/-\^L-/' backends/innduct.c |a2ps -R -B -ops
176
177  *
178  */
179
180 /*============================== PROGRAM ==============================*/
181
182 #define _GNU_SOURCE 1
183
184 #include "config.h"
185 #include "storage.h"
186 #include "nntp.h"
187 #include "libinn.h"
188 #include "inndcomm.h"
189
190 #include "inn/list.h"
191 #include "inn/innconf.h"
192
193 #include <sys/uio.h>
194 #include <sys/types.h>
195 #include <sys/wait.h>
196 #include <sys/stat.h>
197 #include <sys/socket.h>
198 #include <sys/un.h>
199 #include <unistd.h>
200 #include <string.h>
201 #include <signal.h>
202 #include <stdio.h>
203 #include <errno.h>
204 #include <syslog.h>
205 #include <fcntl.h>
206 #include <stdarg.h>
207 #include <assert.h>
208 #include <stdlib.h>
209 #include <stddef.h>
210 #include <glob.h>
211 #include <time.h>
212 #include <math.h>
213 #include <ctype.h>
214
215 #include <oop.h>
216 #include <oop-read.h>
217
218 /*----- general definitions, probably best not changed -----*/
219
220 #define CONNCHILD_ESTATUS_STREAM   24
221 #define CONNCHILD_ESTATUS_NOSTREAM 25
222
223 #define INNDCOMMCHILD_ESTATUS_FAIL     26
224 #define INNDCOMMCHILD_ESTATUS_NONESUCH 27
225
226 #define MAX_LINE_FEEDFILE (NNTP_MSGID_MAXLEN + sizeof(TOKEN)*2 + 10)
227 #define MAX_CLI_COMMAND 1000
228
229 #define VA                va_list al;  va_start(al,fmt)
230 #define PRINTF(f,a)       __attribute__((__format__(printf,f,a)))
231 #define NORET_PRINTF(f,a) __attribute__((__noreturn__,__format__(printf,f,a)))
232 #define NORET             __attribute__((__noreturn__))
233
234 #define NEW(ptr)              ((ptr)= zxmalloc(sizeof(*(ptr))))
235 #define NEW_DECL(type,ptr) type ptr = zxmalloc(sizeof(*(ptr)))
236
237 #define DUMPV(fmt,pfx,v) fprintf(f, " " #v "=" fmt, pfx v);
238
239 #define FOR_CONN(conn) \
240   for ((conn)=LIST_HEAD(conns); (conn); (conn)=LIST_NEXT((conn)))
241
242 /*----- doubly linked lists -----*/
243
244 #define ISNODE(T)   struct node list_node
245 #define DEFLIST(T)                              \
246    typedef struct {                             \
247      union { struct list li; T *for_type; } u;  \
248      int count;                                 \
249    } T##List
250
251 #define NODE(n) (assert((void*)&(n)->list_node == (n)), &(n)->list_node)
252
253 #define LIST_CHECKCANHAVENODE(l,n) \
254   ((void)((n) == ((l).u.for_type))) /* just for the type check */
255
256 #define LIST_ADDSOMEHOW(l,n,list_addsomehow)    \
257  ( LIST_CHECKCANHAVENODE(l,n),                  \
258    list_addsomehow(&(l).u.li, NODE((n))),       \
259    (void)(l).count++                            \
260    )
261
262 #define LIST_REMSOMEHOW(l,list_remsomehow)      \
263  ( (typeof((l).u.for_type))                     \
264    ( (l).count                                  \
265      ? ( (l).count--,                           \
266          list_remsomehow(&(l).u.li) )           \
267      : 0                                        \
268      )                                          \
269    )
270
271
272 #define LIST_ADDHEAD(l,n) LIST_ADDSOMEHOW((l),(n),list_addhead)
273 #define LIST_ADDTAIL(l,n) LIST_ADDSOMEHOW((l),(n),list_addtail)
274 #define LIST_REMHEAD(l) LIST_REMSOMEHOW((l),list_remhead)
275 #define LIST_REMTAIL(l) LIST_REMSOMEHOW((l),list_remtail)
276
277 #define LIST_INIT(l) ((l).count=0, list_new(&(l).u.li))
278 #define LIST_HEAD(l) ((typeof((l).u.for_type))(list_head((struct list*)&(l))))
279 #define LIST_NEXT(n) ((typeof(n))list_succ(NODE((n))))
280 #define LIST_BACK(n) ((typeof(n))list_pred(NODE((n))))
281
282 #define LIST_REMOVE(l,n)                        \
283  ( LIST_CHECKCANHAVENODE(l,n),                  \
284    list_remove(NODE((n))),                      \
285    (void)(l).count--                            \
286    )
287
288 #define LIST_INSERT(l,n,pred)                                   \
289  ( LIST_CHECKCANHAVENODE(l,n),                                  \
290    LIST_CHECKCANHAVENODE(l,pred),                               \
291    list_insert((struct list*)&(l), NODE((n)), NODE((pred))),    \
292    (void)(l).count++                                            \
293    )
294
295 /*----- type predeclarations -----*/
296
297 typedef struct Conn Conn;
298 typedef struct Article Article;
299 typedef struct InputFile InputFile;
300 typedef struct XmitDetails XmitDetails;
301 typedef struct Filemon_Perfile Filemon_Perfile;
302 typedef enum StateMachineState StateMachineState;
303 typedef struct CliCommand CliCommand;
304
305 DEFLIST(Conn);
306 DEFLIST(Article);
307
308 /*----- function predeclarations -----*/
309
310 static void conn_maybe_write(Conn *conn);
311 static void conn_make_some_xmits(Conn *conn);
312 static void *conn_write_some_xmits(Conn *conn);
313
314 static void xmit_free(XmitDetails *d);
315
316 #define SMS(newstate, periods, why) \
317    (statemc_setstate(sm_##newstate,(periods),#newstate,(why)))
318 static void statemc_setstate(StateMachineState newsms, int periods,
319                              const char *forlog, const char *why);
320
321 static void statemc_start_flush(const char *why); /* Normal => Flushing */
322 static void spawn_inndcomm_flush(const char *why); /* Moved => Flushing */
323 static int trigger_flush_ok(const char *why /* 0 means timeout */);
324                                   /* => Flushing,FLUSHING, ret 1; or ret 0 */
325
326 static void article_done(Article *art, int whichcount);
327
328 static void check_assign_articles(void);
329 static void queue_check_input_done(void);
330 static void check_reading_pause_resume(InputFile *ipf);
331
332 static void statemc_check_flushing_done(void);
333 static void statemc_check_backlog_done(void);
334
335 static void postfork(void);
336 static void period(void);
337
338 static void open_defer(void);
339 static void close_defer(void);
340 static void search_backlog_file(void);
341 static void preterminate(void);
342 static void raise_default(int signo) NORET;
343 static char *debug_report_ipf(InputFile *ipf);
344
345 static void inputfile_reading_start(InputFile *ipf);
346 static void inputfile_reading_stop(InputFile *ipf);
347 static void inputfile_reading_pause(InputFile *ipf);
348 static void inputfile_reading_resume(InputFile *ipf);
349   /* pause and resume are idempotent, and no-op if not done _reading_start */
350
351 static void filemon_start(InputFile *ipf);
352 static void filemon_stop(InputFile *ipf);
353 static void tailing_make_readable(InputFile *ipf);
354
355 static void vconnfail(Conn *conn, const char *fmt, va_list al) PRINTF(2,0);
356 static void connfail(Conn *conn, const char *fmt, ...)         PRINTF(2,3);
357
358 static const oop_rd_style peer_rd_style;
359 static oop_rd_call peer_rd_err, peer_rd_ok;
360
361
362 /*----- configuration options -----*/
363 /* when changing defaults, remember to update the manpage */
364
365 static const char *sitename, *remote_host;
366 static const char *feedfile, *path_run, *path_cli, *path_cli_dir;
367 static int quiet_multiple=0;
368 static int become_daemon=1, try_filemon=1;
369 static int try_stream=1;
370 static int port=119;
371 static const char *inndconffile;
372
373 static int max_connections=10;
374 static int max_queue_per_conn=200;
375 static int target_max_feedfile_size=100000;
376 static int period_seconds=60;
377 static int filepoll_seconds=5;
378 static int max_queue_per_ipf=-1;
379
380 static int connection_setup_timeout=200;
381 static int inndcomm_flush_timeout=100;
382
383 static double nocheck_thresh= 95.0; /* converted from percentage by main */
384 static double nocheck_decay= 100; /* conv'd from articles to lambda by main */
385
386 /* all these are initialised to seconds, and converted to periods in main */
387 static int reconnect_delay_periods=1000;
388 static int flushfail_retry_periods=1000;
389 static int backlog_retry_minperiods=100;
390 static int backlog_spontrescan_periods=300;
391 static int spontaneous_flush_periods=100000;
392 static int max_separated_periods=2000;
393 static int need_activity_periods=1000;
394 static int lowvol_thresh=3;
395 static int lowvol_periods=1000;
396
397 static double max_bad_data_ratio= 1; /* conv'd from percentage by main */
398 static int max_bad_data_initial= 30;
399   /* in one corrupt 4096-byte block the number of newlines has
400    * mean 16 and standard deviation 3.99.  30 corresponds to z=+3.5 */
401
402
403 /*----- statistics -----*/
404
405 typedef enum {      /* in queue                 in conn->sent             */
406   art_Unchecked,    /*   not checked, not sent    checking                */
407   art_Wanted,       /*   checked, wanted          sent body as requested  */
408   art_Unsolicited,  /*   -                        sent body without check */
409   art_MaxState,
410 } ArtState;
411
412 static const char *const artstate_names[]=
413   { "Unchecked", "Wanted", "Unsolicited", 0 };
414
415 #define RESULT_COUNTS(RCS,RCN)                  \
416   RCS(sent)                                     \
417   RCS(accepted)                                 \
418   RCN(unwanted)                                 \
419   RCN(rejected)                                 \
420   RCN(deferred)                                 \
421   RCN(missing)                                  \
422   RCN(connretry)
423
424 #define RCI_TRIPLE_FMT_BASE "%d (id=%d,bod=%d,nc=%d)"
425 #define RCI_TRIPLE_VALS_BASE(counts,x)          \
426        counts[art_Unchecked] x                  \
427        + counts[art_Wanted] x                   \
428        + counts[art_Unsolicited] x,             \
429        counts[art_Unchecked] x                  \
430        , counts[art_Wanted] x                   \
431        , counts[art_Unsolicited] x
432
433 typedef enum {
434 #define RC_INDEX(x) RC_##x,
435   RESULT_COUNTS(RC_INDEX, RC_INDEX)
436   RCI_max
437 } ResultCountIndex;
438
439
440 /*----- transmission buffers -----*/
441
442 #define CONNIOVS 128
443
444 typedef enum {
445   xk_Const, xk_Artdata
446 } XmitKind;
447
448 struct XmitDetails {
449   XmitKind kind;
450   union {
451     ARTHANDLE *sm_art;
452   } info;
453 };
454
455
456 /*----- core operational data structure types -----*/
457
458 struct InputFile {
459   /* This is also an instance of struct oop_readable */
460   struct oop_readable readable; /* first */
461   oop_readable_call *readable_callback;
462   void *readable_callback_user;
463
464   int fd;
465   Filemon_Perfile *filemon;
466
467   oop_read *rd; /* non-0: reading; 0: constructing, or had EOF */
468   off_t offset;
469   int skippinglong, paused, fake_readable;
470
471   ArticleList queue;
472   long inprogress; /* includes queue.count and also articles in conns */
473   long autodefer; /* -1 means not doing autodefer */
474
475   int counts[art_MaxState][RCI_max];
476   int readcount_ok, readcount_blank, readcount_err, count_nooffer_missing;
477   char path[];
478 };
479
480 struct Article {
481   ISNODE(Article);
482   ArtState state;
483   int midlen, missing;
484   InputFile *ipf;
485   TOKEN token;
486   off_t offset;
487   int blanklen;
488   char messageid[1];
489 };
490
491 #define SMS_LIST(X)                             \
492   X(NORMAL)                                     \
493   X(FLUSHING)                                   \
494   X(FLUSHFAILED)                                \
495   X(SEPARATED)                                  \
496   X(DROPPING)                                   \
497   X(DROPPED)
498
499 enum StateMachineState {
500 #define SMS_DEF_ENUM(s) sm_##s,
501   SMS_LIST(SMS_DEF_ENUM)
502 };
503
504 static const char *sms_names[]= {
505 #define SMS_DEF_NAME(s) #s ,
506   SMS_LIST(SMS_DEF_NAME)
507   0
508 };
509
510 struct Conn {
511   ISNODE(Conn);
512   int fd; /* may be 0, meaning closed (during construction/destruction) */
513   oop_read *rd; /* likewise */
514   int max_queue, stream;
515   const char *quitting;
516   int since_activity; /* periods */
517   ArticleList waiting; /* not yet told peer */
518   ArticleList priority; /* peer says send it now */
519   ArticleList sent; /* offered/transmitted - in xmit or waiting reply */
520   struct iovec xmit[CONNIOVS];
521   XmitDetails xmitd[CONNIOVS];
522   int xmitu;
523 };
524
525
526 /*----- general operational variables -----*/
527
528 /* main initialises */
529 static oop_source *loop;
530 static ConnList conns;
531 static char *path_lock, *path_flushing, *path_defer, *path_dump;
532 static char *globpat_backlog;
533 static pid_t self_pid;
534 static int *lowvol_perperiod;
535 static int lowvol_circptr;
536 static int lowvol_total; /* does not include current period */
537
538 /* statemc_init initialises */
539 static StateMachineState sms;
540 static int until_flush;
541 static InputFile *main_input_file, *flushing_input_file, *backlog_input_file;
542 static FILE *defer;
543
544 /* initialisation to 0 is good */
545 static int until_connect, until_backlog_nextscan;
546 static double accept_proportion;
547 static int nocheck, nocheck_reported, in_child;
548
549 /* for simulation, debugging, etc. */
550 int simulate_flush= -1;
551
552 /*========== logging ==========*/
553
554 static void logcore(int sysloglevel, const char *fmt, ...) PRINTF(2,3);
555 static void logcore(int sysloglevel, const char *fmt, ...) {
556   VA;
557   if (become_daemon) {
558     vsyslog(sysloglevel,fmt,al);
559   } else {
560     if (self_pid) fprintf(stderr,"[%lu] ",(unsigned long)self_pid);
561     vfprintf(stderr,fmt,al);
562     putc('\n',stderr);
563   }
564   va_end(al);
565 }
566
567 static void logv(int sysloglevel, const char *pfx, int errnoval,
568                  const char *fmt, va_list al) PRINTF(5,0);
569 static void logv(int sysloglevel, const char *pfx, int errnoval,
570                  const char *fmt, va_list al) {
571   char msgbuf[1024]; /* NB do not call xvasprintf here or you'll recurse */
572   vsnprintf(msgbuf,sizeof(msgbuf), fmt,al);
573   msgbuf[sizeof(msgbuf)-1]= 0;
574
575   if (sysloglevel >= LOG_ERR && (errnoval==EACCES || errnoval==EPERM))
576     sysloglevel= LOG_ERR; /* run by wrong user, probably */
577
578   logcore(sysloglevel, "<%s>%s: %s%s%s",
579          sitename, pfx, msgbuf,
580          errnoval>=0 ? ": " : "",
581          errnoval>=0 ? strerror(errnoval) : "");
582 }
583
584 #define diewrap(fn, pfx, sysloglevel, err, estatus)             \
585   static void fn(const char *fmt, ...) NORET_PRINTF(1,2);       \
586   static void fn(const char *fmt, ...) {                        \
587     preterminate();                                             \
588     VA;                                                         \
589     logv(sysloglevel, pfx, err, fmt, al);                       \
590     exit(estatus);                                              \
591   }
592
593 #define logwrap(fn, pfx, sysloglevel, err)              \
594   static void fn(const char *fmt, ...) PRINTF(1,2);     \
595   static void fn(const char *fmt, ...) {                \
596     VA;                                                 \
597     logv(sysloglevel, pfx, err, fmt, al);               \
598     va_end(al);                                         \
599   }
600
601 diewrap(sysdie,   " critical", LOG_CRIT,    errno, 16);
602 diewrap(die,      " critical", LOG_CRIT,    -1,    16);
603
604 diewrap(sysfatal, " fatal",    LOG_ERR,     errno, 12);
605 diewrap(fatal,    " fatal",    LOG_ERR,     -1,    12);
606
607 logwrap(syswarn,  " warning",  LOG_WARNING, errno);
608 logwrap(warn,     " warning",  LOG_WARNING, -1);
609
610 logwrap(notice,   " notice",   LOG_NOTICE,  -1);
611 logwrap(info,     " info",     LOG_INFO,    -1);
612 logwrap(debug,    " debug",    LOG_DEBUG,   -1);
613
614
615 /*========== utility functions etc. ==========*/
616
617 static char *xvasprintf(const char *fmt, va_list al) PRINTF(1,0);
618 static char *xvasprintf(const char *fmt, va_list al) {
619   char *str;
620   int rc= vasprintf(&str,fmt,al);
621   if (rc<0) sysdie("vasprintf(\"%s\",...) failed", fmt);
622   return str;
623 }
624 static char *xasprintf(const char *fmt, ...) PRINTF(1,2);
625 static char *xasprintf(const char *fmt, ...) {
626   VA;
627   char *str= xvasprintf(fmt,al);
628   va_end(al);
629   return str;
630 }
631
632 static int close_perhaps(int *fd) {
633   if (*fd <= 0) return 0;
634   int r= close(*fd);
635   *fd=0;
636   return r;
637 }
638 static void xclose(int fd, const char *what, const char *what2) {
639   int r= close(fd);
640   if (r) sysdie("close %s%s",what,what2?what2:"");
641 }
642 static void xclose_perhaps(int *fd, const char *what, const char *what2) {
643   if (*fd <= 0) return;
644   xclose(*fd,what,what2);
645   *fd=0;
646 }
647
648 static pid_t xfork(const char *what) {
649   pid_t child;
650
651   child= fork();
652   if (child==-1) sysfatal("cannot fork for %s",what);
653   debug("forked %s %ld", what, (unsigned long)child);
654   if (!child) postfork();
655   return child;
656 }
657
658 static void on_fd_read_except(int fd, oop_call_fd callback) {
659   loop->on_fd(loop, fd, OOP_READ,      callback, 0);
660   loop->on_fd(loop, fd, OOP_EXCEPTION, callback, 0);
661 }
662 static void cancel_fd_read_except(int fd) {
663   loop->cancel_fd(loop, fd, OOP_READ);
664   loop->cancel_fd(loop, fd, OOP_EXCEPTION);
665 }
666
667 static void report_child_status(const char *what, int status) {
668   if (WIFEXITED(status)) {
669     int es= WEXITSTATUS(status);
670     if (es)
671       warn("%s: child died with error exit status %d", what, es);
672   } else if (WIFSIGNALED(status)) {
673     int sig= WTERMSIG(status);
674     const char *sigstr= strsignal(sig);
675     const char *coredump= WCOREDUMP(status) ? " (core dumped)" : "";
676     if (sigstr)
677       warn("%s: child died due to fatal signal %s%s", what, sigstr, coredump);
678     else
679       warn("%s: child died due to unknown fatal signal %d%s",
680            what, sig, coredump);
681   } else {
682     warn("%s: child died with unknown wait status %d", what,status);
683   }
684 }
685
686 static int xwaitpid(pid_t *pid, const char *what) {
687   int status;
688
689   int r= kill(*pid, SIGKILL);
690   if (r) sysdie("cannot kill %s child", what);
691
692   pid_t got= waitpid(*pid, &status, 0);
693   if (got==-1) sysdie("cannot reap %s child", what);
694   if (got==0) die("cannot reap %s child", what);
695
696   *pid= 0;
697
698   return status;
699 }
700
701 static void *zxmalloc(size_t sz) {
702   void *p= xmalloc(sz);
703   memset(p,0,sz);
704   return p;
705 }
706
707 static void xunlink(const char *path, const char *what) {
708   int r= unlink(path);
709   if (r) sysdie("can't unlink %s %s", path, what);
710 }
711
712 static time_t xtime(void) {
713   time_t now= time(0);
714   if (now==-1) sysdie("time(2) failed");
715   return now;
716 }
717
718 static void xsigaction(int signo, const struct sigaction *sa) {
719   int r= sigaction(signo,sa,0);
720   if (r) sysdie("sigaction failed for \"%s\"", strsignal(signo));
721 }
722
723 static void xsigsetdefault(int signo) {
724   struct sigaction sa;
725   memset(&sa,0,sizeof(sa));
726   sa.sa_handler= SIG_DFL;
727   xsigaction(signo,&sa);
728 }
729
730 static void xgettimeofday(struct timeval *tv_r) {
731   int r= gettimeofday(tv_r,0);
732   if (r) sysdie("gettimeofday(2) failed");
733 }
734
735 static void xsetnonblock(int fd, int nonblocking) {
736   int errnoval= oop_fd_nonblock(fd, nonblocking);
737   if (errnoval) { errno= errnoval; sysdie("setnonblocking"); }
738 }
739
740 static void check_isreg(const struct stat *stab, const char *path,
741                         const char *what) {
742   if (!S_ISREG(stab->st_mode))
743     die("%s %s not a plain file (mode 0%lo)",
744         what, path, (unsigned long)stab->st_mode);
745 }
746
747 static void xfstat(int fd, struct stat *stab_r, const char *what) {
748   int r= fstat(fd, stab_r);
749   if (r) sysdie("could not fstat %s", what);
750 }
751
752 static void xfstat_isreg(int fd, struct stat *stab_r,
753                          const char *path, const char *what) {
754   xfstat(fd, stab_r, what);
755   check_isreg(stab_r, path, what);
756 }
757
758 static void xlstat_isreg(const char *path, struct stat *stab,
759                          int *enoent_r /* 0 means ENOENT is fatal */,
760                          const char *what) {
761   int r= lstat(path, stab);
762   if (r) {
763     if (errno==ENOENT && enoent_r) { *enoent_r=1; return; }
764     sysdie("could not lstat %s %s", what, path);
765   }
766   if (enoent_r) *enoent_r= 0;
767   check_isreg(stab, path, what);
768 }
769
770 static int samefile(const struct stat *a, const struct stat *b) {
771   assert(S_ISREG(a->st_mode));
772   assert(S_ISREG(b->st_mode));
773   return (a->st_ino == b->st_ino &&
774           a->st_dev == b->st_dev);
775 }
776
777 static char *sanitise(const char *input, int len) {
778   static char sanibuf[100]; /* returns pointer to this buffer! */
779
780   const char *p= input;
781   const char *endp= len>=0 ? input+len : 0;
782   char *q= sanibuf;
783   *q++= '`';
784   for (;;) {
785     if (q > sanibuf+sizeof(sanibuf)-8) { strcpy(q,"'.."); break; }
786     int c= (!endp || p<endp) ? *p++ : 0;
787     if (!c) { *q++= '\''; *q=0; break; }
788     if (c>=' ' && c<=126 && c!='\\') { *q++= c; continue; }
789     sprintf(q,"\\x%02x",c);
790     q += 4;
791   }
792   return sanibuf;
793 }
794
795 static int isewouldblock(int errnoval) {
796   return errnoval==EWOULDBLOCK || errnoval==EAGAIN;
797 }
798
799 /*========== command and control (CLI) connections ==========*/
800
801 static int cli_master;
802
803 typedef struct CliConn CliConn;
804 struct CliConn {
805   void (*destroy)(CliConn*);
806   int fd;
807   oop_read *rd;
808   FILE *out;
809   union {
810     struct sockaddr sa;
811     struct sockaddr_un un;
812   } sa;
813   socklen_t salen;
814 };
815
816 static const oop_rd_style cli_rd_style= {
817   OOP_RD_DELIM_STRIP, '\n',
818   OOP_RD_NUL_FORBID,
819   OOP_RD_SHORTREC_FORBID
820 };
821
822 static void cli_destroy(CliConn *cc) {
823   cc->destroy(cc);
824 }
825
826 static void cli_checkouterr(CliConn *cc /* may destroy*/) {
827   if (ferror(cc->out) | fflush(cc->out)) {
828     info("CTRL%d write error %s", cc->fd, strerror(errno));
829     cli_destroy(cc);
830   }
831 }
832
833 static void cli_prompt(CliConn *cc /* may destroy*/) {
834   fprintf(cc->out, "%s| ", sitename);
835   cli_checkouterr(cc);
836 }
837
838 struct CliCommand {
839   const char *cmd;
840   void (*f)(CliConn *cc, const CliCommand *ccmd,
841             const char *arg, size_t argsz);
842   void *xdata;
843   int xval;
844 };
845
846 static const CliCommand cli_commands[];
847
848 #define CCMD(wh)                                                \
849   static void ccmd_##wh(CliConn *cc, const CliCommand *c,       \
850                         const char *arg, size_t argsz)
851
852 CCMD(help) {
853   fputs("commands:\n", cc->out);
854   const CliCommand *ccmd;
855   for (ccmd=cli_commands; ccmd->cmd; ccmd++)
856     fprintf(cc->out, " %s\n", ccmd->cmd);
857   fputs("NB: permissible arguments are not shown above."
858         "  Not all commands listed are safe.  See innduct(8).\n", cc->out);
859 }
860
861 CCMD(flush) {
862   int ok= trigger_flush_ok("manual request");
863   if (!ok) fprintf(cc->out,"already flushing (state is %s)\n", sms_names[sms]);
864 }
865
866 CCMD(stop) {
867   preterminate();
868   notice("terminating (CTRL%d)",cc->fd);
869   raise_default(SIGTERM);
870   abort();
871 }
872
873 CCMD(dump);
874
875 /* messing with our head: */
876 CCMD(period) { period(); }
877 CCMD(setintarg) { *(int*)c->xdata= atoi(arg); }
878 CCMD(setint) { *(int*)c->xdata= c->xval; }
879 CCMD(setint_period) { *(int*)c->xdata= c->xval; period(); }
880
881 static const CliCommand cli_commands[]= {
882   { "h",             ccmd_help      },
883   { "flush",         ccmd_flush     },
884   { "stop",          ccmd_stop      },
885   { "dump q",        ccmd_dump, 0,0 },
886   { "dump a",        ccmd_dump, 0,1 },
887
888   { "p",             ccmd_period    },
889
890 #define POKES(cmd,func)                                                 \
891   { cmd "flush",     func,           &until_flush,             1 },     \
892   { cmd "conn",      func,           &until_connect,           0 },     \
893   { cmd "blscan",    func,           &until_backlog_nextscan,  0 },
894 POKES("next ", ccmd_setint)
895 POKES("prod ", ccmd_setint_period)
896
897   { "pretend flush", ccmd_setintarg, &simulate_flush             },
898   { "wedge blscan",  ccmd_setint,    &until_backlog_nextscan, -1 },
899   { 0 }
900 };
901
902 static void *cli_rd_ok(oop_source *lp, oop_read *oread, oop_rd_event ev,
903                        const char *errmsg, int errnoval,
904                        const char *data, size_t recsz, void *cc_v) {
905   CliConn *cc= cc_v;
906
907   if (!data) {
908     info("CTRL%d closed", cc->fd);
909     cc->destroy(cc);
910     return OOP_CONTINUE;
911   }
912
913   if (recsz == 0) goto prompt;
914
915   const CliCommand *ccmd;
916   for (ccmd=cli_commands; ccmd->cmd; ccmd++) {
917     int l= strlen(ccmd->cmd);
918     if (recsz < l) continue;
919     if (recsz > l && data[l] != ' ') continue;
920     if (memcmp(data, ccmd->cmd, l)) continue;
921
922     int argl= (int)recsz - (l+1); 
923     ccmd->f(cc, ccmd, argl>=0 ? data+l+1 : 0, argl);
924     goto prompt;
925   }
926
927   fputs("unknown command; h for help\n", cc->out);
928
929  prompt:
930   cli_prompt(cc);
931   return OOP_CONTINUE;
932 }
933
934 static void *cli_rd_err(oop_source *lp, oop_read *oread, oop_rd_event ev,
935                         const char *errmsg, int errnoval,
936                         const char *data, size_t recsz, void *cc_v) {
937   CliConn *cc= cc_v;
938   
939   info("CTRL%d read error %s", cc->fd, errmsg);
940   cc->destroy(cc);
941   return OOP_CONTINUE;
942 }
943
944 static int cli_conn_startup(CliConn *cc /* may destroy*/,
945                                 const char *how) {
946   cc->rd= oop_rd_new_fd(loop, cc->fd, 0,0);
947   if (!cc->rd) { warn("oop_rd_new_fd cli failed"); return -1; }
948
949   int er= oop_rd_read(cc->rd, &cli_rd_style, MAX_CLI_COMMAND,
950                       cli_rd_ok, cc,
951                       cli_rd_err, cc);
952   if (er) { errno= er; syswarn("oop_rd_read cli failed"); return -1; }
953
954   info("CTRL%d %s ready", cc->fd, how);
955   cli_prompt(cc);
956   return 0;
957 }
958
959 static void cli_stdio_destroy(CliConn *cc) {
960   if (cc->rd) {
961     oop_rd_cancel(cc->rd);
962     errno= oop_rd_delete_tidy(cc->rd);
963     if (errno) syswarn("oop_rd_delete tidy failed (no-nonblock stdin?)");
964   }
965   free(cc);
966 }
967
968 static void cli_stdio(void) {
969   NEW_DECL(CliConn *,cc);
970   cc->destroy= cli_stdio_destroy;
971
972   cc->fd= 0;
973   cc->out= stdout;
974   int r= cli_conn_startup(cc,"stdio");
975   if (r) cc->destroy(cc);
976 }
977
978 static void cli_accepted_destroy(CliConn *cc) {
979   if (cc->rd) {
980     oop_rd_cancel(cc->rd);
981     oop_rd_delete_kill(cc->rd);
982   }
983   if (cc->out) { fclose(cc->out); cc->fd=0; }
984   close_perhaps(&cc->fd);
985   free(cc);
986 }
987
988 static void *cli_master_readable(oop_source *lp, int master,
989                                  oop_event ev, void *u) {
990   NEW_DECL(CliConn *,cc);
991   cc->destroy= cli_accepted_destroy;
992
993   cc->salen= sizeof(cc->sa);
994   cc->fd= accept(master, &cc->sa.sa, &cc->salen);
995   if (cc->fd<0) { syswarn("error accepting cli connection"); goto x; }
996
997   cc->out= fdopen(cc->fd, "w");
998   if (!cc->out) { syswarn("error fdopening accepted cli connection"); goto x; }
999
1000   int r= cli_conn_startup(cc, "accepted");
1001   if (r) goto x;
1002
1003   return OOP_CONTINUE;
1004
1005  x:
1006   cc->destroy(cc);
1007   return OOP_CONTINUE;
1008 }
1009
1010 #define NOCLI(...) do{                                          \
1011     syswarn("no cli listener, because failed to " __VA_ARGS__); \
1012     goto nocli;                                                 \
1013   }while(0)
1014
1015 static void cli_init(void) {
1016   union {
1017     struct sockaddr sa;
1018     struct sockaddr_un un;
1019   } sa;
1020
1021   memset(&sa,0,sizeof(sa));
1022   int maxlen= sizeof(sa.un.sun_path);
1023
1024   if (!path_cli) {
1025     info("control command line disabled");
1026     return;
1027   }
1028
1029   int pathlen= strlen(path_cli);
1030   if (pathlen > maxlen) {
1031     warn("no cli listener, because cli socket path %s too long (%d>%d)",
1032          path_cli, pathlen, maxlen);
1033     return;
1034   }
1035
1036   if (path_cli_dir) {
1037     int r= mkdir(path_cli_dir, 0700);
1038     if (r && errno!=EEXIST)
1039       NOCLI("create cli socket directory %s", path_cli_dir);
1040   }
1041
1042   int r= unlink(path_cli);
1043   if (r && errno!=ENOENT)
1044     NOCLI("remove old cli socket %s", path_cli);
1045
1046   cli_master= socket(PF_UNIX, SOCK_STREAM, 0);
1047   if (cli_master<0) NOCLI("create new cli master socket");
1048
1049   int sl= pathlen + offsetof(struct sockaddr_un, sun_path);
1050   sa.un.sun_family= AF_UNIX;
1051   memcpy(sa.un.sun_path, path_cli, pathlen);
1052
1053   r= bind(cli_master, &sa.sa, sl);
1054   if (r) NOCLI("bind to cli socket path %s", sa.un.sun_path);
1055
1056   r= listen(cli_master, 5);
1057   if (r) NOCLI("listen to cli master socket");
1058
1059   xsetnonblock(cli_master, 1);
1060
1061   loop->on_fd(loop, cli_master, OOP_READ, cli_master_readable, 0);
1062   info("cli ready, listening on %s", path_cli);
1063
1064   return;
1065
1066  nocli:
1067   xclose_perhaps(&cli_master, "cli master",0);
1068   return;
1069 }
1070
1071 /*========== management of connections ==========*/
1072
1073 static void reconnect_blocking_event(void) {
1074   until_connect= reconnect_delay_periods;
1075 }
1076
1077 static void conn_closefd(Conn *conn, const char *msgprefix) {
1078   int r= close_perhaps(&conn->fd);
1079   if (r) info("C%d %serror closing socket: %s",
1080               conn->fd, msgprefix, strerror(errno));
1081 }
1082
1083 static int conn_busy(Conn *conn) {
1084   return
1085     conn->waiting.count ||
1086     conn->priority.count ||
1087     conn->sent.count ||
1088     conn->xmitu;
1089 }
1090
1091 static void conn_dispose(Conn *conn) {
1092   if (!conn) return;
1093   if (conn->rd) {
1094     oop_rd_cancel(conn->rd);
1095     oop_rd_delete_kill(conn->rd);
1096     conn->rd= 0;
1097   }
1098   if (conn->fd) {
1099     loop->cancel_fd(loop, conn->fd, OOP_WRITE);
1100     loop->cancel_fd(loop, conn->fd, OOP_EXCEPTION);
1101   }
1102   conn_closefd(conn,"");
1103   free(conn);
1104 }
1105
1106 static void *conn_exception(oop_source *lp, int fd,
1107                             oop_event ev, void *conn_v) {
1108   Conn *conn= conn_v;
1109   unsigned char ch;
1110   assert(fd == conn->fd);
1111   assert(ev == OOP_EXCEPTION);
1112   int r= read(conn->fd, &ch, 1);
1113   if (r<0) connfail(conn,"read failed: %s",strerror(errno));
1114   else connfail(conn,"exceptional condition on socket (peer sent urgent"
1115                 " data? read(,&ch,1)=%d,ch='\\x%02x')",r,ch);
1116   return OOP_CONTINUE;
1117 }  
1118
1119 static void vconnfail(Conn *conn, const char *fmt, va_list al) {
1120   int requeue[art_MaxState];
1121   memset(requeue,0,sizeof(requeue));
1122
1123   Article *art;
1124   
1125   while ((art= LIST_REMHEAD(conn->priority)))
1126     LIST_ADDTAIL(art->ipf->queue, art);
1127
1128   while ((art= LIST_REMHEAD(conn->waiting)))
1129     LIST_ADDTAIL(art->ipf->queue, art);
1130
1131   while ((art= LIST_REMHEAD(conn->sent))) {
1132     requeue[art->state]++;
1133     if (art->state==art_Unsolicited) art->state= art_Unchecked;
1134     LIST_ADDTAIL(art->ipf->queue,art);
1135     check_reading_pause_resume(art->ipf);
1136   }
1137
1138   int i;
1139   XmitDetails *d;
1140   for (i=0, d=conn->xmitd; i<conn->xmitu; i++, d++)
1141     xmit_free(d);
1142
1143   LIST_REMOVE(conns,conn);
1144
1145   char *m= xvasprintf(fmt,al);
1146   warn("C%d (now %d) connection failed requeueing " RCI_TRIPLE_FMT_BASE ": %s",
1147        conn->fd, conns.count, RCI_TRIPLE_VALS_BASE(requeue, /*nothing*/), m);
1148   free(m);
1149
1150   reconnect_blocking_event();
1151   conn_dispose(conn);
1152   check_assign_articles();
1153 }
1154
1155 static void connfail(Conn *conn, const char *fmt, ...) {
1156   va_list al;
1157   va_start(al,fmt);
1158   vconnfail(conn,fmt,al);
1159   va_end(al);
1160 }
1161
1162 static void conn_idle_close(Conn *conn, const char *why) {
1163   static const char quitcmd[]= "QUIT\r\n";
1164   int todo= sizeof(quitcmd)-1;
1165   const char *p= quitcmd;
1166   for (;;) {
1167     int r= write(conn->fd, p, todo);
1168     if (r<0) {
1169       if (isewouldblock(errno))
1170         connfail(conn, "blocked writing QUIT to idle connection");
1171       else
1172         connfail(conn, "failed to write QUIT to idle connection: %s",
1173                  strerror(errno));
1174       break;
1175     }
1176     assert(r<=todo);
1177     todo -= r;
1178     if (!todo) {
1179       conn->quitting= why;
1180       conn->since_activity= 0;
1181       debug("C%d is idle (%s), quitting", conn->fd, why);
1182       break;
1183     }
1184   }
1185 }
1186
1187 /*
1188  * For our last connection, we also shut it down if we have had
1189  * less than K in the last L
1190  */
1191 static void check_idle_conns(void) {
1192   Conn *conn;
1193
1194   int volthisperiod= lowvol_perperiod[lowvol_circptr];
1195   lowvol_circptr++;
1196   lowvol_circptr %= lowvol_periods;
1197   lowvol_total += volthisperiod;
1198   lowvol_total -= lowvol_perperiod[lowvol_circptr];
1199   lowvol_perperiod[lowvol_circptr]= 0;
1200
1201   FOR_CONN(conn)
1202     conn->since_activity++;
1203
1204  search_again:
1205   FOR_CONN(conn) {
1206     if (conn->since_activity <= need_activity_periods) continue;
1207
1208     /* We need to shut this down */
1209     if (conn->quitting)
1210       connfail(conn,"timed out waiting for response to QUIT (%s)",
1211                conn->quitting);
1212     else if (conn->sent.count)
1213       connfail(conn,"timed out waiting for responses");
1214     else if (conn->waiting.count || conn->priority.count)
1215       connfail(conn,"BUG IN INNDUCT conn has queue but nothing sent");
1216     else if (conn->xmitu)
1217       connfail(conn,"peer has been sending responses"
1218                " before receiving our commands!");
1219     else
1220       conn_idle_close(conn, "no activity");
1221     
1222     goto search_again;
1223   }
1224
1225   conn= LIST_HEAD(conns);
1226   if (!volthisperiod &&
1227       conns.count==1 &&
1228       lowvol_total < lowvol_thresh &&
1229       !conn_busy(conn))
1230     conn_idle_close(conn, "low volume");
1231 }  
1232
1233 /*---------- making new connections ----------*/
1234
1235 static pid_t connecting_child;
1236 static int connecting_fdpass_sock;
1237
1238 static void connect_attempt_discard(void) {
1239   if (connecting_child) {
1240     int status= xwaitpid(&connecting_child, "connect");
1241     if (!(WIFEXITED(status) ||
1242           (WIFSIGNALED(status) && WTERMSIG(status) == SIGKILL)))
1243       report_child_status("connect", status);
1244   }
1245   if (connecting_fdpass_sock) {
1246     cancel_fd_read_except(connecting_fdpass_sock);
1247     xclose_perhaps(&connecting_fdpass_sock, "connecting fdpass socket",0);
1248   }
1249 }
1250
1251 #define PREP_DECL_MSG_CMSG(msg)                 \
1252   char msgbyte= 0;                              \
1253   struct iovec msgiov;                          \
1254   msgiov.iov_base= &msgbyte;                    \
1255   msgiov.iov_len= 1;                            \
1256   struct msghdr msg;                            \
1257   memset(&msg,0,sizeof(msg));                   \
1258   char msg##cbuf[CMSG_SPACE(sizeof(int))];      \
1259   msg.msg_iov= &msgiov;                         \
1260   msg.msg_iovlen= 1;                            \
1261   msg.msg_control= msg##cbuf;                   \
1262   msg.msg_controllen= sizeof(msg##cbuf);
1263
1264 static void *connchild_event(oop_source *lp, int fd, oop_event e, void *u) {
1265   Conn *conn= 0;
1266
1267   assert(fd == connecting_fdpass_sock);
1268
1269   PREP_DECL_MSG_CMSG(msg);
1270   
1271   ssize_t rs= recvmsg(fd, &msg, 0);
1272   if (rs<0) {
1273     if (isewouldblock(errno)) return OOP_CONTINUE;
1274     syswarn("failed to read socket from connecting child");
1275     goto x;
1276   }
1277
1278   NEW(conn);
1279   LIST_INIT(conn->waiting);
1280   LIST_INIT(conn->priority);
1281   LIST_INIT(conn->sent);
1282
1283   struct cmsghdr *h= 0;
1284   if (rs >= 0) h= CMSG_FIRSTHDR(&msg);
1285   if (!h) {
1286     int status= xwaitpid(&connecting_child, "connect child (broken)");
1287
1288     if (WIFEXITED(status)) {
1289       if (WEXITSTATUS(status) != 0 &&
1290           WEXITSTATUS(status) != CONNCHILD_ESTATUS_STREAM &&
1291           WEXITSTATUS(status) != CONNCHILD_ESTATUS_NOSTREAM)
1292         /* child already reported the problem */;
1293       else {
1294         if (e == OOP_EXCEPTION)
1295           warn("connect: connection child exited code %d but"
1296                " unexpected exception on fdpass socket",
1297                WEXITSTATUS(status));
1298         else
1299           warn("connect: connection child exited code %d but"
1300                " no cmsg (rs=%d)",
1301                WEXITSTATUS(status), (int)rs);
1302       }
1303     } else if (WIFSIGNALED(status) && WTERMSIG(status) == SIGALRM) {
1304       warn("connect: connection attempt timed out");
1305     } else {
1306       report_child_status("connect", status);
1307     }
1308     goto x;
1309   }
1310
1311 #define CHK(field, val)                                                  \
1312   if (h->cmsg_##field != val) {                                          \
1313     die("connect: child sent cmsg with cmsg_" #field "=%d, expected %d", \
1314         h->cmsg_##field, val);                                           \
1315     goto x;                                                              \
1316   }
1317   CHK(level, SOL_SOCKET);
1318   CHK(type,  SCM_RIGHTS);
1319   CHK(len,   CMSG_LEN(sizeof(conn->fd)));
1320 #undef CHK
1321
1322   if (CMSG_NXTHDR(&msg,h)) die("connect: child sent many cmsgs");
1323
1324   memcpy(&conn->fd, CMSG_DATA(h), sizeof(conn->fd));
1325
1326   int status;
1327   pid_t got= waitpid(connecting_child, &status, 0);
1328   if (got==-1) sysdie("connect: real wait for child");
1329   assert(got == connecting_child);
1330   connecting_child= 0;
1331
1332   if (!WIFEXITED(status)) { report_child_status("connect",status); goto x; }
1333   int es= WEXITSTATUS(status);
1334   switch (es) {
1335   case CONNCHILD_ESTATUS_STREAM:    conn->stream= 1;   break;
1336   case CONNCHILD_ESTATUS_NOSTREAM:  conn->stream= 0;   break;
1337   default:
1338     fatal("connect: child gave unexpected exit status %d", es);
1339   }
1340
1341   /* Phew! */
1342   conn->max_queue= conn->stream ? max_queue_per_conn : 1;
1343
1344   loop->on_fd(loop, conn->fd, OOP_EXCEPTION, conn_exception, conn);
1345   conn->rd= oop_rd_new_fd(loop,conn->fd, 0, 0); /* sets nonblocking, too */
1346   if (!conn->fd) die("oop_rd_new_fd conn failed (fd=%d)",conn->fd);
1347   int r= oop_rd_read(conn->rd, &peer_rd_style, NNTP_STRLEN,
1348                      &peer_rd_ok, conn,
1349                      &peer_rd_err, conn);
1350   if (r) sysdie("oop_rd_read for peer (fd=%d)",conn->fd);
1351
1352   LIST_ADDHEAD(conns, conn);
1353   notice("C%d (now %d) connected %s",
1354          conn->fd, conns.count, conn->stream ? "streaming" : "plain");
1355
1356   connect_attempt_discard();
1357   check_assign_articles();
1358   return OOP_CONTINUE;
1359
1360  x:
1361   conn_dispose(conn);
1362   connect_attempt_discard();
1363   reconnect_blocking_event();
1364   return OOP_CONTINUE;
1365 }
1366
1367 static int allow_connect_start(void) {
1368   return conns.count < max_connections
1369     && !connecting_child
1370     && !until_connect;
1371 }
1372
1373 static void connect_start(void) {
1374   assert(!connecting_child);
1375   assert(!connecting_fdpass_sock);
1376
1377   info("starting connection attempt");
1378   int ok_until_connect= until_connect;
1379   reconnect_blocking_event();
1380
1381   int socks[2];
1382   int r= socketpair(AF_UNIX, SOCK_STREAM, 0, socks);
1383   if (r) { syswarn("connect: cannot create socketpair for child"); return; }
1384
1385   connecting_child= xfork("connection");
1386
1387   if (!connecting_child) {
1388     FILE *cn_from, *cn_to;
1389     char buf[NNTP_STRLEN+100];
1390     int exitstatus= CONNCHILD_ESTATUS_NOSTREAM;
1391
1392     xclose(socks[0], "(in child) parent's connection fdpass socket",0);
1393
1394     alarm(connection_setup_timeout);
1395     if (NNTPconnect((char*)remote_host, port, &cn_from, &cn_to, buf) < 0) {
1396       int l= strlen(buf);
1397       int stripped=0;
1398       while (l>0) {
1399         unsigned char c= buf[l-1];
1400         if (!isspace(c)) break;
1401         if (c=='\n' || c=='\r') stripped=1;
1402         --l;
1403       }
1404       if (!buf[0]) {
1405         sysfatal("connect: connection attempt failed");
1406       } else {
1407         buf[l]= 0;
1408         fatal("connect: %s: %s", stripped ? "rejected" : "failed",
1409               sanitise(buf,-1));
1410       }
1411     }
1412     if (NNTPsendpassword((char*)remote_host, cn_from, cn_to) < 0)
1413       sysfatal("connect: authentication failed");
1414     if (try_stream) {
1415       if (fputs("MODE STREAM\r\n", cn_to)==EOF ||
1416           fflush(cn_to))
1417         sysfatal("connect: could not send MODE STREAM");
1418       buf[sizeof(buf)-1]= 0;
1419       if (!fgets(buf, sizeof(buf)-1, cn_from)) {
1420         if (ferror(cn_from))
1421           sysfatal("connect: could not read response to MODE STREAM");
1422         else
1423           fatal("connect: connection close in response to MODE STREAM");
1424       }
1425       int l= strlen(buf);
1426       assert(l>=1);
1427       if (buf[l-1]!='\n')
1428         fatal("connect: response to MODE STREAM is too long: %.100s...",
1429               sanitise(buf,-1));
1430       l--;  if (l>0 && buf[l-1]=='\r') l--;
1431       buf[l]= 0;
1432       char *ep;
1433       int rcode= strtoul(buf,&ep,10);
1434       if (ep != &buf[3])
1435         fatal("connect: bad response to MODE STREAM: %.50s", sanitise(buf,-1));
1436
1437       switch (rcode) {
1438       case 203:
1439         exitstatus= CONNCHILD_ESTATUS_STREAM;
1440         break;
1441       case 480:
1442       case 500:
1443         break;
1444       default:
1445         warn("connect: unexpected response to MODE STREAM: %.50s",
1446              sanitise(buf,-1));
1447         exitstatus= 2;
1448         break;
1449       }
1450     }
1451     int fd= fileno(cn_from);
1452
1453     PREP_DECL_MSG_CMSG(msg);
1454     struct cmsghdr *cmsg= CMSG_FIRSTHDR(&msg);
1455     cmsg->cmsg_level= SOL_SOCKET;
1456     cmsg->cmsg_type=  SCM_RIGHTS;
1457     cmsg->cmsg_len=   CMSG_LEN(sizeof(fd));
1458     memcpy(CMSG_DATA(cmsg), &fd, sizeof(fd));
1459
1460     msg.msg_controllen= cmsg->cmsg_len;
1461     r= sendmsg(socks[1], &msg, 0);
1462     if (r<0) sysdie("sendmsg failed for new connection");
1463     if (r!=1) die("sendmsg for new connection gave wrong result %d",r);
1464
1465     _exit(exitstatus);
1466   }
1467
1468   xclose(socks[1], "connecting fdpass child's socket",0);
1469   connecting_fdpass_sock= socks[0];
1470   xsetnonblock(connecting_fdpass_sock, 1);
1471   on_fd_read_except(connecting_fdpass_sock, connchild_event);
1472
1473   if (!conns.count)
1474     until_connect= ok_until_connect;
1475 }
1476
1477 /*---------- assigning articles to conns, and transmitting ----------*/
1478
1479 static Article *dequeue_from(int peek, InputFile *ipf) {
1480   if (!ipf) return 0;
1481   if (peek) return LIST_HEAD(ipf->queue);
1482
1483   Article *art= LIST_REMHEAD(ipf->queue);
1484   if (!art) return 0;
1485   check_reading_pause_resume(ipf);
1486   return art;
1487 }
1488
1489 static Article *dequeue(int peek) {
1490   Article *art;
1491   art= dequeue_from(peek, flushing_input_file);  if (art) return art;
1492   art= dequeue_from(peek, backlog_input_file);   if (art) return art;
1493   art= dequeue_from(peek, main_input_file);      if (art) return art;
1494   return 0;
1495 }
1496
1497 static void check_assign_articles(void) {
1498   for (;;) {
1499     if (!dequeue(1))
1500       break;
1501
1502     Conn *walk, *use=0;
1503     int spare=0, inqueue=0;
1504
1505     /* Find a connection to offer this article.  We prefer a busy
1506      * connection to an idle one, provided it's not full.  We take the
1507      * first (oldest) and since that's stable, it will mean we fill up
1508      * connections in order.  That way if we have too many
1509      * connections, the spare ones will go away eventually.
1510      */
1511     FOR_CONN(walk) {
1512       if (walk->quitting) continue;
1513       inqueue= walk->sent.count + walk->priority.count
1514              + walk->waiting.count;
1515       spare= walk->max_queue - inqueue;
1516       assert(inqueue <= max_queue_per_conn);
1517       assert(spare >= 0);
1518       if (inqueue==0) /*idle*/ { if (!use) use= walk; }
1519       else if (spare>0) /*working*/ { use= walk; break; }
1520     }
1521     if (use) {
1522       if (!inqueue) use->since_activity= 0; /* reset idle counter */
1523       while (spare>0) {
1524         Article *art= dequeue(0);
1525         if (!art) break;
1526         LIST_ADDTAIL(use->waiting, art);
1527         lowvol_perperiod[lowvol_circptr]++;
1528         spare--;
1529       }
1530       conn_maybe_write(use);
1531     } else if (allow_connect_start()) {
1532       connect_start();
1533       break;
1534     } else {
1535       break;
1536     }
1537   }
1538 }
1539
1540 static void *conn_writeable(oop_source *l, int fd, oop_event ev, void *u) {
1541   conn_maybe_write(u);
1542   return OOP_CONTINUE;
1543 }
1544
1545 static void conn_maybe_write(Conn *conn)  {
1546   for (;;) {
1547     conn_make_some_xmits(conn);
1548     if (!conn->xmitu) {
1549       loop->cancel_fd(loop, conn->fd, OOP_WRITE);
1550       return;
1551     }
1552
1553     void *rp= conn_write_some_xmits(conn);
1554     if (rp==OOP_CONTINUE) {
1555       loop->on_fd(loop, conn->fd, OOP_WRITE, conn_writeable, conn);
1556       return;
1557     } else if (rp==OOP_HALT) {
1558       return;
1559     } else if (!rp) {
1560       /* transmitted everything */
1561     } else {
1562       abort();
1563     }
1564   }
1565 }
1566
1567 /*---------- expiry, flow control and deferral ----------*/
1568
1569 /*
1570  * flow control notes
1571  * to ensure articles go away eventually
1572  * separate queue for each input file
1573  *   queue expiry
1574  *     every period, check head of backlog queue for expiry with SMretrieve
1575  *       if too old: discard, and check next article
1576  *     also check every backlog article as we read it
1577  *   flush expiry
1578  *     after too long in SEPARATED/DROPPING ie Separated/Finishing/Dropping
1579  *     one-off: eat queued articles from flushing and write them to defer
1580  *     one-off: connfail all connections which have any articles from flushing
1581  *     newly read articles from flushing go straight to defer
1582  *     this should take care of it and get us out of this state
1583  * to avoid filling up ram needlessly
1584  *   input control
1585  *     limit number of queued articles for each ipf
1586  *     pause/resume inputfile tailing
1587  */
1588
1589 static void check_reading_pause_resume(InputFile *ipf) {
1590   if (ipf->queue.count >= max_queue_per_ipf)
1591     inputfile_reading_pause(ipf);
1592   else
1593     inputfile_reading_resume(ipf);
1594 }
1595
1596 static void article_defer(Article *art /* not on a queue */, int whichcount) {
1597   open_defer();
1598   if (fprintf(defer, "%s %s\n", TokenToText(art->token), art->messageid) <0
1599       || fflush(defer))
1600     sysfatal("write to defer file %s",path_defer);
1601   article_done(art, whichcount);
1602 }
1603
1604 static int article_check_expired(Article *art /* must be queued, not conn */) {
1605   ARTHANDLE *artdata= SMretrieve(art->token, RETR_STAT);
1606   if (artdata) { SMfreearticle(artdata); return 0; }
1607
1608   LIST_REMOVE(art->ipf->queue, art);
1609   art->missing= 1;
1610   art->ipf->count_nooffer_missing++;
1611   article_done(art,-1);
1612   return 1;
1613 }
1614
1615 static void inputfile_queue_check_expired(InputFile *ipf) {
1616   if (!ipf) return;
1617
1618   for (;;) {
1619     Article *art= LIST_HEAD(ipf->queue);
1620     int exp= article_check_expired(art);
1621     if (!exp) break;
1622   }
1623   check_reading_pause_resume(ipf);
1624 }
1625
1626 static void article_autodefer(InputFile *ipf, Article *art) {
1627   ipf->autodefer++;
1628   article_defer(art,-1);
1629 }
1630
1631 static int has_article_in(const ArticleList *al, InputFile *ipf) {
1632   Article *art;
1633   for (art=LIST_HEAD(*al); art; art=LIST_NEXT(art))
1634     if (art->ipf == ipf) return 1;
1635   return 0;
1636 }
1637
1638 static void autodefer_input_file_articles(InputFile *ipf) {
1639   Article *art;
1640   while ((art= LIST_REMHEAD(ipf->queue)))
1641     article_autodefer(ipf, art);
1642 }
1643
1644 static void autodefer_input_file(InputFile *ipf) {
1645   static const char *const abandon= "stuck";
1646   ipf->autodefer= 0;
1647
1648   autodefer_input_file_articles(ipf);
1649
1650   if (ipf->inprogress) {
1651     Conn *walk;
1652     FOR_CONN(walk) {
1653       if (has_article_in(&walk->waiting,  ipf) ||
1654           has_article_in(&walk->priority, ipf) ||
1655           has_article_in(&walk->sent,     ipf))
1656         walk->quitting= abandon;
1657     }
1658     while (ipf->inprogress) {
1659       FOR_CONN(walk)
1660         if (walk->quitting == abandon) goto found;
1661       abort(); /* where are they ?? */
1662
1663     found:
1664       connfail(walk, "connection is stuck or crawling,"
1665                " and we need to finish flush");
1666       autodefer_input_file_articles(ipf);
1667     }
1668   }
1669
1670   check_reading_pause_resume(ipf);
1671 }
1672
1673 /*========== article transmission ==========*/
1674
1675 static XmitDetails *xmit_core(Conn *conn, const char *data, int len,
1676                   XmitKind kind) { /* caller must then fill in details */
1677   struct iovec *v= &conn->xmit[conn->xmitu];
1678   XmitDetails *d= &conn->xmitd[conn->xmitu++];
1679   v->iov_base= (char*)data;
1680   v->iov_len= len;
1681   d->kind= kind;
1682   return d;
1683 }
1684
1685 static void xmit_noalloc(Conn *conn, const char *data, int len) {
1686   xmit_core(conn,data,len, xk_Const);
1687 }
1688 #define XMIT_LITERAL(lit) (xmit_noalloc(conn, (lit), sizeof(lit)-1))
1689
1690 static void xmit_artbody(Conn *conn, ARTHANDLE *ah /* consumed */) {
1691   XmitDetails *d= xmit_core(conn, ah->data, ah->len, xk_Artdata);
1692   d->info.sm_art= ah;
1693 }
1694
1695 static void xmit_free(XmitDetails *d) {
1696   switch (d->kind) {
1697   case xk_Artdata: SMfreearticle(d->info.sm_art); break;
1698   case xk_Const:                                  break;
1699   default: abort();
1700   }
1701 }
1702
1703 static void *conn_write_some_xmits(Conn *conn) {
1704   /* return values:
1705    *      0:            nothing more to write, no need to call us again
1706    *      OOP_CONTINUE: more to write but fd not writeable
1707    *      OOP_HALT:     disaster, have destroyed conn
1708    */
1709   for (;;) {
1710     int count= conn->xmitu;
1711     if (!count) return 0;
1712
1713     if (count > IOV_MAX) count= IOV_MAX;
1714     ssize_t rs= writev(conn->fd, conn->xmit, count);
1715     if (rs < 0) {
1716       if (isewouldblock(errno)) return OOP_CONTINUE;
1717       connfail(conn, "write failed: %s", strerror(errno));
1718       return OOP_HALT;
1719     }
1720     assert(rs > 0);
1721
1722     int done;
1723     for (done=0; rs; ) {
1724       assert(done<conn->xmitu);
1725       struct iovec *vp= &conn->xmit[done];
1726       XmitDetails *dp= &conn->xmitd[done];
1727       if (rs >= vp->iov_len) {
1728         rs -= vp->iov_len;
1729         xmit_free(dp); /* vp->iov_len -= vp->iov_len, etc. */
1730         done++;
1731       } else {
1732         vp->iov_base= (char*)vp->iov_base + rs;
1733         vp->iov_len -= rs;
1734         break; /* rs -= rs */
1735       }
1736     }
1737     int newu= conn->xmitu - done;
1738     memmove(conn->xmit,  conn->xmit  + done, newu * sizeof(*conn->xmit));
1739     memmove(conn->xmitd, conn->xmitd + done, newu * sizeof(*conn->xmitd));
1740     conn->xmitu= newu;
1741   }
1742 }
1743
1744 static void conn_make_some_xmits(Conn *conn) {
1745   for (;;) {
1746     if (conn->xmitu+5 > CONNIOVS)
1747       break;
1748
1749     Article *art= LIST_REMHEAD(conn->priority);
1750     if (!art) art= LIST_REMHEAD(conn->waiting);
1751     if (!art) break;
1752
1753     if (art->state >= art_Wanted || (conn->stream && nocheck)) {
1754       /* actually send it */
1755
1756       ARTHANDLE *artdata= SMretrieve(art->token, RETR_ALL);
1757
1758       art->state=
1759         art->state == art_Unchecked ? art_Unsolicited :
1760         art->state == art_Wanted    ? art_Wanted      :
1761         (abort(),-1);
1762
1763       if (!artdata) art->missing= 1;
1764       art->ipf->counts[art->state][ artdata ? RC_sent : RC_missing ]++;
1765
1766       if (conn->stream) {
1767         if (artdata) {
1768           XMIT_LITERAL("TAKETHIS ");
1769           xmit_noalloc(conn, art->messageid, art->midlen);
1770           XMIT_LITERAL("\r\n");
1771           xmit_artbody(conn, artdata);
1772         } else {
1773           article_done(art, -1);
1774           continue;
1775         }
1776       } else {
1777         /* we got 235 from IHAVE */
1778         if (artdata) {
1779           xmit_artbody(conn, artdata);
1780         } else {
1781           XMIT_LITERAL(".\r\n");
1782         }
1783       }
1784
1785       LIST_ADDTAIL(conn->sent, art);
1786
1787     } else {
1788       /* check it */
1789
1790       if (conn->stream)
1791         XMIT_LITERAL("CHECK ");
1792       else
1793         XMIT_LITERAL("IHAVE ");
1794       xmit_noalloc(conn, art->messageid, art->midlen);
1795       XMIT_LITERAL("\r\n");
1796
1797       assert(art->state == art_Unchecked);
1798       art->ipf->counts[art->state][RC_sent]++;
1799       LIST_ADDTAIL(conn->sent, art);
1800     }
1801   }
1802 }
1803
1804 /*========== handling responses from peer ==========*/
1805
1806 static const oop_rd_style peer_rd_style= {
1807   OOP_RD_DELIM_STRIP, '\n',
1808   OOP_RD_NUL_FORBID,
1809   OOP_RD_SHORTREC_FORBID
1810 };
1811
1812 static void *peer_rd_err(oop_source *lp, oop_read *oread, oop_rd_event ev,
1813                          const char *errmsg, int errnoval,
1814                          const char *data, size_t recsz, void *conn_v) {
1815   Conn *conn= conn_v;
1816   connfail(conn, "error receiving from peer: %s", errmsg);
1817   return OOP_CONTINUE;
1818 }
1819
1820 static Article *article_reply_check(Conn *conn, const char *response,
1821                                     int code_indicates_streaming,
1822                                     int must_have_sent
1823                                         /* 1:yes, -1:no, 0:dontcare */,
1824                                     const char *sanitised_response) {
1825   Article *art= LIST_HEAD(conn->sent);
1826
1827   if (!art) {
1828     connfail(conn,
1829              "peer gave unexpected response when no commands outstanding: %s",
1830              sanitised_response);
1831     return 0;
1832   }
1833
1834   if (code_indicates_streaming) {
1835     assert(!memchr(response, 0, 4)); /* ensured by peer_rd_ok */
1836     if (!conn->stream) {
1837       connfail(conn, "peer gave streaming response code "
1838                " to IHAVE or subsequent body: %s", sanitised_response);
1839       return 0;
1840     }
1841     const char *got_mid= response+4;
1842     int got_midlen= strcspn(got_mid, " \n\r");
1843     if (got_midlen<3 || got_mid[0]!='<' || got_mid[got_midlen-1]!='>') {
1844       connfail(conn, "peer gave streaming response with syntactically invalid"
1845                " messageid: %s", sanitised_response);
1846       return 0;
1847     }
1848     if (got_midlen != art->midlen ||
1849         memcmp(got_mid, art->messageid, got_midlen)) {
1850       connfail(conn, "peer gave streaming response code to wrong article -"
1851                " probable synchronisation problem; we offered: %s;"
1852                " peer said: %s",
1853                art->messageid, sanitised_response);
1854       return 0;
1855     }
1856   } else {
1857     if (conn->stream) {
1858       connfail(conn, "peer gave non-streaming response code to"
1859                " CHECK/TAKETHIS: %s", sanitised_response);
1860       return 0;
1861     }
1862   }
1863
1864   if (must_have_sent>0 && art->state < art_Wanted) {
1865     connfail(conn, "peer says article accepted but"
1866              " we had not sent the body: %s", sanitised_response);
1867     return 0;
1868   }
1869   if (must_have_sent<0 && art->state >= art_Wanted) {
1870     connfail(conn, "peer says please sent the article but we just did: %s",
1871              sanitised_response);
1872     return 0;
1873   }
1874
1875   Article *art_again= LIST_REMHEAD(conn->sent);
1876   assert(art_again == art);
1877   return art;
1878 }
1879
1880 static void update_nocheck(int accepted) {
1881   accept_proportion *= nocheck_decay;
1882   accept_proportion += accepted * (1.0 - nocheck_decay);
1883   int new_nocheck= accept_proportion >= nocheck_thresh;
1884   if (new_nocheck && !nocheck_reported) {
1885     notice("entering nocheck mode for the first time");
1886     nocheck_reported= 1;
1887   } else if (new_nocheck != nocheck) {
1888     debug("nocheck mode %s", new_nocheck ? "start" : "stop");
1889   }
1890   nocheck= new_nocheck;
1891 }
1892
1893 static void article_done(Article *art, int whichcount) {
1894   if (whichcount>=0 && !art->missing)
1895     art->ipf->counts[art->state][whichcount]++;
1896
1897   if (whichcount == RC_accepted) update_nocheck(1);
1898   else if (whichcount == RC_unwanted) update_nocheck(0);
1899
1900   InputFile *ipf= art->ipf;
1901
1902   while (art->blanklen) {
1903     static const char spaces[]=
1904       "                                                                "
1905       "                                                                "
1906       "                                                                "
1907       "                                                                "
1908       "                                                                "
1909       "                                                                "
1910       "                                                                "
1911       "                                                                "
1912       "                                                                ";
1913     int w= art->blanklen;  if (w >= sizeof(spaces)) w= sizeof(spaces)-1;
1914     int r= pwrite(ipf->fd, spaces, w, art->offset);
1915     if (r==-1) {
1916       if (errno==EINTR) continue;
1917       sysdie("failed to blank entry for %s (length %d at offset %lu) in %s",
1918              art->messageid, art->blanklen,
1919              (unsigned long)art->offset, ipf->path);
1920     }
1921     assert(r>=0 && r<=w);
1922     art->blanklen -= w;
1923     art->offset += w;
1924   }
1925
1926   ipf->inprogress--;
1927   assert(ipf->inprogress >= 0);
1928   free(art);
1929
1930   if (!ipf->inprogress && ipf != main_input_file)
1931     queue_check_input_done();
1932 }
1933
1934 static void *peer_rd_ok(oop_source *lp, oop_read *oread, oop_rd_event ev,
1935                         const char *errmsg, int errnoval,
1936                         const char *data, size_t recsz, void *conn_v) {
1937   Conn *conn= conn_v;
1938
1939   if (ev == OOP_RD_EOF) {
1940     connfail(conn, "unexpected EOF from peer");
1941     return OOP_CONTINUE;
1942   }
1943   assert(ev == OOP_RD_OK);
1944
1945   char *sani= sanitise(data,-1);
1946
1947   char *ep;
1948   unsigned long code= strtoul(data, &ep, 10);
1949   if (ep != data+3 || *ep != ' ' || data[0]=='0') {
1950     connfail(conn, "badly formatted response from peer: %s", sani);
1951     return OOP_CONTINUE;
1952   }
1953
1954   int busy= conn_busy(conn);
1955
1956   if (conn->quitting) {
1957     if (code!=205 && code!=400) {
1958       connfail(conn, "peer gave unexpected response to QUIT (%s): %s",
1959                conn->quitting, sani);
1960     } else {
1961       LIST_REMOVE(conns,conn);
1962       notice("C%d (now %d) idle connection closed (%s)",
1963              conn->fd, conns.count, conn->quitting);
1964       assert(!busy);
1965       conn_dispose(conn);
1966     }
1967     return OOP_CONTINUE;
1968   }
1969
1970   conn->since_activity= 0;
1971   Article *art;
1972
1973 #define GET_ARTICLE(musthavesent) do{                                         \
1974     art= article_reply_check(conn, data, code_streaming, musthavesent, sani); \
1975     if (!art) return OOP_CONTINUE; /* reply_check has failed the conn */      \
1976   }while(0) 
1977
1978 #define ARTICLE_DEALTWITH(streaming,musthavesent,how) do{       \
1979     code_streaming= (streaming);                                \
1980     GET_ARTICLE(musthavesent);                                  \
1981     article_done(art, RC_##how);                                \
1982     goto dealtwith;                                             \
1983   }while(0)
1984
1985 #define PEERBADMSG(m) do {                                      \
1986     connfail(conn, m ": %s", sani);  return OOP_CONTINUE;       \
1987   }while(0)
1988
1989   int code_streaming= 0;
1990
1991   switch (code) {
1992
1993   default:  PEERBADMSG("peer sent unexpected message");
1994
1995   case 400:
1996     if (busy)
1997       PEERBADMSG("peer timed us out or stopped accepting articles");
1998
1999     LIST_REMOVE(conns,conn);
2000     notice("C%d (now %d) idle connection closed by peer",
2001            conns.count, conn->fd);
2002     conn_dispose(conn);
2003     return OOP_CONTINUE;
2004
2005   case 435: ARTICLE_DEALTWITH(0,0,unwanted); /* IHAVE says they have it */
2006   case 438: ARTICLE_DEALTWITH(1,0,unwanted); /* CHECK/TAKETHIS: they have it */
2007
2008   case 235: ARTICLE_DEALTWITH(0,1,accepted); /* IHAVE says thanks */
2009   case 239: ARTICLE_DEALTWITH(1,1,accepted); /* TAKETHIS says thanks */
2010
2011   case 437: ARTICLE_DEALTWITH(0,0,rejected); /* IHAVE says rejected */
2012   case 439: ARTICLE_DEALTWITH(1,0,rejected); /* TAKETHIS says rejected */
2013
2014   case 238: /* CHECK says send it */
2015     code_streaming= 1;
2016   case 335: /* IHAVE says send it */
2017     GET_ARTICLE(-1);
2018     assert(art->state == art_Unchecked);
2019     art->ipf->counts[art->state][RC_accepted]++;
2020     art->state= art_Wanted;
2021     LIST_ADDTAIL(conn->priority, art);
2022     break;
2023
2024   case 431: /* CHECK or TAKETHIS says try later */
2025     code_streaming= 1;
2026   case 436: /* IHAVE says try later */
2027     GET_ARTICLE(0);
2028     article_defer(art, RC_deferred);
2029     break;
2030
2031   }
2032 dealtwith:
2033
2034   conn_maybe_write(conn);
2035   check_assign_articles();
2036   return OOP_CONTINUE;
2037 }
2038
2039
2040 /*========== monitoring of input files ==========*/
2041
2042 static void feedfile_eof(InputFile *ipf) {
2043   assert(ipf != main_input_file); /* promised by tailing_try_read */
2044   inputfile_reading_stop(ipf);
2045
2046   if (ipf == flushing_input_file) {
2047     assert(sms==sm_SEPARATED || sms==sm_DROPPING);
2048     if (main_input_file) inputfile_reading_start(main_input_file);
2049     statemc_check_flushing_done();
2050   } else if (ipf == backlog_input_file) {
2051     statemc_check_backlog_done();
2052   } else {
2053     abort(); /* supposed to wait rather than get EOF on main input file */
2054   }
2055 }
2056
2057 static InputFile *open_input_file(const char *path) {
2058   int fd= open(path, O_RDWR);
2059   if (fd<0) {
2060     if (errno==ENOENT) return 0;
2061     sysfatal("unable to open input file %s", path);
2062   }
2063   assert(fd>0);
2064
2065   InputFile *ipf= xmalloc(sizeof(*ipf) + strlen(path) + 1);
2066   memset(ipf,0,sizeof(*ipf));
2067
2068   ipf->fd= fd;
2069   ipf->autodefer= -1;
2070   LIST_INIT(ipf->queue);
2071   strcpy(ipf->path, path);
2072
2073   return ipf;
2074 }
2075
2076 static void close_input_file(InputFile *ipf) { /* does not free */
2077   assert(!ipf->readable_callback); /* must have had ->on_cancel */
2078   assert(!ipf->filemon); /* must have had inputfile_reading_stop */
2079   assert(!ipf->rd); /* must have had inputfile_reading_stop */
2080   assert(!ipf->inprogress); /* no dangling pointers pointing here */
2081   xclose_perhaps(&ipf->fd, "input file ", ipf->path);
2082 }
2083
2084
2085 /*---------- dealing with articles read in the input file ----------*/
2086
2087 static void *feedfile_got_bad_data(InputFile *ipf, off_t offset,
2088                                    const char *data, const char *how) {
2089   warn("corrupted file: %s, offset %lu: %s: in %s",
2090        ipf->path, (unsigned long)offset, how, sanitise(data,-1));
2091   ipf->readcount_err++;
2092   if (ipf->readcount_err > max_bad_data_initial +
2093       (ipf->readcount_ok+ipf->readcount_blank) / max_bad_data_ratio)
2094     die("too much garbage in input file!  (%d errs, %d ok, %d blank)",
2095         ipf->readcount_err, ipf->readcount_ok, ipf->readcount_blank);
2096   return OOP_CONTINUE;
2097 }
2098
2099 static void *feedfile_read_err(oop_source *lp, oop_read *rd,
2100                                oop_rd_event ev, const char *errmsg,
2101                                int errnoval, const char *data, size_t recsz,
2102                                void *ipf_v) {
2103   InputFile *ipf= ipf_v;
2104   assert(ev == OOP_RD_SYSTEM);
2105   errno= errnoval;
2106   sysdie("error reading input file: %s, offset %lu",
2107          ipf->path, (unsigned long)ipf->offset);
2108 }
2109
2110 static void *feedfile_got_article(oop_source *lp, oop_read *rd,
2111                                   oop_rd_event ev, const char *errmsg,
2112                                   int errnoval, const char *data, size_t recsz,
2113                                   void *ipf_v) {
2114   InputFile *ipf= ipf_v;
2115   Article *art;
2116   char tokentextbuf[sizeof(TOKEN)*2+3];
2117
2118   if (!data) { feedfile_eof(ipf); return OOP_CONTINUE; }
2119
2120   off_t old_offset= ipf->offset;
2121   ipf->offset += recsz + !!(ev == OOP_RD_OK);
2122
2123 #define X_BAD_DATA(m) return feedfile_got_bad_data(ipf,old_offset,data,m);
2124
2125   if (ev==OOP_RD_PARTREC)
2126     feedfile_got_bad_data(ipf,old_offset,data,"missing final newline");
2127     /* but process it anyway */
2128
2129   if (ipf->skippinglong) {
2130     if (ev==OOP_RD_OK) ipf->skippinglong= 0; /* fine now */
2131     return OOP_CONTINUE;
2132   }
2133   if (ev==OOP_RD_LONG) {
2134     ipf->skippinglong= 1;
2135     X_BAD_DATA("overly long line");
2136   }
2137
2138   if (memchr(data,'\0',recsz)) X_BAD_DATA("nul byte");
2139   if (!recsz) X_BAD_DATA("empty line");
2140
2141   if (data[0]==' ') {
2142     if (strspn(data," ") != recsz) X_BAD_DATA("line partially blanked");
2143     ipf->readcount_blank++;
2144     return OOP_CONTINUE;
2145   }
2146
2147   char *space= strchr(data,' ');
2148   int tokenlen= space-data;
2149   int midlen= (int)recsz-tokenlen-1;
2150   if (midlen <= 2) X_BAD_DATA("no room for messageid");
2151   if (space[1]!='<' || space[midlen]!='>') X_BAD_DATA("invalid messageid");
2152
2153   if (tokenlen != sizeof(TOKEN)*2+2) X_BAD_DATA("token wrong length");
2154   memcpy(tokentextbuf, data, tokenlen);
2155   tokentextbuf[tokenlen]= 0;
2156   if (!IsToken(tokentextbuf)) X_BAD_DATA("token wrong syntax");
2157
2158   ipf->readcount_ok++;
2159
2160   art= xmalloc(sizeof(*art) - 1 + midlen + 1);
2161   memset(art,0,sizeof(*art));
2162   art->state= art_Unchecked;
2163   art->midlen= midlen;
2164   art->ipf= ipf;  ipf->inprogress++;
2165   art->token= TextToToken(tokentextbuf);
2166   art->offset= old_offset;
2167   art->blanklen= recsz;
2168   strcpy(art->messageid, space+1);
2169   LIST_ADDTAIL(ipf->queue, art);
2170
2171   if (ipf->autodefer >= 0)
2172     article_autodefer(ipf, art);
2173   else if (ipf==backlog_input_file)
2174     article_check_expired(art);
2175
2176   if (sms==sm_NORMAL && ipf==main_input_file &&
2177       ipf->offset >= target_max_feedfile_size)
2178     statemc_start_flush("feed file size");
2179
2180   check_assign_articles(); /* may destroy conn but that's OK */
2181   check_reading_pause_resume(ipf);
2182   return OOP_CONTINUE;
2183 }
2184
2185 /*========== tailing input file ==========*/
2186
2187 static void *tailing_rable_call_time(oop_source *loop, struct timeval tv,
2188                                      void *user) {
2189   /* lifetime of ipf here is OK because destruction will cause
2190    * on_cancel which will cancel this callback */
2191   InputFile *ipf= user;
2192
2193   if (!ipf->fake_readable) return OOP_CONTINUE;
2194
2195   /* we just keep calling readable until our caller (oop_rd)
2196    * has called try_read, and try_read has found EOF so given EAGAIN */
2197   loop->on_time(loop, OOP_TIME_NOW, tailing_rable_call_time, ipf);
2198
2199   return ipf->readable_callback(loop, &ipf->readable,
2200                                 ipf->readable_callback_user);
2201 }
2202
2203 static void tailing_on_cancel(struct oop_readable *rable) {
2204   InputFile *ipf= (void*)rable;
2205
2206   if (ipf->filemon) filemon_stop(ipf);
2207   loop->cancel_time(loop, OOP_TIME_NOW, tailing_rable_call_time, ipf);
2208   ipf->readable_callback= 0;
2209 }
2210
2211 static void tailing_make_readable(InputFile *ipf) {
2212   if (!ipf || !ipf->readable_callback) /* so callers can be naive */
2213     return;
2214   ipf->fake_readable= 1;
2215   loop->on_time(loop, OOP_TIME_NOW, tailing_rable_call_time, ipf);
2216 }
2217
2218 static int tailing_on_readable(struct oop_readable *rable,
2219                                 oop_readable_call *cb, void *user) {
2220   InputFile *ipf= (void*)rable;
2221
2222   tailing_on_cancel(rable);
2223   ipf->readable_callback= cb;
2224   ipf->readable_callback_user= user;
2225   filemon_start(ipf);
2226   tailing_make_readable(ipf);
2227   return 0;
2228 }
2229
2230 static ssize_t tailing_try_read(struct oop_readable *rable, void *buffer,
2231                                 size_t length) {
2232   InputFile *ipf= (void*)rable;
2233   for (;;) {
2234     ssize_t r= read(ipf->fd, buffer, length);
2235     if (r==-1) {
2236       if (errno==EINTR) continue;
2237       ipf->fake_readable= 0;
2238       return r;
2239     }
2240     if (!r) {
2241       if (ipf==main_input_file) {
2242         errno=EAGAIN;
2243         ipf->fake_readable= 0;
2244         return -1;
2245       } else if (ipf==flushing_input_file) {
2246         assert(ipf->rd);
2247         assert(sms==sm_SEPARATED || sms==sm_DROPPING);
2248       } else if (ipf==backlog_input_file) {
2249         assert(ipf->rd);
2250       } else {
2251         abort();
2252       }
2253     }
2254     return r;
2255   }
2256 }
2257
2258 /*---------- filemon implemented with inotify ----------*/
2259
2260 #if defined(HAVE_SYS_INOTIFY_H) && !defined(HAVE_FILEMON)
2261 #define HAVE_FILEMON
2262
2263 #include <sys/inotify.h>
2264
2265 static int filemon_inotify_fd;
2266 static int filemon_inotify_wdmax;
2267 static InputFile **filemon_inotify_wd2ipf;
2268
2269 struct Filemon_Perfile {
2270   int wd;
2271 };
2272
2273 static void filemon_method_startfile(InputFile *ipf, Filemon_Perfile *pf) {
2274   int wd= inotify_add_watch(filemon_inotify_fd, ipf->path, IN_MODIFY);
2275   if (wd < 0) sysfatal("inotify_add_watch %s", ipf->path);
2276
2277   if (wd >= filemon_inotify_wdmax) {
2278     int newmax= wd+2;
2279     filemon_inotify_wd2ipf= xrealloc(filemon_inotify_wd2ipf,
2280                                  sizeof(*filemon_inotify_wd2ipf) * newmax);
2281     memset(filemon_inotify_wd2ipf + filemon_inotify_wdmax, 0,
2282            sizeof(*filemon_inotify_wd2ipf) * (newmax - filemon_inotify_wdmax));
2283     filemon_inotify_wdmax= newmax;
2284   }
2285
2286   assert(!filemon_inotify_wd2ipf[wd]);
2287   filemon_inotify_wd2ipf[wd]= ipf;
2288
2289   debug("filemon inotify startfile %p wd=%d wdmax=%d",
2290         ipf, wd, filemon_inotify_wdmax);
2291
2292   pf->wd= wd;
2293 }
2294
2295 static void filemon_method_stopfile(InputFile *ipf, Filemon_Perfile *pf) {
2296   int wd= pf->wd;
2297   debug("filemon inotify stopfile %p wd=%d", ipf, wd);
2298   int r= inotify_rm_watch(filemon_inotify_fd, wd);
2299   if (r) sysdie("inotify_rm_watch");
2300   filemon_inotify_wd2ipf[wd]= 0;
2301 }
2302
2303 static void *filemon_inotify_readable(oop_source *lp, int fd,
2304                                       oop_event e, void *u) {
2305   struct inotify_event iev;
2306   for (;;) {
2307     int r= read(filemon_inotify_fd, &iev, sizeof(iev));
2308     if (r==-1) {
2309       if (isewouldblock(errno)) break;
2310       sysdie("read from inotify master");
2311     } else if (r==sizeof(iev)) {
2312       assert(iev.wd >= 0 && iev.wd < filemon_inotify_wdmax);
2313     } else {
2314       die("inotify read %d bytes wanted struct of %d", r, (int)sizeof(iev));
2315     }
2316     InputFile *ipf= filemon_inotify_wd2ipf[iev.wd];
2317     /*debug("filemon inotify readable read %p wd=%d", ipf, iev.wd);*/
2318     tailing_make_readable(ipf);
2319   }
2320   return OOP_CONTINUE;
2321 }
2322
2323 static int filemon_method_init(void) {
2324   filemon_inotify_fd= inotify_init();
2325   if (filemon_inotify_fd<0) {
2326     syswarn("filemon/inotify: inotify_init failed");
2327     return 0;
2328   }
2329   xsetnonblock(filemon_inotify_fd, 1);
2330   loop->on_fd(loop, filemon_inotify_fd, OOP_READ, filemon_inotify_readable, 0);
2331
2332   debug("filemon inotify init filemon_inotify_fd=%d", filemon_inotify_fd);
2333   return 1;
2334 }
2335
2336 static void filemon_method_dump_info(FILE *f) {
2337   int i;
2338   fprintf(f,"inotify");
2339   DUMPV("%d",,filemon_inotify_fd);
2340   DUMPV("%d",,filemon_inotify_wdmax);
2341   for (i=0; i<filemon_inotify_wdmax; i++)
2342     fprintf(f," wd2ipf[%d]=%p\n", i, filemon_inotify_wd2ipf[i]);
2343 }
2344
2345 #endif /* HAVE_INOTIFY && !HAVE_FILEMON */
2346
2347 /*---------- filemon dummy implementation ----------*/
2348
2349 #if !defined(HAVE_FILEMON)
2350
2351 struct Filemon_Perfile { int dummy; };
2352
2353 static int filemon_method_init(void) {
2354   warn("filemon/dummy: no filemon method compiled in");
2355   return 0;
2356 }
2357 static void filemon_method_startfile(InputFile *ipf, Filemon_Perfile *pf) { }
2358 static void filemon_method_stopfile(InputFile *ipf, Filemon_Perfile *pf) { }
2359 static void filemon_method_dump_info(FILE *f) { fprintf(f,"dummy\n"); }
2360
2361 #endif /* !HAVE_FILEMON */
2362
2363 /*---------- filemon generic interface ----------*/
2364
2365 static void filemon_start(InputFile *ipf) {
2366   assert(!ipf->filemon);
2367
2368   NEW(ipf->filemon);
2369   filemon_method_startfile(ipf, ipf->filemon);
2370 }
2371
2372 static void filemon_stop(InputFile *ipf) {
2373   if (!ipf->filemon) return;
2374   filemon_method_stopfile(ipf, ipf->filemon);
2375   free(ipf->filemon);
2376   ipf->filemon= 0;
2377 }
2378
2379 /*---------- interface to start and stop an input file ----------*/
2380
2381 static const oop_rd_style feedfile_rdstyle= {
2382   OOP_RD_DELIM_STRIP, '\n',
2383   OOP_RD_NUL_PERMIT,
2384   OOP_RD_SHORTREC_LONG,
2385 };
2386
2387 static void inputfile_reading_resume(InputFile *ipf) {
2388   if (!ipf->rd) return;
2389   if (!ipf->paused) return;
2390
2391   int r= oop_rd_read(ipf->rd, &feedfile_rdstyle, MAX_LINE_FEEDFILE,
2392                      feedfile_got_article,ipf, feedfile_read_err, ipf);
2393   if (r) sysdie("unable start reading feedfile %s",ipf->path);
2394
2395   ipf->paused= 0;
2396 }
2397
2398 static void inputfile_reading_pause(InputFile *ipf) {
2399   if (!ipf->rd) return;
2400   if (ipf->paused) return;
2401   oop_rd_cancel(ipf->rd);
2402   ipf->paused= 1;
2403 }
2404
2405 static void inputfile_reading_start(InputFile *ipf) {
2406   assert(!ipf->rd);
2407   ipf->readable.on_readable= tailing_on_readable;
2408   ipf->readable.on_cancel=   tailing_on_cancel;
2409   ipf->readable.try_read=    tailing_try_read;
2410   ipf->readable.delete_tidy= 0; /* we never call oop_rd_delete_{tidy,kill} */
2411   ipf->readable.delete_kill= 0;
2412
2413   ipf->readable_callback= 0;
2414   ipf->readable_callback_user= 0;
2415
2416   ipf->rd= oop_rd_new(loop, &ipf->readable, 0,0);
2417   assert(ipf->rd);
2418
2419   ipf->paused= 1;
2420   inputfile_reading_resume(ipf);
2421 }
2422
2423 static void inputfile_reading_stop(InputFile *ipf) {
2424   assert(ipf->rd);
2425   inputfile_reading_pause(ipf);
2426   oop_rd_delete(ipf->rd);
2427   ipf->rd= 0;
2428   assert(!ipf->filemon); /* we shouldn't be monitoring it now */
2429 }
2430
2431
2432 /*========== interaction with innd - state machine ==========*/
2433
2434 /* See official state diagram at top of file.  We implement
2435  * this as follows:
2436  * -8<-
2437
2438             .=======.
2439             ||START||
2440             `======='
2441                 |
2442                 | open F
2443                 |
2444                 |    F ENOENT
2445                 |`---------------------------------------------------.
2446       F OPEN OK |                                                    |
2447                 |`---------------- - - -                             |
2448        D ENOENT |       D EXISTS   see OVERALL STATES diagram        |
2449                 |                  for full startup logic            |
2450      ,--------->|                                                    |
2451      |          V                                                    |
2452      |     ============                                       try to |
2453      |      NORMAL                                            open D |
2454      |     [Normal]                                                  |
2455      |      main F tail                                              |
2456      |     ============                                              V
2457      |          |                                                    |
2458      |          | F IS SO BIG WE SHOULD FLUSH, OR TIMEOUT            |
2459      ^          | hardlink F to D                                    |
2460      |     [Hardlinked]                                              |
2461      |          | unlink F                                           |
2462      |          | our handle onto F is now onto D                    |
2463      |     [Moved]                                                   |
2464      |          |                                                    |
2465      |          |<-------------------<---------------------<---------+
2466      |          |                                                    |
2467      |          | spawn inndcomm flush                               |
2468      |          V                                                    |
2469      |     ==================                                        |
2470      |      FLUSHING[-ABSENT]                                        |
2471      |     [Flushing]                                                |
2472      |     main D tail/none                                          |
2473      |     ==================                                        |
2474      |          |                                                    |
2475      |          |   INNDCOMM FLUSH FAILS                             ^
2476      |          |`----------------------->----------.                |
2477      |          |                                   |                |
2478      |          |   NO SUCH SITE                    V                |
2479      ^          |`--------------->----.         ==================== |
2480      |          |                      \        FLUSHFAILED[-ABSENT] |
2481      |          |                       \         [Moved]            |
2482      |          | FLUSH OK               \       main D tail/none    |
2483      |          | open F                  \     ==================== |
2484      |          |                          \        |                |
2485      |          |                           \       | TIME TO RETRY  |
2486      |          |`------->----.     ,---<---'\      `----------------'
2487      |          |    D NONE   |     | D NONE  `----.
2488      |          V             |     |              V
2489      |     =============      V     V             ============
2490      |      SEPARATED-1       |     |              DROPPING-1
2491      |      flsh->rd!=0       |     |              flsh->rd!=0
2492      |     [Separated]        |     |             [Dropping]
2493      |      main F idle       |     |              main none
2494      |      flsh D tail       |     |              flsh D tail
2495      |     =============      |     |             ============
2496      |          |             |     | install       |
2497      ^          | EOF ON D    |     |  defer        | EOF ON D
2498      |          V             |     |               V
2499      |     ===============    |     |             ===============
2500      |      SEPARATED-2       |     |              DROPPING-2
2501      |      flsh->rd==0       |     V              flsh->rd==0
2502      |     [Finishing]        |     |             [Dropping]
2503      |      main F tail       |     `.             main none
2504      |      flsh D closed     |       `.           flsh D closed
2505      |     ===============    V         `.        ===============
2506      |          |                         `.          |
2507      |          | ALL D PROCESSED           `.        | ALL D PROCESSED
2508      |          V install defer as backlog    `.      | install defer
2509      ^          | close D                       `.    | close D
2510      |          | unlink D                        `.  | unlink D
2511      |          |                                  |  |
2512      |          |                                  V  V
2513      `----------'                               ==============
2514                                                  DROPPED
2515                                                 [Dropped]
2516                                                  main none
2517                                                  flsh none
2518                                                  some backlog
2519                                                 ==============
2520                                                       |
2521                                                       | ALL BACKLOG DONE
2522                                                       |
2523                                                       | unlink lock
2524                                                       | exit
2525                                                       V
2526                                                   ==========
2527                                                    (ESRCH)
2528                                                   [Droppped]
2529                                                   ==========
2530  * ->8-
2531  */
2532
2533 static void startup_set_input_file(InputFile *f) {
2534   assert(!main_input_file);
2535   main_input_file= f;
2536   inputfile_reading_start(f);
2537 }
2538
2539 static void statemc_lock(void) {
2540   int lockfd;
2541   struct stat stab, stabf;
2542   
2543   for (;;) {
2544     lockfd= open(path_lock, O_CREAT|O_RDWR, 0600);
2545     if (lockfd<0) sysfatal("open lockfile %s", path_lock);
2546
2547     struct flock fl;
2548     memset(&fl,0,sizeof(fl));
2549     fl.l_type= F_WRLCK;
2550     fl.l_whence= SEEK_SET;
2551     int r= fcntl(lockfd, F_SETLK, &fl);
2552     if (r==-1) {
2553       if (errno==EACCES || isewouldblock(errno)) {
2554         if (quiet_multiple) exit(0);
2555         fatal("another duct holds the lockfile");
2556       }
2557       sysfatal("fcntl F_SETLK lockfile %s", path_lock);
2558     }
2559
2560     xfstat_isreg(lockfd, &stabf, path_lock, "lockfile");
2561     int lock_noent;
2562     xlstat_isreg(path_lock, &stab, &lock_noent, "lockfile");
2563
2564     if (!lock_noent && samefile(&stab, &stabf))
2565       break;
2566
2567     xclose(lockfd, "stale lockfile ", path_lock);
2568   }
2569
2570   FILE *lockfile= fdopen(lockfd, "w");
2571   if (!lockfile) sysdie("fdopen lockfile");
2572
2573   int r= ftruncate(lockfd, 0);
2574   if (r) sysdie("truncate lockfile to write new info");
2575
2576   if (fprintf(lockfile, "pid %ld\nsite %s\nfeedfile %s\nfqdn %s\n",
2577               (unsigned long)self_pid,
2578               sitename, feedfile, remote_host) == EOF ||
2579       fflush(lockfile))
2580     sysfatal("write info to lockfile %s", path_lock);
2581
2582   debug("startup: locked");
2583 }
2584
2585 static void statemc_init(void) {
2586   struct stat stabdefer;
2587
2588   search_backlog_file();
2589
2590   int defer_noent;
2591   xlstat_isreg(path_defer, &stabdefer, &defer_noent, "defer file");
2592   if (defer_noent) {
2593     debug("startup: ductdefer ENOENT");
2594   } else {
2595     debug("startup: ductdefer nlink=%ld", (long)stabdefer.st_nlink);
2596     switch (stabdefer.st_nlink==1) {
2597     case 1:
2598       open_defer(); /* so that we will later close it and rename it */
2599       break;
2600     case 2:
2601       xunlink(path_defer, "stale defer file link"
2602               " (presumably hardlink to backlog file)");
2603       break;
2604     default:
2605       die("defer file %s has unexpected link count %d",
2606           path_defer, stabdefer.st_nlink);
2607     }
2608   }
2609
2610   struct stat stab_f, stab_d;
2611   int noent_f;
2612
2613   InputFile *file_d= open_input_file(path_flushing);
2614   if (file_d) xfstat_isreg(file_d->fd, &stab_d, path_flushing,"flushing file");
2615
2616   xlstat_isreg(feedfile, &stab_f, &noent_f, "feedfile");
2617
2618   if (!noent_f && file_d && samefile(&stab_f, &stab_d)) {
2619     debug("startup: F==D => Hardlinked");
2620     xunlink(feedfile, "feed file (during startup)"); /* => Moved */
2621     noent_f= 1;
2622   }
2623
2624   if (noent_f) {
2625     debug("startup: F ENOENT => Moved");
2626     if (file_d) startup_set_input_file(file_d);
2627     spawn_inndcomm_flush("feedfile missing at startup");
2628     /* => Flushing, sms:=FLUSHING */
2629   } else {
2630     if (file_d) {
2631       debug("startup: F!=D => Separated");
2632       startup_set_input_file(file_d);
2633       flushing_input_file= main_input_file;
2634       main_input_file= open_input_file(feedfile);
2635       if (!main_input_file) die("feedfile vanished during startup");
2636       SMS(SEPARATED, max_separated_periods,
2637           "found both old and current feed files");
2638     } else {
2639       debug("startup: F exists, D ENOENT => Normal");
2640       InputFile *file_f= open_input_file(feedfile);
2641       if (!file_f) die("feed file vanished during startup");
2642       startup_set_input_file(file_f);
2643       SMS(NORMAL, spontaneous_flush_periods, "normal startup");
2644     }
2645   }
2646 }
2647
2648 static void statemc_start_flush(const char *why) { /* Normal => Flushing */
2649   assert(sms == sm_NORMAL);
2650
2651   debug("starting flush (%s) (%lu >?= %lu) (%d)",
2652         why,
2653         (unsigned long)(main_input_file ? main_input_file->offset : 0),
2654         (unsigned long)target_max_feedfile_size,
2655         until_flush);
2656
2657   int r= link(feedfile, path_flushing);
2658   if (r) sysfatal("link feedfile %s to flushing file %s",
2659                   feedfile, path_flushing);
2660   /* => Hardlinked */
2661
2662   xunlink(feedfile, "old feedfile link");
2663   /* => Moved */
2664
2665   spawn_inndcomm_flush(why); /* => Flushing FLUSHING */
2666 }
2667
2668 static int trigger_flush_ok(const char *why) {
2669   switch (sms) {
2670
2671   case sm_NORMAL:
2672     statemc_start_flush(why ? why : "periodic");
2673     return 1;                           /* Normal => Flushing; => FLUSHING */
2674
2675   case sm_FLUSHFAILED:
2676     spawn_inndcomm_flush(why ? why : "retry");
2677     return 1;                            /* Moved => Flushing; => FLUSHING */
2678
2679   case sm_SEPARATED:
2680   case sm_DROPPING:
2681     warn("abandoning old feedfile after flush (%s), autodeferring",
2682          why ? why : "took too long to complete");
2683     assert(flushing_input_file);
2684     autodefer_input_file(flushing_input_file);
2685     return 1;
2686
2687   default:
2688     return 0;
2689   }
2690 }
2691
2692 static void statemc_period_poll(void) {
2693   if (!until_flush) return;
2694   until_flush--;
2695   assert(until_flush>=0);
2696
2697   if (until_flush) return;
2698   int ok= trigger_flush_ok(0);
2699   assert(ok);
2700 }
2701
2702 static int inputfile_is_done(InputFile *ipf) {
2703   if (!ipf) return 0;
2704   if (ipf->inprogress) return 0; /* new article in the meantime */
2705   if (ipf->rd) return 0; /* not had EOF */
2706   return 1;
2707 }
2708
2709 static void notice_processed(InputFile *ipf, int completed,
2710                              const char *what, const char *spec) {
2711   if (!ipf) return; /* allows preterminate to be lazy */
2712
2713 #define RCI_NOTHING(x) /* nothing */
2714 #define RCI_TRIPLE_FMT(x) " " #x "=" RCI_TRIPLE_FMT_BASE
2715 #define RCI_TRIPLE_VALS(x) , RCI_TRIPLE_VALS_BASE(ipf->counts, [RC_##x])
2716
2717 #define CNT(art,rc) (ipf->counts[art_##art][RC_##rc])
2718
2719   char *inprog= completed
2720     ? xasprintf("%s","") /* GCC produces a stupid warning for printf("") ! */
2721     : xasprintf(" inprogress=%ld", ipf->inprogress);
2722   char *autodefer= ipf->autodefer >= 0
2723     ? xasprintf(" autodeferred=%ld", ipf->autodefer)
2724     : xasprintf("%s","");
2725
2726   info("%s %s%s read=%d (+bl=%d,+err=%d)%s%s"
2727        " missing=%d offered=%d (ch=%d,nc=%d) accepted=%d (ch=%d,nc=%d)"
2728        RESULT_COUNTS(RCI_NOTHING, RCI_TRIPLE_FMT)
2729        ,
2730        completed?"completed":"processed", what, spec,
2731        ipf->readcount_ok, ipf->readcount_blank, ipf->readcount_err,
2732        inprog, autodefer, ipf->count_nooffer_missing,
2733        CNT(Unchecked,sent) + CNT(Unsolicited,sent)
2734        , CNT(Unchecked,sent), CNT(Unsolicited,sent),
2735        CNT(Wanted,accepted) + CNT(Unsolicited,accepted)
2736        , CNT(Wanted,accepted), CNT(Unsolicited,accepted)
2737        RESULT_COUNTS(RCI_NOTHING,  RCI_TRIPLE_VALS)
2738        );
2739
2740   free(inprog);
2741   free(autodefer);
2742
2743 #undef CNT
2744 }
2745
2746 static void statemc_check_backlog_done(void) {
2747   InputFile *ipf= backlog_input_file;
2748   if (!inputfile_is_done(ipf)) return;
2749
2750   const char *slash= strrchr(ipf->path, '/');
2751   const char *leaf= slash ? slash+1 : ipf->path;
2752   const char *under= strchr(slash, '_');
2753   const char *rest= under ? under+1 : leaf;
2754   if (!strncmp(rest,"backlog",7)) rest += 7;
2755   notice_processed(ipf,1,"backlog ",rest);
2756
2757   close_input_file(ipf);
2758   if (unlink(ipf->path)) {
2759     if (errno != ENOENT)
2760       sysdie("could not unlink processed backlog file %s", ipf->path);
2761     warn("backlog file %s vanished while we were reading it"
2762          " so we couldn't remove it (but it's done now, anyway)",
2763          ipf->path);
2764   }
2765   free(ipf);
2766   backlog_input_file= 0;
2767   search_backlog_file();
2768   return;
2769 }
2770
2771 static void statemc_check_flushing_done(void) {
2772   InputFile *ipf= flushing_input_file;
2773   if (!inputfile_is_done(ipf)) return;
2774
2775   assert(sms==sm_SEPARATED || sms==sm_DROPPING);
2776
2777   notice_processed(ipf,1,"feedfile","");
2778
2779   close_defer();
2780
2781   xunlink(path_flushing, "old flushing file");
2782
2783   close_input_file(flushing_input_file);
2784   free(flushing_input_file);
2785   flushing_input_file= 0;
2786
2787   if (sms==sm_SEPARATED) {
2788     notice("flush complete");
2789     SMS(NORMAL, spontaneous_flush_periods, "flush complete");
2790   } else if (sms==sm_DROPPING) {
2791     SMS(DROPPED, max_separated_periods, "old flush complete");
2792     search_backlog_file();
2793     notice("feed dropped, but will continue until backlog is finished");
2794   }
2795 }
2796
2797 static void *statemc_check_input_done(oop_source *lp, struct timeval now,
2798                                       void *u) {
2799   assert(!inputfile_is_done(main_input_file));
2800   statemc_check_flushing_done();
2801   statemc_check_backlog_done();
2802   return OOP_CONTINUE;
2803 }
2804
2805 static void queue_check_input_done(void) {
2806   loop->on_time(loop, OOP_TIME_NOW, statemc_check_input_done, 0);
2807 }
2808
2809 static void statemc_setstate(StateMachineState newsms, int periods,
2810                              const char *forlog, const char *why) {
2811   sms= newsms;
2812   until_flush= periods;
2813
2814   const char *xtra= "";
2815   switch (sms) {
2816   case sm_FLUSHING:
2817   case sm_FLUSHFAILED:
2818     if (!main_input_file) xtra= "-ABSENT";
2819     break;
2820   case sm_SEPARATED:
2821   case sm_DROPPING:
2822     xtra= flushing_input_file->rd ? "-1" : "-2";
2823     break;
2824   default:;
2825   }
2826
2827   if (periods) {
2828     info("state %s%s[%d] %s",forlog,xtra,periods,why);
2829   } else {
2830     info("state %s%s %s",forlog,xtra,why);
2831   }
2832 }
2833
2834 /*---------- defer and backlog files ----------*/
2835
2836 static void open_defer(void) {
2837   struct stat stab;
2838
2839   if (defer) return;
2840
2841   defer= fopen(path_defer, "a+");
2842   if (!defer) sysfatal("could not open defer file %s", path_defer);
2843
2844   /* truncate away any half-written records */
2845
2846   xfstat_isreg(fileno(defer), &stab, path_defer, "newly opened defer file");
2847
2848   if (stab.st_size > LONG_MAX)
2849     die("defer file %s size is far too large", path_defer);
2850
2851   if (!stab.st_size)
2852     return;
2853
2854   long orgsize= stab.st_size;
2855   long truncto= stab.st_size;
2856   for (;;) {
2857     if (!truncto) break; /* was only (if anything) one half-truncated record */
2858     if (fseek(defer, truncto-1, SEEK_SET) < 0)
2859       sysdie("seek in defer file %s while truncating partial", path_defer);
2860
2861     int r= getc(defer);
2862     if (r==EOF) {
2863       if (ferror(defer))
2864         sysdie("failed read from defer file %s", path_defer);
2865       else
2866         die("defer file %s shrank while we were checking it!", path_defer);
2867     }
2868     if (r=='\n') break;
2869     truncto--;
2870   }
2871
2872   if (stab.st_size != truncto) {
2873     warn("truncating half-record at end of defer file %s -"
2874          " shrinking by %ld bytes from %ld to %ld",
2875          path_defer, orgsize - truncto, orgsize, truncto);
2876
2877     if (fflush(defer))
2878       sysfatal("could not flush defer file %s", path_defer);
2879     if (ftruncate(fileno(defer), truncto))
2880       sysdie("could not truncate defer file %s", path_defer);
2881
2882   } else {
2883     info("continuing existing defer file %s (%ld bytes)",
2884          path_defer, orgsize);
2885   }
2886   if (fseek(defer, truncto, SEEK_SET))
2887     sysdie("could not seek to new end of defer file %s", path_defer);
2888 }
2889
2890 static void close_defer(void) {
2891   if (!defer)
2892     return;
2893
2894   struct stat stab;
2895   xfstat_isreg(fileno(defer), &stab, path_defer, "defer file");
2896
2897   if (fclose(defer)) sysfatal("could not close defer file %s", path_defer);
2898   defer= 0;
2899
2900   time_t now= xtime();
2901
2902   char *backlog= xasprintf("%s_backlog_%lu.%lu", feedfile,
2903                            (unsigned long)now,
2904                            (unsigned long)stab.st_ino);
2905   if (link(path_defer, backlog))
2906     sysfatal("could not install defer file %s as backlog file %s",
2907            path_defer, backlog);
2908   if (unlink(path_defer))
2909     sysdie("could not unlink old defer link %s to backlog file %s",
2910            path_defer, backlog);
2911
2912   free(backlog);
2913
2914   if (until_backlog_nextscan < 0 ||
2915       until_backlog_nextscan > backlog_retry_minperiods + 1)
2916     until_backlog_nextscan= backlog_retry_minperiods + 1;
2917 }
2918
2919 static void poll_backlog_file(void) {
2920   if (until_backlog_nextscan < 0) return;
2921   if (until_backlog_nextscan-- > 0) return;
2922   search_backlog_file();
2923 }
2924
2925 static void search_backlog_file(void) {
2926   /* returns non-0 iff there are any backlog files */
2927
2928   glob_t gl;
2929   int r, i;
2930   struct stat stab;
2931   const char *oldest_path=0;
2932   time_t oldest_mtime=0, now;
2933
2934   if (backlog_input_file) return;
2935
2936  try_again:
2937
2938   r= glob(globpat_backlog, GLOB_ERR|GLOB_MARK|GLOB_NOSORT, 0, &gl);
2939
2940   switch (r) {
2941   case GLOB_ABORTED:
2942     sysfatal("failed to expand backlog pattern %s", globpat_backlog);
2943   case GLOB_NOSPACE:
2944     fatal("out of memory expanding backlog pattern %s", globpat_backlog);
2945   case 0:
2946     for (i=0; i<gl.gl_pathc; i++) {
2947       const char *path= gl.gl_pathv[i];
2948
2949       if (strchr(path,'#') || strchr(path,'~')) {
2950         debug("backlog file search skipping %s", path);
2951         continue;
2952       }
2953       r= stat(path, &stab);
2954       if (r) {
2955         syswarn("failed to stat backlog file %s", path);
2956         continue;
2957       }
2958       if (!S_ISREG(stab.st_mode)) {
2959         warn("backlog file %s is not a plain file (or link to one)", path);
2960         continue;
2961       }
2962       if (!oldest_path || stab.st_mtime < oldest_mtime) {
2963         oldest_path= path;
2964         oldest_mtime= stab.st_mtime;
2965       }
2966     }
2967   case GLOB_NOMATCH: /* fall through */
2968     break;
2969   default:
2970     sysdie("glob expansion of backlog pattern %s gave unexpected"
2971            " nonzero (error?) return value %d", globpat_backlog, r);
2972   }
2973
2974   if (!oldest_path) {
2975     debug("backlog scan: none");
2976
2977     if (sms==sm_DROPPED) {
2978       preterminate();
2979       notice("feed dropped and our work is complete");
2980
2981       int r= unlink(path_cli);
2982       if (r && errno!=ENOENT)
2983         syswarn("failed to unlink cli socket for old feed");
2984
2985       xunlink(path_lock, "lockfile for old feed");
2986       exit(4);
2987     }
2988     until_backlog_nextscan= backlog_spontrescan_periods;
2989     goto xfree;
2990   }
2991
2992   now= xtime();
2993   double age= difftime(now, oldest_mtime);
2994   long age_deficiency= (backlog_retry_minperiods * period_seconds) - age;
2995
2996   if (age_deficiency <= 0) {
2997     debug("backlog scan: found age=%f deficiency=%ld oldest=%s",
2998           age, age_deficiency, oldest_path);
2999
3000     backlog_input_file= open_input_file(oldest_path);
3001     if (!backlog_input_file) {
3002       warn("backlog file %s vanished as we opened it", oldest_path);
3003       globfree(&gl);
3004       goto try_again;
3005     }
3006     inputfile_reading_start(backlog_input_file);
3007     until_backlog_nextscan= -1;
3008     goto xfree;
3009   }
3010
3011   until_backlog_nextscan= age_deficiency / period_seconds;
3012
3013   if (backlog_spontrescan_periods >= 0 &&
3014       until_backlog_nextscan > backlog_spontrescan_periods)
3015     until_backlog_nextscan= backlog_spontrescan_periods;
3016
3017   debug("backlog scan: young age=%f deficiency=%ld nextscan=%d oldest=%s",
3018         age, age_deficiency, until_backlog_nextscan, oldest_path);
3019
3020  xfree:
3021   globfree(&gl);
3022   return;
3023 }
3024
3025 /*---------- shutdown and signal handling ----------*/
3026
3027 static void preterminate(void) {
3028   if (in_child) return;
3029   notice_processed(main_input_file,0,"feedfile","");
3030   notice_processed(flushing_input_file,0,"flushing","");
3031   if (backlog_input_file)
3032     notice_processed(backlog_input_file,0, "backlog file ",
3033                      backlog_input_file->path);
3034 }
3035
3036 static int signal_self_pipe[2];
3037 static sig_atomic_t terminate_sig_flag;
3038
3039 static void raise_default(int signo) {
3040   xsigsetdefault(signo);
3041   raise(signo);
3042   abort();
3043 }
3044
3045 static void *sigarrived_event(oop_source *lp, int fd, oop_event e, void *u) {
3046   assert(fd=signal_self_pipe[0]);
3047   char buf[PIPE_BUF];
3048   int r= read(signal_self_pipe[0], buf, sizeof(buf));
3049   if (r<0 && !isewouldblock(errno)) sysdie("failed to read signal self pipe");
3050   if (r==0) die("eof on signal self pipe");
3051   if (terminate_sig_flag) {
3052     preterminate();
3053     notice("terminating (%s)", strsignal(terminate_sig_flag));
3054     raise_default(terminate_sig_flag);
3055   }
3056   return OOP_CONTINUE;
3057 }
3058
3059 static void sigarrived_handler(int signum) {
3060   static char x;
3061   switch (signum) {
3062   case SIGTERM:
3063   case SIGINT:
3064     if (!terminate_sig_flag) terminate_sig_flag= signum;
3065     break;
3066   default:
3067     abort();
3068   }
3069   write(signal_self_pipe[1],&x,1);
3070 }
3071
3072 static void init_signals(void) {
3073   if (signal(SIGPIPE, SIG_IGN) == SIG_ERR)
3074     sysdie("could not ignore SIGPIPE");
3075
3076   if (pipe(signal_self_pipe)) sysfatal("create self-pipe for signals");
3077
3078   xsetnonblock(signal_self_pipe[0],1);
3079   xsetnonblock(signal_self_pipe[1],1);
3080
3081   struct sigaction sa;
3082   memset(&sa,0,sizeof(sa));
3083   sa.sa_handler= sigarrived_handler;
3084   sa.sa_flags= SA_RESTART;
3085   xsigaction(SIGTERM,&sa);
3086   xsigaction(SIGINT,&sa);
3087
3088   on_fd_read_except(signal_self_pipe[0], sigarrived_event);
3089 }
3090
3091 /*========== flushing the feed ==========*/
3092
3093 static pid_t inndcomm_child;
3094 static int inndcomm_sentinel_fd;
3095
3096 static void *inndcomm_event(oop_source *lp, int fd, oop_event e, void *u) {
3097   assert(inndcomm_child);
3098   assert(fd == inndcomm_sentinel_fd);
3099   int status= xwaitpid(&inndcomm_child, "inndcomm");
3100   inndcomm_child= 0;
3101   
3102   cancel_fd_read_except(fd);
3103   xclose_perhaps(&fd, "inndcomm sentinel pipe",0);
3104   inndcomm_sentinel_fd= 0;
3105
3106   assert(!flushing_input_file);
3107
3108   if (WIFEXITED(status)) {
3109     switch (WEXITSTATUS(status)) {
3110
3111     case INNDCOMMCHILD_ESTATUS_FAIL:
3112       goto failed;
3113
3114     case INNDCOMMCHILD_ESTATUS_NONESUCH:
3115       notice("feed has been dropped by innd, finishing up");
3116       flushing_input_file= main_input_file;
3117       tailing_make_readable(flushing_input_file);
3118         /* we probably previously returned EAGAIN from our fake read method
3119          * when in fact we were at EOF, so signal another readable event
3120          * so we actually see the EOF */
3121
3122       main_input_file= 0;
3123
3124       if (flushing_input_file) {
3125         SMS(DROPPING, max_separated_periods,
3126             "feed dropped by innd, but must finish last flush");
3127       } else {
3128         close_defer();
3129         SMS(DROPPED, 0, "feed dropped by innd");
3130         search_backlog_file();
3131       }
3132       return OOP_CONTINUE;
3133
3134     case 0:
3135       /* as above */
3136       flushing_input_file= main_input_file;
3137       tailing_make_readable(flushing_input_file);
3138
3139       main_input_file= open_input_file(feedfile);
3140       if (!main_input_file)
3141         die("flush succeeded but feedfile %s does not exist!"
3142             " (this probably means feedfile does not correspond"
3143             " to site %s in newsfeeds)", feedfile, sitename);
3144
3145       if (flushing_input_file) {
3146         SMS(SEPARATED, max_separated_periods, "flush complete");
3147       } else {
3148         close_defer();
3149         SMS(NORMAL, spontaneous_flush_periods, "recovery flush complete");
3150       }
3151       return OOP_CONTINUE;
3152
3153     default:
3154       goto unexpected_exitstatus;
3155
3156     }
3157   } else if (WIFSIGNALED(status) && WTERMSIG(status) == SIGALRM) {
3158     warn("flush timed out trying to talk to innd");
3159     goto failed;
3160   } else {
3161   unexpected_exitstatus:
3162     report_child_status("inndcomm child", status);
3163   }
3164
3165  failed:
3166   SMS(FLUSHFAILED, flushfail_retry_periods, "flush failed, will retry");
3167   return OOP_CONTINUE;
3168 }
3169
3170 static void inndcommfail(const char *what) {
3171   syswarn("error communicating with innd: %s failed: %s", what, ICCfailure);
3172   exit(INNDCOMMCHILD_ESTATUS_FAIL);
3173 }
3174
3175 void spawn_inndcomm_flush(const char *why) { /* Moved => Flushing */
3176   int pipefds[2];
3177
3178   notice("flushing %s",why);
3179
3180   assert(sms==sm_NORMAL || sms==sm_FLUSHFAILED);
3181   assert(!inndcomm_child);
3182   assert(!inndcomm_sentinel_fd);
3183
3184   if (pipe(pipefds)) sysfatal("create pipe for inndcomm child sentinel");
3185
3186   inndcomm_child= xfork("inndcomm child");
3187
3188   if (!inndcomm_child) {
3189     const char *flushargv[2]= { sitename, 0 };
3190     char *reply;
3191     int r;
3192
3193     xclose(pipefds[0], "(in child) inndcomm sentinel parent's end",0);
3194     /* parent spots the autoclose of pipefds[1] when we die or exit */
3195
3196     if (simulate_flush>=0) {
3197       warn("SIMULATING flush child status %d", simulate_flush);
3198       if (simulate_flush>128) raise(simulate_flush-128);
3199       else exit(simulate_flush);
3200     }
3201
3202     alarm(inndcomm_flush_timeout);
3203     r= ICCopen();                         if (r)   inndcommfail("connect");
3204     r= ICCcommand('f',flushargv,&reply);  if (r<0) inndcommfail("transmit");
3205     if (!r) exit(0); /* yay! */
3206
3207     if (!strcmp(reply, "1 No such site")) exit(INNDCOMMCHILD_ESTATUS_NONESUCH);
3208     syswarn("innd ctlinnd flush failed: innd said %s", reply);
3209     exit(INNDCOMMCHILD_ESTATUS_FAIL);
3210   }
3211
3212   simulate_flush= -1;
3213
3214   xclose(pipefds[1], "inndcomm sentinel child's end",0);
3215   inndcomm_sentinel_fd= pipefds[0];
3216   assert(inndcomm_sentinel_fd);
3217   on_fd_read_except(inndcomm_sentinel_fd, inndcomm_event);
3218
3219   SMS(FLUSHING, 0, why);
3220 }
3221
3222 /*========== main program ==========*/
3223
3224 static void postfork_inputfile(InputFile *ipf) {
3225   if (!ipf) return;
3226   xclose(ipf->fd, "(in child) input file ", ipf->path);
3227 }
3228
3229 static void postfork_stdio(FILE *f, const char *what, const char *what2) {
3230   /* we have no stdio streams that are buffered long-term */
3231   if (!f) return;
3232   if (fclose(f)) sysdie("(in child) close %s%s", what, what2?what2:0);
3233 }
3234
3235 static void postfork(void) {
3236   in_child= 1;
3237
3238   xsigsetdefault(SIGTERM);
3239   xsigsetdefault(SIGINT);
3240   xsigsetdefault(SIGPIPE);
3241   if (terminate_sig_flag) raise(terminate_sig_flag);
3242
3243   postfork_inputfile(main_input_file);
3244   postfork_inputfile(flushing_input_file);
3245
3246   Conn *conn;
3247   FOR_CONN(conn)
3248     conn_closefd(conn,"(in child) ");
3249
3250   postfork_stdio(defer, "defer file ", path_defer);
3251 }
3252
3253 typedef struct Every Every;
3254 struct Every {
3255   struct timeval interval;
3256   int fixed_rate;
3257   void (*f)(void);
3258 };
3259
3260 static void every_schedule(Every *e, struct timeval base);
3261
3262 static void *every_happens(oop_source *lp, struct timeval base, void *e_v) {
3263   Every *e= e_v;
3264   e->f();
3265   if (!e->fixed_rate) xgettimeofday(&base);
3266   every_schedule(e, base);
3267   return OOP_CONTINUE;
3268 }
3269
3270 static void every_schedule(Every *e, struct timeval base) {
3271   struct timeval when;
3272   timeradd(&base, &e->interval, &when);
3273   loop->on_time(loop, when, every_happens, e);
3274 }
3275
3276 static void every(int interval, int fixed_rate, void (*f)(void)) {
3277   NEW_DECL(Every *,e);
3278   e->interval.tv_sec= interval;
3279   e->interval.tv_usec= 0;
3280   e->fixed_rate= fixed_rate;
3281   e->f= f;
3282   struct timeval now;
3283   xgettimeofday(&now);
3284   every_schedule(e, now);
3285 }
3286
3287 static void filepoll(void) {
3288   tailing_make_readable(main_input_file);
3289   tailing_make_readable(flushing_input_file);
3290 }
3291
3292 static char *debug_report_ipf(InputFile *ipf) {
3293   if (!ipf) return xasprintf("none");
3294
3295   const char *slash= strrchr(ipf->path,'/');
3296   const char *path= slash ? slash+1 : ipf->path;
3297
3298   return xasprintf("%p/%s:queue=%d,ip=%ld,autodef=%ld,off=%ld,fd=%d%s%s%s",
3299                    ipf, path,
3300                    ipf->queue.count, ipf->inprogress, ipf->autodefer,
3301                    (long)ipf->offset, ipf->fd,
3302                    ipf->rd ? "" : ",!rd",
3303                    ipf->skippinglong ? "*skiplong" : "",
3304                    ipf->rd && ipf->paused ? "*paused" : "");
3305 }
3306
3307 static void period(void) {
3308   char *dipf_main=     debug_report_ipf(main_input_file);
3309   char *dipf_flushing= debug_report_ipf(flushing_input_file);
3310   char *dipf_backlog=  debug_report_ipf(backlog_input_file);
3311
3312   debug("PERIOD"
3313         " sms=%s[%d] conns=%d until_connect=%d"
3314         " input_files main:%s flushing:%s backlog:%s[%d]"
3315         " children connecting=%ld inndcomm=%ld lowvol_total=%d"
3316         ,
3317         sms_names[sms], until_flush, conns.count, until_connect,
3318         dipf_main, dipf_flushing, dipf_backlog, until_backlog_nextscan,
3319         (long)connecting_child, (long)inndcomm_child, lowvol_total
3320         );
3321
3322   free(dipf_main);
3323   free(dipf_flushing);
3324   free(dipf_backlog);
3325
3326   if (until_connect) until_connect--;
3327
3328   inputfile_queue_check_expired(backlog_input_file);
3329   poll_backlog_file();
3330   if (!backlog_input_file) close_defer(); /* want to start on a new backlog */
3331   statemc_period_poll();
3332   check_assign_articles();
3333   check_idle_conns();
3334 }
3335
3336
3337 /*========== dumping state ==========*/
3338
3339 static void dump_article_list(FILE *f, const CliCommand *c,
3340                               const ArticleList *al) {
3341   fprintf(f, " count=%d\n", al->count);
3342   if (!c->xval) return;
3343   
3344   int i; Article *art;
3345   for (i=0, art=LIST_HEAD(*al); art; i++, art=LIST_NEXT(art)) {
3346     fprintf(f," #%05d %-11s", i, artstate_names[art->state]);
3347     DUMPV("%p", art->,ipf);
3348     DUMPV("%d", art->,missing);
3349     DUMPV("%lu", (unsigned long)art->,offset);
3350     DUMPV("%d", art->,blanklen);
3351     DUMPV("%d", art->,midlen);
3352     fprintf(f, " %s %s\n", TokenToText(art->token), art->messageid);
3353   }
3354 }
3355   
3356 static void dump_input_file(FILE *f, const CliCommand *c,
3357                             InputFile *ipf, const char *wh) {
3358   char *dipf= debug_report_ipf(ipf);
3359   fprintf(f,"input %s %s", wh, dipf);
3360   free(dipf);
3361   
3362   if (ipf) {
3363     DUMPV("%d", ipf->,readcount_ok);
3364     DUMPV("%d", ipf->,readcount_blank);
3365     DUMPV("%d", ipf->,readcount_err);
3366     DUMPV("%d", ipf->,count_nooffer_missing);
3367   }
3368   fprintf(f,"\n");
3369   if (ipf) {
3370     ArtState state; const char *const *statename; 
3371     for (state=0, statename=artstate_names; *statename; state++,statename++) {
3372 #define RC_DUMP_FMT(x) " " #x "=%d"
3373 #define RC_DUMP_VAL(x) ,ipf->counts[state][RC_##x]
3374       fprintf(f,"input %s counts %-11s"
3375               RESULT_COUNTS(RC_DUMP_FMT,RC_DUMP_FMT) "\n",
3376               wh, *statename
3377               RESULT_COUNTS(RC_DUMP_VAL,RC_DUMP_VAL));
3378     }
3379     fprintf(f,"input %s queue", wh);
3380     dump_article_list(f,c,&ipf->queue);
3381   }
3382 }
3383
3384 CCMD(dump) {
3385   int i;
3386   fprintf(cc->out, "dumping state to %s\n", path_dump);
3387   FILE *f= fopen(path_dump, "w");
3388   if (!f) { fprintf(cc->out, "failed: open: %s\n", strerror(errno)); return; }
3389
3390   fprintf(f,"general");
3391   DUMPV("%s", sms_names,[sms]);
3392   DUMPV("%d", ,until_flush);
3393   DUMPV("%ld", (long),self_pid);
3394   DUMPV("%p", , defer);
3395   DUMPV("%d", , until_connect);
3396   DUMPV("%d", , until_backlog_nextscan);
3397   DUMPV("%d", , simulate_flush);
3398   fprintf(f,"\nnocheck");
3399   DUMPV("%#.10f", , accept_proportion);
3400   DUMPV("%d", , nocheck);
3401   DUMPV("%d", , nocheck_reported);
3402   fprintf(f,"\n");
3403
3404   fprintf(f,"special");
3405   DUMPV("%ld", (long),connecting_child);
3406   DUMPV("%d", , connecting_fdpass_sock);
3407   DUMPV("%d", , cli_master);
3408   fprintf(f,"\n");
3409
3410   fprintf(f,"lowvol");
3411   DUMPV("%d", , lowvol_circptr);
3412   DUMPV("%d", , lowvol_total);
3413   fprintf(f,":");
3414   for (i=0; i<lowvol_periods; i++) {
3415     fprintf(f," ");
3416     if (i==lowvol_circptr) fprintf(f,"*");
3417     fprintf(f,"%d",lowvol_perperiod[i]);
3418   }
3419   fprintf(f,"\n");
3420
3421   fprintf(f,"filemon ");
3422   filemon_method_dump_info(f);
3423
3424   dump_input_file(f,c, main_input_file,     "main"    );
3425   dump_input_file(f,c, flushing_input_file, "flushing");
3426   dump_input_file(f,c, backlog_input_file,  "backlog" );
3427
3428   fprintf(f,"conns count=%d\n", conns.count);
3429
3430   Conn *conn;
3431   FOR_CONN(conn) {
3432
3433     fprintf(f,"C%d",conn->fd);
3434     DUMPV("%p",conn->,rd);             DUMPV("%d",conn->,max_queue);
3435     DUMPV("%d",conn->,stream);         DUMPV("\"%s\"",conn->,quitting);
3436     DUMPV("%d",conn->,since_activity);
3437     fprintf(f,"\n");
3438
3439     fprintf(f,"C%d waiting", conn->fd); dump_article_list(f,c,&conn->waiting);
3440     fprintf(f,"C%d priority",conn->fd); dump_article_list(f,c,&conn->priority);
3441     fprintf(f,"C%d sent",    conn->fd); dump_article_list(f,c,&conn->sent);
3442
3443     fprintf(f,"C%d xmit xmitu=%d\n", conn->fd, conn->xmitu);
3444     for (i=0; i<conn->xmitu; i++) {
3445       const struct iovec *iv= &conn->xmit[i];
3446       const XmitDetails *xd= &conn->xmitd[i];
3447       char *dinfo;
3448       switch (xd->kind) {
3449       case xk_Const:    dinfo= xasprintf("Const");                 break;
3450       case xk_Artdata:  dinfo= xasprintf("A%p", xd->info.sm_art);  break;
3451       default:
3452         abort();
3453       }
3454       fprintf(f," #%03d %-11s l=%d %s\n", i, dinfo, iv->iov_len,
3455               sanitise(iv->iov_base, iv->iov_len));
3456       free(dinfo);
3457     }
3458   }
3459
3460   fprintf(f,"paths");
3461   DUMPV("%s", , feedfile);
3462   DUMPV("%s", , path_cli);
3463   DUMPV("%s", , path_lock);
3464   DUMPV("%s", , path_flushing);
3465   DUMPV("%s", , path_defer);
3466   DUMPV("%s", , path_dump);
3467   DUMPV("%s", , globpat_backlog);
3468   fprintf(f,"\n");
3469
3470   if (!!ferror(f) + !!fclose(f)) {
3471     fprintf(cc->out, "failed: write: %s\n", strerror(errno));
3472     return;
3473   }
3474 }
3475
3476 /*========== option parsing ==========*/
3477
3478 static void vbadusage(const char *fmt, va_list al) NORET_PRINTF(1,0);
3479 static void vbadusage(const char *fmt, va_list al) {
3480   char *m= xvasprintf(fmt,al);
3481   fprintf(stderr, "bad usage: %s\n"
3482           "say --help for help, or read the manpage\n",
3483           m);
3484   if (become_daemon)
3485     syslog(LOG_CRIT,"innduct: invoked with bad usage: %s",m);
3486   exit(8);
3487 }
3488
3489 /*---------- generic option parser ----------*/
3490
3491 static void badusage(const char *fmt, ...) NORET_PRINTF(1,2);
3492 static void badusage(const char *fmt, ...) {
3493   va_list al;
3494   va_start(al,fmt);
3495   vbadusage(fmt,al);
3496 }
3497
3498 enum OptFlags {
3499   of_seconds= 001000u,
3500   of_boolean= 002000u,
3501 };
3502
3503 typedef struct Option Option;
3504 typedef void OptionParser(const Option*, const char *val);
3505
3506 struct Option {
3507   int shrt;
3508   const char *lng, *formarg;
3509   void *store;
3510   OptionParser *fn;
3511   int intval;
3512 };
3513
3514 static void parse_options(const Option *options, char ***argvp) {
3515   /* on return *argvp is first non-option arg; argc is not updated */
3516
3517   for (;;) {
3518     const char *arg= *++(*argvp);
3519     if (!arg) break;
3520     if (*arg != '-') break;
3521     if (!strcmp(arg,"--")) { arg= *++(*argvp); break; }
3522     int a;
3523     while ((a= *++arg)) {
3524       const Option *o;
3525       if (a=='-') {
3526         arg++;
3527         char *equals= strchr(arg,'=');
3528         int len= equals ? (equals - arg) : strlen(arg);
3529         for (o=options; o->shrt || o->lng; o++)
3530           if (strlen(o->lng) == len && !memcmp(o->lng,arg,len))
3531             goto found_long;
3532         badusage("unknown long option --%s",arg);