.\" -*- coding: UTF-8 -*-
.\" Copyright (c) 2017 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH sysfs 5 "2 maja 2024 r." "Linux man\-pages 6.8" 
.SH NAZWA
sysfs \- system plików do eksportowania obiektów jądra
.SH OPIS
System plików \fBsysfs\fP jest pseudosystemem plików, który zapewnia interfejs
do struktur danych jądra (precyzyjniej: pliki i katalogi w \fBsysfs\fP dają
wgląd w struktury \fIkobject\fP, zdefiniowane wewnętrznie w jądrze). Pliki w
\fBsysfs\fP udostępniają informacje o urządzeniach, modułach jądra, systemach
plików i innych składowych jądra.
.P
System plików \fBsysfs\fP jest najczęściej montowany jako \fI/sys\fP. Zwykle jest
to dokonywane automatycznie przez system, ale można go zamontować również
ręcznie, za pomocą polecenia takiego jak:
.P
.in +4n
.EX
mount \-t sysfs sysfs /sys
.EE
.in
.P
.\"
Wiele z plików w systemie plików \fBsysfs\fP 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.
.SS "Pliki i katalogi"
Poniższa lista opisuje niektóre z plików i katalogów znajdujących się w
hierarchii \fI/sys\fP.
.TP 
\fI/sys/block\fP
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 \fI/sys/devices\fP.
.TP 
\fI/sys/bus\fP
Katalog zawiera po jednym podkatalogu dla każdego typu magistrali w
jądrze. W każdym z nich, znajdują się dwa podkatalogi:
.RS
.TP 
\fIdevices\fP
Podkatalog zawierający dowiązania symboliczne do wpisów w \fI/sys/devices\fP,
odpowiadającym urządzeniom odkrytym na tej magistrali.
.TP 
\fIdrivers\fP
Podkatalog zawierający po jednym podkatalogu dla każdego sterownika
urządzenia załadowanego do tej magistrali.
.RE
.TP 
\fI/sys/class\fP
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 \fI/sys/devices\fP.
.TP 
\fI/sys/class/net\fP
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 \fI/sys/devices\fP.
.TP 
\fI/sys/dev\fP
Katalog zawiera dwa podkatalogi: \fIblock/\fP i \fIchar/\fP 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
\fInumer\-główny\fP:\fInumer\-poboczny\fP, które odpowiadają numerowi głównemu i
pobocznemu danego urządzenia. Każde z dowiązań wskazuje na katalog \fBsysfs\fP
urządzenia. Dowiązania symboliczne w \fI/sys/dev\fP dają zatem łatwy wgląd w
interfejs \fBsysfs\fP, za pomocą numerów urządzeń zwracanych przez wywołanie
\fBstat\fP(2) (lub podobne).
.IP
Poniższa powłoka sesji pokazuje przykład z katalogu \fI/sys/dev\fP:
.IP
.in +4n
.EX
$ \fBstat \-c "%t %T" /dev/null\fP
1 3
$ \fBreadlink /sys/dev/char/1\e:3\fP
\&../../devices/virtual/mem/null
$ \fBls \-Fd /sys/devices/virtual/mem/null\fP
/sys/devices/virtual/mem/null/
$ \fBls \-d1 /sys/devices/virtual/mem/null/*\fP
/sys/devices/virtual/mem/null/dev
/sys/devices/virtual/mem/null/power/
/sys/devices/virtual/mem/null/subsystem@
/sys/devices/virtual/mem/null/uevent
.EE
.in
.TP 
\fI/sys/devices\fP
Katalog zawiera drzewo urządzeń jądra, czyli hierarchię sktruktur \fIdevice\fP
w jądrze, reprezentowaną w postaci systemu plików.
.TP 
\fI/sys/firmware\fP
Podkatalog zawiera interfejsy do przeglądania i zmiany obiektów oraz
atrybutów związanych z oprogramowaniem układowym.
.TP 
\fI/sys/fs\fP
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ć.
.TP 
\fI/sys/fs/cgroup\fP
Katalog konwencjonalnie używany jako punkt montowania systemu plików
\fBtmpfs\fP(5), zawierającego punkty montowań systemów plików \fBcgroups\fP(7).
.TP 
\fI/sys/fs/smackfs\fP
Katalog zawiera pliki konfiguracyjne SMACK LSM.  Więcej informacji w pliku
\fIDocumentation/admin\-guide/LSM/Smack.rst\fP, w źródłach jądra.
.TP 
\fI/sys/hypervisor\fP
[do udokumentowania]
.TP 
\fI/sys/kernel\fP
Podkatalog zawiera różne pliki i podkatalogi dostarczające informacji o
działającym jądrze.
.TP 
\fI/sys/kernel/cgroup/\fP
Informacje o plikach w tym katalogu zawarto w podręczniku \fBcgroups\fP(7).
.TP 
\fI/sys/kernel/debug/tracing\fP
Punkt montowania dla systemu plików \fItracefs\fP, używanego przez mechanizm
jądra \fIftrace\fP (więcej informacji o \fIftrace\fP znajduje się w pliku
\fIDocumentation/trace/ftrace.txt\fP w źródłach jądra).
.TP 
\fI/sys/kernel/mm\fP
Podkatalog zawiera różne pliki i podkatalogi udostępniające informacje o
podsystemie zarządzania pamięcią jądra.
.TP 
\fI/sys/kernel/mm/hugepages\fP
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. \fIhugepages\-2048kB\fP). 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 \fIDocumentation/admin\-guide/mm/hugetlbpage.rst\fP w źródłach jądra.
.TP 
\fI/sys/module\fP
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:
.RS
.TP 
\fIcoresize\fP
[do udokumentowania]
.TP 
\fIinitsize\fP
[do udokumentowania]
.TP 
\fIinitstate\fP
[do udokumentowania]
.TP 
\fIrefcnt\fP
[do udokumentowania]
.TP 
\fIsrcversion\fP
[do udokumentowania]
.TP 
\fItaint\fP
[do udokumentowania]
.TP 
\fIuevent\fP
[do udokumentowania]
.TP 
\fIversion\fP
[do udokumentowania]
.RE
.IP
W każdym z tych podkatalogów, mogą istnieć następujące podkatalogi:
.RS
.TP 
\fIdrivers\fP
[do udokumentowania]
.TP 
\fIholders\fP
[do udokumentowania]
.TP 
\fInotes\fP
[do udokumentowania]
.TP 
\fIparameters\fP
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.
.TP 
\fIsections\fP
Podkatalog zawiera informacje o sekcjach modułów. Służą głównie do
debugowania.
.TP 
\fI[Do udokumentowania]\fP
.RE
.TP 
\fI/sys/power\fP
[do udokumentowania]
.SH STANDARDY
Linux.
.SH HISTORIA
Linux 2.6.0.
.SH UWAGI
Ta strona podręcznika jest niekompletna, prawdopodobnie niedokładna i należy
do tych, które powinny być bardzo często poprawiane.
.SH "ZOBACZ TAKŻE"
\fBproc\fP(5), \fBudev\fP(7)
.P
.\" https://www.kernel.org/pub/linux/kernel/people/mochel/doc/papers/ols-2005/mochel.pdf
P.\& Mochel. (2005).  \fIThe sysfs filesystem\fP.  Sprawozdanie z 2005 Ottawa
Linux Symposium.
.P
Plik \fIDocumentation/filesystems/sysfs.txt\fP w źródłach jądra i różne inne
pliki w \fIDocumentation/ABI\fP i \fIDocumentation/*/sysfs.txt\fP
.PP
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Michał Kułach <michal.kulach@gmail.com>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .
