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

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