Date: Tue, 10 Apr 2018 03:50:01 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 227406] man zfs describes effect of some flags on solaris/classic unix, need correcting for differences on import to FreeBSD Message-ID: <bug-227406-9@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D227406 Bug ID: 227406 Summary: man zfs describes effect of some flags on solaris/classic unix, need correcting for differences on import to FreeBSD Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Some People Priority: --- Component: Manual Pages Assignee: bugs@FreeBSD.org Reporter: stilezy@gmail.com CC: doc@FreeBSD.org The zfs man page has been imported from its source unix (illumos/openzfs/solaris/classical unix of some kind) without correcting for discrepancies between the source OS described and FreeBSD. It therefore misleads about the scope of the setuid flag on FreeBSD. "man zfs" -> "setuid=3Don" property states that this property "controls whe= ther the set-UID bit is respected for the file system". There are no stated qualifiers/limitations.=20 On a classical unix this may be a correct description but on FreeBSD the se= tuid bit acts on files **and dirs** "if the file system supports it", which "man zfs" implies it does (ref: man chmod). So a plain reading of man zfs is that setting this property will affect fil= es and dirs. This is not correct *for FreeBSD* even if common on other UNIXes. Correction required: "setuid =3D on | off : Controls whether the set-UID bit is respected for **= files on** the file system. **The property has no effect on directories on the fi= le system**. The default value is on." Current wording (incorrect): "setuid =3D on | off : Controls whether the set-UID bit is respected for th= e file system. The default value is on." Issue identified via FreeBSD-fs mailing list discussion. --=20 You are receiving this mail because: You are on the CC list for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-227406-9>