MKDIR(2) Manuel du programmeur Linux MKDIR(2)
NOM
mkdir - Créer un répertoire.
SYNOPSIS
#include <sys/types.h>
#include <fcntl.h>
#include <unistd.h>
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éé vau
dront (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émantique 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 contient le code d'erreur.
ERREURS
EEXIST pathname existe déjà (pas nécessairement un réper
toire).
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épertoire.
Linux 10 Décembre 1997 1
MKDIR(2) Manuel du programmeur Linux MKDIR(2)
ENOMEM Pas assez de mémoire pour le noyau.
EROFS pathname serait sur un système de fichier en lec
ture 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'util
isateur est dépassé.
CONFORMITÉ
SVr4, POSIX, BSD, SYSV, X/OPEN, SVr4 indique des condi
tions 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, certains d'entre-eux peuvent affecter mkdir.
VOIR AUSSI
read(2), write(2), fcntl(2), close(2), unlink(2), open(2),
mknod(2), stat(2), umask(2), mount(2), socket(2),
fopen(3).
TRADUCTION
Christophe Blaess, 1997.
Linux 10 Décembre 1997 2