gnunet_gns_service.h

Go to the documentation of this file.

/*
      This file is part of GNUnet
      Copyright (C) 2012-2014, 2017 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_GNS_SERVICE_H
#define GNUNET_GNS_SERVICE_H
 
 
#include "gnunet_util_lib.h"
#include "gnunet_identity_service.h"
#include "gnunet_namestore_service.h"
 
#ifdef __cplusplus
extern "C" {
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif
 
 
struct GNUNET_GNS_Handle;
 
struct GNUNET_GNS_LookupRequest;
 
struct GNUNET_GNS_LookupWithTldRequest;
 
 
struct GNUNET_GNS_Handle *
GNUNET_GNS_connect (const struct GNUNET_CONFIGURATION_Handle *cfg);
 
 
void
GNUNET_GNS_disconnect (struct GNUNET_GNS_Handle *handle);
 
 
typedef void (*GNUNET_GNS_LookupResultProcessor) (
  void *cls,
  uint32_t rd_count,
  const struct GNUNET_GNSRECORD_Data *rd);
 
 
enum GNUNET_GNS_LocalOptions
{
  GNUNET_GNS_LO_DEFAULT = 0,
 
  GNUNET_GNS_LO_NO_DHT = 1,
 
  GNUNET_GNS_LO_LOCAL_MASTER = 2
};
 
 
struct GNUNET_GNS_LookupRequest *
GNUNET_GNS_lookup (struct GNUNET_GNS_Handle *handle,
                   const char *name,
                   const struct GNUNET_CRYPTO_PublicKey *zone,
                   uint32_t type,
                   enum GNUNET_GNS_LocalOptions options,
                   GNUNET_GNS_LookupResultProcessor proc,
                   void *proc_cls);
 
 
struct GNUNET_GNS_LookupRequest *
GNUNET_GNS_lookup_limited (struct GNUNET_GNS_Handle *handle,
                           const char *name,
                           const struct GNUNET_CRYPTO_PublicKey *zone,
                           uint32_t type,
                           enum GNUNET_GNS_LocalOptions options,
                           uint16_t recursion_depth_limit,
                           GNUNET_GNS_LookupResultProcessor proc,
                           void *proc_cls);
 
 
void *
GNUNET_GNS_lookup_cancel (struct GNUNET_GNS_LookupRequest *lr);
 
 
typedef void (*GNUNET_GNS_LookupResultProcessor2) (
  void *cls,
  int gns_tld,
  uint32_t rd_count,
  const struct GNUNET_GNSRECORD_Data *rd);
 
 
struct GNUNET_GNS_LookupWithTldRequest *
GNUNET_GNS_lookup_with_tld (struct GNUNET_GNS_Handle *handle,
                            const char *name,
                            uint32_t type,
                            enum GNUNET_GNS_LocalOptions options,
                            GNUNET_GNS_LookupResultProcessor2 proc,
                            void *proc_cls);
 
 
void *
GNUNET_GNS_lookup_with_tld_cancel (struct GNUNET_GNS_LookupWithTldRequest *ltr);
 
enum GNUNET_GenericReturnValue
GNUNET_GNS_parse_ztld (const char *name,
                       struct GNUNET_CRYPTO_PublicKey *ztld_key);
 
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
 
#endif
 /* end of group */
 /* end of group addition */