[PATCH 1/2] vfs: export symbol 'getname' and 'putname'
boqun.feng at gmail.com
Wed Apr 22 03:50:23 UTC 2015
getname/putname in fs/namei.c is a well-implemented way to copy a file
name from userland, however other ways, such as directly calling
__getname() and strncpy_from_user(), may lack features(e.g. auditing and
reusing), introduce errors or at least reinvent wheels. Therefore for
places need a kernel file name copy from userland, it's better to use
getname and putname if possible.
To be able to use these functions all over the kernel, symbols 'getname'
and 'putname' are exported and comments of their behaviors and
constraints are added.
Suggested-by: Al Viro <viro at ZenIV.linux.org.uk>
Signed-off-by: Boqun Feng <boqun.feng at gmail.com>
fs/namei.c | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/fs/namei.c b/fs/namei.c
index c83145a..472911c 100644
@@ -199,11 +199,23 @@ error:
+ * getname() - Get a file name copy from userland
+ * @filename: userland pointer to the file name
+ * If successful, return a 'struct filename' pointer and ->name is the pointer
+ * to the kernel copy of the file name, otherwise an ERR_PTR.
+ * getname() should only be called in a system call context, and for each
+ * getname() that returns a successful value, callers must ensure exactly one
+ * corresponding putname() is called before returning to userland.
struct filename *
getname(const char __user * filename)
return getname_flags(filename, 0, NULL);
struct filename *
getname_kernel(const char * filename)
@@ -242,6 +254,11 @@ getname_kernel(const char * filename)
+/* putname() - Release a 'struct filename' structure
+ * @name: the 'struct filename' structure to be release
+ * See more at getname()
void putname(struct filename *name)
BUG_ON(name->refcnt <= 0);
@@ -255,6 +272,7 @@ void putname(struct filename *name)
static int check_acl(struct inode *inode, int mask)
More information about the devel