TLS_CLIENT(3) | Library Functions Manual | TLS_CLIENT(3) |
tls_client
,
tls_server
, tls_configure
,
tls_free
— configure a TLS
connection
#include
<tls.h>
struct tls *
tls_client
(void);
struct tls *
tls_server
(void);
int
tls_configure
(struct tls *ctx,
struct tls_config *config);
void
tls_free
(struct
tls *ctx);
A TLS connection is represented as a struct
tls object called a “context”. A new context is created
by either the
tls_client
()
or
tls_server
()
functions. tls_client
() is used in TLS client
programs, tls_server
() in TLS server programs.
The context can then be configured with the
function
tls_configure
().
The same tls_config object can be used to configure
multiple contexts.
After configuration,
tls_connect(3) can be
called on objects created with
tls_client
(),
and
tls_accept_socket(3)
on objects created with
tls_server
().
After use, a TLS context should be closed with
tls_close(3), and then
freed by calling
tls_free
().
tls_client
() and
tls_server
() return NULL
on
error or an out of memory condition.
tls_configure
() returns 0 on success or -1
on error.
tls_accept_socket(3), tls_config_new(3), tls_connect(3), tls_init(3)
These functions appeared in OpenBSD 5.6 and got their final names in OpenBSD 5.7.
Joel Sing <jsing@openbsd.org>
January 28, 2017 | OpenBSD-6.1 |