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