2 This file is part of GNUnet.
3 (C) 2013 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 3, 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 identity/gnunet-service-identity.c
23 * @brief identity management service
24 * @author Christian Grothoff
26 * The purpose of this service is to manage private keys that
27 * represent the various egos/pseudonyms/identities of a GNUnet user.
31 * - default identity set/get handlers
34 #include "gnunet_util_lib.h"
35 #include "gnunet_constants.h"
36 #include "gnunet_protocols.h"
37 #include "gnunet_statistics_service.h"
38 #include "gnunet_identity_service.h"
43 * Information we keep about each ego.
49 * We keep egos in a DLL.
54 * We keep egos in a DLL.
59 * Private key of the ego.
61 struct GNUNET_CRYPTO_EccPrivateKey *pk;
64 * String identifier for the ego.
72 * Handle to our current configuration.
74 static const struct GNUNET_CONFIGURATION_Handle *cfg;
77 * Handle to subsystem configuration which for each subsystem contains
78 * the name of the default ego.
80 static struct GNUNET_CONFIGURATION_Handle *subsystem_cfg;
83 * Handle to the statistics service.
85 static struct GNUNET_STATISTICS_Handle *stats;
88 * Notification context, simplifies client broadcasts.
90 static struct GNUNET_SERVER_NotificationContext *nc;
93 * Directory where we store the identities.
95 static char *ego_directory;
98 * Configuration file name where subsystem information is kept.
100 static char *subsystem_cfg_file;
103 * Head of DLL of all egos.
105 static struct Ego *ego_head;
108 * Tail of DLL of all egos.
110 static struct Ego *ego_tail;
114 * Task run during shutdown.
120 shutdown_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
126 GNUNET_SERVER_notification_context_destroy (nc);
131 GNUNET_STATISTICS_destroy (stats, GNUNET_NO);
134 GNUNET_CONFIGURATION_destroy (subsystem_cfg);
135 subsystem_cfg = NULL;
136 GNUNET_free (subsystem_cfg_file);
137 subsystem_cfg_file = NULL;
138 GNUNET_free (ego_directory);
139 ego_directory = NULL;
140 while (NULL != (e = ego_head))
142 GNUNET_CONTAINER_DLL_remove (ego_head, ego_tail, e);
143 GNUNET_CRYPTO_ecc_key_free (e->pk);
150 * Send a result code back to the client.
152 * @param client client that should receive the result code
153 * @param result_code code to transmit
154 * @param emsg error message to include (or NULL for none)
157 send_result_code (struct GNUNET_SERVER_Client *client,
158 uint32_t result_code,
161 struct GNUNET_IDENTITY_ResultCodeMessage *rcm;
167 elen = strlen (emsg) + 1;
168 rcm = GNUNET_malloc (sizeof (struct GNUNET_IDENTITY_ResultCodeMessage) + elen);
169 rcm->header.type = htons (GNUNET_MESSAGE_TYPE_IDENTITY_RESULT_CODE);
170 rcm->header.size = htons (sizeof (struct GNUNET_IDENTITY_ResultCodeMessage) + elen);
171 rcm->result_code = htonl (result_code);
172 memcpy (&rcm[1], emsg, elen);
173 GNUNET_SERVER_notification_context_unicast (nc, client, &rcm->header, GNUNET_YES);
179 * Create an update message with information about the current state of an ego.
181 * @param ego ego to create message for
182 * @return corresponding update message
184 static struct GNUNET_IDENTITY_UpdateMessage *
185 create_update_message (struct Ego *ego)
187 struct GNUNET_IDENTITY_UpdateMessage *um;
191 struct GNUNET_CRYPTO_EccPrivateKeyBinaryEncoded *enc;
193 name_len = (NULL == ego->identifier) ? 0 : (strlen (ego->identifier) + 1);
194 enc = GNUNET_CRYPTO_ecc_encode_key (ego->pk);
195 pk_len = ntohs (enc->size);
196 um = GNUNET_malloc (sizeof (struct GNUNET_IDENTITY_UpdateMessage) + pk_len + name_len);
197 um->header.type = htons (GNUNET_MESSAGE_TYPE_IDENTITY_UPDATE);
198 um->header.size = htons (sizeof (struct GNUNET_IDENTITY_UpdateMessage) + pk_len + name_len);
199 um->name_len = htons (name_len);
200 um->pk_len = htons (pk_len);
201 str = (char *) &um[1];
202 memcpy (str, enc, pk_len);
203 memcpy (&str[pk_len], ego->identifier, name_len);
210 * Handler for START message from client, sends information
211 * about all identities to the client immediately and
212 * adds the client to the notification context for future
216 * @param client who sent the message
217 * @param message the message received
220 handle_start_message (void *cls, struct GNUNET_SERVER_Client *client,
221 const struct GNUNET_MessageHeader *message)
223 struct GNUNET_IDENTITY_UpdateMessage *um;
226 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
227 "Received START message from client\n");
228 GNUNET_SERVER_notification_context_add (nc, client);
229 for (ego = ego_head; NULL != ego; ego = ego->next)
231 um = create_update_message (ego);
232 GNUNET_SERVER_notification_context_unicast (nc, client, &um->header, GNUNET_YES);
235 GNUNET_SERVER_receive_done (client, GNUNET_OK);
240 * Handler for GET_DEFAULT message from client, returns
241 * default identity for some service.
244 * @param client who sent the message
245 * @param message the message received
248 handle_get_default_message (void *cls, struct GNUNET_SERVER_Client *client,
249 const struct GNUNET_MessageHeader *message)
251 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
252 "Received GET_DEFAULT message from client\n");
253 // setup_estimate_message (&em);
254 // GNUNET_SERVER_notification_context_unicast (nc, client, &em.header, GNUNET_YES);
255 GNUNET_break (0); // not implemented!
256 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
261 * Handler for SET_DEFAULT message from client, updates
262 * default identity for some service.
265 * @param client who sent the message
266 * @param message the message received
269 handle_set_default_message (void *cls, struct GNUNET_SERVER_Client *client,
270 const struct GNUNET_MessageHeader *message)
272 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
273 "Received SET_DEFAULT message from client\n");
274 // setup_estimate_message (&em);
275 // GNUNET_SERVER_notification_context_unicast (nc, client, &em.header, GNUNET_YES);
276 GNUNET_break (0); // not implemented!
277 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
282 * Send an updated message for the given ego to all listeners.
284 * @param ego ego to send the update for
287 notify_listeners (struct Ego *ego)
289 struct GNUNET_IDENTITY_UpdateMessage *um;
291 um = create_update_message (ego);
292 GNUNET_SERVER_notification_context_broadcast (nc, &um->header, GNUNET_YES);
298 * Handler for CREATE message from client, creates
302 * @param client who sent the message
303 * @param message the message received
306 handle_create_message (void *cls, struct GNUNET_SERVER_Client *client,
307 const struct GNUNET_MessageHeader *message)
309 const struct GNUNET_IDENTITY_CreateRequestMessage *crm;
315 struct GNUNET_CRYPTO_EccPrivateKey *pk;
317 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
318 "Received CREATE message from client\n");
319 size = ntohs (message->size);
320 if (size <= sizeof (struct GNUNET_IDENTITY_CreateRequestMessage))
323 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
326 crm = (const struct GNUNET_IDENTITY_CreateRequestMessage *) message;
327 name_len = ntohs (crm->name_len);
328 pk_len = ntohs (crm->pk_len);
329 str = (const char *) &crm[1];
330 if ( (name_len + pk_len + sizeof (struct GNUNET_IDENTITY_CreateRequestMessage) != size) ||
331 (NULL == (pk = GNUNET_CRYPTO_ecc_decode_key (str, pk_len, GNUNET_YES))) )
334 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
338 if ('\0' != str[name_len - 1])
341 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
344 for (ego = ego_head; NULL != ego; ego = ego->next)
346 if (0 == strcmp (ego->identifier,
349 send_result_code (client, 1, gettext_noop ("identifier already in use for another ego"));
350 GNUNET_SERVER_receive_done (client, GNUNET_OK);
351 GNUNET_CRYPTO_ecc_key_free (pk);
355 ego = GNUNET_new (struct Ego);
357 ego->identifier = GNUNET_strdup (str);
358 GNUNET_CONTAINER_DLL_insert (ego_head,
361 send_result_code (client, 0, NULL);
362 /* FIXME: also write to file! */
363 notify_listeners (ego);
364 GNUNET_SERVER_receive_done (client, GNUNET_OK);
370 * Handler for RENAME message from client, creates
374 * @param client who sent the message
375 * @param message the message received
378 handle_rename_message (void *cls, struct GNUNET_SERVER_Client *client,
379 const struct GNUNET_MessageHeader *message)
381 const struct GNUNET_IDENTITY_RenameMessage *rm;
383 uint16_t old_name_len;
384 uint16_t new_name_len;
386 const char *old_name;
387 const char *new_name;
389 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
390 "Received RENAME message from client\n");
391 size = ntohs (message->size);
392 if (size <= sizeof (struct GNUNET_IDENTITY_RenameMessage))
395 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
398 rm = (const struct GNUNET_IDENTITY_RenameMessage *) message;
399 old_name_len = ntohs (rm->old_name_len);
400 new_name_len = ntohs (rm->new_name_len);
401 old_name = (const char *) &rm[1];
402 new_name = &old_name[old_name_len];
403 if ( (old_name_len + new_name_len + sizeof (struct GNUNET_IDENTITY_RenameMessage) != size) ||
404 ('\0' != old_name[old_name_len - 1]) ||
405 ('\0' != new_name[new_name_len - 1]) )
408 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
411 for (ego = ego_head; NULL != ego; ego = ego->next)
413 if (0 == strcmp (ego->identifier,
416 GNUNET_free (ego->identifier);
417 ego->identifier = GNUNET_strdup (new_name);
418 /* FIXME: also rename file! */
419 notify_listeners (ego);
420 send_result_code (client, 0, NULL);
421 GNUNET_SERVER_receive_done (client, GNUNET_OK);
426 send_result_code (client, 1, gettext_noop ("no matching ego found"));
427 GNUNET_SERVER_receive_done (client, GNUNET_OK);
432 * Handler for DELETE message from client, creates
436 * @param client who sent the message
437 * @param message the message received
440 handle_delete_message (void *cls, struct GNUNET_SERVER_Client *client,
441 const struct GNUNET_MessageHeader *message)
443 const struct GNUNET_IDENTITY_DeleteMessage *dm;
449 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
450 "Received DELETE message from client\n");
451 size = ntohs (message->size);
452 if (size <= sizeof (struct GNUNET_IDENTITY_DeleteMessage))
455 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
458 dm = (const struct GNUNET_IDENTITY_DeleteMessage *) message;
459 name = (const char *) &dm[1];
460 name_len = ntohs (dm->name_len);
461 if ( (name_len + sizeof (struct GNUNET_IDENTITY_DeleteMessage) != size) ||
462 (0 != ntohs (dm->reserved)) ||
463 ('\0' != name[name_len - 1]) )
466 GNUNET_SERVER_receive_done (client, GNUNET_SYSERR);
469 for (ego = ego_head; NULL != ego; ego = ego->next)
471 if (0 == strcmp (ego->identifier,
474 GNUNET_CONTAINER_DLL_remove (ego_head,
477 /* FIXME: also delete file! */
478 GNUNET_free (ego->identifier);
479 ego->identifier = NULL;
480 notify_listeners (ego);
481 GNUNET_CRYPTO_ecc_key_free (ego->pk);
483 send_result_code (client, 0, NULL);
484 GNUNET_SERVER_receive_done (client, GNUNET_OK);
489 send_result_code (client, 1, gettext_noop ("no matching ego found"));
490 GNUNET_SERVER_receive_done (client, GNUNET_OK);
495 * Process the given file from the "EGODIR". Parses the file
496 * and creates the respective 'struct Ego' in memory.
499 * @param filename name of the file to parse
502 process_ego_file (void *cls,
503 const char *filename)
505 GNUNET_break (0); // not implemented
510 * Handle network size estimate clients.
513 * @param server the initialized server
514 * @param c configuration to use
518 struct GNUNET_SERVER_Handle *server,
519 const struct GNUNET_CONFIGURATION_Handle *c)
521 static const struct GNUNET_SERVER_MessageHandler handlers[] = {
522 {&handle_start_message, NULL,
523 GNUNET_MESSAGE_TYPE_IDENTITY_START, sizeof (struct GNUNET_MessageHeader)},
524 {&handle_get_default_message, NULL,
525 GNUNET_MESSAGE_TYPE_IDENTITY_GET_DEFAULT, 0},
526 {&handle_set_default_message, NULL,
527 GNUNET_MESSAGE_TYPE_IDENTITY_SET_DEFAULT, 0},
528 {&handle_create_message, NULL,
529 GNUNET_MESSAGE_TYPE_IDENTITY_CREATE, 0},
530 {&handle_rename_message, NULL,
531 GNUNET_MESSAGE_TYPE_IDENTITY_RENAME, 0},
532 {&handle_delete_message, NULL,
533 GNUNET_MESSAGE_TYPE_IDENTITY_DELETE, 0},
539 GNUNET_CONFIGURATION_get_value_filename (cfg, "identity",
543 GNUNET_log_config_missing (GNUNET_ERROR_TYPE_ERROR, "identity", "EGODIR");
544 GNUNET_SCHEDULER_shutdown ();
548 GNUNET_CONFIGURATION_get_value_filename (cfg, "identity",
550 &subsystem_cfg_file))
552 GNUNET_log_config_missing (GNUNET_ERROR_TYPE_ERROR, "identity", "SUBSYSTEM_CFG");
553 GNUNET_SCHEDULER_shutdown ();
556 subsystem_cfg = GNUNET_CONFIGURATION_create ();
558 GNUNET_DISK_file_test (subsystem_cfg_file)) &&
560 GNUNET_CONFIGURATION_parse (subsystem_cfg,
561 subsystem_cfg_file)) )
563 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
564 _("Failed to parse subsystem identity configuration file `%s'\n"),
566 GNUNET_SCHEDULER_shutdown ();
569 stats = GNUNET_STATISTICS_create ("identity", cfg);
570 GNUNET_SERVER_add_handlers (server, handlers);
571 nc = GNUNET_SERVER_notification_context_create (server, 1);
572 GNUNET_DISK_directory_scan (ego_directory,
575 GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_FOREVER_REL, &shutdown_task,
581 * The main function for the network size estimation service.
583 * @param argc number of arguments from the command line
584 * @param argv command line arguments
585 * @return 0 ok, 1 on error
588 main (int argc, char *const *argv)
591 GNUNET_SERVICE_run (argc, argv, "identity",
592 GNUNET_SERVICE_OPTION_NONE,
593 &run, NULL)) ? 0 : 1;
597 /* end of gnunet-service-identity.c */