feat(dracut.sh): add "--enhanced-cpio" option for calling dracut-cpio

[thirdparty/dracut.git] / man / dracut.8.asc

diff --git a/man/dracut.8.asc b/man/dracut.8.asc
index 515e32db88f02a42f71e4f9f6f8cbc72c23e9e2d..708166bdcacdec935b26be11979bf4822c5c05d3 100644 (file)
--- a/man/dracut.8.asc
+++ b/man/dracut.8.asc
@@ -530,6 +530,15 @@ will not be able to boot.
     Specifies the kernel image, which to include in the UEFI executable. The default is
     _/lib/modules/<KERNEL-VERSION>/vmlinuz_ or _/boot/vmlinuz-<KERNEL-VERSION>_
 
+**--enhanced-cpio**::
+    Attempt to use the dracut-cpio binary, which optimizes archive creation for
+    copy-on-write filesystems by using the copy_file_range(2) syscall via Rust's
+    io::copy(). When specified, initramfs archives are also padded to ensure
+    optimal data alignment for extent sharing. To retain reflink data
+    deduplication benefits, this should be used alongside the **--no-compress**
+    and **--no-strip** parameters, with initramfs source files, **--tmpdir**
+    staging area and destination all on the same copy-on-write capable filesystem.
+
 ENVIRONMENT
 -----------