'\" t
.\"     Title: chmem
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: Administracja systemem
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "CHMEM" "8" "2026-09-02" "util\-linux 2.42.3" "Administracja systemem"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAZWA"
chmem \- konfiguruje pamięć
.SH "SKŁADNIA"
.sp
\fBchmem\fP [\fB\-h] [\fP\-V*] [\fB\-v\fP] [\fB\-c\fP|\fB\-e\fP|\fB\-d\fP|\fB\-g\fP] [\fIROZMIAR\fP|\fIZAKRES\fP|\fB\-b\fP \fIZAKRES\-BLOKÓW\fP] [\fB\-z\fP \fISTREFA\fP] [\fB\-m\fP \fIMAPA\-PAMIĘCI\-W\-PAMIĘCI\fP]
.SH "OPIS"
.sp
Polecenie \fBchmem\fP może ustawić dany rozmiar lub zakres pamięci jako aktywną lub nieaktywną.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIROZMIAR\fP należy podać jako <rozmiar>[m|M|g|G]. Z przyrostkiem m lub M, <rozmiar> określa rozmiar pamięci w MiB (1024 x 1024 bajtów). Z przyrostkiem g lub G, <rozmiar> określa rozmiar pamięci w GiB (1024 x 1024 x 1024 bajtów). Domyślną jednostką są MiB.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIZAKRES\fP należy podać w postaci 0x<początek>\-0x<koniec>, tak jak wyświetla go wynik polecenia \fBlsmem\fP(1). <Początek> jest szesnastkowym adresem pierwszego bajtu, a <koniec> jest szesnastkowym adresem ostatniego bajtu w danym zakresie pamięci.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIZAKRES\-BLOKÓW\fP należy podać w postaci <pierwszy>\-<ostatni> lub <blok>, tak jak wyświetla go polecenie \fBlsmem\fP(1). <Pierwszy> to numer pierwszego bloku pamięci, a <ostatni> to numer ostatniego bloku pamięci w danym zakresie pamięci. Alternatywnie można podać pojedynczy <blok>. \fIZAKRES\-BLOKÓW\fP wymaga opcji \fB\-\-blocks\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fISTREFĘ\fP należy podać jako nazwę strefy pamięci, tak jak wyświetla ją polecenie \fBlsmem \-o +ZONES\fP. Wyjście pokaże jedną lub więcej prawidłowych stref dla każdego zakresu pamięci. Jeśli wyświetli się kilka stref, to dany zakres pamięci obecnie należy do pierwszej strefy. Domyślnie, \fBchmem\fP ustawi pamięć online do strefy Movable, jeśli taka istnieje wśród prawidłowych stref. To domyślne zachowanie można zmienić podając opcję \fB\-\-zone\fP z inną prawidłową strefą. Przy balonikowaniu pamięci, zaleca się wybierać strefę Movable dla pamięci aktywnej i nieaktywnej, jeśli tylko jest dostępna. Pamięć w tej strefie ma znacznie większe prawdopodobieństwo ponownego zdezaktywowania, lecz nie może być stosowana do dowolnych przydziałów jądra, tylko dla migrowalnych stron (np. stron buforowanych i anonimowych). Wszystkie dostępne strefy pokaże opcja \fB\-\-help\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fIMAPA\-PAMIĘCI\-W\-PAMIĘCI\fP podaje się jako 1 lub 0. Wartość 1 przydziela metadane pamięci typu hotplug (takie jak struktura tablicy stron) niezależnie od samej pamięci podlegającej podłączaniu w trybie hotplug, co pozwala na dokonywanie dołączania pamięci nawet w sytuacjach jej niedoboru, nie wymagając do tego dodatkowej pamięci. Wartość 0 przechowuje metadane pamięci typu hotplug w zwykłej pamięci systemowej, co pozwala uniknąć problemów wynikających z fragmentacji ciągłej pamięci fizycznej na przestrzeni bloków pamięci. Wartość można ustawić tylko, jeśli bloki pamięci są w stanie zdekonfigurowanym, a \fB\-\-memmap\-on\-memory\fP jest prawidłowe tylko z opcją \fB\-\-configure\fP. Jeśli się jej nie poda, a jest obsługiwana, \fBchmem\fP użyje wartości domyślnej pokazanej w wyjściu \fBlsmem\fP.
.RE
.sp
Opcja \fB\-\-enable\fP konfiguruje pamięć, jeśli jest to obsługiwane przez architekturę. Jeśli konfigurowanie pamięci nie jest obsługiwane przez architekturę, \fB\-\-enable\fP wciąż dokona aktywacji pamięci.
.sp
Opcja \fB\-\-disable\fP dezaktywuje pamięć i dokonuje opcjonalnego kroku dekonfiguracji, jeśli jest to obsługiwane przez architekturę.
.sp
Opcja \fB\-\-configure\fP żąda pamięci od nadzorcy bez aktywowania jej, gdy jest to obsługiwane przez architekturę, pozwalając na jawne sterowanie i stosowanie opcji \fB\-\-memmap\-on\-memory\fP.
.sp
Opcja \fB\-\-deconfigure\fP zwraca zasoby pamięci nadzorcy, jeśli jest to obsługiwane przez architekturę.
.sp
\fIROZMIAR\fP i \fIZAKRES\fP muszą być wyrównane do rozmiaru bloku pamięci Linuksa, zgodnie z wynikiem polecenia \fBlsmem\fP(1).
.sp
Ustawienie pamięci jako aktywnej może się nie powieść z wielu powodów. W systemach wirtualizowanych może się tak zdarzyć, gdy nadzorca nie będzie miał odpowiednio dużo pamięci, np. z powodu przydziału ponad stan faktyczny (overcommit). Ustawienie pamięci jako nieaktywnej może zawieść, gdy Linux nie może zwolnić pamięci. Jeśli jedynie część żądanej pamięci może zostać aktywowana lub zdezaktywowana, odpowiedni komunikat poinformuje, jak wiele z żądanej wielkości udało się aktywować lub zdezaktywować.
.sp
Przy aktywowaniu lub konfigurowaniu pamięci, \fBchmem\fP rozpoczyna od najniższych numerów bloków pamięci. Przy dezaktywowaniu lub dekonfigurowaniu pamięci, \fBchmem\fP rozpoczyna od najwyższych numerów bloków pamięci.
.SH "ARCHITEKTURA"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Architektura s390:
.RE
.sp
\fIMAPA\-PAMIĘCI\-W\-PAMIĘCI\fP: W przypadku bloków pamięci skonfigurowanych i aktywowanych przy rozruchu, domyślna wartość wynosi 0, ponieważ są one dodawane bez obsługi memmap\-on\-memory. Pamięć dodawana dynamicznie w czasie uruchomienia korzysta z domyślnej wartości wyświetlanej w wyjściu \fBlsmem\fP.
.SH "OPCJE"
.sp
\fB\-b\fP, \fB\-\-blocks\fP
.RS 4
Korzysta z parametru \fIZAKRES\-BLOKÓW\fP zamiast z \fIZAKRESU\fP lub \fIROZMIARU\fP przy opcjach \fB\-\-enable\fP i \fB\-\-disable\fP.
.RE
.sp
\fB\-c\fP, \fB\-\-configure\fP
.RS 4
Ustawia podany \fIZAKRES\fP, \fIROZMIAR\fP, lub \fIZAKRES\-BLOKÓW\fP pamięci do skonfigurowania.
.RE
.sp
\fB\-d\fP, \fB\-\-disable\fP
.RS 4
Ustawia podany \fIZAKRES\fP, \fIROZMIAR\fP, lub \fIZAKRES\-BLOKÓW\fP pamięci jako nieaktywny.
.RE
.sp
\fB\-e\fP, \fB\-\-enable\fP
.RS 4
Ustawia podany \fIZAKRES\fP, \fIROZMIAR\fP, lub \fIZAKRES\-BLOKÓW\fP pamięci jako aktywny.
.RE
.sp
\fB\-g\fP, \fB\-\-deconfigure\fP
.RS 4
Ustawia podany \fIZAKRES\fP, \fIROZMIAR\fP, lub \fIZAKRES\-BLOKÓW\fP pamięci do zdekonfigurowania.
.RE
.sp
\fB\-m\fP, \fB\-\-memmap\-on\-memory\fP
.RS 4
Ustawia memmap\-on\-memory podanego \fIZAKRESU\fP, \fIROZMIARU\fP, lub \fIZAKRESU\-BLOKÓW\fP pamięci. Opcja ta jest prawidłowa tylko łącznie z \fB\-\-configure\fP.
.RE
.sp
\fB\-z\fP, \fB\-\-zone\fP
.RS 4
Wybiera \fISTREFĘ\fP, w której aktywowany lub dezaktywowany ma być podany \fIZAKRES\fP, \fIROZMIAR\fP lub \fIZAKRES\-BLOKÓW\fP pamięci. Domyślnie pamięć będzie aktywowana w strefie Movable, jeśli to tylko możliwe.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Tryb szczegółowy. Powoduje, że \fBchmem\fP wypisuje komunikaty diagnostyczne o swoim działaniu.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "STATUS ZAKOŃCZENIA"
.sp
\fBchmem\fP ma następujące wartości statusu zakończenia:
.sp
\fB0\fP
.RS 4
sukces
.RE
.sp
\fB1\fP
.RS 4
niepowodzenie
.RE
.sp
\fB64\fP
.RS 4
częściowy sukces
.RE
.SH "PRZYKŁADY"
.sp
\fBchmem \-\-enable 1024\fP
.RS 4
Polecenie żąda aktywowania 1024 MiB pamięci.
.RE
.sp
\fBchmem \-e 2g\fP
.RS 4
Polecenie żąda aktywowania 2 GB pamięci oraz, jeśli jest to obsługiwane przez architekturę, uprzedniego skonfigurowania pamięci.
.RE
.sp
\fBchmem \-\-disable 0x00000000e4000000\-0x00000000f3ffffff\fP
.RS 4
Polecenie dezaktywuje pamięć z zakresu od 0x00000000e4000000 do 0x00000000f3ffffff i dekonfiguruje ją, jeśli jest to obsługiwane przez architekturę.
.RE
.sp
\fBchmem \-b \-d 10\fP
.RS 4
Polecenie dezaktywuje blok pamięci o numerze 10.
.RE
.sp
\fBchmem \-b \-c 10 \-m 1\fP
.RS 4
Polecenie konfiguruje blok pamięci o numerze 10 z ustawioną \fIMAPĄ\-PAMIĘCI\-W\-PAMIĘCI\fP. Blok musi być w stanie zdekonfigurowanym.
.RE
.sp
\fBchmem \-b \-c 10\fP
.RS 4
Polecenie konfiguruje blok pamięci o numerze 10 z domyślnym ustawieniem \fIMAPY\-PAMIĘCI\-W\-PAMIĘCI\fP. Domyślna wartość jest wyświetlana w \fBlsmem \-\-output\-all\fP. Blok musi być w stanie zdekonfigurowanym.
.RE
.sp
\fBchmem \-b \-g 10\fP
.RS 4
Polecenie dekonfiguruje blok pamięci o numerze 10. Blok musi być nieaktywny.
.RE
.sp
\fBchmem \-d 5g\fP
.RS 4
Polecenie dezaktywuje 5 GB pamięci i dekonfiguruje ją, jeśli jest to obsługiwane przez architekturę. Bloki już zdezaktywowane ale wciąż skonfigurowane są pomijane i muszą być zdekonfigurowane bezpośrednio opcją \fB\-\-deconfigure\fP.
.RE
.SH "ZOBACZ TAKŻE"
.sp
\fBlsmem\fP(1)
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBchmem\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."