summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/X509_NAME_print_ex.3
diff options
context:
space:
mode:
authortb <>2025-03-09 14:02:46 +0000
committertb <>2025-03-09 14:02:46 +0000
commita8bc62283dde492a8b24ae55cd59375ad3bffae7 (patch)
tree61cefd5f8e4cba3cede0bcdbe7f290a5528915db /src/lib/libcrypto/man/X509_NAME_print_ex.3
parent6d5eefbfffc4b4c846a1b946ad7cbee1df3a046e (diff)
downloadopenbsd-a8bc62283dde492a8b24ae55cd59375ad3bffae7.tar.gz
openbsd-a8bc62283dde492a8b24ae55cd59375ad3bffae7.tar.bz2
openbsd-a8bc62283dde492a8b24ae55cd59375ad3bffae7.zip
Remove mention of X509_NAME_print(3) in the docs
Diffstat (limited to 'src/lib/libcrypto/man/X509_NAME_print_ex.3')
-rw-r--r--src/lib/libcrypto/man/X509_NAME_print_ex.343
1 files changed, 7 insertions, 36 deletions
diff --git a/src/lib/libcrypto/man/X509_NAME_print_ex.3 b/src/lib/libcrypto/man/X509_NAME_print_ex.3
index f1b3262f2a..6634e6f585 100644
--- a/src/lib/libcrypto/man/X509_NAME_print_ex.3
+++ b/src/lib/libcrypto/man/X509_NAME_print_ex.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_NAME_print_ex.3,v 1.14 2025/01/08 00:08:02 tb Exp $ 1.\" $OpenBSD: X509_NAME_print_ex.3,v 1.15 2025/03/09 14:02:46 tb Exp $
2.\" full merge up to: OpenSSL aebb9aac Jul 19 09:27:53 2016 -0400 2.\" full merge up to: OpenSSL aebb9aac Jul 19 09:27:53 2016 -0400
3.\" selective merge up to: OpenSSL 61f805c1 Jan 16 01:01:46 2018 +0800 3.\" selective merge up to: OpenSSL 61f805c1 Jan 16 01:01:46 2018 +0800
4.\" 4.\"
@@ -50,14 +50,13 @@
50.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 50.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
51.\" OF THE POSSIBILITY OF SUCH DAMAGE. 51.\" OF THE POSSIBILITY OF SUCH DAMAGE.
52.\" 52.\"
53.Dd $Mdocdate: January 8 2025 $ 53.Dd $Mdocdate: March 9 2025 $
54.Dt X509_NAME_PRINT_EX 3 54.Dt X509_NAME_PRINT_EX 3
55.Os 55.Os
56.Sh NAME 56.Sh NAME
57.Nm X509_NAME_print_ex , 57.Nm X509_NAME_print_ex ,
58.Nm X509_NAME_print_ex_fp , 58.Nm X509_NAME_print_ex_fp ,
59.Nm X509_NAME_oneline , 59.Nm X509_NAME_oneline ,
60.Nm X509_NAME_print
61.Nd X509_NAME printing routines 60.Nd X509_NAME printing routines
62.Sh SYNOPSIS 61.Sh SYNOPSIS
63.In openssl/x509.h 62.In openssl/x509.h
@@ -81,12 +80,6 @@
81.Fa "char *buf" 80.Fa "char *buf"
82.Fa "int size" 81.Fa "int size"
83.Fc 82.Fc
84.Ft int
85.Fo X509_NAME_print
86.Fa "BIO *bp"
87.Fa "const X509_NAME *name"
88.Fa "int obase"
89.Fc
90.Sh DESCRIPTION 83.Sh DESCRIPTION
91.Fn X509_NAME_print_ex 84.Fn X509_NAME_print_ex
92prints a human readable version of 85prints a human readable version of
@@ -127,24 +120,11 @@ bytes will be written, including the ending NUL, and
127.Fa buf 120.Fa buf
128is returned. 121is returned.
129.Pp 122.Pp
130.Fn X509_NAME_print
131prints out
132.Fa name
133to
134.Fa bp .
135The
136.Fa obase
137argument is intended to indent the output,
138it is however ignored.
139.Pp
140The functions
141.Fn X509_NAME_oneline 123.Fn X509_NAME_oneline
142and 124is a legacy functions which produce a non-standard output form.
143.Fn X509_NAME_print 125It doesn't handle multi-character fields and has various quirks
144are legacy functions which produce a non-standard output form.
145They don't handle multi-character fields and have various quirks
146and inconsistencies. 126and inconsistencies.
147Their use is strongly discouraged in new applications. 127Its use is strongly discouraged in new applications.
148.Pp 128.Pp
149Although there are a large number of possible flags, for most purposes 129Although there are a large number of possible flags, for most purposes
150.Dv XN_FLAG_ONELINE , 130.Dv XN_FLAG_ONELINE ,
@@ -247,11 +227,7 @@ is a multiline format which is the same as:
247.Dv XN_FLAG_SPC_EQ | XN_FLAG_FN_LN | XN_FLAG_FN_ALIGN . 227.Dv XN_FLAG_SPC_EQ | XN_FLAG_FN_LN | XN_FLAG_FN_ALIGN .
248.Pp 228.Pp
249.Dv XN_FLAG_COMPAT 229.Dv XN_FLAG_COMPAT
250uses a format identical to 230uses the traditional non-standard SSLeay format.
251.Fn X509_NAME_print :
252in fact it calls
253.Fn X509_NAME_print
254internally.
255.Sh RETURN VALUES 231.Sh RETURN VALUES
256.Fn X509_NAME_print_ex 232.Fn X509_NAME_print_ex
257and 233and
@@ -267,9 +243,6 @@ indentation or \-1 on error.
267returns a valid string on success or 243returns a valid string on success or
268.Dv NULL 244.Dv NULL
269on error. 245on error.
270.Pp
271.Fn X509_NAME_print
272returns 1 on success or 0 on error.
273.Sh SEE ALSO 246.Sh SEE ALSO
274.Xr ASN1_STRING_print_ex 3 , 247.Xr ASN1_STRING_print_ex 3 ,
275.Xr d2i_X509_NAME 3 , 248.Xr d2i_X509_NAME 3 ,
@@ -277,9 +250,7 @@ returns 1 on success or 0 on error.
277.Xr X509_NAME_new 3 250.Xr X509_NAME_new 3
278.Sh HISTORY 251.Sh HISTORY
279.Fn X509_NAME_oneline 252.Fn X509_NAME_oneline
280and 253first appeared in SSLeay 0.5.1 and has been available since
281.Fn X509_NAME_print
282first appeared in SSLeay 0.5.1 and have been available since
283.Ox 2.4 . 254.Ox 2.4 .
284.Pp 255.Pp
285.Fn X509_NAME_print_ex 256.Fn X509_NAME_print_ex