[#BIO_lookup]
= BIO_lookup
:mrdocs:

Resolve `host` / `service` into a BIO_ADDRINFO list.

== Synopsis

Declared in `<openssl/bio.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
BIO_lookup(
    char const* host,
    char const* service,
    xref:BIO_lookup_type.adoc[BIO_lookup_type] lookup_type,
    int family,
    int socktype,
    xref:BIO_ADDRINFO.adoc[BIO_ADDRINFO]** res);
----

== Description

Prefer BIO_lookup_ex() when a specific protocol number is required.

== Return Value

1 on success, or 0 on failure.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *host*
| Hostname or address string to look up, or NULL for wildcard.
| *service*
| Service name or port string, or NULL.
| *lookup_type*
| BIO_LOOKUP_CLIENT or BIO_LOOKUP_SERVER.
| *family*
| Address family (for example AF_INET, AF_INET6, or AF_UNSPEC).
| *socktype*
| Socket type (for example SOCK_STREAM or SOCK_DGRAM).
| *res*
| Receives the head of the allocated BIO_ADDRINFO list; free with BIO_ADDRINFO_free().
|===


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