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 un surveillant, ou en modifie un existant, sur le fichier dont
       le chemin est fournit 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  binaire  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,
       associé avec pathname, pour cette instance inotify. Si pathname n'était pas déjà surveillé
       par cette instance inotify, le descripteur de surveillance est alloué  par  le  noyau.  Si
       pathname était déjà surveillé, le descripteur de 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 cet événement
       a eu lieu.

VALEUR RENVOYÉE

       S'il  réussit,  inotify_add_watch() renvoie un descripteur de surveillance positif. En cas
       d'erreur, il renvoie -1 et remplit errno avec la valeur d'erreur.

ERREURS

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

       EBADF  Le descripteur de fichier est invalide.

       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 fd n'est pas
              un descripteur inotify.

       ENAMETOOLONG
              pathname est trop long.

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

       ENOMEM Pas assez de mémoire pour le noyau.

       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.

VERSIONS

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

CONFORMITÉ

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

VOIR AUSSI

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

COLOPHON

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

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».