DESCRIPTION.

Modifie la valeur d'un l'attribut étendu, en le créant si besoin, d'un fichier.

SYNTAXE.

os.setxattr ( fichier , attribut , valeur , option , * , symbolique )

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

fichier ⇨ emplacement à scruter [ OBLIGATOIRE ]

attribut ⇨ attribut étendu du fichier [ OBLIGATOIRE ]

valeur ⇨ nouvelle valeur [ OBLIGATOIRE ]

option ⇨ type d'opération [ optionnel ]

* ⇨ autres options [ optionnel ]

symbolique ⇨ lien symbolique [ optionnel ]

REMARQUES.

fichier doit être un str ( ) correspondant à un nom de fichier valide.

attribut doit être un str ( ) ou un bytes ( ) correspondant à un nom d'attribut étendu du système de fichier. Si attribut est un str ( ), il doit être encodé avec le système d'encodage correspondant au système de fichier de l'os.

valeur doit être un bytes ( ) quelconque mais valide.

option doit l'une des valeurs suivante :

- os.XATTR_CREATE, indique de créer l'attribut étendu ;

- os.XATTR_REPLACE, indique de remplacer l'attribut étendu ;

- os.XATTR_SIZE_MAX, indique la taille maximum de l'attribut étendu, 64 Kio actuellement.

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.walk ( ) opère sur le fichier pointé par chemin ; 

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

La méthode os.setxattr ( ) n'est disponible que pour Linux. 

L'identifiant de l'utilisateur doit pointer sur un utilisateur disposant des droits nécessaires, du super utilisateur, pour utiliser cette méthode.

Les  attributs  étendus  sont  des  paires  nom:valeur associées de façon permanente à desfichiers ou des répertoires, de manière similaire aux chaînes d’environnement associées  à un processus. Un attribut peut être défini ou non. S’il l’est, sa valeur peut être absente ou non.

Les attributs étendus sont des extensions aux attributs normaux qui sont associés  à  tous les inœuds (inode) du système (c’est-à-dire les données stat(2)). Il sont souvent utilisés pour fournir des fonctionnalités supplémentaires à un système de  fichiers,  par  exemple, des  fonctions  de  sécurité  telles que les listes de contrôle d’accès (ACL) peuvent être mises en œuvre en utilisant les attributs étendus.  voir le manuel de linux pour plus de détails sur les attributs étendu. '(cf.: manuel de Linux)

Voir le manuel de Linux pour plus de détails sur les attributs étendus ...

Voir os.listxattr ( ) pour connaitre la liste des attributs étendus disponibles.

Voir os.getxattr ( ) pour connaitre la valeur affectée à un attribut étendu.

Voir os.removexattr ( ) pour supprimer un attribut étendu.

EXEMPLE.

import os

kfichier = "/home/origine/Documents/TextePourTest.txt"

os.setxattr ( ktravail , "etenduA" , b"valeurA" ,  os.XATTR_CREATE )

os.setxattr ( ktravail , "etenduB" , b"valeurB" ,  os.XATTR_CREATE )

print ( os.listxattr ( ktravail ) )

print ( os.getxattr ( ktravail , "etenduA" ) )

print ( os.getxattr ( ktravail , "etenduB" ) )

os.removexattr ( ktravail , "etenduB" ) 

print ( os.listxattr ( ktravail ) )