From: Tobias Brunner <tobias@strongswan.org>
Date: Mon, 12 Aug 2013 15:14:17 +0000 (+0200)
Subject: pki: Add pki --keyid man page
X-Git-Tag: 5.1.1dr4~25^2~6
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=e69fd305382ba4577d9b11cfec3bc9084bc15001;p=thirdparty%2Fstrongswan.git

pki: Add pki --keyid man page
---

diff --git a/configure.ac b/configure.ac
index 7ddb2746a3..4d0eb8eae7 100644
--- a/configure.ac
+++ b/configure.ac
@@ -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
diff --git a/src/pki/man/Makefile.am b/src/pki/man/Makefile.am
index e88230a92e..7918975d2c 100644
--- a/src/pki/man/Makefile.am
+++ b/src/pki/man/Makefile.am
@@ -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)
diff --git a/src/pki/man/ipsec-pki.8.in b/src/pki/man/ipsec-pki.8.in
index c41ea0bea2..5faa321be6 100644
--- a/src/pki/man/ipsec-pki.8.in
+++ b/src/pki/man/ipsec-pki.8.in
@@ -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
index 0000000000..a4a6c9d4a4
--- /dev/null
+++ b/src/pki/man/pki---keyid.8.in
@@ -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