From 31bb8a431a022ffd24e4d0e08a3ee0b26099d302 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Tue, 30 Jan 2007 22:54:34 +0100 Subject: [PATCH] * coreutils.texi (mkdir invocation): Say how to set the file permission bits of a parent directory with mkdir -p. --- doc/ChangeLog | 5 +++++ doc/coreutils.texi | 20 ++++++++++++++------ 2 files changed, 19 insertions(+), 6 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 7654231..0dd0f9e 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2007-01-30 Paul Eggert + + * coreutils.texi (mkdir invocation): Say how to set the file + permission bits of a parent directory with mkdir -p. + 2007-01-29 Jim Meyering Document new syntax: "chown +0:+287 file", "chgrp +99 file" diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 05bf7c6..033059a 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -8446,12 +8446,20 @@ overridden in this way. @opindex -p @opindex --parents @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. +Make any missing parent directories for each argument, setting their +file permission bits to the umask modified by @samp{u+wx}. Ignore +existing parent directories, and do not change their file permission +bits. + +To set the file permission bits of any newly-created parent +directories to a value that includes @samp{u+wx}, you can set the +umask before invoking @command{mkdir}. For example, if the shell +command @samp{(umask u=rwx,go=rx; mkdir -p P/Q)} creates the parent +@file{P} it sets the parent's permission bits to @samp{u=rwx,go=rx}. +To set a parent's special mode bits as well, you can invoke +@command{chmod} after @command{mkdir}. @xref{Directory Setuid and +Setgid}, for how the set-user-ID and set-group-ID bits of +newly-created parent directories are inherited. @item -v @item --verbose -- 2.7.4