summaryrefslogtreecommitdiff
path: root/Documentation/filesystems/ext4/orphan.rst
diff options
context:
space:
mode:
authorJonathan Corbet <corbet@lwn.net>2021-09-02 16:08:53 -0600
committerJonathan Corbet <corbet@lwn.net>2021-10-07 08:46:02 -0600
commit91c76340b4a8213b48d72d42d32c5cae9f238e9a (patch)
tree6cbe4af8516246631c64f84cea436d79501e6f03 /Documentation/filesystems/ext4/orphan.rst
parentb19511926cb50d59c57189739d03c21df325710f (diff)
ext4: docs: switch away from list-table
Commit 3a6541e97c03 (Add documentation about the orphan file feature) added a new document on orphan files, which is great. But the use of "list-table" results in documents that are absolutely unreadable in their plain-text form. Switch this file to the regular RST table format instead; the rendered (HTML) output is identical. Reviewed-by: Jan Kara <jack@suse.cz> Link: https://lore.kernel.org/r/20210902220854.198850-2-corbet@lwn.net Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Diffstat (limited to 'Documentation/filesystems/ext4/orphan.rst')
-rw-r--r--Documentation/filesystems/ext4/orphan.rst32
1 files changed, 11 insertions, 21 deletions
diff --git a/Documentation/filesystems/ext4/orphan.rst b/Documentation/filesystems/ext4/orphan.rst
index bb19ecd1b626..d096fe0ba19e 100644
--- a/Documentation/filesystems/ext4/orphan.rst
+++ b/Documentation/filesystems/ext4/orphan.rst
@@ -21,27 +21,17 @@ in heavy creation of orphan inodes. When orphan file feature
(referenced from the superblock through s\_orphan_file_inum) with several
blocks. Each of these blocks has a structure:
-.. list-table::
- :widths: 8 8 24 40
- :header-rows: 1
-
- * - Offset
- - Type
- - Name
- - Description
- * - 0x0
- - Array of \_\_le32 entries
- - Orphan inode entries
- - Each \_\_le32 entry is either empty (0) or it contains inode number of
- an orphan inode.
- * - blocksize - 8
- - \_\_le32
- - ob\_magic
- - Magic value stored in orphan block tail (0x0b10ca04)
- * - blocksize - 4
- - \_\_le32
- - ob\_checksum
- - Checksum of the orphan block.
+============= ================ =============== ===============================
+Offset Type Name Description
+============= ================ =============== ===============================
+0x0 Array of Orphan inode Each \_\_le32 entry is either
+ \_\_le32 entries entries empty (0) or it contains
+ inode number of an orphan
+ inode.
+blocksize-8 \_\_le32 ob\_magic Magic value stored in orphan
+ block tail (0x0b10ca04)
+blocksize-4 \_\_le32 ob\_checksum Checksum of the orphan block.
+============= ================ =============== ===============================
When a filesystem with orphan file feature is writeably mounted, we set
RO\_COMPAT\_ORPHAN\_PRESENT feature in the superblock to indicate there may