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)