НАЗВА

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

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

       swapon [options] [specialfile...]

       swapoff [-va] [specialfile...]

ОПИС

       swapon is used to specify devices on which paging and swapping are to take place.

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

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

       swapoff disables swapping on the specified devices and files. When the -a flag is given,
       swapping is disabled on all known swap devices and files (as found in /proc/swaps or
       /etc/fstab).

ПАРАМЕТРИ

       -a, --all
           Усі пристрої, які позначено як «swap» в /etc/fstab, буде зроблено доступними, окрім
           тих, які вказано із параметром «noauto». Пристрої, які вже використовуються для
           резервної пам’яті, буде без повідомлень пропущено.

       -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
           Вивести список усіх доступних стовпчиків.

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

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

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

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

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

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

       -V, --version
           Вивести дані щодо версії і завершити роботу.

СТАН ВИХОДУ

       swapoff has the following exit status values since v2.36:

       0
           успіх

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

       4
           swapoff(2) syscall failed for another reason

       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), щоб дізнатися більше.

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

   Призупинення
       swapon automatically detects and rewrites a swap space signature with old software suspend
       data (e.g., S1SUSPEND, S2SUSPEND, ...). The problem is that if we don’t do it, then we get
       data corruption the next time an attempt at unsuspending is made.

ЖУРНАЛ

       Команда 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/>.