LOSETUP(8)

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

-d, --detach уређај-петље...
    Detach the file or device associated with the specified loop device(s). Note that since Linux v3.7 kernel uses "lazy device destruction". The detach operation does not return EBUSY error anymore if device is actively used by system, but it is marked by autoclear flag and destroyed later. Even if the device is not used, the loop device can be destroyed later. If you need to wait for a complete removal of the loop device, call udevadm settle after losetup.

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

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

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

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

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

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

--loop-ref string
    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 string. 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 --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]
    Enable or disable direct I/O for the backing file. The default is off. Specifying either --direct-io or --direct-io=on will enable it. But, --direct-io=off can be provided to explicitly turn it off.

-v, --verbose
    Опширан режим.

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

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

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

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

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

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

ШИФРОВАЊЕ

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 користи LOOP_CONFIGURE „ioctl“ да постави нови уређај петље једним „ioctl“ позивом. Стара издања користе LOOP_SET_FD и LOOP_SET_STATUS64 „ioctl“-е да ураде исто.

ОКРУЖЕЊЕ

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

АУТОРИ

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

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

За пријављивање грешака, користите пратиоца грешака на

ДОСТУПНОСТ

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