Ubuntu Manpage: sysfs - system plików do eksportowania obiektów jądra

NAZWA

       sysfs - system plików do eksportowania obiektów jądra

OPIS

System plików sysfs jest pseudosystemem plików, który zapewnia interfejs do struktur danych jądra
(precyzyjniej: pliki i katalogi w sysfs dają wgląd w struktury kobject, zdefiniowane wewnętrznie w
jądrze). Pliki w sysfs udostępniają informacje o urządzeniach, modułach jądra, systemach plików i innych
składowych jądra.

System plików sysfs jest najczęściej montowany jako /sys. Zwykle jest to dokonywane automatycznie przez
system, ale można go zamontować również ręcznie, za pomocą polecenia takiego jak:

mount -t sysfs sysfs /sys

Wiele z plików w systemie plików sysfs jest tylko do odczytu, lecz niektóre są zapisywalne, co umożliwia
zmianę zmiennych jądra. Aby uniknąć dublowania, do łączenia wpisów w systemie plików używa się wielu
dowiązań symbolicznych.

Pliki i katalogi
Poniższa lista opisuje niektóre z plików i katalogów znajdujących się w hierarchii /sys.

/sys/block
Podkatalog zawierający po jednym dowiązaniu symbolicznym dla każdego urządzenia blokowego, które
zostało odkryte w systemie. Dowiązania symboliczne wskazują na odpowiadające katalogi w katalogu
/sys/devices.

/sys/bus
Katalog zawiera po jednym podkatalogu dla każdego typu magistrali w jądrze. W każdym z nich,
znajdują się dwa podkatalogi:

devices
Podkatalog zawierający dowiązania symboliczne do wpisów w /sys/devices, odpowiadającym
urządzeniom odkrytym na tej magistrali.

drivers
Podkatalog zawierający po jednym podkatalogu dla każdego sterownika urządzenia załadowanego
do tej magistrali.

/sys/class
Podkatalog zawiera po jednym poziomie dalszych podkatalogów, na każdą klasę urządzeń, którą
zarejestrowano w systemie (np. terminale, urządzenia sieciowe, urządzenia blokowe, urządzenia
graficzne, urządzenia dźwiękowe itd.). Wewnątrz każdego z tych podkatalogów znajdują się
dowiązania symboliczne do każdego z urządzeń danej klasy. Dowiązania prowadzą do wpisów w katalogu
/sys/devices.

/sys/class/net
Każdy z wpisów w tym katalogu jest dowiązaniem symbolicznym reprezentującym rzeczywiste lub
wirtualne urządzenie sieciowe, które jest widoczne w przestrzeni nazw sieci procesu, uzyskującego
dostęp do katalogu. Każde z dowiązań prowadzi do wpisów w katalogu /sys/devices.

/sys/dev
Katalog zawiera dwa podkatalogi: block/ i char/ odnoszące się, odpowiednio, do urządzeń blokowych
oraz znakowych w systemie. Wewnątrz każdego z podkatalogów są dowiązania symboliczne z nazwami w
postaci numer-główny:numer-poboczny, które odpowiadają numerowi głównemu i pobocznemu danego
urządzenia. Każde z dowiązań wskazuje na katalog sysfs urządzenia. Dowiązania symboliczne w
/sys/dev dają zatem łatwy wgląd w interfejs sysfs, za pomocą numerów urządzeń zwracanych przez
wywołanie stat(2) (lub podobne).

Poniższa powłoka sesji pokazuje przykład z katalogu /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
Katalog zawiera drzewo urządzeń jądra, czyli hierarchię sktruktur device w jądrze, reprezentowaną
w postaci systemu plików.

/sys/firmware
Podkatalog zawiera interfejsy do przeglądania i zmiany obiektów oraz atrybutów związanych z
oprogramowaniem układowym.

/sys/fs
Katalog zawiera podkatalogi niektórych systemów plików. System plików będzie miał tu podkatalog
tylko, jeśli wyraźnie zdecyduje, że chce go utworzyć.

