DESCRIPTION.

Modifie le propriétaire, et le groupe d'utilisateurs propriétaire d'un fichiers ou d'un répertoire.

SYNTAXE.

os.chown ( chemin , utilisateur , groupe , * , descripteur , symbolique )

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

chemin ⇨ identification de l'entité [ OBLIGATOIRE ]

utilisateur ⇨ identification d'un utilisateur [ OBLIGATOIRE ]

groupe ⇨ identification d'un groupe d'utilisateurs [ OBLIGATOIRE ]

* ⇨ autres options [ optionnel ]

descripteur ⇨ descripteur de fichier [ optionnel ]

symbolique ⇨ liens symboliques [ optionnel ]

REMARQUES.

chemin doit être un str ( ) identifiant de façon absolue ou relative un chemin d'un répertoire ou d'un fichier.

utilisateur doit être un int ( ) valide, correspondant à un utilisateur. 

groupe doit être un int ( ) valide, correspondant à un groupe d'utilisateur. 

descripteur est un attribut nommé par dir_fd = valeur, où valeur doit être un int ( ) identifiant un descripteur de fichier valide, ou None, valeur par défaut. descripteur n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

symbolique est un attribut nommé par follow_symlinks = valeur, où valeur doit être un bool ( ) symbolique n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. Si valeur vaut :

- True, valeur par défaut, os.chown ( ) opère sur le fichier pointé par chemin ; 

- False, et que le dernier élément du chemin est un lien symbolique, os.chown ( ) teste le lien symbolique et non le fichier.

La méthode os.chown ( ) n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

L'appel de la méthode os.chown ( ) modifie l'identifiant numérique de l'utilisateur propriétaire, et du groupe d'utilisateurs, de chemin. Pour laisser inchangé l'un de ces identifiants, il faut lui donner la valeur -1.

L'utilisation de la méthode os.chown ( ) doit être réservée pour la gestion des entrées / sorties de bas niveau. Pour tous les autres usages, il faut recourir à la méthode de plus haut niveau shutil.chown ( ) , du module shutil de la bibliothèque standard, qui accepte les identifiants sous forme de str ( ) pour les noms en plus des identifiants de type int ( ).

EXEMPLE.

import os

os.chown ( "votre fichier.txt" , 1010 , 2310 )