2 This file is part of GNUnet
3 (C) 2003, 2004, 2005, 2006, 2007, 2008 Christian Grothoff (and other contributing authors)
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 2, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
22 * @file util/pseudonym.c
23 * @brief helper functions
24 * @author Christian Grothoff
28 #include "gnunet_common.h"
29 #include "gnunet_container_lib.h"
30 #include "gnunet_disk_lib.h"
31 #include "gnunet_pseudonym_lib.h"
32 #include "gnunet_bio_lib.h"
35 * Name of the directory which stores meta data for pseudonym
37 #define PS_METADATA_DIR DIR_SEPARATOR_STR "data" DIR_SEPARATOR_STR "pseudonyms" DIR_SEPARATOR_STR "metadata" DIR_SEPARATOR_STR
40 * Name of the directory which stores names for pseudonyms
42 #define PS_NAMES_DIR DIR_SEPARATOR_STR "data" DIR_SEPARATOR_STR "pseudonyms" DIR_SEPARATOR_STR "names" DIR_SEPARATOR_STR
46 * Registered callbacks for discovery of pseudonyms.
48 struct DiscoveryCallback
51 * This is a linked list.
53 struct DiscoveryCallback *next;
56 * Function to call each time a pseudonym is discovered.
58 GNUNET_PSEUDONYM_Iterator callback;
61 * Closure for callback.
68 * Head of the linked list of functions to call when
69 * new pseudonyms are added.
71 static struct DiscoveryCallback *head;
74 * Internal notification about new tracked URI.
75 * @param id a point to the hash code of pseudonym
76 * @param md meta data to be written
77 * @param rating rating of pseudonym
80 internal_notify (const GNUNET_HashCode * id,
81 const struct GNUNET_CONTAINER_MetaData *md, int rating)
83 struct DiscoveryCallback *pos;
88 pos->callback (pos->closure, id, md, rating);
94 * Register callback to be invoked whenever we discover
96 * @param cfg configuration to use
97 * @param iterator iterator over pseudonym
98 * @param closure point to a closure
101 GNUNET_PSEUDONYM_discovery_callback_register (const struct
102 GNUNET_CONFIGURATION_Handle
104 GNUNET_PSEUDONYM_Iterator
105 iterator, void *closure)
107 struct DiscoveryCallback *list;
109 list = GNUNET_malloc (sizeof (struct DiscoveryCallback));
110 list->callback = iterator;
111 list->closure = closure;
114 GNUNET_PSEUDONYM_list_all (cfg, iterator, closure);
119 * Unregister pseudonym discovery callback.
120 * @param iterator iterator over pseudonym
121 * @param closure point to a closure
124 GNUNET_PSEUDONYM_discovery_callback_unregister (GNUNET_PSEUDONYM_Iterator
125 iterator, void *closure)
127 struct DiscoveryCallback *prev;
128 struct DiscoveryCallback *pos;
132 while ((pos != NULL) &&
133 ((pos->callback != iterator) || (pos->closure != closure)))
139 return GNUNET_SYSERR;
143 prev->next = pos->next;
150 * Get the filename (or directory name) for the given
151 * pseudonym identifier and directory prefix.
152 * @param cfg configuration to use
153 * @param prefix path components to append to the private directory name
154 * @param psid hash code of pseudonym, can be NULL
155 * @return filename of the pseudonym (if psid != NULL) or directory with the data (if psid == NULL)
158 get_data_filename (const struct GNUNET_CONFIGURATION_Handle
159 *cfg, const char *prefix, const GNUNET_HashCode * psid)
161 struct GNUNET_CRYPTO_HashAsciiEncoded enc;
164 GNUNET_CRYPTO_hash_to_enc (psid, &enc);
165 return GNUNET_DISK_get_home_filename (cfg,
166 GNUNET_CLIENT_SERVICE_NAME,
169 NULL) ? NULL : (const char *) &enc,
175 * Write the pseudonym infomation into a file
176 * @param cfg configuration to use
177 * @param nsid hash code of a pseudonym
178 * @param meta meta data to be written into a file
179 * @param ranking ranking of a pseudonym
180 * @param ns_name name of a pseudonym
183 write_pseudonym_info (const struct GNUNET_CONFIGURATION_Handle *cfg,
184 const GNUNET_HashCode * nsid,
185 const struct GNUNET_CONTAINER_MetaData *meta,
186 int32_t ranking, const char *ns_name)
189 struct GNUNET_BIO_WriteHandle *fileW;
191 fn = get_data_filename (cfg, PS_METADATA_DIR, nsid);
192 GNUNET_assert (fn != NULL);
193 fileW = GNUNET_BIO_write_open(fn);
196 if ( (GNUNET_OK != GNUNET_BIO_write_int32(fileW, ranking)) ||
197 (GNUNET_OK != GNUNET_BIO_write_string(fileW, ns_name)) ||
198 (GNUNET_OK != GNUNET_BIO_write_meta_data(fileW, meta)) )
200 (void) GNUNET_BIO_write_close(fileW);
201 GNUNET_break (GNUNET_OK == GNUNET_DISK_directory_remove (fn));
205 if (GNUNET_OK != GNUNET_BIO_write_close(fileW))
207 GNUNET_break (GNUNET_OK == GNUNET_DISK_directory_remove (fn));
213 /* create entry for pseudonym name in names */
214 /* FIXME: 90% of what this call does is not needed
215 here => refactor code to only create the entry! */
216 GNUNET_free_non_null (GNUNET_PSEUDONYM_id_to_name (cfg, nsid));
221 * read the pseudonym infomation from a file
222 * @param cfg configuration to use
223 * @param nsid hash code of a pseudonym
224 * @param meta meta data to be read from a file
225 * @param ranking ranking of a pseudonym
226 * @param ns_name name of a pseudonym
229 read_info (const struct GNUNET_CONFIGURATION_Handle *cfg,
230 const GNUNET_HashCode * nsid,
231 struct GNUNET_CONTAINER_MetaData **meta,
232 int32_t * ranking, char **ns_name)
236 struct GNUNET_BIO_ReadHandle *fileR;
238 fn = get_data_filename (cfg, PS_METADATA_DIR, nsid);
239 GNUNET_assert (fn != NULL);
240 fileR = GNUNET_BIO_read_open(fn);
244 return GNUNET_SYSERR;
248 if ( (GNUNET_OK != GNUNET_BIO_read_int32 (fileR, ranking)) ||
249 (GNUNET_OK != GNUNET_BIO_read_string(fileR, "Read string error!", ns_name, 200)) ||
250 (GNUNET_OK != GNUNET_BIO_read_meta_data(fileR, "Read meta data error!", meta)) )
252 GNUNET_BIO_read_close(fileR, &emsg);
253 GNUNET_free_non_null (emsg);
254 GNUNET_free_non_null (*ns_name);
256 GNUNET_break (GNUNET_OK == GNUNET_DISK_directory_remove (fn));
258 return GNUNET_SYSERR;
260 if (GNUNET_OK != GNUNET_BIO_read_close(fileR, &emsg))
262 GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
263 _("Failed to parse metadata about pseudonym from file `%s': %s\n"),
266 GNUNET_break (GNUNET_OK == GNUNET_DISK_directory_remove (fn));
267 GNUNET_CONTAINER_meta_data_destroy (*meta);
269 GNUNET_free_non_null (*ns_name);
271 GNUNET_free_non_null (emsg);
273 return GNUNET_SYSERR;
282 * Return the unique, human readable name for the given namespace.
284 * @param cfg configuration
285 * @param nsid cryptographic ID of the namespace
286 * @return NULL on failure (should never happen)
289 GNUNET_PSEUDONYM_id_to_name (const struct GNUNET_CONFIGURATION_Handle *cfg,
290 const GNUNET_HashCode * nsid)
292 struct GNUNET_CONTAINER_MetaData *meta;
297 struct GNUNET_DISK_FileHandle *fh;
303 int32_t *rank = &temp;
307 if (GNUNET_OK == read_info (cfg, nsid, &meta, rank, &name))
309 if ((meta != NULL) && (name == NULL))
310 name = GNUNET_CONTAINER_meta_data_get_first_by_types (meta,
311 EXTRACTOR_METATYPE_TITLE,
312 EXTRACTOR_METATYPE_FILENAME,
313 EXTRACTOR_METATYPE_DESCRIPTION,
314 EXTRACTOR_METATYPE_SUBJECT,
315 EXTRACTOR_METATYPE_PUBLISHER,
316 EXTRACTOR_METATYPE_AUTHOR_NAME,
317 EXTRACTOR_METATYPE_COMMENT,
318 EXTRACTOR_METATYPE_SUMMARY,
322 GNUNET_CONTAINER_meta_data_destroy (meta);
327 name = GNUNET_strdup (_("no-name"));
328 GNUNET_CRYPTO_hash (name, strlen (name), &nh);
329 fn = get_data_filename (cfg, PS_NAMES_DIR, &nh);
330 GNUNET_assert (fn != NULL);
333 if (0 == STAT (fn, &sbuf))
334 GNUNET_DISK_file_size (fn, &len, GNUNET_YES);
335 fh = GNUNET_DISK_file_open (fn, GNUNET_DISK_OPEN_CREATE
336 | GNUNET_DISK_OPEN_READWRITE,
337 GNUNET_DISK_PERM_USER_READ |
338 GNUNET_DISK_PERM_USER_WRITE);
341 while ((len >= sizeof (GNUNET_HashCode)) &&
342 (sizeof (GNUNET_HashCode)
343 == GNUNET_DISK_file_read (fh, &nh, sizeof (GNUNET_HashCode))))
345 if (0 == memcmp (&nh, nsid, sizeof (GNUNET_HashCode)))
351 len -= sizeof (GNUNET_HashCode);
356 if (sizeof (GNUNET_HashCode) !=
357 GNUNET_DISK_file_write (fh, nsid, sizeof (GNUNET_HashCode)))
358 GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_WARNING, "write", fn);
360 GNUNET_DISK_file_close (fh);
361 ret = GNUNET_malloc (strlen (name) + 32);
362 GNUNET_snprintf (ret, strlen (name) + 32, "%s-%u", name, idx);
369 * Get the namespace ID belonging to the given namespace name.
371 * @param cfg configuration to use
372 * @param ns_uname human-readable name for the namespace
373 * @param nsid set to namespace ID based on 'ns_uname'
374 * @return GNUNET_OK on success
377 GNUNET_PSEUDONYM_name_to_id (const struct GNUNET_CONFIGURATION_Handle *cfg,
378 const char *ns_uname, GNUNET_HashCode * nsid)
386 struct GNUNET_DISK_FileHandle *fh;
389 slen = strlen (ns_uname);
390 while ((slen > 0) && (1 != sscanf (&ns_uname[slen - 1], "-%u", &idx)))
393 return GNUNET_SYSERR;
394 name = GNUNET_strdup (ns_uname);
395 name[slen - 1] = '\0';
396 GNUNET_CRYPTO_hash (name, strlen (name), &nh);
398 fn = get_data_filename (cfg, PS_NAMES_DIR, &nh);
399 GNUNET_assert (fn != NULL);
401 if ((GNUNET_OK != GNUNET_DISK_file_test (fn) ||
402 (GNUNET_OK != GNUNET_DISK_file_size (fn, &len, GNUNET_YES))) ||
403 ((idx + 1) * sizeof (GNUNET_HashCode) > len))
406 return GNUNET_SYSERR;
408 fh = GNUNET_DISK_file_open (fn, GNUNET_DISK_OPEN_CREATE
409 | GNUNET_DISK_OPEN_READWRITE,
410 GNUNET_DISK_PERM_USER_READ |
411 GNUNET_DISK_PERM_USER_WRITE);
413 GNUNET_DISK_file_seek (fh, idx * sizeof (GNUNET_HashCode),
414 GNUNET_DISK_SEEK_SET);
415 if (sizeof (GNUNET_HashCode) !=
416 GNUNET_DISK_file_read (fh, nsid, sizeof (GNUNET_HashCode)))
418 GNUNET_DISK_file_close (fh);
419 return GNUNET_SYSERR;
421 GNUNET_DISK_file_close (fh);
428 * struct used to list the pseudonym
430 struct ListPseudonymClosure
434 * iterator over pseudonym
436 GNUNET_PSEUDONYM_Iterator iterator;
439 * Closure for iterator.
444 * Configuration to use.
446 const struct GNUNET_CONFIGURATION_Handle *cfg;
452 * the help function to list all available pseudonyms
453 * @param cls point to a struct ListPseudonymClosure
454 * @param fullname name of pseudonym
457 list_pseudonym_helper (void *cls, const char *fullname)
459 struct ListPseudonymClosure *c = cls;
463 struct GNUNET_CONTAINER_MetaData *meta;
467 if (strlen (fullname) < sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded))
470 &fullname[strlen (fullname) + 1 -
471 sizeof (struct GNUNET_CRYPTO_HashAsciiEncoded)];
472 if (fn[-1] != DIR_SEPARATOR)
475 if (GNUNET_OK != GNUNET_CRYPTO_hash_from_string (fn, &id))
476 return GNUNET_OK; /* invalid name */
478 if (GNUNET_OK != read_info (c->cfg, &id, &meta, &rating, &str))
479 return GNUNET_OK; /* ignore entry */
480 GNUNET_free_non_null (str);
481 if (c->iterator != NULL)
482 ret = c->iterator (c->closure, &id, meta, rating);
483 GNUNET_CONTAINER_meta_data_destroy (meta);
489 * List all available pseudonyms.
491 * @param cfg overall configuration
492 * @param iterator function to call for each pseudonym
493 * @param closure closure for iterator
494 * @return number of pseudonyms found
497 GNUNET_PSEUDONYM_list_all (const struct GNUNET_CONFIGURATION_Handle *cfg,
498 GNUNET_PSEUDONYM_Iterator iterator, void *closure)
500 struct ListPseudonymClosure cls;
504 cls.iterator = iterator;
505 cls.closure = closure;
507 fn = get_data_filename (cfg, PS_METADATA_DIR, NULL);
508 GNUNET_assert (fn != NULL);
509 GNUNET_DISK_directory_create (fn);
510 ret = GNUNET_DISK_directory_scan (fn, &list_pseudonym_helper, &cls);
517 * Change the ranking of a pseudonym.
519 * @param cfg overall configuration
520 * @param nsid id of the pseudonym
521 * @param delta by how much should the rating be
523 * @return new rating of the pseudonym
526 GNUNET_PSEUDONYM_rank (const struct GNUNET_CONFIGURATION_Handle *cfg,
527 const GNUNET_HashCode * nsid, int delta)
529 struct GNUNET_CONTAINER_MetaData *meta;
535 ret = read_info (cfg, nsid, &meta, &ranking, &name);
536 if (ret == GNUNET_SYSERR)
539 meta = GNUNET_CONTAINER_meta_data_create ();
542 write_pseudonym_info (cfg, nsid, meta, ranking, name);
543 GNUNET_CONTAINER_meta_data_destroy (meta);
544 GNUNET_free_non_null (name);
550 * Add a pseudonym to the set of known pseudonyms.
551 * For all pseudonym advertisements that we discover
552 * FS should automatically call this function.
554 * @param cfg overall configuration
555 * @param id the pseudonym identifier
556 * @param meta metadata for the pseudonym
559 GNUNET_PSEUDONYM_add (const struct GNUNET_CONFIGURATION_Handle *cfg,
560 const GNUNET_HashCode * id,
561 const struct GNUNET_CONTAINER_MetaData *meta)
565 struct GNUNET_CONTAINER_MetaData *old;
570 fn = get_data_filename (cfg, PS_METADATA_DIR, id);
571 GNUNET_assert (fn != NULL);
573 if ((0 == STAT (fn, &sbuf)) &&
574 (GNUNET_OK == read_info (cfg, id, &old, &ranking, &name)))
576 GNUNET_CONTAINER_meta_data_merge (old, meta);
577 write_pseudonym_info (cfg, id, old, ranking, name);
578 GNUNET_CONTAINER_meta_data_destroy (old);
579 GNUNET_free_non_null (name);
583 write_pseudonym_info (cfg, id, meta, ranking, NULL);
586 internal_notify (id, meta, ranking);
590 /* end of pseudonym.c */