NOM

       setxattr, lsetxattr, fsetxattr - Définir les attributs étendus

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <sys/xattr.h>

       int setxattr(const char *chemin, const char *nom,
                     const void valeur[.taille], size_t taille, int flags);
       int lsetxattr(const char *chemin, const char *nom,
                     const void valeur[.taille], size_t taille, int flags);
       int fsetxattr(int descripteur, const char *nom,
                     const void valeur[.taille], size_t taille, int flags);

DESCRIPTION

       Les  attributs  étendus  sont  des  paires  nom:valeur associées aux inœuds (fichiers, répertoires, liens
       symboliques, etc.). Ce sont des extensions des attributs normaux qui sont associés avec tous  les  inœuds
       du  système  (les  informations  renvoyées par stat(2). Une description complète des concepts d'attributs
       étendus est disponible dans xattr(7).

       setxattr() positionne la valeur de l'attribut étendu identifié par le nom et associé avec le chemin  dans
       le  système  de  fichiers.  Le  paramètre  taille indique la taille (en octets) de valeur ; une valeur de
       taille 0 est autorisée.

       lsetxattr()  est identique à setxattr(), sauf dans le cas d'un lien symbolique,  où  il  traite  le  lien
       lui-même et non le fichier qu'il vise.

       fsetxattr()   est  identique à setxattr(), seulement on écrit l'attribut du fichier ouvert indiqué par le
       descripteur (renvoyé par open(2)) plutôt que par un chemin.

       Le nom d'un attribut étendu est une simple chaîne terminée par un octet nul. Le  nom  inclut  un  préfixe
       d'espace  de  noms - il peut y avoir plusieurs espaces de noms disjoints associés avec un inœud donné. La
       valeur d'un attribut étendu est un bloc de données littérales ou binaires d'une longueur donnée.

       Par défaut (c'est-à-dire quand options vaut zéro), l'attribut étendu sera créé s'il n'existe  pas  ou  la
       valeur  sera  remplacée  s'il  existe  déjà.  Pour modifier ces sémantiques, vous pouvez modifier une des
       valeurs suivantes dans options :

       XATTR_CREATE
              Effectuer une création pure, ce qui échoue si l'attribut nommé existe déjà.

       XATTR_REPLACE
              Effectuer une opération de remplacement pure, ce qui échoue si l'attribut nommé n'existe pas.

VALEUR RENVOYÉE

       S'ils réussissent, ces appels renvoient zéro. En cas d'échec, ils renvoient -1 et  errno  est  positionné
       pour indiquer l'erreur.

ERREURS

       EDQUOT Les limites de quota de disque indiquaient un espace insuffisant pour stocker l'attribut étendu.

       EEXIST XATTR_CREATE a été indiqué et l'attribut existe déjà.

       ENODATA
              XATTR_CREATE a été indiqué et l'attribut n'existe pas.

       ENOSPC Il n'y a pas suffisamment d'espace pour stocker l'attribut étendu.

       ENOTSUP
              Le préfixe de l'espace de noms de pathname n'est pas valable.

       ENOTSUP
              Les attributs étendus ne sont pas pris en charge par le système de fichiers ou sont désactivés,

       EPERM  Le fichier est indiqué comme immuable ou uniquement complétable (voir FS_IOC_SETFLAGS(2const)).

       De plus, les erreurs documentées dans stat(2) peuvent aussi survenir.

       ERANGE La taille de nom ou de valeur dépasse une limite spécifique au système de fichiers.

STANDARDS

       Linux.

HISTORIQUE

       Linux 2.4, glibc 2.3.

VOIR AUSSI

       getfattr(1),  setfattr(1),  getxattr(2),  listxattr(2),  open(2),  removexattr(2),  stat(2),  symlink(7),
       xattr(7)

TRADUCTION

       La  traduction  française   de   cette   page   de   manuel   a   été   créée   par   Christophe   Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>, François Micaux, Alain Portal  <aportal@univ-montp2.fr>,  Jean-Philippe  Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,     Thomas     Huriaux      <thomas.huriaux@gmail.com>,      Nicolas      François
       <nicolas.francois@centraliens.net>,     Florentin     Duneau    <fduneau@gmail.com>,    Simon    Paillard
       <simon.paillard@resel.enst-bretagne.fr>,    Denis    Barbier    <barbier@debian.org>,    David     Prévot
       <david@tilapin.org> et Jean-Philippe MENGUAL <jpmengual@debian.org>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel,  veuillez  envoyer  un  message  à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                    13 juin 2024                                       setxattr(2)