pki: Add pki --keyid man page

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

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)

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)

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)