pki: Add pki --keyid man page
authorTobias Brunner <tobias@strongswan.org>
Mon, 12 Aug 2013 15:14:17 +0000 (17:14 +0200)
committerTobias Brunner <tobias@strongswan.org>
Fri, 13 Sep 2013 13:07:35 +0000 (15:07 +0200)
configure.ac
src/pki/man/Makefile.am
src/pki/man/ipsec-pki.8.in
src/pki/man/pki---keyid.8.in [new file with mode: 0644]

index 7ddb274..4d0eb8e 100644 (file)
@@ -1496,6 +1496,7 @@ AC_CONFIG_FILES([
        src/pki/man/ipsec-pki.8
        src/pki/man/pki---gen.8
        src/pki/man/pki---issue.8
+       src/pki/man/pki---keyid.8
        src/pki/man/pki---pkcs7.8
        src/pki/man/pki---req.8
        src/pki/man/pki---self.8
index e88230a..7918975 100644 (file)
@@ -5,6 +5,7 @@ man8_MANS = \
        pki---issue.8 \
        pki---signcrl.8 \
        pki---req.8 \
-       pki---pkcs7.8
+       pki---pkcs7.8 \
+       pki---keyid.8
 
 CLEANFILES = $(man8_MANS)
index c41ea0b..5faa321 100644 (file)
@@ -75,4 +75,5 @@ Verify a certificate using a CA certificate.
 .BR pki\ \-\-issue (8),
 .BR pki\ \-\-signcrl (8),
 .BR pki\ \-\-req (8),
-.BR pki\ \-\-pkcs7 (8)
+.BR pki\ \-\-pkcs7 (8),
+.BR pki\ \-\-keyid (8)
diff --git a/src/pki/man/pki---keyid.8.in b/src/pki/man/pki---keyid.8.in
new file mode 100644 (file)
index 0000000..a4a6c9d
--- /dev/null
@@ -0,0 +1,72 @@
+.TH "PKI \-\-KEYID" 8 "2013-07-31" "@PACKAGE_VERSION@" "strongSwan"
+.
+.SH "NAME"
+.
+pki \-\-keyid \- Calculate key identifiers of a key or certificate
+.
+.SH "SYNOPSIS"
+.
+.SY pki\ \-\-keyid
+.OP \-\-in file
+.OP \-\-type type
+.OP \-\-debug level
+.YS
+.
+.SY pki\ \-\-keyid
+.BI \-\-options\~ file
+.YS
+.
+.SY "pki \-\-keyid"
+.B \-h
+|
+.B \-\-help
+.YS
+.
+.SH "DESCRIPTION"
+.
+This sub-command of
+.BR ipsec\-pki (8)
+calculates key identifiers of private keys and certificates.
+.
+.SH "OPTIONS"
+.
+.TP
+.B "\-h, \-\-help"
+Print usage information with a summary of the available options.
+.TP
+.BI "\-v, \-\-debug " level
+Set debug level, default: 1.
+.TP
+.BI "\-+, \-\-options " file
+Read command line options from \fIfile\fR.
+.TP
+.BI "\-i, \-\-in " file
+Input file. If not given the input is read from \fISTDIN\fR.
+.TP
+.BI "\-t, \-\-type " type
+Type of input. One of \fIrsa-priv\fR (RSA private key), \fIecdsa-priv\fR (ECDSA
+private key), \fIpub\fR (public key), \fIpkcs10\fR (PKCS#10 certificate
+request), \fIx509\fR (X.509 certificate), defaults to \fIrsa-priv\fR.
+.
+.SH "EXAMPLES"
+.
+Calculate key identifiers of an RSA private key:
+.PP
+.EX
+  ipsec pki --keyid --in key.der
+  subjectKeyIdentifier:      6a:9c:74:d1:f8:89:79:89:f6:5a:94:e9:89:f1...
+  subjectPublicKeyInfo hash: 6e:55:dc:7e:9c:a5:58:d9:5b:e3:c7:13:14:e1...
+.EE
+.PP
+Calculate key identifiers of an X.509 certificate:
+.PP
+.EX
+  ipsec pki --keyid --in cert.der --type x509
+  subjectKeyIdentifier:      6a:9c:74:d1:f8:89:79:89:f6:5a:94:e9:89:f1...
+  subjectPublicKeyInfo hash: 6e:55:dc:7e:9c:a5:58:d9:5b:e3:c7:13:14:e1...
+.EE
+.PP
+.
+.SH "SEE ALSO"
+.
+.BR ipsec\-pki (8)
\ No newline at end of file