2005-04-17 06:20:36 +08:00
|
|
|
#ifndef _LINUX_NAMEI_H
|
|
|
|
#define _LINUX_NAMEI_H
|
|
|
|
|
2006-10-01 14:27:22 +08:00
|
|
|
#include <linux/dcache.h>
|
2005-04-17 06:20:36 +08:00
|
|
|
#include <linux/linkage.h>
|
2008-02-15 11:34:31 +08:00
|
|
|
#include <linux/path.h>
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
struct vfsmount;
|
|
|
|
|
|
|
|
struct open_intent {
|
|
|
|
int flags;
|
|
|
|
int create_mode;
|
2005-10-19 05:20:16 +08:00
|
|
|
struct file *file;
|
2005-04-17 06:20:36 +08:00
|
|
|
};
|
|
|
|
|
2006-07-14 15:24:29 +08:00
|
|
|
enum { MAX_NESTED_LINKS = 8 };
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
struct nameidata {
|
|
|
|
struct dentry *dentry;
|
|
|
|
struct vfsmount *mnt;
|
|
|
|
struct qstr last;
|
|
|
|
unsigned int flags;
|
|
|
|
int last_type;
|
|
|
|
unsigned depth;
|
|
|
|
char *saved_names[MAX_NESTED_LINKS + 1];
|
|
|
|
|
|
|
|
/* Intent data */
|
|
|
|
union {
|
|
|
|
struct open_intent open;
|
|
|
|
} intent;
|
|
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Type of the last component on LOOKUP_PARENT
|
|
|
|
*/
|
|
|
|
enum {LAST_NORM, LAST_ROOT, LAST_DOT, LAST_DOTDOT, LAST_BIND};
|
|
|
|
|
|
|
|
/*
|
|
|
|
* The bitmask for a lookup event:
|
|
|
|
* - follow links at the end
|
|
|
|
* - require a directory
|
|
|
|
* - ending slashes ok even for nonexistent files
|
|
|
|
* - internal "there are more path compnents" flag
|
|
|
|
* - locked when lookup done with dcache_lock held
|
|
|
|
* - dentry cache is untrusted; force a real lookup
|
|
|
|
*/
|
|
|
|
#define LOOKUP_FOLLOW 1
|
|
|
|
#define LOOKUP_DIRECTORY 2
|
|
|
|
#define LOOKUP_CONTINUE 4
|
|
|
|
#define LOOKUP_PARENT 16
|
|
|
|
#define LOOKUP_NOALT 32
|
|
|
|
#define LOOKUP_REVAL 64
|
|
|
|
/*
|
|
|
|
* Intent data
|
|
|
|
*/
|
|
|
|
#define LOOKUP_OPEN (0x0100)
|
|
|
|
#define LOOKUP_CREATE (0x0200)
|
|
|
|
#define LOOKUP_ACCESS (0x0400)
|
2006-09-29 16:59:35 +08:00
|
|
|
#define LOOKUP_CHDIR (0x0800)
|
2005-04-17 06:20:36 +08:00
|
|
|
|
2008-02-14 07:03:15 +08:00
|
|
|
extern int __user_walk(const char __user *, unsigned, struct nameidata *);
|
|
|
|
extern int __user_walk_fd(int dfd, const char __user *, unsigned, struct nameidata *);
|
2005-04-17 06:20:36 +08:00
|
|
|
#define user_path_walk(name,nd) \
|
2006-01-19 09:43:53 +08:00
|
|
|
__user_walk_fd(AT_FDCWD, name, LOOKUP_FOLLOW, nd)
|
2005-04-17 06:20:36 +08:00
|
|
|
#define user_path_walk_link(name,nd) \
|
2006-01-19 09:43:53 +08:00
|
|
|
__user_walk_fd(AT_FDCWD, name, 0, nd)
|
2008-02-14 07:03:15 +08:00
|
|
|
extern int path_lookup(const char *, unsigned, struct nameidata *);
|
fs: introduce vfs_path_lookup
Stackable file systems, among others, frequently need to lookup paths or
path components starting from an arbitrary point in the namespace
(identified by a dentry and a vfsmount). Currently, such file systems use
lookup_one_len, which is frowned upon [1] as it does not pass the lookup
intent along; not passing a lookup intent, for example, can trigger BUG_ON's
when stacking on top of NFSv4.
The first patch introduces a new lookup function to allow lookup starting
from an arbitrary point in the namespace. This approach has been suggested
by Christoph Hellwig [2].
The second patch changes sunrpc to use vfs_path_lookup.
The third patch changes nfsctl.c to use vfs_path_lookup.
The fourth patch marks link_path_walk static.
The fifth, and last patch, unexports path_walk because it is no longer
unnecessary to call it directly, and using the new vfs_path_lookup is
cleaner.
For example, the following snippet of code, looks up "some/path/component"
in a directory pointed to by parent_{dentry,vfsmnt}:
err = vfs_path_lookup(parent_dentry, parent_vfsmnt,
"some/path/component", 0, &nd);
if (!err) {
/* exits */
...
/* once done, release the references */
path_release(&nd);
} else if (err == -ENOENT) {
/* doesn't exist */
} else {
/* other error */
}
VFS functions such as lookup_create can be used on the nameidata structure
to pass the create intent to the file system.
Signed-off-by: Josef 'Jeff' Sipek <jsipek@cs.sunysb.edu>
Cc: Al Viro <viro@zeniv.linux.org.uk>
Acked-by: Christoph Hellwig <hch@lst.de>
Cc: Trond Myklebust <trond.myklebust@fys.uio.no>
Cc: Neil Brown <neilb@suse.de>
Cc: Michael Halcrow <mhalcrow@us.ibm.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
2007-07-19 16:48:18 +08:00
|
|
|
extern int vfs_path_lookup(struct dentry *, struct vfsmount *,
|
|
|
|
const char *, unsigned int, struct nameidata *);
|
2005-04-17 06:20:36 +08:00
|
|
|
extern void path_release(struct nameidata *);
|
|
|
|
|
2005-10-19 05:20:16 +08:00
|
|
|
extern int __user_path_lookup_open(const char __user *, unsigned lookup_flags, struct nameidata *nd, int open_flags);
|
2006-01-19 09:43:53 +08:00
|
|
|
extern int path_lookup_open(int dfd, const char *name, unsigned lookup_flags, struct nameidata *, int open_flags);
|
2005-10-19 05:20:16 +08:00
|
|
|
extern struct file *lookup_instantiate_filp(struct nameidata *nd, struct dentry *dentry,
|
|
|
|
int (*open)(struct inode *, struct file *));
|
|
|
|
extern struct file *nameidata_to_filp(struct nameidata *nd, int flags);
|
|
|
|
extern void release_open_intent(struct nameidata *);
|
|
|
|
|
2007-10-17 14:25:38 +08:00
|
|
|
extern struct dentry *lookup_one_len(const char *, struct dentry *, int);
|
|
|
|
extern struct dentry *lookup_one_noperm(const char *, struct dentry *);
|
2005-04-17 06:20:36 +08:00
|
|
|
|
|
|
|
extern int follow_down(struct vfsmount **, struct dentry **);
|
|
|
|
extern int follow_up(struct vfsmount **, struct dentry **);
|
|
|
|
|
|
|
|
extern struct dentry *lock_rename(struct dentry *, struct dentry *);
|
|
|
|
extern void unlock_rename(struct dentry *, struct dentry *);
|
|
|
|
|
|
|
|
static inline void nd_set_link(struct nameidata *nd, char *path)
|
|
|
|
{
|
|
|
|
nd->saved_names[nd->depth] = path;
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline char *nd_get_link(struct nameidata *nd)
|
|
|
|
{
|
|
|
|
return nd->saved_names[nd->depth];
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif /* _LINUX_NAMEI_H */
|