Man page - swapoff(2)

Packages contains this manual

Available languages:

en fr it nl ja ru ro de

Manual

swapon

BEZEICHNUNG
BIBLIOTHEK
ÜBERSICHT
BESCHREIBUNG
PrioritÀt
RÜCKGABEWERT
FEHLER
STANDARDS
GESCHICHTE
ANMERKUNGEN
SIEHE AUCH
ÜBERSETZUNG

BEZEICHNUNG

swapon, swapoff - Auslagerung von Hauptspeicherbereichen (Swapping) auf ein GerÀt oder in eine Datei starten/beenden

BIBLIOTHEK

Standard-C-Bibliothek ( libc , -lc )

ÜBERSICHT

#include <sys/swap.h>

int swapon(const char * pfad , int swap_schalter );
int swapoff(const char *
pfad );

BESCHREIBUNG

swapon weist den Auslagerungsbereich fĂŒr Hauptspeicherbereiche der Datei oder dem blockorientierten GerĂ€t zu, das in pfad angegeben wurde. swapoff beendet das Auslagern von Hauptspeicherbereichen in der Datei oder dem blockorientierten GerĂ€t, das in pfad angegeben wurde.

Falls der Schalter SWAP_FLAG_PREFER im swapon ()-Argument swap_schalter angegeben wurde, hat der neue Auslagerungsbereich fĂŒr Hauptspeicherbereiche eine höhere PrioritĂ€t als der vorgegebene. Die PrioritĂ€t ist in swap_schalter kodiert als:

