From 443454a6212e5596f7caaadf3b666fa4857edb64 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Wed, 13 Feb 2019 23:18:43 +0100 Subject: clarifying namestore api (#5458), fixing code duplication and a memory leak while at it --- src/include/gnunet_namestore_plugin.h | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'src/include') diff --git a/src/include/gnunet_namestore_plugin.h b/src/include/gnunet_namestore_plugin.h index 46a7da792..3b603b4c0 100644 --- a/src/include/gnunet_namestore_plugin.h +++ b/src/include/gnunet_namestore_plugin.h @@ -11,7 +11,7 @@ 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. - + You should have received a copy of the GNU Affero General Public License along with this program. If not, see . @@ -47,7 +47,8 @@ extern "C" * Function called for each matching record. * * @param cls closure - * @param serial unique serial number of the record + * @param serial unique serial number of the record, MUST NOT BE ZERO, + * and must be monotonically increasing while iterating * @param zone_key private key of the zone * @param label name that is being mapped (at most 255 characters long) * @param rd_count number of entries in @a rd array @@ -115,7 +116,9 @@ struct GNUNET_NAMESTORE_PluginFunctions * * @param cls closure (internal context for the plugin) * @param zone private key of the zone, NULL for all zones - * @param serial serial (to exclude) in the list of matching records + * @param serial serial (to exclude) in the list of matching records; + * 0 means to exclude nothing; results must be returned using + * the minimum possible sequence number first (ordered by serial) * @param limit maximum number of results to return to @a iter * @param iter function to call with the result * @param iter_cls closure for @a iter -- cgit v1.2.3