kernel/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/mount.h>
  17 #include <linux/namei.h>
  18 #include <linux/nsproxy.h>
  19 #include <linux/path.h>
  20 #include <linux/sched.h>
  21 #include <linux/slab.h>
  22 #include <linux/fs_struct.h>
  23
  24 #include "include/apparmor.h"
  25 #include "include/path.h"
  26 #include "include/policy.h"
  27
  28
  29 /* modified from dcache.c */
  30 static int prepend(char **buffer, int buflen, const char *str, int namelen)
  31 {
  32         buflen -= namelen;
  33         if (buflen < 0)
  34                 return -ENAMETOOLONG;
  35         *buffer -= namelen;
  36         memcpy(*buffer, str, namelen);
  37         return 0;
  38 }
  39
  40 #define CHROOT_NSCONNECT (PATH_CHROOT_REL | PATH_CHROOT_NSCONNECT)
  41
  42 /**
  43  * d_namespace_path - lookup a name associated with a given path
  44  * @path: path to lookup  (NOT NULL)
  45  * @buf:  buffer to store path to  (NOT NULL)
  46  * @buflen: length of @buf
  47  * @name: Returns - pointer for start of path name with in @buf (NOT NULL)
  48  * @flags: flags controlling path lookup
  49  *
  50  * Handle path name lookup.
  51  *
  52  * Returns: %0 else error code if path lookup fails
  53  *          When no error the path name is returned in @name which points to
  54  *          to a position in @buf
  55  */
  56 static int d_namespace_path(struct path *path, char *buf, int buflen,
  57                             char **name, int flags)
  58 {
  59         char *res;
  60         int error = 0;
  61         int connected = 1;
  62
  63         if (path->mnt->mnt_flags & MNT_INTERNAL) {
  64                 /* it's not mounted anywhere */
  65                 res = dentry_path(path->dentry, buf, buflen);
  66                 *name = res;
  67                 if (IS_ERR(res)) {
  68                         *name = buf;
  69                         return PTR_ERR(res);
  70                 }
  71                 if (path->dentry->d_sb->s_magic == PROC_SUPER_MAGIC &&
  72                     strncmp(*name, "/sys/", 5) == 0) {
  73                         /* TODO: convert over to using a per namespace
  74                          * control instead of hard coded /proc
  75                          */
  76                         return prepend(name, *name - buf, "/proc", 5);
  77                 }
  78                 return 0;
  79         }
  80
  81         /* resolve paths relative to chroot?*/
  82         if (flags & PATH_CHROOT_REL) {
  83                 struct path root;
  84                 get_fs_root(current->fs, &root);
  85                 res = __d_path(path, &root, buf, buflen);
  86                 path_put(&root);
  87         } else {
  88                 res = d_absolute_path(path, buf, buflen);
  89                 if (!our_mnt(path->mnt))
  90                         connected = 0;
  91         }
  92
  93         /* handle error conditions - and still allow a partial path to
  94          * be returned.
  95          */
  96         if (!res || IS_ERR(res)) {
  97                 if (PTR_ERR(res) == -ENAMETOOLONG)
  98                         return -ENAMETOOLONG;
  99                 connected = 0;
 100                 res = dentry_path_raw(path->dentry, buf, buflen);
 101                 if (IS_ERR(res)) {
 102                         error = PTR_ERR(res);
 103                         *name = buf;
 104                         goto out;
 105                 };
 106         } else if (!our_mnt(path->mnt))
 107                 connected = 0;
 108
 109         *name = res;
 110
 111         /* Handle two cases:
 112          * 1. A deleted dentry && profile is not allowing mediation of deleted
 113          * 2. On some filesystems, newly allocated dentries appear to the
 114          *    security_path hooks as a deleted dentry except without an inode
 115          *    allocated.
 116          */
 117         if (d_unlinked(path->dentry) && d_is_positive(path->dentry) &&
 118             !(flags & PATH_MEDIATE_DELETED)) {
 119                         error = -ENOENT;
 120                         goto out;
 121         }
 122
 123         /* If the path is not connected to the expected root,
 124          * check if it is a sysctl and handle specially else remove any
 125          * leading / that __d_path may have returned.
 126          * Unless
 127          *     specifically directed to connect the path,
 128          * OR
 129          *     if in a chroot and doing chroot relative paths and the path
 130          *     resolves to the namespace root (would be connected outside
 131          *     of chroot) and specifically directed to connect paths to
 132          *     namespace root.
 133          */
 134         if (!connected) {
 135                 if (!(flags & PATH_CONNECT_PATH) &&
 136                            !(((flags & CHROOT_NSCONNECT) == CHROOT_NSCONNECT) &&
 137                              our_mnt(path->mnt))) {
 138                         /* disconnected path, don't return pathname starting
 139                          * with '/'
 140                          */
 141                         error = -EACCES;
 142                         if (*res == '/')
 143                                 *name = res + 1;
 144                 }
 145         }
 146
 147 out:
 148         return error;
 149 }
 150
 151 /**
 152  * get_name_to_buffer - get the pathname to a buffer ensure dir / is appended
 153  * @path: path to get name for  (NOT NULL)
 154  * @flags: flags controlling path lookup
 155  * @buffer: buffer to put name in  (NOT NULL)
 156  * @size: size of buffer
 157  * @name: Returns - contains position of path name in @buffer (NOT NULL)
 158  *
 159  * Returns: %0 else error on failure
 160  */
 161 static int get_name_to_buffer(struct path *path, int flags, char *buffer,
 162                               int size, char **name, const char **info)
 163 {
 164         int adjust = (flags & PATH_IS_DIR) ? 1 : 0;
 165         int error = d_namespace_path(path, buffer, size - adjust, name, flags);
 166
 167         if (!error && (flags & PATH_IS_DIR) && (*name)[1] != '\0')
 168                 /*
 169                  * Append "/" to the pathname.  The root directory is a special
 170                  * case; it already ends in slash.
 171                  */
 172                 strcpy(&buffer[size - 2], "/");
 173
 174         if (info && error) {
 175                 if (error == -ENOENT)
 176                         *info = "Failed name lookup - deleted entry";
 177                 else if (error == -EACCES)
 178                         *info = "Failed name lookup - disconnected path";
 179                 else if (error == -ENAMETOOLONG)
 180                         *info = "Failed name lookup - name too long";
 181                 else
 182                         *info = "Failed name lookup";
 183         }
 184
 185         return error;
 186 }
 187
 188 /**
 189  * aa_path_name - compute the pathname of a file
 190  * @path: path the file  (NOT NULL)
 191  * @flags: flags controlling path name generation
 192  * @buffer: buffer that aa_get_name() allocated  (NOT NULL)
 193  * @name: Returns - the generated path name if !error (NOT NULL)
 194  * @info: Returns - information on why the path lookup failed (MAYBE NULL)
 195  *
 196  * @name is a pointer to the beginning of the pathname (which usually differs
 197  * from the beginning of the buffer), or NULL.  If there is an error @name
 198  * may contain a partial or invalid name that can be used for audit purposes,
 199  * but it can not be used for mediation.
 200  *
 201  * We need PATH_IS_DIR to indicate whether the file is a directory or not
 202  * because the file may not yet exist, and so we cannot check the inode's
 203  * file type.
 204  *
 205  * Returns: %0 else error code if could retrieve name
 206  */
 207 int aa_path_name(struct path *path, int flags, char **buffer, const char **name,
 208                  const char **info)
 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, info);
 223                 if (error != -ENAMETOOLONG)
 224                         break;
 225
 226                 kfree(buf);
 227                 size <<= 1;
 228                 if (size > aa_g_path_max)
 229                         return -ENAMETOOLONG;
 230                 *info = NULL;
 231         }
 232         *buffer = buf;
 233         *name = str;
 234
 235         return error;
 236 }