4 * Copyright (C) International Business Machines Corp., 2007,2008
5 * Author(s): Steve French (sfrench@us.ibm.com)
7 * Contains the routines for mapping CIFS/NTFS ACLs
9 * This library is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU Lesser General Public License as published
11 * by the Free Software Foundation; either version 2.1 of the License, or
12 * (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
17 * the GNU Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public License
20 * along with this library; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
28 #include "cifsproto.h"
29 #include "cifs_debug.h"
32 #ifdef CONFIG_CIFS_EXPERIMENTAL
34 static struct cifs_wksid wksidarr[NUM_WK_SIDS] = {
35 {{1, 0, {0, 0, 0, 0, 0, 0}, {0, 0, 0, 0, 0} }, "null user"},
36 {{1, 1, {0, 0, 0, 0, 0, 1}, {0, 0, 0, 0, 0} }, "nobody"},
37 {{1, 1, {0, 0, 0, 0, 0, 5}, {cpu_to_le32(11), 0, 0, 0, 0} }, "net-users"},
38 {{1, 1, {0, 0, 0, 0, 0, 5}, {cpu_to_le32(18), 0, 0, 0, 0} }, "sys"},
39 {{1, 2, {0, 0, 0, 0, 0, 5}, {cpu_to_le32(32), cpu_to_le32(544), 0, 0, 0} }, "root"},
40 {{1, 2, {0, 0, 0, 0, 0, 5}, {cpu_to_le32(32), cpu_to_le32(545), 0, 0, 0} }, "users"},
41 {{1, 2, {0, 0, 0, 0, 0, 5}, {cpu_to_le32(32), cpu_to_le32(546), 0, 0, 0} }, "guest"} }
45 /* security id for everyone */
46 static const struct cifs_sid sid_everyone = {
47 1, 1, {0, 0, 0, 0, 0, 1}, {0} };
49 static const struct cifs_sid sid_user = {1, 2 , {0, 0, 0, 0, 0, 5}, {} };
52 int match_sid(struct cifs_sid *ctsid)
55 int num_subauth, num_sat, num_saw;
56 struct cifs_sid *cwsid;
61 for (i = 0; i < NUM_WK_SIDS; ++i) {
62 cwsid = &(wksidarr[i].cifssid);
64 /* compare the revision */
65 if (ctsid->revision != cwsid->revision)
68 /* compare all of the six auth values */
69 for (j = 0; j < 6; ++j) {
70 if (ctsid->authority[j] != cwsid->authority[j])
74 continue; /* all of the auth values did not match */
76 /* compare all of the subauth values if any */
77 num_sat = ctsid->num_subauth;
78 num_saw = cwsid->num_subauth;
79 num_subauth = num_sat < num_saw ? num_sat : num_saw;
81 for (j = 0; j < num_subauth; ++j) {
82 if (ctsid->sub_auth[j] != cwsid->sub_auth[j])
86 continue; /* all sub_auth values do not match */
89 cFYI(1, ("matching sid: %s\n", wksidarr[i].sidname));
90 return (0); /* sids compare/match */
93 cFYI(1, ("No matching sid"));
97 /* if the two SIDs (roughly equivalent to a UUID for a user or group) are
98 the same returns 1, if they do not match returns 0 */
99 int compare_sids(const struct cifs_sid *ctsid, const struct cifs_sid *cwsid)
102 int num_subauth, num_sat, num_saw;
104 if ((!ctsid) || (!cwsid))
107 /* compare the revision */
108 if (ctsid->revision != cwsid->revision)
111 /* compare all of the six auth values */
112 for (i = 0; i < 6; ++i) {
113 if (ctsid->authority[i] != cwsid->authority[i])
117 /* compare all of the subauth values if any */
118 num_sat = ctsid->num_subauth;
119 num_saw = cwsid->num_subauth;
120 num_subauth = num_sat < num_saw ? num_sat : num_saw;
122 for (i = 0; i < num_subauth; ++i) {
123 if (ctsid->sub_auth[i] != cwsid->sub_auth[i])
128 return (1); /* sids compare/match */
132 /* copy ntsd, owner sid, and group sid from a security descriptor to another */
133 static void copy_sec_desc(const struct cifs_ntsd *pntsd,
134 struct cifs_ntsd *pnntsd, __u32 sidsoffset)
138 struct cifs_sid *owner_sid_ptr, *group_sid_ptr;
139 struct cifs_sid *nowner_sid_ptr, *ngroup_sid_ptr;
141 /* copy security descriptor control portion */
142 pnntsd->revision = pntsd->revision;
143 pnntsd->type = pntsd->type;
144 pnntsd->dacloffset = cpu_to_le32(sizeof(struct cifs_ntsd));
145 pnntsd->sacloffset = 0;
146 pnntsd->osidoffset = cpu_to_le32(sidsoffset);
147 pnntsd->gsidoffset = cpu_to_le32(sidsoffset + sizeof(struct cifs_sid));
150 owner_sid_ptr = (struct cifs_sid *)((char *)pntsd +
151 le32_to_cpu(pntsd->osidoffset));
152 nowner_sid_ptr = (struct cifs_sid *)((char *)pnntsd + sidsoffset);
154 nowner_sid_ptr->revision = owner_sid_ptr->revision;
155 nowner_sid_ptr->num_subauth = owner_sid_ptr->num_subauth;
156 for (i = 0; i < 6; i++)
157 nowner_sid_ptr->authority[i] = owner_sid_ptr->authority[i];
158 for (i = 0; i < 5; i++)
159 nowner_sid_ptr->sub_auth[i] = owner_sid_ptr->sub_auth[i];
162 group_sid_ptr = (struct cifs_sid *)((char *)pntsd +
163 le32_to_cpu(pntsd->gsidoffset));
164 ngroup_sid_ptr = (struct cifs_sid *)((char *)pnntsd + sidsoffset +
165 sizeof(struct cifs_sid));
167 ngroup_sid_ptr->revision = group_sid_ptr->revision;
168 ngroup_sid_ptr->num_subauth = group_sid_ptr->num_subauth;
169 for (i = 0; i < 6; i++)
170 ngroup_sid_ptr->authority[i] = group_sid_ptr->authority[i];
171 for (i = 0; i < 5; i++)
172 ngroup_sid_ptr->sub_auth[i] =
173 cpu_to_le32(group_sid_ptr->sub_auth[i]);
180 change posix mode to reflect permissions
181 pmode is the existing mode (we only want to overwrite part of this
182 bits to set can be: S_IRWXU, S_IRWXG or S_IRWXO ie 00700 or 00070 or 00007
184 static void access_flags_to_mode(__le32 ace_flags, int type, umode_t *pmode,
185 umode_t *pbits_to_set)
187 __u32 flags = le32_to_cpu(ace_flags);
188 /* the order of ACEs is important. The canonical order is to begin with
189 DENY entries followed by ALLOW, otherwise an allow entry could be
190 encountered first, making the subsequent deny entry like "dead code"
191 which would be superflous since Windows stops when a match is made
192 for the operation you are trying to perform for your user */
194 /* For deny ACEs we change the mask so that subsequent allow access
195 control entries do not turn on the bits we are denying */
196 if (type == ACCESS_DENIED) {
197 if (flags & GENERIC_ALL)
198 *pbits_to_set &= ~S_IRWXUGO;
200 if ((flags & GENERIC_WRITE) ||
201 ((flags & FILE_WRITE_RIGHTS) == FILE_WRITE_RIGHTS))
202 *pbits_to_set &= ~S_IWUGO;
203 if ((flags & GENERIC_READ) ||
204 ((flags & FILE_READ_RIGHTS) == FILE_READ_RIGHTS))
205 *pbits_to_set &= ~S_IRUGO;
206 if ((flags & GENERIC_EXECUTE) ||
207 ((flags & FILE_EXEC_RIGHTS) == FILE_EXEC_RIGHTS))
208 *pbits_to_set &= ~S_IXUGO;
210 } else if (type != ACCESS_ALLOWED) {
211 cERROR(1, ("unknown access control type %d", type));
214 /* else ACCESS_ALLOWED type */
216 if (flags & GENERIC_ALL) {
217 *pmode |= (S_IRWXUGO & (*pbits_to_set));
218 cFYI(DBG2, ("all perms"));
221 if ((flags & GENERIC_WRITE) ||
222 ((flags & FILE_WRITE_RIGHTS) == FILE_WRITE_RIGHTS))
223 *pmode |= (S_IWUGO & (*pbits_to_set));
224 if ((flags & GENERIC_READ) ||
225 ((flags & FILE_READ_RIGHTS) == FILE_READ_RIGHTS))
226 *pmode |= (S_IRUGO & (*pbits_to_set));
227 if ((flags & GENERIC_EXECUTE) ||
228 ((flags & FILE_EXEC_RIGHTS) == FILE_EXEC_RIGHTS))
229 *pmode |= (S_IXUGO & (*pbits_to_set));
231 cFYI(DBG2, ("access flags 0x%x mode now 0x%x", flags, *pmode));
236 Generate access flags to reflect permissions mode is the existing mode.
237 This function is called for every ACE in the DACL whose SID matches
238 with either owner or group or everyone.
241 static void mode_to_access_flags(umode_t mode, umode_t bits_to_use,
244 /* reset access mask */
247 /* bits to use are either S_IRWXU or S_IRWXG or S_IRWXO */
250 /* check for R/W/X UGO since we do not know whose flags
251 is this but we have cleared all the bits sans RWX for
252 either user or group or other as per bits_to_use */
254 *pace_flags |= SET_FILE_READ_RIGHTS;
256 *pace_flags |= SET_FILE_WRITE_RIGHTS;
258 *pace_flags |= SET_FILE_EXEC_RIGHTS;
260 cFYI(DBG2, ("mode: 0x%x, access flags now 0x%x", mode, *pace_flags));
264 static __le16 fill_ace_for_sid(struct cifs_ace *pntace,
265 const struct cifs_sid *psid, __u64 nmode, umode_t bits)
269 __u32 access_req = 0;
271 pntace->type = ACCESS_ALLOWED;
273 mode_to_access_flags(nmode, bits, &access_req);
275 access_req = SET_MINIMUM_RIGHTS;
276 pntace->access_req = cpu_to_le32(access_req);
278 pntace->sid.revision = psid->revision;
279 pntace->sid.num_subauth = psid->num_subauth;
280 for (i = 0; i < 6; i++)
281 pntace->sid.authority[i] = psid->authority[i];
282 for (i = 0; i < psid->num_subauth; i++)
283 pntace->sid.sub_auth[i] = psid->sub_auth[i];
285 size = 1 + 1 + 2 + 4 + 1 + 1 + 6 + (psid->num_subauth * 4);
286 pntace->size = cpu_to_le16(size);
292 #ifdef CONFIG_CIFS_DEBUG2
293 static void dump_ace(struct cifs_ace *pace, char *end_of_acl)
297 /* validate that we do not go past end of acl */
299 if (le16_to_cpu(pace->size) < 16) {
300 cERROR(1, ("ACE too small, %d", le16_to_cpu(pace->size)));
304 if (end_of_acl < (char *)pace + le16_to_cpu(pace->size)) {
305 cERROR(1, ("ACL too small to parse ACE"));
309 num_subauth = pace->sid.num_subauth;
312 cFYI(1, ("ACE revision %d num_auth %d type %d flags %d size %d",
313 pace->sid.revision, pace->sid.num_subauth, pace->type,
314 pace->flags, le16_to_cpu(pace->size)));
315 for (i = 0; i < num_subauth; ++i) {
316 cFYI(1, ("ACE sub_auth[%d]: 0x%x", i,
317 le32_to_cpu(pace->sid.sub_auth[i])));
320 /* BB add length check to make sure that we do not have huge
321 num auths and therefore go off the end */
329 static void parse_dacl(struct cifs_acl *pdacl, char *end_of_acl,
330 struct cifs_sid *pownersid, struct cifs_sid *pgrpsid,
337 struct cifs_ace **ppace;
339 /* BB need to add parm so we can store the SID BB */
342 /* no DACL in the security descriptor, set
343 all the permissions for user/group/other */
344 inode->i_mode |= S_IRWXUGO;
348 /* validate that we do not go past end of acl */
349 if (end_of_acl < (char *)pdacl + le16_to_cpu(pdacl->size)) {
350 cERROR(1, ("ACL too small to parse DACL"));
354 cFYI(DBG2, ("DACL revision %d size %d num aces %d",
355 le16_to_cpu(pdacl->revision), le16_to_cpu(pdacl->size),
356 le32_to_cpu(pdacl->num_aces)));
358 /* reset rwx permissions for user/group/other.
359 Also, if num_aces is 0 i.e. DACL has no ACEs,
360 user/group/other have no permissions */
361 inode->i_mode &= ~(S_IRWXUGO);
363 acl_base = (char *)pdacl;
364 acl_size = sizeof(struct cifs_acl);
366 num_aces = le32_to_cpu(pdacl->num_aces);
368 umode_t user_mask = S_IRWXU;
369 umode_t group_mask = S_IRWXG;
370 umode_t other_mask = S_IRWXO;
372 ppace = kmalloc(num_aces * sizeof(struct cifs_ace *),
375 for (i = 0; i < num_aces; ++i) {
376 ppace[i] = (struct cifs_ace *) (acl_base + acl_size);
377 #ifdef CONFIG_CIFS_DEBUG2
378 dump_ace(ppace[i], end_of_acl);
380 if (compare_sids(&(ppace[i]->sid), pownersid))
381 access_flags_to_mode(ppace[i]->access_req,
385 if (compare_sids(&(ppace[i]->sid), pgrpsid))
386 access_flags_to_mode(ppace[i]->access_req,
390 if (compare_sids(&(ppace[i]->sid), &sid_everyone))
391 access_flags_to_mode(ppace[i]->access_req,
396 /* memcpy((void *)(&(cifscred->aces[i])),
398 sizeof(struct cifs_ace)); */
400 acl_base = (char *)ppace[i];
401 acl_size = le16_to_cpu(ppace[i]->size);
411 static int set_chmod_dacl(struct cifs_acl *pndacl, struct cifs_sid *pownersid,
412 struct cifs_sid *pgrpsid, __u64 nmode)
415 struct cifs_acl *pnndacl;
417 pnndacl = (struct cifs_acl *)((char *)pndacl + sizeof(struct cifs_acl));
419 size += fill_ace_for_sid((struct cifs_ace *) ((char *)pnndacl + size),
420 pownersid, nmode, S_IRWXU);
421 size += fill_ace_for_sid((struct cifs_ace *)((char *)pnndacl + size),
422 pgrpsid, nmode, S_IRWXG);
423 size += fill_ace_for_sid((struct cifs_ace *)((char *)pnndacl + size),
424 &sid_everyone, nmode, S_IRWXO);
426 pndacl->size = cpu_to_le16(size + sizeof(struct cifs_acl));
427 pndacl->num_aces = cpu_to_le32(3);
433 static int parse_sid(struct cifs_sid *psid, char *end_of_acl)
435 /* BB need to add parm so we can store the SID BB */
437 /* validate that we do not go past end of ACL - sid must be at least 8
438 bytes long (assuming no sub-auths - e.g. the null SID */
439 if (end_of_acl < (char *)psid + 8) {
440 cERROR(1, ("ACL too small to parse SID %p", psid));
444 if (psid->num_subauth) {
445 #ifdef CONFIG_CIFS_DEBUG2
447 cFYI(1, ("SID revision %d num_auth %d",
448 psid->revision, psid->num_subauth));
450 for (i = 0; i < psid->num_subauth; i++) {
451 cFYI(1, ("SID sub_auth[%d]: 0x%x ", i,
452 le32_to_cpu(psid->sub_auth[i])));
455 /* BB add length check to make sure that we do not have huge
456 num auths and therefore go off the end */
458 le32_to_cpu(psid->sub_auth[psid->num_subauth-1])));
466 /* Convert CIFS ACL to POSIX form */
467 static int parse_sec_desc(struct cifs_ntsd *pntsd, int acl_len,
471 struct cifs_sid *owner_sid_ptr, *group_sid_ptr;
472 struct cifs_acl *dacl_ptr; /* no need for SACL ptr */
473 char *end_of_acl = ((char *)pntsd) + acl_len;
476 if ((inode == NULL) || (pntsd == NULL))
479 owner_sid_ptr = (struct cifs_sid *)((char *)pntsd +
480 le32_to_cpu(pntsd->osidoffset));
481 group_sid_ptr = (struct cifs_sid *)((char *)pntsd +
482 le32_to_cpu(pntsd->gsidoffset));
483 dacloffset = le32_to_cpu(pntsd->dacloffset);
484 dacl_ptr = (struct cifs_acl *)((char *)pntsd + dacloffset);
485 cFYI(DBG2, ("revision %d type 0x%x ooffset 0x%x goffset 0x%x "
486 "sacloffset 0x%x dacloffset 0x%x",
487 pntsd->revision, pntsd->type, le32_to_cpu(pntsd->osidoffset),
488 le32_to_cpu(pntsd->gsidoffset),
489 le32_to_cpu(pntsd->sacloffset), dacloffset));
490 /* cifs_dump_mem("owner_sid: ", owner_sid_ptr, 64); */
491 rc = parse_sid(owner_sid_ptr, end_of_acl);
495 rc = parse_sid(group_sid_ptr, end_of_acl);
500 parse_dacl(dacl_ptr, end_of_acl, owner_sid_ptr,
501 group_sid_ptr, inode);
503 cFYI(1, ("no ACL")); /* BB grant all or default perms? */
505 /* cifscred->uid = owner_sid_ptr->rid;
506 cifscred->gid = group_sid_ptr->rid;
507 memcpy((void *)(&(cifscred->osid)), (void *)owner_sid_ptr,
508 sizeof(struct cifs_sid));
509 memcpy((void *)(&(cifscred->gsid)), (void *)group_sid_ptr,
510 sizeof(struct cifs_sid)); */
517 /* Convert permission bits from mode to equivalent CIFS ACL */
518 static int build_sec_desc(struct cifs_ntsd *pntsd, struct cifs_ntsd *pnntsd,
519 int acl_len, struct inode *inode, __u64 nmode)
525 struct cifs_sid *owner_sid_ptr, *group_sid_ptr;
526 struct cifs_acl *dacl_ptr = NULL; /* no need for SACL ptr */
527 struct cifs_acl *ndacl_ptr = NULL; /* no need for SACL ptr */
529 if ((inode == NULL) || (pntsd == NULL) || (pnntsd == NULL))
532 owner_sid_ptr = (struct cifs_sid *)((char *)pntsd +
533 le32_to_cpu(pntsd->osidoffset));
534 group_sid_ptr = (struct cifs_sid *)((char *)pntsd +
535 le32_to_cpu(pntsd->gsidoffset));
537 dacloffset = le32_to_cpu(pntsd->dacloffset);
538 dacl_ptr = (struct cifs_acl *)((char *)pntsd + dacloffset);
540 ndacloffset = sizeof(struct cifs_ntsd);
541 ndacl_ptr = (struct cifs_acl *)((char *)pnntsd + ndacloffset);
542 ndacl_ptr->revision = dacl_ptr->revision;
544 ndacl_ptr->num_aces = 0;
546 rc = set_chmod_dacl(ndacl_ptr, owner_sid_ptr, group_sid_ptr, nmode);
548 sidsoffset = ndacloffset + le16_to_cpu(ndacl_ptr->size);
550 /* copy security descriptor control portion and owner and group sid */
551 copy_sec_desc(pntsd, pnntsd, sidsoffset);
557 /* Retrieve an ACL from the server */
558 static struct cifs_ntsd *get_cifs_acl(u32 *pacllen, struct inode *inode,
559 const char *path, const __u16 *pfid)
561 struct cifsFileInfo *open_file = NULL;
562 int unlock_file = FALSE;
566 struct super_block *sb;
567 struct cifs_sb_info *cifs_sb;
568 struct cifs_ntsd *pntsd = NULL;
570 cFYI(1, ("get mode from ACL for %s", path));
577 open_file = find_readable_file(CIFS_I(inode));
586 cifs_sb = CIFS_SB(sb);
590 fid = open_file->netfid;
591 } else if (pfid == NULL) {
594 rc = CIFSSMBOpen(xid, cifs_sb->tcon, path, FILE_OPEN,
595 READ_CONTROL, 0, &fid, &oplock, NULL,
596 cifs_sb->local_nls, cifs_sb->mnt_cifs_flags &
597 CIFS_MOUNT_MAP_SPECIAL_CHR);
599 cERROR(1, ("Unable to open file to get ACL"));
605 rc = CIFSSMBGetCIFSACL(xid, cifs_sb->tcon, fid, &pntsd, pacllen);
606 cFYI(1, ("GetCIFSACL rc = %d ACL len %d", rc, *pacllen));
607 if (unlock_file == TRUE) /* find_readable_file increments ref count */
608 atomic_dec(&open_file->wrtPending);
609 else if (pfid == NULL) /* if opened above we have to close the handle */
610 CIFSSMBClose(xid, cifs_sb->tcon, fid);
611 /* else handle was passed in by caller */
617 /* Set an ACL on the server */
618 static int set_cifs_acl(struct cifs_ntsd *pnntsd, __u32 acllen,
619 struct inode *inode, const char *path)
621 struct cifsFileInfo *open_file;
622 int unlock_file = FALSE;
626 struct super_block *sb;
627 struct cifs_sb_info *cifs_sb;
629 cFYI(DBG2, ("set ACL for %s from mode 0x%x", path, inode->i_mode));
638 cifs_sb = CIFS_SB(sb);
641 open_file = find_readable_file(CIFS_I(inode));
644 fid = open_file->netfid;
648 rc = CIFSSMBOpen(xid, cifs_sb->tcon, path, FILE_OPEN,
649 WRITE_DAC, 0, &fid, &oplock, NULL,
650 cifs_sb->local_nls, cifs_sb->mnt_cifs_flags &
651 CIFS_MOUNT_MAP_SPECIAL_CHR);
653 cERROR(1, ("Unable to open file to set ACL"));
659 rc = CIFSSMBSetCIFSACL(xid, cifs_sb->tcon, fid, pnntsd, acllen);
660 cFYI(DBG2, ("SetCIFSACL rc = %d", rc));
661 if (unlock_file == TRUE)
662 atomic_dec(&open_file->wrtPending);
664 CIFSSMBClose(xid, cifs_sb->tcon, fid);
671 /* Translate the CIFS ACL (simlar to NTFS ACL) for a file into mode bits */
672 void acl_to_uid_mode(struct inode *inode, const char *path, const __u16 *pfid)
674 struct cifs_ntsd *pntsd = NULL;
678 cFYI(DBG2, ("converting ACL to mode for %s", path));
679 pntsd = get_cifs_acl(&acllen, inode, path, pfid);
681 /* if we can retrieve the ACL, now parse Access Control Entries, ACEs */
683 rc = parse_sec_desc(pntsd, acllen, inode);
685 cFYI(1, ("parse sec desc failed rc = %d", rc));
691 /* Convert mode bits to an ACL so we can update the ACL on the server */
692 int mode_to_acl(struct inode *inode, const char *path, __u64 nmode)
696 struct cifs_ntsd *pntsd = NULL; /* acl obtained from server */
697 struct cifs_ntsd *pnntsd = NULL; /* modified acl to be sent to server */
699 cFYI(DBG2, ("set ACL from mode for %s", path));
701 /* Get the security descriptor */
702 pntsd = get_cifs_acl(&acllen, inode, path, NULL);
704 /* Add three ACEs for owner, group, everyone getting rid of
705 other ACEs as chmod disables ACEs and set the security descriptor */
708 /* allocate memory for the smb header,
709 set security descriptor request security descriptor
710 parameters, and secuirty descriptor itself */
712 pnntsd = kmalloc(acllen, GFP_KERNEL);
714 cERROR(1, ("Unable to allocate security descriptor"));
719 rc = build_sec_desc(pntsd, pnntsd, acllen, inode, nmode);
721 cFYI(DBG2, ("build_sec_desc rc: %d", rc));
724 /* Set the security descriptor */
725 rc = set_cifs_acl(pnntsd, acllen, inode, path);
726 cFYI(DBG2, ("set_cifs_acl rc: %d", rc));
735 #endif /* CONFIG_CIFS_EXPERIMENTAL */