2 This file is part of GNUnet.
3 (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2009, 2010 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.
22 * @file include/gnunet_protocols.h
23 * @brief constants for network protocols
24 * @author Christian Grothoff
27 #ifndef GNUNET_PROTOCOLS_H
28 #define GNUNET_PROTOCOLS_H
33 #if 0 /* keep Emacsens' auto-indent happy */
39 * Test if service is online.
41 #define GNUNET_MESSAGE_TYPE_TEST 0
45 * Request DNS resolution.
47 #define GNUNET_MESSAGE_TYPE_RESOLVER_REQUEST 2
50 * Response to a DNS resolution request.
52 #define GNUNET_MESSAGE_TYPE_RESOLVER_RESPONSE 3
56 * Set a statistical value.
58 #define GNUNET_MESSAGE_TYPE_STATISTICS_SET 4
61 * Get a statistical value(s).
63 #define GNUNET_MESSAGE_TYPE_STATISTICS_GET 5
66 * Response to a STATISTICS_GET message (with value).
68 #define GNUNET_MESSAGE_TYPE_STATISTICS_VALUE 6
71 * Response to a STATISTICS_GET message (end of value stream).
73 #define GNUNET_MESSAGE_TYPE_STATISTICS_END 7
77 * Request to ARM to start a service.
79 #define GNUNET_MESSAGE_TYPE_ARM_START 8
82 * Request to ARM to stop a service.
84 #define GNUNET_MESSAGE_TYPE_ARM_STOP 9
87 * Response from ARM: service is now up.
89 #define GNUNET_MESSAGE_TYPE_ARM_IS_UP 10
92 * Response from ARM: service is now down.
93 * (failed to start it or shut it down).
95 #define GNUNET_MESSAGE_TYPE_ARM_IS_DOWN 11
98 * Response from ARM: service status is unknown.
100 #define GNUNET_MESSAGE_TYPE_ARM_IS_UNKNOWN 12
103 * Request ARM service shutdown.
105 #define GNUNET_MESSAGE_TYPE_ARM_SHUTDOWN 13
108 * Acknowledge service shutting down, disconnect
109 * indicates service stopped.
111 #define GNUNET_MESSAGE_TYPE_ARM_SHUTDOWN_ACK 14
114 * HELLO message used for communicating peer addresses.
115 * Managed by libgnunethello.
117 #define GNUNET_MESSAGE_TYPE_HELLO 16
120 * FRAGMENT of a larger message.
121 * Managed by libgnunetfragment.
123 #define GNUNET_MESSAGE_TYPE_FRAGMENT 18
127 * Message from the core saying that the transport
128 * server should start giving it messages. This
129 * should automatically trigger the transmission of
132 #define GNUNET_MESSAGE_TYPE_TRANSPORT_START 20
135 * Message from TRANSPORT notifying about a
136 * client that connected to us.
138 #define GNUNET_MESSAGE_TYPE_TRANSPORT_CONNECT 21
141 * Message from TRANSPORT notifying about a
142 * client that disconnected from us.
144 #define GNUNET_MESSAGE_TYPE_TRANSPORT_DISCONNECT 22
147 * Request to TRANSPORT to transmit a message.
149 #define GNUNET_MESSAGE_TYPE_TRANSPORT_SEND 23
152 * Confirmation from TRANSPORT that message for
153 * transmission has been queued (and that the next
154 * message to this peer can now be passed to the
155 * service). Note that this confirmation does NOT
156 * imply that the message was fully transmitted.
158 #define GNUNET_MESSAGE_TYPE_TRANSPORT_SEND_OK 24
161 * Message from TRANSPORT notifying about a
162 * message that was received.
164 #define GNUNET_MESSAGE_TYPE_TRANSPORT_RECV 25
167 * Message telling transport to limit its receive rate.
169 #define GNUNET_MESSAGE_TYPE_TRANSPORT_SET_QUOTA 26
172 * Request to look addresses of peers in server.
174 #define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_LOOKUP 27
177 * Response to the address lookup request.
179 #define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_REPLY 28
182 * Register a client that wants to do blacklisting.
184 #define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_INIT 29
187 * Query to a blacklisting client (is this peer blacklisted)?
189 #define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_QUERY 30
193 * Reply from blacklisting client (answer to blacklist query).
195 #define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_REPLY 31
198 * Transport PING message
200 #define GNUNET_MESSAGE_TYPE_TRANSPORT_PING 32
203 * Transport PONG message
205 #define GNUNET_MESSAGE_TYPE_TRANSPORT_PONG 33
208 * Request update and listing of a peer.
210 #define GNUNET_MESSAGE_TYPE_PEERINFO_GET 37
213 * Request update and listing of all peers.
215 #define GNUNET_MESSAGE_TYPE_PEERINFO_GET_ALL 38
218 * Information about one of the peers.
220 #define GNUNET_MESSAGE_TYPE_PEERINFO_INFO 39
223 * End of information about other peers.
225 #define GNUNET_MESSAGE_TYPE_PEERINFO_INFO_END 40
228 * Start notifying this client about all changes to
229 * the known peers until it disconnects.
231 #define GNUNET_MESSAGE_TYPE_PEERINFO_NOTIFY 41
234 * DV service to DV Plugin message, when a message is
235 * unwrapped by the DV service and handed to the plugin
238 #define GNUNET_MESSAGE_TYPE_TRANSPORT_DV_RECEIVE 44
241 * DV Plugin to DV service message, indicating a message
242 * should be sent out.
244 #define GNUNET_MESSAGE_TYPE_TRANSPORT_DV_SEND 45
247 * DV service to DV api message, containing a confirmation
248 * or failure of a DV_SEND message.
250 #define GNUNET_MESSAGE_TYPE_TRANSPORT_DV_SEND_RESULT 46
253 * P2P DV message encapsulating some real message
255 #define GNUNET_MESSAGE_TYPE_DV_DATA 47
258 * P2P DV message gossipping peer information
260 #define GNUNET_MESSAGE_TYPE_DV_GOSSIP 48
263 * DV Plugin to DV service message, indicating
266 #define GNUNET_MESSAGE_TYPE_DV_START 49
269 * P2P DV message notifying connected peers of a disconnect
271 #define GNUNET_MESSAGE_TYPE_DV_DISCONNECT 50
274 * TCP NAT probe message, send from NAT'd peer to
275 * other peer to establish bi-directional communication
277 #define GNUNET_MESSAGE_TYPE_TRANSPORT_TCP_NAT_PROBE 51
280 * Normal UDP message type.
282 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_MESSAGE 52
285 * Fragmented part of a UDP message.
287 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_MESSAGE_PART 53
290 * UDP NAT probe message, send from NAT'd peer to
291 * other peer to negotiate punched address/port
293 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_NAT_PROBE 55
296 * UDP NAT probe reply, sent from a non-NAT'd peer to
297 * a NAT'd one to inform it we got the probe and of the
300 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_NAT_PROBE_REPLY 56
303 * UDP NAT probe confirmation, sent from a NAT'd peer to
304 * a non-NAT'd one to inform it which port to send to us
307 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_NAT_PROBE_CONFIRM 57
310 * UDP NAT probe keepalive, once a hole is punched the NAT'd peer
311 * needs to keep the hole alive
313 #define GNUNET_MESSAGE_TYPE_TRANSPORT_UDP_NAT_PROBE_KEEPALIVE 58
316 * Welcome message between TCP transports.
318 #define GNUNET_MESSAGE_TYPE_TRANSPORT_TCP_WELCOME 60
321 * Initial setup message from core client to core.
323 #define GNUNET_MESSAGE_TYPE_CORE_INIT 64
326 * Response from core to core client to INIT message.
328 #define GNUNET_MESSAGE_TYPE_CORE_INIT_REPLY 65
331 * Notify clients about new peer-to-peer connections (before
332 * key exchange and authentication).
334 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_PRE_CONNECT 66
337 * Notify clients about new peer-to-peer connections (triggered
338 * after key exchange).
340 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_CONNECT 67
343 * Notify clients about peer disconnecting.
345 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_DISCONNECT 68
348 * Notify clients about incoming P2P messages.
350 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_INBOUND 69
353 * Notify clients about outgoing P2P transmissions.
355 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_OUTBOUND 70
358 * Request from client to "configure" P2P connection.
360 #define GNUNET_MESSAGE_TYPE_CORE_REQUEST_INFO 71
363 * Response from server about (possibly updated) P2P
364 * connection configuration.
366 #define GNUNET_MESSAGE_TYPE_CORE_CONFIGURATION_INFO 72
369 * Request from client with message to transmit.
371 #define GNUNET_MESSAGE_TYPE_CORE_SEND 73
374 * Request from client asking to connect to a peer.
376 #define GNUNET_MESSAGE_TYPE_CORE_REQUEST_CONNECT 74
380 * Session key exchange between peers.
382 #define GNUNET_MESSAGE_TYPE_CORE_SET_KEY 80
385 * Encapsulation for an encrypted message between peers.
387 #define GNUNET_MESSAGE_TYPE_CORE_ENCRYPTED_MESSAGE 81
390 * Check that other peer is alive (challenge).
392 #define GNUNET_MESSAGE_TYPE_CORE_PING 82
395 * Confirmation that other peer is alive.
397 #define GNUNET_MESSAGE_TYPE_CORE_PONG 83
400 * Request by the other peer to terminate the connection.
402 #define GNUNET_MESSAGE_TYPE_CORE_HANGUP 84
405 * Message sent by datastore client on join.
407 #define GNUNET_MESSAGE_TYPE_DATASTORE_RESERVE 92
410 * Message sent by datastore client on join.
412 #define GNUNET_MESSAGE_TYPE_DATASTORE_RELEASE_RESERVE 93
415 * Message sent by datastore to client informing about status
416 * processing a request
417 * (in response to RESERVE, RELEASE_RESERVE, PUT, UPDATE and REMOVE requests).
419 #define GNUNET_MESSAGE_TYPE_DATASTORE_STATUS 94
422 * Message sent by datastore client to store data.
424 #define GNUNET_MESSAGE_TYPE_DATASTORE_PUT 95
427 * Message sent by datastore client to update data.
429 #define GNUNET_MESSAGE_TYPE_DATASTORE_UPDATE 96
432 * Message sent by datastore client to get data.
434 #define GNUNET_MESSAGE_TYPE_DATASTORE_GET 97
437 * Message sent by datastore client to get random data.
439 #define GNUNET_MESSAGE_TYPE_DATASTORE_GET_RANDOM 98
442 * Message sent by datastore to client providing requested data
443 * (in response to GET or GET_RANDOM request).
445 #define GNUNET_MESSAGE_TYPE_DATASTORE_DATA 99
448 * Message sent by datastore to client signaling end of matching data.
449 * This message will also be sent for "GET_RANDOM", even though
450 * "GET_RANDOM" returns at most one data item.
452 #define GNUNET_MESSAGE_TYPE_DATASTORE_DATA_END 100
455 * Message sent by datastore client to remove data.
457 #define GNUNET_MESSAGE_TYPE_DATASTORE_REMOVE 101
460 * Message sent by datastore client to drop the database.
462 #define GNUNET_MESSAGE_TYPE_DATASTORE_DROP 102
466 * Message sent by fs client to start indexing.
468 #define GNUNET_MESSAGE_TYPE_FS_INDEX_START 128
471 * Affirmative response to a request for start indexing.
473 #define GNUNET_MESSAGE_TYPE_FS_INDEX_START_OK 129
476 * Response to a request for start indexing that
479 #define GNUNET_MESSAGE_TYPE_FS_INDEX_START_FAILED 130
482 * Request from client for list of indexed files.
484 #define GNUNET_MESSAGE_TYPE_FS_INDEX_LIST_GET 131
487 * Reply to client with an indexed file name.
489 #define GNUNET_MESSAGE_TYPE_FS_INDEX_LIST_ENTRY 132
492 * Reply to client indicating end of list.
494 #define GNUNET_MESSAGE_TYPE_FS_INDEX_LIST_END 133
497 * Request from client to unindex a file.
499 #define GNUNET_MESSAGE_TYPE_FS_UNINDEX 134
502 * Reply to client indicating unindex receipt.
504 #define GNUNET_MESSAGE_TYPE_FS_UNINDEX_OK 135
507 * Client asks FS service to start a (keyword) search.
509 #define GNUNET_MESSAGE_TYPE_FS_START_SEARCH 136
512 * P2P request for content (one FS to another).
514 #define GNUNET_MESSAGE_TYPE_FS_GET 137
517 * P2P response with content or active migration of content. Also
518 * used between the service and clients (in response to START_SEARCH).
520 #define GNUNET_MESSAGE_TYPE_FS_PUT 138
528 * Local and P2P generic DHT message start type
530 #define GNUNET_MESSAGE_TYPE_DHT_ROUTE 142
533 * Local and P2P generic DHT message start type
535 #define GNUNET_MESSAGE_TYPE_DHT_ROUTE_RESULT 143
538 * Local and P2P generic DHT message stop type
540 #define GNUNET_MESSAGE_TYPE_DHT_STOP 144
543 * Local and message acknowledgment
545 #define GNUNET_MESSAGE_TYPE_DHT_ACK 145
548 * Local DHT Put message, from API to service
550 #define GNUNET_MESSAGE_TYPE_DHT_PUT 146
553 * Local DHT Get message, from API to service
555 #define GNUNET_MESSAGE_TYPE_DHT_GET 147
558 * Local DHT Get stop message, from API to service
560 #define GNUNET_MESSAGE_TYPE_DHT_GET_STOP 148
563 * Local DHT Get result message, from service to API
565 #define GNUNET_MESSAGE_TYPE_DHT_GET_RESULT 149
568 * Local DHT Get message, from API to service
570 #define GNUNET_MESSAGE_TYPE_DHT_FIND_PEER 150
573 * Local DHT Get stop message, from API to service
575 #define GNUNET_MESSAGE_TYPE_DHT_FIND_PEER_STOP 151
578 * Local DHT find peer result message, from service to API
580 #define GNUNET_MESSAGE_TYPE_DHT_FIND_PEER_RESULT 152
583 * Hostlist advertisement message
585 #define GNUNET_MESSAGE_TYPE_HOSTLIST_ADVERTISEMENT 160
588 * Type used to match 'all' message types.
590 #define GNUNET_MESSAGE_TYPE_ALL 65535
596 - applications (FS, VPN, CHAT, TRACEKIT, TBENCH)
600 #if 0 /* keep Emacsens' auto-indent happy */
607 /* ifndef GNUNET_PROTOCOLS_H */
609 /* end of gnunet_protocols.h */