LOSETUP(8)

НАЗИВ
losetup - поставља и контролише уређаје петље

УВОД

Поставља уређај петље:

losetup [options] -f|loopdev file

Добавите информације:

losetup [-l] [-a|loopdev]

losetup -j датотека [-o померај]

Recalibrate the size of a loop device:

losetup -c уређај-петље

Detach loop devices:

losetup -d уређај-петље ...

losetup -D

Prevent loop devices from getting listed:

losetup --remove loopdev ...

ОПИС

losetup се користи за придруживање уређаја петље са обичним датотекама или блок уређајима, за одвајање уређаја петље и за пропитивање стања уређаја петље. Ако је дат само аргумент loopdev, приказује се стање одговарајућег уређаја петље. Ако ниједна опција није дата, приказују се сви уређаји петље.

Знајте да стари формат излаза (тј., losetup -a) са зарезом одвојеним нискама је застарео у корист --list формата излаза.

It is possible to create multiple independent loop devices for the same backing file. This setup may be dangerous, can cause data loss, corruption, and overwrites. Use --nooverlap with --find during setup to avoid this problem.

Поставка уређаја петље није атомска радња када се користи са --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
    Показује стање свих уређаја петље. Знајте да нису све информације доступне корисницима који нису администратори. Видите такође --list. Стари излазни формат (који се исписује без --list) је застарео.

-d, --detach уређај-петље...
    Откачиње датотеку или уређај придружен са наведеним уређајем петље. Знајте да од Линукса v3.7 кернел користи „лењо уништење уређаја“. Радња откачињања више не даје EBUSY грешку ако се уређај активно користи на систему, али је означен заставицом самочишћења и уништава се касније. Чак и ако се уређај не користи, уређај петље се може уништити касније. Ако треба да чекате на потпуно уклањање уређаја петље, позовите udevadm settle после losetup.

-D, --detach-all
    Откачиње све придружене уређаје петље.

-f, --find [датотека]
    Налази први некоришћени уређај петље. Ако је аргумент датотека присутан, користи нађени уређај као уређај петље. У супротном, само исписује његов назив.

--show
    Приказује назив додељеног уређаја петље ако су опција -f и аргумент датотека присутни.

-L, --nooverlap
    Врши проверу за сукобима између уређаја петље да би избегао ситуацију у којој је иста датотека резерве дељена између више уређаја петље. Ако датотеку већ користи други уређај тада поново користи уређај радије него нов. Опција има смисла само са --find.

-j, --associated датотека [-o померај]
    Приказује стање свих уређаја петље придружених са датом датотеком.

-o, --offset померај
    Почетак података је померен померај бајта у наведену датотеку или уређај. За померајем могу да следе суфикси множитеља; видите изнад.

--loop-ref ниска
    Set the reference string. The backwardly compatible default is to use the backing filename as a reference in the loop setup ioctl (aka lo_file_name). This option overrides this default behavior and sets the reference to the string. The reference may be used by udevd in /dev/loop/by-ref. The 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 --output +REF) and it is restricted to 64 bytes.

--sizelimit величина
    Крај података је постављен на не више од величина бајта након почетка података. За величином могу да следе суфикси множитеља; видите изнад.

-b, --sector-size величина
    Поставља величину логичког сектора уређаја петље у бајтовима (од Линукса 4.14). Опција се може користити приликом стварања новог уређаја петље као и самостална наредба за измену величине сектора већ постојећег уређаја петље.

-c, --set-capacity уређај_петље
    Приморава да управљачки програм петље поново прочита величину датотеке придружене са наведеним уређајем петље.

-P, --partscan
    Приморава кернел да скенира партициону табелу на ново направљеном уређају петље. Знајте да обрада партиционе табеле зависи од величине сектора. Основно је величина сектора од 512 бајтова, у супротном треба да користите опцију --sector-size заједно са --partscan.

-r, --read-only
    Поставља уређај петље само за читање.

--direct-io[=on|off]
    Укључује или искључује непосредан У/И за датотеку резерве. Основно је off. Ако се наведе --direct-io или --direct-io=on тада ће га укључити. Али се --direct-io=off може доставити за изричито искључивање.

-l, --list
    Ако је наведен уређај петље или опција -a, исписује основне колоне или за наведени уређај петље или за све уређаје петље; основно је да испише информације о свим уређајима. Видите такође --output, --noheadings, --raw, и --json.

-O, --output колона[,колона]...
    Наводи колоне које ће бити исписане за излаз --list-а. Користите --help да добавите списак свих подржаних колона.

--output-all
    Исписује све доступне колоне.

-n, --noheadings
    Не исписује заглавља за --list формат излаза.

--raw
    Користи сирови --list формат излаза.

-J, --json
    Користи JSON формат за --list излаз.

--remove loopdev...
    Remove the specified loop device(s). The loop device must be unused (not associated with any backing file). This option removes the device node from the system. In most cases, --detach is sufficient for normal use. See the LOOP DEVICE LIFECYCLE section below.

-h, --help
    Приказује текст помоћи и излази.

-V, --version
    Исписује издање и излази.

LOOP DEVICE LIFECYCLE

Loop devices go through several states during their lifecycle:

Creation
    When losetup associates a loop device with a backing file, it automatically creates the device node (e.g., /dev/loop0) if it doesn’t already exist. This happens on-demand when you use options like -f or specify a loop device explicitly. The device is created using the LOOP_CTL_ADD ioctl.

Detachment
    The -d (--detach) option disassociates the backing file from the loop device using the LOOP_CLR_FD ioctl. After detachment, the loop device node remains in /dev and can be reused for another backing file. Use lsblk -a to see all loop device nodes, including unused ones.

Removal
    The --remove option completely removes the loop device node from the system using the LOOP_CTL_REMOVE ioctl. The device must be detached first (not associated with any backing file). After removal, the device node disappears from /dev.

ШИФРОВАЊЕ

„Cryptoloop“ није више подржано у корист „dm-crypt“-а. За више појединости видите cryptsetup(8).

ИЗЛАЗНО СТАЊЕ

losetup има за резултат 0 при успеху, број различит од нуле при неуспеху. Када losetup прикаже стање уређаја петље, има за резултат 1 ако уређај није подешен а 2 ако је дошло до грешке која је спречила одређивање стања уређаја.

БЕЛЕШКЕ

Since version 2.37 losetup uses LOOP_CONFIGURE ioctl to set up a new loop device by one ioctl call. The old versions use LOOP_SET_FD and LOOP_SET_STATUS64 ioctls to do the same.

ОКРУЖЕЊЕ

LOOPDEV_DEBUG=all
    укључује излаз прочишћавања.

LIBSMARTCOLS_DEBUG=all
    укључује излаз „libsmartcols“ прочишћавања.

LIBSMARTCOLS_DEBUG_PADDING=on
    користи видљиве знакове попуњавања.

ДАТОТЕКЕ

/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

АУТОРИ

засновано на изворном издању од

ПРИЈАВЉИВАЊЕ ГРЕШАКА

За пријављивање грешака, користите „https://github.com/util-linux/util-linux/issues[issue tracker]“.

ДОСТУПНОСТ

Наредба losetup је део „util-linux“ пакета који се може преузети са