diff options
author | Christian Grothoff <christian@grothoff.org> | 2013-07-14 19:25:22 +0000 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2013-07-14 19:25:22 +0000 |
commit | f271c0f567f00a9adaba5712e21ccd8129e17d74 (patch) | |
tree | 1f29cdc03ec530bdb32c89f7d3876e3d5e14a5a2 /src/include/gnunet_identity_service.h | |
parent | 4dab52c785c9e4498abeb7fe6278f23f1000ec98 (diff) | |
download | gnunet-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.h | 52 |
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" | |||
57 | struct GNUNET_IDENTITY_Handle; | 57 | struct GNUNET_IDENTITY_Handle; |
58 | 58 | ||
59 | /** | 59 | /** |
60 | * Handle for a pseudonym. | 60 | * Handle for a ego. |
61 | */ | 61 | */ |
62 | struct GNUNET_IDENTITY_Pseudonym; | 62 | struct 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 | */ |
71 | const struct GNUNET_CRYPTO_EccPrivateKey * | 71 | const struct GNUNET_CRYPTO_EccPrivateKey * |
72 | GNUNET_IDENTITY_pseudonym_get_key (struct GNUNET_IDENTITY_Pseudonym *pseudonym); | 72 | GNUNET_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 | */ |
110 | typedef void (*GNUNET_IDENTITY_Callback)(void *cls, | 110 | typedef 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, | |||
168 | struct GNUNET_IDENTITY_Operation * | 168 | struct GNUNET_IDENTITY_Operation * |
169 | GNUNET_IDENTITY_set (struct GNUNET_IDENTITY_Handle *id, | 169 | GNUNET_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 | ||