1 .\" $NetBSD: SSL_clear.3,v 1.14 2015/06/12 17:01:14 christos Exp $
3 .\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
6 .\" ========================================================================
7 .de Sp \" Vertical space (when we can't use .PP)
11 .de Vb \" Begin verbatim text
16 .de Ve \" End verbatim text
20 .\" Set up some character translations and predefined strings. \*(-- will
21 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
22 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
23 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
24 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
25 .\" nothing in troff, for use with C<>.
27 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
31 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
32 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
47 .\" Escape single quotes in literal strings from groff's Unicode transform.
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
53 .\" entries marked with X<> in POD. Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
56 .\" Avoid warning from groff about undefined register 'F'.
60 .if \n(.g .if rF .nr rF 1
61 .if (\n(rF:(\n(.g==0)) \{
64 . tm Index:\\$1\t\\n%\t"\\$2"
74 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
75 .\" Fear. Run. Save yourself. No user-serviceable parts.
76 . \" fudge factors for nroff and troff
85 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
91 . \" simple accents for nroff and troff
101 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
102 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
103 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
104 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
105 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
106 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
108 . \" troff and (daisy-wheel) nroff accents
109 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
110 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
111 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
112 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
113 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
114 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
115 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
116 .ds ae a\h'-(\w'a'u*4/10)'e
117 .ds Ae A\h'-(\w'A'u*4/10)'E
118 . \" corrections for vroff
119 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
120 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
121 . \" for low resolution devices (crt and lpr)
122 .if \n(.H>23 .if \n(.V>19 \
135 .\" ========================================================================
137 .IX Title "SSL_clear 3"
138 .TH SSL_clear 3 "2014-06-05" "1.0.1n" "OpenSSL"
139 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
140 .\" way too many mistakes in technical documents.
144 SSL_clear \- reset SSL object to allow another connection
148 .IX Header "SYNOPSIS"
150 \& #include <openssl/ssl.h>
152 \& int SSL_clear(SSL *ssl);
155 .IX Header "DESCRIPTION"
156 Reset \fBssl\fR to allow another connection. All settings (method, ciphers,
160 SSL_clear is used to prepare an \s-1SSL\s0 object for a new connection. While all
161 settings are kept, a side effect is the handling of the current \s-1SSL\s0 session.
162 If a session is still \fBopen\fR, it is considered bad and will be removed
163 from the session cache, as required by \s-1RFC2246. A\s0 session is considered open,
164 if \fISSL_shutdown\fR\|(3) was not called for the connection
165 or at least \fISSL_set_shutdown\fR\|(3) was used to
166 set the \s-1SSL_SENT_SHUTDOWN\s0 state.
168 If a session was closed cleanly, the session object will be kept and all
169 settings corresponding. This explicitly means, that e.g. the special method
170 used during the session will be kept for the next handshake. So if the
171 session was a TLSv1 session, a \s-1SSL\s0 client object will use a TLSv1 client
172 method for the next handshake and a \s-1SSL\s0 server object will use a TLSv1
173 server method, even if SSLv23_*_methods were chosen on startup. This
174 will might lead to connection failures (see \fISSL_new\fR\|(3))
175 for a description of the method's properties.
177 .IX Header "WARNINGS"
178 \&\fISSL_clear()\fR resets the \s-1SSL\s0 object to allow for another connection. The
179 reset operation however keeps several settings of the last sessions
180 (some of these settings were made automatically during the last
181 handshake). It only makes sense for a new connection with the exact
182 same peer that shares these settings, and may fail if that peer
183 changes its settings between connections. Use the sequence
184 \&\fISSL_get_session\fR\|(3);
185 \&\fISSL_new\fR\|(3);
186 \&\fISSL_set_session\fR\|(3);
187 \&\fISSL_free\fR\|(3)
188 instead to avoid such failures
189 (or simply \fISSL_free\fR\|(3); \fISSL_new\fR\|(3)
190 if session reuse is not desired).
192 .IX Header "RETURN VALUES"
193 The following return values can occur:
195 The \fISSL_clear()\fR operation could not be performed. Check the error stack to
199 The \fISSL_clear()\fR operation was successful.
201 \&\fISSL_new\fR\|(3), \fISSL_free\fR\|(3),
202 \&\fISSL_shutdown\fR\|(3), \fISSL_set_shutdown\fR\|(3),
203 \&\fISSL_CTX_set_options\fR\|(3), \fIssl\fR\|(3),
204 \&\fISSL_CTX_set_client_cert_cb\fR\|(3)