GNUnet  0.11.x
gnunet-identity.c
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2013, 2018, 2019 GNUnet e.V.
4 
5  GNUnet is free software: you can redistribute it and/or modify it
6  under the terms of the GNU Affero General Public License as published
7  by the Free Software Foundation, either version 3 of the License,
8  or (at your option) any later version.
9 
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  Affero General Public License for more details.
14 
15  You should have received a copy of the GNU Affero General Public License
16  along with this program. If not, see <http://www.gnu.org/licenses/>.
17 
18  SPDX-License-Identifier: AGPL3.0-or-later
19  */
28 #include "platform.h"
29 #include "gnunet_util_lib.h"
31 
32 
36 #define TIMEOUT_STATUS_CODE 40
37 
41 static struct GNUNET_IDENTITY_Handle *sh;
42 
46 static int list;
47 
51 static int monitor;
52 
56 static int private_keys;
57 
61 static unsigned int verbose;
62 
66 static int quiet;
67 
71 static int type_eddsa;
72 
76 static char *create_ego;
77 
81 static char *delete_ego;
82 
86 static char *privkey_ego;
87 
91 static char *set_ego;
92 
96 static char *set_subsystem;
97 
102 
107 
112 
117 
121 static int global_ret;
122 
123 
129 static void
130 shutdown_task (void *cls)
131 {
132  if (NULL != set_op)
133  {
134  GNUNET_IDENTITY_cancel (set_op);
135  set_op = NULL;
136  }
137  if (NULL != create_op)
138  {
139  GNUNET_IDENTITY_cancel (create_op);
140  create_op = NULL;
141  }
142  if (NULL != delete_op)
143  {
144  GNUNET_IDENTITY_cancel (delete_op);
145  delete_op = NULL;
146  }
147  if (NULL != set_ego)
148  {
150  set_ego = NULL;
151  }
153  sh = NULL;
154 }
155 
156 
160 static void
162 {
163  if ( (NULL == create_op) &&
164  (NULL == delete_op) &&
165  (NULL == set_op) &&
166  (NULL == set_subsystem) &&
167  (! list) &&
168  (! monitor))
169  {
171  global_ret = 0;
173  }
174 }
175 
176 
183 static void
184 delete_finished (void *cls,
185  const char *emsg)
186 {
187  struct GNUNET_IDENTITY_Operation **op = cls;
188 
189  *op = NULL;
190  if (NULL != emsg)
191  fprintf (stderr, "%s\n", gettext (emsg));
192  test_finished ();
193 }
194 
195 
203 static void
205  const struct GNUNET_IDENTITY_PrivateKey *pk,
206  const char *emsg)
207 {
208  struct GNUNET_IDENTITY_Operation **op = cls;
209 
210  *op = NULL;
211  if (NULL == pk)
212  {
213  fprintf (stderr,
214  _ ("Failed to create ego: %s\n"),
215  emsg);
216  global_ret = 1;
217  }
218  else if (verbose)
219  {
220  struct GNUNET_IDENTITY_PublicKey pub;
221  char *pubs;
222 
225  if (private_keys)
226  {
227  char *privs;
228 
230  fprintf (stdout, "%s - %s\n", pubs, privs);
231  GNUNET_free (privs);
232  }
233  else
234  {
235  fprintf (stdout, "%s\n", pubs);
236  }
237  GNUNET_free (pubs);
238  }
239  test_finished ();
240 }
241 
242 
249 static void
250 set_done (void *cls, const char *emsg)
251 {
252  set_op = NULL;
253  if (NULL != emsg)
254  {
255  fprintf (stderr, _ ("Failed to set default ego: %s\n"), emsg);
256  global_ret = 1;
257  }
258  test_finished ();
259 }
260 
261 
295 static void
296 print_ego (void *cls,
297  struct GNUNET_IDENTITY_Ego *ego,
298  void **ctx,
299  const char *identifier)
300 {
301  struct GNUNET_IDENTITY_PublicKey pk;
302  char *s;
303  char *privs;
304 
305  if ( (NULL != set_ego) &&
306  (NULL != set_subsystem) &&
307  (NULL != ego) &&
308  (NULL != identifier) &&
309  (0 == strcmp (identifier, set_ego)))
310  {
311  set_op = GNUNET_IDENTITY_set (sh,
313  ego,
314  &set_done,
315  NULL);
317  set_subsystem = NULL;
319  set_ego = NULL;
320  }
321  if ( (NULL == ego) &&
322  (NULL != set_ego) &&
323  (NULL != set_subsystem) )
324  {
325  fprintf (stderr,
326  "Could not set ego to `%s' for subsystem `%s', ego not known\n",
327  set_ego,
328  set_subsystem);
330  set_subsystem = NULL;
332  set_ego = NULL;
333  }
334  if ((NULL == ego) && (! monitor))
335  {
336  list = 0;
337  test_finished ();
338  return;
339  }
340  if (! (list | monitor))
341  return;
342  if ( (NULL == ego) ||
343  (NULL == identifier) )
344  return;
345  if ( (NULL != set_ego) &&
346  (0 != strcmp (identifier,
347  set_ego)) )
348  return;
353  if ((monitor) || (NULL != identifier))
354  {
355  if (quiet)
356  {
357  if (private_keys)
358  fprintf (stdout, "%s - %s\n", s, privs);
359  else
360  fprintf (stdout, "%s\n", s);
361  }
362  else
363  {
364  if (private_keys)
365  fprintf (stdout, "%s - %s - %s - %s\n",
366  identifier, s, privs,
367  (ntohl (pk.type) == GNUNET_IDENTITY_TYPE_ECDSA) ?
368  "ECDSA" : "EdDSA");
369  else
370  fprintf (stdout, "%s - %s - %s\n",
371  identifier, s,
372  (ntohl (pk.type) == GNUNET_IDENTITY_TYPE_ECDSA) ?
373  "ECDSA" : "EdDSA");
374 
375  }
376  }
377  GNUNET_free (privs);
378  GNUNET_free (s);
379 }
380 
381 
390 static void
391 run (void *cls,
392  char *const *args,
393  const char *cfgfile,
394  const struct GNUNET_CONFIGURATION_Handle *cfg)
395 {
396  if ((NULL != set_subsystem) && (NULL == set_ego))
397  {
398  fprintf (stderr, "Option -s requires option -e to be specified as well.\n");
399  return;
400  }
401  sh = GNUNET_IDENTITY_connect (cfg,
402  (monitor | list) ||
403  (NULL != set_ego) ||
404  (NULL != set_subsystem)
405  ? &print_ego
406  : NULL,
407  NULL);
408  if (NULL != delete_ego)
409  delete_op =
411  delete_ego,
413  &delete_op);
414  if (NULL != create_ego)
415  {
416  if (NULL != privkey_ego)
417  {
419  strlen (privkey_ego),
420  &pk,
421  sizeof(struct
423  create_op =
425  create_ego,
426  &pk,
427  0, // Ignored
429  &create_op);
430  }
431  else
432  create_op =
434  create_ego,
435  NULL,
436  (type_eddsa) ?
440  &create_op);
441  }
443  NULL);
444  test_finished ();
445 }
446 
447 
455 int
456 main (int argc, char *const *argv)
457 {
458  struct GNUNET_GETOPT_CommandLineOption options[] = {
460  "create",
461  "NAME",
462  gettext_noop ("create ego NAME"),
463  &create_ego),
465  "delete",
466  "NAME",
467  gettext_noop ("delete ego NAME "),
468  &delete_ego),
470  "privkey",
471  "PRIVATE_KEY",
472  gettext_noop (
473  "set the private key for the identity to PRIVATE_KEY (use together with -C)"),
474  &privkey_ego),
476  "eddsa",
477  gettext_noop (
478  "generate an EdDSA identity. (use together with -C) EXPERIMENTAL"),
479  &type_eddsa),
481  "display",
482  gettext_noop ("display all egos"),
483  &list),
485  "quiet",
486  gettext_noop ("reduce output"),
487  &quiet),
489  'e',
490  "ego",
491  "NAME",
492  gettext_noop (
493  "set default identity to NAME for a subsystem SUBSYSTEM (use together with -s) or restrict results to NAME (use together with -d)"),
494  &set_ego),
496  "monitor",
497  gettext_noop ("run in monitor mode egos"),
498  &monitor),
500  "private-keys",
501  gettext_noop ("display private keys as well"),
502  &private_keys),
504  's',
505  "set",
506  "SUBSYSTEM",
507  gettext_noop (
508  "set default identity to EGO for a subsystem SUBSYSTEM (use together with -e)"),
509  &set_subsystem),
512  };
513  int res;
514 
515  if (GNUNET_OK !=
516  GNUNET_STRINGS_get_utf8_args (argc, argv,
517  &argc, &argv))
518  return 4;
519  global_ret = TIMEOUT_STATUS_CODE; /* timeout */
520  res = GNUNET_PROGRAM_run (argc,
521  argv,
522  "gnunet-identity",
523  gettext_noop ("Maintain egos"),
524  options,
525  &run,
526  NULL);
527  GNUNET_free_nz ((void *) argv);
528 
529  if (GNUNET_OK != res)
530  return 3;
531  return global_ret;
532 }
533 
534 
535 /* end of gnunet-identity.c */
struct GNUNET_IDENTITY_Handle * GNUNET_IDENTITY_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, GNUNET_IDENTITY_Callback cb, void *cb_cls)
Connect to the identity service.
Definition: identity_api.c:610
static int global_ret
Value to return from main().
void GNUNET_IDENTITY_cancel(struct GNUNET_IDENTITY_Operation *op)
Cancel an identity operation.
Definition: identity_api.c:904
static char * set_ego
-s option.
static void shutdown_task(void *cls)
Task run on shutdown.
static const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we are using.
Definition: gnunet-abd.c:36
static void create_finished(void *cls, const struct GNUNET_IDENTITY_PrivateKey *pk, const char *emsg)
Creation operation finished.
uint32_t type
Type of public key.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_shutdown(GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run on shutdown, that is when a CTRL-C signal is received, or when GNUNET_SCHEDULER_shutdown() is being invoked.
Definition: scheduler.c:1331
struct GNUNET_IDENTITY_Operation * GNUNET_IDENTITY_delete(struct GNUNET_IDENTITY_Handle *h, const char *name, GNUNET_IDENTITY_Continuation cb, void *cb_cls)
Delete an existing identity.
Definition: identity_api.c:863
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_verbose(unsigned int *level)
Define the &#39;-V&#39; verbosity option.
#define gettext(Msgid)
Definition: gettext.h:45
int GNUNET_STRINGS_get_utf8_args(int argc, char *const *argv, int *u8argc, char *const **u8argv)
Returns utf-8 encoded arguments.
Definition: strings.c:1459
char * GNUNET_IDENTITY_public_key_to_string(const struct GNUNET_IDENTITY_PublicKey *key)
Creates a (Base32) string representation of the public key.
static void delete_finished(void *cls, const char *emsg)
Deletion operation finished.
static int private_keys
Was "private" specified?
struct GNUNET_IDENTITY_Operation * GNUNET_IDENTITY_set(struct GNUNET_IDENTITY_Handle *h, const char *service_name, struct GNUNET_IDENTITY_Ego *ego, GNUNET_IDENTITY_Continuation cont, void *cont_cls)
Set the preferred/default identity for a service.
Definition: identity_api.c:720
A private key for an identity as per LSD0001.
static int monitor
Was "monitor" specified?
Definition of a command line option.
static struct GNUNET_IDENTITY_Operation * set_op
Operation handle for set operation.
void GNUNET_IDENTITY_ego_get_public_key(struct GNUNET_IDENTITY_Ego *ego, struct GNUNET_IDENTITY_PublicKey *pk)
Get the identifier (public key) of an ego.
Definition: identity_api.c:652
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:531
static void run(void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *cfg)
Main function that will be run by the scheduler.
static char * privkey_ego
-P option
Handle for an operation with the identity service.
Definition: identity_api.c:39
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_OPTION_END
Definition: 002.c:13
static struct GNUNET_DNSSTUB_Context * ctx
Context for DNS resolution.
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_string(char shortName, const char *name, const char *argumentHelp, const char *description, char **str)
Allow user to specify a string.
#define _(String)
GNU gettext support macro.
Definition: platform.h:184
char * GNUNET_IDENTITY_private_key_to_string(const struct GNUNET_IDENTITY_PrivateKey *key)
Creates a (Base32) string representation of the private key.
static void test_finished(void)
Test if we are finished yet.
Handle for an ego.
Definition: identity.h:36
struct GNUNET_IDENTITY_Operation * GNUNET_IDENTITY_create(struct GNUNET_IDENTITY_Handle *h, const char *name, const struct GNUNET_IDENTITY_PrivateKey *privkey, enum GNUNET_IDENTITY_KeyType ktype, GNUNET_IDENTITY_CreateContinuation cont, void *cont_cls)
Create a new ego with the given name.
Definition: identity_api.c:757
Handle for the service.
Definition: identity_api.c:95
#define TIMEOUT_STATUS_CODE
Return value from main on timeout.
void GNUNET_IDENTITY_disconnect(struct GNUNET_IDENTITY_Handle *h)
Disconnect from identity service.
Definition: identity_api.c:921
enum GNUNET_GenericReturnValue GNUNET_IDENTITY_key_get_public(const struct GNUNET_IDENTITY_PrivateKey *privkey, struct GNUNET_IDENTITY_PublicKey *key)
Retrieves the public key representation of a private key.
Definition: identity_api.c:175
static struct GNUNET_IDENTITY_Handle * sh
Handle to IDENTITY service.
static void set_done(void *cls, const char *emsg)
Function called by GNUNET_IDENTITY_set up on completion.
static int res
#define GNUNET_free_nz(ptr)
Wrapper around free.
static char * set_subsystem
-S option.
static int quiet
Was "quiet" specified?
static struct GNUNET_IDENTITY_Operation * create_op
Handle for create operation.
int main(int argc, char *const *argv)
The main function.
static unsigned int verbose
Was "verbose" specified?
An identity key as per LSD0001.
configuration data
Definition: configuration.c:84
struct GNUNET_IDENTITY_PrivateKey pk
Private key from command line option, or NULL.
const struct GNUNET_IDENTITY_PrivateKey * GNUNET_IDENTITY_ego_get_private_key(const struct GNUNET_IDENTITY_Ego *ego)
Obtain the ECC key associated with a ego.
Definition: identity_api.c:639
void * cls
Closure for cont or cb.
Definition: identity_api.c:88
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_flag(char shortName, const char *name, const char *description, int *val)
Allow user to specify a flag (which internally means setting an integer to 1/GNUNET_YES/GNUNET_OK.
int GNUNET_PROGRAM_run(int argc, char *const *argv, const char *binaryName, const char *binaryHelp, const struct GNUNET_GETOPT_CommandLineOption *options, GNUNET_PROGRAM_Main task, void *task_cls)
Run a standard GNUnet command startup sequence (initialize loggers and configuration, parse options).
Definition: program.c:372
static int type_eddsa
Was "eddsa" specified?
static char * create_ego
-C option
static struct GNUNET_IDENTITY_Operation * delete_op
Handle for delete operation.
static struct GNUNET_ARM_Operation * op
Current operation.
Definition: gnunet-arm.c:144
static char * delete_ego
-D option
static int list
Was "list" specified?
int GNUNET_STRINGS_string_to_data(const char *enc, size_t enclen, void *out, size_t out_size)
Convert CrockfordBase32 encoding back to data.
Definition: strings.c:972
#define GNUNET_free(ptr)
Wrapper around free.
static void print_ego(void *cls, struct GNUNET_IDENTITY_Ego *ego, void **ctx, const char *identifier)
If listing is enabled, prints information about the egos.
#define gettext_noop(String)
Definition: gettext.h:69