From owner-freebsd-doc@FreeBSD.ORG Fri Jul 29 02:40:16 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 54EFD16A420 for ; Fri, 29 Jul 2005 02:40:15 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 97C5A43D58 for ; Fri, 29 Jul 2005 02:40:13 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j6T2eDBt010524 for ; Fri, 29 Jul 2005 02:40:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j6T2eDqs010523; Fri, 29 Jul 2005 02:40:13 GMT (envelope-from gnats) Resent-Date: Fri, 29 Jul 2005 02:40:13 GMT Resent-Message-Id: <200507290240.j6T2eDqs010523@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, garys@opusnet.com Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7E7B816A425 for ; Fri, 29 Jul 2005 02:37:34 +0000 (GMT) (envelope-from garys@opusnet.com) Received: from opusnet.com (mail.opusnet.com [209.210.200.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id D54DE43D7D for ; Fri, 29 Jul 2005 01:56:20 +0000 (GMT) (envelope-from garys@opusnet.com) Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP (SMTPD32-8.05) id ACC13D9C0034; Thu, 28 Jul 2005 18:56:17 -0700 Received: from localhost.localhost (localhost.localhost [127.0.0.1]) by localhost.localhost (8.13.3/8.13.3) with ESMTP id j6T1vIYJ080155 for ; Thu, 28 Jul 2005 18:57:18 -0700 (PDT) (envelope-from garys@opusnet.com) Received: (from jojo@localhost) by localhost.localhost (8.13.3/8.13.3/Submit) id j6T1vDhH080154; Thu, 28 Jul 2005 18:57:13 -0700 (PDT) (envelope-from garys@opusnet.com) Message-Id: <2uvf2ubchy.f2u@mail.opusnet.com> Date: Thu, 28 Jul 2005 18:57:13 -0700 From: "Gary W. Swearingen" To: FreeBSD-gnats-submit@FreeBSD.org Cc: Subject: docs/84265: chmod(1) manpage omits implication of setting w on directory X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: garys@opusnet.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 29 Jul 2005 02:40:16 -0000 >Number: 84265 >Category: docs >Synopsis: chmod(1) manpage omits implication of setting w on directory >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Fri Jul 29 02:40:13 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Gary W. Swearingen >Release: FreeBSD 5.4-RELEASE i386 >Organization: none >Environment: n/a >Description: The manpage gives some implications of setting SUID on a directory but not W. The concept mentioned below is not covered elsewhere AFAIK, at least outside c-programmer manpages. It should be. >How-To-Repeat: n/a >Fix: Apply patch. I'd also add the following paragraph to the chmod(1) and chgrp(1) manpages, but I'll wait for approval before making patches. The group of a directory will be assigned to files newly created (eg, by > or an editor, but not by mv or cp) within it, despite the owner or group of the creator. --- /pr/work/chmod..orig.1 Wed Jul 27 18:05:44 2005 +++ /pr/work/chmod.1 Wed Jul 27 18:14:08 2005 @@ -276,6 +276,16 @@ ``o'' by itself), in combination with the .Ar perm symbols ``s'' or ``t'', are ignored. +.Pp +Setting the write permission on a directory will enable files to be +moved into or copied into or created in the directory. Files +created in the directory (eg, by +.Nm > +or an editor, but not by +.Nm mv +or +.Nm cp ) +will be assigned the group of the directory. .Sh EXAMPLES .Bl -tag -width "u=rwx,go=u-w" -compact .It Li 644 >Release-Note: >Audit-Trail: >Unformatted: