pki: Document --not-before/after and --dateform options in manpages

This commit is contained in:
Martin Willi
2014-03-31 11:39:25 +02:00
parent 2769a22e1f
commit 3941d55f01
4 changed files with 99 additions and 7 deletions
+24 -1
View File
@@ -12,6 +12,8 @@ pki \-\-acert \- Issue an attribute certificate
.BI \-\-issuerkey\~ file |\-\-issuerkeyid\~ hex .BI \-\-issuerkey\~ file |\-\-issuerkeyid\~ hex
.BI \-\-issuercert\~ file .BI \-\-issuercert\~ file
.OP \-\-lifetime hours .OP \-\-lifetime hours
.OP \-\-not-before datetime
.OP \-\-not-after datetime
.OP \-\-serial hex .OP \-\-serial hex
.OP \-\-digest digest .OP \-\-digest digest
.OP \-\-outform encoding .OP \-\-outform encoding
@@ -69,7 +71,28 @@ is required.
Issuer certificate file. Required. Issuer certificate file. Required.
.TP .TP
.BI "\-l, \-\-lifetime " hours .BI "\-l, \-\-lifetime " hours
Hours the attribute certificate is valid, default: 24. Hours the attribute certificate is valid, default: 24. Ignored if both
an absolute start and end time are given.
.TP
.BI "\-F, \-\-not-before " datetime
Absolute time when the validity of the AC begins. The datetime format is
defined by the
.B \-\-dateform
option.
.TP
.BI "\-T, \-\-not-after " datetime
Absolute time when the validity of the AC ends. The datetime format is
defined by the
.B \-\-dateform
option.
.TP
.BI "\-D, \-\-dateform " form
strptime(3) format for the
.B \-\-not\-before
and
.B \-\-not\-after
options, default:
.B %d.%m.%y %T
.TP .TP
.BI "\-s, \-\-serial " hex .BI "\-s, \-\-serial " hex
Serial number in hex. It is randomly allocated by default. Serial number in hex. It is randomly allocated by default.
+25 -2
View File
@@ -14,6 +14,8 @@ pki \-\-issue \- Issue a certificate using a CA certificate and key
.OP \-\-dn subject-dn .OP \-\-dn subject-dn
.OP \-\-san subjectAltName .OP \-\-san subjectAltName
.OP \-\-lifetime days .OP \-\-lifetime days
.OP \-\-not-before datetime
.OP \-\-not-after datetime
.OP \-\-serial hex .OP \-\-serial hex
.OP \-\-flag flag .OP \-\-flag flag
.OP \-\-digest digest .OP \-\-digest digest
@@ -88,7 +90,28 @@ Subject distinguished name (DN) of the issued certificate.
subjectAltName extension to include in certificate. Can be used multiple times. subjectAltName extension to include in certificate. Can be used multiple times.
.TP .TP
.BI "\-l, \-\-lifetime " days .BI "\-l, \-\-lifetime " days
Days the certificate is valid, default: 1095. Days the certificate is valid, default: 1095. Ignored if both
an absolute start and end time are given.
.TP
.BI "\-F, \-\-not-before " datetime
Absolute time when the validity of the certificate begins. The datetime format
is defined by the
.B \-\-dateform
option.
.TP
.BI "\-T, \-\-not-after " datetime
Absolute time when the validity of the certificate ends. The datetime format is
defined by the
.B \-\-dateform
option.
.TP
.BI "\-D, \-\-dateform " form
strptime(3) format for the
.B \-\-not\-before
and
.B \-\-not\-after
options, default:
.B %d.%m.%y %T
.TP .TP
.BI "\-s, \-\-serial " hex .BI "\-s, \-\-serial " hex
Serial number in hex. It is randomly allocated by default. Serial number in hex. It is randomly allocated by default.
@@ -176,4 +199,4 @@ given PKCS#10 certificate request and the options above:
. .
.SH "SEE ALSO" .SH "SEE ALSO"
. .
.BR pki (1) .BR pki (1)
+25 -2
View File
@@ -14,6 +14,8 @@ pki \-\-self \- Create a self-signed certificate
.BI \-\-dn\~ distinguished-name .BI \-\-dn\~ distinguished-name
.OP \-\-san subjectAltName .OP \-\-san subjectAltName
.OP \-\-lifetime days .OP \-\-lifetime days
.OP \-\-not-before datetime
.OP \-\-not-after datetime
.OP \-\-serial hex .OP \-\-serial hex
.OP \-\-flag flag .OP \-\-flag flag
.OP \-\-digest digest .OP \-\-digest digest
@@ -75,7 +77,28 @@ Subject and issuer distinguished name (DN). Required.
subjectAltName extension to include in certificate. Can be used multiple times. subjectAltName extension to include in certificate. Can be used multiple times.
.TP .TP
.BI "\-l, \-\-lifetime " days .BI "\-l, \-\-lifetime " days
Days the certificate is valid, default: 1095. Days the certificate is valid, default: 1095. Ignored if both
an absolute start and end time are given.
.TP
.BI "\-F, \-\-not-before " datetime
Absolute time when the validity of the certificate begins. The datetime format
is defined by the
.B \-\-dateform
option.
.TP
.BI "\-T, \-\-not-after " datetime
Absolute time when the validity of the certificate ends. The datetime format is
defined by the
.B \-\-dateform
option.
.TP
.BI "\-D, \-\-dateform " form
strptime(3) format for the
.B \-\-not\-before
and
.B \-\-not\-after
options, default:
.B %d.%m.%y %T
.TP .TP
.BI "\-s, \-\-serial " hex .BI "\-s, \-\-serial " hex
Serial number in hex. It is randomly allocated by default. Serial number in hex. It is randomly allocated by default.
@@ -145,4 +168,4 @@ Generate a self-signed certificate using the given RSA key:
. .
.SH "SEE ALSO" .SH "SEE ALSO"
. .
.BR pki (1) .BR pki (1)
+25 -2
View File
@@ -10,6 +10,8 @@ pki \-\-signcrl \- Issue a Certificate Revocation List (CRL) using a CA certific
.BI \-\-cakey\~ file |\-\-cakeyid\~ hex .BI \-\-cakey\~ file |\-\-cakeyid\~ hex
.BI \-\-cacert\~ file .BI \-\-cacert\~ file
.OP \-\-lifetime days .OP \-\-lifetime days
.OP \-\-this-update datetime
.OP \-\-next-update datetime
.OP \-\-lastcrl crl .OP \-\-lastcrl crl
.OP \-\-basecrl crl .OP \-\-basecrl crl
.OP \-\-crluri uri .OP \-\-crluri uri
@@ -62,7 +64,28 @@ is required.
CA certificate file. Required. CA certificate file. Required.
.TP .TP
.BI "\-l, \-\-lifetime " days .BI "\-l, \-\-lifetime " days
Days until the CRL gets a nextUpdate, default: 15. Days until the CRL gets a nextUpdate, default: 15. Ignored if both
an absolute start and end time are given.
.TP
.BI "\-F, \-\-this-update " datetime
Absolute time when the validity of the CRL begins. The datetime format is
defined by the
.B \-\-dateform
option.
.TP
.BI "\-T, \-\-next-update " datetime
Absolute time when the validity of the CRL end. The datetime format is
defined by the
.B \-\-dateform
option.
.TP
.BI "\-D, \-\-dateform " form
strptime(3) format for the
.B \-\-this\-update
and
.B \-\-next\-update
options, default:
.B %d.%m.%y %T
.TP .TP
.BI "\-a, \-\-lastcrl " crl .BI "\-a, \-\-lastcrl " crl
CRL of lastUpdate to copy revocations from. CRL of lastUpdate to copy revocations from.
@@ -121,4 +144,4 @@ number, but no reason:
.PP .PP
.SH "SEE ALSO" .SH "SEE ALSO"
. .
.BR pki (1) .BR pki (1)