2 This file is part of GNUnet.
3 (C) 2001 - 2011 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 3, 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 * @author Bartlomiej Polot
30 #include <gnunet_mesh_service_new.h>
31 #include "gnunet_common.h"
33 /******************************************************************************/
34 /******************** MESH LOCAL MESSAGES *************************/
35 /******************************************************************************/
36 /* Any API call should be documented in the folowing table under API CALL.
37 * Also, any message type should be documented in the following table, with the
40 * API CALL (GNUNET_MESH_*) MESSAGE USED
41 * ------------------------ ------------
42 * connect GNUNET_MESH_ClientConnect
43 * disconnect None (network level disconnect)
45 * tunnel_create GNUNET_MESH_TunnelMessage
46 * tunnel_destroy GNUNET_MESH_TunnelMessage
48 * peer_request_connect_add GNUNET_MESH_PeerControl
49 * peer_request_connect_del GNUNET_MESH_PeerControl
50 * peer_request_connect_by_type GNUNET_MESH_ConnectPeerByType
52 * notify_transmit_ready *GNUNET_MESH_TransmitReady?*
53 * notify_transmit_ready_cancel None (clear of internal data structures)
59 * data GNUNET_MESH_Data OR
60 * GNUNET_MESH_DataBroadcast
61 * new incoming tunnel GNUNET_MESH_PeerControl
62 * peer connects to a tunnel GNUNET_MESH_PeerControl
63 * peer disconnects from a tunnel GNUNET_MESH_PeerControl
66 /******************************************************************************/
67 /************************** CONSTANTS ******************************/
68 /******************************************************************************/
70 #define GNUNET_MESH_LOCAL_TUNNEL_ID_CLI 0x80000000
71 #define GNUNET_MESH_LOCAL_TUNNEL_ID_SERV 0xB0000000
74 /******************************************************************************/
75 /************************** MESSAGES ******************************/
76 /******************************************************************************/
79 * Message for a client to register to the service
81 struct GNUNET_MESH_ClientConnect
84 * Type: GNUNET_MESSAGE_TYPE_MESH_LOCAL_CONNECT
86 * Size: sizeof(struct GNUNET_MESH_ClientConnect) +
87 * sizeof(uint16_t) * types +
88 * sizeof(MESH_ApplicationType) * applications
90 struct GNUNET_MessageHeader header;
91 uint16_t types GNUNET_PACKED;
92 uint16_t applications GNUNET_PACKED;
93 /* uint16_t list_types[types] */
94 /* uint16_t list_apps[applications] */
99 * Type for tunnel numbering.
100 * - Local tunnel numbers are >= 0x80000000
101 * - Global tunnel numbers are < 0x80000000
103 typedef uint32_t MESH_TunnelNumber;
106 * Message for a client to create and destroy tunnels.
108 struct GNUNET_MESH_TunnelMessage
111 * Type: GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_[CREATE|DESTROY]
113 * Size: sizeof(struct GNUNET_MESH_TunnelMessage)
115 struct GNUNET_MessageHeader header;
118 * ID of a tunnel controlled by this client.
120 MESH_TunnelNumber tunnel_id GNUNET_PACKED;
123 * Peer at the other end, if any
125 struct GNUNET_PeerIdentity peer;
130 * - request adding and deleting peers from a tunnel
131 * - notify the client that peers have connected:
133 * -- unrequested (new incoming tunnels)
134 * - notify the client that peers have disconnected
136 struct GNUNET_MESH_PeerControl
140 * Type: GNUNET_MESSAGE_TYPE_MESH_LOCAL_CONNECT_PEER_[ADD|DEL]
141 * (client to service, client created tunnel)
142 * GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_[CONNECTED|DISCONNECTED]
143 * (service to client)
145 * Size: sizeof(struct GNUNET_MESH_PeerControl)
147 struct GNUNET_MessageHeader header;
150 * ID of a tunnel controlled by this client.
152 MESH_TunnelNumber tunnel_id GNUNET_PACKED;
155 * Peer to connect/disconnect.
157 struct GNUNET_PeerIdentity peer;
162 * Message for connecting to peers offering a certain service.
164 struct GNUNET_MESH_ConnectPeerByType
167 * Type: GNUNET_MESSAGE_TYPE_MESH_LOCAL_CONNECT_PEER_BY_TYPE |
168 * GNUNET_MESSAGE_TYPE_MESH_LOCAL_DISCONNECT_PEER_BY_TYPE
170 struct GNUNET_MessageHeader header;
173 * ID of a tunnel controlled by this client.
175 MESH_TunnelNumber tunnel_id GNUNET_PACKED;
180 GNUNET_MESH_ApplicationType type GNUNET_PACKED;