SWAPON(8) Systemadministration SWAPON(8)

swapon, swapoff - aktivera/inaktivera enheter och filer för paging och växling

swapon [flaggor] [specialfil...]

swapoff [-va] [specialfil...]

swapon används för att ange enheter på vilka paging och swapping ska ske.

Den enhet eller fil som används anges av parametern specialfile. Den kan vara av formen -L etikett eller -U uuid för att ange en enhet med label eller uuid.

Anrop till swapon sker normalt i systemets startskript som gör alla swap-enheter tillgängliga, så att paging- och swapping-aktiviteten fördelas över flera enheter och filer.

swapoff inaktiverar swapping på de angivna enheterna och filerna. När flaggan -a anges inaktiveras swapping på alla kända swap-enheter och -filer (som finns i /proc/swaps eller /etc/fstab).

-a, --all

All devices marked as "swap" in /etc/fstab are made available, except for those with the "noauto" option. Devices that are already being used as swap are silently skipped. See the FSTAB CONFIGURATION section for more details.

-T, --fstab sökväg

Anger en alternativ fstab-fil för kompatibilitet med mount(8). Om sökväg är en katalog sorteras filerna i katalogen enligt strverscmp(3); filer som börjar med "." eller som saknar .fstab-tillägg ignoreras. Flaggan kan anges mer än en gång. Den här flaggan är främst avsett för initramfs- eller chroot-skript där ytterligare konfiguration anges utöver standardkonfigurationen för systemet.

-d, --discard[=policy]

Aktivera swap discards, om swap backing-enheten stöder discard- eller trim-operationen. Detta kan förbättra prestanda på vissa Solid State-enheter, men ofta gör det inte det. Flaggan gör det möjligt att välja mellan två tillgängliga policyer för swap discard:

--discard=once

för att utföra en engångskastning för hela växlingsområdet vid swapon; eller

--discard=pages

för att asynkront kasta bort frigjorda växlingssidor innan de är tillgängliga för återanvändning.

Om ingen policy har valts är standardbeteendet att aktivera båda diskningstyperna. Monteringsflaggorna /etc/fstab discard, discard=once eller discard=pages kan också användas för att aktivera discard-flaggor.

-e, --ifexists

Hoppa tyst över enheter som inte finns. Monteringsflaggan nofail i /etc/fstab kan också användas för att hoppa över icke-existerande enheter.

-f, --fixpgsz

Återinitialisera (exekvera mkswap) swaputrymmet om dess sidstorlek inte matchar den för den aktuella kärnan. mkswap(8) initierar hela enheten och kontrollerar inte om det finns dåliga block.

-L etikett

Använd den partition som har den angivna etikett. (För detta krävs åtkomst till /proc/partitions.)

-o, --options opts

Ange växlingsflaggor med en kommaseparerad sträng som är kompatibel med fstab. Till exempel:

swapon -o pri=1,discard=pages,nofail /dev/sda2

Strängen opts utvärderas sist och åsidosätter alla andra kommandoradsflaggor.

-p, --priority priority

Ange prioriteten för växlingsenheten. priority är ett värde mellan 0 och 32767. Högre siffror anger högre prioritet. Se swapon(2) för en fullständig beskrivning av växlingsprioriteter. Lägg till pri=värde i flaggfältet i /etc/fstab för användning med swapon -a. När ingen prioritet är definierad använder Linux-kärnan negativa tal som standard.

-s, --summary

Visa en sammanfattning av växlingsanvändningen per enhet. Motsvarar cat /proc/swaps. Detta utdataformat är FÖRÅLDRAT till förmån för --show som ger bättre kontroll över utdata.

--show[=column...]

Visar en definierbar tabell över växlingsområden. Se --help för en lista över tillgängliga kolumner.

--output-all

Skriv ut alla tillgängliga kolumner.

--annotate[=when]

Adds an annotation to each column header name. Such an annotation can be shown as a tooltip by terminals that support this feature. The optional when argument can be always, never, or auto. If the argument is omitted, it defaults to auto, which means that annotations will only be used when the output goes to a terminal.

--noheadings

Skriv inte ut rubriker när du visar --show-utdata.

--raw

Visa --visa utdata utan att justera tabellkolumnerna.

--bytes

