sysfs(5) File Formats Manual sysfs(5) NOM sysfs - Systeme de fichiers pour l'exportation d'objets du noyau DESCRIPTION Le systeme de fichiers sysfs est un pseudo-systeme de fichiers fournissant une interface aux structures de donnees du noyau (plus precisement, les fichiers et les repertoires dans sysfs fournissent une vue des structures kobject definies a l'interieur du noyau). Les fichiers sous sysfs fournissent des informations sur les peripheriques, les modules du noyau, les systemes de fichiers et d'autres composants du noyau. Le systeme de fichiers sysfs est communement monte sur /sys. Normalement, il est monte automatiquement par le systeme, mais peut l'etre aussi manuellement en utilisant une commande telle que : mount -t sysfs sysfs /sys Bon nombre de fichiers du systeme de fichiers sysfs sont en lecture seule, mais certains sont editables, permettant de modifier les variables du noyau. Pour eviter des redondances, les liens symboliques sont abondamment utilises pour des entrees dans l'arbre du systeme de fichiers. Fichiers et repertoires La liste suivante decrit quelques fichiers et repertoires dans la hierarchie /sys. /sys/block Ce sous-repertoire contient un lien symbolique pour chaque peripherique en mode bloc qui a ete decouvert dans le systeme. Les liens symboliques pointent vers les repertoires correspondants dans /sys/devices. /sys/bus Ce repertoire contient un sous-repertoire pour chacun des types de bus du noyau. Dans chacun de ces repertoires deux sous-repertoires existent : devices ce sous-repertoire contient des liens symboliques vers les entrees dans /sys/devices qui correspondent aux peripheriques decouverts sur ce bus ; drivers ce sous-repertoire contient un sous-repertoire par chaque pilote de peripherique qui est charge sur ce bus. /sys/class Ce sous-repertoire contient une seule couche de sous-repertoires supplementaires pour chacune des classes de peripherique qui ont ete enregistrees sur le systeme (par exemple, terminaux, peripheriques reseau, peripheriques en mode bloc, peripheriques graphiques, peripheriques audio, etc.). Dans chacun de ces sous-repertoires, des liens symboliques existent pour chacun des peripheriques de cette classe. Ces liens symboliques font reference aux entrees dans le repertoire /sys/devices. /sys/class/net Chacune des entrees dans ce repertoire est un lien symbolique representant un des peripheriques reseau reel ou virtuel qui sont visibles dans l'espace de noms reseau du processus accedant a ce repertoire. Chacun de ces liens symboliques fait reference a une entree dans le repertoire /sys/devices. /sys/dev Ce repertoire contient deux sous-repertoires block/ et char/, correspondant, respectivement, aux peripheriques en mode bloc et a ceux en mode caractere du systeme. Dans chacun de ces sous-repertoires des liens symboliques existent avec des noms de la forme ID_majeur:ID_mineur, ou les valeurs d'ID correspondent aux ID majeur et mineur d'un peripherique particulier. Chaque lien symbolique pointe vers le repertoire sysfs pour un peripherique. Les liens symboliques dans /sys/dev fournissent ainsi un moyen facile pour rechercher l'interface sysfs en utilisant les ID de peripherique renvoyes par un appel a stat(2) (ou similaire). La session d'interpreteur suivante montre un exemple de /sys/dev : $ stat -c "%t %T" /dev/null 1 3 $ readlink /sys/dev/char/1\:3 ../../devices/virtual/mem/null $ ls -Fd /sys/devices/virtual/mem/null /sys/devices/virtual/mem/null/ $ ls -d1 /sys/devices/virtual/mem/null/* /sys/devices/virtual/mem/null/dev /sys/devices/virtual/mem/null/power/ /sys/devices/virtual/mem/null/subsystem@ /sys/devices/virtual/mem/null/uevent /sys/devices Ce repertoire contient une representation du systeme de fichiers de l'arbre des peripheriques du noyau qui est une hierarchie de structures device dans le noyau. /sys/firmware Ce sous-repertoire contient des interfaces pour voir et manipuler des objets et des attributs specifiques au microprogramme. /sys/fs Ce repertoire contient des sous-repertoires pour certains systemes de fichiers. Un systeme de fichiers aura un sous-repertoire ici seulement s'il choisit explicitement de le creer. /sys/fs/cgroup Conventionnellement ce repertoire est utilise comme point de montage pour un systeme de fichiers tmpfs(5) contenant des points de montage pour des systemes de fichiers cgroups(7). /sys/fs/smackfs Ce repertoire contient les fichiers de configuration pour les modules SMACK LSM. Consulter le fichier des sources du noyau Documentation/admin-guide/LSM/Smack.rst. /sys/hypervisor [A documenter] /sys/kernel Ce sous-repertoire contient divers fichiers et sous-repertoires qui fournissent des informations sur le noyau en cours de fonctionnement. /sys/kernel/cgroup/ Pour des informations sur les fichiers de ce repertoire, consulter cgroups(7). /sys/kernel/debug/tracing C'est le point de montage du systeme de fichiers tracefs utilise par la fonction ftrace du noyau (pour des informations sur ftrace, consulter le fichier des sources du noyau Documentation/trace/ftrace.txt). /sys/kernel/mm Ce sous-repertoire contient divers fichiers et sous-repertoires qui fournissent des informations a propos du sous-systeme de gestion de la memoire par le noyau. /sys/kernel/mm/hugepages Ce sous-repertoire contient un sous-repertoire pour chacune des tailles de page large que le systeme prend en charge. Le nom de sous-repertoire indique la taille de page large (par exemple, hugepages-2048kB). Dans chacun de ces sous-repertoires se trouve un ensemble de fichiers qui peuvent etre utilises pour voir et (dans certains cas) modifier les reglages associes a cette taille de page large. Pour des informations complementaires, consulter le fichier des sources du noyau Documentation/admin-guide/mm/hugetlbpage.rst. /sys/module Ce sous-repertoire contient un sous-repertoire pour chaque module qui est charge dans le noyau. Le nom de chaque sous-repertoire est le nom du module. Dans chacun des sous-repertoires, les fichiers suivants peuvent etre presents : coresize [Documentation a venir] initsize [Documentation a venir] initstate [Documentation a venir] refcnt [Documentation a venir] srcversion [Documentation a venir] taint [Documentation a venir] uevent [Documentation a venir] version [Documentation a venir] Dans chacun des sous-repertoires, les sous-repertoires suivants peuvent etre presents : drivers [A documenter] holders [A documenter] notes [A documenter] parameters Ce repertoire contient un fichier pour chaque parametre de module, chaque fichier contenant la valeur du parametre correspondant. Certains de ces fichiers sont editables, permettant la modification de la valeur. sections Ce sous-repertoire contient des fichiers comportant des informations sur les sections de module. Ces informations sont principalement utilisees a titre de debogage. [Documentation a venir] /sys/power [A documenter] STANDARDS Linux. HISTORIQUE Linux 2.6.0. NOTES Cette page de manuel est incomplete, peut etre imprecise, et devrait etre mise a jour tres souvent. VOIR AUSSI proc(5), udev(7) P. Mochel. (2005). The sysfs filesystem. Expose lors du Symposium Linux a Ottawa en 2005. Le fichier des sources du noyau Documentation/filesystems/sysfs.txt et divers autre fichiers dans Documentation/ABI et Documentation/*/sysfs.txt TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier et David Prevot Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 sysfs(5)