~ubuntu-branches/ubuntu/precise/openssl098/precise

« back to all changes in this revision

Viewing changes to doc/ssl/SSL_new.pod

  • Committer: Bazaar Package Importer
  • Author(s): Kurt Roeckx
  • Date: 2011-03-23 19:50:31 UTC
  • Revision ID: james.westby@ubuntu.com-20110323195031-6h9crj4bymhhr8b8
Tags: upstream-0.9.8o
ImportĀ upstreamĀ versionĀ 0.9.8o

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
=pod
 
2
 
 
3
=head1 NAME
 
4
 
 
5
SSL_new - create a new SSL structure for a connection
 
6
 
 
7
=head1 SYNOPSIS
 
8
 
 
9
 #include <openssl/ssl.h>
 
10
 
 
11
 SSL *SSL_new(SSL_CTX *ctx);
 
12
 
 
13
=head1 DESCRIPTION
 
14
 
 
15
SSL_new() creates a new B<SSL> structure which is needed to hold the
 
16
data for a TLS/SSL connection. The new structure inherits the settings
 
17
of the underlying context B<ctx>: connection method (SSLv2/v3/TLSv1),
 
18
options, verification settings, timeout settings.
 
19
 
 
20
=head1 RETURN VALUES
 
21
 
 
22
The following return values can occur:
 
23
 
 
24
=over 4
 
25
 
 
26
=item NULL
 
27
 
 
28
The creation of a new SSL structure failed. Check the error stack to
 
29
find out the reason.
 
30
 
 
31
=item Pointer to an SSL structure
 
32
 
 
33
The return value points to an allocated SSL structure.
 
34
 
 
35
=back
 
36
 
 
37
=head1 SEE ALSO
 
38
 
 
39
L<SSL_free(3)|SSL_free(3)>, L<SSL_clear(3)|SSL_clear(3)>,
 
40
L<SSL_CTX_set_options(3)|SSL_CTX_set_options(3)>,
 
41
L<SSL_get_SSL_CTX(3)|SSL_get_SSL_CTX(3)>,
 
42
L<ssl(3)|ssl(3)>
 
43
 
 
44
=cut