Bug 84268

Summary: chmod(1) manpage's BUGS entry is either wrong or too cryptic
Product: Documentation Reporter: Gary W. Swearingen <garys>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
chmod.1.diff none

Description Gary W. Swearingen 2005-07-29 05:00:26 UTC
It says:  There's no perm option for the naughty bits.

If true, it needs to explain "naughty bits".  There's a "perm option"
for SUID, GUID, and sticky bits. What else is naughty?

Fix: 

Remove the BUGS section.
How-To-Repeat: n/a
Comment 1 Ceri Davies 2005-07-31 14:39:09 UTC
On 29 Jul 2005, at 04:55, Gary W. Swearingen wrote:
>
> It says:  There's no perm option for the naughty bits.
>
> If true, it needs to explain "naughty bits".  There's a "perm option"
> for SUID, GUID, and sticky bits. What else is naughty?

I think that might actually be a joke.

Failing that, it means 'S' and 'T'.

Ceri
-- 
Only two things are infinite, the universe and human stupidity, and I'm
not sure about the former.                        -- Einstein (attrib.)
Comment 2 Gary W. Swearingen 2005-07-31 16:27:19 UTC
Ceri Davies <ceri@submonkey.net> writes:

> Failing that, it means 'S' and 'T'.

Then the BUG entry doesn't say what it means and will waste people's
time trying to figure out what it does mean.

I still think the BUGS section should be removed.

Or I can make a new patch with:

  There is no "perm" option which sets the sticky bit and also unsets
  the execute/search bit, and vice-versa, depending upon the "op"
  value.  The same applies to each of the setuid and setgid bits.

  There once was a man from Nantucket...

I sure don't see that as a BUG; just a (good) design decision.
Comment 3 Ceri Davies 2005-08-01 23:14:09 UTC
On 31 Jul 2005, at 15:30, Gary W. Swearingen wrote:
>  Ceri Davies <ceri@submonkey.net> writes:
>
>
>> Failing that, it means 'S' and 'T'.
>>
>
>  Then the BUG entry doesn't say what it means and will waste people's
>  time trying to figure out what it does mean.

I agree.

>  I still think the BUGS section should be removed.

I agree.

>  Or I can make a new patch with:
>
>    There is no "perm" option which sets the sticky bit and also unsets
>    the execute/search bit, and vice-versa, depending upon the "op"
>    value.  The same applies to each of the setuid and setgid bits.
>
>    There once was a man from Nantucket...
>
>  I sure don't see that as a BUG; just a (good) design decision.

I agree.

Anyone disagree?  (You have two days to say so).

Ceri
-- 
Only two things are infinite, the universe and human stupidity, and I'm
not sure about the former.                        -- Einstein (attrib.)
Comment 4 Daniel Gerzo 2006-01-02 15:26:46 UTC
Ciao,

   let's do it ;)

-- 
Best Regards,
   Daniel Gerzo
Comment 5 Pav Lucistnik freebsd_committer freebsd_triage 2006-01-02 15:34:44 UTC
Sounds like a well placed reference to Monty Python's naughty bits
sketch to me. It survived there for 11 years - from the initial
revision.

-- 
Pav Lucistnik <pav@oook.cz>
              <pav@FreeBSD.org>

Go back to bed America, your government is in control again. Here's American
Gladiators. Watch this, shut up. Here's 56 channels of it. Watch these
pituitary retards bang their fuckin skulls together and congratulate you on
living in the land of freedom.
  -- Bill Hicks
Comment 6 Ceri Davies 2006-01-02 17:13:20 UTC
On 2 Jan 2006, at 15:40, Pav Lucistnik wrote:

>  Sounds like a well placed reference to Monty Python's naughty bits
>  sketch to me. It survived there for 11 years - from the initial
>  revision.

You mean this?  http://orangecow.org/pythonet/sketches/naughty.htm
I still don't get it, I'm afraid.

Ceri
Comment 7 dfilter service freebsd_committer freebsd_triage 2009-01-23 11:39:11 UTC
Author: trhodes
Date: Fri Jan 23 11:39:00 2009
New Revision: 187627
URL: http://svn.freebsd.org/changeset/base/187627

