|
@@ -0,0 +1,90 @@
|
|
|
+// Copyright (c) The Tor Project, Inc.
|
|
|
+// See LICENSE for licensing information
|
|
|
+// This is an asciidoc file used to generate the manpage/html reference.
|
|
|
+// Learn asciidoc on http://www.methods.co.nz/asciidoc/userguide.html
|
|
|
+tor-gencert(1)
|
|
|
+==============
|
|
|
+Nick Mathewson
|
|
|
+
|
|
|
+NAME
|
|
|
+----
|
|
|
+tor-gencert - Generate certs and keys for Tor directory authorities
|
|
|
+
|
|
|
+SYNOPSIS
|
|
|
+--------
|
|
|
+**tor-gencert** [-h|--help] [-v] [-r|--reuse] [--create-identity-key] [-i __id_file__] [-c
|
|
|
+__cert_file__] [-m __num__] [-a __address__:__port__]
|
|
|
+
|
|
|
+DESCRIPTION
|
|
|
+-----------
|
|
|
+**tor-gencert** 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. +
|
|
|
+
|
|
|
+Every directory authority has a long term authority __identity__ __key__ (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 __signing__ __keys__, which are kept online and used by the
|
|
|
+directory authority to sign votes and consensus documents. +
|
|
|
+
|
|
|
+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.
|
|
|
+
|
|
|
+OPTIONS
|
|
|
+-------
|
|
|
+**-v**::
|
|
|
+ Display verbose output.
|
|
|
+
|
|
|
+**-h** or **--help**::
|
|
|
+ Display help text and exit.
|
|
|
+
|
|
|
+**-r** or **--reuse**::
|
|
|
+ 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.
|
|
|
+
|
|
|
+**--create-identity-key**::
|
|
|
+ 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.
|
|
|
+
|
|
|
+**-i** __FILENAME__::
|
|
|
+ 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"
|
|
|
+
|
|
|
+**-s** __FILENAME__::
|
|
|
+ Write the signing key to the specified file. Default:
|
|
|
+ "./authority_signing_key"
|
|
|
+
|
|
|
+**-c** __FILENAME__::
|
|
|
+ Write the certificate to the specified file. Default:
|
|
|
+ "./authority_certificate"
|
|
|
+
|
|
|
+**-m** __NUM__::
|
|
|
+ Number of months that the certificate should be valid. Default: 12.
|
|
|
+
|
|
|
+**--passphrase-fd** __FILEDES__::
|
|
|
+ Filedescriptor to read the file descriptor from. Ends at the first NUL or
|
|
|
+ newline. Default: read from the terminal.
|
|
|
+
|
|
|
+**-a** __address__:__port__::
|
|
|
+ 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.
|
|
|
+
|
|
|
+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.
|
|
|
+
|
|
|
+SEE ALSO
|
|
|
+--------
|
|
|
+**tor**(1) +
|
|
|
+
|
|
|
+See also the "dir-spec.txt" file, distributed with Tor.
|
|
|
+
|
|
|
+AUTHORS
|
|
|
+-------
|
|
|
+ Roger Dingledine <arma@mit.edu>, Nick Mathewson <nickm@alum.mit.edu>.
|