NOM

       inotify_add_watch - Ajouter une surveillance à une instance inotify déjà initialisée

SYNOPSIS

       #include <sys/inotify.h>

       int inotify_add_watch(int fd, const char *pathname, uint32_t mask);

DESCRIPTION

       inotify_add_watch()  ajoute  une surveillance, ou en modifie une existante, sur le fichier
       dont le chemin est fourni dans pathname ; l'appelant doit avoir la permission  de  lecture
       sur ce fichier. L'argument fd est un descripteur de fichier référençant l'instance inotify
       dont la liste de surveillance doit être modifiée. Les événements à surveiller sur pathname
       sont  indiqués  dans  l'argument  de  masque  de  bits mask. Consultez inotify(7) pour une
       description des bits qui peuvent être positionnés dans mask.

       Un appel réussi à inotify_add_watch() renvoie un descripteur de surveillance  unique  pour
       cette  instance  inotify,  pour  l’objet  (inode)  de système de fichiers qui correspond à
       pathname. Si l’objet de système de fichiers n'était pas déjà surveillé par cette  instance
       inotify,  le descripteur de surveillance est alloué par le noyau. Si l’objet de système de
       fichiers était déjà surveillé (peut-être à l’aide d’un lien différent vers le même objet),
       alors le descripteur pour la surveillance existante est renvoyé.

       Le  descripteur  de  surveillance  est  renvoyé par des appels ultérieurs à read(2) sur le
       descripteur de fichier  inotify.  Ces  lectures  renvoient  des  structures  inotify_event
       (consultez   inotify(7))  indiquant  des  événements  sur  le  système  de  fichiers ;  le
       descripteur de surveillance de cette structure identifie l'objet pour lequel un  événement
       a eu lieu.

VALEUR RENVOYÉE

       S'il  réussit,  inotify_add_watch()  renvoie  un  descripteur  de  surveillance (un entier
       positif). En cas d'erreur, il renvoie -1 et positionne errno pour indiquer l'erreur.

ERREURS

       EACCES L'accès en lecture au fichier indiqué est interdit.

       EBADF  Le descripteur de fichier n’est pas valable.

       EEXIST mask contient IN_MASK_CREATE et pathname se rapporte à un  fichier  déjà  surveillé
              par le même fd.

       EFAULT pathname pointe en dehors de l'espace d'adressage accessible.

       EINVAL Le  masque  d'événements  indiqué  ne  contient  aucun  événement valable ; ou mask
              contient à la fois IN_MASK_ADD et IN_MASK_CREATE ; ou fd n'est pas  un  descripteur
              de fichier inotify.

       ENAMETOOLONG
              nom_chemin est trop long.

       ENOENT Un  des  répertoires  du  chemin  d'accès  nom_chemin  n'existe  pas ou est un lien
              symbolique pointant nulle part.

       ENOMEM La mémoire disponible du noyau n'était pas suffisante.

       ENOSPC La limite sur le nombre total  de  surveillances  inotify  pour  l'utilisateur  est
              atteinte, ou le noyau n'a pas pu allouer une ressource système nécessaire.

       ENOTDIR
              mask contient IN_ONLYDIR et pathname n’est pas un répertoire.

VERSIONS

       Inotify a été intégré dans Linux 2.6.13.

CONFORMITÉ

       Cet appel système est spécifique à Linux.

EXEMPLES

       Consultez inotify(7).

VOIR AUSSI

       inotify_init(2), inotify_rm_watch(2), inotify(7)

COLOPHON

       Cette  page  fait partie de la publication 5.13 du projet man-pages Linux. Une description
       du projet et des instructions pour signaler des anomalies et la dernière version de  cette
       page peuvent être trouvées à l'adresse https://www.kernel.org/doc/man-pages/.

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  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   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⟩.