source3/lib/sysacls.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Samba system utilities for ACL support.
   4    Copyright (C) Jeremy Allison 2000.
   5    Copyright (C) Volker Lendecke 2006
   6    Copyright (C) Michael Adam 2006,2008
   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 3 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, see <http://www.gnu.org/licenses/>.
  20 */
  21
  22 #include "includes.h"
  23 #include "system/passwd.h"
  24
  25 #if defined(HAVE_POSIX_ACLS)
  26 #include "modules/vfs_posixacl.h"
  27 #endif
  28
  29 #if defined(HAVE_TRU64_ACLS)
  30 #include "modules/vfs_tru64acl.h"
  31 #endif
  32
  33 #if defined(HAVE_SOLARIS_ACLS) || defined(HAVE_UNIXWARE_ACLS)
  34 #include "modules/vfs_solarisacl.h"
  35 #endif
  36
  37 #if defined(HAVE_HPUX_ACLS)
  38 #include "modules/vfs_hpuxacl.h"
  39 #endif
  40
  41 #if defined(HAVE_IRIX_ACLS)
  42 #include "modules/vfs_irixacl.h"
  43 #endif
  44
  45 #undef  DBGC_CLASS
  46 #define DBGC_CLASS DBGC_ACLS
  47
  48 /*
  49  * Note that while this code implements sufficient functionality
  50  * to support the sys_acl_* interfaces it does not provide all
  51  * of the semantics of the POSIX ACL interfaces.
  52  *
  53  * In particular, an ACL entry descriptor (SMB_ACL_ENTRY_T) returned
  54  * from a call to sys_acl_get_entry() should not be assumed to be
  55  * valid after calling any of the following functions, which may
  56  * reorder the entries in the ACL.
  57  *
  58  *      sys_acl_valid()
  59  *      sys_acl_set_file()
  60  *      sys_acl_set_fd()
  61  */
  62
  63 int sys_acl_get_entry(SMB_ACL_T acl_d, int entry_id, SMB_ACL_ENTRY_T *entry_p)
  64 {
  65         if (entry_id != SMB_ACL_FIRST_ENTRY && entry_id != SMB_ACL_NEXT_ENTRY) {
  66                 errno = EINVAL;
  67                 return -1;
  68         }
  69
  70         if (entry_p == NULL) {
  71                 errno = EINVAL;
  72                 return -1;
  73         }
  74
  75         if (entry_id == SMB_ACL_FIRST_ENTRY) {
  76                 acl_d->next = 0;
  77         }
  78
  79         if (acl_d->next < 0) {
  80                 errno = EINVAL;
  81                 return -1;
  82         }
  83
  84         if (acl_d->next >= acl_d->count) {
  85                 return 0;
  86         }
  87
  88         *entry_p = &acl_d->acl[acl_d->next++];
  89
  90         return 1;
  91 }
  92
  93 int sys_acl_get_tag_type(SMB_ACL_ENTRY_T entry_d, SMB_ACL_TAG_T *type_p)
  94 {
  95         *type_p = entry_d->a_type;
  96
  97         return 0;
  98 }
  99
 100 int sys_acl_get_permset(SMB_ACL_ENTRY_T entry_d, SMB_ACL_PERMSET_T *permset_p)
 101 {
 102         *permset_p = &entry_d->a_perm;
 103
 104         return 0;
 105 }
 106
 107 void *sys_acl_get_qualifier(SMB_ACL_ENTRY_T entry_d)
 108 {
 109         if (entry_d->a_type == SMB_ACL_USER) {
 110                 return &entry_d->info.user.uid;
 111                 }
 112
 113         if (entry_d->a_type == SMB_ACL_GROUP) {
 114                 return &entry_d->info.group.gid;
 115         }
 116
 117         errno = EINVAL;
 118                 return NULL;
 119 }
 120
 121 int sys_acl_clear_perms(SMB_ACL_PERMSET_T permset_d)
 122 {
 123         *permset_d = 0;
 124
 125         return 0;
 126 }
 127
 128 int sys_acl_add_perm(SMB_ACL_PERMSET_T permset_d, SMB_ACL_PERM_T perm)
 129 {
 130         if (perm != SMB_ACL_READ && perm != SMB_ACL_WRITE
 131             && perm != SMB_ACL_EXECUTE) {
 132                 errno = EINVAL;
 133                 return -1;
 134                 }
 135
 136         if (permset_d == NULL) {
 137                 errno = EINVAL;
 138                 return -1;
 139         }
 140
 141         *permset_d |= perm;
 142
 143         return 0;
 144 }
 145
 146 int sys_acl_get_perm(SMB_ACL_PERMSET_T permset_d, SMB_ACL_PERM_T perm)
 147 {
 148         return *permset_d & perm;
 149 }
 150
 151 char *sys_acl_to_text(const struct smb_acl_t *acl_d, ssize_t *len_p)
 152 {
 153         int     i;
 154         int     len, maxlen;
 155         char    *text;
 156
 157         /*
 158          * use an initial estimate of 20 bytes per ACL entry
 159          * when allocating memory for the text representation
 160          * of the ACL
 161          */
 162         len     = 0;
 163         maxlen  = 20 * acl_d->count;
 164         if ((text = (char *)SMB_MALLOC(maxlen)) == NULL) {
 165                 errno = ENOMEM;
 166                 return NULL;
 167         }
 168
 169         for (i = 0; i < acl_d->count; i++) {
 170                 struct smb_acl_entry *ap = &acl_d->acl[i];
 171                 struct group    *gr;
 172                 char            tagbuf[12];
 173                 char            idbuf[12];
 174                 const char      *tag;
 175                 const char      *id     = "";
 176                 char            perms[4];
 177                 int             nbytes;
 178
 179                 switch (ap->a_type) {
 180                         /*
 181                          * for debugging purposes it's probably more
 182                          * useful to dump unknown tag types rather
 183                          * than just returning an error
 184                          */
 185                         default:
 186                                 slprintf(tagbuf, sizeof(tagbuf)-1, "0x%x",
 187                                          ap->a_type);
 188                                 tag = tagbuf;
 189                                 break;
 190
 191                         case SMB_ACL_USER:
 192                                 id = uidtoname(ap->info.user.uid);
 193                         case SMB_ACL_USER_OBJ:
 194                                 tag = "user";
 195                                 break;
 196
 197                         case SMB_ACL_GROUP:
 198                                 if ((gr = getgrgid(ap->info.group.gid)) == NULL) {
 199                                         slprintf(idbuf, sizeof(idbuf)-1, "%ld",
 200                                                 (long)ap->info.group.gid);
 201                                         id = idbuf;
 202                                 } else {
 203                                         id = gr->gr_name;
 204                                 }
 205                         case SMB_ACL_GROUP_OBJ:
 206                                 tag = "group";
 207                                 break;
 208
 209                         case SMB_ACL_OTHER:
 210                                 tag = "other";
 211                                 break;
 212
 213                         case SMB_ACL_MASK:
 214                                 tag = "mask";
 215                                 break;
 216
 217                 }
 218
 219                 perms[0] = (ap->a_perm & SMB_ACL_READ) ? 'r' : '-';
 220                 perms[1] = (ap->a_perm & SMB_ACL_WRITE) ? 'w' : '-';
 221                 perms[2] = (ap->a_perm & SMB_ACL_EXECUTE) ? 'x' : '-';
 222                 perms[3] = '\0';
 223
 224                 /*          <tag>      :  <qualifier>   :  rwx \n  \0 */
 225                 nbytes = strlen(tag) + 1 + strlen(id) + 1 + 3 + 1 + 1;
 226
 227                 /*
 228                  * If this entry would overflow the buffer
 229                  * allocate enough additional memory for this
 230                  * entry and an estimate of another 20 bytes
 231                  * for each entry still to be processed
 232                  */
 233                 if ((len + nbytes) > maxlen) {
 234                         maxlen += nbytes + 20 * (acl_d->count - i);
 235                         if ((text = (char *)SMB_REALLOC(text, maxlen)) == NULL) {
 236                                 errno = ENOMEM;
 237                                 return NULL;
 238                         }
 239                 }
 240
 241
 242                 slprintf(&text[len], nbytes, "%s:%s:%s\n", tag, id, perms);
 243                 len += (nbytes - 1);
 244         }
 245
 246         if (len_p)
 247                 *len_p = len;
 248
 249         return text;
 250 }
 251
 252 SMB_ACL_T sys_acl_init(int count)
 253 {
 254         SMB_ACL_T       a;
 255
 256         if (count < 0) {
 257                 errno = EINVAL;
 258                 return NULL;
 259         }
 260
 261         if ((a = talloc(NULL, struct smb_acl_t)) == NULL) {
 262                 errno = ENOMEM;
 263                 return NULL;
 264         }
 265
 266         a->size = count + 1;
 267         a->count = 0;
 268         a->next = -1;
 269
 270         a->acl = talloc_array(a, struct smb_acl_entry, count+1);
 271         if (!a->acl) {
 272                 TALLOC_FREE(a);
 273                 errno = ENOMEM;
 274                 return NULL;
 275         }
 276
 277         return a;
 278 }
 279
 280 int sys_acl_create_entry(SMB_ACL_T *acl_p, SMB_ACL_ENTRY_T *entry_p)
 281 {
 282         SMB_ACL_T       acl_d;
 283         SMB_ACL_ENTRY_T entry_d;
 284
 285         if (acl_p == NULL || entry_p == NULL || (acl_d = *acl_p) == NULL) {
 286                 errno = EINVAL;
 287                 return -1;
 288         }
 289
 290         if (acl_d->count >= acl_d->size) {
 291                 errno = ENOSPC;
 292                 return -1;
 293         }
 294
 295         entry_d         = &acl_d->acl[acl_d->count++];
 296         entry_d->a_type = SMB_ACL_TAG_INVALID;
 297         entry_d->a_perm = 0;
 298         *entry_p        = entry_d;
 299
 300         return 0;
 301 }
 302
 303 int sys_acl_set_tag_type(SMB_ACL_ENTRY_T entry_d, SMB_ACL_TAG_T tag_type)
 304 {
 305         switch (tag_type) {
 306                 case SMB_ACL_USER:
 307                 case SMB_ACL_USER_OBJ:
 308                 case SMB_ACL_GROUP:
 309                 case SMB_ACL_GROUP_OBJ:
 310                 case SMB_ACL_OTHER:
 311                 case SMB_ACL_MASK:
 312                         entry_d->a_type = tag_type;
 313                         break;
 314                 default:
 315                         errno = EINVAL;
 316                         return -1;
 317                 }
 318
 319         return 0;
 320 }
 321
 322 int sys_acl_set_qualifier(SMB_ACL_ENTRY_T entry_d, void *qual_p)
 323 {
 324         if (entry_d->a_type == SMB_ACL_USER) {
 325                 entry_d->info.user.uid = *((uid_t *)qual_p);
 326                 return 0;
 327                 }
 328         if (entry_d->a_type == SMB_ACL_GROUP) {
 329                 entry_d->info.group.gid = *((gid_t *)qual_p);
 330                 return 0;
 331         }
 332
 333         errno = EINVAL;
 334         return -1;
 335 }
 336
 337 int sys_acl_set_permset(SMB_ACL_ENTRY_T entry_d, SMB_ACL_PERMSET_T permset_d)
 338 {
 339         if (*permset_d & ~(SMB_ACL_READ|SMB_ACL_WRITE|SMB_ACL_EXECUTE)) {
 340                 errno = EINVAL;
 341                 return -1;
 342         }
 343
 344         entry_d->a_perm = *permset_d;
 345
 346         return 0;
 347 }
 348
 349 int sys_acl_free_text(char *text)
 350 {
 351         SAFE_FREE(text);
 352         return 0;
 353 }
 354
 355 int sys_acl_valid(SMB_ACL_T acl_d)
 356 {
 357         errno = EINVAL;
 358         return -1;
 359 }
 360
 361 /*
 362  * acl_get_file, acl_get_fd, acl_set_file, acl_set_fd and
 363  * sys_acl_delete_def_file are to be redirected to the default
 364  * statically-bound acl vfs module, but they are replacable.
 365  */
 366
 367 #if defined(HAVE_POSIX_ACLS)
 368
 369 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
 370                            const char *path_p, SMB_ACL_TYPE_T type)
 371 {
 372         return posixacl_sys_acl_get_file(handle, path_p, type);
 373 }
 374
 375 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
 376 {
 377         return posixacl_sys_acl_get_fd(handle, fsp);
 378 }
 379
 380 int sys_acl_set_file(vfs_handle_struct *handle,
 381                      const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
 382 {
 383         return posixacl_sys_acl_set_file(handle, name, type, acl_d);
 384 }
 385
 386 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
 387                    SMB_ACL_T acl_d)
 388 {
 389         return posixacl_sys_acl_set_fd(handle, fsp, acl_d);
 390 }
 391
 392 int sys_acl_delete_def_file(vfs_handle_struct *handle,
 393                             const char *path)
 394 {
 395         return posixacl_sys_acl_delete_def_file(handle, path);
 396 }
 397
 398 #elif defined(HAVE_AIX_ACLS)
 399
 400 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
 401                            const char *path_p, SMB_ACL_TYPE_T type)
 402 {
 403         return aixacl_sys_acl_get_file(handle, path_p, type);
 404 }
 405
 406 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
 407 {
 408         return aixacl_sys_acl_get_fd(handle, fsp);
 409 }
 410
 411 int sys_acl_set_file(vfs_handle_struct *handle,
 412                      const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
 413 {
 414         return aixacl_sys_acl_set_file(handle, name, type, acl_d);
 415 }
 416
 417 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
 418                    SMB_ACL_T acl_d)
 419 {
 420         return aixacl_sys_acl_set_fd(handle, fsp, acl_d);
 421 }
 422
 423 int sys_acl_delete_def_file(vfs_handle_struct *handle,
 424                             const char *path)
 425 {
 426         return aixacl_sys_acl_delete_def_file(handle, path);
 427 }
 428
 429 #elif defined(HAVE_TRU64_ACLS)
 430
 431 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
 432                            const char *path_p, SMB_ACL_TYPE_T type)
 433 {
 434         return tru64acl_sys_acl_get_file(handle, path_p, type);
 435 }
 436
 437 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
 438 {
 439         return tru64acl_sys_acl_get_fd(handle, fsp);
 440 }
 441
 442 int sys_acl_set_file(vfs_handle_struct *handle,
 443                      const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
 444 {
 445         return tru64acl_sys_acl_set_file(handle, name, type, acl_d);
 446 }
 447
 448 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
 449                    SMB_ACL_T acl_d)
 450 {
 451         return tru64acl_sys_acl_set_fd(handle, fsp, acl_d);
 452 }
 453
 454 int sys_acl_delete_def_file(vfs_handle_struct *handle,
 455                             const char *path)
 456 {
 457         return tru64acl_sys_acl_delete_def_file(handle, path);
 458 }
 459
 460 #elif defined(HAVE_SOLARIS_ACLS) || defined(HAVE_UNIXWARE_ACLS)
 461
 462 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
 463                            const char *path_p, SMB_ACL_TYPE_T type)
 464 {
 465         return solarisacl_sys_acl_get_file(handle, path_p, type);
 466 }
 467
 468 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
 469 {
 470         return solarisacl_sys_acl_get_fd(handle, fsp);
 471 }
 472
 473 int sys_acl_set_file(vfs_handle_struct *handle,
 474                      const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
 475 {
 476         return solarisacl_sys_acl_set_file(handle, name, type, acl_d);
 477 }
 478
 479 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
 480                    SMB_ACL_T acl_d)
 481 {
 482         return solarisacl_sys_acl_set_fd(handle, fsp, acl_d);
 483 }
 484
 485 int sys_acl_delete_def_file(vfs_handle_struct *handle,
 486                             const char *path)
 487 {
 488         return solarisacl_sys_acl_delete_def_file(handle, path);
 489 }
 490
 491 #elif defined(HAVE_HPUX_ACLS)
 492
 493 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
 494                            const char *path_p, SMB_ACL_TYPE_T type)
 495 {
 496         return hpuxacl_sys_acl_get_file(handle, path_p, type);
 497 }
 498
 499 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
 500 {
 501         return hpuxacl_sys_acl_get_fd(handle, fsp);
 502 }
 503
 504 int sys_acl_set_file(vfs_handle_struct *handle,
 505                      const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
 506 {
 507         return hpuxacl_sys_acl_set_file(handle, name, type, acl_d);
 508 }
 509
 510 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
 511                    SMB_ACL_T acl_d)
 512 {
 513         return hpuxacl_sys_acl_set_fd(handle, fsp, acl_d);
 514 }
 515
 516 int sys_acl_delete_def_file(vfs_handle_struct *handle,
 517                             const char *path)
 518 {
 519         return hpuxacl_sys_acl_delete_def_file(handle, path);
 520 }
 521
 522 #elif defined(HAVE_IRIX_ACLS)
 523
 524 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
 525                            const char *path_p, SMB_ACL_TYPE_T type)
 526 {
 527         return irixacl_sys_acl_get_file(handle, path_p, type);
 528 }
 529
 530 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
 531 {
 532         return irixacl_sys_acl_get_fd(handle, fsp);
 533 }
 534
 535 int sys_acl_set_file(vfs_handle_struct *handle,
 536                      const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
 537 {
 538         return irixacl_sys_acl_set_file(handle, name, type, acl_d);
 539 }
 540
 541 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
 542                    SMB_ACL_T acl_d)
 543 {
 544         return irixacl_sys_acl_set_fd(handle, fsp, acl_d);
 545 }
 546
 547 int sys_acl_delete_def_file(vfs_handle_struct *handle,
 548                             const char *path)
 549 {
 550         return irixacl_sys_acl_delete_def_file(handle, path);
 551 }
 552
 553 #else /* No ACLs. */
 554
 555 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
 556                            const char *path_p, SMB_ACL_TYPE_T type)
 557 {
 558 #ifdef ENOTSUP
 559         errno = ENOTSUP;
 560 #else
 561         errno = ENOSYS;
 562 #endif
 563         return NULL;
 564 }
 565
 566 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
 567 {
 568 #ifdef ENOTSUP
 569         errno = ENOTSUP;
 570 #else
 571         errno = ENOSYS;
 572 #endif
 573         return NULL;
 574 }
 575
 576 int sys_acl_set_file(vfs_handle_struct *handle,
 577                      const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
 578 {
 579 #ifdef ENOTSUP
 580         errno = ENOTSUP;
 581 #else
 582         errno = ENOSYS;
 583 #endif
 584         return -1;
 585 }
 586
 587 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
 588                    SMB_ACL_T acl_d)
 589 {
 590 #ifdef ENOTSUP
 591         errno = ENOTSUP;
 592 #else
 593         errno = ENOSYS;
 594 #endif
 595         return -1;
 596 }
 597
 598 int sys_acl_delete_def_file(vfs_handle_struct *handle,
 599                             const char *path)
 600 {
 601 #ifdef ENOTSUP
 602         errno = ENOTSUP;
 603 #else
 604         errno = ENOSYS;
 605 #endif
 606         return -1;
 607 }
 608
 609 #endif
 610
 611 /************************************************************************
 612  Deliberately outside the ACL defines. Return 1 if this is a "no acls"
 613  errno, 0 if not.
 614 ************************************************************************/
 615
 616 int no_acl_syscall_error(int err)
 617 {
 618 #if defined(ENOSYS)
 619         if (err == ENOSYS) {
 620                 return 1;
 621         }
 622 #endif
 623 #if defined(ENOTSUP)
 624         if (err == ENOTSUP) {
 625                 return 1;
 626         }
 627 #endif
 628         return 0;
 629 }