Sun Jun 18 18:16:40 2023 UTC ()
sysctl(7): Note nodev,nosuid requirement for user-mounted fs.

While here, tidy up language and markup a smidge.


(riastradh)
diff -r1.164 -r1.165 src/share/man/man7/sysctl.7
cvs diff -r1.164 -r1.165 src/share/man/man7/sysctl.7 (expand / switch to unified diff)

--- src/share/man/man7/sysctl.7 2023/05/29 23:30:47 1.164
+++ src/share/man/man7/sysctl.7 2023/06/18 18:16:40 1.165
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: sysctl.7,v 1.164 2023/05/29 23:30:47 gutteridge Exp $ 1.\" $NetBSD: sysctl.7,v 1.165 2023/06/18 18:16:40 riastradh Exp $
2.\" 2.\"
3.\" Copyright (c) 1993 3.\" Copyright (c) 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors 14.\" 3. Neither the name of the University nor the names of its contributors
@@ -132,33 +132,44 @@ See @@ -132,33 +132,44 @@ See
132for more information. 132for more information.
133.Ss The vfs.* subtree 133.Ss The vfs.* subtree
134A distinguished second level name, 134A distinguished second level name,
135.Li vfs.generic ( Dv VFS_GENERIC ) , 135.Li vfs.generic ( Dv VFS_GENERIC ) ,
136is used to get general information about all file systems. 136is used to get general information about all file systems.
137It has the following third level identifiers: 137It has the following third level identifiers:
138.Bl -tag -width "123456" 138.Bl -tag -width "123456"
139.It Li vfs.generic.maxtypenum ( Dv VFS_MAXTYPENUM ) 139.It Li vfs.generic.maxtypenum ( Dv VFS_MAXTYPENUM )
140The highest valid file system type number. 140The highest valid file system type number.
141.It Li vfs.generic.conf ( Dv VFS_CONF ) 141.It Li vfs.generic.conf ( Dv VFS_CONF )
142Returns configuration information about the file system type given as a fourth 142Returns configuration information about the file system type given as a fourth
143level identifier. 143level identifier.
144.It Li vfs.generic.usermount ( Dv VFS_USERMOUNT ) 144.It Li vfs.generic.usermount ( Dv VFS_USERMOUNT )
145Determines if non superuser mounts are allowed, defaults to 145Controls whether users other than the super-user can mount file
146.Dv 0 . 146systems.
 147Defaults to
 148.Li 0 ,
 149so only the super-user can mount file systems.
 150.Pp
 151File systems mounted by unprivileged users must be mounted with the
 152.Li nodev
 153and
 154.Li nosuid
 155.Xr mount 8
 156options.
147.It Li vfs.generic.magiclinks ( Dv VFS_MAGICLINKS ) 157.It Li vfs.generic.magiclinks ( Dv VFS_MAGICLINKS )
148Controls if expansion of variables is going to be performed on pathnames 158Controls whether expansion of variables is going to be performed on
149or not. 159pathnames or not.
150Defaults to no variable expansion, 160Defaults to
151.Dv 0 . 161.Li 0 ,
 162no variable expansion.
152Variables are of the form 163Variables are of the form
153.Li @name 164.Li @name
154and the variables supported are described in 165and the variables supported are described in
155.Xr symlink 7 166.Xr symlink 7
156under 167under
157.Dq "MAGIC SYMLINKS" . 168.Dq "MAGIC SYMLINKS" .
158.El 169.El
159.Pp 170.Pp
160A second level name for controlling the 171A second level name for controlling the
161.Xr wapbl 4 172.Xr wapbl 4
162(Write Ahead Physical Block Logging file system journaling) 173(Write Ahead Physical Block Logging file system journaling)
163capabilities with the following third level identifiers: 174capabilities with the following third level identifiers:
164.Bl -tag -width "123456" 175.Bl -tag -width "123456"