2 Unix SMB/CIFS implementation.
3 ads (active directory) utility library
4 Copyright (C) Andrew Tridgell 2001
5 Copyright (C) Andrew Bartlett 2001
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 /* return a ldap dn path from a string, given separators and field name
26 char *ads_build_path(const char *realm, const char *sep, const char *field, int reverse)
34 r = SMB_STRDUP(realm);
41 if (strchr(sep, *p)) {
46 len = (numbits+1)*(strlen(field)+1) + strlen(r) + 1;
48 ret = (char *)SMB_MALLOC(len);
54 strlcpy(ret,field, len);
55 p=strtok_r(r, sep, &saveptr);
59 while ((p=strtok_r(NULL, sep, &saveptr)) != NULL) {
63 retval = asprintf(&s, "%s%s,%s", field, p, ret);
65 retval = asprintf(&s, "%s,%s%s", ret, field, p);
80 /* return a dn of the form "dc=AA,dc=BB,dc=CC" from a
81 realm of the form AA.BB.CC
84 char *ads_build_dn(const char *realm)
86 return ads_build_path(realm, ".", "dc=", 0);
89 /* return a DNS name in the for aa.bb.cc from the DN
90 "dc=AA,dc=BB,dc=CC". caller must free
92 char *ads_build_domain(const char *dn)
94 char *dnsdomain = NULL;
96 /* result should always be shorter than the DN */
98 if ( (dnsdomain = SMB_STRDUP( dn )) == NULL ) {
99 DEBUG(0,("ads_build_domain: malloc() failed!\n"));
103 strlower_m( dnsdomain );
104 all_string_sub( dnsdomain, "dc=", "", 0);
105 all_string_sub( dnsdomain, ",", ".", 0 );
113 #define LDAP_PORT 389
117 initialise a ADS_STRUCT, ready for some ads_ ops
119 ADS_STRUCT *ads_init(const char *realm,
120 const char *workgroup,
121 const char *ldap_server)
126 ads = SMB_XMALLOC_P(ADS_STRUCT);
129 ads->server.realm = realm? SMB_STRDUP(realm) : NULL;
130 ads->server.workgroup = workgroup ? SMB_STRDUP(workgroup) : NULL;
131 ads->server.ldap_server = ldap_server? SMB_STRDUP(ldap_server) : NULL;
133 /* we need to know if this is a foreign realm */
134 if (realm && *realm && !strequal(lp_realm(), realm)) {
135 ads->server.foreign = 1;
137 if (workgroup && *workgroup && !strequal(lp_workgroup(), workgroup)) {
138 ads->server.foreign = 1;
141 /* the caller will own the memory by default */
144 wrap_flags = lp_client_ldap_sasl_wrapping();
145 if (wrap_flags == -1) {
149 ads->auth.flags = wrap_flags;
151 /* Start with a page size of 1000 when the connection is new,
152 * we will drop it by half we get a timeout. */
153 ads->config.ldap_page_size = 1000;
159 free the memory used by the ADS structure initialized with 'ads_init(...)'
161 void ads_destroy(ADS_STRUCT **ads)
166 is_mine = (*ads)->is_mine;
168 ads_disconnect(*ads);
170 SAFE_FREE((*ads)->server.realm);
171 SAFE_FREE((*ads)->server.workgroup);
172 SAFE_FREE((*ads)->server.ldap_server);
174 SAFE_FREE((*ads)->auth.realm);
175 SAFE_FREE((*ads)->auth.password);
176 SAFE_FREE((*ads)->auth.user_name);
177 SAFE_FREE((*ads)->auth.kdc_server);
179 SAFE_FREE((*ads)->config.realm);
180 SAFE_FREE((*ads)->config.bind_path);
181 SAFE_FREE((*ads)->config.ldap_server_name);
182 SAFE_FREE((*ads)->config.server_site_name);
183 SAFE_FREE((*ads)->config.client_site_name);
184 SAFE_FREE((*ads)->config.schema_path);
185 SAFE_FREE((*ads)->config.config_path);