Debian Codegraph @

upstream/debian-unstable/man3/X509V3_EXT_print.3ssl

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "X509V3_EXT_PRINT 3SSL"
58 .TH X509V3_EXT_PRINT 3SSL 2026-04-07 3.6.2 OpenSSL
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 X509V3_EXT_print, X509V3_EXT_print_fp \- pretty print X509 certificate extensions
65 .SH SYNOPSIS
66 .IX Header "SYNOPSIS"
67 .Vb 1
68 \& #include <openssl/x509v3.h>
69 \&
70 \& int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, unsigned long flag, int indent);
71 \& int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent);
72 .Ve
73 .SH DESCRIPTION
74 .IX Header "DESCRIPTION"
75 \&\fBX509V3_EXT_print()\fR and \fBX509V3_EXT_print_fp()\fR parse and print the extension
76 info from \fIext\fR to \fIbio\fR or \fIout\fR with indentation set via \fIindent\fR.
77 \&\fIflag\fR determines the behaviour if an extension could not be parsed and can be
78 one of:
79 \&\fBX509V3_EXT_DEFAULT\fR (equivalent to 0): an unknown or unparsable extension
80 stops the parsing and the function returns a failure.
81 \&\fBX509V3_EXT_PARSE_UNKNOWN\fR: an unknown or unparsable extension is handled by
82 printing it through the \fBASN1_parse_dump()\fR function, and the function returns
83 success.
84 \&\fBX509V3_EXT_DUMP_UNKNOWN\fR: an unknown or unparsable extension is handled by
85 printing it through the \fBBIO_dump_indent()\fR function, and the function returns
86 success,
87 \&\fBX509V3_EXT_ERROR_UNKNOWN\fR: an unknown or unparsable extension is handled by
88 printing either "<Not Supported>" or "<Parse Error>", and the function returns
89 success.
90 .SH "RETURN VALUES"
91 .IX Header "RETURN VALUES"
92 \&\fBX509V3_EXT_print()\fR and \fBX509V3_EXT_print_fp()\fR return 1 for success and 0 for
93 failure.
94 .SH "SEE ALSO"
95 .IX Header "SEE ALSO"
96 \&\fBBIO_dump_indent\fR\|(3),
97 \&\fBASN1_parse_dump\fR\|(3),
98 .SH COPYRIGHT
99 .IX Header "COPYRIGHT"
100 Copyright 2026 The OpenSSL Project Authors. All Rights Reserved.
101 .PP
102 Licensed under the Apache License 2.0 (the "License"). You may not use
103 this file except in compliance with the License. You can obtain a copy
104 in the file LICENSE in the source distribution or at
105 <https://www.openssl.org/source/license.html>.