From 82e0ce4d8b4487f757b4326c8314b071ec81e893 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Fri, 28 Jul 2006 07:20:28 +0000 Subject: (install invocation, mkdir invocation): Add cross-references to Directory Setuid and Setgid. (install-invocation): The default mode is no longer equivalent to 755. --- doc/coreutils.texi | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 64accb03c..8d6553fe2 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -7260,7 +7260,8 @@ If the @option{--directory} (@option{-d}) option is given, @command{install} creates each @var{directory} and any missing parent directories. Parent directories are created with mode @samp{u=rwx,go=rx} (755), regardless of the @option{-m} option or the -current umask. +current umask. @xref{Directory Setuid and Setgid}, for how the +set-user-ID and set-group-ID bits of parent directories are inherited. @end itemize @cindex Makefiles, installing programs in @@ -7308,9 +7309,12 @@ Set the file mode bits for the installed file or directory to @var{mode}, which can be either an octal number, or a symbolic mode as in @command{chmod}, with @samp{a=} (no access allowed to anyone) as the point of departure (@pxref{File permissions}). -The default mode is @samp{u=rwx,go=rx,a-s} (0755)---read, write, and +The default mode is @samp{u=rwx,go=rx,a-s}---read, write, and execute for the owner, read and execute for group and other, and with set-user-ID and set-group-ID disabled. +This default is not quite the same as @samp{755}, since it disables +instead of preserving set-user-ID and set-group-ID on directories. +@xref{Directory Setuid and Setgid}. @item -o @var{owner} @itemx --owner=@var{owner} @@ -8102,7 +8106,9 @@ Normally the directory has the desired file mode bits at the moment it is created. As a @acronym{GNU} extension, @var{mode} may also mention special mode bits, but in this case there may be a temporary window during which the directory exists but its special mode bits are -incorrect. +incorrect. @xref{Directory Setuid and Setgid}, for how the +set-user-ID and set-group-ID bits of directories are inherited unless +overridden in this way. @item -p @itemx --parents @@ -8111,6 +8117,8 @@ incorrect. @cindex parent directories, creating Make any missing parent directories for each argument. The file permission bits of parent directories are set to the umask modified by @samp{u+wx}. +@xref{Directory Setuid and Setgid}, for how the set-user-ID and +set-group-ID bits of parent directories are inherited. Ignore arguments corresponding to existing directories, and do not change their file mode bits. -- cgit v1.2.3-70-g09d2