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