2 This file is part of GNUnet
3 (C) 2012 Christian Grothoff (and other contributing authors)
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.
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.
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.
21 #include "gnunet_gns_service.h"
25 * @brief IPC messages between GNS API and GNS service
26 * @author Martin Schanzenbach
31 #define GNUNET_GNS_TLD "gnunet"
32 #define GNUNET_GNS_TLD_ZKEY "zkey"
33 #define GNUNET_GNS_DHT_MAX_UPDATE_INTERVAL 3600
35 #define MAX_DNS_LABEL_LENGTH 63
36 #define MAX_DNS_NAME_LENGTH 253
38 GNUNET_NETWORK_STRUCT_BEGIN
41 * Message from client to GNS service to lookup records.
43 struct GNUNET_GNS_ClientLookupMessage
46 * Header of type GNUNET_MESSAGE_TYPE_GNS_CLIENT_LOOKUP
48 struct GNUNET_MessageHeader header;
51 * Unique identifier for this request (for key collisions).
53 uint32_t id GNUNET_PACKED;
56 * Only check cached results
58 uint32_t only_cached GNUNET_PACKED;
61 * Should we look up in the default zone?
63 uint32_t use_default_zone GNUNET_PACKED;
66 * Is a shorten key attached?
68 uint32_t have_key GNUNET_PACKED;
71 * If use_default_zone is empty this zone is used for lookup
73 struct GNUNET_CRYPTO_ShortHashCode zone;
76 * the type of record to look up
78 enum GNUNET_GNS_RecordType type;
80 /* Followed by the key for shorten (optional) see have_key */
82 /* Followed by the name to look up */
87 * Message from GNS service to client: new results.
89 struct GNUNET_GNS_ClientLookupResultMessage
92 * Header of type GNUNET_MESSAGE_TYPE_GNS_CLIENT_RESULT
94 struct GNUNET_MessageHeader header;
97 * Unique identifier for this request (for key collisions).
99 uint32_t id GNUNET_PACKED;
102 * The number of records contained in response
106 // FIXME: what format has a GNS_Record?
107 /* followed by rd_count GNUNET_NAMESTORE_RecordData structs*/
112 * Message from client to GNS service to shorten names.
114 struct GNUNET_GNS_ClientShortenMessage
117 * Header of type GNUNET_MESSAGE_TYPE_GNS_CLIENT_SHORTEN
119 struct GNUNET_MessageHeader header;
122 * Unique identifier for this request
124 uint32_t id GNUNET_PACKED;
127 * Should we look up in the default zone?
129 uint32_t use_default_zone GNUNET_PACKED;
132 * If use_default_zone is empty this zone is used for lookup
134 struct GNUNET_CRYPTO_ShortHashCode zone;
136 /* Followed by the name to shorten up */
141 * Message from GNS service to client: shorten result.
143 struct GNUNET_GNS_ClientShortenResultMessage
146 * Header of type GNUNET_MESSAGE_TYPE_GNS_CLIENT_SHORTEN_RESULT
148 struct GNUNET_MessageHeader header;
151 * Unique identifier for this request (for key collisions).
153 uint32_t id GNUNET_PACKED;
155 /* followed by the shortened name or '\0' for no result*/
160 * Message from client to GNS service to lookup an authority of a name.
162 struct GNUNET_GNS_ClientGetAuthMessage
165 * Header of type GNUNET_MESSAGE_TYPE_GNS_CLIENT_GET_AUTH
167 struct GNUNET_MessageHeader header;
170 * Unique identifier for this request
172 uint32_t id GNUNET_PACKED;
174 /* Followed by the name to get authority for */
179 * Message from GNS service to client: authority result.
181 struct GNUNET_GNS_ClientGetAuthResultMessage
184 * Header of type GNUNET_MESSAGE_TYPE_GNS_CLIENT_GET_AUTH_RESULT
186 struct GNUNET_MessageHeader header;
189 * Unique identifier for this request (for key collisions).
191 uint32_t id GNUNET_PACKED;
193 /* followed by the authority part of the name or '\0' for no result*/
196 GNUNET_NETWORK_STRUCT_END