From 37505fe2ae0468046648c9b39a11860c7926a6d7 Mon Sep 17 00:00:00 2001
From: tb <tb@openbsd.org>
Date: Thu, 18 Aug 2022 18:42:13 +0000
Subject: [PATCH] Adjust signatures of BIO_ctrl functions

In bio.h r1.54, the signature of BIO_callback_ctrl() was changed from
bio_info_cb to BIO_info_cb. Adjust manual to reflect this change.

At the moment, bio_info_cb and BIO_info_cb are still distinct types with
our BIO_info_cb matching OpenSSL's definition. Historically, bio_info_cb
had a different type, but that leads to issues with casting function
pointers. The ecosystem has moved on to embrace the new type and several
ports confuse the two types because OpenSSL decided to "solve" the issues
with "typedef BIO_info_cb bio_info_cb; /* backward compatibilty */". We
will align with this in the next bump.

ok jsing
---
 lib/libcrypto/man/BIO_ctrl.3 | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/lib/libcrypto/man/BIO_ctrl.3 b/lib/libcrypto/man/BIO_ctrl.3
index 24265c03187..762d45a5ed0 100644
--- a/lib/libcrypto/man/BIO_ctrl.3
+++ b/lib/libcrypto/man/BIO_ctrl.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: BIO_ctrl.3,v 1.15 2020/12/03 22:47:21 jmc Exp $
+.\"	$OpenBSD: BIO_ctrl.3,v 1.16 2022/08/18 18:42:13 tb Exp $
 .\"	OpenSSL b055fceb Thu Oct 20 09:56:18 2016 +0100
 .\"
 .\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
@@ -48,7 +48,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: December 3 2020 $
+.Dd $Mdocdate: August 18 2022 $
 .Dt BIO_CTRL 3
 .Os
 .Sh NAME
@@ -69,7 +69,7 @@
 .Nm BIO_ctrl_wpending ,
 .Nm BIO_get_info_callback ,
 .Nm BIO_set_info_callback ,
-.Nm bio_info_cb
+.Nm BIO_info_cb
 .Nd BIO control operations
 .Sh SYNOPSIS
 .In openssl/bio.h
@@ -84,7 +84,7 @@
 .Fo BIO_callback_ctrl
 .Fa "BIO *b"
 .Fa "int cmd"
-.Fa "bio_info_cb cb"
+.Fa "BIO_info_cb cb"
 .Fc
 .Ft char *
 .Fo BIO_ptr_ctrl
@@ -148,21 +148,18 @@
 .Ft int
 .Fo BIO_get_info_callback
 .Fa "BIO *b"
-.Fa "bio_info_cb **cbp"
+.Fa "BIO_info_cb **cbp"
 .Fc
 .Ft int
 .Fo BIO_set_info_callback
 .Fa "BIO *b"
-.Fa "bio_info_cb *cb"
+.Fa "BIO_info_cb *cb"
 .Fc
-.Ft typedef void
-.Fo bio_info_cb
+.Ft typedef int
+.Fo BIO_info_cb
 .Fa "BIO *b"
-.Fa "int oper"
-.Fa "const char *ptr"
-.Fa "int arg1"
-.Fa "long arg2"
-.Fa "long arg3"
+.Fa "int state"
+.Fa "int res"
 .Fc
 .Sh DESCRIPTION
 .Fn BIO_ctrl ,
-- 
2.20.1