'\" t .\" Title: chmem .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.26 .\" Date: 2026-09-02 .\" Manual: System-Administration .\" Source: util-linux 2.42.3 .\" Language: English .\" .TH "CHMEM" "8" "2026-09-02" "util\-linux 2.42.3" "System\-Administration" .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 "BEZEICHNUNG" chmem \- Speicher konfigurieren .SH "ÜBERSICHT" .sp \fBchmem\fP [\fB\-h\fP] [\fB\-V\fP] [\fB\-v\fP] [\fB\-c\fP|\fB\-e\fP|\fB\-d\fP|\fB\-g\fP] [\fIGRÖSSE\fP|\fIBEREICH\fP|\fB\-b\fP \fIBLOCKBEREICH\fP] [\fB\-z\fP \fIZONE\fP] [\fB\-m\fP \fIZUWEISUNG\-IM\-SPEICHER\fP] .SH "BESCHREIBUNG" .sp Der Befehl \fBchmem\fP setzt eine bestimmte Speichergröße oder einen bestimmten Speicherbereich online oder offline. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Geben Sie die \fIGRÖSSE\fP als [m|M|g|G] an. Mit m oder M gibt die die Speichergröße in MiB an (1024 x 1024 Byte). Mit g oder G gibt die die Speichergröße in GiB an (1024 x 1024 x 1024 Byte). Die Standardeinheit ist MiB. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Geben Sie den \fIBEREICH\fP in der Form 0x\-0x an, wie in der Ausgabe des Befehls \fBlsmem\fP(1). ist die hexadezimale Adresse des ersten Bytes und die hexadezimale Adresse des letzten Bytes im Speicherbereich. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Geben Sie den \fIBLOCKBEREICH\fP in der Form \- oder an, wie in der Ausgabe des Befehls \fBlsmem\fP(1). ist die Nummer des ersten Speicherblocks und die Nummer des letzten Speicherblocks im Speicherbereich. Alternativ kann ein einzelner Block angegeben werden. \fIBLOCKBEREICH\fP erfordert die Option \fB\-\-blocks\fP. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Geben Sie \fIZONE\fP als Name des Speicherbereichs an, wie in der Ausgabe des Befehls \fBlsmem \-o +ZONEN\fP. Die Ausgabe zeigt eine oder mehrere zulässige Speicherzonen für jeden Speicherbereich an. Wenn mehrere Zonen angezeigt werden, dann bezieht sich der aktuelle Speicherbereich auf die erste Zone. Standardmäßig setzt \fBchmem\fP den Speicher in der Zone »Movable« online, sofern sich diese unter den zulässigen Zonen befindet. Diese Standardeinstellung kann mit der Option \fB\-\-zone\fP in eine andere zulässige Zone geändert werden. Für »Memory Ballooning« (Rückforderung ungenutzten virtuellen Speichers vom Gast durch das Wirtssystem in Virtualisierungen) wird empfohlen, die Zone »Movable« für Online\- und Offline\-Speicher falls möglich auszuwählen. Für den Speicher in diesem Bereich ist es sehr wahrscheinlich, dass er wieder offline gesetzt werden kann, aber er kann nicht für willkürliche Zuweisungen durch den Kernel genutzt werden, sondern nur für migrierbare Seiten (zum Beispiel anonyme Seiten oder jene aus dem Seiten\-Zwischenspeicher). Mit der Option \fB\-\-help\fP erhalten Sie eine Übersicht aller verfügbaren Zonen. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} Geben Sie \fIZUWEISUNG\-IM\-SPEICHER\fP als 1 oder 0 an. Der Wert 1 weist Hotplug\-Metadaten (zum Beispiel das Array »struct pages«) aus dem Hotplug\-Speicher selbst zu und ermöglicht so Hot\-Add\-Operationen auch unter Speichermangel, ohne dass zusätzlicher Systemspeicher benötigt wird. Der Wert 0 speichert die Metadaten des Hotplug\-Speichers im regulären Systemspeicher, wodurch Probleme im Zusammenhang mit der Fragmentierung zusammenhängender physischer Speicherblöcke vermieden werden. Der Wert kann nur gesetzt werden, wenn sich der Speicherblock in einem dekonfigurierten Zustand befindet, und \fB\-\- memmap\-on\-memory\fP ist nur mit \fB\-\-configure\fP zulässig. Wenn kein Wert angegeben wird und \fBchmem\fP unterstützt wird, verwendet \fBchmem\fP den in der Ausgabe von \fBlsmem\fP angezeigten Standardwert. .RE .sp Die Option \fB\-\-enable\fP konfiguriert den Speicher, sofern dies von der Architektur unterstützt wird. Wird die Speicherkonfiguration von der Architektur nicht unterstützt, aktiviert \fB\-\-enable\fP den Speicher dennoch. .sp Die Option \fB\-\-disable\fP schaltet den Speicher offline und führt optional einen Dekonfigurationsschritt durch, sofern dies von der Architektur unterstützt wird. .sp Die Option \fB\-\-configure\fP fordert Speicher vom Hypervisor an, ohne ihn online zu schalten, sofern die Architektur dies unterstützt. Dadurch wird eine explizite Steuerung und Nutzung von \fB\-\-memmap\-on\-memory\fP ermöglicht. .sp Die Option \fB\-\-deconfigure\fP gibt Speicherressourcen an den Hypervisor zurück, sofern dies von der Architektur unterstützt wird. .sp \fIGRÖSSE\fP und \fIBEREICH\fP müssen an der Linux\-Speicherblockgröße ausgerichtet sein, wie in der Ausgabe des Befehls \fBlsmem\fP(1) gezeigt. .sp Das Versetzen des Speichers in den Online\-Zustand kann aus verschiedenen Gründen fehlschlagen. Auf virtualisierten Systemen ist es möglich, dass der Hypervisor nicht über ausreichend Speicher verfügt, zum Beispiel weil der Speicher überzogen (»overcommitted«) wurde. Das Versetzen in den Offline\-Zustand kann ebenso fehlschlagen, wenn Linux den Speicher nicht freisetzen kann. Falls nur Teile des angeforderten Speichers online oder offline gesetzt werden können, informiert Sie eine Meldung darüber, wie viel Speicher im Gegensatz zu der angeforderten Menge online oder offline gesetzt werden konnte. .sp Wenn Speicher online gesetzt oder konfiguriert wird, beginnt \fBchmem\fP bei den Speicherblöcken mit den niedrigsten Nummern. Wenn Speicher offline gesetzt oder dekonfiguriert wwird, beginnt \fBchmem\fP bei den Speicherblöcken mit den höchsten Nummern. .SH "ARCHITEKTUR" .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} s390\-Architektur: .RE .sp \fIZUWEISUNG\-IM\-SPEICHER\fP: Für Speicherblöcke, die beim Systemstart online konfiguriert werden, ist der Standardwert 0, da sie ohne ZUWEISUNG\-IM\-SPEICHER\-Unterstützung hinzugefügt werden. Speicher, der dynamisch zur Laufzeit hinzugefügt wird, verwendet den in der Ausgabe von \fBlsmem\fP(1) angezeigten Standardwert. .SH "OPTIONEN" .sp \fB\-b\fP, \fB\-\-blocks\fP .RS 4 verwendet für die Optionen \fB\-\-enable\fP und \fB\-\-disable\fP einen \fIBLOCKBEREICH\fP\-Parameter anstelle von \fIBEREICH\fP oder \fIGRÖSSE\fP. .RE .sp \fB\-c\fP, \fB\-\-configure\fP .RS 4 setzt den angegebenen \fIBEREICH\fP, die \fIGRÖSSE\fP oder den \fIBLOCKBEREICH\fP des Speichers auf »konfiguriert«. .RE .sp \fB\-d\fP, \fB\-\-disable\fP .RS 4 setzt den angegebenen \fIBEREICH\fP, die \fIGRÖSSE\fP oder den \fIBLOCKBEREICH\fP des Speichers offline. .RE .sp \fB\-e\fP, \fB\-\-enable\fP .RS 4 setzt den angegebenen \fIBEREICH\fP, die \fIGRÖSSE\fP oder den \fIBLOCKBEREICH\fP des Speichers online. .RE .sp \fB\-g\fP, \fB\-\-deconfigure\fP .RS 4 setzt den angegebenen \fIBEREICH\fP, die \fIGRÖSSE\fP oder den \fIBLOCKBEREICH\fP des Speichers auf »dekonfiguriert«. .RE .sp \fB\-m\fP, \fB\-\-memmap\-on\-memory\fP .RS 4 wählt ZUWEISUNG\-IM\-SPEICHER für den angegebenen Speicherbereich (\fIBEREICH\fP, \fIGRÖSSE\fP oder \fIBLOCKBEREICH\fP). Diese Option ist nur mit \fB\-\-configure\fP gültig. .RE .sp \fB\-z\fP, \fB\-\-zone\fP .RS 4 wählt die Speicher\-\fIZONE\fP, in welcher der angegebene \fIBEREICH\fP, die \fIGRÖSSE\fP oder der \fIBLOCKBEREICH\fP des Speichers online oder offline gesetzt werden soll. Standardmäßig wird der Speicher in der Zone »Movable« online gesetzt, falls möglich. .RE .sp \fB\-v\fP, \fB\-\-verbose\fP .RS 4 aktiviert den ausführlichen Modus. Dadurch wird \fBchmem\fP veranlasst, Fehlerdiagnosemeldungen über dessen Fortschritt auszugeben. .RE .sp \fB\-h\fP, \fB\-\-help\fP .RS 4 zeigt einen Hilfetext an und beendet das Programm. .RE .sp \fB\-V\fP, \fB\-\-version\fP .RS 4 zeigt Versionsinformationen an und beendet das Programm. .RE .SH "EXIT\-STATUS" .sp \fBchmem\fP gibt die folgenden Exit\-Status\-Werte aus: .sp \fB0\fP .RS 4 Erfolg .RE .sp \fB1\fP .RS 4 Fehlschlag .RE .sp \fB64\fP .RS 4 Teilerfolg .RE .SH "BEISPIELE" .sp \fBchmem \-\-enable 1024\fP .RS 4 Dieser Befehl fordert die Online\-Setzung von 1024 MiB Speicher an. .RE .sp \fBchmem \-e 2g\fP .RS 4 Dieser Befehl fordert 2 GB Arbeitsspeicher an, der online geschaltet werden soll, und konfiguriert diesen, sofern die Architektur dies unterstützt, im Voraus. .RE .sp \fBchmem \-\-disable 0x00000000e4000000\-0x00000000f3ffffff\fP .RS 4 Dieser Befehl nimmt den Speicherbereich von 0x00000000e4000000 bis0x00000000f3ffffff offline und dekonfiguriert ihn, sofern dies von der Architektur unterstützt wird. .RE .sp \fBchmem \-b \-d 10\fP .RS 4 Dieser Befehl setzt den Speicherblock mit der Nummer 10 offline. .RE .sp \fBchmem \-b \-c 10 \-m 1\fP .RS 4 Dieser Befehl konfiguriert Speicherblock 10 mit aktivierter \fIZUWEISUNG\-IM\-SPEICHER\fP. Der Block muss sich im dekonfigurierten Zustand befinden. .RE .sp \fBchmem \-b \-c 10\fP .RS 4 Dieser Befehl konfiguriert Speicherblock 10 mit der standardmäßigen \fIZUWEISUNG\-IM\-SPEICHER\fP\-Einstellung. Der Standardwert wird in \fBlsmem \-\-output\-all\fP angezeigt. Der Block muss sich im dekonfigurierten Zustand befinden. .RE .sp \fBchmem \-b \-g 10\fP .RS 4 Dieser Befehl dekonfiguriert den Speicherblock mit der Nummer 10. Der Block muss offline sein. .RE .sp \fBchmem \-d 5g\fP .RS 4 nimmt 5 GB Speicher offline und dekonfiguriert ihn, sofern die Architektur dies unterstützt. Bereits offline gesetzte, aber noch konfigurierte Speicherblöcke werden übersprungen und müssen explizit mit \fB\-\-deconfigure\fP dekonfiguriert werden. .RE .SH "SIEHE AUCH" .sp \fBlsmem\fP(1) .SH "FEHLER MELDEN" .sp Nutzen Sie zum Melden von Fehlern das \c .URL "https://github.com/util\-linux/util\-linux/issues" "Fehlererfassungssystem" "." .SH "VERFÜGBARKEIT" .sp Der Befehl \fBchmem\fP ist Teil des Pakets util\-linux, welches aus dem \c .URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" "" heruntergeladen werden kann.