source/libads/ldap.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3    ads (active directory) utility library
   4    Copyright (C) Andrew Tridgell 2001
   5    Copyright (C) Remus Koos 2001
   6    Copyright (C) Jim McDonough <jmcd@us.ibm.com> 2002
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 2 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program; if not, write to the Free Software
  20    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 */
  22
  23 #include "includes.h"
  24
  25 #ifdef HAVE_LDAP
  26
  27 /**
  28  * @file ldap.c
  29  * @brief basic ldap client-side routines for ads server communications
  30  *
  31  * The routines contained here should do the necessary ldap calls for
  32  * ads setups.
  33  *
  34  * Important note: attribute names passed into ads_ routines must
  35  * already be in UTF-8 format.  We do not convert them because in almost
  36  * all cases, they are just ascii (which is represented with the same
  37  * codepoints in UTF-8).  This may have to change at some point
  38  **/
  39
  40
  41 /*
  42   try a connection to a given ldap server, returning True and setting the servers IP
  43   in the ads struct if successful
  44
  45   TODO : add a negative connection cache in here leveraged off of the one
  46   found in the rpc code.  --jerry
  47  */
  48 static BOOL ads_try_connect(ADS_STRUCT *ads, const char *server, unsigned port)
  49 {
  50         char *srv;
  51
  52         if (!server || !*server) {
  53                 return False;
  54         }
  55
  56         DEBUG(5,("ads_try_connect: trying ldap server '%s' port %u\n", server, port));
  57
  58         /* this copes with inet_ntoa brokenness */
  59         srv = strdup(server);
  60
  61         ads->ld = ldap_open(srv, port);
  62         if (!ads->ld) {
  63                 free(srv);
  64                 return False;
  65         }
  66         ads->ldap_port = port;
  67         ads->ldap_ip = *interpret_addr2(srv);
  68         free(srv);
  69
  70         return True;
  71 }
  72
  73 /*
  74   try a connection to a given ldap server, based on URL, returning True if successful
  75  */
  76 static BOOL ads_try_connect_uri(ADS_STRUCT *ads)
  77 {
  78 #if defined(LDAP_API_FEATURE_X_OPENLDAP) && (LDAP_API_VERSION > 2000)
  79         DEBUG(5,("ads_try_connect: trying ldap server at URI '%s'\n",
  80                  ads->server.ldap_uri));
  81
  82
  83         if (ldap_initialize((LDAP**)&(ads->ld), ads->server.ldap_uri) == LDAP_SUCCESS) {
  84                 return True;
  85         }
  86         DEBUG(0, ("ldap_initialize: %s\n", strerror(errno)));
  87
  88 #else
  89
  90         DEBUG(1, ("no URL support in LDAP libs!\n"));
  91 #endif
  92
  93         return False;
  94 }
  95
  96 /**********************************************************************
  97  Try to find an AD dc using our internal name resolution routines
  98  Try the realm first and then then workgroup name if netbios is not
  99  disabled
 100 **********************************************************************/
 101
 102 static BOOL ads_find_dc(ADS_STRUCT *ads)
 103 {
 104         const char *c_realm;
 105         int count, i=0;
 106         struct ip_service *ip_list;
 107         pstring realm;
 108         BOOL got_realm = False;
 109         BOOL use_own_domain = False;
 110
 111         /* if the realm and workgroup are both empty, assume they are ours */
 112
 113         /* realm */
 114         c_realm = ads->server.realm;
 115
 116         if ( !c_realm || !*c_realm ) {
 117                 /* special case where no realm and no workgroup means our own */
 118                 if ( !ads->server.workgroup || !*ads->server.workgroup ) {
 119                         use_own_domain = True;
 120                         c_realm = lp_realm();
 121                 }
 122         }
 123
 124         if (c_realm && *c_realm)
 125                 got_realm = True;
 126
 127 again:
 128         /* we need to try once with the realm name and fallback to the
 129            netbios domain name if we fail (if netbios has not been disabled */
 130
 131         if ( !got_realm && !lp_disable_netbios() ) {
 132                 c_realm = ads->server.workgroup;
 133                 if (!c_realm || !*c_realm) {
 134                         if ( use_own_domain )
 135                                 c_realm = lp_workgroup();
 136                 }
 137
 138                 if ( !c_realm || !*c_realm ) {
 139                         DEBUG(0,("ads_find_dc: no realm or workgroup!  Don't know what to do\n"));
 140                         return False;
 141                 }
 142         }
 143
 144         pstrcpy( realm, c_realm );
 145
 146         DEBUG(6,("ads_find_dc: looking for %s '%s'\n",
 147                 (got_realm ? "realm" : "domain"), realm));
 148
 149         if ( !get_sorted_dc_list(realm, &ip_list, &count, got_realm) ) {
 150                 /* fall back to netbios if we can */
 151                 if ( got_realm && !lp_disable_netbios() ) {
 152                         got_realm = False;
 153                         goto again;
 154                 }
 155
 156                 return False;
 157         }
 158
 159         /* if we fail this loop, then giveup since all the IP addresses returned were dead */
 160         for ( i=0; i<count; i++ ) {
 161                 /* since this is an ads conection request, default to LDAP_PORT is not set */
 162                 int port = (ip_list[i].port!=PORT_NONE) ? ip_list[i].port : LDAP_PORT;
 163                 fstring server;
 164
 165                 fstrcpy( server, inet_ntoa(ip_list[i].ip) );
 166
 167                 if ( !NT_STATUS_IS_OK(check_negative_conn_cache(realm, server)) )
 168                         continue;
 169
 170                 if ( ads_try_connect(ads, server, port) ) {
 171                         SAFE_FREE(ip_list);
 172                         return True;
 173                 }
 174
 175                 /* keep track of failures */
 176                 add_failed_connection_entry( realm, server, NT_STATUS_UNSUCCESSFUL );
 177         }
 178
 179         SAFE_FREE(ip_list);
 180
 181         return False;
 182 }
 183
 184
 185 /**
 186  * Connect to the LDAP server
 187  * @param ads Pointer to an existing ADS_STRUCT
 188  * @return status of connection
 189  **/
 190 ADS_STATUS ads_connect(ADS_STRUCT *ads)
 191 {
 192         int version = LDAP_VERSION3;
 193         ADS_STATUS status;
 194
 195         ads->last_attempt = time(NULL);
 196         ads->ld = NULL;
 197
 198         /* try with a URL based server */
 199
 200         if (ads->server.ldap_uri &&
 201             ads_try_connect_uri(ads)) {
 202                 goto got_connection;
 203         }
 204
 205         /* try with a user specified server */
 206         if (ads->server.ldap_server &&
 207             ads_try_connect(ads, ads->server.ldap_server, LDAP_PORT)) {
 208                 goto got_connection;
 209         }
 210
 211         if (ads_find_dc(ads)) {
 212                 goto got_connection;
 213         }
 214
 215         return ADS_ERROR_SYSTEM(errno?errno:ENOENT);
 216
 217 got_connection:
 218         DEBUG(3,("Connected to LDAP server %s\n", inet_ntoa(ads->ldap_ip)));
 219
 220         status = ads_server_info(ads);
 221         if (!ADS_ERR_OK(status)) {
 222                 DEBUG(1,("Failed to get ldap server info\n"));
 223                 return status;
 224         }
 225
 226         ldap_set_option(ads->ld, LDAP_OPT_PROTOCOL_VERSION, &version);
 227
 228         if (!ads->auth.user_name) {
 229                 /* by default use the machine account */
 230                 fstring myname;
 231                 fstrcpy(myname, global_myname());
 232                 strlower_m(myname);
 233                 asprintf(&ads->auth.user_name, "HOST/%s", myname);
 234         }
 235
 236         if (!ads->auth.realm) {
 237                 ads->auth.realm = strdup(ads->config.realm);
 238         }
 239
 240         if (!ads->auth.kdc_server) {
 241                 ads->auth.kdc_server = strdup(inet_ntoa(ads->ldap_ip));
 242         }
 243
 244 #if KRB5_DNS_HACK
 245         /* this is a really nasty hack to avoid ADS DNS problems. It needs a patch
 246            to MIT kerberos to work (tridge) */
 247         {
 248                 char *env;
 249                 asprintf(&env, "KRB5_KDC_ADDRESS_%s", ads->config.realm);
 250                 setenv(env, ads->auth.kdc_server, 1);
 251                 free(env);
 252         }
 253 #endif
 254
 255         if (ads->auth.flags & ADS_AUTH_NO_BIND) {
 256                 return ADS_SUCCESS;
 257         }
 258
 259         if (ads->auth.flags & ADS_AUTH_ANON_BIND) {
 260                 return ADS_ERROR(ldap_simple_bind_s( ads->ld, NULL, NULL));
 261         }
 262
 263         if (ads->auth.flags & ADS_AUTH_SIMPLE_BIND) {
 264                 return ADS_ERROR(ldap_simple_bind_s( ads->ld, ads->auth.user_name, ads->auth.password));
 265         }
 266
 267         return ads_sasl_bind(ads);
 268 }
 269
 270 /*
 271   Duplicate a struct berval into talloc'ed memory
 272  */
 273 static struct berval *dup_berval(TALLOC_CTX *ctx, const struct berval *in_val)
 274 {
 275         struct berval *value;
 276
 277         if (!in_val) return NULL;
 278
 279         value = talloc_zero(ctx, sizeof(struct berval));
 280         if (value == NULL)
 281                 return NULL;
 282         if (in_val->bv_len == 0) return value;
 283
 284         value->bv_len = in_val->bv_len;
 285         value->bv_val = talloc_memdup(ctx, in_val->bv_val, in_val->bv_len);
 286         return value;
 287 }
 288
 289 /*
 290   Make a values list out of an array of (struct berval *)
 291  */
 292 static struct berval **ads_dup_values(TALLOC_CTX *ctx,
 293                                       const struct berval **in_vals)
 294 {
 295         struct berval **values;
 296         int i;
 297
 298         if (!in_vals) return NULL;
 299         for (i=0; in_vals[i]; i++); /* count values */
 300         values = (struct berval **) talloc_zero(ctx,
 301                                                 (i+1)*sizeof(struct berval *));
 302         if (!values) return NULL;
 303
 304         for (i=0; in_vals[i]; i++) {
 305                 values[i] = dup_berval(ctx, in_vals[i]);
 306         }
 307         return values;
 308 }
 309
 310 /*
 311   UTF8-encode a values list out of an array of (char *)
 312  */
 313 static char **ads_push_strvals(TALLOC_CTX *ctx, const char **in_vals)
 314 {
 315         char **values;
 316         int i;
 317
 318         if (!in_vals) return NULL;
 319         for (i=0; in_vals[i]; i++); /* count values */
 320         values = (char ** ) talloc_zero(ctx, (i+1)*sizeof(char *));
 321         if (!values) return NULL;
 322
 323         for (i=0; in_vals[i]; i++) {
 324                 push_utf8_talloc(ctx, &values[i], in_vals[i]);
 325         }
 326         return values;
 327 }
 328
 329 /*
 330   Pull a (char *) array out of a UTF8-encoded values list
 331  */
 332 static char **ads_pull_strvals(TALLOC_CTX *ctx, const char **in_vals)
 333 {
 334         char **values;
 335         int i;
 336
 337         if (!in_vals) return NULL;
 338         for (i=0; in_vals[i]; i++); /* count values */
 339         values = (char **) talloc_zero(ctx, (i+1)*sizeof(char *));
 340         if (!values) return NULL;
 341
 342         for (i=0; in_vals[i]; i++) {
 343                 pull_utf8_talloc(ctx, &values[i], in_vals[i]);
 344         }
 345         return values;
 346 }
 347
 348 /**
 349  * Do a search with paged results.  cookie must be null on the first
 350  *  call, and then returned on each subsequent call.  It will be null
 351  *  again when the entire search is complete
 352  * @param ads connection to ads server
 353  * @param bind_path Base dn for the search
 354  * @param scope Scope of search (LDAP_SCOPE_BASE | LDAP_SCOPE_ONE | LDAP_SCOPE_SUBTREE)
 355  * @param expr Search expression - specified in local charset
 356  * @param attrs Attributes to retrieve - specified in utf8 or ascii
 357  * @param res ** which will contain results - free res* with ads_msgfree()
 358  * @param count Number of entries retrieved on this page
 359  * @param cookie The paged results cookie to be returned on subsequent calls
 360  * @return status of search
 361  **/
 362 ADS_STATUS ads_do_paged_search(ADS_STRUCT *ads, const char *bind_path,
 363                                int scope, const char *expr,
 364                                const char **attrs, void **res,
 365                                int *count, void **cookie)
 366 {
 367         int rc, i, version;
 368         char *utf8_expr, *utf8_path, **search_attrs;
 369         LDAPControl PagedResults, NoReferrals, *controls[3], **rcontrols;
 370         BerElement *cookie_be = NULL;
 371         struct berval *cookie_bv= NULL;
 372         TALLOC_CTX *ctx;
 373
 374         *res = NULL;
 375
 376         if (!(ctx = talloc_init("ads_do_paged_search")))
 377                 return ADS_ERROR(LDAP_NO_MEMORY);
 378
 379         /* 0 means the conversion worked but the result was empty
 380            so we only fail if it's -1.  In any case, it always
 381            at least nulls out the dest */
 382         if ((push_utf8_talloc(ctx, &utf8_expr, expr) == (size_t)-1) ||
 383             (push_utf8_talloc(ctx, &utf8_path, bind_path) == (size_t)-1)) {
 384                 rc = LDAP_NO_MEMORY;
 385                 goto done;
 386         }
 387
 388         if (!attrs || !(*attrs))
 389                 search_attrs = NULL;
 390         else {
 391                 /* This would be the utf8-encoded version...*/
 392                 /* if (!(search_attrs = ads_push_strvals(ctx, attrs))) */
 393                 if (!(str_list_copy(&search_attrs, attrs))) {
 394                         rc = LDAP_NO_MEMORY;
 395                         goto done;
 396                 }
 397         }
 398
 399
 400         /* Paged results only available on ldap v3 or later */
 401         ldap_get_option(ads->ld, LDAP_OPT_PROTOCOL_VERSION, &version);
 402         if (version < LDAP_VERSION3) {
 403                 rc =  LDAP_NOT_SUPPORTED;
 404                 goto done;
 405         }
 406
 407         cookie_be = ber_alloc_t(LBER_USE_DER);
 408         if (cookie && *cookie) {
 409                 ber_printf(cookie_be, "{iO}", (ber_int_t) 1000, *cookie);
 410                 ber_bvfree(*cookie); /* don't need it from last time */
 411                 *cookie = NULL;
 412         } else {
 413                 ber_printf(cookie_be, "{io}", (ber_int_t) 1000, "", 0);
 414         }
 415         ber_flatten(cookie_be, &cookie_bv);
 416         PagedResults.ldctl_oid = ADS_PAGE_CTL_OID;
 417         PagedResults.ldctl_iscritical = (char) 1;
 418         PagedResults.ldctl_value.bv_len = cookie_bv->bv_len;
 419         PagedResults.ldctl_value.bv_val = cookie_bv->bv_val;
 420
 421         NoReferrals.ldctl_oid = ADS_NO_REFERRALS_OID;
 422         NoReferrals.ldctl_iscritical = (char) 0;
 423         NoReferrals.ldctl_value.bv_len = 0;
 424         NoReferrals.ldctl_value.bv_val = "";
 425
 426
 427         controls[0] = &NoReferrals;
 428         controls[1] = &PagedResults;
 429         controls[2] = NULL;
 430
 431         *res = NULL;
 432
 433         /* we need to disable referrals as the openldap libs don't
 434            handle them and paged results at the same time.  Using them
 435            together results in the result record containing the server
 436            page control being removed from the result list (tridge/jmcd)
 437
 438            leaving this in despite the control that says don't generate
 439            referrals, in case the server doesn't support it (jmcd)
 440         */
 441         ldap_set_option(ads->ld, LDAP_OPT_REFERRALS, LDAP_OPT_OFF);
 442
 443         rc = ldap_search_ext_s(ads->ld, utf8_path, scope, utf8_expr,
 444                                search_attrs, 0, controls,
 445                                NULL, NULL, LDAP_NO_LIMIT, (LDAPMessage **)res);
 446
 447         ber_free(cookie_be, 1);
 448         ber_bvfree(cookie_bv);
 449
 450         if (rc) {
 451                 DEBUG(3,("ldap_search_ext_s(%s) -> %s\n", expr, ldap_err2string(rc)));
 452                 goto done;
 453         }
 454
 455         rc = ldap_parse_result(ads->ld, *res, NULL, NULL, NULL,
 456                                         NULL, &rcontrols,  0);
 457
 458         if (!rcontrols) {
 459                 goto done;
 460         }
 461
 462         for (i=0; rcontrols[i]; i++) {
 463                 if (strcmp(ADS_PAGE_CTL_OID, rcontrols[i]->ldctl_oid) == 0) {
 464                         cookie_be = ber_init(&rcontrols[i]->ldctl_value);
 465                         ber_scanf(cookie_be,"{iO}", (ber_int_t *) count,
 466                                   &cookie_bv);
 467                         /* the berval is the cookie, but must be freed when
 468                            it is all done */
 469                         if (cookie_bv->bv_len) /* still more to do */
 470                                 *cookie=ber_bvdup(cookie_bv);
 471                         else
 472                                 *cookie=NULL;
 473                         ber_bvfree(cookie_bv);
 474                         ber_free(cookie_be, 1);
 475                         break;
 476                 }
 477         }
 478         ldap_controls_free(rcontrols);
 479
 480 done:
 481         talloc_destroy(ctx);
 482         /* if/when we decide to utf8-encode attrs, take out this next line */
 483         str_list_free(&search_attrs);
 484
 485         return ADS_ERROR(rc);
 486 }
 487
 488
 489 /**
 490  * Get all results for a search.  This uses ads_do_paged_search() to return
 491  * all entries in a large search.
 492  * @param ads connection to ads server
 493  * @param bind_path Base dn for the search
 494  * @param scope Scope of search (LDAP_SCOPE_BASE | LDAP_SCOPE_ONE | LDAP_SCOPE_SUBTREE)
 495  * @param expr Search expression
 496  * @param attrs Attributes to retrieve
 497  * @param res ** which will contain results - free res* with ads_msgfree()
 498  * @return status of search
 499  **/
 500 ADS_STATUS ads_do_search_all(ADS_STRUCT *ads, const char *bind_path,
 501                              int scope, const char *expr,
 502                              const char **attrs, void **res)
 503 {
 504         void *cookie = NULL;
 505         int count = 0;
 506         ADS_STATUS status;
 507
 508         status = ads_do_paged_search(ads, bind_path, scope, expr, attrs, res,
 509                                      &count, &cookie);
 510
 511         if (!ADS_ERR_OK(status)) return status;
 512
 513         while (cookie) {
 514                 void *res2 = NULL;
 515                 ADS_STATUS status2;
 516                 LDAPMessage *msg, *next;
 517
 518                 status2 = ads_do_paged_search(ads, bind_path, scope, expr,
 519                                               attrs, &res2, &count, &cookie);
 520
 521                 if (!ADS_ERR_OK(status2)) break;
 522
 523                 /* this relies on the way that ldap_add_result_entry() works internally. I hope
 524                    that this works on all ldap libs, but I have only tested with openldap */
 525                 for (msg = ads_first_entry(ads, res2); msg; msg = next) {
 526                         next = ads_next_entry(ads, msg);
 527                         ldap_add_result_entry((LDAPMessage **)res, msg);
 528                 }
 529                 /* note that we do not free res2, as the memory is now
 530                    part of the main returned list */
 531         }
 532
 533         return status;
 534 }
 535
 536 /**
 537  * Run a function on all results for a search.  Uses ads_do_paged_search() and
 538  *  runs the function as each page is returned, using ads_process_results()
 539  * @param ads connection to ads server
 540  * @param bind_path Base dn for the search
 541  * @param scope Scope of search (LDAP_SCOPE_BASE | LDAP_SCOPE_ONE | LDAP_SCOPE_SUBTREE)
 542  * @param expr Search expression - specified in local charset
 543  * @param attrs Attributes to retrieve - specified in UTF-8 or ascii
 544  * @param fn Function which takes attr name, values list, and data_area
 545  * @param data_area Pointer which is passed to function on each call
 546  * @return status of search
 547  **/
 548 ADS_STATUS ads_do_search_all_fn(ADS_STRUCT *ads, const char *bind_path,
 549                                 int scope, const char *expr, const char **attrs,
 550                                 BOOL(*fn)(char *, void **, void *),
 551                                 void *data_area)
 552 {
 553         void *cookie = NULL;
 554         int count = 0;
 555         ADS_STATUS status;
 556         void *res;
 557
 558         status = ads_do_paged_search(ads, bind_path, scope, expr, attrs, &res,
 559                                      &count, &cookie);
 560
 561         if (!ADS_ERR_OK(status)) return status;
 562
 563         ads_process_results(ads, res, fn, data_area);
 564         ads_msgfree(ads, res);
 565
 566         while (cookie) {
 567                 status = ads_do_paged_search(ads, bind_path, scope, expr, attrs,
 568                                              &res, &count, &cookie);
 569
 570                 if (!ADS_ERR_OK(status)) break;
 571
 572                 ads_process_results(ads, res, fn, data_area);
 573                 ads_msgfree(ads, res);
 574         }
 575
 576         return status;
 577 }
 578
 579 /**
 580  * Do a search with a timeout.
 581  * @param ads connection to ads server
 582  * @param bind_path Base dn for the search
 583  * @param scope Scope of search (LDAP_SCOPE_BASE | LDAP_SCOPE_ONE | LDAP_SCOPE_SUBTREE)
 584  * @param expr Search expression
 585  * @param attrs Attributes to retrieve
 586  * @param res ** which will contain results - free res* with ads_msgfree()
 587  * @return status of search
 588  **/
 589 ADS_STATUS ads_do_search(ADS_STRUCT *ads, const char *bind_path, int scope,
 590                          const char *expr,
 591                          const char **attrs, void **res)
 592 {
 593         struct timeval timeout;
 594         int rc;
 595         char *utf8_expr, *utf8_path, **search_attrs = NULL;
 596         TALLOC_CTX *ctx;
 597
 598         if (!(ctx = talloc_init("ads_do_search"))) {
 599                 DEBUG(1,("ads_do_search: talloc_init() failed!"));
 600                 return ADS_ERROR(LDAP_NO_MEMORY);
 601         }
 602
 603         /* 0 means the conversion worked but the result was empty
 604            so we only fail if it's negative.  In any case, it always
 605            at least nulls out the dest */
 606         if ((push_utf8_talloc(ctx, &utf8_expr, expr) == (size_t)-1) ||
 607             (push_utf8_talloc(ctx, &utf8_path, bind_path) == (size_t)-1)) {
 608                 DEBUG(1,("ads_do_search: push_utf8_talloc() failed!"));
 609                 rc = LDAP_NO_MEMORY;
 610                 goto done;
 611         }
 612
 613         if (!attrs || !(*attrs))
 614                 search_attrs = NULL;
 615         else {
 616                 /* This would be the utf8-encoded version...*/
 617                 /* if (!(search_attrs = ads_push_strvals(ctx, attrs)))  */
 618                 if (!(str_list_copy(&search_attrs, attrs)))
 619                 {
 620                         DEBUG(1,("ads_do_search: str_list_copy() failed!"));
 621                         rc = LDAP_NO_MEMORY;
 622                         goto done;
 623                 }
 624         }
 625
 626         timeout.tv_sec = ADS_SEARCH_TIMEOUT;
 627         timeout.tv_usec = 0;
 628         *res = NULL;
 629
 630         /* see the note in ads_do_paged_search - we *must* disable referrals */
 631         ldap_set_option(ads->ld, LDAP_OPT_REFERRALS, LDAP_OPT_OFF);
 632
 633         rc = ldap_search_ext_s(ads->ld, utf8_path, scope, utf8_expr,
 634                                search_attrs, 0, NULL, NULL,
 635                                &timeout, LDAP_NO_LIMIT, (LDAPMessage **)res);
 636
 637         if (rc == LDAP_SIZELIMIT_EXCEEDED) {
 638                 DEBUG(3,("Warning! sizelimit exceeded in ldap. Truncating.\n"));
 639                 rc = 0;
 640         }
 641
 642  done:
 643         talloc_destroy(ctx);
 644         /* if/when we decide to utf8-encode attrs, take out this next line */
 645         str_list_free(&search_attrs);
 646         return ADS_ERROR(rc);
 647 }
 648 /**
 649  * Do a general ADS search
 650  * @param ads connection to ads server
 651  * @param res ** which will contain results - free res* with ads_msgfree()
 652  * @param expr Search expression
 653  * @param attrs Attributes to retrieve
 654  * @return status of search
 655  **/
 656 ADS_STATUS ads_search(ADS_STRUCT *ads, void **res,
 657                       const char *expr,
 658                       const char **attrs)
 659 {
 660         return ads_do_search(ads, ads->config.bind_path, LDAP_SCOPE_SUBTREE,
 661                              expr, attrs, res);
 662 }
 663
 664 /**
 665  * Do a search on a specific DistinguishedName
 666  * @param ads connection to ads server
 667  * @param res ** which will contain results - free res* with ads_msgfree()
 668  * @param dn DistinguishName to search
 669  * @param attrs Attributes to retrieve
 670  * @return status of search
 671  **/
 672 ADS_STATUS ads_search_dn(ADS_STRUCT *ads, void **res,
 673                          const char *dn,
 674                          const char **attrs)
 675 {
 676         return ads_do_search(ads, dn, LDAP_SCOPE_BASE, "(objectclass=*)", attrs, res);
 677 }
 678
 679 /**
 680  * Free up memory from a ads_search
 681  * @param ads connection to ads server
 682  * @param msg Search results to free
 683  **/
 684 void ads_msgfree(ADS_STRUCT *ads, void *msg)
 685 {
 686         if (!msg) return;
 687         ldap_msgfree(msg);
 688 }
 689
 690 /**
 691  * Free up memory from various ads requests
 692  * @param ads connection to ads server
 693  * @param mem Area to free
 694  **/
 695 void ads_memfree(ADS_STRUCT *ads, void *mem)
 696 {
 697         SAFE_FREE(mem);
 698 }
 699
 700 /**
 701  * Get a dn from search results
 702  * @param ads connection to ads server
 703  * @param msg Search result
 704  * @return dn string
 705  **/
 706 char *ads_get_dn(ADS_STRUCT *ads, void *msg)
 707 {
 708         char *utf8_dn, *unix_dn;
 709
 710         utf8_dn = ldap_get_dn(ads->ld, msg);
 711
 712         if (!utf8_dn) {
 713                 DEBUG (5, ("ads_get_dn: ldap_get_dn failed\n"));
 714                 return NULL;
 715         }
 716
 717         if (pull_utf8_allocate((void **) &unix_dn, utf8_dn) == (size_t)-1) {
 718                 DEBUG(0,("ads_get_dn: string conversion failure utf8 [%s]\n",
 719                         utf8_dn ));
 720                 return NULL;
 721         }
 722         ldap_memfree(utf8_dn);
 723         return unix_dn;
 724 }
 725
 726 /**
 727  * Find a machine account given a hostname
 728  * @param ads connection to ads server
 729  * @param res ** which will contain results - free res* with ads_msgfree()
 730  * @param host Hostname to search for
 731  * @return status of search
 732  **/
 733 ADS_STATUS ads_find_machine_acct(ADS_STRUCT *ads, void **res, const char *host)
 734 {
 735         ADS_STATUS status;
 736         char *expr;
 737         const char *attrs[] = {"*", "nTSecurityDescriptor", NULL};
 738
 739         /* the easiest way to find a machine account anywhere in the tree
 740            is to look for hostname$ */
 741         if (asprintf(&expr, "(samAccountName=%s$)", host) == -1) {
 742                 DEBUG(1, ("asprintf failed!\n"));
 743                 return ADS_ERROR_NT(NT_STATUS_NO_MEMORY);
 744         }
 745
 746         status = ads_search(ads, res, expr, attrs);
 747         free(expr);
 748         return status;
 749 }
 750
 751 /**
 752  * Initialize a list of mods to be used in a modify request
 753  * @param ctx An initialized TALLOC_CTX
 754  * @return allocated ADS_MODLIST
 755  **/
 756 ADS_MODLIST ads_init_mods(TALLOC_CTX *ctx)
 757 {
 758 #define ADS_MODLIST_ALLOC_SIZE 10
 759         LDAPMod **mods;
 760
 761         if ((mods = (LDAPMod **) talloc_zero(ctx, sizeof(LDAPMod *) *
 762                                              (ADS_MODLIST_ALLOC_SIZE + 1))))
 763                 /* -1 is safety to make sure we don't go over the end.
 764                    need to reset it to NULL before doing ldap modify */
 765                 mods[ADS_MODLIST_ALLOC_SIZE] = (LDAPMod *) -1;
 766
 767         return mods;
 768 }
 769
 770
 771 /*
 772   add an attribute to the list, with values list already constructed
 773 */
 774 static ADS_STATUS ads_modlist_add(TALLOC_CTX *ctx, ADS_MODLIST *mods,
 775                                   int mod_op, const char *name,
 776                                   const void **invals)
 777 {
 778         int curmod;
 779         LDAPMod **modlist = (LDAPMod **) *mods;
 780         struct berval **ber_values = NULL;
 781         char **char_values = NULL;
 782
 783         if (!invals) {
 784                 mod_op = LDAP_MOD_DELETE;
 785         } else {
 786                 if (mod_op & LDAP_MOD_BVALUES)
 787                         ber_values = ads_dup_values(ctx,
 788                                                 (const struct berval **)invals);
 789                 else
 790                         char_values = ads_push_strvals(ctx,
 791                                                   (const char **) invals);
 792         }
 793
 794         /* find the first empty slot */
 795         for (curmod=0; modlist[curmod] && modlist[curmod] != (LDAPMod *) -1;
 796              curmod++);
 797         if (modlist[curmod] == (LDAPMod *) -1) {
 798                 if (!(modlist = talloc_realloc(ctx, modlist,
 799                         (curmod+ADS_MODLIST_ALLOC_SIZE+1)*sizeof(LDAPMod *))))
 800                         return ADS_ERROR(LDAP_NO_MEMORY);
 801                 memset(&modlist[curmod], 0,
 802                        ADS_MODLIST_ALLOC_SIZE*sizeof(LDAPMod *));
 803                 modlist[curmod+ADS_MODLIST_ALLOC_SIZE] = (LDAPMod *) -1;
 804                 *mods = modlist;
 805         }
 806
 807         if (!(modlist[curmod] = talloc_zero(ctx, sizeof(LDAPMod))))
 808                 return ADS_ERROR(LDAP_NO_MEMORY);
 809         modlist[curmod]->mod_type = talloc_strdup(ctx, name);
 810         if (mod_op & LDAP_MOD_BVALUES) {
 811                 modlist[curmod]->mod_bvalues = ber_values;
 812         } else if (mod_op & LDAP_MOD_DELETE) {
 813                 modlist[curmod]->mod_values = NULL;
 814         } else {
 815                 modlist[curmod]->mod_values = char_values;
 816         }
 817
 818         modlist[curmod]->mod_op = mod_op;
 819         return ADS_ERROR(LDAP_SUCCESS);
 820 }
 821
 822 /**
 823  * Add a single string value to a mod list
 824  * @param ctx An initialized TALLOC_CTX
 825  * @param mods An initialized ADS_MODLIST
 826  * @param name The attribute name to add
 827  * @param val The value to add - NULL means DELETE
 828  * @return ADS STATUS indicating success of add
 829  **/
 830 ADS_STATUS ads_mod_str(TALLOC_CTX *ctx, ADS_MODLIST *mods,
 831                        const char *name, const char *val)
 832 {
 833         const char *values[2];
 834
 835         values[0] = val;
 836         values[1] = NULL;
 837
 838         if (!val)
 839                 return ads_modlist_add(ctx, mods, LDAP_MOD_DELETE, name, NULL);
 840         return ads_modlist_add(ctx, mods, LDAP_MOD_REPLACE, name,
 841                                (const void **) values);
 842 }
 843
 844 /**
 845  * Add an array of string values to a mod list
 846  * @param ctx An initialized TALLOC_CTX
 847  * @param mods An initialized ADS_MODLIST
 848  * @param name The attribute name to add
 849  * @param vals The array of string values to add - NULL means DELETE
 850  * @return ADS STATUS indicating success of add
 851  **/
 852 ADS_STATUS ads_mod_strlist(TALLOC_CTX *ctx, ADS_MODLIST *mods,
 853                            const char *name, const char **vals)
 854 {
 855         if (!vals)
 856                 return ads_modlist_add(ctx, mods, LDAP_MOD_DELETE, name, NULL);
 857         return ads_modlist_add(ctx, mods, LDAP_MOD_REPLACE,
 858                                name, (const void **) vals);
 859 }
 860
 861 /**
 862  * Add a single ber-encoded value to a mod list
 863  * @param ctx An initialized TALLOC_CTX
 864  * @param mods An initialized ADS_MODLIST
 865  * @param name The attribute name to add
 866  * @param val The value to add - NULL means DELETE
 867  * @return ADS STATUS indicating success of add
 868  **/
 869 static ADS_STATUS ads_mod_ber(TALLOC_CTX *ctx, ADS_MODLIST *mods,
 870                               const char *name, const struct berval *val)
 871 {
 872         const struct berval *values[2];
 873
 874         values[0] = val;
 875         values[1] = NULL;
 876         if (!val)
 877                 return ads_modlist_add(ctx, mods, LDAP_MOD_DELETE, name, NULL);
 878         return ads_modlist_add(ctx, mods, LDAP_MOD_REPLACE|LDAP_MOD_BVALUES,
 879                                name, (const void **) values);
 880 }
 881
 882 /**
 883  * Perform an ldap modify
 884  * @param ads connection to ads server
 885  * @param mod_dn DistinguishedName to modify
 886  * @param mods list of modifications to perform
 887  * @return status of modify
 888  **/
 889 ADS_STATUS ads_gen_mod(ADS_STRUCT *ads, const char *mod_dn, ADS_MODLIST mods)
 890 {
 891         int ret,i;
 892         char *utf8_dn = NULL;
 893         /*
 894            this control is needed to modify that contains a currently
 895            non-existent attribute (but allowable for the object) to run
 896         */
 897         LDAPControl PermitModify = {
 898                 ADS_PERMIT_MODIFY_OID,
 899                 {0, NULL},
 900                 (char) 1};
 901         LDAPControl *controls[2];
 902
 903         controls[0] = &PermitModify;
 904         controls[1] = NULL;
 905
 906         if (push_utf8_allocate(&utf8_dn, mod_dn) == -1) {
 907                 return ADS_ERROR_NT(NT_STATUS_NO_MEMORY);
 908         }
 909
 910         /* find the end of the list, marked by NULL or -1 */
 911         for(i=0;(mods[i]!=0)&&(mods[i]!=(LDAPMod *) -1);i++);
 912         /* make sure the end of the list is NULL */
 913         mods[i] = NULL;
 914         ret = ldap_modify_ext_s(ads->ld, utf8_dn,
 915                                 (LDAPMod **) mods, controls, NULL);
 916         SAFE_FREE(utf8_dn);
 917         return ADS_ERROR(ret);
 918 }
 919
 920 /**
 921  * Perform an ldap add
 922  * @param ads connection to ads server
 923  * @param new_dn DistinguishedName to add
 924  * @param mods list of attributes and values for DN
 925  * @return status of add
 926  **/
 927 ADS_STATUS ads_gen_add(ADS_STRUCT *ads, const char *new_dn, ADS_MODLIST mods)
 928 {
 929         int ret, i;
 930         char *utf8_dn = NULL;
 931
 932         if (push_utf8_allocate(&utf8_dn, new_dn) == -1) {
 933                 DEBUG(1, ("ads_gen_add: push_utf8_allocate failed!"));
 934                 return ADS_ERROR_NT(NT_STATUS_NO_MEMORY);
 935         }
 936
 937         /* find the end of the list, marked by NULL or -1 */
 938         for(i=0;(mods[i]!=0)&&(mods[i]!=(LDAPMod *) -1);i++);
 939         /* make sure the end of the list is NULL */
 940         mods[i] = NULL;
 941
 942         ret = ldap_add_s(ads->ld, utf8_dn, mods);
 943         SAFE_FREE(utf8_dn);
 944         return ADS_ERROR(ret);
 945 }
 946
 947 /**
 948  * Delete a DistinguishedName
 949  * @param ads connection to ads server
 950  * @param new_dn DistinguishedName to delete
 951  * @return status of delete
 952  **/
 953 ADS_STATUS ads_del_dn(ADS_STRUCT *ads, char *del_dn)
 954 {
 955         int ret;
 956         char *utf8_dn = NULL;
 957         if (push_utf8_allocate(&utf8_dn, del_dn) == -1) {
 958                 DEBUG(1, ("ads_del_dn: push_utf8_allocate failed!"));
 959                 return ADS_ERROR_NT(NT_STATUS_NO_MEMORY);
 960         }
 961
 962         ret = ldap_delete_s(ads->ld, utf8_dn);
 963         return ADS_ERROR(ret);
 964 }
 965
 966 /**
 967  * Build an org unit string
 968  *  if org unit is Computers or blank then assume a container, otherwise
 969  *  assume a \ separated list of organisational units
 970  * @param org_unit Organizational unit
 971  * @return org unit string - caller must free
 972  **/
 973 char *ads_ou_string(const char *org_unit)
 974 {
 975         if (!org_unit || !*org_unit || strequal(org_unit, "Computers")) {
 976                 return strdup("cn=Computers");
 977         }
 978
 979         return ads_build_path(org_unit, "\\/", "ou=", 1);
 980 }
 981
 982
 983
 984 /*
 985   add a machine account to the ADS server
 986 */
 987 static ADS_STATUS ads_add_machine_acct(ADS_STRUCT *ads, const char *hostname,
 988                                        uint32 account_type,
 989                                        const char *org_unit)
 990 {
 991         ADS_STATUS ret, status;
 992         char *host_spn, *host_upn, *new_dn, *samAccountName, *controlstr;
 993         char *ou_str;
 994         TALLOC_CTX *ctx;
 995         ADS_MODLIST mods;
 996         const char *objectClass[] = {"top", "person", "organizationalPerson",
 997                                      "user", "computer", NULL};
 998         const char *servicePrincipalName[5] = {NULL, NULL, NULL, NULL, NULL};
 999         char *psp, *psp2;
1000         unsigned acct_control;
1001
1002         if (!(ctx = talloc_init("machine_account")))
1003                 return ADS_ERROR(LDAP_NO_MEMORY);
1004
1005         ret = ADS_ERROR(LDAP_NO_MEMORY);
1006
1007         if (!(host_spn = talloc_asprintf(ctx, "HOST/%s", hostname)))
1008                 goto done;
1009         if (!(host_upn = talloc_asprintf(ctx, "%s@%s", host_spn, ads->config.realm)))
1010                 goto done;
1011         ou_str = ads_ou_string(org_unit);
1012         if (!ou_str) {
1013                 DEBUG(1, ("ads_ou_string returned NULL (malloc failure?)\n"));
1014                 goto done;
1015         }
1016         new_dn = talloc_asprintf(ctx, "cn=%s,%s,%s", hostname, ou_str,
1017                                  ads->config.bind_path);
1018         servicePrincipalName[0] = talloc_asprintf(ctx, "HOST/%s", hostname);
1019         psp = talloc_asprintf(ctx, "HOST/%s.%s",
1020                               hostname,
1021                               ads->config.realm);
1022         strlower_m(&psp[5]);
1023         servicePrincipalName[1] = psp;
1024         servicePrincipalName[2] = talloc_asprintf(ctx, "CIFS/%s", hostname);
1025         psp2 = talloc_asprintf(ctx, "CIFS/%s.%s",
1026                                hostname,
1027                                ads->config.realm);
1028         strlower_m(&psp2[5]);
1029         servicePrincipalName[3] = psp2;
1030
1031         free(ou_str);
1032         if (!new_dn)
1033                 goto done;
1034
1035         if (!(samAccountName = talloc_asprintf(ctx, "%s$", hostname)))
1036                 goto done;
1037
1038         acct_control = account_type | UF_DONT_EXPIRE_PASSWD;
1039 #ifndef ENCTYPE_ARCFOUR_HMAC
1040         acct_control |= UF_USE_DES_KEY_ONLY;
1041 #endif
1042
1043         if (!(controlstr = talloc_asprintf(ctx, "%u", acct_control)))
1044                 goto done;
1045
1046         if (!(mods = ads_init_mods(ctx)))
1047                 goto done;
1048
1049         ads_mod_str(ctx, &mods, "cn", hostname);
1050         ads_mod_str(ctx, &mods, "sAMAccountName", samAccountName);
1051         ads_mod_strlist(ctx, &mods, "objectClass", objectClass);
1052         ads_mod_str(ctx, &mods, "userPrincipalName", host_upn);
1053         ads_mod_strlist(ctx, &mods, "servicePrincipalName", servicePrincipalName);
1054         ads_mod_str(ctx, &mods, "dNSHostName", hostname);
1055         ads_mod_str(ctx, &mods, "userAccountControl", controlstr);
1056         ads_mod_str(ctx, &mods, "operatingSystem", "Samba");
1057         ads_mod_str(ctx, &mods, "operatingSystemVersion", SAMBA_VERSION_STRING);
1058
1059         ret = ads_gen_add(ads, new_dn, mods);
1060
1061         if (!ADS_ERR_OK(ret))
1062                 goto done;
1063
1064         /* Do not fail if we can't set security descriptor
1065          * it shouldn't be mandatory and probably we just
1066          * don't have enough rights to do it.
1067          */
1068         status = ads_set_machine_sd(ads, hostname, new_dn);
1069
1070         if (!ADS_ERR_OK(status)) {
1071                 DEBUG(0, ("Warning: ads_set_machine_sd: %s\n",
1072                                 ads_errstr(status)));
1073         }
1074 done:
1075         talloc_destroy(ctx);
1076         return ret;
1077 }
1078
1079 /*
1080   dump a binary result from ldap
1081 */
1082 static void dump_binary(const char *field, struct berval **values)
1083 {
1084         int i, j;
1085         for (i=0; values[i]; i++) {
1086                 printf("%s: ", field);
1087                 for (j=0; j<values[i]->bv_len; j++) {
1088                         printf("%02X", (unsigned char)values[i]->bv_val[j]);
1089                 }
1090                 printf("\n");
1091         }
1092 }
1093
1094 static void dump_guid(const char *field, struct berval **values)
1095 {
1096         int i;
1097         UUID_FLAT guid;
1098         for (i=0; values[i]; i++) {
1099                 memcpy(guid.info, values[i]->bv_val, sizeof(guid.info));
1100                 printf("%s: %s\n", field,
1101                        smb_uuid_string_static(smb_uuid_unpack_static(guid)));
1102         }
1103 }
1104
1105 /*
1106   dump a sid result from ldap
1107 */
1108 static void dump_sid(const char *field, struct berval **values)
1109 {
1110         int i;
1111         for (i=0; values[i]; i++) {
1112                 DOM_SID sid;
1113                 sid_parse(values[i]->bv_val, values[i]->bv_len, &sid);
1114                 printf("%s: %s\n", field, sid_string_static(&sid));
1115         }
1116 }
1117
1118 /*
1119   dump ntSecurityDescriptor
1120 */
1121 static void dump_sd(const char *filed, struct berval **values)
1122 {
1123         prs_struct ps;
1124
1125         SEC_DESC   *psd = 0;
1126         TALLOC_CTX *ctx = 0;
1127
1128         if (!(ctx = talloc_init("sec_io_desc")))
1129                 return;
1130
1131         /* prepare data */
1132         prs_init(&ps, values[0]->bv_len, ctx, UNMARSHALL);
1133         prs_copy_data_in(&ps, values[0]->bv_val, values[0]->bv_len);
1134         prs_set_offset(&ps,0);
1135
1136         /* parse secdesc */
1137         if (!sec_io_desc("sd", &psd, &ps, 1)) {
1138                 prs_mem_free(&ps);
1139                 talloc_destroy(ctx);
1140                 return;
1141         }
1142         if (psd) ads_disp_sd(psd);
1143
1144         prs_mem_free(&ps);
1145         talloc_destroy(ctx);
1146 }
1147
1148 /*
1149   dump a string result from ldap
1150 */
1151 static void dump_string(const char *field, char **values)
1152 {
1153         int i;
1154         for (i=0; values[i]; i++) {
1155                 printf("%s: %s\n", field, values[i]);
1156         }
1157 }
1158
1159 /*
1160   dump a field from LDAP on stdout
1161   used for debugging
1162 */
1163
1164 static BOOL ads_dump_field(char *field, void **values, void *data_area)
1165 {
1166         const struct {
1167                 const char *name;
1168                 BOOL string;
1169                 void (*handler)(const char *, struct berval **);
1170         } handlers[] = {
1171                 {"objectGUID", False, dump_guid},
1172                 {"nTSecurityDescriptor", False, dump_sd},
1173                 {"dnsRecord", False, dump_binary},
1174                 {"objectSid", False, dump_sid},
1175                 {"tokenGroups", False, dump_sid},
1176                 {NULL, True, NULL}
1177         };
1178         int i;
1179
1180         if (!field) { /* must be end of an entry */
1181                 printf("\n");
1182                 return False;
1183         }
1184
1185         for (i=0; handlers[i].name; i++) {
1186                 if (StrCaseCmp(handlers[i].name, field) == 0) {
1187                         if (!values) /* first time, indicate string or not */
1188                                 return handlers[i].string;
1189                         handlers[i].handler(field, (struct berval **) values);
1190                         break;
1191                 }
1192         }
1193         if (!handlers[i].name) {
1194                 if (!values) /* first time, indicate string conversion */
1195                         return True;
1196                 dump_string(field, (char **)values);
1197         }
1198         return False;
1199 }
1200
1201 /**
1202  * Dump a result from LDAP on stdout
1203  *  used for debugging
1204  * @param ads connection to ads server
1205  * @param res Results to dump
1206  **/
1207
1208 void ads_dump(ADS_STRUCT *ads, void *res)
1209 {
1210         ads_process_results(ads, res, ads_dump_field, NULL);
1211 }
1212
1213 /**
1214  * Walk through results, calling a function for each entry found.
1215  *  The function receives a field name, a berval * array of values,
1216  *  and a data area passed through from the start.  The function is
1217  *  called once with null for field and values at the end of each
1218  *  entry.
1219  * @param ads connection to ads server
1220  * @param res Results to process
1221  * @param fn Function for processing each result
1222  * @param data_area user-defined area to pass to function
1223  **/
1224 void ads_process_results(ADS_STRUCT *ads, void *res,
1225                          BOOL(*fn)(char *, void **, void *),
1226                          void *data_area)
1227 {
1228         void *msg;
1229         TALLOC_CTX *ctx;
1230
1231         if (!(ctx = talloc_init("ads_process_results")))
1232                 return;
1233
1234         for (msg = ads_first_entry(ads, res); msg;
1235              msg = ads_next_entry(ads, msg)) {
1236                 char *utf8_field;
1237                 BerElement *b;
1238
1239                 for (utf8_field=ldap_first_attribute(ads->ld,
1240                                                      (LDAPMessage *)msg,&b);
1241                      utf8_field;
1242                      utf8_field=ldap_next_attribute(ads->ld,
1243                                                     (LDAPMessage *)msg,b)) {
1244                         struct berval **ber_vals;
1245                         char **str_vals, **utf8_vals;
1246                         char *field;
1247                         BOOL string;
1248
1249                         pull_utf8_talloc(ctx, &field, utf8_field);
1250                         string = fn(field, NULL, data_area);
1251
1252                         if (string) {
1253                                 utf8_vals = ldap_get_values(ads->ld,
1254                                                  (LDAPMessage *)msg, field);
1255                                 str_vals = ads_pull_strvals(ctx,
1256                                                   (const char **) utf8_vals);
1257                                 fn(field, (void **) str_vals, data_area);
1258                                 ldap_value_free(utf8_vals);
1259                         } else {
1260                                 ber_vals = ldap_get_values_len(ads->ld,
1261                                                  (LDAPMessage *)msg, field);
1262                                 fn(field, (void **) ber_vals, data_area);
1263
1264                                 ldap_value_free_len(ber_vals);
1265                         }
1266                         ldap_memfree(utf8_field);
1267                 }
1268                 ber_free(b, 0);
1269                 talloc_destroy_pool(ctx);
1270                 fn(NULL, NULL, data_area); /* completed an entry */
1271
1272         }
1273         talloc_destroy(ctx);
1274 }
1275
1276 /**
1277  * count how many replies are in a LDAPMessage
1278  * @param ads connection to ads server
1279  * @param res Results to count
1280  * @return number of replies
1281  **/
1282 int ads_count_replies(ADS_STRUCT *ads, void *res)
1283 {
1284         return ldap_count_entries(ads->ld, (LDAPMessage *)res);
1285 }
1286
1287 /**
1288  * Join a machine to a realm
1289  *  Creates the machine account and sets the machine password
1290  * @param ads connection to ads server
1291  * @param hostname name of host to add
1292  * @param org_unit Organizational unit to place machine in
1293  * @return status of join
1294  **/
1295 ADS_STATUS ads_join_realm(ADS_STRUCT *ads, const char *hostname,
1296                           uint32 account_type, const char *org_unit)
1297 {
1298         ADS_STATUS status;
1299         LDAPMessage *res;
1300         char *host;
1301
1302         /* hostname must be lowercase */
1303         host = strdup(hostname);
1304         strlower_m(host);
1305
1306         status = ads_find_machine_acct(ads, (void **)&res, host);
1307         if (ADS_ERR_OK(status) && ads_count_replies(ads, res) == 1) {
1308                 DEBUG(0, ("Host account for %s already exists - deleting old account\n", host));
1309                 status = ads_leave_realm(ads, host);
1310                 if (!ADS_ERR_OK(status)) {
1311                         DEBUG(0, ("Failed to delete host '%s' from the '%s' realm.\n",
1312                                   host, ads->config.realm));
1313                         return status;
1314                 }
1315         }
1316
1317         status = ads_add_machine_acct(ads, host, account_type, org_unit);
1318         if (!ADS_ERR_OK(status)) {
1319                 DEBUG(0, ("ads_add_machine_acct: %s\n", ads_errstr(status)));
1320                 return status;
1321         }
1322
1323         status = ads_find_machine_acct(ads, (void **)&res, host);
1324         if (!ADS_ERR_OK(status)) {
1325                 DEBUG(0, ("Host account test failed\n"));
1326                 return status;
1327         }
1328
1329         free(host);
1330
1331         return status;
1332 }
1333
1334 /**
1335  * Delete a machine from the realm
1336  * @param ads connection to ads server
1337  * @param hostname Machine to remove
1338  * @return status of delete
1339  **/
1340 ADS_STATUS ads_leave_realm(ADS_STRUCT *ads, const char *hostname)
1341 {
1342         ADS_STATUS status;
1343         void *res, *msg;
1344         char *hostnameDN, *host;
1345         int rc;
1346
1347         /* hostname must be lowercase */
1348         host = strdup(hostname);
1349         strlower_m(host);
1350
1351         status = ads_find_machine_acct(ads, &res, host);
1352         if (!ADS_ERR_OK(status)) {
1353             DEBUG(0, ("Host account for %s does not exist.\n", host));
1354             return status;
1355         }
1356
1357         msg = ads_first_entry(ads, res);
1358         if (!msg) {
1359                 return ADS_ERROR_SYSTEM(ENOENT);
1360         }
1361
1362         hostnameDN = ads_get_dn(ads, (LDAPMessage *)msg);
1363         rc = ldap_delete_s(ads->ld, hostnameDN);
1364         ads_memfree(ads, hostnameDN);
1365         if (rc != LDAP_SUCCESS) {
1366                 return ADS_ERROR(rc);
1367         }
1368
1369         status = ads_find_machine_acct(ads, &res, host);
1370         if (ADS_ERR_OK(status) && ads_count_replies(ads, res) == 1) {
1371                 DEBUG(0, ("Failed to remove host account.\n"));
1372                 return status;
1373         }
1374
1375         free(host);
1376
1377         return status;
1378 }
1379
1380 /**
1381  * add machine account to existing security descriptor
1382  * @param ads connection to ads server
1383  * @param hostname machine to add
1384  * @param dn DN of security descriptor
1385  * @return status
1386  **/
1387 ADS_STATUS ads_set_machine_sd(ADS_STRUCT *ads, const char *hostname, char *dn)
1388 {
1389         const char     *attrs[] = {"nTSecurityDescriptor", "objectSid", 0};
1390         char           *expr     = 0;
1391         size_t          sd_size = 0;
1392         struct berval   bval = {0, NULL};
1393         prs_struct      ps_wire;
1394         char           *escaped_hostname = escape_ldap_string_alloc(hostname);
1395
1396         LDAPMessage *res  = 0;
1397         LDAPMessage *msg  = 0;
1398         ADS_MODLIST  mods = 0;
1399
1400         NTSTATUS    status;
1401         ADS_STATUS  ret;
1402         DOM_SID     sid;
1403         SEC_DESC   *psd = NULL;
1404         TALLOC_CTX *ctx = NULL;
1405
1406         /* Avoid segmentation fault in prs_mem_free if
1407          * we have to bail out before prs_init */
1408         ps_wire.is_dynamic = False;
1409
1410         if (!ads) return ADS_ERROR(LDAP_SERVER_DOWN);
1411
1412         ret = ADS_ERROR(LDAP_SUCCESS);
1413
1414         if (!escaped_hostname) {
1415                 return ADS_ERROR_NT(NT_STATUS_NO_MEMORY);
1416         }
1417
1418         if (asprintf(&expr, "(samAccountName=%s$)", escaped_hostname) == -1) {
1419                 DEBUG(1, ("ads_set_machine_sd: asprintf failed!\n"));
1420                 SAFE_FREE(escaped_hostname);
1421                 return ADS_ERROR_NT(NT_STATUS_NO_MEMORY);
1422         }
1423
1424         SAFE_FREE(escaped_hostname);
1425
1426         ret = ads_search(ads, (void *) &res, expr, attrs);
1427
1428         if (!ADS_ERR_OK(ret)) return ret;
1429
1430         if ( !(msg = ads_first_entry(ads, res) )) {
1431                 ret = ADS_ERROR(LDAP_NO_RESULTS_RETURNED);
1432                 goto ads_set_sd_error;
1433         }
1434
1435         if (!ads_pull_sid(ads, msg, attrs[1], &sid)) {
1436                 ret = ADS_ERROR_NT(NT_STATUS_INVALID_PARAMETER);
1437                 goto ads_set_sd_error;
1438         }
1439
1440         if (!(ctx = talloc_init("sec_io_desc"))) {
1441                 ret =  ADS_ERROR(LDAP_NO_MEMORY);
1442                 goto ads_set_sd_error;
1443         }
1444
1445         if (!ads_pull_sd(ads, ctx, msg, attrs[0], &psd)) {
1446                 ret = ADS_ERROR_NT(NT_STATUS_INVALID_PARAMETER);
1447                 goto ads_set_sd_error;
1448         }
1449
1450         status = sec_desc_add_sid(ctx, &psd, &sid, SEC_RIGHTS_FULL_CTRL, &sd_size);
1451
1452         if (!NT_STATUS_IS_OK(status)) {
1453                 ret = ADS_ERROR_NT(status);
1454                 goto ads_set_sd_error;
1455         }
1456
1457         if (!prs_init(&ps_wire, sd_size, ctx, MARSHALL)) {
1458                 ret = ADS_ERROR_NT(NT_STATUS_NO_MEMORY);
1459         }
1460
1461         if (!sec_io_desc("sd_wire", &psd, &ps_wire, 1)) {
1462                 ret = ADS_ERROR(LDAP_NO_MEMORY);
1463                 goto ads_set_sd_error;
1464         }
1465
1466 #if 0
1467         file_save("/tmp/sec_desc.new", ps_wire.data_p, sd_size);
1468 #endif
1469         if (!(mods = ads_init_mods(ctx))) return ADS_ERROR(LDAP_NO_MEMORY);
1470
1471         bval.bv_len = prs_offset(&ps_wire);
1472         bval.bv_val = talloc(ctx, bval.bv_len);
1473         if (!bval.bv_val) {
1474                 ret = ADS_ERROR(LDAP_NO_MEMORY);
1475                 goto ads_set_sd_error;
1476         }
1477
1478         prs_set_offset(&ps_wire, 0);
1479
1480         if (!prs_copy_data_out(bval.bv_val, &ps_wire, bval.bv_len)) {
1481                 ret = ADS_ERROR(LDAP_NO_MEMORY);
1482                 goto ads_set_sd_error;
1483         }
1484
1485         ret = ads_mod_ber(ctx, &mods, attrs[0], &bval);
1486         if (ADS_ERR_OK(ret)) {
1487                 ret = ads_gen_mod(ads, dn, mods);
1488         }
1489
1490 ads_set_sd_error:
1491         ads_msgfree(ads, res);
1492         prs_mem_free(&ps_wire);
1493         talloc_destroy(ctx);
1494         return ret;
1495 }
1496
1497 /**
1498  * pull the first entry from a ADS result
1499  * @param ads connection to ads server
1500  * @param res Results of search
1501  * @return first entry from result
1502  **/
1503 void *ads_first_entry(ADS_STRUCT *ads, void *res)
1504 {
1505         return (void *)ldap_first_entry(ads->ld, (LDAPMessage *)res);
1506 }
1507
1508 /**
1509  * pull the next entry from a ADS result
1510  * @param ads connection to ads server
1511  * @param res Results of search
1512  * @return next entry from result
1513  **/
1514 void *ads_next_entry(ADS_STRUCT *ads, void *res)
1515 {
1516         return (void *)ldap_next_entry(ads->ld, (LDAPMessage *)res);
1517 }
1518
1519 /**
1520  * pull a single string from a ADS result
1521  * @param ads connection to ads server
1522  * @param mem_ctx TALLOC_CTX to use for allocating result string
1523  * @param msg Results of search
1524  * @param field Attribute to retrieve
1525  * @return Result string in talloc context
1526  **/
1527 char *ads_pull_string(ADS_STRUCT *ads,
1528                       TALLOC_CTX *mem_ctx, void *msg, const char *field)
1529 {
1530         char **values;
1531         char *ret = NULL;
1532         char *ux_string;
1533         size_t rc;
1534
1535         values = ldap_get_values(ads->ld, msg, field);
1536         if (!values)
1537                 return NULL;
1538
1539         if (values[0]) {
1540                 rc = pull_utf8_talloc(mem_ctx, &ux_string,
1541                                       values[0]);
1542                 if (rc != (size_t)-1)
1543                         ret = ux_string;
1544
1545         }
1546         ldap_value_free(values);
1547         return ret;
1548 }
1549
1550 /**
1551  * pull an array of strings from a ADS result
1552  * @param ads connection to ads server
1553  * @param mem_ctx TALLOC_CTX to use for allocating result string
1554  * @param msg Results of search
1555  * @param field Attribute to retrieve
1556  * @return Result strings in talloc context
1557  **/
1558 char **ads_pull_strings(ADS_STRUCT *ads,
1559                        TALLOC_CTX *mem_ctx, void *msg, const char *field)
1560 {
1561         char **values;
1562         char **ret = NULL;
1563         int i, n;
1564
1565         values = ldap_get_values(ads->ld, msg, field);
1566         if (!values)
1567                 return NULL;
1568
1569         for (i=0;values[i];i++)
1570                 /* noop */ ;
1571         n = i;
1572
1573         ret = talloc(mem_ctx, sizeof(char *) * (n+1));
1574         if (!ret) {
1575                 ldap_value_free(values);
1576                 return NULL;
1577         }
1578
1579         for (i=0;i<n;i++) {
1580                 if (pull_utf8_talloc(mem_ctx, &ret[i], values[i]) == -1) {
1581                         ldap_value_free(values);
1582                         return NULL;
1583                 }
1584         }
1585         ret[i] = NULL;
1586
1587         ldap_value_free(values);
1588         return ret;
1589 }
1590
1591
1592 /**
1593  * pull a single uint32 from a ADS result
1594  * @param ads connection to ads server
1595  * @param msg Results of search
1596  * @param field Attribute to retrieve
1597  * @param v Pointer to int to store result
1598  * @return boolean inidicating success
1599 */
1600 BOOL ads_pull_uint32(ADS_STRUCT *ads,
1601                      void *msg, const char *field, uint32 *v)
1602 {
1603         char **values;
1604
1605         values = ldap_get_values(ads->ld, msg, field);
1606         if (!values)
1607                 return False;
1608         if (!values[0]) {
1609                 ldap_value_free(values);
1610                 return False;
1611         }
1612
1613         *v = atoi(values[0]);
1614         ldap_value_free(values);
1615         return True;
1616 }
1617
1618 /**
1619  * pull a single objectGUID from an ADS result
1620  * @param ads connection to ADS server
1621  * @param msg results of search
1622  * @param guid 37-byte area to receive text guid
1623  * @return boolean indicating success
1624  **/
1625 BOOL ads_pull_guid(ADS_STRUCT *ads,
1626                    void *msg, struct uuid *guid)
1627 {
1628         char **values;
1629         UUID_FLAT flat_guid;
1630
1631         values = ldap_get_values(ads->ld, msg, "objectGUID");
1632         if (!values)
1633                 return False;
1634
1635         if (values[0]) {
1636                 memcpy(&flat_guid.info, values[0], sizeof(UUID_FLAT));
1637                 smb_uuid_unpack(flat_guid, guid);
1638                 ldap_value_free(values);
1639                 return True;
1640         }
1641         ldap_value_free(values);
1642         return False;
1643
1644 }
1645
1646
1647 /**
1648  * pull a single DOM_SID from a ADS result
1649  * @param ads connection to ads server
1650  * @param msg Results of search
1651  * @param field Attribute to retrieve
1652  * @param sid Pointer to sid to store result
1653  * @return boolean inidicating success
1654 */
1655 BOOL ads_pull_sid(ADS_STRUCT *ads,
1656                   void *msg, const char *field, DOM_SID *sid)
1657 {
1658         struct berval **values;
1659         BOOL ret = False;
1660
1661         values = ldap_get_values_len(ads->ld, msg, field);
1662
1663         if (!values)
1664                 return False;
1665
1666         if (values[0])
1667                 ret = sid_parse(values[0]->bv_val, values[0]->bv_len, sid);
1668
1669         ldap_value_free_len(values);
1670         return ret;
1671 }
1672
1673 /**
1674  * pull an array of DOM_SIDs from a ADS result
1675  * @param ads connection to ads server
1676  * @param mem_ctx TALLOC_CTX for allocating sid array
1677  * @param msg Results of search
1678  * @param field Attribute to retrieve
1679  * @param sids pointer to sid array to allocate
1680  * @return the count of SIDs pulled
1681  **/
1682 int ads_pull_sids(ADS_STRUCT *ads, TALLOC_CTX *mem_ctx,
1683                   void *msg, const char *field, DOM_SID **sids)
1684 {
1685         struct berval **values;
1686         BOOL ret;
1687         int count, i;
1688
1689         values = ldap_get_values_len(ads->ld, msg, field);
1690
1691         if (!values)
1692                 return 0;
1693
1694         for (i=0; values[i]; i++)
1695                 /* nop */ ;
1696
1697         (*sids) = talloc(mem_ctx, sizeof(DOM_SID) * i);
1698         if (!(*sids)) {
1699                 ldap_value_free_len(values);
1700                 return 0;
1701         }
1702
1703         count = 0;
1704         for (i=0; values[i]; i++) {
1705                 ret = sid_parse(values[i]->bv_val, values[i]->bv_len, &(*sids)[count]);
1706                 if (ret) {
1707                         fstring sid;
1708                         DEBUG(10, ("pulling SID: %s\n", sid_to_string(sid, &(*sids)[count])));
1709                         count++;
1710                 }
1711         }
1712
1713         ldap_value_free_len(values);
1714         return count;
1715 }
1716
1717 /**
1718  * pull a SEC_DESC from a ADS result
1719  * @param ads connection to ads server
1720  * @param mem_ctx TALLOC_CTX for allocating sid array
1721  * @param msg Results of search
1722  * @param field Attribute to retrieve
1723  * @param sd Pointer to *SEC_DESC to store result (talloc()ed)
1724  * @return boolean inidicating success
1725 */
1726 BOOL ads_pull_sd(ADS_STRUCT *ads, TALLOC_CTX *mem_ctx,
1727                   void *msg, const char *field, SEC_DESC **sd)
1728 {
1729         struct berval **values;
1730         prs_struct      ps;
1731         BOOL ret = False;
1732
1733         values = ldap_get_values_len(ads->ld, msg, field);
1734
1735         if (!values) return False;
1736
1737         if (values[0]) {
1738                 prs_init(&ps, values[0]->bv_len, mem_ctx, UNMARSHALL);
1739                 prs_copy_data_in(&ps, values[0]->bv_val, values[0]->bv_len);
1740                 prs_set_offset(&ps,0);
1741
1742                 ret = sec_io_desc("sd", sd, &ps, 1);
1743         }
1744
1745         ldap_value_free_len(values);
1746         return ret;
1747 }
1748
1749 /*
1750  * in order to support usernames longer than 21 characters we need to
1751  * use both the sAMAccountName and the userPrincipalName attributes
1752  * It seems that not all users have the userPrincipalName attribute set
1753  *
1754  * @param ads connection to ads server
1755  * @param mem_ctx TALLOC_CTX for allocating sid array
1756  * @param msg Results of search
1757  * @return the username
1758  */
1759 char *ads_pull_username(ADS_STRUCT *ads, TALLOC_CTX *mem_ctx, void *msg)
1760 {
1761         char *ret, *p;
1762
1763         ret = ads_pull_string(ads, mem_ctx, msg, "userPrincipalName");
1764         if (ret && (p = strchr(ret, '@'))) {
1765                 *p = 0;
1766                 return ret;
1767         }
1768         return ads_pull_string(ads, mem_ctx, msg, "sAMAccountName");
1769 }
1770
1771
1772 /**
1773  * find the update serial number - this is the core of the ldap cache
1774  * @param ads connection to ads server
1775  * @param ads connection to ADS server
1776  * @param usn Pointer to retrieved update serial number
1777  * @return status of search
1778  **/
1779 ADS_STATUS ads_USN(ADS_STRUCT *ads, uint32 *usn)
1780 {
1781         const char *attrs[] = {"highestCommittedUSN", NULL};
1782         ADS_STATUS status;
1783         void *res;
1784
1785         status = ads_do_search_retry(ads, "", LDAP_SCOPE_BASE, "(objectclass=*)", attrs, &res);
1786         if (!ADS_ERR_OK(status))
1787                 return status;
1788
1789         if (ads_count_replies(ads, res) != 1) {
1790                 return ADS_ERROR(LDAP_NO_RESULTS_RETURNED);
1791         }
1792
1793         ads_pull_uint32(ads, res, "highestCommittedUSN", usn);
1794         ads_msgfree(ads, res);
1795         return ADS_SUCCESS;
1796 }
1797
1798 /* parse a ADS timestring - typical string is
1799    '20020917091222.0Z0' which means 09:12.22 17th September
1800    2002, timezone 0 */
1801 static time_t ads_parse_time(const char *str)
1802 {
1803         struct tm tm;
1804
1805         ZERO_STRUCT(tm);
1806
1807         if (sscanf(str, "%4d%2d%2d%2d%2d%2d",
1808                    &tm.tm_year, &tm.tm_mon, &tm.tm_mday,
1809                    &tm.tm_hour, &tm.tm_min, &tm.tm_sec) != 6) {
1810                 return 0;
1811         }
1812         tm.tm_year -= 1900;
1813         tm.tm_mon -= 1;
1814
1815         return timegm(&tm);
1816 }
1817
1818
1819 /**
1820  * Find the servers name and realm - this can be done before authentication
1821  *  The ldapServiceName field on w2k  looks like this:
1822  *    vnet3.home.samba.org:win2000-vnet3$@VNET3.HOME.SAMBA.ORG
1823  * @param ads connection to ads server
1824  * @return status of search
1825  **/
1826 ADS_STATUS ads_server_info(ADS_STRUCT *ads)
1827 {
1828         const char *attrs[] = {"ldapServiceName", "currentTime", NULL};
1829         ADS_STATUS status;
1830         void *res;
1831         char *value;
1832         char *p;
1833         char *timestr;
1834         TALLOC_CTX *ctx;
1835
1836         if (!(ctx = talloc_init("ads_server_info"))) {
1837                 return ADS_ERROR(LDAP_NO_MEMORY);
1838         }
1839
1840         status = ads_do_search(ads, "", LDAP_SCOPE_BASE, "(objectclass=*)", attrs, &res);
1841         if (!ADS_ERR_OK(status)) return status;
1842
1843         value = ads_pull_string(ads, ctx, res, "ldapServiceName");
1844         if (!value) {
1845                 return ADS_ERROR(LDAP_NO_RESULTS_RETURNED);
1846         }
1847
1848         timestr = ads_pull_string(ads, ctx, res, "currentTime");
1849         if (!timestr) {
1850                 return ADS_ERROR(LDAP_NO_RESULTS_RETURNED);
1851         }
1852
1853         ldap_msgfree(res);
1854
1855         p = strchr(value, ':');
1856         if (!p) {
1857                 talloc_destroy(ctx);
1858                 DEBUG(1, ("ads_server_info: returned ldap server name did not contain a ':' so was deemed invalid\n"));
1859                 return ADS_ERROR(LDAP_DECODING_ERROR);
1860         }
1861
1862         SAFE_FREE(ads->config.ldap_server_name);
1863
1864         ads->config.ldap_server_name = strdup(p+1);
1865         p = strchr(ads->config.ldap_server_name, '$');
1866         if (!p || p[1] != '@') {
1867                 talloc_destroy(ctx);
1868                 DEBUG(1, ("ads_server_info: returned ldap server name (%s) does not contain '$@' so was deemed invalid\n", ads->config.ldap_server_name));
1869                 SAFE_FREE(ads->config.ldap_server_name);
1870                 return ADS_ERROR(LDAP_DECODING_ERROR);
1871         }
1872
1873         *p = 0;
1874
1875         SAFE_FREE(ads->config.realm);
1876         SAFE_FREE(ads->config.bind_path);
1877
1878         ads->config.realm = strdup(p+2);
1879         ads->config.bind_path = ads_build_dn(ads->config.realm);
1880
1881         DEBUG(3,("got ldap server name %s@%s, using bind path: %s\n",
1882                  ads->config.ldap_server_name, ads->config.realm,
1883                  ads->config.bind_path));
1884
1885         ads->config.current_time = ads_parse_time(timestr);
1886
1887         if (ads->config.current_time != 0) {
1888                 ads->auth.time_offset = ads->config.current_time - time(NULL);
1889                 DEBUG(4,("time offset is %d seconds\n", ads->auth.time_offset));
1890         }
1891
1892         talloc_destroy(ctx);
1893
1894         return ADS_SUCCESS;
1895 }
1896
1897 /**
1898  * find the domain sid for our domain
1899  * @param ads connection to ads server
1900  * @param sid Pointer to domain sid
1901  * @return status of search
1902  **/
1903 ADS_STATUS ads_domain_sid(ADS_STRUCT *ads, DOM_SID *sid)
1904 {
1905         const char *attrs[] = {"objectSid", NULL};
1906         void *res;
1907         ADS_STATUS rc;
1908
1909         rc = ads_do_search_retry(ads, ads->config.bind_path, LDAP_SCOPE_BASE, "(objectclass=*)",
1910                            attrs, &res);
1911         if (!ADS_ERR_OK(rc)) return rc;
1912         if (!ads_pull_sid(ads, res, "objectSid", sid)) {
1913                 return ADS_ERROR_SYSTEM(ENOENT);
1914         }
1915         ads_msgfree(ads, res);
1916
1917         return ADS_SUCCESS;
1918 }
1919
1920 /* this is rather complex - we need to find the allternate (netbios) name
1921    for the domain, but there isn't a simple query to do this. Instead
1922    we look for the principle names on the DCs account and find one that has
1923    the right form, then extract the netbios name of the domain from that
1924
1925    NOTE! better method is this:
1926
1927 bin/net -Uadministrator%XXXXX ads search '(&(objectclass=crossref)(dnsroot=VNET3.HOME.SAMBA.ORG))'  nETBIOSName
1928
1929 but you need to force the bind path to match the configurationNamingContext from the rootDSE
1930
1931 */
1932 ADS_STATUS ads_workgroup_name(ADS_STRUCT *ads, TALLOC_CTX *mem_ctx, const char **workgroup)
1933 {
1934         char *expr;
1935         ADS_STATUS rc;
1936         char **principles;
1937         char *prefix;
1938         int prefix_length;
1939         int i;
1940         void *res;
1941         const char *attrs[] = {"servicePrincipalName", NULL};
1942
1943         (*workgroup) = NULL;
1944
1945         asprintf(&expr, "(&(objectclass=computer)(dnshostname=%s.%s))",
1946                  ads->config.ldap_server_name, ads->config.realm);
1947         rc = ads_search(ads, &res, expr, attrs);
1948         free(expr);
1949
1950         if (!ADS_ERR_OK(rc)) {
1951                 return rc;
1952         }
1953
1954         principles = ads_pull_strings(ads, mem_ctx, res, "servicePrincipalName");
1955
1956         ads_msgfree(ads, res);
1957
1958         if (!principles) {
1959                 return ADS_ERROR(LDAP_NO_RESULTS_RETURNED);
1960         }
1961
1962         asprintf(&prefix, "HOST/%s.%s/",
1963                  ads->config.ldap_server_name,
1964                  ads->config.realm);
1965
1966         prefix_length = strlen(prefix);
1967
1968         for (i=0;principles[i]; i++) {
1969                 if (strnequal(principles[i], prefix, prefix_length) &&
1970                     !strequal(ads->config.realm, principles[i]+prefix_length) &&
1971                     !strchr(principles[i]+prefix_length, '.')) {
1972                         /* found an alternate (short) name for the domain. */
1973                         DEBUG(3,("Found alternate name '%s' for realm '%s'\n",
1974                                  principles[i]+prefix_length,
1975                                  ads->config.realm));
1976                         (*workgroup) = talloc_strdup(mem_ctx, principles[i]+prefix_length);
1977                         break;
1978                 }
1979         }
1980         free(prefix);
1981
1982         if (!*workgroup) {
1983                 return ADS_ERROR(LDAP_NO_RESULTS_RETURNED);
1984         }
1985
1986         return ADS_SUCCESS;
1987 }
1988
1989 #endif