summaryrefslogtreecommitdiff
path: root/doc/man/gnunet-revocation.1
blob: 467eb4bcf04bde132aa3fed91386d5d7e64f723f (plain)
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
.TH GNUNET\-REVOCATION 1 "Mar 15, 2012" "GNUnet"

.SH NAME
gnunet\-revocation \- revoke private keys (of egos) in GNUnet

.SH SYNOPSIS
.B gnunet\-revocation
.RI [ options ]
.br

.SH DESCRIPTION
\fBgnunet\-revocation\fP can be used to verify if a key has been
revoked, to create a revocation certificate for later revocation, to
instantly revoke a key and to use a pre-generated revocation
certificate to revoke a key.  Upon successful revocation, all peers
will be informed about the invalidity of the key.  As this is an
expensive operation, GNUnet requires the issuer of the revocation to
perform an expensive proof-of-work computation before they will be
allowed to perform the revocation.  gnunet\-revocation will perform
this computation.  The computation can be performed ahead of time,
with the resulting revocation certificate being stored in a file for
later "instant" use.  gnunet\-revocation also makes is possible to
resume the pre-calculation of a revocation --- simply abort a running
proof-of-work calculation with CTRL-C, and the existing revocation
certificate file will contain the status of the computation.  Note
that performing a revocation proof-of-work is deliberately VERY
expensive.  Depending on your CPU, the calculation can take days or
weeks.

.SH OPTIONS
.B
.IP "\-t KEY, \-\-test=KEY"
Check if the given KEY (ASCII\-encoded public key required) has been
revoked.
.B
.IP "\-R NAME, \-\-revoke=NAME"
Calculate or perform revocation for the ego with the given NAME.
.B
.IP "\-p, \-\-perform"
Actually perform the revocation as soon as possible (do not just
generate a revocation certificate, use it).  Must be supplied to
actually perform the revocation.
.B
.IP "\-f NAME, \-\-filename=NAME"
Use NAME as the name of the file that is to contain the revocation
certificate.  Intermediate computation results will be stored here, as
well as the final revocation certificate.  When used together with
\-p, this file will be inspected to see if it contains a valid
certificate for instant revocation, in which case the revocation can
be performed instantly.  If the given file contains anything (a valid
certificate, with or without the completed proof-of-work) there is no
need to supply the "\-R" option or to still have the private key of
the ego to perform the revocation.
.B
.IP "\-c FILENAME,  \-\-config=FILENAME"
Use the configuration file FILENAME.
.B
.IP "\-h, \-\-help"
Print short help on options.
.B
.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
Use LOGLEVEL for logging.  Valid values are DEBUG, INFO, WARNING and
ERROR.
.B
.IP "\-v, \-\-version"
Print GNUnet version number.


.SH BUGS
Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
.SH "SEE ALSO"
The full documentation for
.B gnunet
is maintained as a Texinfo manual.  If the
.B info
and
.B gnunet
programs are properly installed at your site, the command
.IP
.B info gnunet
.PP
should give you access to the complete handbook,
.IP
.B info gnunet-c-tutorial
.PP
will give you access to a tutorial for developers.
.PP
Depending on your installation, this information is also
available in
\fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7).