summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authortb <>2025-03-09 14:02:46 +0000
committertb <>2025-03-09 14:02:46 +0000
commita8bc62283dde492a8b24ae55cd59375ad3bffae7 (patch)
tree61cefd5f8e4cba3cede0bcdbe7f290a5528915db
parent6d5eefbfffc4b4c846a1b946ad7cbee1df3a046e (diff)
downloadopenbsd-a8bc62283dde492a8b24ae55cd59375ad3bffae7.tar.gz
openbsd-a8bc62283dde492a8b24ae55cd59375ad3bffae7.tar.bz2
openbsd-a8bc62283dde492a8b24ae55cd59375ad3bffae7.zip
Remove mention of X509_NAME_print(3) in the docs
-rw-r--r--src/lib/libcrypto/man/X509_NAME_print_ex.343
-rw-r--r--src/lib/libcrypto/man/X509_REQ_print_ex.38
-rw-r--r--src/lib/libcrypto/man/X509_print_ex.38
3 files changed, 13 insertions, 46 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
diff --git a/src/lib/libcrypto/man/X509_REQ_print_ex.3 b/src/lib/libcrypto/man/X509_REQ_print_ex.3
index b8fb690cc7..eee06abb21 100644
--- a/src/lib/libcrypto/man/X509_REQ_print_ex.3
+++ b/src/lib/libcrypto/man/X509_REQ_print_ex.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_REQ_print_ex.3,v 1.2 2021/11/19 15:50:46 schwarze Exp $ 1.\" $OpenBSD: X509_REQ_print_ex.3,v 1.3 2025/03/09 14:02:46 tb Exp $
2.\" 2.\"
3.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org> 3.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org>
4.\" 4.\"
@@ -14,7 +14,7 @@
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\" 16.\"
17.Dd $Mdocdate: November 19 2021 $ 17.Dd $Mdocdate: March 9 2025 $
18.Dt X509_REQ_PRINT_EX 3 18.Dt X509_REQ_PRINT_EX 3
19.Os 19.Os
20.Sh NAME 20.Sh NAME
@@ -125,9 +125,7 @@ the
125.Fa indent 125.Fa indent
126argument of 126argument of
127.Xr X509_NAME_print_ex 3 127.Xr X509_NAME_print_ex 3
128is set to 16 spaces and the traditional SSLeay format generated by 128is set to 16 spaces and the traditional SSLeay format is used.
129.Xr X509_NAME_print 3
130is used.
131Otherwise, if the only bit set in 129Otherwise, if the only bit set in
132.Dv XN_FLAG_SEP_MASK 130.Dv XN_FLAG_SEP_MASK
133is 131is
diff --git a/src/lib/libcrypto/man/X509_print_ex.3 b/src/lib/libcrypto/man/X509_print_ex.3
index 1a2e0edbdf..c769e77c32 100644
--- a/src/lib/libcrypto/man/X509_print_ex.3
+++ b/src/lib/libcrypto/man/X509_print_ex.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_print_ex.3,v 1.4 2021/10/29 09:42:07 schwarze Exp $ 1.\" $OpenBSD: X509_print_ex.3,v 1.5 2025/03/09 14:02:46 tb Exp $
2.\" 2.\"
3.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org> 3.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org>
4.\" 4.\"
@@ -14,7 +14,7 @@
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\" 16.\"
17.Dd $Mdocdate: October 29 2021 $ 17.Dd $Mdocdate: March 9 2025 $
18.Dt X509_PRINT_EX 3 18.Dt X509_PRINT_EX 3
19.Os 19.Os
20.Sh NAME 20.Sh NAME
@@ -163,9 +163,7 @@ the
163.Fa indent 163.Fa indent
164argument of 164argument of
165.Xr X509_NAME_print_ex 3 165.Xr X509_NAME_print_ex 3
166is set to 16 spaces and the traditional SSLeay format generated by 166is set to 16 spaces and the traditional SSLeay format is used.
167.Xr X509_NAME_print 3
168is used.
169Otherwise, if the only bit set in 167Otherwise, if the only bit set in
170.Dv XN_FLAG_SEP_MASK 168.Dv XN_FLAG_SEP_MASK
171is 169is