Provided by: manpages-fr-dev_3.23.1-1_all bug

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  spécifiés  dans  l’argument  masque  de bits mask. Voir
       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 (voir 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.

       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.23 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

       Cette page de manuel a été traduite  et  mise  à  jour  par  Christophe
       Blaess  <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
       Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et  mise  à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

       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> ».