Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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)