mknod(2) System Calls Manual mknod(2) NOM mknod, mknodat - Creer un fichier special ou ordinaire BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include int mknod(const char *nom_chemin, mode_t mode, dev_t dev); #include /* Definition des constantes AT_* */ #include int mknodat(int dirfd, const char *nom_chemin, mode_t mode, dev_t dev); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : mknod() : _XOPEN_SOURCE >= 500 || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE DESCRIPTION mknod() cree un noeud du systeme de fichiers (fichier, fichier special de peripherique ou tube nomme) appele nom_chemin, avec les attributs mode et dev. L'argument mode definit a la fois les permissions d'utilisation, et le type de noeud a creer. C'est une combinaison (en utilisant une operation OU bit a bit) entre l'un des types de fichier ci-dessous et aucun ou plusieurs bits de mode de fichier listes dans inode(7). Le mode du fichier est modifie par le umask du processus de maniere habituelle : en l'absence de liste de controle d'acces (ACL) par defaut, les permissions du noeud cree sont (mode & ~umask). Le type de noeud doit etre l'un des suivants S_IFREG, S_IFCHR, S_IFBLK, S_IFIFO ou S_IFSOCK pour indiquer respectivement un fichier regulier (vide a la creation), un fichier special mode caractere, un fichier special mode bloc, un tube nomme (FIFO) ou un socket du domaine UNIX. Un type de fichier egal a zero est equivalent a S_IFREG. Si le type de fichier est S_IFCHR ou S_IFBLK alors dev doit indiquer les numeros majeur et mineur du fichier special nouvellement cree (makedev(3) peut etre utile pour construire la valeur de dev). Pour les autres types de fichier, dev est ignore. Si nom_chemin existe deja, ou est un lien symbolique, l'appel echoue avec l'erreur EEXIST. Le noeud nouvellement cree aura pour proprietaire l'UID effectif du processus. Si le repertoire contenant ce noeud a son bit Set-GID defini, ou si le systeme de fichiers est monte avec une semantique de groupe BSD, le nouveau noeud heritera de la propriete de groupe de son repertoire parent. Sinon il appartiendra au GID effectif du processus. mknodat() L'appel systeme mknodat() agit exactement de la meme facon que mknod(2), aux differences suivantes pres. Si le chemin donne dans nom_chemin est relatif, il est interprete par rapport au repertoire reference par le descripteur de fichier dirfd (plutot que par rapport au repertoire courant de travail du processus appelant, comme le fait mknod() pour un chemin relatif). Si nom_chemin est un chemin relatif et si dirfd est la valeur speciale AT_FDCWD, nom_chemin est interprete comme etant relatif au repertoire courant du processus appelant, comme mknod(). Si pathname est absolu, alors dirfd est ignore. Consultez openat(2) pour une explication de la necessite de mknodat(). VALEUR RENVOYEE mknod() et mknodat() renvoient 0 s'ils reussissent. En cas d'erreur, la valeur de retour est -1 et errno est defini pour preciser l'erreur. ERREURS EACCES Le repertoire parent n'autorise pas l'ecriture au processus, ou l'un des repertoires dans le chemin d'acces a nom_chemin n'autorise pas la consultation de son contenu. (Consultez aussi path_resolution(7).) EBADF ((mknodat())) pathname est relatif mais dirfd n'est ni AT_FDCWD ni un descripteur de fichier valable. EDQUOT Le quota de blocs de disque ou d'inoeuds de l'utilisateur sur le systeme de fichiers a ete atteint. EEXIST nom_chemin existe deja. Cela inclut le cas ou nom_chemin est un lien symbolique, pouvant pointer nulle part. EFAULT nom_chemin pointe en dehors de l'espace d'adressage accessible. EINVAL mode demande la creation d'autre chose qu'un fichier regulier, fichier special de peripherique, FIFO ou socket. ELOOP Trop de liens symboliques ont ete rencontres en parcourant nom_chemin. ENAMETOOLONG nom_chemin est trop long. ENOENT Un des repertoires du chemin d'acces nom_chemin n'existe pas ou est un lien symbolique pointant nulle part. ENOMEM La memoire disponible du noyau n'etait pas suffisante. ENOSPC Le peripherique contenant nom_chemin n'a pas assez de place pour le nouveau noeud. ENOTDIR Un element, utilise comme repertoire, du chemin d'acces nom_chemin n'est pas en fait un repertoire. ENOTDIR (mknodat()) pathname est relatif et dirfd est un descripteur de fichier faisant reference a un fichier qui n'est pas un repertoire. EPERM mode demande la creation de quelque chose d'autre qu'un fichier regulier, une FIFO (tube nomme) ou un socket du domaine UNIX, alors que le processus appelant n'est pas privilegie (sous Linux : n'a pas la capacite CAP_MKNOD). Cette erreur se produit egalement si le systeme de fichiers contenant nom_chemin ne gere pas les noeuds du type demande. EROFS pathname est place sur un systeme de fichiers en lecture seule. VERSIONS POSIX.1-2001 dit : << Le seul usage portable de mknod() est reserve a la creation de fichiers speciaux FIFO. Si le mode n'est pas S_IFIFO ou si dev n'est pas 0, alors le comportement de mknod() est indetermine >>. Toutefois, aujourd'hui, on ne devrait jamais utiliser mknod() pour cela ; on devrait utiliser mkfifo(3), une fonction specialement concue pour cela. Sous Linux, mknod() ne peut pas etre utilise pour creer des repertoires. Il faut creer les repertoires avec mkdir(2). STANDARDS POSIX.1-2008. HISTORIQUE mknod() SVr4, 4.4BSD, POSIX.1-2001 (mais voir VERSIONS). mknodat() Linux 2.6.16, glibc 2.4. POSIX.1-2008. NOTES Il y a de nombreux problemes avec le protocole sous-jacent a NFS, certains d'entre eux pouvant affecter mknod() et mknodat(). VOIR AUSSI mknod(1), chmod(2), chown(2), fcntl(2), mkdir(2), mount(2), socket(2), stat(2), umask(2), unlink(2), makedev(3), mkfifo(3), acl(5), path_resolution(7) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot , Cedric Boutillier , Frederic Hantrais et Jean-Philippe MENGUAL Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 mknod(2)