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 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.
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.
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/>.
19 * @file regex/regex_api_announce.c
20 * @brief access regex service to advertise capabilities via regex
21 * @author Maximilian Szengel
22 * @author Christian Grothoff
25 #include "gnunet_protocols.h"
26 #include "gnunet_util_lib.h"
27 #include "gnunet_regex_service.h"
28 #include "regex_ipc.h"
30 #define LOG(kind,...) GNUNET_log_from (kind, "regex-api",__VA_ARGS__)
33 * Handle to store cached data about a regex announce.
35 struct GNUNET_REGEX_Announcement
38 * Connection to the regex service.
40 struct GNUNET_MQ_Handle *mq;
45 const struct GNUNET_CONFIGURATION_Handle *cfg;
48 * Message we're sending to the service.
53 * Frequency of announcements.
55 struct GNUNET_TIME_Relative refresh_delay;
58 * Number of characters per edge.
66 * (Re)connect to the REGEX service with the given announcement @a a.
68 * @param a REGEX to announce.
71 announce_reconnect (struct GNUNET_REGEX_Announcement *a);
75 * We got a disconnect after asking regex to do the announcement.
78 * @param cls the `struct GNUNET_REGEX_Announcement` to retry
79 * @param error error code
82 announce_mq_error_handler (void *cls,
83 enum GNUNET_MQ_Error error)
85 struct GNUNET_REGEX_Announcement *a = cls;
87 GNUNET_MQ_destroy (a->mq);
89 announce_reconnect (a);
94 * (Re)connect to the REGEX service with the given announcement @a a.
96 * @param a REGEX to announce.
99 announce_reconnect (struct GNUNET_REGEX_Announcement *a)
101 struct GNUNET_MQ_Envelope *env;
102 struct AnnounceMessage *am;
105 a->mq = GNUNET_CLIENT_connect (a->cfg,
108 &announce_mq_error_handler,
112 slen = strlen (a->regex) + 1;
113 env = GNUNET_MQ_msg_extra (am,
115 GNUNET_MESSAGE_TYPE_REGEX_ANNOUNCE);
116 am->compression = htons (a->compression);
117 am->reserved = htons (0);
118 am->refresh_delay = GNUNET_TIME_relative_hton (a->refresh_delay);
119 GNUNET_memcpy (&am[1],
122 GNUNET_MQ_send (a->mq,
128 * Announce the given peer under the given regular expression.
130 * @param cfg configuration to use
131 * @param regex Regular expression to announce.
132 * @param refresh_delay after what delay should the announcement be repeated?
133 * @param compression How many characters per edge can we squeeze?
134 * @return Handle to reuse o free cached resources.
135 * Must be freed by calling #GNUNET_REGEX_announce_cancel().
137 struct GNUNET_REGEX_Announcement *
138 GNUNET_REGEX_announce (const struct GNUNET_CONFIGURATION_Handle *cfg,
140 struct GNUNET_TIME_Relative refresh_delay,
141 uint16_t compression)
143 struct GNUNET_REGEX_Announcement *a;
146 slen = strlen (regex) + 1;
147 if (slen + sizeof (struct AnnounceMessage) >= GNUNET_MAX_MESSAGE_SIZE)
149 GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
150 _("Regex `%s' is too long!\n"),
155 a = GNUNET_new (struct GNUNET_REGEX_Announcement);
157 a->refresh_delay = refresh_delay;
158 a->compression = compression;
159 a->regex = GNUNET_strdup (regex);
160 announce_reconnect (a);
163 GNUNET_free (a->regex);
172 * Stop announcing the regex specified by the given handle.
174 * @param a handle returned by a previous #GNUNET_REGEX_announce() call.
177 GNUNET_REGEX_announce_cancel (struct GNUNET_REGEX_Announcement *a)
179 GNUNET_MQ_destroy (a->mq);
180 GNUNET_free (a->regex);
184 /* end of regex_api_announce.c */