-defining proper structs for vpn-exit mesh communication
[oweals/gnunet.git] / src / include / gnunet_protocols.h
index 1b03835bfd0558fe7a456a38080617f67e818092..5257e2587accd45c0ab5af51a5013b5c454c73b0 100644 (file)
@@ -44,6 +44,11 @@ extern "C"
  */
 #define GNUNET_MESSAGE_TYPE_TEST 1
 
+/**
+ * Dummy messages for testing / benchmarking.
+ */
+#define GNUNET_MESSAGE_TYPE_DUMMY 2
+
 /*******************************************************************************
  * RESOLVER message types
  ******************************************************************************/
@@ -73,31 +78,15 @@ extern "C"
 #define GNUNET_MESSAGE_TYPE_ARM_STOP 9
 
 /**
- * Response from ARM: service is now up.
- */
-#define GNUNET_MESSAGE_TYPE_ARM_IS_UP 10
-
-/**
- * Response from ARM: service is now down.
- * (failed to start it or shut it down).
+ * Request ARM service itself to shutdown.
  */
-#define GNUNET_MESSAGE_TYPE_ARM_IS_DOWN 11
+#define GNUNET_MESSAGE_TYPE_ARM_SHUTDOWN 10
 
 /**
- * Response from ARM: service status is unknown.
+ * Response from ARM.
  */
-#define GNUNET_MESSAGE_TYPE_ARM_IS_UNKNOWN 12
+#define GNUNET_MESSAGE_TYPE_ARM_RESULT 11
 
-/**
- * Request ARM service shutdown.
- */
-#define GNUNET_MESSAGE_TYPE_ARM_SHUTDOWN 13
-
-/**
- * Acknowledge service shutting down, disconnect
- * indicates service stopped.
- */
-#define GNUNET_MESSAGE_TYPE_ARM_SHUTDOWN_ACK 14
 
 /*******************************************************************************
  * HELLO message types
@@ -125,122 +114,6 @@ extern "C"
  */
 #define GNUNET_MESSAGE_TYPE_FRAGMENT_ACK 19
 
-/*******************************************************************************
- * TRANSPORT message types
- ******************************************************************************/
-
-/**
- * Message from the core saying that the transport
- * server should start giving it messages.  This
- * should automatically trigger the transmission of
- * a HELLO message.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_START 20
-
-/**
- * Message from TRANSPORT notifying about a
- * client that connected to us.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_CONNECT 21
-
-/**
- * Message from TRANSPORT notifying about a
- * client that disconnected from us.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_DISCONNECT 22
-
-/**
- * Request to TRANSPORT to transmit a message.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_SEND 23
-
-/**
- * Confirmation from TRANSPORT that message for transmission has been
- * queued (and that the next message to this peer can now be passed to
- * the service).  Note that this confirmation does NOT imply that the
- * message was fully transmitted.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_SEND_OK 24
-
-/**
- * Message from TRANSPORT notifying about a
- * message that was received.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_RECV 25
-
-/**
- * Message telling transport to limit its receive rate.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_SET_QUOTA 26
-
-/**
- * Request to look addresses of peers in server.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_LOOKUP 27
-
-/**
- * Response to the address lookup request.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_REPLY 28
-
-/**
- * Register a client that wants to do blacklisting.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_INIT 29
-
-/**
- * Query to a blacklisting client (is this peer blacklisted)?
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_QUERY 30
-
-/**
- * Reply from blacklisting client (answer to blacklist query).
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_REPLY 31
-
-/**
- * Transport PING message
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_PING 32
-
-/**
- * Transport PONG message
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_PONG 33
-
-/**
- * Message for transport service from a client asking that a
- * connection be initiated with another peer.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_REQUEST_CONNECT 34
-
-/**
- * Transport CONNECT message exchanged between transport services to
- * indicate that a session should be marked as 'connected'.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_CONNECT 35
-
-/**
- * Transport DISCONNECT message exchanged between transport services to
- * indicate that a connection should be dropped.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_DISCONNECT 36
-
-/**
- * Request to look up addresses of peers.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_PEER_ADDRESS_LOOKUP 37
-
-/**
- * Request to iterate over all known addresses.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_ITERATE 38
-
-/**
- * Message send by a peer to notify the other to keep the session alive.
- */
-#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_KEEPALIVE 39
-
 /*******************************************************************************
  * Transport-WLAN message types
  ******************************************************************************/
@@ -401,17 +274,6 @@ extern "C"
  */
 #define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_OUTBOUND 71
 
