155716d26SThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-only */ 2ae6621b0STejun Heo /* 3ae6621b0STejun Heo * fs/kernfs/kernfs-internal.h - kernfs internal header file 4ae6621b0STejun Heo * 5ae6621b0STejun Heo * Copyright (c) 2001-3 Patrick Mochel 6ae6621b0STejun Heo * Copyright (c) 2007 SUSE Linux Products GmbH 7ae6621b0STejun Heo * Copyright (c) 2007, 2013 Tejun Heo <teheo@suse.de> 8ae6621b0STejun Heo */ 9ae6621b0STejun Heo 10ae6621b0STejun Heo #ifndef __KERNFS_INTERNAL_H 11ae6621b0STejun Heo #define __KERNFS_INTERNAL_H 12ae6621b0STejun Heo 13ae6621b0STejun Heo #include <linux/lockdep.h> 14ae6621b0STejun Heo #include <linux/fs.h> 15fd7b9f7bSTejun Heo #include <linux/mutex.h> 167ba0273bSIan Kent #include <linux/rwsem.h> 172322392bSTejun Heo #include <linux/xattr.h> 18ae6621b0STejun Heo 19ae6621b0STejun Heo #include <linux/kernfs.h> 2023bf1b6bSDavid Howells #include <linux/fs_context.h> 21ae6621b0STejun Heo 22c525aaddSTejun Heo struct kernfs_iattrs { 2305895219SOndrej Mosnacek kuid_t ia_uid; 2405895219SOndrej Mosnacek kgid_t ia_gid; 2505895219SOndrej Mosnacek struct timespec64 ia_atime; 2605895219SOndrej Mosnacek struct timespec64 ia_mtime; 2705895219SOndrej Mosnacek struct timespec64 ia_ctime; 282322392bSTejun Heo 292322392bSTejun Heo struct simple_xattrs xattrs; 300c47383bSDaniel Xu atomic_t nr_user_xattrs; 310c47383bSDaniel Xu atomic_t user_xattr_size; 32ae6621b0STejun Heo }; 33ae6621b0STejun Heo 34f2eb478fSGreg Kroah-Hartman struct kernfs_root { 35f2eb478fSGreg Kroah-Hartman /* published fields */ 36f2eb478fSGreg Kroah-Hartman struct kernfs_node *kn; 37f2eb478fSGreg Kroah-Hartman unsigned int flags; /* KERNFS_ROOT_* flags */ 38f2eb478fSGreg Kroah-Hartman 39f2eb478fSGreg Kroah-Hartman /* private fields, do not use outside kernfs proper */ 40f2eb478fSGreg Kroah-Hartman struct idr ino_idr; 41f2eb478fSGreg Kroah-Hartman u32 last_id_lowbits; 42f2eb478fSGreg Kroah-Hartman u32 id_highbits; 43f2eb478fSGreg Kroah-Hartman struct kernfs_syscall_ops *syscall_ops; 44f2eb478fSGreg Kroah-Hartman 45f2eb478fSGreg Kroah-Hartman /* list of kernfs_super_info of this root, protected by kernfs_rwsem */ 46f2eb478fSGreg Kroah-Hartman struct list_head supers; 47f2eb478fSGreg Kroah-Hartman 48f2eb478fSGreg Kroah-Hartman wait_queue_head_t deactivate_waitq; 49f2eb478fSGreg Kroah-Hartman struct rw_semaphore kernfs_rwsem; 50f2eb478fSGreg Kroah-Hartman }; 51f2eb478fSGreg Kroah-Hartman 5281c173cbSTejun Heo /* +1 to avoid triggering overflow warning when negating it */ 5381c173cbSTejun Heo #define KN_DEACTIVATED_BIAS (INT_MIN + 1) 54ae6621b0STejun Heo 55df23fc39STejun Heo /* KERNFS_TYPE_MASK and types are defined in include/linux/kernfs.h */ 56ae6621b0STejun Heo 57ba7443bcSTejun Heo /** 58324a56e1STejun Heo * kernfs_root - find out the kernfs_root a kernfs_node belongs to 59324a56e1STejun Heo * @kn: kernfs_node of interest 60ba7443bcSTejun Heo * 6124b3e3ddSRandy Dunlap * Return: the kernfs_root @kn belongs to. 62ba7443bcSTejun Heo */ 63324a56e1STejun Heo static inline struct kernfs_root *kernfs_root(struct kernfs_node *kn) 64ba7443bcSTejun Heo { 65ba7443bcSTejun Heo /* if parent exists, it's always a dir; otherwise, @sd is a dir */ 66adc5e8b5STejun Heo if (kn->parent) 67adc5e8b5STejun Heo kn = kn->parent; 68adc5e8b5STejun Heo return kn->dir.root; 69ba7443bcSTejun Heo } 70ba7443bcSTejun Heo 71ae6621b0STejun Heo /* 72fa736a95STejun Heo * mount.c 73fa736a95STejun Heo */ 74c525aaddSTejun Heo struct kernfs_super_info { 757d568a83STejun Heo struct super_block *sb; 767d568a83STejun Heo 77fa736a95STejun Heo /* 78fa736a95STejun Heo * The root associated with this super_block. Each super_block is 79fa736a95STejun Heo * identified by the root and ns it's associated with. 80fa736a95STejun Heo */ 81fa736a95STejun Heo struct kernfs_root *root; 82fa736a95STejun Heo 83fa736a95STejun Heo /* 84324a56e1STejun Heo * Each sb is associated with one namespace tag, currently the 85c525aaddSTejun Heo * network namespace of the task which mounted this kernfs 86c525aaddSTejun Heo * instance. If multiple tags become necessary, make the following 87c525aaddSTejun Heo * an array and compare kernfs_node tag against every entry. 88fa736a95STejun Heo */ 89fa736a95STejun Heo const void *ns; 907d568a83STejun Heo 917ba0273bSIan Kent /* anchored at kernfs_root->supers, protected by kernfs_rwsem */ 927d568a83STejun Heo struct list_head node; 93fa736a95STejun Heo }; 94c525aaddSTejun Heo #define kernfs_info(SB) ((struct kernfs_super_info *)(SB->s_fs_info)) 95fa736a95STejun Heo 96319ba91dSShaohua Li static inline struct kernfs_node *kernfs_dentry_node(struct dentry *dentry) 97319ba91dSShaohua Li { 98319ba91dSShaohua Li if (d_really_is_negative(dentry)) 99319ba91dSShaohua Li return NULL; 100319ba91dSShaohua Li return d_inode(dentry)->i_private; 101319ba91dSShaohua Li } 102319ba91dSShaohua Li 103895adbecSIan Kent static inline void kernfs_set_rev(struct kernfs_node *parent, 104895adbecSIan Kent struct dentry *dentry) 105895adbecSIan Kent { 106895adbecSIan Kent dentry->d_time = parent->dir.rev; 107895adbecSIan Kent } 108895adbecSIan Kent 109895adbecSIan Kent static inline void kernfs_inc_rev(struct kernfs_node *parent) 110895adbecSIan Kent { 111895adbecSIan Kent parent->dir.rev++; 112895adbecSIan Kent } 113895adbecSIan Kent 114895adbecSIan Kent static inline bool kernfs_dir_changed(struct kernfs_node *parent, 115895adbecSIan Kent struct dentry *dentry) 116895adbecSIan Kent { 117895adbecSIan Kent if (parent->dir.rev != dentry->d_time) 118895adbecSIan Kent return true; 119895adbecSIan Kent return false; 120895adbecSIan Kent } 121895adbecSIan Kent 122f41c5934SLi Zefan extern const struct super_operations kernfs_sops; 12326e28d68SAyush Mittal extern struct kmem_cache *kernfs_node_cache, *kernfs_iattrs_cache; 124fa736a95STejun Heo 125fa736a95STejun Heo /* 126ffed24e2STejun Heo * inode.c 127ffed24e2STejun Heo */ 128e72a1a8bSAndreas Gruenbacher extern const struct xattr_handler *kernfs_xattr_handlers[]; 129c637b8acSTejun Heo void kernfs_evict_inode(struct inode *inode); 130*4609e1f1SChristian Brauner int kernfs_iop_permission(struct mnt_idmap *idmap, 131549c7297SChristian Brauner struct inode *inode, int mask); 132c1632a0fSChristian Brauner int kernfs_iop_setattr(struct mnt_idmap *idmap, struct dentry *dentry, 133549c7297SChristian Brauner struct iattr *iattr); 134b74d24f7SChristian Brauner int kernfs_iop_getattr(struct mnt_idmap *idmap, 135549c7297SChristian Brauner const struct path *path, struct kstat *stat, 136a528d35eSDavid Howells u32 request_mask, unsigned int query_flags); 137c637b8acSTejun Heo ssize_t kernfs_iop_listxattr(struct dentry *dentry, char *buf, size_t size); 138488dee96SDmitry Torokhov int __kernfs_setattr(struct kernfs_node *kn, const struct iattr *iattr); 139ffed24e2STejun Heo 140fd7b9f7bSTejun Heo /* 141fd7b9f7bSTejun Heo * dir.c 142fd7b9f7bSTejun Heo */ 143a797bfc3STejun Heo extern const struct dentry_operations kernfs_dops; 144a797bfc3STejun Heo extern const struct file_operations kernfs_dir_fops; 145a797bfc3STejun Heo extern const struct inode_operations kernfs_dir_iops; 146fd7b9f7bSTejun Heo 147c637b8acSTejun Heo struct kernfs_node *kernfs_get_active(struct kernfs_node *kn); 148c637b8acSTejun Heo void kernfs_put_active(struct kernfs_node *kn); 149988cd7afSTejun Heo int kernfs_add_one(struct kernfs_node *kn); 150db4aad20STejun Heo struct kernfs_node *kernfs_new_node(struct kernfs_node *parent, 151db4aad20STejun Heo const char *name, umode_t mode, 152488dee96SDmitry Torokhov kuid_t uid, kgid_t gid, 153db4aad20STejun Heo unsigned flags); 154fd7b9f7bSTejun Heo 155414985aeSTejun Heo /* 156414985aeSTejun Heo * file.c 157414985aeSTejun Heo */ 158a797bfc3STejun Heo extern const struct file_operations kernfs_file_fops; 159414985aeSTejun Heo 160bdb2fd7fSTejun Heo bool kernfs_should_drain_open_files(struct kernfs_node *kn); 1610e67db2fSTejun Heo void kernfs_drain_open_files(struct kernfs_node *kn); 162414985aeSTejun Heo 1632072f1afSTejun Heo /* 1642072f1afSTejun Heo * symlink.c 1652072f1afSTejun Heo */ 166a797bfc3STejun Heo extern const struct inode_operations kernfs_symlink_iops; 1672072f1afSTejun Heo 1681d25b84eSImran Khan /* 1691d25b84eSImran Khan * kernfs locks 1701d25b84eSImran Khan */ 1711d25b84eSImran Khan extern struct kernfs_global_locks *kernfs_locks; 172ae6621b0STejun Heo #endif /* __KERNFS_INTERNAL_H */ 173