docs-xml: "cluster addresses" dns registration
[Samba.git] / source3 / libads / ads_struct.c
blob3ab682c0e3883459bd27f309105af7fc876d39a0
1 /*
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/>.
21 #include "includes.h"
22 #include "ads.h"
24 /* return a ldap dn path from a string, given separators and field name
25 caller must free
27 char *ads_build_path(const char *realm, const char *sep, const char *field, int reverse)
29 char *p, *r;
30 int numbits = 0;
31 char *ret;
32 int len;
33 char *saveptr;
35 r = SMB_STRDUP(realm);
37 if (!r || !*r) {
38 return r;
41 for (p=r; *p; p++) {
42 if (strchr(sep, *p)) {
43 numbits++;
47 len = (numbits+1)*(strlen(field)+1) + strlen(r) + 1;
49 ret = (char *)SMB_MALLOC(len);
50 if (!ret) {
51 free(r);
52 return NULL;
55 if (strlcpy(ret,field, len) >= len) {
56 /* Truncate ! */
57 free(r);
58 free(ret);
59 return NULL;
61 p=strtok_r(r, sep, &saveptr);
62 if (p) {
63 if (strlcat(ret, p, len) >= len) {
64 free(r);
65 free(ret);
66 return NULL;
69 while ((p=strtok_r(NULL, sep, &saveptr)) != NULL) {
70 int retval;
71 char *s = NULL;
72 if (reverse)
73 retval = asprintf(&s, "%s%s,%s", field, p, ret);
74 else
75 retval = asprintf(&s, "%s,%s%s", ret, field, p);
76 free(ret);
77 if (retval == -1) {
78 free(r);
79 return NULL;
81 ret = SMB_STRDUP(s);
82 free(s);
86 free(r);
87 return ret;
90 /* return a dn of the form "dc=AA,dc=BB,dc=CC" from a
91 realm of the form AA.BB.CC
92 caller must free
94 char *ads_build_dn(const char *realm)
96 return ads_build_path(realm, ".", "dc=", 0);
99 /* return a DNS name in the for aa.bb.cc from the DN
100 "dc=AA,dc=BB,dc=CC". caller must free
102 char *ads_build_domain(const char *dn)
104 char *dnsdomain = NULL;
106 /* result should always be shorter than the DN */
108 if ( (dnsdomain = SMB_STRDUP( dn )) == NULL ) {
109 DEBUG(0,("ads_build_domain: malloc() failed!\n"));
110 return NULL;
113 if (!strlower_m( dnsdomain )) {
114 SAFE_FREE(dnsdomain);
115 return NULL;
118 all_string_sub( dnsdomain, "dc=", "", 0);
119 all_string_sub( dnsdomain, ",", ".", 0 );
121 return dnsdomain;
126 #ifndef LDAP_PORT
127 #define LDAP_PORT 389
128 #endif
131 initialise a ADS_STRUCT, ready for some ads_ ops
133 ADS_STRUCT *ads_init(const char *realm,
134 const char *workgroup,
135 const char *ldap_server)
137 ADS_STRUCT *ads;
138 int wrap_flags;
140 ads = SMB_XMALLOC_P(ADS_STRUCT);
141 ZERO_STRUCTP(ads);
143 ads->server.realm = realm? SMB_STRDUP(realm) : NULL;
144 ads->server.workgroup = workgroup ? SMB_STRDUP(workgroup) : NULL;
145 ads->server.ldap_server = ldap_server? SMB_STRDUP(ldap_server) : NULL;
147 /* the caller will own the memory by default */
148 ads->is_mine = 1;
150 wrap_flags = lp_client_ldap_sasl_wrapping();
151 if (wrap_flags == -1) {
152 wrap_flags = 0;
155 ads->auth.flags = wrap_flags;
157 /* Start with the configured page size when the connection is new,
158 * we will drop it by half we get a timeout. */
159 ads->config.ldap_page_size = lp_ldap_page_size();
161 return ads;
164 /****************************************************************
165 ****************************************************************/
167 bool ads_set_sasl_wrap_flags(ADS_STRUCT *ads, int flags)
169 if (!ads) {
170 return false;
173 ads->auth.flags = flags;
175 return true;
179 free the memory used by the ADS structure initialized with 'ads_init(...)'
181 void ads_destroy(ADS_STRUCT **ads)
183 if (ads && *ads) {
184 bool is_mine;
186 is_mine = (*ads)->is_mine;
187 #ifdef HAVE_LDAP
188 ads_disconnect(*ads);
189 #endif
190 SAFE_FREE((*ads)->server.realm);
191 SAFE_FREE((*ads)->server.workgroup);
192 SAFE_FREE((*ads)->server.ldap_server);
194 SAFE_FREE((*ads)->auth.realm);
195 SAFE_FREE((*ads)->auth.password);
196 SAFE_FREE((*ads)->auth.user_name);
197 SAFE_FREE((*ads)->auth.kdc_server);
198 SAFE_FREE((*ads)->auth.ccache_name);
200 SAFE_FREE((*ads)->config.realm);
201 SAFE_FREE((*ads)->config.bind_path);
202 SAFE_FREE((*ads)->config.ldap_server_name);
203 SAFE_FREE((*ads)->config.server_site_name);
204 SAFE_FREE((*ads)->config.client_site_name);
205 SAFE_FREE((*ads)->config.schema_path);
206 SAFE_FREE((*ads)->config.config_path);
208 ZERO_STRUCTP(*ads);
210 if ( is_mine )
211 SAFE_FREE(*ads);