2 * AppArmor security module
4 * This file contains AppArmor function for pathnames
6 * Copyright (C) 1998-2008 Novell/SUSE
7 * Copyright 2009-2010 Canonical Ltd.
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
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>
24 #include "include/apparmor.h"
25 #include "include/path.h"
26 #include "include/policy.h"
28 /* modified from dcache.c */
29 static int prepend(char **buffer, int buflen, const char *str, int namelen)
35 memcpy(*buffer, str, namelen);
39 #define CHROOT_NSCONNECT (PATH_CHROOT_REL | PATH_CHROOT_NSCONNECT)
41 /* If the path is not connected to the expected root,
42 * check if it is a sysctl and handle specially else remove any
43 * leading / that __d_path may have returned.
45 * specifically directed to connect the path,
47 * if in a chroot and doing chroot relative paths and the path
48 * resolves to the namespace root (would be connected outside
49 * of chroot) and specifically directed to connect paths to
52 static int disconnect(const struct path *path, char *buf, char **name,
53 int flags, const char *disconnected)
57 if (!(flags & PATH_CONNECT_PATH) &&
58 !(((flags & CHROOT_NSCONNECT) == CHROOT_NSCONNECT) &&
59 our_mnt(path->mnt))) {
60 /* disconnected path, don't return pathname starting
68 /* CONNECT_PATH with missing root */
69 error = prepend(name, *name - buf, "/", 1);
70 if (!error && disconnected)
71 error = prepend(name, *name - buf, disconnected,
72 strlen(disconnected));
79 * d_namespace_path - lookup a name associated with a given path
80 * @path: path to lookup (NOT NULL)
81 * @buf: buffer to store path to (NOT NULL)
82 * @name: Returns - pointer for start of path name with in @buf (NOT NULL)
83 * @flags: flags controlling path lookup
84 * @disconnected: string to prefix to disconnected paths
86 * Handle path name lookup.
88 * Returns: %0 else error code if path lookup fails
89 * When no error the path name is returned in @name which points to
90 * to a position in @buf
92 static int d_namespace_path(const struct path *path, char *buf, char **name,
93 int flags, const char *disconnected)
98 int isdir = (flags & PATH_IS_DIR) ? 1 : 0;
99 int buflen = aa_g_path_max - isdir;
101 if (path->mnt->mnt_flags & MNT_INTERNAL) {
102 /* it's not mounted anywhere */
103 res = dentry_path(path->dentry, buf, buflen);
109 if (path->dentry->d_sb->s_magic == PROC_SUPER_MAGIC &&
110 strncmp(*name, "/sys/", 5) == 0) {
111 /* TODO: convert over to using a per namespace
112 * control instead of hard coded /proc
114 error = prepend(name, *name - buf, "/proc", 5);
117 error = disconnect(path, buf, name, flags,
122 /* resolve paths relative to chroot?*/
123 if (flags & PATH_CHROOT_REL) {
125 get_fs_root(current->fs, &root);
126 res = __d_path(path, &root, buf, buflen);
129 res = d_absolute_path(path, buf, buflen);
130 if (!our_mnt(path->mnt))
134 /* handle error conditions - and still allow a partial path to
137 if (!res || IS_ERR(res)) {
138 if (PTR_ERR(res) == -ENAMETOOLONG) {
139 error = -ENAMETOOLONG;
144 res = dentry_path_raw(path->dentry, buf, buflen);
146 error = PTR_ERR(res);
150 } else if (!our_mnt(path->mnt))
156 error = disconnect(path, buf, name, flags, disconnected);
159 * 1. A deleted dentry && profile is not allowing mediation of deleted
160 * 2. On some filesystems, newly allocated dentries appear to the
161 * security_path hooks as a deleted dentry except without an inode
164 if (d_unlinked(path->dentry) && d_is_positive(path->dentry) &&
165 !(flags & (PATH_MEDIATE_DELETED | PATH_DELEGATE_DELETED))) {
172 * Append "/" to the pathname. The root directory is a special
173 * case; it already ends in slash.
175 if (!error && isdir && ((*name)[1] != '\0' || (*name)[0] != '/'))
176 strcpy(&buf[aa_g_path_max - 2], "/");
182 * aa_path_name - get the pathname to a buffer ensure dir / is appended
183 * @path: path the file (NOT NULL)
184 * @flags: flags controlling path name generation
185 * @buffer: buffer to put name in (NOT NULL)
186 * @name: Returns - the generated path name if !error (NOT NULL)
187 * @info: Returns - information on why the path lookup failed (MAYBE NULL)
188 * @disconnected: string to prepend to disconnected paths
190 * @name is a pointer to the beginning of the pathname (which usually differs
191 * from the beginning of the buffer), or NULL. If there is an error @name
192 * may contain a partial or invalid name that can be used for audit purposes,
193 * but it can not be used for mediation.
195 * We need PATH_IS_DIR to indicate whether the file is a directory or not
196 * because the file may not yet exist, and so we cannot check the inode's
199 * Returns: %0 else error code if could retrieve name
201 int aa_path_name(const struct path *path, int flags, char *buffer,
202 const char **name, const char **info, const char *disconnected)
205 int error = d_namespace_path(path, buffer, &str, flags, disconnected);
208 if (error == -ENOENT)
209 *info = "Failed name lookup - deleted entry";
210 else if (error == -EACCES)
211 *info = "Failed name lookup - disconnected path";
212 else if (error == -ENAMETOOLONG)
213 *info = "Failed name lookup - name too long";
215 *info = "Failed name lookup";