1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
|
/*
This file is part of GNUnet
(C) 2006 Christian Grothoff (and other contributing authors)
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
by the Free Software Foundation; either version 2, or (at your
option) any later version.
GNUnet is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
/**
* @file src/dht/dhtlog.h
*
* @brief dhtlog is a service that implements logging of dht operations
* for testing
* @author Nathan Evans
*/
#ifndef GNUNET_DHTLOG_SERVICE_H
#define GNUNET_DHTLOG_SERVICE_H
#include "gnunet_util_lib.h"
#ifdef __cplusplus
extern "C"
{
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif
typedef enum
{
/**
* Type for a DHT GET message
*/
DHTLOG_GET = 1,
/**
* Type for a DHT PUT message
*/
DHTLOG_PUT = 2,
/**
* Type for a DHT FIND PEER message
*/
DHTLOG_FIND_PEER = 3,
/**
* Type for a DHT RESULT message
*/
DHTLOG_RESULT = 4,
/**
* Generic DHT ROUTE message
*/
DHTLOG_ROUTE = 5,
} DHTLOG_MESSAGE_TYPES;
struct GNUNET_DHTLOG_Handle
{
/*
* Insert the result of a query into the database
*
* @param sqlqueryuid return value for the sql uid for this query
* @param queryid gnunet internal query id (doesn't exist)
* @param type the type of query (DHTLOG_GET, DHTLOG_PUT, DHTLOG_RESULT)
* @param hops the hops the query has traveled
* @param succeeded is successful or not (GNUNET_YES or GNUNET_NO)
* @param GNUNET_PeerIdentity of the node the query is at now
* @param key the GNUNET_HashCode of this query
*
*/
int (*insert_query) (unsigned long long *sqlqueryuid,
unsigned long long queryid, DHTLOG_MESSAGE_TYPES type,
unsigned int hops,
int succeeded,
const struct GNUNET_PeerIdentity * node,
const GNUNET_HashCode * key);
/*
* Inserts the trial information into the database
*/
int (*insert_trial) (unsigned long long *trialuid, int num_nodes, int topology,
int blacklist_topology, int connect_topology,
int connect_topology_option, float connect_topology_option_modifier,
float topology_percentage, float topology_probability,
int puts, int gets, int concurrent, int settle_time,
int num_rounds, int malicious_getters, int malicious_putters,
int malicious_droppers,
char *message);
/*
* Update the trial information with the ending time and dropped message stats
*/
int (*update_trial) (unsigned long long trialuid,
unsigned long long totalMessagesDropped,
unsigned long long totalBytesDropped,
unsigned long long unknownPeers);
/*
* Update the trial information with the total connections
*/
int (*update_connections) (unsigned long long trialuid,
unsigned int totalConnections);
/*
* Insert the query information from a single hop into the database
*
* @param sqlqueryuid return value for the sql uid for this query
* @param queryid gnunet internal query id (doesn't exist)
* @param type the type of query (DHTLOG_GET, DHTLOG_PUT, DHTLOG_RESULT)
* @param hops the hops the query has traveled
* @param succeeded query is successful or not (GNUNET_YES or GNUNET_NO)
* @param node GNUNET_PeerIdentity of the node the query is at now
* @param key the GNUNET_HashCode of this query
* @param from_node GNUNET_PeerIdentity of the node the query was
* received from (NULL if origin)
* @param to_node GNUNET_PeerIdentity of the node this node will forward
* to (NULL if none)
*
*/
int (*insert_route) (unsigned long long *sqlqueryuid,
unsigned long long queryid,
unsigned int type,
unsigned int hops,
int succeeded,
const struct GNUNET_PeerIdentity * node,
const GNUNET_HashCode * key,
const struct GNUNET_PeerIdentity * from_node,
const struct GNUNET_PeerIdentity * to_node);
/*
* Inserts the specified node into the dhttests.nodes table
*/
int (*insert_node) (unsigned long long *nodeuid,
struct GNUNET_PeerIdentity * node);
/*
* Inserts a dhtkey into the database
*/
int (*insert_dhtkey) (unsigned long long *dhtkeyuid,
const GNUNET_HashCode * dhtkey);
};
struct GNUNET_DHTLOG_Plugin
{
const struct GNUNET_CONFIGURATION_Handle *cfg;
struct GNUNET_DHTLOG_Handle *dhtlog_api;
};
/**
* Connect to mysql server using the DHT log plugin.
*
* @param c a configuration to use
*/
struct GNUNET_DHTLOG_Handle *
GNUNET_DHTLOG_connect (const struct GNUNET_CONFIGURATION_Handle *c);
/**
* Shutdown the module.
*/
void
GNUNET_DHTLOG_disconnect (struct GNUNET_DHTLOG_Handle *api);
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
/* end of dhtlog.h */
#endif
|
