summaryrefslogtreecommitdiff
path: root/sys/man/8
diff options
context:
space:
mode:
authorcinap_lenrek <cinap_lenrek@felloff.net>2016-04-22 03:41:06 +0200
committercinap_lenrek <cinap_lenrek@felloff.net>2016-04-22 03:41:06 +0200
commit1cf3c4666943028cccfbbed8d2bae2fee30713a4 (patch)
treee5094d6a443d4f70ded329f89dbbbab838e64a98 /sys/man/8
parent17a67eeb652ebc76f6fc9f7f7bbed501187d24e1 (diff)
rsa: rename getkey() to getrsakey(), document rsa2csr in rsa(8)
Diffstat (limited to 'sys/man/8')
-rw-r--r--sys/man/8/rsa20
1 files changed, 19 insertions, 1 deletions
diff --git a/sys/man/8/rsa b/sys/man/8/rsa
index 94ae8775b..8b2ba333b 100644
--- a/sys/man/8/rsa
+++ b/sys/man/8/rsa
@@ -1,6 +1,6 @@
.TH RSA 8
.SH NAME
-rsagen, rsafill, asn12rsa, rsa2pub, rsa2ssh, rsa2x509 \- generate and format rsa keys
+rsagen, rsafill, asn12rsa, rsa2pub, rsa2ssh, rsa2x509, rsa2csr \- generate and format rsa keys
.SH SYNOPSIS
.B rsagen
[
@@ -52,6 +52,12 @@ rsagen, rsafill, asn12rsa, rsa2pub, rsa2ssh, rsa2x509 \- generate and format rsa
[
.I file
]
+.PP
+.B rsa2csr
+.I subject
+[
+.I file
+]
.SH DESCRIPTION
Plan 9 represents an RSA key as an attribute-value pair list
prefixed with the string
@@ -229,6 +235,11 @@ The Plan 9 RSA private key needs to be loaded into factotum
for TLS server applications. It is recommended to put the key into
.IR secstore (1),
avoiding it being stored unencrypted on the filesystem.
+.PP
+.I Rsa2csr
+takes the
+.I subject
+and a RSA private key and outputs a signing request in ASN.1 format.
.SH EXAMPLES
Generate a fresh key and use it to start a TLS-enabled web server:
.IP
@@ -257,6 +268,13 @@ and load it into factotum:
auth/pemdecode 'PRIVATE KEY' key.pem |
auth/asn12rsa -t 'service=tls' >/mnt/factotum/ctl
.EE
+.PP
+Generate a certificate signing request (CSR) in PEM format:
+.IP
+.EX
+auth/rsa2csr 'CN=example.com' key |
+ auth/pemencode 'CERTIFICATE REQUEST'
+.EE
.SH SOURCE
.B /sys/src/cmd/auth
.SH "SEE ALSO