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 surveillant unique associé à
pathname
pour cette instance inotify.
Si
pathname
n'était pas précédemment surveillé par cette instance inotify,
le descripteur de surveillant est nouvellement alloué.
Si
pathname
était déjà surveillé,
l'appel renvoie alors le descripteur du surveillant existant.
Le descripteur de surveillant 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 du système de fichiers ;
le descripteur de surveillant à l'intérieur de cette structure identifie
l'objet pour lequel l'événement est survenu.