(prio << SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK

Falls der Schalter SWAP_FLAG_DISCARD im swapon ()-Argument swap_schalter angegeben wurde, werden freigegebene Auslagerungsseiten fĂŒr Hauptspeicherbereiche verworfen, bevor sie erneut benutzt werden, falls das GerĂ€t mit dem Auslagerungsbereich fĂŒr Hauptspeicherbereiche die Aktionen zum Verwerfen oder KĂŒrzen (»discard« und »trim«) unterstĂŒtzt. (Dies könnte die Leistung auf einigen FestspeichergerĂ€ten (SSD) verbessern, was aber oft nicht der Fall ist.) Siehe auch die ANMERKUNGEN.

Diese Funktionen können nur von einem privilegierten Prozess (einem, der ĂŒber die CAP_SYS_ADMIN -Capability verfĂŒgt) benutzt werden.

PrioritÀt

Jeder Auslagerungsbereich fĂŒr den Arbeitsspeicher hat eine PrioritĂ€t, hoch oder niedrig. Die StandardprioritĂ€t ist niedrig. Innerhalb der Auslagerungsbereiche mit niedriger PrioritĂ€t werden neue Bereiche niedriger als bereits vorhandene Bereiche priorisiert.

Alle mit _swap_schalter_ gesetzten PrioritÀten sind hoch, höher als der Standardwert. Beim Aufruf kann die PrioritÀt auf einen beliebigen nicht negativen Wert gesetzt werden. Höhere Werte bedeuten höhere PrioritÀten.

Auslagerungsbereiche werden gemĂ€ĂŸ ihrer PrioritĂ€t reserviert, solche mit der höchsten PrioritĂ€t als erste. Ein höher priorisierter Bereich wird zunĂ€chst vollstĂ€ndig genutzt, bevor ein Bereich mit niedrigerer PrioritĂ€t verwendet wird. Sind mehrere Bereiche mit derselben PrioritĂ€t definiert und sind alle Bereiche mit höherer PrioritĂ€t bereits vollstĂ€ndig genutzt, so werden neue Speicherseiten unter den gleich priorisierten Bereichen reihum reserviert.

Ab Linux 1.3.6 befolgt der Kernel diese Regeln gewöhnlich, aber es gibt auch Ausnahmen.

RÜCKGABEWERT

Bei Erfolg wird Null zurĂŒckgegeben. Bei einem Fehler wird -1 zurĂŒckgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER

EBUSY

(FĂŒr swapon ()) Der angegebene pfad wird bereits als Auslagerungsbereich fĂŒr Hauptspeicherbereiche benutzt.

EINVAL

Die Datei pfad existiert, bezieht sich aber weder auf eine normale Datei noch auf ein BlockgerÀt;

EINVAL

( swapon ()) Der angegebene Pfad enthĂ€lt keine gĂŒltige Auslagerungssignatur oder befindet sich in einem speicherinternen Dateisystem wie beispielsweise tmpfs (5).

EINVAL (seit Linux 3.4)

( swapon ()) Ein unzulÀssiger Schalter wurde in swapflags angegeben.

EINVAL

( swapoff ()) pfad ist derzeit kein Auslagerungsbereich.

ENFILE

Die systemweite BeschrĂ€nkung fĂŒr die Gesamtzahl offener Dateien wurde erreicht.

ENOENT

Die Datei pfad existiert nicht.

ENOMEM

Das System verfĂŒgt nicht ĂŒber ausreichenden Speicher, um das Auslagern von Hauptspeicherbereichen zu starten.

EPERM

Der Aufrufende verfĂŒgt nicht ĂŒber die Capability CAP_SYS_ADMIN . Alternativ wird die maximale Anzahl der Auslagerungsdateien fĂŒr Hauptspeicherbereiche benutzt; Lesen Sie die folgenden ANMERKUNGEN.

STANDARDS

Linux.

GESCHICHTE

Das Argument swapflags wurde in Linux 1.3.2 eingefĂŒhrt.

ANMERKUNGEN

Die Partition oder der Pfad mĂŒssen mit mkswap (8) vorbereitet werden.

Es gibt eine Obergrenze fĂŒr die Anzahl der benutzbaren Auslagerungsdateien von Hauptspeicherbereichen, die in der Kernel-Konstante MAX_SWAPFILES definiert wird. Vor Linux 2.4.10 hatte MAX_SWAPFILES den Wert 8; seit Linux 2.4.10 hat sie den Wert 32. Seit Linux 2.6.18 ist die Grenze um zwei herabgesetzt (daher 30), seit Linux 5.19 wird die Grenze um 3 herabgesetzt (daher: 29), falls der Kernel mit der Option CONFIG_MIGRATION erstellt wurde (die zwei EintrĂ€ge in der Auslagerungstabelle von Hauptspeicherbereichen fĂŒr die Seiten-Migrationsfunktionen von mbind (2) und migrate_pages (2) reserviert). Seit Linux 2.6.32 wird die Grenze ferner um eins herabgesetzt, falls der Kernel mit der Option CONFIG_MEMORY_FAILURE erstellt wurde. Seit Linux 5.14 ist die BeschrĂ€nkung weiter auf 4 reduziert, falls der Kernel mit der Option CONFIG_DEVICE_PRIVATE gebaut wurde. Seit Linux 5.19 ist die Grenze weiter um 1 herabgesetzt, falls der Kernel mit der Option CONFIG_PTE_MARKER erstellt wurde.

Verwerfen von Auslagerungsseiten von Hauptspeicherbereichen wurde in Linux 2.6.29 eingefĂŒhrt, dann wurde es in Linux 2.6.36 vom Schalter SWAP_FLAG_DISCARD abhĂ€ngig gemacht, wodurch immer noch die ganze Auslagerung von Hauptspeicherbereichen beim Aufruf von swapon () verworfen (»discard«) wird, sogar, wenn das Schalter-Bit nicht gesetzt ist.

SIEHE AUCH

mkswap (8), swapoff (8), swapon (8)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Ralf Demmer <rdemmer@rdemmer.de>, Chris Leick <c.leick@vollbio.de>, Mario BlĂ€ttermann <mario.blaettermann@gmail.com>, Helge Kreutzmann <debian@helgefjell.de> und Joachim Schnitter <joachim.schnitter@software-logistik.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezĂŒglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ĂŒbernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org .