*/
/**
- * @file testing/new_testing.h
+ * @file testbed/testbed.h
* @brief IPC messages between testing API and service ("controller")
* @author Christian Grothoff
*/
-#ifndef NEW_TESTING_H
-#define NEW_TESTING_H
+#ifndef TESTBED_H
+#define TESTBED_H
#include "gnunet_util_lib.h"
+GNUNET_NETWORK_STRUCT_BEGIN
/**
* Initial message from a client to a testing control service.
*/
-struct GNUNET_TESTBED_Message
+struct GNUNET_TESTBED_InitMessage
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_INIT
*/
struct GNUNET_MessageHeader header;
/**
- * Host ID that the controller is either given
- * (if this is the dominating client communicating
- * via stdin) or assumed to have (for peer-connections
- * between controllers).
+ * Host ID that the controller is either given (if this is the
+ * dominating client) or assumed to have (for peer-connections
+ * between controllers). A controller must check that all
+ * connections make consistent claims...
*/
uint32_t host_id GNUNET_PACKED;
*/
uint64_t event_mask GNUNET_PACKED;
+ /* Followed by 0-terminated hostname of the controller */
};
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_ADDHOST
*/
struct GNUNET_MessageHeader header;
/**
* Confirmation from the service that adding a host
* worked (or failed).
+ * FIXME: Where is this required?
*/
struct GNUNET_TESTBED_HostConfirmedMessage
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_ADDHOSTCONFIRMED
*/
struct GNUNET_MessageHeader header;
*/
uint32_t host_id GNUNET_PACKED;
- /* followed by the 0-terminated error message (on failure)
- (typical errors include failure to login and
- host-id already in use) */
+ /* followed by the 0-terminated error message (on failure)
+ * (typical errors include host-id already in use) */
};
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_SERVICESHARE
*/
struct GNUNET_MessageHeader header;
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_LCONTROLLERS
*/
struct GNUNET_MessageHeader header;
*/
uint32_t delegated_host_id GNUNET_PACKED;
+ /**
+ * The id of the operation which created this message
+ */
+ uint64_t operation_id GNUNET_PACKED;
+
/**
* Which host is responsible for managing the delegation? NBO
*/
uint32_t slave_host_id GNUNET_PACKED;
/**
- * Is the receiving controller the master controller for
- * the slave host (and thus responsible for starting it?). NBO.
+ * The size of the uncompressed configuration
*/
- int32_t is_subordinate GNUNET_PACKED;
+ uint16_t config_size GNUNET_PACKED;
+
+ /**
+ * Set to 1 if the receiving controller is the master controller for
+ * the slave host (and thus responsible for starting it?). 0 if not
+ */
+ uint8_t is_subordinate;
/* followed by serialized slave configuration;
- gzip'ed configuration file in INI format */
+ * gzip'ed configuration file in INI format */
};
/**
- * Message sent from client to testing service to
+ * Message sent from client to testing service to
* create (configure, but not start) a peer.
*/
struct GNUNET_TESTBED_PeerCreateMessage
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_CREATEPEER
*/
struct GNUNET_MessageHeader header;
+ /**
+ * Unique operation id
+ */
+ uint64_t operation_id GNUNET_PACKED;
+
/**
* On which host should the peer be started?
*/
*/
uint32_t peer_id GNUNET_PACKED;
+ /**
+ * Size of the uncompressed configuration
+ */
+ uint32_t config_size GNUNET_PACKED;
+
/* followed by serialized peer configuration;
- gzip'ed configuration file in INI format */
-
+ * gzip'ed configuration file in INI format */
+
};
/**
- * Message sent from client to testing service to
+ * Message sent from client to testing service to
* reconfigure a (stopped) a peer.
*/
struct GNUNET_TESTBED_PeerReconfigureMessage
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPDE_TESTBED_PEERRECONF
*/
struct GNUNET_MessageHeader header;
uint64_t operation_id GNUNET_PACKED;
/* followed by serialized peer configuration;
- gzip'ed configuration file in INI format */
-
+ * gzip'ed configuration file in INI format */
+
};
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_STARTPEER
*/
struct GNUNET_MessageHeader header;
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_STOPPEER
*/
struct GNUNET_MessageHeader header;
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_DESTROYPEER
*/
struct GNUNET_MessageHeader header;
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_CONFIGULLINK
*/
struct GNUNET_MessageHeader header;
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_OLCONNECT
*/
struct GNUNET_MessageHeader header;
*/
uint32_t peer2 GNUNET_PACKED;
+ /**
+ * The ID of the host which runs peer2
+ */
+ uint32_t peer2_host_id GNUNET_PACKED;
+
+};
+
+
+/**
+ * Message sent from host controller of a peer(A) to the host controller of
+ * another peer(B) to request B to connect to A
+ */
+struct GNUNET_TESTBED_RequestConnectMessage
+{
+ /**
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_REQUESTCONNECT
+ */
+ struct GNUNET_MessageHeader header;
+
+ /**
+ * The Unique ID of B
+ */
+ uint32_t peer GNUNET_PACKED;
+
+ /**
+ * The Operation ID that is used to identify this operation
+ */
+ uint64_t operation_id GNUNET_PACKED;
+
+ /**
+ * Identity of A
+ */
+ struct GNUNET_PeerIdentity peer_identity;
+
+ /**
+ * To be followed by the HELLO message of A
+ */
+ struct GNUNET_MessageHeader hello[0];
+
};
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_PEEREVENT
*/
struct GNUNET_MessageHeader header;
* either GNUNET_TESTBED_ET_PEER_START or GNUNET_TESTBED_ET_PEER_STOP.
*/
int32_t event_type GNUNET_PACKED;
-
+
/**
* Host where the peer is running.
*/
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_PEERCONEVENT
*/
struct GNUNET_MessageHeader header;
/**
* 'enum GNUNET_TESTBED_EventType' (in NBO);
- * either GNUNET_TESTBED_ET_PEER_CONNECT or GNUNET_TESTBED_ET_PEER_DISCONNECT.
+ * either GNUNET_TESTBED_ET_CONNECT or GNUNET_TESTBED_ET_DISCONNECT.
*/
int32_t event_type GNUNET_PACKED;
-
+
/**
* First peer.
*/
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_OPERATIONFAILEVENT
*/
struct GNUNET_MessageHeader header;
* GNUNET_TESTBED_ET_OPERATION_FINISHED.
*/
int32_t event_type GNUNET_PACKED;
-
+
/**
* Operation ID of the operation that created this event.
*/
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_PEERCREATESUCCESS
*/
struct GNUNET_MessageHeader header;
* Peer identity of the peer that was created.
*/
uint32_t peer_id GNUNET_PACKED;
-
+
/**
* Operation ID of the operation that created this event.
*/
uint64_t operation_id GNUNET_PACKED;
- /**
- * Identity of the peer.
- */
- struct GNUNET_PeerIdentity peer_id;
-
- /* followed by gzip-compressed configuration of the peer */
-
};
{
/**
- * Type is
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_GENERICOPSUCCESS
*/
struct GNUNET_MessageHeader header;
* GNUNET_TESTBED_ET_OPERATION_FINISHED.
*/
int32_t event_type GNUNET_PACKED;
-
+
+ /**
+ * Operation ID of the operation that created this event.
+ */
+ uint64_t operation_id GNUNET_PACKED;
+
+};
+
+
+/**
+ * Message sent from client to testing service to
+ * obtain the configuration of a peer.
+ */
+struct GNUNET_TESTBED_PeerGetConfigurationMessage
+{
+
+ /**
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_GETPEERCONFIG
+ */
+ struct GNUNET_MessageHeader header;
+
+ /**
+ * Unique ID for the peer.
+ */
+ uint32_t peer_id GNUNET_PACKED;
+
+ /**
+ * Operation ID that is used to identify this operation.
+ */
+ uint64_t operation_id GNUNET_PACKED;
+
+};
+
+
+/**
+ * Peer configuration and identity reply from controller to a client.
+ */
+struct GNUNET_TESTBED_PeerConfigurationInformationMessage
+{
+
+ /**
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_PEERCONFIG
+ */
+ struct GNUNET_MessageHeader header;
+
+ /**
+ * The id of the peer relevant to this information
+ */
+ uint32_t peer_id GNUNET_PACKED;
+
/**
* Operation ID of the operation that created this event.
*/
uint64_t operation_id GNUNET_PACKED;
+ /**
+ * Identity of the peer.
+ */
+ struct GNUNET_PeerIdentity peer_identity;
+
+ /**
+ * The size of configuration when uncompressed
+ */
+ uint16_t config_size GNUNET_PACKED;
+
+ /* followed by gzip-compressed configuration of the peer */
+
};
+
+/**
+ * Message to request configuration of a slave controller
+ */
+struct GNUNET_TESTBED_SlaveGetConfigurationMessage
+{
+ /**
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_GETSLAVECONFIG
+ */
+ struct GNUNET_MessageHeader header;
+
+ /**
+ * The id of the slave host
+ */
+ uint32_t slave_id GNUNET_PACKED;
+
+ /**
+ * Operation ID
+ */
+ uint64_t operation_id GNUNET_PACKED;
+
+};
+
+
+/**
+ * Reply to GETSLAVECONFIG message
+ */
+struct GNUNET_TESTBED_SlaveConfiguration
+{
+ /**
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_SLAVECONFIG
+ */
+ struct GNUNET_MessageHeader header;
+
+ /**
+ * The id of the host where the slave is running
+ */
+ uint32_t slave_id GNUNET_PACKED;
+
+ /**
+ * Operation ID
+ */
+ uint64_t operation_id GNUNET_PACKED;
+
+ /**
+ * The size of the configuration when uncompressed
+ */
+ uint16_t config_size GNUNET_PACKED;
+
+ /* followed by gzip-compressed configuration of the peer */
+
+};
+
+
+/**
+ * Message sent from a controller to the testbed API seeking the configuration
+ * of the host whose id is contained in the message.
+ */
+struct GNUNET_TESTBED_NeedControllerConfig
+{
+ /**
+ * Type is GNUNET_MESSAGE_TYPE_TESTBED_NEEDCONTROLLERCONFIG
+ */
+ struct GNUNET_MessageHeader header;
+
+ /**
+ * The id of the controller host
+ */
+ uint32_t controller_host_id GNUNET_PACKED;
+
+ /**
+ * Operation ID
+ */
+ uint64_t operation_id GNUNET_PACKED;
+
+};
+
+GNUNET_NETWORK_STRUCT_END
+
#endif
+/* end of testbed.h */
projects / oweals / gnunet.git / blobdiff