|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Calls mkdir(2)
NAME
mkdir - make a directory
SYNOPSIS
#include <sys/types.h>
#include <sys/stat.h>
int mkdir(const char *path, mode_t mode);
DESCRIPTION
The mkdir() function creates a new directory named by the
path name pointed to by path. The mode of the new directory
is initialized from mode (see chmod(2) for values of mode).
The protection part of the mode argument is modified by the
process's file creation mask (see umask(2)).
The directory's owner ID is set to the process's effective
user ID. The directory's group ID is set to the process's
effective group ID, or if the S_ISGID bit is set in the
parent directory, then the group ID of the directory is
inherited from the parent. The S_ISGID bit of the new
directory is inherited from the parent directory.
If path names a symbolic link, mkdir() fails and sets errno
to EEXIST.
The newly created directory is empty with the exception of
entries for itself (.) and its parent directory (..).
Upon successful completion, mkdir() marks for update the
st_atime, st_ctime and st_mtime fields of the directory.
Also, the st_ctime and st_mtime fields of the directory that
contains the new entry are marked for update.
RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1 is
returned, no directory is created, and errno is set to
indicate the error.
ERRORS
The mkdir() function will fail if:
EACCES Either a component of the path prefix denies
search permission or write permission is
denied on the parent directory of the direc-
tory to be created.
EDQUOT The directory where the new file entry is
being placed cannot be extended because the
user's quota of disk blocks on that file
SunOS 5.10 Last change: 29 Jul 2004 1
System Calls mkdir(2)
system has been exhausted; the new directory
cannot be created because the user's quota
of disk blocks on that file system has been
exhausted; or the user's quota of inodes on
the file system where the file is being
created has been exhausted.
EEXIST The named file already exists.
EFAULT The path argument points to an illegal
address.
EINVAL An attempt was made to create an extended
attribute that is a directory.
EIO An I/O error has occurred while accessing
the file system.
ELOOP Too many symbolic links were encountered in
translating path.
ELOOP A loop exists in symbolic links encountered
during resolution of the path argument.
EMLINK The maximum number of links to the parent
directory would be exceeded.
ENAMETOOLONG The length of the path argument exceeds
PATH_MAX, or the length of a path component
exceeds NAME_MAX while _POSIX_NO_TRUNC is in
effect.
ENOENT A component of the path prefix does not
exist or is a null pathname.
SunOS 5.10 Last change: 29 Jul 2004 2
System Calls mkdir(2)
ENOLINK The path argument points to a remote machine
and the link to that machine is no longer
active.
ENOSPC No free space is available on the device
containing the directory.
ENOTDIR A component of the path prefix is not a
directory.
EROFS The path prefix resides on a read-only file
system.
The mkdir() function may fail if:
ENAMETOOLONG As a result of encountering a symbolic link
in resolution of the path argument, the
length of the substituted pathname string
exceeded {PATH_MAX}.
EXAMPLES
Example 1: Create a directory.
The following example demonstrates how to create a directory
named /home/cnd/mod1, with read, write, and search permis-
sions for owner and group, and with read and search permis-
sions for others.
#include <sys/types.h>
#include <sys/stat.h>
int status;
...
status = mkdir("/home/cnd/mod1", S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH);
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.10 Last change: 29 Jul 2004 3
System Calls mkdir(2)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
| MT-Level | Async-Signal-Safe |
|_____________________________|_____________________________|
SEE ALSO
chmod(2), mknod(2), umask(2), mkdirp(3GEN), stat.h(3HEAD),
attributes(5), standards(5)
SunOS 5.10 Last change: 29 Jul 2004 4
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:27:02 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5323 hits)
(openSUSE 10.2)
svn man page (5164 hits)
(FreeBSD 6.2)
adv_cap_autoneg man page (4865 hits)
(Solaris 10 11_06)
CPAN man page (4602 hits)
(Suse Linux 10.1)
ssh man page (4337 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2839 hits)
(Solaris 10 11_06)
netcat man page (2687 hits)
(Suse Linux 10.1)
pprosetup man page (2472 hits)
(Solaris 10 11_06)
startproc man page (2452 hits)
(Suse Linux 10.1)
signal man page (2393 hits)
(Suse Linux 10.1)
|
Man Pages 
