gnunet_identity_service.h

Go to the documentation of this file.

/*
     This file is part of GNUnet.
     Copyright (C) 2013 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_IDENTITY_SERVICE_H
#define GNUNET_IDENTITY_SERVICE_H

#ifdef __cplusplus
extern "C" {
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif

#include "gnunet_util_lib.h"


#define GNUNET_IDENTITY_VERSION 0x00000100

struct GNUNET_IDENTITY_Handle;

struct GNUNET_IDENTITY_Ego;

struct GNUNET_IDENTITY_Operation;


const struct GNUNET_CRYPTO_EcdsaPrivateKey *
GNUNET_IDENTITY_ego_get_private_key(const struct GNUNET_IDENTITY_Ego *ego);


const struct GNUNET_IDENTITY_Ego *
GNUNET_IDENTITY_ego_get_anonymous(void);


void
GNUNET_IDENTITY_ego_get_public_key(const struct GNUNET_IDENTITY_Ego *ego,
                                   struct GNUNET_CRYPTO_EcdsaPublicKey *pk);


typedef void (*GNUNET_IDENTITY_Callback) (void *cls,
                                          struct GNUNET_IDENTITY_Ego *ego,
                                          void **ctx,
                                          const char *name);


struct GNUNET_IDENTITY_Handle *
GNUNET_IDENTITY_connect(const struct GNUNET_CONFIGURATION_Handle *cfg,
                        GNUNET_IDENTITY_Callback cb,
                        void *cb_cls);


struct GNUNET_IDENTITY_Operation *
GNUNET_IDENTITY_get(struct GNUNET_IDENTITY_Handle *id,
                    const char *service_name,
                    GNUNET_IDENTITY_Callback cb,
                    void *cb_cls);


typedef void (*GNUNET_IDENTITY_Continuation) (void *cls, const char *emsg);


struct GNUNET_IDENTITY_Operation *
GNUNET_IDENTITY_set(struct GNUNET_IDENTITY_Handle *id,
                    const char *service_name,
                    struct GNUNET_IDENTITY_Ego *ego,
                    GNUNET_IDENTITY_Continuation cont,
                    void *cont_cls);


void
GNUNET_IDENTITY_disconnect(struct GNUNET_IDENTITY_Handle *h);


typedef void (*GNUNET_IDENTITY_CreateContinuation) (
  void *cls,
  const struct GNUNET_CRYPTO_EcdsaPrivateKey *pk,
  const char *emsg);


struct GNUNET_IDENTITY_Operation *
GNUNET_IDENTITY_create(struct GNUNET_IDENTITY_Handle *id,
                       const char *name,
                       GNUNET_IDENTITY_CreateContinuation cont,
                       void *cont_cls);


struct GNUNET_IDENTITY_Operation *
GNUNET_IDENTITY_rename(struct GNUNET_IDENTITY_Handle *id,
                       const char *old_name,
                       const char *new_name,
                       GNUNET_IDENTITY_Continuation cb,
                       void *cb_cls);


struct GNUNET_IDENTITY_Operation *
GNUNET_IDENTITY_delete(struct GNUNET_IDENTITY_Handle *id,
                       const char *name,
                       GNUNET_IDENTITY_Continuation cb,
                       void *cb_cls);


void
GNUNET_IDENTITY_cancel(struct GNUNET_IDENTITY_Operation *op);


/* ************* convenience API to lookup an ego ***************** */

typedef void (*GNUNET_IDENTITY_EgoCallback) (
  void *cls,
  const struct GNUNET_IDENTITY_Ego *ego);

struct GNUNET_IDENTITY_EgoLookup;


struct GNUNET_IDENTITY_EgoLookup *
GNUNET_IDENTITY_ego_lookup(const struct GNUNET_CONFIGURATION_Handle *cfg,
                           const char *name,
                           GNUNET_IDENTITY_EgoCallback cb,
                           void *cb_cls);


void
GNUNET_IDENTITY_ego_lookup_cancel(struct GNUNET_IDENTITY_EgoLookup *el);

typedef void (*GNUNET_IDENTITY_EgoSuffixCallback) (
  void *cls,
  const struct GNUNET_CRYPTO_EcdsaPrivateKey *priv,
  const char *ego_name);


struct GNUNET_IDENTITY_EgoSuffixLookup;


struct GNUNET_IDENTITY_EgoSuffixLookup *
GNUNET_IDENTITY_ego_lookup_by_suffix(const struct GNUNET_CONFIGURATION_Handle *cfg,
                                     const char *suffix,
                                     GNUNET_IDENTITY_EgoSuffixCallback cb,
                                     void *cb_cls);


void
GNUNET_IDENTITY_ego_lookup_by_suffix_cancel(struct GNUNET_IDENTITY_EgoSuffixLookup *el);

#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif

/* ifndef GNUNET_IDENTITY_SERVICE_H */
#endif
 /* end of group identity */

/* end of gnunet_identity_service.h */