xref: /freebsd/crypto/openssl/doc/man3/X509V3_EXT_print.pod (revision 10a428653ee7216475f1ddce3fb4cbf1200319f8)
1=pod
2
3=head1 NAME
4
5X509V3_EXT_print, X509V3_EXT_print_fp - pretty print X509 certificate extensions
6
7=head1 SYNOPSIS
8
9 #include <openssl/x509v3.h>
10
11 int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, unsigned long flag, int indent);
12 int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent);
13
14=head1 DESCRIPTION
15
16X509V3_EXT_print() and X509V3_EXT_print_fp() parse and print the extension
17info from I<ext> to I<bio> or I<out> with indentation set via I<indent>.
18I<flag> determines the behaviour if an extension could not be parsed and can be
19one of:
20B<X509V3_EXT_DEFAULT> (equivalent to 0): an unknown or unparsable extension
21stops the parsing and the function returns a failure.
22B<X509V3_EXT_PARSE_UNKNOWN>: an unknown or unparsable extension is handled by
23printing it through the B<ASN1_parse_dump()> function, and the function returns
24success.
25B<X509V3_EXT_DUMP_UNKNOWN>: an unknown or unparsable extension is handled by
26printing it through the B<BIO_dump_indent()> function, and the function returns
27success,
28B<X509V3_EXT_ERROR_UNKNOWN>: an unknown or unparsable extension is handled by
29printing either "<Not Supported>" or  "<Parse Error>", and the function returns
30success.
31
32=head1 RETURN VALUES
33
34X509V3_EXT_print() and X509V3_EXT_print_fp() return 1 for success and 0 for
35failure.
36
37=head1 SEE ALSO
38
39L<BIO_dump_indent(3)>,
40L<ASN1_parse_dump(3)>,
41
42=head1 COPYRIGHT
43
44Copyright 2026 The OpenSSL Project Authors. All Rights Reserved.
45
46Licensed under the Apache License 2.0 (the "License").  You may not use
47this file except in compliance with the License.  You can obtain a copy
48in the file LICENSE in the source distribution or at
49L<https://www.openssl.org/source/license.html>.
50
51=cut
52