UMASK

Section : Manuel du programmeur Linux (2)
Mise à jour de la version anglaise : 9 janvier 2008
Index Menu principal  

NOM

umask - Fixer le masque de création de fichiers  

SYNOPSIS

#include <sys/types.h>
#include <sys/stat.h> mode_t umask(mode_t mask);  

DESCRIPTION

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

Ce masque est utilisé par open(2), mkdir(2) et d'autres appels système qui créent des fichiers pour positionner les permissions d'accès initiales sur les fichiers ou répertoires nouvellement créés. Les bits contenus dans le umask sont éliminés de l'argument mode des appels open(2) et mkdir(2).

Les constantes qui peuvent être utilisées pour définir mask sont décrites dans stat(2).

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


    S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH

(0666 en octal) lors de 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.  

CONFORMITÉ

SVr4, BSD 4.3, POSIX.1-2001.  

NOTES

Un processus fils créé avec fork(2) hérite de l'umask de son père. L'umask n'est pas modifié par execve(2).

La configuration de l'umask affecte également les permissions des objets IPC POSIX (mq_open(3), sem_open(3), shm_open(3)), FIFO (mkfifo(3)), et 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)  

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 15 octobre 1996 et révisée le 23 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 umask ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

 

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
CONFORMITÉ
NOTES
VOIR AUSSI
TRADUCTION

Dernière mise à jour : 23 juin 2008