-/**
- * Request from client to "configure" P2P connection.
- */
-#define GNUNET_MESSAGE_TYPE_CORE_REQUEST_INFO 72
-
-/**
- * Response from server about (possibly updated) P2P
- * connection configuration.
- */
-#define GNUNET_MESSAGE_TYPE_CORE_CONFIGURATION_INFO 73
-
 /**
  * Request from client to transmit message.
  */
@@ -428,10 +290,6 @@ extern "C"
  */
 #define GNUNET_MESSAGE_TYPE_CORE_SEND 76
 
-/**
- * Request from client asking to connect to a peer.
- */
-#define GNUNET_MESSAGE_TYPE_CORE_REQUEST_CONNECT 77
 
 /**
  * Request for peer iteration from CORE service.
@@ -625,81 +483,60 @@ extern "C"
  ******************************************************************************/
 
 /**
- * Local DHT route request type
- */
-#define GNUNET_MESSAGE_TYPE_DHT_LOCAL_ROUTE 142
-
-/**
- * Local generic DHT route result type
- */
-#define GNUNET_MESSAGE_TYPE_DHT_LOCAL_ROUTE_RESULT 143
-
-/**
- * P2P DHT route request type
+ * Client wants to store item in DHT.
  */
-#define GNUNET_MESSAGE_TYPE_DHT_P2P_ROUTE 144
+#define GNUNET_MESSAGE_TYPE_DHT_CLIENT_PUT 142
 
 /**
- * P2P DHT route result type
+ * Client wants to lookup item in DHT.
  */
-#define GNUNET_MESSAGE_TYPE_DHT_P2P_ROUTE_RESULT 145
+#define GNUNET_MESSAGE_TYPE_DHT_CLIENT_GET 143
 
 /**
- * Local generic DHT message stop type
+ * Client wants to stop search in DHT.
  */
-#define GNUNET_MESSAGE_TYPE_DHT_LOCAL_ROUTE_STOP 146
+#define GNUNET_MESSAGE_TYPE_DHT_CLIENT_GET_STOP 144
 
 /**
- * Local and P2P DHT PUT message
- * (encapsulated in DHT_ROUTE message)
+ * Service returns result to client.
  */
-#define GNUNET_MESSAGE_TYPE_DHT_PUT 147
+#define GNUNET_MESSAGE_TYPE_DHT_CLIENT_RESULT 145
 
 /**
- * Local and P2P DHT GET message
- * (encapsulated in DHT_ROUTE message)
+ * Peer is storing data in DHT.
  */
-#define GNUNET_MESSAGE_TYPE_DHT_GET 148
+#define GNUNET_MESSAGE_TYPE_DHT_P2P_PUT 146
 
 /**
- * Local and P2P DHT Get result message
+ * Peer tries to find data in DHT.
  */
-#define GNUNET_MESSAGE_TYPE_DHT_GET_RESULT 149
+#define GNUNET_MESSAGE_TYPE_DHT_P2P_GET 147
 
 /**
- * Local and P2P DHT find peer message
+ * Data is returned to peer from DHT.
  */
-#define GNUNET_MESSAGE_TYPE_DHT_FIND_PEER 150
+#define GNUNET_MESSAGE_TYPE_DHT_P2P_RESULT 148
 
 /**
- * Local and P2P DHT find peer result message
+ * Request / receive information about transiting GETs
  */
-#define GNUNET_MESSAGE_TYPE_DHT_FIND_PEER_RESULT 151
-
+#define GNUNET_MESSAGE_TYPE_DHT_MONITOR_GET             149
 
 /**
- * DHT Control message type, for telling the
- * DHT to alter its current operation somehow.
+ * Request / receive information about transiting GET responses
  */
-#define GNUNET_MESSAGE_TYPE_DHT_CONTROL 153
+#define GNUNET_MESSAGE_TYPE_DHT_MONITOR_GET_RESP        150
 
 /**
- * Local control message type, tells peer to start
- * issuing malicious GET requests.
+ * Request / receive information about transiting PUTs
  */
-#define GNUNET_MESSAGE_TYPE_DHT_MALICIOUS_GET 154
+#define GNUNET_MESSAGE_TYPE_DHT_MONITOR_PUT             151
 
 /**
- * Local control message type, tells peer to start
- * issuing malicious PUT requests.
+ * Request / receive information about transiting PUT responses (TODO)
  */
-#define GNUNET_MESSAGE_TYPE_DHT_MALICIOUS_PUT 155
+#define GNUNET_MESSAGE_TYPE_DHT_MONITOR_PUT_RESP        152
 
