/*
This file is part of GNUnet.
- (C) 2013 Christian Grothoff (and other contributing authors)
+ Copyright (C) 2013 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
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
- Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- Boston, MA 02111-1307, USA.
+ Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ Boston, MA 02110-1301, USA.
*/
/**
- * @file include/gnunet_identity_service.h
- * @brief Identity service; implements identity management for GNUnet
* @author Christian Grothoff
*
- * Identities in GNUnet are ECDSA keys. You assume an identity by
- * using (signing with) a particular private key. As GNUnet users are
- * expected to have many egos, we need an identity service to
- * allow users to manage their egos. The identity service
- * manages the egos (private keys) of the local user; it does
- * NOT manage identities of other users (public keys). For giving
- * names to other users and manage their public keys securely, we
- * use GNS.
+ * @file
+ * Identity service; implements identity management for GNUnet
+ *
+ * @defgroup identity Identity service
+ * Identity management.
+ *
+ * Egos in GNUnet are ECDSA keys. You assume an ego by using (signing
+ * with) a particular private key. As GNUnet users are expected to
+ * have many egos, we need an identity service to allow users to
+ * manage their egos. The identity service manages the egos (private
+ * keys) of the local user; it does NOT manage egos of other users
+ * (public keys). For giving names to other users and manage their
+ * public keys securely, we use GNS.
+ *
+ * @see [Documentation](https://gnunet.org/identity-subsystem)
*
- * @defgroup identity identity management service
* @{
*/
#ifndef GNUNET_IDENTITY_SERVICE_H
/**
- * Method called to inform about the egos of
- * this peer.
+ * Method called to inform about the egos of this peer.
*
* When used with #GNUNET_IDENTITY_connect, this function is
* initially called for all egos and then again whenever a
* NULL if the user just deleted the ego and it
* must thus no longer be used
*/
-typedef void (*GNUNET_IDENTITY_Callback)(void *cls,
- struct GNUNET_IDENTITY_Ego *ego,
- void **ctx,
- const char *name);
+typedef void
+(*GNUNET_IDENTITY_Callback)(void *cls,
+ struct GNUNET_IDENTITY_Ego *ego,
+ void **ctx,
+ const char *name);
/**
/**
- * Obtain the identity that is currently preferred/default
- * for a service.
+ * Obtain the ego that is currently preferred/default for a service.
*
* @param id identity service to query
* @param service_name for which service is an identity wanted
* @param cls closure
* @param emsg NULL on success, otherwise an error message
*/
-typedef void (*GNUNET_IDENTITY_Continuation)(void *cls,
- const char *emsg);
+typedef void
+(*GNUNET_IDENTITY_Continuation)(void *cls,
+ const char *emsg);
/**
- * Set the preferred/default identity for a service.
+ * Set the preferred/default ego for a service.
*
* @param id identity service to inform
* @param service_name for which service is an identity set
/**
- * Create a new identity with the given name.
+ * Create a new ego with the given name.
*
* @param id identity service to use
* @param name desired name
/**
- * Renames an existing identity.
+ * Renames an existing ego.
*
* @param id identity service to use
* @param old_name old name
/**
- * Delete an existing identity.
+ * Delete an existing ego.
*
* @param id identity service to use
* @param name name of the identity to delete
* @param cls closure
* @param ego NULL on error / ego not found
*/
-typedef void (*GNUNET_IDENTITY_EgoCallback)(void *cls,
- const struct GNUNET_IDENTITY_Ego *ego);
+typedef void
+(*GNUNET_IDENTITY_EgoCallback)(void *cls,
+ const struct GNUNET_IDENTITY_Ego *ego);
/**
* Handle for ego lookup.
}
#endif
-/** @} */ /* end of group identity */
-
/* ifndef GNUNET_IDENTITY_SERVICE_H */
#endif
+
+/** @} */ /* end of group identity */
+
/* end of gnunet_identity_service.h */