SSL_new.pod revision 89837 
1224133Sdim=pod
2224133Sdim
3224133Sdim=head1 NAME
4224133Sdim
5224133SdimSSL_new - create a new SSL structure for a connection
6224133Sdim
7224133Sdim=head1 SYNOPSIS
8224133Sdim
9224133Sdim #include <openssl/ssl.h>
10224133Sdim
11224133Sdim SSL *SSL_new(SSL_CTX *ctx);
12224133Sdim
13224133Sdim=head1 DESCRIPTION
14224133Sdim
15224133SdimSSL_new() creates a new B<SSL> structure which is needed to hold the
16224133Sdimdata for a TLS/SSL connection. The new structure inherits the settings
17224133Sdimof the underlying context B<ctx>: connection method (SSLv2/v3/TLSv1),
18224133Sdimoptions, verification settings, timeout settings.
19224133Sdim
20224133Sdim=head1 RETURN VALUES
21224133Sdim
22224133SdimThe following return values can occur:
23224133Sdim
24224133Sdim=over 4
25224133Sdim
26224133Sdim=item NULL
27224133Sdim
28224133SdimThe creation of a new SSL structure failed. Check the error stack to
29224133Sdimfind out the reason.
30224133Sdim
31224133Sdim=item Pointer to an SSL structure
32224133Sdim
33224133SdimThe return value points to an allocated SSL structure.
34224133Sdim
35224133Sdim=back
36224133Sdim
37224133Sdim=head1 SEE ALSO
38224133Sdim
39224133SdimL<SSL_free(3)|SSL_free(3)>, L<SSL_clear(3)|SSL_clear(3)>,
40224133SdimL<SSL_CTX_set_options(3)|SSL_CTX_set_options(3)>,
41224133SdimL<SSL_get_SSL_CTX(3)|SSL_get_SSL_CTX(3)>,
42224133SdimL<ssl(3)|ssl(3)>
43224133Sdim
44224133Sdim=cut
45224133Sdim