OLD | NEW |
1 =pod | 1 =pod |
2 | 2 |
3 =head1 NAME | 3 =head1 NAME |
4 | 4 |
5 SSL_CTX_set_mode, SSL_set_mode, SSL_CTX_get_mode, SSL_get_mode - manipulate SSL
engine mode | 5 SSL_CTX_set_mode, SSL_set_mode, SSL_CTX_get_mode, SSL_get_mode - manipulate SSL
engine mode |
6 | 6 |
7 =head1 SYNOPSIS | 7 =head1 SYNOPSIS |
8 | 8 |
9 #include <openssl/ssl.h> | 9 #include <openssl/ssl.h> |
10 | 10 |
(...skipping 43 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
54 If a renegotiation take place during normal operation, a | 54 If a renegotiation take place during normal operation, a |
55 L<SSL_read(3)|SSL_read(3)> or L<SSL_write(3)|SSL_write(3)> would return | 55 L<SSL_read(3)|SSL_read(3)> or L<SSL_write(3)|SSL_write(3)> would return |
56 with -1 and indicate the need to retry with SSL_ERROR_WANT_READ. | 56 with -1 and indicate the need to retry with SSL_ERROR_WANT_READ. |
57 In a non-blocking environment applications must be prepared to handle | 57 In a non-blocking environment applications must be prepared to handle |
58 incomplete read/write operations. | 58 incomplete read/write operations. |
59 In a blocking environment, applications are not always prepared to | 59 In a blocking environment, applications are not always prepared to |
60 deal with read/write operations returning without success report. The | 60 deal with read/write operations returning without success report. The |
61 flag SSL_MODE_AUTO_RETRY will cause read/write operations to only | 61 flag SSL_MODE_AUTO_RETRY will cause read/write operations to only |
62 return after the handshake and successful completion. | 62 return after the handshake and successful completion. |
63 | 63 |
| 64 =item SSL_MODE_RELEASE_BUFFERS |
| 65 |
| 66 When we no longer need a read buffer or a write buffer for a given SSL, |
| 67 then release the memory we were using to hold it. Released memory is |
| 68 either appended to a list of unused RAM chunks on the SSL_CTX, or simply |
| 69 freed if the list of unused chunks would become longer than |
| 70 SSL_CTX->freelist_max_len, which defaults to 32. Using this flag can |
| 71 save around 34k per idle SSL connection. |
| 72 This flag has no effect on SSL v2 connections, or on DTLS connections. |
| 73 |
64 =back | 74 =back |
65 | 75 |
66 =head1 RETURN VALUES | 76 =head1 RETURN VALUES |
67 | 77 |
68 SSL_CTX_set_mode() and SSL_set_mode() return the new mode bitmask | 78 SSL_CTX_set_mode() and SSL_set_mode() return the new mode bitmask |
69 after adding B<mode>. | 79 after adding B<mode>. |
70 | 80 |
71 SSL_CTX_get_mode() and SSL_get_mode() return the current bitmask. | 81 SSL_CTX_get_mode() and SSL_get_mode() return the current bitmask. |
72 | 82 |
73 =head1 SEE ALSO | 83 =head1 SEE ALSO |
74 | 84 |
75 L<ssl(3)|ssl(3)>, L<SSL_read(3)|SSL_read(3)>, L<SSL_write(3)|SSL_write(3)> | 85 L<ssl(3)|ssl(3)>, L<SSL_read(3)|SSL_read(3)>, L<SSL_write(3)|SSL_write(3)> |
76 | 86 |
77 =head1 HISTORY | 87 =head1 HISTORY |
78 | 88 |
79 SSL_MODE_AUTO_RETRY as been added in OpenSSL 0.9.6. | 89 SSL_MODE_AUTO_RETRY as been added in OpenSSL 0.9.6. |
80 | 90 |
81 =cut | 91 =cut |
OLD | NEW |