[#BIO_listen]
= BIO_listen
:mrdocs:

Bind and listen on a socket using `addr` and BIO_SOCK_* `options.`

== Synopsis

Declared in `<openssl/bio.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
BIO_listen(
    int sock,
    xref:BIO_ADDR.adoc[BIO_ADDR] const* addr,
    int options);
----

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *sock*
| Socket file descriptor to put into listening state.
| *addr*
| Local address to bind (may be NULL for an already‐bound socket).
| *options*
| BIO_SOCK_* flags such as BIO_SOCK_REUSEADDR.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#