| ASN1_STRING_print_ex.3 (273399) | ASN1_STRING_print_ex.3 (279264) |
|---|---|
| 1.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.28) | 1.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28) |
| 2.\" 3.\" Standard preamble: 4.\" ======================================================================== 5.de Sp \" Vertical space (when we can't use .PP) 6.if t .sp .5v 7.if n .sp 8.. 9.de Vb \" Begin verbatim text --- 23 unchanged lines hidden (view full) --- 33. ds C` "" 34. ds C' "" 35'br\} 36.el\{\ 37. ds -- \|\(em\| 38. ds PI \(*p 39. ds L" `` 40. ds R" '' | 2.\" 3.\" Standard preamble: 4.\" ======================================================================== 5.de Sp \" Vertical space (when we can't use .PP) 6.if t .sp .5v 7.if n .sp 8.. 9.de Vb \" Begin verbatim text --- 23 unchanged lines hidden (view full) --- 33. ds C` "" 34. ds C' "" 35'br\} 36.el\{\ 37. ds -- \|\(em\| 38. ds PI \(*p 39. ds L" `` 40. ds R" '' |
| 41. ds C` 42. ds C' |
|
| 41'br\} 42.\" 43.\" Escape single quotes in literal strings from groff's Unicode transform. 44.ie \n(.g .ds Aq \(aq 45.el .ds Aq ' 46.\" 47.\" If the F register is turned on, we'll generate index entries on stderr for 48.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index 49.\" entries marked with X<> in POD. Of course, you'll have to process the 50.\" output yourself in some meaningful fashion. | 43'br\} 44.\" 45.\" Escape single quotes in literal strings from groff's Unicode transform. 46.ie \n(.g .ds Aq \(aq 47.el .ds Aq ' 48.\" 49.\" If the F register is turned on, we'll generate index entries on stderr for 50.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index 51.\" entries marked with X<> in POD. Of course, you'll have to process the 52.\" output yourself in some meaningful fashion. |
| 51.ie \nF \{\ 52. de IX 53. tm Index:\\$1\t\\n%\t"\\$2" | 53.\" 54.\" Avoid warning from groff about undefined register 'F'. 55.de IX |
| 54.. | 56.. |
| 55. nr % 0 56. rr F 57.\} 58.el \{\ 59. de IX | 57.nr rF 0 58.if \n(.g .if rF .nr rF 1 59.if (\n(rF:(\n(.g==0)) \{ 60. if \nF \{ 61. de IX 62. tm Index:\\$1\t\\n%\t"\\$2" |
| 60.. | 63.. |
| 64. if !\nF==2 \{ 65. nr % 0 66. nr F 2 67. \} 68. \} |
|
| 61.\} | 69.\} |
| 70.rr rF |
|
| 62.\" 63.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). 64.\" Fear. Run. Save yourself. No user-serviceable parts. 65. \" fudge factors for nroff and troff 66.if n \{\ 67. ds #H 0 68. ds #V .8m 69. ds #F .3m --- 49 unchanged lines hidden (view full) --- 119. ds Th \o'LP' 120. ds ae ae 121. ds Ae AE 122.\} 123.rm #[ #] #H #V #F C 124.\" ======================================================================== 125.\" 126.IX Title "ASN1_STRING_print_ex 3" | 71.\" 72.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). 73.\" Fear. Run. Save yourself. No user-serviceable parts. 74. \" fudge factors for nroff and troff 75.if n \{\ 76. ds #H 0 77. ds #V .8m 78. ds #F .3m --- 49 unchanged lines hidden (view full) --- 128. ds Th \o'LP' 129. ds ae ae 130. ds Ae AE 131.\} 132.rm #[ #] #H #V #F C 133.\" ======================================================================== 134.\" 135.IX Title "ASN1_STRING_print_ex 3" |
| 127.TH ASN1_STRING_print_ex 3 "2014-10-15" "1.0.1j" "OpenSSL" | 136.TH ASN1_STRING_print_ex 3 "2015-01-15" "1.0.1l" "OpenSSL" |
| 128.\" For nroff, turn off justification. Always turn off hyphenation; it makes 129.\" way too many mistakes in technical documents. 130.if n .ad l 131.nh 132.SH "NAME" 133ASN1_STRING_print_ex, ASN1_STRING_print_ex_fp \- ASN1_STRING output routines. 134.SH "SYNOPSIS" 135.IX Header "SYNOPSIS" --- 9 unchanged lines hidden (view full) --- 145These functions output an \fB\s-1ASN1_STRING\s0\fR structure. \fB\s-1ASN1_STRING\s0\fR is used to 146represent all the \s-1ASN1\s0 string types. 147.PP 148\&\fIASN1_STRING_print_ex()\fR outputs \fBstr\fR to \fBout\fR, the format is determined by 149the options \fBflags\fR. \fIASN1_STRING_print_ex_fp()\fR is identical except it outputs 150to \fBfp\fR instead. 151.PP 152\&\fIASN1_STRING_print()\fR prints \fBstr\fR to \fBout\fR but using a different format to | 137.\" For nroff, turn off justification. Always turn off hyphenation; it makes 138.\" way too many mistakes in technical documents. 139.if n .ad l 140.nh 141.SH "NAME" 142ASN1_STRING_print_ex, ASN1_STRING_print_ex_fp \- ASN1_STRING output routines. 143.SH "SYNOPSIS" 144.IX Header "SYNOPSIS" --- 9 unchanged lines hidden (view full) --- 154These functions output an \fB\s-1ASN1_STRING\s0\fR structure. \fB\s-1ASN1_STRING\s0\fR is used to 155represent all the \s-1ASN1\s0 string types. 156.PP 157\&\fIASN1_STRING_print_ex()\fR outputs \fBstr\fR to \fBout\fR, the format is determined by 158the options \fBflags\fR. \fIASN1_STRING_print_ex_fp()\fR is identical except it outputs 159to \fBfp\fR instead. 160.PP 161\&\fIASN1_STRING_print()\fR prints \fBstr\fR to \fBout\fR but using a different format to |
| 153\&\fIASN1_STRING_print_ex()\fR. It replaces unprintable characters (other than \s-1CR\s0, \s-1LF\s0) | 162\&\fIASN1_STRING_print_ex()\fR. It replaces unprintable characters (other than \s-1CR, LF\s0) |
| 154with '.'. 155.SH "NOTES" 156.IX Header "NOTES" 157\&\fIASN1_STRING_print()\fR is a legacy function which should be avoided in new applications. 158.PP 159Although there are a large number of options frequently \fB\s-1ASN1_STRFLGS_RFC2253\s0\fR is | 163with '.'. 164.SH "NOTES" 165.IX Header "NOTES" 166\&\fIASN1_STRING_print()\fR is a legacy function which should be avoided in new applications. 167.PP 168Although there are a large number of options frequently \fB\s-1ASN1_STRFLGS_RFC2253\s0\fR is |
| 160suitable, or on \s-1UTF8\s0 terminals \fB\s-1ASN1_STRFLGS_RFC2253\s0 & ~ASN1_STRFLGS_ESC_MSB\fR. | 169suitable, or on \s-1UTF8\s0 terminals \fB\s-1ASN1_STRFLGS_RFC2253 &\s0 ~ASN1_STRFLGS_ESC_MSB\fR. |
| 161.PP 162The complete set of supported options for \fBflags\fR is listed below. 163.PP 164Various characters can be escaped. If \fB\s-1ASN1_STRFLGS_ESC_2253\s0\fR is set the characters 165determined by \s-1RFC2253\s0 are escaped. If \fB\s-1ASN1_STRFLGS_ESC_CTRL\s0\fR is set control 166characters are escaped. If \fB\s-1ASN1_STRFLGS_ESC_MSB\s0\fR is set characters with the 167\&\s-1MSB\s0 set are escaped: this option should \fBnot\fR be used if the terminal correctly 168interprets \s-1UTF8\s0 sequences. --- 15 unchanged lines hidden (view full) --- 184format first. If the terminal supports the display of \s-1UTF8\s0 sequences then this 185option will correctly display multi byte characters. 186.PP 187If \fB\s-1ASN1_STRFLGS_IGNORE_TYPE\s0\fR is set then the string type is not interpreted at 188all: everything is assumed to be one byte per character. This is primarily for 189debugging purposes and can result in confusing output in multi character strings. 190.PP 191If \fB\s-1ASN1_STRFLGS_SHOW_TYPE\s0\fR is set then the string type itself is printed out | 170.PP 171The complete set of supported options for \fBflags\fR is listed below. 172.PP 173Various characters can be escaped. If \fB\s-1ASN1_STRFLGS_ESC_2253\s0\fR is set the characters 174determined by \s-1RFC2253\s0 are escaped. If \fB\s-1ASN1_STRFLGS_ESC_CTRL\s0\fR is set control 175characters are escaped. If \fB\s-1ASN1_STRFLGS_ESC_MSB\s0\fR is set characters with the 176\&\s-1MSB\s0 set are escaped: this option should \fBnot\fR be used if the terminal correctly 177interprets \s-1UTF8\s0 sequences. --- 15 unchanged lines hidden (view full) --- 193format first. If the terminal supports the display of \s-1UTF8\s0 sequences then this 194option will correctly display multi byte characters. 195.PP 196If \fB\s-1ASN1_STRFLGS_IGNORE_TYPE\s0\fR is set then the string type is not interpreted at 197all: everything is assumed to be one byte per character. This is primarily for 198debugging purposes and can result in confusing output in multi character strings. 199.PP 200If \fB\s-1ASN1_STRFLGS_SHOW_TYPE\s0\fR is set then the string type itself is printed out |
| 192before its value (for example \*(L"\s-1BMPSTRING\s0\*(R"), this actually uses \fIASN1_tag2str()\fR. | 201before its value (for example \*(L"\s-1BMPSTRING\*(R"\s0), this actually uses \fIASN1_tag2str()\fR. |
| 193.PP 194The content of a string instead of being interpreted can be \*(L"dumped\*(R": this just 195outputs the value of the string using the form #XXXX using hex format for each 196octet. 197.PP 198If \fB\s-1ASN1_STRFLGS_DUMP_ALL\s0\fR is set then any type is dumped. 199.PP | 202.PP 203The content of a string instead of being interpreted can be \*(L"dumped\*(R": this just 204outputs the value of the string using the form #XXXX using hex format for each 205octet. 206.PP 207If \fB\s-1ASN1_STRFLGS_DUMP_ALL\s0\fR is set then any type is dumped. 208.PP |
| 200Normally non character string types (such as \s-1OCTET\s0 \s-1STRING\s0) are assumed to be | 209Normally non character string types (such as \s-1OCTET STRING\s0) are assumed to be |
| 201one byte per character, if \fB\s-1ASN1_STRFLGS_DUMP_UNKNOWN\s0\fR is set then they will 202be dumped instead. 203.PP 204When a type is dumped normally just the content octets are printed, if 205\&\fB\s-1ASN1_STRFLGS_DUMP_DER\s0\fR is set then the complete encoding is dumped 206instead (including tag and length octets). 207.PP | 210one byte per character, if \fB\s-1ASN1_STRFLGS_DUMP_UNKNOWN\s0\fR is set then they will 211be dumped instead. 212.PP 213When a type is dumped normally just the content octets are printed, if 214\&\fB\s-1ASN1_STRFLGS_DUMP_DER\s0\fR is set then the complete encoding is dumped 215instead (including tag and length octets). 216.PP |
| 208\&\fB\s-1ASN1_STRFLGS_RFC2253\s0\fR includes all the flags required by \s-1RFC2253\s0. It is | 217\&\fB\s-1ASN1_STRFLGS_RFC2253\s0\fR includes all the flags required by \s-1RFC2253.\s0 It is |
| 209equivalent to: 210 \s-1ASN1_STRFLGS_ESC_2253\s0 | \s-1ASN1_STRFLGS_ESC_CTRL\s0 | \s-1ASN1_STRFLGS_ESC_MSB\s0 | | 218equivalent to: 219 \s-1ASN1_STRFLGS_ESC_2253\s0 | \s-1ASN1_STRFLGS_ESC_CTRL\s0 | \s-1ASN1_STRFLGS_ESC_MSB\s0 | |
| 211 \s-1ASN1_STRFLGS_UTF8_CONVERT\s0 | \s-1ASN1_STRFLGS_DUMP_UNKNOWN\s0 \s-1ASN1_STRFLGS_DUMP_DER\s0 | 220 \s-1ASN1_STRFLGS_UTF8_CONVERT\s0 | \s-1ASN1_STRFLGS_DUMP_UNKNOWN ASN1_STRFLGS_DUMP_DER\s0 |
| 212.SH "SEE ALSO" 213.IX Header "SEE ALSO" 214\&\fIX509_NAME_print_ex\fR\|(3), 215\&\fIASN1_tag2str\fR\|(3) 216.SH "HISTORY" 217.IX Header "HISTORY" 218\&\s-1TBA\s0 | 221.SH "SEE ALSO" 222.IX Header "SEE ALSO" 223\&\fIX509_NAME_print_ex\fR\|(3), 224\&\fIASN1_tag2str\fR\|(3) 225.SH "HISTORY" 226.IX Header "HISTORY" 227\&\s-1TBA\s0 |