summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2006-07-25 18:37:55 +0000
committerPaul Eggert <eggert@cs.ucla.edu>2006-07-25 18:37:55 +0000
commit5637c1634f8d08b25c41390d7cc95acd94a1d37e (patch)
tree888790bf523cab92b9a9f5c07fc7fdc67c4fcd34 /doc
parent0b34021d6db942c7e70fbc95d2fc45ef6a7f36f6 (diff)
downloadcoreutils-5637c1634f8d08b25c41390d7cc95acd94a1d37e.tar.xz
(Directory Setuid and Setgid): Explain that this is a
GNU extension, and that other systems behave differently here.
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog5
-rw-r--r--doc/perm.texi12
2 files changed, 13 insertions, 4 deletions
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 <eggert@cs.ucla.edu>
+
+ * 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 <eggert@cs.ucla.edu>
* 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.