168651Skris=pod
268651Skris
368651Skris=head1 NAME
468651Skris
568651SkrisSSL_new - create a new SSL structure for a connection
668651Skris
768651Skris=head1 SYNOPSIS
868651Skris
968651Skris #include <openssl/ssl.h>
1068651Skris
1168651Skris SSL *SSL_new(SSL_CTX *ctx);
1268651Skris
1368651Skris=head1 DESCRIPTION
1468651Skris
1568651SkrisSSL_new() creates a new B<SSL> structure which is needed to hold the
1668651Skrisdata for a TLS/SSL connection. The new structure inherits the settings
1768651Skrisof the underlying context B<ctx>: connection method (SSLv2/v3/TLSv1),
1868651Skrisoptions, verification settings, timeout settings.
1968651Skris
2068651Skris=head1 RETURN VALUES
2168651Skris
2268651SkrisThe following return values can occur:
2368651Skris
2468651Skris=over 4
2568651Skris
2668651Skris=item NULL
2768651Skris
2868651SkrisThe creation of a new SSL structure failed. Check the error stack to
2968651Skrisfind out the reason.
3068651Skris
3168651Skris=item Pointer to an SSL structure
3268651Skris
3368651SkrisThe return value points to an allocated SSL structure.
3468651Skris
3568651Skris=back
3668651Skris
3768651Skris=head1 SEE ALSO
3868651Skris
3968651SkrisL<SSL_free(3)|SSL_free(3)>, L<SSL_clear(3)|SSL_clear(3)>,
4072613SkrisL<SSL_CTX_set_options(3)|SSL_CTX_set_options(3)>,
4189837SkrisL<SSL_get_SSL_CTX(3)|SSL_get_SSL_CTX(3)>,
4268651SkrisL<ssl(3)|ssl(3)>
4368651Skris
4468651Skris=cut
45