blob: 8f7b41a14882eec85c4ab8e46a9e86f41a0c6c79 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * linux/fs/namei.c
3 *
4 * Copyright (C) 1991, 1992 Linus Torvalds
5 */
6
7/*
8 * Some corrections by tytso.
9 */
10
11/* [Feb 1997 T. Schoebel-Theuer] Complete rewrite of the pathname
12 * lookup logic.
13 */
14/* [Feb-Apr 2000, AV] Rewrite to the new namespace architecture.
15 */
16
17#include <linux/init.h>
18#include <linux/module.h>
19#include <linux/slab.h>
20#include <linux/fs.h>
21#include <linux/namei.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070022#include <linux/pagemap.h>
Robert Love0eeca282005-07-12 17:06:03 -040023#include <linux/fsnotify.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070024#include <linux/personality.h>
25#include <linux/security.h>
Mimi Zohar6146f0d2009-02-04 09:06:57 -050026#include <linux/ima.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070027#include <linux/syscalls.h>
28#include <linux/mount.h>
29#include <linux/audit.h>
Randy Dunlap16f7e0f2006-01-11 12:17:46 -080030#include <linux/capability.h>
Trond Myklebust834f2a42005-10-18 14:20:16 -070031#include <linux/file.h>
Ulrich Drepper5590ff02006-01-18 17:43:53 -080032#include <linux/fcntl.h>
Serge E. Hallyn08ce5f12008-04-29 01:00:10 -070033#include <linux/device_cgroup.h>
Al Viro5ad4e532009-03-29 19:50:06 -040034#include <linux/fs_struct.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070035#include <asm/uaccess.h>
36
Eric Parise81e3f42009-12-04 15:47:36 -050037#include "internal.h"
38
Linus Torvalds1da177e2005-04-16 15:20:36 -070039/* [Feb-1997 T. Schoebel-Theuer]
40 * Fundamental changes in the pathname lookup mechanisms (namei)
41 * were necessary because of omirr. The reason is that omirr needs
42 * to know the _real_ pathname, not the user-supplied one, in case
43 * of symlinks (and also when transname replacements occur).
44 *
45 * The new code replaces the old recursive symlink resolution with
46 * an iterative one (in case of non-nested symlink chains). It does
47 * this with calls to <fs>_follow_link().
48 * As a side effect, dir_namei(), _namei() and follow_link() are now
49 * replaced with a single function lookup_dentry() that can handle all
50 * the special cases of the former code.
51 *
52 * With the new dcache, the pathname is stored at each inode, at least as
53 * long as the refcount of the inode is positive. As a side effect, the
54 * size of the dcache depends on the inode cache and thus is dynamic.
55 *
56 * [29-Apr-1998 C. Scott Ananian] Updated above description of symlink
57 * resolution to correspond with current state of the code.
58 *
59 * Note that the symlink resolution is not *completely* iterative.
60 * There is still a significant amount of tail- and mid- recursion in
61 * the algorithm. Also, note that <fs>_readlink() is not used in
62 * lookup_dentry(): lookup_dentry() on the result of <fs>_readlink()
63 * may return different results than <fs>_follow_link(). Many virtual
64 * filesystems (including /proc) exhibit this behavior.
65 */
66
67/* [24-Feb-97 T. Schoebel-Theuer] Side effects caused by new implementation:
68 * New symlink semantics: when open() is called with flags O_CREAT | O_EXCL
69 * and the name already exists in form of a symlink, try to create the new
70 * name indicated by the symlink. The old code always complained that the
71 * name already exists, due to not following the symlink even if its target
72 * is nonexistent. The new semantics affects also mknod() and link() when
73 * the name is a symlink pointing to a non-existant name.
74 *
75 * I don't know which semantics is the right one, since I have no access
76 * to standards. But I found by trial that HP-UX 9.0 has the full "new"
77 * semantics implemented, while SunOS 4.1.1 and Solaris (SunOS 5.4) have the
78 * "old" one. Personally, I think the new semantics is much more logical.
79 * Note that "ln old new" where "new" is a symlink pointing to a non-existing
80 * file does succeed in both HP-UX and SunOs, but not in Solaris
81 * and in the old Linux semantics.
82 */
83
84/* [16-Dec-97 Kevin Buhr] For security reasons, we change some symlink
85 * semantics. See the comments in "open_namei" and "do_link" below.
86 *
87 * [10-Sep-98 Alan Modra] Another symlink change.
88 */
89
90/* [Feb-Apr 2000 AV] Complete rewrite. Rules for symlinks:
91 * inside the path - always follow.
92 * in the last component in creation/removal/renaming - never follow.
93 * if LOOKUP_FOLLOW passed - follow.
94 * if the pathname has trailing slashes - follow.
95 * otherwise - don't follow.
96 * (applied in that order).
97 *
98 * [Jun 2000 AV] Inconsistent behaviour of open() in case if flags==O_CREAT
99 * restored for 2.4. This is the last surviving part of old 4.2BSD bug.
100 * During the 2.4 we need to fix the userland stuff depending on it -
101 * hopefully we will be able to get rid of that wart in 2.5. So far only
102 * XEmacs seems to be relying on it...
103 */
104/*
105 * [Sep 2001 AV] Single-semaphore locking scheme (kudos to David Holland)
Arjan van de Vena11f3a02006-03-23 03:00:33 -0800106 * implemented. Let's see if raised priority of ->s_vfs_rename_mutex gives
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107 * any extra contention...
108 */
109
110/* In order to reduce some races, while at the same time doing additional
111 * checking and hopefully speeding things up, we copy filenames to the
112 * kernel data space before using them..
113 *
114 * POSIX.1 2.4: an empty pathname is invalid (ENOENT).
115 * PATH_MAX includes the nul terminator --RR.
116 */
Arjan van de Ven858119e2006-01-14 13:20:43 -0800117static int do_getname(const char __user *filename, char *page)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700118{
119 int retval;
120 unsigned long len = PATH_MAX;
121
122 if (!segment_eq(get_fs(), KERNEL_DS)) {
123 if ((unsigned long) filename >= TASK_SIZE)
124 return -EFAULT;
125 if (TASK_SIZE - (unsigned long) filename < PATH_MAX)
126 len = TASK_SIZE - (unsigned long) filename;
127 }
128
129 retval = strncpy_from_user(page, filename, len);
130 if (retval > 0) {
131 if (retval < len)
132 return 0;
133 return -ENAMETOOLONG;
134 } else if (!retval)
135 retval = -ENOENT;
136 return retval;
137}
138
139char * getname(const char __user * filename)
140{
141 char *tmp, *result;
142
143 result = ERR_PTR(-ENOMEM);
144 tmp = __getname();
145 if (tmp) {
146 int retval = do_getname(filename, tmp);
147
148 result = tmp;
149 if (retval < 0) {
150 __putname(tmp);
151 result = ERR_PTR(retval);
152 }
153 }
154 audit_getname(result);
155 return result;
156}
157
158#ifdef CONFIG_AUDITSYSCALL
159void putname(const char *name)
160{
Al Viro5ac3a9c2006-07-16 06:38:45 -0400161 if (unlikely(!audit_dummy_context()))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700162 audit_putname(name);
163 else
164 __putname(name);
165}
166EXPORT_SYMBOL(putname);
167#endif
168
Linus Torvalds5909ccaa2009-08-28 11:51:25 -0700169/*
170 * This does basic POSIX ACL permission checking
171 */
Nick Pigginb74c79e2011-01-07 17:49:58 +1100172static int acl_permission_check(struct inode *inode, int mask, unsigned int flags,
173 int (*check_acl)(struct inode *inode, int mask, unsigned int flags))
Linus Torvalds5909ccaa2009-08-28 11:51:25 -0700174{
175 umode_t mode = inode->i_mode;
176
177 mask &= MAY_READ | MAY_WRITE | MAY_EXEC;
178
179 if (current_fsuid() == inode->i_uid)
180 mode >>= 6;
181 else {
182 if (IS_POSIXACL(inode) && (mode & S_IRWXG) && check_acl) {
Nick Pigginb74c79e2011-01-07 17:49:58 +1100183 int error = check_acl(inode, mask, flags);
184 if (error != -EAGAIN)
185 return error;
Linus Torvalds5909ccaa2009-08-28 11:51:25 -0700186 }
187
188 if (in_group_p(inode->i_gid))
189 mode >>= 3;
190 }
191
192 /*
193 * If the DACs are ok we don't need any capability check.
194 */
195 if ((mask & ~mode) == 0)
196 return 0;
197 return -EACCES;
198}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700199
200/**
Nick Pigginb74c79e2011-01-07 17:49:58 +1100201 * generic_permission - check for access rights on a Posix-like filesystem
Linus Torvalds1da177e2005-04-16 15:20:36 -0700202 * @inode: inode to check access rights for
203 * @mask: right to check for (%MAY_READ, %MAY_WRITE, %MAY_EXEC)
204 * @check_acl: optional callback to check for Posix ACLs
Randy Dunlap39191622011-01-08 19:36:21 -0800205 * @flags: IPERM_FLAG_ flags.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700206 *
207 * Used to check for read/write/execute permissions on a file.
208 * We use "fsuid" for this, letting us set arbitrary permissions
209 * for filesystem access without changing the "normal" uids which
Nick Pigginb74c79e2011-01-07 17:49:58 +1100210 * are used for other things.
211 *
212 * generic_permission is rcu-walk aware. It returns -ECHILD in case an rcu-walk
213 * request cannot be satisfied (eg. requires blocking or too much complexity).
214 * It would then be called again in ref-walk mode.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700215 */
Nick Pigginb74c79e2011-01-07 17:49:58 +1100216int generic_permission(struct inode *inode, int mask, unsigned int flags,
217 int (*check_acl)(struct inode *inode, int mask, unsigned int flags))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700218{
Linus Torvalds5909ccaa2009-08-28 11:51:25 -0700219 int ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700220
221 /*
Linus Torvalds5909ccaa2009-08-28 11:51:25 -0700222 * Do the basic POSIX ACL permission checks.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700223 */
Nick Pigginb74c79e2011-01-07 17:49:58 +1100224 ret = acl_permission_check(inode, mask, flags, check_acl);
Linus Torvalds5909ccaa2009-08-28 11:51:25 -0700225 if (ret != -EACCES)
226 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700227
Linus Torvalds1da177e2005-04-16 15:20:36 -0700228 /*
229 * Read/write DACs are always overridable.
230 * Executable DACs are overridable if at least one exec bit is set.
231 */
Miklos Szeredif696a362008-07-31 13:41:58 +0200232 if (!(mask & MAY_EXEC) || execute_ok(inode))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700233 if (capable(CAP_DAC_OVERRIDE))
234 return 0;
235
236 /*
237 * Searching includes executable on directories, else just read.
238 */
Serge E. Hallyn7ea66002009-12-29 14:50:19 -0600239 mask &= MAY_READ | MAY_WRITE | MAY_EXEC;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700240 if (mask == MAY_READ || (S_ISDIR(inode->i_mode) && !(mask & MAY_WRITE)))
241 if (capable(CAP_DAC_READ_SEARCH))
242 return 0;
243
244 return -EACCES;
245}
246
Christoph Hellwigcb23beb2008-10-24 09:59:29 +0200247/**
248 * inode_permission - check for access rights to a given inode
249 * @inode: inode to check permission on
250 * @mask: right to check for (%MAY_READ, %MAY_WRITE, %MAY_EXEC)
251 *
252 * Used to check for read/write/execute permissions on an inode.
253 * We use "fsuid" for this, letting us set arbitrary permissions
254 * for filesystem access without changing the "normal" uids which
255 * are used for other things.
256 */
Al Virof419a2e2008-07-22 00:07:17 -0400257int inode_permission(struct inode *inode, int mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700258{
Al Viroe6305c42008-07-15 21:03:57 -0400259 int retval;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700260
261 if (mask & MAY_WRITE) {
Miklos Szeredi22590e42007-10-16 23:27:08 -0700262 umode_t mode = inode->i_mode;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700263
264 /*
265 * Nobody gets write access to a read-only fs.
266 */
267 if (IS_RDONLY(inode) &&
268 (S_ISREG(mode) || S_ISDIR(mode) || S_ISLNK(mode)))
269 return -EROFS;
270
271 /*
272 * Nobody gets write access to an immutable file.
273 */
274 if (IS_IMMUTABLE(inode))
275 return -EACCES;
276 }
277
Al Viroacfa4382008-12-04 10:06:33 -0500278 if (inode->i_op->permission)
Nick Pigginb74c79e2011-01-07 17:49:58 +1100279 retval = inode->i_op->permission(inode, mask, 0);
Miklos Szeredif696a362008-07-31 13:41:58 +0200280 else
Nick Pigginb74c79e2011-01-07 17:49:58 +1100281 retval = generic_permission(inode, mask, 0,
282 inode->i_op->check_acl);
Miklos Szeredif696a362008-07-31 13:41:58 +0200283
Linus Torvalds1da177e2005-04-16 15:20:36 -0700284 if (retval)
285 return retval;
286
Serge E. Hallyn08ce5f12008-04-29 01:00:10 -0700287 retval = devcgroup_inode_permission(inode, mask);
288 if (retval)
289 return retval;
290
Eric Parisd09ca732010-07-23 11:43:57 -0400291 return security_inode_permission(inode, mask);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700292}
293
Christoph Hellwige4543ed2005-11-08 21:35:04 -0800294/**
Christoph Hellwig8c744fb2005-11-08 21:35:04 -0800295 * file_permission - check for additional access rights to a given file
296 * @file: file to check access rights for
297 * @mask: right to check for (%MAY_READ, %MAY_WRITE, %MAY_EXEC)
298 *
299 * Used to check for read/write/execute permissions on an already opened
300 * file.
301 *
302 * Note:
303 * Do not use this function in new code. All access checks should
Christoph Hellwigcb23beb2008-10-24 09:59:29 +0200304 * be done using inode_permission().
Christoph Hellwig8c744fb2005-11-08 21:35:04 -0800305 */
306int file_permission(struct file *file, int mask)
307{
Al Virof419a2e2008-07-22 00:07:17 -0400308 return inode_permission(file->f_path.dentry->d_inode, mask);
Christoph Hellwig8c744fb2005-11-08 21:35:04 -0800309}
310
Linus Torvalds1da177e2005-04-16 15:20:36 -0700311/*
312 * get_write_access() gets write permission for a file.
313 * put_write_access() releases this write permission.
314 * This is used for regular files.
315 * We cannot support write (and maybe mmap read-write shared) accesses and
316 * MAP_DENYWRITE mmappings simultaneously. The i_writecount field of an inode
317 * can have the following values:
318 * 0: no writers, no VM_DENYWRITE mappings
319 * < 0: (-i_writecount) vm_area_structs with VM_DENYWRITE set exist
320 * > 0: (i_writecount) users are writing to the file.
321 *
322 * Normally we operate on that counter with atomic_{inc,dec} and it's safe
323 * except for the cases where we don't hold i_writecount yet. Then we need to
324 * use {get,deny}_write_access() - these functions check the sign and refuse
325 * to do the change if sign is wrong. Exclusion between them is provided by
326 * the inode->i_lock spinlock.
327 */
328
329int get_write_access(struct inode * inode)
330{
331 spin_lock(&inode->i_lock);
332 if (atomic_read(&inode->i_writecount) < 0) {
333 spin_unlock(&inode->i_lock);
334 return -ETXTBSY;
335 }
336 atomic_inc(&inode->i_writecount);
337 spin_unlock(&inode->i_lock);
338
339 return 0;
340}
341
342int deny_write_access(struct file * file)
343{
Josef "Jeff" Sipek0f7fc9e2006-12-08 02:36:35 -0800344 struct inode *inode = file->f_path.dentry->d_inode;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700345
346 spin_lock(&inode->i_lock);
347 if (atomic_read(&inode->i_writecount) > 0) {
348 spin_unlock(&inode->i_lock);
349 return -ETXTBSY;
350 }
351 atomic_dec(&inode->i_writecount);
352 spin_unlock(&inode->i_lock);
353
354 return 0;
355}
356
Jan Blunck1d957f92008-02-14 19:34:35 -0800357/**
Jan Blunck5dd784d2008-02-14 19:34:38 -0800358 * path_get - get a reference to a path
359 * @path: path to get the reference to
360 *
361 * Given a path increment the reference count to the dentry and the vfsmount.
362 */
363void path_get(struct path *path)
364{
365 mntget(path->mnt);
366 dget(path->dentry);
367}
368EXPORT_SYMBOL(path_get);
369
370/**
Jan Blunck1d957f92008-02-14 19:34:35 -0800371 * path_put - put a reference to a path
372 * @path: path to put the reference to
373 *
374 * Given a path decrement the reference count to the dentry and the vfsmount.
375 */
376void path_put(struct path *path)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700377{
Jan Blunck1d957f92008-02-14 19:34:35 -0800378 dput(path->dentry);
379 mntput(path->mnt);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700380}
Jan Blunck1d957f92008-02-14 19:34:35 -0800381EXPORT_SYMBOL(path_put);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700382
Trond Myklebust834f2a42005-10-18 14:20:16 -0700383/**
Nick Piggin31e6b012011-01-07 17:49:52 +1100384 * nameidata_drop_rcu - drop this nameidata out of rcu-walk
385 * @nd: nameidata pathwalk data to drop
Randy Dunlap39191622011-01-08 19:36:21 -0800386 * Returns: 0 on success, -ECHILD on failure
Nick Piggin31e6b012011-01-07 17:49:52 +1100387 *
388 * Path walking has 2 modes, rcu-walk and ref-walk (see
389 * Documentation/filesystems/path-lookup.txt). __drop_rcu* functions attempt
390 * to drop out of rcu-walk mode and take normal reference counts on dentries
391 * and vfsmounts to transition to rcu-walk mode. __drop_rcu* functions take
392 * refcounts at the last known good point before rcu-walk got stuck, so
393 * ref-walk may continue from there. If this is not successful (eg. a seqcount
394 * has changed), then failure is returned and path walk restarts from the
395 * beginning in ref-walk mode.
396 *
397 * nameidata_drop_rcu attempts to drop the current nd->path and nd->root into
398 * ref-walk. Must be called from rcu-walk context.
399 */
400static int nameidata_drop_rcu(struct nameidata *nd)
401{
402 struct fs_struct *fs = current->fs;
403 struct dentry *dentry = nd->path.dentry;
404
405 BUG_ON(!(nd->flags & LOOKUP_RCU));
406 if (nd->root.mnt) {
407 spin_lock(&fs->lock);
408 if (nd->root.mnt != fs->root.mnt ||
409 nd->root.dentry != fs->root.dentry)
410 goto err_root;
411 }
412 spin_lock(&dentry->d_lock);
413 if (!__d_rcu_to_refcount(dentry, nd->seq))
414 goto err;
415 BUG_ON(nd->inode != dentry->d_inode);
416 spin_unlock(&dentry->d_lock);
417 if (nd->root.mnt) {
418 path_get(&nd->root);
419 spin_unlock(&fs->lock);
420 }
421 mntget(nd->path.mnt);
422
423 rcu_read_unlock();
424 br_read_unlock(vfsmount_lock);
425 nd->flags &= ~LOOKUP_RCU;
426 return 0;
427err:
428 spin_unlock(&dentry->d_lock);
429err_root:
430 if (nd->root.mnt)
431 spin_unlock(&fs->lock);
432 return -ECHILD;
433}
434
435/* Try to drop out of rcu-walk mode if we were in it, otherwise do nothing. */
436static inline int nameidata_drop_rcu_maybe(struct nameidata *nd)
437{
438 if (nd->flags & LOOKUP_RCU)
439 return nameidata_drop_rcu(nd);
440 return 0;
441}
442
443/**
444 * nameidata_dentry_drop_rcu - drop nameidata and dentry out of rcu-walk
445 * @nd: nameidata pathwalk data to drop
446 * @dentry: dentry to drop
Randy Dunlap39191622011-01-08 19:36:21 -0800447 * Returns: 0 on success, -ECHILD on failure
Nick Piggin31e6b012011-01-07 17:49:52 +1100448 *
449 * nameidata_dentry_drop_rcu attempts to drop the current nd->path and nd->root,
450 * and dentry into ref-walk. @dentry must be a path found by a do_lookup call on
451 * @nd. Must be called from rcu-walk context.
452 */
453static int nameidata_dentry_drop_rcu(struct nameidata *nd, struct dentry *dentry)
454{
455 struct fs_struct *fs = current->fs;
456 struct dentry *parent = nd->path.dentry;
457
Nick Piggin90dbb772011-01-14 02:36:19 +0000458 /*
459 * It can be possible to revalidate the dentry that we started
460 * the path walk with. force_reval_path may also revalidate the
461 * dentry already committed to the nameidata.
462 */
463 if (unlikely(parent == dentry))
464 return nameidata_drop_rcu(nd);
465
Nick Piggin31e6b012011-01-07 17:49:52 +1100466 BUG_ON(!(nd->flags & LOOKUP_RCU));
467 if (nd->root.mnt) {
468 spin_lock(&fs->lock);
469 if (nd->root.mnt != fs->root.mnt ||
470 nd->root.dentry != fs->root.dentry)
471 goto err_root;
472 }
473 spin_lock(&parent->d_lock);
474 spin_lock_nested(&dentry->d_lock, DENTRY_D_LOCK_NESTED);
475 if (!__d_rcu_to_refcount(dentry, nd->seq))
476 goto err;
477 /*
478 * If the sequence check on the child dentry passed, then the child has
479 * not been removed from its parent. This means the parent dentry must
480 * be valid and able to take a reference at this point.
481 */
482 BUG_ON(!IS_ROOT(dentry) && dentry->d_parent != parent);
483 BUG_ON(!parent->d_count);
484 parent->d_count++;
485 spin_unlock(&dentry->d_lock);
486 spin_unlock(&parent->d_lock);
487 if (nd->root.mnt) {
488 path_get(&nd->root);
489 spin_unlock(&fs->lock);
490 }
491 mntget(nd->path.mnt);
492
493 rcu_read_unlock();
494 br_read_unlock(vfsmount_lock);
495 nd->flags &= ~LOOKUP_RCU;
496 return 0;
497err:
498 spin_unlock(&dentry->d_lock);
499 spin_unlock(&parent->d_lock);
500err_root:
501 if (nd->root.mnt)
502 spin_unlock(&fs->lock);
503 return -ECHILD;
504}
505
506/* Try to drop out of rcu-walk mode if we were in it, otherwise do nothing. */
507static inline int nameidata_dentry_drop_rcu_maybe(struct nameidata *nd, struct dentry *dentry)
508{
509 if (nd->flags & LOOKUP_RCU)
510 return nameidata_dentry_drop_rcu(nd, dentry);
511 return 0;
512}
513
514/**
515 * nameidata_drop_rcu_last - drop nameidata ending path walk out of rcu-walk
516 * @nd: nameidata pathwalk data to drop
Randy Dunlap39191622011-01-08 19:36:21 -0800517 * Returns: 0 on success, -ECHILD on failure
Nick Piggin31e6b012011-01-07 17:49:52 +1100518 *
519 * nameidata_drop_rcu_last attempts to drop the current nd->path into ref-walk.
520 * nd->path should be the final element of the lookup, so nd->root is discarded.
521 * Must be called from rcu-walk context.
522 */
523static int nameidata_drop_rcu_last(struct nameidata *nd)
524{
525 struct dentry *dentry = nd->path.dentry;
526
527 BUG_ON(!(nd->flags & LOOKUP_RCU));
528 nd->flags &= ~LOOKUP_RCU;
529 nd->root.mnt = NULL;
530 spin_lock(&dentry->d_lock);
531 if (!__d_rcu_to_refcount(dentry, nd->seq))
532 goto err_unlock;
533 BUG_ON(nd->inode != dentry->d_inode);
534 spin_unlock(&dentry->d_lock);
535
536 mntget(nd->path.mnt);
537
538 rcu_read_unlock();
539 br_read_unlock(vfsmount_lock);
540
541 return 0;
542
543err_unlock:
544 spin_unlock(&dentry->d_lock);
545 rcu_read_unlock();
546 br_read_unlock(vfsmount_lock);
547 return -ECHILD;
548}
549
550/* Try to drop out of rcu-walk mode if we were in it, otherwise do nothing. */
551static inline int nameidata_drop_rcu_last_maybe(struct nameidata *nd)
552{
553 if (likely(nd->flags & LOOKUP_RCU))
554 return nameidata_drop_rcu_last(nd);
555 return 0;
556}
557
558/**
Trond Myklebust834f2a42005-10-18 14:20:16 -0700559 * release_open_intent - free up open intent resources
560 * @nd: pointer to nameidata
561 */
562void release_open_intent(struct nameidata *nd)
563{
Josef "Jeff" Sipek0f7fc9e2006-12-08 02:36:35 -0800564 if (nd->intent.open.file->f_path.dentry == NULL)
Trond Myklebust834f2a42005-10-18 14:20:16 -0700565 put_filp(nd->intent.open.file);
566 else
567 fput(nd->intent.open.file);
568}
569
Nick Pigginbb20c182011-01-14 02:35:53 +0000570/*
571 * Call d_revalidate and handle filesystems that request rcu-walk
572 * to be dropped. This may be called and return in rcu-walk mode,
573 * regardless of success or error. If -ECHILD is returned, the caller
574 * must return -ECHILD back up the path walk stack so path walk may
575 * be restarted in ref-walk mode.
576 */
Nick Piggin34286d62011-01-07 17:49:57 +1100577static int d_revalidate(struct dentry *dentry, struct nameidata *nd)
578{
579 int status;
580
581 status = dentry->d_op->d_revalidate(dentry, nd);
582 if (status == -ECHILD) {
583 if (nameidata_dentry_drop_rcu(nd, dentry))
584 return status;
585 status = dentry->d_op->d_revalidate(dentry, nd);
586 }
587
588 return status;
589}
590
Ian Kentbcdc5e02006-09-27 01:50:44 -0700591static inline struct dentry *
592do_revalidate(struct dentry *dentry, struct nameidata *nd)
593{
Nick Piggin34286d62011-01-07 17:49:57 +1100594 int status;
595
596 status = d_revalidate(dentry, nd);
Ian Kentbcdc5e02006-09-27 01:50:44 -0700597 if (unlikely(status <= 0)) {
598 /*
599 * The dentry failed validation.
600 * If d_revalidate returned 0 attempt to invalidate
601 * the dentry otherwise d_revalidate is asking us
602 * to return a fail status.
603 */
Nick Piggin34286d62011-01-07 17:49:57 +1100604 if (status < 0) {
605 /* If we're in rcu-walk, we don't have a ref */
606 if (!(nd->flags & LOOKUP_RCU))
607 dput(dentry);
608 dentry = ERR_PTR(status);
609
610 } else {
611 /* Don't d_invalidate in rcu-walk mode */
612 if (nameidata_dentry_drop_rcu_maybe(nd, dentry))
613 return ERR_PTR(-ECHILD);
Ian Kentbcdc5e02006-09-27 01:50:44 -0700614 if (!d_invalidate(dentry)) {
615 dput(dentry);
616 dentry = NULL;
617 }
Ian Kentbcdc5e02006-09-27 01:50:44 -0700618 }
619 }
620 return dentry;
621}
622
Nick Pigginfb045ad2011-01-07 17:49:55 +1100623static inline int need_reval_dot(struct dentry *dentry)
624{
625 if (likely(!(dentry->d_flags & DCACHE_OP_REVALIDATE)))
626 return 0;
627
628 if (likely(!(dentry->d_sb->s_type->fs_flags & FS_REVAL_DOT)))
629 return 0;
630
631 return 1;
632}
633
Linus Torvalds1da177e2005-04-16 15:20:36 -0700634/*
Jeff Layton39159de2009-12-07 12:01:50 -0500635 * force_reval_path - force revalidation of a dentry
636 *
637 * In some situations the path walking code will trust dentries without
638 * revalidating them. This causes problems for filesystems that depend on
639 * d_revalidate to handle file opens (e.g. NFSv4). When FS_REVAL_DOT is set
640 * (which indicates that it's possible for the dentry to go stale), force
641 * a d_revalidate call before proceeding.
642 *
643 * Returns 0 if the revalidation was successful. If the revalidation fails,
644 * either return the error returned by d_revalidate or -ESTALE if the
645 * revalidation it just returned 0. If d_revalidate returns 0, we attempt to
646 * invalidate the dentry. It's up to the caller to handle putting references
647 * to the path if necessary.
648 */
649static int
650force_reval_path(struct path *path, struct nameidata *nd)
651{
652 int status;
653 struct dentry *dentry = path->dentry;
654
655 /*
656 * only check on filesystems where it's possible for the dentry to
Nick Pigginfb045ad2011-01-07 17:49:55 +1100657 * become stale.
Jeff Layton39159de2009-12-07 12:01:50 -0500658 */
Nick Pigginfb045ad2011-01-07 17:49:55 +1100659 if (!need_reval_dot(dentry))
Jeff Layton39159de2009-12-07 12:01:50 -0500660 return 0;
661
Nick Piggin34286d62011-01-07 17:49:57 +1100662 status = d_revalidate(dentry, nd);
Jeff Layton39159de2009-12-07 12:01:50 -0500663 if (status > 0)
664 return 0;
665
666 if (!status) {
Nick Pigginbb20c182011-01-14 02:35:53 +0000667 /* Don't d_invalidate in rcu-walk mode */
668 if (nameidata_drop_rcu(nd))
669 return -ECHILD;
Jeff Layton39159de2009-12-07 12:01:50 -0500670 d_invalidate(dentry);
671 status = -ESTALE;
672 }
673 return status;
674}
675
676/*
Al Virob75b5082009-12-16 01:01:38 -0500677 * Short-cut version of permission(), for calling on directories
678 * during pathname resolution. Combines parts of permission()
679 * and generic_permission(), and tests ONLY for MAY_EXEC permission.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700680 *
681 * If appropriate, check DAC only. If not appropriate, or
Al Virob75b5082009-12-16 01:01:38 -0500682 * short-cut DAC fails, then call ->permission() to do more
Linus Torvalds1da177e2005-04-16 15:20:36 -0700683 * complete permission check.
684 */
Nick Pigginb74c79e2011-01-07 17:49:58 +1100685static inline int exec_permission(struct inode *inode, unsigned int flags)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700686{
Linus Torvalds5909ccaa2009-08-28 11:51:25 -0700687 int ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700688
Linus Torvaldscb9179e2009-08-28 11:08:31 -0700689 if (inode->i_op->permission) {
Nick Pigginb74c79e2011-01-07 17:49:58 +1100690 ret = inode->i_op->permission(inode, MAY_EXEC, flags);
691 } else {
692 ret = acl_permission_check(inode, MAY_EXEC, flags,
693 inode->i_op->check_acl);
Linus Torvaldscb9179e2009-08-28 11:08:31 -0700694 }
Nick Pigginb74c79e2011-01-07 17:49:58 +1100695 if (likely(!ret))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700696 goto ok;
Nick Pigginb74c79e2011-01-07 17:49:58 +1100697 if (ret == -ECHILD)
Nick Piggin31e6b012011-01-07 17:49:52 +1100698 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700699
Linus Torvaldsf1ac9f62009-08-28 10:53:56 -0700700 if (capable(CAP_DAC_OVERRIDE) || capable(CAP_DAC_READ_SEARCH))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700701 goto ok;
702
Linus Torvalds5909ccaa2009-08-28 11:51:25 -0700703 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700704ok:
Nick Pigginb74c79e2011-01-07 17:49:58 +1100705 return security_inode_exec_permission(inode, flags);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700706}
707
Al Viro2a737872009-04-07 11:49:53 -0400708static __always_inline void set_root(struct nameidata *nd)
709{
Miklos Szeredif7ad3c62010-08-10 11:41:36 +0200710 if (!nd->root.mnt)
711 get_fs_root(current->fs, &nd->root);
Al Viro2a737872009-04-07 11:49:53 -0400712}
713
Al Viro6de88d72009-08-09 01:41:57 +0400714static int link_path_walk(const char *, struct nameidata *);
715
Nick Piggin31e6b012011-01-07 17:49:52 +1100716static __always_inline void set_root_rcu(struct nameidata *nd)
717{
718 if (!nd->root.mnt) {
719 struct fs_struct *fs = current->fs;
Nick Pigginc28cc362011-01-07 17:49:53 +1100720 unsigned seq;
721
722 do {
723 seq = read_seqcount_begin(&fs->seq);
724 nd->root = fs->root;
725 } while (read_seqcount_retry(&fs->seq, seq));
Nick Piggin31e6b012011-01-07 17:49:52 +1100726 }
727}
728
Arjan van de Venf1662352006-01-14 13:21:31 -0800729static __always_inline int __vfs_follow_link(struct nameidata *nd, const char *link)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700730{
Nick Piggin31e6b012011-01-07 17:49:52 +1100731 int ret;
732
Linus Torvalds1da177e2005-04-16 15:20:36 -0700733 if (IS_ERR(link))
734 goto fail;
735
736 if (*link == '/') {
Al Viro2a737872009-04-07 11:49:53 -0400737 set_root(nd);
Jan Blunck1d957f92008-02-14 19:34:35 -0800738 path_put(&nd->path);
Al Viro2a737872009-04-07 11:49:53 -0400739 nd->path = nd->root;
740 path_get(&nd->root);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700741 }
Nick Piggin31e6b012011-01-07 17:49:52 +1100742 nd->inode = nd->path.dentry->d_inode;
Christoph Hellwigb4091d52008-11-05 15:07:21 +0100743
Nick Piggin31e6b012011-01-07 17:49:52 +1100744 ret = link_path_walk(link, nd);
745 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700746fail:
Jan Blunck1d957f92008-02-14 19:34:35 -0800747 path_put(&nd->path);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700748 return PTR_ERR(link);
749}
750
Jan Blunck1d957f92008-02-14 19:34:35 -0800751static void path_put_conditional(struct path *path, struct nameidata *nd)
Miklos Szeredi09dd17d2005-09-06 15:18:21 -0700752{
753 dput(path->dentry);
Jan Blunck4ac91372008-02-14 19:34:32 -0800754 if (path->mnt != nd->path.mnt)
Miklos Szeredi09dd17d2005-09-06 15:18:21 -0700755 mntput(path->mnt);
756}
757
Nick Piggin7b9337a2011-01-14 08:42:43 +0000758static inline void path_to_nameidata(const struct path *path,
759 struct nameidata *nd)
Miklos Szeredi09dd17d2005-09-06 15:18:21 -0700760{
Nick Piggin31e6b012011-01-07 17:49:52 +1100761 if (!(nd->flags & LOOKUP_RCU)) {
762 dput(nd->path.dentry);
763 if (nd->path.mnt != path->mnt)
764 mntput(nd->path.mnt);
Huang Shijie9a229682010-04-02 17:37:13 +0800765 }
Nick Piggin31e6b012011-01-07 17:49:52 +1100766 nd->path.mnt = path->mnt;
Jan Blunck4ac91372008-02-14 19:34:32 -0800767 nd->path.dentry = path->dentry;
Miklos Szeredi09dd17d2005-09-06 15:18:21 -0700768}
769
Al Virodef4af32009-12-26 08:37:05 -0500770static __always_inline int
Nick Piggin7b9337a2011-01-14 08:42:43 +0000771__do_follow_link(const struct path *link, struct nameidata *nd, void **p)
Ian Kent051d3812006-03-27 01:14:53 -0800772{
773 int error;
Nick Piggin7b9337a2011-01-14 08:42:43 +0000774 struct dentry *dentry = link->dentry;
Ian Kent051d3812006-03-27 01:14:53 -0800775
Nick Piggin7b9337a2011-01-14 08:42:43 +0000776 touch_atime(link->mnt, dentry);
Ian Kent051d3812006-03-27 01:14:53 -0800777 nd_set_link(nd, NULL);
778
David Howells87556ef2011-01-14 18:46:46 +0000779 if (link->mnt == nd->path.mnt)
780 mntget(link->mnt);
Nick Piggin31e6b012011-01-07 17:49:52 +1100781
Al Viro86acdca12009-12-22 23:45:11 -0500782 nd->last_type = LAST_BIND;
Al Virodef4af32009-12-26 08:37:05 -0500783 *p = dentry->d_inode->i_op->follow_link(dentry, nd);
784 error = PTR_ERR(*p);
785 if (!IS_ERR(*p)) {
Ian Kent051d3812006-03-27 01:14:53 -0800786 char *s = nd_get_link(nd);
787 error = 0;
788 if (s)
789 error = __vfs_follow_link(nd, s);
Jeff Layton39159de2009-12-07 12:01:50 -0500790 else if (nd->last_type == LAST_BIND) {
791 error = force_reval_path(&nd->path, nd);
792 if (error)
793 path_put(&nd->path);
794 }
Ian Kent051d3812006-03-27 01:14:53 -0800795 }
Ian Kent051d3812006-03-27 01:14:53 -0800796 return error;
797}
798
Linus Torvalds1da177e2005-04-16 15:20:36 -0700799/*
800 * This limits recursive symlink follows to 8, while
801 * limiting consecutive symlinks to 40.
802 *
803 * Without that kind of total limit, nasty chains of consecutive
804 * symlinks can cause almost arbitrarily long lookups.
805 */
Al Viro90ebe562005-06-06 13:35:58 -0700806static inline int do_follow_link(struct path *path, struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700807{
Al Virodef4af32009-12-26 08:37:05 -0500808 void *cookie;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700809 int err = -ELOOP;
810 if (current->link_count >= MAX_NESTED_LINKS)
811 goto loop;
812 if (current->total_link_count >= 40)
813 goto loop;
814 BUG_ON(nd->depth >= MAX_NESTED_LINKS);
815 cond_resched();
Al Viro90ebe562005-06-06 13:35:58 -0700816 err = security_inode_follow_link(path->dentry, nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700817 if (err)
818 goto loop;
819 current->link_count++;
820 current->total_link_count++;
821 nd->depth++;
Al Virodef4af32009-12-26 08:37:05 -0500822 err = __do_follow_link(path, nd, &cookie);
823 if (!IS_ERR(cookie) && path->dentry->d_inode->i_op->put_link)
824 path->dentry->d_inode->i_op->put_link(path->dentry, nd, cookie);
Al Viro258fa992009-08-09 01:32:02 +0400825 path_put(path);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700826 current->link_count--;
827 nd->depth--;
828 return err;
829loop:
Jan Blunck1d957f92008-02-14 19:34:35 -0800830 path_put_conditional(path, nd);
831 path_put(&nd->path);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700832 return err;
833}
834
Nick Piggin31e6b012011-01-07 17:49:52 +1100835static int follow_up_rcu(struct path *path)
836{
837 struct vfsmount *parent;
838 struct dentry *mountpoint;
839
840 parent = path->mnt->mnt_parent;
841 if (parent == path->mnt)
842 return 0;
843 mountpoint = path->mnt->mnt_mountpoint;
844 path->dentry = mountpoint;
845 path->mnt = parent;
846 return 1;
847}
848
Al Virobab77eb2009-04-18 03:26:48 -0400849int follow_up(struct path *path)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700850{
851 struct vfsmount *parent;
852 struct dentry *mountpoint;
Nick Piggin99b7db72010-08-18 04:37:39 +1000853
854 br_read_lock(vfsmount_lock);
Al Virobab77eb2009-04-18 03:26:48 -0400855 parent = path->mnt->mnt_parent;
856 if (parent == path->mnt) {
Nick Piggin99b7db72010-08-18 04:37:39 +1000857 br_read_unlock(vfsmount_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700858 return 0;
859 }
860 mntget(parent);
Al Virobab77eb2009-04-18 03:26:48 -0400861 mountpoint = dget(path->mnt->mnt_mountpoint);
Nick Piggin99b7db72010-08-18 04:37:39 +1000862 br_read_unlock(vfsmount_lock);
Al Virobab77eb2009-04-18 03:26:48 -0400863 dput(path->dentry);
864 path->dentry = mountpoint;
865 mntput(path->mnt);
866 path->mnt = parent;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700867 return 1;
868}
869
Nick Pigginb5c84bf2011-01-07 17:49:38 +1100870/*
David Howells9875cf82011-01-14 18:45:21 +0000871 * Perform an automount
872 * - return -EISDIR to tell follow_managed() to stop and return the path we
873 * were called with.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700874 */
David Howells9875cf82011-01-14 18:45:21 +0000875static int follow_automount(struct path *path, unsigned flags,
876 bool *need_mntput)
Nick Piggin31e6b012011-01-07 17:49:52 +1100877{
David Howells9875cf82011-01-14 18:45:21 +0000878 struct vfsmount *mnt;
David Howellsea5b7782011-01-14 19:10:03 +0000879 int err;
Nick Piggin31e6b012011-01-07 17:49:52 +1100880
David Howells9875cf82011-01-14 18:45:21 +0000881 if (!path->dentry->d_op || !path->dentry->d_op->d_automount)
882 return -EREMOTE;
Al Viro463ffb22005-06-06 13:36:05 -0700883
David Howells6f45b652011-01-14 18:45:31 +0000884 /* We don't want to mount if someone supplied AT_NO_AUTOMOUNT
885 * and this is the terminal part of the path.
886 */
887 if ((flags & LOOKUP_NO_AUTOMOUNT) && !(flags & LOOKUP_CONTINUE))
888 return -EISDIR; /* we actually want to stop here */
889
David Howells9875cf82011-01-14 18:45:21 +0000890 /* We want to mount if someone is trying to open/create a file of any
891 * type under the mountpoint, wants to traverse through the mountpoint
892 * or wants to open the mounted directory.
893 *
894 * We don't want to mount if someone's just doing a stat and they've
895 * set AT_SYMLINK_NOFOLLOW - unless they're stat'ing a directory and
896 * appended a '/' to the name.
897 */
898 if (!(flags & LOOKUP_FOLLOW) &&
899 !(flags & (LOOKUP_CONTINUE | LOOKUP_DIRECTORY |
900 LOOKUP_OPEN | LOOKUP_CREATE)))
901 return -EISDIR;
902
903 current->total_link_count++;
904 if (current->total_link_count >= 40)
905 return -ELOOP;
906
907 mnt = path->dentry->d_op->d_automount(path);
908 if (IS_ERR(mnt)) {
909 /*
910 * The filesystem is allowed to return -EISDIR here to indicate
911 * it doesn't want to automount. For instance, autofs would do
912 * this so that its userspace daemon can mount on this dentry.
913 *
914 * However, we can only permit this if it's a terminal point in
915 * the path being looked up; if it wasn't then the remainder of
916 * the path is inaccessible and we should say so.
917 */
918 if (PTR_ERR(mnt) == -EISDIR && (flags & LOOKUP_CONTINUE))
919 return -EREMOTE;
920 return PTR_ERR(mnt);
921 }
David Howellsea5b7782011-01-14 19:10:03 +0000922
David Howells9875cf82011-01-14 18:45:21 +0000923 if (!mnt) /* mount collision */
924 return 0;
925
David Howellsea5b7782011-01-14 19:10:03 +0000926 /* The new mount record should have at least 2 refs to prevent it being
927 * expired before we get a chance to add it
928 */
929 BUG_ON(mnt_get_count(mnt) < 2);
930
David Howells9875cf82011-01-14 18:45:21 +0000931 if (mnt->mnt_sb == path->mnt->mnt_sb &&
932 mnt->mnt_root == path->dentry) {
David Howellsea5b7782011-01-14 19:10:03 +0000933 mnt_clear_expiry(mnt);
934 mntput(mnt);
David Howells9875cf82011-01-14 18:45:21 +0000935 mntput(mnt);
936 return -ELOOP;
937 }
938
David Howellsea5b7782011-01-14 19:10:03 +0000939 /* We need to add the mountpoint to the parent. The filesystem may
940 * have placed it on an expiry list, and so we need to make sure it
941 * won't be expired under us if do_add_mount() fails (do_add_mount()
942 * will eat a reference unconditionally).
943 */
944 mntget(mnt);
945 err = do_add_mount(mnt, path, path->mnt->mnt_flags | MNT_SHRINKABLE);
946 switch (err) {
947 case -EBUSY:
948 /* Someone else made a mount here whilst we were busy */
949 err = 0;
950 default:
951 mnt_clear_expiry(mnt);
952 mntput(mnt);
953 mntput(mnt);
954 return err;
955 case 0:
956 mntput(mnt);
957 dput(path->dentry);
958 if (*need_mntput)
959 mntput(path->mnt);
960 path->mnt = mnt;
961 path->dentry = dget(mnt->mnt_root);
962 *need_mntput = true;
963 return 0;
964 }
David Howells9875cf82011-01-14 18:45:21 +0000965}
966
967/*
968 * Handle a dentry that is managed in some way.
David Howellscc53ce52011-01-14 18:45:26 +0000969 * - Flagged for transit management (autofs)
David Howells9875cf82011-01-14 18:45:21 +0000970 * - Flagged as mountpoint
971 * - Flagged as automount point
972 *
973 * This may only be called in refwalk mode.
974 *
975 * Serialization is taken care of in namespace.c
976 */
977static int follow_managed(struct path *path, unsigned flags)
978{
979 unsigned managed;
980 bool need_mntput = false;
981 int ret;
982
983 /* Given that we're not holding a lock here, we retain the value in a
984 * local variable for each dentry as we look at it so that we don't see
985 * the components of that value change under us */
986 while (managed = ACCESS_ONCE(path->dentry->d_flags),
987 managed &= DCACHE_MANAGED_DENTRY,
988 unlikely(managed != 0)) {
David Howellscc53ce52011-01-14 18:45:26 +0000989 /* Allow the filesystem to manage the transit without i_mutex
990 * being held. */
991 if (managed & DCACHE_MANAGE_TRANSIT) {
992 BUG_ON(!path->dentry->d_op);
993 BUG_ON(!path->dentry->d_op->d_manage);
David Howellsab909112011-01-14 18:46:51 +0000994 ret = path->dentry->d_op->d_manage(path->dentry,
995 false, false);
David Howellscc53ce52011-01-14 18:45:26 +0000996 if (ret < 0)
997 return ret == -EISDIR ? 0 : ret;
998 }
999
David Howells9875cf82011-01-14 18:45:21 +00001000 /* Transit to a mounted filesystem. */
1001 if (managed & DCACHE_MOUNTED) {
1002 struct vfsmount *mounted = lookup_mnt(path);
1003 if (mounted) {
1004 dput(path->dentry);
1005 if (need_mntput)
1006 mntput(path->mnt);
1007 path->mnt = mounted;
1008 path->dentry = dget(mounted->mnt_root);
1009 need_mntput = true;
1010 continue;
1011 }
1012
1013 /* Something is mounted on this dentry in another
1014 * namespace and/or whatever was mounted there in this
1015 * namespace got unmounted before we managed to get the
1016 * vfsmount_lock */
1017 }
1018
1019 /* Handle an automount point */
1020 if (managed & DCACHE_NEED_AUTOMOUNT) {
1021 ret = follow_automount(path, flags, &need_mntput);
1022 if (ret < 0)
1023 return ret == -EISDIR ? 0 : ret;
1024 continue;
1025 }
1026
1027 /* We didn't change the current path point */
1028 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001029 }
David Howells9875cf82011-01-14 18:45:21 +00001030 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001031}
1032
David Howellscc53ce52011-01-14 18:45:26 +00001033int follow_down_one(struct path *path)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001034{
1035 struct vfsmount *mounted;
1036
Al Viro1c755af2009-04-18 14:06:57 -04001037 mounted = lookup_mnt(path);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001038 if (mounted) {
Al Viro9393bd02009-04-18 13:58:15 -04001039 dput(path->dentry);
1040 mntput(path->mnt);
1041 path->mnt = mounted;
1042 path->dentry = dget(mounted->mnt_root);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001043 return 1;
1044 }
1045 return 0;
1046}
1047
David Howells9875cf82011-01-14 18:45:21 +00001048/*
1049 * Skip to top of mountpoint pile in rcuwalk mode. We abort the rcu-walk if we
David Howellscc53ce52011-01-14 18:45:26 +00001050 * meet a managed dentry and we're not walking to "..". True is returned to
David Howells9875cf82011-01-14 18:45:21 +00001051 * continue, false to abort.
1052 */
1053static bool __follow_mount_rcu(struct nameidata *nd, struct path *path,
1054 struct inode **inode, bool reverse_transit)
1055{
1056 while (d_mountpoint(path->dentry)) {
1057 struct vfsmount *mounted;
David Howellsab909112011-01-14 18:46:51 +00001058 if (unlikely(path->dentry->d_flags & DCACHE_MANAGE_TRANSIT) &&
1059 !reverse_transit &&
1060 path->dentry->d_op->d_manage(path->dentry, false, true) < 0)
1061 return false;
David Howells9875cf82011-01-14 18:45:21 +00001062 mounted = __lookup_mnt(path->mnt, path->dentry, 1);
1063 if (!mounted)
1064 break;
1065 path->mnt = mounted;
1066 path->dentry = mounted->mnt_root;
1067 nd->seq = read_seqcount_begin(&path->dentry->d_seq);
1068 *inode = path->dentry->d_inode;
1069 }
1070
1071 if (unlikely(path->dentry->d_flags & DCACHE_NEED_AUTOMOUNT))
1072 return reverse_transit;
1073 return true;
1074}
1075
Nick Piggin31e6b012011-01-07 17:49:52 +11001076static int follow_dotdot_rcu(struct nameidata *nd)
1077{
1078 struct inode *inode = nd->inode;
1079
1080 set_root_rcu(nd);
1081
David Howells9875cf82011-01-14 18:45:21 +00001082 while (1) {
Nick Piggin31e6b012011-01-07 17:49:52 +11001083 if (nd->path.dentry == nd->root.dentry &&
1084 nd->path.mnt == nd->root.mnt) {
1085 break;
1086 }
1087 if (nd->path.dentry != nd->path.mnt->mnt_root) {
1088 struct dentry *old = nd->path.dentry;
1089 struct dentry *parent = old->d_parent;
1090 unsigned seq;
1091
1092 seq = read_seqcount_begin(&parent->d_seq);
1093 if (read_seqcount_retry(&old->d_seq, nd->seq))
1094 return -ECHILD;
1095 inode = parent->d_inode;
1096 nd->path.dentry = parent;
1097 nd->seq = seq;
1098 break;
1099 }
1100 if (!follow_up_rcu(&nd->path))
1101 break;
1102 nd->seq = read_seqcount_begin(&nd->path.dentry->d_seq);
1103 inode = nd->path.dentry->d_inode;
1104 }
David Howells9875cf82011-01-14 18:45:21 +00001105 __follow_mount_rcu(nd, &nd->path, &inode, true);
Nick Piggin31e6b012011-01-07 17:49:52 +11001106 nd->inode = inode;
1107
1108 return 0;
1109}
1110
David Howells9875cf82011-01-14 18:45:21 +00001111/*
David Howellscc53ce52011-01-14 18:45:26 +00001112 * Follow down to the covering mount currently visible to userspace. At each
1113 * point, the filesystem owning that dentry may be queried as to whether the
1114 * caller is permitted to proceed or not.
1115 *
1116 * Care must be taken as namespace_sem may be held (indicated by mounting_here
1117 * being true).
1118 */
1119int follow_down(struct path *path, bool mounting_here)
1120{
1121 unsigned managed;
1122 int ret;
1123
1124 while (managed = ACCESS_ONCE(path->dentry->d_flags),
1125 unlikely(managed & DCACHE_MANAGED_DENTRY)) {
1126 /* Allow the filesystem to manage the transit without i_mutex
1127 * being held.
1128 *
1129 * We indicate to the filesystem if someone is trying to mount
1130 * something here. This gives autofs the chance to deny anyone
1131 * other than its daemon the right to mount on its
1132 * superstructure.
1133 *
1134 * The filesystem may sleep at this point.
1135 */
1136 if (managed & DCACHE_MANAGE_TRANSIT) {
1137 BUG_ON(!path->dentry->d_op);
1138 BUG_ON(!path->dentry->d_op->d_manage);
David Howellsab909112011-01-14 18:46:51 +00001139 ret = path->dentry->d_op->d_manage(
1140 path->dentry, mounting_here, false);
David Howellscc53ce52011-01-14 18:45:26 +00001141 if (ret < 0)
1142 return ret == -EISDIR ? 0 : ret;
1143 }
1144
1145 /* Transit to a mounted filesystem. */
1146 if (managed & DCACHE_MOUNTED) {
1147 struct vfsmount *mounted = lookup_mnt(path);
1148 if (!mounted)
1149 break;
1150 dput(path->dentry);
1151 mntput(path->mnt);
1152 path->mnt = mounted;
1153 path->dentry = dget(mounted->mnt_root);
1154 continue;
1155 }
1156
1157 /* Don't handle automount points here */
1158 break;
1159 }
1160 return 0;
1161}
1162
1163/*
David Howells9875cf82011-01-14 18:45:21 +00001164 * Skip to top of mountpoint pile in refwalk mode for follow_dotdot()
1165 */
1166static void follow_mount(struct path *path)
1167{
1168 while (d_mountpoint(path->dentry)) {
1169 struct vfsmount *mounted = lookup_mnt(path);
1170 if (!mounted)
1171 break;
1172 dput(path->dentry);
1173 mntput(path->mnt);
1174 path->mnt = mounted;
1175 path->dentry = dget(mounted->mnt_root);
1176 }
1177}
1178
Nick Piggin31e6b012011-01-07 17:49:52 +11001179static void follow_dotdot(struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001180{
Al Viro2a737872009-04-07 11:49:53 -04001181 set_root(nd);
Andreas Mohre518ddb2006-09-29 02:01:22 -07001182
Linus Torvalds1da177e2005-04-16 15:20:36 -07001183 while(1) {
Jan Blunck4ac91372008-02-14 19:34:32 -08001184 struct dentry *old = nd->path.dentry;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001185
Al Viro2a737872009-04-07 11:49:53 -04001186 if (nd->path.dentry == nd->root.dentry &&
1187 nd->path.mnt == nd->root.mnt) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001188 break;
1189 }
Jan Blunck4ac91372008-02-14 19:34:32 -08001190 if (nd->path.dentry != nd->path.mnt->mnt_root) {
Al Viro3088dd72010-01-30 15:47:29 -05001191 /* rare case of legitimate dget_parent()... */
1192 nd->path.dentry = dget_parent(nd->path.dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001193 dput(old);
1194 break;
1195 }
Al Viro3088dd72010-01-30 15:47:29 -05001196 if (!follow_up(&nd->path))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001197 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001198 }
Al Viro79ed0222009-04-18 13:59:41 -04001199 follow_mount(&nd->path);
Nick Piggin31e6b012011-01-07 17:49:52 +11001200 nd->inode = nd->path.dentry->d_inode;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001201}
1202
Linus Torvalds1da177e2005-04-16 15:20:36 -07001203/*
Nick Pigginbaa03892010-08-18 04:37:31 +10001204 * Allocate a dentry with name and parent, and perform a parent
1205 * directory ->lookup on it. Returns the new dentry, or ERR_PTR
1206 * on error. parent->d_inode->i_mutex must be held. d_lookup must
1207 * have verified that no child exists while under i_mutex.
1208 */
1209static struct dentry *d_alloc_and_lookup(struct dentry *parent,
1210 struct qstr *name, struct nameidata *nd)
1211{
1212 struct inode *inode = parent->d_inode;
1213 struct dentry *dentry;
1214 struct dentry *old;
1215
1216 /* Don't create child dentry for a dead directory. */
1217 if (unlikely(IS_DEADDIR(inode)))
1218 return ERR_PTR(-ENOENT);
1219
1220 dentry = d_alloc(parent, name);
1221 if (unlikely(!dentry))
1222 return ERR_PTR(-ENOMEM);
1223
1224 old = inode->i_op->lookup(inode, dentry, nd);
1225 if (unlikely(old)) {
1226 dput(dentry);
1227 dentry = old;
1228 }
1229 return dentry;
1230}
1231
1232/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07001233 * It's more convoluted than I'd like it to be, but... it's still fairly
1234 * small and for now I'd prefer to have fast path as straight as possible.
1235 * It _is_ time-critical.
1236 */
1237static int do_lookup(struct nameidata *nd, struct qstr *name,
Nick Piggin31e6b012011-01-07 17:49:52 +11001238 struct path *path, struct inode **inode)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001239{
Jan Blunck4ac91372008-02-14 19:34:32 -08001240 struct vfsmount *mnt = nd->path.mnt;
Nick Piggin31e6b012011-01-07 17:49:52 +11001241 struct dentry *dentry, *parent = nd->path.dentry;
Al Viro6e6b1bd2009-08-13 23:38:37 +04001242 struct inode *dir;
David Howells9875cf82011-01-14 18:45:21 +00001243 int err;
1244
Al Viro3cac2602009-08-13 18:27:43 +04001245 /*
1246 * See if the low-level filesystem might want
1247 * to use its own hash..
1248 */
Nick Pigginfb045ad2011-01-07 17:49:55 +11001249 if (unlikely(parent->d_flags & DCACHE_OP_HASH)) {
David Howells9875cf82011-01-14 18:45:21 +00001250 err = parent->d_op->d_hash(parent, nd->inode, name);
Al Viro3cac2602009-08-13 18:27:43 +04001251 if (err < 0)
1252 return err;
1253 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001254
Nick Pigginb04f7842010-08-18 04:37:34 +10001255 /*
1256 * Rename seqlock is not required here because in the off chance
1257 * of a false negative due to a concurrent rename, we're going to
1258 * do the non-racy lookup, below.
1259 */
Nick Piggin31e6b012011-01-07 17:49:52 +11001260 if (nd->flags & LOOKUP_RCU) {
1261 unsigned seq;
1262
1263 *inode = nd->inode;
1264 dentry = __d_lookup_rcu(parent, name, &seq, inode);
1265 if (!dentry) {
1266 if (nameidata_drop_rcu(nd))
1267 return -ECHILD;
1268 goto need_lookup;
1269 }
1270 /* Memory barrier in read_seqcount_begin of child is enough */
1271 if (__read_seqcount_retry(&parent->d_seq, nd->seq))
1272 return -ECHILD;
1273
1274 nd->seq = seq;
Nick Piggin34286d62011-01-07 17:49:57 +11001275 if (dentry->d_flags & DCACHE_OP_REVALIDATE)
Nick Piggin31e6b012011-01-07 17:49:52 +11001276 goto need_revalidate;
Al Viro1a8edf42011-01-15 13:12:53 -05001277done2:
Nick Piggin31e6b012011-01-07 17:49:52 +11001278 path->mnt = mnt;
1279 path->dentry = dentry;
David Howells9875cf82011-01-14 18:45:21 +00001280 if (likely(__follow_mount_rcu(nd, path, inode, false)))
1281 return 0;
1282 if (nameidata_drop_rcu(nd))
1283 return -ECHILD;
1284 /* fallthru */
Nick Piggin31e6b012011-01-07 17:49:52 +11001285 }
David Howells9875cf82011-01-14 18:45:21 +00001286 dentry = __d_lookup(parent, name);
1287 if (!dentry)
1288 goto need_lookup;
1289found:
1290 if (dentry->d_flags & DCACHE_OP_REVALIDATE)
1291 goto need_revalidate;
1292done:
1293 path->mnt = mnt;
1294 path->dentry = dentry;
1295 err = follow_managed(path, nd->flags);
1296 if (unlikely(err < 0))
1297 return err;
1298 *inode = path->dentry->d_inode;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001299 return 0;
1300
1301need_lookup:
Al Viro6e6b1bd2009-08-13 23:38:37 +04001302 dir = parent->d_inode;
Nick Piggin31e6b012011-01-07 17:49:52 +11001303 BUG_ON(nd->inode != dir);
Al Viro6e6b1bd2009-08-13 23:38:37 +04001304
1305 mutex_lock(&dir->i_mutex);
1306 /*
1307 * First re-do the cached lookup just in case it was created
Nick Pigginb04f7842010-08-18 04:37:34 +10001308 * while we waited for the directory semaphore, or the first
1309 * lookup failed due to an unrelated rename.
Al Viro6e6b1bd2009-08-13 23:38:37 +04001310 *
Nick Pigginb04f7842010-08-18 04:37:34 +10001311 * This could use version numbering or similar to avoid unnecessary
1312 * cache lookups, but then we'd have to do the first lookup in the
1313 * non-racy way. However in the common case here, everything should
1314 * be hot in cache, so would it be a big win?
Al Viro6e6b1bd2009-08-13 23:38:37 +04001315 */
1316 dentry = d_lookup(parent, name);
Nick Pigginbaa03892010-08-18 04:37:31 +10001317 if (likely(!dentry)) {
1318 dentry = d_alloc_and_lookup(parent, name, nd);
Al Viro6e6b1bd2009-08-13 23:38:37 +04001319 mutex_unlock(&dir->i_mutex);
1320 if (IS_ERR(dentry))
1321 goto fail;
1322 goto done;
1323 }
Al Viro6e6b1bd2009-08-13 23:38:37 +04001324 /*
1325 * Uhhuh! Nasty case: the cache was re-populated while
1326 * we waited on the semaphore. Need to revalidate.
1327 */
1328 mutex_unlock(&dir->i_mutex);
Nick Piggin2e2e88e2010-08-18 04:37:30 +10001329 goto found;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001330
1331need_revalidate:
Ian Kentbcdc5e02006-09-27 01:50:44 -07001332 dentry = do_revalidate(dentry, nd);
1333 if (!dentry)
1334 goto need_lookup;
1335 if (IS_ERR(dentry))
1336 goto fail;
Al Viro1a8edf42011-01-15 13:12:53 -05001337 if (nd->flags & LOOKUP_RCU)
1338 goto done2;
Ian Kentbcdc5e02006-09-27 01:50:44 -07001339 goto done;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001340
1341fail:
1342 return PTR_ERR(dentry);
1343}
1344
1345/*
1346 * Name resolution.
Prasanna Medaea3834d2005-04-29 16:00:17 +01001347 * This is the basic name resolution function, turning a pathname into
1348 * the final dentry. We expect 'base' to be positive and a directory.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001349 *
Prasanna Medaea3834d2005-04-29 16:00:17 +01001350 * Returns 0 and nd will have valid dentry and mnt on success.
1351 * Returns error and drops reference to input namei data on failure.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001352 */
Al Viro6de88d72009-08-09 01:41:57 +04001353static int link_path_walk(const char *name, struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001354{
1355 struct path next;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001356 int err;
1357 unsigned int lookup_flags = nd->flags;
1358
1359 while (*name=='/')
1360 name++;
1361 if (!*name)
1362 goto return_reval;
1363
Linus Torvalds1da177e2005-04-16 15:20:36 -07001364 if (nd->depth)
Trond Myklebustf55eab82006-02-04 23:28:01 -08001365 lookup_flags = LOOKUP_FOLLOW | (nd->flags & LOOKUP_CONTINUE);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001366
1367 /* At this point we know we have a real path component. */
1368 for(;;) {
Nick Piggin31e6b012011-01-07 17:49:52 +11001369 struct inode *inode;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001370 unsigned long hash;
1371 struct qstr this;
1372 unsigned int c;
1373
Trond Myklebustcdce5d62005-10-18 14:20:18 -07001374 nd->flags |= LOOKUP_CONTINUE;
Nick Piggin31e6b012011-01-07 17:49:52 +11001375 if (nd->flags & LOOKUP_RCU) {
Nick Pigginb74c79e2011-01-07 17:49:58 +11001376 err = exec_permission(nd->inode, IPERM_FLAG_RCU);
Nick Piggin31e6b012011-01-07 17:49:52 +11001377 if (err == -ECHILD) {
1378 if (nameidata_drop_rcu(nd))
1379 return -ECHILD;
1380 goto exec_again;
1381 }
1382 } else {
1383exec_again:
Nick Pigginb74c79e2011-01-07 17:49:58 +11001384 err = exec_permission(nd->inode, 0);
Nick Piggin31e6b012011-01-07 17:49:52 +11001385 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001386 if (err)
1387 break;
1388
1389 this.name = name;
1390 c = *(const unsigned char *)name;
1391
1392 hash = init_name_hash();
1393 do {
1394 name++;
1395 hash = partial_name_hash(c, hash);
1396 c = *(const unsigned char *)name;
1397 } while (c && (c != '/'));
1398 this.len = name - (const char *) this.name;
1399 this.hash = end_name_hash(hash);
1400
1401 /* remove trailing slashes? */
1402 if (!c)
1403 goto last_component;
1404 while (*++name == '/');
1405 if (!*name)
1406 goto last_with_slashes;
1407
1408 /*
1409 * "." and ".." are special - ".." especially so because it has
1410 * to be able to know about the current root directory and
1411 * parent relationships.
1412 */
1413 if (this.name[0] == '.') switch (this.len) {
1414 default:
1415 break;
Nick Piggin31e6b012011-01-07 17:49:52 +11001416 case 2:
Linus Torvalds1da177e2005-04-16 15:20:36 -07001417 if (this.name[1] != '.')
1418 break;
Nick Piggin31e6b012011-01-07 17:49:52 +11001419 if (nd->flags & LOOKUP_RCU) {
1420 if (follow_dotdot_rcu(nd))
1421 return -ECHILD;
1422 } else
1423 follow_dotdot(nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001424 /* fallthrough */
1425 case 1:
1426 continue;
1427 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001428 /* This does the actual lookups.. */
Nick Piggin31e6b012011-01-07 17:49:52 +11001429 err = do_lookup(nd, &this, &next, &inode);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001430 if (err)
1431 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001432 err = -ENOENT;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001433 if (!inode)
1434 goto out_dput;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001435
1436 if (inode->i_op->follow_link) {
Nick Piggin31e6b012011-01-07 17:49:52 +11001437 /* We commonly drop rcu-walk here */
1438 if (nameidata_dentry_drop_rcu_maybe(nd, next.dentry))
1439 return -ECHILD;
1440 BUG_ON(inode != next.dentry->d_inode);
Al Viro90ebe562005-06-06 13:35:58 -07001441 err = do_follow_link(&next, nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001442 if (err)
1443 goto return_err;
Nick Piggin31e6b012011-01-07 17:49:52 +11001444 nd->inode = nd->path.dentry->d_inode;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001445 err = -ENOENT;
Nick Piggin31e6b012011-01-07 17:49:52 +11001446 if (!nd->inode)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001447 break;
Nick Piggin31e6b012011-01-07 17:49:52 +11001448 } else {
Miklos Szeredi09dd17d2005-09-06 15:18:21 -07001449 path_to_nameidata(&next, nd);
Nick Piggin31e6b012011-01-07 17:49:52 +11001450 nd->inode = inode;
1451 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001452 err = -ENOTDIR;
Nick Piggin31e6b012011-01-07 17:49:52 +11001453 if (!nd->inode->i_op->lookup)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001454 break;
1455 continue;
1456 /* here ends the main loop */
1457
1458last_with_slashes:
1459 lookup_flags |= LOOKUP_FOLLOW | LOOKUP_DIRECTORY;
1460last_component:
Trond Myklebustf55eab82006-02-04 23:28:01 -08001461 /* Clear LOOKUP_CONTINUE iff it was previously unset */
1462 nd->flags &= lookup_flags | ~LOOKUP_CONTINUE;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001463 if (lookup_flags & LOOKUP_PARENT)
1464 goto lookup_parent;
1465 if (this.name[0] == '.') switch (this.len) {
1466 default:
1467 break;
Nick Piggin31e6b012011-01-07 17:49:52 +11001468 case 2:
Linus Torvalds1da177e2005-04-16 15:20:36 -07001469 if (this.name[1] != '.')
1470 break;
Nick Piggin31e6b012011-01-07 17:49:52 +11001471 if (nd->flags & LOOKUP_RCU) {
1472 if (follow_dotdot_rcu(nd))
1473 return -ECHILD;
1474 } else
1475 follow_dotdot(nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001476 /* fallthrough */
1477 case 1:
1478 goto return_reval;
1479 }
Nick Piggin31e6b012011-01-07 17:49:52 +11001480 err = do_lookup(nd, &this, &next, &inode);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001481 if (err)
1482 break;
David Howellsdb372912011-01-14 18:45:53 +00001483 if (inode && unlikely(inode->i_op->follow_link) &&
1484 (lookup_flags & LOOKUP_FOLLOW)) {
Nick Piggin31e6b012011-01-07 17:49:52 +11001485 if (nameidata_dentry_drop_rcu_maybe(nd, next.dentry))
1486 return -ECHILD;
1487 BUG_ON(inode != next.dentry->d_inode);
Al Viro90ebe562005-06-06 13:35:58 -07001488 err = do_follow_link(&next, nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001489 if (err)
1490 goto return_err;
Nick Piggin31e6b012011-01-07 17:49:52 +11001491 nd->inode = nd->path.dentry->d_inode;
1492 } else {
Miklos Szeredi09dd17d2005-09-06 15:18:21 -07001493 path_to_nameidata(&next, nd);
Nick Piggin31e6b012011-01-07 17:49:52 +11001494 nd->inode = inode;
1495 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001496 err = -ENOENT;
Nick Piggin31e6b012011-01-07 17:49:52 +11001497 if (!nd->inode)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001498 break;
1499 if (lookup_flags & LOOKUP_DIRECTORY) {
1500 err = -ENOTDIR;
Nick Piggin31e6b012011-01-07 17:49:52 +11001501 if (!nd->inode->i_op->lookup)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001502 break;
1503 }
1504 goto return_base;
1505lookup_parent:
1506 nd->last = this;
1507 nd->last_type = LAST_NORM;
1508 if (this.name[0] != '.')
1509 goto return_base;
1510 if (this.len == 1)
1511 nd->last_type = LAST_DOT;
1512 else if (this.len == 2 && this.name[1] == '.')
1513 nd->last_type = LAST_DOTDOT;
1514 else
1515 goto return_base;
1516return_reval:
1517 /*
1518 * We bypassed the ordinary revalidation routines.
1519 * We may need to check the cached dentry for staleness.
1520 */
Nick Pigginfb045ad2011-01-07 17:49:55 +11001521 if (need_reval_dot(nd->path.dentry)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001522 /* Note: we do not d_invalidate() */
Nick Piggin34286d62011-01-07 17:49:57 +11001523 err = d_revalidate(nd->path.dentry, nd);
1524 if (!err)
1525 err = -ESTALE;
1526 if (err < 0)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001527 break;
1528 }
1529return_base:
Nick Piggin31e6b012011-01-07 17:49:52 +11001530 if (nameidata_drop_rcu_last_maybe(nd))
1531 return -ECHILD;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001532 return 0;
1533out_dput:
Nick Piggin31e6b012011-01-07 17:49:52 +11001534 if (!(nd->flags & LOOKUP_RCU))
1535 path_put_conditional(&next, nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001536 break;
1537 }
Nick Piggin31e6b012011-01-07 17:49:52 +11001538 if (!(nd->flags & LOOKUP_RCU))
1539 path_put(&nd->path);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001540return_err:
1541 return err;
1542}
1543
Nick Piggin31e6b012011-01-07 17:49:52 +11001544static inline int path_walk_rcu(const char *name, struct nameidata *nd)
1545{
1546 current->total_link_count = 0;
1547
1548 return link_path_walk(name, nd);
1549}
1550
1551static inline int path_walk_simple(const char *name, struct nameidata *nd)
1552{
1553 current->total_link_count = 0;
1554
1555 return link_path_walk(name, nd);
1556}
1557
Harvey Harrisonfc9b52c2008-02-08 04:19:52 -08001558static int path_walk(const char *name, struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001559{
Al Viro6de88d72009-08-09 01:41:57 +04001560 struct path save = nd->path;
1561 int result;
1562
Linus Torvalds1da177e2005-04-16 15:20:36 -07001563 current->total_link_count = 0;
Al Viro6de88d72009-08-09 01:41:57 +04001564
1565 /* make sure the stuff we saved doesn't go away */
1566 path_get(&save);
1567
1568 result = link_path_walk(name, nd);
1569 if (result == -ESTALE) {
1570 /* nd->path had been dropped */
1571 current->total_link_count = 0;
1572 nd->path = save;
1573 path_get(&nd->path);
1574 nd->flags |= LOOKUP_REVAL;
1575 result = link_path_walk(name, nd);
1576 }
1577
1578 path_put(&save);
1579
1580 return result;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001581}
1582
Nick Piggin31e6b012011-01-07 17:49:52 +11001583static void path_finish_rcu(struct nameidata *nd)
1584{
1585 if (nd->flags & LOOKUP_RCU) {
1586 /* RCU dangling. Cancel it. */
1587 nd->flags &= ~LOOKUP_RCU;
1588 nd->root.mnt = NULL;
1589 rcu_read_unlock();
1590 br_read_unlock(vfsmount_lock);
1591 }
1592 if (nd->file)
1593 fput(nd->file);
1594}
1595
1596static int path_init_rcu(int dfd, const char *name, unsigned int flags, struct nameidata *nd)
1597{
1598 int retval = 0;
1599 int fput_needed;
1600 struct file *file;
1601
1602 nd->last_type = LAST_ROOT; /* if there are only slashes... */
1603 nd->flags = flags | LOOKUP_RCU;
1604 nd->depth = 0;
1605 nd->root.mnt = NULL;
1606 nd->file = NULL;
1607
1608 if (*name=='/') {
1609 struct fs_struct *fs = current->fs;
Nick Pigginc28cc362011-01-07 17:49:53 +11001610 unsigned seq;
Nick Piggin31e6b012011-01-07 17:49:52 +11001611
1612 br_read_lock(vfsmount_lock);
1613 rcu_read_lock();
1614
Nick Pigginc28cc362011-01-07 17:49:53 +11001615 do {
1616 seq = read_seqcount_begin(&fs->seq);
1617 nd->root = fs->root;
1618 nd->path = nd->root;
1619 nd->seq = __read_seqcount_begin(&nd->path.dentry->d_seq);
1620 } while (read_seqcount_retry(&fs->seq, seq));
Nick Piggin31e6b012011-01-07 17:49:52 +11001621
1622 } else if (dfd == AT_FDCWD) {
1623 struct fs_struct *fs = current->fs;
Nick Pigginc28cc362011-01-07 17:49:53 +11001624 unsigned seq;
Nick Piggin31e6b012011-01-07 17:49:52 +11001625
1626 br_read_lock(vfsmount_lock);
1627 rcu_read_lock();
1628
Nick Pigginc28cc362011-01-07 17:49:53 +11001629 do {
1630 seq = read_seqcount_begin(&fs->seq);
1631 nd->path = fs->pwd;
1632 nd->seq = __read_seqcount_begin(&nd->path.dentry->d_seq);
1633 } while (read_seqcount_retry(&fs->seq, seq));
1634
Nick Piggin31e6b012011-01-07 17:49:52 +11001635 } else {
1636 struct dentry *dentry;
1637
1638 file = fget_light(dfd, &fput_needed);
1639 retval = -EBADF;
1640 if (!file)
1641 goto out_fail;
1642
1643 dentry = file->f_path.dentry;
1644
1645 retval = -ENOTDIR;
1646 if (!S_ISDIR(dentry->d_inode->i_mode))
1647 goto fput_fail;
1648
1649 retval = file_permission(file, MAY_EXEC);
1650 if (retval)
1651 goto fput_fail;
1652
1653 nd->path = file->f_path;
1654 if (fput_needed)
1655 nd->file = file;
1656
Nick Pigginc28cc362011-01-07 17:49:53 +11001657 nd->seq = __read_seqcount_begin(&nd->path.dentry->d_seq);
Nick Piggin31e6b012011-01-07 17:49:52 +11001658 br_read_lock(vfsmount_lock);
1659 rcu_read_lock();
1660 }
1661 nd->inode = nd->path.dentry->d_inode;
1662 return 0;
1663
1664fput_fail:
1665 fput_light(file, fput_needed);
1666out_fail:
1667 return retval;
1668}
1669
Al Viro9b4a9b12009-04-07 11:44:16 -04001670static int path_init(int dfd, const char *name, unsigned int flags, struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001671{
Prasanna Medaea3834d2005-04-29 16:00:17 +01001672 int retval = 0;
Ulrich Drepper170aa3d2006-02-04 23:28:02 -08001673 int fput_needed;
1674 struct file *file;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001675
1676 nd->last_type = LAST_ROOT; /* if there are only slashes... */
1677 nd->flags = flags;
1678 nd->depth = 0;
Al Viro2a737872009-04-07 11:49:53 -04001679 nd->root.mnt = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001680
Linus Torvalds1da177e2005-04-16 15:20:36 -07001681 if (*name=='/') {
Al Viro2a737872009-04-07 11:49:53 -04001682 set_root(nd);
1683 nd->path = nd->root;
1684 path_get(&nd->root);
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001685 } else if (dfd == AT_FDCWD) {
Miklos Szeredif7ad3c62010-08-10 11:41:36 +02001686 get_fs_pwd(current->fs, &nd->path);
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001687 } else {
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001688 struct dentry *dentry;
1689
1690 file = fget_light(dfd, &fput_needed);
Ulrich Drepper170aa3d2006-02-04 23:28:02 -08001691 retval = -EBADF;
1692 if (!file)
Trond Myklebust6d09bb62006-06-04 02:51:37 -07001693 goto out_fail;
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001694
Josef "Jeff" Sipek0f7fc9e2006-12-08 02:36:35 -08001695 dentry = file->f_path.dentry;
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001696
Ulrich Drepper170aa3d2006-02-04 23:28:02 -08001697 retval = -ENOTDIR;
1698 if (!S_ISDIR(dentry->d_inode->i_mode))
Trond Myklebust6d09bb62006-06-04 02:51:37 -07001699 goto fput_fail;
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001700
1701 retval = file_permission(file, MAY_EXEC);
Ulrich Drepper170aa3d2006-02-04 23:28:02 -08001702 if (retval)
Trond Myklebust6d09bb62006-06-04 02:51:37 -07001703 goto fput_fail;
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001704
Jan Blunck5dd784d2008-02-14 19:34:38 -08001705 nd->path = file->f_path;
1706 path_get(&file->f_path);
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001707
1708 fput_light(file, fput_needed);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001709 }
Nick Piggin31e6b012011-01-07 17:49:52 +11001710 nd->inode = nd->path.dentry->d_inode;
Al Viro9b4a9b12009-04-07 11:44:16 -04001711 return 0;
Ulrich Drepper170aa3d2006-02-04 23:28:02 -08001712
Trond Myklebust6d09bb62006-06-04 02:51:37 -07001713fput_fail:
Ulrich Drepper170aa3d2006-02-04 23:28:02 -08001714 fput_light(file, fput_needed);
Al Viro9b4a9b12009-04-07 11:44:16 -04001715out_fail:
1716 return retval;
1717}
1718
1719/* Returns 0 and nd will be valid on success; Retuns error, otherwise. */
1720static int do_path_lookup(int dfd, const char *name,
1721 unsigned int flags, struct nameidata *nd)
1722{
Nick Piggin31e6b012011-01-07 17:49:52 +11001723 int retval;
1724
1725 /*
1726 * Path walking is largely split up into 2 different synchronisation
1727 * schemes, rcu-walk and ref-walk (explained in
1728 * Documentation/filesystems/path-lookup.txt). These share much of the
1729 * path walk code, but some things particularly setup, cleanup, and
1730 * following mounts are sufficiently divergent that functions are
1731 * duplicated. Typically there is a function foo(), and its RCU
1732 * analogue, foo_rcu().
1733 *
1734 * -ECHILD is the error number of choice (just to avoid clashes) that
1735 * is returned if some aspect of an rcu-walk fails. Such an error must
1736 * be handled by restarting a traditional ref-walk (which will always
1737 * be able to complete).
1738 */
1739 retval = path_init_rcu(dfd, name, flags, nd);
1740 if (unlikely(retval))
1741 return retval;
1742 retval = path_walk_rcu(name, nd);
1743 path_finish_rcu(nd);
Al Viro2a737872009-04-07 11:49:53 -04001744 if (nd->root.mnt) {
1745 path_put(&nd->root);
1746 nd->root.mnt = NULL;
1747 }
Nick Piggin31e6b012011-01-07 17:49:52 +11001748
1749 if (unlikely(retval == -ECHILD || retval == -ESTALE)) {
1750 /* slower, locked walk */
1751 if (retval == -ESTALE)
1752 flags |= LOOKUP_REVAL;
1753 retval = path_init(dfd, name, flags, nd);
1754 if (unlikely(retval))
1755 return retval;
1756 retval = path_walk(name, nd);
1757 if (nd->root.mnt) {
1758 path_put(&nd->root);
1759 nd->root.mnt = NULL;
1760 }
1761 }
1762
1763 if (likely(!retval)) {
1764 if (unlikely(!audit_dummy_context())) {
1765 if (nd->path.dentry && nd->inode)
1766 audit_inode(name, nd->path.dentry);
1767 }
1768 }
1769
Al Viro9b4a9b12009-04-07 11:44:16 -04001770 return retval;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001771}
1772
Harvey Harrisonfc9b52c2008-02-08 04:19:52 -08001773int path_lookup(const char *name, unsigned int flags,
Ulrich Drepper5590ff02006-01-18 17:43:53 -08001774 struct nameidata *nd)
1775{
1776 return do_path_lookup(AT_FDCWD, name, flags, nd);
1777}
1778
Al Virod1811462008-08-02 00:49:18 -04001779int kern_path(const char *name, unsigned int flags, struct path *path)
1780{
1781 struct nameidata nd;
1782 int res = do_path_lookup(AT_FDCWD, name, flags, &nd);
1783 if (!res)
1784 *path = nd.path;
1785 return res;
1786}
1787
Josef 'Jeff' Sipek16f18202007-07-19 01:48:18 -07001788/**
1789 * vfs_path_lookup - lookup a file path relative to a dentry-vfsmount pair
1790 * @dentry: pointer to dentry of the base directory
1791 * @mnt: pointer to vfs mount of the base directory
1792 * @name: pointer to file name
1793 * @flags: lookup flags
1794 * @nd: pointer to nameidata
1795 */
1796int vfs_path_lookup(struct dentry *dentry, struct vfsmount *mnt,
1797 const char *name, unsigned int flags,
1798 struct nameidata *nd)
1799{
1800 int retval;
1801
1802 /* same as do_path_lookup */
1803 nd->last_type = LAST_ROOT;
1804 nd->flags = flags;
1805 nd->depth = 0;
1806
Jan Blunckc8e7f442008-06-09 16:40:35 -07001807 nd->path.dentry = dentry;
1808 nd->path.mnt = mnt;
1809 path_get(&nd->path);
Al Viro5b857112009-04-07 11:53:49 -04001810 nd->root = nd->path;
1811 path_get(&nd->root);
Nick Piggin31e6b012011-01-07 17:49:52 +11001812 nd->inode = nd->path.dentry->d_inode;
Josef 'Jeff' Sipek16f18202007-07-19 01:48:18 -07001813
1814 retval = path_walk(name, nd);
Jan Blunck4ac91372008-02-14 19:34:32 -08001815 if (unlikely(!retval && !audit_dummy_context() && nd->path.dentry &&
Nick Piggin31e6b012011-01-07 17:49:52 +11001816 nd->inode))
Jan Blunck4ac91372008-02-14 19:34:32 -08001817 audit_inode(name, nd->path.dentry);
Josef 'Jeff' Sipek16f18202007-07-19 01:48:18 -07001818
Al Viro5b857112009-04-07 11:53:49 -04001819 path_put(&nd->root);
1820 nd->root.mnt = NULL;
Josef 'Jeff' Sipek16f18202007-07-19 01:48:18 -07001821
Al Viro2a737872009-04-07 11:49:53 -04001822 return retval;
Josef 'Jeff' Sipek16f18202007-07-19 01:48:18 -07001823}
1824
Christoph Hellwigeead1912007-10-16 23:25:38 -07001825static struct dentry *__lookup_hash(struct qstr *name,
1826 struct dentry *base, struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001827{
Christoph Hellwig81fca442010-10-06 10:47:47 +02001828 struct inode *inode = base->d_inode;
James Morris057f6c02007-04-26 00:12:05 -07001829 struct dentry *dentry;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001830 int err;
1831
Nick Pigginb74c79e2011-01-07 17:49:58 +11001832 err = exec_permission(inode, 0);
Christoph Hellwig81fca442010-10-06 10:47:47 +02001833 if (err)
1834 return ERR_PTR(err);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001835
1836 /*
1837 * See if the low-level filesystem might want
1838 * to use its own hash..
1839 */
Nick Pigginfb045ad2011-01-07 17:49:55 +11001840 if (base->d_flags & DCACHE_OP_HASH) {
Nick Pigginb1e6a012011-01-07 17:49:28 +11001841 err = base->d_op->d_hash(base, inode, name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001842 dentry = ERR_PTR(err);
1843 if (err < 0)
1844 goto out;
1845 }
1846
Nick Pigginb04f7842010-08-18 04:37:34 +10001847 /*
1848 * Don't bother with __d_lookup: callers are for creat as
1849 * well as unlink, so a lot of the time it would cost
1850 * a double lookup.
Al Viro6e6b1bd2009-08-13 23:38:37 +04001851 */
Nick Pigginb04f7842010-08-18 04:37:34 +10001852 dentry = d_lookup(base, name);
Al Viro6e6b1bd2009-08-13 23:38:37 +04001853
Nick Pigginfb045ad2011-01-07 17:49:55 +11001854 if (dentry && (dentry->d_flags & DCACHE_OP_REVALIDATE))
Al Viro6e6b1bd2009-08-13 23:38:37 +04001855 dentry = do_revalidate(dentry, nd);
1856
Nick Pigginbaa03892010-08-18 04:37:31 +10001857 if (!dentry)
1858 dentry = d_alloc_and_lookup(base, name, nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001859out:
1860 return dentry;
1861}
1862
James Morris057f6c02007-04-26 00:12:05 -07001863/*
1864 * Restricted form of lookup. Doesn't follow links, single-component only,
1865 * needs parent already locked. Doesn't follow mounts.
1866 * SMP-safe.
1867 */
Adrian Bunka244e162006-03-31 02:32:11 -08001868static struct dentry *lookup_hash(struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001869{
Jan Blunck4ac91372008-02-14 19:34:32 -08001870 return __lookup_hash(&nd->last, nd->path.dentry, nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001871}
1872
Christoph Hellwigeead1912007-10-16 23:25:38 -07001873static int __lookup_one_len(const char *name, struct qstr *this,
1874 struct dentry *base, int len)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001875{
1876 unsigned long hash;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001877 unsigned int c;
1878
James Morris057f6c02007-04-26 00:12:05 -07001879 this->name = name;
1880 this->len = len;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001881 if (!len)
James Morris057f6c02007-04-26 00:12:05 -07001882 return -EACCES;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001883
1884 hash = init_name_hash();
1885 while (len--) {
1886 c = *(const unsigned char *)name++;
1887 if (c == '/' || c == '\0')
James Morris057f6c02007-04-26 00:12:05 -07001888 return -EACCES;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001889 hash = partial_name_hash(c, hash);
1890 }
James Morris057f6c02007-04-26 00:12:05 -07001891 this->hash = end_name_hash(hash);
1892 return 0;
1893}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001894
Christoph Hellwigeead1912007-10-16 23:25:38 -07001895/**
Randy Dunlapa6b91912008-03-19 17:01:00 -07001896 * lookup_one_len - filesystem helper to lookup single pathname component
Christoph Hellwigeead1912007-10-16 23:25:38 -07001897 * @name: pathname component to lookup
1898 * @base: base directory to lookup from
1899 * @len: maximum length @len should be interpreted to
1900 *
Randy Dunlapa6b91912008-03-19 17:01:00 -07001901 * Note that this routine is purely a helper for filesystem usage and should
1902 * not be called by generic code. Also note that by using this function the
Christoph Hellwigeead1912007-10-16 23:25:38 -07001903 * nameidata argument is passed to the filesystem methods and a filesystem
1904 * using this helper needs to be prepared for that.
1905 */
James Morris057f6c02007-04-26 00:12:05 -07001906struct dentry *lookup_one_len(const char *name, struct dentry *base, int len)
1907{
1908 int err;
1909 struct qstr this;
1910
David Woodhouse2f9092e2009-04-20 23:18:37 +01001911 WARN_ON_ONCE(!mutex_is_locked(&base->d_inode->i_mutex));
1912
James Morris057f6c02007-04-26 00:12:05 -07001913 err = __lookup_one_len(name, &this, base, len);
1914 if (err)
1915 return ERR_PTR(err);
Christoph Hellwigeead1912007-10-16 23:25:38 -07001916
Christoph Hellwig49705b72005-11-08 21:35:06 -08001917 return __lookup_hash(&this, base, NULL);
James Morris057f6c02007-04-26 00:12:05 -07001918}
1919
Al Viro2d8f3032008-07-22 09:59:21 -04001920int user_path_at(int dfd, const char __user *name, unsigned flags,
1921 struct path *path)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001922{
Al Viro2d8f3032008-07-22 09:59:21 -04001923 struct nameidata nd;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001924 char *tmp = getname(name);
1925 int err = PTR_ERR(tmp);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001926 if (!IS_ERR(tmp)) {
Al Viro2d8f3032008-07-22 09:59:21 -04001927
1928 BUG_ON(flags & LOOKUP_PARENT);
1929
1930 err = do_path_lookup(dfd, tmp, flags, &nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001931 putname(tmp);
Al Viro2d8f3032008-07-22 09:59:21 -04001932 if (!err)
1933 *path = nd.path;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001934 }
1935 return err;
1936}
1937
Al Viro2ad94ae2008-07-21 09:32:51 -04001938static int user_path_parent(int dfd, const char __user *path,
1939 struct nameidata *nd, char **name)
1940{
1941 char *s = getname(path);
1942 int error;
1943
1944 if (IS_ERR(s))
1945 return PTR_ERR(s);
1946
1947 error = do_path_lookup(dfd, s, LOOKUP_PARENT, nd);
1948 if (error)
1949 putname(s);
1950 else
1951 *name = s;
1952
1953 return error;
1954}
1955
Linus Torvalds1da177e2005-04-16 15:20:36 -07001956/*
1957 * It's inline, so penalty for filesystems that don't use sticky bit is
1958 * minimal.
1959 */
1960static inline int check_sticky(struct inode *dir, struct inode *inode)
1961{
David Howellsda9592e2008-11-14 10:39:05 +11001962 uid_t fsuid = current_fsuid();
1963
Linus Torvalds1da177e2005-04-16 15:20:36 -07001964 if (!(dir->i_mode & S_ISVTX))
1965 return 0;
David Howellsda9592e2008-11-14 10:39:05 +11001966 if (inode->i_uid == fsuid)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001967 return 0;
David Howellsda9592e2008-11-14 10:39:05 +11001968 if (dir->i_uid == fsuid)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001969 return 0;
1970 return !capable(CAP_FOWNER);
1971}
1972
1973/*
1974 * Check whether we can remove a link victim from directory dir, check
1975 * whether the type of victim is right.
1976 * 1. We can't do it if dir is read-only (done in permission())
1977 * 2. We should have write and exec permissions on dir
1978 * 3. We can't remove anything from append-only dir
1979 * 4. We can't do anything with immutable dir (done in permission())
1980 * 5. If the sticky bit on dir is set we should either
1981 * a. be owner of dir, or
1982 * b. be owner of victim, or
1983 * c. have CAP_FOWNER capability
1984 * 6. If the victim is append-only or immutable we can't do antyhing with
1985 * links pointing to it.
1986 * 7. If we were asked to remove a directory and victim isn't one - ENOTDIR.
1987 * 8. If we were asked to remove a non-directory and victim isn't one - EISDIR.
1988 * 9. We can't remove a root or mountpoint.
1989 * 10. We don't allow removal of NFS sillyrenamed files; it's handled by
1990 * nfs_async_unlink().
1991 */
Arjan van de Ven858119e2006-01-14 13:20:43 -08001992static int may_delete(struct inode *dir,struct dentry *victim,int isdir)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001993{
1994 int error;
1995
1996 if (!victim->d_inode)
1997 return -ENOENT;
1998
1999 BUG_ON(victim->d_parent->d_inode != dir);
Al Virocccc6bb2009-12-25 05:07:33 -05002000 audit_inode_child(victim, dir);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002001
Al Virof419a2e2008-07-22 00:07:17 -04002002 error = inode_permission(dir, MAY_WRITE | MAY_EXEC);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002003 if (error)
2004 return error;
2005 if (IS_APPEND(dir))
2006 return -EPERM;
2007 if (check_sticky(dir, victim->d_inode)||IS_APPEND(victim->d_inode)||
Hugh Dickinsf9454542008-11-19 15:36:38 -08002008 IS_IMMUTABLE(victim->d_inode) || IS_SWAPFILE(victim->d_inode))
Linus Torvalds1da177e2005-04-16 15:20:36 -07002009 return -EPERM;
2010 if (isdir) {
2011 if (!S_ISDIR(victim->d_inode->i_mode))
2012 return -ENOTDIR;
2013 if (IS_ROOT(victim))
2014 return -EBUSY;
2015 } else if (S_ISDIR(victim->d_inode->i_mode))
2016 return -EISDIR;
2017 if (IS_DEADDIR(dir))
2018 return -ENOENT;
2019 if (victim->d_flags & DCACHE_NFSFS_RENAMED)
2020 return -EBUSY;
2021 return 0;
2022}
2023
2024/* Check whether we can create an object with dentry child in directory
2025 * dir.
2026 * 1. We can't do it if child already exists (open has special treatment for
2027 * this case, but since we are inlined it's OK)
2028 * 2. We can't do it if dir is read-only (done in permission())
2029 * 3. We should have write and exec permissions on dir
2030 * 4. We can't do it if dir is immutable (done in permission())
2031 */
Miklos Szeredia95164d2008-07-30 15:08:48 +02002032static inline int may_create(struct inode *dir, struct dentry *child)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002033{
2034 if (child->d_inode)
2035 return -EEXIST;
2036 if (IS_DEADDIR(dir))
2037 return -ENOENT;
Al Virof419a2e2008-07-22 00:07:17 -04002038 return inode_permission(dir, MAY_WRITE | MAY_EXEC);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002039}
2040
Linus Torvalds1da177e2005-04-16 15:20:36 -07002041/*
2042 * p1 and p2 should be directories on the same fs.
2043 */
2044struct dentry *lock_rename(struct dentry *p1, struct dentry *p2)
2045{
2046 struct dentry *p;
2047
2048 if (p1 == p2) {
Ingo Molnarf2eace22006-07-03 00:25:05 -07002049 mutex_lock_nested(&p1->d_inode->i_mutex, I_MUTEX_PARENT);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002050 return NULL;
2051 }
2052
Arjan van de Vena11f3a02006-03-23 03:00:33 -08002053 mutex_lock(&p1->d_inode->i_sb->s_vfs_rename_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002054
OGAWA Hirofumie2761a12008-10-16 07:50:28 +09002055 p = d_ancestor(p2, p1);
2056 if (p) {
2057 mutex_lock_nested(&p2->d_inode->i_mutex, I_MUTEX_PARENT);
2058 mutex_lock_nested(&p1->d_inode->i_mutex, I_MUTEX_CHILD);
2059 return p;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002060 }
2061
OGAWA Hirofumie2761a12008-10-16 07:50:28 +09002062 p = d_ancestor(p1, p2);
2063 if (p) {
2064 mutex_lock_nested(&p1->d_inode->i_mutex, I_MUTEX_PARENT);
2065 mutex_lock_nested(&p2->d_inode->i_mutex, I_MUTEX_CHILD);
2066 return p;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002067 }
2068
Ingo Molnarf2eace22006-07-03 00:25:05 -07002069 mutex_lock_nested(&p1->d_inode->i_mutex, I_MUTEX_PARENT);
2070 mutex_lock_nested(&p2->d_inode->i_mutex, I_MUTEX_CHILD);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002071 return NULL;
2072}
2073
2074void unlock_rename(struct dentry *p1, struct dentry *p2)
2075{
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002076 mutex_unlock(&p1->d_inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002077 if (p1 != p2) {
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002078 mutex_unlock(&p2->d_inode->i_mutex);
Arjan van de Vena11f3a02006-03-23 03:00:33 -08002079 mutex_unlock(&p1->d_inode->i_sb->s_vfs_rename_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002080 }
2081}
2082
2083int vfs_create(struct inode *dir, struct dentry *dentry, int mode,
2084 struct nameidata *nd)
2085{
Miklos Szeredia95164d2008-07-30 15:08:48 +02002086 int error = may_create(dir, dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002087
2088 if (error)
2089 return error;
2090
Al Viroacfa4382008-12-04 10:06:33 -05002091 if (!dir->i_op->create)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002092 return -EACCES; /* shouldn't it be ENOSYS? */
2093 mode &= S_IALLUGO;
2094 mode |= S_IFREG;
2095 error = security_inode_create(dir, dentry, mode);
2096 if (error)
2097 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002098 error = dir->i_op->create(dir, dentry, mode, nd);
Stephen Smalleya74574a2005-09-09 13:01:44 -07002099 if (!error)
Amy Griffisf38aa942005-11-03 15:57:06 +00002100 fsnotify_create(dir, dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002101 return error;
2102}
2103
Christoph Hellwig3fb64192008-10-24 09:58:10 +02002104int may_open(struct path *path, int acc_mode, int flag)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002105{
Christoph Hellwig3fb64192008-10-24 09:58:10 +02002106 struct dentry *dentry = path->dentry;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002107 struct inode *inode = dentry->d_inode;
2108 int error;
2109
2110 if (!inode)
2111 return -ENOENT;
2112
Christoph Hellwigc8fe8f32009-01-05 19:27:23 +01002113 switch (inode->i_mode & S_IFMT) {
2114 case S_IFLNK:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002115 return -ELOOP;
Christoph Hellwigc8fe8f32009-01-05 19:27:23 +01002116 case S_IFDIR:
2117 if (acc_mode & MAY_WRITE)
2118 return -EISDIR;
2119 break;
2120 case S_IFBLK:
2121 case S_IFCHR:
Christoph Hellwig3fb64192008-10-24 09:58:10 +02002122 if (path->mnt->mnt_flags & MNT_NODEV)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002123 return -EACCES;
Christoph Hellwigc8fe8f32009-01-05 19:27:23 +01002124 /*FALLTHRU*/
2125 case S_IFIFO:
2126 case S_IFSOCK:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002127 flag &= ~O_TRUNC;
Christoph Hellwigc8fe8f32009-01-05 19:27:23 +01002128 break;
Dave Hansen4a3fd212008-02-15 14:37:48 -08002129 }
Dave Hansenb41572e2007-10-16 23:31:14 -07002130
Christoph Hellwig3fb64192008-10-24 09:58:10 +02002131 error = inode_permission(inode, acc_mode);
Dave Hansenb41572e2007-10-16 23:31:14 -07002132 if (error)
2133 return error;
Mimi Zohar6146f0d2009-02-04 09:06:57 -05002134
Linus Torvalds1da177e2005-04-16 15:20:36 -07002135 /*
2136 * An append-only file must be opened in append mode for writing.
2137 */
2138 if (IS_APPEND(inode)) {
Al Viro8737c932009-12-24 06:47:55 -05002139 if ((flag & O_ACCMODE) != O_RDONLY && !(flag & O_APPEND))
Al Viro7715b522009-12-16 03:54:00 -05002140 return -EPERM;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002141 if (flag & O_TRUNC)
Al Viro7715b522009-12-16 03:54:00 -05002142 return -EPERM;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002143 }
2144
2145 /* O_NOATIME can only be set by the owner or superuser */
Al Viro7715b522009-12-16 03:54:00 -05002146 if (flag & O_NOATIME && !is_owner_or_cap(inode))
2147 return -EPERM;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002148
2149 /*
2150 * Ensure there are no outstanding leases on the file.
2151 */
Al Virob65a9cf2009-12-16 06:27:40 -05002152 return break_lease(inode, flag);
Al Viro7715b522009-12-16 03:54:00 -05002153}
Linus Torvalds1da177e2005-04-16 15:20:36 -07002154
Jeff Laytone1181ee2010-12-07 16:19:50 -05002155static int handle_truncate(struct file *filp)
Al Viro7715b522009-12-16 03:54:00 -05002156{
Jeff Laytone1181ee2010-12-07 16:19:50 -05002157 struct path *path = &filp->f_path;
Al Viro7715b522009-12-16 03:54:00 -05002158 struct inode *inode = path->dentry->d_inode;
2159 int error = get_write_access(inode);
2160 if (error)
2161 return error;
2162 /*
2163 * Refuse to truncate files with mandatory locks held on them.
2164 */
2165 error = locks_verify_locked(inode);
2166 if (!error)
Tetsuo Handaea0d3ab2010-06-02 13:24:43 +09002167 error = security_path_truncate(path);
Al Viro7715b522009-12-16 03:54:00 -05002168 if (!error) {
2169 error = do_truncate(path->dentry, 0,
2170 ATTR_MTIME|ATTR_CTIME|ATTR_OPEN,
Jeff Laytone1181ee2010-12-07 16:19:50 -05002171 filp);
Al Viro7715b522009-12-16 03:54:00 -05002172 }
2173 put_write_access(inode);
Mimi Zoharacd0c932009-09-04 13:08:46 -04002174 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002175}
2176
Dave Hansend57999e2008-02-15 14:37:27 -08002177/*
2178 * Be careful about ever adding any more callers of this
2179 * function. Its flags must be in the namei format, not
2180 * what get passed to sys_open().
2181 */
2182static int __open_namei_create(struct nameidata *nd, struct path *path,
Al Viro8737c932009-12-24 06:47:55 -05002183 int open_flag, int mode)
Dave Hansenaab520e2006-09-30 23:29:02 -07002184{
2185 int error;
Jan Blunck4ac91372008-02-14 19:34:32 -08002186 struct dentry *dir = nd->path.dentry;
Dave Hansenaab520e2006-09-30 23:29:02 -07002187
2188 if (!IS_POSIXACL(dir->d_inode))
Al Viroce3b0f82009-03-29 19:08:22 -04002189 mode &= ~current_umask();
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09002190 error = security_path_mknod(&nd->path, path->dentry, mode, 0);
2191 if (error)
2192 goto out_unlock;
Dave Hansenaab520e2006-09-30 23:29:02 -07002193 error = vfs_create(dir->d_inode, path->dentry, mode, nd);
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09002194out_unlock:
Dave Hansenaab520e2006-09-30 23:29:02 -07002195 mutex_unlock(&dir->d_inode->i_mutex);
Jan Blunck4ac91372008-02-14 19:34:32 -08002196 dput(nd->path.dentry);
2197 nd->path.dentry = path->dentry;
Nick Piggin31e6b012011-01-07 17:49:52 +11002198
Dave Hansenaab520e2006-09-30 23:29:02 -07002199 if (error)
2200 return error;
2201 /* Don't check for write permission, don't truncate */
Al Viro8737c932009-12-24 06:47:55 -05002202 return may_open(&nd->path, 0, open_flag & ~O_TRUNC);
Dave Hansenaab520e2006-09-30 23:29:02 -07002203}
2204
Linus Torvalds1da177e2005-04-16 15:20:36 -07002205/*
Dave Hansend57999e2008-02-15 14:37:27 -08002206 * Note that while the flag value (low two bits) for sys_open means:
2207 * 00 - read-only
2208 * 01 - write-only
2209 * 10 - read-write
2210 * 11 - special
2211 * it is changed into
2212 * 00 - no permissions needed
2213 * 01 - read-permission
2214 * 10 - write-permission
2215 * 11 - read-write
2216 * for the internal routines (ie open_namei()/follow_link() etc)
2217 * This is more logical, and also allows the 00 "no perm needed"
2218 * to be used for symlinks (where the permissions are checked
2219 * later).
2220 *
2221*/
2222static inline int open_to_namei_flags(int flag)
2223{
2224 if ((flag+1) & O_ACCMODE)
2225 flag++;
2226 return flag;
2227}
2228
Al Viro7715b522009-12-16 03:54:00 -05002229static int open_will_truncate(int flag, struct inode *inode)
Dave Hansen4a3fd212008-02-15 14:37:48 -08002230{
2231 /*
2232 * We'll never write to the fs underlying
2233 * a device file.
2234 */
2235 if (special_file(inode->i_mode))
2236 return 0;
2237 return (flag & O_TRUNC);
2238}
2239
Al Viro648fa862009-12-24 01:26:48 -05002240static struct file *finish_open(struct nameidata *nd,
Al Viro9a661792009-12-24 06:49:47 -05002241 int open_flag, int acc_mode)
Al Viro648fa862009-12-24 01:26:48 -05002242{
2243 struct file *filp;
2244 int will_truncate;
2245 int error;
2246
Al Viro9a661792009-12-24 06:49:47 -05002247 will_truncate = open_will_truncate(open_flag, nd->path.dentry->d_inode);
Al Viro648fa862009-12-24 01:26:48 -05002248 if (will_truncate) {
2249 error = mnt_want_write(nd->path.mnt);
2250 if (error)
2251 goto exit;
2252 }
2253 error = may_open(&nd->path, acc_mode, open_flag);
2254 if (error) {
2255 if (will_truncate)
2256 mnt_drop_write(nd->path.mnt);
2257 goto exit;
2258 }
2259 filp = nameidata_to_filp(nd);
2260 if (!IS_ERR(filp)) {
2261 error = ima_file_check(filp, acc_mode);
2262 if (error) {
2263 fput(filp);
2264 filp = ERR_PTR(error);
2265 }
2266 }
2267 if (!IS_ERR(filp)) {
Al Viro648fa862009-12-24 01:26:48 -05002268 if (will_truncate) {
Jeff Laytone1181ee2010-12-07 16:19:50 -05002269 error = handle_truncate(filp);
Al Viro648fa862009-12-24 01:26:48 -05002270 if (error) {
2271 fput(filp);
2272 filp = ERR_PTR(error);
2273 }
2274 }
2275 }
2276 /*
2277 * It is now safe to drop the mnt write
2278 * because the filp has had a write taken
2279 * on its behalf.
2280 */
2281 if (will_truncate)
2282 mnt_drop_write(nd->path.mnt);
Al Virod893f1b2010-10-29 03:30:42 -04002283 path_put(&nd->path);
Al Viro648fa862009-12-24 01:26:48 -05002284 return filp;
2285
2286exit:
2287 if (!IS_ERR(nd->intent.open.file))
2288 release_open_intent(nd);
2289 path_put(&nd->path);
2290 return ERR_PTR(error);
2291}
2292
Nick Piggin31e6b012011-01-07 17:49:52 +11002293/*
2294 * Handle O_CREAT case for do_filp_open
2295 */
Al Virofb1cc552009-12-24 01:58:28 -05002296static struct file *do_last(struct nameidata *nd, struct path *path,
Al Viro5b369df2009-12-24 06:51:13 -05002297 int open_flag, int acc_mode,
Al Viro3e297b62010-03-26 12:40:13 -04002298 int mode, const char *pathname)
Al Virofb1cc552009-12-24 01:58:28 -05002299{
Al Viroa1e28032009-12-24 02:12:06 -05002300 struct dentry *dir = nd->path.dentry;
Al Virofb1cc552009-12-24 01:58:28 -05002301 struct file *filp;
Al Viro1f36f772009-12-26 10:56:19 -05002302 int error = -EISDIR;
Al Virofb1cc552009-12-24 01:58:28 -05002303
Al Viro1f36f772009-12-26 10:56:19 -05002304 switch (nd->last_type) {
2305 case LAST_DOTDOT:
2306 follow_dotdot(nd);
2307 dir = nd->path.dentry;
Neil Brown176306f2010-05-24 16:57:56 +10002308 case LAST_DOT:
Nick Pigginfb045ad2011-01-07 17:49:55 +11002309 if (need_reval_dot(dir)) {
J. R. Okajimaf20877d2011-01-14 03:56:04 +00002310 int status = d_revalidate(nd->path.dentry, nd);
2311 if (!status)
2312 status = -ESTALE;
2313 if (status < 0) {
2314 error = status;
Al Viro1f36f772009-12-26 10:56:19 -05002315 goto exit;
J. R. Okajimaf20877d2011-01-14 03:56:04 +00002316 }
Al Viro1f36f772009-12-26 10:56:19 -05002317 }
2318 /* fallthrough */
Al Viro1f36f772009-12-26 10:56:19 -05002319 case LAST_ROOT:
Nick Piggin31e6b012011-01-07 17:49:52 +11002320 goto exit;
Al Viro1f36f772009-12-26 10:56:19 -05002321 case LAST_BIND:
2322 audit_inode(pathname, dir);
Al Viro67ee3ad2009-12-26 07:01:01 -05002323 goto ok;
Al Viro1f36f772009-12-26 10:56:19 -05002324 }
Al Viro67ee3ad2009-12-26 07:01:01 -05002325
Al Viro1f36f772009-12-26 10:56:19 -05002326 /* trailing slashes? */
Nick Piggin31e6b012011-01-07 17:49:52 +11002327 if (nd->last.name[nd->last.len])
2328 goto exit;
Al Viroa2c36b42009-12-24 03:39:50 -05002329
Al Viroa1e28032009-12-24 02:12:06 -05002330 mutex_lock(&dir->d_inode->i_mutex);
2331
2332 path->dentry = lookup_hash(nd);
2333 path->mnt = nd->path.mnt;
2334
Al Virofb1cc552009-12-24 01:58:28 -05002335 error = PTR_ERR(path->dentry);
2336 if (IS_ERR(path->dentry)) {
2337 mutex_unlock(&dir->d_inode->i_mutex);
2338 goto exit;
2339 }
2340
2341 if (IS_ERR(nd->intent.open.file)) {
2342 error = PTR_ERR(nd->intent.open.file);
2343 goto exit_mutex_unlock;
2344 }
2345
2346 /* Negative dentry, just create the file */
2347 if (!path->dentry->d_inode) {
2348 /*
2349 * This write is needed to ensure that a
2350 * ro->rw transition does not occur between
2351 * the time when the file is created and when
2352 * a permanent write count is taken through
2353 * the 'struct file' in nameidata_to_filp().
2354 */
2355 error = mnt_want_write(nd->path.mnt);
2356 if (error)
2357 goto exit_mutex_unlock;
2358 error = __open_namei_create(nd, path, open_flag, mode);
2359 if (error) {
2360 mnt_drop_write(nd->path.mnt);
2361 goto exit;
2362 }
2363 filp = nameidata_to_filp(nd);
2364 mnt_drop_write(nd->path.mnt);
Al Virod893f1b2010-10-29 03:30:42 -04002365 path_put(&nd->path);
Al Virofb1cc552009-12-24 01:58:28 -05002366 if (!IS_ERR(filp)) {
2367 error = ima_file_check(filp, acc_mode);
2368 if (error) {
2369 fput(filp);
2370 filp = ERR_PTR(error);
2371 }
2372 }
2373 return filp;
2374 }
2375
2376 /*
2377 * It already exists.
2378 */
2379 mutex_unlock(&dir->d_inode->i_mutex);
2380 audit_inode(pathname, path->dentry);
2381
2382 error = -EEXIST;
Al Viro5b369df2009-12-24 06:51:13 -05002383 if (open_flag & O_EXCL)
Al Virofb1cc552009-12-24 01:58:28 -05002384 goto exit_dput;
2385
David Howells9875cf82011-01-14 18:45:21 +00002386 error = follow_managed(path, nd->flags);
2387 if (error < 0)
2388 goto exit_dput;
Al Virofb1cc552009-12-24 01:58:28 -05002389
2390 error = -ENOENT;
2391 if (!path->dentry->d_inode)
2392 goto exit_dput;
Al Viro9e67f362009-12-26 07:04:50 -05002393
2394 if (path->dentry->d_inode->i_op->follow_link)
Al Virofb1cc552009-12-24 01:58:28 -05002395 return NULL;
Al Virofb1cc552009-12-24 01:58:28 -05002396
2397 path_to_nameidata(path, nd);
Nick Piggin31e6b012011-01-07 17:49:52 +11002398 nd->inode = path->dentry->d_inode;
Al Virofb1cc552009-12-24 01:58:28 -05002399 error = -EISDIR;
Nick Piggin31e6b012011-01-07 17:49:52 +11002400 if (S_ISDIR(nd->inode->i_mode))
Al Virofb1cc552009-12-24 01:58:28 -05002401 goto exit;
Al Viro67ee3ad2009-12-26 07:01:01 -05002402ok:
Al Viro9a661792009-12-24 06:49:47 -05002403 filp = finish_open(nd, open_flag, acc_mode);
Al Virofb1cc552009-12-24 01:58:28 -05002404 return filp;
2405
2406exit_mutex_unlock:
2407 mutex_unlock(&dir->d_inode->i_mutex);
2408exit_dput:
2409 path_put_conditional(path, nd);
2410exit:
2411 if (!IS_ERR(nd->intent.open.file))
2412 release_open_intent(nd);
Al Virofb1cc552009-12-24 01:58:28 -05002413 path_put(&nd->path);
2414 return ERR_PTR(error);
2415}
2416
Dave Hansend57999e2008-02-15 14:37:27 -08002417/*
Dave Hansen4a3fd212008-02-15 14:37:48 -08002418 * Note that the low bits of the passed in "open_flag"
2419 * are not the same as in the local variable "flag". See
2420 * open_to_namei_flags() for more details.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002421 */
Christoph Hellwiga70e65d2008-02-15 14:37:28 -08002422struct file *do_filp_open(int dfd, const char *pathname,
Al Viro6e8341a2009-04-06 11:16:22 -04002423 int open_flag, int mode, int acc_mode)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002424{
Dave Hansen4a3fd212008-02-15 14:37:48 -08002425 struct file *filp;
Christoph Hellwiga70e65d2008-02-15 14:37:28 -08002426 struct nameidata nd;
Al Viro6e8341a2009-04-06 11:16:22 -04002427 int error;
Al Viro9850c052010-01-13 15:01:15 -05002428 struct path path;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002429 int count = 0;
Dave Hansend57999e2008-02-15 14:37:27 -08002430 int flag = open_to_namei_flags(open_flag);
Nick Piggin31e6b012011-01-07 17:49:52 +11002431 int flags;
Al Viro1f36f772009-12-26 10:56:19 -05002432
2433 if (!(open_flag & O_CREAT))
2434 mode = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002435
Lino Sanfilippob1085ba2010-11-05 17:05:27 +01002436 /* Must never be set by userspace */
2437 open_flag &= ~FMODE_NONOTIFY;
2438
Christoph Hellwig6b2f3d12009-10-27 11:05:28 +01002439 /*
2440 * O_SYNC is implemented as __O_SYNC|O_DSYNC. As many places only
2441 * check for O_DSYNC if the need any syncing at all we enforce it's
2442 * always set instead of having to deal with possibly weird behaviour
2443 * for malicious applications setting only __O_SYNC.
2444 */
2445 if (open_flag & __O_SYNC)
2446 open_flag |= O_DSYNC;
2447
Al Viro6e8341a2009-04-06 11:16:22 -04002448 if (!acc_mode)
Al Viro6d125522009-12-24 06:58:56 -05002449 acc_mode = MAY_OPEN | ACC_MODE(open_flag);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002450
Trond Myklebust834f2a42005-10-18 14:20:16 -07002451 /* O_TRUNC implies we need access checks for write permissions */
Al Viro4296e2c2009-12-24 07:15:41 -05002452 if (open_flag & O_TRUNC)
Trond Myklebust834f2a42005-10-18 14:20:16 -07002453 acc_mode |= MAY_WRITE;
2454
Linus Torvalds1da177e2005-04-16 15:20:36 -07002455 /* Allow the LSM permission hook to distinguish append
2456 access from general write access. */
Al Viro4296e2c2009-12-24 07:15:41 -05002457 if (open_flag & O_APPEND)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002458 acc_mode |= MAY_APPEND;
2459
Nick Piggin31e6b012011-01-07 17:49:52 +11002460 flags = LOOKUP_OPEN;
2461 if (open_flag & O_CREAT) {
2462 flags |= LOOKUP_CREATE;
2463 if (open_flag & O_EXCL)
2464 flags |= LOOKUP_EXCL;
J. R. Okajima654f5622009-06-18 23:30:15 +09002465 }
Nick Piggin31e6b012011-01-07 17:49:52 +11002466 if (open_flag & O_DIRECTORY)
2467 flags |= LOOKUP_DIRECTORY;
2468 if (!(open_flag & O_NOFOLLOW))
2469 flags |= LOOKUP_FOLLOW;
2470
2471 filp = get_empty_filp();
2472 if (!filp)
2473 return ERR_PTR(-ENFILE);
2474
2475 filp->f_flags = open_flag;
2476 nd.intent.open.file = filp;
2477 nd.intent.open.flags = flag;
2478 nd.intent.open.create_mode = mode;
2479
2480 if (open_flag & O_CREAT)
2481 goto creat;
2482
2483 /* !O_CREAT, simple open */
2484 error = do_path_lookup(dfd, pathname, flags, &nd);
2485 if (unlikely(error))
2486 goto out_filp;
2487 error = -ELOOP;
2488 if (!(nd.flags & LOOKUP_FOLLOW)) {
2489 if (nd.inode->i_op->follow_link)
2490 goto out_path;
2491 }
2492 error = -ENOTDIR;
2493 if (nd.flags & LOOKUP_DIRECTORY) {
2494 if (!nd.inode->i_op->lookup)
2495 goto out_path;
2496 }
2497 audit_inode(pathname, nd.path.dentry);
2498 filp = finish_open(&nd, open_flag, acc_mode);
2499 return filp;
2500
2501creat:
2502 /* OK, have to create the file. Find the parent. */
2503 error = path_init_rcu(dfd, pathname,
2504 LOOKUP_PARENT | (flags & LOOKUP_REVAL), &nd);
2505 if (error)
2506 goto out_filp;
2507 error = path_walk_rcu(pathname, &nd);
2508 path_finish_rcu(&nd);
2509 if (unlikely(error == -ECHILD || error == -ESTALE)) {
2510 /* slower, locked walk */
2511 if (error == -ESTALE) {
2512reval:
2513 flags |= LOOKUP_REVAL;
2514 }
2515 error = path_init(dfd, pathname,
2516 LOOKUP_PARENT | (flags & LOOKUP_REVAL), &nd);
2517 if (error)
2518 goto out_filp;
2519
2520 error = path_walk_simple(pathname, &nd);
2521 }
2522 if (unlikely(error))
2523 goto out_filp;
2524 if (unlikely(!audit_dummy_context()))
Al Viro9b4a9b12009-04-07 11:44:16 -04002525 audit_inode(pathname, nd.path.dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002526
2527 /*
Al Viroa2c36b42009-12-24 03:39:50 -05002528 * We have the parent and last component.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002529 */
Nick Piggin31e6b012011-01-07 17:49:52 +11002530 nd.flags = flags;
Al Viro3e297b62010-03-26 12:40:13 -04002531 filp = do_last(&nd, &path, open_flag, acc_mode, mode, pathname);
Al Viro806b6812009-12-26 07:16:40 -05002532 while (unlikely(!filp)) { /* trailing symlink */
Nick Piggin7b9337a2011-01-14 08:42:43 +00002533 struct path link = path;
2534 struct inode *linki = link.dentry->d_inode;
Al Virodef4af32009-12-26 08:37:05 -05002535 void *cookie;
Al Viro806b6812009-12-26 07:16:40 -05002536 error = -ELOOP;
David Howellsdb372912011-01-14 18:45:53 +00002537 if (!(nd.flags & LOOKUP_FOLLOW))
Al Viro1f36f772009-12-26 10:56:19 -05002538 goto exit_dput;
2539 if (count++ == 32)
Al Viro806b6812009-12-26 07:16:40 -05002540 goto exit_dput;
2541 /*
2542 * This is subtle. Instead of calling do_follow_link() we do
2543 * the thing by hands. The reason is that this way we have zero
2544 * link_count and path_walk() (called from ->follow_link)
2545 * honoring LOOKUP_PARENT. After that we have the parent and
2546 * last component, i.e. we are in the same situation as after
2547 * the first path_walk(). Well, almost - if the last component
2548 * is normal we get its copy stored in nd->last.name and we will
2549 * have to putname() it when we are done. Procfs-like symlinks
2550 * just set LAST_BIND.
2551 */
2552 nd.flags |= LOOKUP_PARENT;
Nick Piggin7b9337a2011-01-14 08:42:43 +00002553 error = security_inode_follow_link(link.dentry, &nd);
Al Viro806b6812009-12-26 07:16:40 -05002554 if (error)
2555 goto exit_dput;
Nick Piggin7b9337a2011-01-14 08:42:43 +00002556 error = __do_follow_link(&link, &nd, &cookie);
Al Virodef4af32009-12-26 08:37:05 -05002557 if (unlikely(error)) {
Nick Piggin7b9337a2011-01-14 08:42:43 +00002558 if (!IS_ERR(cookie) && linki->i_op->put_link)
2559 linki->i_op->put_link(link.dentry, &nd, cookie);
Al Viro806b6812009-12-26 07:16:40 -05002560 /* nd.path had been dropped */
Nick Piggin7b9337a2011-01-14 08:42:43 +00002561 nd.path = link;
Nick Piggin31e6b012011-01-07 17:49:52 +11002562 goto out_path;
Al Viro806b6812009-12-26 07:16:40 -05002563 }
2564 nd.flags &= ~LOOKUP_PARENT;
Al Viro3e297b62010-03-26 12:40:13 -04002565 filp = do_last(&nd, &path, open_flag, acc_mode, mode, pathname);
Nick Piggin7b9337a2011-01-14 08:42:43 +00002566 if (linki->i_op->put_link)
2567 linki->i_op->put_link(link.dentry, &nd, cookie);
2568 path_put(&link);
Al Viro806b6812009-12-26 07:16:40 -05002569 }
Al Viro10fa8e62009-12-26 07:09:49 -05002570out:
Al Viro2a737872009-04-07 11:49:53 -04002571 if (nd.root.mnt)
2572 path_put(&nd.root);
Nick Piggin31e6b012011-01-07 17:49:52 +11002573 if (filp == ERR_PTR(-ESTALE) && !(flags & LOOKUP_REVAL))
Al Viro10fa8e62009-12-26 07:09:49 -05002574 goto reval;
Al Viro10fa8e62009-12-26 07:09:49 -05002575 return filp;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002576
Al Viro806b6812009-12-26 07:16:40 -05002577exit_dput:
2578 path_put_conditional(&path, &nd);
Nick Piggin31e6b012011-01-07 17:49:52 +11002579out_path:
2580 path_put(&nd.path);
2581out_filp:
Al Viro806b6812009-12-26 07:16:40 -05002582 if (!IS_ERR(nd.intent.open.file))
Christoph Hellwiga70e65d2008-02-15 14:37:28 -08002583 release_open_intent(&nd);
Al Viro806b6812009-12-26 07:16:40 -05002584 filp = ERR_PTR(error);
Al Viro10fa8e62009-12-26 07:09:49 -05002585 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002586}
2587
2588/**
Christoph Hellwiga70e65d2008-02-15 14:37:28 -08002589 * filp_open - open file and return file pointer
2590 *
2591 * @filename: path to open
2592 * @flags: open flags as per the open(2) second argument
2593 * @mode: mode for the new file if O_CREAT is set, else ignored
2594 *
2595 * This is the helper to open a file from kernelspace if you really
2596 * have to. But in generally you should not do this, so please move
2597 * along, nothing to see here..
2598 */
2599struct file *filp_open(const char *filename, int flags, int mode)
2600{
Al Viro6e8341a2009-04-06 11:16:22 -04002601 return do_filp_open(AT_FDCWD, filename, flags, mode, 0);
Christoph Hellwiga70e65d2008-02-15 14:37:28 -08002602}
2603EXPORT_SYMBOL(filp_open);
2604
2605/**
Linus Torvalds1da177e2005-04-16 15:20:36 -07002606 * lookup_create - lookup a dentry, creating it if it doesn't exist
2607 * @nd: nameidata info
2608 * @is_dir: directory flag
2609 *
2610 * Simple function to lookup and return a dentry and create it
2611 * if it doesn't exist. Is SMP-safe.
Christoph Hellwigc663e5d2005-06-23 00:09:49 -07002612 *
Jan Blunck4ac91372008-02-14 19:34:32 -08002613 * Returns with nd->path.dentry->d_inode->i_mutex locked.
Linus Torvalds1da177e2005-04-16 15:20:36 -07002614 */
2615struct dentry *lookup_create(struct nameidata *nd, int is_dir)
2616{
Christoph Hellwigc663e5d2005-06-23 00:09:49 -07002617 struct dentry *dentry = ERR_PTR(-EEXIST);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002618
Jan Blunck4ac91372008-02-14 19:34:32 -08002619 mutex_lock_nested(&nd->path.dentry->d_inode->i_mutex, I_MUTEX_PARENT);
Christoph Hellwigc663e5d2005-06-23 00:09:49 -07002620 /*
2621 * Yucky last component or no last component at all?
2622 * (foo/., foo/.., /////)
2623 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07002624 if (nd->last_type != LAST_NORM)
2625 goto fail;
2626 nd->flags &= ~LOOKUP_PARENT;
Al Viro35165862008-08-05 03:00:49 -04002627 nd->flags |= LOOKUP_CREATE | LOOKUP_EXCL;
ASANO Masahiroa6349042006-08-22 20:06:02 -04002628 nd->intent.open.flags = O_EXCL;
Christoph Hellwigc663e5d2005-06-23 00:09:49 -07002629
2630 /*
2631 * Do the final lookup.
2632 */
Christoph Hellwig49705b72005-11-08 21:35:06 -08002633 dentry = lookup_hash(nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002634 if (IS_ERR(dentry))
2635 goto fail;
Christoph Hellwigc663e5d2005-06-23 00:09:49 -07002636
Al Viroe9baf6e2008-05-15 04:49:12 -04002637 if (dentry->d_inode)
2638 goto eexist;
Christoph Hellwigc663e5d2005-06-23 00:09:49 -07002639 /*
2640 * Special case - lookup gave negative, but... we had foo/bar/
2641 * From the vfs_mknod() POV we just have a negative dentry -
2642 * all is fine. Let's be bastards - you had / on the end, you've
2643 * been asking for (non-existent) directory. -ENOENT for you.
2644 */
Al Viroe9baf6e2008-05-15 04:49:12 -04002645 if (unlikely(!is_dir && nd->last.name[nd->last.len])) {
2646 dput(dentry);
2647 dentry = ERR_PTR(-ENOENT);
2648 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002649 return dentry;
Al Viroe9baf6e2008-05-15 04:49:12 -04002650eexist:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002651 dput(dentry);
Al Viroe9baf6e2008-05-15 04:49:12 -04002652 dentry = ERR_PTR(-EEXIST);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002653fail:
2654 return dentry;
2655}
Christoph Hellwigf81a0bf2005-05-19 12:26:43 -07002656EXPORT_SYMBOL_GPL(lookup_create);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002657
2658int vfs_mknod(struct inode *dir, struct dentry *dentry, int mode, dev_t dev)
2659{
Miklos Szeredia95164d2008-07-30 15:08:48 +02002660 int error = may_create(dir, dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002661
2662 if (error)
2663 return error;
2664
2665 if ((S_ISCHR(mode) || S_ISBLK(mode)) && !capable(CAP_MKNOD))
2666 return -EPERM;
2667
Al Viroacfa4382008-12-04 10:06:33 -05002668 if (!dir->i_op->mknod)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002669 return -EPERM;
2670
Serge E. Hallyn08ce5f12008-04-29 01:00:10 -07002671 error = devcgroup_inode_mknod(mode, dev);
2672 if (error)
2673 return error;
2674
Linus Torvalds1da177e2005-04-16 15:20:36 -07002675 error = security_inode_mknod(dir, dentry, mode, dev);
2676 if (error)
2677 return error;
2678
Linus Torvalds1da177e2005-04-16 15:20:36 -07002679 error = dir->i_op->mknod(dir, dentry, mode, dev);
Stephen Smalleya74574a2005-09-09 13:01:44 -07002680 if (!error)
Amy Griffisf38aa942005-11-03 15:57:06 +00002681 fsnotify_create(dir, dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002682 return error;
2683}
2684
Dave Hansen463c3192008-02-15 14:37:57 -08002685static int may_mknod(mode_t mode)
2686{
2687 switch (mode & S_IFMT) {
2688 case S_IFREG:
2689 case S_IFCHR:
2690 case S_IFBLK:
2691 case S_IFIFO:
2692 case S_IFSOCK:
2693 case 0: /* zero mode translates to S_IFREG */
2694 return 0;
2695 case S_IFDIR:
2696 return -EPERM;
2697 default:
2698 return -EINVAL;
2699 }
2700}
2701
Heiko Carstens2e4d0922009-01-14 14:14:31 +01002702SYSCALL_DEFINE4(mknodat, int, dfd, const char __user *, filename, int, mode,
2703 unsigned, dev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002704{
Al Viro2ad94ae2008-07-21 09:32:51 -04002705 int error;
2706 char *tmp;
2707 struct dentry *dentry;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002708 struct nameidata nd;
2709
2710 if (S_ISDIR(mode))
2711 return -EPERM;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002712
Al Viro2ad94ae2008-07-21 09:32:51 -04002713 error = user_path_parent(dfd, filename, &nd, &tmp);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002714 if (error)
Al Viro2ad94ae2008-07-21 09:32:51 -04002715 return error;
2716
Linus Torvalds1da177e2005-04-16 15:20:36 -07002717 dentry = lookup_create(&nd, 0);
Dave Hansen463c3192008-02-15 14:37:57 -08002718 if (IS_ERR(dentry)) {
2719 error = PTR_ERR(dentry);
2720 goto out_unlock;
2721 }
Jan Blunck4ac91372008-02-14 19:34:32 -08002722 if (!IS_POSIXACL(nd.path.dentry->d_inode))
Al Viroce3b0f82009-03-29 19:08:22 -04002723 mode &= ~current_umask();
Dave Hansen463c3192008-02-15 14:37:57 -08002724 error = may_mknod(mode);
2725 if (error)
2726 goto out_dput;
2727 error = mnt_want_write(nd.path.mnt);
2728 if (error)
2729 goto out_dput;
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09002730 error = security_path_mknod(&nd.path, dentry, mode, dev);
2731 if (error)
2732 goto out_drop_write;
Dave Hansen463c3192008-02-15 14:37:57 -08002733 switch (mode & S_IFMT) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002734 case 0: case S_IFREG:
Jan Blunck4ac91372008-02-14 19:34:32 -08002735 error = vfs_create(nd.path.dentry->d_inode,dentry,mode,&nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002736 break;
2737 case S_IFCHR: case S_IFBLK:
Jan Blunck4ac91372008-02-14 19:34:32 -08002738 error = vfs_mknod(nd.path.dentry->d_inode,dentry,mode,
Linus Torvalds1da177e2005-04-16 15:20:36 -07002739 new_decode_dev(dev));
2740 break;
2741 case S_IFIFO: case S_IFSOCK:
Jan Blunck4ac91372008-02-14 19:34:32 -08002742 error = vfs_mknod(nd.path.dentry->d_inode,dentry,mode,0);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002743 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002744 }
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09002745out_drop_write:
Dave Hansen463c3192008-02-15 14:37:57 -08002746 mnt_drop_write(nd.path.mnt);
2747out_dput:
2748 dput(dentry);
2749out_unlock:
Jan Blunck4ac91372008-02-14 19:34:32 -08002750 mutex_unlock(&nd.path.dentry->d_inode->i_mutex);
Jan Blunck1d957f92008-02-14 19:34:35 -08002751 path_put(&nd.path);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002752 putname(tmp);
2753
2754 return error;
2755}
2756
Heiko Carstens3480b252009-01-14 14:14:16 +01002757SYSCALL_DEFINE3(mknod, const char __user *, filename, int, mode, unsigned, dev)
Ulrich Drepper5590ff02006-01-18 17:43:53 -08002758{
2759 return sys_mknodat(AT_FDCWD, filename, mode, dev);
2760}
2761
Linus Torvalds1da177e2005-04-16 15:20:36 -07002762int vfs_mkdir(struct inode *dir, struct dentry *dentry, int mode)
2763{
Miklos Szeredia95164d2008-07-30 15:08:48 +02002764 int error = may_create(dir, dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002765
2766 if (error)
2767 return error;
2768
Al Viroacfa4382008-12-04 10:06:33 -05002769 if (!dir->i_op->mkdir)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002770 return -EPERM;
2771
2772 mode &= (S_IRWXUGO|S_ISVTX);
2773 error = security_inode_mkdir(dir, dentry, mode);
2774 if (error)
2775 return error;
2776
Linus Torvalds1da177e2005-04-16 15:20:36 -07002777 error = dir->i_op->mkdir(dir, dentry, mode);
Stephen Smalleya74574a2005-09-09 13:01:44 -07002778 if (!error)
Amy Griffisf38aa942005-11-03 15:57:06 +00002779 fsnotify_mkdir(dir, dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002780 return error;
2781}
2782
Heiko Carstens2e4d0922009-01-14 14:14:31 +01002783SYSCALL_DEFINE3(mkdirat, int, dfd, const char __user *, pathname, int, mode)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002784{
2785 int error = 0;
2786 char * tmp;
Dave Hansen6902d922006-09-30 23:29:01 -07002787 struct dentry *dentry;
2788 struct nameidata nd;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002789
Al Viro2ad94ae2008-07-21 09:32:51 -04002790 error = user_path_parent(dfd, pathname, &nd, &tmp);
2791 if (error)
Dave Hansen6902d922006-09-30 23:29:01 -07002792 goto out_err;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002793
Dave Hansen6902d922006-09-30 23:29:01 -07002794 dentry = lookup_create(&nd, 1);
2795 error = PTR_ERR(dentry);
2796 if (IS_ERR(dentry))
2797 goto out_unlock;
2798
Jan Blunck4ac91372008-02-14 19:34:32 -08002799 if (!IS_POSIXACL(nd.path.dentry->d_inode))
Al Viroce3b0f82009-03-29 19:08:22 -04002800 mode &= ~current_umask();
Dave Hansen463c3192008-02-15 14:37:57 -08002801 error = mnt_want_write(nd.path.mnt);
2802 if (error)
2803 goto out_dput;
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09002804 error = security_path_mkdir(&nd.path, dentry, mode);
2805 if (error)
2806 goto out_drop_write;
Jan Blunck4ac91372008-02-14 19:34:32 -08002807 error = vfs_mkdir(nd.path.dentry->d_inode, dentry, mode);
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09002808out_drop_write:
Dave Hansen463c3192008-02-15 14:37:57 -08002809 mnt_drop_write(nd.path.mnt);
2810out_dput:
Dave Hansen6902d922006-09-30 23:29:01 -07002811 dput(dentry);
2812out_unlock:
Jan Blunck4ac91372008-02-14 19:34:32 -08002813 mutex_unlock(&nd.path.dentry->d_inode->i_mutex);
Jan Blunck1d957f92008-02-14 19:34:35 -08002814 path_put(&nd.path);
Dave Hansen6902d922006-09-30 23:29:01 -07002815 putname(tmp);
2816out_err:
Linus Torvalds1da177e2005-04-16 15:20:36 -07002817 return error;
2818}
2819
Heiko Carstens3cdad422009-01-14 14:14:22 +01002820SYSCALL_DEFINE2(mkdir, const char __user *, pathname, int, mode)
Ulrich Drepper5590ff02006-01-18 17:43:53 -08002821{
2822 return sys_mkdirat(AT_FDCWD, pathname, mode);
2823}
2824
Linus Torvalds1da177e2005-04-16 15:20:36 -07002825/*
2826 * We try to drop the dentry early: we should have
2827 * a usage count of 2 if we're the only user of this
2828 * dentry, and if that is true (possibly after pruning
2829 * the dcache), then we drop the dentry now.
2830 *
2831 * A low-level filesystem can, if it choses, legally
2832 * do a
2833 *
2834 * if (!d_unhashed(dentry))
2835 * return -EBUSY;
2836 *
2837 * if it cannot handle the case of removing a directory
2838 * that is still in use by something else..
2839 */
2840void dentry_unhash(struct dentry *dentry)
2841{
2842 dget(dentry);
Vasily Averindc168422006-12-06 20:37:07 -08002843 shrink_dcache_parent(dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002844 spin_lock(&dentry->d_lock);
Nick Pigginb7ab39f2011-01-07 17:49:32 +11002845 if (dentry->d_count == 2)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002846 __d_drop(dentry);
2847 spin_unlock(&dentry->d_lock);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002848}
2849
2850int vfs_rmdir(struct inode *dir, struct dentry *dentry)
2851{
2852 int error = may_delete(dir, dentry, 1);
2853
2854 if (error)
2855 return error;
2856
Al Viroacfa4382008-12-04 10:06:33 -05002857 if (!dir->i_op->rmdir)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002858 return -EPERM;
2859
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002860 mutex_lock(&dentry->d_inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002861 dentry_unhash(dentry);
2862 if (d_mountpoint(dentry))
2863 error = -EBUSY;
2864 else {
2865 error = security_inode_rmdir(dir, dentry);
2866 if (!error) {
2867 error = dir->i_op->rmdir(dir, dentry);
Al Virod83c49f2010-04-30 17:17:09 -04002868 if (!error) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002869 dentry->d_inode->i_flags |= S_DEAD;
Al Virod83c49f2010-04-30 17:17:09 -04002870 dont_mount(dentry);
2871 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002872 }
2873 }
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002874 mutex_unlock(&dentry->d_inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002875 if (!error) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002876 d_delete(dentry);
2877 }
2878 dput(dentry);
2879
2880 return error;
2881}
2882
Ulrich Drepper5590ff02006-01-18 17:43:53 -08002883static long do_rmdir(int dfd, const char __user *pathname)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002884{
2885 int error = 0;
2886 char * name;
2887 struct dentry *dentry;
2888 struct nameidata nd;
2889
Al Viro2ad94ae2008-07-21 09:32:51 -04002890 error = user_path_parent(dfd, pathname, &nd, &name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002891 if (error)
Al Viro2ad94ae2008-07-21 09:32:51 -04002892 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002893
2894 switch(nd.last_type) {
OGAWA Hirofumi0612d9f2008-10-16 07:50:29 +09002895 case LAST_DOTDOT:
2896 error = -ENOTEMPTY;
2897 goto exit1;
2898 case LAST_DOT:
2899 error = -EINVAL;
2900 goto exit1;
2901 case LAST_ROOT:
2902 error = -EBUSY;
2903 goto exit1;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002904 }
OGAWA Hirofumi0612d9f2008-10-16 07:50:29 +09002905
2906 nd.flags &= ~LOOKUP_PARENT;
2907
Jan Blunck4ac91372008-02-14 19:34:32 -08002908 mutex_lock_nested(&nd.path.dentry->d_inode->i_mutex, I_MUTEX_PARENT);
Christoph Hellwig49705b72005-11-08 21:35:06 -08002909 dentry = lookup_hash(&nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002910 error = PTR_ERR(dentry);
Dave Hansen6902d922006-09-30 23:29:01 -07002911 if (IS_ERR(dentry))
2912 goto exit2;
Dave Hansen06227532008-02-15 14:37:34 -08002913 error = mnt_want_write(nd.path.mnt);
2914 if (error)
2915 goto exit3;
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09002916 error = security_path_rmdir(&nd.path, dentry);
2917 if (error)
2918 goto exit4;
Jan Blunck4ac91372008-02-14 19:34:32 -08002919 error = vfs_rmdir(nd.path.dentry->d_inode, dentry);
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09002920exit4:
Dave Hansen06227532008-02-15 14:37:34 -08002921 mnt_drop_write(nd.path.mnt);
2922exit3:
Dave Hansen6902d922006-09-30 23:29:01 -07002923 dput(dentry);
2924exit2:
Jan Blunck4ac91372008-02-14 19:34:32 -08002925 mutex_unlock(&nd.path.dentry->d_inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002926exit1:
Jan Blunck1d957f92008-02-14 19:34:35 -08002927 path_put(&nd.path);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002928 putname(name);
2929 return error;
2930}
2931
Heiko Carstens3cdad422009-01-14 14:14:22 +01002932SYSCALL_DEFINE1(rmdir, const char __user *, pathname)
Ulrich Drepper5590ff02006-01-18 17:43:53 -08002933{
2934 return do_rmdir(AT_FDCWD, pathname);
2935}
2936
Linus Torvalds1da177e2005-04-16 15:20:36 -07002937int vfs_unlink(struct inode *dir, struct dentry *dentry)
2938{
2939 int error = may_delete(dir, dentry, 0);
2940
2941 if (error)
2942 return error;
2943
Al Viroacfa4382008-12-04 10:06:33 -05002944 if (!dir->i_op->unlink)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002945 return -EPERM;
2946
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002947 mutex_lock(&dentry->d_inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002948 if (d_mountpoint(dentry))
2949 error = -EBUSY;
2950 else {
2951 error = security_inode_unlink(dir, dentry);
Al Virobec10522010-03-03 14:12:08 -05002952 if (!error) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07002953 error = dir->i_op->unlink(dir, dentry);
Al Virobec10522010-03-03 14:12:08 -05002954 if (!error)
Al Virod83c49f2010-04-30 17:17:09 -04002955 dont_mount(dentry);
Al Virobec10522010-03-03 14:12:08 -05002956 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07002957 }
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002958 mutex_unlock(&dentry->d_inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002959
2960 /* We don't d_delete() NFS sillyrenamed files--they still exist. */
2961 if (!error && !(dentry->d_flags & DCACHE_NFSFS_RENAMED)) {
Jan Karaece95912008-02-06 01:37:13 -08002962 fsnotify_link_count(dentry->d_inode);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002963 d_delete(dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002964 }
Robert Love0eeca282005-07-12 17:06:03 -04002965
Linus Torvalds1da177e2005-04-16 15:20:36 -07002966 return error;
2967}
2968
2969/*
2970 * Make sure that the actual truncation of the file will occur outside its
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08002971 * directory's i_mutex. Truncate can take a long time if there is a lot of
Linus Torvalds1da177e2005-04-16 15:20:36 -07002972 * writeout happening, and we don't want to prevent access to the directory
2973 * while waiting on the I/O.
2974 */
Ulrich Drepper5590ff02006-01-18 17:43:53 -08002975static long do_unlinkat(int dfd, const char __user *pathname)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002976{
Al Viro2ad94ae2008-07-21 09:32:51 -04002977 int error;
2978 char *name;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002979 struct dentry *dentry;
2980 struct nameidata nd;
2981 struct inode *inode = NULL;
2982
Al Viro2ad94ae2008-07-21 09:32:51 -04002983 error = user_path_parent(dfd, pathname, &nd, &name);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002984 if (error)
Al Viro2ad94ae2008-07-21 09:32:51 -04002985 return error;
2986
Linus Torvalds1da177e2005-04-16 15:20:36 -07002987 error = -EISDIR;
2988 if (nd.last_type != LAST_NORM)
2989 goto exit1;
OGAWA Hirofumi0612d9f2008-10-16 07:50:29 +09002990
2991 nd.flags &= ~LOOKUP_PARENT;
2992
Jan Blunck4ac91372008-02-14 19:34:32 -08002993 mutex_lock_nested(&nd.path.dentry->d_inode->i_mutex, I_MUTEX_PARENT);
Christoph Hellwig49705b72005-11-08 21:35:06 -08002994 dentry = lookup_hash(&nd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002995 error = PTR_ERR(dentry);
2996 if (!IS_ERR(dentry)) {
2997 /* Why not before? Because we want correct error value */
2998 if (nd.last.name[nd.last.len])
2999 goto slashes;
3000 inode = dentry->d_inode;
3001 if (inode)
Al Viro7de9c6e2010-10-23 11:11:40 -04003002 ihold(inode);
Dave Hansen06227532008-02-15 14:37:34 -08003003 error = mnt_want_write(nd.path.mnt);
3004 if (error)
3005 goto exit2;
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09003006 error = security_path_unlink(&nd.path, dentry);
3007 if (error)
3008 goto exit3;
Jan Blunck4ac91372008-02-14 19:34:32 -08003009 error = vfs_unlink(nd.path.dentry->d_inode, dentry);
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09003010exit3:
Dave Hansen06227532008-02-15 14:37:34 -08003011 mnt_drop_write(nd.path.mnt);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003012 exit2:
3013 dput(dentry);
3014 }
Jan Blunck4ac91372008-02-14 19:34:32 -08003015 mutex_unlock(&nd.path.dentry->d_inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003016 if (inode)
3017 iput(inode); /* truncate the inode here */
3018exit1:
Jan Blunck1d957f92008-02-14 19:34:35 -08003019 path_put(&nd.path);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003020 putname(name);
3021 return error;
3022
3023slashes:
3024 error = !dentry->d_inode ? -ENOENT :
3025 S_ISDIR(dentry->d_inode->i_mode) ? -EISDIR : -ENOTDIR;
3026 goto exit2;
3027}
3028
Heiko Carstens2e4d0922009-01-14 14:14:31 +01003029SYSCALL_DEFINE3(unlinkat, int, dfd, const char __user *, pathname, int, flag)
Ulrich Drepper5590ff02006-01-18 17:43:53 -08003030{
3031 if ((flag & ~AT_REMOVEDIR) != 0)
3032 return -EINVAL;
3033
3034 if (flag & AT_REMOVEDIR)
3035 return do_rmdir(dfd, pathname);
3036
3037 return do_unlinkat(dfd, pathname);
3038}
3039
Heiko Carstens3480b252009-01-14 14:14:16 +01003040SYSCALL_DEFINE1(unlink, const char __user *, pathname)
Ulrich Drepper5590ff02006-01-18 17:43:53 -08003041{
3042 return do_unlinkat(AT_FDCWD, pathname);
3043}
3044
Miklos Szeredidb2e7472008-06-24 16:50:16 +02003045int vfs_symlink(struct inode *dir, struct dentry *dentry, const char *oldname)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003046{
Miklos Szeredia95164d2008-07-30 15:08:48 +02003047 int error = may_create(dir, dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003048
3049 if (error)
3050 return error;
3051
Al Viroacfa4382008-12-04 10:06:33 -05003052 if (!dir->i_op->symlink)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003053 return -EPERM;
3054
3055 error = security_inode_symlink(dir, dentry, oldname);
3056 if (error)
3057 return error;
3058
Linus Torvalds1da177e2005-04-16 15:20:36 -07003059 error = dir->i_op->symlink(dir, dentry, oldname);
Stephen Smalleya74574a2005-09-09 13:01:44 -07003060 if (!error)
Amy Griffisf38aa942005-11-03 15:57:06 +00003061 fsnotify_create(dir, dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003062 return error;
3063}
3064
Heiko Carstens2e4d0922009-01-14 14:14:31 +01003065SYSCALL_DEFINE3(symlinkat, const char __user *, oldname,
3066 int, newdfd, const char __user *, newname)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003067{
Al Viro2ad94ae2008-07-21 09:32:51 -04003068 int error;
3069 char *from;
3070 char *to;
Dave Hansen6902d922006-09-30 23:29:01 -07003071 struct dentry *dentry;
3072 struct nameidata nd;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003073
3074 from = getname(oldname);
Al Viro2ad94ae2008-07-21 09:32:51 -04003075 if (IS_ERR(from))
Linus Torvalds1da177e2005-04-16 15:20:36 -07003076 return PTR_ERR(from);
Al Viro2ad94ae2008-07-21 09:32:51 -04003077
3078 error = user_path_parent(newdfd, newname, &nd, &to);
3079 if (error)
Dave Hansen6902d922006-09-30 23:29:01 -07003080 goto out_putname;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003081
Dave Hansen6902d922006-09-30 23:29:01 -07003082 dentry = lookup_create(&nd, 0);
3083 error = PTR_ERR(dentry);
3084 if (IS_ERR(dentry))
3085 goto out_unlock;
3086
Dave Hansen75c3f292008-02-15 14:37:45 -08003087 error = mnt_want_write(nd.path.mnt);
3088 if (error)
3089 goto out_dput;
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09003090 error = security_path_symlink(&nd.path, dentry, from);
3091 if (error)
3092 goto out_drop_write;
Miklos Szeredidb2e7472008-06-24 16:50:16 +02003093 error = vfs_symlink(nd.path.dentry->d_inode, dentry, from);
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09003094out_drop_write:
Dave Hansen75c3f292008-02-15 14:37:45 -08003095 mnt_drop_write(nd.path.mnt);
3096out_dput:
Dave Hansen6902d922006-09-30 23:29:01 -07003097 dput(dentry);
3098out_unlock:
Jan Blunck4ac91372008-02-14 19:34:32 -08003099 mutex_unlock(&nd.path.dentry->d_inode->i_mutex);
Jan Blunck1d957f92008-02-14 19:34:35 -08003100 path_put(&nd.path);
Dave Hansen6902d922006-09-30 23:29:01 -07003101 putname(to);
3102out_putname:
Linus Torvalds1da177e2005-04-16 15:20:36 -07003103 putname(from);
3104 return error;
3105}
3106
Heiko Carstens3480b252009-01-14 14:14:16 +01003107SYSCALL_DEFINE2(symlink, const char __user *, oldname, const char __user *, newname)
Ulrich Drepper5590ff02006-01-18 17:43:53 -08003108{
3109 return sys_symlinkat(oldname, AT_FDCWD, newname);
3110}
3111
Linus Torvalds1da177e2005-04-16 15:20:36 -07003112int vfs_link(struct dentry *old_dentry, struct inode *dir, struct dentry *new_dentry)
3113{
3114 struct inode *inode = old_dentry->d_inode;
3115 int error;
3116
3117 if (!inode)
3118 return -ENOENT;
3119
Miklos Szeredia95164d2008-07-30 15:08:48 +02003120 error = may_create(dir, new_dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003121 if (error)
3122 return error;
3123
3124 if (dir->i_sb != inode->i_sb)
3125 return -EXDEV;
3126
3127 /*
3128 * A link to an append-only or immutable file cannot be created.
3129 */
3130 if (IS_APPEND(inode) || IS_IMMUTABLE(inode))
3131 return -EPERM;
Al Viroacfa4382008-12-04 10:06:33 -05003132 if (!dir->i_op->link)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003133 return -EPERM;
Tetsuo Handa7e79eed2008-06-24 16:50:15 +02003134 if (S_ISDIR(inode->i_mode))
Linus Torvalds1da177e2005-04-16 15:20:36 -07003135 return -EPERM;
3136
3137 error = security_inode_link(old_dentry, dir, new_dentry);
3138 if (error)
3139 return error;
3140
Tetsuo Handa7e79eed2008-06-24 16:50:15 +02003141 mutex_lock(&inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003142 error = dir->i_op->link(old_dentry, dir, new_dentry);
Tetsuo Handa7e79eed2008-06-24 16:50:15 +02003143 mutex_unlock(&inode->i_mutex);
Stephen Smalleye31e14e2005-09-09 13:01:45 -07003144 if (!error)
Tetsuo Handa7e79eed2008-06-24 16:50:15 +02003145 fsnotify_link(dir, inode, new_dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003146 return error;
3147}
3148
3149/*
3150 * Hardlinks are often used in delicate situations. We avoid
3151 * security-related surprises by not following symlinks on the
3152 * newname. --KAB
3153 *
3154 * We don't follow them on the oldname either to be compatible
3155 * with linux 2.0, and to avoid hard-linking to directories
3156 * and other special files. --ADM
3157 */
Heiko Carstens2e4d0922009-01-14 14:14:31 +01003158SYSCALL_DEFINE5(linkat, int, olddfd, const char __user *, oldname,
3159 int, newdfd, const char __user *, newname, int, flags)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003160{
3161 struct dentry *new_dentry;
Al Viro2d8f3032008-07-22 09:59:21 -04003162 struct nameidata nd;
3163 struct path old_path;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003164 int error;
Al Viro2ad94ae2008-07-21 09:32:51 -04003165 char *to;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003166
Ulrich Drepper45c9b112006-06-25 05:49:11 -07003167 if ((flags & ~AT_SYMLINK_FOLLOW) != 0)
Ulrich Drepperc04030e2006-02-24 13:04:21 -08003168 return -EINVAL;
3169
Al Viro2d8f3032008-07-22 09:59:21 -04003170 error = user_path_at(olddfd, oldname,
3171 flags & AT_SYMLINK_FOLLOW ? LOOKUP_FOLLOW : 0,
3172 &old_path);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003173 if (error)
Al Viro2ad94ae2008-07-21 09:32:51 -04003174 return error;
3175
3176 error = user_path_parent(newdfd, newname, &nd, &to);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003177 if (error)
3178 goto out;
3179 error = -EXDEV;
Al Viro2d8f3032008-07-22 09:59:21 -04003180 if (old_path.mnt != nd.path.mnt)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003181 goto out_release;
3182 new_dentry = lookup_create(&nd, 0);
3183 error = PTR_ERR(new_dentry);
Dave Hansen6902d922006-09-30 23:29:01 -07003184 if (IS_ERR(new_dentry))
3185 goto out_unlock;
Dave Hansen75c3f292008-02-15 14:37:45 -08003186 error = mnt_want_write(nd.path.mnt);
3187 if (error)
3188 goto out_dput;
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09003189 error = security_path_link(old_path.dentry, &nd.path, new_dentry);
3190 if (error)
3191 goto out_drop_write;
Al Viro2d8f3032008-07-22 09:59:21 -04003192 error = vfs_link(old_path.dentry, nd.path.dentry->d_inode, new_dentry);
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09003193out_drop_write:
Dave Hansen75c3f292008-02-15 14:37:45 -08003194 mnt_drop_write(nd.path.mnt);
3195out_dput:
Dave Hansen6902d922006-09-30 23:29:01 -07003196 dput(new_dentry);
3197out_unlock:
Jan Blunck4ac91372008-02-14 19:34:32 -08003198 mutex_unlock(&nd.path.dentry->d_inode->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003199out_release:
Jan Blunck1d957f92008-02-14 19:34:35 -08003200 path_put(&nd.path);
Al Viro2ad94ae2008-07-21 09:32:51 -04003201 putname(to);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003202out:
Al Viro2d8f3032008-07-22 09:59:21 -04003203 path_put(&old_path);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003204
3205 return error;
3206}
3207
Heiko Carstens3480b252009-01-14 14:14:16 +01003208SYSCALL_DEFINE2(link, const char __user *, oldname, const char __user *, newname)
Ulrich Drepper5590ff02006-01-18 17:43:53 -08003209{
Ulrich Drepperc04030e2006-02-24 13:04:21 -08003210 return sys_linkat(AT_FDCWD, oldname, AT_FDCWD, newname, 0);
Ulrich Drepper5590ff02006-01-18 17:43:53 -08003211}
3212
Linus Torvalds1da177e2005-04-16 15:20:36 -07003213/*
3214 * The worst of all namespace operations - renaming directory. "Perverted"
3215 * doesn't even start to describe it. Somebody in UCB had a heck of a trip...
3216 * Problems:
3217 * a) we can get into loop creation. Check is done in is_subdir().
3218 * b) race potential - two innocent renames can create a loop together.
3219 * That's where 4.4 screws up. Current fix: serialization on
Arjan van de Vena11f3a02006-03-23 03:00:33 -08003220 * sb->s_vfs_rename_mutex. We might be more accurate, but that's another
Linus Torvalds1da177e2005-04-16 15:20:36 -07003221 * story.
3222 * c) we have to lock _three_ objects - parents and victim (if it exists).
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08003223 * And that - after we got ->i_mutex on parents (until then we don't know
Linus Torvalds1da177e2005-04-16 15:20:36 -07003224 * whether the target exists). Solution: try to be smart with locking
3225 * order for inodes. We rely on the fact that tree topology may change
Arjan van de Vena11f3a02006-03-23 03:00:33 -08003226 * only under ->s_vfs_rename_mutex _and_ that parent of the object we
Linus Torvalds1da177e2005-04-16 15:20:36 -07003227 * move will be locked. Thus we can rank directories by the tree
3228 * (ancestors first) and rank all non-directories after them.
3229 * That works since everybody except rename does "lock parent, lookup,
Arjan van de Vena11f3a02006-03-23 03:00:33 -08003230 * lock child" and rename is under ->s_vfs_rename_mutex.
Linus Torvalds1da177e2005-04-16 15:20:36 -07003231 * HOWEVER, it relies on the assumption that any object with ->lookup()
3232 * has no more than 1 dentry. If "hybrid" objects will ever appear,
3233 * we'd better make sure that there's no link(2) for them.
3234 * d) some filesystems don't support opened-but-unlinked directories,
3235 * either because of layout or because they are not ready to deal with
3236 * all cases correctly. The latter will be fixed (taking this sort of
3237 * stuff into VFS), but the former is not going away. Solution: the same
3238 * trick as in rmdir().
3239 * e) conversion from fhandle to dentry may come in the wrong moment - when
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08003240 * we are removing the target. Solution: we will have to grab ->i_mutex
Linus Torvalds1da177e2005-04-16 15:20:36 -07003241 * in the fhandle_to_dentry code. [FIXME - current nfsfh.c relies on
Adam Buchbinderc41b20e2009-12-11 16:35:39 -05003242 * ->i_mutex on parents, which works but leads to some truly excessive
Linus Torvalds1da177e2005-04-16 15:20:36 -07003243 * locking].
3244 */
Adrian Bunk75c96f82005-05-05 16:16:09 -07003245static int vfs_rename_dir(struct inode *old_dir, struct dentry *old_dentry,
3246 struct inode *new_dir, struct dentry *new_dentry)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003247{
3248 int error = 0;
3249 struct inode *target;
3250
3251 /*
3252 * If we are going to change the parent - check write permissions,
3253 * we'll need to flip '..'.
3254 */
3255 if (new_dir != old_dir) {
Al Virof419a2e2008-07-22 00:07:17 -04003256 error = inode_permission(old_dentry->d_inode, MAY_WRITE);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003257 if (error)
3258 return error;
3259 }
3260
3261 error = security_inode_rename(old_dir, old_dentry, new_dir, new_dentry);
3262 if (error)
3263 return error;
3264
3265 target = new_dentry->d_inode;
Al Virod83c49f2010-04-30 17:17:09 -04003266 if (target)
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08003267 mutex_lock(&target->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003268 if (d_mountpoint(old_dentry)||d_mountpoint(new_dentry))
3269 error = -EBUSY;
Al Virod83c49f2010-04-30 17:17:09 -04003270 else {
3271 if (target)
3272 dentry_unhash(new_dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003273 error = old_dir->i_op->rename(old_dir, old_dentry, new_dir, new_dentry);
Al Virod83c49f2010-04-30 17:17:09 -04003274 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07003275 if (target) {
Al Virod83c49f2010-04-30 17:17:09 -04003276 if (!error) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07003277 target->i_flags |= S_DEAD;
Al Virod83c49f2010-04-30 17:17:09 -04003278 dont_mount(new_dentry);
3279 }
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08003280 mutex_unlock(&target->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003281 if (d_unhashed(new_dentry))
3282 d_rehash(new_dentry);
3283 dput(new_dentry);
3284 }
Stephen Smalleye31e14e2005-09-09 13:01:45 -07003285 if (!error)
Mark Fasheh349457c2006-09-08 14:22:21 -07003286 if (!(old_dir->i_sb->s_type->fs_flags & FS_RENAME_DOES_D_MOVE))
3287 d_move(old_dentry,new_dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003288 return error;
3289}
3290
Adrian Bunk75c96f82005-05-05 16:16:09 -07003291static int vfs_rename_other(struct inode *old_dir, struct dentry *old_dentry,
3292 struct inode *new_dir, struct dentry *new_dentry)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003293{
3294 struct inode *target;
3295 int error;
3296
3297 error = security_inode_rename(old_dir, old_dentry, new_dir, new_dentry);
3298 if (error)
3299 return error;
3300
3301 dget(new_dentry);
3302 target = new_dentry->d_inode;
3303 if (target)
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08003304 mutex_lock(&target->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003305 if (d_mountpoint(old_dentry)||d_mountpoint(new_dentry))
3306 error = -EBUSY;
3307 else
3308 error = old_dir->i_op->rename(old_dir, old_dentry, new_dir, new_dentry);
3309 if (!error) {
Al Virobec10522010-03-03 14:12:08 -05003310 if (target)
Al Virod83c49f2010-04-30 17:17:09 -04003311 dont_mount(new_dentry);
Mark Fasheh349457c2006-09-08 14:22:21 -07003312 if (!(old_dir->i_sb->s_type->fs_flags & FS_RENAME_DOES_D_MOVE))
Linus Torvalds1da177e2005-04-16 15:20:36 -07003313 d_move(old_dentry, new_dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003314 }
3315 if (target)
Jes Sorensen1b1dcc12006-01-09 15:59:24 -08003316 mutex_unlock(&target->i_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003317 dput(new_dentry);
3318 return error;
3319}
3320
3321int vfs_rename(struct inode *old_dir, struct dentry *old_dentry,
3322 struct inode *new_dir, struct dentry *new_dentry)
3323{
3324 int error;
3325 int is_dir = S_ISDIR(old_dentry->d_inode->i_mode);
Eric Paris59b0df22010-02-08 12:53:52 -05003326 const unsigned char *old_name;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003327
3328 if (old_dentry->d_inode == new_dentry->d_inode)
3329 return 0;
3330
3331 error = may_delete(old_dir, old_dentry, is_dir);
3332 if (error)
3333 return error;
3334
3335 if (!new_dentry->d_inode)
Miklos Szeredia95164d2008-07-30 15:08:48 +02003336 error = may_create(new_dir, new_dentry);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003337 else
3338 error = may_delete(new_dir, new_dentry, is_dir);
3339 if (error)
3340 return error;
3341
Al Viroacfa4382008-12-04 10:06:33 -05003342 if (!old_dir->i_op->rename)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003343 return -EPERM;
3344
Robert Love0eeca282005-07-12 17:06:03 -04003345 old_name = fsnotify_oldname_init(old_dentry->d_name.name);
3346
Linus Torvalds1da177e2005-04-16 15:20:36 -07003347 if (is_dir)
3348 error = vfs_rename_dir(old_dir,old_dentry,new_dir,new_dentry);
3349 else
3350 error = vfs_rename_other(old_dir,old_dentry,new_dir,new_dentry);
Al Viro123df292009-12-25 04:57:57 -05003351 if (!error)
3352 fsnotify_move(old_dir, new_dir, old_name, is_dir,
Al Viro5a190ae2007-06-07 12:19:32 -04003353 new_dentry->d_inode, old_dentry);
Robert Love0eeca282005-07-12 17:06:03 -04003354 fsnotify_oldname_free(old_name);
3355
Linus Torvalds1da177e2005-04-16 15:20:36 -07003356 return error;
3357}
3358
Heiko Carstens2e4d0922009-01-14 14:14:31 +01003359SYSCALL_DEFINE4(renameat, int, olddfd, const char __user *, oldname,
3360 int, newdfd, const char __user *, newname)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003361{
Al Viro2ad94ae2008-07-21 09:32:51 -04003362 struct dentry *old_dir, *new_dir;
3363 struct dentry *old_dentry, *new_dentry;
3364 struct dentry *trap;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003365 struct nameidata oldnd, newnd;
Al Viro2ad94ae2008-07-21 09:32:51 -04003366 char *from;
3367 char *to;
3368 int error;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003369
Al Viro2ad94ae2008-07-21 09:32:51 -04003370 error = user_path_parent(olddfd, oldname, &oldnd, &from);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003371 if (error)
3372 goto exit;
3373
Al Viro2ad94ae2008-07-21 09:32:51 -04003374 error = user_path_parent(newdfd, newname, &newnd, &to);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003375 if (error)
3376 goto exit1;
3377
3378 error = -EXDEV;
Jan Blunck4ac91372008-02-14 19:34:32 -08003379 if (oldnd.path.mnt != newnd.path.mnt)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003380 goto exit2;
3381
Jan Blunck4ac91372008-02-14 19:34:32 -08003382 old_dir = oldnd.path.dentry;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003383 error = -EBUSY;
3384 if (oldnd.last_type != LAST_NORM)
3385 goto exit2;
3386
Jan Blunck4ac91372008-02-14 19:34:32 -08003387 new_dir = newnd.path.dentry;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003388 if (newnd.last_type != LAST_NORM)
3389 goto exit2;
3390
OGAWA Hirofumi0612d9f2008-10-16 07:50:29 +09003391 oldnd.flags &= ~LOOKUP_PARENT;
3392 newnd.flags &= ~LOOKUP_PARENT;
OGAWA Hirofumi4e9ed2f2008-10-16 07:50:29 +09003393 newnd.flags |= LOOKUP_RENAME_TARGET;
OGAWA Hirofumi0612d9f2008-10-16 07:50:29 +09003394
Linus Torvalds1da177e2005-04-16 15:20:36 -07003395 trap = lock_rename(new_dir, old_dir);
3396
Christoph Hellwig49705b72005-11-08 21:35:06 -08003397 old_dentry = lookup_hash(&oldnd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003398 error = PTR_ERR(old_dentry);
3399 if (IS_ERR(old_dentry))
3400 goto exit3;
3401 /* source must exist */
3402 error = -ENOENT;
3403 if (!old_dentry->d_inode)
3404 goto exit4;
3405 /* unless the source is a directory trailing slashes give -ENOTDIR */
3406 if (!S_ISDIR(old_dentry->d_inode->i_mode)) {
3407 error = -ENOTDIR;
3408 if (oldnd.last.name[oldnd.last.len])
3409 goto exit4;
3410 if (newnd.last.name[newnd.last.len])
3411 goto exit4;
3412 }
3413 /* source should not be ancestor of target */
3414 error = -EINVAL;
3415 if (old_dentry == trap)
3416 goto exit4;
Christoph Hellwig49705b72005-11-08 21:35:06 -08003417 new_dentry = lookup_hash(&newnd);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003418 error = PTR_ERR(new_dentry);
3419 if (IS_ERR(new_dentry))
3420 goto exit4;
3421 /* target should not be an ancestor of source */
3422 error = -ENOTEMPTY;
3423 if (new_dentry == trap)
3424 goto exit5;
3425
Dave Hansen9079b1e2008-02-15 14:37:49 -08003426 error = mnt_want_write(oldnd.path.mnt);
3427 if (error)
3428 goto exit5;
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09003429 error = security_path_rename(&oldnd.path, old_dentry,
3430 &newnd.path, new_dentry);
3431 if (error)
3432 goto exit6;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003433 error = vfs_rename(old_dir->d_inode, old_dentry,
3434 new_dir->d_inode, new_dentry);
Kentaro Takedabe6d3e52008-12-17 13:24:15 +09003435exit6:
Dave Hansen9079b1e2008-02-15 14:37:49 -08003436 mnt_drop_write(oldnd.path.mnt);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003437exit5:
3438 dput(new_dentry);
3439exit4:
3440 dput(old_dentry);
3441exit3:
3442 unlock_rename(new_dir, old_dir);
3443exit2:
Jan Blunck1d957f92008-02-14 19:34:35 -08003444 path_put(&newnd.path);
Al Viro2ad94ae2008-07-21 09:32:51 -04003445 putname(to);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003446exit1:
Jan Blunck1d957f92008-02-14 19:34:35 -08003447 path_put(&oldnd.path);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003448 putname(from);
Al Viro2ad94ae2008-07-21 09:32:51 -04003449exit:
Linus Torvalds1da177e2005-04-16 15:20:36 -07003450 return error;
3451}
3452
Heiko Carstensa26eab22009-01-14 14:14:17 +01003453SYSCALL_DEFINE2(rename, const char __user *, oldname, const char __user *, newname)
Ulrich Drepper5590ff02006-01-18 17:43:53 -08003454{
3455 return sys_renameat(AT_FDCWD, oldname, AT_FDCWD, newname);
3456}
3457
Linus Torvalds1da177e2005-04-16 15:20:36 -07003458int vfs_readlink(struct dentry *dentry, char __user *buffer, int buflen, const char *link)
3459{
3460 int len;
3461
3462 len = PTR_ERR(link);
3463 if (IS_ERR(link))
3464 goto out;
3465
3466 len = strlen(link);
3467 if (len > (unsigned) buflen)
3468 len = buflen;
3469 if (copy_to_user(buffer, link, len))
3470 len = -EFAULT;
3471out:
3472 return len;
3473}
3474
3475/*
3476 * A helper for ->readlink(). This should be used *ONLY* for symlinks that
3477 * have ->follow_link() touching nd only in nd_set_link(). Using (or not
3478 * using) it for any given inode is up to filesystem.
3479 */
3480int generic_readlink(struct dentry *dentry, char __user *buffer, int buflen)
3481{
3482 struct nameidata nd;
Linus Torvaldscc314ee2005-08-19 18:02:56 -07003483 void *cookie;
Marcin Slusarz694a1762008-06-09 16:40:37 -07003484 int res;
Linus Torvaldscc314ee2005-08-19 18:02:56 -07003485
Linus Torvalds1da177e2005-04-16 15:20:36 -07003486 nd.depth = 0;
Linus Torvaldscc314ee2005-08-19 18:02:56 -07003487 cookie = dentry->d_inode->i_op->follow_link(dentry, &nd);
Marcin Slusarz694a1762008-06-09 16:40:37 -07003488 if (IS_ERR(cookie))
3489 return PTR_ERR(cookie);
3490
3491 res = vfs_readlink(dentry, buffer, buflen, nd_get_link(&nd));
3492 if (dentry->d_inode->i_op->put_link)
3493 dentry->d_inode->i_op->put_link(dentry, &nd, cookie);
3494 return res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003495}
3496
3497int vfs_follow_link(struct nameidata *nd, const char *link)
3498{
3499 return __vfs_follow_link(nd, link);
3500}
3501
3502/* get the link contents into pagecache */
3503static char *page_getlink(struct dentry * dentry, struct page **ppage)
3504{
Duane Griffinebd09ab2008-12-19 20:47:12 +00003505 char *kaddr;
3506 struct page *page;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003507 struct address_space *mapping = dentry->d_inode->i_mapping;
Pekka Enberg090d2b12006-06-23 02:05:08 -07003508 page = read_mapping_page(mapping, 0, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003509 if (IS_ERR(page))
Nick Piggin6fe69002007-05-06 14:49:04 -07003510 return (char*)page;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003511 *ppage = page;
Duane Griffinebd09ab2008-12-19 20:47:12 +00003512 kaddr = kmap(page);
3513 nd_terminate_link(kaddr, dentry->d_inode->i_size, PAGE_SIZE - 1);
3514 return kaddr;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003515}
3516
3517int page_readlink(struct dentry *dentry, char __user *buffer, int buflen)
3518{
3519 struct page *page = NULL;
3520 char *s = page_getlink(dentry, &page);
3521 int res = vfs_readlink(dentry,buffer,buflen,s);
3522 if (page) {
3523 kunmap(page);
3524 page_cache_release(page);
3525 }
3526 return res;
3527}
3528
Linus Torvaldscc314ee2005-08-19 18:02:56 -07003529void *page_follow_link_light(struct dentry *dentry, struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003530{
Linus Torvaldscc314ee2005-08-19 18:02:56 -07003531 struct page *page = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003532 nd_set_link(nd, page_getlink(dentry, &page));
Linus Torvaldscc314ee2005-08-19 18:02:56 -07003533 return page;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003534}
3535
Linus Torvaldscc314ee2005-08-19 18:02:56 -07003536void page_put_link(struct dentry *dentry, struct nameidata *nd, void *cookie)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003537{
Linus Torvaldscc314ee2005-08-19 18:02:56 -07003538 struct page *page = cookie;
3539
3540 if (page) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07003541 kunmap(page);
3542 page_cache_release(page);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003543 }
3544}
3545
Nick Piggin54566b22009-01-04 12:00:53 -08003546/*
3547 * The nofs argument instructs pagecache_write_begin to pass AOP_FLAG_NOFS
3548 */
3549int __page_symlink(struct inode *inode, const char *symname, int len, int nofs)
Linus Torvalds1da177e2005-04-16 15:20:36 -07003550{
3551 struct address_space *mapping = inode->i_mapping;
Kirill Korotaev0adb25d2006-03-11 03:27:13 -08003552 struct page *page;
Nick Pigginafddba42007-10-16 01:25:01 -07003553 void *fsdata;
Dmitriy Monakhovbeb497a2007-02-16 01:27:18 -08003554 int err;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003555 char *kaddr;
Nick Piggin54566b22009-01-04 12:00:53 -08003556 unsigned int flags = AOP_FLAG_UNINTERRUPTIBLE;
3557 if (nofs)
3558 flags |= AOP_FLAG_NOFS;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003559
NeilBrown7e53cac2006-03-25 03:07:57 -08003560retry:
Nick Pigginafddba42007-10-16 01:25:01 -07003561 err = pagecache_write_begin(NULL, mapping, 0, len-1,
Nick Piggin54566b22009-01-04 12:00:53 -08003562 flags, &page, &fsdata);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003563 if (err)
Nick Pigginafddba42007-10-16 01:25:01 -07003564 goto fail;
3565
Linus Torvalds1da177e2005-04-16 15:20:36 -07003566 kaddr = kmap_atomic(page, KM_USER0);
3567 memcpy(kaddr, symname, len-1);
3568 kunmap_atomic(kaddr, KM_USER0);
Nick Pigginafddba42007-10-16 01:25:01 -07003569
3570 err = pagecache_write_end(NULL, mapping, 0, len-1, len-1,
3571 page, fsdata);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003572 if (err < 0)
3573 goto fail;
Nick Pigginafddba42007-10-16 01:25:01 -07003574 if (err < len-1)
3575 goto retry;
3576
Linus Torvalds1da177e2005-04-16 15:20:36 -07003577 mark_inode_dirty(inode);
3578 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07003579fail:
3580 return err;
3581}
3582
Kirill Korotaev0adb25d2006-03-11 03:27:13 -08003583int page_symlink(struct inode *inode, const char *symname, int len)
3584{
3585 return __page_symlink(inode, symname, len,
Nick Piggin54566b22009-01-04 12:00:53 -08003586 !(mapping_gfp_mask(inode->i_mapping) & __GFP_FS));
Kirill Korotaev0adb25d2006-03-11 03:27:13 -08003587}
3588
Arjan van de Ven92e1d5b2007-02-12 00:55:39 -08003589const struct inode_operations page_symlink_inode_operations = {
Linus Torvalds1da177e2005-04-16 15:20:36 -07003590 .readlink = generic_readlink,
3591 .follow_link = page_follow_link_light,
3592 .put_link = page_put_link,
3593};
3594
Al Viro2d8f3032008-07-22 09:59:21 -04003595EXPORT_SYMBOL(user_path_at);
David Howellscc53ce52011-01-14 18:45:26 +00003596EXPORT_SYMBOL(follow_down_one);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003597EXPORT_SYMBOL(follow_down);
3598EXPORT_SYMBOL(follow_up);
3599EXPORT_SYMBOL(get_write_access); /* binfmt_aout */
3600EXPORT_SYMBOL(getname);
3601EXPORT_SYMBOL(lock_rename);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003602EXPORT_SYMBOL(lookup_one_len);
3603EXPORT_SYMBOL(page_follow_link_light);
3604EXPORT_SYMBOL(page_put_link);
3605EXPORT_SYMBOL(page_readlink);
Kirill Korotaev0adb25d2006-03-11 03:27:13 -08003606EXPORT_SYMBOL(__page_symlink);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003607EXPORT_SYMBOL(page_symlink);
3608EXPORT_SYMBOL(page_symlink_inode_operations);
3609EXPORT_SYMBOL(path_lookup);
Al Virod1811462008-08-02 00:49:18 -04003610EXPORT_SYMBOL(kern_path);
Josef 'Jeff' Sipek16f18202007-07-19 01:48:18 -07003611EXPORT_SYMBOL(vfs_path_lookup);
Al Virof419a2e2008-07-22 00:07:17 -04003612EXPORT_SYMBOL(inode_permission);
Christoph Hellwig8c744fb2005-11-08 21:35:04 -08003613EXPORT_SYMBOL(file_permission);
Linus Torvalds1da177e2005-04-16 15:20:36 -07003614EXPORT_SYMBOL(unlock_rename);
3615EXPORT_SYMBOL(vfs_create);
3616EXPORT_SYMBOL(vfs_follow_link);
3617EXPORT_SYMBOL(vfs_link);
3618EXPORT_SYMBOL(vfs_mkdir);
3619EXPORT_SYMBOL(vfs_mknod);
3620EXPORT_SYMBOL(generic_permission);
3621EXPORT_SYMBOL(vfs_readlink);
3622EXPORT_SYMBOL(vfs_rename);
3623EXPORT_SYMBOL(vfs_rmdir);
3624EXPORT_SYMBOL(vfs_symlink);
3625EXPORT_SYMBOL(vfs_unlink);
3626EXPORT_SYMBOL(dentry_unhash);
3627EXPORT_SYMBOL(generic_readlink);