chiark / gitweb /
server/: Maybe use GNU ADNS rather than mLib's `bres' for name resolution.
[tripe] / server / admin.c
1 /* -*-c-*-
2  *
3  * Admin interface for configuration
4  *
5  * (c) 2001 Straylight/Edgeware
6  */
7
8 /*----- Licensing notice --------------------------------------------------*
9  *
10  * This file is part of Trivial IP Encryption (TrIPE).
11  *
12  * TrIPE is free software: you can redistribute it and/or modify it under
13  * the terms of the GNU General Public License as published by the Free
14  * Software Foundation; either version 3 of the License, or (at your
15  * option) any later version.
16  *
17  * TrIPE is distributed in the hope that it will be useful, but WITHOUT
18  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
19  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
20  * for more details.
21  *
22  * You should have received a copy of the GNU General Public License
23  * along with TrIPE.  If not, see <https://www.gnu.org/licenses/>.
24  */
25
26 /*----- Header files ------------------------------------------------------*/
27
28 #include "tripe.h"
29
30 /*----- Global variables --------------------------------------------------*/
31
32 #ifndef NTRACE
33
34 const trace_opt tr_opts[] = {
35   { 't',        T_TUNNEL,       "tunnel events" },
36   { 'r',        T_PEER,         "peer events" },
37   { 'a',        T_ADMIN,        "admin interface" },
38   { 's',        T_KEYSET,       "symmetric keyset management" },
39   { 'x',        T_KEYEXCH,      "key exchange" },
40   { 'm',        T_KEYMGMT,      "key management" },
41   { 'l',        T_CHAL,         "challenge management" },
42   { 'v',        T_PRIVSEP,      "privilege separation" },
43   { 'p',        T_PACKET,       "packet contents" },
44   { 'c',        T_CRYPTO,       "crypto details" },
45   { 'A',        T_ALL,          "all of the above" },
46   { 0,          0,              0 }
47 };
48
49 unsigned tr_flags = 0;
50 #endif
51
52 static const trace_opt w_opts[] = {
53 #ifndef NTRACE
54   { 't',        AF_TRACE,       "trace messages" },
55 #endif
56   { 'n',        AF_NOTE,        "asynchronous notifications" },
57   { 'w',        AF_WARN,        "warnings" },
58   { 'A',        AF_ALLMSGS,     "all of the above" },
59   { 0,          0,              0 }
60 };
61
62 /*----- Static variables --------------------------------------------------*/
63
64 #ifdef HAVE_LIBADNS
65   static adns_state ads;
66   sel_hook hook;
67 #endif
68 static admin *admins;
69 static admin *a_dead;
70 static sel_file sock;
71 static const char *sockname;
72 static sym_table a_svcs;
73 static unsigned flags = 0;
74 static admin *a_stdin = 0;
75 static sig s_term, s_int, s_hup;
76
77 #define F_DAEMON 1u
78 #define F_INIT 2u
79 #define F_FOREGROUND 4u
80
81 #define T_RESOLVE SEC(30)
82 #define T_PING SEC(5)
83
84 static void a_destroy(admin */*a*/);
85
86 #define BOOL(x) ((x) ? "t" : "nil")
87
88 /*----- Output functions --------------------------------------------------*/
89
90 /* --- @trywrite@ --- *
91  *
92  * Arguments:   @admin *a@ = pointer to an admin block
93  *              @const char *p@ = pointer to buffer to write
94  *              @size_t sz@ = size of data to write
95  *
96  * Returns:     The number of bytes written, or less than zero on error.
97  *
98  * Use:         Attempts to write data to a client.
99  */
100
101 static ssize_t trywrite(admin *a, const char *p, size_t sz)
102 {
103   ssize_t n, done = 0;
104
105 again:
106   if (!sz)
107     return (done);
108   n = write(a->w.fd, p, sz);
109   if (n > 0) {
110     done += n;
111     p += n;
112     sz -= n;
113     goto again;
114   }
115   if (n < 0) {
116     if (errno == EINTR)
117       goto again;
118     if (errno != EAGAIN && errno != EWOULDBLOCK) {
119       a_destroy(a);
120       a_warn("ADMIN", "client-write-error", "?ERRNO", A_END);
121       return (-1);
122     }
123   }
124   return (done);
125 }
126
127 /* --- @doqueue@ -- *
128  *
129  * Arguments:   @oqueue *q@ = pointer to output queue
130  *              @const char *p@ = pointer to buffer to write
131  *              @size_t sz@ = size of buffer
132  *
133  * Returns:     Nonzero if the queue was previously empty.
134  *
135  * Use:         Queues data to be written later.
136  */
137
138 static int doqueue(oqueue *q, const char *p, size_t sz)
139 {
140   obuf *o;
141   int rc = 0;
142   size_t n;
143
144   o = q->tl;
145   if (!o)
146     rc = 1;
147   else if (o->p_in < o->buf + OBUFSZ)
148     goto noalloc;
149
150   do {
151     o = xmalloc(sizeof(obuf));
152     o->next = 0;
153     o->p_in = o->p_out = o->buf;
154     if (q->tl)
155       q->tl->next = o;
156     else
157       q->hd = o;
158     q->tl = o;
159
160   noalloc:
161     n = o->buf + OBUFSZ - o->p_in;
162     if (n > sz)
163       n = sz;
164     memcpy(o->p_in, p, n);
165     o->p_in += n;
166     p += n;
167     sz -= n;
168   } while (sz);
169
170   return (rc);
171 }
172
173 /* --- @dosend@ --- *
174  *
175  * Arguemnts:   @admin *a@ = pointer to an admin block
176  *              @const char *p@ = pointer to buffer to write
177  *              @size_t sz@ = size of data to write
178  *
179  * Returns:     ---
180  *
181  * Use:         Sends data to an admin client.
182  */
183
184 static void dosend(admin *a, const char *p, size_t sz)
185 {
186   ssize_t n;
187
188   if (a->f & AF_DEAD)
189     return;
190   if (!a->out.hd) {
191     if ((n = trywrite(a, p, sz)) < 0)
192       return;
193     p += n;
194     sz -= n;
195     if (!sz)
196       return;
197   }
198   if (doqueue(&a->out, p, sz))
199     sel_addfile(&a->w);
200 }
201
202 /* --- @a_flush@ --- *
203  *
204  * Arguments:   @int fd@ = file descriptor
205  *              @unsigned mode@ = what's happening
206  *              @void *v@ = pointer to my admin block
207  *
208  * Returns:     ---
209  *
210  * Use:         Flushes buffers when a client is ready to read again.
211  */
212
213 static void a_flush(int fd, unsigned mode, void *v)
214 {
215   admin *a = v;
216   obuf *o, *oo;
217   ssize_t n;
218
219   o = a->out.hd;
220   while (o) {
221     if ((n = trywrite(a, o->p_out, o->p_in - o->p_out)) < 0)
222       return;
223     o->p_out += n;
224     if (o->p_in < o->p_out)
225       break;
226     oo = o;
227     o = o->next;
228     xfree(oo);
229   }
230   a->out.hd = o;
231   if (!o) {
232     a->out.tl = 0;
233     sel_rmfile(&a->w);
234   }
235 }
236
237 /*----- Utility functions -------------------------------------------------*/
238
239 /* --- @a_vformat@ --- *
240  *
241  * Arguments:   @dstr *d@ = where to leave the formatted message
242  *              @const char *fmt@ = pointer to format string
243  *              @va_list *ap@ = arguments in list
244  *
245  * Returns:     ---
246  *
247  * Use:         Main message token formatting driver.  The arguments are
248  *              interleaved formatting tokens and their parameters, finally
249  *              terminated by an entry @A_END@.
250  *
251  *              Tokens recognized:
252  *
253  *                * "*..." ... -- pretokenized @dstr_putf@-like string
254  *
255  *                * "?ADDR" SOCKADDR -- a socket address, to be converted
256  *
257  *                * "?B64" BUFFER SIZE -- binary data to be base64-encoded
258  *
259  *                * "?TOKENS" VECTOR -- null-terminated vector of tokens
260  *
261  *                * "?PEER" PEER -- peer's name
262  *
263  *                * "?ERRNO" ERRNO -- system error code
264  *
265  *                * "[!]..." ... -- @dstr_putf@-like string as single token
266  */
267
268 void a_vformat(dstr *d, const char *fmt, va_list *ap)
269 {
270   dstr dd = DSTR_INIT;
271
272   while (fmt) {
273     if (*fmt == '*') {
274       if (d->len) dstr_putc(d, ' ');
275       dstr_vputf(d, fmt + 1, ap);
276     } else if (*fmt == '?') {
277       if (strcmp(fmt, "?ADDR") == 0) {
278         const addr *a = va_arg(*ap, const addr *);
279         char name[NI_MAXHOST], serv[NI_MAXSERV];
280         int ix, err;
281         if ((err = getnameinfo(&a->sa, addrsz(a),
282                                name, sizeof(name), serv, sizeof(serv),
283                                (NI_NUMERICHOST | NI_NUMERICSERV |
284                                 NI_DGRAM)))) {
285           dstr_putf(d, " E%d", err);
286           u_quotify(d, gai_strerror(err));
287         } else {
288           ix = afix(a->sa.sa_family); assert(ix >= 0);
289           u_quotify(d, aftab[ix].name);
290           u_quotify(d, name);
291           u_quotify(d, serv);
292         }
293       } else if (strcmp(fmt, "?B64") == 0) {
294         const octet *p = va_arg(*ap, const octet *);
295         size_t n = va_arg(*ap, size_t);
296         codec *b64 = base64_class.encoder(CDCF_NOEQPAD, "", 0);
297         dstr_putc(d, ' ');
298         b64->ops->code(b64, p, n, d);
299         b64->ops->code(b64, 0, 0, d);
300         b64->ops->destroy(b64);
301       } else if (strcmp(fmt, "?TOKENS") == 0) {
302         const char *const *av = va_arg(*ap, const char *const *);
303         while (*av) u_quotify(d, *av++);
304       } else if (strcmp(fmt, "?PEER") == 0)
305         u_quotify(d, p_name(va_arg(*ap, peer *)));
306       else if (strcmp(fmt, "?ERRNO") == 0) {
307         dstr_putf(d, " E%d", errno);
308         u_quotify(d, strerror(errno));
309       } else
310         abort();
311     } else {
312       if (*fmt == '!') fmt++;
313       DRESET(&dd);
314       dstr_vputf(&dd, fmt, ap);
315       u_quotify(d, dd.buf);
316     }
317     fmt = va_arg(*ap, const char *);
318   }
319   dstr_putz(d);
320
321   dstr_destroy(&dd);
322 }
323
324 /* --- @a_format@ --- *
325  *
326  * Arguments:   @dstr *d@ = where to leave the formatted message
327  *              @const char *fmt@ = pointer to format string
328  *
329  * Returns:     ---
330  *
331  * Use:         Writes a tokenized message into a string, for later
332  *              presentation.
333  */
334
335 void a_format(dstr *d, const char *fmt, ...)
336 {
337   va_list ap;
338
339   va_start(ap, fmt);
340   a_vformat(d, fmt, &ap);
341   va_end(ap);
342 }
343
344 /* --- @a_write@, @a_vwrite@ --- *
345  *
346  * Arguments:   @admin *a@ = admin connection to write to
347  *              @const char *status@ = status code to report
348  *              @const char *tag@ = tag string, or null
349  *              @const char *fmt@ = pointer to format string
350  *              @va_list *ap@ = arguments in list
351  *              @...@ = other arguments
352  *
353  * Returns:     ---
354  *
355  * Use:         Sends a message to an admin connection.
356  */
357
358 static void a_vwrite(admin *a, const char *status, const char *tag,
359                      const char *fmt, va_list *ap)
360 {
361   dstr d = DSTR_INIT;
362
363   if (tag) dstr_puts(&d, "BG");
364   dstr_puts(&d, status);
365   if (tag) u_quotify(&d, tag);
366   a_vformat(&d, fmt, ap);
367   dstr_putc(&d, '\n');
368   dosend(a, d.buf, d.len);
369   dstr_destroy(&d);
370 }
371
372 static void a_write(admin *a, const char *status, const char *tag,
373                     const char *fmt, ...)
374 {
375   va_list ap;
376
377   va_start(ap, fmt);
378   a_vwrite(a, status, tag, fmt, &ap);
379   va_end(ap);
380 }
381
382 /* --- @a_ok@, @a_fail@ --- *
383  *
384  * Arguments:   @admin *a@ = connection
385  *              @const char *fmt@ = format string
386  *              @...@ = other arguments
387  *
388  * Returns:     ---
389  *
390  * Use:         Convenience functions for @a_write@.
391  */
392
393 static void a_ok(admin *a) { a_write(a, "OK", 0, A_END); }
394
395 static void a_fail(admin *a, const char *fmt, ...)
396 {
397   va_list ap;
398
399   va_start(ap, fmt);
400   a_vwrite(a, "FAIL", 0, fmt, &ap);
401   va_end(ap);
402 }
403
404 /* --- @a_info@ --- *
405  *
406  * Arguments:   @admin *a@ = connection
407  *              @const char *fmt@ = format string
408  *              @...@ = other arguments
409  *
410  * Returns:     ---
411  *
412  * Use:         Report information to an admin client.
413  */
414
415 void a_info(admin *a, const char *fmt, ...)
416 {
417   va_list ap;
418
419   va_start(ap, fmt);
420   a_vwrite(a, "INFO", 0, fmt, &ap);
421   va_end(ap);
422 }
423
424 /* --- @a_alert@, @a_valert@, @a_rawalert@ --- *
425  *
426  * Arguments:   @unsigned f_and, f_eq@ = filter for connections
427  *              @const char *status@ = status string
428  *              @const char *fmt@ = pointer to format string
429  *              @const char *p@ = pointer to raw string
430  *              @size_t sz@ = size of raw string
431  *              @va_list *ap@ = arguments in list
432  *              @...@ = other arguments
433  *
434  * Returns:     ---
435  *
436  * Use:         Write a message to all admin connections matched by the given
437  *              filter.
438  */
439
440 static void a_rawalert(unsigned f_and, unsigned f_eq, const char *status,
441                        const char *p, size_t sz)
442 {
443   admin *a, *aa;
444   dstr d = DSTR_INIT;
445
446   if (!(flags & F_INIT))
447     return;
448   dstr_puts(&d, status);
449   if (p) {
450     dstr_putc(&d, ' ');
451     dstr_putm(&d, p, sz);
452   }
453   dstr_putc(&d, '\n');
454   p = d.buf;
455   sz = d.len;
456   for (a = admins; a; a = aa) {
457     aa = a->next;
458     if ((a->f & f_and) == f_eq)
459       dosend(a, d.buf, d.len);
460   }
461   dstr_destroy(&d);
462 }
463
464 static void a_valert(unsigned f_and, unsigned f_eq, const char *status,
465                      const char *fmt, va_list *ap)
466 {
467   dstr d = DSTR_INIT;
468
469   if (!(flags & F_INIT))
470     return;
471   a_vformat(&d, fmt, ap);
472   a_rawalert(f_and, f_eq, status, fmt ? d.buf : 0, fmt ? d.len : 0);
473   dstr_destroy(&d);
474 }
475
476 static void a_alert(unsigned f_and, unsigned f_eq, const char *status,
477                     const char *fmt, ...)
478 {
479   va_list ap;
480
481   va_start(ap, fmt);
482   a_valert(f_and, f_eq, status, fmt, &ap);
483   va_end(ap);
484 }
485
486 /* --- @a_warn@ --- *
487  *
488  * Arguments:   @const char *fmt@ = pointer to format string
489  *              @...@ = other arguments
490  *
491  * Returns:     ---
492  *
493  * Use:         Informs all admin connections of a warning.
494  */
495
496 void a_warn(const char *fmt, ...)
497 {
498   va_list ap;
499
500   va_start(ap, fmt);
501   if (flags & F_INIT)
502     a_valert(0, 0, "WARN", fmt, &ap);
503   else {
504     dstr d = DSTR_INIT;
505     fprintf(stderr, "%s: ", QUIS);
506     a_vformat(&d, fmt, &ap);
507     dstr_putc(&d, '\n');
508     dstr_write(&d, stderr);
509     dstr_destroy(&d);
510   }
511   va_end(ap);
512 }
513
514 /* --- @a_trace@ --- *
515  *
516  * Arguments:   @const char *p@ = pointer to a buffer
517  *              @size_t sz@ = size of the buffer
518  *              @void *v@ = uninteresting pointer
519  *
520  * Returns:     ---
521  *
522  * Use:         Custom trace output handler.  Sends trace messages to
523  *              interested admin connections.
524  */
525
526 #ifndef NTRACE
527 static void a_trace(const char *p, size_t sz, void *v)
528   { a_rawalert(AF_TRACE, AF_TRACE, "TRACE", p, sz); }
529 #endif
530
531 /* --- @a_notify@ --- *
532  *
533  * Arguments:   @const char *fmt@ = pointer to format string
534  *              @...@ = other arguments
535  *
536  * Returns:     ---
537  *
538  * Use:         Sends a notification to interested admin connections.
539  */
540
541 void a_notify(const char *fmt, ...)
542 {
543   va_list ap;
544
545   va_start(ap, fmt);
546   a_valert(AF_NOTE, AF_NOTE, "NOTE", fmt, &ap);
547   va_end(ap);
548 }
549
550 /* --- @a_quit@ --- *
551  *
552  * Arguments:   ---
553  *
554  * Returns:     ---
555  *
556  * Use:         Shuts things down nicely.
557  */
558
559 void a_quit(void)
560 {
561   close(sock.fd);
562   unlink(sockname);
563   FOREACH_PEER(p, { p_destroy(p); });
564   ps_quit();
565   exit(0);
566 }
567
568 /* --- @a_sigdie@ --- *
569  *
570  * Arguments:   @int sig@ = signal number
571  *              @void *v@ = an uninteresting argument
572  *
573  * Returns:     ---
574  *
575  * Use          Shuts down on receipt of a fatal signal.
576  */
577
578 static void a_sigdie(int sig, void *v)
579 {
580   char *p;
581   char buf[20];
582
583   switch (sig) {
584     case SIGTERM:       p = "SIGTERM"; break;
585     case SIGINT:        p = "SIGINT"; break;
586     default:
587       sprintf(buf, "%i", sig);
588       p = buf;
589       break;
590   }
591   a_warn("SERVER", "quit", "signal", "%s", p, A_END);
592   a_quit();
593 }
594
595 /* --- @a_sighup@ --- *
596  *
597  * Arguments:   @int sig@ = signal number
598  *              @void *v@ = an uninteresting argument
599  *
600  * Returns:     ---
601  *
602  * Use          Logs a message about SIGHUP not being useful.
603  */
604
605 static void a_sighup(int sig, void *v)
606   { a_warn("SERVER", "ignore", "signal", "SIGHUP", A_END); }
607
608 /* --- @a_parsetime@ --- *
609  *
610  * Arguments;   @const char *p@ = time string to parse
611  *
612  * Returns:     Time in seconds, or @< 0@ on error.
613  */
614
615 static long a_parsetime(const char *p)
616 {
617   char *q;
618   long t = strtol(p, &q, 0);
619
620   switch (*q) {
621     case 'd': t *= 24;
622     case 'h': t *= 60;
623     case 'm': t *= 60;
624     case 's': if (q[1] != 0)
625     default:    t = -1;
626     case 0:   break;
627   }
628   return (t);
629 }
630
631 /* --- @a_findpeer@ --- *
632  *
633  * Arguments:   @admin *a@ = admin connection
634  *              @const char *pn@ = peer name
635  *
636  * Returns:     The peer, or null if not there.
637  *
638  * Use:         Finds a peer, reporting an error if it failed.
639  */
640
641 static peer *a_findpeer(admin *a, const char *pn)
642 {
643   peer *p;
644
645   if ((p = p_find(pn)) == 0)
646     a_fail(a, "unknown-peer", "%s", pn, A_END);
647   return (p);
648 }
649
650 /*----- Backgrounded operations -------------------------------------------*/
651
652 #define BGTAG(bg)                                                       \
653   (((admin_bgop *)(bg))->tag ? ((admin_bgop *)(bg))->tag : "<foreground>")
654
655 /* --- @a_bgfind@ --- *
656  *
657  * Arguments:   @admin *a@ = a client block
658  *              @const char *tag@ = the requested tag
659  *
660  * Returns:     The requested background job, or null.
661  */
662
663 static admin_bgop *a_bgfind(admin *a, const char *tag)
664 {
665   admin_bgop *bg;
666
667   for (bg = a->bg; bg; bg = bg->next) {
668     if (bg->tag && strcmp(tag, bg->tag) == 0)
669       return (bg);
670   }
671   return (0);
672 }
673
674 /* --- @a_bgrelease@ --- *
675  *
676  * Arguments:   @admin_bgop *bg@ = backgrounded operation
677  *
678  * Returns:     ---
679  *
680  * Use:         Removes a backgrounded operation from the queue, since
681  *              (presumably) it's done.
682  */
683
684 static void a_bgrelease(admin_bgop *bg)
685 {
686   admin *a = bg->a;
687
688   T( trace(T_ADMIN, "admin: release bgop %s", BGTAG(bg)); )
689   if (bg->tag) xfree(bg->tag);
690   else selbuf_enable(&a->b);
691   if (bg->next) bg->next->prev = bg->prev;
692   if (bg->prev) bg->prev->next = bg->next;
693   else a->bg = bg->next;
694   xfree(bg);
695   if (!a->bg && (a->f & AF_CLOSE)) a_destroy(a);
696 }
697
698 /* --- @a_bgok@, @a_bginfo@, @a_bgfail@ --- *
699  *
700  * Arguments:   @admin_bgop *bg@ = backgrounded operation
701  *              @const char *fmt@ = format string
702  *              @...@ = other arguments
703  *
704  * Returns:     ---
705  *
706  * Use:         Convenience functions for @a_write@.
707  */
708
709 static void a_bgok(admin_bgop *bg)
710   { a_write(bg->a, "OK", bg->tag, A_END); }
711
712 static void a_bginfo(admin_bgop *bg, const char *fmt, ...)
713 {
714   va_list ap;
715   va_start(ap, fmt);
716   a_vwrite(bg->a, "INFO", bg->tag, fmt, &ap);
717   va_end(ap);
718 }
719
720 static void a_bgfail(admin_bgop *bg, const char *fmt, ...)
721 {
722   va_list ap;
723   va_start(ap, fmt);
724   a_vwrite(bg->a, "FAIL", bg->tag, fmt, &ap);
725   va_end(ap);
726 }
727
728 /* --- @a_bgadd@ --- *
729  *
730  * Arguments:   @admin *a@ = administration connection
731  *              @admin_bgop *bg@ = pointer to background operation
732  *              @const char *tag@ = background tag, or null for foreground
733  *              @void (*cancel)(admin_bgop *)@ = cancel function
734  *
735  * Returns:     Zero for success, nonzero on failure.
736  *
737  * Use:         Links a background job into the list.
738  */
739
740 static int a_bgadd(admin *a, admin_bgop *bg, const char *tag,
741                    void (*cancel)(admin_bgop *))
742 {
743   if (tag) {
744     if (a_bgfind(a, tag)) {
745       a_fail(a, "tag-exists", "%s", tag, A_END);
746       return (-1);
747     }
748     bg->tag = xstrdup(tag);
749   }
750   else {
751     bg->tag = 0;
752     selbuf_disable(&a->b);
753   }
754   bg->a = a;
755   bg->cancel = cancel;
756   bg->next = a->bg;
757   bg->prev = 0;
758   if (a->bg) a->bg->prev = bg;
759   a->bg = bg;
760   T( trace(T_ADMIN, "admin: add bgop %s", BGTAG(bg)); )
761   if (tag) a_write(a, "DETACH", tag, A_END);
762   return (0);
763 }
764
765 /*----- Job table manipulation --------------------------------------------*/
766
767 #define JOB_SHIFT 16
768 #define JOB_INDEXMASK ((1ul << JOB_SHIFT) - 1)
769 #define JOB_SEQMASK ((1ul << (32 - JOB_SHIFT)) - 1)
770
771 #define JOB_END 0xfffffffful
772
773 static unsigned long a_joboffset;
774
775 /* --- @a_jobidencode@ --- *
776  *
777  * Arguments:   @admin_svcop *svc@ = pointer to a service operation
778  *
779  * Returns:     A jobid for this job, in an internal static buffer.
780  *
781  * Use:         Constructs a jobid.  In order to dissuade people from
782  *              predicting jobids, we obfuscate them.
783  *
784  *              A `raw' jobid consists of two 16-bit fields.  The low 16 bits
785  *              are an index into a big array.  The high 16 bits are a
786  *              sequence number recording how many times that slot has been
787  *              reused.
788  *
789  *              This `raw' jobid is then obfuscated by adding a randomly-
790  *              generated offset, and multiplying (mod %$2^{32}$%) by a fixed
791  *              odd constant.
792  */
793
794 static const char *a_jobidencode(admin_svcop *svc)
795 {
796   admin_jobtable *j = &svc->prov->j;
797   static char buf[10];
798   unsigned long pre;
799   unsigned seq;
800
801   assert(svc->index <= JOB_INDEXMASK);
802   seq = j->v[svc->index].seq;
803   assert(seq <= JOB_SEQMASK);
804   pre = (unsigned long)svc->index | ((unsigned long)seq << JOB_SHIFT);
805   sprintf(buf, "J%08lx", ((pre + a_joboffset) * 0x0f87a7a3ul) & 0xffffffff);
806   return (buf);
807 }
808
809 /* --- @a_jobiddecode@ --- *
810  *
811  * Arguments:   @admin_jobtable *j@ = pointer to a job table
812  *              @const char *jid@ = pointer to a jobid string
813  *
814  * Returns:     A pointer to the job's @svcop@ structure.
815  */
816
817 static admin_svcop *a_jobiddecode(admin_jobtable *j, const char *jid)
818 {
819   unsigned i;
820   unsigned long pre;
821
822   if (jid[0] != 'J')
823     return (0);
824   for (i = 1; i < 9; i++) {
825     if (!isxdigit((unsigned char)jid[i]))
826       return (0);
827   }
828   if (jid[9] != 0)
829     return (0);
830   pre = strtoul(jid + 1, 0, 16);
831   pre = ((pre * 0xbd11c40bul) - a_joboffset) & 0xffffffff;
832   i = pre & JOB_INDEXMASK;
833   if (i >= j->n || j->v[i].seq != (pre >> JOB_SHIFT))
834     return (0);
835   return (j->v[i].u.op);
836 }
837
838 /* --- @a_jobcreate@ --- *
839  *
840  * Arguments:   @admin *a@ = pointer to administration client
841  *
842  * Returns:     A pointer to a freshly-allocated @svcop@, or null.
843  *
844  * Use:         Allocates a fresh @svcop@ and links it into a job table.
845  */
846
847 static admin_svcop *a_jobcreate(admin *a)
848 {
849   admin_svcop *svc;
850   unsigned i;
851   unsigned sz;
852   admin_jobtable *j = &a->j;
853
854   if (j->free != JOB_END) {
855     i = j->free;
856     j->free = j->v[i].u.next;
857   } else {
858     if (j->n == j->sz) {
859       if (j->sz > JOB_INDEXMASK)
860         return (0);
861       sz = j->sz;
862       if (!sz) {
863         j->sz = 16;
864         j->v = xmalloc(j->sz * sizeof(*j->v));
865       } else {
866         j->sz = sz << 1;
867         j->v = xrealloc(j->v, j->sz * sizeof(*j->v), sz * sizeof(*j->v));
868       }
869     }
870     i = j->n++;
871     j->v[i].seq = 0;
872   }
873   svc = xmalloc(sizeof(*svc));
874   svc->index = i;
875   svc->prov = a;
876   svc->next = j->active;
877   svc->prev = 0;
878   if (j->active) j->active->prev = svc;
879   j->active = svc;
880   j->v[i].u.op = svc;
881   IF_TRACING(T_ADMIN, {
882     trace(T_ADMIN, "admin: created job %s (%u)", a_jobidencode(svc), i);
883   })
884   return (svc);
885 }
886
887 /* --- @a_jobdestroy@ --- *
888  *
889  * Arguments:   @admin_svcop *svc@ = pointer to job block
890  *
891  * Returns:     ---
892  *
893  * Use:         Frees up a completed (or cancelled) job.
894  */
895
896 static void a_jobdestroy(admin_svcop *svc)
897 {
898   admin *a = svc->prov;
899   admin_jobtable *j = &a->j;
900   unsigned i = svc->index;
901
902   IF_TRACING(T_ADMIN, {
903     trace(T_ADMIN, "admin: destroying job %s (%u)", a_jobidencode(svc), i);
904   })
905   assert(j->v[i].u.op = svc);
906   j->v[i].u.next = j->free;
907   j->v[i].seq++;
908   j->free = i;
909   if (svc->next) svc->next->prev = svc->prev;
910   if (svc->prev) svc->prev->next = svc->next;
911   else j->active = svc->next;
912 }
913
914 /* --- @a_jobtableinit@ --- *
915  *
916  * Arguments:   @admin_jobtable *j@ = pointer to job table
917  *
918  * Returns:     ---
919  *
920  * Use:         Initializes a job table.
921  */
922
923 static void a_jobtableinit(admin_jobtable *j)
924 {
925   if (!a_joboffset)
926     a_joboffset = GR_RANGE(&rand_global, 0xffffffff) + 1;
927   j->n = j->sz = 0;
928   j->active = 0;
929   j->free = JOB_END;
930   j->v = 0;
931 }
932
933 /* --- @a_jobtablefinal@ --- *
934  *
935  * Arguments:   @admin_jobtable *j@ = pointer to job table
936  *
937  * Returns:     ---
938  *
939  * Use:         Closes down a job table.
940  */
941
942 static void a_jobtablefinal(admin_jobtable *j)
943 {
944   admin_svcop *svc, *ssvc;
945
946   for (svc = j->active; svc; svc = ssvc) {
947     ssvc = svc->next;
948     a_bgfail(&svc->bg, "provider-failed", A_END);
949     a_bgrelease(&svc->bg);
950   }
951   if (j->v) xfree(j->v);
952 }
953
954 /*----- Services infrastructure -------------------------------------------*/
955
956 /* --- @a_svcfind@ --- *
957  *
958  * Arguments:   @admin *a@ = the requesting client
959  *              @const char *name@ = service name wanted
960  *
961  * Returns:     The service requested, or null.
962  *
963  * Use:         Finds a service; reports an error if the service couldn't be
964  *              found.
965  */
966
967 static admin_service *a_svcfind(admin *a, const char *name)
968 {
969   admin_service *svc;
970
971   if ((svc = sym_find(&a_svcs, name, -1, 0, 0)) == 0) {
972     a_fail(a, "unknown-service", "%s", name, A_END);
973     return (0);
974   }
975   return (svc);
976 }
977
978 /* --- @a_svcunlink@ --- *
979  *
980  * Arguments:   @admin_service *svc@ = pointer to service structure
981  *
982  * Returns:     ---
983  *
984  * Use:         Unlinks the service from its provider, without issuing a
985  *              message or freeing the structure.  The version string is
986  *              freed, however.
987  */
988
989 static void a_svcunlink(admin_service *svc)
990 {
991   if (svc->next)
992     svc->next->prev = svc->prev;
993   if (svc->prev)
994     svc->prev->next = svc->next;
995   else
996     svc->prov->svcs = svc->next;
997   xfree(svc->version);
998 }
999
1000 /* --- @a_svcrelease@ --- *
1001  *
1002  * Arguments:   @admin_service *svc@ = pointer to service structure
1003  *
1004  * Returns:     ---
1005  *
1006  * Use:         Releases a service and frees its structure.
1007  */
1008
1009 static void a_svcrelease(admin_service *svc)
1010 {
1011   a_notify("SVCRELEASE", "%s", SYM_NAME(svc), A_END);
1012   a_svcunlink(svc);
1013   sym_remove(&a_svcs, svc);
1014 }
1015
1016 /*----- Name resolution operations ----------------------------------------*/
1017
1018 #ifdef HAVE_LIBADNS
1019
1020 /* --- @before_select@ --- *
1021  *
1022  * Arguments:   @sel_state *s@ = the @sel@ multiplexor (unused)
1023  *              @sel_args *a@ = input to @select@, to be updated
1024  *              @void *p@ = a context pointer (unused)
1025  *
1026  * Returns:     ---
1027  *
1028  * Use:         An I/O multiplexor hook, called just before waiting for I/O
1029  *              events.
1030  *
1031  *              Currently its main purpose is to wire ADNS into the event
1032  *              loop.
1033  */
1034
1035 static void before_select(sel_state *s, sel_args *a, void *p)
1036 {
1037   struct timeval now;
1038   adns_query q;
1039   adns_answer *n;
1040   admin_resop *r;
1041   int any = 0;
1042
1043   /* --- Check for name-resolution progress --- *
1044    *
1045    * If there is any, then clobber the timeout: one of the resolver
1046    * callbacks might have renewed its interest in a file descriptor, but too
1047    * late to affect this @select@ call.
1048    *
1049    * I think, strictly, this is an mLib bug, but it's cheap enough to hack
1050    * around here.  Fixing it will wait for mLib 3.
1051    */
1052
1053   for (;;) {
1054     q = 0;
1055     if (adns_check(ads, &q, &n, &p)) break;
1056     r = p;
1057     any = 1;
1058     if (n->status != adns_s_ok) {
1059       T( trace(T_ADMIN, "admin: resop %s failed: %s",
1060                BGTAG(r), adns_strerror(n->status)); )
1061       a_bgfail(&r->bg, "resolve-error", "%s", r->addr, A_END);
1062       r->func(r, ARES_FAIL);
1063     } else {
1064       T( trace(T_ADMIN, "admin: resop %s ok", BGTAG(r)); )
1065       assert(n->type == adns_r_addr);
1066       assert(n->nrrs > 0);
1067       assert(n->rrs.addr[0].len <= sizeof(r->sa));
1068       memcpy(&r->sa, &n->rrs.addr[0].addr, n->rrs.addr[0].len);
1069       setport(&r->sa, r->port);
1070       r->func(r, ARES_OK);
1071     }
1072     free(n);
1073     sel_rmtimer(&r->t);
1074     xfree(r->addr);
1075     a_bgrelease(&r->bg);
1076   }
1077
1078   if (any) { a->tvp = &a->tv; a->tv.tv_sec = 0; a->tv.tv_usec = 0; }
1079
1080   gettimeofday(&now, 0);
1081   adns_beforeselect(ads, &a->maxfd,
1082                     &a->fd[SEL_READ], &a->fd[SEL_WRITE], &a->fd[SEL_EXC],
1083                     &a->tvp, &a->tv, &now);
1084 }
1085
1086 /* --- @after_select@ --- *
1087  *
1088  * Arguments:   @sel_state *s@ = the @sel@ multiplexor (unused)
1089  *              @sel_args *a@ = input to @select@, to be updated
1090  *              @void *p@ = a context pointer (unused)
1091  *
1092  * Returns:     ---
1093  *
1094  * Use:         An I/O multiplexor hook, called just after waiting for I/O
1095  *              events.
1096  *
1097  *              Currently its main purpose is to wire ADNS into the event
1098  *              loop.
1099  */
1100
1101 static void after_select(sel_state *s, sel_args *a, void *p)
1102 {
1103   struct timeval now;
1104
1105   gettimeofday(&now, 0);
1106   adns_afterselect(ads, a->maxfd,
1107                    &a->fd[SEL_READ], &a->fd[SEL_WRITE], &a->fd[SEL_EXC],
1108                    &now);
1109 }
1110
1111 #else
1112
1113 /* --- @a_resolved@ --- *
1114  *
1115  * Arguments:   @struct hostent *h@ = pointer to resolved hostname
1116  *              @void *v@ = pointer to resolver operation
1117  *
1118  * Returns:     ---
1119  *
1120  * Use:         Handles a completed name resolution.
1121  */
1122
1123 static void a_resolved(struct hostent *h, void *v)
1124 {
1125   admin_resop *r = v;
1126
1127   QUICKRAND;
1128   if (!h) {
1129     T( trace(T_ADMIN, "admin: resop %s failed: %s",
1130              BGTAG(r), hstrerror(h_errno)); )
1131     a_bgfail(&r->bg, "resolve-error", "%s", r->addr, A_END);
1132     r->func(r, ARES_FAIL);
1133   } else {
1134     T( trace(T_ADMIN, "admin: resop %s ok", BGTAG(r)); )
1135     r->sa.sin.sin_family = AF_INET;
1136     memcpy(&r->sa.sin.sin_addr, h->h_addr, sizeof(struct in_addr));
1137     setport(&r->sa, r->port);
1138     r->func(r, ARES_OK);
1139   }
1140   sel_rmtimer(&r->t);
1141   xfree(r->addr);
1142   a_bgrelease(&r->bg);
1143 }
1144
1145 #endif
1146
1147 /* --- @a_restimer@ --- *
1148  *
1149  * Arguments:   @struct timeval *tv@ = timer
1150  *              @void *v@ = pointer to resolver operation
1151  *
1152  * Returns:     ---
1153  *
1154  * Use:         Times out a resolver.
1155  */
1156
1157 static void a_restimer(struct timeval *tv, void *v)
1158 {
1159   admin_resop *r = v;
1160
1161   T( trace(T_ADMIN, "admin: resop %s timeout", BGTAG(r)); )
1162   a_bgfail(&r->bg, "resolver-timeout", "%s", r->addr, A_END);
1163   r->func(r, ARES_FAIL);
1164 #ifdef HAVE_LIBADNS
1165   adns_cancel(r->q);
1166 #else
1167   bres_abort(&r->r);
1168 #endif
1169   xfree(r->addr);
1170   a_bgrelease(&r->bg);
1171 }
1172
1173 /* --- @a_rescancel@ --- *
1174  *
1175  * Arguments:   @admin_bgop *bg@ = background operation
1176  *
1177  * Returns:     ---
1178  *
1179  * Use:         Cancels an add operation.
1180  */
1181
1182 static void a_rescancel(admin_bgop *bg)
1183 {
1184   admin_resop *r = (admin_resop *)bg;
1185
1186   T( trace(T_ADMIN, "admin: cancel resop %s", BGTAG(r)); )
1187   r->func(r, ARES_FAIL);
1188   sel_rmtimer(&r->t);
1189   xfree(r->addr);
1190 #ifdef HAVE_LIBADNS
1191   adns_cancel(r->q);
1192 #else
1193   bres_abort(&r->r);
1194 #endif
1195 }
1196
1197 /* --- @a_resolve@ --- *
1198  *
1199  * Arguments:   @admin *a@ = administration connection
1200  *              @admin_resop *r@ = resolver operation to run
1201  *              @const char *tag@ = background operation tag
1202  *              @void (*func)(struct admin_resop *, int@ = handler function
1203  *              @unsigned ac@ = number of remaining arguments
1204  *              @char *av[]@ = pointer to remaining arguments
1205  *
1206  * Returns:     ---
1207  *
1208  * Use:         Cranks up a resolver job.
1209  */
1210
1211 static void a_resolve(admin *a, admin_resop *r, const char *tag,
1212                       void (*func)(struct admin_resop *, int),
1213                       unsigned ac, char *av[])
1214 {
1215   struct timeval tv;
1216   unsigned long pt;
1217   int af = AF_UNSPEC;
1218   const char *fam = "ANY";
1219   char *p;
1220   int i = 0, j;
1221   struct addrinfo *ai, *ailist, aihint = { 0 };
1222 #ifdef HAVE_LIBADNS
1223   int err;
1224   adns_queryflags qf;
1225 #endif
1226
1227   /* --- Fill in the easy bits of address --- */
1228
1229   r->bg.tag = "<starting>";
1230   r->addr = 0;
1231   r->func = func;
1232   if (mystrieq(av[i], "any"))
1233     { fam = "ANY"; af = AF_UNSPEC; i++; }
1234   else for (j = 0; j < NADDRFAM; j++) {
1235     if (mystrieq(av[i], aftab[j].name)) {
1236       assert(udpsock[j].fd >= 0);
1237       fam = aftab[j].name;
1238       af = aftab[j].af;
1239       i++;
1240       break;
1241     }
1242   }
1243   if (ac - i != 1 && ac - i != 2) {
1244     a_fail(a, "bad-addr-syntax", "[FAMILY] ADDRESS [PORT]", A_END);
1245     goto fail;
1246   }
1247   r->addr = xstrdup(av[i]);
1248   if (!av[i + 1])
1249     pt = TRIPE_PORT;
1250   else {
1251     pt = strtoul(av[i + 1], &p, 0);
1252     if (*p) {
1253       struct servent *s = getservbyname(av[i + 1], "udp");
1254       if (!s) {
1255         a_fail(a, "unknown-service", "%s", av[i + 1], A_END);
1256         goto fail;
1257       }
1258       pt = ntohs(s->s_port);
1259     }
1260   }
1261   if (pt == 0 || pt >= 65536) {
1262     a_fail(a, "invalid-port", "%lu", pt, A_END);
1263     goto fail;
1264   }
1265   r->port = pt;
1266
1267   /* --- Report backgrounding --- *
1268    *
1269    * Do this for consistency of interface, even if we're going to get the
1270    * answer straight away.
1271    */
1272
1273   if (a_bgadd(a, &r->bg, tag, a_rescancel))
1274     goto fail;
1275   T( trace(T_ADMIN, "admin: %u, resop %s, hostname `%s', family `%s'",
1276            a->seq, BGTAG(r), r->addr, fam); )
1277
1278   /* --- Make sure the address family is something we can implement --- */
1279
1280   if (af != AF_UNSPEC && af != AF_INET) {
1281     T( trace(T_ADMIN, "admin: resop %s failed: unsupported address family",
1282              BGTAG(r)); )
1283     a_bgfail(&r->bg, "resolve-error", "%s", r->addr, A_END);
1284     goto fail_release;
1285   }
1286   assert(udpsock[AFIX_INET].fd >= 0);
1287
1288   /* --- If the name is numeric, do it the easy way --- */
1289
1290   aihint.ai_family = AF_INET;
1291   aihint.ai_socktype = SOCK_DGRAM;
1292   aihint.ai_protocol = IPPROTO_UDP;
1293   aihint.ai_flags = AI_NUMERICHOST;
1294   if (!getaddrinfo(av[i], 0, &aihint, &ailist)) {
1295     for (ai = ailist; ai; ai = ai->ai_next) {
1296       if ((j = afix(ai->ai_family)) >= 0 && udpsock[j].fd >= 0)
1297         break;
1298     }
1299     if (!ai) {
1300       T( trace(T_ADMIN, "admin: resop %s failed: "
1301                "no suitable addresses returned", BGTAG(r)); )
1302       a_bgfail(&r->bg, "resolve-error", "%s" , r->addr, A_END);
1303       func(r, ARES_FAIL);
1304     } else {
1305       T( trace(T_ADMIN, "admin: resop %s done the easy way", BGTAG(r)); )
1306       assert(ai->ai_addrlen <= sizeof(r->sa));
1307       memcpy(&r->sa, ai->ai_addr, ai->ai_addrlen);
1308       setport(&r->sa, r->port);
1309       func(r, ARES_OK);
1310     }
1311     freeaddrinfo(ailist);
1312     xfree(r->addr);
1313     a_bgrelease(&r->bg);
1314     return;
1315   }
1316
1317   /* --- Store everything for later and crank up the resolver --- */
1318
1319   gettimeofday(&tv, 0);
1320   tv.tv_sec += T_RESOLVE;
1321   sel_addtimer(&sel, &r->t, &tv, a_restimer, r);
1322 #ifdef HAVE_LIBADNS
1323   qf = adns_qf_search | adns_qf_want_ipv4;
1324   if ((err = adns_submit(ads, r->addr, adns_r_addr, qf, r, &r->q)) != 0) {
1325     T( trace(T_ADMIN, "admin: resop %s adns_submit failed: %s",
1326              BGTAG(r), strerror(err)); )
1327     a_bgfail(&r->bg, "resolve-error", "%s", r->addr, A_END);
1328     goto fail_release;
1329   }
1330 #else
1331   bres_byname(&r->r, r->addr, a_resolved, r);
1332 #endif
1333   return;
1334
1335 fail:
1336   func(r, ARES_FAIL);
1337   if (r->addr) xfree(r->addr);
1338   xfree(r);
1339   return;
1340
1341 fail_release:
1342   func(r, ARES_FAIL);
1343   xfree(r->addr);
1344   a_bgrelease(&r->bg);
1345 }
1346
1347 /*----- Option parsing ----------------------------------------------------*/
1348
1349 #define OPTIONS(argc, argv, guts) do {                                  \
1350   char **o_av = argv;                                                   \
1351   for (;; o_av++) {                                                     \
1352     if (!*o_av)                                                         \
1353       break;                                                            \
1354     if (mystrieq(*o_av, "--")) {                                        \
1355       o_av++;                                                           \
1356       break;                                                            \
1357     }                                                                   \
1358     guts                                                                \
1359     if (**o_av == '-')                                                  \
1360       goto bad_syntax;                                                  \
1361     break;                                                              \
1362   }                                                                     \
1363   argc -= o_av - argv;                                                  \
1364   argv = o_av;                                                          \
1365 } while (0)
1366
1367 #define OPT(name, guts) if (mystrieq(*o_av, name)) { guts continue; }
1368
1369 #define OPTARG(name, arg, guts) OPT(name, {                             \
1370   const char *arg;                                                      \
1371   arg = *++o_av;                                                        \
1372   if (!arg) goto bad_syntax;                                            \
1373   guts                                                                  \
1374 })
1375
1376 #define OPTTIME(name, arg, guts) OPTARG(name, o_arg, {                  \
1377   long arg;                                                             \
1378   if ((arg = a_parsetime(o_arg)) < 0) {                                 \
1379     a_fail(a, "bad-time-spec", "%s", o_arg, A_END);                     \
1380     goto fail;                                                          \
1381   }                                                                     \
1382   guts                                                                  \
1383 })
1384
1385 /*----- Adding peers ------------------------------------------------------*/
1386
1387 /* --- @a_doadd@ --- *
1388  *
1389  * Arguments:   @admin_resop *r@ = resolver operation
1390  *              @int rc@ = how it worked
1391  *
1392  * Returns:     ---
1393  *
1394  * Use:         Handles a completed resolution.
1395  */
1396
1397 static void a_doadd(admin_resop *r, int rc)
1398 {
1399   admin_addop *add = (admin_addop *)r;
1400
1401   T( trace(T_ADMIN, "admin: done add op %s", BGTAG(add)); )
1402
1403   if (rc == ARES_OK) {
1404     add->peer.sa = add->r.sa;
1405     if (p_findbyaddr(&add->r.sa))
1406       a_bgfail(&add->r.bg, "peer-addr-exists", "?ADDR", &add->r.sa, A_END);
1407     else if (p_find(add->peer.name))
1408       a_bgfail(&add->r.bg, "peer-exists", "%s", add->peer.name, A_END);
1409     else if (!p_create(&add->peer))
1410       a_bgfail(&add->r.bg, "peer-create-fail", "%s", add->peer.name, A_END);
1411     else
1412       a_bgok(&add->r.bg);
1413   }
1414
1415   if (add->peer.tag) xfree(add->peer.tag);
1416   if (add->peer.privtag) xfree(add->peer.privtag);
1417   xfree(add->peer.name);
1418 }
1419
1420 /* --- @acmd_add@ --- *
1421  *
1422  * Arguments:   @admin *a@ = connection which requested the addition
1423  *              @unsigned ac@ = argument count
1424  *              @char *av[]@ = pointer to the argument list
1425  *
1426  * Returns:     ---
1427  *
1428  * Use:         Adds a new peer.
1429  */
1430
1431 static void acmd_add(admin *a, unsigned ac, char *av[])
1432 {
1433   const char *tag = 0;
1434   admin_addop *add;
1435
1436   /* --- Set stuff up --- */
1437
1438   add = xmalloc(sizeof(*add));
1439   add->peer.name = 0;
1440   add->peer.tag = 0;
1441   add->peer.privtag = 0;
1442   add->peer.t_ka = 0;
1443   add->peer.tops = tun_default;
1444   add->peer.f = 0;
1445
1446   /* --- Parse options --- */
1447
1448   OPTIONS(ac, av, {
1449     OPTARG("-background", arg, { tag = arg; })
1450     OPTARG("-tunnel", arg, {
1451       unsigned i;
1452       for (i = 0;; i++) {
1453         if (!tunnels[i]) {
1454           a_fail(a, "unknown-tunnel", "%s", arg, A_END);
1455           goto fail;
1456         }
1457         if (mystrieq(arg, tunnels[i]->name)) {
1458           add->peer.tops = tunnels[i];
1459           break;
1460         }
1461       }
1462     })
1463     OPTTIME("-keepalive", t, { add->peer.t_ka = t; })
1464     OPT("-cork", { add->peer.f |= KXF_CORK; })
1465     OPTARG("-key", arg, {
1466       if (add->peer.tag) xfree(add->peer.tag);
1467       add->peer.tag = xstrdup(arg);
1468     })
1469     OPT("-mobile", { add->peer.f |= PSF_MOBILE; })
1470     OPTARG("-priv", arg, {
1471       if (add->peer.privtag) xfree(add->peer.privtag);
1472       add->peer.privtag = xstrdup(arg);
1473     })
1474   });
1475
1476   /* --- Make sure someone's not got there already --- */
1477
1478   if (!av[0] || !av[1])
1479     goto bad_syntax;
1480   if (p_find(*av)) {
1481     a_fail(a, "peer-exists", "%s", *av, A_END);
1482     goto fail;
1483   }
1484   add->peer.name = xstrdup(*av++);
1485   ac--;
1486
1487   /* --- Crank up the resolver --- */
1488
1489   a_resolve(a, &add->r, tag, a_doadd, ac, av);
1490   return;
1491
1492   /* --- Clearing up --- */
1493
1494 bad_syntax:
1495   a_fail(a, "bad-syntax", "add", "[OPTIONS] PEER ADDR ...", A_END);
1496 fail:
1497   if (add->peer.name) xfree(add->peer.name);
1498   if (add->peer.tag) xfree(add->peer.tag);
1499   if (add->peer.privtag) xfree(add->peer.privtag);
1500   xfree(add);
1501   return;
1502 }
1503
1504 /*----- Ping --------------------------------------------------------------*/
1505
1506 /* --- @a_pingcancel@ --- *
1507  *
1508  * Arguments:   @admin_bgop *bg@ = background operation block
1509  *
1510  * Returns:     ---
1511  *
1512  * Use:         Cancels a running ping.
1513  */
1514
1515 static void a_pingcancel(admin_bgop *bg)
1516 {
1517   admin_pingop *pg = (admin_pingop *)bg;
1518   T( trace(T_ADMIN, "admin: cancel ping op %s", BGTAG(pg)); )
1519   p_pingdone(&pg->ping, PING_NONOTIFY);
1520 }
1521
1522 /* --- @a_pong@ --- *
1523  *
1524  * Arguments:   @int rc@ = return code
1525  *              @void *v@ = ping operation block
1526  *
1527  * Returns:     ---
1528  *
1529  * Use:         Collects what happened to a ping message.
1530  */
1531
1532 static void a_pong(int rc, void *v)
1533 {
1534   admin_pingop *pg = v;
1535   struct timeval tv;
1536   double millis;
1537
1538   switch (rc) {
1539     case PING_OK:
1540       gettimeofday(&tv, 0);
1541       tv_sub(&tv, &tv, &pg->pingtime);
1542       millis = (double)tv.tv_sec * 1000 + (double)tv.tv_usec/1000;
1543       a_bginfo(&pg->bg, "ping-ok", "%.1f", millis, A_END);
1544       a_bgok(&pg->bg);
1545       break;
1546     case PING_TIMEOUT:
1547       a_bginfo(&pg->bg, "ping-timeout", A_END);
1548       a_bgok(&pg->bg);
1549       break;
1550     case PING_PEERDIED:
1551       a_bginfo(&pg->bg, "ping-peer-died", A_END);
1552       a_bgok(&pg->bg);
1553       break;
1554     default:
1555       abort();
1556   }
1557   T( trace(T_ADMIN, "admin: ponged ping op %s", BGTAG(pg)); )
1558   a_bgrelease(&pg->bg);
1559 }
1560
1561 /* --- @acmd_ping@, @acmd_eping@ --- *
1562  *
1563  * Arguments:   @admin *a@ = connection which requested the ping
1564  *              @unsigned ac@ = argument count
1565  *              @char *av[]@ = pointer to the argument list
1566  *
1567  * Returns:     ---
1568  *
1569  * Use:         Pings a peer.
1570  */
1571
1572 static void a_ping(admin *a, unsigned ac, char *av[],
1573                    const char *cmd, unsigned msg)
1574 {
1575   long t = T_PING;
1576   peer *p;
1577   admin_pingop *pg = 0;
1578   const char *tag = 0;
1579
1580   OPTIONS(ac, av, {
1581     OPTARG("-background", arg, { tag = arg; })
1582     OPTTIME("-timeout", arg, { t = arg; })
1583   });
1584   if (!*av || av[1]) goto bad_syntax;
1585   if ((p = a_findpeer(a, *av)) == 0)
1586     return;
1587   pg = xmalloc(sizeof(*pg));
1588   gettimeofday(&pg->pingtime, 0);
1589   if (a_bgadd(a, &pg->bg, tag, a_pingcancel))
1590     goto fail;
1591   T( trace(T_ADMIN, "admin: ping op %s: %s to %s",
1592            BGTAG(pg), cmd, p_name(p)); )
1593   if (p_pingsend(p, &pg->ping, msg, t, a_pong, pg)) {
1594     a_bgfail(&pg->bg, "ping-send-failed", A_END);
1595     a_bgrelease(&pg->bg);
1596   }
1597   return;
1598
1599 bad_syntax:
1600   a_fail(a, "bad-syntax", "%s", cmd, "[OPTIONS] PEER", cmd, A_END);
1601 fail:
1602   if (pg) xfree(pg);
1603   return;
1604 }
1605
1606 static void acmd_ping(admin *a, unsigned ac, char *av[])
1607   { a_ping(a, ac, av, "ping", MISC_PING); }
1608 static void acmd_eping(admin *a, unsigned ac, char *av[])
1609   { a_ping(a, ac, av, "eping", MISC_EPING); }
1610
1611 /*----- Service commands --------------------------------------------------*/
1612
1613 static void acmd_svcclaim(admin *a, unsigned ac, char *av[])
1614 {
1615   admin_service *svc;
1616   unsigned f;
1617
1618   svc = sym_find(&a_svcs, av[0], -1, sizeof(*svc), &f);
1619   if (f) {
1620     if (versioncmp(av[1], svc->version) <= 0) {
1621       a_fail(a,
1622              "service-exists",
1623              "%s", SYM_NAME(svc),
1624              "%s", svc->version,
1625              A_END);
1626       return;
1627     }
1628     a_write(svc->prov, "SVCCLAIM", 0, "%s", av[0], "%s", av[1], A_END);
1629     a_svcunlink(svc);
1630   }
1631   svc->prov = a;
1632   svc->version = xstrdup(av[1]);
1633   svc->next = a->svcs;
1634   svc->prev = 0;
1635   if (a->svcs) a->svcs->prev = svc;
1636   a->svcs = svc;
1637   a_notify("SVCCLAIM", "%s", SYM_NAME(svc), "%s", svc->version, A_END);
1638   a_ok(a);
1639 }
1640
1641 static void acmd_svcrelease(admin *a, unsigned ac, char *av[])
1642 {
1643   admin_service *svc;
1644
1645   if ((svc = a_svcfind(a, av[0])) == 0)
1646     return;
1647   if (svc->prov != a) {
1648     a_fail(a, "not-service-provider", "%s", SYM_NAME(svc), A_END);
1649     return;
1650   }
1651   a_svcrelease(svc);
1652   a_ok(a);
1653 }
1654
1655 static void acmd_svcensure(admin *a, unsigned ac, char *av[])
1656 {
1657   admin_service *svc;
1658
1659   if ((svc = a_svcfind(a, av[0])) == 0)
1660     return;
1661   if (av[1] && versioncmp(svc->version, av[1]) < 0) {
1662     a_fail(a, "service-too-old",
1663            "%s", SYM_NAME(svc),
1664            "%s", svc->version,
1665            A_END);
1666     return;
1667   }
1668   a_ok(a);
1669 }
1670
1671 static void acmd_svcquery(admin *a, unsigned ac, char *av[])
1672 {
1673   admin_service *svc;
1674
1675   if ((svc = a_svcfind(a, av[0])) != 0) {
1676     a_info(a, "name=%s", SYM_NAME(svc), "version=%s", svc->version, A_END);
1677     a_ok(a);
1678   }
1679 }
1680
1681 static void acmd_svclist(admin *a, unsigned ac, char *av[])
1682 {
1683   admin_service *svc;
1684   sym_iter i;
1685
1686   for (sym_mkiter(&i, &a_svcs); (svc = sym_next(&i)) != 0; )
1687     a_info(a, "%s", SYM_NAME(svc), "%s", svc->version, A_END);
1688   a_ok(a);
1689 }
1690
1691 static void a_canceljob(admin_bgop *bg)
1692 {
1693   admin_svcop *svc = (admin_svcop *)bg;
1694
1695   a_write(svc->prov, "SVCCANCEL", 0, "%s", a_jobidencode(svc), A_END);
1696   a_jobdestroy(svc);
1697 }
1698
1699 static void acmd_svcsubmit(admin *a, unsigned ac, char *av[])
1700 {
1701   const char *tag = 0;
1702   admin_service *svc;
1703   admin_svcop *svcop;
1704   const char *ver = 0;
1705   dstr d = DSTR_INIT;
1706
1707   OPTIONS(ac, av, {
1708     OPTARG("-background", arg, { tag = arg; })
1709     OPTARG("-version", arg, { ver = arg; })
1710   });
1711   if (!*av) goto bad_syntax;
1712   if ((svc = a_svcfind(a, *av)) == 0) goto fail;
1713   if (ver && versioncmp(svc->version, ver) < 0) {
1714     a_fail(a, "service-too-old",
1715            "%s", SYM_NAME(svc),
1716            "%s", svc->version,
1717            A_END);
1718     goto fail;
1719   }
1720   if ((svcop = a_jobcreate(svc->prov)) == 0) {
1721     a_fail(a, "provider-overloaded", A_END);
1722     goto fail;
1723   }
1724   if (a_bgadd(a, &svcop->bg, tag, a_canceljob)) {
1725     a_jobdestroy(svcop);
1726     goto fail;
1727   }
1728   a_write(svc->prov, "SVCJOB", 0,
1729           "%s", a_jobidencode(svcop),
1730           "?TOKENS", av,
1731           A_END);
1732   goto done;
1733
1734 bad_syntax:
1735   a_fail(a, "bad-syntax", "svcsubmit", "[OPTIONS] SERVICE ARGS...", A_END);
1736 fail:
1737 done:
1738   dstr_destroy(&d);
1739   return;
1740 }
1741
1742 static void a_replycmd(admin *a, const char *status, int donep, char *av[])
1743 {
1744   admin_svcop *svc;
1745
1746   if ((svc = a_jobiddecode(&a->j, av[0])) == 0) {
1747     a_fail(a, "unknown-jobid", av[0], A_END);
1748     return;
1749   }
1750   a_write(svc->bg.a, status, svc->bg.tag, "?TOKENS", av + 1, A_END);
1751   if (donep) {
1752     a_jobdestroy(svc);
1753     a_bgrelease(&svc->bg);
1754   }
1755   a_ok(a);
1756 }
1757
1758 static void acmd_svcok(admin *a, unsigned ac, char *av[])
1759   { a_replycmd(a, "OK", 1, av); }
1760 static void acmd_svcinfo(admin *a, unsigned ac, char *av[])
1761   { a_replycmd(a, "INFO", 0, av); }
1762 static void acmd_svcfail(admin *a, unsigned ac, char *av[])
1763   { a_replycmd(a, "FAIL", 1, av); }
1764
1765 /*----- Administration commands -------------------------------------------*/
1766
1767 /* --- Miscellaneous commands --- */
1768
1769 /* --- @traceish@ --- *
1770  *
1771  * Arguments:   @admin *a@ = connection to complain on
1772  *              @unsigned ac@ = number of arguments
1773  *              @char *av[]@ = vector of arguments
1774  *              @const char *what@ = what we're messing with
1775  *              @const trace_opt *tt@ = options table
1776  *              @unsigned *ff@ = where the flags are
1777  *
1778  * Returns:     Nonzero if anything changed.
1779  *
1780  * Use:         Guts of trace-ish commands like `trace' and `watch'.
1781  */
1782
1783 static int traceish(admin *a, unsigned ac, char *av[],
1784                     const char *what, const trace_opt *tt, unsigned *ff)
1785 {
1786   int ch = 0;
1787
1788   if (!ac || strcmp(av[0], "?") == 0) {
1789     const trace_opt *t;
1790     for (t = tt; t->ch; t++) {
1791       a_info(a, "*%c%c %s",
1792              t->ch, (*ff & t->f) == t->f ? '+' : ' ', t->help, A_END);
1793     }
1794   } else {
1795     unsigned sense = 1;
1796     unsigned f = *ff;
1797     const trace_opt *t;
1798     char *p = av[0];
1799
1800     while (*p) {
1801       switch (*p) {
1802         case '+': sense = 1; break;
1803         case '-': sense = 0; break;
1804         default:
1805           for (t = tt; t->ch; t++) {
1806             if (t->ch == *p) {
1807               if (sense) f |= t->f;
1808               else f &= ~t->f;
1809               goto tropt_ok;
1810             }
1811           }
1812           a_fail(a, "bad-%s-option", what, "%c", *p, A_END);
1813           return (0);
1814         tropt_ok:;
1815           break;
1816       }
1817       p++;
1818     }
1819     *ff = f;
1820     ch = 1;
1821   }
1822   a_ok(a);
1823   return (ch);
1824 }
1825
1826 #ifndef NTRACE
1827
1828 static void acmd_trace(admin *a, unsigned ac, char *av[])
1829 {
1830   if (traceish(a, ac, av, "trace", tr_opts, &tr_flags))
1831     trace_level(tr_flags);
1832 }
1833
1834 #endif
1835
1836 static void acmd_watch(admin *a, unsigned ac, char *av[])
1837   { traceish(a, ac, av, "watch", w_opts, &a->f); }
1838
1839 static void alertcmd(admin *a, unsigned f_and, unsigned f_eq,
1840                      const char *status, char *av[])
1841   { a_alert(f_and, f_eq, status, "USER", "?TOKENS", av, A_END); a_ok(a); }
1842 static void acmd_notify(admin *a, unsigned ac, char *av[])
1843   { alertcmd(a, AF_NOTE, AF_NOTE, "NOTE", av); }
1844 static void acmd_warn(admin *a, unsigned ac, char *av[])
1845   { alertcmd(a, AF_WARN, AF_WARN, "WARN", av); }
1846
1847 static void acmd_port(admin *a, unsigned ac, char *av[])
1848 {
1849   int i;
1850
1851   if (ac) {
1852     for (i = 0; i < NADDRFAM; i++)
1853       if (mystrieq(av[0], aftab[i].name)) goto found;
1854     a_fail(a, "unknown-address-family", "%s", av[0], A_END);
1855     return;
1856   found:
1857     if (udpsock[i].fd < 0) {
1858       a_fail(a, "disabled-address-family", "%s", aftab[i].name, A_END);
1859       return;
1860     }
1861   } else {
1862     for (i = 0; i < NADDRFAM; i++)
1863       if (udpsock[i].fd >= 0) goto found;
1864     abort();
1865   }
1866   a_info(a, "%u", p_port(i), A_END);
1867   a_ok(a);
1868 }
1869
1870 static void acmd_daemon(admin *a, unsigned ac, char *av[])
1871 {
1872   if (flags & F_DAEMON)
1873     a_fail(a, "already-daemon", A_END);
1874   else {
1875     a_notify("DAEMON", A_END);
1876     if (a_stdin)
1877       a_destroy(a_stdin);
1878     if (daemonize())
1879       a_fail(a, "daemon-error", "?ERRNO", A_END);
1880     else {
1881       flags |= F_DAEMON;
1882       a_ok(a);
1883     }
1884   }
1885 }
1886
1887 static void acmd_jobs(admin *a, unsigned ac, char *av[])
1888 {
1889   admin_bgop *bg;
1890
1891   for (bg = a->bg; bg; bg = bg->next) {
1892     assert(bg->tag);
1893     a_info(a, "%s", bg->tag, A_END);
1894   }
1895   a_ok(a);
1896 }
1897
1898 static void acmd_bgcancel(admin *a, unsigned ac, char *av[])
1899 {
1900   admin_bgop *bg;
1901
1902   if ((bg = a_bgfind(a, av[0])) == 0)
1903     a_fail(a, "unknown-tag", "%s", av[0], A_END);
1904   else {
1905     bg->cancel(bg);
1906     a_bgrelease(bg);
1907     a_ok(a);
1908   }
1909 }
1910
1911 static void acmd_algs(admin *a, unsigned ac, char *av[])
1912 {
1913   peer *p;
1914   const kdata *kd;
1915   const dhgrp *g;
1916   const algswitch *algs;
1917
1918   if (!ac)
1919     kd = master;
1920   else {
1921     if ((p = a_findpeer(a, av[0])) == 0) return;
1922     kd = p->kx.kpriv;
1923   }
1924   g = kd->grp;
1925   algs = &kd->algs;
1926
1927   g->ops->grpinfo(g, a);
1928   a_info(a,
1929          "hash=%s", algs->h->name,
1930          "mgf=%s", algs->mgf->name,
1931          "hash-sz=%lu", (unsigned long)algs->h->hashsz,
1932          A_END);
1933   a_info(a,
1934          "bulk-transform=%s", algs->bulk->ops->name,
1935          "bulk-overhead=%lu",
1936          (unsigned long)algs->bulk->ops->overhead(algs->bulk),
1937          A_END);
1938   algs->bulk->ops->alginfo(algs->bulk, a);
1939   a_info(a,
1940          "cipher-data-limit=%lu",
1941          (unsigned long)algs->bulk->ops->expsz(algs->bulk),
1942          A_END);
1943   a_ok(a);
1944 }
1945
1946 static void acmd_list(admin *a, unsigned ac, char *av[])
1947 {
1948   FOREACH_PEER(p, {  a_info(a, "%s", p_name(p), A_END); });
1949   a_ok(a);
1950 }
1951
1952 static void acmd_ifname(admin *a, unsigned ac, char *av[])
1953 {
1954   peer *p;
1955
1956   if ((p = a_findpeer(a, av[0])) != 0) {
1957     a_info(a, "%s", p_ifname(p), A_END);
1958     a_ok(a);
1959   }
1960 }
1961
1962 static void acmd_setifname(admin *a, unsigned ac, char *av[])
1963 {
1964   peer *p;
1965
1966   if ((p = a_findpeer(a, av[0])) != 0) {
1967     a_notify("NEWIFNAME", "?PEER", p, "%s", p_ifname(p), "%s", av[1], A_END);
1968     p_setifname(p, av[1]);
1969     a_ok(a);
1970   }
1971 }
1972
1973 static void acmd_getchal(admin *a, unsigned ac, char *av[])
1974 {
1975   buf b;
1976
1977   buf_init(&b, buf_i, PKBUFSZ);
1978   c_new(&b);
1979   a_info(a, "?B64", BBASE(&b), (size_t)BLEN(&b), A_END);
1980   a_ok(a);
1981 }
1982
1983 static void acmd_checkchal(admin *a, unsigned ac, char *av[])
1984 {
1985   codec *b64 = base64_class.decoder(CDCF_NOEQPAD);
1986   int err;
1987   buf b;
1988   dstr d = DSTR_INIT;
1989
1990   if ((err = b64->ops->code(b64, av[0], strlen(av[0]), &d)) != 0 ||
1991       (err = b64->ops->code(b64, 0, 0, &d)) != 0)
1992     a_fail(a, "bad-base64", "%s", codec_strerror(err), A_END);
1993   else {
1994     buf_init(&b, d.buf, d.len);
1995     if (c_check(&b) || BBAD(&b) || BLEFT(&b))
1996       a_fail(a, "invalid-challenge", A_END);
1997     else
1998       a_ok(a);
1999   }
2000   b64->ops->destroy(b64);
2001   dstr_destroy(&d);
2002 }
2003
2004 static void acmd_greet(admin *a, unsigned ac, char *av[])
2005 {
2006   peer *p;
2007   int err;
2008   codec *b64;
2009   dstr d = DSTR_INIT;
2010
2011   if ((p = a_findpeer(a, av[0])) == 0) return;
2012   b64 = base64_class.decoder(CDCF_NOEQPAD);
2013   if ((err = b64->ops->code(b64, av[1], strlen(av[1]), &d)) != 0 ||
2014       (err = b64->ops->code(b64, 0, 0, &d)) != 0)
2015     a_fail(a, "bad-base64", "%s", codec_strerror(err), A_END);
2016   else {
2017     p_greet(p, d.buf, d.len);
2018     a_ok(a);
2019   }
2020   b64->ops->destroy(b64);
2021   dstr_destroy(&d);
2022 }
2023
2024 static void acmd_addr(admin *a, unsigned ac, char *av[])
2025 {
2026   peer *p;
2027   const addr *ad;
2028
2029   if ((p = a_findpeer(a, av[0])) != 0) {
2030     ad = p_addr(p);
2031     a_info(a, "?ADDR", ad, A_END);
2032     a_ok(a);
2033   }
2034 }
2035
2036 static void acmd_peerinfo(admin *a, unsigned ac, char *av[])
2037 {
2038   peer *p;
2039   const peerspec *ps;
2040   const char *ptag;
2041
2042   if ((p = a_findpeer(a, av[0])) != 0) {
2043     ps = p_spec(p);
2044     a_info(a, "tunnel=%s", ps->tops->name, A_END);
2045     a_info(a, "key=%s", p_tag(p),
2046            "current-key=%s", p->kx.kpub->tag, A_END);
2047     if ((ptag = p_privtag(p)) == 0) ptag = "(default)";
2048     a_info(a, "private-key=%s", ptag,
2049            "current-private-key=%s", p->kx.kpriv->tag, A_END);
2050     a_info(a, "keepalive=%lu", ps->t_ka, A_END);
2051     a_info(a, "corked=%s", BOOL(p->kx.f&KXF_CORK),
2052            "mobile=%s", BOOL(ps->f&PSF_MOBILE),
2053            A_END);
2054     a_ok(a);
2055   }
2056 }
2057
2058 static void acmd_servinfo(admin *a, unsigned ac, char *av[])
2059 {
2060   a_info(a, "implementation=edgeware-tripe", A_END);
2061   a_info(a, "version=%s", VERSION, A_END);
2062   a_info(a, "daemon=%s", BOOL(flags & F_DAEMON), A_END);
2063   a_ok(a);
2064 }
2065
2066 static void acmd_stats(admin *a, unsigned ac, char *av[])
2067 {
2068   peer *p;
2069   stats *st;
2070
2071   if ((p = a_findpeer(a, av[0])) == 0)
2072     return;
2073
2074   st = p_stats(p);
2075   a_info(a, "start-time=%s", timestr(st->t_start), A_END);
2076   a_info(a, "last-packet-time=%s", timestr(st->t_last), A_END);
2077   a_info(a, "last-keyexch-time=%s", timestr(st->t_kx), A_END);
2078   a_info(a, "packets-in=%lu", st->n_in, "bytes-in=%lu", st->sz_in, A_END);
2079   a_info(a,
2080          "packets-out=%lu", st->n_out,
2081          "bytes-out=%lu", st->sz_out,
2082          A_END);
2083   a_info(a,
2084          "keyexch-packets-in=%lu", st->n_kxin,
2085          "keyexch-bytes-in=%lu", st->sz_kxin,
2086          A_END);
2087   a_info(a,
2088          "keyexch-packets-out=%lu", st->n_kxout,
2089          "keyexch-bytes-out=%lu", st->sz_kxout,
2090          A_END);
2091   a_info(a,
2092          "ip-packets-in=%lu", st->n_ipin,
2093          "ip-bytes-in=%lu", st->sz_ipin,
2094          A_END);
2095   a_info(a,
2096          "ip-packets-out=%lu", st->n_ipout,
2097          "ip-bytes-out=%lu", st->sz_ipout,
2098          A_END);
2099   a_info(a, "rejected-packets=%lu", st->n_reject, A_END);
2100   a_ok(a);
2101 }
2102
2103 static void acmd_kill(admin *a, unsigned ac, char *av[])
2104 {
2105   peer *p;
2106
2107   if ((p = a_findpeer(a, av[0])) != 0) {
2108     p_destroy(p);
2109     a_ok(a);
2110   }
2111 }
2112
2113 static void acmd_forcekx(admin *a, unsigned ac, char *av[])
2114 {
2115   peer *p;
2116
2117   if ((p = a_findpeer(a, av[0])) != 0) {
2118     kx_start(&p->kx, 1);
2119     a_ok(a);
2120   }
2121 }
2122
2123 static void acmd_reload(admin *a, unsigned ac, char *av[])
2124   { p_keyreload(); a_ok(a); }
2125
2126 static void acmd_quit(admin *a, unsigned ac, char *av[])
2127 {
2128   a_warn("SERVER", "quit", "admin-request", A_END);
2129   a_ok(a);
2130   a_quit();
2131 }
2132
2133 static void acmd_version(admin *a, unsigned ac, char *av[])
2134 {
2135   a_info(a, "%s", PACKAGE, "%s", VERSION, A_END);
2136   a_ok(a);
2137 }
2138
2139 static void acmd_tunnels(admin *a, unsigned ac, char *av[])
2140 {
2141   int i;
2142
2143   for (i = 0; tunnels[i]; i++)
2144     a_info(a, "%s", tunnels[i]->name, A_END);
2145   a_ok(a);
2146 }
2147
2148 /* --- The command table and help --- */
2149
2150 typedef struct acmd {
2151   const char *name;
2152   const char *help;
2153   unsigned argmin, argmax;
2154   void (*func)(admin */*a*/, unsigned /*ac*/, char */*av*/[]);
2155 } acmd;
2156
2157 static void acmd_help(admin */*a*/, unsigned /*ac*/, char */*av*/[]);
2158
2159 static const acmd acmdtab[] = {
2160   { "add",      "[OPTIONS] PEER ADDR ...", 2,   0xffff, acmd_add },
2161   { "addr",     "PEER",                 1,      1,      acmd_addr },
2162   { "algs",     "[PEER]",               0,      1,      acmd_algs },
2163   { "bgcancel", "TAG",                  1,      1,      acmd_bgcancel },
2164   { "checkchal", "CHAL",                1,      1,      acmd_checkchal },
2165   { "daemon",   0,                      0,      0,      acmd_daemon },
2166   { "eping",    "[OPTIONS] PEER",       1,      0xffff, acmd_eping },
2167   { "forcekx",  "PEER",                 1,      1,      acmd_forcekx },
2168   { "getchal",  0,                      0,      0,      acmd_getchal },
2169   { "greet",    "PEER CHAL",            2,      2,      acmd_greet },
2170   { "help",     0,                      0,      0,      acmd_help },
2171   { "ifname",   "PEER",                 1,      1,      acmd_ifname },
2172   { "jobs",     0,                      0,      0,      acmd_jobs },
2173   { "kill",     "PEER",                 1,      1,      acmd_kill },
2174   { "list",     0,                      0,      0,      acmd_list },
2175   { "notify",   "MESSAGE ...",          1,      0xffff, acmd_notify },
2176   { "peerinfo", "PEER",                 1,      1,      acmd_peerinfo },
2177   { "ping",     "[OPTIONS] PEER",       1,      0xffff, acmd_ping },
2178   { "port",     "[FAMILY]",             0,      1,      acmd_port },
2179   { "quit",     0,                      0,      0,      acmd_quit },
2180   { "reload",   0,                      0,      0,      acmd_reload },
2181   { "servinfo", 0,                      0,      0,      acmd_servinfo },
2182   { "setifname", "PEER NEW-NAME",       2,      2,      acmd_setifname },
2183   { "stats",    "PEER",                 1,      1,      acmd_stats },
2184   { "svcclaim", "SERVICE VERSION",      2,      2,      acmd_svcclaim },
2185   { "svcensure", "SERVICE [VERSION]",   1,      2,      acmd_svcensure },
2186   { "svcfail",  "JOBID TOKENS...",      1,      0xffff, acmd_svcfail },
2187   { "svcinfo",  "JOBID TOKENS...",      1,      0xffff, acmd_svcinfo },
2188   { "svclist",  0,                      0,      0,      acmd_svclist },
2189   { "svcok",    "JOBID",                1,      1,      acmd_svcok },
2190   { "svcquery", "SERVICE",              1,      1,      acmd_svcquery },
2191   { "svcrelease", "SERVICE",            1,      1,      acmd_svcrelease },
2192   { "svcsubmit", "[OPTIONS] SERVICE TOKENS...",
2193                                         2,      0xffff, acmd_svcsubmit },
2194 #ifndef NTRACE
2195   { "trace",    "[OPTIONS]",            0,      1,      acmd_trace },
2196 #endif
2197   { "tunnels",  0,                      0,      0,      acmd_tunnels },
2198   { "version",  0,                      0,      0,      acmd_version },
2199   { "warn",     "MESSAGE ...",          1,      0xffff, acmd_warn },
2200   { "watch",    "[OPTIONS]",            0,      1,      acmd_watch },
2201   { 0,          0,                      0,      0,      0 }
2202 };
2203
2204 static void acmd_help(admin *a, unsigned ac, char *av[])
2205 {
2206   const acmd *c;
2207
2208   for (c = acmdtab; c->name; c++) {
2209     if (c->help)
2210       a_info(a, "%s", c->name, "*%s", c->help, A_END);
2211     else
2212       a_info(a, "%s", c->name, A_END);
2213   }
2214   a_ok(a);
2215 }
2216
2217 /*----- Connection handling -----------------------------------------------*/
2218
2219 /* --- @a_destroypending@ --- *
2220  *
2221  * Arguments:   ---
2222  *
2223  * Returns:     ---
2224  *
2225  * Use:         Destroys pending admin connections at a safe time.
2226  */
2227
2228 static void a_destroypending(void)
2229 {
2230   admin *a, *aa, *head;
2231   admin_bgop *bg, *bbg;
2232   admin_service *svc, *ssvc;
2233
2234   /* --- Destroy connections marked as pending --- *
2235    *
2236    * Slightly messy.  Killing clients may cause others to finally die.  Make
2237    * sure that they can be put on the list without clobbering anything or
2238    * getting lost.
2239    */
2240
2241   while (a_dead) {
2242     head = a_dead;
2243     a_dead = 0;
2244     for (a = head; a; a = aa) {
2245       aa = a->next;
2246       assert(a->f & AF_DEAD);
2247
2248       /* --- Report what we're doing --- */
2249
2250       T( trace(T_ADMIN, "admin: completing destruction of connection %u",
2251                a->seq); )
2252
2253       /* --- If this is the foreground client then shut down --- */
2254
2255       if (a->f & AF_FOREGROUND) {
2256         T( trace(T_ADMIN, "admin: foreground client quit: shutting down"); )
2257         a_warn("SERVER", "quit", "foreground-eof", A_END);
2258         a_quit();
2259       }
2260
2261       /* --- Abort any background jobs in progress --- */
2262
2263       for (bg = a->bg; bg; bg = bbg) {
2264         bbg = bg->next;
2265         bg->cancel(bg);
2266         if (bg->tag) xfree(bg->tag);
2267         xfree(bg);
2268       }
2269
2270       /* --- Release services I hold, and abort pending jobs --- */
2271
2272       for (svc = a->svcs; svc; svc = ssvc) {
2273         ssvc = svc->next;
2274         a_svcrelease(svc);
2275       }
2276       a_jobtablefinal(&a->j);
2277
2278       /* --- Close file descriptors and selectory --- */
2279
2280       selbuf_destroy(&a->b);
2281       if (a->b.reader.fd != a->w.fd) close(a->b.reader.fd);
2282       close(a->w.fd);
2283       if (a_stdin == a) a_stdin = 0;
2284
2285       /* --- Done --- */
2286
2287       DESTROY(a);
2288     }
2289   }
2290 }
2291
2292 /* --- @a_destroy@ --- *
2293  *
2294  * Arguments:   @admin *a@ = pointer to an admin block
2295  *
2296  * Returns:     ---
2297  *
2298  * Use:         Destroys an admin block.  This requires a certain amount of
2299  *              care.
2300  */
2301
2302 static void freequeue(oqueue *q)
2303 {
2304   obuf *o, *oo;
2305
2306   for (o = q->hd; o; o = oo) {
2307     oo = o->next;
2308     xfree(o);
2309   }
2310   q->hd = q->tl = 0;
2311 }
2312
2313 static void a_destroy(admin *a)
2314 {
2315   if (a->f & AF_DEAD)
2316     return;
2317
2318   if (a->next) a->next->prev = a->prev;
2319   if (a->prev) a->prev->next = a->next;
2320   else admins = a->next;
2321
2322   if (a->out.hd) sel_rmfile(&a->w);
2323   freequeue(&a->out);
2324
2325   a->f |= AF_DEAD;
2326   a->next = a_dead;
2327   a_dead = a;
2328
2329   T( trace(T_ADMIN, "admin: killing connection %u", a->seq); )
2330 }
2331
2332 /* --- @a_line@ --- *
2333  *
2334  * Arguments:   @char *p@ = pointer to the line read
2335  *              @size_t len@ = length of the line
2336  *              @void *vp@ = pointer to my admin block
2337  *
2338  * Returns:     ---
2339  *
2340  * Use:         Handles a line of input.
2341  */
2342
2343 static void a_line(char *p, size_t len, void *vp)
2344 {
2345   admin *a = vp;
2346   const acmd *c;
2347   char *av[16 + 1];
2348   size_t ac;
2349
2350   QUICKRAND;
2351   if (a->f & AF_DEAD)
2352     return;
2353   if (!p) {
2354     if (!a->bg)
2355       a_destroy(a);
2356     else {
2357       a->f |= AF_CLOSE;
2358       selbuf_disable(&a->b);
2359     }
2360     return;
2361   }
2362   ac = str_qsplit(p, av, N(av) - 1, 0, STRF_QUOTE);
2363   if (!ac)
2364     return;
2365   av[ac] = 0;
2366   for (c = acmdtab; c->name; c++) {
2367     if (mystrieq(av[0], c->name)) {
2368       ac--;
2369       if (c->argmin > ac || ac > c->argmax) {
2370         if (!c->help)
2371           a_fail(a, "bad-syntax", "%s", c->name, "", A_END);
2372         else
2373           a_fail(a, "bad-syntax", "%s", c->name, "%s", c->help, A_END);
2374       } else
2375         c->func(a, ac, av + 1);
2376       return;
2377     }
2378   }
2379   a_fail(a, "unknown-command", "%s", av[0], A_END);
2380 }
2381
2382 /* --- @a_create@ --- *
2383  *
2384  * Arguments:   @int fd_in, fd_out@ = file descriptors to use
2385  *              @unsigned f@ = initial flags to set
2386  *
2387  * Returns:     ---
2388  *
2389  * Use:         Creates a new admin connection.
2390  */
2391
2392 void a_create(int fd_in, int fd_out, unsigned f)
2393 {
2394   admin *a = CREATE(admin);
2395
2396   T( static unsigned seq = 0;
2397      a->seq = seq++; )
2398   T( trace(T_ADMIN, "admin: accepted connection %u", a->seq); )
2399   a->bg = 0;
2400   a->ref = 0;
2401   a->svcs = 0;
2402   a_jobtableinit(&a->j);
2403   a->f = f;
2404   if (fd_in == STDIN_FILENO) a_stdin = a;
2405   fdflags(fd_in, O_NONBLOCK, O_NONBLOCK, FD_CLOEXEC, FD_CLOEXEC);
2406   if (fd_out != fd_in)
2407     fdflags(fd_out, O_NONBLOCK, O_NONBLOCK, FD_CLOEXEC, FD_CLOEXEC);
2408   selbuf_init(&a->b, &sel, fd_in, a_line, a);
2409   sel_initfile(&sel, &a->w, fd_out, SEL_WRITE, a_flush, a);
2410   a->out.hd = a->out.tl = 0;
2411   a->next = admins;
2412   a->prev = 0;
2413   if (admins) admins->prev = a;
2414   admins = a;
2415 }
2416
2417 /* --- @a_accept@ --- *
2418  *
2419  * Arguments:   @int fd@ = file descriptor to accept
2420  *              @unsigned mode@ = what to do
2421  *              @void *v@ = uninteresting pointer
2422  *
2423  * Returns:     ---
2424  *
2425  * Use:         Accepts a new admin connection.
2426  */
2427
2428 static void a_accept(int fd, unsigned mode, void *v)
2429 {
2430   int nfd;
2431   struct sockaddr_un sun;
2432   socklen_t sz = sizeof(sun);
2433
2434   if ((nfd = accept(fd, (struct sockaddr *)&sun, &sz)) < 0) {
2435     if (errno != EINTR && errno != EAGAIN && errno != EWOULDBLOCK &&
2436         errno != ECONNABORTED && errno != EPROTO)
2437       a_warn("ADMIN", "accept-error", "?ERRNO", A_END);
2438     return;
2439   }
2440   a_create(nfd, nfd, 0);
2441 }
2442
2443 /* --- @a_preselect@ --- *
2444  *
2445  * Arguments:   ---
2446  *
2447  * Returns:     ---
2448  *
2449  * Use:         Informs the admin module that we're about to select again,
2450  *              and that it should do cleanup things it has delayed until a
2451  *              `safe' time.
2452  */
2453
2454 void a_preselect(void) { if (a_dead) a_destroypending(); }
2455
2456 /* --- @a_daemon@ --- *
2457  *
2458  * Arguments:   ---
2459  *
2460  * Returns:     ---
2461  *
2462  * Use:         Informs the admin module that it's a daemon.
2463  */
2464
2465 void a_daemon(void) { flags |= F_DAEMON; }
2466
2467 /* --- @a_init@ --- *
2468  *
2469  * Arguments:   @const char *name@ = socket name to create
2470  *              @uid_t u@ = user to own the socket
2471  *              @gid_t g@ = group to own the socket
2472  *              @mode_t m@ = permissions to set on the socket
2473  *
2474  * Returns:     ---
2475  *
2476  * Use:         Creates the admin listening socket.
2477  */
2478
2479 void a_init(const char *name, uid_t u, gid_t g, mode_t m)
2480 {
2481   int fd;
2482   int n = 5;
2483   struct sockaddr_un sun;
2484   struct sigaction sa;
2485   size_t sz;
2486   mode_t omask;
2487 #ifdef HAVE_LIBADNS
2488   int err;
2489 #endif
2490
2491   /* --- Create services table --- */
2492
2493   sym_create(&a_svcs);
2494
2495   /* --- Set up the socket address --- */
2496
2497   sz = strlen(name) + 1;
2498   if (sz > sizeof(sun.sun_path))
2499     die(EXIT_FAILURE, "socket name `%s' too long", name);
2500   BURN(sun);
2501   sun.sun_family = AF_UNIX;
2502   memcpy(sun.sun_path, name, sz);
2503   sz += offsetof(struct sockaddr_un, sun_path);
2504
2505   /* --- Attempt to bind to the socket --- */
2506
2507   omask = umask(0077);
2508 again:
2509   if ((fd = socket(PF_UNIX, SOCK_STREAM, 0)) < 0)
2510     die(EXIT_FAILURE, "couldn't create socket: %s", strerror(errno));
2511   if (bind(fd, (struct sockaddr *)&sun, sz) < 0) {
2512     struct stat st;
2513     int e = errno;
2514     if (errno != EADDRINUSE) {
2515       die(EXIT_FAILURE, "couldn't bind to address `%s': %s",
2516           sun.sun_path, strerror(e));
2517     }
2518     if (!n)
2519       die(EXIT_FAILURE, "too many retries; giving up");
2520     n--;
2521     if (!connect(fd, (struct sockaddr *)&sun, sz)) {
2522       die(EXIT_FAILURE, "server already listening on admin socket `%s'",
2523           sun.sun_path);
2524     }
2525     if (errno != ECONNREFUSED)
2526       die(EXIT_FAILURE, "couldn't bind to address: %s", strerror(e));
2527     if (stat(sun.sun_path, &st)) {
2528       die(EXIT_FAILURE, "couldn't stat `%s': %s",
2529           sun.sun_path, strerror(errno));
2530     }
2531     if (!S_ISSOCK(st.st_mode))
2532       die(EXIT_FAILURE, "object `%s' isn't a socket", sun.sun_path);
2533     T( trace(T_ADMIN, "admin: stale socket found; removing it"); )
2534     unlink(sun.sun_path);
2535     close(fd);
2536     goto again;
2537   }
2538   if (chown(sun.sun_path, u, g)) {
2539     die(EXIT_FAILURE, "failed to set socket owner: %s",
2540         strerror(errno));
2541   }
2542   if (chmod(sun.sun_path, m)) {
2543     die(EXIT_FAILURE, "failed to set socket permissions: %s",
2544         strerror(errno));
2545   }
2546   umask(omask);
2547   fdflags(fd, O_NONBLOCK, O_NONBLOCK, FD_CLOEXEC, FD_CLOEXEC);
2548   if (listen(fd, 5))
2549     die(EXIT_FAILURE, "couldn't listen on socket: %s", strerror(errno));
2550
2551   /* --- Listen to the socket --- */
2552
2553   sel_initfile(&sel, &sock, fd, SEL_READ, a_accept, 0);
2554   sel_addfile(&sock);
2555   sockname = name;
2556 #ifdef HAVE_LIBADNS
2557   if ((err = adns_init(&ads,
2558                        (adns_if_permit_ipv4 | adns_if_permit_ipv6 |
2559                         adns_if_noserverwarn | adns_if_nosigpipe |
2560                         adns_if_noautosys),
2561                        0)) != 0)
2562     die(EXIT_FAILURE, "failed to initialize ADNS: %s", strerror(errno));
2563   sel_addhook(&sel, &hook, before_select, after_select, 0);
2564 #else
2565   bres_init(&sel);
2566 #endif
2567   T( trace_custom(a_trace, 0);
2568      trace(T_ADMIN, "admin: enabled custom tracing"); )
2569   flags |= F_INIT;
2570
2571   /* --- Set up signal handlers --- */
2572
2573   sig_add(&s_term, SIGTERM, a_sigdie, 0);
2574   sig_add(&s_hup, SIGHUP, a_sighup, 0);
2575   sigaction(SIGINT, 0, &sa);
2576   if (sa.sa_handler != SIG_IGN)
2577     sig_add(&s_int, SIGINT, a_sigdie, 0);
2578 }
2579
2580 /*----- That's all, folks -------------------------------------------------*/