From 1895c76f741a9cb85f83b333dbf0079528d254f0 Mon Sep 17 00:00:00 2001 From: Karel Zak Date: Tue, 22 Jan 2019 10:02:17 +0100 Subject: 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 --- disk-utils/mkswap.8 | 15 +++------------ 1 file changed, 3 insertions(+), 12 deletions(-) (limited to 'disk-utils') 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 -- cgit v1.2.3-55-g7522