mirror of
https://github.com/torvalds/linux.git
synced 2024-10-22 21:20:52 +00:00
f8ffbc365f
-----BEGIN PGP SIGNATURE----- iHUEABYIAB0WIQQqUNBr3gm4hGXdBJlZ7Krx/gZQ6wUCZvDNmgAKCRBZ7Krx/gZQ 63zrAP9vI0rf55v27twiabe9LnI7aSx5ckoqXxFIFxyT3dOYpQD/bPmoApnWDD3d 592+iDgLsema/H/0/CqfqlaNtDNY8Q0= =HUl5 -----END PGP SIGNATURE----- Merge tag 'pull-stable-struct_fd' of git://git.kernel.org/pub/scm/linux/kernel/git/viro/vfs Pull 'struct fd' updates from Al Viro: "Just the 'struct fd' layout change, with conversion to accessor helpers" * tag 'pull-stable-struct_fd' of git://git.kernel.org/pub/scm/linux/kernel/git/viro/vfs: add struct fd constructors, get rid of __to_fd() struct fd: representation change introduce fd_file(), convert all accessors to it.
135 lines
3.6 KiB
C
135 lines
3.6 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>
|
|
#include <linux/errno.h>
|
|
#include <linux/cleanup.h>
|
|
#include <linux/err.h>
|
|
|
|
struct file;
|
|
|
|
extern void fput(struct file *);
|
|
|
|
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_pseudo_noaccount(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);
|
|
}
|
|
|
|
/* either a reference to struct file + flags
|
|
* (cloned vs. borrowed, pos locked), with
|
|
* flags stored in lower bits of value,
|
|
* or empty (represented by 0).
|
|
*/
|
|
struct fd {
|
|
unsigned long word;
|
|
};
|
|
#define FDPUT_FPUT 1
|
|
#define FDPUT_POS_UNLOCK 2
|
|
|
|
#define fd_file(f) ((struct file *)((f).word & ~(FDPUT_FPUT|FDPUT_POS_UNLOCK)))
|
|
static inline bool fd_empty(struct fd f)
|
|
{
|
|
return unlikely(!f.word);
|
|
}
|
|
|
|
#define EMPTY_FD (struct fd){0}
|
|
static inline struct fd BORROWED_FD(struct file *f)
|
|
{
|
|
return (struct fd){(unsigned long)f};
|
|
}
|
|
static inline struct fd CLONED_FD(struct file *f)
|
|
{
|
|
return (struct fd){(unsigned long)f | FDPUT_FPUT};
|
|
}
|
|
|
|
static inline void fdput(struct fd fd)
|
|
{
|
|
if (fd.word & FDPUT_FPUT)
|
|
fput(fd_file(fd));
|
|
}
|
|
|
|
extern struct file *fget(unsigned int fd);
|
|
extern struct file *fget_raw(unsigned int fd);
|
|
extern struct file *fget_task(struct task_struct *task, unsigned int fd);
|
|
extern void __f_unlock_pos(struct file *);
|
|
|
|
struct fd fdget(unsigned int fd);
|
|
struct fd fdget_raw(unsigned int fd);
|
|
struct fd fdget_pos(unsigned int fd);
|
|
|
|
static inline void fdput_pos(struct fd f)
|
|
{
|
|
if (f.word & FDPUT_POS_UNLOCK)
|
|
__f_unlock_pos(fd_file(f));
|
|
fdput(f);
|
|
}
|
|
|
|
DEFINE_CLASS(fd, struct fd, fdput(_T), fdget(fd), int fd)
|
|
DEFINE_CLASS(fd_raw, struct fd, fdput(_T), fdget_raw(fd), int fd)
|
|
|
|
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, unsigned long nofile);
|
|
extern int get_unused_fd_flags(unsigned flags);
|
|
extern void put_unused_fd(unsigned int fd);
|
|
|
|
DEFINE_CLASS(get_unused_fd, int, if (_T >= 0) put_unused_fd(_T),
|
|
get_unused_fd_flags(flags), unsigned flags)
|
|
DEFINE_FREE(fput, struct file *, if (!IS_ERR_OR_NULL(_T)) fput(_T))
|
|
|
|
/*
|
|
* take_fd() will take care to set @fd to -EBADF ensuring that
|
|
* CLASS(get_unused_fd) won't call put_unused_fd(). This makes it
|
|
* easier to rely on CLASS(get_unused_fd):
|
|
*
|
|
* struct file *f;
|
|
*
|
|
* CLASS(get_unused_fd, fd)(O_CLOEXEC);
|
|
* if (fd < 0)
|
|
* return fd;
|
|
*
|
|
* f = dentry_open(&path, O_RDONLY, current_cred());
|
|
* if (IS_ERR(f))
|
|
* return PTR_ERR(f);
|
|
*
|
|
* fd_install(fd, f);
|
|
* return take_fd(fd);
|
|
*/
|
|
#define take_fd(fd) __get_and_null(fd, -EBADF)
|
|
|
|
extern void fd_install(unsigned int fd, struct file *file);
|
|
|
|
int receive_fd(struct file *file, int __user *ufd, unsigned int o_flags);
|
|
|
|
int receive_fd_replace(int new_fd, struct file *file, unsigned int o_flags);
|
|
|
|
extern void flush_delayed_fput(void);
|
|
extern void __fput_sync(struct file *);
|
|
|
|
extern unsigned int sysctl_nr_open_min, sysctl_nr_open_max;
|
|
|
|
#endif /* __LINUX_FILE_H */
|