[src/trunk]: src/share/man/man7 sysctl(7): Note nodev,nosuid requirement for ...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/bd5532b0a528
branches:  trunk
changeset: 376447:bd5532b0a528
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Sun Jun 18 18:16:40 2023 +0000

description:
sysctl(7): Note nodev,nosuid requirement for user-mounted fs.

While here, tidy up language and markup a smidge.

diffstat:

 share/man/man7/sysctl.7 |  25 ++++++++++++++++++-------
 1 files changed, 18 insertions(+), 7 deletions(-)

diffs (40 lines):

diff -r 6604f930c8e2 -r bd5532b0a528 share/man/man7/sysctl.7
--- a/share/man/man7/sysctl.7   Sun Jun 18 07:32:33 2023 +0000
+++ b/share/man/man7/sysctl.7   Sun Jun 18 18:16:40 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysctl.7,v 1.164 2023/05/29 23:30:47 gutteridge Exp $
+.\"    $NetBSD: sysctl.7,v 1.165 2023/06/18 18:16:40 riastradh Exp $
 .\"
 .\" Copyright (c) 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -142,13 +142,24 @@ The highest valid file system type numbe
 Returns configuration information about the file system type given as a fourth
 level identifier.
 .It Li vfs.generic.usermount ( Dv VFS_USERMOUNT )
-Determines if non superuser mounts are allowed, defaults to
-.Dv 0 .
+Controls whether users other than the super-user can mount file
+systems.
+Defaults to
+.Li 0 ,
+so only the super-user can mount file systems.
+.Pp
+File systems mounted by unprivileged users must be mounted with the
+.Li nodev
+and
+.Li nosuid
+.Xr mount 8
+options.
 .It Li vfs.generic.magiclinks ( Dv VFS_MAGICLINKS )
-Controls if expansion of variables is going to be performed on pathnames
-or not.
-Defaults to no variable expansion,
-.Dv 0 .
+Controls whether expansion of variables is going to be performed on
+pathnames or not.
+Defaults to
+.Li 0 ,
+no variable expansion.
 Variables are of the form
 .Li @name
 and the variables supported are described in