BIO_s_accept.pod: Document port auto-selection feature of BIO_set_accept_port()
authorDr. David von Oheimb <David.von.Oheimb@siemens.com>
Wed, 19 May 2021 15:20:53 +0000 (17:20 +0200)
committerPauli <pauli@openssl.org>
Fri, 21 May 2021 00:06:35 +0000 (10:06 +1000)
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/15354)

doc/man3/BIO_s_accept.pod

index 02c6006453eb18c08769365c612c848441d88249..f49eb532fcd12477f3270eefba0bda5fa58ae259 100644 (file)
@@ -77,6 +77,8 @@ port.  "port" has the same syntax as the port specified in
 BIO_set_conn_port() for connect BIOs, that is it can be a numerical
 port string or a string to lookup using getservbyname() and a string
 table.
+If the given port is C<0> then a random available port is chosen.
+It may be queried using BIO_sock_info() and L<BIO_ADDR_service_string(3)>.
 
 BIO_new_accept() combines BIO_new() and BIO_set_accept_name() into
 a single call: that is it creates a new accept BIO with port