attr - attributs étendus sur les objets du système de fichiers XFS
attr [ -LRSq ] -s attrname [ -V attrvalue ] pathname
attr [ -LRSq ] -g attrname pathname
attr [ -LRSq ] -r attrname pathname
attr [ -LRSq ] -l pathname
Les attributs étendus implémentent la possibilité pour un utilisateur d'attacher des paires nom:valeur à des objets dans le système de fichiers XFS.
Ce document décrit la commande attr, qui est principalement compatible avec la commande IRIX du même nom. Il s'adresse donc spécifiquement aux utilisateurs du système de fichiers XFS - pour la manipulation des attributs étendus indépendants du système de fichiers, consultez la documentation getfattr(1) et setfattr(1).
Les attributs étendus peuvent être utilisés pour stocker des méta-informations sur le fichier. Par exemple, "character-set=kanji" pourrait indiquer à un navigateur de documents d'utiliser le jeu de caractères Kanji lors de l'affichage de ce document et "thumbnail=..." pourrait fournir un aperçu à résolution réduite d'une image graphique haute résolution.
Dans le système de fichiers XFS, les noms peuvent avoir une longueur maximale de 256 octets, terminés par le premier 0 octet. L'intention est qu'il s'agisse de noms imprimables ASCII (ou d'un autre jeu de caractères) pour l'attribut. Les valeurs peuvent représenter jusqu'à 64 Ko de données binaires arbitraires.
Les attributs peuvent être attachés à tous les types d'inodes XFS : fichiers réguliers, répertoires, liens symboliques, nœuds de périphérique, etc.
XFS utilise 2 espaces de noms d'attribut disjoints associés à chaque objet du système de fichiers. Il s'agit des espaces d'adressage racine et utilisateur. L'espace d'adressage root n'est accessible qu'au superutilisateur, et uniquement en spécifiant un argument flag à l'appel de fonction. Les autres utilisateurs ne verront pas ou ne pourront pas modifier les attributs dans l'espace d'adressage racine. L'espace d'adressage de l'utilisateur est protégé par le mécanisme normal des autorisations de fichiers, de sorte que le propriétaire du fichier peut décider qui peut voir et/ou modifier la valeur des attributs sur un fichier particulier.
L'utilitaire attr permet la manipulation des attributs étendus associés aux objets du système de fichiers à partir de scripts shell.
Il y a quatre opérations principales que attr peut effectuer :
L'option -g attrname indique à attr de rechercher l'objet nommé et d'imprimer (sur stdout) la valeur associée à ce nom d'attribut. Avec le drapeau -q, stdout sera exactement et uniquement la valeur de l'attribut, adapté au stockage directement dans un fichier ou au traitement via une commande canalisée.
L'option -l indique à attr de lister les noms de tous les attributs associés à l'objet, et le nombre d'octets dans la valeur de chacun de ces attributs. Avec le drapeau -q, stdout sera une simple liste des seuls noms d'attributs, un par ligne, convenant à l'entrée dans un script.
L'option -r attrname indique à attr de supprimer un attribut avec le nom donné de l'objet si l'attribut existe. Il n'y a pas de sortie en cas de réussite.
L'option -s attrname indique à attr de définir l'attribut nommé de l'objet sur la valeur lue depuis stdin. Si un attribut portant ce nom existe déjà, sa valeur sera remplacée par celle-ci. Si un attribut portant ce nom n'existe pas déjà, un sera créé avec cette valeur. Avec l'indicateur -V attrvalue, l'attribut sera défini pour avoir une valeur de attrvalue et stdin ne sera pas lu. Avec le drapeau -q, stdout ne sera pas utilisé. Sans le drapeau -q, un message indiquant le nom de l'attribut et la valeur entière sera imprimé.
Lorsque l'option -L est donnée et que l'objet nommé est un lien symbolique, opérer sur les attributs de l'objet référencé par le lien symbolique. Sans cette option, opérer sur les attributs du lien symbolique lui-même.
Lorsque l'option -R est donnée et que le processus dispose des privilèges appropriés, opérez dans l'espace de noms d'attribut root plutôt que dans l'espace de noms d'attribut USER.
L'option -S est similaire, sauf qu'elle spécifie l'utilisation de l'espace de noms d'attribut security.
Lorsque l'option -q est donnée, attr essaiera de se taire. Il affichera des messages d'erreur (sur stderr) mais n'imprimera pas de messages d'état (sur stdout).
Les programmes standard d'échange/d'archivage de fichiers tar(1) et cpio(1) n'archiveront ni ne restaureront les attributs étendus, tandis que xfsdump( 8) le programme sera.
L'option de liste présente dans la version IRIX de cette commande n'est pas prise en charge. getfattr fournit un mécanisme pour récupérer tous les noms d'attributs.
Andreas Gruenbacher, <andreas.gruenbacher@gmail.com> et l'équipe de développement SGI XFS, <linux-xfs@oss.sgi.com>.
Veuillez envoyer vos rapports de bogues ou commentaires à <https://savannah.nongnu.org/bugs/?group=attr> ou <acl-devel@nongnu.org> .
getfattr(1), setfattr(1), attr_get(3), attr_set(3), attr_multi(3), attr_remove(3), attr(5), xfsdump(8)