c34c5aa32c11925ca4403e4d7e0f1452e37ba079
[oweals/gnunet.git] / 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, NULL if we got pre-bound
439    * listen sockets.
440    */
441   struct sockaddr **addrs;
442
443   /**
444    * Name of our service.
445    */
446   const char *serviceName;
447
448   /**
449    * Main service-specific task to run.
450    */
451   GNUNET_SERVICE_Main task;
452
453   /**
454    * Closure for task.
455    */
456   void *task_cls;
457
458   /**
459    * IPv4 addresses that are not allowed to connect.
460    */
461   struct IPv4NetworkSet *v4_denied;
462
463   /**
464    * IPv6 addresses that are not allowed to connect.
465    */
466   struct IPv6NetworkSet *v6_denied;
467
468   /**
469    * IPv4 addresses that are allowed to connect (if not
470    * set, all are allowed).
471    */
472   struct IPv4NetworkSet *v4_allowed;
473
474   /**
475    * IPv6 addresses that are allowed to connect (if not
476    * set, all are allowed).
477    */
478   struct IPv6NetworkSet *v6_allowed;
479
480   /**
481    * My (default) message handlers.  Adjusted copy
482    * of "defhandlers".
483    */
484   struct GNUNET_SERVER_MessageHandler *my_handlers;
485
486   /**
487    * Array of the lengths of the entries in addrs.
488    */
489   socklen_t * addrlens;
490
491   /**
492    * NULL-terminated array of listen sockets we should take over.
493    */
494   struct GNUNET_NETWORK_Handle **lsocks;
495
496   /**
497    * Idle timeout for server.
498    */
499   struct GNUNET_TIME_Relative timeout;
500
501   /**
502    * Maximum buffer size for the server.
503    */
504   size_t maxbuf;
505
506   /**
507    * Overall success/failure of the service start.
508    */
509   int ret;
510
511   /**
512    * If we are daemonizing, this FD is set to the
513    * pipe to the parent.  Send '.' if we started
514    * ok, '!' if not.  -1 if we are not daemonizing.
515    */
516   int ready_confirm_fd;
517
518   /**
519    * Do we close connections if we receive messages
520    * for which we have no handler?
521    */
522   int require_found;
523
524   /**
525    * Our options.
526    */
527   enum GNUNET_SERVICE_Options options;
528
529 };
530
531
532 /* ****************** message handlers ****************** */
533
534 static size_t
535 write_test (void *cls, size_t size, void *buf)
536 {
537   struct GNUNET_SERVER_Client *client = cls;
538   struct GNUNET_MessageHeader *msg;
539
540   if (size < sizeof (struct GNUNET_MessageHeader))
541     {
542       GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
543       return 0;                 /* client disconnected */
544     }
545   msg = (struct GNUNET_MessageHeader *) buf;
546   msg->type = htons (GNUNET_MESSAGE_TYPE_TEST);
547   msg->size = htons (sizeof (struct GNUNET_MessageHeader));
548   GNUNET_SERVER_receive_done (client, GNUNET_OK);
549   return sizeof (struct GNUNET_MessageHeader);
550 }
551
552 /**
553  * Handler for TEST message.
554  *
555  * @param cls closure (refers to service)
556  * @param client identification of the client
557  * @param message the actual message
558  */
559 static void
560 handle_test (void *cls,
561              struct GNUNET_SERVER_Client *client,
562              const struct GNUNET_MessageHeader *message)
563 {
564   /* simply bounce message back to acknowledge */
565   if (NULL == GNUNET_SERVER_notify_transmit_ready (client,
566                                                    sizeof (struct
567                                                            GNUNET_MessageHeader),
568                                                    GNUNET_TIME_UNIT_FOREVER_REL,
569                                                    &write_test, client))
570     GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
571 }
572
573
574 /**
575  * Default handlers for all services.  Will be copied and the
576  * "callback_cls" fields will be replaced with the specific service
577  * struct.
578  */
579 static const struct GNUNET_SERVER_MessageHandler defhandlers[] = {
580   {&handle_test, NULL, GNUNET_MESSAGE_TYPE_TEST,
581    sizeof (struct GNUNET_MessageHeader)},
582   {NULL, NULL, 0, 0}
583 };
584
585
586
587 /* ****************** service core routines ************** */
588
589
590 /**
591  * Check if access to the service is allowed from the given address.
592  */
593 static int
594 check_access (void *cls, const struct sockaddr *addr, socklen_t addrlen)
595 {
596   struct GNUNET_SERVICE_Context *sctx = cls;
597   const struct sockaddr_in *i4;
598   const struct sockaddr_in6 *i6;
599   int ret;
600
601   switch (addr->sa_family)
602     {
603     case AF_INET:
604       GNUNET_assert (addrlen == sizeof (struct sockaddr_in));
605       i4 = (const struct sockaddr_in *) addr;
606       ret = ((sctx->v4_allowed == NULL) ||
607              (check_ipv4_listed (sctx->v4_allowed,
608                                  &i4->sin_addr)))
609         && ((sctx->v4_denied == NULL) ||
610             (!check_ipv4_listed (sctx->v4_denied, &i4->sin_addr)));
611       break;
612     case AF_INET6:
613       GNUNET_assert (addrlen == sizeof (struct sockaddr_in6));
614       i6 = (const struct sockaddr_in6 *) addr;
615       ret = ((sctx->v6_allowed == NULL) ||
616              (check_ipv6_listed (sctx->v6_allowed,
617                                  &i6->sin6_addr)))
618         && ((sctx->v6_denied == NULL) ||
619             (!check_ipv6_listed (sctx->v6_denied, &i6->sin6_addr)));
620       break;
621     case AF_UNIX:
622       /* FIXME: support checking UID/GID in the future... */
623       ret = GNUNET_OK; /* always OK for now */
624       break;
625     default:
626       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
627                   _("Unknown address family %d\n"), addr->sa_family);
628       return GNUNET_SYSERR;
629     }
630   if (ret != GNUNET_OK)
631     {
632       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
633                   _("Access from `%s' denied to service `%s'\n"),
634                   GNUNET_a2s (addr, addrlen), sctx->serviceName);
635     }
636   return ret;
637 }
638
639
640 /**
641  * Get the name of the file where we will
642  * write the PID of the service.
643  */
644 static char *
645 get_pid_file_name (struct GNUNET_SERVICE_Context *sctx)
646 {
647
648   char *pif;
649
650   if (GNUNET_OK !=
651       GNUNET_CONFIGURATION_get_value_filename (sctx->cfg,
652                                                sctx->serviceName,
653                                                "PIDFILE", &pif))
654     return NULL;
655   return pif;
656 }
657
658
659 /**
660  * Parse an IPv4 access control list.
661  */
662 static int
663 process_acl4 (struct IPv4NetworkSet **ret,
664               struct GNUNET_SERVICE_Context *sctx, const char *option)
665 {
666   char *opt;
667
668   if (!GNUNET_CONFIGURATION_have_value (sctx->cfg, sctx->serviceName, option))
669     return GNUNET_OK;
670   GNUNET_break (GNUNET_OK ==
671                 GNUNET_CONFIGURATION_get_value_string (sctx->cfg,
672                                                        sctx->serviceName,
673                                                        option, &opt));
674   if (NULL == (*ret = parse_ipv4_specification (opt)))
675     {
676       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
677                   _
678                   ("Could not parse IPv4 network specification `%s' for `%s:%s'\n"),
679                   opt, sctx->serviceName, option);
680       GNUNET_free (opt);
681       return GNUNET_SYSERR;
682     }
683   GNUNET_free (opt);
684   return GNUNET_OK;
685 }
686
687
688 /**
689  * Parse an IPv4 access control list.
690  */
691 static int
692 process_acl6 (struct IPv6NetworkSet **ret,
693               struct GNUNET_SERVICE_Context *sctx, const char *option)
694 {
695   char *opt;
696   if (!GNUNET_CONFIGURATION_have_value (sctx->cfg, sctx->serviceName, option))
697     return GNUNET_OK;
698   GNUNET_break (GNUNET_OK ==
699                 GNUNET_CONFIGURATION_get_value_string (sctx->cfg,
700                                                        sctx->serviceName,
701                                                        option, &opt));
702   if (NULL == (*ret = parse_ipv6_specification (opt)))
703     {
704       GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
705                   _
706                   ("Could not parse IPv6 network specification `%s' for `%s:%s'\n"),
707                   opt, sctx->serviceName, option);
708       GNUNET_free (opt);
709       return GNUNET_SYSERR;
710     }
711   GNUNET_free (opt);
712   return GNUNET_OK;
713 }
714
715 /**
716  * Add the given UNIX domain path as an address to the
717  * list (as the first entry).
718  *
719  * @param saddrs array to update
720  * @param saddrlens where to store the address length
721  * @param unixpath path to add
722  */
723 static void
724 add_unixpath (struct sockaddr **saddrs,
725               socklen_t *saddrlens,
726               const char *unixpath)
727 {
728 #ifdef AF_UNIX  
729   struct sockaddr_un *un;
730   size_t slen;
731
732   un = GNUNET_malloc (sizeof (struct sockaddr_un));
733   un->sun_family = AF_UNIX;
734   slen = strlen (unixpath) + 1;
735   if (slen >= sizeof (un->sun_path))
736     slen = sizeof (un->sun_path) - 1;
737   memcpy (un->sun_path,
738           unixpath,
739           slen);
740   un->sun_path[slen] = '\0';
741 #if LINUX
742   un->sun_path[0] = '\0';
743   slen = sizeof (struct sockaddr_un);
744 #else
745   slen += sizeof (sa_family_t);
746 #endif
747   *saddrs = (struct sockaddr*) un;
748   *saddrlens = slen;
749 #else
750   /* this function should never be called 
751      unless AF_UNIX is defined! */
752   GNUNET_assert (0);
753 #endif
754 }
755
756
757 /**
758  * Get the list of addresses that a server for the given service
759  * should bind to.
760  *
761  * @param serviceName name of the service
762  * @param cfg configuration (which specifies the addresses)
763  * @param addrs set (call by reference) to an array of pointers to the
764  *              addresses the server should bind to and listen on; the
765  *              array will be NULL-terminated (on success)
766  * @param addr_lens set (call by reference) to an array of the lengths
767  *              of the respective 'struct sockaddr' struct in the 'addrs'
768  *              array (on success)
769  * @return number of addresses found on success,
770  *              GNUNET_SYSERR if the configuration
771  *              did not specify reasonable finding information or
772  *              if it specified a hostname that could not be resolved;
773  *              GNUNET_NO if the number of addresses configured is
774  *              zero (in this case, '*addrs' and '*addr_lens' will be
775  *              set to NULL).
776  */
777 int
778 GNUNET_SERVICE_get_server_addresses (const char *serviceName,
779                                      const struct GNUNET_CONFIGURATION_Handle *cfg,
780                                      struct sockaddr ***addrs,
781                                      socklen_t **addr_lens)
782 {
783   int disablev6;
784   struct GNUNET_NETWORK_Handle *desc;
785   unsigned long long port;
786   char *unixpath;
787   struct addrinfo hints;
788   struct addrinfo *res;
789   struct addrinfo *pos;
790   struct addrinfo *next;
791   unsigned int i;
792   int resi;
793   int ret;
794   struct sockaddr **saddrs;
795   socklen_t *saddrlens;
796   char *hostname;
797
798   *addrs = NULL;
799   *addr_lens = NULL;
800   desc = NULL;
801   if (GNUNET_CONFIGURATION_have_value (cfg,
802                                        serviceName, "DISABLEV6"))
803     {
804       if (GNUNET_SYSERR ==
805           (disablev6 = GNUNET_CONFIGURATION_get_value_yesno (cfg,
806                                                              serviceName,
807                                                              "DISABLEV6")))
808         return GNUNET_SYSERR;
809     }
810   else
811     disablev6 = GNUNET_NO;
812
813   if (!disablev6)
814     {
815       /* probe IPv6 support */
816       desc = GNUNET_NETWORK_socket_create (PF_INET6, SOCK_STREAM, 0);
817       if (NULL == desc)
818         {
819           if ((errno == ENOBUFS) ||
820               (errno == ENOMEM) || (errno == ENFILE) || (errno == EACCES))
821             {
822               GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "socket");
823               return GNUNET_SYSERR;
824             }
825           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
826                       _
827                       ("Disabling IPv6 support for service `%s', failed to create IPv6 socket: %s\n"),
828                       serviceName, STRERROR (errno));
829           disablev6 = GNUNET_YES;
830         }
831       else
832         {
833           GNUNET_break (GNUNET_OK == GNUNET_NETWORK_socket_close (desc));
834           desc = NULL;
835         }
836     }
837
838   port = 0;
839   if (GNUNET_CONFIGURATION_have_value (cfg,
840                                        serviceName, "PORT"))
841     {
842       GNUNET_break (GNUNET_OK ==
843                     GNUNET_CONFIGURATION_get_value_number (cfg,
844                                                            serviceName,
845                                                            "PORT",
846                                                            &port));
847       if (port > 65535)
848         {
849           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
850                       _
851                       ("Require valid port number for service `%s' in configuration!\n"),
852                       serviceName);
853           return GNUNET_SYSERR;
854         }
855     }
856
857   if (GNUNET_CONFIGURATION_have_value (cfg,
858                                        serviceName, "BINDTO"))
859     {
860       GNUNET_break (GNUNET_OK ==
861                     GNUNET_CONFIGURATION_get_value_string (cfg,
862                                                            serviceName,
863                                                            "BINDTO",
864                                                            &hostname));
865     }
866   else
867     hostname = NULL;
868
869 #ifdef AF_UNIX
870   if (GNUNET_CONFIGURATION_have_value (cfg,
871                                        serviceName, "UNIXPATH"))
872     {
873       GNUNET_break (GNUNET_OK ==
874                     GNUNET_CONFIGURATION_get_value_string (cfg,
875                                                            serviceName,
876                                                            "UNIXPATH",
877                                                            &unixpath));
878
879       /* probe UNIX support */
880       desc = GNUNET_NETWORK_socket_create (AF_UNIX, SOCK_STREAM, 0);
881       if (NULL == desc)
882         {
883           if ((errno == ENOBUFS) ||
884               (errno == ENOMEM) || (errno == ENFILE) || (errno == EACCES))
885             {
886               GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "socket");
887               GNUNET_free_non_null (hostname);
888               GNUNET_free (unixpath);
889               return GNUNET_SYSERR;
890             }
891           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
892                       _
893                       ("Disabling UNIX domain socket support for service `%s', failed to create UNIX domain socket: %s\n"),
894                       serviceName, STRERROR (errno));
895           GNUNET_free (unixpath);
896           unixpath = NULL;
897         }
898       else
899         {
900           GNUNET_break (GNUNET_OK == GNUNET_NETWORK_socket_close (desc));
901           desc = NULL;
902         }
903     }
904   else
905     unixpath = NULL;
906 #else
907   unixpath = NULL;
908 #endif
909
910   if ( (port == 0) &&
911        (unixpath == NULL) )
912     {
913       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
914                   _("Have neither PORT nor UNIXPATH for service `%s', but one is required\n"),
915                   serviceName);
916       GNUNET_free_non_null(hostname);
917       return GNUNET_SYSERR;
918     }
919   if (port == 0)
920     {
921       saddrs = GNUNET_malloc (2 * sizeof(struct sockaddr*));
922       saddrlens = GNUNET_malloc (2 * sizeof (socklen_t));
923       add_unixpath (saddrs, saddrlens, unixpath);
924       GNUNET_free_non_null (unixpath);
925       *addrs = saddrs;
926       *addr_lens = saddrlens;
927       return 1;
928     }
929        
930   if (hostname != NULL)
931     {
932 #if DEBUG_SERVICE
933       GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
934                   "Resolving `%s' since that is where `%s' will bind to.\n",
935                   hostname,
936                   serviceName);
937 #endif
938       memset (&hints, 0, sizeof (struct addrinfo));
939       if (disablev6)
940         hints.ai_family = AF_INET;
941       if ((0 != (ret = getaddrinfo (hostname,
942                                     NULL, &hints, &res))) || (res == NULL))
943         {
944           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
945                       _("Failed to resolve `%s': %s\n"),
946                       hostname, gai_strerror (ret));
947           GNUNET_free (hostname);
948           GNUNET_free (unixpath);
949           return GNUNET_SYSERR;
950         }
951       next = res;
952       i = 0;
953       while (NULL != (pos = next)) 
954         {
955           next = pos->ai_next;
956           if ( (disablev6) && (pos->ai_family == AF_INET6))
957             continue;
958           i++;
959         }
960       if (0 == i)
961         {
962           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
963                       _("Failed to find %saddress for `%s'.\n"),
964                       disablev6 ? "IPv4 " : "", hostname);
965           freeaddrinfo (res);
966           GNUNET_free (hostname);
967           GNUNET_free (unixpath);
968           return GNUNET_SYSERR;
969         }
970       resi = i;
971       if (NULL != unixpath)
972         resi++;
973       saddrs = GNUNET_malloc ((resi+1) * sizeof(struct sockaddr*));
974       saddrlens = GNUNET_malloc ((resi+1) * sizeof (socklen_t));
975       i = 0;
976       if (NULL != unixpath)
977         {
978           add_unixpath (saddrs, saddrlens, unixpath);
979           i++;
980         }
981       next = res;
982       while (NULL != (pos = next)) 
983         {
984           next = pos->ai_next;
985           if ( (disablev6) && (pos->ai_family == AF_INET6))
986             continue;
987 #if DEBUG_SERVICE
988           GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
989                       "Service `%s' will bind to `%s'\n",
990                       serviceName,
991                       GNUNET_a2s (pos->ai_addr,
992                                   pos->ai_addrlen));
993 #endif
994           if (pos->ai_family == AF_INET)
995             {
996               GNUNET_assert (pos->ai_addrlen == sizeof (struct sockaddr_in));
997               saddrlens[i] = pos->ai_addrlen;
998               saddrs[i] = GNUNET_malloc (saddrlens[i]);
999               memcpy (saddrs[i], pos->ai_addr, saddrlens[i]);
1000               ((struct sockaddr_in *) saddrs[i])->sin_port = htons (port);
1001             }
1002           else
1003             {
1004               GNUNET_assert (pos->ai_family == AF_INET6);
1005               GNUNET_assert (pos->ai_addrlen == sizeof (struct sockaddr_in6));
1006               saddrlens[i] = pos->ai_addrlen;
1007               saddrs[i] = GNUNET_malloc (saddrlens[i]);
1008               memcpy (saddrs[i], pos->ai_addr, saddrlens[i]);
1009               ((struct sockaddr_in6 *) saddrs[i])->sin6_port = htons (port);
1010             }     
1011           i++;
1012         }
1013       GNUNET_free (hostname);
1014       freeaddrinfo (res);
1015     }
1016   else
1017     {
1018       /* will bind against everything, just set port */
1019       if (disablev6)
1020         {
1021           /* V4-only */
1022           resi = 1;
1023           if (NULL != unixpath)
1024             resi++;
1025           i = 0;
1026           saddrs = GNUNET_malloc ((resi+1) * sizeof(struct sockaddr*));
1027           saddrlens = GNUNET_malloc ((resi+1) * sizeof (socklen_t));
1028           if (NULL != unixpath)
1029             {
1030               add_unixpath (saddrs, saddrlens, unixpath);
1031               i++;
1032             }
1033           saddrlens[i] = sizeof (struct sockaddr_in);
1034           saddrs[i] = GNUNET_malloc (saddrlens[i]);
1035 #if HAVE_SOCKADDR_IN_SIN_LEN
1036           ((struct sockaddr_in *) saddrs[i])->sin_len = saddrlens[i];
1037 #endif
1038           ((struct sockaddr_in *) saddrs[i])->sin_family = AF_INET;
1039           ((struct sockaddr_in *) saddrs[i])->sin_port = htons (port);
1040         }
1041       else
1042         {
1043           /* dual stack */
1044           resi = 2;
1045           if (NULL != unixpath)
1046             resi++;
1047           saddrs = GNUNET_malloc ((resi+1) * sizeof(struct sockaddr*));
1048           saddrlens = GNUNET_malloc ((resi+1) * sizeof (socklen_t));
1049           i = 0;
1050           if (NULL != unixpath)
1051             {
1052               add_unixpath (saddrs, saddrlens, unixpath);
1053               i++;
1054             }
1055           saddrlens[i] = sizeof (struct sockaddr_in6);
1056           saddrs[i] = GNUNET_malloc (saddrlens[i]);
1057 #if HAVE_SOCKADDR_IN_SIN_LEN
1058           ((struct sockaddr_in6 *) saddrs[i])->sin6_len = saddrlens[0];
1059 #endif
1060           ((struct sockaddr_in6 *) saddrs[i])->sin6_family = AF_INET6;
1061           ((struct sockaddr_in6 *) saddrs[i])->sin6_port = htons (port);
1062           i++;
1063           saddrlens[i] = sizeof (struct sockaddr_in);
1064           saddrs[i] = GNUNET_malloc (saddrlens[i]);
1065 #if HAVE_SOCKADDR_IN_SIN_LEN
1066           ((struct sockaddr_in *) saddrs[i])->sin_len = saddrlens[1];
1067 #endif
1068           ((struct sockaddr_in *) saddrs[i])->sin_family = AF_INET;
1069           ((struct sockaddr_in *) saddrs[i])->sin_port = htons (port);
1070         }
1071     }
1072   GNUNET_free_non_null (unixpath);
1073   *addrs = saddrs;
1074   *addr_lens = saddrlens;
1075   return resi;
1076 }
1077
1078
1079 /**
1080  * Setup addr, addrlen, maxbuf, idle_timeout
1081  * based on configuration!
1082  *
1083  * Configuration may specify:
1084  * - PORT (where to bind to for TCP)
1085  * - UNIXPATH (where to bind to for UNIX domain sockets)
1086  * - TIMEOUT (after how many ms does an inactive service timeout);
1087  * - MAXBUF (maximum incoming message size supported)
1088  * - DISABLEV6 (disable support for IPv6, otherwise we use dual-stack)
1089  * - BINDTO (hostname or IP address to bind to, otherwise we take everything)
1090  * - ACCEPT_FROM  (only allow connections from specified IPv4 subnets)
1091  * - ACCEPT_FROM6 (only allow connections from specified IPv6 subnets)
1092  * - REJECT_FROM  (disallow allow connections from specified IPv4 subnets)
1093  * - REJECT_FROM6 (disallow allow connections from specified IPv6 subnets)
1094  *
1095  * @return GNUNET_OK if configuration succeeded
1096  */
1097 static int
1098 setup_service (struct GNUNET_SERVICE_Context *sctx)
1099 {
1100   unsigned long long maxbuf;
1101   struct GNUNET_TIME_Relative idleout;
1102   int tolerant;
1103   const char *lpid;
1104   unsigned int pid;
1105   const char *nfds;
1106   unsigned int cnt;
1107   int flags;
1108
1109   if (GNUNET_CONFIGURATION_have_value (sctx->cfg,
1110                                        sctx->serviceName, "TIMEOUT"))
1111     {
1112       if (GNUNET_OK !=
1113           GNUNET_CONFIGURATION_get_value_time (sctx->cfg,
1114                                                sctx->serviceName,
1115                                                "TIMEOUT", &idleout))
1116         {
1117           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1118                       _("Specified value for `%s' of service `%s' is invalid\n"),
1119                       "TIMEOUT",
1120                       sctx->serviceName);
1121           return GNUNET_SYSERR;
1122         }
1123       sctx->timeout = idleout;
1124     }
1125   else
1126     sctx->timeout = GNUNET_TIME_UNIT_FOREVER_REL;
1127   if (GNUNET_CONFIGURATION_have_value (sctx->cfg,
1128                                        sctx->serviceName, "MAXBUF"))
1129     {
1130       if (GNUNET_OK !=
1131           GNUNET_CONFIGURATION_get_value_number (sctx->cfg,
1132                                                  sctx->serviceName,
1133                                                  "MAXBUF", &maxbuf))
1134         {
1135           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1136                       _("Specified value for `%s' of service `%s' is invalid\n"),
1137                       "MAXBUF",
1138                       sctx->serviceName);
1139           return GNUNET_SYSERR;
1140         }
1141     }
1142   else
1143     maxbuf = GNUNET_SERVER_MAX_MESSAGE_SIZE - 1;
1144
1145   if (GNUNET_CONFIGURATION_have_value (sctx->cfg,
1146                                        sctx->serviceName, "TOLERANT"))
1147     {
1148       if (GNUNET_SYSERR ==
1149           (tolerant = GNUNET_CONFIGURATION_get_value_yesno (sctx->cfg,
1150                                                             sctx->serviceName,
1151                                                             "TOLERANT")))
1152         {
1153           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1154                       _("Specified value for `%s' of service `%s' is invalid\n"),
1155                       "TOLERANT",
1156                       sctx->serviceName);
1157           return GNUNET_SYSERR;
1158         }
1159     }
1160   else
1161     tolerant = GNUNET_NO;
1162
1163 #ifndef MINGW
1164   errno = 0;
1165   if ( (NULL != (lpid = getenv ("LISTEN_PID"))) &&
1166        (1 == sscanf (lpid, "%u", &pid)) &&
1167        (getpid () == (pid_t) pid) &&
1168        (NULL != (nfds = getenv ("LISTEN_FDS"))) &&
1169        (1 == sscanf (nfds, "%u", &cnt)) &&
1170        (cnt > 0) )
1171     {
1172       sctx->lsocks = GNUNET_malloc (sizeof(struct GNUNET_NETWORK_Handle*) * (cnt+1));
1173       while (0 < cnt--)
1174         {
1175           flags = fcntl (3 + cnt, F_GETFD);      
1176           if ( (flags < 0) ||
1177                (0 != (flags & FD_CLOEXEC)) ||
1178                (NULL == (sctx->lsocks[cnt] = GNUNET_NETWORK_socket_box_native (3 + cnt))) )
1179             {
1180               GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1181                           _("Could not access pre-bound socket %u, will try to bind myself\n"),
1182                           (unsigned int) 3 +cnt);
1183               cnt++;
1184               while (sctx->lsocks[cnt] != NULL)
1185                 GNUNET_break (0 == GNUNET_NETWORK_socket_close (sctx->lsocks[cnt++]));
1186               GNUNET_free (sctx->lsocks);
1187               sctx->lsocks = NULL;
1188               break;
1189             }
1190         }
1191       unsetenv ("LISTEN_PID");
1192       unsetenv ("LISTEN_FDS");
1193     }
1194 #endif
1195
1196   if ( (sctx->lsocks == NULL) &&
1197        (GNUNET_SYSERR ==
1198         GNUNET_SERVICE_get_server_addresses (sctx->serviceName,
1199                                              sctx->cfg,
1200                                              &sctx->addrs,
1201                                              &sctx->addrlens)) )
1202     return GNUNET_SYSERR;
1203   sctx->require_found = tolerant ? GNUNET_NO : GNUNET_YES;
1204   sctx->maxbuf = (size_t) maxbuf;
1205   if (sctx->maxbuf != maxbuf)
1206     {
1207       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1208                   _
1209                   ("Value in configuration for `%s' and service `%s' too large!\n"),
1210                   "MAXBUF", sctx->serviceName);
1211       return GNUNET_SYSERR;
1212     }
1213
1214   process_acl4 (&sctx->v4_denied, sctx, "REJECT_FROM");
1215   process_acl4 (&sctx->v4_allowed, sctx, "ACCEPT_FROM");
1216   process_acl6 (&sctx->v6_denied, sctx, "REJECT_FROM6");
1217   process_acl6 (&sctx->v6_allowed, sctx, "ACCEPT_FROM6");
1218
1219   return GNUNET_OK;
1220 }
1221
1222
1223 /**
1224  * Get the name of the user that'll be used
1225  * to provide the service.
1226  */
1227 static char *
1228 get_user_name (struct GNUNET_SERVICE_Context *sctx)
1229 {
1230
1231   char *un;
1232
1233   if (GNUNET_OK !=
1234       GNUNET_CONFIGURATION_get_value_filename (sctx->cfg,
1235                                                sctx->serviceName,
1236                                                "USERNAME", &un))
1237     return NULL;
1238   return un;
1239 }
1240
1241 /**
1242  * Write PID file.
1243  */
1244 static int
1245 write_pid_file (struct GNUNET_SERVICE_Context *sctx, pid_t pid)
1246 {
1247   FILE *pidfd;
1248   char *pif;
1249   char *user;
1250   char *rdir;
1251   int len;
1252
1253   if (NULL == (pif = get_pid_file_name (sctx)))
1254     return GNUNET_OK;           /* no file desired */
1255   user = get_user_name (sctx);
1256   rdir = GNUNET_strdup (pif);
1257   len = strlen (rdir);
1258   while ((len > 0) && (rdir[len] != DIR_SEPARATOR))
1259     len--;
1260   rdir[len] = '\0';
1261   if (0 != ACCESS (rdir, F_OK))
1262     {
1263       /* we get to create a directory -- and claim it
1264          as ours! */
1265       GNUNET_DISK_directory_create (rdir);
1266       if ((user != NULL) && (0 < strlen (user)))
1267         GNUNET_DISK_file_change_owner (rdir, user);
1268     }
1269   if (0 != ACCESS (rdir, W_OK | X_OK))
1270     {
1271       GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_ERROR, "access", rdir);
1272       GNUNET_free (rdir);
1273       GNUNET_free_non_null (user);
1274       GNUNET_free (pif);
1275       return GNUNET_SYSERR;
1276     }
1277   GNUNET_free (rdir);
1278   pidfd = FOPEN (pif, "w");
1279   if (pidfd == NULL)
1280     {
1281       GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_ERROR, "fopen", pif);
1282       GNUNET_free (pif);
1283       GNUNET_free_non_null (user);
1284       return GNUNET_SYSERR;
1285     }
1286   if (0 > FPRINTF (pidfd, "%u", pid))
1287     GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_WARNING, "fprintf", pif);
1288   GNUNET_break (0 == fclose (pidfd));
1289   if ((user != NULL) && (0 < strlen (user)))
1290     GNUNET_DISK_file_change_owner (pif, user);
1291   GNUNET_free_non_null (user);
1292   GNUNET_free (pif);
1293   return GNUNET_OK;
1294 }
1295
1296
1297 /**
1298  * Task run during shutdown.
1299  *
1300  * @param cls unused
1301  * @param tc unused
1302  */
1303 static void
1304 shutdown_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1305 {
1306   struct GNUNET_SERVER_Handle *server = cls;
1307
1308   GNUNET_SERVER_destroy (server);
1309 }
1310
1311
1312 /**
1313  * Initial task for the service.
1314  */
1315 static void
1316 service_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1317 {
1318   struct GNUNET_SERVICE_Context *sctx = cls;
1319   unsigned int i;
1320
1321   sctx->sched = tc->sched;
1322   if (sctx->lsocks != NULL)
1323     sctx->server = GNUNET_SERVER_create_with_sockets (tc->sched,
1324                                                       &check_access,
1325                                                       sctx,
1326                                                       sctx->lsocks,
1327                                                       sctx->maxbuf,
1328                                                       sctx->timeout, sctx->require_found);
1329   else
1330     sctx->server = GNUNET_SERVER_create (tc->sched,
1331                                          &check_access,
1332                                          sctx,
1333                                          sctx->addrs,
1334                                          sctx->addrlens,
1335                                          sctx->maxbuf,
1336                                          sctx->timeout, sctx->require_found);
1337   if (sctx->server == NULL)
1338     {
1339       if (sctx->addrs != NULL)
1340         {
1341           i = 0;
1342           while (sctx->addrs[i] != NULL)
1343             {
1344               GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1345                           _("Failed to start `%s' at `%s'\n"),
1346                           sctx->serviceName, 
1347                           GNUNET_a2s (sctx->addrs[i], sctx->addrlens[i]));
1348               i++;
1349             }
1350         }
1351       sctx->ret = GNUNET_SYSERR;
1352       return;
1353     }
1354   if (0 == (sctx->options & GNUNET_SERVICE_OPTION_MANUAL_SHUTDOWN))
1355     {
1356       /* install a task that will kill the server
1357          process if the scheduler ever gets a shutdown signal */
1358       GNUNET_SCHEDULER_add_delayed (tc->sched,
1359                                     GNUNET_TIME_UNIT_FOREVER_REL,
1360                                     &shutdown_task, sctx->server);
1361     }
1362   sctx->my_handlers = GNUNET_malloc (sizeof (defhandlers));
1363   memcpy (sctx->my_handlers, defhandlers, sizeof (defhandlers));
1364   i = 0;
1365   while ((sctx->my_handlers[i].callback != NULL))
1366     sctx->my_handlers[i++].callback_cls = sctx;
1367   GNUNET_SERVER_add_handlers (sctx->server, sctx->my_handlers);
1368   if (sctx->ready_confirm_fd != -1)
1369     {
1370       GNUNET_break (1 == WRITE (sctx->ready_confirm_fd, ".", 1));
1371       GNUNET_break (0 == CLOSE (sctx->ready_confirm_fd));
1372       sctx->ready_confirm_fd = -1;
1373       write_pid_file (sctx, getpid ());
1374     }
1375   if (sctx->addrs != NULL)
1376     {
1377       i = 0;
1378       while (sctx->addrs[i] != NULL)
1379         {
1380           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1381                       _("Service `%s' runs at %s\n"),
1382                       sctx->serviceName, 
1383                       GNUNET_a2s (sctx->addrs[i], sctx->addrlens[i]));
1384           i++;
1385         }
1386     }
1387   sctx->task (sctx->task_cls, tc->sched, sctx->server, sctx->cfg);
1388 }
1389
1390
1391 /**
1392  * Detach from terminal.
1393  */
1394 static int
1395 detach_terminal (struct GNUNET_SERVICE_Context *sctx)
1396 {
1397 #ifndef MINGW
1398   pid_t pid;
1399   int nullfd;
1400   int filedes[2];
1401
1402   if (0 != PIPE (filedes))
1403     {
1404       GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "pipe");
1405       return GNUNET_SYSERR;
1406     }
1407   pid = fork ();
1408   if (pid < 0)
1409     {
1410       GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "fork");
1411       return GNUNET_SYSERR;
1412     }
1413   if (pid != 0)
1414     {
1415       /* Parent */
1416       char c;
1417
1418       GNUNET_break (0 == CLOSE (filedes[1]));
1419       c = 'X';
1420       if (1 != READ (filedes[0], &c, sizeof (char)))
1421         GNUNET_log_strerror (GNUNET_ERROR_TYPE_WARNING, "read");
1422       fflush (stdout);
1423       switch (c)
1424         {
1425         case '.':
1426           exit (0);
1427         case 'I':
1428           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1429                       _("Service process failed to initialize\n"));
1430           break;
1431         case 'S':
1432           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1433                       _
1434                       ("Service process could not initialize server function\n"));
1435           break;
1436         case 'X':
1437           GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1438                       _("Service process failed to report status\n"));
1439           break;
1440         }
1441       exit (1);                 /* child reported error */
1442     }
1443   GNUNET_break (0 == CLOSE (0));
1444   GNUNET_break (0 == CLOSE (1));
1445   GNUNET_break (0 == CLOSE (filedes[0]));
1446   nullfd = OPEN ("/dev/null", O_RDWR | O_APPEND);
1447   if (nullfd < 0)
1448     return GNUNET_SYSERR;
1449   /* set stdin/stdout to /dev/null */
1450   if ((dup2 (nullfd, 0) < 0) || (dup2 (nullfd, 1) < 0))
1451     {
1452       GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "dup2");
1453       return GNUNET_SYSERR;
1454     }
1455   /* Detach from controlling terminal */
1456   pid = setsid ();
1457   if (pid == -1)
1458     GNUNET_log_strerror (GNUNET_ERROR_TYPE_ERROR, "setsid");
1459   sctx->ready_confirm_fd = filedes[1];
1460 #else
1461   /* FIXME: we probably need to do something else
1462      elsewhere in order to fork the process itself... */
1463   FreeConsole ();
1464 #endif
1465   return GNUNET_OK;
1466 }
1467
1468
1469 /**
1470  * Set user ID.
1471  */
1472 static int
1473 set_user_id (struct GNUNET_SERVICE_Context *sctx)
1474 {
1475   char *user;
1476
1477   if (NULL == (user = get_user_name (sctx)))
1478     return GNUNET_OK;           /* keep */
1479 #ifndef MINGW
1480   struct passwd *pws;
1481
1482   errno = 0;
1483   pws = getpwnam (user);
1484   if (pws == NULL)
1485     {
1486       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1487                   _("Cannot obtain information about user `%s': %s\n"),
1488                   user, errno == 0 ? _("No such user") : STRERROR (errno));
1489       GNUNET_free (user);
1490       return GNUNET_SYSERR;
1491     }
1492   if ((0 != setgid (pws->pw_gid)) || (0 != setegid (pws->pw_gid)) ||
1493 #if HAVE_INITGROUPS
1494       (0 != initgroups (user, pws->pw_gid)) ||
1495 #endif
1496       (0 != setuid (pws->pw_uid)) || (0 != seteuid (pws->pw_uid)))
1497     {
1498       if ((0 != setregid (pws->pw_gid, pws->pw_gid)) ||
1499           (0 != setreuid (pws->pw_uid, pws->pw_uid)))
1500         {
1501           GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1502                       _("Cannot change user/group to `%s': %s\n"), user,
1503                       STRERROR (errno));
1504           GNUNET_free (user);
1505           return GNUNET_SYSERR;
1506         }
1507     }
1508 #endif
1509   GNUNET_free (user);
1510   return GNUNET_OK;
1511 }
1512
1513
1514 /**
1515  * Delete the PID file that was created by our parent.
1516  */
1517 static void
1518 pid_file_delete (struct GNUNET_SERVICE_Context *sctx)
1519 {
1520   char *pif = get_pid_file_name (sctx);
1521   if (pif == NULL)
1522     return;                     /* no PID file */
1523   if (0 != UNLINK (pif))
1524     GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_WARNING, "unlink", pif);
1525   GNUNET_free (pif);
1526 }
1527
1528
1529 /**
1530  * Run a standard GNUnet service startup sequence (initialize loggers
1531  * and configuration, parse options).
1532  *
1533  * @param argc number of command line arguments
1534  * @param argv command line arguments
1535  * @param serviceName our service name
1536  * @param opt service options
1537  * @param task main task of the service
1538  * @param task_cls closure for task
1539  * @return GNUNET_SYSERR on error, GNUNET_OK
1540  *         if we shutdown nicely
1541  */
1542 int
1543 GNUNET_SERVICE_run (int argc,
1544                     char *const *argv,
1545                     const char *serviceName,
1546                     enum GNUNET_SERVICE_Options opt,
1547                     GNUNET_SERVICE_Main task, void *task_cls)
1548 {
1549 #define HANDLE_ERROR do { err = 1; GNUNET_break (0); goto shutdown; } while (0)
1550
1551   int err;
1552   char *cfg_fn;
1553   char *loglev;
1554   char *logfile;
1555   int do_daemonize;
1556   unsigned int i;
1557   struct GNUNET_SERVICE_Context sctx;
1558   struct GNUNET_CONFIGURATION_Handle *cfg;
1559   struct GNUNET_GETOPT_CommandLineOption service_options[] = {
1560     GNUNET_GETOPT_OPTION_CFG_FILE (&cfg_fn),
1561     {'d', "daemonize", NULL,
1562      gettext_noop ("do daemonize (detach from terminal)"), 0,
1563      GNUNET_GETOPT_set_one, &do_daemonize},
1564     GNUNET_GETOPT_OPTION_HELP (serviceName),
1565     GNUNET_GETOPT_OPTION_LOGLEVEL (&loglev),
1566     GNUNET_GETOPT_OPTION_LOGFILE (&logfile),
1567     GNUNET_GETOPT_OPTION_VERSION (PACKAGE_VERSION),
1568     GNUNET_GETOPT_OPTION_END
1569   };
1570   err = 0;
1571   do_daemonize = 0;
1572   logfile = NULL;
1573   loglev = GNUNET_strdup ("WARNING");
1574   cfg_fn = GNUNET_strdup (GNUNET_DEFAULT_USER_CONFIG_FILE);
1575   memset (&sctx, 0, sizeof (sctx));
1576   sctx.options = opt;
1577   sctx.ready_confirm_fd = -1;
1578   sctx.ret = GNUNET_OK;
1579   sctx.timeout = GNUNET_TIME_UNIT_FOREVER_REL;
1580   sctx.maxbuf = GNUNET_SERVER_MAX_MESSAGE_SIZE - 1;
1581   sctx.task = task;
1582   sctx.serviceName = serviceName;
1583   sctx.cfg = cfg = GNUNET_CONFIGURATION_create ();
1584   /* setup subsystems */
1585   if (GNUNET_SYSERR == GNUNET_GETOPT_run (serviceName, service_options, argc,
1586       argv))    
1587     goto shutdown;
1588   if (GNUNET_OK != GNUNET_log_setup (serviceName, loglev, logfile))
1589     HANDLE_ERROR;
1590   if (GNUNET_OK != GNUNET_CONFIGURATION_load (cfg, cfg_fn))
1591     goto shutdown;
1592   if (GNUNET_OK != setup_service (&sctx))
1593     goto shutdown;
1594   if ( (do_daemonize == 1) && (GNUNET_OK != detach_terminal (&sctx)))    
1595     HANDLE_ERROR;
1596   if (GNUNET_OK != set_user_id (&sctx))
1597     goto shutdown;
1598 #if DEBUG_SERVICE
1599   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1600               "Service `%s' runs with configuration from `%s'\n",
1601               serviceName, cfg_fn);
1602 #endif
1603   /* actually run service */
1604   GNUNET_SCHEDULER_run (&service_task, &sctx);
1605
1606   /* shutdown */
1607   if ((do_daemonize == 1) && (sctx.server != NULL))
1608     pid_file_delete (&sctx);
1609   GNUNET_free_non_null (sctx.my_handlers);
1610
1611 shutdown:
1612   if (sctx.ready_confirm_fd != -1)
1613     {
1614       if (1 != WRITE (sctx.ready_confirm_fd, err ? "I" : "S", 1))
1615         GNUNET_log_strerror (GNUNET_ERROR_TYPE_WARNING, "write");
1616       GNUNET_break (0 == CLOSE (sctx.ready_confirm_fd));
1617     }
1618
1619   GNUNET_CONFIGURATION_destroy (cfg);
1620   i = 0;
1621   if (sctx.addrs != NULL)
1622     while (sctx.addrs[i] != NULL)    
1623       GNUNET_free (sctx.addrs[i++]);    
1624   GNUNET_free_non_null (sctx.addrs);
1625   GNUNET_free_non_null (sctx.addrlens);
1626   GNUNET_free_non_null (logfile);
1627   GNUNET_free (loglev);
1628   GNUNET_free (cfg_fn);
1629   GNUNET_free_non_null (sctx.v4_denied);
1630   GNUNET_free_non_null (sctx.v6_denied);
1631   GNUNET_free_non_null (sctx.v4_allowed);
1632   GNUNET_free_non_null (sctx.v6_allowed);
1633
1634   return err ? GNUNET_SYSERR : sctx.ret;
1635 }
1636
1637
1638 /**
1639  * Run a service startup sequence within an existing
1640  * initialized system.
1641  *
1642  * @param serviceName our service name
1643  * @param sched scheduler to use
1644  * @param cfg configuration to use
1645  * @return NULL on error, service handle
1646  */
1647 struct GNUNET_SERVICE_Context *
1648 GNUNET_SERVICE_start (const char *serviceName,
1649                       struct GNUNET_SCHEDULER_Handle *sched,
1650                       const struct GNUNET_CONFIGURATION_Handle *cfg)
1651 {
1652   int i;
1653   struct GNUNET_SERVICE_Context *sctx;
1654
1655   sctx = GNUNET_malloc (sizeof (struct GNUNET_SERVICE_Context));
1656   sctx->ready_confirm_fd = -1;  /* no daemonizing */
1657   sctx->ret = GNUNET_OK;
1658   sctx->timeout = GNUNET_TIME_UNIT_FOREVER_REL;
1659   sctx->maxbuf = GNUNET_SERVER_MAX_MESSAGE_SIZE;
1660   sctx->serviceName = serviceName;
1661   sctx->cfg = cfg;
1662   sctx->sched = sched;
1663
1664   /* setup subsystems */
1665   if (GNUNET_OK != setup_service (sctx))
1666     {
1667       GNUNET_SERVICE_stop (sctx);
1668       return NULL;
1669     }
1670   if (sctx->lsocks != NULL)
1671     sctx->server = GNUNET_SERVER_create_with_sockets (sched,
1672                                                       &check_access,
1673                                                       sctx,
1674                                                       sctx->lsocks,
1675                                                       sctx->maxbuf,
1676                                                       sctx->timeout, sctx->require_found);
1677   else
1678     sctx->server = GNUNET_SERVER_create (sched,
1679                                          &check_access,
1680                                          sctx,
1681                                          sctx->addrs,
1682                                          sctx->addrlens,
1683                                          sctx->maxbuf,
1684                                          sctx->timeout,
1685                                          sctx->require_found);
1686                                          
1687   if (NULL == sctx->server)
1688     {
1689       GNUNET_SERVICE_stop (sctx);
1690       return NULL;
1691     }
1692   sctx->my_handlers = GNUNET_malloc (sizeof (defhandlers));
1693   memcpy (sctx->my_handlers, defhandlers, sizeof (defhandlers));
1694   i = 0;
1695   while ((sctx->my_handlers[i].callback != NULL))
1696     sctx->my_handlers[i++].callback_cls = sctx;
1697   GNUNET_SERVER_add_handlers (sctx->server, sctx->my_handlers);
1698   return sctx;
1699 }
1700
1701 /**
1702  * Obtain the server used by a service.  Note that the server must NOT
1703  * be destroyed by the caller.
1704  *
1705  * @param ctx the service context returned from the start function
1706  * @return handle to the server for this service, NULL if there is none
1707  */
1708 struct GNUNET_SERVER_Handle *
1709 GNUNET_SERVICE_get_server (struct GNUNET_SERVICE_Context *ctx)
1710 {
1711   return ctx->server;
1712 }
1713
1714
1715 /**
1716  * Stop a service that was started with "GNUNET_SERVICE_start".
1717  *
1718  * @param sctx the service context returned from the start function
1719  */
1720 void
1721 GNUNET_SERVICE_stop (struct GNUNET_SERVICE_Context *sctx)
1722 {
1723   unsigned int i;
1724   if (NULL != sctx->server)
1725     GNUNET_SERVER_destroy (sctx->server);
1726   GNUNET_free_non_null (sctx->my_handlers);
1727   if (sctx->addrs != NULL)
1728     {
1729       i = 0;
1730       while (sctx->addrs[i] != NULL)    
1731         GNUNET_free (sctx->addrs[i++]);    
1732       GNUNET_free (sctx->addrs);
1733     }
1734   GNUNET_free_non_null (sctx->addrlens);
1735   GNUNET_free_non_null (sctx->v4_denied);
1736   GNUNET_free_non_null (sctx->v6_denied);
1737   GNUNET_free_non_null (sctx->v4_allowed);
1738   GNUNET_free_non_null (sctx->v6_allowed);
1739   GNUNET_free (sctx);
1740 }
1741
1742
1743 /* end of service.c */