Section courante

A propos

Section administrative du site

FANOTIFY_MARK

Marque le fanotify
  sys/fanotify.h

Syntaxe

int fanotify_mark(int fanotify_fd, unsigned int flags, uint64_t mask, int dirfd, const char *pathname);

Paramètres

Nom Description
fanotify_fd Ce paramètre permet d'indiquer l'identificateur de descripteur de fichier,
flags Ce paramètre permet d'indiquer la modification a effectuer :
Constante Description
FAN_MARK_ADD Cette constante permet d'indiquer que l'événement dans le paramètre mask doit être ajouter à la marque de masque (ou ignoré du masque). La valeur du paramètre mask ne doit pas être vide car sinon une erreur EINVAL se produira.
FAN_MARK_REMOVE Cette constante permet d'indiquer que l'événement dans le paramètre mask doit être enlevé de la marque de masque (ou ignoré du masque). La valeur du paramètre mask ne doit pas être vide car sinon une erreur EINVAL se produira.
FAN_MARK_FLUSH Cette constante permet de supprimer toutes les marques de montage ou toutes les marques non montées du groupe fanotify. Si le paramètre flags contient FAN_MARK_MOUNT, alors toutes les marques des montages sont supprimées du groupe, sinon toutes les marques pour les répertoires et les fichiers sont supprimées. Aucun autre drapeau que FAN_MARK_FLUSH ne peut être utilisé conjointement avec FAN_MARK_FLUSH, sinon il est ignoré.
On peut combiné à un opérateur «Ou» les valeurs plus hauts avec les valeurs suivantes :
FAN_MARK_DONT_FOLLOW Cette constante permet d'indiquer qu'il faut marquez le lien lui-même, plutôt que le fichier auquel il se rapporte si pathname est un lien symbolique.
FAN_MARK_ONLYDIR Cette constante permet d'indiquer qu'il faut déclencher l'erreur ENOTDIR si l'objet du système de fichiers à marquer n'est pas un répertoire.
FAN_MARK_MOUNT Cette constante permet d'indiquer qu'il faut marquez le point de montage spécifié par le chemin d'accès. Si pathname n'est pas lui-même un point de montage, le point de montage contenant le chemin d'accès sera marqué. Tous les répertoires, sous-répertoires et les fichiers contenus du point de montage seront surveillés.
FAN_MARK_IGNORED_MASK Cette constante permet d'indiquer que les événements dans le masque doivent être ajoutés ou supprimés du masque ignoré.
FAN_MARK_IGNORED_SURV_MODIFY Cette constante permet d'indiquer qu'il faut que le masque ignoré survivre aux événements de modification. Si ce drapeau n'est pas défini, le masque ignoré est effacé lorsqu'un événement de modification se produit pour le fichier ou le répertoire ignoré.
mask Ce paramètre permet d'indiquer les options d'événement :
Constante Description
FAN_ACCESS Cette constante permet de créer un événement quand un fichier ou un répertoire est accessible. Peu contenir des bogues ou des mauvais fonctionnement.
FAN_MODIFY Cette constante permet de créer un événement quand un fichier est modifié (écrit).
FAN_CLOSE_WRITE Cette constante permet de créer un événement quand un fichier à écrire est fermé.
FAN_CLOSE_NOWRITE Cette constante permet de créer un événement quand un fichier ou un répertoire est ouvert.
FAN_OPEN Cette constante permet de créer un événement quand un fichier en lecture seulement ou un répertoire est fermé.
FAN_Q_OVERFLOW Cette constante permet de créer un événement quand un débordement se produit dans la file d'attente d'événement.
FAN_OPEN_PERM Cette constante permet de créer un événement quand une permission d'ouverture de fichier ou de répertoire est requis.
FAN_ACCESS_PERM Cette constante permet de créer un événement quand une permission de lecture de fichier ou de répertoire est requis.
FAN_ONDIR Cette constante permet de créer un événement quand une fonction opendir, readdir ou closedir est appelé.
FAN_EVENT_ON_CHILD Cette constante permet d'indiquer que des événements pour les enfants immédiats des répertoires marqués doivent être créés. Le drapeau n'a aucun effet lors du marquage des montures. Notez que les événements ne sont pas générés pour les enfants des sous-répertoires de répertoires marqués. Pour surveiller les arborescences complètes, il est nécessaire de marquer le montage correspondant.
pathname Ce paramètre permet d'indiquer le nom du fichier.

Description

Cette fonction permet d'initialiser un nouveau groupe fanotify et retourne un descripteur de fichier pour la file d'attente d'événements associée au groupe.



Dernière mise à jour : Dimanche, le 21 février 2016