]> git.lizzy.rs Git - plan9front.git/commitdiff
rsa: rename getkey() to getrsakey(), document rsa2csr in rsa(8)
authorcinap_lenrek <cinap_lenrek@felloff.net>
Fri, 22 Apr 2016 01:41:06 +0000 (03:41 +0200)
committercinap_lenrek <cinap_lenrek@felloff.net>
Fri, 22 Apr 2016 01:41:06 +0000 (03:41 +0200)
sys/man/8/rsa
sys/src/cmd/auth/rsa2any.c
sys/src/cmd/auth/rsa2any.h
sys/src/cmd/auth/rsa2csr.c
sys/src/cmd/auth/rsa2pub.c
sys/src/cmd/auth/rsa2ssh.c
sys/src/cmd/auth/rsa2x509.c
sys/src/cmd/auth/rsafill.c

index 94ae8775ba1b3031c18be72498d5aa911bb7c39f..8b2ba333b261724d8caa56f7d56392b0368c8cfd 100644 (file)
@@ -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
index 32cd7133878382096407d62f1f74b7f5066d066d..b6b4e6e5fe1eaa914e929089bc979a4e4fcb05f1 100644 (file)
@@ -7,7 +7,7 @@
 #include "rsa2any.h"
 
 RSApriv*
-getkey(int argc, char **argv, int needprivate, Attr **pa)
+getrsakey(int argc, char **argv, int needprivate, Attr **pa)
 {
        char *file, *s, *p;
        int sz;
index 5574edb4400cf5832e2081622b066fda57bc7e0d..e42a92cb4756c32ad2e51b2d3ffc6ee8477bcdc9 100644 (file)
@@ -1,5 +1,5 @@
 DSApriv*getdsakey(int argc, char **argv, int needprivate, Attr **pa);
-RSApriv*getkey(int argc, char **argv, int needprivate, Attr **pa);
+RSApriv*getrsakey(int argc, char **argv, int needprivate, Attr **pa);
 uchar* put4(uchar *p, uint n);
 uchar* putmp2(uchar *p, mpint *b);
 uchar* putn(uchar *p, void *v, uint n);
index e4107a2d7b0c68bf86ceb8f5229d80cb1cd03e8e..b8b126f60f4aafe1457b3b86269aeebd407c01a2 100644 (file)
@@ -31,12 +31,12 @@ main(int argc, char **argv)
        if(argc != 1 && argc != 2)
                usage();
 
-       if((key = getkey(argc-1, argv+1, 1, nil)) == nil)
+       if((key = getrsakey(argc-1, argv+1, 1, nil)) == nil)
                sysfatal("%r");
 
        cert = X509rsareq(key, argv[0], &len);
        if(cert == nil)
-               sysfatal("X509req: %r");
+               sysfatal("X509rsareq: %r");
 
        write(1, cert, len);
        exits(0);
index 7de105064f3ccb4dcfef06fb485daa146700819c..df3ac9ac67097f2ad0d1d39b55a39d0582ed6b15 100644 (file)
@@ -31,7 +31,7 @@ main(int argc, char **argv)
        if(argc > 1)
                usage();
 
-       if((key = getkey(argc, argv, 0, &a)) == nil)
+       if((key = getrsakey(argc, argv, 0, &a)) == nil)
                sysfatal("%r");
 
        s = smprint("key %A size=%d ek=%B n=%B\n",
index 397189502c839d1aa6659e7684ad61f0a39f1351..6c06af6b4d09ac5259270fff708cd46aebff114d 100644 (file)
@@ -39,7 +39,7 @@ main(int argc, char **argv)
        if(argc > 1)
                usage();
 
-       if((k = getkey(argc, argv, 0, nil)) == nil)
+       if((k = getrsakey(argc, argv, 0, nil)) == nil)
                sysfatal("%r");
 
        if(ssh2) {
index 3e07bb88ff3475dddc6f2fdc36073d71b8181647..e433fc9d84167f07ec86802f525b21c6ba2b1bab 100644 (file)
@@ -38,12 +38,12 @@ main(int argc, char **argv)
        if(argc != 1 && argc != 2)
                usage();
 
-       if((key = getkey(argc-1, argv+1, 1, nil)) == nil)
+       if((key = getrsakey(argc-1, argv+1, 1, nil)) == nil)
                sysfatal("%r");
 
        cert = X509rsagen(key, argv[0], valid, &len);
        if(cert == nil)
-               sysfatal("X509gen: %r");
+               sysfatal("X509rsagen: %r");
 
        write(1, cert, len);
        exits(0);
index b9e26d43be80a3821356ce83f7a3d5868f0a7111..95e583aa64f4f5208de06d830fb018c3552481c6 100644 (file)
@@ -31,7 +31,7 @@ main(int argc, char **argv)
        if(argc > 1)
                usage();
 
-       if((key = getkey(argc, argv, 1, &a)) == nil)
+       if((key = getrsakey(argc, argv, 1, &a)) == nil)
                sysfatal("%r");
 
        s = smprint("key %A size=%d ek=%B !dk=%B n=%B !p=%B !q=%B !kp=%B !kq=%B !c2=%B\n",