aboutsummaryrefslogtreecommitdiff
path: root/src/include/gnunet_fs_service.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/include/gnunet_fs_service.h')
-rw-r--r--src/include/gnunet_fs_service.h146
1 files changed, 73 insertions, 73 deletions
diff --git a/src/include/gnunet_fs_service.h b/src/include/gnunet_fs_service.h
index 6143f0630..83279cb08 100644
--- a/src/include/gnunet_fs_service.h
+++ b/src/include/gnunet_fs_service.h
@@ -84,7 +84,7 @@ struct GNUNET_FS_Uri;
84 * Identifier for a GNUnet pseudonym (the public key). 84 * Identifier for a GNUnet pseudonym (the public key).
85 * Q-point, Q=dp. 85 * Q-point, Q=dp.
86 */ 86 */
87struct GNUNET_PseudonymIdentifier 87struct GNUNET_FS_PseudonymIdentifier
88{ 88{
89 /** 89 /**
90 * Q consists of an x- and a y-value, each mod p (256 bits), 90 * Q consists of an x- and a y-value, each mod p (256 bits),
@@ -104,7 +104,7 @@ struct GNUNET_PseudonymIdentifier
104/** 104/**
105 * Handle for a pseudonym (private key). 105 * Handle for a pseudonym (private key).
106 */ 106 */
107struct GNUNET_PseudonymHandle; 107struct GNUNET_FS_PseudonymHandle;
108 108
109 109
110/** 110/**
@@ -114,13 +114,13 @@ struct GNUNET_PseudonymHandle;
114 * where z is derived from the hash of the message that is being 114 * where z is derived from the hash of the message that is being
115 * signed. 115 * signed.
116 */ 116 */
117struct GNUNET_PseudonymSignature 117struct GNUNET_FS_PseudonymSignature
118{ 118{
119 119
120 /** 120 /**
121 * Who created the signature? (public key of the signer), 'd' value in NIST P-256. 121 * Who created the signature? (public key of the signer), 'd' value in NIST P-256.
122 */ 122 */
123 struct GNUNET_PseudonymIdentifier signer; 123 struct GNUNET_FS_PseudonymIdentifier signer;
124 124
125 /** 125 /**
126 * Binary ECDSA signature data, r-value. Value is mod n, and n is 256 bits. 126 * Binary ECDSA signature data, r-value. Value is mod n, and n is 256 bits.
@@ -137,7 +137,7 @@ struct GNUNET_PseudonymSignature
137/** 137/**
138 * Purpose for signature made with a pseudonym. 138 * Purpose for signature made with a pseudonym.
139 */ 139 */
140struct GNUNET_PseudonymSignaturePurpose 140struct GNUNET_FS_PseudonymSignaturePurpose
141{ 141{
142 /** 142 /**
143 * How many bytes are being signed (including this header)? 143 * How many bytes are being signed (including this header)?
@@ -171,8 +171,8 @@ typedef int (*GNUNET_FS_KeywordIterator) (void *cls, const char *keyword,
171 * @param filename name of the file to use for storage, NULL for in-memory only 171 * @param filename name of the file to use for storage, NULL for in-memory only
172 * @return handle to the private key of the pseudonym 172 * @return handle to the private key of the pseudonym
173 */ 173 */
174struct GNUNET_PseudonymHandle * 174struct GNUNET_FS_PseudonymHandle *
175GNUNET_PSEUDONYM_create (const char *filename); 175GNUNET_FS_pseudonym_create (const char *filename);
176 176
177 177
178/** 178/**
@@ -181,8 +181,8 @@ GNUNET_PSEUDONYM_create (const char *filename);
181 * @param filename name of the file to use for storage, NULL for in-memory only 181 * @param filename name of the file to use for storage, NULL for in-memory only
182 * @return handle to the private key of the pseudonym 182 * @return handle to the private key of the pseudonym
183 */ 183 */
184struct GNUNET_PseudonymHandle * 184struct GNUNET_FS_PseudonymHandle *
185GNUNET_PSEUDONYM_create_from_existing_file (const char *filename); 185GNUNET_FS_pseudonym_create_from_existing_file (const char *filename);
186 186
187 187
188/** 188/**
@@ -193,8 +193,8 @@ GNUNET_PSEUDONYM_create_from_existing_file (const char *filename);
193 * 193 *
194 * @return handle to the (non-secret) private key of the 'anonymous' pseudonym 194 * @return handle to the (non-secret) private key of the 'anonymous' pseudonym
195 */ 195 */
196struct GNUNET_PseudonymHandle * 196struct GNUNET_FS_PseudonymHandle *
197GNUNET_PSEUDONYM_get_anonymous_pseudonym_handle (void); 197GNUNET_FS_pseudonym_get_anonymous_pseudonym_handle (void);
198 198
199 199
200/** 200/**
@@ -204,7 +204,7 @@ GNUNET_PSEUDONYM_get_anonymous_pseudonym_handle (void);
204 * @param ph pseudonym handle to destroy 204 * @param ph pseudonym handle to destroy
205 */ 205 */
206void 206void
207GNUNET_PSEUDONYM_destroy (struct GNUNET_PseudonymHandle *ph); 207GNUNET_FS_pseudonym_destroy (struct GNUNET_FS_PseudonymHandle *ph);
208 208
209 209
210/** 210/**
@@ -221,11 +221,11 @@ GNUNET_PSEUDONYM_destroy (struct GNUNET_PseudonymHandle *ph);
221 * @return GNUNET_SYSERR on failure 221 * @return GNUNET_SYSERR on failure
222 */ 222 */
223int 223int
224GNUNET_PSEUDONYM_sign (struct GNUNET_PseudonymHandle *ph, 224GNUNET_FS_pseudonym_sign (struct GNUNET_FS_PseudonymHandle *ph,
225 const struct GNUNET_PseudonymSignaturePurpose *purpose, 225 const struct GNUNET_FS_PseudonymSignaturePurpose *purpose,
226 const struct GNUNET_HashCode *seed, 226 const struct GNUNET_HashCode *seed,
227 const struct GNUNET_HashCode *signing_key, 227 const struct GNUNET_HashCode *signing_key,
228 struct GNUNET_PseudonymSignature *signature); 228 struct GNUNET_FS_PseudonymSignature *signature);
229 229
230 230
231/** 231/**
@@ -236,13 +236,13 @@ GNUNET_PSEUDONYM_sign (struct GNUNET_PseudonymHandle *ph,
236 * @param signing_key input to derive 'h' (see section 2.4 of #2564) 236 * @param signing_key input to derive 'h' (see section 2.4 of #2564)
237 * @param verification_key resulting public key to verify the signature 237 * @param verification_key resulting public key to verify the signature
238 * created from the 'ph' of 'pseudonym' and the 'signing_key'; 238 * created from the 'ph' of 'pseudonym' and the 'signing_key';
239 * the value stored here can then be given to GNUNET_PSEUDONYM_verify. 239 * the value stored here can then be given to GNUNET_FS_pseudonym_verify.
240 * @return GNUNET_OK on success, GNUNET_SYSERR on error 240 * @return GNUNET_OK on success, GNUNET_SYSERR on error
241 */ 241 */
242int 242int
243GNUNET_PSEUDONYM_derive_verification_key (struct GNUNET_PseudonymIdentifier *pseudonym, 243GNUNET_FS_pseudonym_derive_verification_key (struct GNUNET_FS_PseudonymIdentifier *pseudonym,
244 const struct GNUNET_HashCode *signing_key, 244 const struct GNUNET_HashCode *signing_key,
245 struct GNUNET_PseudonymIdentifier *verification_key); 245 struct GNUNET_FS_PseudonymIdentifier *verification_key);
246 246
247 247
248/** 248/**
@@ -256,9 +256,9 @@ GNUNET_PSEUDONYM_derive_verification_key (struct GNUNET_PseudonymIdentifier *pse
256 * GNUNET_SYSERR if the signature is invalid 256 * GNUNET_SYSERR if the signature is invalid
257 */ 257 */
258int 258int
259GNUNET_PSEUDONYM_verify (const struct GNUNET_PseudonymSignaturePurpose *purpose, 259GNUNET_FS_pseudonym_verify (const struct GNUNET_FS_PseudonymSignaturePurpose *purpose,
260 const struct GNUNET_PseudonymSignature *signature, 260 const struct GNUNET_FS_PseudonymSignature *signature,
261 const struct GNUNET_PseudonymIdentifier *verification_key); 261 const struct GNUNET_FS_PseudonymIdentifier *verification_key);
262 262
263 263
264/** 264/**
@@ -268,8 +268,8 @@ GNUNET_PSEUDONYM_verify (const struct GNUNET_PseudonymSignaturePurpose *purpose,
268 * @param pseudonym pseudonym identifier (set based on 'ph') 268 * @param pseudonym pseudonym identifier (set based on 'ph')
269 */ 269 */
270void 270void
271GNUNET_PSEUDONYM_get_identifier (struct GNUNET_PseudonymHandle *ph, 271GNUNET_FS_pseudonym_get_identifier (struct GNUNET_FS_PseudonymHandle *ph,
272 struct GNUNET_PseudonymIdentifier *pseudonym); 272 struct GNUNET_FS_PseudonymIdentifier *pseudonym);
273 273
274 274
275 275
@@ -284,12 +284,12 @@ GNUNET_PSEUDONYM_get_identifier (struct GNUNET_PseudonymHandle *ph,
284 * @param rating the local rating of the pseudonym 284 * @param rating the local rating of the pseudonym
285 * @return GNUNET_OK to continue iteration, GNUNET_SYSERR to abort 285 * @return GNUNET_OK to continue iteration, GNUNET_SYSERR to abort
286 */ 286 */
287typedef int (*GNUNET_PSEUDONYM_Iterator) (void *cls, 287typedef int (*GNUNET_FS_PseudonymIterator) (void *cls,
288 const struct GNUNET_PseudonymIdentifier *pseudonym, 288 const struct GNUNET_FS_PseudonymIdentifier *pseudonym,
289 const char *name, 289 const char *name,
290 const char *unique_name, 290 const char *unique_name,
291 const struct GNUNET_CONTAINER_MetaData *md, 291 const struct GNUNET_CONTAINER_MetaData *md,
292 int32_t rating); 292 int32_t rating);
293 293
294 294
295/** 295/**
@@ -301,9 +301,9 @@ typedef int (*GNUNET_PSEUDONYM_Iterator) (void *cls,
301 * @return new rating of the pseudonym 301 * @return new rating of the pseudonym
302 */ 302 */
303int 303int
304GNUNET_PSEUDONYM_rank (const struct GNUNET_CONFIGURATION_Handle *cfg, 304GNUNET_FS_pseudonym_rank (const struct GNUNET_CONFIGURATION_Handle *cfg,
305 const struct GNUNET_PseudonymIdentifier *pseudonym, 305 const struct GNUNET_FS_PseudonymIdentifier *pseudonym,
306 int32_t delta); 306 int32_t delta);
307 307
308 308
309/** 309/**
@@ -317,9 +317,9 @@ GNUNET_PSEUDONYM_rank (const struct GNUNET_CONFIGURATION_Handle *cfg,
317 * @return GNUNET_OK on success, GNUNET_SYSERR on failure 317 * @return GNUNET_OK on success, GNUNET_SYSERR on failure
318 */ 318 */
319int 319int
320GNUNET_PSEUDONYM_add (const struct GNUNET_CONFIGURATION_Handle *cfg, 320GNUNET_FS_pseudonym_add (const struct GNUNET_CONFIGURATION_Handle *cfg,
321 const struct GNUNET_PseudonymIdentifier *pseudonym, 321 const struct GNUNET_FS_PseudonymIdentifier *pseudonym,
322 const struct GNUNET_CONTAINER_MetaData *meta); 322 const struct GNUNET_CONTAINER_MetaData *meta);
323 323
324 324
325/** 325/**
@@ -331,15 +331,15 @@ GNUNET_PSEUDONYM_add (const struct GNUNET_CONFIGURATION_Handle *cfg,
331 * @return number of pseudonyms found 331 * @return number of pseudonyms found
332 */ 332 */
333int 333int
334GNUNET_PSEUDONYM_list_all (const struct GNUNET_CONFIGURATION_Handle *cfg, 334GNUNET_FS_pseudonym_list_all (const struct GNUNET_CONFIGURATION_Handle *cfg,
335 GNUNET_PSEUDONYM_Iterator iterator, 335 GNUNET_FS_PseudonymIterator iterator,
336 void *iterator_cls); 336 void *iterator_cls);
337 337
338 338
339/** 339/**
340 * Handle for a discovery callback registration. 340 * Handle for a discovery callback registration.
341 */ 341 */
342struct GNUNET_PSEUDONYM_DiscoveryHandle; 342struct GNUNET_FS_pseudonym_DiscoveryHandle;
343 343
344 344
345/** 345/**
@@ -351,10 +351,10 @@ struct GNUNET_PSEUDONYM_DiscoveryHandle;
351 * @param iterator_cls closure for iterator 351 * @param iterator_cls closure for iterator
352 * @return registration handle 352 * @return registration handle
353 */ 353 */
354struct GNUNET_PSEUDONYM_DiscoveryHandle * 354struct GNUNET_FS_pseudonym_DiscoveryHandle *
355GNUNET_PSEUDONYM_discovery_callback_register (const struct GNUNET_CONFIGURATION_Handle *cfg, 355GNUNET_FS_pseudonym_discovery_callback_register (const struct GNUNET_CONFIGURATION_Handle *cfg,
356 GNUNET_PSEUDONYM_Iterator iterator, 356 GNUNET_FS_PseudonymIterator iterator,
357 void *iterator_cls); 357 void *iterator_cls);
358 358
359 359
360/** 360/**
@@ -363,12 +363,12 @@ GNUNET_PSEUDONYM_discovery_callback_register (const struct GNUNET_CONFIGURATION_
363 * @param dh registration to unregister 363 * @param dh registration to unregister
364 */ 364 */
365void 365void
366GNUNET_PSEUDONYM_discovery_callback_unregister (struct GNUNET_PSEUDONYM_DiscoveryHandle *dh); 366GNUNET_FS_pseudonym_discovery_callback_unregister (struct GNUNET_FS_pseudonym_DiscoveryHandle *dh);
367 367
368 368
369/** 369/**
370 * Return unique variant of the pseudonym name. Use after 370 * Return unique variant of the pseudonym name. Use after
371 * GNUNET_PSEUDONYM_id_to_name() to make sure that name is unique. 371 * GNUNET_FS_pseudonym_id_to_name() to make sure that name is unique.
372 * 372 *
373 * @param cfg configuration 373 * @param cfg configuration
374 * @param pseudonym cryptographic ID of the pseudonym 374 * @param pseudonym cryptographic ID of the pseudonym
@@ -378,10 +378,10 @@ GNUNET_PSEUDONYM_discovery_callback_unregister (struct GNUNET_PSEUDONYM_Discover
378 * Free the name with GNUNET_free(). 378 * Free the name with GNUNET_free().
379 */ 379 */
380char * 380char *
381GNUNET_PSEUDONYM_name_uniquify (const struct GNUNET_CONFIGURATION_Handle *cfg, 381GNUNET_FS_pseudonym_name_uniquify (const struct GNUNET_CONFIGURATION_Handle *cfg,
382 const struct GNUNET_PseudonymIdentifier *pseudonym, 382 const struct GNUNET_FS_PseudonymIdentifier *pseudonym,
383 const char *name, 383 const char *name,
384 unsigned int *suffix); 384 unsigned int *suffix);
385 385
386 386
387/** 387/**
@@ -405,12 +405,12 @@ GNUNET_PSEUDONYM_name_uniquify (const struct GNUNET_CONFIGURATION_Handle *cfg,
405 * empty metadata container, rank -1 and a "no-name" name). 405 * empty metadata container, rank -1 and a "no-name" name).
406 */ 406 */
407int 407int
408GNUNET_PSEUDONYM_get_info (const struct GNUNET_CONFIGURATION_Handle *cfg, 408GNUNET_FS_pseudonym_get_info (const struct GNUNET_CONFIGURATION_Handle *cfg,
409 const struct GNUNET_PseudonymIdentifier *pseudonym, 409 const struct GNUNET_FS_PseudonymIdentifier *pseudonym,
410 struct GNUNET_CONTAINER_MetaData **ret_meta, 410 struct GNUNET_CONTAINER_MetaData **ret_meta,
411 int32_t *ret_rank, 411 int32_t *ret_rank,
412 char **ret_name, 412 char **ret_name,
413 int *name_is_a_dup); 413 int *name_is_a_dup);
414 414
415 415
416/** 416/**
@@ -422,9 +422,9 @@ GNUNET_PSEUDONYM_get_info (const struct GNUNET_CONFIGURATION_Handle *cfg,
422 * @return GNUNET_OK on success, GNUNET_SYSERR on failure 422 * @return GNUNET_OK on success, GNUNET_SYSERR on failure
423 */ 423 */
424int 424int
425GNUNET_PSEUDONYM_name_to_id (const struct GNUNET_CONFIGURATION_Handle *cfg, 425GNUNET_FS_pseudonym_name_to_id (const struct GNUNET_CONFIGURATION_Handle *cfg,
426 const char *ns_uname, 426 const char *ns_uname,
427 struct GNUNET_PseudonymIdentifier *pseudonym); 427 struct GNUNET_FS_PseudonymIdentifier *pseudonym);
428 428
429 429
430/** 430/**
@@ -440,11 +440,11 @@ GNUNET_PSEUDONYM_name_to_id (const struct GNUNET_CONFIGURATION_Handle *cfg,
440 * @return GNUNET_OK on success, GNUNET_SYSERR on failure 440 * @return GNUNET_OK on success, GNUNET_SYSERR on failure
441 */ 441 */
442int 442int
443GNUNET_PSEUDONYM_set_info (const struct GNUNET_CONFIGURATION_Handle *cfg, 443GNUNET_FS_pseudonym_set_info (const struct GNUNET_CONFIGURATION_Handle *cfg,
444 const struct GNUNET_PseudonymIdentifier *pseudonym, 444 const struct GNUNET_FS_PseudonymIdentifier *pseudonym,
445 const char *name, 445 const char *name,
446 const struct GNUNET_CONTAINER_MetaData *md, 446 const struct GNUNET_CONTAINER_MetaData *md,
447 int32_t rank); 447 int32_t rank);
448 448
449 449
450/** 450/**
@@ -455,8 +455,8 @@ GNUNET_PSEUDONYM_set_info (const struct GNUNET_CONFIGURATION_Handle *cfg,
455 * @return GNUNET_OK on success, GNUNET_SYSERR on failure 455 * @return GNUNET_OK on success, GNUNET_SYSERR on failure
456 */ 456 */
457int 457int
458GNUNET_PSEUDONYM_remove (const struct GNUNET_CONFIGURATION_Handle *cfg, 458GNUNET_FS_pseudonym_remove (const struct GNUNET_CONFIGURATION_Handle *cfg,
459 const struct GNUNET_PseudonymIdentifier *id); 459 const struct GNUNET_FS_PseudonymIdentifier *id);
460 460
461 461
462/** 462/**
@@ -719,7 +719,7 @@ GNUNET_FS_uri_sks_create (struct GNUNET_FS_Namespace *ns, const char *id,
719 * @return an FS URI for the given namespace and identifier 719 * @return an FS URI for the given namespace and identifier
720 */ 720 */
721struct GNUNET_FS_Uri * 721struct GNUNET_FS_Uri *
722GNUNET_FS_uri_sks_create_from_nsid (struct GNUNET_PseudonymIdentifier *pseudonym, 722GNUNET_FS_uri_sks_create_from_nsid (struct GNUNET_FS_PseudonymIdentifier *pseudonym,
723 const char *id); 723 const char *id);
724 724
725 725
@@ -733,7 +733,7 @@ GNUNET_FS_uri_sks_create_from_nsid (struct GNUNET_PseudonymIdentifier *pseudonym
733 */ 733 */
734int 734int
735GNUNET_FS_uri_sks_get_namespace (const struct GNUNET_FS_Uri *uri, 735GNUNET_FS_uri_sks_get_namespace (const struct GNUNET_FS_Uri *uri,
736 struct GNUNET_PseudonymIdentifier *pseudonym); 736 struct GNUNET_FS_PseudonymIdentifier *pseudonym);
737 737
738 738
739/** 739/**
@@ -1778,7 +1778,7 @@ struct GNUNET_FS_ProgressInfo
1778 /** 1778 /**
1779 * Public key of the namespace. 1779 * Public key of the namespace.
1780 */ 1780 */
1781 struct GNUNET_PseudonymIdentifier pseudonym; 1781 struct GNUNET_FS_PseudonymIdentifier pseudonym;
1782 1782
1783 } ns; 1783 } ns;
1784 1784
@@ -2619,7 +2619,7 @@ GNUNET_FS_namespace_dup (struct GNUNET_FS_Namespace *ns);
2619 */ 2619 */
2620int 2620int
2621GNUNET_FS_namespace_get_public_identifier (struct GNUNET_FS_Namespace *ns, 2621GNUNET_FS_namespace_get_public_identifier (struct GNUNET_FS_Namespace *ns,
2622 struct GNUNET_PseudonymIdentifier *id); 2622 struct GNUNET_FS_PseudonymIdentifier *id);
2623 2623
2624 2624
2625/** 2625/**
@@ -2647,7 +2647,7 @@ GNUNET_FS_namespace_delete (struct GNUNET_FS_Namespace *ns, int freeze);
2647 * @param id identifier for the namespace 2647 * @param id identifier for the namespace
2648 */ 2648 */
2649typedef void (*GNUNET_FS_NamespaceInfoProcessor) (void *cls, const char *name, 2649typedef void (*GNUNET_FS_NamespaceInfoProcessor) (void *cls, const char *name,
2650 const struct GNUNET_PseudonymIdentifier *id); 2650 const struct GNUNET_FS_PseudonymIdentifier *id);
2651 2651
2652 2652
2653/** 2653/**