xref: /netbsd-src/external/bsd/openldap/dist/libraries/libldap/unbind.c (revision 3816d47b2c42fcd6e549e3407f842a5b1a1d23ad)
1 /* $OpenLDAP: pkg/ldap/libraries/libldap/unbind.c,v 1.56.2.4 2008/02/11 23:26:41 kurt Exp $ */
2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
3  *
4  * Copyright 1998-2008 The OpenLDAP Foundation.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted only as authorized by the OpenLDAP
9  * Public License.
10  *
11  * A copy of this license is available in the file LICENSE in the
12  * top-level directory of the distribution or, alternatively, at
13  * <http://www.OpenLDAP.org/license.html>.
14  */
15 /* Portions Copyright (c) 1990 Regents of the University of Michigan.
16  * All rights reserved.
17  */
18 
19 #include "portable.h"
20 
21 #include <stdio.h>
22 #include <ac/stdlib.h>
23 
24 #include <ac/socket.h>
25 #include <ac/string.h>
26 #include <ac/time.h>
27 
28 #include "ldap-int.h"
29 
30 /* An Unbind Request looks like this:
31  *
32  *	UnbindRequest ::= [APPLICATION 2] NULL
33  *
34  * and has no response.  (Source: RFC 4511)
35  */
36 
37 int
38 ldap_unbind_ext(
39 	LDAP *ld,
40 	LDAPControl **sctrls,
41 	LDAPControl **cctrls )
42 {
43 	int rc;
44 
45 	assert( ld != NULL );
46 	assert( LDAP_VALID( ld ) );
47 
48 	/* check client controls */
49 	rc = ldap_int_client_controls( ld, cctrls );
50 	if( rc != LDAP_SUCCESS ) return rc;
51 
52 	return ldap_ld_free( ld, 1, sctrls, cctrls );
53 }
54 
55 int
56 ldap_unbind_ext_s(
57 	LDAP *ld,
58 	LDAPControl **sctrls,
59 	LDAPControl **cctrls )
60 {
61 	return ldap_unbind_ext( ld, sctrls, cctrls );
62 }
63 
64 int
65 ldap_unbind( LDAP *ld )
66 {
67 	Debug( LDAP_DEBUG_TRACE, "ldap_unbind\n", 0, 0, 0 );
68 
69 	return( ldap_unbind_ext( ld, NULL, NULL ) );
70 }
71 
72 
73 int
74 ldap_ld_free(
75 	LDAP *ld,
76 	int close,
77 	LDAPControl **sctrls,
78 	LDAPControl **cctrls )
79 {
80 	LDAPMessage	*lm, *next;
81 	int		err = LDAP_SUCCESS;
82 
83 	/* free LDAP structure and outstanding requests/responses */
84 #ifdef LDAP_R_COMPILE
85 	ldap_pvt_thread_mutex_lock( &ld->ld_req_mutex );
86 #endif
87 	while ( ld->ld_requests != NULL ) {
88 		ldap_free_request( ld, ld->ld_requests );
89 	}
90 
91 	/* free and unbind from all open connections */
92 	while ( ld->ld_conns != NULL ) {
93 		ldap_free_connection( ld, ld->ld_conns, 1, close );
94 	}
95 #ifdef LDAP_R_COMPILE
96 	ldap_pvt_thread_mutex_unlock( &ld->ld_req_mutex );
97 #endif
98 
99 #ifdef LDAP_R_COMPILE
100 	ldap_pvt_thread_mutex_lock( &ld->ld_res_mutex );
101 #endif
102 	for ( lm = ld->ld_responses; lm != NULL; lm = next ) {
103 		next = lm->lm_next;
104 		ldap_msgfree( lm );
105 	}
106 
107 	if ( ld->ld_abandoned != NULL ) {
108 		LDAP_FREE( ld->ld_abandoned );
109 		ld->ld_abandoned = NULL;
110 	}
111 #ifdef LDAP_R_COMPILE
112 	ldap_pvt_thread_mutex_unlock( &ld->ld_res_mutex );
113 #endif
114 
115 	if ( ld->ld_error != NULL ) {
116 		LDAP_FREE( ld->ld_error );
117 		ld->ld_error = NULL;
118 	}
119 
120 	if ( ld->ld_matched != NULL ) {
121 		LDAP_FREE( ld->ld_matched );
122 		ld->ld_matched = NULL;
123 	}
124 
125 	if( ld->ld_referrals != NULL) {
126 		LDAP_VFREE(ld->ld_referrals);
127 		ld->ld_referrals = NULL;
128 	}
129 
130 	if ( ld->ld_selectinfo != NULL ) {
131 		ldap_free_select_info( ld->ld_selectinfo );
132 		ld->ld_selectinfo = NULL;
133 	}
134 
135 	if ( ld->ld_options.ldo_defludp != NULL ) {
136 		ldap_free_urllist( ld->ld_options.ldo_defludp );
137 		ld->ld_options.ldo_defludp = NULL;
138 	}
139 
140 #ifdef LDAP_CONNECTIONLESS
141 	if ( ld->ld_options.ldo_peer != NULL ) {
142 		LDAP_FREE( ld->ld_options.ldo_peer );
143 		ld->ld_options.ldo_peer = NULL;
144 	}
145 #endif
146 
147 #ifdef HAVE_CYRUS_SASL
148 	if ( ld->ld_options.ldo_def_sasl_mech != NULL ) {
149 		LDAP_FREE( ld->ld_options.ldo_def_sasl_mech );
150 		ld->ld_options.ldo_def_sasl_mech = NULL;
151 	}
152 
153 	if ( ld->ld_options.ldo_def_sasl_realm != NULL ) {
154 		LDAP_FREE( ld->ld_options.ldo_def_sasl_realm );
155 		ld->ld_options.ldo_def_sasl_realm = NULL;
156 	}
157 
158 	if ( ld->ld_options.ldo_def_sasl_authcid != NULL ) {
159 		LDAP_FREE( ld->ld_options.ldo_def_sasl_authcid );
160 		ld->ld_options.ldo_def_sasl_authcid = NULL;
161 	}
162 
163 	if ( ld->ld_options.ldo_def_sasl_authzid != NULL ) {
164 		LDAP_FREE( ld->ld_options.ldo_def_sasl_authzid );
165 		ld->ld_options.ldo_def_sasl_authzid = NULL;
166 	}
167 #endif
168 
169 #ifdef HAVE_TLS
170 	ldap_int_tls_destroy( &ld->ld_options );
171 #endif
172 
173 	if ( ld->ld_options.ldo_sctrls != NULL ) {
174 		ldap_controls_free( ld->ld_options.ldo_sctrls );
175 		ld->ld_options.ldo_sctrls = NULL;
176 	}
177 
178 	if ( ld->ld_options.ldo_cctrls != NULL ) {
179 		ldap_controls_free( ld->ld_options.ldo_cctrls );
180 		ld->ld_options.ldo_cctrls = NULL;
181 	}
182 
183 	ber_sockbuf_free( ld->ld_sb );
184 
185 #ifdef LDAP_R_COMPILE
186 	ldap_pvt_thread_mutex_destroy( &ld->ld_req_mutex );
187 	ldap_pvt_thread_mutex_destroy( &ld->ld_res_mutex );
188 	ldap_pvt_thread_mutex_destroy( &ld->ld_conn_mutex );
189 #endif
190 #ifndef NDEBUG
191 	LDAP_TRASH(ld);
192 #endif
193 	LDAP_FREE( (char *) ld );
194 
195 	return( err );
196 }
197 
198 int
199 ldap_unbind_s( LDAP *ld )
200 {
201 	return( ldap_unbind_ext( ld, NULL, NULL ) );
202 }
203 
204 /* FIXME: this function is called only by ldap_free_connection(),
205  * which, most of the times, is called with ld_req_mutex locked */
206 int
207 ldap_send_unbind(
208 	LDAP *ld,
209 	Sockbuf *sb,
210 	LDAPControl **sctrls,
211 	LDAPControl **cctrls )
212 {
213 	BerElement	*ber;
214 	ber_int_t	id;
215 
216 	Debug( LDAP_DEBUG_TRACE, "ldap_send_unbind\n", 0, 0, 0 );
217 
218 #ifdef LDAP_CONNECTIONLESS
219 	if (LDAP_IS_UDP(ld))
220 		return LDAP_SUCCESS;
221 #endif
222 	/* create a message to send */
223 	if ( (ber = ldap_alloc_ber_with_options( ld )) == NULL ) {
224 		return( ld->ld_errno );
225 	}
226 
227 	id = ++(ld)->ld_msgid;
228 
229 	/* fill it in */
230 	if ( ber_printf( ber, "{itn" /*}*/, id,
231 	    LDAP_REQ_UNBIND ) == -1 ) {
232 		ld->ld_errno = LDAP_ENCODING_ERROR;
233 		ber_free( ber, 1 );
234 		return( ld->ld_errno );
235 	}
236 
237 	/* Put Server Controls */
238 	if( ldap_int_put_controls( ld, sctrls, ber ) != LDAP_SUCCESS ) {
239 		ber_free( ber, 1 );
240 		return ld->ld_errno;
241 	}
242 
243 	if ( ber_printf( ber, /*{*/ "N}", LDAP_REQ_UNBIND ) == -1 ) {
244 		ld->ld_errno = LDAP_ENCODING_ERROR;
245 		ber_free( ber, 1 );
246 		return( ld->ld_errno );
247 	}
248 
249 	ld->ld_errno = LDAP_SUCCESS;
250 	/* send the message */
251 	if ( ber_flush2( sb, ber, LBER_FLUSH_FREE_ALWAYS ) == -1 ) {
252 		ld->ld_errno = LDAP_SERVER_DOWN;
253 	}
254 
255 	return( ld->ld_errno );
256 }
257