Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
User Commandsmkdir(1)


NAME

 mkdir - make directories

SYNOPSIS

 mkdir [-m mode] [-p] dir ...

DESCRIPTION

 

The mkdir command creates the named directories in mode 777 (possibly altered by the file mode creation mask umask(1)).

Standard entries in a directory (for instance, the files ".", for the directory itself, and "..", for its parent) are made automatically. mkdir cannot create these entries by name. Creation of a directory requires write permission in the parent directory.

The owner-ID and group-ID of the new directories are set to the process's effective user-ID and group-ID, respectively. mkdir calls the mkdir(2) system call.

setgid and mkdir

 

To change the setgid bit on a newly created directory, you must use chmod g+s or chmod g-s after executing mkdir.

The setgid bit setting is inherited from the parent directory.

OPTIONS

 

The following options are supported:

-m mode
This option allows users to specify the mode to be used for new directories. Choices for modes can be found in chmod(1).
-p
With this option, mkdir creates dir by creating all the non-existing parent directories first. The mode given to intermediate directories will be the difference between 777 and the bits set in the file mode creation mask. The difference, however, must be at least 300 (write and execute permission for the user).

OPERANDS

 

The following operand is supported:

dir
A path name of a directory to be created.

USAGE

 

See largefile(5) for the description of the behavior of mkdir when encountering files greater than or equal to 2 Gbyte ( 231 bytes).

EXAMPLES

 Example 1. Using mkdir
 

The following example:
 
example% mkdir -p ltr/jd/jan
creates the subdirectory structure ltr/jd/jan.

ENVIRONMENT VARIABLES

 

See environ(5) for descriptions of the following environment variables that affect the execution of mkdir: LC_CTYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS

 

The following exit values are returned:

0
All the specified directories were created successfully or the -p option was specified and all the specified directories now exist.
>0
An error occurred.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWcsu
CSIenabled

SEE ALSO

 

rm(1), sh(1), umask(1), intro(2), mkdir(2), attributes(5), environ(5), largefile(5)


SunOS 5.9Go To TopLast Changed 1 Feb 1995

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.