aboutsummaryrefslogtreecommitdiff
path: root/src/include/gnunet_identity_service.h
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2013-07-14 19:25:22 +0000
committerChristian Grothoff <christian@grothoff.org>2013-07-14 19:25:22 +0000
commitf271c0f567f00a9adaba5712e21ccd8129e17d74 (patch)
tree1f29cdc03ec530bdb32c89f7d3876e3d5e14a5a2 /src/include/gnunet_identity_service.h
parent4dab52c785c9e4498abeb7fe6278f23f1000ec98 (diff)
downloadgnunet-f271c0f567f00a9adaba5712e21ccd8129e17d74.tar.gz
gnunet-f271c0f567f00a9adaba5712e21ccd8129e17d74.zip
-renaming pseudonym to ego in identity service
Diffstat (limited to 'src/include/gnunet_identity_service.h')
-rw-r--r--src/include/gnunet_identity_service.h52
1 files changed, 26 insertions, 26 deletions
diff --git a/src/include/gnunet_identity_service.h b/src/include/gnunet_identity_service.h
index 2ad40791d..e5ea98de3 100644
--- a/src/include/gnunet_identity_service.h
+++ b/src/include/gnunet_identity_service.h
@@ -25,9 +25,9 @@
25 * 25 *
26 * Identities in GNUnet are ECDSA keys. You assume an identity by 26 * Identities in GNUnet are ECDSA keys. You assume an identity by
27 * using (signing with) a particular private key. As GNUnet users are 27 * using (signing with) a particular private key. As GNUnet users are
28 * expected to have many pseudonyms, we need an identity service to 28 * expected to have many egos, we need an identity service to
29 * allow users to manage their pseudonyms. The identity service 29 * allow users to manage their egos. The identity service
30 * manages the pseudonyms (private keys) of the local user; it does 30 * manages the egos (private keys) of the local user; it does
31 * NOT manage identities of other users (public keys). For giving 31 * NOT manage identities of other users (public keys). For giving
32 * names to other users and manage their public keys securely, we 32 * names to other users and manage their public keys securely, we
33 * use GADS/GNS. 33 * use GADS/GNS.
@@ -57,58 +57,58 @@ extern "C"
57struct GNUNET_IDENTITY_Handle; 57struct GNUNET_IDENTITY_Handle;
58 58
59/** 59/**
60 * Handle for a pseudonym. 60 * Handle for a ego.
61 */ 61 */
62struct GNUNET_IDENTITY_Pseudonym; 62struct GNUNET_IDENTITY_Ego;
63 63
64 64
65/** 65/**
66 * Obtain the ECC key associated with a pseudonym. 66 * Obtain the ECC key associated with a ego.
67 * 67 *
68 * @param pseudonym the pseudonym 68 * @param ego the ego
69 * @return associated ECC key, valid as long as the pseudonym is valid 69 * @return associated ECC key, valid as long as the ego is valid
70 */ 70 */
71const struct GNUNET_CRYPTO_EccPrivateKey * 71const struct GNUNET_CRYPTO_EccPrivateKey *
72GNUNET_IDENTITY_pseudonym_get_key (struct GNUNET_IDENTITY_Pseudonym *pseudonym); 72GNUNET_IDENTITY_ego_get_key (struct GNUNET_IDENTITY_Ego *ego);
73 73
74 74
75/** 75/**
76 * Method called to inform about the pseudonyms of 76 * Method called to inform about the egos of
77 * this peer. 77 * this peer.
78 * 78 *
79 * When used with 'GNUNET_IDENTITY_connect', this function is 79 * When used with 'GNUNET_IDENTITY_connect', this function is
80 * initially called for all pseudonyms and then again whenever a 80 * initially called for all egos and then again whenever a
81 * pseudonym's identifier changes or if it is deleted. At the end of 81 * ego's identifier changes or if it is deleted. At the end of
82 * the initial pass over all pseudonyms, the function is once called 82 * the initial pass over all egos, the function is once called
83 * with 'NULL' for 'pseu'. That does NOT mean that the callback won't 83 * with 'NULL' for 'ego'. That does NOT mean that the callback won't
84 * be invoked in the future or that there was an error. 84 * be invoked in the future or that there was an error.
85 * 85 *
86 * When used with 'GNUNET_IDENTITY_create' or 'GNUNET_IDENTITY_get', 86 * When used with 'GNUNET_IDENTITY_create' or 'GNUNET_IDENTITY_get',
87 * this function is only called ONCE, and 'NULL' being passed in 87 * this function is only called ONCE, and 'NULL' being passed in
88 * 'pseu' does indicate an error (i.e. name is taken or no default 88 * 'ego' does indicate an error (i.e. name is taken or no default
89 * value is known). If 'pseu' is non-NULL and if '*ctx' 89 * value is known). If 'ego' is non-NULL and if '*ctx'
90 * is set in those callbacks, the value WILL be passed to a subsequent 90 * is set in those callbacks, the value WILL be passed to a subsequent
91 * call to the identity callback of 'GNUNET_IDENTITY_connect' (if 91 * call to the identity callback of 'GNUNET_IDENTITY_connect' (if
92 * that one was not NULL). 92 * that one was not NULL).
93 * 93 *
94 * When an identity is renamed, this function is called with the 94 * When an identity is renamed, this function is called with the
95 * (known) pseudonym but the NEW identifier. 95 * (known) ego but the NEW identifier.
96 * 96 *
97 * When an identity is deleted, this function is called with the 97 * When an identity is deleted, this function is called with the
98 * (known) pseudonym and "NULL" for the 'identifier'. In this case, 98 * (known) ego and "NULL" for the 'identifier'. In this case,
99 * the 'pseu' is henceforth invalid (and the 'ctx' should also be 99 * the 'ego' is henceforth invalid (and the 'ctx' should also be
100 * cleaned up). 100 * cleaned up).
101 * 101 *
102 * @param cls closure 102 * @param cls closure
103 * @param pseu pseudonym handle 103 * @param ego ego handle
104 * @param pseu_ctx context for application to store data for this pseudonym 104 * @param ego_ctx context for application to store data for this ego
105 * (during the lifetime of this process, initially NULL) 105 * (during the lifetime of this process, initially NULL)
106 * @param identifier identifier assigned by the user for this pseudonym, 106 * @param identifier identifier assigned by the user for this ego,
107 * NULL if the user just deleted the pseudonym and it 107 * NULL if the user just deleted the ego and it
108 * must thus no longer be used 108 * must thus no longer be used
109 */ 109 */
110typedef void (*GNUNET_IDENTITY_Callback)(void *cls, 110typedef void (*GNUNET_IDENTITY_Callback)(void *cls,
111 struct GNUNET_IDENTITY_Pseudonym *pseu, 111 struct GNUNET_IDENTITY_Ego *ego,
112 void **ctx, 112 void **ctx,
113 const char *identifier); 113 const char *identifier);
114 114
@@ -160,7 +160,7 @@ typedef void (*GNUNET_IDENTITY_Continuation)(void *cls,
160 * 160 *
161 * @param id identity service to inform 161 * @param id identity service to inform
162 * @param service_name for which service is an identity set 162 * @param service_name for which service is an identity set
163 * @param pseu new default identity to be set for this service 163 * @param ego new default identity to be set for this service
164 * @param cont function to call once the operation finished 164 * @param cont function to call once the operation finished
165 * @param cont_cls closure for cont 165 * @param cont_cls closure for cont
166 * @return handle to abort the operation 166 * @return handle to abort the operation
@@ -168,7 +168,7 @@ typedef void (*GNUNET_IDENTITY_Continuation)(void *cls,
168struct GNUNET_IDENTITY_Operation * 168struct GNUNET_IDENTITY_Operation *
169GNUNET_IDENTITY_set (struct GNUNET_IDENTITY_Handle *id, 169GNUNET_IDENTITY_set (struct GNUNET_IDENTITY_Handle *id,
170 const char *service_name, 170 const char *service_name,
171 struct GNUNET_IDENTITY_Pseudonym *pseu, 171 struct GNUNET_IDENTITY_Ego *ego,
172 GNUNET_IDENTITY_Continuation cont, 172 GNUNET_IDENTITY_Continuation cont,
173 void *cont_cls); 173 void *cont_cls);
174 174