source/lib/util_sid.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Samba utility functions
   4    Copyright (C) Andrew Tridgell 1992-1998
   5    Copyright (C) Luke Kenneth Caseson Leighton 1998-1999
   6    Copyright (C) Jeremy Allison  1999
   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 /* NOTE! the global_sam_sid is the SID of our local SAM. This is only
  26    equal to the domain SID when we are a DC, otherwise its our
  27    workstation SID */
  28 DOM_SID global_sam_sid;
  29 extern pstring global_myname;
  30 extern fstring global_myworkgroup;
  31
  32 /*
  33  * Some useful sids
  34  */
  35
  36 DOM_SID global_sid_Builtin;                             /* Local well-known domain */
  37 DOM_SID global_sid_World_Domain;                /* Everyone domain */
  38 DOM_SID global_sid_World;                               /* Everyone */
  39 DOM_SID global_sid_Creator_Owner_Domain;    /* Creator Owner domain */
  40 DOM_SID global_sid_Creator_Owner;               /* Creator Owner */
  41 DOM_SID global_sid_Creator_Group;              /* Creator Group */
  42 DOM_SID global_sid_NT_Authority;                /* NT Authority */
  43 DOM_SID global_sid_NULL;                        /* NULL sid */
  44 DOM_SID global_sid_Builtin_Guests;                      /* Builtin guest users */
  45 DOM_SID global_sid_Authenticated_Users;         /* All authenticated rids */
  46 DOM_SID global_sid_Network;                                     /* Network rids */
  47 DOM_SID global_sid_Anonymous;                           /* Anonymous login */
  48
  49 const DOM_SID *global_sid_everyone = &global_sid_World;
  50
  51 typedef struct _known_sid_users {
  52         uint32 rid;
  53         enum SID_NAME_USE sid_name_use;
  54         char *known_user_name;
  55 } known_sid_users;
  56
  57 /* static known_sid_users no_users[] = {{0, 0, NULL}}; */
  58
  59 static known_sid_users everyone_users[] = {
  60         { 0, SID_NAME_WKN_GRP, "Everyone" },
  61         {0, (enum SID_NAME_USE)0, NULL}};
  62
  63 static known_sid_users creator_owner_users[] = {
  64         { 0, SID_NAME_ALIAS, "Creator Owner" },
  65         {0, (enum SID_NAME_USE)0, NULL}};
  66
  67 static known_sid_users nt_authority_users[] = {
  68         {  1, SID_NAME_ALIAS, "Dialup" },
  69         {  2, SID_NAME_ALIAS, "Network"},
  70         {  3, SID_NAME_ALIAS, "Batch"},
  71         {  4, SID_NAME_ALIAS, "Interactive"},
  72         {  6, SID_NAME_ALIAS, "Service"},
  73         {  7, SID_NAME_ALIAS, "AnonymousLogon"},
  74         {  8, SID_NAME_ALIAS, "Proxy"},
  75         {  9, SID_NAME_ALIAS, "ServerLogon"},
  76         { 11, SID_NAME_ALIAS, "Authenticated Users"},
  77         { 18, SID_NAME_ALIAS, "SYSTEM"},
  78         {  0, (enum SID_NAME_USE)0, NULL}};
  79
  80 static known_sid_users builtin_groups[] = {
  81         { BUILTIN_ALIAS_RID_ADMINS, SID_NAME_ALIAS, "Administrators" },
  82         { BUILTIN_ALIAS_RID_USERS, SID_NAME_ALIAS, "Users" },
  83         { BUILTIN_ALIAS_RID_GUESTS, SID_NAME_ALIAS, "Guests" },
  84         { BUILTIN_ALIAS_RID_ACCOUNT_OPS, SID_NAME_ALIAS, "Account Operators" },
  85         { BUILTIN_ALIAS_RID_SYSTEM_OPS, SID_NAME_ALIAS, "Server Operators" },
  86         { BUILTIN_ALIAS_RID_PRINT_OPS, SID_NAME_ALIAS, "Print Operators" },
  87         { BUILTIN_ALIAS_RID_BACKUP_OPS, SID_NAME_ALIAS, "Backup Operators" },
  88         {  0, (enum SID_NAME_USE)0, NULL}};
  89
  90 #define MAX_SID_NAMES   7
  91
  92 static struct sid_name_map_info
  93 {
  94         DOM_SID *sid;
  95         char *name;
  96         known_sid_users *known_users;
  97 } sid_name_map[MAX_SID_NAMES];
  98
  99 static BOOL sid_name_map_initialized = False;
 100
 101 /*
 102  * An NT compatible anonymous token.
 103  */
 104
 105 static DOM_SID anon_sid_array[3];
 106
 107 NT_USER_TOKEN anonymous_token = {
 108     3,
 109     anon_sid_array
 110 };
 111
 112 /**************************************************************************
 113  quick init function
 114  *************************************************************************/
 115 static void init_sid_name_map (void)
 116 {
 117         int i = 0;
 118
 119         if (sid_name_map_initialized) return;
 120
 121
 122         if ((lp_security() == SEC_USER) && lp_domain_logons()) {
 123                 sid_name_map[i].sid = &global_sam_sid;
 124                 sid_name_map[i].name = global_myworkgroup;
 125                 sid_name_map[i].known_users = NULL;
 126                 i++;
 127                 sid_name_map[i].sid = &global_sam_sid;
 128                 sid_name_map[i].name = global_myname;
 129                 sid_name_map[i].known_users = NULL;
 130                 i++;
 131         }
 132         else {
 133                 sid_name_map[i].sid = &global_sam_sid;
 134                 sid_name_map[i].name = global_myname;
 135                 sid_name_map[i].known_users = NULL;
 136                 i++;
 137         }
 138
 139         sid_name_map[i].sid = &global_sid_Builtin;
 140         sid_name_map[i].name = "BUILTIN";
 141         sid_name_map[i].known_users = &builtin_groups[0];
 142         i++;
 143
 144         sid_name_map[i].sid = &global_sid_World_Domain;
 145         sid_name_map[i].name = "";
 146         sid_name_map[i].known_users = &everyone_users[0];
 147         i++;
 148
 149         sid_name_map[i].sid = &global_sid_Creator_Owner_Domain;
 150         sid_name_map[i].name = "";
 151         sid_name_map[i].known_users = &creator_owner_users[0];
 152         i++;
 153
 154         sid_name_map[i].sid = &global_sid_NT_Authority;
 155         sid_name_map[i].name = "NT Authority";
 156         sid_name_map[i].known_users = &nt_authority_users[0];
 157         i++;
 158
 159
 160         /* end of array */
 161         sid_name_map[i].sid = NULL;
 162         sid_name_map[i].name = NULL;
 163         sid_name_map[i].known_users = NULL;
 164
 165         sid_name_map_initialized = True;
 166
 167         return;
 168
 169 }
 170
 171 /****************************************************************************
 172  Creates some useful well known sids
 173 ****************************************************************************/
 174
 175 void generate_wellknown_sids(void)
 176 {
 177         string_to_sid(&global_sid_Builtin, "S-1-5-32");
 178         string_to_sid(&global_sid_Builtin_Guests, "S-1-5-32-546");
 179         string_to_sid(&global_sid_World_Domain, "S-1-1");
 180         string_to_sid(&global_sid_World, "S-1-1-0");
 181         string_to_sid(&global_sid_Creator_Owner_Domain, "S-1-3");
 182         string_to_sid(&global_sid_Creator_Owner, "S-1-3-0");
 183         string_to_sid(&global_sid_Creator_Group, "S-1-3-1");
 184         string_to_sid(&global_sid_NT_Authority, "S-1-5");
 185         string_to_sid(&global_sid_NULL, "S-1-0-0");
 186         string_to_sid(&global_sid_Authenticated_Users, "S-1-5-11");
 187         string_to_sid(&global_sid_Network, "S-1-5-2");
 188         string_to_sid(&global_sid_Anonymous, "S-1-5-7");
 189
 190         /* Create the anon token. */
 191         sid_copy( &anonymous_token.user_sids[0], &global_sid_World);
 192         sid_copy( &anonymous_token.user_sids[1], &global_sid_Network);
 193         sid_copy( &anonymous_token.user_sids[2], &global_sid_Anonymous);
 194 }
 195
 196 /**************************************************************************
 197  Turns a domain SID into a name, returned in the nt_domain argument.
 198 ***************************************************************************/
 199
 200 BOOL map_domain_sid_to_name(DOM_SID *sid, char *nt_domain)
 201 {
 202         fstring sid_str;
 203         int i = 0;
 204
 205         sid_to_string(sid_str, sid);
 206
 207         if (!sid_name_map_initialized)
 208                 init_sid_name_map();
 209
 210         DEBUG(5,("map_domain_sid_to_name: %s\n", sid_str));
 211
 212         if (nt_domain == NULL)
 213                 return False;
 214
 215         while (sid_name_map[i].sid != NULL) {
 216                 sid_to_string(sid_str, sid_name_map[i].sid);
 217                 DEBUG(5,("map_domain_sid_to_name: compare: %s\n", sid_str));
 218                 if (sid_equal(sid_name_map[i].sid, sid)) {
 219                         fstrcpy(nt_domain, sid_name_map[i].name);
 220                         DEBUG(5,("map_domain_sid_to_name: found '%s'\n", nt_domain));
 221                         return True;
 222                 }
 223                 i++;
 224         }
 225
 226         DEBUG(5,("map_domain_sid_to_name: mapping for %s not found\n", sid_str));
 227
 228     return False;
 229 }
 230
 231 /**************************************************************************
 232  Looks up a known username from one of the known domains.
 233 ***************************************************************************/
 234
 235 BOOL lookup_known_rid(DOM_SID *sid, uint32 rid, char *name, enum SID_NAME_USE *psid_name_use)
 236 {
 237         int i = 0;
 238         struct sid_name_map_info *psnm;
 239
 240         if (!sid_name_map_initialized)
 241                 init_sid_name_map();
 242
 243         for(i = 0; sid_name_map[i].sid != NULL; i++) {
 244                 psnm = &sid_name_map[i];
 245                 if(sid_equal(psnm->sid, sid)) {
 246                         int j;
 247                         for(j = 0; psnm->known_users && psnm->known_users[j].known_user_name != NULL; j++) {
 248                                 if(rid == psnm->known_users[j].rid) {
 249                                         DEBUG(5,("lookup_builtin_rid: rid = %u, domain = '%s', user = '%s'\n",
 250                                                 (unsigned int)rid, psnm->name, psnm->known_users[j].known_user_name ));
 251                                         fstrcpy( name, psnm->known_users[j].known_user_name);
 252                                         *psid_name_use = psnm->known_users[j].sid_name_use;
 253                                         return True;
 254                                 }
 255                         }
 256                 }
 257         }
 258
 259         return False;
 260 }
 261
 262 /**************************************************************************
 263  Turns a domain name into a SID.
 264  *** side-effect: if the domain name is NULL, it is set to our domain ***
 265 ***************************************************************************/
 266
 267 BOOL map_domain_name_to_sid(DOM_SID *sid, char *nt_domain)
 268 {
 269         int i = 0;
 270
 271         if (nt_domain == NULL) {
 272                 DEBUG(5,("map_domain_name_to_sid: mapping NULL domain to our SID.\n"));
 273                 sid_copy(sid, &global_sam_sid);
 274                 return True;
 275         }
 276
 277         if (nt_domain[0] == 0) {
 278                 fstrcpy(nt_domain, global_myname);
 279                 DEBUG(5,("map_domain_name_to_sid: overriding blank name to %s\n", nt_domain));
 280                 sid_copy(sid, &global_sam_sid);
 281                 return True;
 282         }
 283
 284         DEBUG(5,("map_domain_name_to_sid: %s\n", nt_domain));
 285
 286         if (!sid_name_map_initialized)
 287                 init_sid_name_map();
 288
 289         while (sid_name_map[i].name != NULL) {
 290                 DEBUG(5,("map_domain_name_to_sid: compare: %s\n", sid_name_map[i].name));
 291                 if (strequal(sid_name_map[i].name, nt_domain)) {
 292                         fstring sid_str;
 293                         sid_copy(sid, sid_name_map[i].sid);
 294                         sid_to_string(sid_str, sid_name_map[i].sid);
 295                         DEBUG(5,("map_domain_name_to_sid: found %s\n", sid_str));
 296                         return True;
 297                 }
 298                 i++;
 299         }
 300
 301         DEBUG(0,("map_domain_name_to_sid: mapping to %s not found.\n", nt_domain));
 302         return False;
 303 }
 304
 305 /**************************************************************************
 306  Splits a name of format \DOMAIN\name or name into its two components.
 307  Sets the DOMAIN name to global_myname if it has not been specified.
 308 ***************************************************************************/
 309
 310 void split_domain_name(const char *fullname, char *domain, char *name)
 311 {
 312         pstring full_name;
 313         char *p, *sep;
 314
 315         sep = lp_winbind_separator();
 316
 317         *domain = *name = '\0';
 318
 319         if (fullname[0] == sep[0] || fullname[0] == '\\')
 320                 fullname++;
 321
 322         pstrcpy(full_name, fullname);
 323         p = strchr(full_name+1, '\\');
 324         if (!p) p = strchr(full_name+1, sep[0]);
 325
 326         if (p != NULL) {
 327                 *p = 0;
 328                 fstrcpy(domain, full_name);
 329                 fstrcpy(name, p+1);
 330         } else {
 331                 fstrcpy(domain, global_myname);
 332                 fstrcpy(name, full_name);
 333         }
 334
 335         DEBUG(10,("split_domain_name:name '%s' split into domain :'%s' and user :'%s'\n",
 336                         fullname, domain, name));
 337 }
 338
 339 /*****************************************************************
 340  Convert a SID to an ascii string.
 341 *****************************************************************/
 342
 343 char *sid_to_string(fstring sidstr_out, DOM_SID *sid)
 344 {
 345   char subauth[16];
 346   int i;
 347   /* BIG NOTE: this function only does SIDS where the identauth is not >= 2^32 */
 348   uint32 ia = (sid->id_auth[5]) +
 349               (sid->id_auth[4] << 8 ) +
 350               (sid->id_auth[3] << 16) +
 351               (sid->id_auth[2] << 24);
 352
 353   slprintf(sidstr_out, sizeof(fstring) - 1, "S-%u-%lu", (unsigned int)sid->sid_rev_num, (unsigned long)ia);
 354
 355   for (i = 0; i < sid->num_auths; i++) {
 356     slprintf(subauth, sizeof(subauth)-1, "-%lu", (unsigned long)sid->sub_auths[i]);
 357     fstrcat(sidstr_out, subauth);
 358   }
 359
 360   return sidstr_out;
 361 }
 362
 363 /*
 364   useful function for debug lines
 365 */
 366 const char *sid_string_static(DOM_SID *sid)
 367 {
 368         static fstring sid_str;
 369         sid_to_string(sid_str, sid);
 370         return sid_str;
 371 }
 372
 373 /*****************************************************************
 374  Convert a string to a SID. Returns True on success, False on fail.
 375 *****************************************************************/
 376
 377 BOOL string_to_sid(DOM_SID *sidout, const char *sidstr)
 378 {
 379   pstring tok;
 380   char *p, *q;
 381   /* BIG NOTE: this function only does SIDS where the identauth is not >= 2^32 */
 382   uint32 ia;
 383
 384   if (StrnCaseCmp( sidstr, "S-", 2)) {
 385     DEBUG(0,("string_to_sid: Sid %s does not start with 'S-'.\n", sidstr));
 386     return False;
 387   }
 388
 389   memset((char *)sidout, '\0', sizeof(DOM_SID));
 390
 391   q = p = strdup(sidstr + 2);
 392   if (p == NULL) {
 393     DEBUG(0, ("string_to_sid: out of memory!\n"));
 394     return False;
 395   }
 396
 397   if (!next_token(&p, tok, "-", sizeof(tok))) {
 398     DEBUG(0,("string_to_sid: Sid %s is not in a valid format.\n", sidstr));
 399     SAFE_FREE(q);
 400     return False;
 401   }
 402
 403   /* Get the revision number. */
 404   sidout->sid_rev_num = (uint8)strtoul(tok, NULL, 10);
 405
 406   if (!next_token(&p, tok, "-", sizeof(tok))) {
 407     DEBUG(0,("string_to_sid: Sid %s is not in a valid format.\n", sidstr));
 408     SAFE_FREE(q);
 409     return False;
 410   }
 411
 412   /* identauth in decimal should be <  2^32 */
 413   ia = (uint32)strtoul(tok, NULL, 10);
 414
 415   /* NOTE - the ia value is in big-endian format. */
 416   sidout->id_auth[0] = 0;
 417   sidout->id_auth[1] = 0;
 418   sidout->id_auth[2] = (ia & 0xff000000) >> 24;
 419   sidout->id_auth[3] = (ia & 0x00ff0000) >> 16;
 420   sidout->id_auth[4] = (ia & 0x0000ff00) >> 8;
 421   sidout->id_auth[5] = (ia & 0x000000ff);
 422
 423   sidout->num_auths = 0;
 424
 425   while(next_token(&p, tok, "-", sizeof(tok)) &&
 426         sidout->num_auths < MAXSUBAUTHS) {
 427     /*
 428      * NOTE - the subauths are in native machine-endian format. They
 429      * are converted to little-endian when linearized onto the wire.
 430      */
 431         sid_append_rid(sidout, (uint32)strtoul(tok, NULL, 10));
 432   }
 433
 434   SAFE_FREE(q);
 435   return True;
 436 }
 437
 438 /*****************************************************************
 439  Add a rid to the end of a sid
 440 *****************************************************************/
 441
 442 BOOL sid_append_rid(DOM_SID *sid, uint32 rid)
 443 {
 444         if (sid->num_auths < MAXSUBAUTHS) {
 445                 sid->sub_auths[sid->num_auths++] = rid;
 446                 return True;
 447         }
 448         return False;
 449 }
 450
 451 /*****************************************************************
 452  Removes the last rid from the end of a sid
 453 *****************************************************************/
 454
 455 BOOL sid_split_rid(DOM_SID *sid, uint32 *rid)
 456 {
 457         if (sid->num_auths > 0) {
 458                 sid->num_auths--;
 459                 *rid = sid->sub_auths[sid->num_auths];
 460                 return True;
 461         }
 462         return False;
 463 }
 464
 465 /*****************************************************************
 466  Return the last rid from the end of a sid
 467 *****************************************************************/
 468
 469 BOOL sid_peek_rid(DOM_SID *sid, uint32 *rid)
 470 {
 471         if (sid->num_auths > 0) {
 472                 *rid = sid->sub_auths[sid->num_auths - 1];
 473                 return True;
 474         }
 475         return False;
 476 }
 477
 478 /*****************************************************************
 479  Copies a sid
 480 *****************************************************************/
 481
 482 void sid_copy(DOM_SID *dst, const DOM_SID *src)
 483 {
 484         int i;
 485
 486         memset((char *)dst, '\0', sizeof(DOM_SID));
 487
 488         dst->sid_rev_num = src->sid_rev_num;
 489         dst->num_auths = src->num_auths;
 490
 491         memcpy(&dst->id_auth[0], &src->id_auth[0], sizeof(src->id_auth));
 492
 493         for (i = 0; i < src->num_auths; i++)
 494                 dst->sub_auths[i] = src->sub_auths[i];
 495 }
 496
 497 /*****************************************************************
 498  Duplicates a sid - mallocs the target.
 499 *****************************************************************/
 500
 501 DOM_SID *sid_dup(DOM_SID *src)
 502 {
 503   DOM_SID *dst;
 504
 505   if(!src)
 506     return NULL;
 507
 508   if((dst = malloc(sizeof(DOM_SID))) != NULL) {
 509         memset(dst, '\0', sizeof(DOM_SID));
 510         sid_copy( dst, src);
 511   }
 512
 513   return dst;
 514 }
 515
 516 /*****************************************************************
 517  Write a sid out into on-the-wire format.
 518 *****************************************************************/
 519 BOOL sid_linearize(char *outbuf, size_t len, DOM_SID *sid)
 520 {
 521         size_t i;
 522
 523         if (len < sid_size(sid))
 524                 return False;
 525
 526         SCVAL(outbuf,0,sid->sid_rev_num);
 527         SCVAL(outbuf,1,sid->num_auths);
 528         memcpy(&outbuf[2], sid->id_auth, 6);
 529         for(i = 0; i < sid->num_auths; i++)
 530                 SIVAL(outbuf, 8 + (i*4), sid->sub_auths[i]);
 531
 532         return True;
 533 }
 534
 535 /*****************************************************************
 536  parse a on-the-wire SID to a DOM_SID
 537 *****************************************************************/
 538 BOOL sid_parse(char *inbuf, size_t len, DOM_SID *sid)
 539 {
 540         int i;
 541         if (len < 8) return False;
 542         sid->sid_rev_num = CVAL(inbuf, 0);
 543         sid->num_auths = CVAL(inbuf, 1);
 544         memcpy(sid->id_auth, inbuf+2, 6);
 545         if (len < 8 + sid->num_auths*4) return False;
 546         for (i=0;i<sid->num_auths;i++) {
 547                 sid->sub_auths[i] = IVAL(inbuf, 8+i*4);
 548         }
 549         return True;
 550 }
 551
 552
 553 /*****************************************************************
 554  Compare the auth portion of two sids.
 555 *****************************************************************/
 556 int sid_compare_auth(const DOM_SID *sid1, const DOM_SID *sid2)
 557 {
 558         int i;
 559
 560         if (sid1 == sid2) return 0;
 561         if (!sid1) return -1;
 562         if (!sid2) return 1;
 563
 564         if (sid1->sid_rev_num != sid2->sid_rev_num)
 565                 return sid1->sid_rev_num - sid2->sid_rev_num;
 566
 567         for (i = 0; i < 6; i++)
 568                 if (sid1->id_auth[i] != sid2->id_auth[i])
 569                         return sid1->id_auth[i] - sid2->id_auth[i];
 570
 571         return 0;
 572 }
 573
 574 /*****************************************************************
 575  Compare two sids.
 576 *****************************************************************/
 577 int sid_compare(const DOM_SID *sid1, const DOM_SID *sid2)
 578 {
 579         int i;
 580
 581         if (sid1 == sid2) return 0;
 582         if (!sid1) return -1;
 583         if (!sid2) return 1;
 584
 585         /* compare most likely different rids, first: i.e start at end */
 586         if (sid1->num_auths != sid2->num_auths)
 587                 return sid1->num_auths - sid2->num_auths;
 588
 589         for (i = sid1->num_auths-1; i >= 0; --i)
 590                 if (sid1->sub_auths[i] != sid2->sub_auths[i])
 591                         return sid1->sub_auths[i] - sid2->sub_auths[i];
 592
 593         return sid_compare_auth(sid1, sid2);
 594 }
 595
 596 /*****************************************************************
 597 see if 2 SIDs are in the same domain
 598 this just compares the leading sub-auths
 599 *****************************************************************/
 600 int sid_compare_domain(const DOM_SID *sid1, const DOM_SID *sid2)
 601 {
 602         int n, i;
 603
 604         n = MIN(sid1->num_auths, sid2->num_auths);
 605
 606         for (i = n-1; i >= 0; --i)
 607                 if (sid1->sub_auths[i] != sid2->sub_auths[i])
 608                         return sid1->sub_auths[i] - sid2->sub_auths[i];
 609
 610         return sid_compare_auth(sid1, sid2);
 611 }
 612
 613 /*****************************************************************
 614  Compare two sids.
 615 *****************************************************************/
 616 BOOL sid_equal(const DOM_SID *sid1, const DOM_SID *sid2)
 617 {
 618         return sid_compare(sid1, sid2) == 0;
 619 }
 620
 621
 622 /*****************************************************************
 623  Check if the SID is our domain SID (S-1-5-21-x-y-z).
 624 *****************************************************************/
 625 BOOL sid_check_is_domain(const DOM_SID *sid)
 626 {
 627         return sid_equal(sid, &global_sam_sid);
 628 }
 629
 630
 631 /*****************************************************************
 632  Check if the SID is the builtin SID (S-1-5-32).
 633 *****************************************************************/
 634 BOOL sid_check_is_builtin(const DOM_SID *sid)
 635 {
 636         return sid_equal(sid, &global_sid_Builtin);
 637 }
 638
 639
 640 /*****************************************************************
 641  Check if the SID is our domain SID (S-1-5-21-x-y-z).
 642 *****************************************************************/
 643 BOOL sid_check_is_in_our_domain(const DOM_SID *sid)
 644 {
 645         DOM_SID dom_sid;
 646         uint32 rid;
 647
 648         sid_copy(&dom_sid, sid);
 649         sid_split_rid(&dom_sid, &rid);
 650
 651         return sid_equal(&dom_sid, &global_sam_sid);
 652 }
 653
 654 /*****************************************************************
 655  Check if the SID is our domain SID (S-1-5-21-x-y-z).
 656 *****************************************************************/
 657 BOOL sid_check_is_in_builtin(const DOM_SID *sid)
 658 {
 659         DOM_SID dom_sid;
 660         uint32 rid;
 661
 662         sid_copy(&dom_sid, sid);
 663         sid_split_rid(&dom_sid, &rid);
 664
 665         return sid_equal(&dom_sid, &global_sid_Builtin);
 666 }
 667
 668
 669 /*****************************************************************
 670  Calculates size of a sid.
 671 *****************************************************************/
 672
 673 size_t sid_size(DOM_SID *sid)
 674 {
 675         if (sid == NULL)
 676                 return 0;
 677
 678         return sid->num_auths * sizeof(uint32) + 8;
 679 }
 680
 681 /*****************************************************************
 682  Returns true if SID is internal (and non-mappable).
 683 *****************************************************************/
 684
 685 BOOL non_mappable_sid(DOM_SID *sid)
 686 {
 687         DOM_SID dom;
 688         uint32 rid;
 689
 690         sid_copy(&dom, sid);
 691         sid_split_rid(&dom, &rid);
 692
 693         if (sid_equal(&dom, &global_sid_Builtin))
 694                 return True;
 695
 696         if (sid_equal(&dom, &global_sid_Creator_Owner_Domain))
 697                 return True;
 698
 699         if (sid_equal(&dom, &global_sid_NT_Authority))
 700                 return True;
 701
 702         return False;
 703 }
 704
 705 /*
 706   return the binary string representation of a DOM_SID
 707   caller must free
 708 */
 709 char *sid_binstring(DOM_SID *sid)
 710 {
 711         char *buf, *s;
 712         int len = sid_size(sid);
 713         buf = malloc(len);
 714         if (!buf) return NULL;
 715         sid_linearize(buf, len, sid);
 716         s = binary_string(buf, len);
 717         free(buf);
 718         return s;
 719 }
 720