NOM

       umask - Définir le masque de création de fichiers

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <sys/stat.h>

       mode_t umask(mode_t mask);

DESCRIPTION

       umask()  définit  le  masque de création de fichiers à la valeur mask & 0777 (c'est-à-dire
       seuls les bits relatifs aux permissions des fichiers de mask sont utilisés) et renvoie  la
       valeur précédente du masque.

       L'umask  est  utilisé  par  open(2),  mkdir(2)  et autres pour positionner les permissions
       d'accès initiales sur les fichiers ou répertoires nouvellement  créés.  Plus  précisément,
       les  bits  contenus  dans  l'umask  sont éliminés de l'argument mode de l'appel open(2) ou
       mkdir(2).

       Alternativement, si le répertoire parent a une ACL (liste de contrôle d'accès) par  défaut
       (consultez  acl(5)),  l'umask  est ignoré, l'ACL par défaut est héritée, les bits relatifs
       aux permissions sont réglés en se basant sur  l'ACL  héritée  et  les  bits  relatifs  aux
       permissions  absents  de  l'argument  mode  sont désactivés. Par exemple, l'ACL par défaut
       suivante est équivalente à un umask de 022 :

           u::rwx,g::r-x,o::r-x

       En combinant l'effet de cette ACL par défaut avec un argument mode  de  0666  (rw-rw-rw-),
       les permissions de fichier en résultant devraient être 0644 (rw-r--r--).

       Les constantes à utiliser pour indiquer mask sont décrites dans inode(7).

       La  valeur  par  défaut  typique pour l'umask d'un processus est S_IWGRP | S_IWOTH (022 en
       octal). Dans le cas général où l'argument mode de open(2) est indiqué comme :

           S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH

       (0666 en octal) à la création d'un nouveau fichier, les permissions sur  le  fichier  créé
       seront :

           S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH

       (car 0666 & ~022 = 0644, c'est-à-dire rw-r--r--).

VALEUR RENVOYÉE

       Cet appel système n'échoue jamais et la valeur précédente du masque est renvoyée.

STANDARDS

       POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

NOTES

       Un processus enfant créé par fork(2) hérite de l'umask de son parent. L'umask est conservé
       après un execve(2).

       Il est impossible d'utiliser  umask()  pour  récupérer  l'umask  d'un  processus  sans  le
       modifier  en  même  temps.  Un  second  appel à umask() devrait être alors nécessaire pour
       rétablir l'umask. Le  caractère  non  atomique  de  ces  deux  étapes  rend  possible  des
       conditions de concurrence dans un programme multithreadé.

       Depuis  Linux 4.7,  l'umask  d'un  processus  peut  être  vu  au  moyen  du champ Umask de
       /proc/pid/status. L'introspection de ce champ dans /proc/self/status permet à un processus
       de récupérer son umask sans le modifier en même temps.

       La  configuration  de  l'umask  affecte également les permissions assignées aux objets IPC
       POSIX (mq_open(3), sem_open(3), shm_open(3)), FIFO (mkfifo(3)) et aux sockets  de  domaine
       UNIX  (unix(7))  créés  par le processus. L'umask n'affecte pas les permissions des objets
       IPC System V créés par le processus (en utilisant msgget(2), semget(2), shmget(2)).

VOIR AUSSI

       chmod(2), mkdir(2), open(2), stat(2), acl(5)

TRADUCTION

       La traduction française de cette  page  de  manuel  a  été  créée  par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,  Stéphan  Rafin  <stephan.rafin@laposte.net>, Thierry
       Vignaud <tvignaud@mandriva.com>, François Micaux, Alain  Portal  <aportal@univ-montp2.fr>,
       Jean-Philippe    Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-
       luc.coulon@wanadoo.fr>,   Julien    Cristau    <jcristau@debian.org>,    Thomas    Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>,  Denis
       Barbier  <barbier@debian.org>,  David  Prévot  <david@tilapin.org>  et  Jean-Pierre Giraud
       <jean-pierregiraud@neuf.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  concernant  les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.