Boston, MA 02111-1307, 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.
+ * 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.
*
* @defgroup identity identity management service
* @{
#include "gnunet_util_lib.h"
-/**
+/**
* Version number of GNUnet Identity API.
*/
#define GNUNET_IDENTITY_VERSION 0x00000000
-/**
+/**
* Handle to access the identity service.
*/
struct GNUNET_IDENTITY_Handle;
-/**
+/**
* Handle for a ego.
*/
struct GNUNET_IDENTITY_Ego;
-/**
+/**
* Handle for an operation with the identity service.
*/
struct GNUNET_IDENTITY_Operation;
* @param ego the ego
* @return associated ECC key, valid as long as the ego is valid
*/
-const struct GNUNET_CRYPTO_EccPrivateKey *
+const struct GNUNET_CRYPTO_EcdsaPrivateKey *
GNUNET_IDENTITY_ego_get_private_key (const struct GNUNET_IDENTITY_Ego *ego);
/**
* Obtain the ego representing 'anonymous' users.
*
- * @returns handle for the anonymous user, must not be freed
+ * @return handle for the anonymous user, must not be freed
*/
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_EccPublicKey *pk);
+ struct GNUNET_CRYPTO_EcdsaPublicKey *pk);
-/**
+/**
* Method called to inform about the egos of
- * this peer.
+ * this peer.
*
* When used with #GNUNET_IDENTITY_connect, this function is
* initially called for all egos and then again whenever a
* @a ego does indicate an error (i.e. name is taken or no default
* value is known). If @a ego is non-NULL and if '*ctx'
* is set in those callbacks, the value WILL be passed to a subsequent
- * call to the identity callback of #GNUNET_IDENTITY_connect (if
+ * call to the identity callback of #GNUNET_IDENTITY_connect (if
* that one was not NULL).
*
* When an identity is renamed, this function is called with the
- * (known) @a ego but the NEW @a name.
+ * (known) @a ego but the NEW @a name.
*
* When an identity is deleted, this function is called with the
* (known) ego and "NULL" for the @a name. In this case,
*
* @param cls closure
* @param ego ego handle
- * @param ego_ctx context for application to store data for this ego
+ * @param ctx context for application to store data for this ego
* (during the lifetime of this process, initially NULL)
* @param name name assigned by the user for this ego,
* NULL if the user just deleted the ego and it
const char *name);
-/**
+/**
* Connect to the identity service.
*
* @param cfg Configuration to contact the identity service.
/**
- * Obtain the identity that is currently preferred/default
+ * Obtain the ego that is currently preferred/default
* for a service.
*
* @param id identity service to query
/**
- * 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
* Disconnect from identity service.
*
* @param h identity service to disconnect
- */
+ */
void
GNUNET_IDENTITY_disconnect (struct GNUNET_IDENTITY_Handle *h);
-/**
- * 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
void *cont_cls);
-/**
- * Renames an existing identity.
+/**
+ * Renames an existing ego.
*
* @param id identity service to use
* @param old_name old name
void *cb_cls);
-/**
- * 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);
/**
* Handle for ego lookup.
- */
+ */
struct GNUNET_IDENTITY_EgoLookup;