НАЗВА¶

losetup - налаштувати петльові пристрої або керувати ними

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

Отримати інформацію:

losetup [loopdev]

losetup -l [-a]

losetup -j file [-o offset]

Від’єднати петльовий пристрій:

losetup -d loopdev ...

Від’єднання усіх пов’язаних петльових пристроїв:

losetup -D

Налаштовування петльового пристрою:

losetup [-o offset] [--sizelimit size] [--sector-size size] [--loop-ref name] [-Pr] [--show] -f|loopdev file

Зміна розміру петльового пристрою:

losetup -c loopdev

ОПИС¶

losetup 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 loopdev argument is given, the status of the corresponding loop device is shown. If no option is given, all loop devices are shown.

Зауважте, що старий формат виведення (тобто losetup -a) із рядками, які відокремлено комами, вважається застарілим - тепер пріоритетним є формат виведення --list.

Існує можливість створювати декілька незалежних петльових пристроїв для одного базового файла. Така конфігурація може бути небезпечною, може спричинити втрату даних, пошкодження і перезапис. Скористайтеся параметром --nooverlap із --find під час налаштовування, щоб уникнути цієї проблеми.

Налаштовування петльового пристрою не є атомарною дією при використанні з --find, і losetup не захищає цю дію будь-яким блокуванням. Кількість спроб на внутрішньому рівні обмежено максимумом у 16. Рекомендуємо скористатися, наприклад, flock(1), щоб уникнути конфліктів у значно паралелізованих випадках використання.

ПАРАМЕТРИ¶

Після аргументів розмір і відступ можна додавати суфікси одиниць KiB (=1024), MiB (=1024*1024) тощо для GiB, TiB, PiB, EiB, ZiB та YiB (частина «iB» є необов’язковою, наприклад, «K» є тим самим, що і «KiB») або суфікси KB (=1000), MB (=1000*1000) тощо для GB, TB, PB, EB, ZB і YB.

-a, --all

-d, --detach петльовий-пристрій...

-D, --detach-all

-f, --find [файл]

--show

-L, --nooverlap

-j, --associated файл [-o відступ]

-o, --offset відступ

--loop-ref рядок

--sizelimit розмір

-b, --sector-size розмір

-c, --set-capacity петльовий-пристрій

-P, --partscan

-r, --read-only

--direct-io[=on|off]

-v, --verbose

-l, --list

-O, --output стовпчик[,стовпчик]...

--output-all

-n, --noheadings

--raw

-J, --json

ШИФРУВАННЯ¶

Cryptoloop is no longer supported in favor of dm-crypt. For more details see cryptsetup(8).

СТАН ВИХОДУ¶

losetup returns 0 on success, nonzero on failure. When losetup 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.

ЗАУВАЖЕННЯ¶

Починаючи з версії 2.37, losetup використовує ioctl LOOP_CONFIGURE для налаштовування нового петльового пристрою одним викликом ioctl. Для виконання того самого завдання у старих версіях використано ioctl LOOP_SET_FD і LOOP_SET_STATUS64.

СЕРЕДОВИЩЕ¶

LOOPDEV_DEBUG=all

ФАЙЛИ¶

/dev/loop[0..N]

/dev/loop-control

ПРИКЛАД¶

Наведеними нижче командами можна скористатися як прикладом використання петльового пристрою.

# 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

АВТОРИ¶

Karel Zak <kzak@redhat.com>, засновано на початковій версії Theodore Ts’o <tytso@athena.mit.edu>.

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

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

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

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