chiark - git - mdw - tripe/blob - server/admin.c

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