-/**
- * Local control message type, tells peer to start
- * dropping all requests.
- */
-#define GNUNET_MESSAGE_TYPE_DHT_MALICIOUS_DROP  156
 
 /*******************************************************************************
  * HOSTLIST message types
@@ -797,6 +634,57 @@ extern "C"
 #define GNUNET_MESSAGE_TYPE_VPN_REMOTE_TCP_BACK 193
 
 
+
+/**
+ * Type of messages containing an TCP packet for a service.
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_TCP_TO_SERVICE_START 196
+
+/**
+ * Type of messages containing an TCP packet for the Internet.
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_TCP_TO_INTERNET_START 197
+
+/**
+ * Type of messages containing an TCP packet of an established connection.
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_TCP_DATA 198
+
+/**
+ * Type of messages containing an UDP packet for a service.
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_UDP_TO_SERVICE 199
+
+/**
+ * Type of messages containing an UDP packet for the Internet.
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_UDP_TO_INTERNET 200
+
+/**
+ * Type of messages containing an UDP packet from a remote host
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_UDP_REPLY 201
+
+
+/**
+ * Client asks VPN service to setup an IP to redirect traffic
+ * via an exit node to some global IP address.
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_CLIENT_REDIRECT_TO_IP 202
+
+/**
+ * Client asks VPN service to setup an IP to redirect traffic
+ * to some peer offering a service.
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_CLIENT_REDIRECT_TO_SERVICE 203
+
+/**
+ * VPN service responds to client with an IP to use for the
+ * requested redirection.
+ */
+#define GNUNET_MESSAGE_TYPE_VPN_CLIENT_USE_IP 204
+
+
 /*******************************************************************************
  * VPN-DNS message types
  ******************************************************************************/
@@ -822,6 +710,25 @@ extern "C"
  */
 #define GNUNET_MESSAGE_TYPE_VPN_REMOTE_ANSWER_DNS 209
 
+/**
+ * Initial message from client to DNS service for registration.
+ */
+#define GNUNET_MESSAGE_TYPE_DNS_CLIENT_INIT 211
+
+/**
+ * Type of messages between the gnunet-helper-dns and the service
+ */
+#define GNUNET_MESSAGE_TYPE_DNS_CLIENT_REQUEST 212
+
+/**
+ * Type of messages between the gnunet-helper-dns and the service
+ */
+#define GNUNET_MESSAGE_TYPE_DNS_CLIENT_RESPONSE 213
+
+/**
+ * Type of messages between the gnunet-helper-dns and the service
+ */
+#define GNUNET_MESSAGE_TYPE_DNS_HELPER 214
 
 
 /*******************************************************************************
@@ -851,9 +758,9 @@ extern "C"
 #define GNUNET_MESSAGE_TYPE_MESH_PATH_CHANGE            257
 
 /**
- * Request the addition to a new branch to a path
+ * Notify that a connection of a path is no longer valid
  */
-#define GNUNET_MESSAGE_TYPE_MESH_PATH_ADD               258
+#define GNUNET_MESSAGE_TYPE_MESH_PATH_BROKEN            258
 
 /**
  * At some point, the route will spontaneously change
@@ -880,6 +787,21 @@ extern "C"
  */
 #define GNUNET_MESSAGE_TYPE_MESH_PATH_ACK               263
 
+/**
+ * Avoid path timeouts
+ */
+#define GNUNET_MESSAGE_TYPE_MESH_PATH_KEEPALIVE         264
+
+/**
+ * Request the destuction of a path
+ */
+#define GNUNET_MESSAGE_TYPE_MESH_PATH_DESTROY           265
+
+/**
+ * Request the destruction of a whole tunnel
+ */
+#define GNUNET_MESSAGE_TYPE_MESH_TUNNEL_DESTROY         266
+
 /**
  * We need flow control
  */
@@ -1042,6 +964,231 @@ extern "C"
  */
 #define GNUNET_MESSAGE_TYPE_PEERINFO_NOTIFY 334
 
