Loading...
1/*
2 * fs/kernfs/kernfs-internal.h - kernfs internal header file
3 *
4 * Copyright (c) 2001-3 Patrick Mochel
5 * Copyright (c) 2007 SUSE Linux Products GmbH
6 * Copyright (c) 2007, 2013 Tejun Heo <teheo@suse.de>
7 *
8 * This file is released under the GPLv2.
9 */
10
11#ifndef __KERNFS_INTERNAL_H
12#define __KERNFS_INTERNAL_H
13
14#include <linux/lockdep.h>
15#include <linux/fs.h>
16#include <linux/mutex.h>
17#include <linux/xattr.h>
18
19#include <linux/kernfs.h>
20
21struct kernfs_iattrs {
22 struct iattr ia_iattr;
23 void *ia_secdata;
24 u32 ia_secdata_len;
25
26 struct simple_xattrs xattrs;
27};
28
29/* +1 to avoid triggering overflow warning when negating it */
30#define KN_DEACTIVATED_BIAS (INT_MIN + 1)
31
32/* KERNFS_TYPE_MASK and types are defined in include/linux/kernfs.h */
33
34/**
35 * kernfs_root - find out the kernfs_root a kernfs_node belongs to
36 * @kn: kernfs_node of interest
37 *
38 * Return the kernfs_root @kn belongs to.
39 */
40static inline struct kernfs_root *kernfs_root(struct kernfs_node *kn)
41{
42 /* if parent exists, it's always a dir; otherwise, @sd is a dir */
43 if (kn->parent)
44 kn = kn->parent;
45 return kn->dir.root;
46}
47
48/*
49 * mount.c
50 */
51struct kernfs_super_info {
52 struct super_block *sb;
53
54 /*
55 * The root associated with this super_block. Each super_block is
56 * identified by the root and ns it's associated with.
57 */
58 struct kernfs_root *root;
59
60 /*
61 * Each sb is associated with one namespace tag, currently the
62 * network namespace of the task which mounted this kernfs
63 * instance. If multiple tags become necessary, make the following
64 * an array and compare kernfs_node tag against every entry.
65 */
66 const void *ns;
67
68 /* anchored at kernfs_root->supers, protected by kernfs_mutex */
69 struct list_head node;
70};
71#define kernfs_info(SB) ((struct kernfs_super_info *)(SB->s_fs_info))
72
73extern const struct super_operations kernfs_sops;
74extern struct kmem_cache *kernfs_node_cache;
75
76/*
77 * inode.c
78 */
79extern const struct xattr_handler *kernfs_xattr_handlers[];
80void kernfs_evict_inode(struct inode *inode);
81int kernfs_iop_permission(struct inode *inode, int mask);
82int kernfs_iop_setattr(struct dentry *dentry, struct iattr *iattr);
83int kernfs_iop_getattr(struct vfsmount *mnt, struct dentry *dentry,
84 struct kstat *stat);
85ssize_t kernfs_iop_listxattr(struct dentry *dentry, char *buf, size_t size);
86
87/*
88 * dir.c
89 */
90extern struct mutex kernfs_mutex;
91extern const struct dentry_operations kernfs_dops;
92extern const struct file_operations kernfs_dir_fops;
93extern const struct inode_operations kernfs_dir_iops;
94
95struct kernfs_node *kernfs_get_active(struct kernfs_node *kn);
96void kernfs_put_active(struct kernfs_node *kn);
97int kernfs_add_one(struct kernfs_node *kn);
98struct kernfs_node *kernfs_new_node(struct kernfs_node *parent,
99 const char *name, umode_t mode,
100 unsigned flags);
101
102/*
103 * file.c
104 */
105extern const struct file_operations kernfs_file_fops;
106
107void kernfs_unmap_bin_file(struct kernfs_node *kn);
108
109/*
110 * symlink.c
111 */
112extern const struct inode_operations kernfs_symlink_iops;
113
114#endif /* __KERNFS_INTERNAL_H */
1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * fs/kernfs/kernfs-internal.h - kernfs internal header file
4 *
5 * Copyright (c) 2001-3 Patrick Mochel
6 * Copyright (c) 2007 SUSE Linux Products GmbH
7 * Copyright (c) 2007, 2013 Tejun Heo <teheo@suse.de>
8 */
9
10#ifndef __KERNFS_INTERNAL_H
11#define __KERNFS_INTERNAL_H
12
13#include <linux/lockdep.h>
14#include <linux/fs.h>
15#include <linux/mutex.h>
16#include <linux/xattr.h>
17
18#include <linux/kernfs.h>
19#include <linux/fs_context.h>
20
21struct kernfs_iattrs {
22 kuid_t ia_uid;
23 kgid_t ia_gid;
24 struct timespec64 ia_atime;
25 struct timespec64 ia_mtime;
26 struct timespec64 ia_ctime;
27
28 struct simple_xattrs xattrs;
29 atomic_t nr_user_xattrs;
30 atomic_t user_xattr_size;
31};
32
33/* +1 to avoid triggering overflow warning when negating it */
34#define KN_DEACTIVATED_BIAS (INT_MIN + 1)
35
36/* KERNFS_TYPE_MASK and types are defined in include/linux/kernfs.h */
37
38/**
39 * kernfs_root - find out the kernfs_root a kernfs_node belongs to
40 * @kn: kernfs_node of interest
41 *
42 * Return the kernfs_root @kn belongs to.
43 */
44static inline struct kernfs_root *kernfs_root(struct kernfs_node *kn)
45{
46 /* if parent exists, it's always a dir; otherwise, @sd is a dir */
47 if (kn->parent)
48 kn = kn->parent;
49 return kn->dir.root;
50}
51
52/*
53 * mount.c
54 */
55struct kernfs_super_info {
56 struct super_block *sb;
57
58 /*
59 * The root associated with this super_block. Each super_block is
60 * identified by the root and ns it's associated with.
61 */
62 struct kernfs_root *root;
63
64 /*
65 * Each sb is associated with one namespace tag, currently the
66 * network namespace of the task which mounted this kernfs
67 * instance. If multiple tags become necessary, make the following
68 * an array and compare kernfs_node tag against every entry.
69 */
70 const void *ns;
71
72 /* anchored at kernfs_root->supers, protected by kernfs_mutex */
73 struct list_head node;
74};
75#define kernfs_info(SB) ((struct kernfs_super_info *)(SB->s_fs_info))
76
77static inline struct kernfs_node *kernfs_dentry_node(struct dentry *dentry)
78{
79 if (d_really_is_negative(dentry))
80 return NULL;
81 return d_inode(dentry)->i_private;
82}
83
84extern const struct super_operations kernfs_sops;
85extern struct kmem_cache *kernfs_node_cache, *kernfs_iattrs_cache;
86
87/*
88 * inode.c
89 */
90extern const struct xattr_handler *kernfs_xattr_handlers[];
91void kernfs_evict_inode(struct inode *inode);
92int kernfs_iop_permission(struct user_namespace *mnt_userns,
93 struct inode *inode, int mask);
94int kernfs_iop_setattr(struct user_namespace *mnt_userns, struct dentry *dentry,
95 struct iattr *iattr);
96int kernfs_iop_getattr(struct user_namespace *mnt_userns,
97 const struct path *path, struct kstat *stat,
98 u32 request_mask, unsigned int query_flags);
99ssize_t kernfs_iop_listxattr(struct dentry *dentry, char *buf, size_t size);
100int __kernfs_setattr(struct kernfs_node *kn, const struct iattr *iattr);
101
102/*
103 * dir.c
104 */
105extern struct mutex kernfs_mutex;
106extern const struct dentry_operations kernfs_dops;
107extern const struct file_operations kernfs_dir_fops;
108extern const struct inode_operations kernfs_dir_iops;
109
110struct kernfs_node *kernfs_get_active(struct kernfs_node *kn);
111void kernfs_put_active(struct kernfs_node *kn);
112int kernfs_add_one(struct kernfs_node *kn);
113struct kernfs_node *kernfs_new_node(struct kernfs_node *parent,
114 const char *name, umode_t mode,
115 kuid_t uid, kgid_t gid,
116 unsigned flags);
117
118/*
119 * file.c
120 */
121extern const struct file_operations kernfs_file_fops;
122
123void kernfs_drain_open_files(struct kernfs_node *kn);
124
125/*
126 * symlink.c
127 */
128extern const struct inode_operations kernfs_symlink_iops;
129
130#endif /* __KERNFS_INTERNAL_H */