'\" t
.\"     Title: swapon
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: Systemadministration
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "SWAPON" "8" "2026-05-18" "util\-linux 2.42.1" "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
All devices marked as "swap" in \fI/etc/fstab\fP are made available, except for those with the "noauto" option. Devices that are already being used as swap are silently skipped. See the \fBFSTAB CONFIGURATION\fP section for more details.
.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 i katalogen enligt \fBstrverscmp\fP(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.
.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\fIwhen\fP]
.RS 4
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 \fIwhen\fP argument can be \fBalways\fP, \fBnever\fP, or \fBauto\fP. If the argument is omitted, it defaults to \fBauto\fP, which means that annotations will only be used when the output goes to a 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 \fB\-\-visa\fP utdata 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 CONFIGURATION"
.sp
The command \fBswapon \-\-all\fP reads configuration from \fI/etc/fstab\fP (or from a file specified by the \fB\-\-fstab\fP command line option). Only fstab entries with the filesystem type (3rd field) set to "swap" are relevant.
.sp
The option \fB\-\-options\fP accepts values in the same form as can be specified in the fourth field in fstab.
.SS "The first field (source)"
.sp
Specify the swap source. If the source is a regular file, it is addressed by an absolute path.
.sp
If the swap is a block device, it can be addressed by device path, swap area tags \fBLABEL=\fP or \fBUUID=\fP (see \fBmkswap\fP(8) for more details), or by partition tags like \fBPARTLABEL=\fP or \fBPARTUUID=\fP.
.SS "The second field (target)"
.sp
Unused by \fBswapon\fP, the recommended convention is to use "none".
.SS "The third field (type)"
.sp
Requires "swap" as the filesystem type.
.SS "The fourth field (options)"
.sp
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 \fIfstab\fP extend or overwrite settings specified on the \fBswapon\fP command line.
.sp
Supported swap options:
.sp
\fBnoauto\fP
.RS 4
Ignore entry when \fBswapon \-\-all\fP is given.
.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
Enable swap discard. The supported settings are \fBdiscard\fP, \fBdiscard=once\fP, or \fBdiscard=pages\fP. For more details, see the \fB\-\-discard\fP command line option.
.RE
.sp
\fBpri=\fP\fIpriority\fP
.RS 4
Specify the priority of the swap device. For more details, see the \fB\-\-priority\fP command line option.
.RE
.SS "The fifth field"
.sp
Unused by \fBswapon\fP, the recommended convention is to keep it empty.
.SS "The sixth field"
.sp
Unused by \fBswapon\fP, the recommended convention is to keep it empty.
.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
standardutrustning för personsökning
.RE
.sp
\fI/etc/fstab\fP
.RS 4
ascii\-tabell för beskrivning av filsystem
.RE
.SH "ANTECKNINGAR"
.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" "."