mirror of
https://gitlab.torproject.org/tpo/core/tor.git
synced 2024-11-10 05:03:43 +01:00
r17550@catbus: nickm | 2008-01-10 12:08:01 -0500
Add a manual page for tor-gencert. Also implement the missing -s option in tor-gencert, and fix the info message for when no cert file is specified. svn:r13091
This commit is contained in:
parent
ca5f670fab
commit
c508fa5aec
@ -50,6 +50,8 @@ Changes in version 0.2.0.16-alpha - 2008-01-??
|
||||
- New configuration options to override default maximum number of
|
||||
servers allowed on a single IP address. This is important
|
||||
for running a test network on a single host.
|
||||
- Actually implement the -s option to tor-gencert.
|
||||
- Add a manual page for tor-gencert.
|
||||
|
||||
o Minor features (other):
|
||||
- Add hidden services and DNSPorts to the list of things that make
|
||||
|
@ -4,7 +4,7 @@ EXTRA_DIST = website img HACKING \
|
||||
tor-osx-dmg-creation.txt tor-rpm-creation.txt \
|
||||
tor-win32-mingw-creation.txt
|
||||
|
||||
man_MANS = tor.1 tor-resolve.1
|
||||
man_MANS = tor.1 tor-resolve.1 tor-gencert.1
|
||||
|
||||
SUBDIRS = design-paper spec
|
||||
|
||||
|
2
doc/TODO
2
doc/TODO
@ -32,7 +32,7 @@ N - add a bit in the dir_connection_t. or check whether the linked conn
|
||||
dir-connection-is-encrypted.
|
||||
- set up a filter to not answer any bridge descriptors on a
|
||||
non-encrypted request
|
||||
N - write a tor-gencert man page
|
||||
o write a tor-gencert man page
|
||||
|
||||
. geoip caching and publishing for bridges
|
||||
d Track consecutive time up, not time since last-forgotten IP.
|
||||
|
81
doc/tor-gencert.1
Normal file
81
doc/tor-gencert.1
Normal file
@ -0,0 +1,81 @@
|
||||
.TH tor-gencert 1 "" Jan-2008 ""
|
||||
.\" manual page by Nick Mathewson
|
||||
.SH NAME
|
||||
.LP
|
||||
tor-gencert \- Generate certs and keys for Tor directory authorities
|
||||
|
||||
.SH SYNOPSIS
|
||||
\fBtor-gencert\fP\ [-h|--help] [-v] [-r|--reuse] [--create-identity-key] [-i \fIid_file\fP] [-c \fIcert_file\fP] [-m \fInum\fP] [-a \fIaddress\fP:\fIport\fP]
|
||||
|
||||
.SH DESCRIPTION
|
||||
\fBtor-gencert\fR generates certificates and private keys for use by Tor
|
||||
directory authorities running the v3 Tor directory protocol, as used by Tor
|
||||
0.2.0 and later. If you are not running a directory authority, you don't
|
||||
need to use tor-gencert.
|
||||
.PP
|
||||
Every directory authority has a long term authority \fIidentity key\fP (which
|
||||
is distinct from the identity key it uses as a Tor server); this key should
|
||||
be kept offline in a secure location. It is used to certify shorter-lived
|
||||
\fIsigning keys\fP, which are kept online and used by the directory authority
|
||||
to sign votes and consensus documents.
|
||||
.PP
|
||||
After you use this program to generate a signing key and a certificate, copy
|
||||
those files to the keys subdirectory of your Tor process, and send Tor a
|
||||
SIGHUP signal. DO NOT COPY THE IDENTITY KEY.
|
||||
|
||||
.SH OPTIONS
|
||||
\fB-v\fP
|
||||
Display verbose output.
|
||||
.LP
|
||||
.TP
|
||||
\fB-h\fP or \fB--help\fP
|
||||
Display help text and exit.
|
||||
.LP
|
||||
.TP
|
||||
\fB-r\fP or \fB--reuse\fP
|
||||
Generate a new certificate, but not a new signing key. This can be
|
||||
used to change the address or lifetime associated with a given key.
|
||||
.LP
|
||||
.TP
|
||||
\fB--create-identity-key\fP
|
||||
Generate a new identity key. You should only use this option the first
|
||||
time you run tor-gencert; in the future, you should use the identity
|
||||
key that's already there.
|
||||
.LP
|
||||
.TP
|
||||
\fB-i \fR\fIFILENAME\fP
|
||||
Read the identity key from the specified file. If the file is not present
|
||||
and --create-identity-key is provided, create the identity key in the
|
||||
specified file. Default: "./authority_identity_key"
|
||||
.LP
|
||||
.TP
|
||||
\fB-s \fR\fIFILENAME\fP
|
||||
Write the signing key to the specified file. Default:
|
||||
"./authority_signing_key"
|
||||
.LP
|
||||
.TP
|
||||
\fB-c \fR\fIFILENAME\fP
|
||||
Write the certificate to the specified file.
|
||||
Default: "./authority_certificate"
|
||||
.LP
|
||||
.TP
|
||||
\fB-m \fR\fINUM\fP
|
||||
Number of months that the certificate should be valid. Default: 12.
|
||||
.LP
|
||||
.TP
|
||||
\fB-a \fR\fIaddress\fR:\fIport\fP
|
||||
If provided, advertise the address:port combination as this authority's
|
||||
preferred directory port in its certificate. If the address is a hostname,
|
||||
the hostname is resolved to an IP before it's published.
|
||||
|
||||
.SH BUGS
|
||||
This probably doesn't run on Windows. That's not a big issue, since we
|
||||
don't really want authorities to be running on Windows anyway.
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR tor (1)
|
||||
.PP
|
||||
See also the "dir-spec.txt" file, distributed with Tor.
|
||||
|
||||
.SH AUTHORS
|
||||
Roger Dingledine <arma@mit.edu>, Nick Mathewson <nickm@alum.mit.edu>.
|
@ -96,6 +96,12 @@ parse_commandline(int argc, char **argv)
|
||||
return 1;
|
||||
}
|
||||
identity_key_file = tor_strdup(argv[++i]);
|
||||
} else if (!strcmp(argv[i], "-s")) {
|
||||
if (i+1>=argc) {
|
||||
fprintf(stderr, "No argument to -s\n");
|
||||
return 1;
|
||||
}
|
||||
signing_key_file = tor_strdup(argv[++i]);
|
||||
} else if (!strcmp(argv[i], "-c")) {
|
||||
if (i+1>=argc) {
|
||||
fprintf(stderr, "No argument to -c\n");
|
||||
@ -158,7 +164,7 @@ parse_commandline(int argc, char **argv)
|
||||
if (!certificate_file) {
|
||||
certificate_file = tor_strdup("./authority_certificate");
|
||||
log_info(LD_GENERAL, "No signing key file given; defaulting to %s",
|
||||
signing_key_file);
|
||||
certificate_file);
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
Loading…
Reference in New Issue
Block a user