'\" t
.\"     Title: swapon
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-21
.\"    Manual: Systemadministration
.\"    Source: util-linux 2.42.4
.\"  Language: English
.\"
.TH "SWAPON" "8" "2026-09-21" "util\-linux 2.42.4" "Systemadministration"
.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 "NAMN"
swapon, swapoff \- aktivera/inaktivera enheter och filer för paging och växling
.SH "SYNOPSIS"
.sp
\fBswapon\fP [flaggor] [\fIspecialfil\fP.\|.\|.]
.sp
\fBswapoff\fP [\fB\-va\fP] [\fIspecialfil\fP.\|.\|.]
.SH "BESKRIVNING"
.sp
\fBswapon\fP används för att ange enheter på vilka paging och swapping ska ske.
.sp
Den enhet eller fil som används anges av parametern \fIspecialfile\fP. Den kan vara av formen \fB\-L\fP \fIetikett\fP eller \fB\-U\fP \fIuuid\fP för att ange en enhet med label eller uuid.
.sp
Anrop till \fBswapon\fP 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.
.sp
\fBswapoff\fP inaktiverar swapping på de angivna enheterna och filerna. När flaggan \fB\-a\fP anges inaktiveras swapping på alla kända swap\-enheter och \-filer (som finns i \fI/proc/swaps\fP eller \fI/etc/fstab\fP).
.SH "FLAGGOR"
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Alla enheter markerade som ”swap” i \fI/etc/fstab\fP görs tillgängliga, utom de med flaggan ”noauto”. Enheter som redan används som växlingsutrymme hoppas över utan meddelande. Se avsnittet \fBFSTAB\-KONFIGURATION\fP för mer information.
.RE
.sp
\fB\-T\fP, \fB\-\-fstab\fP \fIsökväg\fP
.RS 4
Anger en alternativ fstab\-fil för kompatibilitet med \fBmount\fP(8). Om \fIsökväg\fP är en katalog sorteras filerna med \fBstrverscmp\fP(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.
.RE
.sp
\fB\-d\fP, \fB\-\-discard\fP[\fB=\fP\fIpolicy\fP]
.RS 4
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:
.sp
\fB\-\-discard=once\fP
.RS 4
för att utföra en engångskastning för hela växlingsområdet vid swapon; eller
.RE
.sp
\fB\-\-discard=pages\fP
.RS 4
för att asynkront kasta bort frigjorda växlingssidor innan de är tillgängliga för återanvändning.
.RE
.sp
Om ingen policy har valts är standardbeteendet att aktivera båda diskningstyperna. Monteringsflaggorna \fI/etc/fstab\fP \fBdiscard\fP, \fBdiscard=once\fP eller \fBdiscard=pages\fP kan också användas för att aktivera discard\-flaggor.
.RE
.sp
\fB\-e\fP, \fB\-\-ifexists\fP
.RS 4
Hoppa tyst över enheter som inte finns. Monteringsflaggan \fBnofail\fP i \fI/etc/fstab\fP kan också användas för att hoppa över icke\-existerande enheter.
.RE
.sp
\fB\-f\fP, \fB\-\-fixpgsz\fP
.RS 4
Återinitialisera (exekvera mkswap) swaputrymmet om dess sidstorlek inte matchar den för den aktuella kärnan. \fBmkswap\fP(8) initierar hela enheten och kontrollerar inte om det finns dåliga block.
.RE
.sp
\fB\-L\fP \fIetikett\fP
.RS 4
Använd den partition som har den angivna \fIetikett\fP. (För detta krävs åtkomst till \fI/proc/partitions\fP.)
.RE
.sp
\fB\-o\fP, \fB\-\-options\fP \fIopts\fP
.RS 4
Ange växlingsflaggor med en kommaseparerad sträng som är kompatibel med \fIfstab\fP. Till exempel:
.sp
\fBswapon \-o pri=1,discard=pages,nofail /dev/sda2\fP
.sp
Strängen \fIopts\fP utvärderas sist och åsidosätter alla andra kommandoradsflaggor.
.RE
.sp
\fB\-p\fP, \fB\-\-priority\fP \fIpriority\fP
.RS 4
Ange prioriteten för växlingsenheten. \fIpriority\fP är ett värde mellan 0 och 32767. Högre siffror anger högre prioritet. Se \fBswapon\fP(2) för en fullständig beskrivning av växlingsprioriteter. Lägg till \fBpri=\fP\fIvärde\fP i flaggfältet i \fI/etc/fstab\fP för användning med \fBswapon \-a\fP. När ingen prioritet är definierad använder Linux\-kärnan negativa tal som standard.
.RE
.sp
\fB\-s\fP, \fB\-\-summary\fP
.RS 4
Visa en sammanfattning av växlingsanvändningen per enhet. Motsvarar \fBcat /proc/swaps\fP. Detta utdataformat är FÖRÅLDRAT till förmån för \fB\-\-show\fP som ger bättre kontroll över utdata.
.RE
.sp
\fB\-\-show\fP[\fB=\fP\fIcolumn\fP.\|.\|.]
.RS 4
Visar en definierbar tabell över växlingsområden. Se \fB\-\-help\fP för en lista över tillgängliga kolumner.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
Skriv ut alla tillgängliga kolumner.
.RE
.sp
\fB\-\-annotate\fP[\fB=\fP\fInär\fP]
.RS 4
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 \fInär\fP kan vara \fBalways\fP, \fBnever\fP eller \fBauto\fP. Om argumentet utelämnas används \fBauto\fP, vilket innebär att anmärkningar endast används när utdata går till en terminal.
.RE
.sp
\fB\-\-noheadings\fP
.RS 4
Skriv inte ut rubriker när du visar \fB\-\-show\fP\-utdata.
.RE
.sp
\fB\-\-raw\fP
.RS 4
Visa utdata från \fB\-\-show\fP utan att justera tabellkolumnerna.
.RE
.sp
\fB\-\-bytes\fP
.RS 4
Visa växlingsstorlek i byte i \fB\-\-show\fP\-utdata istället för i användarvänliga enheter.
.RE
.sp
\fB\-U\fP \fIuuid\fP
.RS 4
Använd den partition som har den angivna \fIuuid\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Var utförlig.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Visa hjälptext och avsluta.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Visa version och avsluta.
.RE
.SH "FSTAB\-KONFIGURATION"
.sp
Kommandot \fBswapon \-\-all\fP läser konfiguration från \fI/etc/fstab\fP (eller från en fil som anges med kommandoradsflaggan \fB\-\-fstab\fP). Endast fstab\-poster med filsystemstypen (tredje fältet) ”swap” är relevanta.
.sp
Flaggan \fB\-\-options\fP accepterar värden i samma form som kan anges i det fjärde fältet i fstab.
.SS "Det första fältet (källa)"
.sp
Ange källan för växlingsutrymmet. Om källan är en vanlig fil adresseras den med en absolut sökväg.
.sp
Om växlingsutrymmet är en blockenhet kan den adresseras med enhetssökväg, växlingsområdestaggarna \fBLABEL=\fP eller \fBUUID=\fP (se \fBmkswap\fP(8) för mer information), eller partitionstaggar som \fBPARTLABEL=\fP eller \fBPARTUUID=\fP.
.SS "Det andra fältet (mål)"
.sp
Används inte av \fBswapon\fP. Rekommenderad konvention är att använda ”none”.
.SS "Det tredje fältet (typ)"
.sp
Kräver ”swap” som filsystemstyp.
.SS "Det fjärde fältet (flaggor)"
.sp
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 \fIfstab\fP utökar eller åsidosätter inställningarna på kommandoraden för \fBswapon\fP.
.sp
Växlingsflaggor som stöds:
.sp
\fBnoauto\fP
.RS 4
Ignorera posten när \fBswapon \-\-all\fP anges.
.RE
.sp
\fBnofail\fP
.RS 4
Rapportera inte fel för den här enheten om den inte finns.
.RE
.sp
\fBdiscard\fP[\fB=\fP\fIpolicy\fP]
.RS 4
Aktivera kassering av växlingsutrymme. Inställningar som stöds är \fBdiscard\fP, \fBdiscard=once\fP eller \fBdiscard=pages\fP. Se kommandoradsflaggan \fB\-\-discard\fP för mer information.
.RE
.sp
\fBpri=\fP\fIprioritet\fP
.RS 4
Ange växlingsenhetens prioritet. Se kommandoradsflaggan \fB\-\-priority\fP för mer information.
.RE
.SS "Det femte fältet"
.sp
Används inte av \fBswapon\fP. Rekommenderad konvention är att lämna det tomt.
.SS "Det sjätte fältet"
.sp
Används inte av \fBswapon\fP. Rekommenderad konvention är att lämna det tomt.
.SH "AVSLUTSSTATUS"
.sp
\fBswapoff\fP har följande utgångsstatusvärden sedan v2.36:
.sp
\fB0\fP
.RS 4
lyckades
.RE
.sp
\fB2\fP
.RS 4
systemet har inte tillräckligt med minne för att stoppa växlingen (OOM)
.RE
.sp
\fB4\fP
.RS 4
\fBswapoff\fP(2) syscall misslyckades av annan anledning
.RE
.sp
\fB8\fP
.RS 4
non\-\fBswapoff\fP(2) syscall systemfel (slut på minne, .\|.\|.)
.RE
.sp
\fB16\fP
.RS 4
användnings\- eller syntaxfel
.RE
.sp
\fB32\fP
.RS 4
alla swapoff misslyckades på \fB\-\-all\fP
.RE
.sp
\fB64\fP
.RS 4
vissa swapoff lyckades på \fB\-\-all\fP
.RE
.sp
Kommandot \fBswapoff \-\-all\fP returnerar 0 (alla lyckades), 32 (alla misslyckades) eller 64 (några misslyckades, några lyckades).
.sp
+
De gamla versionerna före v2.36 har ingen dokumenterad utgångsstatus, 0 betyder framgång i alla versioner.
.SH "MILJÖ"
.sp
\fBLIBMOUNT_DEBUG\fP=all
.RS 4
aktiverar \fBlibmount\fP felsökningsutdata.
.RE
.sp
\fBLIBBLKID_DEBUG\fP=all
.RS 4
aktiverar \fBlibblkid\fP felsökningsutdata.
.RE
.SH "FILER"
.sp
\fI/dev/sd??\fP
.RS 4
standardenheter för sidväxling
.RE
.sp
\fI/etc/fstab\fP
.RS 4
ascii\-tabell för beskrivning av filsystem
.RE
.SH "ANMÄRKNINGAR"
.SS "Filar med hål"
.sp
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.
.sp
Kommandon som \fBcp\fP(1) eller \fBtruncate\fP(1) skapar filer med hål. Dessa filer kommer att avvisas av \fBswapon\fP.
.sp
Förallokerade filer som skapats av \fBfallocate\fP(1) kan tolkas som filer med hål beroende på filsystemet. Förallokerade växlingsfiler stöds på XFS sedan Linux 4.18.
.sp
Den mest portabla lösningen för att skapa en växlingsfil är att använda \fBdd\fP(1) och \fI/dev/zero\fP.
.SS "Btrfs"
.sp
Växlingsfiler på Btrfs stöds sedan Linux 5.0 på filer med \fBnocow\fP\-attributet. Se manualsidan för \fBbtrfs\fP(5) för mer information.
.sp
Sedan version 2.41 kan kommandot \fBmkswap \-\-file\fP skapa en ny växlingsfil med attributet \fBnocow\fP.
.SS "NFS"
.sp
Växling över \fBNFS\fP kanske inte fungerar.
.SS "Pausa"
.sp
\fBswapon\fP upptäcker automatiskt och skriver om en signatur för ett swaputrymme med gamla väntelägesdata för programvara (t.ex. \fBS1SUSPEND\fP, \fBS2SUSPEND\fP, .\|.\|.). 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.
.SH "HISTORIK"
.sp
Kommandot \fBswapon\fP dök upp i 4.0BSD.
.SH "SE ÄVEN"
.sp
\fBswapoff\fP(2), \fBswapon\fP(2), \fBfstab\fP(5), \fBinit\fP(8), \fBfallocate\fP(1), \fBmkswap\fP(8), \fBmount\fP(8), \fBrc\fP(8)
.SH "FELRAPPORTERING"
.sp
För felrapporter, använd \c
.URL "https://github.com/util\-linux/util\-linux/issues" "felhanteraren" "."
.SH "TILLGÄNGLIGHET"
.sp
Kommandot \fBswapon\fP ingår i paketet util\-linux som kan hämtas från \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."