Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
docs: f2fs: wrap ASCII tables in literal blocks to fix LaTeX build
Sphinx's LaTeX builder fails when converting the nested ASCII tables in
f2fs.rst, producing the following error:
"Markup is unsupported in LaTeX: longtable does not support nesting a table."
Wrap the affected ASCII tables in literal code blocks to force Sphinx to
render them verbatim. This prevents nested longtables and fixes the PDF
build failure on Sphinx 8.2.x.
Acked-by: Bagas Sanjaya <bagasdotme@gmail.com>
Reviewed-by: Akira Yokosawa <akiyks@gmail.com>
Signed-off-by: Masaharu Noguchi <nogunix@gmail.com>
Acked-by: Jonathan Corbet <corbet@lwn.net>
Reviewed-by: Chao Yu <chao@kernel.org>
Signed-off-by: Jaegeuk Kim <jaegeuk@kernel.org>
authored by
Masaharu Noguchi
and committed by
Jaegeuk Kim
fbc0774b
1627a303
+68
-61
+68
-61
Documentation/filesystems/f2fs.rst
+68
-61
Documentation/filesystems/f2fs.rst
···
188
188
enabled with fault_injection option, fault type value
189
189
is shown below, it supports single or combined type.
190
190
191
-
=========================== ==========
192
-
Type_Name Type_Value
193
-
=========================== ==========
194
-
FAULT_KMALLOC 0x00000001
195
-
FAULT_KVMALLOC 0x00000002
196
-
FAULT_PAGE_ALLOC 0x00000004
197
-
FAULT_PAGE_GET 0x00000008
198
-
FAULT_ALLOC_BIO 0x00000010 (obsolete)
199
-
FAULT_ALLOC_NID 0x00000020
200
-
FAULT_ORPHAN 0x00000040
201
-
FAULT_BLOCK 0x00000080
202
-
FAULT_DIR_DEPTH 0x00000100
203
-
FAULT_EVICT_INODE 0x00000200
204
-
FAULT_TRUNCATE 0x00000400
205
-
FAULT_READ_IO 0x00000800
206
-
FAULT_CHECKPOINT 0x00001000
207
-
FAULT_DISCARD 0x00002000
208
-
FAULT_WRITE_IO 0x00004000
209
-
FAULT_SLAB_ALLOC 0x00008000
210
-
FAULT_DQUOT_INIT 0x00010000
211
-
FAULT_LOCK_OP 0x00020000
212
-
FAULT_BLKADDR_VALIDITY 0x00040000
213
-
FAULT_BLKADDR_CONSISTENCE 0x00080000
214
-
FAULT_NO_SEGMENT 0x00100000
215
-
FAULT_INCONSISTENT_FOOTER 0x00200000
216
-
FAULT_TIMEOUT 0x00400000 (1000ms)
217
-
FAULT_VMALLOC 0x00800000
218
-
=========================== ==========
191
+
.. code-block:: none
192
+
193
+
=========================== ==========
194
+
Type_Name Type_Value
195
+
=========================== ==========
196
+
FAULT_KMALLOC 0x00000001
197
+
FAULT_KVMALLOC 0x00000002
198
+
FAULT_PAGE_ALLOC 0x00000004
199
+
FAULT_PAGE_GET 0x00000008
200
+
FAULT_ALLOC_BIO 0x00000010 (obsolete)
201
+
FAULT_ALLOC_NID 0x00000020
202
+
FAULT_ORPHAN 0x00000040
203
+
FAULT_BLOCK 0x00000080
204
+
FAULT_DIR_DEPTH 0x00000100
205
+
FAULT_EVICT_INODE 0x00000200
206
+
FAULT_TRUNCATE 0x00000400
207
+
FAULT_READ_IO 0x00000800
208
+
FAULT_CHECKPOINT 0x00001000
209
+
FAULT_DISCARD 0x00002000
210
+
FAULT_WRITE_IO 0x00004000
211
+
FAULT_SLAB_ALLOC 0x00008000
212
+
FAULT_DQUOT_INIT 0x00010000
213
+
FAULT_LOCK_OP 0x00020000
214
+
FAULT_BLKADDR_VALIDITY 0x00040000
215
+
FAULT_BLKADDR_CONSISTENCE 0x00080000
216
+
FAULT_NO_SEGMENT 0x00100000
217
+
FAULT_INCONSISTENT_FOOTER 0x00200000
218
+
FAULT_TIMEOUT 0x00400000 (1000ms)
219
+
FAULT_VMALLOC 0x00800000
220
+
=========================== ==========
219
221
mode=%s Control block allocation mode which supports "adaptive"
220
222
and "lfs". In "lfs" mode, there should be no random
221
223
writes towards main area.
···
298
296
compress_algorithm=%s Control compress algorithm, currently f2fs supports "lzo",
299
297
"lz4", "zstd" and "lzo-rle" algorithm.
300
298
compress_algorithm=%s:%d Control compress algorithm and its compress level, now, only
301
-
"lz4" and "zstd" support compress level config.
299
+
"lz4" and "zstd" support compress level config::
302
300
303
-
========= ===========
304
-
algorithm level range
305
-
========= ===========
306
-
lz4 3 - 16
307
-
zstd 1 - 22
308
-
========= ===========
301
+
========= ===========
302
+
algorithm level range
303
+
========= ===========
304
+
lz4 3 - 16
305
+
zstd 1 - 22
306
+
========= ===========
307
+
309
308
compress_log_size=%u Support configuring compress cluster size. The size will
310
309
be 4KB * (1 << %u). The default and minimum sizes are 16KB.
311
310
compress_extension=%s Support adding specified extension, so that f2fs can enable
···
371
368
the partition in read-only mode. By default it uses "continue"
372
369
mode.
373
370
374
-
====================== =============== =============== ========
375
-
mode continue remount-ro panic
376
-
====================== =============== =============== ========
377
-
access ops normal normal N/A
378
-
syscall errors -EIO -EROFS N/A
379
-
mount option rw ro N/A
380
-
pending dir write keep keep N/A
381
-
pending non-dir write drop keep N/A
382
-
pending node write drop keep N/A
383
-
pending meta write keep keep N/A
384
-
====================== =============== =============== ========
371
+
.. code-block:: none
372
+
373
+
====================== =============== =============== ========
374
+
mode continue remount-ro panic
375
+
====================== =============== =============== ========
376
+
access ops normal normal N/A
377
+
syscall errors -EIO -EROFS N/A
378
+
mount option rw ro N/A
379
+
pending dir write keep keep N/A
380
+
pending non-dir write drop keep N/A
381
+
pending node write drop keep N/A
382
+
pending meta write keep keep N/A
383
+
====================== =============== =============== ========
385
384
nat_bits Enable nat_bits feature to enhance full/empty nat blocks access,
386
385
by default it's disabled.
387
386
lookup_mode=%s Control the directory lookup behavior for casefolded
388
387
directories. This option has no effect on directories
389
388
that do not have the casefold feature enabled.
390
389
391
-
================== ========================================
392
-
Value Description
393
-
================== ========================================
394
-
perf (Default) Enforces a hash-only lookup.
395
-
The linear search fallback is always
396
-
disabled, ignoring the on-disk flag.
397
-
compat Enables the linear search fallback for
398
-
compatibility with directory entries
399
-
created by older kernel that used a
400
-
different case-folding algorithm.
401
-
This mode ignores the on-disk flag.
402
-
auto F2FS determines the mode based on the
403
-
on-disk `SB_ENC_NO_COMPAT_FALLBACK_FL`
404
-
flag.
405
-
================== ========================================
390
+
.. code-block:: none
391
+
392
+
================== ========================================
393
+
Value Description
394
+
================== ========================================
395
+
perf (Default) Enforces a hash-only lookup.
396
+
The linear search fallback is always
397
+
disabled, ignoring the on-disk flag.
398
+
compat Enables the linear search fallback for
399
+
compatibility with directory entries
400
+
created by older kernel that used a
401
+
different case-folding algorithm.
402
+
This mode ignores the on-disk flag.
403
+
auto F2FS determines the mode based on the
404
+
on-disk `SB_ENC_NO_COMPAT_FALLBACK_FL`
405
+
flag.
406
+
================== ========================================
406
407
======================== ============================================================
407
408
408
409
Debugfs Entries