Visa växlingsstorlek i byte i --show-utdata istället för i användarvänliga enheter.

-U uuid

Använd den partition som har den angivna uuid.

-v, --verbose

Var utförlig.

-h, --help

Visa hjälptext och avsluta.

-V, --version

Visa version och avsluta.

The command swapon --all reads configuration from /etc/fstab (or from a file specified by the --fstab command line option). Only fstab entries with the filesystem type (3rd field) set to "swap" are relevant.

The option --options accepts values in the same form as can be specified in the fourth field in fstab.

Specify the swap source. If the source is a regular file, it is addressed by an absolute path.

If the swap is a block device, it can be addressed by device path, swap area tags LABEL= or UUID= (see mkswap(8) for more details), or by partition tags like PARTLABEL= or PARTUUID=.

Unused by swapon, the recommended convention is to use "none".

Requires "swap" as the filesystem type.

It is formatted as a comma-separated list of options. All unknown options are silently ignored. If options are unnecessary, the recommended convention is to use "defaults". The options specified in fstab extend or overwrite settings specified on the swapon command line.

Supported swap options:

noauto

Ignore entry when swapon --all is given.

nofail

Rapportera inte fel för den här enheten om den inte finns.

discard[=policy]

Enable swap discard. The supported settings are discard, discard=once, or discard=pages. For more details, see the --discard command line option.

pri=priority

Specify the priority of the swap device. For more details, see the --priority command line option.

Unused by swapon, the recommended convention is to keep it empty.

Unused by swapon, the recommended convention is to keep it empty.

swapoff har följande utgångsstatusvärden sedan v2.36:

0

lyckades

2

systemet har inte tillräckligt med minne för att stoppa växlingen (OOM)

4

swapoff(2) syscall misslyckades av annan anledning

8

non-swapoff(2) syscall systemfel (slut på minne, ...)

16

användnings- eller syntaxfel

32

alla swapoff misslyckades på --all

64

vissa swapoff lyckades på --all

Kommandot swapoff --all returnerar 0 (alla lyckades), 32 (alla misslyckades) eller 64 (några misslyckades, några lyckades).

+ De gamla versionerna före v2.36 har ingen dokumenterad utgångsstatus, 0 betyder framgång i alla versioner.

LIBMOUNT_DEBUG=all

aktiverar libmount felsökningsutdata.

LIBBLKID_DEBUG=all

aktiverar libblkid felsökningsutdata.

/dev/sd??

standardutrustning för personsökning

/etc/fstab

ascii-tabell för beskrivning av filsystem

Implementeringen av växlingsfilen i kärnan förväntar sig att kunna skriva till filen direkt, utan hjälp av filsystemet. Detta är ett problem på filer med hål eller på copy-on-write-filer på filsystem som Btrfs.

Kommandon som cp(1) eller truncate(1) skapar filer med hål. Dessa filer kommer att avvisas av swapon.

Förallokerade filer som skapats av fallocate(1) kan tolkas som filer med hål beroende på filsystemet. Förallokerade växlingsfiler stöds på XFS sedan Linux 4.18.

Den mest portabla lösningen för att skapa en växlingsfil är att använda dd(1) och /dev/zero.

Växlingsfiler på Btrfs stöds sedan Linux 5.0 på filer med nocow-attributet. Se manualsidan för btrfs(5) för mer information.

Sedan version 2.41 kan kommandot mkswap --file skapa en ny växlingsfil med attributet nocow.

Växling över NFS kanske inte fungerar.

swapon upptäcker automatiskt och skriver om en signatur för ett swaputrymme med gamla väntelägesdata för programvara (t.ex. S1SUSPEND, S2SUSPEND, ...). Problemet är att om vi inte gör det får vi datakorruption nästa gång ett försök till unsuspending görs.

Kommandot swapon dök upp i 4.0BSD.

swapoff(2), swapon(2), fstab(5), init(8), fallocate(1), mkswap(8), mount(8), rc(8)

För felrapporter, använd felhanteraren https://github.com/util-linux/util-linux/issues.

Kommandot swapon ingår i paketet util-linux som kan hämtas från Linux Kernel Archive https://www.kernel.org/pub/linux/utils/util-linux/.

2026-05-18 util-linux 2.42.1