diff options
| author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2020-09-02 14:18:34 +0200 |
|---|---|---|
| committer | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2020-09-10 12:07:33 +0200 |
| commit | 2aa91df406a8c907b53d01773b1b860117542c48 (patch) | |
| tree | fb747970ad7adf2ecfd40a0c0f7fa27dbb4e20a4 /doc | |
| parent | X509_NAME_print_ex.pod: re-format lines to fit within 80 chars limit (diff) | |
| download | openssl-2aa91df406a8c907b53d01773b1b860117542c48.tar.xz openssl-2aa91df406a8c907b53d01773b1b860117542c48.zip | |
X509_NAME_oneline(): Fix output of multi-valued RDNs, escaping '/' and '+' in values
Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org>
(Merged from https://github.com/openssl/openssl/pull/12769)
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/man3/X509_NAME_print_ex.pod | 23 |
1 files changed, 12 insertions, 11 deletions
diff --git a/doc/man3/X509_NAME_print_ex.pod b/doc/man3/X509_NAME_print_ex.pod index e5bdf1d582..ccb4b5629a 100644 --- a/doc/man3/X509_NAME_print_ex.pod +++ b/doc/man3/X509_NAME_print_ex.pod @@ -18,27 +18,28 @@ X509_NAME_oneline - X509_NAME printing routines =head1 DESCRIPTION -X509_NAME_print_ex() prints a human readable version of B<nm> to BIO B<out>. -Each line (for multiline formats) is indented by B<indent> spaces. The -output format can be extensively customised by use of the B<flags> parameter. +X509_NAME_print_ex() prints a human readable version of I<nm> to BIO I<out>. +Each line (for multiline formats) is indented by I<indent> spaces. The +output format can be extensively customised by use of the I<flags> parameter. X509_NAME_print_ex_fp() is identical to X509_NAME_print_ex() -except the output is written to FILE pointer B<fp>. +except the output is written to FILE pointer I<fp>. -X509_NAME_oneline() prints an ASCII version of B<a> to B<buf>. -If B<buf> is B<NULL> then a buffer is dynamically allocated and returned, and -B<size> is ignored. -Otherwise, at most B<size> bytes will be written, including the ending '\0', -and B<buf> is returned. +X509_NAME_oneline() prints an ASCII version of I<a> to I<buf>. +This supports multi-valued RDNs and escapes B</> and B<+> characters in values. +If I<buf> is B<NULL> then a buffer is dynamically allocated and returned, and +I<size> is ignored. +Otherwise, at most I<size> bytes will be written, including the ending '\0', +and I<buf> is returned. -X509_NAME_print() prints out B<name> to B<bp> indenting each line by B<obase> +X509_NAME_print() prints out I<name> to I<bp> indenting each line by I<obase> characters. Multiple lines are used if the output (including indent) exceeds 80 characters. =head1 NOTES The functions X509_NAME_oneline() and X509_NAME_print() -produce a non standard output form, they don't handle multi character fields and +produce a non standard output form, they don't handle multi-character fields and have various quirks and inconsistencies. Their use is strongly discouraged in new applications and they could be deprecated in a future release. |