1.\" 2.\" $OpenBSD: SSL_new.3,v 1.1 2016/11/05 15:32:20 schwarze Exp $ 3.\" 4.Dd $Mdocdate: November 5 2016 $ 5.Dt SSL_NEW 3 6.Os 7.Sh NAME 8.Nm SSL_new 9.Nd create a new SSL structure for a connection 10.Sh SYNOPSIS 11.In openssl/ssl.h 12.Ft SSL * 13.Fn SSL_new "SSL_CTX *ctx" 14.Sh DESCRIPTION 15.Fn SSL_new 16creates a new 17.Vt SSL 18structure which is needed to hold the data for a TLS/SSL connection. 19The new structure inherits the settings of the underlying context 20.Fa ctx : 21connection method (SSLv2/v3/TLSv1), options, verification settings, 22timeout settings. 23.Sh RETURN VALUES 24The following return values can occur: 25.Bl -tag -width Ds 26.It Dv NULL 27The creation of a new 28.Vt SSL 29structure failed. 30Check the error stack to find out the reason. 31.It Pointer to an Vt SSL No structure 32The return value points to an allocated 33.Vt SSL 34structure. 35.El 36.Sh SEE ALSO 37.Xr ssl 3 , 38.Xr SSL_clear 3 , 39.Xr SSL_CTX_set_options 3 , 40.Xr SSL_free 3 , 41.Xr SSL_get_SSL_CTX 3 42