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 it
   6      under the terms of the GNU Affero General Public License as published
   7      by the Free Software Foundation, either version 3 of the License,
   8      or (at your 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      Affero General Public License for more details.
  14
  15      You should have received a copy of the GNU Affero General Public License
  16      along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18      SPDX-License-Identifier: AGPL3.0-or-later
  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, NULL);
  89 }
  90
  91
  92 /**
  93  * Define "main" method using service macro.
  94  */
  95 GNUNET_SERVICE_MAIN ("template",
  96                      GNUNET_SERVICE_OPTION_NONE,
  97                      &run,
  98                      &client_connect_cb,
  99                      &client_disconnect_cb,
 100                      NULL,
 101                      GNUNET_MQ_handler_end ());
 102
 103
 104 /* end of gnunet-service-template.c */