summaryrefslogtreecommitdiffstats
path: root/disk-utils
diff options
context:
space:
mode:
authorKarel Zak2019-01-22 10:02:17 +0100
committerKarel Zak2019-01-22 10:02:17 +0100
commit1895c76f741a9cb85f83b333dbf0079528d254f0 (patch)
tree9bfbe5fa9ac17f2fe48c850d07a8fdf9e1b25d06 /disk-utils
parentswapon: (man) iomap for swapfile is already supported by kernel (diff)
downloadkernel-qcow2-util-linux-1895c76f741a9cb85f83b333dbf0079528d254f0.tar.gz
kernel-qcow2-util-linux-1895c76f741a9cb85f83b333dbf0079528d254f0.tar.xz
kernel-qcow2-util-linux-1895c76f741a9cb85f83b333dbf0079528d254f0.zip
swapon: rewrite section about swapfiles
* don't duplicate info on two places -- let's keep only small note in mkswap(8) man page, suggest to read swapon(8) man page * add info about kernel versions for XFS and Btrfs swapfiles support * use subsection in the NOTES Addresses: https://github.com/karelzak/util-linux/issues/633 Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'disk-utils')
-rw-r--r--disk-utils/mkswap.815
1 files changed, 3 insertions, 12 deletions
diff --git a/disk-utils/mkswap.8 b/disk-utils/mkswap.8
index 7b6a02746..e9bd9ccfa 100644
--- a/disk-utils/mkswap.8
+++ b/disk-utils/mkswap.8
@@ -130,20 +130,11 @@ e.g.\& using a command like
to create 8GiB swapfile.
-The swap file implementation in the kernel expects to be able to write to the file directly,
-without the assistance of the filesystem. This is a problem on files with holes
-(e.g. created by
-.BR cp (1)
-or another commands), or on files on copy-on-write filesystems like
-.BR btrfs .
-In some cases preallocated files (e.g. fallocate(1) on XFS) maybe interpreted
-by old kernel versions as files with holes too. The most portable solution is to use
-.BR dd (1)
-and /dev/zero in these cases.
-.sp
Please read notes from
.BR swapon (8)
-before adding a swap file to copy-on-write filesystems.
+about
+.B the swap file use restrictions
+(holes, preallocation and copy-on-write issues).
.SH ENVIRONMENT
.IP LIBBLKID_DEBUG=all