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 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 * @file testbed/testbed_api.h
23 * @brief Interface for functions internally exported from testbed_api.c
24 * @author Sree Harsha Totakura
32 * Enumeration of operations
37 * Peer create operation
42 * Peer start operation
52 * Peer destroy operation
57 * Get peer information operation
62 * Overlay connection operation
70 * Testbed operation structure
72 struct GNUNET_TESTBED_Operation
75 * next pointer for DLL
77 struct GNUNET_TESTBED_Operation *next;
80 * prev pointer for DLL
82 struct GNUNET_TESTBED_Operation *prev;
85 * The controller on which this operation operates
87 struct GNUNET_TESTBED_Controller *controller;
90 * The ID for the operation;
92 uint64_t operation_id;
95 * The type of operation
97 enum OperationType type;
100 * Data specific to OperationType
107 * The message queue for sending messages to the controller service
112 * Structure for a controller link
114 struct ControllerLink;
117 * Context information for GNUNET_TESTBED_Operation
119 struct OperationContext
124 struct OperationContext *next;
129 struct OperationContext *prev;
132 * The controller to which this operation context belongs to
134 struct GNUNET_TESTBED_Controller *c;
139 struct GNUNET_TESTBED_Operation *op;
142 * Data relevant to the operation
147 * The id of the opearation
152 * The type of operation
154 enum OperationType type;
157 * Is this operation completed? (has there been a reply from the service)
165 * Handle to interact with a GNUnet testbed controller. Each
166 * controller has at least one master handle which is created when the
167 * controller is created; this master handle interacts with the
168 * controller process, destroying it destroys the controller (by
169 * closing stdin of the controller process). Additionally,
170 * controllers can interact with each other (in a P2P fashion); those
171 * links are established via TCP/IP on the controller's service port.
173 struct GNUNET_TESTBED_Controller
177 * The host where the controller is running
179 struct GNUNET_TESTBED_Host *host;
182 * The controller callback
184 GNUNET_TESTBED_ControllerCallback cc;
187 * The closure for controller callback
192 * The configuration to use while connecting to controller
194 struct GNUNET_CONFIGURATION_Handle *cfg;
197 * The client connection handle to the controller service
199 struct GNUNET_CLIENT_Connection *client;
202 * The head of the message queue
204 struct MessageQueue *mq_head;
207 * The tail of the message queue
209 struct MessageQueue *mq_tail;
212 * The head of the ControllerLink list
214 struct ControllerLink *cl_head;
217 * The tail of the ControllerLink list
219 struct ControllerLink *cl_tail;
222 * The client transmit handle
224 struct GNUNET_CLIENT_TransmitHandle *th;
227 * The host registration handle; NULL if no current registration requests are
230 struct GNUNET_TESTBED_HostRegistrationHandle *rh;
233 * The head of the operation queue (FIXME: Remove, use ocq)
235 struct GNUNET_TESTBED_Operation *op_head;
238 * The tail of the operation queue (FIXME: Remove, use ocq)
240 struct GNUNET_TESTBED_Operation *op_tail;
243 * The head of the opeartion context queue
245 struct OperationContext *ocq_head;
248 * The tail of the operation context queue
250 struct OperationContext *ocq_tail;
253 * Operation queue for simultaneous peer creations
255 struct OperationQueue *opq_peer_create;
258 * The operation id counter. use current value and increment
260 uint64_t operation_counter;
263 * The controller event mask
268 * Did we start the receive loop yet?
273 * Did we create the host for this?
280 * Queues a message in send queue for sending to the service
282 * @param controller the handle to the controller
283 * @param msg the message to queue
286 GNUNET_TESTBED_queue_message_ (struct GNUNET_TESTBED_Controller *controller,
287 struct GNUNET_MessageHeader *msg);
291 * Compresses given configuration using zlib compress
293 * @param config the serialized configuration
294 * @param size the size of config
295 * @param xconfig will be set to the compressed configuration (memory is fresly
297 * @return the size of the xconfig
300 GNUNET_TESTBED_compress_config_ (const char *config, size_t size,
305 * Adds an operation to the queue of operations
307 * @param op the operation to add
310 GNUNET_TESTBED_operation_add_ (struct GNUNET_TESTBED_Operation *op);
314 * Creates a helper initialization message. Only for testing.
316 * @param cname the ip address of the controlling host
317 * @param cfg the configuration that has to used to start the testbed service
319 * @return the initialization message
321 struct GNUNET_TESTBED_HelperInit *
322 GNUNET_TESTBED_create_helper_init_msg_ (const char *cname,
323 const struct GNUNET_CONFIGURATION_Handle *cfg);