src/util/service.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2009 Christian Grothoff (and other contributing authors)
   4
   5      GNUnet is free software; you can redistribute it and/or modify
   6      it under the terms of the GNU General Public License as published
   7      by the Free Software Foundation; either version 2, or (at your
   8      option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      General Public License for more details.
  14
  15      You should have received a copy of the GNU General Public License
  16      along with GNUnet; see the file COPYING.  If not, write to the
  17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18      Boston, MA 02111-1307, USA.
  19 */
  20
  21 /**
  22  * @file util/service.c
  23  * @brief functions related to starting services
  24  * @author Christian Grothoff
  25  */
  26 #include "platform.h"
  27 #include "gnunet_common.h"
  28 #include "gnunet_configuration_lib.h"
  29 #include "gnunet_crypto_lib.h"
  30 #include "gnunet_directories.h"
  31 #include "gnunet_disk_lib.h"
  32 #include "gnunet_getopt_lib.h"
  33 #include "gnunet_os_lib.h"
  34 #include "gnunet_protocols.h"
  35 #include "gnunet_server_lib.h"
  36 #include "gnunet_service_lib.h"
  37
  38 #define DEBUG_SERVICE GNUNET_NO
  39
  40 /* ******************* access control ******************** */
  41
  42 /**
  43  * @brief IPV4 network in CIDR notation.
  44  */
  45 struct IPv4NetworkSet
  46 {
  47   struct in_addr network;
  48   struct in_addr netmask;
  49 };
  50
  51 /**
  52  * @brief network in CIDR notation for IPV6.
  53  */
  54 struct IPv6NetworkSet
  55 {
  56   struct in6_addr network;
  57   struct in6_addr netmask;
  58 };
  59
  60
  61 /**
  62  * Parse a network specification. The argument specifies
  63  * a list of networks. The format is
  64  * <tt>[network/netmask;]*</tt> (no whitespace, must be terminated
  65  * with a semicolon). The network must be given in dotted-decimal
  66  * notation. The netmask can be given in CIDR notation (/16) or
  67  * in dotted-decimal (/255.255.0.0).
  68  * <p>
  69  * @param routeList a string specifying the forbidden networks
  70  * @return the converted list, NULL if the synatx is flawed
  71  */
  72 static struct IPv4NetworkSet *
  73 parse_ipv4_specification (const char *routeList)
  74 {
  75   unsigned int count;
  76   unsigned int i;
  77   unsigned int j;
  78   unsigned int len;
  79   int cnt;
  80   unsigned int pos;
  81   unsigned int temps[8];
  82   int slash;
  83   struct IPv4NetworkSet *result;
  84
  85   if (routeList == NULL)
  86     return NULL;
  87   len = strlen (routeList);
  88   if (len == 0)
  89     return NULL;
  90   count = 0;
  91   for (i = 0; i < len; i++)
  92     if (routeList[i] == ';')
  93       count++;
  94   result = GNUNET_malloc (sizeof (struct IPv4NetworkSet) * (count + 1));
  95   /* add termination */
  96   memset (result, 0, sizeof (struct IPv4NetworkSet) * (count + 1));
  97   i = 0;
  98   pos = 0;
  99   while (i < count)
 100     {
 101       cnt = sscanf (&routeList[pos],
 102                     "%u.%u.%u.%u/%u.%u.%u.%u;",
 103                     &temps[0],
 104                     &temps[1],
 105                     &temps[2],
 106                     &temps[3], &temps[4], &temps[5], &temps[6], &temps[7]);
 107       if (cnt == 8)
 108         {
 109           for (j = 0; j < 8; j++)
 110             if (temps[j] > 0xFF)
 111               {
 112                 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 113                             _("Invalid format for IP: `%s'\n"),
 114                             &routeList[pos]);
 115                 GNUNET_free (result);
 116                 return NULL;
 117               }
 118           result[i].network.s_addr
 119             =
 120             htonl ((temps[0] << 24) + (temps[1] << 16) + (temps[2] << 8) +
 121                    temps[3]);
 122           result[i].netmask.s_addr =
 123             htonl ((temps[4] << 24) + (temps[5] << 16) + (temps[6] << 8) +
 124                    temps[7]);
 125           while (routeList[pos] != ';')
 126             pos++;
 127           pos++;
 128           i++;
 129           continue;
 130         }
 131       /* try second notation */
 132       cnt = sscanf (&routeList[pos],
 133                     "%u.%u.%u.%u/%u;",
 134                     &temps[0], &temps[1], &temps[2], &temps[3], &slash);
 135       if (cnt == 5)
 136         {
 137           for (j = 0; j < 4; j++)
 138             if (temps[j] > 0xFF)
 139               {
 140                 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 141                             _("Invalid format for IP: `%s'\n"),
 142                             &routeList[pos]);
 143                 GNUNET_free (result);
 144                 return NULL;
 145               }
 146           result[i].network.s_addr
 147             =
 148             htonl ((temps[0] << 24) + (temps[1] << 16) + (temps[2] << 8) +
 149                    temps[3]);
 150           if ((slash <= 32) && (slash >= 0))
 151             {
 152               result[i].netmask.s_addr = 0;
 153               while (slash > 0)
 154                 {
 155                   result[i].netmask.s_addr
 156                     = (result[i].netmask.s_addr >> 1) + 0x80000000;
 157                   slash--;
 158                 }
 159               result[i].netmask.s_addr = htonl (result[i].netmask.s_addr);
 160               while (routeList[pos] != ';')
 161                 pos++;
 162               pos++;
 163               i++;
 164               continue;
 165             }
 166           else
 167             {
 168               GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 169                           _
 170                           ("Invalid network notation ('/%d' is not legal in IPv4 CIDR)."),
 171                           slash);
 172               GNUNET_free (result);
 173               return NULL;      /* error */
 174             }
 175         }
 176       /* try third notation */
 177       slash = 32;
 178       cnt = sscanf (&routeList[pos],
 179                     "%u.%u.%u.%u;",
 180                     &temps[0], &temps[1], &temps[2], &temps[3]);
 181       if (cnt == 4)
 182         {
 183           for (j = 0; j < 4; j++)
 184             if (temps[j] > 0xFF)
 185               {
 186                 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 187                             _("Invalid format for IP: `%s'\n"),
 188                             &routeList[pos]);
 189                 GNUNET_free (result);
 190                 return NULL;
 191               }
 192           result[i].network.s_addr
 193             =
 194             htonl ((temps[0] << 24) + (temps[1] << 16) + (temps[2] << 8) +
 195                    temps[3]);
 196           result[i].netmask.s_addr = 0;
 197           while (slash > 0)
 198             {
 199               result[i].netmask.s_addr
 200                 = (result[i].netmask.s_addr >> 1) + 0x80000000;
 201               slash--;
 202             }
 203           result[i].netmask.s_addr = htonl (result[i].netmask.s_addr);
 204           while (routeList[pos] != ';')
 205             pos++;
 206           pos++;
 207           i++;
 208           continue;
 209         }
 210       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 211                   _("Invalid format for IP: `%s'\n"), &routeList[pos]);
 212       GNUNET_free (result);
 213       return NULL;              /* error */
 214     }
 215   if (pos < strlen (routeList))
 216     {
 217       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 218                   _("Invalid format for IP: `%s'\n"), &routeList[pos]);
 219       GNUNET_free (result);
 220       return NULL;              /* oops */
 221     }
 222   return result;                /* ok */
 223 }
 224
 225
 226 /**
 227  * Parse a network specification. The argument specifies
 228  * a list of networks. The format is
 229  * <tt>[network/netmask;]*</tt> (no whitespace, must be terminated
 230  * with a semicolon). The network must be given in colon-hex
 231  * notation.  The netmask must be given in CIDR notation (/16) or
 232  * can be omitted to specify a single host.
 233  * <p>
 234  * @param routeListX a string specifying the forbidden networks
 235  * @return the converted list, NULL if the synatx is flawed
 236  */
 237 static struct IPv6NetworkSet *
 238 parse_ipv6_specification (const char *routeListX)
 239 {
 240   unsigned int count;
 241   unsigned int i;
 242   unsigned int len;
 243   unsigned int pos;
 244   int start;
 245   int slash;
 246   int ret;
 247   char *routeList;
 248   struct IPv6NetworkSet *result;
 249   unsigned int bits;
 250   unsigned int off;
 251   int save;
 252
 253   if (routeListX == NULL)
 254     return NULL;
 255   len = strlen (routeListX);
 256   if (len == 0)
 257     return NULL;
 258   routeList = GNUNET_strdup (routeListX);
 259   count = 0;
 260   for (i = 0; i < len; i++)
 261     if (routeList[i] == ';')
 262       count++;
 263   if (routeList[len - 1] != ';')
 264     {
 265       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 266                   _
 267                   ("Invalid network notation (does not end with ';': `%s')\n"),
 268                   routeList);
 269       GNUNET_free (routeList);
 270       return NULL;
 271     }
 272
 273   result = GNUNET_malloc (sizeof (struct IPv6NetworkSet) * (count + 1));
 274   memset (result, 0, sizeof (struct IPv6NetworkSet) * (count + 1));
 275   i = 0;
 276   pos = 0;
 277   while (i < count)
 278     {
 279       start = pos;
 280       while (routeList[pos] != ';')
 281         pos++;
 282       slash = pos;
 283       while ((slash >= start) && (routeList[slash] != '/'))
 284         slash--;
 285       if (slash < start)
 286         {
 287           memset (&result[i].netmask, 0xFF, sizeof (struct in6_addr));
 288           slash = pos;
 289         }
 290       else
 291         {
 292           routeList[pos] = '\0';
 293           ret = inet_pton (AF_INET6,
 294                            &routeList[slash + 1], &result[i].netmask);
 295           if (ret <= 0)
 296             {
 297               save = errno;
 298               if ((1 != SSCANF (&routeList[slash + 1],
 299                                 "%u", &bits)) || (bits >= 128))
 300                 {
 301                   if (ret == 0)
 302                     GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 303                                 _("Wrong format `%s' for netmask\n"),
 304                                 &routeList[slash + 1]);
 305                   else
 306                     {
 307                       errno = save;
 308                       GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR,
 309                                            "inet_pton");
 310                     }
 311                   GNUNET_free (result);
 312                   GNUNET_free (routeList);
 313                   return NULL;
 314                 }
 315               off = 0;
 316               while (bits > 8)
 317                 {
 318                   result[i].netmask.s6_addr[off++] = 0xFF;
 319                   bits -= 8;
 320                 }
 321               while (bits > 0)
 322                 {
 323                   result[i].netmask.s6_addr[off]
 324                     = (result[i].netmask.s6_addr[off] >> 1) + 0x80;
 325                   bits--;
 326                 }
 327             }
 328         }
 329       routeList[slash] = '\0';
 330       ret = inet_pton (AF_INET6, &routeList[start], &result[i].network);
 331       if (ret <= 0)
 332         {
 333           if (ret == 0)
 334             GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 335                         _("Wrong format `%s' for network\n"),
 336                         &routeList[slash + 1]);
 337           else
 338             GNUNET_log_strerror(GNUNET_ERROR_TYPE_ERROR, "inet_pton");
 339           GNUNET_free (result);
 340           GNUNET_free (routeList);
 341           return NULL;
 342         }
 343       pos++;
 344       i++;
 345     }
 346   GNUNET_free (routeList);
 347   return result;
 348 }
 349
 350
 351 /**
 352  * Check if the given IP address is in the list of IP addresses.
 353  *
 354  * @param list a list of networks
 355  * @param add the IP to check (in network byte order)
 356  * @return GNUNET_NO if the IP is not in the list, GNUNET_YES if it it is
 357  */
 358 static int
 359 check_ipv4_listed (const struct IPv4NetworkSet *list,
 360                    const struct in_addr *add)
 361 {
 362   int i;
 363
 364   i = 0;
 365   if (list == NULL)
 366     return GNUNET_NO;
 367
 368   while ((list[i].network.s_addr != 0) || (list[i].netmask.s_addr != 0))
 369     {
 370       if ((add->s_addr & list[i].netmask.s_addr) ==
 371           (list[i].network.s_addr & list[i].netmask.s_addr))
 372         return GNUNET_YES;
 373       i++;
 374     }
 375   return GNUNET_NO;
 376 }
 377
 378 /**
 379  * Check if the given IP address is in the list of IP addresses.
 380  *
 381  * @param list a list of networks
 382  * @param ip the IP to check (in network byte order)
 383  * @return GNUNET_NO if the IP is not in the list, GNUNET_YES if it it is
 384  */
 385 static int
 386 check_ipv6_listed (const struct IPv6NetworkSet *list,
 387                    const struct in6_addr *ip)
 388 {
 389   unsigned int i;
 390   unsigned int j;
 391   struct in6_addr zero;
 392
 393   if (list == NULL)
 394     return GNUNET_NO;
 395
 396   memset (&zero, 0, sizeof (struct in6_addr));
 397   i = 0;
 398 NEXT:
 399   while (memcmp (&zero, &list[i].network, sizeof (struct in6_addr)) != 0)
 400     {
 401       for (j = 0; j < sizeof (struct in6_addr) / sizeof (int); j++)
 402         if (((((int *) ip)[j] & ((int *) &list[i].netmask)[j])) !=
 403             (((int *) &list[i].network)[j] & ((int *) &list[i].netmask)[j]))
 404           {
 405             i++;
 406             goto NEXT;
 407           }
 408       return GNUNET_YES;
 409     }
 410   return GNUNET_NO;
 411 }
 412
 413
 414 /* ****************** service struct ****************** */
 415
 416
 417 /**
 418  * Context for "service_task".
 419  */
 420 struct GNUNET_SERVICE_Context
 421 {
 422   /**
 423    * Our configuration.
 424    */
 425   const struct GNUNET_CONFIGURATION_Handle *cfg;
 426
 427   /**
 428    * Handle for the server.
 429    */
 430   struct GNUNET_SERVER_Handle *server;
 431
 432   /**
 433    * Scheduler for the server.
 434    */
 435   struct GNUNET_SCHEDULER_Handle *sched;
 436
 437   /**
 438    * NULL-terminated array of addresses to bind to.
 439    */
 440   struct sockaddr **addrs;
 441
 442   /**
 443    * Name of our service.
 444    */
 445   const char *serviceName;
 446
 447   /**
 448    * Main service-specific task to run.
 449    */
 450   GNUNET_SERVICE_Main task;
 451
 452   /**
 453    * Closure for task.
 454    */
 455   void *task_cls;
 456
 457   /**
 458    * IPv4 addresses that are not allowed to connect.
 459    */
 460   struct IPv4NetworkSet *v4_denied;
 461
 462   /**
 463    * IPv6 addresses that are not allowed to connect.
 464    */
 465   struct IPv6NetworkSet *v6_denied;
 466
 467   /**
 468    * IPv4 addresses that are allowed to connect (if not
 469    * set, all are allowed).
 470    */
 471   struct IPv4NetworkSet *v4_allowed;
 472
 473   /**
 474    * IPv6 addresses that are allowed to connect (if not
 475    * set, all are allowed).
 476    */
 477   struct IPv6NetworkSet *v6_allowed;
 478
 479   /**
 480    * My (default) message handlers.  Adjusted copy
 481    * of "defhandlers".
 482    */
 483   struct GNUNET_SERVER_MessageHandler *my_handlers;
 484
 485   /**
 486    * Idle timeout for server.
 487    */
 488   struct GNUNET_TIME_Relative timeout;
 489
 490   /**
 491    * Maximum buffer size for the server.
 492    */
 493   size_t maxbuf;
 494
 495   /**
 496    * Overall success/failure of the service start.
 497    */
 498   int ret;
 499
 500   /**
 501    * If we are daemonizing, this FD is set to the
 502    * pipe to the parent.  Send '.' if we started
 503    * ok, '!' if not.  -1 if we are not daemonizing.
 504    */
 505   int ready_confirm_fd;
 506
 507   /**
 508    * Do we close connections if we receive messages
 509    * for which we have no handler?
 510    */
 511   int require_found;
 512
 513   /**
 514    * Can clients ask us to initiate a shutdown?
 515    */
 516   int allow_shutdown;
 517
 518   /**
 519    * Our options.
 520    */
 521   enum GNUNET_SERVICE_Options options;
 522
 523   /**
 524    * Array of the lengths of the entries in addrs.
 525    */
 526   socklen_t * addrlens;
 527
 528 };
 529
 530
 531 /* ****************** message handlers ****************** */
 532
 533 static size_t
 534 write_test (void *cls, size_t size, void *buf)
 535 {
 536   struct GNUNET_SERVER_Client *client = cls;
 537   struct GNUNET_MessageHeader *msg;
 538
 539   if (size < sizeof (struct GNUNET_MessageHeader))
 540     {
 541       GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 542       return 0;                 /* client disconnected */
 543     }
 544   msg = (struct GNUNET_MessageHeader *) buf;
 545   msg->type = htons (GNUNET_MESSAGE_TYPE_TEST);
 546   msg->size = htons (sizeof (struct GNUNET_MessageHeader));
 547   GNUNET_SERVER_receive_done (client, GNUNET_OK);
 548   return sizeof (struct GNUNET_MessageHeader);
 549 }
 550
 551 /**
 552  * Handler for TEST message.
 553  *
 554  * @param cls closure (refers to service)
 555  * @param client identification of the client
 556  * @param message the actual message
 557  */
 558 static void
 559 handle_test (void *cls,
 560              struct GNUNET_SERVER_Client *client,
 561              const struct GNUNET_MessageHeader *message)
 562 {
 563   /* simply bounce message back to acknowledge */
 564   if (NULL == GNUNET_SERVER_notify_transmit_ready (client,
 565                                                    sizeof (struct
 566                                                            GNUNET_MessageHeader),
 567                                                    GNUNET_TIME_UNIT_FOREVER_REL,
 568                                                    &write_test, client))
 569     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 570 }
 571
 572
 573 /**
 574  * Handler for SHUTDOWN message.
 575  *
 576  * @param cls closure (refers to service)
 577  * @param client identification of the client
 578  * @param message the actual message
 579  */
 580 static void
 581 handle_shutdown (void *cls,
 582                  struct GNUNET_SERVER_Client *client,
 583                  const struct GNUNET_MessageHeader *message)
 584 {
 585   struct GNUNET_SERVICE_Context *service = cls;
 586   if (!service->allow_shutdown)
 587     {
 588       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
 589                   _
 590                   ("Received shutdown request, but configured to ignore!\n"));
 591       GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
 592       return;
 593     }
 594   GNUNET_log (GNUNET_ERROR_TYPE_INFO,
 595               _("Initiating shutdown as requested by client.\n"));
 596   GNUNET_assert (service->sched != NULL);
 597   GNUNET_SCHEDULER_shutdown (service->sched);
 598   GNUNET_SERVER_receive_done (client, GNUNET_OK);
 599 }
 600
 601
 602 /**
 603  * Default handlers for all services.  Will be copied and the
 604  * "callback_cls" fields will be replaced with the specific service
 605  * struct.
 606  */
 607 static const struct GNUNET_SERVER_MessageHandler defhandlers[] = {
 608   {&handle_test, NULL, GNUNET_MESSAGE_TYPE_TEST,
 609    sizeof (struct GNUNET_MessageHeader)},
 610   {&handle_shutdown, NULL, GNUNET_MESSAGE_TYPE_SHUTDOWN,
 611    sizeof (struct GNUNET_MessageHeader)},
 612   {NULL, NULL, 0, 0}
 613 };
 614
 615
 616
 617 /* ****************** service core routines ************** */
 618
 619
 620 /**
 621  * Check if access to the service is allowed from the given address.
 622  */
 623 static int
 624 check_access (void *cls, const struct sockaddr *addr, socklen_t addrlen)
 625 {
 626   struct GNUNET_SERVICE_Context *sctx = cls;
 627   const struct sockaddr_in *i4;
 628   const struct sockaddr_in6 *i6;
 629   int ret;
 630
 631   switch (addr->sa_family)
 632     {
 633     case AF_INET:
 634       GNUNET_assert (addrlen == sizeof (struct sockaddr_in));
 635       i4 = (const struct sockaddr_in *) addr;
 636       ret = ((sctx->v4_allowed == NULL) ||
 637              (check_ipv4_listed (sctx->v4_allowed,
 638                                  &i4->sin_addr)))
 639         && ((sctx->v4_denied == NULL) ||
 640             (!check_ipv4_listed (sctx->v4_denied, &i4->sin_addr)));
 641       break;
 642     case AF_INET6:
 643       GNUNET_assert (addrlen == sizeof (struct sockaddr_in6));
 644       i6 = (const struct sockaddr_in6 *) addr;
 645       ret = ((sctx->v6_allowed == NULL) ||
 646              (check_ipv6_listed (sctx->v6_allowed,
 647                                  &i6->sin6_addr)))
 648         && ((sctx->v6_denied == NULL) ||
 649             (!check_ipv6_listed (sctx->v6_denied, &i6->sin6_addr)));
 650       break;
 651     default:
 652       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
 653                   _("Unknown address family %d\n"), addr->sa_family);
 654       return GNUNET_SYSERR;
 655     }
 656   if (ret != GNUNET_OK)
 657     {
 658       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
 659                   _("Access from `%s' denied to service `%s'\n"),
 660                   GNUNET_a2s (addr, addrlen), sctx->serviceName);
 661     }
 662   return ret;
 663 }
 664
 665
 666 /**
 667  * Get the name of the file where we will
 668  * write the PID of the service.
 669  */
 670 static char *
 671 get_pid_file_name (struct GNUNET_SERVICE_Context *sctx)
 672 {
 673
 674   char *pif;
 675
 676   if (GNUNET_OK !=
 677       GNUNET_CONFIGURATION_get_value_filename (sctx->cfg,
 678                                                sctx->serviceName,
 679                                                "PIDFILE", &pif))
 680     return NULL;
 681   return pif;
 682 }
 683
 684
 685 /**
 686  * Parse an IPv4 access control list.
 687  */
 688 static int
 689 process_acl4 (struct IPv4NetworkSet **ret,
 690               struct GNUNET_SERVICE_Context *sctx, const char *option)
 691 {
 692   char *opt;
 693
 694   if (!GNUNET_CONFIGURATION_have_value (sctx->cfg, sctx->serviceName, option))
 695     return GNUNET_OK;
 696   GNUNET_break (GNUNET_OK ==
 697                 GNUNET_CONFIGURATION_get_value_string (sctx->cfg,
 698                                                        sctx->serviceName,
 699                                                        option, &opt));
 700   if (NULL == (*ret = parse_ipv4_specification (opt)))
 701     {
 702       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
 703                   _
 704                   ("Could not parse IPv4 network specification `%s' for `%s:%s'\n"),
 705                   opt, sctx->serviceName, option);
 706       GNUNET_free (opt);
 707       return GNUNET_SYSERR;
 708     }
 709   GNUNET_free (opt);
 710   return GNUNET_OK;
 711 }
 712
 713
 714 /**
 715  * Parse an IPv4 access control list.
 716  */
 717 static int
 718 process_acl6 (struct IPv6NetworkSet **ret,
 719               struct GNUNET_SERVICE_Context *sctx, const char *option)
 720 {
 721   char *opt;
 722   if (!GNUNET_CONFIGURATION_have_value (sctx->cfg, sctx->serviceName, option))
 723     return GNUNET_OK;
 724   GNUNET_break (GNUNET_OK ==
 725                 GNUNET_CONFIGURATION_get_value_string (sctx->cfg,
 726                                                        sctx->serviceName,
 727                                                        option, &opt));
 728   if (NULL == (*ret = parse_ipv6_specification (opt)))
 729     {
 730       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
 731                   _
 732                   ("Could not parse IPv6 network specification `%s' for `%s:%s'\n"),
 733                   opt, sctx->serviceName, option);
 734       GNUNET_free (opt);
 735       return GNUNET_SYSERR;
 736     }
 737   GNUNET_free (opt);
 738   return GNUNET_OK;
 739 }
 740
 741
 742 /**
 743  * Get the list of addresses that a server for the given service
 744  * should bind to.
 745  *
 746  * @param serviceName name of the service
 747  * @param cfg configuration (which specifies the addresses)
 748  * @param addrs set (call by reference) to an array of pointers to the
 749  *              addresses the server should bind to and listen on; the
 750  *              array will be NULL-terminated (on success)
 751  * @param addr_lens set (call by reference) to an array of the lengths
 752  *              of the respective 'struct sockaddr' struct in the 'addrs'
 753  *              array (on success)
 754  * @return number of addresses found on success,
 755  *              GNUNET_SYSERR if the configuration
 756  *              did not specify reasonable finding information or
 757  *              if it specified a hostname that could not be resolved;
 758  *              GNUNET_NO if the number of addresses configured is
 759  *              zero (in this case, '*addrs' and '*addr_lens' will be
 760  *              set to NULL).
 761  */
 762 int
 763 GNUNET_SERVICE_get_server_addresses (const char *serviceName,
 764                                      const struct GNUNET_CONFIGURATION_Handle *cfg,
 765                                      struct sockaddr ***addrs,
 766                                      socklen_t **addr_lens)
 767 {
 768   int disablev6;
 769   struct GNUNET_NETWORK_Handle *desc;
 770   unsigned long long port;
 771   struct addrinfo hints;
 772   struct addrinfo *res;
 773   struct addrinfo *pos;
 774   struct addrinfo *next;
 775   unsigned int i;
 776   int resi;
 777   int ret;
 778   struct sockaddr **saddrs;
 779   socklen_t *saddrlens;
 780   char *hostname;
 781
 782   *addrs = NULL;
 783   *addr_lens = NULL;
 784   if (GNUNET_CONFIGURATION_have_value (cfg,
 785                                        serviceName, "DISABLEV6"))
 786     {
 787       if (GNUNET_SYSERR ==
 788           (disablev6 = GNUNET_CONFIGURATION_get_value_yesno (cfg,
 789                                                              serviceName,
 790                                                              "DISABLEV6")))
 791         return GNUNET_SYSERR;
 792     }
 793   else
 794     disablev6 = GNUNET_NO;
 795
 796   if (!disablev6)
 797     {
 798       /* probe IPv6 support */
 799       desc = GNUNET_NETWORK_socket_create (PF_INET6, SOCK_STREAM, 0);
 800       if (NULL == desc)
 801         {
 802           if ((errno == ENOBUFS) ||
 803               (errno == ENOMEM) || (errno == ENFILE) || (errno == EACCES))
 804             {
 805               GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "socket");
 806               return GNUNET_SYSERR;
 807             }
 808           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
 809                       _
 810                       ("Disabling IPv6 support for service `%s', failed to create IPv6 socket: %s\n"),
 811                       serviceName, STRERROR (errno));
 812           disablev6 = GNUNET_YES;
 813         }
 814       else
 815         {
 816           GNUNET_break (GNUNET_OK == GNUNET_NETWORK_socket_close (desc));
 817         }
 818     }
 819
 820
 821   if ((GNUNET_OK !=
 822        GNUNET_CONFIGURATION_get_value_number (cfg,
 823                                               serviceName,
 824                                               "PORT",
 825                                               &port)) || (port > 65535))
 826     {
 827       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 828                   _
 829                   ("Require valid port number for service `%s' in configuration!\n"),
 830                   serviceName);
 831       return GNUNET_SYSERR;
 832     }
 833   if (GNUNET_CONFIGURATION_have_value (cfg,
 834                                        serviceName, "BINDTO"))
 835     {
 836       GNUNET_break (GNUNET_OK ==
 837                     GNUNET_CONFIGURATION_get_value_string (cfg,
 838                                                            serviceName,
 839                                                            "BINDTO",
 840                                                            &hostname));
 841     }
 842   else
 843     hostname = NULL;
 844
 845   if (hostname != NULL)
 846     {
 847 #if DEBUG_SERVICE
 848       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
 849                   "Resolving `%s' since that is where `%s' will bind to.\n",
 850                   hostname,
 851                   serviceName);
 852 #endif
 853       memset (&hints, 0, sizeof (struct addrinfo));
 854       if (disablev6)
 855         hints.ai_family = AF_INET;
 856       if ((0 != (ret = getaddrinfo (hostname,
 857                                     NULL, &hints, &res))) || (res == NULL))
 858         {
 859           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 860                       _("Failed to resolve `%s': %s\n"),
 861                       hostname, gai_strerror (ret));
 862           GNUNET_free (hostname);
 863           return GNUNET_SYSERR;
 864         }
 865       next = res;
 866       i = 0;
 867       while (NULL != (pos = next))
 868         {
 869           next = pos->ai_next;
 870           if ( (disablev6) && (pos->ai_family == AF_INET6))
 871             continue;
 872           i++;
 873         }
 874       if (0 == i)
 875         {
 876           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 877                       _("Failed to find %saddress for `%s'.\n"),
 878                       disablev6 ? "IPv4 " : "", hostname);
 879           freeaddrinfo (res);
 880           GNUNET_free (hostname);
 881           return GNUNET_SYSERR;
 882         }
 883       resi = i;
 884       saddrs = GNUNET_malloc ((i+1) * sizeof(struct sockaddr*));
 885       saddrlens = GNUNET_malloc ((i+1) * sizeof (socklen_t));
 886       i = 0;
 887       next = res;
 888       while (NULL != (pos = next))
 889         {
 890           next = pos->ai_next;
 891           if ( (disablev6) && (pos->ai_family == AF_INET6))
 892             continue;
 893 #if DEBUG_SERVICE
 894           GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
 895                       "Service `%s' will bind to `%s'\n",
 896                       serviceName,
 897                       GNUNET_a2s (pos->ai_addr,
 898                                   pos->ai_addrlen));
 899 #endif
 900           if (pos->ai_family == AF_INET)
 901             {
 902               GNUNET_assert (pos->ai_addrlen == sizeof (struct sockaddr_in));
 903               saddrlens[i] = pos->ai_addrlen;
 904               saddrs[i] = GNUNET_malloc (saddrlens[i]);
 905               memcpy (saddrs[i], pos->ai_addr, saddrlens[i]);
 906               ((struct sockaddr_in *) saddrs[i])->sin_port = htons (port);
 907             }
 908           else
 909             {
 910               GNUNET_assert (pos->ai_family == AF_INET6);
 911               GNUNET_assert (pos->ai_addrlen == sizeof (struct sockaddr_in6));
 912               saddrlens[i] = pos->ai_addrlen;
 913               saddrs[i] = GNUNET_malloc (saddrlens[i]);
 914               memcpy (saddrs[i], pos->ai_addr, saddrlens[i]);
 915               ((struct sockaddr_in6 *) saddrs[i])->sin6_port = htons (port);
 916             }
 917           i++;
 918         }
 919       GNUNET_free (hostname);
 920       freeaddrinfo (res);
 921     }
 922   else
 923     {
 924       /* will bind against everything, just set port */
 925       if (disablev6)
 926         {
 927           /* V4-only */
 928           resi = 1;
 929           saddrs = GNUNET_malloc (2 * sizeof(struct sockaddr*));
 930           saddrlens = GNUNET_malloc (2 * sizeof (socklen_t));
 931           saddrlens[0] = sizeof (struct sockaddr_in);
 932           saddrs[0] = GNUNET_malloc (saddrlens[0]);
 933 #if HAVE_SOCKADDR_IN_SIN_LEN
 934           ((struct sockaddr_in *) saddrs[0])->sin_len = saddrlens[0];
 935 #endif
 936           ((struct sockaddr_in *) saddrs[0])->sin_family = AF_INET;
 937           ((struct sockaddr_in *) saddrs[0])->sin_port = htons (port);
 938         }
 939       else
 940         {
 941           /* dual stack */
 942           resi = 2;
 943           saddrs = GNUNET_malloc (3 * sizeof(struct sockaddr*));
 944           saddrlens = GNUNET_malloc (3 * sizeof (socklen_t));
 945
 946           saddrlens[0] = sizeof (struct sockaddr_in6);
 947           saddrs[0] = GNUNET_malloc (saddrlens[0]);
 948 #if HAVE_SOCKADDR_IN_SIN_LEN
 949           ((struct sockaddr_in6 *) saddrs[0])->sin6_len = saddrlens[0];
 950 #endif
 951           ((struct sockaddr_in6 *) saddrs[0])->sin6_family = AF_INET6;
 952           ((struct sockaddr_in6 *) saddrs[0])->sin6_port = htons (port);
 953
 954           saddrlens[1] = sizeof (struct sockaddr_in);
 955           saddrs[1] = GNUNET_malloc (saddrlens[1]);
 956 #if HAVE_SOCKADDR_IN_SIN_LEN
 957           ((struct sockaddr_in *) saddrs[1])->sin_len = saddrlens[1];
 958 #endif
 959           ((struct sockaddr_in *) saddrs[1])->sin_family = AF_INET;
 960           ((struct sockaddr_in *) saddrs[1])->sin_port = htons (port);
 961
 962         }
 963     }
 964   *addrs = saddrs;
 965   *addr_lens = saddrlens;
 966   return resi;
 967 }
 968
 969
 970 /**
 971  * Setup addr, addrlen, maxbuf, idle_timeout
 972  * based on configuration!
 973  *
 974  * Configuration must specify a "PORT".  It may
 975  * specify:
 976  * - TIMEOUT (after how many ms does an inactive service timeout);
 977  * - MAXBUF (maximum incoming message size supported)
 978  * - DISABLEV6 (disable support for IPv6, otherwise we use dual-stack)
 979  * - ALLOW_SHUTDOWN (allow clients to shutdown this service)
 980  * - BINDTO (hostname or IP address to bind to, otherwise we take everything)
 981  * - ACCEPT_FROM  (only allow connections from specified IPv4 subnets)
 982  * - ACCEPT_FROM6 (only allow connections from specified IPv6 subnets)
 983  * - REJECT_FROM  (disallow allow connections from specified IPv4 subnets)
 984  * - REJECT_FROM6 (disallow allow connections from specified IPv6 subnets)
 985  *
 986  * @return GNUNET_OK if configuration succeeded
 987  */
 988 static int
 989 setup_service (struct GNUNET_SERVICE_Context *sctx)
 990 {
 991   unsigned long long maxbuf;
 992   struct GNUNET_TIME_Relative idleout;
 993   int tolerant;
 994
 995   if (GNUNET_CONFIGURATION_have_value (sctx->cfg,
 996                                        sctx->serviceName, "TIMEOUT"))
 997     {
 998       if (GNUNET_OK !=
 999           GNUNET_CONFIGURATION_get_value_time (sctx->cfg,
1000                                                sctx->serviceName,
1001                                                "TIMEOUT", &idleout))
1002         return GNUNET_SYSERR;
1003
1004       sctx->timeout = idleout;
1005     }
1006   else
1007     sctx->timeout = GNUNET_TIME_UNIT_FOREVER_REL;
1008   if (GNUNET_CONFIGURATION_have_value (sctx->cfg,
1009                                        sctx->serviceName, "MAXBUF"))
1010     {
1011       if (GNUNET_OK !=
1012           GNUNET_CONFIGURATION_get_value_number (sctx->cfg,
1013                                                  sctx->serviceName,
1014                                                  "MAXBUF", &maxbuf))
1015         return GNUNET_SYSERR;
1016     }
1017   else
1018     maxbuf = GNUNET_SERVER_MAX_MESSAGE_SIZE;
1019   if (GNUNET_CONFIGURATION_have_value (sctx->cfg,
1020                                        sctx->serviceName, "ALLOW_SHUTDOWN"))
1021     {
1022       if (GNUNET_SYSERR ==
1023           (sctx->allow_shutdown =
1024            GNUNET_CONFIGURATION_get_value_yesno (sctx->cfg, sctx->serviceName,
1025                                                  "ALLOW_SHUTDOWN")))
1026         return GNUNET_SYSERR;
1027     }
1028   else
1029     sctx->allow_shutdown = GNUNET_NO;
1030
1031
1032   if (GNUNET_CONFIGURATION_have_value (sctx->cfg,
1033                                        sctx->serviceName, "TOLERANT"))
1034     {
1035       if (GNUNET_SYSERR ==
1036           (tolerant = GNUNET_CONFIGURATION_get_value_yesno (sctx->cfg,
1037                                                             sctx->serviceName,
1038                                                             "TOLERANT")))
1039         return GNUNET_SYSERR;
1040     }
1041   else
1042     tolerant = GNUNET_NO;
1043
1044   if (GNUNET_SYSERR ==
1045       GNUNET_SERVICE_get_server_addresses (sctx->serviceName,
1046                                            sctx->cfg,
1047                                            &sctx->addrs,
1048                                            &sctx->addrlens))
1049     return GNUNET_SYSERR;
1050   sctx->require_found = tolerant ? GNUNET_NO : GNUNET_YES;
1051   sctx->maxbuf = (size_t) maxbuf;
1052   if (sctx->maxbuf != maxbuf)
1053     {
1054       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1055                   _
1056                   ("Value in configuration for `%s' and service `%s' too large!\n"),
1057                   "MAXBUF", sctx->serviceName);
1058       return GNUNET_SYSERR;
1059     }
1060
1061   process_acl4 (&sctx->v4_denied, sctx, "REJECT_FROM");
1062   process_acl4 (&sctx->v4_allowed, sctx, "ACCEPT_FROM");
1063   process_acl6 (&sctx->v6_denied, sctx, "REJECT_FROM6");
1064   process_acl6 (&sctx->v6_allowed, sctx, "ACCEPT_FROM6");
1065
1066   return GNUNET_OK;
1067 }
1068
1069
1070 /**
1071  * Get the name of the user that'll be used
1072  * to provide the service.
1073  */
1074 static char *
1075 get_user_name (struct GNUNET_SERVICE_Context *sctx)
1076 {
1077
1078   char *un;
1079
1080   if (GNUNET_OK !=
1081       GNUNET_CONFIGURATION_get_value_filename (sctx->cfg,
1082                                                sctx->serviceName,
1083                                                "USERNAME", &un))
1084     return NULL;
1085   return un;
1086 }
1087
1088 /**
1089  * Write PID file.
1090  */
1091 static int
1092 write_pid_file (struct GNUNET_SERVICE_Context *sctx, pid_t pid)
1093 {
1094   FILE *pidfd;
1095   char *pif;
1096   char *user;
1097   char *rdir;
1098   int len;
1099
1100   if (NULL == (pif = get_pid_file_name (sctx)))
1101     return GNUNET_OK;           /* no file desired */
1102   user = get_user_name (sctx);
1103   rdir = GNUNET_strdup (pif);
1104   len = strlen (rdir);
1105   while ((len > 0) && (rdir[len] != DIR_SEPARATOR))
1106     len--;
1107   rdir[len] = '\0';
1108   if (0 != ACCESS (rdir, F_OK))
1109     {
1110       /* we get to create a directory -- and claim it
1111          as ours! */
1112       GNUNET_DISK_directory_create (rdir);
1113       if ((user != NULL) && (0 < strlen (user)))
1114         GNUNET_DISK_file_change_owner (rdir, user);
1115     }
1116   if (0 != ACCESS (rdir, W_OK | X_OK))
1117     {
1118       GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_ERROR, "access", rdir);
1119       GNUNET_free (rdir);
1120       GNUNET_free_non_null (user);
1121       GNUNET_free (pif);
1122       return GNUNET_SYSERR;
1123     }
1124   GNUNET_free (rdir);
1125   pidfd = FOPEN (pif, "w");
1126   if (pidfd == NULL)
1127     {
1128       GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_ERROR, "fopen", pif);
1129       GNUNET_free (pif);
1130       GNUNET_free_non_null (user);
1131       return GNUNET_SYSERR;
1132     }
1133   if (0 > FPRINTF (pidfd, "%u", pid))
1134     GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_WARNING, "fprintf", pif);
1135   GNUNET_break (0 == fclose (pidfd));
1136   if ((user != NULL) && (0 < strlen (user)))
1137     GNUNET_DISK_file_change_owner (pif, user);
1138   GNUNET_free_non_null (user);
1139   GNUNET_free (pif);
1140   return GNUNET_OK;
1141 }
1142
1143
1144 /**
1145  * Task run during shutdown.
1146  *
1147  * @param cls unused
1148  * @param tc unused
1149  */
1150 static void
1151 shutdown_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1152 {
1153   struct GNUNET_SERVER_Handle *server = cls;
1154
1155   GNUNET_SERVER_destroy (server);
1156 }
1157
1158
1159 /**
1160  * Initial task for the service.
1161  */
1162 static void
1163 service_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1164 {
1165   struct GNUNET_SERVICE_Context *sctx = cls;
1166   unsigned int i;
1167
1168   sctx->sched = tc->sched;
1169   sctx->server = GNUNET_SERVER_create (tc->sched,
1170                                        &check_access,
1171                                        sctx,
1172                                        sctx->addrs,
1173                                        sctx->addrlens,
1174                                        sctx->maxbuf,
1175                                        sctx->timeout, sctx->require_found);
1176   if (sctx->server == NULL)
1177     {
1178       i = 0;
1179       while (sctx->addrs[i] != NULL)
1180         {
1181           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1182                       _("Failed to start `%s' at `%s'\n"),
1183                       sctx->serviceName,
1184                       GNUNET_a2s (sctx->addrs[i], sctx->addrlens[i]));
1185           i++;
1186         }
1187       sctx->ret = GNUNET_SYSERR;
1188       return;
1189     }
1190   if (0 == (sctx->options & GNUNET_SERVICE_OPTION_MANUAL_SHUTDOWN))
1191     {
1192       /* install a task that will kill the server
1193          process if the scheduler ever gets a shutdown signal */
1194       GNUNET_SCHEDULER_add_delayed (tc->sched,
1195                                     GNUNET_TIME_UNIT_FOREVER_REL,
1196                                     &shutdown_task, sctx->server);
1197     }
1198   sctx->my_handlers = GNUNET_malloc (sizeof (defhandlers));
1199   memcpy (sctx->my_handlers, defhandlers, sizeof (defhandlers));
1200   i = 0;
1201   while ((sctx->my_handlers[i].callback != NULL))
1202     sctx->my_handlers[i++].callback_cls = sctx;
1203   GNUNET_SERVER_add_handlers (sctx->server, sctx->my_handlers);
1204   if (sctx->ready_confirm_fd != -1)
1205     {
1206       GNUNET_break (1 == WRITE (sctx->ready_confirm_fd, ".", 1));
1207       GNUNET_break (0 == CLOSE (sctx->ready_confirm_fd));
1208       sctx->ready_confirm_fd = -1;
1209       write_pid_file (sctx, getpid ());
1210     }
1211   i = 0;
1212   while (sctx->addrs[i] != NULL)
1213     {
1214       GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1215                   _("Service `%s' runs at %s\n"),
1216                   sctx->serviceName,
1217                   GNUNET_a2s (sctx->addrs[i], sctx->addrlens[i]));
1218       i++;
1219     }
1220   sctx->task (sctx->task_cls, tc->sched, sctx->server, sctx->cfg);
1221 }
1222
1223
1224 /**
1225  * Detach from terminal.
1226  */
1227 static int
1228 detach_terminal (struct GNUNET_SERVICE_Context *sctx)
1229 {
1230 #ifndef MINGW
1231   pid_t pid;
1232   int nullfd;
1233   int filedes[2];
1234
1235   if (0 != PIPE (filedes))
1236     {
1237       GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "pipe");
1238       return GNUNET_SYSERR;
1239     }
1240   pid = fork ();
1241   if (pid < 0)
1242     {
1243       GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "fork");
1244       return GNUNET_SYSERR;
1245     }
1246   if (pid != 0)
1247     {
1248       /* Parent */
1249       char c;
1250
1251       GNUNET_break (0 == CLOSE (filedes[1]));
1252       c = 'X';
1253       if (1 != READ (filedes[0], &c, sizeof (char)))
1254         GNUNET_log_strerror (GNUNET_ERROR_TYPE_WARNING, "read");
1255       fflush (stdout);
1256       switch (c)
1257         {
1258         case '.':
1259           exit (0);
1260         case 'I':
1261           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1262                       _("Service process failed to initialize\n"));
1263           break;
1264         case 'S':
1265           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1266                       _
1267                       ("Service process could not initialize server function\n"));
1268           break;
1269         case 'X':
1270           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1271                       _("Service process failed to report status\n"));
1272           break;
1273         }
1274       exit (1);                 /* child reported error */
1275     }
1276   GNUNET_break (0 == CLOSE (0));
1277   GNUNET_break (0 == CLOSE (1));
1278   GNUNET_break (0 == CLOSE (filedes[0]));
1279   nullfd = OPEN ("/dev/null", O_RDWR | O_APPEND);
1280   if (nullfd < 0)
1281     return GNUNET_SYSERR;
1282   /* set stdin/stdout to /dev/null */
1283   if ((dup2 (nullfd, 0) < 0) || (dup2 (nullfd, 1) < 0))
1284     {
1285       GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "dup2");
1286       return GNUNET_SYSERR;
1287     }
1288   /* Detach from controlling terminal */
1289   pid = setsid ();
1290   if (pid == -1)
1291     GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "setsid");
1292   sctx->ready_confirm_fd = filedes[1];
1293 #else
1294   /* FIXME: we probably need to do something else
1295      elsewhere in order to fork the process itself... */
1296   FreeConsole ();
1297 #endif
1298   return GNUNET_OK;
1299 }
1300
1301
1302 /**
1303  * Set user ID.
1304  */
1305 static int
1306 set_user_id (struct GNUNET_SERVICE_Context *sctx)
1307 {
1308   char *user;
1309
1310   if (NULL == (user = get_user_name (sctx)))
1311     return GNUNET_OK;           /* keep */
1312 #ifndef MINGW
1313   struct passwd *pws;
1314
1315   errno = 0;
1316   pws = getpwnam (user);
1317   if (pws == NULL)
1318     {
1319       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1320                   _("Cannot obtain information about user `%s': %s\n"),
1321                   user, errno == 0 ? _("No such user") : STRERROR (errno));
1322       GNUNET_free (user);
1323       return GNUNET_SYSERR;
1324     }
1325   if ((0 != setgid (pws->pw_gid)) || (0 != setegid (pws->pw_gid)) ||
1326 #if HAVE_INITGROUPS
1327       (0 != initgroups (user, pws->pw_gid)) ||
1328 #endif
1329       (0 != setuid (pws->pw_uid)) || (0 != seteuid (pws->pw_uid)))
1330     {
1331       if ((0 != setregid (pws->pw_gid, pws->pw_gid)) ||
1332           (0 != setreuid (pws->pw_uid, pws->pw_uid)))
1333         {
1334           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1335                       _("Cannot change user/group to `%s': %s\n"), user,
1336                       STRERROR (errno));
1337           GNUNET_free (user);
1338           return GNUNET_SYSERR;
1339         }
1340     }
1341 #endif
1342   GNUNET_free (user);
1343   return GNUNET_OK;
1344 }
1345
1346
1347 /**
1348  * Delete the PID file that was created by our parent.
1349  */
1350 static void
1351 pid_file_delete (struct GNUNET_SERVICE_Context *sctx)
1352 {
1353   char *pif = get_pid_file_name (sctx);
1354   if (pif == NULL)
1355     return;                     /* no PID file */
1356   if (0 != UNLINK (pif))
1357     GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_WARNING, "unlink", pif);
1358   GNUNET_free (pif);
1359 }
1360
1361
1362 /**
1363  * Run a standard GNUnet service startup sequence (initialize loggers
1364  * and configuration, parse options).
1365  *
1366  * @param argc number of command line arguments
1367  * @param argv command line arguments
1368  * @param serviceName our service name
1369  * @param opt service options
1370  * @param task main task of the service
1371  * @param task_cls closure for task
1372  * @return GNUNET_SYSERR on error, GNUNET_OK
1373  *         if we shutdown nicely
1374  */
1375 int
1376 GNUNET_SERVICE_run (int argc,
1377                     char *const *argv,
1378                     const char *serviceName,
1379                     enum GNUNET_SERVICE_Options opt,
1380                     GNUNET_SERVICE_Main task, void *task_cls)
1381 {
1382 #define HANDLE_ERROR do { err = 1; GNUNET_break (0); goto shutdown; } while (0)
1383
1384   int err;
1385   char *cfg_fn;
1386   char *loglev;
1387   char *logfile;
1388   int do_daemonize;
1389   unsigned int i;
1390   struct GNUNET_SERVICE_Context sctx;
1391   struct GNUNET_CONFIGURATION_Handle *cfg;
1392   struct GNUNET_GETOPT_CommandLineOption service_options[] = {
1393     GNUNET_GETOPT_OPTION_CFG_FILE (&cfg_fn),
1394     {'d', "daemonize", NULL,
1395      gettext_noop ("do daemonize (detach from terminal)"), 0,
1396      GNUNET_GETOPT_set_one, &do_daemonize},
1397     GNUNET_GETOPT_OPTION_HELP (serviceName),
1398     GNUNET_GETOPT_OPTION_LOGLEVEL (&loglev),
1399     GNUNET_GETOPT_OPTION_LOGFILE (&logfile),
1400     GNUNET_GETOPT_OPTION_VERSION (PACKAGE_VERSION),
1401     GNUNET_GETOPT_OPTION_END
1402   };
1403   err = 0;
1404   do_daemonize = 0;
1405   logfile = NULL;
1406   loglev = GNUNET_strdup ("WARNING");
1407   cfg_fn = GNUNET_strdup (GNUNET_DEFAULT_USER_CONFIG_FILE);
1408   memset (&sctx, 0, sizeof (sctx));
1409   sctx.options = opt;
1410   sctx.ready_confirm_fd = -1;
1411   sctx.ret = GNUNET_OK;
1412   sctx.timeout = GNUNET_TIME_UNIT_FOREVER_REL;
1413   sctx.maxbuf = GNUNET_SERVER_MAX_MESSAGE_SIZE;
1414   sctx.task = task;
1415   sctx.serviceName = serviceName;
1416   sctx.cfg = cfg = GNUNET_CONFIGURATION_create ();
1417   /* setup subsystems */
1418   if (GNUNET_SYSERR == GNUNET_GETOPT_run (serviceName, service_options, argc,
1419       argv))
1420     HANDLE_ERROR;
1421   if (GNUNET_OK != GNUNET_log_setup (serviceName, loglev, logfile))
1422     HANDLE_ERROR;
1423   if (GNUNET_OK != GNUNET_CONFIGURATION_load (cfg, cfg_fn))
1424     HANDLE_ERROR;
1425   if (GNUNET_OK != setup_service (&sctx))
1426     HANDLE_ERROR;
1427   if ( (do_daemonize == 1) && (GNUNET_OK != detach_terminal (&sctx)))
1428     HANDLE_ERROR;
1429   if (GNUNET_OK != set_user_id (&sctx))
1430     HANDLE_ERROR;
1431 #if DEBUG_SERVICE
1432   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1433               "Service `%s' runs with configuration from `%s'\n",
1434               serviceName, cfg_fn);
1435 #endif
1436   /* actually run service */
1437   GNUNET_SCHEDULER_run (&service_task, &sctx);
1438
1439   /* shutdown */
1440   if ((do_daemonize == 1) && (sctx.server != NULL))
1441     pid_file_delete (&sctx);
1442   GNUNET_free_non_null (sctx.my_handlers);
1443
1444 shutdown:
1445   if (sctx.ready_confirm_fd != -1)
1446     {
1447       if (1 != WRITE (sctx.ready_confirm_fd, err ? "I" : "S", 1))
1448         GNUNET_log_strerror (GNUNET_ERROR_TYPE_WARNING, "write");
1449       GNUNET_break (0 == CLOSE (sctx.ready_confirm_fd));
1450     }
1451
1452   GNUNET_CONFIGURATION_destroy (cfg);
1453   i = 0;
1454   if (sctx.addrs != NULL)
1455     while (sctx.addrs[i] != NULL)
1456       GNUNET_free (sctx.addrs[i++]);
1457   GNUNET_free_non_null (sctx.addrs);
1458   GNUNET_free_non_null (sctx.addrlens);
1459   GNUNET_free_non_null (logfile);
1460   GNUNET_free (loglev);
1461   GNUNET_free (cfg_fn);
1462   GNUNET_free_non_null (sctx.v4_denied);
1463   GNUNET_free_non_null (sctx.v6_denied);
1464   GNUNET_free_non_null (sctx.v4_allowed);
1465   GNUNET_free_non_null (sctx.v6_allowed);
1466
1467   return err ? GNUNET_SYSERR : sctx.ret;
1468 }
1469
1470
1471 /**
1472  * Run a service startup sequence within an existing
1473  * initialized system.
1474  *
1475  * @param serviceName our service name
1476  * @param sched scheduler to use
1477  * @param cfg configuration to use
1478  * @return NULL on error, service handle
1479  */
1480 struct GNUNET_SERVICE_Context *
1481 GNUNET_SERVICE_start (const char *serviceName,
1482                       struct GNUNET_SCHEDULER_Handle *sched,
1483                       const struct GNUNET_CONFIGURATION_Handle *cfg)
1484 {
1485   int i;
1486   struct GNUNET_SERVICE_Context *sctx;
1487
1488   sctx = GNUNET_malloc (sizeof (struct GNUNET_SERVICE_Context));
1489   sctx->ready_confirm_fd = -1;  /* no daemonizing */
1490   sctx->ret = GNUNET_OK;
1491   sctx->timeout = GNUNET_TIME_UNIT_FOREVER_REL;
1492   sctx->maxbuf = GNUNET_SERVER_MAX_MESSAGE_SIZE;
1493   sctx->serviceName = serviceName;
1494   sctx->cfg = cfg;
1495   sctx->sched = sched;
1496
1497   /* setup subsystems */
1498   if ((GNUNET_OK != setup_service (sctx)) ||
1499       (NULL == (sctx->server = GNUNET_SERVER_create (sched,
1500                                                      &check_access,
1501                                                      sctx,
1502                                                      sctx->addrs,
1503                                                      sctx->addrlens,
1504                                                      sctx->maxbuf,
1505                                                      sctx->timeout,
1506                                                      sctx->require_found))))
1507     {
1508       GNUNET_SERVICE_stop (sctx);
1509       return NULL;
1510     }
1511   sctx->my_handlers = GNUNET_malloc (sizeof (defhandlers));
1512   memcpy (sctx->my_handlers, defhandlers, sizeof (defhandlers));
1513   i = 0;
1514   while ((sctx->my_handlers[i].callback != NULL))
1515     sctx->my_handlers[i++].callback_cls = sctx;
1516   GNUNET_SERVER_add_handlers (sctx->server, sctx->my_handlers);
1517   return sctx;
1518 }
1519
1520 /**
1521  * Obtain the server used by a service.  Note that the server must NOT
1522  * be destroyed by the caller.
1523  *
1524  * @param ctx the service context returned from the start function
1525  * @return handle to the server for this service, NULL if there is none
1526  */
1527 struct GNUNET_SERVER_Handle *
1528 GNUNET_SERVICE_get_server (struct GNUNET_SERVICE_Context *ctx)
1529 {
1530   return ctx->server;
1531 }
1532
1533
1534 /**
1535  * Stop a service that was started with "GNUNET_SERVICE_start".
1536  *
1537  * @param sctx the service context returned from the start function
1538  */
1539 void
1540 GNUNET_SERVICE_stop (struct GNUNET_SERVICE_Context *sctx)
1541 {
1542   unsigned int i;
1543   if (NULL != sctx->server)
1544     GNUNET_SERVER_destroy (sctx->server);
1545   GNUNET_free_non_null (sctx->my_handlers);
1546   i = 0;
1547   while (sctx->addrs[i] != NULL)
1548     GNUNET_free (sctx->addrs[i++]);
1549   GNUNET_free_non_null (sctx->addrs);
1550   GNUNET_free_non_null (sctx->addrlens);
1551   GNUNET_free_non_null (sctx->v4_denied);
1552   GNUNET_free_non_null (sctx->v6_denied);
1553   GNUNET_free_non_null (sctx->v4_allowed);
1554   GNUNET_free_non_null (sctx->v6_allowed);
1555   GNUNET_free (sctx);
1556 }
1557
1558
1559 /* end of service.c */