libressl-SSL_num_renegotiations(3)

libressl-SSL_num_renegotiations3

Renegotiation counters

Usage

SSL Library (libssl, -lssl) libcrypto

#include <openssl/ssl.h>

long

SSL_num_renegotiations(SSL *ssl);

long

SSL_clear_num_renegotiations(SSL *ssl);

long

SSL_total_renegotiations(SSL *ssl);

Overview

SSL_num_renegotiations() reports the number of renegotiations initiated in ssl since SSL_new(3), SSL_clear(3), or SSL_clear_num_renegotiations() was last called on that object.

SSL_clear_num_renegotiations() does the same and additionally resets the renegotiation counter to 0.

SSL_total_renegotiations() reports the number of renegotiations initiated in ssl since SSL_new(3) or SSL_clear(3) was last called on that object.

These functions are implemented as macros.

Return values

All these functions return a number of renegotiations.

History

These functions first appeared in SSLeay 0.9.0 and have been available since OpenBSD 2.4.

From libressl 4.4.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.