/*
This file is part of GNUnet
- Copyright (C) 2012, 2013 Christian Grothoff (and other contributing authors)
+ Copyright (C) 2012, 2013, 2016 GNUnet e.V.
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
* authoritative, or blocks which are cached, encrypted naming data from other
* peers.
*
+ * @see [Documentation](https://gnunet.org/namecache-subsystem)
+ *
* @{
*/
#ifndef GNUNET_NAMECACHE_SERVICE_H
* #GNUNET_YES (or other positive value) on success
* @param emsg NULL on success, otherwise an error message
*/
-typedef void (*GNUNET_NAMECACHE_ContinuationWithStatus) (void *cls,
- int32_t success,
- const char *emsg);
+typedef void
+(*GNUNET_NAMECACHE_ContinuationWithStatus) (void *cls,
+ int32_t success,
+ const char *emsg);
* @param block block to store
* @param cont continuation to call when done
* @param cont_cls closure for @a cont
- * @return handle to abort the request
+ * @return handle to abort the request, NULL on error
*/
struct GNUNET_NAMECACHE_QueueEntry *
GNUNET_NAMECACHE_block_cache (struct GNUNET_NAMECACHE_Handle *h,
* @param cls closure
* @param block block that was stored in the namecache
*/
-typedef void (*GNUNET_NAMECACHE_BlockProcessor) (void *cls,
- const struct GNUNET_GNSRECORD_Block *block);
+typedef void
+(*GNUNET_NAMECACHE_BlockProcessor) (void *cls,
+ const struct GNUNET_GNSRECORD_Block *block);
/**
* @param proc function to call on the matching block, or with
* NULL if there is no matching block
* @param proc_cls closure for @a proc
- * @return a handle that can be used to cancel
+ * @return a handle that can be used to cancel, NULL on error
*/
struct GNUNET_NAMECACHE_QueueEntry *
GNUNET_NAMECACHE_lookup_block (struct GNUNET_NAMECACHE_Handle *h,
const struct GNUNET_HashCode *derived_hash,
- GNUNET_NAMECACHE_BlockProcessor proc, void *proc_cls);
+ GNUNET_NAMECACHE_BlockProcessor proc,
+ void *proc_cls);
/**