From 6c29422e90dca7a7ef6a69c721238a1c33f393f9 Mon Sep 17 00:00:00 2001 From: Graham Perrin Date: Fri, 2 Jun 2023 19:25:13 +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 a7b6097c37..b3997d3276 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 EXAMPLES .\" These are, respectively, examples 1, 10 from zfs.8