1.\" $OpenBSD: SSL_CTX_set_num_tickets.3,v 1.2 2021/10/23 17:20:50 schwarze Exp $ 2.\" OpenSSL pod checked up to: 5402f96a Sep 11 09:58:52 2021 +0100 3.\" 4.\" Copyright (c) 2021 Bob Beck <beck@openbsd.org> 5.\" 6.\" Permission to use, copy, modify, and distribute this software for any 7.\" purpose with or without fee is hereby granted, provided that the above 8.\" copyright notice and this permission notice appear in all copies. 9.\" 10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 14.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17.\" 18.Dd $Mdocdate: October 23 2021 $ 19.Dt SSL_CTX_SET_NUM_TICKETS 3 20.Os 21.Sh NAME 22.Nm SSL_CTX_set_num_tickets , 23.Nm SSL_CTX_get_num_tickets , 24.Nm SSL_set_num_tickets , 25.Nm SSL_get_num_tickets 26.Nd set and get the number of TLS 1.3 session tickets to be sent 27.Sh SYNOPSIS 28.In openssl/ssl.h 29.Ft int 30.Fn SSL_CTX_set_num_tickets "SSL_CTX *ctx" "size_t num_tickets" 31.Ft size_t 32.Fn SSL_CTX_get_num_tickets "const SSL_CTX *ctx" 33.Ft int 34.Fn SSL_set_num_tickets "SSL *ssl" "size_t num_tickets" 35.Ft size_t 36.Fn SSL_get_num_tickets "const SSL *ssl" 37.Sh DESCRIPTION 38These functions set and retrieve 39the configured number of session tickets for 40.Fa ctx 41and 42.Fa ssl , 43respectively. 44.Pp 45They are provided only for compatibility with OpenSSL 46and have no effect in LibreSSL. 47.Sh RETURN VALUES 48.Fn SSL_CTX_set_num_tickets 49and 50.Fn SSL_set_num_tickets 51always return 1. 52.Pp 53.Fn SSL_CTX_get_num_tickets 54and 55.Fn SSL_get_num_tickets 56return the previously set number of tickets, or 0 if it has not been set. 57.Sh SEE ALSO 58.Xr ssl 3 , 59.Xr SSL_CTX_new 3 60.Sh HISTORY 61These function first appeared in OpenSSL 1.1.1 62and have been available since 63.Ox 7.1 . 64