INOTIFY_ADD_WATCH

Section : Manuel du programmeur Linux (2)
Mise à jour de la version anglaise : 7 février 2006
Index Menu principal

NOM

inotify_add_watch - Ajouter une surveillance à une instance inotify 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 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 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 le descripteur de surveillance unique associé à pathname pour cette instance inotify. Si pathname n'était pas déjà surveillé par cette instance inotify, le descripteur de surveillance est nouvellement alloué. Si pathname était déjà surveillé, l'appel renvoie alors le descripteur de la surveillance existante.

Le descripteur de surveillance est renvoyé par des lectures (read(2)) ultérieures du descripteur de fichier inotify. Ces lectures extraient les structures inotify_event voir inotify(7)) indiquant les événements sur le système de fichiers ; le descripteur de surveillance à l'intérieur de cette structure identifie l'objet pour lequel l'événement est survenu.

VALEUR RENVOYÉE

S'il réussit, inotify_add_watch() renvoie un descripteur de surveillance non négatif. S'il échoue, il renvoie -1 et renseigne errno en conséquence.

ERREURS

EACCES: L'accès en lecture au fichier fourni n'est pas autorisé.
EBADF: Le descripteur de fichier fourni n'est pas valide.
EFAULT: pathname pointe en dehors de l'espace d'adressage accessible du processus.
EINVAL: Le masque d'événements fourni ne contient aucun événement valide ; ou fd n'est pas un descripteur de fichier inotify.
ENOMEM: Mémoire insuffisante pour le noyau.
ENOSPC: La limite sur le nombre total de surveillances inotify par utilisateur a été atteinte ou le noyau n'a pas pu allouer une ressource système nécessaire.

VERSIONS

Inotify a été intégré au noyau Linux 2.6.13.

CONFORMITÉ

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

VOIR AUSSI

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

TRADUCTION

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 21 juillet 2006 et révisée le 23 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 inotify_add_watch ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 23 juin 2008