Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       inotify_add_watch  -  Ajouter  une  surveillance a une instance inotify
       deja initialisee

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 referencant l'instance inotify dont la liste
       de surveillance doit etre modifiee. Les  evenements  a  surveiller  sur
       pathname  sont specifies dans l'argument masque de bits mask. Consultez
       inotify(7) pour une description des bits qui peuvent  etre  positionnes
       dans mask.

       Un  appel  reussi  a  inotify_add_watch()  renvoie  un  descripteur  de
       surveillance  unique,  associe  avec  pathname,  pour  cette   instance
       inotify.  Si  pathname  n'etait  pas  deja surveille par cette instance
       inotify, le descripteur de surveillance est alloue  par  le  noyau.  Si
       pathname  etait  deja  surveille,  le  descripteur  de  la surveillance
       existante est renvoye.

       Le descripteur de surveillance est renvoye par des appels ulterieurs  a
       read(2)  sur  le descripteur de fichier inotify. Ces lectures renvoient
       des  structures  inotify_event  (consultez  inotify(7))  indiquant  des
       evenements  sur le systeme de fichiers ; le descripteur de surveillance
       de cette structure identifie l'objet pour lequel  cet  evenement  a  eu
       lieu.

VALEUR RENVOY'EE

       S'il   reussit,   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'acces en lecture au fichier indique est interdit.

       EBADF  Le descripteur de fichier est invalide.

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

       EINVAL Le  masque  d'evenements  indique  ne  contient  aucun evenement
              valable, ou fd n'est pas un descripteur inotify.

       ENOMEM Pas assez de memoire 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 systeme necessaire.

VERSIONS

       Inotify a ete integre dans Linux 2.6.13.

CONFORMIT'E

       Cet appel systeme est specifique a Linux.

VOIR AUSSI

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

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

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

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

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

Linux                           7 fevrier 2006            INOTIFY_ADD_WATCH(2)