From: Kirill A. Korinsky <kirill@korins.ky>
Subject: swapctl.8: state that nfsmntpt=/path should be crated as directory
To: OpenBSD tech <tech@openbsd.org>
Date: Wed, 06 Aug 2025 13:46:41 +0200

tech@,

I had noticed that nfsmntpt option do not state that /path should exist and
it should be a directory, and not a file.

I suggest to make it clear:

     nfsmntpt=/path  This option is useful for swapping to NFS files.  It
                     specifies the local mount point /path to mount an NFS
                     filesystem which shoud exist as a directory.  Typically,
                     once this mount has succeeded, the file to be used for
                     swapping on will be available under this mount point.
                     For example:

                     server:/export/swap/client none swap sw,nfsmntpt=/swap



Thought? Ok?

Index: swapctl.8
===================================================================
RCS file: /home/cvs/src/sbin/swapctl/swapctl.8,v
diff -u -p -r1.37 swapctl.8
--- swapctl.8	9 Jul 2024 05:19:41 -0000	1.37
+++ swapctl.8	6 Aug 2025 11:45:52 -0000
@@ -178,10 +178,11 @@ This value can be any valid integer,
 with higher values receiving less priority.
 .It nfsmntpt=/path
 This option is useful for swapping to NFS files.
-It specifies the local mount point to mount an NFS filesystem.
-Typically, once
-this mount has succeeded, the file to be used for swapping on will
-be available under this mount point.
+It specifies the local mount point
+.Pa /path
+to mount an NFS filesystem which shoud exist as a directory.
+Typically, once this mount has succeeded, the file to be used for
+swapping on will be available under this mount point.
 For example:
 .Bd -literal
 server:/export/swap/client none swap sw,nfsmntpt=/swap