xref: /openbmc/linux/fs/overlayfs/ovl_entry.h (revision 657c45b3)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  *
4  * Copyright (C) 2011 Novell Inc.
5  * Copyright (C) 2016 Red Hat, Inc.
6  */
7 
8 struct ovl_config {
9 	char *upperdir;
10 	char *workdir;
11 	bool default_permissions;
12 	int redirect_mode;
13 	bool index;
14 	bool uuid;
15 	bool nfs_export;
16 	int xino;
17 	bool metacopy;
18 	bool userxattr;
19 	bool ovl_volatile;
20 };
21 
22 struct ovl_sb {
23 	struct super_block *sb;
24 	dev_t pseudo_dev;
25 	/* Unusable (conflicting) uuid */
26 	bool bad_uuid;
27 	/* Used as a lower layer (but maybe also as upper) */
28 	bool is_lower;
29 };
30 
31 struct ovl_layer {
32 	/* ovl_free_fs() relies on @mnt being the first member! */
33 	struct vfsmount *mnt;
34 	/* Trap in ovl inode cache */
35 	struct inode *trap;
36 	struct ovl_sb *fs;
37 	/* Index of this layer in fs root (upper idx == 0) */
38 	int idx;
39 	/* One fsid per unique underlying sb (upper fsid == 0) */
40 	int fsid;
41 	char *name;
42 };
43 
44 /*
45  * ovl_free_fs() relies on @mnt being the first member when unmounting
46  * the private mounts created for each layer. Let's check both the
47  * offset and type.
48  */
49 static_assert(offsetof(struct ovl_layer, mnt) == 0);
50 static_assert(__same_type(typeof_member(struct ovl_layer, mnt), struct vfsmount *));
51 
52 struct ovl_path {
53 	const struct ovl_layer *layer;
54 	struct dentry *dentry;
55 };
56 
57 struct ovl_entry {
58 	unsigned int __numlower;
59 	struct ovl_path __lowerstack[];
60 };
61 
62 /* private information held for overlayfs's superblock */
63 struct ovl_fs {
64 	unsigned int numlayer;
65 	/* Number of unique fs among layers including upper fs */
66 	unsigned int numfs;
67 	/* Number of data-only lower layers */
68 	unsigned int numdatalayer;
69 	const struct ovl_layer *layers;
70 	struct ovl_sb *fs;
71 	/* workbasedir is the path at workdir= mount option */
72 	struct dentry *workbasedir;
73 	/* workdir is the 'work' directory under workbasedir */
74 	struct dentry *workdir;
75 	/* index directory listing overlay inodes by origin file handle */
76 	struct dentry *indexdir;
77 	long namelen;
78 	/* pathnames of lower and upper dirs, for show_options */
79 	struct ovl_config config;
80 	/* creds of process who forced instantiation of super block */
81 	const struct cred *creator_cred;
82 	bool tmpfile;
83 	bool noxattr;
84 	/* Did we take the inuse lock? */
85 	bool upperdir_locked;
86 	bool workdir_locked;
87 	/* Traps in ovl inode cache */
88 	struct inode *workbasedir_trap;
89 	struct inode *workdir_trap;
90 	struct inode *indexdir_trap;
91 	/* -1: disabled, 0: same fs, 1..32: number of unused ino bits */
92 	int xino_mode;
93 	/* For allocation of non-persistent inode numbers */
94 	atomic_long_t last_ino;
95 	/* Shared whiteout cache */
96 	struct dentry *whiteout;
97 	bool no_shared_whiteout;
98 	/* r/o snapshot of upperdir sb's only taken on volatile mounts */
99 	errseq_t errseq;
100 };
101 
102 /* Number of lower layers, not including data-only layers */
103 static inline unsigned int ovl_numlowerlayer(struct ovl_fs *ofs)
104 {
105 	return ofs->numlayer - ofs->numdatalayer - 1;
106 }
107 
108 static inline struct vfsmount *ovl_upper_mnt(struct ovl_fs *ofs)
109 {
110 	return ofs->layers[0].mnt;
111 }
112 
113 static inline struct mnt_idmap *ovl_upper_mnt_idmap(struct ovl_fs *ofs)
114 {
115 	return mnt_idmap(ovl_upper_mnt(ofs));
116 }
117 
118 static inline struct ovl_fs *OVL_FS(struct super_block *sb)
119 {
120 	return (struct ovl_fs *)sb->s_fs_info;
121 }
122 
123 static inline bool ovl_should_sync(struct ovl_fs *ofs)
124 {
125 	return !ofs->config.ovl_volatile;
126 }
127 
128 static inline unsigned int ovl_numlower(struct ovl_entry *oe)
129 {
130 	return oe ? oe->__numlower : 0;
131 }
132 
133 static inline struct ovl_path *ovl_lowerstack(struct ovl_entry *oe)
134 {
135 	return ovl_numlower(oe) ? oe->__lowerstack : NULL;
136 }
137 
138 static inline struct ovl_path *ovl_lowerpath(struct ovl_entry *oe)
139 {
140 	return ovl_lowerstack(oe);
141 }
142 
143 static inline struct ovl_path *ovl_lowerdata(struct ovl_entry *oe)
144 {
145 	struct ovl_path *lowerstack = ovl_lowerstack(oe);
146 
147 	return lowerstack ? &lowerstack[oe->__numlower - 1] : NULL;
148 }
149 
150 /* May return NULL if lazy lookup of lowerdata is needed */
151 static inline struct dentry *ovl_lowerdata_dentry(struct ovl_entry *oe)
152 {
153 	struct ovl_path *lowerdata = ovl_lowerdata(oe);
154 
155 	return lowerdata ? READ_ONCE(lowerdata->dentry) : NULL;
156 }
157 
158 /* private information held for every overlayfs dentry */
159 static inline unsigned long *OVL_E_FLAGS(struct dentry *dentry)
160 {
161 	return (unsigned long *) &dentry->d_fsdata;
162 }
163 
164 struct ovl_inode {
165 	union {
166 		struct ovl_dir_cache *cache;	/* directory */
167 		const char *lowerdata_redirect;	/* regular file */
168 	};
169 	const char *redirect;
170 	u64 version;
171 	unsigned long flags;
172 	struct inode vfs_inode;
173 	struct dentry *__upperdentry;
174 	struct ovl_entry *oe;
175 
176 	/* synchronize copy up and more */
177 	struct mutex lock;
178 };
179 
180 static inline struct ovl_inode *OVL_I(struct inode *inode)
181 {
182 	return container_of(inode, struct ovl_inode, vfs_inode);
183 }
184 
185 static inline struct ovl_entry *OVL_I_E(struct inode *inode)
186 {
187 	return inode ? OVL_I(inode)->oe : NULL;
188 }
189 
190 static inline struct ovl_entry *OVL_E(struct dentry *dentry)
191 {
192 	return OVL_I_E(d_inode(dentry));
193 }
194 
195 static inline struct dentry *ovl_upperdentry_dereference(struct ovl_inode *oi)
196 {
197 	return READ_ONCE(oi->__upperdentry);
198 }
199