From owner-freebsd-bugs@freebsd.org Tue Apr 10 03:50:03 2018 Return-Path: Delivered-To: freebsd-bugs@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id C790BF9A926 for ; Tue, 10 Apr 2018 03:50:03 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mailman.ysv.freebsd.org (mailman.ysv.freebsd.org [IPv6:2001:1900:2254:206a::50:5]) by mx1.freebsd.org (Postfix) with ESMTP id 42C52690F1 for ; Tue, 10 Apr 2018 03:50:03 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: by mailman.ysv.freebsd.org (Postfix) id 018B9F9A920; Tue, 10 Apr 2018 03:50:03 +0000 (UTC) Delivered-To: bugs@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id D1BB6F9A91E for ; Tue, 10 Apr 2018 03:50:02 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.ysv.freebsd.org (mxrelay.ysv.freebsd.org [IPv6:2001:1900:2254:206a::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.ysv.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 6D6FC690EF for ; Tue, 10 Apr 2018 03:50:02 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.ysv.freebsd.org (Postfix) with ESMTPS id 93D714AA3 for ; Tue, 10 Apr 2018 03:50:01 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id w3A3o1JT059674 for ; Tue, 10 Apr 2018 03:50:01 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id w3A3o162059672 for bugs@FreeBSD.org; Tue, 10 Apr 2018 03:50:01 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: bugs@FreeBSD.org Subject: [Bug 227406] man zfs describes effect of some flags on solaris/classic unix, need correcting for differences on import to FreeBSD Date: Tue, 10 Apr 2018 03:50:01 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: stilezy@gmail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter cc Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 10 Apr 2018 03:50:04 -0000 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 the assignee for the bug.=