summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/X509_REQ_print_ex.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/X509_REQ_print_ex.3')
-rw-r--r--src/lib/libcrypto/man/X509_REQ_print_ex.3173
1 files changed, 0 insertions, 173 deletions
diff --git a/src/lib/libcrypto/man/X509_REQ_print_ex.3 b/src/lib/libcrypto/man/X509_REQ_print_ex.3
deleted file mode 100644
index eee06abb21..0000000000
--- a/src/lib/libcrypto/man/X509_REQ_print_ex.3
+++ /dev/null
@@ -1,173 +0,0 @@
1.\" $OpenBSD: X509_REQ_print_ex.3,v 1.3 2025/03/09 14:02:46 tb Exp $
2.\"
3.\" Copyright (c) 2021 Ingo Schwarze <schwarze@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: March 9 2025 $
18.Dt X509_REQ_PRINT_EX 3
19.Os
20.Sh NAME
21.Nm X509_REQ_print_ex ,
22.Nm X509_REQ_print ,
23.Nm X509_REQ_print_fp
24.Nd pretty-print a PKCS#10 certification request
25.Sh SYNOPSIS
26.Ft int
27.Fo X509_REQ_print_ex
28.Fa "BIO *bio"
29.Fa "X509_REQ *req"
30.Fa "unsigned long nameflags"
31.Fa "unsigned long skipflags"
32.Fc
33.Ft int
34.Fo X509_REQ_print
35.Fa "BIO *bio"
36.Fa "X509_REQ *req"
37.Fc
38.Ft int
39.Fo X509_REQ_print_fp
40.Fa "FILE *fp"
41.Fa "X509_REQ *req"
42.Fc
43.Sh DESCRIPTION
44.Fn X509_REQ_print_ex
45prints information contained in
46.Fa req
47to
48.Fa bio
49in human-readable form.
50Printing is aborted as soon as any operation fails, with the exception
51that failures while attempting to decode or print the public key
52are not considered as errors.
53.Pp
54By default, the following blocks of information
55are printed in the following order.
56Each block can be skipped by setting the corresponding bit in
57.Fa skipflags ,
58provided in parentheses after each block description.
59.Bl -bullet
60.It
61A pair of lines reading
62.Qq Certificate Request:\&
63and
64.Qq Data:\&
65containing no information.
66.Pq Dv X509_FLAG_NO_HEADER
67.It
68The value contained in the version field
69in decimal and hexadecimal notation.
70.Pq Dv X509_FLAG_NO_VERSION
71.It
72The subject name is printed with
73.Xr X509_NAME_print_ex 3 .
74.Pq Dv X509_FLAG_NO_SUBJECT
75.It
76The public key algorithm is printed with
77.Xr i2a_ASN1_OBJECT 3 ,
78and the public key returned from
79.Xr X509_REQ_get_pubkey 3
80with
81.Xr EVP_PKEY_print_public 3 .
82.Pq Dv X509_FLAG_NO_PUBKEY
83.It
84For each X.501 attribute that is not a requested extension according to
85.Xr X509_REQ_extension_nid 3 ,
86the object identifier is printed with
87.Xr i2a_ASN1_OBJECT 3 ,
88and all values of the types
89.Dv V_ASN1_PRINTABLESTRING ,
90.Dv V_ASN1_T61STRING ,
91and
92.Dv V_ASN1_IA5STRING
93are printed with
94.Xr BIO_write 3 .
95.Pq Dv X509_FLAG_NO_ATTRIBUTES
96.It
97The requested extensions are retrieved with
98.Xr X509_REQ_get_extensions 3
99and their types and values are printed with
100.Xr i2a_ASN1_OBJECT 3
101and
102.Xr X509V3_EXT_print 3 ,
103or, if the latter fails, with
104.Xr ASN1_STRING_print 3 .
105.Pq Dv X509_FLAG_NO_EXTENSIONS
106.It
107The signature is printed with
108.Xr X509_signature_print 3 .
109.Pq Dv X509_FLAG_NO_SIGDUMP
110.El
111.Pp
112The
113.Fa nameflags
114argument modifies the format for printing X.501
115.Vt Name
116objects contained in
117.Fa req .
118It is passed through to
119.Xr X509_NAME_print_ex 3 .
120If
121.Fa nameflags
122is
123.Dv X509_FLAG_COMPAT ,
124the
125.Fa indent
126argument of
127.Xr X509_NAME_print_ex 3
128is set to 16 spaces and the traditional SSLeay format is used.
129Otherwise, if the only bit set in
130.Dv XN_FLAG_SEP_MASK
131is
132.Dv XN_FLAG_SEP_MULTILINE ,
133.Fa indent
134is set to 12 spaces.
135Otherwise, indent is set to zero.
136.Pp
137.Fn X509_REQ_print
138is a wrapper function setting the
139.Fa nameflags
140to
141.Dv XN_FLAG_COMPAT
142and the
143.Fa skipflags
144to
145.Dv X509_FLAG_COMPAT .
146.Pp
147.Fn X509_REQ_print_fp
148is similar to
149.Fn X509_REQ_print
150except that it prints to
151.Fa fp .
152.Sh RETURN VALUES
153These functions return 1 if all requested information was successfully
154printed, even if failures occurred while attempting to decode or
155print the public key, or 0 if any operation fails.
156.Sh SEE ALSO
157.Xr BIO_new 3 ,
158.Xr X509_print_ex 3 ,
159.Xr X509_REQ_new 3
160.Sh HISTORY
161.Fn X509_REQ_print
162first appeared in SSLeay 0.4.4 and
163.Fn X509_REQ_print_fp
164in SSLeay 0.6.0.
165These functions have been available since
166.Ox 2.4 .
167.Pp
168.Fn X509_REQ_print_ex
169first appeared in OpenSSL 0.9.7 and has been available since
170.Ox 3.2 .
171.Sh BUGS
172Some printing failures are silently ignored while printing extensions,
173which may result in incomplete data being printed.
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-05-06 18:26:11 +0000