diff options
Diffstat (limited to 'secure/usr.bin/openssl/man/openssl-namedisplay-options.1')
| -rw-r--r-- | secure/usr.bin/openssl/man/openssl-namedisplay-options.1 | 192 |
1 files changed, 59 insertions, 133 deletions
diff --git a/secure/usr.bin/openssl/man/openssl-namedisplay-options.1 b/secure/usr.bin/openssl/man/openssl-namedisplay-options.1 index 4b9a6515dcd4..dd1898af1b0a 100644 --- a/secure/usr.bin/openssl/man/openssl-namedisplay-options.1 +++ b/secure/usr.bin/openssl/man/openssl-namedisplay-options.1 @@ -1,4 +1,5 @@ -.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== @@ -15,29 +16,12 @@ .ft R .fi .. -.\" Set up some character translations and predefined strings. \*(-- will -.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. \*(C+ will -.\" give a nicer C++. Capital omega is used to do unbreakable dashes and -.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, -.\" nothing in troff, for use with C<>. -.tr \(*W- -.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ -. ds -- \(*W- -. ds PI pi -. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch -. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch -. ds L" "" -. ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ -. ds -- \|\(em\| -. ds PI \(*p -. ds L" `` -. ds R" '' . ds C` . ds C' 'br\} @@ -68,215 +52,157 @@ . \} .\} .rr rF -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "OPENSSL-NAMEDISPLAY-OPTIONS 1ossl" -.TH OPENSSL-NAMEDISPLAY-OPTIONS 1ossl "2023-09-19" "3.0.11" "OpenSSL" +.TH OPENSSL-NAMEDISPLAY-OPTIONS 1ossl 2025-07-01 3.5.1 OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh -.SH "NAME" +.SH NAME openssl\-namedisplay\-options \- Distinguished name display options -.SH "SYNOPSIS" +.SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBopenssl\fR \&\fIcommand\fR [ \fIoptions\fR ... ] [ \fIparameters\fR ... ] -.SH "DESCRIPTION" +.SH DESCRIPTION .IX Header "DESCRIPTION" -OpenSSL provides fine-grain control over how the subject and issuer \s-1DN\s0's are +OpenSSL provides fine-grain control over how the subject and issuer DN's are displayed. This is specified by using the \fB\-nameopt\fR option, which takes a comma-separated list of options from the following set. An option may be preceded by a minus sign, \f(CW\*(C`\-\*(C'\fR, to turn it off. -The default value is \f(CW\*(C`oneline\*(C'\fR. -The first four are the most commonly used. -.SH "OPTIONS" +The first four option arguments are the most commonly used. +.PP +The default value is +\&\f(CW\*(C`esc_ctrl,utf8,dump_unknown,dump_der,sep_comma_plus_space,sname\*(C'\fR. +.SH OPTIONS .IX Header "OPTIONS" .SS "Name Format Option Arguments" .IX Subsection "Name Format Option Arguments" -The \s-1DN\s0 output format can be fine tuned with the following flags. -.IP "\fBcompat\fR" 4 +The DN output format can be fine tuned with the following flags. +.IP \fBcompat\fR 4 .IX Item "compat" Display the name using an old format from previous OpenSSL versions. -.IP "\fB\s-1RFC2253\s0\fR" 4 +.IP \fBRFC2253\fR 4 .IX Item "RFC2253" -Display the name using the format defined in \s-1RFC 2253.\s0 +Display the name using the format defined in RFC 2253. It is equivalent to \fBesc_2253\fR, \fBesc_ctrl\fR, \fBesc_msb\fR, \fButf8\fR, \&\fBdump_nostr\fR, \fBdump_unknown\fR, \fBdump_der\fR, \fBsep_comma_plus\fR, \fBdn_rev\fR and \fBsname\fR. -.IP "\fBoneline\fR" 4 +.IP \fBoneline\fR 4 .IX Item "oneline" Display the name in one line, using a format that is more readable -\&\s-1RFC 2253.\s0 +RFC 2253. It is equivalent to \fBesc_2253\fR, \fBesc_ctrl\fR, \fBesc_msb\fR, \fButf8\fR, \&\fBdump_nostr\fR, \fBdump_der\fR, \fBuse_quote\fR, \fBsep_comma_plus_space\fR, \&\fBspace_eq\fR and \fBsname\fR options. -.IP "\fBmultiline\fR" 4 +.IP \fBmultiline\fR 4 .IX Item "multiline" Display the name using multiple lines. It is equivalent to \fBesc_ctrl\fR, \fBesc_msb\fR, \fBsep_multiline\fR, \fBspace_eq\fR, \&\fBlname\fR and \fBalign\fR. -.IP "\fBesc_2253\fR" 4 +.IP \fBesc_2253\fR 4 .IX Item "esc_2253" -Escape the \*(L"special\*(R" characters in a field, as required by \s-1RFC 2253.\s0 +Escape the "special" characters in a field, as required by RFC 2253. That is, any of the characters \f(CW\*(C`,+"<>;\*(C'\fR, \f(CW\*(C`#\*(C'\fR at the beginning of a string and leading or trailing spaces. -.IP "\fBesc_2254\fR" 4 +.IP \fBesc_2254\fR 4 .IX Item "esc_2254" -Escape the \*(L"special\*(R" characters in a field as required by \s-1RFC 2254\s0 in a field. -That is, the \fB\s-1NUL\s0\fR character and of \f(CW\*(C`()*\*(C'\fR. -.IP "\fBesc_ctrl\fR" 4 +Escape the "special" characters in a field as required by RFC 2254 in a field. +That is, the \fBNUL\fR character and of \f(CW\*(C`()*\*(C'\fR. +.IP \fBesc_ctrl\fR 4 .IX Item "esc_ctrl" -Escape non-printable \s-1ASCII\s0 characters, codes less than 0x20 (space) -or greater than 0x7F (\s-1DELETE\s0). They are displayed using \s-1RFC 2253\s0 \f(CW\*(C`\eXX\*(C'\fR -notation where \fB\s-1XX\s0\fR are the two hex digits representing the character value. -.IP "\fBesc_msb\fR" 4 +Escape non-printable ASCII characters, codes less than 0x20 (space) +or greater than 0x7F (DELETE). They are displayed using RFC 2253 \f(CW\*(C`\eXX\*(C'\fR +notation where \fBXX\fR are the two hex digits representing the character value. +.IP \fBesc_msb\fR 4 .IX Item "esc_msb" Escape any characters with the most significant bit set, that is with values larger than 127, as described in \fBesc_ctrl\fR. -.IP "\fBuse_quote\fR" 4 +.IP \fBuse_quote\fR 4 .IX Item "use_quote" Escapes some characters by surrounding the entire string with quotation marks, \f(CW\*(C`"\*(C'\fR. Without this option, individual special characters are preceded with a backslash character, \f(CW\*(C`\e\*(C'\fR. -.IP "\fButf8\fR" 4 +.IP \fButf8\fR 4 .IX Item "utf8" -Convert all strings to \s-1UTF\-8\s0 format first as required by \s-1RFC 2253.\s0 -If the output device is \s-1UTF\-8\s0 compatible, then using this option (and +Convert all strings to UTF\-8 format first as required by RFC 2253. +If the output device is UTF\-8 compatible, then using this option (and not setting \fBesc_msb\fR) may give the correct display of multibyte characters. If this option is not set, then multibyte characters larger than 0xFF will be output as \f(CW\*(C`\eUXXXX\*(C'\fR for 16 bits or \f(CW\*(C`\eWXXXXXXXX\*(C'\fR for 32 bits. In addition, any UTF8Strings will be converted to their character form first. -.IP "\fBignore_type\fR" 4 +.IP \fBignore_type\fR 4 .IX Item "ignore_type" This option does not attempt to interpret multibyte characters in any way. That is, the content octets are merely dumped as though one octet represents each character. This is useful for diagnostic purposes but will result in rather odd looking output. -.IP "\fBshow_type\fR" 4 +.IP \fBshow_type\fR 4 .IX Item "show_type" -Display the type of the \s-1ASN1\s0 character string before the value, +Display the type of the ASN1 character string before the value, such as \f(CW\*(C`BMPSTRING: Hello World\*(C'\fR. -.IP "\fBdump_der\fR" 4 +.IP \fBdump_der\fR 4 .IX Item "dump_der" Any fields that would be output in hex format are displayed using -the \s-1DER\s0 encoding of the field. +the DER encoding of the field. If not set, just the content octets are displayed. -Either way, the \fB#XXXX...\fR format of \s-1RFC 2253\s0 is used. -.IP "\fBdump_nostr\fR" 4 +Either way, the \fB#XXXX...\fR format of RFC 2253 is used. +.IP \fBdump_nostr\fR 4 .IX Item "dump_nostr" -Dump non-character strings, such as \s-1ASN.1\s0 \fB\s-1OCTET STRING\s0\fR. +Dump non-character strings, such as ASN.1 \fBOCTET STRING\fR. If this option is not set, then non character string types will be displayed as though each content octet represents a single character. -.IP "\fBdump_all\fR" 4 +.IP \fBdump_all\fR 4 .IX Item "dump_all" Dump all fields. When this used with \fBdump_der\fR, this allows the -\&\s-1DER\s0 encoding of the structure to be unambiguously determined. -.IP "\fBdump_unknown\fR" 4 +DER encoding of the structure to be unambiguously determined. +.IP \fBdump_unknown\fR 4 .IX Item "dump_unknown" -Dump any field whose \s-1OID\s0 is not recognised by OpenSSL. +Dump any field whose OID is not recognised by OpenSSL. .IP "\fBsep_comma_plus\fR, \fBsep_comma_plus_space\fR, \fBsep_semi_plus_space\fR, \fBsep_multiline\fR" 4 .IX Item "sep_comma_plus, sep_comma_plus_space, sep_semi_plus_space, sep_multiline" Specify the field separators. The first word is used between the Relative Distinguished Names (RDNs) and the second is between multiple Attribute Value Assertions (AVAs). Multiple AVAs are very rare and their use is discouraged. -The options ending in \*(L"space\*(R" additionally place a space after the separator to make it more readable. -The \fBsep_multiline\fR starts each field on its own line, and uses \*(L"plus space\*(R" -for the \s-1AVA\s0 separator. +The options ending in "space" additionally place a space after the separator to make it more readable. +The \fBsep_multiline\fR starts each field on its own line, and uses "plus space" +for the AVA separator. It also indents the fields by four characters. The default value is \fBsep_comma_plus_space\fR. -.IP "\fBdn_rev\fR" 4 +.IP \fBdn_rev\fR 4 .IX Item "dn_rev" -Reverse the fields of the \s-1DN\s0 as required by \s-1RFC 2253.\s0 +Reverse the fields of the DN as required by RFC 2253. This also reverses the order of multiple AVAs in a field, but this is permissible as there is no ordering on values. .IP "\fBnofname\fR, \fBsname\fR, \fBlname\fR, \fBoid\fR" 4 .IX Item "nofname, sname, lname, oid" Specify how the field name is displayed. \&\fBnofname\fR does not display the field at all. -\&\fBsname\fR uses the \*(L"short name\*(R" form (\s-1CN\s0 for commonName for example). +\&\fBsname\fR uses the "short name" form (CN for commonName for example). \&\fBlname\fR uses the long form. -\&\fBoid\fR represents the \s-1OID\s0 in numerical form and is useful for +\&\fBoid\fR represents the OID in numerical form and is useful for diagnostic purpose. -.IP "\fBalign\fR" 4 +.IP \fBalign\fR 4 .IX Item "align" Align field values for a more readable output. Only usable with \&\fBsep_multiline\fR. -.IP "\fBspace_eq\fR" 4 +.IP \fBspace_eq\fR 4 .IX Item "space_eq" Places spaces round the equal sign, \f(CW\*(C`=\*(C'\fR, character which follows the field name. -.SH "COPYRIGHT" +.SH COPYRIGHT .IX Header "COPYRIGHT" -Copyright 2000\-2020 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2000\-2025 The OpenSSL Project Authors. All Rights Reserved. .PP -Licensed under the Apache License 2.0 (the \*(L"License\*(R"). You may not use +Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy -in the file \s-1LICENSE\s0 in the source distribution or at +in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>. |