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

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