+/*******************************************************************************
+ * ATS message types
+ ******************************************************************************/
+
+/**
+ * Type of the 'struct ClientStartMessage' sent by clients to ATS to
+ * identify the type of the client.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_START 340
+
+/**
+ * Type of the 'struct RequestAddressMessage' sent by clients to ATS
+ * to request an address to help connect.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_REQUEST_ADDRESS 341
+
+/**
+ * Type of the 'struct RequestAddressMessage' sent by clients to ATS
+ * to request an address to help connect.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_REQUEST_ADDRESS_CANCEL 342
+
+/**
+ * Type of the 'struct AddressUpdateMessage' sent by clients to ATS
+ * to inform ATS about performance changes.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_ADDRESS_UPDATE 343
+
+/**
+ * Type of the 'struct AddressDestroyedMessage' sent by clients to ATS
+ * to inform ATS about an address being unavailable.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_ADDRESS_DESTROYED 344
+
+/**
+ * Type of the 'struct AddressSuggestionMessage' sent by ATS to clients
+ * to suggest switching to a different address.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_ADDRESS_SUGGESTION 345
+
+/**
+ * Type of the 'struct PeerInformationMessage' sent by ATS to clients
+ * to inform about QoS for a particular connection.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_PEER_INFORMATION 346
+
+/**
+ * Type of the 'struct ReservationRequestMessage' sent by clients to ATS
+ * to ask for inbound bandwidth reservations.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_RESERVATION_REQUEST 347
+
+/**
+ * Type of the 'struct ReservationResultMessage' sent by ATS to clients
+ * in response to a reservation request.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_RESERVATION_RESULT 348
+
+/**
+ * Type of the 'struct ChangePreferenceMessage' sent by clients to ATS
+ * to ask for allocation preference changes.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_PREFERENCE_CHANGE 349
+
+/**
+ * Type of the 'struct SessionReleaseMessage' sent by ATS to client
+ * to confirm that a session ID was destroyed.
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_SESSION_RELEASE 350
+
+/**
+ * Type of the 'struct AddressUseMessage' sent by ATS to client
+ * to confirm that an address is used or not used anymore
+ */
+#define GNUNET_MESSAGE_TYPE_ATS_ADDRESS_IN_USE 351
+
+
+
+
+/*******************************************************************************
+ * TRANSPORT message types
+ ******************************************************************************/
+
+/**
+ * Message from the core saying that the transport
+ * server should start giving it messages.  This
+ * should automatically trigger the transmission of
+ * a HELLO message.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_START 360
+
+/**
+ * Message from TRANSPORT notifying about a
+ * client that connected to us.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_CONNECT 361
+
+/**
+ * Message from TRANSPORT notifying about a
+ * client that disconnected from us.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_DISCONNECT 362
+
+/**
+ * Request to TRANSPORT to transmit a message.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SEND 363
+
+/**
+ * Confirmation from TRANSPORT that message for transmission has been
+ * queued (and that the next message to this peer can now be passed to
+ * the service).  Note that this confirmation does NOT imply that the
+ * message was fully transmitted.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SEND_OK 364
+
+/**
+ * Message from TRANSPORT notifying about a
+ * message that was received.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_RECV 365
+
+/**
+ * Message telling transport to limit its receive rate.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SET_QUOTA 366
+
+/**
+ * Request to look addresses of peers in server.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_TO_STRING 367
+
+/**
+ * Response to the address lookup request.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_TO_STRING_REPLY 368
+
+/**
+ * Register a client that wants to do blacklisting.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_INIT 369
+
+/**
+ * Query to a blacklisting client (is this peer blacklisted)?
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_QUERY 370
+
+/**
+ * Reply from blacklisting client (answer to blacklist query).
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_BLACKLIST_REPLY 371
+
+/**
+ * Transport PING message
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_PING 372
+
+/**
+ * Transport PONG message
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_PONG 373
+
+/**
+ * Message for transport service from a client asking that a
+ * connection be initiated with another peer.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_REQUEST_CONNECT 374
+
+/**
+ * Transport CONNECT message exchanged between transport services to
+ * indicate that a session should be marked as 'connected'.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_CONNECT 375
+
+/**
+ * Transport CONNECT_ACK message exchanged between transport services to
+ * indicate that a CONNECT message was accepted
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_CONNECT_ACK 376
+
+/**
+ * Transport CONNECT_ACK message exchanged between transport services to
+ * indicate that a CONNECT message was accepted
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_ACK 377
+
+/**
+ * Transport DISCONNECT message exchanged between transport services to
+ * indicate that a connection should be dropped.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_DISCONNECT 378
+
+/**
+ * Request to monitor addresses used by a peer or all peers.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_ITERATE 380
+
+/**
+ * Message send by a peer to notify the other to keep the session alive
+ * and measure latency in a regular interval
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_KEEPALIVE 381
+
+/**
+ * Response to a GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_KEEPALIVE message to
+ * measure latency in a regular interval
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_SESSION_KEEPALIVE_RESPONSE 382
+
+
+/**
+ * Request to iterate over all known addresses.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_ADDRESS_ITERATE_RESPONSE 383
+
+/**
+ * Message send by a peer to notify the other to keep the session alive.
+ */
+#define GNUNET_MESSAGE_TYPE_TRANSPORT_BROADCAST_BEACON 384
+
+
+/**
+ *  Next available: 400
+ */
+
 /*******************************************************************************
  * TODO: we need a way to register message types centrally (via some webpage).
  * For now: unofficial extensions should start at 48k, internal extensions