2 Unix SMB/CIFS implementation.
3 Check access to files based on security descriptors.
4 Copyright (C) Jeremy Allison 2005-2006.
5 Copyright (C) Michael Adam 2007.
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 3 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, see <http://www.gnu.org/licenses/>.
24 #define DBGC_CLASS DBGC_ACLS
27 * Security descriptor / NT Token level access check function.
29 bool can_access_file_acl(struct connection_struct *conn,
34 uint32_t access_granted;
35 struct security_descriptor *secdesc = NULL;
37 status = SMB_VFS_GET_NT_ACL(conn, fname,
38 (OWNER_SECURITY_INFORMATION |
39 GROUP_SECURITY_INFORMATION |
40 DACL_SECURITY_INFORMATION),
42 if (!NT_STATUS_IS_OK(status)) {
43 DEBUG(5, ("Could not get acl: %s\n", nt_errstr(status)));
47 status = se_access_check(secdesc, conn->server_info->ptok,
48 access_mask, &access_granted);
50 return NT_STATUS_IS_OK(status);
53 /****************************************************************************
54 Actually emulate the in-kernel access checking for delete access. We need
55 this to successfully return ACCESS_DENIED on a file open for delete access.
56 ****************************************************************************/
58 bool can_delete_file_in_directory(connection_struct *conn, const char *fname)
61 TALLOC_CTX *ctx = talloc_tos();
64 if (!CAN_WRITE(conn)) {
68 /* Get the parent directory permission mask and owners. */
69 if (!parent_dirname_talloc(ctx,
75 if(SMB_VFS_STAT(conn, dname, &sbuf) != 0) {
79 /* fast paths first */
81 if (!S_ISDIR(sbuf.st_mode)) {
84 if (conn->server_info->utok.uid == 0 || conn->admin_user) {
85 /* I'm sorry sir, I didn't know you were root... */
90 /* sticky bit means delete only by owner or root. */
91 if (sbuf.st_mode & S_ISVTX) {
92 SMB_STRUCT_STAT sbuf_file;
93 if(SMB_VFS_STAT(conn, fname, &sbuf_file) != 0) {
94 if (errno == ENOENT) {
95 /* If the file doesn't already exist then
96 * yes we'll be able to delete it. */
102 * Patch from SATOH Fumiyasu <fumiyas@miraclelinux.com>
103 * for bug #3348. Don't assume owning sticky bit
104 * directory means write access allowed.
106 if (conn->server_info->utok.uid != sbuf_file.st_uid) {
112 /* now for ACL checks */
115 * There's two ways to get the permission to delete a file: First by
116 * having the DELETE bit on the file itself and second if that does
117 * not help, by the DELETE_CHILD bit on the containing directory.
119 * Here we only check the directory permissions, we will
120 * check the file DELETE permission separately.
123 return can_access_file_acl(conn, dname, FILE_DELETE_CHILD);
126 /****************************************************************************
127 Actually emulate the in-kernel access checking for read/write access. We need
128 this to successfully check for ability to write for dos filetimes.
129 Note this doesn't take into account share write permissions.
130 ****************************************************************************/
132 bool can_access_file_data(connection_struct *conn, const char *fname, SMB_STRUCT_STAT *psbuf, uint32 access_mask)
134 if (!(access_mask & (FILE_READ_DATA|FILE_WRITE_DATA))) {
137 access_mask &= (FILE_READ_DATA|FILE_WRITE_DATA);
139 /* some fast paths first */
141 DEBUG(10,("can_access_file_data: requesting 0x%x on file %s\n",
142 (unsigned int)access_mask, fname ));
144 if (conn->server_info->utok.uid == 0 || conn->admin_user) {
145 /* I'm sorry sir, I didn't know you were root... */
149 if (!VALID_STAT(*psbuf)) {
150 /* Get the file permission mask and owners. */
151 if(SMB_VFS_STAT(conn, fname, psbuf) != 0) {
156 /* Check primary owner access. */
157 if (conn->server_info->utok.uid == psbuf->st_uid) {
158 switch (access_mask) {
160 return (psbuf->st_mode & S_IRUSR) ? True : False;
162 case FILE_WRITE_DATA:
163 return (psbuf->st_mode & S_IWUSR) ? True : False;
165 default: /* FILE_READ_DATA|FILE_WRITE_DATA */
167 if ((psbuf->st_mode & (S_IWUSR|S_IRUSR)) == (S_IWUSR|S_IRUSR)) {
175 /* now for ACL checks */
177 return can_access_file_acl(conn, fname, access_mask);
180 /****************************************************************************
181 Userspace check for write access.
182 Note this doesn't take into account share write permissions.
183 ****************************************************************************/
185 bool can_write_to_file(connection_struct *conn, const char *fname, SMB_STRUCT_STAT *psbuf)
187 return can_access_file_data(conn, fname, psbuf, FILE_WRITE_DATA);
190 /****************************************************************************
191 Check for an existing default Windows ACL on a directory.
192 ****************************************************************************/
194 bool directory_has_default_acl(connection_struct *conn, const char *fname)
196 /* returns talloced off tos. */
197 struct security_descriptor *secdesc = NULL;
199 NTSTATUS status = SMB_VFS_GET_NT_ACL(conn, fname,
200 DACL_SECURITY_INFORMATION, &secdesc);
202 if (!NT_STATUS_IS_OK(status) || secdesc == NULL) {
206 for (i = 0; i < secdesc->dacl->num_aces; i++) {
207 struct security_ace *psa = &secdesc->dacl->aces[i];
208 if (psa->flags & (SEC_ACE_FLAG_OBJECT_INHERIT|
209 SEC_ACE_FLAG_CONTAINER_INHERIT)) {
210 TALLOC_FREE(secdesc);
214 TALLOC_FREE(secdesc);