CHMEM(8)

NAZWA
chmem - konfiguruje pamięć

SKŁADNIA

chmem [-h] [-V*] [-v] [-c|-e|-d|-g] [ROZMIAR|ZAKRES|-b ZAKRES-BLOKÓW] [-z STREFA] [-m MAPA-PAMIĘCI-W-PAMIĘCI]

OPIS

Polecenie chmem może ustawić dany rozmiar lub zakres pamięci jako aktywną lub nieaktywną.

    • ROZMIAR 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.

    • ZAKRES należy podać w postaci 0x<początek>-0x<koniec>, tak jak wyświetla go wynik polecenia lsmem(1). <Początek> jest szesnastkowym adresem pierwszego bajtu, a <koniec> jest szesnastkowym adresem ostatniego bajtu w danym zakresie pamięci.

    • ZAKRES-BLOKÓW należy podać w postaci <pierwszy>-<ostatni> lub <blok>, tak jak wyświetla go polecenie lsmem(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>. ZAKRES-BLOKÓW wymaga opcji --blocks.

    • STREFĘ należy podać jako nazwę strefy pamięci, tak jak wyświetla ją polecenie lsmem -o +ZONES. 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, chmem 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ę --zone 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 --help.

    • MAPA-PAMIĘCI-W-PAMIĘCI 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 --memmap-on-memory jest prawidłowe tylko z opcją --configure. Jeśli się jej nie poda, a jest obsługiwana, chmem użyje wartości domyślnej pokazanej w wyjściu lsmem.

Opcja --enable konfiguruje pamięć, jeśli jest to obsługiwane przez architekturę. Jeśli konfigurowanie pamięci nie jest obsługiwane przez architekturę, --enable wciąż dokona aktywacji pamięci.

Opcja --disable dezaktywuje pamięć i dokonuje opcjonalnego kroku dekonfiguracji, jeśli jest to obsługiwane przez architekturę.

Opcja --configure żąda pamięci od nadzorcy bez aktywowania jej, gdy jest to obsługiwane przez architekturę, pozwalając na jawne sterowanie i stosowanie opcji --memmap-on-memory.

Opcja --deconfigure zwraca zasoby pamięci nadzorcy, jeśli jest to obsługiwane przez architekturę.

ROZMIAR i ZAKRES muszą być wyrównane do rozmiaru bloku pamięci Linuksa, zgodnie z wynikiem polecenia lsmem(1).

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ć.

Przy aktywowaniu lub konfigurowaniu pamięci, chmem rozpoczyna od najniższych numerów bloków pamięci. Przy dezaktywowaniu lub dekonfigurowaniu pamięci, chmem rozpoczyna od najwyższych numerów bloków pamięci.

ARCHITEKTURA

    • Architektura s390:

MAPA-PAMIĘCI-W-PAMIĘCI: 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 lsmem.

OPCJE

-b, --blocks
    Korzysta z parametru ZAKRES-BLOKÓW zamiast z ZAKRESU lub ROZMIARU przy opcjach --enable i --disable.

-c, --configure
    Ustawia podany ZAKRES, ROZMIAR, lub ZAKRES-BLOKÓW pamięci do skonfigurowania.

-d, --disable
    Ustawia podany ZAKRES, ROZMIAR, lub ZAKRES-BLOKÓW pamięci jako nieaktywny.

-e, --enable
    Ustawia podany ZAKRES, ROZMIAR, lub ZAKRES-BLOKÓW pamięci jako aktywny.

-g, --deconfigure
    Ustawia podany ZAKRES, ROZMIAR, lub ZAKRES-BLOKÓW pamięci do zdekonfigurowania.

-m, --memmap-on-memory
    Ustawia memmap-on-memory podanego ZAKRESU, ROZMIARU, lub ZAKRESU-BLOKÓW pamięci. Opcja ta jest prawidłowa tylko łącznie z --configure.

-z, --zone
    Wybiera STREFĘ, w której aktywowany lub dezaktywowany ma być podany ZAKRES, ROZMIAR lub ZAKRES-BLOKÓW pamięci. Domyślnie pamięć będzie aktywowana w strefie Movable, jeśli to tylko możliwe.

-v, --verbose
    Tryb szczegółowy. Powoduje, że chmem wypisuje komunikaty diagnostyczne o swoim działaniu.

-h, --help
    Wyświetla ten tekst i wychodzi.

-V, --version
    Wyświetla wersję i wychodzi.

STATUS ZAKOŃCZENIA

chmem ma następujące wartości statusu zakończenia:

0
    sukces

1
    niepowodzenie

64
    częściowy sukces

PRZYKŁADY

chmem --enable 1024
    Polecenie żąda aktywowania 1024 MiB pamięci.

chmem -e 2g
    Polecenie żąda aktywowania 2 GB pamięci oraz, jeśli jest to obsługiwane przez architekturę, uprzedniego skonfigurowania pamięci.

chmem --disable 0x00000000e4000000-0x00000000f3ffffff
    Polecenie dezaktywuje pamięć z zakresu od 0x00000000e4000000 do 0x00000000f3ffffff i dekonfiguruje ją, jeśli jest to obsługiwane przez architekturę.

chmem -b -d 10
    Polecenie dezaktywuje blok pamięci o numerze 10.

chmem -b -c 10 -m 1
    Polecenie konfiguruje blok pamięci o numerze 10 z ustawioną MAPĄ-PAMIĘCI-W-PAMIĘCI. Blok musi być w stanie zdekonfigurowanym.

chmem -b -c 10
    Polecenie konfiguruje blok pamięci o numerze 10 z domyślnym ustawieniem MAPY-PAMIĘCI-W-PAMIĘCI. Domyślna wartość jest wyświetlana w lsmem --output-all. Blok musi być w stanie zdekonfigurowanym.

chmem -b -g 10
    Polecenie dekonfiguruje blok pamięci o numerze 10. Blok musi być nieaktywny.

chmem -d 5g
    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ą --deconfigure.

ZOBACZ TAKŻE

lsmem(1)

ZGŁASZANIE BŁĘDÓW

Problemy należy zgłaszać w

DOSTĘPNOŚĆ

Polecenie chmem jest częścią pakietu util-linux, który można pobrać ze strony