src/arm/arm.h

   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 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., 59 Temple Place - Suite 330,
  18      Boston, MA 02111-1307, USA.
  19 */
  20
  21 /**
  22  * @author Christian Grothoff
  23  * @file arm/arm.h
  24  */
  25 #ifndef ARM_H
  26 #define ARM_H
  27
  28 #include "gnunet_common.h"
  29
  30 /**
  31  * This option will turn on the DEBUG loglevel for
  32  * all processes controlled by this ARM!
  33  */
  34 #define DEBUG_ARM GNUNET_EXTRA_LOGGING
  35
  36 GNUNET_NETWORK_STRUCT_BEGIN
  37
  38 /**
  39  * Status update from ARM to client.
  40  */
  41 struct GNUNET_ARM_StatusMessage
  42 {
  43
  44   /**
  45    * Reply to client, of type is GNUNET_MESSAGE_TYPE_ARM_STATUS.
  46    */
  47   struct GNUNET_MessageHeader header;
  48
  49   /**
  50    * Status from the 'enum GNUNET_ARM_ServiceStatus'
  51    */
  52   uint32_t status;
  53
  54   /* followed by a 0-terminated service name */
  55 };
  56
  57 struct GNUNET_ARM_Message
  58 {
  59   /**
  60    * Reply to client, type is #GNUNET_MESSAGE_TYPE_ARM_RESULT or
  61    * #GNUNET_MESSAGE_TYPE_ARM_LIST_RESULT.
  62    * OR
  63    * Request from client, type is #GNUNET_MESSAGE_TYPE_ARM_REQUEST
  64    */
  65   struct GNUNET_MessageHeader header;
  66
  67   /**
  68    * For alignment.
  69    */
  70   uint32_t reserved;
  71
  72   /**
  73    * ID of a request that is being replied to.
  74    * OR
  75    * ID of a request that is being sent.
  76    */
  77   uint64_t request_id;
  78
  79   /* For requests - followed by a 0-terminated service name */
  80 };
  81
  82
  83 /**
  84  * Reply from ARM to client.
  85  */
  86 struct GNUNET_ARM_ResultMessage
  87 {
  88
  89   /**
  90    * Reply to client, of type is GNUNET_MESSAGE_TYPE_ARM_RESULT, with an ID.
  91    */
  92   struct GNUNET_ARM_Message arm_msg;
  93
  94   /**
  95    * Result from the 'enum GNUNET_ARM_Result'
  96    */
  97   uint32_t result;
  98 };
  99
 100 /**
 101  * Reply from ARM to client for the
 102  * GNUNET_MESSAGE_TYPE_ARM_LIST request followed by count
 103  * '\0' terminated strings. header->size contains the
 104  * total size (including all strings).
 105  */
 106 struct GNUNET_ARM_ListResultMessage
 107 {
 108   /**
 109    * Reply to client, of type is GNUNET_MESSAGE_TYPE_ARM_LIST_RESULT,
 110    * with an ID.
 111    */
 112   struct GNUNET_ARM_Message arm_msg;
 113
 114   /**
 115    * Number of '\0' terminated strings that follow
 116    * this message.
 117    */
 118   uint16_t count;
 119 };
 120
 121 GNUNET_NETWORK_STRUCT_END
 122
 123 #endif