Annotation of embedaddon/strongswan/src/pki/man/pki---self.1.in, revision 1.1
1.1 ! misho 1: .TH "PKI \-\-SELF" 1 "2019-05-06" "@PACKAGE_VERSION@" "strongSwan"
! 2: .
! 3: .SH "NAME"
! 4: .
! 5: pki \-\-self \- Create a self-signed certificate
! 6: .
! 7: .SH "SYNOPSIS"
! 8: .
! 9: .SY pki\ \-\-self
! 10: .RB [ \-\-in
! 11: .IR file | \fB\-\-keyid\fR
! 12: .IR hex ]
! 13: .OP \-\-type t
! 14: .BI \-\-dn\~ distinguished-name
! 15: .OP \-\-san subjectAltName
! 16: .OP \-\-lifetime days
! 17: .OP \-\-not-before datetime
! 18: .OP \-\-not-after datetime
! 19: .OP \-\-serial hex
! 20: .OP \-\-flag flag
! 21: .OP \-\-digest digest
! 22: .OP \-\-rsa\-padding padding
! 23: .OP \-\-ca
! 24: .OP \-\-ocsp uri
! 25: .OP \-\-pathlen len
! 26: .OP \-\-addrblock block
! 27: .OP \-\-nc-permitted name
! 28: .OP \-\-nc-excluded name
! 29: .OP \-\-critical oid
! 30: .OP \-\-policy\-mapping mapping
! 31: .OP \-\-policy\-explicit len
! 32: .OP \-\-policy\-inhibit len
! 33: .OP \-\-policy\-any len
! 34: .OP \-\-cert\-policy oid\ \fR[\fB\-\-cps\-uri\ \fIuri\fR]\ \fR[\fB\-\-user\-notice\ \fItext\fR]
! 35: .OP \-\-outform encoding
! 36: .OP \-\-debug level
! 37: .YS
! 38: .
! 39: .SY pki\ \-\-self
! 40: .BI \-\-options\~ file
! 41: .YS
! 42: .
! 43: .SY "pki \-\-self"
! 44: .B \-h
! 45: |
! 46: .B \-\-help
! 47: .YS
! 48: .
! 49: .SH "DESCRIPTION"
! 50: .
! 51: This sub-command of
! 52: .BR pki (1)
! 53: is used to create a self-signed certificate.
! 54: .
! 55: .SH "OPTIONS"
! 56: .
! 57: .TP
! 58: .B "\-h, \-\-help"
! 59: Print usage information with a summary of the available options.
! 60: .TP
! 61: .BI "\-v, \-\-debug " level
! 62: Set debug level, default: 1.
! 63: .TP
! 64: .BI "\-+, \-\-options " file
! 65: Read command line options from \fIfile\fR.
! 66: .TP
! 67: .BI "\-i, \-\-in " file
! 68: Private key input file. If not given the key is read from \fISTDIN\fR.
! 69: .TP
! 70: .BI "\-x, \-\-keyid " hex
! 71: Smartcard or TPM private key object handle in hex format with an optional
! 72: 0x prefix.
! 73: .TP
! 74: .BI "\-t, \-\-type " type
! 75: Type of the input key. Either \fIpriv\fR, \fIrsa\fR, \fIecdsa\fR, \fIed25519\fR,
! 76: \fIed448\fR or \fIbliss\fR, defaults to \fIpriv\fR.
! 77: .TP
! 78: .BI "\-d, \-\-dn " distinguished-name
! 79: Subject and issuer distinguished name (DN). Required.
! 80: .TP
! 81: .BI "\-a, \-\-san " subjectAltName
! 82: subjectAltName extension to include in certificate. Can be used multiple times.
! 83: .TP
! 84: .BI "\-l, \-\-lifetime " days
! 85: Days the certificate is valid, default: 1095. Ignored if both
! 86: an absolute start and end time are given.
! 87: .TP
! 88: .BI "\-F, \-\-not-before " datetime
! 89: Absolute time when the validity of the certificate begins. The datetime format
! 90: is defined by the
! 91: .B \-\-dateform
! 92: option.
! 93: .TP
! 94: .BI "\-T, \-\-not-after " datetime
! 95: Absolute time when the validity of the certificate ends. The datetime format is
! 96: defined by the
! 97: .B \-\-dateform
! 98: option.
! 99: .TP
! 100: .BI "\-D, \-\-dateform " form
! 101: strptime(3) format for the
! 102: .B \-\-not\-before
! 103: and
! 104: .B \-\-not\-after
! 105: options, default:
! 106: .B %d.%m.%y %T
! 107: .TP
! 108: .BI "\-s, \-\-serial " hex
! 109: Serial number in hex. It is randomly allocated by default.
! 110: .TP
! 111: .BI "\-e, \-\-flag " flag
! 112: Add extendedKeyUsage flag. One of \fIserverAuth\fR, \fIclientAuth\fR,
! 113: \fIcrlSign\fR, or \fIocspSigning\fR. Can be used multiple times.
! 114: .TP
! 115: .BI "\-g, \-\-digest " digest
! 116: Digest to use for signature creation. One of \fImd5\fR, \fIsha1\fR,
! 117: \fIsha224\fR, \fIsha256\fR, \fIsha384\fR, or \fIsha512\fR. The default is
! 118: determined based on the type and size of the signature key.
! 119: .TP
! 120: .BI "\-R, \-\-rsa\-padding " padding
! 121: Padding to use for RSA signatures. Either \fIpkcs1\fR or \fIpss\fR, defaults
! 122: to \fIpkcs1\fR.
! 123: .TP
! 124: .BI "\-f, \-\-outform " encoding
! 125: Encoding of the created certificate file. Either \fIder\fR (ASN.1 DER) or
! 126: \fIpem\fR (Base64 PEM), defaults to \fIder\fR.
! 127: .TP
! 128: .BI "\-b, \-\-ca"
! 129: Include CA basicConstraint extension in certificate.
! 130: .TP
! 131: .BI "\-o, \-\-ocsp " uri
! 132: OCSP AuthorityInfoAccess URI to include in certificate. Can be used multiple
! 133: times.
! 134: .TP
! 135: .BI "\-p, \-\-pathlen " len
! 136: Set path length constraint.
! 137: .TP
! 138: .BI "\-B, \-\-addrblock " block
! 139: RFC 3779 address block to include in certificate. \fIblock\fR is either a
! 140: CIDR subnet (such as \fI10.0.0.0/8\fR) or an arbitrary address range
! 141: (\fI192.168.1.7-192.168.1.13\fR). Can be repeated to include multiple blocks.
! 142: Please note that the supplied blocks are included in the certificate as is,
! 143: so for standards compliance, multiple blocks must be supplied in correct
! 144: order and adjacent blocks must be combined. Refer to RFC 3779 for details.
! 145: .TP
! 146: .BI "\-n, \-\-nc-permitted " name
! 147: Add permitted NameConstraint extension to certificate. For DNS or email
! 148: constraints, the identity type is not always detectable by the given name. Use
! 149: the
! 150: .B dns:
! 151: or
! 152: .B email:
! 153: prefix to force a constraint type.
! 154: .TP
! 155: .BI "\-N, \-\-nc-excluded " name
! 156: Add excluded NameConstraint extension to certificate. For DNS or email
! 157: constraints, the identity type is not always detectable by the given name. Use
! 158: the
! 159: .B dns:
! 160: or
! 161: .B email:
! 162: prefix to force a constraint type.
! 163: .TP
! 164: .BI "\-X, \-\-critical " oid
! 165: Add a critical extension with the given OID.
! 166: .TP
! 167: .BI "\-M, \-\-policy-mapping " issuer-oid:subject-oid
! 168: Add policyMapping from issuer to subject OID.
! 169: .TP
! 170: .BI "\-E, \-\-policy-explicit " len
! 171: Add requireExplicitPolicy constraint.
! 172: .TP
! 173: .BI "\-H, \-\-policy-inhibit " len
! 174: Add inhibitPolicyMapping constraint.
! 175: .TP
! 176: .BI "\-A, \-\-policy-any " len
! 177: Add inhibitAnyPolicy constraint.
! 178: .PP
! 179: .SS "Certificate Policy"
! 180: Multiple certificatePolicy extensions can be added. Each with the following
! 181: information:
! 182: .TP
! 183: .BI "\-P, \-\-cert-policy " oid
! 184: OID to include in certificatePolicy extension. Required.
! 185: .TP
! 186: .BI "\-C, \-\-cps-uri " uri
! 187: Certification Practice statement URI for certificatePolicy.
! 188: .TP
! 189: .BI "\-U, \-\-user-notice " text
! 190: User notice for certificatePolicy.
! 191: .
! 192: .SH "EXAMPLES"
! 193: .
! 194: Generate a self-signed certificate using the given RSA key:
! 195: .PP
! 196: .EX
! 197: pki \-\-self \-\-in key.der \-\-dn "C=CH, O=strongSwan, CN=moon" \\
! 198: \-\-san moon.strongswan.org > cert.der
! 199: .EE
! 200: .
! 201: .SH "SEE ALSO"
! 202: .
! 203: .BR pki (1)
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>