]>
Commit | Line | Data |
---|---|---|
8cbceba6 LJ |
1 | =pod |
2 | ||
3 | =head1 NAME | |
54ff1e6a | 4 | |
8cbceba6 LJ |
5 | d2i_SSL_SESSION, i2d_SSL_SESSION - convert SSL_SESSION object from/to ASN1 representation |
6 | ||
7 | =head1 SYNOPSIS | |
8 | ||
9 | #include <openssl/ssl.h> | |
10 | ||
e9b77246 BB |
11 | SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a, const unsigned char **pp, |
12 | long length); | |
9022f240 | 13 | int i2d_SSL_SESSION(SSL_SESSION *in, unsigned char **pp); |
8cbceba6 LJ |
14 | |
15 | =head1 DESCRIPTION | |
16 | ||
4692340e RS |
17 | These functions decode and encode an SSL_SESSION object. |
18 | For encoding details see L<d2i_X509(3)>. | |
56fa8e69 LJ |
19 | |
20 | SSL_SESSION objects keep internal link information about the session cache | |
21 | list, when being inserted into one SSL_CTX object's session cache. | |
22 | One SSL_SESSION object, regardless of its reference count, must therefore | |
23 | only be used with one SSL_CTX object (and the SSL objects created | |
24 | from this SSL_CTX object). | |
8cbceba6 | 25 | |
8cbceba6 LJ |
26 | =head1 RETURN VALUES |
27 | ||
28 | d2i_SSL_SESSION() returns a pointer to the newly allocated SSL_SESSION | |
29 | object. In case of failure the NULL-pointer is returned and the error message | |
30 | can be retrieved from the error stack. | |
31 | ||
32 | i2d_SSL_SESSION() returns the size of the ASN1 representation in bytes. | |
33 | When the session is not valid, B<0> is returned and no operation is performed. | |
34 | ||
35 | =head1 SEE ALSO | |
36 | ||
b97fdb57 | 37 | L<ssl(7)>, L<SSL_SESSION_free(3)>, |
4692340e RS |
38 | L<SSL_CTX_sess_set_get_cb(3)>, |
39 | L<d2i_X509(3)> | |
8cbceba6 | 40 | |
e2f92610 RS |
41 | =head1 COPYRIGHT |
42 | ||
43 | Copyright 2001-2016 The OpenSSL Project Authors. All Rights Reserved. | |
44 | ||
4746f25a | 45 | Licensed under the Apache License 2.0 (the "License"). You may not use |
e2f92610 RS |
46 | this file except in compliance with the License. You can obtain a copy |
47 | in the file LICENSE in the source distribution or at | |
48 | L<https://www.openssl.org/source/license.html>. | |
49 | ||
50 | =cut |