2005-04-16 16:20:36 -06:00
|
|
|
#ifndef _LINUX_NAMEI_H
|
|
|
|
#define _LINUX_NAMEI_H
|
|
|
|
|
2006-10-01 00:27:22 -06:00
|
|
|
#include <linux/dcache.h>
|
2005-04-16 16:20:36 -06:00
|
|
|
#include <linux/linkage.h>
|
2008-02-14 20:34:31 -07:00
|
|
|
#include <linux/path.h>
|
2005-04-16 16:20:36 -06:00
|
|
|
|
|
|
|
struct vfsmount;
|
|
|
|
|
|
|
|
struct open_intent {
|
|
|
|
int flags;
|
|
|
|
int create_mode;
|
2005-10-18 15:20:16 -06:00
|
|
|
struct file *file;
|
2005-04-16 16:20:36 -06:00
|
|
|
};
|
|
|
|
|
2006-07-14 01:24:29 -06:00
|
|
|
enum { MAX_NESTED_LINKS = 8 };
|
2005-04-16 16:20:36 -06:00
|
|
|
|
|
|
|
struct nameidata {
|
2008-02-14 20:34:32 -07:00
|
|
|
struct path path;
|
2005-04-16 16:20:36 -06:00
|
|
|
struct qstr last;
|
2009-04-07 09:49:53 -06:00
|
|
|
struct path root;
|
2005-04-16 16:20:36 -06:00
|
|
|
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
|
2009-06-16 03:17:53 -06:00
|
|
|
* - internal "there are more path components" flag
|
2005-04-16 16:20:36 -06:00
|
|
|
* - 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_REVAL 64
|
|
|
|
/*
|
|
|
|
* Intent data
|
|
|
|
*/
|
2008-08-05 01:00:49 -06:00
|
|
|
#define LOOKUP_OPEN 0x0100
|
|
|
|
#define LOOKUP_CREATE 0x0200
|
|
|
|
#define LOOKUP_EXCL 0x0400
|
2008-10-15 16:50:29 -06:00
|
|
|
#define LOOKUP_RENAME_TARGET 0x0800
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2008-07-22 07:59:21 -06:00
|
|
|
extern int user_path_at(int, const char __user *, unsigned, struct path *);
|
|
|
|
|
|
|
|
#define user_path(name, path) user_path_at(AT_FDCWD, name, LOOKUP_FOLLOW, path)
|
|
|
|
#define user_lpath(name, path) user_path_at(AT_FDCWD, name, 0, path)
|
|
|
|
#define user_path_dir(name, path) \
|
|
|
|
user_path_at(AT_FDCWD, name, LOOKUP_FOLLOW | LOOKUP_DIRECTORY, path)
|
|
|
|
|
2008-08-01 22:49:18 -06:00
|
|
|
extern int kern_path(const char *, unsigned, struct path *);
|
|
|
|
|
2008-02-13 16:03:15 -07: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 02:48:18 -06:00
|
|
|
extern int vfs_path_lookup(struct dentry *, struct vfsmount *,
|
|
|
|
const char *, unsigned int, struct nameidata *);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2005-10-18 15:20:16 -06: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 00:25:38 -06:00
|
|
|
extern struct dentry *lookup_one_len(const char *, struct dentry *, int);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
2009-04-18 11:58:15 -06:00
|
|
|
extern int follow_down(struct path *);
|
2009-04-18 01:26:48 -06:00
|
|
|
extern int follow_up(struct path *);
|
2005-04-16 16:20:36 -06:00
|
|
|
|
|
|
|
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];
|
|
|
|
}
|
|
|
|
|
2008-12-19 13:47:11 -07:00
|
|
|
static inline void nd_terminate_link(void *name, size_t len, size_t maxlen)
|
|
|
|
{
|
|
|
|
((char *) name)[min(len, maxlen)] = '\0';
|
|
|
|
}
|
|
|
|
|
2005-04-16 16:20:36 -06:00
|
|
|
#endif /* _LINUX_NAMEI_H */
|