/sys/fs/cgroup
Katalog konwencjonalnie używany jako punkt montowania systemu plików tmpfs(5), zawierającego
punkty montowań systemów plików cgroups(7).

/sys/fs/smackfs
Katalog zawiera pliki konfiguracyjne SMACK LSM. Więcej informacji w pliku
Documentation/admin-guide/LSM/Smack.rst, w źródłach jądra.

/sys/hypervisor
[do udokumentowania]

/sys/kernel
Podkatalog zawiera różne pliki i podkatalogi dostarczające informacji o działającym jądrze.

/sys/kernel/cgroup/
Informacje o plikach w tym katalogu zawarto w podręczniku cgroups(7).

/sys/kernel/debug/tracing
Punkt montowania dla systemu plików tracefs, używanego przez mechanizm jądra ftrace (więcej
informacji o ftrace znajduje się w pliku Documentation/trace/ftrace.txt w źródłach jądra).

/sys/kernel/mm
Podkatalog zawiera różne pliki i podkatalogi udostępniające informacje o podsystemie zarządzania
pamięcią jądra.

/sys/kernel/mm/hugepages
Podkatalog zawiera po jednym podkatalogu, dla każdego rozmiaru dużych stron, które obsługuje
system. Nazwa danego podkatalogu wskazuje rozmiar dużej strony (np. hugepages-2048kB). Wewnątrz
każdego z tych podkatalogów znajduje się zbiór plików, które mogą służyć do przeglądania i
(czasem) zmiany ustawień związanych z danym rozmiarem dużych stron. Więcej informacji w pliku
Documentation/admin-guide/mm/hugetlbpage.rst w źródłach jądra.

/sys/module
Podkatalog zawiera po jednym podkatalogu, dla każdego modułu załadowego do jądra. Nazwa danego
podkatalogu jest nazwą modułu. W każdym z tych podkatalogów, mogą istnieć następujące pliki:

coresize
[do udokumentowania]

initsize
[do udokumentowania]

initstate
[do udokumentowania]

refcnt [do udokumentowania]

srcversion
[do udokumentowania]

taint [do udokumentowania]

uevent [do udokumentowania]

version
[do udokumentowania]

W każdym z tych podkatalogów, mogą istnieć następujące podkatalogi:

drivers
[do udokumentowania]

holders
[do udokumentowania]

notes [do udokumentowania]

parameters
Katalog zawiera po jednym pliku dla każdego parametru modułu, przy czym każdy plik zawiera
wartość danego parametru. Niektóre z plików są dostępne do zapisu, pozwalając na
modyfikację wartości.

sections
Podkatalog zawiera informacje o sekcjach modułów. Służą głównie do debugowania.

[Do udokumentowania]

/sys/power
[do udokumentowania]

STANDARDY

       Linux.

HISTORIA

       Linux 2.6.0.

UWAGI

       Ta  strona  podręcznika jest niekompletna, prawdopodobnie niedokładna i należy do tych, które powinny być
       bardzo często poprawiane.

ZOBACZ TAKŻE

       proc(5), udev(7)

       P. Mochel. (2005).  The sysfs filesystem.  Sprawozdanie z 2005 Ottawa Linux Symposium.

       Plik Documentation/filesystems/sysfs.txt w źródłach jądra  i  różne  inne  pliki  w  Documentation/ABI  i
       Documentation/*/sysfs.txt

TŁUMACZENIE

       Tłumaczenie niniejszej strony podręcznika: Michał Kułach <michal.kulach@gmail.com>

       Niniejsze  tłumaczenie  jest  wolną  dokumentacją.  Bliższe informacje o warunkach licencji można uzyskać
       zapoznając  się  z  GNU General Public License w wersji 3  lub  nowszej.   Nie   przyjmuje   się   ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy  w  tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej manpages-pl-
       list@lists.sourceforge.net.

Linux man-pages 6.9.1                          15 czerwca 2024 r.                                       sysfs(5)