/usr/include/gnunet/gnunet_regex_service.h is in gnunet-dev 0.10.1-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*
This file is part of GNUnet
(C) 2012, 2013 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 3, 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 include/gnunet_regex_service.h
* @brief access regex service to advertise capabilities via regex and discover
* respective peers using matching strings
* @author Maximilian Szengel
* @author Christian Grothoff
*/
#ifndef GNUNET_REGEX_SERVICE_H
#define GNUNET_REGEX_SERVICE_H
#include "gnunet_util_lib.h"
#ifdef __cplusplus
extern "C"
{
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif
/**
* Constant for how many bytes the initial string regex should have.
*/
#define GNUNET_REGEX_INITIAL_BYTES 24
/**
* Handle to store cached data about a regex announce.
*/
struct GNUNET_REGEX_Announcement;
/**
* Handle to store data about a regex search.
*/
struct GNUNET_REGEX_Search;
/**
* Announce this peer under the given regular expression. Does
* not free resources, must call #GNUNET_REGEX_announce_cancel for
* that.
*
* @param cfg configuration to use
* @param regex Regular expression to announce.
* @param refresh_delay after what delay should the announcement be repeated?
* @param compression How many characters per edge can we squeeze?
* @return Handle to reuse o free cached resources.
* Must be freed by calling #GNUNET_REGEX_announce_cancel.
*/
struct GNUNET_REGEX_Announcement *
GNUNET_REGEX_announce (const struct GNUNET_CONFIGURATION_Handle *cfg,
const char *regex,
struct GNUNET_TIME_Relative refresh_delay,
uint16_t compression);
/**
* Stop announcing the regex specified by the given handle.
*
* @param a handle returned by a previous #GNUNET_REGEX_announce call.
*/
void
GNUNET_REGEX_announce_cancel (struct GNUNET_REGEX_Announcement *a);
/**
* Search callback function, invoked for every result that was found.
*
* @param cls Closure provided in #GNUNET_REGEX_search.
* @param id Peer providing a regex that matches the string.
* @param get_path Path of the get request.
* @param get_path_length Lenght of @a get_path.
* @param put_path Path of the put request.
* @param put_path_length Length of the @a put_path.
*/
typedef void (*GNUNET_REGEX_Found)(void *cls,
const struct GNUNET_PeerIdentity *id,
const struct GNUNET_PeerIdentity *get_path,
unsigned int get_path_length,
const struct GNUNET_PeerIdentity *put_path,
unsigned int put_path_length);
/**
* Search for a peer offering a regex matching certain string in the DHT.
* The search runs until #GNUNET_REGEX_search_cancel is called, even if results
* are returned.
*
* @param cfg configuration to use
* @param string String to match against the regexes in the DHT.
* @param callback Callback for found peers.
* @param callback_cls Closure for @c callback.
* @return Handle to stop search and free resources.
* Must be freed by calling #GNUNET_REGEX_search_cancel.
*/
struct GNUNET_REGEX_Search *
GNUNET_REGEX_search (const struct GNUNET_CONFIGURATION_Handle *cfg,
const char *string,
GNUNET_REGEX_Found callback,
void *callback_cls);
/**
* Stop search and free all data used by a #GNUNET_REGEX_search call.
*
* @param s Handle returned by a previous #GNUNET_REGEX_search call.
*/
void
GNUNET_REGEX_search_cancel (struct GNUNET_REGEX_Search *s);
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
/* end of gnunet_regex_service.h */
#endif
|