2 This file is part of GNUnet
3 Copyright (C) 2012, 2013, 2016 GNUnet e.V.
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., 51 Franklin Street, Fifth Floor,
18 Boston, MA 02110-1301, USA.
21 * @file regex/regex_api_announce.c
22 * @brief access regex service to advertise capabilities via regex
23 * @author Maximilian Szengel
24 * @author Christian Grothoff
27 #include "gnunet_protocols.h"
28 #include "gnunet_util_lib.h"
29 #include "gnunet_regex_service.h"
30 #include "regex_ipc.h"
32 #define LOG(kind,...) GNUNET_log_from (kind, "regex-api",__VA_ARGS__)
35 * Handle to store cached data about a regex announce.
37 struct GNUNET_REGEX_Announcement
40 * Connection to the regex service.
42 struct GNUNET_MQ_Handle *mq;
47 const struct GNUNET_CONFIGURATION_Handle *cfg;
50 * Message we're sending to the service.
55 * Frequency of announcements.
57 struct GNUNET_TIME_Relative refresh_delay;
60 * Number of characters per edge.
68 * (Re)connect to the REGEX service with the given announcement @a a.
70 * @param a REGEX to announce.
73 announce_reconnect (struct GNUNET_REGEX_Announcement *a);
77 * We got a disconnect after asking regex to do the announcement.
80 * @param cls the `struct GNUNET_REGEX_Announcement` to retry
81 * @param error error code
84 announce_mq_error_handler (void *cls,
85 enum GNUNET_MQ_Error error)
87 struct GNUNET_REGEX_Announcement *a = cls;
89 GNUNET_MQ_destroy (a->mq);
91 announce_reconnect (a);
96 * (Re)connect to the REGEX service with the given announcement @a a.
98 * @param a REGEX to announce.
101 announce_reconnect (struct GNUNET_REGEX_Announcement *a)
103 struct GNUNET_MQ_Envelope *env;
104 struct AnnounceMessage *am;
107 a->mq = GNUNET_CLIENT_connecT (a->cfg,
110 &announce_mq_error_handler,
114 slen = strlen (a->regex) + 1;
115 env = GNUNET_MQ_msg_extra (am,
117 GNUNET_MESSAGE_TYPE_REGEX_ANNOUNCE);
118 am->compression = htons (a->compression);
119 am->reserved = htons (0);
120 am->refresh_delay = GNUNET_TIME_relative_hton (a->refresh_delay);
124 GNUNET_MQ_send (a->mq,
130 * Announce the given peer under the given regular expression.
132 * @param cfg configuration to use
133 * @param regex Regular expression to announce.
134 * @param refresh_delay after what delay should the announcement be repeated?
135 * @param compression How many characters per edge can we squeeze?
136 * @return Handle to reuse o free cached resources.
137 * Must be freed by calling #GNUNET_REGEX_announce_cancel().
139 struct GNUNET_REGEX_Announcement *
140 GNUNET_REGEX_announce (const struct GNUNET_CONFIGURATION_Handle *cfg,
142 struct GNUNET_TIME_Relative refresh_delay,
143 uint16_t compression)
145 struct GNUNET_REGEX_Announcement *a;
148 slen = strlen (regex) + 1;
149 if (slen + sizeof (struct AnnounceMessage) >= GNUNET_SERVER_MAX_MESSAGE_SIZE)
151 GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
152 _("Regex `%s' is too long!\n"),
157 a = GNUNET_new (struct GNUNET_REGEX_Announcement);
159 a->refresh_delay = refresh_delay;
160 a->compression = compression;
161 a->regex = GNUNET_strdup (regex);
162 announce_reconnect (a);
165 GNUNET_free (a->regex);
174 * Stop announcing the regex specified by the given handle.
176 * @param a handle returned by a previous #GNUNET_REGEX_announce() call.
179 GNUNET_REGEX_announce_cancel (struct GNUNET_REGEX_Announcement *a)
181 GNUNET_MQ_destroy (a->mq);
182 GNUNET_free (a->regex);
186 /* end of regex_api_announce.c */