gnunet_seti_service.h

Go to the documentation of this file.

/*
      This file is part of GNUnet
      Copyright (C) 2013, 2014, 2020 GNUnet e.V.
 
      GNUnet is free software: you can redistribute it and/or modify it
      under the terms of the GNU Affero General Public License as published
      by the Free Software Foundation, either version 3 of the License,
      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
      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 <http://www.gnu.org/licenses/>.
 
     SPDX-License-Identifier: AGPL3.0-or-later
 */
#ifndef GNUNET_SETI_SERVICE_H
#define GNUNET_SETI_SERVICE_H
 
#ifdef __cplusplus
extern "C"
{
#if 0                           /* keep Emacsens' auto-indent happy */
}
#endif
#endif
 
 
#include "gnunet_common.h"
#include "gnunet_time_lib.h"
#include "gnunet_configuration_lib.h"
 
 
#define GNUNET_SETI_CONTEXT_MESSAGE_MAX_SIZE ((1 << 16) - 1024)
 
struct GNUNET_SETI_Handle;
 
struct GNUNET_SETI_Request;
 
struct GNUNET_SETI_ListenHandle;
 
struct GNUNET_SETI_OperationHandle;
 
 
enum GNUNET_SETI_Status
{
 
  GNUNET_SETI_STATUS_ADD_LOCAL,
 
  GNUNET_SETI_STATUS_DEL_LOCAL,
 
  GNUNET_SETI_STATUS_FAILURE,
 
  GNUNET_SETI_STATUS_DONE
};
 
 
struct GNUNET_SETI_Element
{
  uint16_t size;
 
  uint16_t element_type;
 
  const void *data;
};
 
 
enum GNUNET_SETI_OptionType
{
  GNUNET_SETI_OPTION_END = 0,
 
  GNUNET_SETI_OPTION_RETURN_INTERSECTION = 1,
};
 
 
struct GNUNET_SETI_Option
{
  enum GNUNET_SETI_OptionType type;
 
  union
  {
    uint64_t num;
  } v;
};
 
 
typedef void
(*GNUNET_SETI_ResultIterator) (void *cls,
                               const struct GNUNET_SETI_Element *element,
                               uint64_t current_size,
                               enum GNUNET_SETI_Status status);
 
 
typedef void
(*GNUNET_SETI_ListenCallback) (void *cls,
                               const struct GNUNET_PeerIdentity *other_peer,
                               const struct GNUNET_MessageHeader *context_msg,
                               struct GNUNET_SETI_Request *request);
 
 
struct GNUNET_SETI_Handle *
GNUNET_SETI_create (const struct GNUNET_CONFIGURATION_Handle *cfg);
 
 
int
GNUNET_SETI_add_element (struct GNUNET_SETI_Handle *set,
                         const struct GNUNET_SETI_Element *element,
                         GNUNET_SCHEDULER_TaskCallback cb,
                         void *cb_cls);
 
 
void
GNUNET_SETI_destroy (struct GNUNET_SETI_Handle *set);
 
 
struct GNUNET_SETI_OperationHandle *
GNUNET_SETI_prepare (const struct GNUNET_PeerIdentity *other_peer,
                     const struct GNUNET_HashCode *app_id,
                     const struct GNUNET_MessageHeader *context_msg,
                     const struct GNUNET_SETI_Option options[],
                     GNUNET_SETI_ResultIterator result_cb,
                     void *result_cls);
 
 
struct GNUNET_SETI_ListenHandle *
GNUNET_SETI_listen (const struct GNUNET_CONFIGURATION_Handle *cfg,
                    const struct GNUNET_HashCode *app_id,
                    GNUNET_SETI_ListenCallback listen_cb,
                    void *listen_cls);
 
 
void
GNUNET_SETI_listen_cancel (struct GNUNET_SETI_ListenHandle *lh);
 
 
struct GNUNET_SETI_OperationHandle *
GNUNET_SETI_accept (struct GNUNET_SETI_Request *request,
                    const struct GNUNET_SETI_Option options[],
                    GNUNET_SETI_ResultIterator result_cb,
                    void *result_cls);
 
 
int
GNUNET_SETI_commit (struct GNUNET_SETI_OperationHandle *oh,
                    struct GNUNET_SETI_Handle *set);
 
 
void
GNUNET_SETI_operation_cancel (struct GNUNET_SETI_OperationHandle *oh);
 
 
void
GNUNET_SETI_element_hash (const struct GNUNET_SETI_Element *element,
                          struct GNUNET_HashCode *ret_hash);
 
 
#if 0                           /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
 
#endif
  /* end of group */
 /* end of group addition */