Log:
  Note the implication of setting the 'w' permission on directories,
  while here, expand the 'naughty bits' comment in BUGS.
  
  PR:		84265 and 84268
  Reviewed by:	keramida
  Obtained from:	hints from ceri, keramida

Modified:
  head/bin/chmod/chmod.1

Modified: head/bin/chmod/chmod.1
==============================================================================
--- head/bin/chmod/chmod.1	Fri Jan 23 11:11:29 2009	(r187626)
+++ head/bin/chmod/chmod.1	Fri Jan 23 11:39:00 2009	(r187627)
@@ -32,7 +32,7 @@
 .\"	@(#)chmod.1	8.4 (Berkeley) 3/31/94
 .\" $FreeBSD$
 .\"
-.Dd December 22, 2006
+.Dd January 23, 2009
 .Dt CHMOD 1
 .Os
 .Sh NAME
@@ -281,6 +281,10 @@ Operations upon the other permissions on
 ``o'' by itself), in combination with the
 .Ar perm
 symbols ``s'' or ``t'', are ignored.
+.Pp
+The ``w'' permission on directories will permit file creation, relocation,
+and copy into that directory.
+Files created within the directory itself will inherit its group ID.
 .Sh EXAMPLES
 .Bl -tag -width "u=rwx,go=u-w" -compact
 .It Li 644
@@ -343,4 +347,5 @@ command appeared in
 .Sh BUGS
 There is no
 .Ar perm
-option for the naughty bits.
+option for the naughty bits which are ``S'' and
+``T'' respectively.
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Comment 8 Tom Rhodes freebsd_committer freebsd_triage 2009-01-23 11:39:14 UTC
State Changed
From-To: open->patched

Discussion on 'naughty bits' expanded.  Thanks. 


Comment 9 Tom Rhodes freebsd_committer freebsd_triage 2009-01-23 11:39:14 UTC
Responsible Changed
From-To: freebsd-doc->trhodes

Over to me.
Comment 10 Glen Barber freebsd_committer freebsd_triage 2011-06-14 23:52:31 UTC
State Changed
From-To: patched->closed

MFCd to stable/7.
Comment 11 dfilter service freebsd_committer freebsd_triage 2011-06-14 23:52:38 UTC
Author: gjb (doc committer)
Date: Tue Jun 14 22:52:24 2011
New Revision: 223102
URL: http://svn.freebsd.org/changeset/base/223102

Log:
  MFC 187627 by trhodes:
  
  Note the implication of setting the 'w' permission on directories,
  while here, expand the 'naughty bits' comment in BUGS.
  
  PR:		84268

Modified:
  stable/7/bin/chmod/chmod.1
Directory Properties:
  stable/7/bin/chmod/   (props changed)

Modified: stable/7/bin/chmod/chmod.1
==============================================================================
--- stable/7/bin/chmod/chmod.1	Tue Jun 14 22:40:13 2011	(r223101)
+++ stable/7/bin/chmod/chmod.1	Tue Jun 14 22:52:24 2011	(r223102)
@@ -32,7 +32,7 @@
 .\"	@(#)chmod.1	8.4 (Berkeley) 3/31/94
 .\" $FreeBSD$
 .\"
-.Dd December 22, 2006
+.Dd January 23, 2009
 .Dt CHMOD 1
 .Os
 .Sh NAME
@@ -281,6 +281,10 @@ Operations upon the other permissions on
 ``o'' by itself), in combination with the
 .Ar perm
 symbols ``s'' or ``t'', are ignored.
+.Pp
+The ``w'' permission on directories will permit file creation, relocation,
+and copy into that directory.
+Files created within the directory itself will inherit its group ID.
 .Sh EXAMPLES
 .Bl -tag -width "u=rwx,go=u-w" -compact
 .It Li 644
@@ -343,4 +347,5 @@ command appeared in
 .Sh BUGS
 There is no
 .Ar perm
-option for the naughty bits.
+option for the naughty bits which are ``S'' and
+``T'' respectively.
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"