1 /* SPDX-License-Identifier: GPL-2.0-only */
4 * Copyright (C) 2011 Novell Inc.
7 #include <linux/kernel.h>
8 #include <linux/uuid.h>
10 #include <linux/namei.h>
11 #include <linux/posix_acl.h>
12 #include <linux/posix_acl_xattr.h>
13 #include "ovl_entry.h"
16 #define pr_fmt(fmt) "overlayfs: " fmt
19 __OVL_PATH_UPPER
= (1 << 0),
20 __OVL_PATH_MERGE
= (1 << 1),
21 __OVL_PATH_ORIGIN
= (1 << 2),
24 #define OVL_TYPE_UPPER(type) ((type) & __OVL_PATH_UPPER)
25 #define OVL_TYPE_MERGE(type) ((type) & __OVL_PATH_MERGE)
26 #define OVL_TYPE_ORIGIN(type) ((type) & __OVL_PATH_ORIGIN)
28 #define OVL_XATTR_NAMESPACE "overlay."
29 #define OVL_XATTR_TRUSTED_PREFIX XATTR_TRUSTED_PREFIX OVL_XATTR_NAMESPACE
30 #define OVL_XATTR_USER_PREFIX XATTR_USER_PREFIX OVL_XATTR_NAMESPACE
44 /* Pure upper dir that may contain non pure upper entries */
46 /* Non-merge dir that may contain whiteout entries */
50 /* Inode number will remain constant over copy up. */
61 OVL_REDIRECT_OFF
, /* "off" mode is never used. In effect */
62 OVL_REDIRECT_FOLLOW
, /* ...it translates to either "follow" */
63 OVL_REDIRECT_NOFOLLOW
, /* ...or "nofollow". */
73 /* The set of options that user requested explicitly via mount options */
82 * The tuple (fh,uuid) is a universal unique identifier for a copy up origin,
84 * origin.fh - exported file handle of the lower file
85 * origin.uuid - uuid of the lower filesystem
87 #define OVL_FH_VERSION 0
88 #define OVL_FH_MAGIC 0xfb
90 /* CPU byte order required for fid decoding: */
91 #define OVL_FH_FLAG_BIG_ENDIAN (1 << 0)
92 #define OVL_FH_FLAG_ANY_ENDIAN (1 << 1)
93 /* Is the real inode encoded in fid an upper inode? */
94 #define OVL_FH_FLAG_PATH_UPPER (1 << 2)
96 #define OVL_FH_FLAG_ALL (OVL_FH_FLAG_BIG_ENDIAN | OVL_FH_FLAG_ANY_ENDIAN | \
97 OVL_FH_FLAG_PATH_UPPER)
99 #if defined(__LITTLE_ENDIAN)
100 #define OVL_FH_FLAG_CPU_ENDIAN 0
101 #elif defined(__BIG_ENDIAN)
102 #define OVL_FH_FLAG_CPU_ENDIAN OVL_FH_FLAG_BIG_ENDIAN
104 #error Endianness not defined
107 /* The type used to be returned by overlay exportfs for misaligned fid */
108 #define OVL_FILEID_V0 0xfb
109 /* The type returned by overlay exportfs for 32bit aligned fid */
110 #define OVL_FILEID_V1 0xf8
112 /* On-disk format for "origin" file handle */
116 u8 len
; /* size of this header + size of fid */
117 u8 flags
; /* OVL_FH_FLAG_* */
118 u8 type
; /* fid_type of fid */
119 uuid_t uuid
; /* uuid of filesystem */
120 u32 fid
[]; /* file identifier should be 32bit aligned in-memory */
123 /* In-memory and on-wire format for overlay file handle */
125 u8 padding
[3]; /* make sure fb.fid is 32bit aligned */
128 DECLARE_FLEX_ARRAY(u8
, buf
);
132 #define OVL_FH_WIRE_OFFSET offsetof(struct ovl_fh, fb)
133 #define OVL_FH_LEN(fh) (OVL_FH_WIRE_OFFSET + (fh)->fb.len)
134 #define OVL_FH_FID_OFFSET (OVL_FH_WIRE_OFFSET + \
135 offsetof(struct ovl_fb, fid))
137 extern const char *const ovl_xattr_table
[][2];
138 static inline const char *ovl_xattr(struct ovl_fs
*ofs
, enum ovl_xattr ox
)
140 return ovl_xattr_table
[ox
][ofs
->config
.userxattr
];
144 * When changing ownership of an upper object map the intended ownership
145 * according to the upper layer's idmapping. When an upper mount idmaps files
146 * that are stored on-disk as owned by id 1001 to id 1000 this means stat on
147 * this object will report it as being owned by id 1000 when calling stat via
149 * In order to change ownership of an object so stat reports id 1000 when
150 * called on an idmapped upper mount the value written to disk - i.e., the
151 * value stored in ia_*id - must 1001. The mount mapping helper will thus take
152 * care to map 1000 to 1001.
153 * The mnt idmapping helpers are nops if the upper layer isn't idmapped.
155 static inline int ovl_do_notify_change(struct ovl_fs
*ofs
,
156 struct dentry
*upperdentry
,
159 return notify_change(ovl_upper_mnt_idmap(ofs
), upperdentry
, attr
, NULL
);
162 static inline int ovl_do_rmdir(struct ovl_fs
*ofs
,
163 struct inode
*dir
, struct dentry
*dentry
)
165 int err
= vfs_rmdir(ovl_upper_mnt_idmap(ofs
), dir
, dentry
);
167 pr_debug("rmdir(%pd2) = %i\n", dentry
, err
);
171 static inline int ovl_do_unlink(struct ovl_fs
*ofs
, struct inode
*dir
,
172 struct dentry
*dentry
)
174 int err
= vfs_unlink(ovl_upper_mnt_idmap(ofs
), dir
, dentry
, NULL
);
176 pr_debug("unlink(%pd2) = %i\n", dentry
, err
);
180 static inline int ovl_do_link(struct ovl_fs
*ofs
, struct dentry
*old_dentry
,
181 struct inode
*dir
, struct dentry
*new_dentry
)
183 int err
= vfs_link(old_dentry
, ovl_upper_mnt_idmap(ofs
), dir
,
186 pr_debug("link(%pd2, %pd2) = %i\n", old_dentry
, new_dentry
, err
);
190 static inline int ovl_do_create(struct ovl_fs
*ofs
,
191 struct inode
*dir
, struct dentry
*dentry
,
194 int err
= vfs_create(ovl_upper_mnt_idmap(ofs
), dir
, dentry
, mode
, true);
196 pr_debug("create(%pd2, 0%o) = %i\n", dentry
, mode
, err
);
200 static inline int ovl_do_mkdir(struct ovl_fs
*ofs
,
201 struct inode
*dir
, struct dentry
*dentry
,
204 int err
= vfs_mkdir(ovl_upper_mnt_idmap(ofs
), dir
, dentry
, mode
);
205 pr_debug("mkdir(%pd2, 0%o) = %i\n", dentry
, mode
, err
);
209 static inline int ovl_do_mknod(struct ovl_fs
*ofs
,
210 struct inode
*dir
, struct dentry
*dentry
,
211 umode_t mode
, dev_t dev
)
213 int err
= vfs_mknod(ovl_upper_mnt_idmap(ofs
), dir
, dentry
, mode
, dev
);
215 pr_debug("mknod(%pd2, 0%o, 0%o) = %i\n", dentry
, mode
, dev
, err
);
219 static inline int ovl_do_symlink(struct ovl_fs
*ofs
,
220 struct inode
*dir
, struct dentry
*dentry
,
223 int err
= vfs_symlink(ovl_upper_mnt_idmap(ofs
), dir
, dentry
, oldname
);
225 pr_debug("symlink(\"%s\", %pd2) = %i\n", oldname
, dentry
, err
);
229 static inline ssize_t
ovl_do_getxattr(const struct path
*path
, const char *name
,
230 void *value
, size_t size
)
234 WARN_ON(path
->dentry
->d_sb
!= path
->mnt
->mnt_sb
);
236 err
= vfs_getxattr(mnt_idmap(path
->mnt
), path
->dentry
,
238 len
= (value
&& err
> 0) ? err
: 0;
240 pr_debug("getxattr(%pd2, \"%s\", \"%*pE\", %zu, 0) = %i\n",
241 path
->dentry
, name
, min(len
, 48), value
, size
, err
);
245 static inline ssize_t
ovl_getxattr_upper(struct ovl_fs
*ofs
,
246 struct dentry
*upperdentry
,
247 enum ovl_xattr ox
, void *value
,
250 struct path upperpath
= {
251 .dentry
= upperdentry
,
252 .mnt
= ovl_upper_mnt(ofs
),
255 return ovl_do_getxattr(&upperpath
, ovl_xattr(ofs
, ox
), value
, size
);
258 static inline ssize_t
ovl_path_getxattr(struct ovl_fs
*ofs
,
259 const struct path
*path
,
260 enum ovl_xattr ox
, void *value
,
263 return ovl_do_getxattr(path
, ovl_xattr(ofs
, ox
), value
, size
);
266 static inline int ovl_do_setxattr(struct ovl_fs
*ofs
, struct dentry
*dentry
,
267 const char *name
, const void *value
,
268 size_t size
, int flags
)
270 int err
= vfs_setxattr(ovl_upper_mnt_idmap(ofs
), dentry
, name
,
273 pr_debug("setxattr(%pd2, \"%s\", \"%*pE\", %zu, %d) = %i\n",
274 dentry
, name
, min((int)size
, 48), value
, size
, flags
, err
);
278 static inline int ovl_setxattr(struct ovl_fs
*ofs
, struct dentry
*dentry
,
279 enum ovl_xattr ox
, const void *value
,
282 return ovl_do_setxattr(ofs
, dentry
, ovl_xattr(ofs
, ox
), value
, size
, 0);
285 static inline int ovl_do_removexattr(struct ovl_fs
*ofs
, struct dentry
*dentry
,
288 int err
= vfs_removexattr(ovl_upper_mnt_idmap(ofs
), dentry
, name
);
289 pr_debug("removexattr(%pd2, \"%s\") = %i\n", dentry
, name
, err
);
293 static inline int ovl_removexattr(struct ovl_fs
*ofs
, struct dentry
*dentry
,
296 return ovl_do_removexattr(ofs
, dentry
, ovl_xattr(ofs
, ox
));
299 static inline int ovl_do_set_acl(struct ovl_fs
*ofs
, struct dentry
*dentry
,
300 const char *acl_name
, struct posix_acl
*acl
)
302 return vfs_set_acl(ovl_upper_mnt_idmap(ofs
), dentry
, acl_name
, acl
);
305 static inline int ovl_do_remove_acl(struct ovl_fs
*ofs
, struct dentry
*dentry
,
306 const char *acl_name
)
308 return vfs_remove_acl(ovl_upper_mnt_idmap(ofs
), dentry
, acl_name
);
311 static inline int ovl_do_rename(struct ovl_fs
*ofs
, struct inode
*olddir
,
312 struct dentry
*olddentry
, struct inode
*newdir
,
313 struct dentry
*newdentry
, unsigned int flags
)
316 struct renamedata rd
= {
317 .old_mnt_idmap
= ovl_upper_mnt_idmap(ofs
),
319 .old_dentry
= olddentry
,
320 .new_mnt_idmap
= ovl_upper_mnt_idmap(ofs
),
322 .new_dentry
= newdentry
,
326 pr_debug("rename(%pd2, %pd2, 0x%x)\n", olddentry
, newdentry
, flags
);
327 err
= vfs_rename(&rd
);
329 pr_debug("...rename(%pd2, %pd2, ...) = %i\n",
330 olddentry
, newdentry
, err
);
335 static inline int ovl_do_whiteout(struct ovl_fs
*ofs
,
336 struct inode
*dir
, struct dentry
*dentry
)
338 int err
= vfs_whiteout(ovl_upper_mnt_idmap(ofs
), dir
, dentry
);
339 pr_debug("whiteout(%pd2) = %i\n", dentry
, err
);
343 static inline struct file
*ovl_do_tmpfile(struct ovl_fs
*ofs
,
344 struct dentry
*dentry
, umode_t mode
)
346 struct path path
= { .mnt
= ovl_upper_mnt(ofs
), .dentry
= dentry
};
347 struct file
*file
= vfs_tmpfile_open(ovl_upper_mnt_idmap(ofs
), &path
, mode
,
348 O_LARGEFILE
| O_WRONLY
, current_cred());
349 int err
= PTR_ERR_OR_ZERO(file
);
351 pr_debug("tmpfile(%pd2, 0%o) = %i\n", dentry
, mode
, err
);
355 static inline struct dentry
*ovl_lookup_upper(struct ovl_fs
*ofs
,
357 struct dentry
*base
, int len
)
359 return lookup_one(ovl_upper_mnt_idmap(ofs
), name
, base
, len
);
362 static inline bool ovl_open_flags_need_copy_up(int flags
)
367 return ((OPEN_FMODE(flags
) & FMODE_WRITE
) || (flags
& O_TRUNC
));
372 #define OVL_MAX_STACK 500
374 struct ovl_fs_context_layer
{
379 struct ovl_fs_context
{
383 size_t nr
; /* includes nr_data */
385 struct ovl_opt_set set
;
386 struct ovl_fs_context_layer
*lower
;
389 int ovl_parse_param_upperdir(const char *name
, struct fs_context
*fc
,
391 int ovl_parse_param_lowerdir(const char *name
, struct fs_context
*fc
);
392 void ovl_parse_param_drop_lowerdir(struct ovl_fs_context
*ctx
);
395 int ovl_want_write(struct dentry
*dentry
);
396 void ovl_drop_write(struct dentry
*dentry
);
397 struct dentry
*ovl_workdir(struct dentry
*dentry
);
398 const struct cred
*ovl_override_creds(struct super_block
*sb
);
399 int ovl_can_decode_fh(struct super_block
*sb
);
400 struct dentry
*ovl_indexdir(struct super_block
*sb
);
401 bool ovl_index_all(struct super_block
*sb
);
402 bool ovl_verify_lower(struct super_block
*sb
);
403 struct ovl_path
*ovl_stack_alloc(unsigned int n
);
404 void ovl_stack_cpy(struct ovl_path
*dst
, struct ovl_path
*src
, unsigned int n
);
405 void ovl_stack_put(struct ovl_path
*stack
, unsigned int n
);
406 void ovl_stack_free(struct ovl_path
*stack
, unsigned int n
);
407 struct ovl_entry
*ovl_alloc_entry(unsigned int numlower
);
408 void ovl_free_entry(struct ovl_entry
*oe
);
409 bool ovl_dentry_remote(struct dentry
*dentry
);
410 void ovl_dentry_update_reval(struct dentry
*dentry
, struct dentry
*realdentry
);
411 void ovl_dentry_init_reval(struct dentry
*dentry
, struct dentry
*upperdentry
,
412 struct ovl_entry
*oe
);
413 void ovl_dentry_init_flags(struct dentry
*dentry
, struct dentry
*upperdentry
,
414 struct ovl_entry
*oe
, unsigned int mask
);
415 bool ovl_dentry_weird(struct dentry
*dentry
);
416 enum ovl_path_type
ovl_path_type(struct dentry
*dentry
);
417 void ovl_path_upper(struct dentry
*dentry
, struct path
*path
);
418 void ovl_path_lower(struct dentry
*dentry
, struct path
*path
);
419 void ovl_path_lowerdata(struct dentry
*dentry
, struct path
*path
);
420 struct inode
*ovl_i_path_real(struct inode
*inode
, struct path
*path
);
421 enum ovl_path_type
ovl_path_real(struct dentry
*dentry
, struct path
*path
);
422 enum ovl_path_type
ovl_path_realdata(struct dentry
*dentry
, struct path
*path
);
423 struct dentry
*ovl_dentry_upper(struct dentry
*dentry
);
424 struct dentry
*ovl_dentry_lower(struct dentry
*dentry
);
425 struct dentry
*ovl_dentry_lowerdata(struct dentry
*dentry
);
426 int ovl_dentry_set_lowerdata(struct dentry
*dentry
, struct ovl_path
*datapath
);
427 const struct ovl_layer
*ovl_i_layer_lower(struct inode
*inode
);
428 const struct ovl_layer
*ovl_layer_lower(struct dentry
*dentry
);
429 struct dentry
*ovl_dentry_real(struct dentry
*dentry
);
430 struct dentry
*ovl_i_dentry_upper(struct inode
*inode
);
431 struct inode
*ovl_inode_upper(struct inode
*inode
);
432 struct inode
*ovl_inode_lower(struct inode
*inode
);
433 struct inode
*ovl_inode_lowerdata(struct inode
*inode
);
434 struct inode
*ovl_inode_real(struct inode
*inode
);
435 struct inode
*ovl_inode_realdata(struct inode
*inode
);
436 const char *ovl_lowerdata_redirect(struct inode
*inode
);
437 struct ovl_dir_cache
*ovl_dir_cache(struct inode
*inode
);
438 void ovl_set_dir_cache(struct inode
*inode
, struct ovl_dir_cache
*cache
);
439 void ovl_dentry_set_flag(unsigned long flag
, struct dentry
*dentry
);
440 void ovl_dentry_clear_flag(unsigned long flag
, struct dentry
*dentry
);
441 bool ovl_dentry_test_flag(unsigned long flag
, struct dentry
*dentry
);
442 bool ovl_dentry_is_opaque(struct dentry
*dentry
);
443 bool ovl_dentry_is_whiteout(struct dentry
*dentry
);
444 void ovl_dentry_set_opaque(struct dentry
*dentry
);
445 bool ovl_dentry_has_upper_alias(struct dentry
*dentry
);
446 void ovl_dentry_set_upper_alias(struct dentry
*dentry
);
447 bool ovl_dentry_needs_data_copy_up(struct dentry
*dentry
, int flags
);
448 bool ovl_dentry_needs_data_copy_up_locked(struct dentry
*dentry
, int flags
);
449 bool ovl_has_upperdata(struct inode
*inode
);
450 void ovl_set_upperdata(struct inode
*inode
);
451 const char *ovl_dentry_get_redirect(struct dentry
*dentry
);
452 void ovl_dentry_set_redirect(struct dentry
*dentry
, const char *redirect
);
453 void ovl_inode_update(struct inode
*inode
, struct dentry
*upperdentry
);
454 void ovl_dir_modified(struct dentry
*dentry
, bool impurity
);
455 u64
ovl_inode_version_get(struct inode
*inode
);
456 bool ovl_is_whiteout(struct dentry
*dentry
);
457 struct file
*ovl_path_open(const struct path
*path
, int flags
);
458 int ovl_copy_up_start(struct dentry
*dentry
, int flags
);
459 void ovl_copy_up_end(struct dentry
*dentry
);
460 bool ovl_already_copied_up(struct dentry
*dentry
, int flags
);
461 bool ovl_path_check_dir_xattr(struct ovl_fs
*ofs
, const struct path
*path
,
463 bool ovl_path_check_origin_xattr(struct ovl_fs
*ofs
, const struct path
*path
);
465 static inline bool ovl_check_origin_xattr(struct ovl_fs
*ofs
,
466 struct dentry
*upperdentry
)
468 struct path upperpath
= {
469 .dentry
= upperdentry
,
470 .mnt
= ovl_upper_mnt(ofs
),
472 return ovl_path_check_origin_xattr(ofs
, &upperpath
);
475 int ovl_check_setxattr(struct ovl_fs
*ofs
, struct dentry
*upperdentry
,
476 enum ovl_xattr ox
, const void *value
, size_t size
,
478 int ovl_set_impure(struct dentry
*dentry
, struct dentry
*upperdentry
);
479 bool ovl_inuse_trylock(struct dentry
*dentry
);
480 void ovl_inuse_unlock(struct dentry
*dentry
);
481 bool ovl_is_inuse(struct dentry
*dentry
);
482 bool ovl_need_index(struct dentry
*dentry
);
483 int ovl_nlink_start(struct dentry
*dentry
);
484 void ovl_nlink_end(struct dentry
*dentry
);
485 int ovl_lock_rename_workdir(struct dentry
*workdir
, struct dentry
*upperdir
);
486 int ovl_check_metacopy_xattr(struct ovl_fs
*ofs
, const struct path
*path
);
487 bool ovl_is_metacopy_dentry(struct dentry
*dentry
);
488 char *ovl_get_redirect_xattr(struct ovl_fs
*ofs
, const struct path
*path
, int padding
);
489 int ovl_sync_status(struct ovl_fs
*ofs
);
491 static inline void ovl_set_flag(unsigned long flag
, struct inode
*inode
)
493 set_bit(flag
, &OVL_I(inode
)->flags
);
496 static inline void ovl_clear_flag(unsigned long flag
, struct inode
*inode
)
498 clear_bit(flag
, &OVL_I(inode
)->flags
);
501 static inline bool ovl_test_flag(unsigned long flag
, struct inode
*inode
)
503 return test_bit(flag
, &OVL_I(inode
)->flags
);
506 static inline bool ovl_is_impuredir(struct super_block
*sb
,
507 struct dentry
*upperdentry
)
509 struct ovl_fs
*ofs
= OVL_FS(sb
);
510 struct path upperpath
= {
511 .dentry
= upperdentry
,
512 .mnt
= ovl_upper_mnt(ofs
),
515 return ovl_path_check_dir_xattr(ofs
, &upperpath
, OVL_XATTR_IMPURE
);
518 static inline bool ovl_redirect_follow(struct ovl_fs
*ofs
)
520 return ofs
->config
.redirect_mode
!= OVL_REDIRECT_NOFOLLOW
;
523 static inline bool ovl_redirect_dir(struct ovl_fs
*ofs
)
525 return ofs
->config
.redirect_mode
== OVL_REDIRECT_ON
;
529 * With xino=auto, we do best effort to keep all inodes on same st_dev and
530 * d_ino consistent with st_ino.
531 * With xino=on, we do the same effort but we warn if we failed.
533 static inline bool ovl_xino_warn(struct ovl_fs
*ofs
)
535 return ofs
->config
.xino
== OVL_XINO_ON
;
539 * To avoid regressions in existing setups with overlay lower offline changes,
540 * we allow lower changes only if none of the new features are used.
542 static inline bool ovl_allow_offline_changes(struct ovl_fs
*ofs
)
544 return (!ofs
->config
.index
&& !ofs
->config
.metacopy
&&
545 !ovl_redirect_dir(ofs
) && !ovl_xino_warn(ofs
));
548 /* All layers on same fs? */
549 static inline bool ovl_same_fs(struct ovl_fs
*ofs
)
551 return ofs
->xino_mode
== 0;
554 /* All overlay inodes have same st_dev? */
555 static inline bool ovl_same_dev(struct ovl_fs
*ofs
)
557 return ofs
->xino_mode
>= 0;
560 static inline unsigned int ovl_xino_bits(struct ovl_fs
*ofs
)
562 return ovl_same_dev(ofs
) ? ofs
->xino_mode
: 0;
565 static inline void ovl_inode_lock(struct inode
*inode
)
567 mutex_lock(&OVL_I(inode
)->lock
);
570 static inline int ovl_inode_lock_interruptible(struct inode
*inode
)
572 return mutex_lock_interruptible(&OVL_I(inode
)->lock
);
575 static inline void ovl_inode_unlock(struct inode
*inode
)
577 mutex_unlock(&OVL_I(inode
)->lock
);
582 int ovl_check_fb_len(struct ovl_fb
*fb
, int fb_len
);
584 static inline int ovl_check_fh_len(struct ovl_fh
*fh
, int fh_len
)
586 if (fh_len
< sizeof(struct ovl_fh
))
589 return ovl_check_fb_len(&fh
->fb
, fh_len
- OVL_FH_WIRE_OFFSET
);
592 struct dentry
*ovl_decode_real_fh(struct ovl_fs
*ofs
, struct ovl_fh
*fh
,
593 struct vfsmount
*mnt
, bool connected
);
594 int ovl_check_origin_fh(struct ovl_fs
*ofs
, struct ovl_fh
*fh
, bool connected
,
595 struct dentry
*upperdentry
, struct ovl_path
**stackp
);
596 int ovl_verify_set_fh(struct ovl_fs
*ofs
, struct dentry
*dentry
,
597 enum ovl_xattr ox
, struct dentry
*real
, bool is_upper
,
599 struct dentry
*ovl_index_upper(struct ovl_fs
*ofs
, struct dentry
*index
,
601 int ovl_verify_index(struct ovl_fs
*ofs
, struct dentry
*index
);
602 int ovl_get_index_name(struct ovl_fs
*ofs
, struct dentry
*origin
,
604 struct dentry
*ovl_get_index_fh(struct ovl_fs
*ofs
, struct ovl_fh
*fh
);
605 struct dentry
*ovl_lookup_index(struct ovl_fs
*ofs
, struct dentry
*upper
,
606 struct dentry
*origin
, bool verify
);
607 int ovl_path_next(int idx
, struct dentry
*dentry
, struct path
*path
);
608 int ovl_maybe_lookup_lowerdata(struct dentry
*dentry
);
609 struct dentry
*ovl_lookup(struct inode
*dir
, struct dentry
*dentry
,
611 bool ovl_lower_positive(struct dentry
*dentry
);
613 static inline int ovl_verify_origin(struct ovl_fs
*ofs
, struct dentry
*upper
,
614 struct dentry
*origin
, bool set
)
616 return ovl_verify_set_fh(ofs
, upper
, OVL_XATTR_ORIGIN
, origin
,
620 static inline int ovl_verify_upper(struct ovl_fs
*ofs
, struct dentry
*index
,
621 struct dentry
*upper
, bool set
)
623 return ovl_verify_set_fh(ofs
, index
, OVL_XATTR_UPPER
, upper
, true, set
);
627 extern const struct file_operations ovl_dir_operations
;
628 struct file
*ovl_dir_real_file(const struct file
*file
, bool want_upper
);
629 int ovl_check_empty_dir(struct dentry
*dentry
, struct list_head
*list
);
630 void ovl_cleanup_whiteouts(struct ovl_fs
*ofs
, struct dentry
*upper
,
631 struct list_head
*list
);
632 void ovl_cache_free(struct list_head
*list
);
633 void ovl_dir_cache_free(struct inode
*inode
);
634 int ovl_check_d_type_supported(const struct path
*realpath
);
635 int ovl_workdir_cleanup(struct ovl_fs
*ofs
, struct inode
*dir
,
636 struct vfsmount
*mnt
, struct dentry
*dentry
, int level
);
637 int ovl_indexdir_cleanup(struct ovl_fs
*ofs
);
640 * Can we iterate real dir directly?
642 * Non-merge dir may contain whiteouts from a time it was a merge upper, before
643 * lower dir was removed under it and possibly before it was rotated from upper
646 static inline bool ovl_dir_is_real(struct inode
*dir
)
648 return !ovl_test_flag(OVL_WHITEOUTS
, dir
);
652 int ovl_set_nlink_upper(struct dentry
*dentry
);
653 int ovl_set_nlink_lower(struct dentry
*dentry
);
654 unsigned int ovl_get_nlink(struct ovl_fs
*ofs
, struct dentry
*lowerdentry
,
655 struct dentry
*upperdentry
,
656 unsigned int fallback
);
657 int ovl_setattr(struct mnt_idmap
*idmap
, struct dentry
*dentry
,
659 int ovl_getattr(struct mnt_idmap
*idmap
, const struct path
*path
,
660 struct kstat
*stat
, u32 request_mask
, unsigned int flags
);
661 int ovl_permission(struct mnt_idmap
*idmap
, struct inode
*inode
,
663 int ovl_xattr_set(struct dentry
*dentry
, struct inode
*inode
, const char *name
,
664 const void *value
, size_t size
, int flags
);
665 int ovl_xattr_get(struct dentry
*dentry
, struct inode
*inode
, const char *name
,
666 void *value
, size_t size
);
667 ssize_t
ovl_listxattr(struct dentry
*dentry
, char *list
, size_t size
);
669 #ifdef CONFIG_FS_POSIX_ACL
670 struct posix_acl
*do_ovl_get_acl(struct mnt_idmap
*idmap
,
671 struct inode
*inode
, int type
,
672 bool rcu
, bool noperm
);
673 static inline struct posix_acl
*ovl_get_inode_acl(struct inode
*inode
, int type
,
676 return do_ovl_get_acl(&nop_mnt_idmap
, inode
, type
, rcu
, true);
678 static inline struct posix_acl
*ovl_get_acl(struct mnt_idmap
*idmap
,
679 struct dentry
*dentry
, int type
)
681 return do_ovl_get_acl(idmap
, d_inode(dentry
), type
, false, false);
683 int ovl_set_acl(struct mnt_idmap
*idmap
, struct dentry
*dentry
,
684 struct posix_acl
*acl
, int type
);
685 struct posix_acl
*ovl_get_acl_path(const struct path
*path
,
686 const char *acl_name
, bool noperm
);
688 #define ovl_get_inode_acl NULL
689 #define ovl_get_acl NULL
690 #define ovl_set_acl NULL
691 static inline struct posix_acl
*ovl_get_acl_path(const struct path
*path
,
692 const char *acl_name
,
699 int ovl_update_time(struct inode
*inode
, struct timespec64
*ts
, int flags
);
700 bool ovl_is_private_xattr(struct super_block
*sb
, const char *name
);
702 struct ovl_inode_params
{
703 struct inode
*newinode
;
704 struct dentry
*upperdentry
;
705 struct ovl_entry
*oe
;
708 char *lowerdata_redirect
;
710 void ovl_inode_init(struct inode
*inode
, struct ovl_inode_params
*oip
,
711 unsigned long ino
, int fsid
);
712 struct inode
*ovl_new_inode(struct super_block
*sb
, umode_t mode
, dev_t rdev
);
713 struct inode
*ovl_lookup_inode(struct super_block
*sb
, struct dentry
*real
,
715 bool ovl_lookup_trap_inode(struct super_block
*sb
, struct dentry
*dir
);
716 struct inode
*ovl_get_trap_inode(struct super_block
*sb
, struct dentry
*dir
);
717 struct inode
*ovl_get_inode(struct super_block
*sb
,
718 struct ovl_inode_params
*oip
);
719 void ovl_copyattr(struct inode
*to
);
721 /* vfs inode flags copied from real to ovl inode */
722 #define OVL_COPY_I_FLAGS_MASK (S_SYNC | S_NOATIME | S_APPEND | S_IMMUTABLE)
723 /* vfs inode flags read from overlay.protattr xattr to ovl inode */
724 #define OVL_PROT_I_FLAGS_MASK (S_APPEND | S_IMMUTABLE)
727 * fileattr flags copied from lower to upper inode on copy up.
728 * We cannot copy up immutable/append-only flags, because that would prevent
729 * linking temp inode to upper dir, so we store them in xattr instead.
731 #define OVL_COPY_FS_FLAGS_MASK (FS_SYNC_FL | FS_NOATIME_FL)
732 #define OVL_COPY_FSX_FLAGS_MASK (FS_XFLAG_SYNC | FS_XFLAG_NOATIME)
733 #define OVL_PROT_FS_FLAGS_MASK (FS_APPEND_FL | FS_IMMUTABLE_FL)
734 #define OVL_PROT_FSX_FLAGS_MASK (FS_XFLAG_APPEND | FS_XFLAG_IMMUTABLE)
736 void ovl_check_protattr(struct inode
*inode
, struct dentry
*upper
);
737 int ovl_set_protattr(struct inode
*inode
, struct dentry
*upper
,
738 struct fileattr
*fa
);
740 static inline void ovl_copyflags(struct inode
*from
, struct inode
*to
)
742 unsigned int mask
= OVL_COPY_I_FLAGS_MASK
;
744 inode_set_flags(to
, from
->i_flags
& mask
, mask
);
748 extern const struct inode_operations ovl_dir_inode_operations
;
749 int ovl_cleanup_and_whiteout(struct ovl_fs
*ofs
, struct inode
*dir
,
750 struct dentry
*dentry
);
755 struct dentry
*hardlink
;
758 #define OVL_CATTR(m) (&(struct ovl_cattr) { .mode = (m) })
760 int ovl_mkdir_real(struct ovl_fs
*ofs
, struct inode
*dir
,
761 struct dentry
**newdentry
, umode_t mode
);
762 struct dentry
*ovl_create_real(struct ovl_fs
*ofs
,
763 struct inode
*dir
, struct dentry
*newdentry
,
764 struct ovl_cattr
*attr
);
765 int ovl_cleanup(struct ovl_fs
*ofs
, struct inode
*dir
, struct dentry
*dentry
);
766 struct dentry
*ovl_lookup_temp(struct ovl_fs
*ofs
, struct dentry
*workdir
);
767 struct dentry
*ovl_create_temp(struct ovl_fs
*ofs
, struct dentry
*workdir
,
768 struct ovl_cattr
*attr
);
771 extern const struct file_operations ovl_file_operations
;
772 int __init
ovl_aio_request_cache_init(void);
773 void ovl_aio_request_cache_destroy(void);
774 int ovl_real_fileattr_get(const struct path
*realpath
, struct fileattr
*fa
);
775 int ovl_real_fileattr_set(const struct path
*realpath
, struct fileattr
*fa
);
776 int ovl_fileattr_get(struct dentry
*dentry
, struct fileattr
*fa
);
777 int ovl_fileattr_set(struct mnt_idmap
*idmap
,
778 struct dentry
*dentry
, struct fileattr
*fa
);
781 int ovl_copy_up(struct dentry
*dentry
);
782 int ovl_copy_up_with_data(struct dentry
*dentry
);
783 int ovl_maybe_copy_up(struct dentry
*dentry
, int flags
);
784 int ovl_copy_xattr(struct super_block
*sb
, const struct path
*path
, struct dentry
*new);
785 int ovl_set_attr(struct ovl_fs
*ofs
, struct dentry
*upper
, struct kstat
*stat
);
786 struct ovl_fh
*ovl_encode_real_fh(struct ovl_fs
*ofs
, struct dentry
*real
,
788 int ovl_set_origin(struct ovl_fs
*ofs
, struct dentry
*lower
,
789 struct dentry
*upper
);
792 extern const struct export_operations ovl_export_operations
;