twx-linux/Documentation/filesystems
Sheng Yong c36ec00d7f erofs: add 'fsoffset' mount option to specify filesystem offset
When attempting to use an archive file, such as APEX on android,
as a file-backed mount source, it fails because EROFS image within
the archive file does not start at offset 0. As a result, a loop
or a dm device is still needed to attach the image file at an
appropriate offset first. Similarly, if an EROFS image within a
block device does not start at offset 0, it cannot be mounted
directly either.

To address this issue, this patch adds a new mount option `fsoffset=x'
to accept a start offset for the primary device. The offset should be
aligned to the block size. EROFS will add this offset before performing
read requests.

Signed-off-by: Sheng Yong <shengyong1@xiaomi.com>
Signed-off-by: Wang Shuai <wangshuai12@xiaomi.com>
Reviewed-by: Gao Xiang <hsiangkao@linux.alibaba.com>
Link: https://lore.kernel.org/r/20250517090544.2687651-1-shengyong1@xiaomi.com
[ Gao Xiang: minor update on documentation and the error message. ]
Reviewed-by: Hongbo Li <lihongbo22@huawei.com>
Signed-off-by: Gao Xiang <hsiangkao@linux.alibaba.com>
2025-05-22 11:57:57 +08:00
..
bcachefs bcachefs updates for 6.15 2025-03-27 13:20:07 -07:00
caching doc: correcting the debug path for cachefiles 2024-10-24 13:50:27 +02:00
ext4 Documentation: ext4: Add fields to ext4_super_block documentation 2025-04-12 21:50:41 -04:00
iomap iomap: rework IOMAP atomic flags 2025-03-20 15:16:03 +01:00
nfs nfsd: disallow file locking and delegations for NFSv4 reexport 2025-03-10 09:11:08 -04:00
smb ksmbd: fix spelling mistakes in documentation 2024-08-18 17:02:36 -05:00
spufs
xfs Documentation: Remove repeated word in docs 2025-02-10 10:54:50 -07:00
9p.rst 9p update for 6.15-rc1 2025-04-03 15:35:46 -07:00
adfs.rst
affs.rst
afs.rst
api-summary.rst doc: split buffer.rst out of api-summary.rst 2024-05-05 17:53:40 -07:00
autofs-mount-control.rst
autofs.rst Documentation: filesystems: update filename extensions 2024-11-22 10:31:04 -07:00
automount-support.rst
befs.rst
bfs.rst
btrfs.rst
buffer.rst doc: split buffer.rst out of api-summary.rst 2024-05-05 17:53:40 -07:00
ceph.rst doc: ceph: update userspace command to get CephFS metadata 2024-05-23 10:35:47 +02:00
coda.rst documentation/filesystems: fix spelling mistakes 2025-02-10 10:42:28 -07:00
configfs.rst
cramfs.rst
dax.rst dcssblk: mark DAX broken, remove FS_DAX_LIMITED support 2025-03-17 22:06:40 -07:00
debugfs.rst documentation/filesystems: fix spelling mistakes 2025-02-10 10:42:28 -07:00
devpts.rst
directory-locking.rst Docs: typos/spelling 2024-05-02 10:02:29 -06:00
dlmfs.rst Documentation: filesystems: update filename extensions 2024-11-22 10:31:04 -07:00
dnotify.rst
ecryptfs.rst
efivarfs.rst Documentation: Mark the 'efivars' sysfs interface as removed 2024-04-13 10:33:02 +02:00
erofs.rst erofs: add 'fsoffset' mount option to specify filesystem offset 2025-05-22 11:57:57 +08:00
ext2.rst
ext3.rst
f2fs.rst f2fs: introduce FAULT_INCONSISTENT_FOOTER 2025-03-11 03:25:53 +00:00
fiemap.rst fiemap: use kernel-doc includes in fiemap docbook 2024-12-22 11:29:50 +01:00
files.rst docs: filesystems: fix typo in docs 2024-02-09 10:37:20 +01:00
fscrypt.rst fscrypt: mention init_on_free instead of page poisoning 2025-03-04 13:02:45 -08:00
fsverity.rst Documentation: add a usecase for FS_IOC_READ_VERITY_METADATA 2025-02-17 11:03:29 -08:00
fuse-io-uring.rst fuse: Add fuse-io-uring design documentation 2025-01-24 11:53:56 +01:00
fuse-io.rst
fuse.rst
gfs2-glocks.rst gfs2: Get rid of demote_ok checks 2024-05-29 15:34:55 +02:00
gfs2-uevents.rst
gfs2.rst
hfs.rst
hfsplus.rst
hpfs.rst
idmappings.rst doc: correcting two prefix errors in idmappings.rst 2025-03-05 11:54:18 +01:00
index.rst sysv: Remove the filesystem 2025-02-21 10:32:47 +01:00
inotify.rst
isofs.rst
journalling.rst jbd2: remove unused transaction->t_private_list 2025-02-10 07:48:24 -05:00
locking.rst Change inode_operations.mkdir to return struct dentry * 2025-02-27 20:00:17 +01:00
locks.rst
mount_api.rst fs_parser: update mount_api doc to match function signature 2024-11-26 10:32:20 +01:00
multigrain-ts.rst Documentation: add a new file documenting multigrain timestamps 2024-10-10 10:20:52 +02:00
netfs_library.rst documentation/filesystems: fix spelling mistakes 2025-02-10 10:42:28 -07:00
nilfs2.rst
ntfs3.rst
ocfs2-online-filecheck.rst
ocfs2.rst
omfs.rst
orangefs.rst
overlayfs.rst ovl: allow to specify override credentials 2025-02-19 14:32:09 +01:00
path-lookup.rst Documentation: filesystems: update filename extensions 2024-11-22 10:31:04 -07:00
path-lookup.txt Documentation: filesystems: update filename extensions 2024-11-22 10:31:04 -07:00
porting.rst vfs-6.15-rc1.async.dir 2025-03-24 10:47:14 -07:00
proc.rst - The 7 patch series "powerpc/crash: use generic crashkernel 2025-04-01 10:06:52 -07:00
qnx6.rst
quota.rst
ramfs-rootfs-initramfs.rst Documentation: filesystems: update filename extensions 2024-11-22 10:31:04 -07:00
relay.rst
romfs.rst
seq_file.rst
sharedsubtree.rst
splice.rst
squashfs.rst Documentation: update the Squashfs filesystem documentation 2025-01-24 22:47:21 -08:00
sysfs.rst
tmpfs.rst docs: tmpfs: Add casefold options 2024-10-28 13:36:55 +01:00
ubifs-authentication.rst
ubifs.rst
udf.rst
vfat.rst
vfs.rst Change inode_operations.mkdir to return struct dentry * 2025-02-27 20:00:17 +01:00
virtiofs.rst
zonefs.rst