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 2 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, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 /* return a ldap dn path from a string, given separators and field name
27 char *ads_build_path(const char *realm, const char *sep, const char *field, int reverse)
43 len = (numbits+1)*(strlen(field)+1) + strlen(r) + 1;
49 strlcpy(ret,field, len);
53 while ((p=strtok(NULL,sep))) {
56 asprintf(&s, "%s%s,%s", field, p, ret);
58 asprintf(&s, "%s,%s%s", ret, field, p);
67 /* return a dn of the form "dc=AA,dc=BB,dc=CC" from a
68 realm of the form AA.BB.CC
71 char *ads_build_dn(const char *realm)
73 return ads_build_path(realm, ".", "dc=", 0);
82 initialise a ADS_STRUCT, ready for some ads_ ops
84 ADS_STRUCT *ads_init(const char *realm,
85 const char *workgroup,
86 const char *ldap_server)
90 ads = (ADS_STRUCT *)smb_xmalloc(sizeof(*ads));
93 ads->server.realm = realm? strdup(realm) : NULL;
94 ads->server.workgroup = workgroup ? strdup(workgroup) : NULL;
95 ads->server.ldap_server = ldap_server? strdup(ldap_server) : NULL;
97 /* we need to know if this is a foreign realm to know if we can
98 use lp_ads_server() */
99 if (realm && *realm && strcasecmp(lp_realm(), realm) != 0) {
100 ads->server.foreign = 1;
102 if (workgroup && *workgroup && strcasecmp(lp_workgroup(), workgroup) != 0) {
103 ads->server.foreign = 1;
109 /* a simpler ads_init() interface using all defaults */
110 ADS_STRUCT *ads_init_simple(void)
112 return ads_init(NULL, NULL, NULL);
116 free the memory used by the ADS structure initialized with 'ads_init(...)'
118 void ads_destroy(ADS_STRUCT **ads)
122 if ((*ads)->ld) ldap_unbind((*ads)->ld);
124 SAFE_FREE((*ads)->server.realm);
125 SAFE_FREE((*ads)->server.workgroup);
126 SAFE_FREE((*ads)->server.ldap_server);
127 SAFE_FREE((*ads)->server.ldap_uri);
129 SAFE_FREE((*ads)->auth.realm);
130 SAFE_FREE((*ads)->auth.password);
131 SAFE_FREE((*ads)->auth.user_name);
132 SAFE_FREE((*ads)->auth.kdc_server);
134 SAFE_FREE((*ads)->config.realm);
135 SAFE_FREE((*ads)->config.bind_path);
136 SAFE_FREE((*ads)->config.ldap_server_name);