openbsd/src/lib/libcrypto/man/BIO_set_callback.3, branch OPENBSD_7_9

.Lb libcrypto ; OK tb@

2025-06-08T22:40:31+00:00

Slightly improve the documentation of the "oper" parameter by

2023-04-30T13:57:29+00:00

explicitly listing the valid arguments, i.e. the BIO_CB_* constants.

Mark BIO_CB_return(), BIO_cb_pre(), and BIO_cb_post() as intentionally

2023-04-07T14:47:37+00:00

undocumented because they are unused according to codesearch.debian.net and would cause nothing but obfuscation if they were used.

In bio.h rev. 1.54, jsing@ and tb@ provided BIO_callback_fn_ex(3),

2022-12-16T23:56:57+00:00

BIO_set_callback_ex(3), BIO_get_callback_ex(3), and BIO_callback_fn(3). Document them, in part by merging from the OpenSSL 1.1.1 branch, which is still under a free license, but heavily tweaked by me, in particular: * mention that BIO_set_callback_arg(3) is misnamed; * keep our more detailed explanation of the "ret" argument; * make the list of callback invocations more readable; * and update the HISTORY section.

correct callback argument for BIO_puts(3);

2018-03-29T20:42:17+00:00

from via OpenSSL commit c911e5da Mar 19 14:20:53 2018 +0100

found a complete archive of SSLeay-0.4 to SSLeay-0.8.1b tarballs

2018-03-27T17:35:50+00:00

on the web, so fix up SSLeay HISTORY accordingly

bio.h HISTORY up to SSLeay 0.8.1b; researched from OpenSSL git

2018-03-20T19:33:16+00:00

Add the missing RETURN VALUES section.

2018-02-13T01:15:24+00:00

Triggered by OpenSSL commit 1f13ad31 Dec 25 17:50:39 2017 +0800 by Paul Yang, but reworded for intelligibility and precision. While here, also expand the description of the "ret" argument of BIO_callback_fn(). That's a fairly complicated and alarmingly powerful concept, but the description was so brief that is was barely comprehensible.

make sure that all the BIO pages point back to the master page BIO_new(3)

2016-12-06T14:45:08+00:00

Add Copyright and license.

2016-11-20T01:22:28+00:00

In the SYNOPSIS, provide prototypes rather than #define directives. Name arguments consistently. Remove lies about functions being macros.