From 5beeabebe0304a1047ff82620b94bde0c95b3a3f Mon Sep 17 00:00:00 2001 From: Hennadii Makhomed Date: Fri, 27 Dec 2024 16:33:09 +0100 Subject: [PATCH] zfs-create(8): ZFS for swap: caution, clarity Make the section heading more generic (the section relates to ZFS files as well as ZFS volumes). Swapping to a ZFS volume is prone to deadlock. Remove the related instruction, direct readers to OpenZFS FAQ. Related, but not linked from within the manual page: (Using a zvol for a swap device on Linux). Reviewed-by: Brian Behlendorf Signed-off-by: Graham Perrin Issue #7734 Closes #14756 --- man/man8/zfs-create.8 | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/man/man8/zfs-create.8 b/man/man8/zfs-create.8 index 55397fa661d5..903f70a5d6fd 100644 --- a/man/man8/zfs-create.8 +++ b/man/man8/zfs-create.8 @@ -234,14 +234,11 @@ if the volume is not sparse. Print verbose information about the created dataset. .El .El -.Ss ZFS Volumes as Swap -ZFS volumes may be used as swap devices. -After creating the volume with the -.Nm zfs Cm create Fl V -enable the swap area using the -.Xr swapon 8 -command. -Swapping to files on ZFS filesystems is not supported. +.Ss ZFS for Swap +Swapping to a ZFS volume is prone to deadlock and not recommended. +See OpenZFS FAQ. +.Pp +Swapping to a file on a ZFS filesystem is not supported. . .Sh SEE ALSO .Xr zfs-destroy 8 ,