'\" t
.\"     Title: mkswap
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Керування системою
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "MKSWAP" "8" "2024-04-27" "util\-linux 2.40" "Керування системою"
.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 "НАЗВА"
mkswap \- налаштовування області резервної пам\*(Aqяті Linux
.SH "КОРОТКИЙ ОПИС"
.sp
\fBmkswap\fP [options] \fIdevice\fP [\fIblocks\fP]
.sp
\fBmkswap\fP [options] \-\-size \fIsize\fP \-\-file \fIfile\fP
.SH "ОПИС"
.sp
\fBmkswap\fP sets up a Linux swap area on a device or in a file.
.sp
Аргументом \fIпристрій\fP, зазвичай, є розділ диска (щось подібне до \fI/dev/sdb7\fP), але ним може бути і файл. Ядро Linux не обробляє ідентифікатори розділів, але у багатьох скриптах встановлення припускають, що розділи, що належать до шістнадцяткового типу 82 (LINUX_SWAP), призначено для розділів резервної пам\(cqяті. (\fBПопередження: для розділів Solaris теж використано цей тип. Будьте обережні, щоб не знищити ваші розділи Solaris.\fP)
.sp
Параметр \fIблоки\fP є зайвим, але його підтримку збережено з міркувань зворотної сумісності. (Він задає бажаний розмір області резервної пам\(cqяті у 1024\-байтових блоках. \fBmkswap\fP використовуватиме увесь розділ або файл, якщо параметр не вказано. Не варто його вказувати \- малесенька друкарська помилка може знищити вміст вашого диска.)
.sp
Після створення області резервної пам\(cqяті, вам слід віддати команду \fBswapon\fP(8), щоб почати нею користуватися. Зазвичай, області резервної пам\(cqяті потрапляють до списку \fI/etc/fstab\fP, отже, система починає ними користуватися під час завантаження після команди \fBswapon \-a\fP, яка є частиною скрипту завантаження.
.SH "ПОПЕРЕДЖЕННЯ"
.sp
Заголовок резервної пам\(cqяті не використовує перший блок. Там можуть бути завантажувач або мітка диска, але розміщувати їх там не варто. Рекомендованим є використання окремого розділу для області резервної пам\(cqяті Linux.
.sp
\fBmkswap\fP, like many others mkfs\-like utils, \fBerases the first partition block to make any previous filesystem invisible.\fP
.sp
Втім, \fBmkswap\fP відмовляється витирати перший блок на пристрої із міткою диска (SUN, BSD, ...).
.SH "ПАРАМЕТРИ"
.sp
\fB\-c\fP, \fB\-\-check\fP
.RS 4
Перед створенням області резервної пам\(cqяті перевірити пристрій (якщо це блоковий пристрій) на наявність помилкових блоків. Якщо буде знайдено помилкові блоки, програма виведе дані щодо їхньої кількості.
.RE
.sp
\fB\-F\fP, \fB\-\-file\fP
.RS 4
Створити файл резервної пам\(cqяті із відповідними правами доступу до файла та заповненими блоками на диску.
.RE
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
Виконати команду, навіть якщо вона безглузда. Уможливлює створення області резервної пам\(cqяті, розмір якої перевищує розмір файла або розділу, на якому вона зберігається.
.sp
Також, без цього параметра, \fBmkswap\fP відмовлятиметься витирати перший блок на пристрої із таблицею розділів.
.RE
.sp
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
Придушити виведення даних і повідомлень із попередженнями.
.RE
.sp
\fB\-L\fP, \fB\-\-label\fP \fIмітка\fP
.RS 4
Вказати \fIмітку\fP пристрою, щоб уможливити виконання \fBswapon\fP(8) із параметром мітки.
.RE
.sp
\fB\-\-lock\fP[=\fIрежим\fP]
.RS 4
Скористатися виключним блокуванням BSD для пристрою або файла, який ним керує. Значенням додаткового аргументу \fIрежим\fP може бути \fByes\fP, \fBno\fP (або 1 і 0) чи \fBnonblock\fP. Якщо пропустити аргумент \fIрежим\fP, типовим значенням буде \fB"yes"\fP. Цей параметр переписує змінну середовища \fB$LOCK_BLOCK_DEVICE\fP. Типовим станом є невикористання блокування, але рекомендуємо уникати конфліктів із \fBsystemd\-udevd\fP(8) або іншими програмами.
.RE
.sp
\fB\-p\fP, \fB\-\-pagesize\fP \fIрозмір\fP
.RS 4
Вказати \fIрозмір\fP сторінки (у байтах). Зазвичай, потреби у визначенні цього параметра немає; \fBmkswap\fP читає розмір з ядра.
.RE
.sp
\fB\-U\fP, \fB\-\-uuid\fP \fIUUID\fP
.RS 4
Вказати \fIUUID\fP, яким слід скористатися. Типовим є створення UUID. Форматом UUID є послідовності шістнадцяткових цифр, відокремлених дефісами, ось так: «c1b9d5a2\-f162\-11cf\-9ece\-0020afc76f16». Параметр UUID також може мати одне з таких значень:
.sp
\fBclear\fP
.RS 4
очистити UUID файлової системи
.RE
.sp
\fBrandom\fP
.RS 4
створити новий випадковий UUID
.RE
.sp
\fBtime\fP
.RS 4
створити новий UUID на основі позначки часу
.RE
.RE
.sp
\fB\-e\fP, \fB\-\-endianness\fP \fIПОРЯДОКБАЙТІВ\fP
.RS 4
Вказати \fIПОРЯДОКБАЙТІВ\fP, яким слід скористатися. Коректні значення \fBnative\fP, \fBlittle\fP та \fBbig\fP. Типовим є значення \fBnative\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIвідступ\fP
.RS 4
Вказати \fIвідступ\fP для запису області резервної пам\(cqяті.
.RE
.sp
\fB\-s\fP, \fB\-\-size\fP \fIрозмір\fP
.RS 4
Вказати розмір створеного файла резервної пам\(cqяті у байтах, можна додавати суфікси одиниць KiB (=1024), MiB (=1024*1024) тощо для GiB, TiB, PiB, EiB, ZiB та YiB (частина «iB» є необов\(cqязковою, наприклад, «K» є тим самим, що і «KiB»). Якщо файл вже існує і має розмір, що перевищує \fIрозмір\fP, його буде обрізано до вказаного розміру. Цей параметр має сенс, лише якщо його використано разом із \fB\-\-file\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-swapversion 1\fP
.RS 4
Вказати версію простору резервної пам\(cqяті. (У визначенні цього параметра у сучасних умовах немає сенсу, оскільки старий варіант \fB\-v 0\fP став застарілим, і у поточних умовах передбачено підтримку лише \fB\-v 1\fP. У ядрі не передбачено підтримки формату простору резервної пам\(cqяті версії 0 з часу випуску версії 2.5.22 (червень 2002 року). Підтримку нової версії 1 передбачено з версії 2.1.117 (серпень 1998 року).)
.RE
.sp
\fB\-\-verbose\fP
.RS 4
Режим докладних повідомлень. З цим параметром \fBmkswap\fP виводитиме докладніші повідомлення щодо виявлених проблем під час налаштовування області резервної пам\(cqяті.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Вивести текст довідки і завершити роботу.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Вивести дані щодо версії і завершити роботу.
.RE
.SH "СЕРЕДОВИЩЕ"
.sp
LIBBLKID_DEBUG=all
.RS 4
вмикає показ діагностичних повідомлень libblkid.
.RE
.sp
LOCK_BLOCK_DEVICE=<режим>
.RS 4
використати виключне блокування BSD. Режимом може бути «1» або «0». Див. \fB\-\-lock\fP, щоб дізнатися більше.
.RE
.SH "ЗАУВАЖЕННЯ"
.sp
Максимальний корисний розмір області резервної пам\(cqяті залежить від архітектури і версії ядра системи.
.sp
Максимальна кількість сторінок, які можна адресувати у заголовку області резервної пам\(cqяті дорівнює 4294967295 (максимальне значення 32\-бітового цілого числа без знаку). Решту місця на пристрої резервної пам\(cqяті буде проігноровано.
.sp
У поточних версіях Linux уможливлює використання 32 областей резервної пам\(cqяті. Області резервної пам\(cqяті можна переглядати у файлі \fI/proc/swaps\fP.
.sp
\fBmkswap\fP refuses areas smaller than 10 pages.
.sp
Якщо вам не відомий розмір сторінки, який використано у вашій системі, ви можете ознайомитися із ним за допомогою команди \fBgetconf PAGESIZE\fP.
.sp
Щоб налаштувати файл резервної пам\(cqяті, слід створити цей файл до його ініціалізації за допомогою \fBmkswap\fP, наприклад, за допомогою командного рядка
.sp
.if n .RS 4
.nf
.fam C
# dd if=/dev/zero of=swapfile bs=1MiB count=$((8*1024))
.fam
.fi
.if n .RE
.sp
для створення файла резервної пам\(cqяті розміром у 8 ГіБ.
.sp
Будь ласка, ознайомтеся із зауваженнями на сторінці підручника \fBswapon\fP(8) щодо \fBобмежень використання файла резервної пам\(cqяті\fP (дірки, попередній розподіл і проблеми із копіюванням при записі).
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.sp
\fBfdisk\fP(8),
\fBswapon\fP(8)
.SH "ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ"
.sp
Для звітування щодо вад скористайтеся системою стеження за вадами \- \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "ДОСТУП ДО ПРОГРАМИ"
.sp
Програма \fBmkswap\fP є частиною пакунка util\-linux, який можна отримати з \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "архіву ядра Linux" "."