GNUnet  0.10.x
cadet_api_get_channel.c
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2011, 2017, 2019 GNUnet e.V.
4 
5  GNUnet is free software: you can redistribute it and/or modify it
6  under the terms of the GNU Affero General Public License as published
7  by the Free Software Foundation, either version 3 of the License,
8  or (at your option) any later version.
9 
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  Affero General Public License for more details.
14 
15  You should have received a copy of the GNU Affero General Public License
16  along with this program. If not, see <http://www.gnu.org/licenses/>.
17 
18  SPDX-License-Identifier: AGPL3.0-or-later
19  */
26 #include "platform.h"
27 #include "gnunet_util_lib.h"
28 #include "gnunet_constants.h"
29 #include "gnunet_cadet_service.h"
30 #include "cadet.h"
31 #include "cadet_protocol.h"
32 
33 
42 
47 
52 
57 
62 
67 
72 };
73 
74 
83 static int
85  const struct GNUNET_CADET_ChannelInfoMessage *message)
86 {
87  (void)cls;
88 
89  return GNUNET_OK;
90 }
91 
92 
99 static void
101  const struct GNUNET_CADET_ChannelInfoMessage *message)
102 {
103  struct GNUNET_CADET_ChannelMonitor *cm = cls;
105 
106  ci.root = message->root;
107  ci.dest = message->dest;
108  cm->channel_cb(cm->channel_cb_cls,
109  &ci);
111 }
112 
113 
120 static void
122  const struct GNUNET_MessageHeader *message)
123 {
124  struct GNUNET_CADET_ChannelMonitor *cm = cls;
125 
126  cm->channel_cb(cm->channel_cb_cls,
127  NULL);
129 }
130 
131 
137 static void
138 reconnect(void *cls);
139 
140 
147 static void
148 error_handler(void *cls,
149  enum GNUNET_MQ_Error error)
150 {
151  struct GNUNET_CADET_ChannelMonitor *cm = cls;
152 
153  GNUNET_MQ_destroy(cm->mq);
154  cm->mq = NULL;
158  &reconnect,
159  cm);
160 }
161 
162 
168 static void
169 reconnect(void *cls)
170 {
171  struct GNUNET_CADET_ChannelMonitor *cm = cls;
172  struct GNUNET_MQ_MessageHandler handlers[] = {
173  GNUNET_MQ_hd_fixed_size(channel_info_end,
175  struct GNUNET_MessageHeader,
176  cm),
177  GNUNET_MQ_hd_var_size(channel_info,
180  cm),
182  };
184  struct GNUNET_MQ_Envelope *env;
185 
186  cm->reconnect_task = NULL;
187  cm->mq = GNUNET_CLIENT_connect(cm->cfg,
188  "cadet",
189  handlers,
190  &error_handler,
191  cm);
192  if (NULL == cm->mq)
193  return;
194  env = GNUNET_MQ_msg(msg,
196  msg->target = cm->peer;
197  GNUNET_MQ_send(cm->mq,
198  env);
199 }
200 
201 
213  struct GNUNET_PeerIdentity *peer,
214  GNUNET_CADET_ChannelCB callback,
215  void *callback_cls)
216 {
217  struct GNUNET_CADET_ChannelMonitor *cm;
218 
219  if (NULL == callback)
220  {
221  GNUNET_break(0);
222  return NULL;
223  }
225  cm->channel_cb = callback;
226  cm->channel_cb_cls = callback_cls;
227  cm->cfg = cfg;
228  cm->peer = *peer;
229  reconnect(cm);
230  if (NULL == cm->mq)
231  {
232  GNUNET_free(cm);
233  return NULL;
234  }
235  return cm;
236 }
237 
238 
245 void *
247 {
248  void *ret = cm->channel_cb_cls;
249 
250  if (NULL != cm->mq)
251  GNUNET_MQ_destroy(cm->mq);
252  if (NULL != cm->reconnect_task)
254  GNUNET_free(cm);
255  return ret;
256 }
257 
258 /* end of cadet_api_get_channel.c */
static void reconnect(void *cls)
Reconnect to the service and try again.
#define GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_CHANNEL
Local information of service about a specific channel.
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
struct GNUNET_PeerIdentity root
Root of the channel.
struct GNUNET_MQ_Handle * GNUNET_CLIENT_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *service_name, const struct GNUNET_MQ_MessageHandler *handlers, GNUNET_MQ_ErrorHandler error_handler, void *error_handler_cls)
Create a message queue to connect to a GNUnet service.
Definition: client.c:900
GNUNET_MQ_Error
Error codes for the queue.
static int check_channel_info(void *cls, const struct GNUNET_CADET_ChannelInfoMessage *message)
Check that message received from CADET service is well-formed.
#define GNUNET_TIME_UNIT_MINUTES
One minute.
Internal details about a channel.
#define GNUNET_MQ_hd_fixed_size(name, code, str, ctx)
#define GNUNET_MQ_msg(mvar, type)
Allocate a GNUNET_MQ_Envelope.
Definition: gnunet_mq_lib.h:67
struct GNUNET_CADET_ChannelMonitor * GNUNET_CADET_get_channel(const struct GNUNET_CONFIGURATION_Handle *cfg, struct GNUNET_PeerIdentity *peer, GNUNET_CADET_ChannelCB callback, void *callback_cls)
Request information about a specific channel of the running cadet peer.
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define GNUNET_new(type)
Allocate a struct or union of the given type.
static int ret
Final status code.
Definition: gnunet-arm.c:89
void * channel_cb_cls
Info callback closure for channel_cb.
void(* GNUNET_CADET_ChannelCB)(void *cls, const struct GNUNET_CADET_ChannelInternals *info)
Method called to retrieve information about a specific channel the cadet peer is aware of...
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
Message to inform the client about channels in the service.
Definition: cadet.h:273
struct GNUNET_PeerIdentity dest
Destination of the channel.
Definition: cadet.h:287
const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we use.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1237
struct GNUNET_PeerIdentity peer
Peer we want information about.
static void handle_channel_info_end(void *cls, const struct GNUNET_MessageHeader *message)
Process a local peer info reply, pass info to the user.
#define GNUNET_MQ_hd_var_size(name, code, str, ctx)
struct GNUNET_TIME_Relative backoff
Backoff for reconnect attempts.
GNUNET_CADET_ChannelCB channel_cb
Channel callback.
Message to as the service about information on a channel.
Definition: cadet.h:296
struct GNUNET_MQ_Handle * mq
Message queue to talk to CADET service.
#define GNUNET_MESSAGE_TYPE_CADET_LOCAL_REQUEST_INFO_CHANNEL
Local information about all channels of service.
Message handler for a specific message type.
struct GNUNET_PeerIdentity target
Target of the channel.
Definition: cadet.h:305
struct GNUNET_MQ_Envelope * env
Definition: 005.c:1
P2P messages used by CADET.
void * GNUNET_CADET_get_channel_cancel(struct GNUNET_CADET_ChannelMonitor *cm)
Cancel a channel monitor request.
static void error_handler(void *cls, enum GNUNET_MQ_Error error)
Function called on connection trouble.
Handle to a message queue.
Definition: mq.c:84
The identity of the host (wraps the signing key of the peer).
configuration data
Definition: configuration.c:83
struct GNUNET_PeerIdentity root
Root of the channel.
Definition: cadet.h:282
Entry in list of pending tasks.
Definition: scheduler.c:131
Header for all communications.
void GNUNET_MQ_destroy(struct GNUNET_MQ_Handle *mq)
Destroy the message queue.
Definition: mq.c:821
static void handle_channel_info(void *cls, const struct GNUNET_CADET_ChannelInfoMessage *message)
Process a local peer info reply, pass info to the user.
void GNUNET_MQ_send(struct GNUNET_MQ_Handle *mq, struct GNUNET_MQ_Envelope *ev)
Send a message with the given message queue.
Definition: mq.c:351
#define GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_CHANNEL_END
End of local information of service about channels.
struct GNUNET_TIME_Relative GNUNET_TIME_randomized_backoff(struct GNUNET_TIME_Relative rt, struct GNUNET_TIME_Relative threshold)
Randomized exponential back-off, starting at 1 ms and going up by a factor of 2+r, where 0 <= r <= 0.5, up to a maximum of the given threshold.
Definition: time.c:758
#define GNUNET_MQ_handler_end()
End-marker for the handlers array.
struct GNUNET_SCHEDULER_Task * reconnect_task
Task to reconnect.
struct GNUNET_PeerIdentity dest
Destination of the channel.
#define GNUNET_free(ptr)
Wrapper around free.
Time for relative time used by GNUnet, in microseconds.
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:956