src/template/gnunet-service-template.c

   1 /*
   2      This file is part of GNUnet.
   3      Copyright (C) 2009 GNUnet e.V.
   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 3, 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., 51 Franklin Street, Fifth Floor,
  18      Boston, MA 02110-1301, USA.
  19 */
  20
  21 /**
  22  * @file template/gnunet-service-template.c
  23  * @brief program that does template
  24  * @author Christian Grothoff
  25  */
  26 #include "platform.h"
  27 #include "gnunet_util_lib.h"
  28
  29
  30 /**
  31  * Task run during shutdown.
  32  *
  33  * @param cls unused
  34  */
  35 static void
  36 cleanup_task (void *cls)
  37 {
  38   /* FIXME: do clean up here */
  39 }
  40
  41
  42 /**
  43  * Callback called when a client connects to the service.
  44  *
  45  * @param cls closure for the service
  46  * @param c the new client that connected to the service
  47  * @param mq the message queue used to send messages to the client
  48  * @return @a c
  49  */
  50 static void *
  51 client_connect_cb (void *cls,
  52                    struct GNUNET_SERVICE_Client *c,
  53                    struct GNUNET_MQ_Handle *mq)
  54 {
  55   return c;
  56 }
  57
  58
  59 /**
  60  * Callback called when a client disconnected from the service
  61  *
  62  * @param cls closure for the service
  63  * @param c the client that disconnected
  64  * @param internal_cls should be equal to @a c
  65  */
  66 static void
  67 client_disconnect_cb (void *cls,
  68                       struct GNUNET_SERVICE_Client *c,
  69                       void *internal_cls)
  70 {
  71   GNUNET_assert (c == internal_cls);
  72 }
  73
  74
  75 /**
  76  * Process template requests.
  77  *
  78  * @param cls closure
  79  * @param cfg configuration to use
  80  * @param service the initialized service
  81  */
  82 static void
  83 run (void *cls,
  84      const struct GNUNET_CONFIGURATION_Handle *cfg,
  85      struct GNUNET_SERVICE_Handle *service)
  86 {
  87   /* FIXME: do setup here */
  88   GNUNET_SCHEDULER_add_shutdown (&cleanup_task,
  89                                  NULL);
  90 }
  91
  92
  93 /**
  94  * Define "main" method using service macro.
  95  */
  96 GNUNET_SERVICE_MAIN
  97 ("template",
  98  GNUNET_SERVICE_OPTION_NONE,
  99  &run,
 100  &client_connect_cb,
 101  &client_disconnect_cb,
 102  NULL,
 103  GNUNET_MQ_handler_end ());
 104
 105
 106 /* end of gnunet-service-template.c */