.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2013, Heinrich Schuchardt .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of .\" this manual under the conditions for verbatim copying, provided that .\" the entire resulting derived work is distributed under the terms of .\" a permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume. .\" no responsibility for errors or omissions, or for damages resulting. .\" from the use of the information contained herein. The author(s) may. .\" not have taken the same level of care in the production of this. .\" manual, which is licensed free of charge, as they might when working. .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH FANOTIFY_INIT 2 "1 novembre 2020" Linux "Manuel du programmeur Linux" .SH NOM fanotify_init \- Créer et initialiser un groupe fanotify .SH SYNOPSIS \fB#include \fP .br \fB#include \fP .PP \fBint fanotify_init(unsigned int \fP\fIflags\fP\fB, unsigned int \fP\fIevent_f_flags\fP\fB);\fP .SH DESCRIPTION Pour un aperçu de l’interface de programmation fanotify, consultez \fBfanotify\fP(7). .PP \fBfanotify_init\fP() initialise un nouveau groupe fanotify et renvoie un descripteur de fichier pour la file d’événements associée au groupe. .PP Le descripteur de fichier est utilisé dans les appels de \fBfanotify_mark\fP(2) pour indiquer les fichiers, les répertoires, les points de montage et les systèmes de fichiers pour lesquels les événements fanotify seront créés. Ces événements sont reçus en lisant le descripteur de fichier. Certains événements ne sont qu’informatifs, indiquant qu’il y a eu un accès au fichier. D’autres événements peuvent être utilisés pour déterminer si une autre application a le droit d’accéder à un fichier ou répertoire. Le droit d’accéder aux objets de système de fichiers est accordé en écrivant dans le descripteur de fichier. .PP Plusieurs programmes peuvent utiliser l’interface fanotify en même temps pour surveiller les mêmes fichiers. .PP Dans l’implémentation actuelle, le nombre de groupes fanotify par utilisateur est limité à\ 128. Cette limite ne peut pas être écrasée. .PP Appeler \fBfanotify_init\fP() nécessite la capacité \fBCAP_SYS_ADMIN\fP. Cette contrainte pourrait être levée dans les prochaines versions de l’interface de programmation. Par conséquent, certaines vérifications supplémentaires de capacité ont été mises en place comme indiqué ci\-dessous. .PP L’argument \fIflags\fP contient un champ multibit définissant la classe de notification de l’application écoutant et d’autres champs monobits indiquant le comportement du descripteur de fichier. .PP Si plusieurs écoutants d’événements de permission existent, la classe de notification est utilisée pour établir l’ordre dans lequel les écoutants reçoivent les événements. .PP Une seule des classes de notification suivantes peut être indiquée dans \fIflags\fP. .TP \fBFAN_CLASS_PRE_CONTENT\fP Cette valeur permet de recevoir des événements notifiant qu’un fichier a été accédé et les événements de décisions de permission si un fichier peut être accédé. Elle est conçue pour les écoutants d’événement qui doivent accéder aux fichiers avant qu’ils ne contiennent leurs données finales. Cette classe de notification pourrait être utilisée par exemple par des gestionnaires de stockage hiérarchisé. .TP \fBFAN_CLASS_CONTENT\fP Cette valeur permet de recevoir des événements notifiant qu’un fichier a été accédé et les événements de décisions de permission si un fichier peut être accédé. Elle est conçue pour les écoutants d’événement qui doivent accéder aux fichiers quand ils contiennent déjà leur contenu final. Cette classe de notification pourrait être utilisée par exemple par des programmes de détection de logiciels malveillants. .TP \fBFAN_CLASS_NOTIF\fP C’est la valeur par défaut. Elle n’a pas besoin d’être indiquée. Cette valeur ne permet de recevoir que des événements notifiant qu’un fichier a été accédé. Les décisions de permission avant que le fichier ne soit accédé ne sont pas possibles. .PP Les écoutants avec différentes classes de notification recevront les événements dans l’ordre \fBFAN_CLASS_PRE_CONTENT\fP, \fBFAN_CLASS_CONTENT\fP, \fBFAN_CLASS_NOTIF\fP. L’ordre de notification pour les écoutants dans la même classe de notification n’est pas défini. .PP Les bits suivants peuvent de plus être définis dans \fIflags\fP. .TP \fBFAN_CLOEXEC\fP Placer l'attribut «\ close\-on\-exec\ » (\fBFD_CLOEXEC\fP) sur le nouveau descripteur de fichier. Consultez la description de l'attribut \fBO_CLOEXEC\fP dans \fBopen\fP(2). .TP \fBFAN_NONBLOCK\fP Activer l’attribut non bloquant (\fBO_NONBLOCK\fP) pour le descripteur de fichier. La lecture du descripteur de fichier ne bloquera pas. À la place, si aucune donnée n’est disponible, \fBread\fP(2) échouera avec l’erreur \fBEAGAIN\fP. .TP \fBFAN_UNLIMITED_QUEUE\fP Supprimer la limite de 16384\ événements pour la file d’événements. L’utilisation de cet attribut nécessite la capacité \fBCAP_SYS_ADMIN\fP. .TP \fBFAN_UNLIMITED_MARKS\fP Supprimer la limite de 8192\ marques. L’utilisation de cet attribut nécessite la capacité \fBCAP_SYS_ADMIN\fP. .TP \fBFAN_REPORT_TID\fP (depuis Linux 4.20) .\" commit d0a6a87e40da49cfc7954c491d3065a25a641b29 Signaler l'ID d'un thread (TID) au lieu de l'ID du processus (PID) dans le champ \fIpid\fP de la \fIstruct fanotify_event_metadata\fP fournie à \fBread\fP(2) (voir \fBfanotify\fP(7)). .TP \fBFAN_REPORT_FID\fP (depuis Linux 5.1) .\" commit a8b13aa20afb69161b5123b4f1acc7ea0a03d360 Cette valeur permet la réception d'événements qui contiennent des informations complémentaires sur l'objet du système de fichiers sous\-jacent corrélé à un événement. Un enregistrement supplémentaire de type \fBFAN_EVENT_INFO_TYPE_FID\fP enferme les informations sur l'objet et est inclus dans toute la structure générique des métadonnées de l'événement. Le descripteur de fichier utilisé pour représenter l'objet lié à un événement est remplacé par un identificateur de fichier. Il est conçu pour les applications qui trouvent que l'utilisation d'un identificateur de fichier pour identifier un objet convient mieux qu'un descripteur de fichier. De plus, il peut être utilisé par des applications supervisant un répertoire ou un système de fichiers qui s'intéressent aux modifications d'entrée de répertoire, tels que \fBFAN_CREATE\fP, \fBFAN_DELETE\fP et \fBFAN_MOVE\fP, ou à des événements tels que \fBFAN_ATTRIB\fP, \fBFAN_DELETE_SELF\fP et \fBFAN_MOVE_SELF\fP. Tous les événements ci\-dessus exigent un groupe fanotify identifiant les objets du système de fichiers par des identificateurs de fichier. Remarquez que pour que les événements de modification de l'entrée d'un répertoire, l’identificateur de fichier signalé identifie le répertoire modifié et non l'objet enfant créé/supprimé/déplacé. L'utilisation de \fBFAN_CLASS_CONTENT\fP ou de \fBFAN_CLASS_PRE_CONTENT\fP n'est pas autorisée avec cet attribut et donnera une erreur \fBEINVAL\fP. Voir \fBfanotify\fP(7) pour des informations supplémentaires. .TP \fBFAN_REPORT_DIR_FID\fP (depuis Linux 5.9) Les événements des groupes fanotify initialisés avec cet attribut contiendront (voir les exceptions ci\-dessous) des informations supplémentaires sur l'objet d'un répertoire corrélé à un événement. Un enregistrement supplémentaire de type \fBFAN_EVENT_INFO_TYPE_DFID\fP enferme les informations sur l'objet répertoire et est inclus dans toute la structure générique des métadonnées de l'événement. Pour des événements qui arrivent sur un objet qui n'est pas un répertoire, la structure supplémentaire inclut un identificateur de fichier qui identifie l'objet système de fichiers du répertoire parent. Remarquez qu'il n'y a pas de garantie que l'objet système de fichiers du répertoire ne se trouve à l'emplacement décrit par l’information d’identificateur de fichier au moment où l'événement est reçu. S'il est associé à l'attribut \fBFAN_REPORT_FID\fP, il se peut que deux événements soient signalés avec ceux qui se produisent sur un objet non répertoire, un pour identifier l'objet non répertoire lui\-même, et un pour identifier le répertoire parent. Remarquez que dans certains cas, un objet système de fichiers n'a pas de parent, par exemple quand un événement se produit sur un fichier non lié mais ouvert. Dans ce cas, avec l'attribut \fBFAN_REPORT_FID\fP l'événement sera signalé avec un seul enregistrement pour identifier l'objet non répertoire, puisqu'il n'y a pas de répertoire associé à l'événement. Sans l'attribut \fBFAN_REPORT_FID\fP, aucun événement ne sera signalé. Voir \fBfanotify\fP(7) pour des détails supplémentaires. .TP \fBFAN_REPORT_NAME\fP (depuis Linux 5.9) Les événements des groupes fanotify initialisés avec cet attribut contiendront des informations supplémentaires sur le nom de l'entrée de répertoire corrélé à un événement. Cet attribut doit être fourni en association avec l'attribut \fBFAN_REPORT_DIR_FID\fP. Le fait de fournir cette valeur d'attribut sans \fBFAN_REPORT_DIR_FID\fP aboutira à l'erreur \fBEINVAL\fP. Cet attribut peut être combiné à l'attribut \fBFAN_REPORT_FID\fP. Un enregistrement supplémentaire de type \fBFAN_EVENT_INFO_TYPE_DFID_NAME\fP, qui enferme les informations sur l'entrée de répertoire, est inclus dans toute la structure générique des métadonnées de l'événement et remplace l'enregistrement des informations supplémentaires de type \fBFAN_EVENT_INFO_TYPE_DFID\fP. L'enregistrement supplémentaire inclut un identificateur de fichier qui identifie un objet système de fichiers de répertoire suivi d'un nom qui identifie une entrée dans ce répertoire. Pour que les événements de modification de l'entrée d'un répertoire \fBFAN_CREATE\fP, \fBFAN_DELETE\fP et \fBFAN_MOVE\fP, le nom signalé est celui de l'entrée de répertoire créée/effacée/déplacée. Pour les autres événements qui se produisent sur un objet répertoire, l’identificateur rapporté est celui est celui de l'objet répertoire lui\-même et le nom signalé est «\ .\ ». Pour les autres événements qui se produisent sur un objet non répertoire, l’identificateur de fichier signalé est celui de l'objet du répertoire parent et le nom signalé est celui de l'entrée d'un répertoire où se situait l'objet au moment de l'événement. La raison derrière cette logique est que l’identificateur de fichier du répertoire signalé peut être passé à \fBopen_by_handle_at\fP(2) pour récupérer un descripteur de fichier de répertoire ouvert et que ce descripteur de fichier ainsi que le nom signalé puissent être utilisés pour appeler \fBfstatat\fP(2). La même règle qui s'applique au type d'enregistrement \fBFAN_EVENT_INFO_TYPE_DFID\fP s'applique aussi au type d'enregistrement \fBFAN_EVENT_INFO_TYPE_DFID_NAME\fP\ : si un objet non répertoire n'a pas de parent, soit l'événement ne sera pas signalé, soit il le sera sans les informations d'entrée de répertoire. Remarquez qu'il n'existe pas de garantie que l'objet système de fichiers se trouve à l'endroit décrit par les informations de l'entrée de répertoire au moment où l'événement est reçu. Voir \fBfanotify\fP(7) pour des détails supplémentaires. .TP \fBFAN_REPORT_DFID_NAME\fP C'est un synonyme de (\fBFAN_REPORT_DIR_FID\fP|\fBFAN_REPORT_NAME\fP). .PP L’argument \fIevent_f_flags\fP définit les attributs d’état de fichier qui seront définis sur les descriptions de fichiers ouverts qui sont créées pour les événements fanotify. Pour plus de précisions sur ces attributs, consultez la description des valeurs de \fIflags\fP dans \fBopen\fP. \fIevent_f_flags\fP contient un champ multibit pour le mode d’accès. Ce champ peut prendre une des valeurs suivantes\ : .TP \fBO_RDONLY\fP Cette valeur permet l’accès en lecture seule. .TP \fBO_WRONLY\fP Cette valeur permet l’accès en écriture seule. .TP \fBO_RDWR\fP Cette valeur permet l’accès en lecture et écriture. .PP Des bits supplémentaires peuvent être définis dans \fIevent_f_flags\fP. Les valeurs les plus utiles sont les suivantes\ : .TP \fBO_LARGEFILE\fP Activer la prise en charge de fichiers dépassant 2\ Go. Sans cet attribut, une erreur \fBEOVERFLOW\fP surviendra lors d’une tentative d’ouverture d’un gros fichier surveillé par un groupe fanotify sur un système 32\ bits. .TP \fBO_CLOEXEC\fP (depuis Linux\ 3.18) .\" commit 0b37e097a648aa71d4db1ad108001e95b69a2da4 Activer l'attribut «\ close\-on\-exec\ » pour le descripteur de fichier. Consultez la description de l'attribut \fBO_CLOEXEC\fP dans \fBopen\fP(2) pour savoir pourquoi cela peut être utile. .PP Les valeurs suivantes sont aussi permises\ : \fBO_APPEND\fP, \fBO_DSYNC\fP, \fBO_NOATIME\fP, \fBO_NONBLOCK\fP et \fBO_SYNC\fP. Indiquer n’importe quel autre attribut dans \fIevent_f_flags\fP provoque l’erreur \fBEINVAL\fP (mais consultez \fBBOGUES\fP). .SH "VALEUR RENVOYÉE" S'il réussit, \fBfanotify_init\fP() renvoie un nouveau descripteur de fichier. En cas d'erreur, il renvoie\ \fB\-1\fP et \fIerrno\fP contient le code d'erreur. .SH ERREURS .TP \fBEINVAL\fP .\" commit 23c9deeb3285d34fd243abb3d6b9f07db60c3cf4 Une valeur incorrecte a été passée dans \fIflags\fP ou \fIevent_f_flags\fP. \fBFAN_ALL_INIT_FLAGS\fP (obsolète depuis la version 4.20 du noyau Linux) définit tous les bits permis pour \fIflags\fP. .TP \fBEMFILE\fP Le nombre de groupes fanotify pour cet utilisateur dépasse\ 128. .TP \fBEMFILE\fP La limite du nombre de descripteurs de fichiers par processus a été atteinte. .TP \fBENOMEM\fP Échec d’allocation mémoire pour le groupe de notification. .TP \fBENOSYS\fP Ce noyau n’implémente pas \fBfanotify_init\fP(). L’interface de programmation fanotify n'est disponible que si le noyau a été configuré avec \fBCONFIG_FANOTIFY\fP. .TP \fBEPERM\fP L’opération n’est pas permise car l’appelant n’a pas la capacité \fBCAP_SYS_ADMIN\fP. .SH VERSIONS \fBfanotify_init\fP() a été introduit dans la version\ 2.6.36 du noyau Linux et activé dans la version\ 2.6.37. .SH CONFORMITÉ Cet appel système est spécifique à Linux. .SH BOGUES Le bogue suivant était présent dans les noyaux Linux avant la version\ 3.18\ : .IP * 3 .\" Fixed by commit 0b37e097a648aa71d4db1ad108001e95b69a2da4 \fBO_CLOEXEC\fP est ignoré lorsqu'il est passé dans \fIevent_f_flags\fP. .PP Le bogue suivant était présent dans les noyaux Linux avant la version\ 3.14\ : .IP * 3 .\" Fixed by commit 48149e9d3a7e924010a0daab30a6197b7d7b6580 l’argument \fIevent_f_flags\fP n’est pas vérifié pour les attributs incorrects. Les attributs qui ne sont conçus que pour une utilisation interne, comme \fBFMODE_EXEC\fP, peuvent être définis et seront donc définis pour les descripteurs de fichier renvoyés lors de la lecture depuis le descripteur de fichier fanotify. .SH "VOIR AUSSI" \fBfanotify_mark\fP(2), \fBfanotify\fP(7) .SH COLOPHON Cette page fait partie de la publication\ 5.10 du projet \fIman\-pages\fP Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man\-pages/. .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Philippe MENGUAL . Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .