2 This file is part of GNUnet.
3 (C) 2009, 2010, 2012, 2013 Christian Grothoff (and other contributing authors)
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., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
22 * @file fs/fs_publish_ublock.h
23 * @brief publish a UBLOCK in GNUnet
24 * @see https://gnunet.org/encoding and #2564
25 * @author Krista Bennett
26 * @author Christian Grothoff
28 #ifndef FS_PUBLISH_UBLOCK_H
29 #define FS_PUBLISH_UBLOCK_H
31 #include "gnunet_util_lib.h"
32 #include "gnunet_datastore_service.h"
33 #include "gnunet_fs_service.h"
34 #include "gnunet_identity_service.h"
38 * Decrypt the given UBlock, storing the result in output.
40 * @param input input data
41 * @param input_len number of bytes in input
42 * @param ns public key under which the UBlock was stored
43 * @param label label under which the UBlock was stored
44 * @param output where to write the result, has input_len bytes
47 GNUNET_FS_ublock_decrypt_ (const void *input,
49 const struct GNUNET_CRYPTO_EcdsaPublicKey *ns,
55 * Context for 'ublock_put_cont'.
57 struct GNUNET_FS_PublishUblockContext;
61 * Signature of a function called as the continuation of a UBlock
65 * @param emsg error message, NULL on success
67 typedef void (*GNUNET_FS_UBlockContinuation) (void *cls,
74 * @param h handle to the file sharing subsystem
75 * @param dsh datastore handle to use for storage operation
76 * @param label identifier to use
77 * @param ulabel update label to use, may be an empty string for none
78 * @param ns namespace to publish in
79 * @param meta metadata to use
80 * @param uri URI to refer to in the UBlock
81 * @param bo per-block options
82 * @param options publication options
83 * @param cont continuation
84 * @param cont_cls closure for cont
85 * @return NULL on error ('cont' will still be called)
87 struct GNUNET_FS_PublishUblockContext *
88 GNUNET_FS_publish_ublock_ (struct GNUNET_FS_Handle *h,
89 struct GNUNET_DATASTORE_Handle *dsh,
92 const struct GNUNET_CRYPTO_EcdsaPrivateKey *ns,
93 const struct GNUNET_CONTAINER_MetaData *meta,
94 const struct GNUNET_FS_Uri *uri,
95 const struct GNUNET_FS_BlockOptions *bo,
96 enum GNUNET_FS_PublishOptions options,
97 GNUNET_FS_UBlockContinuation cont, void *cont_cls);
101 * Abort UBlock publishing operation.
103 * @param uc operation to abort.
106 GNUNET_FS_publish_ublock_cancel_ (struct GNUNET_FS_PublishUblockContext *uc);