'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Керування системою
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "LOSETUP" "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 "НАЗВА"
losetup \- налаштувати петльові пристрої або керувати ними
.SH "КОРОТКИЙ ОПИС"
.sp
Отримати інформацію:
.sp
\fBlosetup\fP [\fIloopdev\fP]
.sp
\fBlosetup\fP \fB\-l\fP [\fB\-a\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIfile\fP [\fB\-o\fP \fIoffset\fP]
.sp
Від\(cqєднати петльовий пристрій:
.sp
\fBlosetup\fP \fB\-d\fP \fIloopdev\fP ...
.sp
Від\(cqєднання усіх пов\(cqязаних петльових пристроїв:
.sp
\fBlosetup\fP \fB\-D\fP
.sp
Налаштовування петльового пристрою:
.sp
\fBlosetup\fP [\fB\-o\fP \fIoffset\fP] [\fB\-\-sizelimit\fP \fIsize\fP] [\fB\-\-sector\-size\fP \fIsize\fP] [\fB\-\-loop\-ref\fP \fIname\fP] [\fB\-Pr\fP] [\fB\-\-show\fP] \fB\-f\fP|\fIloopdev file\fP
.sp
Зміна розміру петльового пристрою:
.sp
\fBlosetup\fP \fB\-c\fP \fIloopdev\fP
.SH "ОПИС"
.sp
\fBlosetup\fP is used to associate loop devices with regular files or block devices, to detach loop devices, and to query the status of a loop device. If only the \fIloopdev\fP argument is given, the status of the corresponding loop device is shown. If no option is given, all loop devices are shown.
.sp
Зауважте, що старий формат виведення (тобто \fBlosetup \-a\fP) із рядками, які відокремлено комами, вважається застарілим \- тепер пріоритетним є формат виведення \fB\-\-list\fP.
.sp
Існує можливість створювати декілька незалежних петльових пристроїв для одного базового файла. \fBТака конфігурація може бути небезпечною, може спричинити втрату даних, пошкодження і перезапис.\fP Скористайтеся параметром \fB\-\-nooverlap\fP із \fB\-\-find\fP під час налаштовування, щоб уникнути цієї проблеми.
.sp
Налаштовування петльового пристрою не є атомарною дією при використанні з \fB\-\-find\fP, і \fBlosetup\fP не захищає цю дію будь\-яким блокуванням. Кількість спроб на внутрішньому рівні обмежено максимумом у 16. Рекомендуємо скористатися, наприклад, \fBflock\fP(1), щоб уникнути конфліктів у значно паралелізованих випадках використання.
.SH "ПАРАМЕТРИ"
.sp
Після аргументів \fIрозмір\fP і \fIвідступ\fP можна додавати суфікси одиниць KiB (=1024), MiB (=1024*1024) тощо для GiB, TiB, PiB, EiB, ZiB та YiB (частина «iB» є необов\(cqязковою, наприклад, «K» є тим самим, що і «KiB») або суфікси KB (=1000), MB (=1000*1000) тощо для GB, TB, PB, EB, ZB і YB.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Вивести стан для усіх петльових пристроїв. Зауважте, що усі відомості є доступні для користувачів, відмінних від root. Див. також \fB\-\-list\fP. Старий формат виведення (який буде виведено без \fB\-\-list\fP) вважається застарілим.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\fP \fIпетльовий\-пристрій\fP...
.RS 4
Від\(cqєднати файл або пристрій, який пов\(cqязано із вказаними петльовими пристроями. Зауважте, що, починаючи з ядра Linux v3.7, ядро використовує «ліниве знищення пристроїв». Дія з від\(cqєднання не повертає помилки \fBEBUSY\fP у нових версіях, якщо пристрій активно використовується системою, пристрій буде позначено прапорцем автоочищення, його буде знищено пізніше.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
Від\(cqєднати усі пов\(cqязані петльові пристрої.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIфайл\fP]
.RS 4
Знайти перший невикористаний петльовий пристрій. Якщо вказано аргумент \fIфайл\fP, скористатися знайденим пристроєм, як петльовим пристроєм. Якщо аргумент не вказано, просто вивести назву пристрою.
.RE
.sp
\fB\-\-show\fP
.RS 4
Вивести назву пов\(cqязаного петльового пристрою, якщо вказано параметр \fB\-f\fP і аргумент \fIфайл\fP.
.RE
.sp
\fB\-L\fP, \fB\-\-nooverlap\fP
.RS 4
Перевірити наявність конфліктів між петльовими пристроями для уникнення ситуацій, коли той самий резервний файл є спільним між декількома петльовими пристроями. Якщо файл вже використано іншим пристроєм, повторно використати пристрій, а не створювати новий. Параметр має сенс лише разом із \fB\-\-find\fP.
.RE
.sp
\fB\-j\fP, \fB\-\-associated\fP \fIфайл\fP [\fB\-o\fP \fIвідступ\fP]
.RS 4
Вивести стан усіх петльових пристроїв, які пов\(cqязано із вказаним \fIфайлом\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIвідступ\fP
.RS 4
Початок даних буде зсунуто на \fIвідступ\fP у вказаному файлі або на вказаному пристрої. Після аргументу \fIвідступ\fP можна вказати суфікс одиниць; див. вище.
.RE
.sp
\fB\-\-loop\-ref\fP \fIрядок\fP
.RS 4
Set reference string. The backwardly compatible default is to use the backing filename as a reference in loop setup ioctl (aka lo_file_name). This option can overwrite this default behavior and set the reference to the \fIstring\fP. The reference may be used by udevd in /dev/loop/by\-ref. Linux kernel does not use the reference at all, but it could be used by some old utils that cannot read the backing file from sysfs. The reference is readable only for the root user (see \fB\-\-output\fP +REF) and it is restricted to 64 bytes.
.RE
.sp
\fB\-\-sizelimit\fP \fIрозмір\fP
.RS 4
Кінець даних буде встановлено у позицію не далі за \fIрозмір\fP байтів після початку даних. Після аргументу \fIрозмір\fP можна вказати суфікс одиниць; див. вище.
.RE
.sp
\fB\-b\fP, \fB\-\-sector\-size\fP \fIрозмір\fP
.RS 4
Встановити розмір логічного сектора петльового пристрою у байтах (починаючи з Linux 4.14). Цим параметром можна скористатися для створення нового петльового пристрою, а також як окремою командою для зміни розміру сектора наявного петльового пристрою.
.RE
.sp
\fB\-c\fP, \fB\-\-set\-capacity\fP \fIпетльовий\-пристрій\fP
.RS 4
Наказати драйверу петльових пристроїв для повторного читання розміру файла, пов\(cqязаного із вказаним петльовим пристроєм.
.RE
.sp
\fB\-P\fP, \fB\-\-partscan\fP
.RS 4
Наказати ядру сканувати таблицю розділів для пошуку новоствореного петльового пристрою. Зауважте, що обробка таблиці розділів залежить від розмірів секторів. Типовий розмір сектора дорівнює 512 байтів. Якщо це не так, вам слід скористатися параметром \fB\-\-sector\-size\fP у поєднанні із \fB\-\-partscan\fP.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-only\fP
.RS 4
Створити придатний лише для читання петльовий пристрій.
.RE
.sp
\fB\-\-direct\-io\fP[\fB=on\fP|\fBoff\fP]
.RS 4
Увімкнути або вимкнути безпосереднє введення\-виведення для базового файла. Необов\(cqязковим аргументом може бути \fBon\fP або \fBoff\fP. Якщо необов\(cqязковий аргумент буде пропущено, типовим значенням вважатиметься \fBon\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Режим докладних повідомлень.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
Якщо вказано петльовий пристрій або параметр \fB\-a\fP, вивести типові стовпчики або для вказаного петльового пристрою, або для усіх петльових пристроїв; типово, буде виведено відомості щодо усіх пристроїв. Див. також \fB\-\-output\fP, \fB\-\-noheadings\fP, \fB\-\-raw\fP та \fB\-\-json\fP.
.RE
.sp
\fB\-O\fP, \fB\-\-output\fP \fIстовпчик\fP[,\fIстовпчик\fP]...
.RS 4
Вказати стовпчики, які не буде виведено у відповідь на використання параметра \fB\-\-list\fP. Скористайтеся \fB\-\-help\fP, щоб отримати список усіх підтримуваних стовпчиків.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
Вивести список усіх доступних стовпчиків.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Не виводити заголовків для даних, які виведено \fB\-\-list\fP.
.RE
.sp
\fB\-\-raw\fP
.RS 4
Використовувати формат виведення без обробки у \fB\-\-list\fP.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
Використовувати формат JSON для виведення \fB\-\-list\fP.
.RE
.SH "ШИФРУВАННЯ"
.sp
\fBCryptoloop is no longer supported in favor of dm\-crypt.\fP For more details see \fBcryptsetup\fP(8).
.SH "СТАН ВИХОДУ"
.sp
\fBlosetup\fP returns 0 on success, nonzero on failure. When \fBlosetup\fP displays the status of a loop device, it returns 1 if the device is not configured and 2 if an error occurred which prevented determining the status of the device.
.SH "ЗАУВАЖЕННЯ"
.sp
Починаючи з версії 2.37, \fBlosetup\fP використовує ioctl \fBLOOP_CONFIGURE\fP для налаштовування нового петльового пристрою одним викликом ioctl. Для виконання того самого завдання у старих версіях використано ioctl \fBLOOP_SET_FD\fP і \fBLOOP_SET_STATUS64\fP.
.SH "СЕРЕДОВИЩЕ"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
вмикає показ діагностичних повідомлень.
.RE
.SH "ФАЙЛИ"
.sp
\fI/dev/loop[0..N]\fP
.RS 4
блокові петльові пристрої
.RE
.sp
\fI/dev/loop\-control\fP
.RS 4
пристрій керування петльовим пристроєм
.RE
.SH "ПРИКЛАД"
.sp
Наведеними нижче командами можна скористатися як прикладом використання петльового пристрою.
.sp
.if n .RS 4
.nf
.fam C
# dd if=/dev/zero of=~/file.img bs=1024k count=10
# losetup \-\-find \-\-show ~/file.img
/dev/loop0
# mkfs \-t ext2 /dev/loop0
# mount /dev/loop0 /mnt
\&...
# umount /dev/loop0
# losetup \-\-detach /dev/loop0
.fam
.fi
.if n .RE
.SH "АВТОРИ"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ","
засновано на початковій версії
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
.SH "ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ"
.sp
Для звітування щодо вад скористайтеся системою стеження за вадами \- \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "ДОСТУП ДО ПРОГРАМИ"
.sp
Програма \fBlosetup\fP є частиною пакунка util\-linux, який можна отримати з \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "архіву ядра Linux" "."