5e876fb43d
This introduces a function which can be used to fetch a file, given an arbitrary task. As long as the user holds a reference (refcnt) to the task_struct it is safe to call, and will either return NULL on failure, or a pointer to the file, with a refcnt. This patch is based on Oleg Nesterov's (cf. [1]) patch from September 2018. [1]: Link: https://lore.kernel.org/r/20180915160423.GA31461@redhat.com Signed-off-by: Sargun Dhillon <sargun@sargun.me> Suggested-by: Oleg Nesterov <oleg@redhat.com> Acked-by: Christian Brauner <christian.brauner@ubuntu.com> Reviewed-by: Arnd Bergmann <arnd@arndb.de> Link: https://lore.kernel.org/r/20200107175927.4558-2-sargun@sargun.me Signed-off-by: Christian Brauner <christian.brauner@ubuntu.com>
97 lines
2.3 KiB
C
97 lines
2.3 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Wrapper functions for accessing the file_struct fd array.
|
|
*/
|
|
|
|
#ifndef __LINUX_FILE_H
|
|
#define __LINUX_FILE_H
|
|
|
|
#include <linux/compiler.h>
|
|
#include <linux/types.h>
|
|
#include <linux/posix_types.h>
|
|
|
|
struct file;
|
|
|
|
extern void fput(struct file *);
|
|
extern void fput_many(struct file *, unsigned int);
|
|
|
|
struct file_operations;
|
|
struct task_struct;
|
|
struct vfsmount;
|
|
struct dentry;
|
|
struct inode;
|
|
struct path;
|
|
extern struct file *alloc_file_pseudo(struct inode *, struct vfsmount *,
|
|
const char *, int flags, const struct file_operations *);
|
|
extern struct file *alloc_file_clone(struct file *, int flags,
|
|
const struct file_operations *);
|
|
|
|
static inline void fput_light(struct file *file, int fput_needed)
|
|
{
|
|
if (fput_needed)
|
|
fput(file);
|
|
}
|
|
|
|
struct fd {
|
|
struct file *file;
|
|
unsigned int flags;
|
|
};
|
|
#define FDPUT_FPUT 1
|
|
#define FDPUT_POS_UNLOCK 2
|
|
|
|
static inline void fdput(struct fd fd)
|
|
{
|
|
if (fd.flags & FDPUT_FPUT)
|
|
fput(fd.file);
|
|
}
|
|
|
|
extern struct file *fget(unsigned int fd);
|
|
extern struct file *fget_many(unsigned int fd, unsigned int refs);
|
|
extern struct file *fget_raw(unsigned int fd);
|
|
extern struct file *fget_task(struct task_struct *task, unsigned int fd);
|
|
extern unsigned long __fdget(unsigned int fd);
|
|
extern unsigned long __fdget_raw(unsigned int fd);
|
|
extern unsigned long __fdget_pos(unsigned int fd);
|
|
extern void __f_unlock_pos(struct file *);
|
|
|
|
static inline struct fd __to_fd(unsigned long v)
|
|
{
|
|
return (struct fd){(struct file *)(v & ~3),v & 3};
|
|
}
|
|
|
|
static inline struct fd fdget(unsigned int fd)
|
|
{
|
|
return __to_fd(__fdget(fd));
|
|
}
|
|
|
|
static inline struct fd fdget_raw(unsigned int fd)
|
|
{
|
|
return __to_fd(__fdget_raw(fd));
|
|
}
|
|
|
|
static inline struct fd fdget_pos(int fd)
|
|
{
|
|
return __to_fd(__fdget_pos(fd));
|
|
}
|
|
|
|
static inline void fdput_pos(struct fd f)
|
|
{
|
|
if (f.flags & FDPUT_POS_UNLOCK)
|
|
__f_unlock_pos(f.file);
|
|
fdput(f);
|
|
}
|
|
|
|
extern int f_dupfd(unsigned int from, struct file *file, unsigned flags);
|
|
extern int replace_fd(unsigned fd, struct file *file, unsigned flags);
|
|
extern void set_close_on_exec(unsigned int fd, int flag);
|
|
extern bool get_close_on_exec(unsigned int fd);
|
|
extern int get_unused_fd_flags(unsigned flags);
|
|
extern void put_unused_fd(unsigned int fd);
|
|
|
|
extern void fd_install(unsigned int fd, struct file *file);
|
|
|
|
extern void flush_delayed_fput(void);
|
|
extern void __fput_sync(struct file *);
|
|
|
|
#endif /* __LINUX_FILE_H */
|