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

FSTAB CONFIGURATION

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.

  The first field (source)

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

  The second field (target)

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

  The third field (type)

Requires "swap" as the filesystem type.

  The fourth field (options)

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.

  The fifth field

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

  The sixth field

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

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??
    standardutrustning för personsökning

/etc/fstab
    ascii-tabell för beskrivning av filsystem

ANTECKNINGAR

  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

TILLGÄNGLIGHET

Kommandot swapon ingår i paketet util-linux som kan hämtas från