aboutsummaryrefslogtreecommitdiff
path: root/doc/man/gnunet-reclaim.1
blob: a38d9c9e053d01992e1fd9aecd0cb40c4cb6c8b7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
.\" This file is part of GNUnet.
.\" Copyright (C) 2001-2019 GNUnet e.V.
.\"
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.3 or
.\" any later version published by the Free Software Foundation; with no
.\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
.\" copy of the license is included in the file
.\" FDL-1.3.
.\"
.\" A copy of the license is also available from the Free Software
.\" Foundation Web site at http://www.gnu.org/licenses/fdl.html}.
.\"
.\" Alternately, this document is also available under the General
.\" Public License, version 3 or later, as published by the Free Software
.\" Foundation.  A copy of the license is included in the file
.\" GPL3.
.\"
.\" A copy of the license is also available from the Free Software
.\" Foundation Web site at http://www.gnu.org/licenses/gpl.html
.\"
.\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later
.\"
.Dd May 12, 2019
.Dt GNUNET-RECLAIM 1
.Os
.Sh NAME
.Nm gnunet-reclaim
.Nd Command-line tools for re:claimID subsystem
.Sh SYNOPSIS
.Nm
.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
.Op Fl h | -help
.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
.Op Fl e Ar EGO | Fl -ego= Ns Ar EGO
.Op Fl a Ar NAME | Fl -add= Ns Ar NAME
.Op Fl V Ar VALUE | Fl -value= Ns Ar VALUE
.Op Fl d Ar ID | Fl -delete= Ns Ar ID
.Op Fl r Ar RP | Fl -rp= Ns Ar RP
.Op Fl D | -dump
.Op Fl A | -credentials
.Op Fl I | -credential-id Ns Ar CREDENTIAL_ID
.Op Fl N | -credential-name Ns AR NAME
.Op Fl i Ar A1,A2,... | Fl -issue= Ns Ar A1,A2,...
.Op Fl C Ar TICKET | Fl -consume= Ns Ar TICKET
.Op Fl R Ar TICKET | Fl -revoke= Ns Ar TICKET
.Op Fl t Ar TYPE | Fl -type= Ns Ar TYPE
.Op Fl T | -tickets
.Op Fl E Ar INTERVAL | Fl -expiration= Ns Ar INTERVAL
.Op Fl v | -version
.Sh DESCRIPTION
.Nm
allows you to manage identity attributes and manage authorizations.
.Bl -tag -width indent
.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
Use the configuration file FILENAME.
.It Fl h | -help
Print short help on options.
.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
Use LOGLEVEL for logging.
Valid values are DEBUG, INFO, WARNING and ERROR.
.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
Configure logging to write logs to LOGFILE.
.It Fl e Ar EGO | Fl -ego= Ns Ar EGO
Specify identity to use. Always required.
.It Fl a Ar NAME | Fl -add= Ns Ar NAME
Add or update an attribute with NAME. Must be used in conjunction with -V
.It Fl V Ar VALUE | Fl -value= Ns Ar VALUE
Specify value of attribute to add or update.
.It Fl t Ar TYPE | Fl -type= Ns Ar TYPE
Specify type of attribute to add (Default: STRING)
.It Fl d Ar ID | Fl -delete= Ns Ar ID
Delete an attribute with ID.
.It Fl E Ar INTERVAL | Fl -expiration= Ns Ar INTERVAL
Specify relative expiration interval (freshness) of attribute.
.It Fl D | -dump
List all attributes for given identity.
.It Fl A | -credentials
List credentials for a given identity.
.It Fl I | -credential-id= Ns Ar CREDENTIAL_ID
Credential ID to use when creating an attribute backed by a credential
.It Fl N | -credential-name= Ns Ar NAME
The name of the credential to add.
.It Fl i Ar A1,A2,... | Fl -issue= Ns Ar A1,A2,...
Authorize a relying party to access a set of attributes. Must be
used in conjunction with -r. Returns a TICKET.
.It Fl r Ar RP | Fl -rp= Ns Ar RP
The relying party to authorize (see -i). RP is a PKEY of the entity.
.It Fl C Ar TICKET | Fl -consume= Ns Ar TICKET
Consume TICKET and retrieve shared attributes. To be used by RP.
.It Fl R Ar TICKET | Fl -revoke= Ns Ar TICKET
Revoke TICKET. To be used by identity which issued TICKET.
.It Fl T | -tickets
List issued tickets.
.It Fl v | -version
Print GNUnet version number.
.El
.\".Sh EXAMPLES
.Sh SEE ALSO
The full documentation for gnunet is maintained as a Texinfo manual.
If the
.Xr info 1
and gnunet programs are properly installed at your site, the command
.Pp
.Dl info gnunet
.Pp
should give you access to the complete handbook,
.Pp
.Dl info gnunet-c-tutorial
.Pp
will give you access to a tutorial for developers.
.sp
Depending on your installation, this information is also available in
.Xr gnunet 7 and
.Xr gnunet-c-tutorial 7 .
.\".Sh HISTORY
.\".Sh AUTHORS
.Sh BUGS
Report bugs by using
.Lk https://bugs.gnunet.org
or by sending electronic mail to
.Aq Mt gnunet-developers@gnu.org .