From 5637c1634f8d08b25c41390d7cc95acd94a1d37e Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Tue, 25 Jul 2006 18:37:55 +0000 Subject: (Directory Setuid and Setgid): Explain that this is a GNU extension, and that other systems behave differently here. --- doc/ChangeLog | 5 +++++ doc/perm.texi | 12 ++++++++---- 2 files changed, 13 insertions(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/ChangeLog b/doc/ChangeLog index f30b6a3e5..22490068d 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2006-07-25 Paul Eggert + + * perm.texi (Directory Setuid and Setgid): Explain that this is a + GNU extension, and that other systems behave differently here. + 2006-07-22 Paul Eggert * coreutils.texi (What information is listed): Clarify that the diff --git a/doc/perm.texi b/doc/perm.texi index 5a65420a1..4cc00b1d6 100644 --- a/doc/perm.texi +++ b/doc/perm.texi @@ -537,7 +537,7 @@ bits of new subdirectories. These mechanisms let users share files more easily, by lessening the need to use @command{chmod} or @command{chown} to share new files. -These convenience mechanisms rely on the set-group-ID and set-user-ID +These convenience mechanisms rely on the set-user-ID and set-group-ID bits of directories. If commands like @command{chmod} and @command{mkdir} routinely cleared these bits on directories, the mechanisms would be less convenient and it would be harder to share @@ -557,11 +557,11 @@ mkdir -m 755 c mkdir -m u=rwx,go=rx d @end example -If you want to clear these bits, you must mention them explicitly in -the symbolic or numeric modes, e.g.: +If you want to try to clear these bits, you must mention them +explicitly in the symbolic or numeric modes, e.g.: @example -# These commands clear the set-user-ID +# These commands try to clear the set-user-ID # and set-group-ID bits of the subdirectories. mkdir a b chmod 0755 a @@ -569,3 +569,7 @@ chmod a-s,u=rwx,go=rx b mkdir -m 0755 c mkdir -m a-s,u=rwx,go=rx d @end example + +This behavior is a @acronym{GNU} extension. Portable scripts should +not rely on requests to set or clear these bits on directories, as +@acronym{POSIX} allows implementations to ignore these requests. -- cgit v1.2.3-70-g09d2