security/apparmor/path.c

   1 /*
   2  * AppArmor security module
   3  *
   4  * This file contains AppArmor function for pathnames
   5  *
   6  * Copyright (C) 1998-2008 Novell/SUSE
   7  * Copyright 2009-2010 Canonical Ltd.
   8  *
   9  * This program is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU General Public License as
  11  * published by the Free Software Foundation, version 2 of the
  12  * License.
  13  */
  14
  15 #include <linux/magic.h>
  16 #include <linux/mnt_namespace.h>
  17 #include <linux/mount.h>
  18 #include <linux/namei.h>
  19 #include <linux/nsproxy.h>
  20 #include <linux/path.h>
  21 #include <linux/sched.h>
  22 #include <linux/slab.h>
  23 #include <linux/fs_struct.h>
  24
  25 #include "include/apparmor.h"
  26 #include "include/path.h"
  27 #include "include/policy.h"
  28
  29
  30 /* modified from dcache.c */
  31 static int prepend(char **buffer, int buflen, const char *str, int namelen)
  32 {
  33         buflen -= namelen;
  34         if (buflen < 0)
  35                 return -ENAMETOOLONG;
  36         *buffer -= namelen;
  37         memcpy(*buffer, str, namelen);
  38         return 0;
  39 }
  40
  41 #define CHROOT_NSCONNECT (PATH_CHROOT_REL | PATH_CHROOT_NSCONNECT)
  42
  43 /**
  44  * d_namespace_path - lookup a name associated with a given path
  45  * @path: path to lookup  (NOT NULL)
  46  * @buf:  buffer to store path to  (NOT NULL)
  47  * @buflen: length of @buf
  48  * @name: Returns - pointer for start of path name with in @buf (NOT NULL)
  49  * @flags: flags controlling path lookup
  50  *
  51  * Handle path name lookup.
  52  *
  53  * Returns: %0 else error code if path lookup fails
  54  *          When no error the path name is returned in @name which points to
  55  *          to a position in @buf
  56  */
  57 static int d_namespace_path(struct path *path, char *buf, int buflen,
  58                             char **name, int flags)
  59 {
  60         struct path root, tmp;
  61         char *res;
  62         int deleted, connected;
  63         int error = 0;
  64
  65         /* Get the root we want to resolve too */
  66         if (flags & PATH_CHROOT_REL) {
  67                 /* resolve paths relative to chroot */
  68                 read_lock(&current->fs->lock);
  69                 root = current->fs->root;
  70                 /* released below */
  71                 path_get(&root);
  72                 read_unlock(&current->fs->lock);
  73         } else {
  74                 /* resolve paths relative to namespace */
  75                 root.mnt = current->nsproxy->mnt_ns->root;
  76                 root.dentry = root.mnt->mnt_root;
  77                 /* released below */
  78                 path_get(&root);
  79         }
  80
  81         spin_lock(&dcache_lock);
  82         /* There is a race window between path lookup here and the
  83          * need to strip the " (deleted) string that __d_path applies
  84          * Detect the race and relookup the path
  85          *
  86          * The stripping of (deleted) is a hack that could be removed
  87          * with an updated __d_path
  88          */
  89         do {
  90                 tmp = root;
  91                 deleted = d_unlinked(path->dentry);
  92                 res = __d_path(path, &tmp, buf, buflen);
  93
  94         } while (deleted != d_unlinked(path->dentry));
  95         spin_unlock(&dcache_lock);
  96
  97         *name = res;
  98         /* handle error conditions - and still allow a partial path to
  99          * be returned.
 100          */
 101         if (IS_ERR(res)) {
 102                 error = PTR_ERR(res);
 103                 *name = buf;
 104                 goto out;
 105         }
 106         if (deleted) {
 107                 /* On some filesystems, newly allocated dentries appear to the
 108                  * security_path hooks as a deleted dentry except without an
 109                  * inode allocated.
 110                  *
 111                  * Remove the appended deleted text and return as string for
 112                  * normal mediation, or auditing.  The (deleted) string is
 113                  * guaranteed to be added in this case, so just strip it.
 114                  */
 115                 buf[buflen - 11] = 0;   /* - (len(" (deleted)") +\0) */
 116
 117                 if (path->dentry->d_inode && !(flags & PATH_MEDIATE_DELETED)) {
 118                         error = -ENOENT;
 119                         goto out;
 120                 }
 121         }
 122
 123         /* Determine if the path is connected to the expected root */
 124         connected = tmp.dentry == root.dentry && tmp.mnt == root.mnt;
 125
 126         /* If the path is not connected,
 127          * check if it is a sysctl and handle specially else remove any
 128          * leading / that __d_path may have returned.
 129          * Unless
 130          *     specifically directed to connect the path,
 131          * OR
 132          *     if in a chroot and doing chroot relative paths and the path
 133          *     resolves to the namespace root (would be connected outside
 134          *     of chroot) and specifically directed to connect paths to
 135          *     namespace root.
 136          */
 137         if (!connected) {
 138                 /* is the disconnect path a sysctl? */
 139                 if (tmp.dentry->d_sb->s_magic == PROC_SUPER_MAGIC &&
 140                     strncmp(*name, "/sys/", 5) == 0) {
 141                         /* TODO: convert over to using a per namespace
 142                          * control instead of hard coded /proc
 143                          */
 144                         error = prepend(name, *name - buf, "/proc", 5);
 145                 } else if (!(flags & PATH_CONNECT_PATH) &&
 146                            !(((flags & CHROOT_NSCONNECT) == CHROOT_NSCONNECT) &&
 147                              (tmp.mnt == current->nsproxy->mnt_ns->root &&
 148                               tmp.dentry == tmp.mnt->mnt_root))) {
 149                         /* disconnected path, don't return pathname starting
 150                          * with '/'
 151                          */
 152                         error = -ESTALE;
 153                         if (*res == '/')
 154                                 *name = res + 1;
 155                 }
 156         }
 157
 158 out:
 159         path_put(&root);
 160
 161         return error;
 162 }
 163
 164 /**
 165  * get_name_to_buffer - get the pathname to a buffer ensure dir / is appended
 166  * @path: path to get name for  (NOT NULL)
 167  * @flags: flags controlling path lookup
 168  * @buffer: buffer to put name in  (NOT NULL)
 169  * @size: size of buffer
 170  * @name: Returns - contains position of path name in @buffer (NOT NULL)
 171  *
 172  * Returns: %0 else error on failure
 173  */
 174 static int get_name_to_buffer(struct path *path, int flags, char *buffer,
 175                               int size, char **name)
 176 {
 177         int adjust = (flags & PATH_IS_DIR) ? 1 : 0;
 178         int error = d_namespace_path(path, buffer, size - adjust, name, flags);
 179
 180         if (!error && (flags & PATH_IS_DIR) && (*name)[1] != '\0')
 181                 /*
 182                  * Append "/" to the pathname.  The root directory is a special
 183                  * case; it already ends in slash.
 184                  */
 185                 strcpy(&buffer[size - 2], "/");
 186
 187         return error;
 188 }
 189
 190 /**
 191  * aa_get_name - compute the pathname of a file
 192  * @path: path the file  (NOT NULL)
 193  * @flags: flags controlling path name generation
 194  * @buffer: buffer that aa_get_name() allocated  (NOT NULL)
 195  * @name: Returns - the generated path name if !error (NOT NULL)
 196  *
 197  * @name is a pointer to the beginning of the pathname (which usually differs
 198  * from the beginning of the buffer), or NULL.  If there is an error @name
 199  * may contain a partial or invalid name that can be used for audit purposes,
 200  * but it can not be used for mediation.
 201  *
 202  * We need PATH_IS_DIR to indicate whether the file is a directory or not
 203  * because the file may not yet exist, and so we cannot check the inode's
 204  * file type.
 205  *
 206  * Returns: %0 else error code if could retrieve name
 207  */
 208 int aa_get_name(struct path *path, int flags, char **buffer, const char **name)
 209 {
 210         char *buf, *str = NULL;
 211         int size = 256;
 212         int error;
 213
 214         *name = NULL;
 215         *buffer = NULL;
 216         for (;;) {
 217                 /* freed by caller */
 218                 buf = kmalloc(size, GFP_KERNEL);
 219                 if (!buf)
 220                         return -ENOMEM;
 221
 222                 error = get_name_to_buffer(path, flags, buf, size, &str);
 223                 if (error != -ENAMETOOLONG)
 224                         break;
 225
 226                 kfree(buf);
 227                 size <<= 1;
 228                 if (size > aa_g_path_max)
 229                         return -ENAMETOOLONG;
 230         }
 231         *buffer = buf;
 232         *name = str;
 233
 234         return error;
 235 }