124 lines
3.2 KiB
HTML
124 lines
3.2 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>mkdir(2)</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
<H1>mkdir(2)</H1>
|
|
<HR>
|
|
<PRE>
|
|
|
|
</PRE>
|
|
<H2>NAME</H2><PRE>
|
|
mkdir - make a directory file
|
|
|
|
|
|
</PRE>
|
|
<H2>SYNOPSIS</H2><PRE>
|
|
<STRONG>#include</STRONG> <STRONG><sys/types.h></STRONG>
|
|
<STRONG>#include</STRONG> <STRONG><sys/stat.h></STRONG>
|
|
|
|
<STRONG>int</STRONG> <STRONG>mkdir(const</STRONG> <STRONG>char</STRONG> <STRONG>*</STRONG><EM>path</EM><STRONG>,</STRONG> <STRONG>mode_t</STRONG> <EM>mode</EM><STRONG>)</STRONG>
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
<STRONG>Mkdir</STRONG> creates a new directory file with name <EM>path</EM>. The mode of the new
|
|
file is initialized from <EM>mode</EM>. (The protection part of the mode is
|
|
modified by the process's mode mask; see <STRONG><A HREF="../man2/umask.2.html">umask(2)</A></STRONG>).
|
|
|
|
The directory's owner ID is set to the process's effective user ID. The
|
|
directory's group ID is set to that of the parent directory in which it
|
|
is created.
|
|
|
|
The low-order 9 bits of mode are modified by the process's file mode
|
|
creation mask: all bits set in the process's file mode creation mask are
|
|
cleared. See <STRONG><A HREF="../man2/umask.2.html">umask(2)</A></STRONG>.
|
|
|
|
|
|
</PRE>
|
|
<H2>RETURN VALUE</H2><PRE>
|
|
A 0 return value indicates success. A -1 return value indicates an
|
|
error, and an error code is stored in <STRONG>errno.</STRONG>
|
|
|
|
|
|
</PRE>
|
|
<H2>ERRORS</H2><PRE>
|
|
<STRONG>Mkdir</STRONG> will fail and no directory will be created if:
|
|
|
|
[ENOTDIR] A component of the path prefix is not a directory.
|
|
|
|
[ENAMETOOLONG] The path name exceeds PATH_MAX characters.
|
|
|
|
[ENOENT] A component of the path prefix does not exist.
|
|
|
|
[EACCES] Search permission is denied for a component of the path
|
|
prefix.
|
|
|
|
[ELOOP] Too many symbolic links were encountered in translating
|
|
the pathname. (Minix-vmd)
|
|
|
|
[EROFS] The named file resides on a read-only file system.
|
|
|
|
[EEXIST] The named file exists.
|
|
|
|
[ENOSPC] The directory in which the entry for the new directory is
|
|
being placed cannot be extended because there is no space
|
|
left on the file system containing the directory.
|
|
|
|
|
|
[ENOSPC] The new directory cannot be created because there there is
|
|
no space left on the file system that will contain the
|
|
directory.
|
|
|
|
[ENOSPC] There are no free inodes on the file system on which the
|
|
directory is being created.
|
|
|
|
[EIO] An I/O error occurred while making the directory entry or
|
|
allocating the inode.
|
|
|
|
[EIO] An I/O error occurred while reading from or writing to the
|
|
file system.
|
|
|
|
[EFAULT] <EM>Path</EM> points outside the process's allocated address space.
|
|
|
|
|
|
</PRE>
|
|
<H2>SEE ALSO</H2><PRE>
|
|
<STRONG><A HREF="../man2/chmod.2.html">chmod(2)</A></STRONG>, <STRONG><A HREF="../man2/stat.2.html">stat(2)</A></STRONG>, <STRONG><A HREF="../man2/umask.2.html">umask(2)</A></STRONG>.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
</BODY>
|
|
</HTML>
|