.\" -*- coding: UTF-8 -*-
.\" Copyright (c) 2001 Andreas Dilger (adilger@turbolinux.com)
.\" and Copyright (c) 2017 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH slabinfo 5 "2 maja 2024 r." "Linux man\-pages 6.9.1" 
.SH NAZWA
slabinfo \- statystyki alokatora płyt (slab) w jądrze
.SH SKŁADNIA
.nf
\fBcat /proc/slabinfo\fP
.fi
.SH OPIS
Często używane obiekty w jądrze Linux (nagłówki buforów, i\-węzły, dentry
itp.) mają swoje własne bufory. Plik \fI/proc/slabinfo\fP udostępnia statystyki
tych buforów. Poniższe (zmodyfikowane) wyjście pokazuje przykład zawartości
tego pliku:
.P
.EX
$ \fBsudo cat /proc/slabinfo\fP
slabinfo \- version: 2.1
# name    <active_objs> <num_objs> <objsize> <objperslab> <pagesperslab> ...
sigqueue      100  100  160   25  1 : tunables  0  0  0 : slabdata   4   4  0
sighand_cache 355   405 2112  15  8 : tunables  0  0  0 : slabdata  27  27  0
kmalloc\-8192   96   96  8192   4  8 : tunables  0  0  0 : slabdata  24  24  0
\&...
.EE
.P
Pierwszy wiersz zawiera numer wersji, pozwalającym aplikacjom odczytującej
plik na obsługę zmian w formacie pliku (zob. WERSJE poniżej). Następny
wiersz zawiera listę nazw kolumn będących w pozostałych wierszach
.P
Każdy z pozostałych wierszy wyświetla informacje o określonym buforze. Po
nazwie bufora, pokazane wyjście w każdym wierszu wyświetla trzy składowe
każdego bufora:
.IP \[bu] 3
statystyki
.IP \[bu]
tunables
.IP \[bu]
slabdata
.P
Występują poniższe statystyki:
.TP 
\fIactive_objs\fP
Liczba aktualnie aktywnych obiektów (tj. w użyciu).
.TP 
\fInum_objs\fP
Całkowita liczba przydzielonych obiektów (tj. obiektów w użyciu i
nieużywanych)
.TP 
\fIobjsize\fP
Rozmiar obiektów w tej płycie, w bajtach.
.TP 
\fIobjperslab\fP
Liczba obiektów przechowywanych w każdej płycie.
.TP 
\fIpagesperslab\fP
Liczba stron przydzielonych do każdej płyty.
.P
Wpisy \fItunables\fP w każdym wierszu pokazują parametry, które można
zmodyfikować dla poszczególnego bufora. Przy korzystaniu z domyślnego
alokatora SLUB, takie wartości nie występują, plik \fI/proc/slabinfo\fP nie
jest zapisywalny, a w tych polach wyświetlana jest wartość 0. Jeśli korzysta
się ze starszego alokatora SLAB, wartości dla poszczególnego bufora można
ustawić zapisując wiersz w poniższej postaci do \fI/proc/slabinfo\fP:
.P
.in +4n
.EX
# \fBecho \[aq]nazwa limit batchcount sharedfactor\[aq] > /proc/slabinfo\fP
.EE
.in
.P
\fINazwa\fP jest tu nazwą bufora, a \fIlimit\fP, \fIbatchcount\fP i \fIsharedfactor\fP
stanowią liczby całkowite definiujące poszczególne nowe wartości. Wartość
\fIlimit\fP powinna być dodatnia, wartość \fIbatchcount\fP powinna być dodatnia i
mniejsza lub równa wartości \fIlimit\fP, a \fIsharedfactor\fP powinno być
nieujemne. Jeśli dowolna z podanych wartości będzie nieprawidłowa,
ustawienia bufora nie ulegną zmianie.
.P
Wpisy \fItunables\fP w każdym wierszu zawierają poniższe wpisy:
.TP 
\fIlimit\fP
.\" https://lwn.net/Articles/56360/
.\"     This is the limit on the number of free objects that can be stored
.\"     in the per-CPU free list for this slab cache.
Maksymalna liczba obiektów, które będą zbuforowane.
.TP 
\fIbatchcount\fP
.\" https://lwn.net/Articles/56360/
.\"     On SMP systems, when we refill the available object list, instead
.\"     of doing one object at a time, we do batch-count objects at a time.
W systemach SMP, określa to liczbę obiektów, które będą przetransferowane
jednocześnie, przy ponownym wypełnianiu listy dostępnych obiektów.
.TP 
\fIsharedfactor\fP
.\"
[do udokumentowania]
.P
Wpisy \fIslabdata\fP w każdym wierszu zawierają poniższe wpisy:
.TP 
\fIactive_slabs\fP
Liczba aktywnych płyt.
.TP 
\fInums_slabs\fP
Całkowita liczba płyt.
.TP 
\fIsharedavail\fP
[do udokumentowania]
.P
Proszę zauważyć, że ze względu na wyrównanie obiektów i narzut bufora płyt,
obiekty nie są zwykle umieszczane ściśle w stronach. Strony zawierające choć
jeden obiekt w użyciu są uważane za w użyciu i nie mogą być zwolnione.
.P
.\"
.\" SMP systems will also have "(SMP)" in the first line of
.\" output, and will have two additional columns for each slab,
.\" reporting the slab allocation policy for the CPU-local
.\" cache (to reduce the need for inter-CPU synchronization
.\" when allocating objects from the cache).
.\" The first column is the per-CPU limit: the maximum number of objects that
.\" will be cached for each CPU.
.\" The second column is the
.\" batchcount: the maximum number of free objects in the
.\" global cache that will be transferred to the per-CPU cache
.\" if it is empty, or the number of objects to be returned
.\" to the global cache if the per-CPU cache is full.
.\"
.\" If both slab cache statistics and SMP are defined, there
.\" will be four additional columns, reporting the per-CPU
.\" cache statistics.
.\" The first two are the per-CPU cache
.\" allocation hit and miss counts: the number of times an
.\" object was or was not available in the per-CPU cache
.\" for allocation.
.\" The next two are the per-CPU cache free
.\" hit and miss counts: the number of times a freed object
.\" could or could not fit within the per-CPU cache limit,
.\" before flushing objects to the global cache.
Jądra skonfigurowane z opcją \fBCONFIG_DEBUG_SLAB\fP będą zawierać również
dodatkowe pola ze statystykami w każdym wierszu, a pierwszy wiersz w pliku
będzie zawierał łańcuch \[Bq](statistics)\[rq]. Pola statystyk obejmują:
szczytową liczba aktywnych obiektów; ile razy obiekty były przydzielone, ile
razy bufor został zwiększony (dodano do danego bufora nowe strony); ile razy
bufor został wyrwany (reaped; nieużywane strony usunięto z danego bufora) i
ile razy przy przydzielaniu nowych stron do tego bufora wystąpił błąd.
.SH WERSJE
Plik \fI/proc/slabinfo\fP pojawił się pierwotnie w Linuksie 2.1.23. Plik jest
wersjonowany, a z biegiem czasu pojawiło się wiele wersji z różnym
rozmieszczeniem danych:
.TP 
1.0
Obecny w serii jąder Linux 2.2.x.
.TP 
1.1
.\" First appeared in Linux 2.4.0-test3
Obecny w serii jąder Linux 2.4.x.
.TP 
1.2
.\" from Linux 2.5.45 to Linux 2.5.70
Format obecny przez chwilę w serii rozwojowej Linuksa 2.5.
.TP 
2.0
.\" First appeared in Linux 2.5.71
Obecny w jądrach Linux 2.6.x do 2.6.9 włącznie.
.TP 
2.1
Aktualny format, pojawił się pierwotnie w Linuksie 2.6.10.
.SH UWAGI
Jedynie root może odczytywać i (jeśli jądro skonfigurowano z opcją
\fBCONFIG_SLAB\fP) zapisywać plik \fI/proc/slabinfo\fP.
.P
Całkowita ilość pamięci przydzielonej do bufora SLAB/SLUB widnieje w polu
\fISlab\fP w pliku \fI/proc/meminfo\fP.
.SH "ZOBACZ TAKŻE"
\fBslabtop\fP(1)
.P
Pliki \fIDocumentation/vm/slub.txt\fP i \fItools/vm/slabinfo.c\fP w źródłach
jądra.
.PP
.SH TŁUMACZENIE
Tłumaczenie niniejszej strony podręcznika:
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 .
