Scroll to navigation

SWAPON(8) Керування системою SWAPON(8)

НАЗВА

swapon, swapoff - вимикання пристроїв і файлів для поділу на сторінки і резервування

КОРОТКИЙ ОПИС

swapon [параметри] [спеціальний-файл...]

swapoff [-va] [спеціальний-файл...]

ОПИС

swapon використовують для визначення пристроїв, на яких відбуватиметься поділ на сторінки та робота із резервною пам’яттю.

Використаний пристрій або файл задає параметр спеціальний-файл. Його може бути задано у формі -L мітка або -U uuid для визначення пристрою за міткою або UUID.

Виклик swapon, зазвичай, відбувається зі скриптів завантаження системи, які роблять усі пристрої резервної пам’яті доступними, тому дії з поділу на сторінки і роботи із резервною пам’яттю на диску розподіляються між декількома пристроями і файлами.

swapoff вимикає резервну пам’ять на вказаних пристроях і у файлах. Якщо задано прапорець -a, резервну пам’ять на диску вимкнено для усіх відомих пристроїв і файлів резервної пам’яті (які буде знайдено у /proc/swaps або /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 шлях

Вказує альтернативний файл fstab для забезпечення сумісності із mount(8). Якщо шлях є каталогом, файли у каталозі буде упорядковано strverscmp(3); файли, назви яких починаються з «.» або не мають суфікса .fstab, буде проігноровано. Параметр можна вказати декілька разів. Цей параметр, здебільшого, було створено для скриптів initramfs або chroot, де вказано додаткові налаштування поза стандартними налаштуваннями системи.

-d, --discard[=правила]

Увімкнути відкидання резервної пам’яті на диску, якщо підтримку дії з відкидання або обрізання передбачено для базового пристрою резервної пам’яті. Це може удосконалити швидкодію на деяких пристроях SSD, але часто цього не відбувається. За допомогою цього параметра можна вибрати між двома доступними правилами відкидання резервної пам’яті на диску:

--discard=once

для виконання одноразової дії з відкидання для усієї області резервної пам’яті на диску при виконанні swapon; або

--discard=pages

для асинхронного відкидання вивільнених сторінок резервної пам’яті на диску до того, як вони стануть доступними для повторного використання.

Якщо не вибрано жодних правил, типовою поведінкою буде вмикання обох типів відкидання. Для вмикання прапорців відкидання можна також скористатися параметрами монтування /etc/fstab discard, discard=once або discard=pages.

-e, --ifexists

Без повідомлень пропускати пристрої, яких не існує. Також для пропускання пристроїв, яких не існує, можна скористатися параметром монтування nofail в /etc/fstab.

-f, --fixpgsz

Повторно ініціалізувати (виконати mkswap) простір резервної пам’яті, якщо розмір його сторінки не відповідає розміру у поточному запущеному ядрі системи. mkswap(8) ініціалізує увесь пристрій і не перевіряє пристрій на наявність помилкових блоків.

-L мітка

Використати розділ, який має вказану мітку. (Для цього потрібен доступу до /proc/partitions.)

-o, --options параметри

Вказати параметри резервної пам’яті на диску за допомогою сумісного з fstab рядка відокремлених комами значень. Приклад:

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

Рядок параметри буде оброблено останнім, він має вищий пріоритет над усіма іншими параметрами рядка команди.

-p, --priority пріоритетність

Вказати пріоритетність пристрою резервної пам’яті. пріоритетність є значенням від -1 до 32767. Більші значення означають вищу пріоритетність. Див. swapon(2), щоб ознайомитися із усіма описами пріоритетностей резервної пам’яті на диску. Додайте pri=значення до поля параметрів /etc/fstab, щоб скористатися у поєднанні із swapon -a. Якщо пріоритетності не визначено, типовим значенням для ядра Linux буде від’ємне число.

-s, --summary

Вивести резюме щодо використання резервної пам’яті на диску за пристроями. Еквівалент cat /proc/swaps. Цей формат виведення даних є ЗАСТАРІЛИМ, його замінено на параметр --show, який забезпечує краще керування виведенням даних.

--show[=стовпчик...]

Вивести придатну до визначення таблицю областей резервної пам’яті на диску. Див. виведення команди з параметром --help, щоб ознайомитися зі списком доступних стовпчиків.

--output-all

Вивести список усіх доступних стовпчиків.

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

Не виводити заголовки при виведенні на основі --show.

--raw

Виводити дані --show без вирівнювання стовпчиків таблиці.

--bytes

Показати розмір області свопінгу (резервної пам’яті) у байтах у виведенні --show замість зручних для читання одиниць.

-U uuid

Використати розділ, який має вказаний uuid.

-v, --verbose

Режим докладних повідомлень.

-h, --help

Вивести текст довідки і завершити роботу.

-V, --version

Показати дані щодо версії і завершити роботу.

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

Не звітувати про помилки для цього пристрою, якщо він не існує.

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.

СТАН ВИХОДУ

swapoff має такі значення стану виходу, починаючи з версії 2.36:

0

успіх

2

у системі недостатньо пам’яті, щоб припинити використання резервної пам’яті на диску (OOM)

4

системний виклик B<swapoff>(2) зазнав невдачі з іншої причини

8

не пов’язана із системним викликом swapoff(2) помилка (не вистачає пам’яті...)

16

помилка використання або синтаксична помилка

32

усі виклики swapoff завершилися помилками при використанні --all

64

деякі з викликів swapoff було здійснено успішно при використанні з --all

Команда swapoff --all повертає 0 (усі успішно), 32 (усі невдало) або 64 (деякі невдало, деякі успішно).

+ У старих версіях до 2.36 не мали документованих стані виходу, 0 означає «успіх» в усіх версіях.

СЕРЕДОВИЩЕ

LIBMOUNT_DEBUG=all

вмикає показ діагностичних повідомлень libmount.

LIBBLKID_DEBUG=all

вмикає показ діагностичних повідомлень libblkid.

ФАЙЛИ

/dev/sd??

стандартні пристрої поділу на сторінки

/etc/fstab

таблиця опису файлової системи символами ASCII

ЗАУВАЖЕННЯ

Файли з дірками

Реалізація файла резервної пам’яті у ядрі передбачає можливість запису до файла безпосередньо, без допомоги з боку файлової системи. Це є проблемою для файлів із дірками або файлів із копіюванням при запису у файлових системах, які подібні до Btrfs.

Команди like cp(1) і truncate(1) створюють файли з дірками. Ці файли буде відкинуто swapon.

Попередньо розміщені файли, які створено за допомогою fallocate(1), може бути також оброблено як файли із дірками, залежно від файлової системи. Підтримку попереднього розміщення файлів резервної пам’яті на диску у XFS передбачено, починаючи з Linux 4.18.

Найпридатнішим для портування рішенням зі створення файла резервної пам’яті є використання dd(1) і /dev/zero.

Btrfs

Підтримку файлів резервної пам’яті на Btrfs реалізовано, починаючи з Linux 5.0 для файлів із атрибутом nocow. Див. сторінку підручника щодо btrfs(5), щоб дізнатися більше.

Since version 2.41, the command mkswap --file can create a new swap file with the nocow attribute.

NFS

Використання резервної пам’яті із NFS може не працювати.

Призупинення

swapon автоматично виявляє і перезаписує підпис простору резервної пам’яті із застарілими даними призупинення роботи програмного забезпечення (наприклад, S1SUSPEND, S2SUSPEND, ...). Проблема полягає у тому, що якщо цього не робити, ми отримаємо пошкодження даних під час наступної спроби виходу зі стану призупинення.

ЖУРНАЛ

Команда swapon з’явилася у 4.0BSD.

ТАКОЖ ПЕРЕГЛЯНЬТЕ

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

ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ

Для звітування щодо вад скористайтеся системою стеження за вадами <https://github.com/util-linux/util-linux/issues>

ДОСТУП ДО ПРОГРАМИ

Програма swapon є частиною пакунка util-linux, який можна отримати з архіву ядра Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.

2026-03-03 util-linux 2.42-rc1