2 Unix SMB/CIFS implementation.
3 SMB NT Security Descriptor / Unix permission conversion.
4 Copyright (C) Jeremy Allison 1994-2000.
5 Copyright (C) Andreas Gruenbacher 2002.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 extern struct current_user current_user;
25 extern struct generic_mapping file_generic_mapping;
28 #define DBGC_CLASS DBGC_ACLS
30 /****************************************************************************
31 Data structures representing the internal ACE format.
32 ****************************************************************************/
34 enum ace_owner {UID_ACE, GID_ACE, WORLD_ACE};
35 enum ace_attribute {ALLOW_ACE, DENY_ACE}; /* Used for incoming NT ACLS. */
37 typedef union posix_id {
43 typedef struct canon_ace {
44 struct canon_ace *next, *prev;
46 mode_t perms; /* Only use S_I(R|W|X)USR mode bits here. */
48 enum ace_owner owner_type;
49 enum ace_attribute attr;
54 #define ALL_ACE_PERMS (S_IRUSR|S_IWUSR|S_IXUSR)
57 * EA format of user.SAMBA_PAI (Samba_Posix_Acl_Interitance)
60 * | 1 | 1 | 2 | 2 | ....
61 * +------+------+-------------+---------------------+-------------+--------------------+
62 * | vers | flag | num_entries | num_default_entries | ..entries.. | default_entries... |
63 * +------+------+-------------+---------------------+-------------+--------------------+
66 #define PAI_VERSION_OFFSET 0
67 #define PAI_FLAG_OFFSET 1
68 #define PAI_NUM_ENTRIES_OFFSET 2
69 #define PAI_NUM_DEFAULT_ENTRIES_OFFSET 4
70 #define PAI_ENTRIES_BASE 6
73 #define PAI_ACL_FLAG_PROTECTED 0x1
74 #define PAI_ENTRY_LENGTH 5
77 * In memory format of user.SAMBA_PAI attribute.
81 struct pai_entry *next, *prev;
82 enum ace_owner owner_type;
88 unsigned int num_entries;
89 struct pai_entry *entry_list;
90 unsigned int num_def_entries;
91 struct pai_entry *def_entry_list;
94 /************************************************************************
95 Return a uint32 of the pai_entry principal.
96 ************************************************************************/
98 static uint32 get_pai_entry_val(struct pai_entry *paie)
100 switch (paie->owner_type) {
102 DEBUG(10,("get_pai_entry_val: uid = %u\n", (unsigned int)paie->unix_ug.uid ));
103 return (uint32)paie->unix_ug.uid;
105 DEBUG(10,("get_pai_entry_val: gid = %u\n", (unsigned int)paie->unix_ug.gid ));
106 return (uint32)paie->unix_ug.gid;
109 DEBUG(10,("get_pai_entry_val: world ace\n"));
114 /************************************************************************
115 Return a uint32 of the entry principal.
116 ************************************************************************/
118 static uint32 get_entry_val(canon_ace *ace_entry)
120 switch (ace_entry->owner_type) {
122 DEBUG(10,("get_entry_val: uid = %u\n", (unsigned int)ace_entry->unix_ug.uid ));
123 return (uint32)ace_entry->unix_ug.uid;
125 DEBUG(10,("get_entry_val: gid = %u\n", (unsigned int)ace_entry->unix_ug.gid ));
126 return (uint32)ace_entry->unix_ug.gid;
129 DEBUG(10,("get_entry_val: world ace\n"));
134 /************************************************************************
135 Count the inherited entries.
136 ************************************************************************/
138 static unsigned int num_inherited_entries(canon_ace *ace_list)
140 unsigned int num_entries = 0;
142 for (; ace_list; ace_list = ace_list->next)
143 if (ace_list->inherited)
148 /************************************************************************
149 Create the on-disk format. Caller must free.
150 ************************************************************************/
152 static char *create_pai_buf(canon_ace *file_ace_list, canon_ace *dir_ace_list, BOOL pai_protected, size_t *store_size)
154 char *pai_buf = NULL;
155 canon_ace *ace_list = NULL;
156 char *entry_offset = NULL;
157 unsigned int num_entries = 0;
158 unsigned int num_def_entries = 0;
160 for (ace_list = file_ace_list; ace_list; ace_list = ace_list->next)
161 if (ace_list->inherited)
164 for (ace_list = dir_ace_list; ace_list; ace_list = ace_list->next)
165 if (ace_list->inherited)
168 DEBUG(10,("create_pai_buf: num_entries = %u, num_def_entries = %u\n", num_entries, num_def_entries ));
170 *store_size = PAI_ENTRIES_BASE + ((num_entries + num_def_entries)*PAI_ENTRY_LENGTH);
172 pai_buf = (char *)SMB_MALLOC(*store_size);
177 /* Set up the header. */
178 memset(pai_buf, '\0', PAI_ENTRIES_BASE);
179 SCVAL(pai_buf,PAI_VERSION_OFFSET,PAI_VERSION);
180 SCVAL(pai_buf,PAI_FLAG_OFFSET,(pai_protected ? PAI_ACL_FLAG_PROTECTED : 0));
181 SSVAL(pai_buf,PAI_NUM_ENTRIES_OFFSET,num_entries);
182 SSVAL(pai_buf,PAI_NUM_DEFAULT_ENTRIES_OFFSET,num_def_entries);
184 entry_offset = pai_buf + PAI_ENTRIES_BASE;
186 for (ace_list = file_ace_list; ace_list; ace_list = ace_list->next) {
187 if (ace_list->inherited) {
188 uint8 type_val = (unsigned char)ace_list->owner_type;
189 uint32 entry_val = get_entry_val(ace_list);
191 SCVAL(entry_offset,0,type_val);
192 SIVAL(entry_offset,1,entry_val);
193 entry_offset += PAI_ENTRY_LENGTH;
197 for (ace_list = dir_ace_list; ace_list; ace_list = ace_list->next) {
198 if (ace_list->inherited) {
199 uint8 type_val = (unsigned char)ace_list->owner_type;
200 uint32 entry_val = get_entry_val(ace_list);
202 SCVAL(entry_offset,0,type_val);
203 SIVAL(entry_offset,1,entry_val);
204 entry_offset += PAI_ENTRY_LENGTH;
211 /************************************************************************
212 Store the user.SAMBA_PAI attribute on disk.
213 ************************************************************************/
215 static void store_inheritance_attributes(files_struct *fsp, canon_ace *file_ace_list,
216 canon_ace *dir_ace_list, BOOL pai_protected)
222 if (!lp_map_acl_inherit(SNUM(fsp->conn)))
226 * Don't store if this ACL isn't protected and
227 * none of the entries in it are marked as inherited.
230 if (!pai_protected && num_inherited_entries(file_ace_list) == 0 && num_inherited_entries(dir_ace_list) == 0) {
231 /* Instead just remove the attribute if it exists. */
232 if (fsp->fh->fd != -1)
233 SMB_VFS_FREMOVEXATTR(fsp, fsp->fh->fd, SAMBA_POSIX_INHERITANCE_EA_NAME);
235 SMB_VFS_REMOVEXATTR(fsp->conn, fsp->fsp_name, SAMBA_POSIX_INHERITANCE_EA_NAME);
239 pai_buf = create_pai_buf(file_ace_list, dir_ace_list, pai_protected, &store_size);
241 if (fsp->fh->fd != -1)
242 ret = SMB_VFS_FSETXATTR(fsp, fsp->fh->fd, SAMBA_POSIX_INHERITANCE_EA_NAME,
243 pai_buf, store_size, 0);
245 ret = SMB_VFS_SETXATTR(fsp->conn,fsp->fsp_name, SAMBA_POSIX_INHERITANCE_EA_NAME,
246 pai_buf, store_size, 0);
250 DEBUG(10,("store_inheritance_attribute:%s for file %s\n", pai_protected ? " (protected)" : "", fsp->fsp_name));
251 if (ret == -1 && !no_acl_syscall_error(errno))
252 DEBUG(1,("store_inheritance_attribute: Error %s\n", strerror(errno) ));
255 /************************************************************************
256 Delete the in memory inheritance info.
257 ************************************************************************/
259 static void free_inherited_info(struct pai_val *pal)
262 struct pai_entry *paie, *paie_next;
263 for (paie = pal->entry_list; paie; paie = paie_next) {
264 paie_next = paie->next;
267 for (paie = pal->def_entry_list; paie; paie = paie_next) {
268 paie_next = paie->next;
275 /************************************************************************
276 Was this ACL protected ?
277 ************************************************************************/
279 static BOOL get_protected_flag(struct pai_val *pal)
283 return pal->pai_protected;
286 /************************************************************************
287 Was this ACE inherited ?
288 ************************************************************************/
290 static BOOL get_inherited_flag(struct pai_val *pal, canon_ace *ace_entry, BOOL default_ace)
292 struct pai_entry *paie;
297 /* If the entry exists it is inherited. */
298 for (paie = (default_ace ? pal->def_entry_list : pal->entry_list); paie; paie = paie->next) {
299 if (ace_entry->owner_type == paie->owner_type &&
300 get_entry_val(ace_entry) == get_pai_entry_val(paie))
306 /************************************************************************
307 Ensure an attribute just read is valid.
308 ************************************************************************/
310 static BOOL check_pai_ok(char *pai_buf, size_t pai_buf_data_size)
313 uint16 num_def_entries;
315 if (pai_buf_data_size < PAI_ENTRIES_BASE) {
316 /* Corrupted - too small. */
320 if (CVAL(pai_buf,PAI_VERSION_OFFSET) != PAI_VERSION)
323 num_entries = SVAL(pai_buf,PAI_NUM_ENTRIES_OFFSET);
324 num_def_entries = SVAL(pai_buf,PAI_NUM_DEFAULT_ENTRIES_OFFSET);
326 /* Check the entry lists match. */
327 /* Each entry is 5 bytes (type plus 4 bytes of uid or gid). */
329 if (((num_entries + num_def_entries)*PAI_ENTRY_LENGTH) + PAI_ENTRIES_BASE != pai_buf_data_size)
336 /************************************************************************
337 Convert to in-memory format.
338 ************************************************************************/
340 static struct pai_val *create_pai_val(char *buf, size_t size)
343 struct pai_val *paiv = NULL;
346 if (!check_pai_ok(buf, size))
349 paiv = SMB_MALLOC_P(struct pai_val);
353 memset(paiv, '\0', sizeof(struct pai_val));
355 paiv->pai_protected = (CVAL(buf,PAI_FLAG_OFFSET) == PAI_ACL_FLAG_PROTECTED);
357 paiv->num_entries = SVAL(buf,PAI_NUM_ENTRIES_OFFSET);
358 paiv->num_def_entries = SVAL(buf,PAI_NUM_DEFAULT_ENTRIES_OFFSET);
360 entry_offset = buf + PAI_ENTRIES_BASE;
362 DEBUG(10,("create_pai_val:%s num_entries = %u, num_def_entries = %u\n",
363 paiv->pai_protected ? " (pai_protected)" : "", paiv->num_entries, paiv->num_def_entries ));
365 for (i = 0; i < paiv->num_entries; i++) {
366 struct pai_entry *paie;
368 paie = SMB_MALLOC_P(struct pai_entry);
370 free_inherited_info(paiv);
374 paie->owner_type = (enum ace_owner)CVAL(entry_offset,0);
375 switch( paie->owner_type) {
377 paie->unix_ug.uid = (uid_t)IVAL(entry_offset,1);
378 DEBUG(10,("create_pai_val: uid = %u\n", (unsigned int)paie->unix_ug.uid ));
381 paie->unix_ug.gid = (gid_t)IVAL(entry_offset,1);
382 DEBUG(10,("create_pai_val: gid = %u\n", (unsigned int)paie->unix_ug.gid ));
385 paie->unix_ug.world = -1;
386 DEBUG(10,("create_pai_val: world ace\n"));
389 free_inherited_info(paiv);
392 entry_offset += PAI_ENTRY_LENGTH;
393 DLIST_ADD(paiv->entry_list, paie);
396 for (i = 0; i < paiv->num_def_entries; i++) {
397 struct pai_entry *paie;
399 paie = SMB_MALLOC_P(struct pai_entry);
401 free_inherited_info(paiv);
405 paie->owner_type = (enum ace_owner)CVAL(entry_offset,0);
406 switch( paie->owner_type) {
408 paie->unix_ug.uid = (uid_t)IVAL(entry_offset,1);
409 DEBUG(10,("create_pai_val: (def) uid = %u\n", (unsigned int)paie->unix_ug.uid ));
412 paie->unix_ug.gid = (gid_t)IVAL(entry_offset,1);
413 DEBUG(10,("create_pai_val: (def) gid = %u\n", (unsigned int)paie->unix_ug.gid ));
416 paie->unix_ug.world = -1;
417 DEBUG(10,("create_pai_val: (def) world ace\n"));
420 free_inherited_info(paiv);
423 entry_offset += PAI_ENTRY_LENGTH;
424 DLIST_ADD(paiv->def_entry_list, paie);
430 /************************************************************************
431 Load the user.SAMBA_PAI attribute.
432 ************************************************************************/
434 static struct pai_val *load_inherited_info(files_struct *fsp)
437 size_t pai_buf_size = 1024;
438 struct pai_val *paiv = NULL;
441 if (!lp_map_acl_inherit(SNUM(fsp->conn)))
444 if ((pai_buf = (char *)SMB_MALLOC(pai_buf_size)) == NULL)
448 if (fsp->fh->fd != -1)
449 ret = SMB_VFS_FGETXATTR(fsp, fsp->fh->fd, SAMBA_POSIX_INHERITANCE_EA_NAME,
450 pai_buf, pai_buf_size);
452 ret = SMB_VFS_GETXATTR(fsp->conn,fsp->fsp_name,SAMBA_POSIX_INHERITANCE_EA_NAME,
453 pai_buf, pai_buf_size);
456 if (errno != ERANGE) {
459 /* Buffer too small - enlarge it. */
462 if (pai_buf_size > 1024*1024) {
463 return NULL; /* Limit malloc to 1mb. */
465 if ((pai_buf = (char *)SMB_MALLOC(pai_buf_size)) == NULL)
470 DEBUG(10,("load_inherited_info: ret = %lu for file %s\n", (unsigned long)ret, fsp->fsp_name));
473 /* No attribute or not supported. */
475 if (errno != ENOATTR)
476 DEBUG(10,("load_inherited_info: Error %s\n", strerror(errno) ));
479 DEBUG(10,("load_inherited_info: Error %s\n", strerror(errno) ));
485 paiv = create_pai_val(pai_buf, ret);
487 if (paiv && paiv->pai_protected)
488 DEBUG(10,("load_inherited_info: ACL is protected for file %s\n", fsp->fsp_name));
494 /****************************************************************************
495 Functions to manipulate the internal ACE format.
496 ****************************************************************************/
498 /****************************************************************************
499 Count a linked list of canonical ACE entries.
500 ****************************************************************************/
502 static size_t count_canon_ace_list( canon_ace *list_head )
507 for (ace = list_head; ace; ace = ace->next)
513 /****************************************************************************
514 Free a linked list of canonical ACE entries.
515 ****************************************************************************/
517 static void free_canon_ace_list( canon_ace *list_head )
519 canon_ace *list, *next;
521 for (list = list_head; list; list = next) {
523 DLIST_REMOVE(list_head, list);
528 /****************************************************************************
529 Function to duplicate a canon_ace entry.
530 ****************************************************************************/
532 static canon_ace *dup_canon_ace( canon_ace *src_ace)
534 canon_ace *dst_ace = SMB_MALLOC_P(canon_ace);
540 dst_ace->prev = dst_ace->next = NULL;
544 /****************************************************************************
545 Print out a canon ace.
546 ****************************************************************************/
548 static void print_canon_ace(canon_ace *pace, int num)
552 dbgtext( "canon_ace index %d. Type = %s ", num, pace->attr == ALLOW_ACE ? "allow" : "deny" );
553 dbgtext( "SID = %s ", sid_to_string( str, &pace->trustee));
554 if (pace->owner_type == UID_ACE) {
555 const char *u_name = uidtoname(pace->unix_ug.uid);
556 dbgtext( "uid %u (%s) ", (unsigned int)pace->unix_ug.uid, u_name );
557 } else if (pace->owner_type == GID_ACE) {
558 char *g_name = gidtoname(pace->unix_ug.gid);
559 dbgtext( "gid %u (%s) ", (unsigned int)pace->unix_ug.gid, g_name );
562 switch (pace->type) {
564 dbgtext( "SMB_ACL_USER ");
566 case SMB_ACL_USER_OBJ:
567 dbgtext( "SMB_ACL_USER_OBJ ");
570 dbgtext( "SMB_ACL_GROUP ");
572 case SMB_ACL_GROUP_OBJ:
573 dbgtext( "SMB_ACL_GROUP_OBJ ");
576 dbgtext( "SMB_ACL_OTHER ");
583 dbgtext( "(inherited) ");
585 dbgtext( "%c", pace->perms & S_IRUSR ? 'r' : '-');
586 dbgtext( "%c", pace->perms & S_IWUSR ? 'w' : '-');
587 dbgtext( "%c\n", pace->perms & S_IXUSR ? 'x' : '-');
590 /****************************************************************************
591 Print out a canon ace list.
592 ****************************************************************************/
594 static void print_canon_ace_list(const char *name, canon_ace *ace_list)
598 if( DEBUGLVL( 10 )) {
599 dbgtext( "print_canon_ace_list: %s\n", name );
600 for (;ace_list; ace_list = ace_list->next, count++)
601 print_canon_ace(ace_list, count );
605 /****************************************************************************
606 Map POSIX ACL perms to canon_ace permissions (a mode_t containing only S_(R|W|X)USR bits).
607 ****************************************************************************/
609 static mode_t convert_permset_to_mode_t(connection_struct *conn, SMB_ACL_PERMSET_T permset)
613 ret |= (SMB_VFS_SYS_ACL_GET_PERM(conn, permset, SMB_ACL_READ) ? S_IRUSR : 0);
614 ret |= (SMB_VFS_SYS_ACL_GET_PERM(conn, permset, SMB_ACL_WRITE) ? S_IWUSR : 0);
615 ret |= (SMB_VFS_SYS_ACL_GET_PERM(conn, permset, SMB_ACL_EXECUTE) ? S_IXUSR : 0);
620 /****************************************************************************
621 Map generic UNIX permissions to canon_ace permissions (a mode_t containing only S_(R|W|X)USR bits).
622 ****************************************************************************/
624 static mode_t unix_perms_to_acl_perms(mode_t mode, int r_mask, int w_mask, int x_mask)
638 /****************************************************************************
639 Map canon_ace permissions (a mode_t containing only S_(R|W|X)USR bits) to
640 an SMB_ACL_PERMSET_T.
641 ****************************************************************************/
643 static int map_acl_perms_to_permset(connection_struct *conn, mode_t mode, SMB_ACL_PERMSET_T *p_permset)
645 if (SMB_VFS_SYS_ACL_CLEAR_PERMS(conn, *p_permset) == -1)
647 if (mode & S_IRUSR) {
648 if (SMB_VFS_SYS_ACL_ADD_PERM(conn, *p_permset, SMB_ACL_READ) == -1)
651 if (mode & S_IWUSR) {
652 if (SMB_VFS_SYS_ACL_ADD_PERM(conn, *p_permset, SMB_ACL_WRITE) == -1)
655 if (mode & S_IXUSR) {
656 if (SMB_VFS_SYS_ACL_ADD_PERM(conn, *p_permset, SMB_ACL_EXECUTE) == -1)
662 /****************************************************************************
663 Function to create owner and group SIDs from a SMB_STRUCT_STAT.
664 ****************************************************************************/
666 static void create_file_sids(SMB_STRUCT_STAT *psbuf, DOM_SID *powner_sid, DOM_SID *pgroup_sid)
668 uid_to_sid( powner_sid, psbuf->st_uid );
669 gid_to_sid( pgroup_sid, psbuf->st_gid );
672 /****************************************************************************
673 Is the identity in two ACEs equal ? Check both SID and uid/gid.
674 ****************************************************************************/
676 static BOOL identity_in_ace_equal(canon_ace *ace1, canon_ace *ace2)
678 if (sid_equal(&ace1->trustee, &ace2->trustee)) {
681 if (ace1->owner_type == ace2->owner_type) {
682 if (ace1->owner_type == UID_ACE &&
683 ace1->unix_ug.uid == ace2->unix_ug.uid) {
685 } else if (ace1->owner_type == GID_ACE &&
686 ace1->unix_ug.gid == ace2->unix_ug.gid) {
693 /****************************************************************************
694 Merge aces with a common sid - if both are allow or deny, OR the permissions together and
695 delete the second one. If the first is deny, mask the permissions off and delete the allow
696 if the permissions become zero, delete the deny if the permissions are non zero.
697 ****************************************************************************/
699 static void merge_aces( canon_ace **pp_list_head )
701 canon_ace *list_head = *pp_list_head;
702 canon_ace *curr_ace_outer;
703 canon_ace *curr_ace_outer_next;
706 * First, merge allow entries with identical SIDs, and deny entries
707 * with identical SIDs.
710 for (curr_ace_outer = list_head; curr_ace_outer; curr_ace_outer = curr_ace_outer_next) {
712 canon_ace *curr_ace_next;
714 curr_ace_outer_next = curr_ace_outer->next; /* Save the link in case we delete. */
716 for (curr_ace = curr_ace_outer->next; curr_ace; curr_ace = curr_ace_next) {
718 curr_ace_next = curr_ace->next; /* Save the link in case of delete. */
720 if (identity_in_ace_equal(curr_ace, curr_ace_outer) &&
721 (curr_ace->attr == curr_ace_outer->attr)) {
723 if( DEBUGLVL( 10 )) {
724 dbgtext("merge_aces: Merging ACE's\n");
725 print_canon_ace( curr_ace_outer, 0);
726 print_canon_ace( curr_ace, 0);
729 /* Merge two allow or two deny ACE's. */
731 curr_ace_outer->perms |= curr_ace->perms;
732 DLIST_REMOVE(list_head, curr_ace);
734 curr_ace_outer_next = curr_ace_outer->next; /* We may have deleted the link. */
740 * Now go through and mask off allow permissions with deny permissions.
741 * We can delete either the allow or deny here as we know that each SID
742 * appears only once in the list.
745 for (curr_ace_outer = list_head; curr_ace_outer; curr_ace_outer = curr_ace_outer_next) {
747 canon_ace *curr_ace_next;
749 curr_ace_outer_next = curr_ace_outer->next; /* Save the link in case we delete. */
751 for (curr_ace = curr_ace_outer->next; curr_ace; curr_ace = curr_ace_next) {
753 curr_ace_next = curr_ace->next; /* Save the link in case of delete. */
756 * Subtract ACE's with different entries. Due to the ordering constraints
757 * we've put on the ACL, we know the deny must be the first one.
760 if (identity_in_ace_equal(curr_ace, curr_ace_outer) &&
761 (curr_ace_outer->attr == DENY_ACE) && (curr_ace->attr == ALLOW_ACE)) {
763 if( DEBUGLVL( 10 )) {
764 dbgtext("merge_aces: Masking ACE's\n");
765 print_canon_ace( curr_ace_outer, 0);
766 print_canon_ace( curr_ace, 0);
769 curr_ace->perms &= ~curr_ace_outer->perms;
771 if (curr_ace->perms == 0) {
774 * The deny overrides the allow. Remove the allow.
777 DLIST_REMOVE(list_head, curr_ace);
779 curr_ace_outer_next = curr_ace_outer->next; /* We may have deleted the link. */
784 * Even after removing permissions, there
785 * are still allow permissions - delete the deny.
786 * It is safe to delete the deny here,
787 * as we are guarenteed by the deny first
788 * ordering that all the deny entries for
789 * this SID have already been merged into one
790 * before we can get to an allow ace.
793 DLIST_REMOVE(list_head, curr_ace_outer);
794 SAFE_FREE(curr_ace_outer);
799 } /* end for curr_ace */
800 } /* end for curr_ace_outer */
802 /* We may have modified the list. */
804 *pp_list_head = list_head;
807 /****************************************************************************
808 Check if we need to return NT4.x compatible ACL entries.
809 ****************************************************************************/
811 static BOOL nt4_compatible_acls(void)
813 int compat = lp_acl_compatibility();
815 if (compat == ACL_COMPAT_AUTO) {
816 enum remote_arch_types ra_type = get_remote_arch();
818 /* Automatically adapt to client */
819 return (ra_type <= RA_WINNT);
821 return (compat == ACL_COMPAT_WINNT);
825 /****************************************************************************
826 Map canon_ace perms to permission bits NT.
827 The attr element is not used here - we only process deny entries on set,
828 not get. Deny entries are implicit on get with ace->perms = 0.
829 ****************************************************************************/
831 static SEC_ACCESS map_canon_ace_perms(int snum,
839 *pacl_type = SEC_ACE_TYPE_ACCESS_ALLOWED;
841 if (lp_acl_map_full_control(snum) && ((perms & ALL_ACE_PERMS) == ALL_ACE_PERMS)) {
843 nt_mask = UNIX_DIRECTORY_ACCESS_RWX;
845 nt_mask = UNIX_ACCESS_RWX;
847 } else if ((perms & ALL_ACE_PERMS) == (mode_t)0) {
849 * Windows NT refuses to display ACEs with no permissions in them (but
850 * they are perfectly legal with Windows 2000). If the ACE has empty
851 * permissions we cannot use 0, so we use the otherwise unused
852 * WRITE_OWNER permission, which we ignore when we set an ACL.
853 * We abstract this into a #define of UNIX_ACCESS_NONE to allow this
854 * to be changed in the future.
857 if (nt4_compatible_acls())
858 nt_mask = UNIX_ACCESS_NONE;
863 nt_mask |= ((perms & S_IRUSR) ? UNIX_DIRECTORY_ACCESS_R : 0 );
864 nt_mask |= ((perms & S_IWUSR) ? UNIX_DIRECTORY_ACCESS_W : 0 );
865 nt_mask |= ((perms & S_IXUSR) ? UNIX_DIRECTORY_ACCESS_X : 0 );
867 nt_mask |= ((perms & S_IRUSR) ? UNIX_ACCESS_R : 0 );
868 nt_mask |= ((perms & S_IWUSR) ? UNIX_ACCESS_W : 0 );
869 nt_mask |= ((perms & S_IXUSR) ? UNIX_ACCESS_X : 0 );
873 DEBUG(10,("map_canon_ace_perms: Mapped (UNIX) %x to (NT) %x\n",
874 (unsigned int)perms, (unsigned int)nt_mask ));
876 init_sec_access(&sa,nt_mask);
880 /****************************************************************************
881 Map NT perms to a UNIX mode_t.
882 ****************************************************************************/
884 #define FILE_SPECIFIC_READ_BITS (FILE_READ_DATA|FILE_READ_EA|FILE_READ_ATTRIBUTES)
885 #define FILE_SPECIFIC_WRITE_BITS (FILE_WRITE_DATA|FILE_APPEND_DATA|FILE_WRITE_EA|FILE_WRITE_ATTRIBUTES)
886 #define FILE_SPECIFIC_EXECUTE_BITS (FILE_EXECUTE)
888 static mode_t map_nt_perms( uint32 *mask, int type)
894 if((*mask) & GENERIC_ALL_ACCESS)
895 mode = S_IRUSR|S_IWUSR|S_IXUSR;
897 mode |= ((*mask) & (GENERIC_READ_ACCESS|FILE_SPECIFIC_READ_BITS)) ? S_IRUSR : 0;
898 mode |= ((*mask) & (GENERIC_WRITE_ACCESS|FILE_SPECIFIC_WRITE_BITS)) ? S_IWUSR : 0;
899 mode |= ((*mask) & (GENERIC_EXECUTE_ACCESS|FILE_SPECIFIC_EXECUTE_BITS)) ? S_IXUSR : 0;
903 if((*mask) & GENERIC_ALL_ACCESS)
904 mode = S_IRGRP|S_IWGRP|S_IXGRP;
906 mode |= ((*mask) & (GENERIC_READ_ACCESS|FILE_SPECIFIC_READ_BITS)) ? S_IRGRP : 0;
907 mode |= ((*mask) & (GENERIC_WRITE_ACCESS|FILE_SPECIFIC_WRITE_BITS)) ? S_IWGRP : 0;
908 mode |= ((*mask) & (GENERIC_EXECUTE_ACCESS|FILE_SPECIFIC_EXECUTE_BITS)) ? S_IXGRP : 0;
912 if((*mask) & GENERIC_ALL_ACCESS)
913 mode = S_IROTH|S_IWOTH|S_IXOTH;
915 mode |= ((*mask) & (GENERIC_READ_ACCESS|FILE_SPECIFIC_READ_BITS)) ? S_IROTH : 0;
916 mode |= ((*mask) & (GENERIC_WRITE_ACCESS|FILE_SPECIFIC_WRITE_BITS)) ? S_IWOTH : 0;
917 mode |= ((*mask) & (GENERIC_EXECUTE_ACCESS|FILE_SPECIFIC_EXECUTE_BITS)) ? S_IXOTH : 0;
925 /****************************************************************************
926 Unpack a SEC_DESC into a UNIX owner and group.
927 ****************************************************************************/
929 BOOL unpack_nt_owners(int snum, uid_t *puser, gid_t *pgrp, uint32 security_info_sent, SEC_DESC *psd)
937 if(security_info_sent == 0) {
938 DEBUG(0,("unpack_nt_owners: no security info sent !\n"));
943 * Validate the owner and group SID's.
946 memset(&owner_sid, '\0', sizeof(owner_sid));
947 memset(&grp_sid, '\0', sizeof(grp_sid));
949 DEBUG(5,("unpack_nt_owners: validating owner_sids.\n"));
952 * Don't immediately fail if the owner sid cannot be validated.
953 * This may be a group chown only set.
956 if (security_info_sent & OWNER_SECURITY_INFORMATION) {
957 sid_copy(&owner_sid, psd->owner_sid);
958 if (!sid_to_uid(&owner_sid, puser)) {
959 if (lp_force_unknown_acl_user(snum)) {
960 /* this allows take ownership to work
962 *puser = current_user.ut.uid;
964 DEBUG(3,("unpack_nt_owners: unable to validate"
965 " owner sid for %s\n",
966 sid_string_static(&owner_sid)));
973 * Don't immediately fail if the group sid cannot be validated.
974 * This may be an owner chown only set.
977 if (security_info_sent & GROUP_SECURITY_INFORMATION) {
978 sid_copy(&grp_sid, psd->group_sid);
979 if (!sid_to_gid( &grp_sid, pgrp)) {
980 if (lp_force_unknown_acl_user(snum)) {
981 /* this allows take group ownership to work
983 *pgrp = current_user.ut.gid;
985 DEBUG(3,("unpack_nt_owners: unable to validate"
992 DEBUG(5,("unpack_nt_owners: owner_sids validated.\n"));
997 /****************************************************************************
998 Ensure the enforced permissions for this share apply.
999 ****************************************************************************/
1001 static void apply_default_perms(files_struct *fsp, canon_ace *pace, mode_t type)
1003 int snum = SNUM(fsp->conn);
1004 mode_t and_bits = (mode_t)0;
1005 mode_t or_bits = (mode_t)0;
1007 /* Get the initial bits to apply. */
1009 if (fsp->is_directory) {
1010 and_bits = lp_dir_security_mask(snum);
1011 or_bits = lp_force_dir_security_mode(snum);
1013 and_bits = lp_security_mask(snum);
1014 or_bits = lp_force_security_mode(snum);
1017 /* Now bounce them into the S_USR space. */
1020 /* Ensure owner has read access. */
1021 pace->perms |= S_IRUSR;
1022 if (fsp->is_directory)
1023 pace->perms |= (S_IWUSR|S_IXUSR);
1024 and_bits = unix_perms_to_acl_perms(and_bits, S_IRUSR, S_IWUSR, S_IXUSR);
1025 or_bits = unix_perms_to_acl_perms(or_bits, S_IRUSR, S_IWUSR, S_IXUSR);
1028 and_bits = unix_perms_to_acl_perms(and_bits, S_IRGRP, S_IWGRP, S_IXGRP);
1029 or_bits = unix_perms_to_acl_perms(or_bits, S_IRGRP, S_IWGRP, S_IXGRP);
1032 and_bits = unix_perms_to_acl_perms(and_bits, S_IROTH, S_IWOTH, S_IXOTH);
1033 or_bits = unix_perms_to_acl_perms(or_bits, S_IROTH, S_IWOTH, S_IXOTH);
1037 pace->perms = ((pace->perms & and_bits)|or_bits);
1040 /****************************************************************************
1041 Check if a given uid/SID is in a group gid/SID. This is probably very
1042 expensive and will need optimisation. A *lot* of optimisation :-). JRA.
1043 ****************************************************************************/
1045 static BOOL uid_entry_in_group( canon_ace *uid_ace, canon_ace *group_ace )
1049 /* "Everyone" always matches every uid. */
1051 if (sid_equal(&group_ace->trustee, &global_sid_World))
1054 /* Assume that the current user is in the current group (force group) */
1056 if (uid_ace->unix_ug.uid == current_user.ut.uid && group_ace->unix_ug.gid == current_user.ut.gid)
1059 fstrcpy(u_name, uidtoname(uid_ace->unix_ug.uid));
1060 return user_in_group_sid(u_name, &group_ace->trustee);
1063 /****************************************************************************
1064 A well formed POSIX file or default ACL has at least 3 entries, a
1065 SMB_ACL_USER_OBJ, SMB_ACL_GROUP_OBJ, SMB_ACL_OTHER_OBJ.
1066 In addition, the owner must always have at least read access.
1067 When using this call on get_acl, the pst struct is valid and contains
1068 the mode of the file. When using this call on set_acl, the pst struct has
1069 been modified to have a mode containing the default for this file or directory
1071 ****************************************************************************/
1073 static BOOL ensure_canon_entry_valid(canon_ace **pp_ace,
1075 const DOM_SID *pfile_owner_sid,
1076 const DOM_SID *pfile_grp_sid,
1077 SMB_STRUCT_STAT *pst,
1081 BOOL got_user = False;
1082 BOOL got_grp = False;
1083 BOOL got_other = False;
1084 canon_ace *pace_other = NULL;
1086 for (pace = *pp_ace; pace; pace = pace->next) {
1087 if (pace->type == SMB_ACL_USER_OBJ) {
1090 apply_default_perms(fsp, pace, S_IRUSR);
1093 } else if (pace->type == SMB_ACL_GROUP_OBJ) {
1096 * Ensure create mask/force create mode is respected on set.
1100 apply_default_perms(fsp, pace, S_IRGRP);
1103 } else if (pace->type == SMB_ACL_OTHER) {
1106 * Ensure create mask/force create mode is respected on set.
1110 apply_default_perms(fsp, pace, S_IROTH);
1117 if ((pace = SMB_MALLOC_P(canon_ace)) == NULL) {
1118 DEBUG(0,("ensure_canon_entry_valid: malloc fail.\n"));
1123 pace->type = SMB_ACL_USER_OBJ;
1124 pace->owner_type = UID_ACE;
1125 pace->unix_ug.uid = pst->st_uid;
1126 pace->trustee = *pfile_owner_sid;
1127 pace->attr = ALLOW_ACE;
1130 /* See if the owning user is in any of the other groups in
1131 the ACE. If so, OR in the permissions from that group. */
1133 BOOL group_matched = False;
1134 canon_ace *pace_iter;
1136 for (pace_iter = *pp_ace; pace_iter; pace_iter = pace_iter->next) {
1137 if (pace_iter->type == SMB_ACL_GROUP_OBJ || pace_iter->type == SMB_ACL_GROUP) {
1138 if (uid_entry_in_group(pace, pace_iter)) {
1139 pace->perms |= pace_iter->perms;
1140 group_matched = True;
1145 /* If we only got an "everyone" perm, just use that. */
1146 if (!group_matched) {
1148 pace->perms = pace_other->perms;
1153 apply_default_perms(fsp, pace, S_IRUSR);
1155 pace->perms = unix_perms_to_acl_perms(pst->st_mode, S_IRUSR, S_IWUSR, S_IXUSR);
1158 DLIST_ADD(*pp_ace, pace);
1162 if ((pace = SMB_MALLOC_P(canon_ace)) == NULL) {
1163 DEBUG(0,("ensure_canon_entry_valid: malloc fail.\n"));
1168 pace->type = SMB_ACL_GROUP_OBJ;
1169 pace->owner_type = GID_ACE;
1170 pace->unix_ug.uid = pst->st_gid;
1171 pace->trustee = *pfile_grp_sid;
1172 pace->attr = ALLOW_ACE;
1174 /* If we only got an "everyone" perm, just use that. */
1176 pace->perms = pace_other->perms;
1179 apply_default_perms(fsp, pace, S_IRGRP);
1181 pace->perms = unix_perms_to_acl_perms(pst->st_mode, S_IRGRP, S_IWGRP, S_IXGRP);
1184 DLIST_ADD(*pp_ace, pace);
1188 if ((pace = SMB_MALLOC_P(canon_ace)) == NULL) {
1189 DEBUG(0,("ensure_canon_entry_valid: malloc fail.\n"));
1194 pace->type = SMB_ACL_OTHER;
1195 pace->owner_type = WORLD_ACE;
1196 pace->unix_ug.world = -1;
1197 pace->trustee = global_sid_World;
1198 pace->attr = ALLOW_ACE;
1201 apply_default_perms(fsp, pace, S_IROTH);
1203 pace->perms = unix_perms_to_acl_perms(pst->st_mode, S_IROTH, S_IWOTH, S_IXOTH);
1205 DLIST_ADD(*pp_ace, pace);
1211 /****************************************************************************
1212 Check if a POSIX ACL has the required SMB_ACL_USER_OBJ and SMB_ACL_GROUP_OBJ entries.
1213 If it does not have them, check if there are any entries where the trustee is the
1214 file owner or the owning group, and map these to SMB_ACL_USER_OBJ and SMB_ACL_GROUP_OBJ.
1215 ****************************************************************************/
1217 static void check_owning_objs(canon_ace *ace, DOM_SID *pfile_owner_sid, DOM_SID *pfile_grp_sid)
1219 BOOL got_user_obj, got_group_obj;
1220 canon_ace *current_ace;
1223 entries = count_canon_ace_list(ace);
1224 got_user_obj = False;
1225 got_group_obj = False;
1227 for (i=0, current_ace = ace; i < entries; i++, current_ace = current_ace->next) {
1228 if (current_ace->type == SMB_ACL_USER_OBJ)
1229 got_user_obj = True;
1230 else if (current_ace->type == SMB_ACL_GROUP_OBJ)
1231 got_group_obj = True;
1233 if (got_user_obj && got_group_obj) {
1234 DEBUG(10,("check_owning_objs: ACL had owning user/group entries.\n"));
1238 for (i=0, current_ace = ace; i < entries; i++, current_ace = current_ace->next) {
1239 if (!got_user_obj && current_ace->owner_type == UID_ACE &&
1240 sid_equal(¤t_ace->trustee, pfile_owner_sid)) {
1241 current_ace->type = SMB_ACL_USER_OBJ;
1242 got_user_obj = True;
1244 if (!got_group_obj && current_ace->owner_type == GID_ACE &&
1245 sid_equal(¤t_ace->trustee, pfile_grp_sid)) {
1246 current_ace->type = SMB_ACL_GROUP_OBJ;
1247 got_group_obj = True;
1251 DEBUG(10,("check_owning_objs: ACL is missing an owner entry.\n"));
1253 DEBUG(10,("check_owning_objs: ACL is missing an owning group entry.\n"));
1256 /****************************************************************************
1257 Unpack a SEC_DESC into two canonical ace lists.
1258 ****************************************************************************/
1260 static BOOL create_canon_ace_lists(files_struct *fsp, SMB_STRUCT_STAT *pst,
1261 DOM_SID *pfile_owner_sid,
1262 DOM_SID *pfile_grp_sid,
1263 canon_ace **ppfile_ace, canon_ace **ppdir_ace,
1266 BOOL all_aces_are_inherit_only = (fsp->is_directory ? True : False);
1267 canon_ace *file_ace = NULL;
1268 canon_ace *dir_ace = NULL;
1269 canon_ace *current_ace = NULL;
1270 BOOL got_dir_allow = False;
1271 BOOL got_file_allow = False;
1278 * Convert the incoming ACL into a more regular form.
1281 for(i = 0; i < dacl->num_aces; i++) {
1282 SEC_ACE *psa = &dacl->aces[i];
1284 if((psa->type != SEC_ACE_TYPE_ACCESS_ALLOWED) && (psa->type != SEC_ACE_TYPE_ACCESS_DENIED)) {
1285 DEBUG(3,("create_canon_ace_lists: unable to set anything but an ALLOW or DENY ACE.\n"));
1289 if (nt4_compatible_acls()) {
1291 * The security mask may be UNIX_ACCESS_NONE which should map into
1292 * no permissions (we overload the WRITE_OWNER bit for this) or it
1293 * should be one of the ALL/EXECUTE/READ/WRITE bits. Arrange for this
1294 * to be so. Any other bits override the UNIX_ACCESS_NONE bit.
1298 * Convert GENERIC bits to specific bits.
1301 se_map_generic(&psa->access_mask, &file_generic_mapping);
1303 psa->access_mask &= (UNIX_ACCESS_NONE|FILE_ALL_ACCESS);
1305 if(psa->access_mask != UNIX_ACCESS_NONE)
1306 psa->access_mask &= ~UNIX_ACCESS_NONE;
1311 * Deal with the fact that NT 4.x re-writes the canonical format
1312 * that we return for default ACLs. If a directory ACE is identical
1313 * to a inherited directory ACE then NT changes the bits so that the
1314 * first ACE is set to OI|IO and the second ACE for this SID is set
1315 * to CI. We need to repair this. JRA.
1318 for(i = 0; i < dacl->num_aces; i++) {
1319 SEC_ACE *psa1 = &dacl->aces[i];
1321 for (j = i + 1; j < dacl->num_aces; j++) {
1322 SEC_ACE *psa2 = &dacl->aces[j];
1324 if (psa1->access_mask != psa2->access_mask)
1327 if (!sid_equal(&psa1->trustee, &psa2->trustee))
1331 * Ok - permission bits and SIDs are equal.
1332 * Check if flags were re-written.
1335 if (psa1->flags & SEC_ACE_FLAG_INHERIT_ONLY) {
1337 psa1->flags |= (psa2->flags & (SEC_ACE_FLAG_CONTAINER_INHERIT|SEC_ACE_FLAG_OBJECT_INHERIT));
1338 psa2->flags &= ~(SEC_ACE_FLAG_CONTAINER_INHERIT|SEC_ACE_FLAG_OBJECT_INHERIT);
1340 } else if (psa2->flags & SEC_ACE_FLAG_INHERIT_ONLY) {
1342 psa2->flags |= (psa1->flags & (SEC_ACE_FLAG_CONTAINER_INHERIT|SEC_ACE_FLAG_OBJECT_INHERIT));
1343 psa1->flags &= ~(SEC_ACE_FLAG_CONTAINER_INHERIT|SEC_ACE_FLAG_OBJECT_INHERIT);
1349 for(i = 0; i < dacl->num_aces; i++) {
1350 SEC_ACE *psa = &dacl->aces[i];
1353 * Create a cannon_ace entry representing this NT DACL ACE.
1356 if ((current_ace = SMB_MALLOC_P(canon_ace)) == NULL) {
1357 free_canon_ace_list(file_ace);
1358 free_canon_ace_list(dir_ace);
1359 DEBUG(0,("create_canon_ace_lists: malloc fail.\n"));
1363 ZERO_STRUCTP(current_ace);
1365 sid_copy(¤t_ace->trustee, &psa->trustee);
1368 * Try and work out if the SID is a user or group
1369 * as we need to flag these differently for POSIX.
1370 * Note what kind of a POSIX ACL this should map to.
1373 if( sid_equal(¤t_ace->trustee, &global_sid_World)) {
1374 current_ace->owner_type = WORLD_ACE;
1375 current_ace->unix_ug.world = -1;
1376 current_ace->type = SMB_ACL_OTHER;
1377 } else if (sid_equal(¤t_ace->trustee, &global_sid_Creator_Owner)) {
1378 current_ace->owner_type = UID_ACE;
1379 current_ace->unix_ug.uid = pst->st_uid;
1380 current_ace->type = SMB_ACL_USER_OBJ;
1383 * The Creator Owner entry only specifies inheritable permissions,
1384 * never access permissions. WinNT doesn't always set the ACE to
1385 *INHERIT_ONLY, though.
1388 if (nt4_compatible_acls())
1389 psa->flags |= SEC_ACE_FLAG_INHERIT_ONLY;
1390 } else if (sid_equal(¤t_ace->trustee, &global_sid_Creator_Group)) {
1391 current_ace->owner_type = GID_ACE;
1392 current_ace->unix_ug.gid = pst->st_gid;
1393 current_ace->type = SMB_ACL_GROUP_OBJ;
1396 * The Creator Group entry only specifies inheritable permissions,
1397 * never access permissions. WinNT doesn't always set the ACE to
1398 *INHERIT_ONLY, though.
1400 if (nt4_compatible_acls())
1401 psa->flags |= SEC_ACE_FLAG_INHERIT_ONLY;
1403 } else if (sid_to_uid( ¤t_ace->trustee, ¤t_ace->unix_ug.uid)) {
1404 current_ace->owner_type = UID_ACE;
1405 /* If it's the owning user, this is a user_obj, not
1407 if (current_ace->unix_ug.uid == pst->st_uid) {
1408 current_ace->type = SMB_ACL_USER_OBJ;
1410 current_ace->type = SMB_ACL_USER;
1412 } else if (sid_to_gid( ¤t_ace->trustee, ¤t_ace->unix_ug.gid)) {
1413 current_ace->owner_type = GID_ACE;
1414 /* If it's the primary group, this is a group_obj, not
1416 if (current_ace->unix_ug.gid == pst->st_gid) {
1417 current_ace->type = SMB_ACL_GROUP_OBJ;
1419 current_ace->type = SMB_ACL_GROUP;
1425 * Silently ignore map failures in non-mappable SIDs (NT Authority, BUILTIN etc).
1428 if (non_mappable_sid(&psa->trustee)) {
1429 DEBUG(10,("create_canon_ace_lists: ignoring non-mappable SID %s\n",
1430 sid_to_string(str, &psa->trustee) ));
1431 SAFE_FREE(current_ace);
1435 free_canon_ace_list(file_ace);
1436 free_canon_ace_list(dir_ace);
1437 DEBUG(0,("create_canon_ace_lists: unable to map SID %s to uid or gid.\n",
1438 sid_to_string(str, ¤t_ace->trustee) ));
1439 SAFE_FREE(current_ace);
1444 * Map the given NT permissions into a UNIX mode_t containing only
1445 * S_I(R|W|X)USR bits.
1448 current_ace->perms |= map_nt_perms( &psa->access_mask, S_IRUSR);
1449 current_ace->attr = (psa->type == SEC_ACE_TYPE_ACCESS_ALLOWED) ? ALLOW_ACE : DENY_ACE;
1450 current_ace->inherited = ((psa->flags & SEC_ACE_FLAG_INHERITED_ACE) ? True : False);
1453 * Now add the created ace to either the file list, the directory
1454 * list, or both. We *MUST* preserve the order here (hence we use
1455 * DLIST_ADD_END) as NT ACLs are order dependent.
1458 if (fsp->is_directory) {
1461 * We can only add to the default POSIX ACE list if the ACE is
1462 * designed to be inherited by both files and directories.
1465 if ((psa->flags & (SEC_ACE_FLAG_OBJECT_INHERIT|SEC_ACE_FLAG_CONTAINER_INHERIT)) ==
1466 (SEC_ACE_FLAG_OBJECT_INHERIT|SEC_ACE_FLAG_CONTAINER_INHERIT)) {
1468 DLIST_ADD_END(dir_ace, current_ace, canon_ace *);
1471 * Note if this was an allow ace. We can't process
1472 * any further deny ace's after this.
1475 if (current_ace->attr == ALLOW_ACE)
1476 got_dir_allow = True;
1478 if ((current_ace->attr == DENY_ACE) && got_dir_allow) {
1479 DEBUG(0,("create_canon_ace_lists: malformed ACL in inheritable ACL ! \
1480 Deny entry after Allow entry. Failing to set on file %s.\n", fsp->fsp_name ));
1481 free_canon_ace_list(file_ace);
1482 free_canon_ace_list(dir_ace);
1486 if( DEBUGLVL( 10 )) {
1487 dbgtext("create_canon_ace_lists: adding dir ACL:\n");
1488 print_canon_ace( current_ace, 0);
1492 * If this is not an inherit only ACE we need to add a duplicate
1496 if (!(psa->flags & SEC_ACE_FLAG_INHERIT_ONLY)) {
1497 canon_ace *dup_ace = dup_canon_ace(current_ace);
1500 DEBUG(0,("create_canon_ace_lists: malloc fail !\n"));
1501 free_canon_ace_list(file_ace);
1502 free_canon_ace_list(dir_ace);
1507 * We must not free current_ace here as its
1508 * pointer is now owned by the dir_ace list.
1510 current_ace = dup_ace;
1513 * We must not free current_ace here as its
1514 * pointer is now owned by the dir_ace list.
1522 * Only add to the file ACL if not inherit only.
1525 if (current_ace && !(psa->flags & SEC_ACE_FLAG_INHERIT_ONLY)) {
1526 DLIST_ADD_END(file_ace, current_ace, canon_ace *);
1529 * Note if this was an allow ace. We can't process
1530 * any further deny ace's after this.
1533 if (current_ace->attr == ALLOW_ACE)
1534 got_file_allow = True;
1536 if ((current_ace->attr == DENY_ACE) && got_file_allow) {
1537 DEBUG(0,("create_canon_ace_lists: malformed ACL in file ACL ! \
1538 Deny entry after Allow entry. Failing to set on file %s.\n", fsp->fsp_name ));
1539 free_canon_ace_list(file_ace);
1540 free_canon_ace_list(dir_ace);
1544 if( DEBUGLVL( 10 )) {
1545 dbgtext("create_canon_ace_lists: adding file ACL:\n");
1546 print_canon_ace( current_ace, 0);
1548 all_aces_are_inherit_only = False;
1550 * We must not free current_ace here as its
1551 * pointer is now owned by the file_ace list.
1557 * Free if ACE was not added.
1560 SAFE_FREE(current_ace);
1563 if (fsp->is_directory && all_aces_are_inherit_only) {
1565 * Windows 2000 is doing one of these weird 'inherit acl'
1566 * traverses to conserve NTFS ACL resources. Just pretend
1567 * there was no DACL sent. JRA.
1570 DEBUG(10,("create_canon_ace_lists: Win2k inherit acl traverse. Ignoring DACL.\n"));
1571 free_canon_ace_list(file_ace);
1572 free_canon_ace_list(dir_ace);
1577 * Check if we have SMB_ACL_USER_OBJ and SMB_ACL_GROUP_OBJ entries in each
1578 * ACL. If we don't have them, check if any SMB_ACL_USER/SMB_ACL_GROUP
1579 * entries can be converted to *_OBJ. Usually we will already have these
1580 * entries in the Default ACL, and the Access ACL will not have them.
1583 check_owning_objs(file_ace, pfile_owner_sid, pfile_grp_sid);
1586 check_owning_objs(dir_ace, pfile_owner_sid, pfile_grp_sid);
1590 *ppfile_ace = file_ace;
1591 *ppdir_ace = dir_ace;
1596 /****************************************************************************
1597 ASCII art time again... JRA :-).
1599 We have 4 cases to process when moving from an NT ACL to a POSIX ACL. Firstly,
1600 we insist the ACL is in canonical form (ie. all DENY entries preceede ALLOW
1601 entries). Secondly, the merge code has ensured that all duplicate SID entries for
1602 allow or deny have been merged, so the same SID can only appear once in the deny
1603 list or once in the allow list.
1605 We then process as follows :
1607 ---------------------------------------------------------------------------
1608 First pass - look for a Everyone DENY entry.
1610 If it is deny all (rwx) trunate the list at this point.
1611 Else, walk the list from this point and use the deny permissions of this
1612 entry as a mask on all following allow entries. Finally, delete
1613 the Everyone DENY entry (we have applied it to everything possible).
1615 In addition, in this pass we remove any DENY entries that have
1616 no permissions (ie. they are a DENY nothing).
1617 ---------------------------------------------------------------------------
1618 Second pass - only deal with deny user entries.
1620 DENY user1 (perms XXX)
1623 for all following allow group entries where user1 is in group
1624 new_perms |= group_perms;
1626 user1 entry perms = new_perms & ~ XXX;
1628 Convert the deny entry to an allow entry with the new perms and
1629 push to the end of the list. Note if the user was in no groups
1630 this maps to a specific allow nothing entry for this user.
1632 The common case from the NT ACL choser (userX deny all) is
1633 optimised so we don't do the group lookup - we just map to
1634 an allow nothing entry.
1636 What we're doing here is inferring the allow permissions the
1637 person setting the ACE on user1 wanted by looking at the allow
1638 permissions on the groups the user is currently in. This will
1639 be a snapshot, depending on group membership but is the best
1640 we can do and has the advantage of failing closed rather than
1642 ---------------------------------------------------------------------------
1643 Third pass - only deal with deny group entries.
1645 DENY group1 (perms XXX)
1647 for all following allow user entries where user is in group1
1648 user entry perms = user entry perms & ~ XXX;
1650 If there is a group Everyone allow entry with permissions YYY,
1651 convert the group1 entry to an allow entry and modify its
1654 new_perms = YYY & ~ XXX
1656 and push to the end of the list.
1658 If there is no group Everyone allow entry then convert the
1659 group1 entry to a allow nothing entry and push to the end of the list.
1661 Note that the common case from the NT ACL choser (groupX deny all)
1662 cannot be optimised here as we need to modify user entries who are
1663 in the group to change them to a deny all also.
1665 What we're doing here is modifying the allow permissions of
1666 user entries (which are more specific in POSIX ACLs) to mask
1667 out the explicit deny set on the group they are in. This will
1668 be a snapshot depending on current group membership but is the
1669 best we can do and has the advantage of failing closed rather
1671 ---------------------------------------------------------------------------
1672 Fourth pass - cope with cumulative permissions.
1674 for all allow user entries, if there exists an allow group entry with
1675 more permissive permissions, and the user is in that group, rewrite the
1676 allow user permissions to contain both sets of permissions.
1678 Currently the code for this is #ifdef'ed out as these semantics make
1679 no sense to me. JRA.
1680 ---------------------------------------------------------------------------
1682 Note we *MUST* do the deny user pass first as this will convert deny user
1683 entries into allow user entries which can then be processed by the deny
1686 The above algorithm took a *lot* of thinking about - hence this
1687 explaination :-). JRA.
1688 ****************************************************************************/
1690 /****************************************************************************
1691 Process a canon_ace list entries. This is very complex code. We need
1692 to go through and remove the "deny" permissions from any allow entry that matches
1693 the id of this entry. We have already refused any NT ACL that wasn't in correct
1694 order (DENY followed by ALLOW). If any allow entry ends up with zero permissions,
1695 we just remove it (to fail safe). We have already removed any duplicate ace
1696 entries. Treat an "Everyone" DENY_ACE as a special case - use it to mask all
1698 ****************************************************************************/
1700 static void process_deny_list( canon_ace **pp_ace_list )
1702 canon_ace *ace_list = *pp_ace_list;
1703 canon_ace *curr_ace = NULL;
1704 canon_ace *curr_ace_next = NULL;
1706 /* Pass 1 above - look for an Everyone, deny entry. */
1708 for (curr_ace = ace_list; curr_ace; curr_ace = curr_ace_next) {
1709 canon_ace *allow_ace_p;
1711 curr_ace_next = curr_ace->next; /* So we can't lose the link. */
1713 if (curr_ace->attr != DENY_ACE)
1716 if (curr_ace->perms == (mode_t)0) {
1718 /* Deny nothing entry - delete. */
1720 DLIST_REMOVE(ace_list, curr_ace);
1724 if (!sid_equal(&curr_ace->trustee, &global_sid_World))
1727 /* JRATEST - assert. */
1728 SMB_ASSERT(curr_ace->owner_type == WORLD_ACE);
1730 if (curr_ace->perms == ALL_ACE_PERMS) {
1733 * Optimisation. This is a DENY_ALL to Everyone. Truncate the
1734 * list at this point including this entry.
1737 canon_ace *prev_entry = curr_ace->prev;
1739 free_canon_ace_list( curr_ace );
1741 prev_entry->next = NULL;
1743 /* We deleted the entire list. */
1749 for (allow_ace_p = curr_ace->next; allow_ace_p; allow_ace_p = allow_ace_p->next) {
1752 * Only mask off allow entries.
1755 if (allow_ace_p->attr != ALLOW_ACE)
1758 allow_ace_p->perms &= ~curr_ace->perms;
1762 * Now it's been applied, remove it.
1765 DLIST_REMOVE(ace_list, curr_ace);
1768 /* Pass 2 above - deal with deny user entries. */
1770 for (curr_ace = ace_list; curr_ace; curr_ace = curr_ace_next) {
1771 mode_t new_perms = (mode_t)0;
1772 canon_ace *allow_ace_p;
1774 curr_ace_next = curr_ace->next; /* So we can't lose the link. */
1776 if (curr_ace->attr != DENY_ACE)
1779 if (curr_ace->owner_type != UID_ACE)
1782 if (curr_ace->perms == ALL_ACE_PERMS) {
1785 * Optimisation - this is a deny everything to this user.
1786 * Convert to an allow nothing and push to the end of the list.
1789 curr_ace->attr = ALLOW_ACE;
1790 curr_ace->perms = (mode_t)0;
1791 DLIST_DEMOTE(ace_list, curr_ace, canon_ace *);
1795 for (allow_ace_p = curr_ace->next; allow_ace_p; allow_ace_p = allow_ace_p->next) {
1797 if (allow_ace_p->attr != ALLOW_ACE)
1800 /* We process GID_ACE and WORLD_ACE entries only. */
1802 if (allow_ace_p->owner_type == UID_ACE)
1805 if (uid_entry_in_group( curr_ace, allow_ace_p))
1806 new_perms |= allow_ace_p->perms;
1810 * Convert to a allow entry, modify the perms and push to the end
1814 curr_ace->attr = ALLOW_ACE;
1815 curr_ace->perms = (new_perms & ~curr_ace->perms);
1816 DLIST_DEMOTE(ace_list, curr_ace, canon_ace *);
1819 /* Pass 3 above - deal with deny group entries. */
1821 for (curr_ace = ace_list; curr_ace; curr_ace = curr_ace_next) {
1822 canon_ace *allow_ace_p;
1823 canon_ace *allow_everyone_p = NULL;
1825 curr_ace_next = curr_ace->next; /* So we can't lose the link. */
1827 if (curr_ace->attr != DENY_ACE)
1830 if (curr_ace->owner_type != GID_ACE)
1833 for (allow_ace_p = curr_ace->next; allow_ace_p; allow_ace_p = allow_ace_p->next) {
1835 if (allow_ace_p->attr != ALLOW_ACE)
1838 /* Store a pointer to the Everyone allow, if it exists. */
1839 if (allow_ace_p->owner_type == WORLD_ACE)
1840 allow_everyone_p = allow_ace_p;
1842 /* We process UID_ACE entries only. */
1844 if (allow_ace_p->owner_type != UID_ACE)
1847 /* Mask off the deny group perms. */
1849 if (uid_entry_in_group( allow_ace_p, curr_ace))
1850 allow_ace_p->perms &= ~curr_ace->perms;
1854 * Convert the deny to an allow with the correct perms and
1855 * push to the end of the list.
1858 curr_ace->attr = ALLOW_ACE;
1859 if (allow_everyone_p)
1860 curr_ace->perms = allow_everyone_p->perms & ~curr_ace->perms;
1862 curr_ace->perms = (mode_t)0;
1863 DLIST_DEMOTE(ace_list, curr_ace, canon_ace *);
1866 /* Doing this fourth pass allows Windows semantics to be layered
1867 * on top of POSIX semantics. I'm not sure if this is desirable.
1868 * For example, in W2K ACLs there is no way to say, "Group X no
1869 * access, user Y full access" if user Y is a member of group X.
1870 * This seems completely broken semantics to me.... JRA.
1874 /* Pass 4 above - deal with allow entries. */
1876 for (curr_ace = ace_list; curr_ace; curr_ace = curr_ace_next) {
1877 canon_ace *allow_ace_p;
1879 curr_ace_next = curr_ace->next; /* So we can't lose the link. */
1881 if (curr_ace->attr != ALLOW_ACE)
1884 if (curr_ace->owner_type != UID_ACE)
1887 for (allow_ace_p = ace_list; allow_ace_p; allow_ace_p = allow_ace_p->next) {
1889 if (allow_ace_p->attr != ALLOW_ACE)
1892 /* We process GID_ACE entries only. */
1894 if (allow_ace_p->owner_type != GID_ACE)
1897 /* OR in the group perms. */
1899 if (uid_entry_in_group( curr_ace, allow_ace_p))
1900 curr_ace->perms |= allow_ace_p->perms;
1905 *pp_ace_list = ace_list;
1908 /****************************************************************************
1909 Create a default mode that will be used if a security descriptor entry has
1910 no user/group/world entries.
1911 ****************************************************************************/
1913 static mode_t create_default_mode(files_struct *fsp, BOOL interitable_mode)
1915 int snum = SNUM(fsp->conn);
1916 mode_t and_bits = (mode_t)0;
1917 mode_t or_bits = (mode_t)0;
1918 mode_t mode = interitable_mode
1919 ? unix_mode( fsp->conn, FILE_ATTRIBUTE_ARCHIVE, fsp->fsp_name,
1923 if (fsp->is_directory)
1924 mode |= (S_IWUSR|S_IXUSR);
1927 * Now AND with the create mode/directory mode bits then OR with the
1928 * force create mode/force directory mode bits.
1931 if (fsp->is_directory) {
1932 and_bits = lp_dir_security_mask(snum);
1933 or_bits = lp_force_dir_security_mode(snum);
1935 and_bits = lp_security_mask(snum);
1936 or_bits = lp_force_security_mode(snum);
1939 return ((mode & and_bits)|or_bits);
1942 /****************************************************************************
1943 Unpack a SEC_DESC into two canonical ace lists. We don't depend on this
1945 ****************************************************************************/
1947 static BOOL unpack_canon_ace(files_struct *fsp,
1948 SMB_STRUCT_STAT *pst,
1949 DOM_SID *pfile_owner_sid,
1950 DOM_SID *pfile_grp_sid,
1951 canon_ace **ppfile_ace, canon_ace **ppdir_ace,
1952 uint32 security_info_sent, SEC_DESC *psd)
1954 canon_ace *file_ace = NULL;
1955 canon_ace *dir_ace = NULL;
1960 if(security_info_sent == 0) {
1961 DEBUG(0,("unpack_canon_ace: no security info sent !\n"));
1966 * If no DACL then this is a chown only security descriptor.
1969 if(!(security_info_sent & DACL_SECURITY_INFORMATION) || !psd->dacl)
1973 * Now go through the DACL and create the canon_ace lists.
1976 if (!create_canon_ace_lists( fsp, pst, pfile_owner_sid, pfile_grp_sid,
1977 &file_ace, &dir_ace, psd->dacl))
1980 if ((file_ace == NULL) && (dir_ace == NULL)) {
1981 /* W2K traverse DACL set - ignore. */
1986 * Go through the canon_ace list and merge entries
1987 * belonging to identical users of identical allow or deny type.
1988 * We can do this as all deny entries come first, followed by
1989 * all allow entries (we have mandated this before accepting this acl).
1992 print_canon_ace_list( "file ace - before merge", file_ace);
1993 merge_aces( &file_ace );
1995 print_canon_ace_list( "dir ace - before merge", dir_ace);
1996 merge_aces( &dir_ace );
1999 * NT ACLs are order dependent. Go through the acl lists and
2000 * process DENY entries by masking the allow entries.
2003 print_canon_ace_list( "file ace - before deny", file_ace);
2004 process_deny_list( &file_ace);
2006 print_canon_ace_list( "dir ace - before deny", dir_ace);
2007 process_deny_list( &dir_ace);
2010 * A well formed POSIX file or default ACL has at least 3 entries, a
2011 * SMB_ACL_USER_OBJ, SMB_ACL_GROUP_OBJ, SMB_ACL_OTHER_OBJ
2012 * and optionally a mask entry. Ensure this is the case.
2015 print_canon_ace_list( "file ace - before valid", file_ace);
2018 * A default 3 element mode entry for a file should be r-- --- ---.
2019 * A default 3 element mode entry for a directory should be rwx --- ---.
2022 pst->st_mode = create_default_mode(fsp, False);
2024 if (!ensure_canon_entry_valid(&file_ace, fsp, pfile_owner_sid, pfile_grp_sid, pst, True)) {
2025 free_canon_ace_list(file_ace);
2026 free_canon_ace_list(dir_ace);
2030 print_canon_ace_list( "dir ace - before valid", dir_ace);
2033 * A default inheritable 3 element mode entry for a directory should be the
2034 * mode Samba will use to create a file within. Ensure user rwx bits are set if
2038 pst->st_mode = create_default_mode(fsp, True);
2040 if (dir_ace && !ensure_canon_entry_valid(&dir_ace, fsp, pfile_owner_sid, pfile_grp_sid, pst, True)) {
2041 free_canon_ace_list(file_ace);
2042 free_canon_ace_list(dir_ace);
2046 print_canon_ace_list( "file ace - return", file_ace);
2047 print_canon_ace_list( "dir ace - return", dir_ace);
2049 *ppfile_ace = file_ace;
2050 *ppdir_ace = dir_ace;
2055 /******************************************************************************
2056 When returning permissions, try and fit NT display
2057 semantics if possible. Note the the canon_entries here must have been malloced.
2058 The list format should be - first entry = owner, followed by group and other user
2059 entries, last entry = other.
2061 Note that this doesn't exactly match the NT semantics for an ACL. As POSIX entries
2062 are not ordered, and match on the most specific entry rather than walking a list,
2063 then a simple POSIX permission of rw-r--r-- should really map to 5 entries,
2065 Entry 0: owner : deny all except read and write.
2066 Entry 1: owner : allow read and write.
2067 Entry 2: group : deny all except read.
2068 Entry 3: group : allow read.
2069 Entry 4: Everyone : allow read.
2071 But NT cannot display this in their ACL editor !
2072 ********************************************************************************/
2074 static void arrange_posix_perms( char *filename, canon_ace **pp_list_head)
2076 canon_ace *list_head = *pp_list_head;
2077 canon_ace *owner_ace = NULL;
2078 canon_ace *other_ace = NULL;
2079 canon_ace *ace = NULL;
2081 for (ace = list_head; ace; ace = ace->next) {
2082 if (ace->type == SMB_ACL_USER_OBJ)
2084 else if (ace->type == SMB_ACL_OTHER) {
2085 /* Last ace - this is "other" */
2090 if (!owner_ace || !other_ace) {
2091 DEBUG(0,("arrange_posix_perms: Invalid POSIX permissions for file %s, missing owner or other.\n",
2097 * The POSIX algorithm applies to owner first, and other last,
2098 * so ensure they are arranged in this order.
2102 DLIST_PROMOTE(list_head, owner_ace);
2106 DLIST_DEMOTE(list_head, other_ace, canon_ace *);
2109 /* We have probably changed the head of the list. */
2111 *pp_list_head = list_head;
2114 /****************************************************************************
2115 Create a linked list of canonical ACE entries.
2116 ****************************************************************************/
2118 static canon_ace *canonicalise_acl( files_struct *fsp, SMB_ACL_T posix_acl, SMB_STRUCT_STAT *psbuf,
2119 const DOM_SID *powner, const DOM_SID *pgroup, struct pai_val *pal, SMB_ACL_TYPE_T the_acl_type)
2121 connection_struct *conn = fsp->conn;
2122 mode_t acl_mask = (S_IRUSR|S_IWUSR|S_IXUSR);
2123 canon_ace *list_head = NULL;
2124 canon_ace *ace = NULL;
2125 canon_ace *next_ace = NULL;
2126 int entry_id = SMB_ACL_FIRST_ENTRY;
2127 SMB_ACL_ENTRY_T entry;
2130 while ( posix_acl && (SMB_VFS_SYS_ACL_GET_ENTRY(conn, posix_acl, entry_id, &entry) == 1)) {
2131 SMB_ACL_TAG_T tagtype;
2132 SMB_ACL_PERMSET_T permset;
2135 enum ace_owner owner_type;
2138 if (entry_id == SMB_ACL_FIRST_ENTRY)
2139 entry_id = SMB_ACL_NEXT_ENTRY;
2141 /* Is this a MASK entry ? */
2142 if (SMB_VFS_SYS_ACL_GET_TAG_TYPE(conn, entry, &tagtype) == -1)
2145 if (SMB_VFS_SYS_ACL_GET_PERMSET(conn, entry, &permset) == -1)
2148 /* Decide which SID to use based on the ACL type. */
2150 case SMB_ACL_USER_OBJ:
2151 /* Get the SID from the owner. */
2152 sid_copy(&sid, powner);
2153 unix_ug.uid = psbuf->st_uid;
2154 owner_type = UID_ACE;
2158 uid_t *puid = (uid_t *)SMB_VFS_SYS_ACL_GET_QUALIFIER(conn, entry);
2160 DEBUG(0,("canonicalise_acl: Failed to get uid.\n"));
2164 * A SMB_ACL_USER entry for the owner is shadowed by the
2165 * SMB_ACL_USER_OBJ entry and Windows also cannot represent
2166 * that entry, so we ignore it. We also don't create such
2167 * entries out of the blue when setting ACLs, so a get/set
2168 * cycle will drop them.
2170 if (the_acl_type == SMB_ACL_TYPE_ACCESS && *puid == psbuf->st_uid) {
2171 SMB_VFS_SYS_ACL_FREE_QUALIFIER(conn, (void *)puid,tagtype);
2174 uid_to_sid( &sid, *puid);
2175 unix_ug.uid = *puid;
2176 owner_type = UID_ACE;
2177 SMB_VFS_SYS_ACL_FREE_QUALIFIER(conn, (void *)puid,tagtype);
2180 case SMB_ACL_GROUP_OBJ:
2181 /* Get the SID from the owning group. */
2182 sid_copy(&sid, pgroup);
2183 unix_ug.gid = psbuf->st_gid;
2184 owner_type = GID_ACE;
2188 gid_t *pgid = (gid_t *)SMB_VFS_SYS_ACL_GET_QUALIFIER(conn, entry);
2190 DEBUG(0,("canonicalise_acl: Failed to get gid.\n"));
2193 gid_to_sid( &sid, *pgid);
2194 unix_ug.gid = *pgid;
2195 owner_type = GID_ACE;
2196 SMB_VFS_SYS_ACL_FREE_QUALIFIER(conn, (void *)pgid,tagtype);
2200 acl_mask = convert_permset_to_mode_t(conn, permset);
2201 continue; /* Don't count the mask as an entry. */
2203 /* Use the Everyone SID */
2204 sid = global_sid_World;
2206 owner_type = WORLD_ACE;
2209 DEBUG(0,("canonicalise_acl: Unknown tagtype %u\n", (unsigned int)tagtype));
2214 * Add this entry to the list.
2217 if ((ace = SMB_MALLOC_P(canon_ace)) == NULL)
2221 ace->type = tagtype;
2222 ace->perms = convert_permset_to_mode_t(conn, permset);
2223 ace->attr = ALLOW_ACE;
2225 ace->unix_ug = unix_ug;
2226 ace->owner_type = owner_type;
2227 ace->inherited = get_inherited_flag(pal, ace, (the_acl_type == SMB_ACL_TYPE_DEFAULT));
2229 DLIST_ADD(list_head, ace);
2233 * This next call will ensure we have at least a user/group/world set.
2236 if (!ensure_canon_entry_valid(&list_head, fsp, powner, pgroup, psbuf, False))
2240 * Now go through the list, masking the permissions with the
2241 * acl_mask. Ensure all DENY Entries are at the start of the list.
2244 DEBUG(10,("canonicalise_acl: %s ace entries before arrange :\n", the_acl_type == SMB_ACL_TYPE_ACCESS ? "Access" : "Default" ));
2246 for ( ace_count = 0, ace = list_head; ace; ace = next_ace, ace_count++) {
2247 next_ace = ace->next;
2249 /* Masks are only applied to entries other than USER_OBJ and OTHER. */
2250 if (ace->type != SMB_ACL_OTHER && ace->type != SMB_ACL_USER_OBJ)
2251 ace->perms &= acl_mask;
2253 if (ace->perms == 0) {
2254 DLIST_PROMOTE(list_head, ace);
2257 if( DEBUGLVL( 10 ) ) {
2258 print_canon_ace(ace, ace_count);
2262 arrange_posix_perms(fsp->fsp_name,&list_head );
2264 print_canon_ace_list( "canonicalise_acl: ace entries after arrange", list_head );
2270 free_canon_ace_list(list_head);
2274 /****************************************************************************
2275 Check if the current user group list contains a given group.
2276 ****************************************************************************/
2278 static BOOL current_user_in_group(gid_t gid)
2282 for (i = 0; i < current_user.ut.ngroups; i++) {
2283 if (current_user.ut.groups[i] == gid) {
2291 /****************************************************************************
2292 Should we override a deny ? Check 'acl group control' and 'dos filemode'
2293 ****************************************************************************/
2295 static BOOL acl_group_override(connection_struct *conn, gid_t prim_gid, const char *fname)
2297 SMB_STRUCT_STAT sbuf;
2299 if ((errno != EPERM) && (errno != EACCES)) {
2303 /* file primary group == user primary or supplementary group */
2304 if (lp_acl_group_control(SNUM(conn)) && current_user_in_group(prim_gid)) {
2308 /* user has writeable permission */
2309 if (lp_dos_filemode(SNUM(conn)) && can_write_to_file(conn, fname, &sbuf)) {
2316 /****************************************************************************
2317 Attempt to apply an ACL to a file or directory.
2318 ****************************************************************************/
2320 static BOOL set_canon_ace_list(files_struct *fsp, canon_ace *the_ace, BOOL default_ace, gid_t prim_gid, BOOL *pacl_set_support)
2322 connection_struct *conn = fsp->conn;
2324 SMB_ACL_T the_acl = SMB_VFS_SYS_ACL_INIT(conn, (int)count_canon_ace_list(the_ace) + 1);
2327 SMB_ACL_ENTRY_T mask_entry;
2328 BOOL got_mask_entry = False;
2329 SMB_ACL_PERMSET_T mask_permset;
2330 SMB_ACL_TYPE_T the_acl_type = (default_ace ? SMB_ACL_TYPE_DEFAULT : SMB_ACL_TYPE_ACCESS);
2331 BOOL needs_mask = False;
2332 mode_t mask_perms = 0;
2334 #if defined(POSIX_ACL_NEEDS_MASK)
2335 /* HP-UX always wants to have a mask (called "class" there). */
2339 if (the_acl == NULL) {
2341 if (!no_acl_syscall_error(errno)) {
2343 * Only print this error message if we have some kind of ACL
2344 * support that's not working. Otherwise we would always get this.
2346 DEBUG(0,("set_canon_ace_list: Unable to init %s ACL. (%s)\n",
2347 default_ace ? "default" : "file", strerror(errno) ));
2349 *pacl_set_support = False;
2353 if( DEBUGLVL( 10 )) {
2354 dbgtext("set_canon_ace_list: setting ACL:\n");
2355 for (i = 0, p_ace = the_ace; p_ace; p_ace = p_ace->next, i++ ) {
2356 print_canon_ace( p_ace, i);
2360 for (i = 0, p_ace = the_ace; p_ace; p_ace = p_ace->next, i++ ) {
2361 SMB_ACL_ENTRY_T the_entry;
2362 SMB_ACL_PERMSET_T the_permset;
2365 * ACLs only "need" an ACL_MASK entry if there are any named user or
2366 * named group entries. But if there is an ACL_MASK entry, it applies
2367 * to ACL_USER, ACL_GROUP, and ACL_GROUP_OBJ entries. Set the mask
2368 * so that it doesn't deny (i.e., mask off) any permissions.
2371 if (p_ace->type == SMB_ACL_USER || p_ace->type == SMB_ACL_GROUP) {
2373 mask_perms |= p_ace->perms;
2374 } else if (p_ace->type == SMB_ACL_GROUP_OBJ) {
2375 mask_perms |= p_ace->perms;
2379 * Get the entry for this ACE.
2382 if (SMB_VFS_SYS_ACL_CREATE_ENTRY(conn, &the_acl, &the_entry) == -1) {
2383 DEBUG(0,("set_canon_ace_list: Failed to create entry %d. (%s)\n",
2384 i, strerror(errno) ));
2388 if (p_ace->type == SMB_ACL_MASK) {
2389 mask_entry = the_entry;
2390 got_mask_entry = True;
2394 * Ok - we now know the ACL calls should be working, don't
2395 * allow fallback to chmod.
2398 *pacl_set_support = True;
2401 * Initialise the entry from the canon_ace.
2405 * First tell the entry what type of ACE this is.
2408 if (SMB_VFS_SYS_ACL_SET_TAG_TYPE(conn, the_entry, p_ace->type) == -1) {
2409 DEBUG(0,("set_canon_ace_list: Failed to set tag type on entry %d. (%s)\n",
2410 i, strerror(errno) ));
2415 * Only set the qualifier (user or group id) if the entry is a user
2419 if ((p_ace->type == SMB_ACL_USER) || (p_ace->type == SMB_ACL_GROUP)) {
2420 if (SMB_VFS_SYS_ACL_SET_QUALIFIER(conn, the_entry,(void *)&p_ace->unix_ug.uid) == -1) {
2421 DEBUG(0,("set_canon_ace_list: Failed to set qualifier on entry %d. (%s)\n",
2422 i, strerror(errno) ));
2428 * Convert the mode_t perms in the canon_ace to a POSIX permset.
2431 if (SMB_VFS_SYS_ACL_GET_PERMSET(conn, the_entry, &the_permset) == -1) {
2432 DEBUG(0,("set_canon_ace_list: Failed to get permset on entry %d. (%s)\n",
2433 i, strerror(errno) ));
2437 if (map_acl_perms_to_permset(conn, p_ace->perms, &the_permset) == -1) {
2438 DEBUG(0,("set_canon_ace_list: Failed to create permset for mode (%u) on entry %d. (%s)\n",
2439 (unsigned int)p_ace->perms, i, strerror(errno) ));
2444 * ..and apply them to the entry.
2447 if (SMB_VFS_SYS_ACL_SET_PERMSET(conn, the_entry, the_permset) == -1) {
2448 DEBUG(0,("set_canon_ace_list: Failed to add permset on entry %d. (%s)\n",
2449 i, strerror(errno) ));
2454 print_canon_ace( p_ace, i);
2458 if (needs_mask && !got_mask_entry) {
2459 if (SMB_VFS_SYS_ACL_CREATE_ENTRY(conn, &the_acl, &mask_entry) == -1) {
2460 DEBUG(0,("set_canon_ace_list: Failed to create mask entry. (%s)\n", strerror(errno) ));
2464 if (SMB_VFS_SYS_ACL_SET_TAG_TYPE(conn, mask_entry, SMB_ACL_MASK) == -1) {
2465 DEBUG(0,("set_canon_ace_list: Failed to set tag type on mask entry. (%s)\n",strerror(errno) ));
2469 if (SMB_VFS_SYS_ACL_GET_PERMSET(conn, mask_entry, &mask_permset) == -1) {
2470 DEBUG(0,("set_canon_ace_list: Failed to get mask permset. (%s)\n", strerror(errno) ));
2474 if (map_acl_perms_to_permset(conn, S_IRUSR|S_IWUSR|S_IXUSR, &mask_permset) == -1) {
2475 DEBUG(0,("set_canon_ace_list: Failed to create mask permset. (%s)\n", strerror(errno) ));
2479 if (SMB_VFS_SYS_ACL_SET_PERMSET(conn, mask_entry, mask_permset) == -1) {
2480 DEBUG(0,("set_canon_ace_list: Failed to add mask permset. (%s)\n", strerror(errno) ));
2486 * Finally apply it to the file or directory.
2489 if(default_ace || fsp->is_directory || fsp->fh->fd == -1) {
2490 if (SMB_VFS_SYS_ACL_SET_FILE(conn, fsp->fsp_name, the_acl_type, the_acl) == -1) {
2492 * Some systems allow all the above calls and only fail with no ACL support
2493 * when attempting to apply the acl. HPUX with HFS is an example of this. JRA.
2495 if (no_acl_syscall_error(errno)) {
2496 *pacl_set_support = False;
2499 if (acl_group_override(conn, prim_gid, fsp->fsp_name)) {
2502 DEBUG(5,("set_canon_ace_list: acl group control on and current user in file %s primary group.\n",
2506 sret = SMB_VFS_SYS_ACL_SET_FILE(conn, fsp->fsp_name, the_acl_type, the_acl);
2514 DEBUG(2,("set_canon_ace_list: sys_acl_set_file type %s failed for file %s (%s).\n",
2515 the_acl_type == SMB_ACL_TYPE_DEFAULT ? "directory default" : "file",
2516 fsp->fsp_name, strerror(errno) ));
2521 if (SMB_VFS_SYS_ACL_SET_FD(fsp, fsp->fh->fd, the_acl) == -1) {
2523 * Some systems allow all the above calls and only fail with no ACL support
2524 * when attempting to apply the acl. HPUX with HFS is an example of this. JRA.
2526 if (no_acl_syscall_error(errno)) {
2527 *pacl_set_support = False;
2530 if (acl_group_override(conn, prim_gid, fsp->fsp_name)) {
2533 DEBUG(5,("set_canon_ace_list: acl group control on and current user in file %s primary group.\n",
2537 sret = SMB_VFS_SYS_ACL_SET_FD(fsp, fsp->fh->fd, the_acl);
2545 DEBUG(2,("set_canon_ace_list: sys_acl_set_file failed for file %s (%s).\n",
2546 fsp->fsp_name, strerror(errno) ));
2556 if (the_acl != NULL) {
2557 SMB_VFS_SYS_ACL_FREE_ACL(conn, the_acl);
2563 /****************************************************************************
2564 Find a particular canon_ace entry.
2565 ****************************************************************************/
2567 static struct canon_ace *canon_ace_entry_for(struct canon_ace *list, SMB_ACL_TAG_T type, posix_id *id)
2570 if (list->type == type && ((type != SMB_ACL_USER && type != SMB_ACL_GROUP) ||
2571 (type == SMB_ACL_USER && id && id->uid == list->unix_ug.uid) ||
2572 (type == SMB_ACL_GROUP && id && id->gid == list->unix_ug.gid)))
2579 /****************************************************************************
2581 ****************************************************************************/
2583 SMB_ACL_T free_empty_sys_acl(connection_struct *conn, SMB_ACL_T the_acl)
2585 SMB_ACL_ENTRY_T entry;
2589 if (SMB_VFS_SYS_ACL_GET_ENTRY(conn, the_acl, SMB_ACL_FIRST_ENTRY, &entry) != 1) {
2590 SMB_VFS_SYS_ACL_FREE_ACL(conn, the_acl);
2596 /****************************************************************************
2597 Convert a canon_ace to a generic 3 element permission - if possible.
2598 ****************************************************************************/
2600 #define MAP_PERM(p,mask,result) (((p) & (mask)) ? (result) : 0 )
2602 static BOOL convert_canon_ace_to_posix_perms( files_struct *fsp, canon_ace *file_ace_list, mode_t *posix_perms)
2604 int snum = SNUM(fsp->conn);
2605 size_t ace_count = count_canon_ace_list(file_ace_list);
2607 canon_ace *owner_ace = NULL;
2608 canon_ace *group_ace = NULL;
2609 canon_ace *other_ace = NULL;
2613 if (ace_count != 3) {
2614 DEBUG(3,("convert_canon_ace_to_posix_perms: Too many ACE entries for file %s to convert to \
2615 posix perms.\n", fsp->fsp_name ));
2619 for (ace_p = file_ace_list; ace_p; ace_p = ace_p->next) {
2620 if (ace_p->owner_type == UID_ACE)
2622 else if (ace_p->owner_type == GID_ACE)
2624 else if (ace_p->owner_type == WORLD_ACE)
2628 if (!owner_ace || !group_ace || !other_ace) {
2629 DEBUG(3,("convert_canon_ace_to_posix_perms: Can't get standard entries for file %s.\n",
2634 *posix_perms = (mode_t)0;
2636 *posix_perms |= owner_ace->perms;
2637 *posix_perms |= MAP_PERM(group_ace->perms, S_IRUSR, S_IRGRP);
2638 *posix_perms |= MAP_PERM(group_ace->perms, S_IWUSR, S_IWGRP);
2639 *posix_perms |= MAP_PERM(group_ace->perms, S_IXUSR, S_IXGRP);
2640 *posix_perms |= MAP_PERM(other_ace->perms, S_IRUSR, S_IROTH);
2641 *posix_perms |= MAP_PERM(other_ace->perms, S_IWUSR, S_IWOTH);
2642 *posix_perms |= MAP_PERM(other_ace->perms, S_IXUSR, S_IXOTH);
2644 /* The owner must have at least read access. */
2646 *posix_perms |= S_IRUSR;
2647 if (fsp->is_directory)
2648 *posix_perms |= (S_IWUSR|S_IXUSR);
2650 /* If requested apply the masks. */
2652 /* Get the initial bits to apply. */
2654 if (fsp->is_directory) {
2655 and_bits = lp_dir_security_mask(snum);
2656 or_bits = lp_force_dir_security_mode(snum);
2658 and_bits = lp_security_mask(snum);
2659 or_bits = lp_force_security_mode(snum);
2662 *posix_perms = (((*posix_perms) & and_bits)|or_bits);
2664 DEBUG(10,("convert_canon_ace_to_posix_perms: converted u=%o,g=%o,w=%o to perm=0%o for file %s.\n",
2665 (int)owner_ace->perms, (int)group_ace->perms, (int)other_ace->perms, (int)*posix_perms,
2671 /****************************************************************************
2672 Incoming NT ACLs on a directory can be split into a default POSIX acl (CI|OI|IO) and
2673 a normal POSIX acl. Win2k needs these split acls re-merging into one ACL
2674 with CI|OI set so it is inherited and also applies to the directory.
2675 Based on code from "Jim McDonough" <jmcd@us.ibm.com>.
2676 ****************************************************************************/
2678 static size_t merge_default_aces( SEC_ACE *nt_ace_list, size_t num_aces)
2682 for (i = 0; i < num_aces; i++) {
2683 for (j = i+1; j < num_aces; j++) {
2684 uint32 i_flags_ni = (nt_ace_list[i].flags & ~SEC_ACE_FLAG_INHERITED_ACE);
2685 uint32 j_flags_ni = (nt_ace_list[j].flags & ~SEC_ACE_FLAG_INHERITED_ACE);
2686 BOOL i_inh = (nt_ace_list[i].flags & SEC_ACE_FLAG_INHERITED_ACE) ? True : False;
2687 BOOL j_inh = (nt_ace_list[j].flags & SEC_ACE_FLAG_INHERITED_ACE) ? True : False;
2689 /* We know the lower number ACE's are file entries. */
2690 if ((nt_ace_list[i].type == nt_ace_list[j].type) &&
2691 (nt_ace_list[i].size == nt_ace_list[j].size) &&
2692 (nt_ace_list[i].access_mask == nt_ace_list[j].access_mask) &&
2693 sid_equal(&nt_ace_list[i].trustee, &nt_ace_list[j].trustee) &&
2695 (i_flags_ni == 0) &&
2696 (j_flags_ni == (SEC_ACE_FLAG_OBJECT_INHERIT|
2697 SEC_ACE_FLAG_CONTAINER_INHERIT|
2698 SEC_ACE_FLAG_INHERIT_ONLY))) {
2700 * W2K wants to have access allowed zero access ACE's
2701 * at the end of the list. If the mask is zero, merge
2702 * the non-inherited ACE onto the inherited ACE.
2705 if (nt_ace_list[i].access_mask == 0) {
2706 nt_ace_list[j].flags = SEC_ACE_FLAG_OBJECT_INHERIT|SEC_ACE_FLAG_CONTAINER_INHERIT|
2707 (i_inh ? SEC_ACE_FLAG_INHERITED_ACE : 0);
2708 if (num_aces - i - 1 > 0)
2709 memmove(&nt_ace_list[i], &nt_ace_list[i+1], (num_aces-i-1) *
2712 DEBUG(10,("merge_default_aces: Merging zero access ACE %u onto ACE %u.\n",
2713 (unsigned int)i, (unsigned int)j ));
2716 * These are identical except for the flags.
2717 * Merge the inherited ACE onto the non-inherited ACE.
2720 nt_ace_list[i].flags = SEC_ACE_FLAG_OBJECT_INHERIT|SEC_ACE_FLAG_CONTAINER_INHERIT|
2721 (i_inh ? SEC_ACE_FLAG_INHERITED_ACE : 0);
2722 if (num_aces - j - 1 > 0)
2723 memmove(&nt_ace_list[j], &nt_ace_list[j+1], (num_aces-j-1) *
2726 DEBUG(10,("merge_default_aces: Merging ACE %u onto ACE %u.\n",
2727 (unsigned int)j, (unsigned int)i ));
2737 /****************************************************************************
2738 Reply to query a security descriptor from an fsp. If it succeeds it allocates
2739 the space for the return elements and returns the size needed to return the
2740 security descriptor. This should be the only external function needed for
2741 the UNIX style get ACL.
2742 ****************************************************************************/
2744 size_t get_nt_acl(files_struct *fsp, uint32 security_info, SEC_DESC **ppdesc)
2746 connection_struct *conn = fsp->conn;
2747 SMB_STRUCT_STAT sbuf;
2748 SEC_ACE *nt_ace_list = NULL;
2752 SEC_ACL *psa = NULL;
2753 size_t num_acls = 0;
2754 size_t num_def_acls = 0;
2755 size_t num_aces = 0;
2756 SMB_ACL_T posix_acl = NULL;
2757 SMB_ACL_T def_acl = NULL;
2758 canon_ace *file_ace = NULL;
2759 canon_ace *dir_ace = NULL;
2760 size_t num_profile_acls = 0;
2761 struct pai_val *pal = NULL;
2762 SEC_DESC *psd = NULL;
2766 DEBUG(10,("get_nt_acl: called for file %s\n", fsp->fsp_name ));
2768 if(fsp->is_directory || fsp->fh->fd == -1) {
2770 /* Get the stat struct for the owner info. */
2771 if(SMB_VFS_STAT(fsp->conn,fsp->fsp_name, &sbuf) != 0) {
2775 * Get the ACL from the path.
2778 posix_acl = SMB_VFS_SYS_ACL_GET_FILE(conn, fsp->fsp_name, SMB_ACL_TYPE_ACCESS);
2781 * If it's a directory get the default POSIX ACL.
2784 if(fsp->is_directory) {
2785 def_acl = SMB_VFS_SYS_ACL_GET_FILE(conn, fsp->fsp_name, SMB_ACL_TYPE_DEFAULT);
2786 def_acl = free_empty_sys_acl(conn, def_acl);
2791 /* Get the stat struct for the owner info. */
2792 if(SMB_VFS_FSTAT(fsp,fsp->fh->fd,&sbuf) != 0) {
2796 * Get the ACL from the fd.
2798 posix_acl = SMB_VFS_SYS_ACL_GET_FD(fsp, fsp->fh->fd);
2801 DEBUG(5,("get_nt_acl : file ACL %s, directory ACL %s\n",
2802 posix_acl ? "present" : "absent",
2803 def_acl ? "present" : "absent" ));
2805 pal = load_inherited_info(fsp);
2808 * Get the owner, group and world SIDs.
2811 if (lp_profile_acls(SNUM(conn))) {
2812 /* For WXP SP1 the owner must be administrators. */
2813 sid_copy(&owner_sid, &global_sid_Builtin_Administrators);
2814 sid_copy(&group_sid, &global_sid_Builtin_Users);
2815 num_profile_acls = 2;
2817 create_file_sids(&sbuf, &owner_sid, &group_sid);
2820 if ((security_info & DACL_SECURITY_INFORMATION) && !(security_info & PROTECTED_DACL_SECURITY_INFORMATION)) {
2823 * In the optimum case Creator Owner and Creator Group would be used for
2824 * the ACL_USER_OBJ and ACL_GROUP_OBJ entries, respectively, but this
2825 * would lead to usability problems under Windows: The Creator entries
2826 * are only available in browse lists of directories and not for files;
2827 * additionally the identity of the owning group couldn't be determined.
2828 * We therefore use those identities only for Default ACLs.
2831 /* Create the canon_ace lists. */
2832 file_ace = canonicalise_acl( fsp, posix_acl, &sbuf, &owner_sid, &group_sid, pal, SMB_ACL_TYPE_ACCESS );
2834 /* We must have *some* ACLS. */
2836 if (count_canon_ace_list(file_ace) == 0) {
2837 DEBUG(0,("get_nt_acl : No ACLs on file (%s) !\n", fsp->fsp_name ));
2841 if (fsp->is_directory && def_acl) {
2842 dir_ace = canonicalise_acl(fsp, def_acl, &sbuf,
2843 &global_sid_Creator_Owner,
2844 &global_sid_Creator_Group, pal, SMB_ACL_TYPE_DEFAULT );
2848 * Create the NT ACE list from the canonical ace lists.
2856 if (nt4_compatible_acls() && dir_ace) {
2858 * NT 4 chokes if an ACL contains an INHERIT_ONLY entry
2859 * but no non-INHERIT_ONLY entry for one SID. So we only
2860 * remove entries from the Access ACL if the
2861 * corresponding Default ACL entries have also been
2862 * removed. ACEs for CREATOR-OWNER and CREATOR-GROUP
2863 * are exceptions. We can do nothing
2864 * intelligent if the Default ACL contains entries that
2865 * are not also contained in the Access ACL, so this
2866 * case will still fail under NT 4.
2869 ace = canon_ace_entry_for(dir_ace, SMB_ACL_OTHER, NULL);
2870 if (ace && !ace->perms) {
2871 DLIST_REMOVE(dir_ace, ace);
2874 ace = canon_ace_entry_for(file_ace, SMB_ACL_OTHER, NULL);
2875 if (ace && !ace->perms) {
2876 DLIST_REMOVE(file_ace, ace);
2882 * WinNT doesn't usually have Creator Group
2883 * in browse lists, so we send this entry to
2884 * WinNT even if it contains no relevant
2885 * permissions. Once we can add
2886 * Creator Group to browse lists we can
2891 ace = canon_ace_entry_for(dir_ace, SMB_ACL_GROUP_OBJ, NULL);
2892 if (ace && !ace->perms) {
2893 DLIST_REMOVE(dir_ace, ace);
2898 ace = canon_ace_entry_for(file_ace, SMB_ACL_GROUP_OBJ, NULL);
2899 if (ace && !ace->perms) {
2900 DLIST_REMOVE(file_ace, ace);
2905 num_acls = count_canon_ace_list(file_ace);
2906 num_def_acls = count_canon_ace_list(dir_ace);
2908 /* Allocate the ace list. */
2909 if ((nt_ace_list = SMB_MALLOC_ARRAY(SEC_ACE,num_acls + num_profile_acls + num_def_acls)) == NULL) {
2910 DEBUG(0,("get_nt_acl: Unable to malloc space for nt_ace_list.\n"));
2914 memset(nt_ace_list, '\0', (num_acls + num_def_acls) * sizeof(SEC_ACE) );
2917 * Create the NT ACE list from the canonical ace lists.
2922 for (i = 0; i < num_acls; i++, ace = ace->next) {
2925 acc = map_canon_ace_perms(SNUM(conn),
2929 init_sec_ace(&nt_ace_list[num_aces++],
2934 SEC_ACE_FLAG_INHERITED_ACE : 0);
2937 /* The User must have access to a profile share - even
2938 * if we can't map the SID. */
2939 if (lp_profile_acls(SNUM(conn))) {
2942 init_sec_access(&acc,FILE_GENERIC_ALL);
2943 init_sec_ace(&nt_ace_list[num_aces++],
2944 &global_sid_Builtin_Users,
2945 SEC_ACE_TYPE_ACCESS_ALLOWED,
2951 for (i = 0; i < num_def_acls; i++, ace = ace->next) {
2954 acc = map_canon_ace_perms(SNUM(conn),
2958 init_sec_ace(&nt_ace_list[num_aces++],
2962 SEC_ACE_FLAG_OBJECT_INHERIT|
2963 SEC_ACE_FLAG_CONTAINER_INHERIT|
2964 SEC_ACE_FLAG_INHERIT_ONLY|
2966 SEC_ACE_FLAG_INHERITED_ACE : 0));
2969 /* The User must have access to a profile share - even
2970 * if we can't map the SID. */
2971 if (lp_profile_acls(SNUM(conn))) {
2974 init_sec_access(&acc,FILE_GENERIC_ALL);
2975 init_sec_ace(&nt_ace_list[num_aces++], &global_sid_Builtin_Users, SEC_ACE_TYPE_ACCESS_ALLOWED, acc,
2976 SEC_ACE_FLAG_OBJECT_INHERIT|SEC_ACE_FLAG_CONTAINER_INHERIT|
2977 SEC_ACE_FLAG_INHERIT_ONLY|0);
2981 * Merge POSIX default ACLs and normal ACLs into one NT ACE.
2982 * Win2K needs this to get the inheritance correct when replacing ACLs
2983 * on a directory tree. Based on work by Jim @ IBM.
2986 num_aces = merge_default_aces(nt_ace_list, num_aces);
2991 if((psa = make_sec_acl( main_loop_talloc_get(), NT4_ACL_REVISION, num_aces, nt_ace_list)) == NULL) {
2992 DEBUG(0,("get_nt_acl: Unable to malloc space for acl.\n"));
2996 } /* security_info & DACL_SECURITY_INFORMATION */
2998 psd = make_standard_sec_desc( main_loop_talloc_get(),
2999 (security_info & OWNER_SECURITY_INFORMATION) ? &owner_sid : NULL,
3000 (security_info & GROUP_SECURITY_INFORMATION) ? &group_sid : NULL,
3005 DEBUG(0,("get_nt_acl: Unable to malloc space for security descriptor.\n"));
3011 * Windows 2000: The DACL_PROTECTED flag in the security
3012 * descriptor marks the ACL as non-inheriting, i.e., no
3013 * ACEs from higher level directories propagate to this
3014 * ACL. In the POSIX ACL model permissions are only
3015 * inherited at file create time, so ACLs never contain
3016 * any ACEs that are inherited dynamically. The DACL_PROTECTED
3017 * flag doesn't seem to bother Windows NT.
3018 * Always set this if map acl inherit is turned off.
3020 if (get_protected_flag(pal) || !lp_map_acl_inherit(SNUM(conn))) {
3021 psd->type |= SE_DESC_DACL_PROTECTED;
3025 dacl_sort_into_canonical_order(psd->dacl->aces, (unsigned int)psd->dacl->num_aces);
3033 SMB_VFS_SYS_ACL_FREE_ACL(conn, posix_acl);
3036 SMB_VFS_SYS_ACL_FREE_ACL(conn, def_acl);
3038 free_canon_ace_list(file_ace);
3039 free_canon_ace_list(dir_ace);
3040 free_inherited_info(pal);
3041 SAFE_FREE(nt_ace_list);
3046 /****************************************************************************
3047 Try to chown a file. We will be able to chown it under the following conditions.
3049 1) If we have root privileges, then it will just work.
3050 2) If we have SeTakeOwnershipPrivilege we can change the user to the current user.
3051 3) If we have SeRestorePrivilege we can change the user to any other user.
3052 4) If we have write permission to the file and dos_filemodes is set
3053 then allow chown to the currently authenticated user.
3054 ****************************************************************************/
3056 int try_chown(connection_struct *conn, const char *fname, uid_t uid, gid_t gid)
3062 if(!CAN_WRITE(conn)) {
3067 /* try the direct way first */
3068 ret = SMB_VFS_CHOWN(conn, fname, uid, gid);
3072 /* Case (2) / (3) */
3073 if (lp_enable_privileges()) {
3075 BOOL has_take_ownership_priv = user_has_privileges(current_user.nt_user_token,
3076 &se_take_ownership);
3077 BOOL has_restore_priv = user_has_privileges(current_user.nt_user_token,
3081 if ( ( has_take_ownership_priv && ( uid == current_user.ut.uid ) ) ||
3083 ( has_restore_priv ) ) {
3086 /* Keep the current file gid the same - take ownership doesn't imply group change. */
3087 ret = SMB_VFS_CHOWN(conn, fname, uid, (gid_t)-1);
3094 if (!lp_dos_filemode(SNUM(conn))) {
3098 if (SMB_VFS_STAT(conn,fname,&st)) {
3102 if (!NT_STATUS_IS_OK(open_file_fchmod(conn,fname,&st,&fsp))) {
3106 /* only allow chown to the current user. This is more secure,
3107 and also copes with the case where the SID in a take ownership ACL is
3108 a local SID on the users workstation
3110 uid = current_user.ut.uid;
3113 /* Keep the current file gid the same. */
3114 ret = SMB_VFS_FCHOWN(fsp, fsp->fh->fd, uid, (gid_t)-1);
3117 close_file_fchmod(fsp);
3123 /* Disable this - prevents ACL inheritance from the ACL editor. JRA. */
3125 /****************************************************************************
3126 Take care of parent ACL inheritance.
3127 ****************************************************************************/
3129 static NTSTATUS append_parent_acl(files_struct *fsp,
3130 SMB_STRUCT_STAT *psbuf,
3132 SEC_DESC **pp_new_sd)
3134 SEC_DESC *parent_sd = NULL;
3135 files_struct *parent_fsp = NULL;
3136 TALLOC_CTX *mem_ctx = talloc_parent(psd);
3137 char *parent_name = NULL;
3138 SEC_ACE *new_ace = NULL;
3139 unsigned int num_aces = psd->dacl->num_aces;
3140 SMB_STRUCT_STAT sbuf;
3145 BOOL is_dacl_protected = (psd->type & SE_DESC_DACL_PROTECTED);
3149 if (mem_ctx == NULL) {
3150 return NT_STATUS_NO_MEMORY;
3153 if (!parent_dirname_talloc(mem_ctx,
3157 return NT_STATUS_NO_MEMORY;
3160 status = open_directory(fsp->conn,
3163 FILE_READ_ATTRIBUTES, /* Just a stat open */
3164 FILE_SHARE_NONE, /* Ignored for stat opens */
3171 if (!NT_STATUS_IS_OK(status)) {
3175 sd_size = SMB_VFS_GET_NT_ACL(parent_fsp, parent_fsp->fsp_name,
3176 DACL_SECURITY_INFORMATION, &parent_sd );
3178 close_file(parent_fsp, NORMAL_CLOSE);
3181 return NT_STATUS_ACCESS_DENIED;
3185 * Make room for potentially all the ACLs from
3186 * the parent. We used to add the ugw triple here,
3187 * as we knew we were dealing with POSIX ACLs.
3188 * We no longer need to do so as we can guarentee
3189 * that a default ACL from the parent directory will
3190 * be well formed for POSIX ACLs if it came from a
3191 * POSIX ACL source, and if we're not writing to a
3192 * POSIX ACL sink then we don't care if it's not well
3196 num_aces += parent_sd->dacl->num_aces;
3198 if((new_ace = TALLOC_ZERO_ARRAY(mem_ctx, SEC_ACE,
3199 num_aces)) == NULL) {
3200 return NT_STATUS_NO_MEMORY;
3203 /* Start by copying in all the given ACE entries. */
3204 for (i = 0; i < psd->dacl->num_aces; i++) {
3205 sec_ace_copy(&new_ace[i], &psd->dacl->aces[i]);
3209 * Note that we're ignoring "inherit permissions" here
3210 * as that really only applies to newly created files. JRA.
3213 /* Finally append any inherited ACEs. */
3214 for (j = 0; j < parent_sd->dacl->num_aces; j++) {
3215 SEC_ACE *se = &parent_sd->dacl->aces[j];
3217 if (fsp->is_directory) {
3218 if (!(se->flags & SEC_ACE_FLAG_CONTAINER_INHERIT)) {
3219 /* Doesn't apply to a directory - ignore. */
3220 DEBUG(10,("append_parent_acl: directory %s "
3221 "ignoring non container "
3222 "inherit flags %u on ACE with sid %s "
3225 (unsigned int)se->flags,
3226 sid_string_static(&se->trustee),
3231 if (!(se->flags & SEC_ACE_FLAG_OBJECT_INHERIT)) {
3232 /* Doesn't apply to a file - ignore. */
3233 DEBUG(10,("append_parent_acl: file %s "
3234 "ignoring non object "
3235 "inherit flags %u on ACE with sid %s "
3238 (unsigned int)se->flags,
3239 sid_string_static(&se->trustee),
3245 if (is_dacl_protected) {
3246 /* If the DACL is protected it means we must
3247 * not overwrite an existing ACE entry with the
3248 * same SID. This is order N^2. Ouch :-(. JRA. */
3250 for (k = 0; k < psd->dacl->num_aces; k++) {
3251 if (sid_equal(&psd->dacl->aces[k].trustee,
3256 if (k < psd->dacl->num_aces) {
3257 /* SID matched. Ignore. */
3258 DEBUG(10,("append_parent_acl: path %s "
3259 "ignoring ACE with protected sid %s "
3262 sid_string_static(&se->trustee),
3268 sec_ace_copy(&new_ace[i], se);
3269 if (se->flags & SEC_ACE_FLAG_NO_PROPAGATE_INHERIT) {
3270 new_ace[i].flags &= ~(SEC_ACE_FLAG_VALID_INHERIT);
3272 new_ace[i].flags |= SEC_ACE_FLAG_INHERITED_ACE;
3274 if (fsp->is_directory) {
3276 * Strip off any inherit only. It's applied.
3278 new_ace[i].flags &= ~(SEC_ACE_FLAG_INHERIT_ONLY);
3279 if (se->flags & SEC_ACE_FLAG_NO_PROPAGATE_INHERIT) {
3280 /* No further inheritance. */
3282 ~(SEC_ACE_FLAG_CONTAINER_INHERIT|
3283 SEC_ACE_FLAG_OBJECT_INHERIT);
3287 * Strip off any container or inherit
3288 * flags, they can't apply to objects.
3290 new_ace[i].flags &= ~(SEC_ACE_FLAG_CONTAINER_INHERIT|
3291 SEC_ACE_FLAG_INHERIT_ONLY|
3292 SEC_ACE_FLAG_NO_PROPAGATE_INHERIT);
3297 DEBUG(10,("append_parent_acl: path %s "
3298 "inheriting ACE with sid %s "
3301 sid_string_static(&se->trustee),
3306 /* This sucks. psd should be const and we should
3307 * be doing a deep-copy here. We're getting away
3308 * with is as we know parent_sd is talloced off
3309 * talloc_tos() as well as psd. JRA. */
3311 psd->dacl->aces = new_ace;
3312 psd->dacl->num_aces = i;
3313 psd->type &= ~(SE_DESC_DACL_AUTO_INHERITED|
3314 SE_DESC_DACL_AUTO_INHERIT_REQ);
3321 /****************************************************************************
3322 Reply to set a security descriptor on an fsp. security_info_sent is the
3323 description of the following NT ACL.
3324 This should be the only external function needed for the UNIX style set ACL.
3325 ****************************************************************************/
3327 BOOL set_nt_acl(files_struct *fsp, uint32 security_info_sent, SEC_DESC *psd)
3329 connection_struct *conn = fsp->conn;
3330 uid_t user = (uid_t)-1;
3331 gid_t grp = (gid_t)-1;
3332 SMB_STRUCT_STAT sbuf;
3333 DOM_SID file_owner_sid;
3334 DOM_SID file_grp_sid;
3335 canon_ace *file_ace_list = NULL;
3336 canon_ace *dir_ace_list = NULL;
3337 BOOL acl_perms = False;
3338 mode_t orig_mode = (mode_t)0;
3341 BOOL need_chown = False;
3343 DEBUG(10,("set_nt_acl: called for file %s\n", fsp->fsp_name ));
3345 if (!CAN_WRITE(conn)) {
3346 DEBUG(10,("set acl rejected on read-only share\n"));
3351 * Get the current state of the file.
3354 if(fsp->is_directory || fsp->fh->fd == -1) {
3355 if(SMB_VFS_STAT(fsp->conn,fsp->fsp_name, &sbuf) != 0)
3358 if(SMB_VFS_FSTAT(fsp,fsp->fh->fd,&sbuf) != 0)
3362 /* Save the original elements we check against. */
3363 orig_mode = sbuf.st_mode;
3364 orig_uid = sbuf.st_uid;
3365 orig_gid = sbuf.st_gid;
3368 * Unpack the user/group/world id's.
3371 if (!unpack_nt_owners( SNUM(conn), &user, &grp, security_info_sent, psd)) {
3376 * Do we need to chown ?
3379 if (((user != (uid_t)-1) && (orig_uid != user)) || (( grp != (gid_t)-1) && (orig_gid != grp))) {
3384 * Chown before setting ACL only if we don't change the user, or
3385 * if we change to the current user, but not if we want to give away
3389 if (need_chown && (user == (uid_t)-1 || user == current_user.ut.uid)) {
3391 DEBUG(3,("set_nt_acl: chown %s. uid = %u, gid = %u.\n",
3392 fsp->fsp_name, (unsigned int)user, (unsigned int)grp ));
3394 if(try_chown( fsp->conn, fsp->fsp_name, user, grp) == -1) {
3395 DEBUG(3,("set_nt_acl: chown %s, %u, %u failed. Error = %s.\n",
3396 fsp->fsp_name, (unsigned int)user, (unsigned int)grp, strerror(errno) ));
3401 * Recheck the current state of the file, which may have changed.
3402 * (suid/sgid bits, for instance)
3405 if(fsp->is_directory) {
3406 if(SMB_VFS_STAT(fsp->conn, fsp->fsp_name, &sbuf) != 0) {
3413 if(fsp->fh->fd == -1)
3414 ret = SMB_VFS_STAT(fsp->conn, fsp->fsp_name, &sbuf);
3416 ret = SMB_VFS_FSTAT(fsp,fsp->fh->fd,&sbuf);
3422 /* Save the original elements we check against. */
3423 orig_mode = sbuf.st_mode;
3424 orig_uid = sbuf.st_uid;
3425 orig_gid = sbuf.st_gid;
3427 /* We did it, don't try again */
3431 create_file_sids(&sbuf, &file_owner_sid, &file_grp_sid);
3434 /* Disable this - prevents ACL inheritance from the ACL editor. JRA. */
3436 /* See here: http://www.codeproject.com/KB/winsdk/accessctrl2.aspx
3437 * for details and also the log trace in bug #4308. JRA.
3440 if ((security_info_sent & DACL_SECURITY_INFORMATION) &&
3441 psd->dacl != NULL &&
3442 (psd->type & (SE_DESC_DACL_AUTO_INHERITED|
3443 SE_DESC_DACL_AUTO_INHERIT_REQ))==
3444 (SE_DESC_DACL_AUTO_INHERITED|
3445 SE_DESC_DACL_AUTO_INHERIT_REQ) ) {
3446 NTSTATUS status = append_parent_acl(fsp, &sbuf, psd, &psd);
3447 if (!NT_STATUS_IS_OK(status)) {
3453 acl_perms = unpack_canon_ace( fsp, &sbuf, &file_owner_sid, &file_grp_sid,
3454 &file_ace_list, &dir_ace_list, security_info_sent, psd);
3456 /* Ignore W2K traverse DACL set. */
3457 if (file_ace_list || dir_ace_list) {
3460 DEBUG(3,("set_nt_acl: cannot set permissions\n"));
3461 free_canon_ace_list(file_ace_list);
3462 free_canon_ace_list(dir_ace_list);
3467 * Only change security if we got a DACL.
3470 if((security_info_sent & DACL_SECURITY_INFORMATION) && (psd->dacl != NULL)) {
3472 BOOL acl_set_support = False;
3476 * Try using the POSIX ACL set first. Fall back to chmod if
3477 * we have no ACL support on this filesystem.
3480 if (acl_perms && file_ace_list) {
3481 ret = set_canon_ace_list(fsp, file_ace_list, False, sbuf.st_gid, &acl_set_support);
3482 if (acl_set_support && ret == False) {
3483 DEBUG(3,("set_nt_acl: failed to set file acl on file %s (%s).\n", fsp->fsp_name, strerror(errno) ));
3484 free_canon_ace_list(file_ace_list);
3485 free_canon_ace_list(dir_ace_list);
3490 if (acl_perms && acl_set_support && fsp->is_directory) {
3492 if (!set_canon_ace_list(fsp, dir_ace_list, True, sbuf.st_gid, &acl_set_support)) {
3493 DEBUG(3,("set_nt_acl: failed to set default acl on directory %s (%s).\n", fsp->fsp_name, strerror(errno) ));
3494 free_canon_ace_list(file_ace_list);
3495 free_canon_ace_list(dir_ace_list);
3501 * No default ACL - delete one if it exists.
3504 if (SMB_VFS_SYS_ACL_DELETE_DEF_FILE(conn, fsp->fsp_name) == -1) {
3507 if (acl_group_override(conn, sbuf.st_gid, fsp->fsp_name)) {
3508 DEBUG(5,("set_nt_acl: acl group control on and "
3509 "current user in file %s primary group. Override delete_def_acl\n",
3513 sret = SMB_VFS_SYS_ACL_DELETE_DEF_FILE(conn, fsp->fsp_name);
3518 DEBUG(3,("set_nt_acl: sys_acl_delete_def_file failed (%s)\n", strerror(errno)));
3519 free_canon_ace_list(file_ace_list);
3520 free_canon_ace_list(dir_ace_list);
3527 if (acl_set_support) {
3528 store_inheritance_attributes(fsp, file_ace_list, dir_ace_list,
3529 (psd->type & SE_DESC_DACL_PROTECTED) ? True : False);
3533 * If we cannot set using POSIX ACLs we fall back to checking if we need to chmod.
3536 if(!acl_set_support && acl_perms) {
3539 if (!convert_canon_ace_to_posix_perms( fsp, file_ace_list, &posix_perms)) {
3540 free_canon_ace_list(file_ace_list);
3541 free_canon_ace_list(dir_ace_list);
3542 DEBUG(3,("set_nt_acl: failed to convert file acl to posix permissions for file %s.\n",
3547 if (orig_mode != posix_perms) {
3549 DEBUG(3,("set_nt_acl: chmod %s. perms = 0%o.\n",
3550 fsp->fsp_name, (unsigned int)posix_perms ));
3552 if(SMB_VFS_CHMOD(conn,fsp->fsp_name, posix_perms) == -1) {
3554 if (acl_group_override(conn, sbuf.st_gid, fsp->fsp_name)) {
3555 DEBUG(5,("set_nt_acl: acl group control on and "
3556 "current user in file %s primary group. Override chmod\n",
3560 sret = SMB_VFS_CHMOD(conn,fsp->fsp_name, posix_perms);
3565 DEBUG(3,("set_nt_acl: chmod %s, 0%o failed. Error = %s.\n",
3566 fsp->fsp_name, (unsigned int)posix_perms, strerror(errno) ));
3567 free_canon_ace_list(file_ace_list);
3568 free_canon_ace_list(dir_ace_list);
3576 free_canon_ace_list(file_ace_list);
3577 free_canon_ace_list(dir_ace_list);
3580 /* Any chown pending? */
3583 DEBUG(3,("set_nt_acl: chown %s. uid = %u, gid = %u.\n",
3584 fsp->fsp_name, (unsigned int)user, (unsigned int)grp ));
3586 if(try_chown( fsp->conn, fsp->fsp_name, user, grp) == -1) {
3587 DEBUG(3,("set_nt_acl: chown %s, %u, %u failed. Error = %s.\n",
3588 fsp->fsp_name, (unsigned int)user, (unsigned int)grp, strerror(errno) ));
3596 /****************************************************************************
3597 Get the actual group bits stored on a file with an ACL. Has no effect if
3598 the file has no ACL. Needed in dosmode code where the stat() will return
3599 the mask bits, not the real group bits, for a file with an ACL.
3600 ****************************************************************************/
3602 int get_acl_group_bits( connection_struct *conn, const char *fname, mode_t *mode )
3604 int entry_id = SMB_ACL_FIRST_ENTRY;
3605 SMB_ACL_ENTRY_T entry;
3606 SMB_ACL_T posix_acl;
3609 posix_acl = SMB_VFS_SYS_ACL_GET_FILE(conn, fname, SMB_ACL_TYPE_ACCESS);
3610 if (posix_acl == (SMB_ACL_T)NULL)
3613 while (SMB_VFS_SYS_ACL_GET_ENTRY(conn, posix_acl, entry_id, &entry) == 1) {
3614 SMB_ACL_TAG_T tagtype;
3615 SMB_ACL_PERMSET_T permset;
3618 if (entry_id == SMB_ACL_FIRST_ENTRY)
3619 entry_id = SMB_ACL_NEXT_ENTRY;
3621 if (SMB_VFS_SYS_ACL_GET_TAG_TYPE(conn, entry, &tagtype) ==-1)
3624 if (tagtype == SMB_ACL_GROUP_OBJ) {
3625 if (SMB_VFS_SYS_ACL_GET_PERMSET(conn, entry, &permset) == -1) {
3628 *mode &= ~(S_IRGRP|S_IWGRP|S_IXGRP);
3629 *mode |= (SMB_VFS_SYS_ACL_GET_PERM(conn, permset, SMB_ACL_READ) ? S_IRGRP : 0);
3630 *mode |= (SMB_VFS_SYS_ACL_GET_PERM(conn, permset, SMB_ACL_WRITE) ? S_IWGRP : 0);
3631 *mode |= (SMB_VFS_SYS_ACL_GET_PERM(conn, permset, SMB_ACL_EXECUTE) ? S_IXGRP : 0);
3637 SMB_VFS_SYS_ACL_FREE_ACL(conn, posix_acl);
3641 /****************************************************************************
3642 Do a chmod by setting the ACL USER_OBJ, GROUP_OBJ and OTHER bits in an ACL
3643 and set the mask to rwx. Needed to preserve complex ACLs set by NT.
3644 ****************************************************************************/
3646 static int chmod_acl_internals( connection_struct *conn, SMB_ACL_T posix_acl, mode_t mode)
3648 int entry_id = SMB_ACL_FIRST_ENTRY;
3649 SMB_ACL_ENTRY_T entry;
3650 int num_entries = 0;
3652 while ( SMB_VFS_SYS_ACL_GET_ENTRY(conn, posix_acl, entry_id, &entry) == 1) {
3653 SMB_ACL_TAG_T tagtype;
3654 SMB_ACL_PERMSET_T permset;
3658 if (entry_id == SMB_ACL_FIRST_ENTRY)
3659 entry_id = SMB_ACL_NEXT_ENTRY;
3661 if (SMB_VFS_SYS_ACL_GET_TAG_TYPE(conn, entry, &tagtype) == -1)
3664 if (SMB_VFS_SYS_ACL_GET_PERMSET(conn, entry, &permset) == -1)
3670 case SMB_ACL_USER_OBJ:
3671 perms = unix_perms_to_acl_perms(mode, S_IRUSR, S_IWUSR, S_IXUSR);
3673 case SMB_ACL_GROUP_OBJ:
3674 perms = unix_perms_to_acl_perms(mode, S_IRGRP, S_IWGRP, S_IXGRP);
3678 * FIXME: The ACL_MASK entry permissions should really be set to
3679 * the union of the permissions of all ACL_USER,
3680 * ACL_GROUP_OBJ, and ACL_GROUP entries. That's what
3681 * acl_calc_mask() does, but Samba ACLs doesn't provide it.
3683 perms = S_IRUSR|S_IWUSR|S_IXUSR;
3686 perms = unix_perms_to_acl_perms(mode, S_IROTH, S_IWOTH, S_IXOTH);
3692 if (map_acl_perms_to_permset(conn, perms, &permset) == -1)
3695 if (SMB_VFS_SYS_ACL_SET_PERMSET(conn, entry, permset) == -1)
3700 * If this is a simple 3 element ACL or no elements then it's a standard
3701 * UNIX permission set. Just use chmod...
3704 if ((num_entries == 3) || (num_entries == 0))
3710 /****************************************************************************
3711 Get the access ACL of FROM, do a chmod by setting the ACL USER_OBJ,
3712 GROUP_OBJ and OTHER bits in an ACL and set the mask to rwx. Set the
3713 resulting ACL on TO. Note that name is in UNIX character set.
3714 ****************************************************************************/
3716 static int copy_access_acl(connection_struct *conn, const char *from, const char *to, mode_t mode)
3718 SMB_ACL_T posix_acl = NULL;
3721 if ((posix_acl = SMB_VFS_SYS_ACL_GET_FILE(conn, from, SMB_ACL_TYPE_ACCESS)) == NULL)
3724 if ((ret = chmod_acl_internals(conn, posix_acl, mode)) == -1)
3727 ret = SMB_VFS_SYS_ACL_SET_FILE(conn, to, SMB_ACL_TYPE_ACCESS, posix_acl);
3731 SMB_VFS_SYS_ACL_FREE_ACL(conn, posix_acl);
3735 /****************************************************************************
3736 Do a chmod by setting the ACL USER_OBJ, GROUP_OBJ and OTHER bits in an ACL
3737 and set the mask to rwx. Needed to preserve complex ACLs set by NT.
3738 Note that name is in UNIX character set.
3739 ****************************************************************************/
3741 int chmod_acl(connection_struct *conn, const char *name, mode_t mode)
3743 return copy_access_acl(conn, name, name, mode);
3746 /****************************************************************************
3747 If the parent directory has no default ACL but it does have an Access ACL,
3748 inherit this Access ACL to file name.
3749 ****************************************************************************/
3751 int inherit_access_acl(connection_struct *conn, const char *inherit_from_dir,
3752 const char *name, mode_t mode)
3754 if (directory_has_default_acl(conn, inherit_from_dir))
3757 return copy_access_acl(conn, inherit_from_dir, name, mode);
3760 /****************************************************************************
3761 Do an fchmod by setting the ACL USER_OBJ, GROUP_OBJ and OTHER bits in an ACL
3762 and set the mask to rwx. Needed to preserve complex ACLs set by NT.
3763 ****************************************************************************/
3765 int fchmod_acl(files_struct *fsp, int fd, mode_t mode)
3767 connection_struct *conn = fsp->conn;
3768 SMB_ACL_T posix_acl = NULL;
3771 if ((posix_acl = SMB_VFS_SYS_ACL_GET_FD(fsp, fd)) == NULL)
3774 if ((ret = chmod_acl_internals(conn, posix_acl, mode)) == -1)
3777 ret = SMB_VFS_SYS_ACL_SET_FD(fsp, fd, posix_acl);
3781 SMB_VFS_SYS_ACL_FREE_ACL(conn, posix_acl);
3785 /****************************************************************************
3786 Check for an existing default POSIX ACL on a directory.
3787 ****************************************************************************/
3789 BOOL directory_has_default_acl(connection_struct *conn, const char *fname)
3791 SMB_ACL_T def_acl = SMB_VFS_SYS_ACL_GET_FILE( conn, fname, SMB_ACL_TYPE_DEFAULT);
3792 BOOL has_acl = False;
3793 SMB_ACL_ENTRY_T entry;
3795 if (def_acl != NULL && (SMB_VFS_SYS_ACL_GET_ENTRY(conn, def_acl, SMB_ACL_FIRST_ENTRY, &entry) == 1)) {
3800 SMB_VFS_SYS_ACL_FREE_ACL(conn, def_acl);
3805 /****************************************************************************
3806 Map from wire type to permset.
3807 ****************************************************************************/
3809 static BOOL unix_ex_wire_to_permset(connection_struct *conn, unsigned char wire_perm, SMB_ACL_PERMSET_T *p_permset)
3811 if (wire_perm & ~(SMB_POSIX_ACL_READ|SMB_POSIX_ACL_WRITE|SMB_POSIX_ACL_EXECUTE)) {
3815 if (SMB_VFS_SYS_ACL_CLEAR_PERMS(conn, *p_permset) == -1) {
3819 if (wire_perm & SMB_POSIX_ACL_READ) {
3820 if (SMB_VFS_SYS_ACL_ADD_PERM(conn, *p_permset, SMB_ACL_READ) == -1) {
3824 if (wire_perm & SMB_POSIX_ACL_WRITE) {
3825 if (SMB_VFS_SYS_ACL_ADD_PERM(conn, *p_permset, SMB_ACL_WRITE) == -1) {
3829 if (wire_perm & SMB_POSIX_ACL_EXECUTE) {
3830 if (SMB_VFS_SYS_ACL_ADD_PERM(conn, *p_permset, SMB_ACL_EXECUTE) == -1) {
3837 /****************************************************************************
3838 Map from wire type to tagtype.
3839 ****************************************************************************/
3841 static BOOL unix_ex_wire_to_tagtype(unsigned char wire_tt, SMB_ACL_TAG_T *p_tt)
3844 case SMB_POSIX_ACL_USER_OBJ:
3845 *p_tt = SMB_ACL_USER_OBJ;
3847 case SMB_POSIX_ACL_USER:
3848 *p_tt = SMB_ACL_USER;
3850 case SMB_POSIX_ACL_GROUP_OBJ:
3851 *p_tt = SMB_ACL_GROUP_OBJ;
3853 case SMB_POSIX_ACL_GROUP:
3854 *p_tt = SMB_ACL_GROUP;
3856 case SMB_POSIX_ACL_MASK:
3857 *p_tt = SMB_ACL_MASK;
3859 case SMB_POSIX_ACL_OTHER:
3860 *p_tt = SMB_ACL_OTHER;
3868 /****************************************************************************
3869 Create a new POSIX acl from wire permissions.
3870 FIXME ! How does the share mask/mode fit into this.... ?
3871 ****************************************************************************/
3873 static SMB_ACL_T create_posix_acl_from_wire(connection_struct *conn, uint16 num_acls, const char *pdata)
3876 SMB_ACL_T the_acl = SMB_VFS_SYS_ACL_INIT(conn, num_acls);
3878 if (the_acl == NULL) {
3882 for (i = 0; i < num_acls; i++) {
3883 SMB_ACL_ENTRY_T the_entry;
3884 SMB_ACL_PERMSET_T the_permset;
3885 SMB_ACL_TAG_T tag_type;
3887 if (SMB_VFS_SYS_ACL_CREATE_ENTRY(conn, &the_acl, &the_entry) == -1) {
3888 DEBUG(0,("create_posix_acl_from_wire: Failed to create entry %u. (%s)\n",
3889 i, strerror(errno) ));
3893 if (!unix_ex_wire_to_tagtype(CVAL(pdata,(i*SMB_POSIX_ACL_ENTRY_SIZE)), &tag_type)) {
3894 DEBUG(0,("create_posix_acl_from_wire: invalid wire tagtype %u on entry %u.\n",
3895 CVAL(pdata,(i*SMB_POSIX_ACL_ENTRY_SIZE)), i ));
3899 if (SMB_VFS_SYS_ACL_SET_TAG_TYPE(conn, the_entry, tag_type) == -1) {
3900 DEBUG(0,("create_posix_acl_from_wire: Failed to set tagtype on entry %u. (%s)\n",
3901 i, strerror(errno) ));
3905 /* Get the permset pointer from the new ACL entry. */
3906 if (SMB_VFS_SYS_ACL_GET_PERMSET(conn, the_entry, &the_permset) == -1) {
3907 DEBUG(0,("create_posix_acl_from_wire: Failed to get permset on entry %u. (%s)\n",
3908 i, strerror(errno) ));
3912 /* Map from wire to permissions. */
3913 if (!unix_ex_wire_to_permset(conn, CVAL(pdata,(i*SMB_POSIX_ACL_ENTRY_SIZE)+1), &the_permset)) {
3914 DEBUG(0,("create_posix_acl_from_wire: invalid permset %u on entry %u.\n",
3915 CVAL(pdata,(i*SMB_POSIX_ACL_ENTRY_SIZE) + 1), i ));
3919 /* Now apply to the new ACL entry. */
3920 if (SMB_VFS_SYS_ACL_SET_PERMSET(conn, the_entry, the_permset) == -1) {
3921 DEBUG(0,("create_posix_acl_from_wire: Failed to add permset on entry %u. (%s)\n",
3922 i, strerror(errno) ));
3926 if (tag_type == SMB_ACL_USER) {
3927 uint32 uidval = IVAL(pdata,(i*SMB_POSIX_ACL_ENTRY_SIZE)+2);
3928 uid_t uid = (uid_t)uidval;
3929 if (SMB_VFS_SYS_ACL_SET_QUALIFIER(conn, the_entry,(void *)&uid) == -1) {
3930 DEBUG(0,("create_posix_acl_from_wire: Failed to set uid %u on entry %u. (%s)\n",
3931 (unsigned int)uid, i, strerror(errno) ));
3936 if (tag_type == SMB_ACL_GROUP) {
3937 uint32 gidval = IVAL(pdata,(i*SMB_POSIX_ACL_ENTRY_SIZE)+2);
3938 gid_t gid = (uid_t)gidval;
3939 if (SMB_VFS_SYS_ACL_SET_QUALIFIER(conn, the_entry,(void *)&gid) == -1) {
3940 DEBUG(0,("create_posix_acl_from_wire: Failed to set gid %u on entry %u. (%s)\n",
3941 (unsigned int)gid, i, strerror(errno) ));
3951 if (the_acl != NULL) {
3952 SMB_VFS_SYS_ACL_FREE_ACL(conn, the_acl);
3957 /****************************************************************************
3958 Calls from UNIX extensions - Default POSIX ACL set.
3959 If num_def_acls == 0 and not a directory just return. If it is a directory
3960 and num_def_acls == 0 then remove the default acl. Else set the default acl
3962 ****************************************************************************/
3964 BOOL set_unix_posix_default_acl(connection_struct *conn, const char *fname, SMB_STRUCT_STAT *psbuf,
3965 uint16 num_def_acls, const char *pdata)
3967 SMB_ACL_T def_acl = NULL;
3969 if (num_def_acls && !S_ISDIR(psbuf->st_mode)) {
3970 DEBUG(5,("set_unix_posix_default_acl: Can't set default ACL on non-directory file %s\n", fname ));
3975 if (!num_def_acls) {
3976 /* Remove the default ACL. */
3977 if (SMB_VFS_SYS_ACL_DELETE_DEF_FILE(conn, fname) == -1) {
3978 DEBUG(5,("set_unix_posix_default_acl: acl_delete_def_file failed on directory %s (%s)\n",
3979 fname, strerror(errno) ));
3985 if ((def_acl = create_posix_acl_from_wire(conn, num_def_acls, pdata)) == NULL) {
3989 if (SMB_VFS_SYS_ACL_SET_FILE(conn, fname, SMB_ACL_TYPE_DEFAULT, def_acl) == -1) {
3990 DEBUG(5,("set_unix_posix_default_acl: acl_set_file failed on directory %s (%s)\n",
3991 fname, strerror(errno) ));
3992 SMB_VFS_SYS_ACL_FREE_ACL(conn, def_acl);
3996 DEBUG(10,("set_unix_posix_default_acl: set default acl for file %s\n", fname ));
3997 SMB_VFS_SYS_ACL_FREE_ACL(conn, def_acl);
4001 /****************************************************************************
4002 Remove an ACL from a file. As we don't have acl_delete_entry() available
4003 we must read the current acl and copy all entries except MASK, USER and GROUP
4004 to a new acl, then set that. This (at least on Linux) causes any ACL to be
4006 FIXME ! How does the share mask/mode fit into this.... ?
4007 ****************************************************************************/
4009 static BOOL remove_posix_acl(connection_struct *conn, files_struct *fsp, const char *fname)
4011 SMB_ACL_T file_acl = NULL;
4012 int entry_id = SMB_ACL_FIRST_ENTRY;
4013 SMB_ACL_ENTRY_T entry;
4015 /* Create a new ACL with only 3 entries, u/g/w. */
4016 SMB_ACL_T new_file_acl = SMB_VFS_SYS_ACL_INIT(conn, 3);
4017 SMB_ACL_ENTRY_T user_ent = NULL;
4018 SMB_ACL_ENTRY_T group_ent = NULL;
4019 SMB_ACL_ENTRY_T other_ent = NULL;
4021 if (new_file_acl == NULL) {
4022 DEBUG(5,("remove_posix_acl: failed to init new ACL with 3 entries for file %s.\n", fname));
4026 /* Now create the u/g/w entries. */
4027 if (SMB_VFS_SYS_ACL_CREATE_ENTRY(conn, &new_file_acl, &user_ent) == -1) {
4028 DEBUG(5,("remove_posix_acl: Failed to create user entry for file %s. (%s)\n",
4029 fname, strerror(errno) ));
4032 if (SMB_VFS_SYS_ACL_SET_TAG_TYPE(conn, user_ent, SMB_ACL_USER_OBJ) == -1) {
4033 DEBUG(5,("remove_posix_acl: Failed to set user entry for file %s. (%s)\n",
4034 fname, strerror(errno) ));
4038 if (SMB_VFS_SYS_ACL_CREATE_ENTRY(conn, &new_file_acl, &group_ent) == -1) {
4039 DEBUG(5,("remove_posix_acl: Failed to create group entry for file %s. (%s)\n",
4040 fname, strerror(errno) ));
4043 if (SMB_VFS_SYS_ACL_SET_TAG_TYPE(conn, group_ent, SMB_ACL_GROUP_OBJ) == -1) {
4044 DEBUG(5,("remove_posix_acl: Failed to set group entry for file %s. (%s)\n",
4045 fname, strerror(errno) ));
4049 if (SMB_VFS_SYS_ACL_CREATE_ENTRY(conn, &new_file_acl, &other_ent) == -1) {
4050 DEBUG(5,("remove_posix_acl: Failed to create other entry for file %s. (%s)\n",
4051 fname, strerror(errno) ));
4054 if (SMB_VFS_SYS_ACL_SET_TAG_TYPE(conn, other_ent, SMB_ACL_OTHER) == -1) {
4055 DEBUG(5,("remove_posix_acl: Failed to set other entry for file %s. (%s)\n",
4056 fname, strerror(errno) ));
4060 /* Get the current file ACL. */
4061 if (fsp && fsp->fh->fd != -1) {
4062 file_acl = SMB_VFS_SYS_ACL_GET_FD(fsp, fsp->fh->fd);
4064 file_acl = SMB_VFS_SYS_ACL_GET_FILE( conn, fname, SMB_ACL_TYPE_ACCESS);
4067 if (file_acl == NULL) {
4068 /* This is only returned if an error occurred. Even for a file with
4069 no acl a u/g/w acl should be returned. */
4070 DEBUG(5,("remove_posix_acl: failed to get ACL from file %s (%s).\n",
4071 fname, strerror(errno) ));
4075 while ( SMB_VFS_SYS_ACL_GET_ENTRY(conn, file_acl, entry_id, &entry) == 1) {
4076 SMB_ACL_TAG_T tagtype;
4077 SMB_ACL_PERMSET_T permset;
4080 if (entry_id == SMB_ACL_FIRST_ENTRY)
4081 entry_id = SMB_ACL_NEXT_ENTRY;
4083 if (SMB_VFS_SYS_ACL_GET_TAG_TYPE(conn, entry, &tagtype) == -1) {
4084 DEBUG(5,("remove_posix_acl: failed to get tagtype from ACL on file %s (%s).\n",
4085 fname, strerror(errno) ));
4089 if (SMB_VFS_SYS_ACL_GET_PERMSET(conn, entry, &permset) == -1) {
4090 DEBUG(5,("remove_posix_acl: failed to get permset from ACL on file %s (%s).\n",
4091 fname, strerror(errno) ));
4095 if (tagtype == SMB_ACL_USER_OBJ) {
4096 if (SMB_VFS_SYS_ACL_SET_PERMSET(conn, user_ent, permset) == -1) {
4097 DEBUG(5,("remove_posix_acl: failed to set permset from ACL on file %s (%s).\n",
4098 fname, strerror(errno) ));
4100 } else if (tagtype == SMB_ACL_GROUP_OBJ) {
4101 if (SMB_VFS_SYS_ACL_SET_PERMSET(conn, group_ent, permset) == -1) {
4102 DEBUG(5,("remove_posix_acl: failed to set permset from ACL on file %s (%s).\n",
4103 fname, strerror(errno) ));
4105 } else if (tagtype == SMB_ACL_OTHER) {
4106 if (SMB_VFS_SYS_ACL_SET_PERMSET(conn, other_ent, permset) == -1) {
4107 DEBUG(5,("remove_posix_acl: failed to set permset from ACL on file %s (%s).\n",
4108 fname, strerror(errno) ));
4113 /* Set the new empty file ACL. */
4114 if (fsp && fsp->fh->fd != -1) {
4115 if (SMB_VFS_SYS_ACL_SET_FD(fsp, fsp->fh->fd, new_file_acl) == -1) {
4116 DEBUG(5,("remove_posix_acl: acl_set_file failed on %s (%s)\n",
4117 fname, strerror(errno) ));
4121 if (SMB_VFS_SYS_ACL_SET_FILE(conn, fname, SMB_ACL_TYPE_ACCESS, new_file_acl) == -1) {
4122 DEBUG(5,("remove_posix_acl: acl_set_file failed on %s (%s)\n",
4123 fname, strerror(errno) ));
4133 SMB_VFS_SYS_ACL_FREE_ACL(conn, file_acl);
4136 SMB_VFS_SYS_ACL_FREE_ACL(conn, new_file_acl);
4141 /****************************************************************************
4142 Calls from UNIX extensions - POSIX ACL set.
4143 If num_def_acls == 0 then read/modify/write acl after removing all entries
4144 except SMB_ACL_USER_OBJ, SMB_ACL_GROUP_OBJ, SMB_ACL_OTHER.
4145 ****************************************************************************/
4147 BOOL set_unix_posix_acl(connection_struct *conn, files_struct *fsp, const char *fname, uint16 num_acls, const char *pdata)
4149 SMB_ACL_T file_acl = NULL;
4152 /* Remove the ACL from the file. */
4153 return remove_posix_acl(conn, fsp, fname);
4156 if ((file_acl = create_posix_acl_from_wire(conn, num_acls, pdata)) == NULL) {
4160 if (fsp && fsp->fh->fd != -1) {
4161 /* The preferred way - use an open fd. */
4162 if (SMB_VFS_SYS_ACL_SET_FD(fsp, fsp->fh->fd, file_acl) == -1) {
4163 DEBUG(5,("set_unix_posix_acl: acl_set_file failed on %s (%s)\n",
4164 fname, strerror(errno) ));
4165 SMB_VFS_SYS_ACL_FREE_ACL(conn, file_acl);
4169 if (SMB_VFS_SYS_ACL_SET_FILE(conn, fname, SMB_ACL_TYPE_ACCESS, file_acl) == -1) {
4170 DEBUG(5,("set_unix_posix_acl: acl_set_file failed on %s (%s)\n",
4171 fname, strerror(errno) ));
4172 SMB_VFS_SYS_ACL_FREE_ACL(conn, file_acl);
4177 DEBUG(10,("set_unix_posix_acl: set acl for file %s\n", fname ));
4178 SMB_VFS_SYS_ACL_FREE_ACL(conn, file_acl);
4182 /****************************************************************************
4183 Helper function that gets a security descriptor by connection and
4185 NOTE: This is transitional, in the sense that SMB_VFS_GET_NT_ACL really
4186 should *not* get a files_struct pointer but a connection_struct ptr
4187 (automatic by the vfs handle) and the file name and _use_ that!
4188 ****************************************************************************/
4189 static NTSTATUS conn_get_nt_acl(TALLOC_CTX *mem_ctx,
4190 struct connection_struct *conn,
4192 SMB_STRUCT_STAT *psbuf,
4193 struct security_descriptor_info **psd)
4196 struct files_struct *fsp = NULL;
4197 struct security_descriptor_info *secdesc = NULL;
4198 size_t secdesc_size;
4200 if (!VALID_STAT(*psbuf)) {
4201 if (SMB_VFS_STAT(conn, fname, psbuf) != 0) {
4202 return map_nt_error_from_unix(errno);
4206 /* fake a files_struct ptr: */
4208 if (S_ISDIR(psbuf->st_mode)) {
4209 status = open_directory(conn, fname, psbuf,
4210 READ_CONTROL_ACCESS,
4211 FILE_SHARE_READ|FILE_SHARE_WRITE,
4214 FILE_ATTRIBUTE_DIRECTORY,
4218 status = open_file_stat(conn, fname, psbuf, &fsp);
4221 if (!NT_STATUS_IS_OK(status)) {
4222 DEBUG(3, ("Unable to open file %s: %s\n", fname,
4223 nt_errstr(status)));
4227 secdesc_size = SMB_VFS_GET_NT_ACL(fsp, fname,
4228 (OWNER_SECURITY_INFORMATION |
4229 GROUP_SECURITY_INFORMATION |
4230 DACL_SECURITY_INFORMATION),
4232 if (secdesc_size == 0) {
4233 DEBUG(5, ("Unable to get NT ACL for file %s\n", fname));
4234 status = NT_STATUS_ACCESS_DENIED;
4238 *psd = talloc_move(mem_ctx, &secdesc);
4239 status = NT_STATUS_OK;
4242 close_file(fsp, NORMAL_CLOSE);
4246 static BOOL can_access_file_acl(struct connection_struct *conn,
4247 const char * fname, SMB_STRUCT_STAT *psbuf,
4248 uint32_t access_mask)
4252 uint32_t access_granted;
4253 struct security_descriptor_info *secdesc = NULL;
4255 status = conn_get_nt_acl(tmp_talloc_ctx(), conn, fname, psbuf, &secdesc);
4256 if (!NT_STATUS_IS_OK(status)) {
4257 DEBUG(5, ("Could not get acl: %s\n", nt_errstr(status)));
4261 result = se_access_check(secdesc, current_user.nt_user_token,
4262 access_mask, &access_granted, &status);
4263 TALLOC_FREE(secdesc);
4267 /****************************************************************************
4268 Actually emulate the in-kernel access checking for delete access. We need
4269 this to successfully return ACCESS_DENIED on a file open for delete access.
4270 ****************************************************************************/
4272 BOOL can_delete_file_in_directory(connection_struct *conn, const char *fname)
4274 SMB_STRUCT_STAT sbuf;
4277 if (!CAN_WRITE(conn)) {
4281 /* Get the parent directory permission mask and owners. */
4282 pstrcpy(dname, parent_dirname(fname));
4283 if(SMB_VFS_STAT(conn, dname, &sbuf) != 0) {
4287 /* fast paths first */
4289 if (!S_ISDIR(sbuf.st_mode)) {
4292 if (current_user.ut.uid == 0 || conn->admin_user) {
4293 /* I'm sorry sir, I didn't know you were root... */
4297 /* Check primary owner write access. */
4298 if (current_user.ut.uid == sbuf.st_uid) {
4299 return (sbuf.st_mode & S_IWUSR) ? True : False;
4303 /* sticky bit means delete only by owner or root. */
4304 if (sbuf.st_mode & S_ISVTX) {
4305 SMB_STRUCT_STAT sbuf_file;
4306 if(SMB_VFS_STAT(conn, fname, &sbuf_file) != 0) {
4307 if (errno == ENOENT) {
4308 /* If the file doesn't already exist then
4309 * yes we'll be able to delete it. */
4315 * Patch from SATOH Fumiyasu <fumiyas@miraclelinux.com>
4316 * for bug #3348. Don't assume owning sticky bit
4317 * directory means write access allowed.
4319 if (current_user.ut.uid != sbuf_file.st_uid) {
4325 /* now for ACL checks */
4327 return can_access_file_acl(conn, dname, &sbuf, FILE_WRITE_DATA);
4330 /****************************************************************************
4331 Actually emulate the in-kernel access checking for read/write access. We need
4332 this to successfully check for ability to write for dos filetimes.
4333 Note this doesn't take into account share write permissions.
4334 ****************************************************************************/
4336 BOOL can_access_file(connection_struct *conn, const char *fname, SMB_STRUCT_STAT *psbuf, uint32 access_mask)
4338 if (!(access_mask & (FILE_READ_DATA|FILE_WRITE_DATA))) {
4341 access_mask &= (FILE_READ_DATA|FILE_WRITE_DATA);
4343 /* some fast paths first */
4345 DEBUG(10,("can_access_file: requesting 0x%x on file %s\n",
4346 (unsigned int)access_mask, fname ));
4348 if (current_user.ut.uid == 0 || conn->admin_user) {
4349 /* I'm sorry sir, I didn't know you were root... */
4353 if (!VALID_STAT(*psbuf)) {
4354 /* Get the file permission mask and owners. */
4355 if(SMB_VFS_STAT(conn, fname, psbuf) != 0) {
4360 /* Check primary owner access. */
4361 if (current_user.ut.uid == psbuf->st_uid) {
4362 switch (access_mask) {
4363 case FILE_READ_DATA:
4364 return (psbuf->st_mode & S_IRUSR) ? True : False;
4366 case FILE_WRITE_DATA:
4367 return (psbuf->st_mode & S_IWUSR) ? True : False;
4369 default: /* FILE_READ_DATA|FILE_WRITE_DATA */
4371 if ((psbuf->st_mode & (S_IWUSR|S_IRUSR)) == (S_IWUSR|S_IRUSR)) {
4379 /* now for ACL checks */
4381 return can_access_file_acl(conn, fname, psbuf, access_mask);
4384 /****************************************************************************
4385 Userspace check for write access.
4386 Note this doesn't take into account share write permissions.
4387 ****************************************************************************/
4389 BOOL can_write_to_file(connection_struct *conn, const char *fname, SMB_STRUCT_STAT *psbuf)
4391 return can_access_file(conn, fname, psbuf, FILE_WRITE_DATA);
4394 /********************************************************************
4395 Pull the NT ACL from a file on disk or the OpenEventlog() access
4396 check. Caller is responsible for freeing the returned security
4397 descriptor via TALLOC_FREE(). This is designed for dealing with
4398 user space access checks in smbd outside of the VFS. For example,
4399 checking access rights in OpenEventlog().
4401 Assume we are dealing with files (for now)
4402 ********************************************************************/
4404 SEC_DESC* get_nt_acl_no_snum( TALLOC_CTX *ctx, const char *fname)
4406 SEC_DESC *psd, *ret_sd;
4407 connection_struct conn;
4409 struct fd_handle fh;
4413 ZERO_STRUCT( conn );
4415 if ( !(conn.mem_ctx = talloc_init( "novfs_get_nt_acl" )) ) {
4416 DEBUG(0,("get_nt_acl_no_snum: talloc() failed!\n"));
4420 if (!(conn.params = TALLOC_P(conn.mem_ctx, struct share_params))) {
4421 DEBUG(0,("get_nt_acl_no_snum: talloc() failed!\n"));
4422 TALLOC_FREE(conn.mem_ctx);
4426 conn.params->service = -1;
4428 pstrcpy( path, "/" );
4429 set_conn_connectpath(&conn, path);
4431 if (!smbd_vfs_init(&conn)) {
4432 DEBUG(0,("get_nt_acl_no_snum: Unable to create a fake connection struct!\n"));
4433 conn_free_internal( &conn );
4437 ZERO_STRUCT( finfo );
4444 pstrcpy( filename, fname );
4445 finfo.fsp_name = filename;
4447 if (get_nt_acl( &finfo, DACL_SECURITY_INFORMATION, &psd ) == 0) {
4448 DEBUG(0,("get_nt_acl_no_snum: get_nt_acl returned zero.\n"));
4449 conn_free_internal( &conn );
4453 ret_sd = dup_sec_desc( ctx, psd );
4455 conn_free_internal( &conn );