Scroll to navigation

SWAPON(8) Systemadministration SWAPON(8)

NAMN

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

SYNOPSIS

swapon [flaggor] [specialfil...]

swapoff [-va] [specialfil...]

BESKRIVNING

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

FLAGGOR

-a, --all

Alla enheter markerade som ”swap” i /etc/fstab görs tillgängliga, utom de med flaggan ”noauto”. Enheter som redan används som växlingsutrymme hoppas över utan meddelande. Se avsnittet FSTAB-KONFIGURATION för mer information.

-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 med strverscmp(3); filer som börjar med ”.” eller saknar tillägget .fstab ignoreras. Alternativet kan anges mer än en gång och är främst avsett för initramfs- eller chroot-skript med ytterligare konfiguration utöver systemets standardkonfiguration.

-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[=när]

Lägger till en anmärkning till varje kolumnrubrik. Anmärkningen kan visas som ett verktygstips i terminaler som stöder detta. Det valfria argumentet när kan vara always, never eller auto. Om argumentet utelämnas används auto, vilket innebär att anmärkningar endast används när utdata går till en terminal.

--noheadings

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

--raw

Visa utdata från --show 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.

FSTAB-KONFIGURATION

Kommandot swapon --all läser konfiguration från /etc/fstab (eller från en fil som anges med kommandoradsflaggan --fstab). Endast fstab-poster med filsystemstypen (tredje fältet) ”swap” är relevanta.

Flaggan --options accepterar värden i samma form som kan anges i det fjärde fältet i fstab.

Det första fältet (källa)

Ange källan för växlingsutrymmet. Om källan är en vanlig fil adresseras den med en absolut sökväg.

Om växlingsutrymmet är en blockenhet kan den adresseras med enhetssökväg, växlingsområdestaggarna LABEL= eller UUID= (se mkswap(8) för mer information), eller partitionstaggar som PARTLABEL= eller PARTUUID=.

Det andra fältet (mål)

Används inte av swapon. Rekommenderad konvention är att använda ”none”.

Det tredje fältet (typ)

Kräver ”swap” som filsystemstyp.

Det fjärde fältet (flaggor)

Formateras som en kommaseparerad lista över flaggor. Alla okända flaggor ignoreras utan meddelande. Om inga flaggor behövs är rekommenderad konvention att använda ”defaults”. Flaggorna i fstab utökar eller åsidosätter inställningarna på kommandoraden för swapon.

Växlingsflaggor som stöds:

noauto

Ignorera posten när swapon --all anges.

nofail

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

discard[=policy]

Aktivera kassering av växlingsutrymme. Inställningar som stöds är discard, discard=once eller discard=pages. Se kommandoradsflaggan --discard för mer information.

pri=prioritet

Ange växlingsenhetens prioritet. Se kommandoradsflaggan --priority för mer information.

Det femte fältet

Används inte av swapon. Rekommenderad konvention är att lämna det tomt.

Det sjätte fältet

Används inte av swapon. Rekommenderad konvention är att lämna det tomt.

AVSLUTSSTATUS

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.

MILJÖ

LIBMOUNT_DEBUG=all

aktiverar libmount felsökningsutdata.

LIBBLKID_DEBUG=all

aktiverar libblkid felsökningsutdata.

FILER

/dev/sd??

standardenheter för sidväxling

/etc/fstab

ascii-tabell för beskrivning av filsystem

ANMÄRKNINGAR

Filar med hål

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.

Btrfs

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.

NFS

Växling över NFS kanske inte fungerar.

Pausa

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.

HISTORIK

Kommandot swapon dök upp i 4.0BSD.

SE ÄVEN

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

FELRAPPORTERING

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

TILLGÄNGLIGHET

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-09-25 util-linux 2.42.4