aboutsummaryrefslogtreecommitdiff
path: root/secure
diff options
context:
space:
mode:
authorEnji Cooper <ngie@FreeBSD.org>2026-04-09 02:00:10 +0000
committerEnji Cooper <ngie@FreeBSD.org>2026-04-09 02:00:10 +0000
commit9f7080ba6bcf18d013ae3b91dc9d92cfa731a8c0 (patch)
treeec9e0d469069ca6dfd7fc854cef3e77cb9762252 /secure
parent5254e16213ff1bb136ef24e0b0fe30625ac53563 (diff)
crypto/openssl: add new manpage from release 3.5.6HEADmain
MFC after: 1 day (the security issues warrant a quick backport). MFC with: 10a428653ee7216475f1ddce3fb4cbf1200319f8
Diffstat (limited to 'secure')
-rw-r--r--secure/lib/libcrypto/man/man3/Makefile2
-rw-r--r--secure/lib/libcrypto/man/man3/X509V3_EXT_print.3108
2 files changed, 110 insertions, 0 deletions
diff --git a/secure/lib/libcrypto/man/man3/Makefile b/secure/lib/libcrypto/man/man3/Makefile
index 172444fcb68c..8e81b1871d33 100644
--- a/secure/lib/libcrypto/man/man3/Makefile
+++ b/secure/lib/libcrypto/man/man3/Makefile
@@ -663,6 +663,7 @@ MAN+= X509_sign.3
MAN+= X509_verify.3
MAN+= X509_verify_cert.3
MAN+= X509v3_get_ext_by_NID.3
+MAN+= X509V3_EXT_print.3
MAN+= b2i_PVK_bio_ex.3
MAN+= d2i_PKCS8PrivateKey_bio.3
MAN+= d2i_PrivateKey.3
@@ -5615,6 +5616,7 @@ MLINKS+= X509v3_get_ext_by_NID.3 X509v3_get_ext.3
MLINKS+= X509v3_get_ext_by_NID.3 X509v3_get_ext_by_OBJ.3
MLINKS+= X509v3_get_ext_by_NID.3 X509v3_get_ext_by_critical.3
MLINKS+= X509v3_get_ext_by_NID.3 X509v3_get_ext_count.3
+MLINKS+= X509V3_EXT_print.3 X509V3_EXT_print_fp.3
MLINKS+= b2i_PVK_bio_ex.3 b2i_PVK_bio.3
MLINKS+= b2i_PVK_bio_ex.3 i2b_PVK_bio.3
MLINKS+= b2i_PVK_bio_ex.3 i2b_PVK_bio_ex.3
diff --git a/secure/lib/libcrypto/man/man3/X509V3_EXT_print.3 b/secure/lib/libcrypto/man/man3/X509V3_EXT_print.3
new file mode 100644
index 000000000000..f23dc989ae29
--- /dev/null
+++ b/secure/lib/libcrypto/man/man3/X509V3_EXT_print.3
@@ -0,0 +1,108 @@
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
+.ie n \{\
+. ds C` ""
+. ds C' ""
+'br\}
+.el\{\
+. ds C`
+. ds C'
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\"
+.\" If the F register is >0, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD. Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+. if \nF \{\
+. de IX
+. tm Index:\\$1\t\\n%\t"\\$2"
+..
+. if !\nF==2 \{\
+. nr % 0
+. nr F 2
+. \}
+. \}
+.\}
+.rr rF
+.\"
+.\" Required to disable full justification in groff 1.23.0.
+.if n .ds AD l
+.\" ========================================================================
+.\"
+.IX Title "X509V3_EXT_PRINT 3ossl"
+.TH X509V3_EXT_PRINT 3ossl 2026-04-07 3.5.6 OpenSSL
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH NAME
+X509V3_EXT_print, X509V3_EXT_print_fp \- pretty print X509 certificate extensions
+.SH SYNOPSIS
+.IX Header "SYNOPSIS"
+.Vb 1
+\& #include <openssl/x509v3.h>
+\&
+\& int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, unsigned long flag, int indent);
+\& int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent);
+.Ve
+.SH DESCRIPTION
+.IX Header "DESCRIPTION"
+\&\fBX509V3_EXT_print()\fR and \fBX509V3_EXT_print_fp()\fR parse and print the extension
+info from \fIext\fR to \fIbio\fR or \fIout\fR with indentation set via \fIindent\fR.
+\&\fIflag\fR determines the behaviour if an extension could not be parsed and can be
+one of:
+\&\fBX509V3_EXT_DEFAULT\fR (equivalent to 0): an unknown or unparsable extension
+stops the parsing and the function returns a failure.
+\&\fBX509V3_EXT_PARSE_UNKNOWN\fR: an unknown or unparsable extension is handled by
+printing it through the \fBASN1_parse_dump()\fR function, and the function returns
+success.
+\&\fBX509V3_EXT_DUMP_UNKNOWN\fR: an unknown or unparsable extension is handled by
+printing it through the \fBBIO_dump_indent()\fR function, and the function returns
+success,
+\&\fBX509V3_EXT_ERROR_UNKNOWN\fR: an unknown or unparsable extension is handled by
+printing either "<Not Supported>" or "<Parse Error>", and the function returns
+success.
+.SH "RETURN VALUES"
+.IX Header "RETURN VALUES"
+\&\fBX509V3_EXT_print()\fR and \fBX509V3_EXT_print_fp()\fR return 1 for success and 0 for
+failure.
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+\&\fBBIO_dump_indent\fR\|(3),
+\&\fBASN1_parse_dump\fR\|(3),
+.SH COPYRIGHT
+.IX Header "COPYRIGHT"
+Copyright 2026 The OpenSSL Project Authors. All Rights Reserved.
+.PP
+Licensed under the Apache License 2.0 (the "License"). You may not use
+this file except in compliance with the License. You can obtain a copy
+in the file LICENSE in the source distribution or at
+<https://www.openssl.org/source/license.html>.