mkdir() -- create new directory

SYNOPSIS

#include <sys/types.h>

#include <sys/stat.h>

int mkdir(const char *pathname, mode_t mode);

The mkdir() function creates a new directory with the specified path name. The file permissions of the new directory are initialized from the specified mode. The file permission bits of the mode argument are modified by the process' file creation mask. When bits in the specified mode other than the file permission bits are set, the behavior is undefined.

The directory's user ID is set to the process' effective user ID. The directory's group ID is set to the group ID of the parent directory or to the effective group ID of the process.

The newly-created directory is an empty directory.

Upon successful completion, mkdir() marks for update the st_atime, st_ctime and st_mtime fields of the directory.

PARAMETERS

pathname: Specifies the name of the new directory. The path name can be absolute or relative. If the specified path name is relative, the directory is created based upon your current working directory.
mode: Is a bitwise-OR field that specifies what permissions the directory has when it is created.

RETURN VALUES

If successful, mkdir() returns a value of zero. On failure, it returns a value of -1, does not create a directory, and sets errno to one of the following values:

EACCES: Search permission is denied on a component of the path name prefix or write permission is denied on the parent directory of the directory to be created.
EEXIST: The named file already exists.
EFAULT: pathname is an invalid pointer.
EIO: While accessing the file system, an I/O error occurred.
EMLINK: The link count of the parent directory exceeds LINK_MAX.
ENAMETOOLONG: The length of the pathname parameter exceeds PATH_MAX or a path name component is longer than NAME_MAX.
ENOENT: A component of the path name prefix does not exist or is a null path name.
ENOSPC: The file system does not contain enough space to hold the contents of the new directory or to extend the parent directory of he new directory.
ENOTDIR: A component of the path name prefix is not a directory.
EROFS: The parent directory of the directory being created resides on a read-only file system.

CONFORMANCE

POSIX.1 (1996)

MULTITHREAD SAFETY LEVEL

Async-signal-safe.

PORTING ISSUES

Directory names are treated as multibyte sequences and are converted to UNICODE before passing to Win32. The conversion is either performed based on the current thread locale, set using uselocale() or the process locale as set by a call to setlocale(), and overridden by _NutConf() _NC_SET_ANSI_LOCALE and _NC_SET_UTF8_LOCALE options. Under all other conditions, the multibyte sequences are considered to be from the ANSI code page for the current windows system locale.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

mkdir()
create new directory

Function