git: 9f0fea5d033f - main - Document new variant of swapoff(2)

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Thu, 09 Dec 2021 01:27:57 UTC
The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=9f0fea5d033f5cd4b9b76aefe31b12c4dba25790

commit 9f0fea5d033f5cd4b9b76aefe31b12c4dba25790
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2021-12-08 21:24:31 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2021-12-09 00:48:53 +0000

    Document new variant of swapoff(2)
    
    Reviewed by:    brooks
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D33343
---
 lib/libc/sys/swapon.2 | 26 +++-----------------------
 1 file changed, 3 insertions(+), 23 deletions(-)

diff --git a/lib/libc/sys/swapon.2 b/lib/libc/sys/swapon.2
index 3a8da8f4f363..c369e8b7ba51 100644
--- a/lib/libc/sys/swapon.2
+++ b/lib/libc/sys/swapon.2
@@ -28,7 +28,7 @@
 .\"     @(#)swapon.2	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd December 2, 2021
+.Dd December 8, 2021
 .Dt SWAPON 2
 .Os
 .Sh NAME
@@ -43,7 +43,7 @@
 .Ft int
 .Fn swapon "const char *special"
 .Ft int
-.Fn swapoff "const char *special"
+.Fn swapoff "const char *special" "u_int flags"
 .Sh DESCRIPTION
 The
 .Fn swapon
@@ -68,27 +68,7 @@ is made available for other purposes.
 .Pp
 The
 .Fa special
-argument points to either the string that names the special device
-used for swapping or the following structure
-.Bd -literal
-struct swapoff_new_args {
-	const char *name_old_syscall;
-	const char *name;
-	u_int flags;
-};
-.Ed
-that extends swapoff's interface to include optional flags.
-The
-.Va name_old_syscall
-member must be initialized to
-.Dv NULL
-for the system to recognize the extended interface.
-It is recommended that the whole structure be zeroed for future
-compatibility, due to padding.
-.Pp
-The
-.Va name
-string is the special device name, same as legacy syscall argument.
+argument points to the name of the device or file used for swapping.
 .The
 .Va flags
 argument takes the following flags: