BSD 4_4_Lite1 release
[unix-history] / usr / src / bin / mkdir / mkdir.1
index c8c41c5..f38a5dc 100644 (file)
@@ -32,9 +32,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"    @(#)mkdir.1     8.1 (Berkeley) 5/31/93
+.\"    @(#)mkdir.1     8.2 (Berkeley) 1/25/94
 .\"
 .\"
-.Dd May 31, 1993
+.Dd January 25, 1994
 .Dt MKDIR 1
 .Os
 .Sh NAME
 .Dt MKDIR 1
 .Os
 .Sh NAME
 .Sh SYNOPSIS
 .Nm mkdir
 .Op Fl p
 .Sh SYNOPSIS
 .Nm mkdir
 .Op Fl p
+.Op Fl m Ar mode
 .Ar directory_name  ...
 .Sh DESCRIPTION
 .Nm Mkdir
 creates the directories named as operands, in the order specified,
 using mode
 .Ar directory_name  ...
 .Sh DESCRIPTION
 .Nm Mkdir
 creates the directories named as operands, in the order specified,
 using mode
-.Li \&0777
-modified by the current
+.Li rwxrwxrwx (\&0777)
+as modified by the current
 .Xr umask  2  .
 .Pp
 The options are as follows:
 .Pp
 .Bl -tag -width indent
 .Xr umask  2  .
 .Pp
 The options are as follows:
 .Pp
 .Bl -tag -width indent
+.It Fl m
+Set the file permission bits of the final created directory to
+the specified mode.
+The mode argument can be in any of the formats specified to the
+.Xr chmod 1
+command.
+If a symbolic mode is specified, the operation characters
+.Dq +
+and
+.Dq -
+are interpreted relative to an initial mode of
+.Dq a=rwx .
 .It Fl p
 .It Fl p
-Create intermediate directories as required.  If this option is not
-specified, the full path prefix of each operand must already exist.
+Create intermediate directories as required.
+If this option is not specified, the full path prefix of each
+operand must already exist.
+Intermediate directories are created with permission bits of
+.Li rwxrwxrwx (\&0777)
+as modified by the current umask, plus write and search
+permission for the owner.
 .El
 .Pp
 The user must have write permission in the parent directory.
 .El
 .Pp
 The user must have write permission in the parent directory.