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