SSL_CTX_SET_MODE(3) | Library Functions Manual | SSL_CTX_SET_MODE(3) |
SSL_CTX_set_mode
,
SSL_set_mode
,
SSL_CTX_get_mode
,
SSL_get_mode
— manipulate
SSL engine mode
#include
<openssl/ssl.h>
long
SSL_CTX_set_mode
(SSL_CTX
*ctx, long
mode);
long
SSL_set_mode
(SSL
*ssl, long
mode);
long
SSL_CTX_get_mode
(SSL_CTX
*ctx);
long
SSL_get_mode
(SSL
*ssl);
SSL_CTX_set_mode
()
adds the mode set via bitmask in mode to
ctx. Options already set before are not cleared.
SSL_set_mode
()
adds the mode set via bitmask in mode to
ssl. Options already set before are not cleared.
SSL_CTX_get_mode
()
returns the mode set for ctx.
SSL_get_mode
()
returns the mode set for ssl.
The following mode changes are available:
SSL_MODE_ENABLE_PARTIAL_WRITE
SSL_write
(...,
n) to return r with
(i.e., report success when just a single record has been written). When not
set (the default),
SSL_write(3) will only
report success once the complete chunk was written. Once
SSL_write(3) returns
with r, r bytes have been
successfully written and the next call to
SSL_write(3) must only
send the n − r bytes left, imitating the
behaviour of write(2).SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER
SSL_MODE_AUTO_RETRY
SSL_ERROR_WANT_READ
. In a non-blocking environment
applications must be prepared to handle incomplete read/write operations.
In a blocking environment, applications are not always prepared to deal
with read/write operations returning without success report. The flag
SSL_MODE_AUTO_RETRY
will cause read/write
operations to only return after the handshake and successful
completion.SSL_MODE_RELEASE_BUFFERS
SSL_CTX_set_mode
() and
SSL_set_mode
() return the new mode bitmask after
adding mode.
SSL_CTX_get_mode
() and
SSL_get_mode
() return the current bitmask.
SSL_MODE_AUTO_RETRY
was added in OpenSSL
0.9.6.
December 1, 2016 | OpenBSD-6.1 |