DESCRIPTION.

Modifie le masque d'autorisation de création de fichier par l'utilisateur, et retourne l'ancien masque.

SYNTAXE.

Valeurs = os.umask ( masque )

Valeurs = ⇨ variable qui recevra la valeur retournée [ optionnel ]

os.strerror ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

masque ⇨ droits de l'utilisateur [ OBLIGATOIRE ]

REMARQUES.

masque doit être un int ( ), souvent exprimé sous forme octale, qui déterminera les permissions par complétion de 0o0666 (438 en décimal) pour les fichiers et de 0o0777 (511 en décimal) pour les répertoires qui seront créés ultérieurement par les appels systèmes creat() et mkdir(), c'est-à-dire que les permissions seront obtenues par l'opération binaire 0o0777 (ou 0o0666) AND NOT masque. Autrement dit, les bits du masque sont annulés, ce qui signifie que les droits correspondant à ces bits sont supprimés.

Le masque le plus courant est 0o0022 (18 en décimal). Il consiste à supprimer les droits d'écriture pour les membres du groupe et les autres sur les fichiers. Ces permissions correspondent à rw-r--r--, c'est-à-dire que le propriétaire du fichier a des droits en lecture et en écriture, tandis que les membres du groupe et les autres ne disposent que de la permission de lecture.

L'appel de la méthode os.umask ( ) retourne un int ( ) indiquant la valeur de masque avant son changement.

La fonction est un stub sur Emscripten et WASI, voir Plateformes WebAssembly pour plus d'informations.

EXEMPLE.

import os

kancien = os.umask ( 0o0043 )

print ( kancien )

kancien = os.umask ( kancien )

print ( kancien )