MKDIR(2) Manuel du programmeur Linux MKDIR(2)
NOM
mkdir - Créer un répertoire.
SYNOPSIS
#include
#include
int mkdir(const char *pathname, mode_t mode);
DESCRIPTION
mkdir crée un nouveau répertoire nommé pathname.
mode spécifie les permissions à appliquer au répertoire. Cette valeur
peut être modifiée par le umask du processus : les permissions du
répertoire effectivement créé vaudront (mode & ~umask).
Le répertoire nouvellement créé aura pour propriétaire l'UID effectif
du processus. Si le répertoire au-dessus du nouveau répertoire a son
bit Set-GID à 1, ou si le système de fichier est monté avec une séman‐
tique de groupe BSD, le nouveau répertoire héritera de l'appartenance
au groupe de son parent. Sinon il appartiendra au groupe correspondant
au GID effectif du processus.
Si le répertoire parent a son bit Set-GID à 1, le nouveau répertoire
aura aussi son bit Set-GID à 1.
VALEUR RENVOYÉE
mkdir renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas errno con‐
tient le code d'erreur.
ERREURS
EPERM Le système de fichiers contenant pathname ne permet pas la
création de répertoires.
EEXIST pathname existe déjà (pas nécessairement un répertoire). Ceci
inclut le cas où pathname est un lien symbolique, pointant
quelque part ou pas.
EFAULT pathname pointe en-dehors de l'espace d'adressage accessible.
EACCES Le répertoire parent n'autorise pas l'écriture au processus, ou
l'un des répertoires de pathname n'autorise pas la consultation
de son contenu.
ENAMETOOLONG
pathname trop long.
ENOENT Un répertoire du chemin d'accès pathname n'existe pas ou est un
lien symbolique pointant nulle part.
ENOTDIR
Un élément utilisé dans le chemin pathname n'est pas un réper‐
toire.
ENOMEM Pas assez de mémoire pour le noyau.
EROFS pathname serait sur un système de fichier en lecture seule.
ELOOP pathname contient une référence circulaire (à travers un lien
symbolique).
ENOSPC Le périphérique contenant pathname n'a pas assez de place pour
le nouveau répertoire. Cette erreur se produit également si le
quota de disque de l'utilisateur est dépassé.
CONFORMITÉ
SVr4, POSIX, BSD, SYSV, X/OPEN, SVr4 indique des conditions d'erreur
supplémentaires EIO, EMULTIHOP, et ENOLINK. POSIX.1 omet ELOOP.
Il y a de nombreux problèmes avec le protocole sous-jacent à NFS, cer‐
tains d'entre-eux peuvent affecter mkdir.
VOIR AUSSI
mkdir(1), chmod(2), mknod(2), mount(2), rmdir(2), stat(2), umask(2),
unlink(2)
TRADUCTION
Christophe Blaess, 1996-2003.
LDP 18 juillet 2003 MKDIR(2)