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
|
/*
This file is part of GNUnet.
Copyright (C) 2010-2015 GNUnet e.V.
GNUnet is free software: you can redistribute it and/or modify it
under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License,
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
Affero General Public License for more details.
*/
/**
* @file transport/gnunet-service-transport_neighbours.h
* @brief neighbour manipulation API, allows manipulation of
* performance metrics (delay and towards ATS)
* @author Christian Grothoff
*/
#ifndef GNUNET_SERVICE_TRANSPORT_MANIPULATION_H
#define GNUNET_SERVICE_TRANSPORT_MANIPULATION_H
#include "platform.h"
#include "gnunet-service-transport_hello.h"
#include "gnunet-service-transport_neighbours.h"
#include "gnunet-service-transport_plugins.h"
#include "gnunet-service-transport_validation.h"
#include "gnunet-service-transport.h"
#include "transport.h"
/**
* Set traffic metric to manipulate
*
* @param message containing information
*/
void
GST_manipulation_set_metric (const struct TrafficMetricMessage *tm);
/**
* Adapter function between transport's send function and transport plugins
*
* @param target the peer the message to send to
* @param msg the message received
* @param msg_size message size
* @param timeout timeout
* @param cont the continuation to call after sending
* @param cont_cls cls for continuation
*/
void
GST_manipulation_send (const struct GNUNET_PeerIdentity *target,
const void *msg,
size_t msg_size,
struct GNUNET_TIME_Relative timeout,
GST_NeighbourSendContinuation cont,
void *cont_cls);
/**
* Adapter function between transport plugins and transport receive function
* manipulation delays for next send.
*
* @param cls the closure for transport
* @param address the address and the peer the message was received from
* @param message the message received
* @param session the session the message was received on
* @return manipulated delay for next receive
*/
struct GNUNET_TIME_Relative
GST_manipulation_recv (void *cls,
const struct GNUNET_HELLO_Address *address,
struct GNUNET_ATS_Session *session,
const struct GNUNET_MessageHeader *message);
/**
* Function that will be called to manipulate ATS information according to
* current manipulation settings
*
* @param address binary address
* @param session the session
* @param prop[IN|OUT] metrics to modify
*/
void
GST_manipulation_manipulate_metrics (const struct GNUNET_HELLO_Address *address,
struct GNUNET_ATS_Session *session,
struct GNUNET_ATS_Properties *prop);
/**
* Notify manipulation about disconnect so it can discard queued messages
*
* @param peer the disconnecting peer
*/
void
GST_manipulation_peer_disconnect (const struct GNUNET_PeerIdentity *peer);
/**
* Initialize traffic manipulation
*/
void
GST_manipulation_init (void);
/**
* Stop traffic manipulation
*/
void
GST_manipulation_stop (void);
#endif
/* end of file gnunet-service-transport_neighbours.h */
|
