'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: Администрација система
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "LOSETUP" "8" "2026-05-18" "util\-linux 2.42.1" "Администрација система"
.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 [options] \fB\-f\fP|\fIloopdev file\fP
.sp
Добавите информације:
.sp
\fBlosetup\fP [\fB\-l\fP] [\fB\-a\fP|\fIloopdev\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIдатотека\fP [\fB\-o\fP \fIпомерај\fP]
.sp
Recalibrate the size of a loop device:
.sp
\fBlosetup\fP \fB\-c\fP \fIуређај\-петље\fP
.sp
Detach loop devices:
.sp
\fBlosetup\fP \fB\-d\fP \fIуређај\-петље\fP .\|.\|.
.sp
\fBlosetup\fP \fB\-D\fP
.sp
Prevent loop devices from getting listed:
.sp
\fBlosetup\fP \fB\-\-remove\fP \fIloopdev\fP .\|.\|.
.SH "ОПИС"
.sp
\fBlosetup\fP се користи за придруживање уређаја петље са обичним датотекама или блок уређајима, за одвајање уређаја петље и за пропитивање стања уређаја петље. Ако је дат само аргумент \fIloopdev\fP, приказује се стање одговарајућег уређаја петље. Ако ниједна опција није дата, приказују се сви уређаји петље.
.sp
Знајте да стари формат излаза (тј., \fBlosetup \-a\fP) са зарезом одвојеним нискама је застарео у корист \fB\-\-list\fP формата излаза.
.sp
It is possible to create multiple independent loop devices for the same backing file. \fBThis setup may be dangerous, can cause data loss, corruption, and overwrites.\fP Use \fB\-\-nooverlap\fP with \fB\-\-find\fP during setup to avoid this problem.
.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“ је опционално, нпр., „K“ има исто значење као „KiB“) или суфикси KB (=1000), MB (=1000*1000), и тако редом за GB, TB, PB, EB, ZB и YB.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Показује стање свих уређаја петље. Знајте да нису све информације доступне корисницима који нису администратори. Видите такође \fB\-\-list\fP. Стари излазни формат (који се исписује без \fB\-\-list\fP) је застарео.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\fP \fIуређај\-петље\fP.\|.\|.
.RS 4
Откачиње датотеку или уређај придружен са наведеним уређајем петље. Знајте да од Линукса v3.7 кернел користи „лењо уништење уређаја“. Радња откачињања више не даје \fBEBUSY\fP грешку ако се уређај активно користи на систему, али је означен заставицом самочишћења и уништава се касније. Чак и ако се уређај не користи, уређај петље се може уништити касније. Ако треба да чекате на потпуно уклањање уређаја петље, позовите \fBudevadm settle\fP после \fBlosetup\fP.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
Откачиње све придружене уређаје петље.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIдатотека\fP]
.RS 4
Налази први некоришћени уређај петље. Ако је аргумент \fIдатотека\fP присутан, користи нађени уређај као уређај петље. У супротном, само исписује његов назив.
.RE
.sp
\fB\-\-show\fP
.RS 4
Приказује назив додељеног уређаја петље ако су опција \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
Приказује стање свих уређаја петље придружених са датом \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 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 \fIstring\fP. 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 \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
Поставља величину логичког сектора уређаја петље у бајтовима (од Линукса 4.14). Опција се може користити приликом стварања новог уређаја петље као и самостална наредба за измену величине сектора већ постојећег уређаја петље.
.RE
.sp
\fB\-c\fP, \fB\-\-set\-capacity\fP \fIуређај_петље\fP
.RS 4
Приморава да управљачки програм петље поново прочита величину датотеке придружене са наведеним уређајем петље.
.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
Укључује или искључује непосредан У/И за датотеку резерве. Основно је \fBoff\fP. Ако се наведе \fB\-\-direct\-io\fP или \fB\-\-direct\-io=on\fP тада ће га укључити. Али се \fB\-\-direct\-io=off\fP може доставити за изричито искључивање.
.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
.sp
\fB\-\-remove\fP \fIloopdev\fP.\|.\|.
.RS 4
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, \fB\-\-detach\fP is sufficient for normal use. See the \fBLOOP DEVICE LIFECYCLE\fP section below.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Приказује текст помоћи и излази.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Исписује издање и излази.
.RE
.SH "LOOP DEVICE LIFECYCLE"
.sp
Loop devices go through several states during their lifecycle:
.sp
\fBCreation\fP
.RS 4
When \fBlosetup\fP associates a loop device with a backing file, it automatically creates the device node (e.g., \fI/dev/loop0\fP) if it doesn\(cqt already exist. This happens on\-demand when you use options like \fB\-f\fP or specify a loop device explicitly. The device is created using the \fBLOOP_CTL_ADD\fP ioctl.
.RE
.sp
\fBDetachment\fP
.RS 4
The \fB\-d\fP (\fB\-\-detach\fP) option disassociates the backing file from the loop device using the \fBLOOP_CLR_FD\fP ioctl. After detachment, the loop device node remains in \fI/dev\fP and can be reused for another backing file. Use \fBlsblk \-a\fP to see all loop device nodes, including unused ones.
.RE
.sp
\fBRemoval\fP
.RS 4
The \fB\-\-remove\fP option completely removes the loop device node from the system using the \fBLOOP_CTL_REMOVE\fP ioctl. The device must be detached first (not associated with any backing file). After removal, the device node disappears from \fI/dev\fP.
.RE
.SH "ШИФРОВАЊЕ"
.sp
\fB„Cryptoloop“ није више подржано у корист „dm\-crypt“\-а.\fP За више појединости видите \fBcryptsetup\fP(8).
.SH "ИЗЛАЗНО СТАЊЕ"
.sp
\fBlosetup\fP има за резултат 0 при успеху, број различит од нуле при неуспеху. Када \fBlosetup\fP прикаже стање уређаја петље, има за резултат 1 ако уређај није подешен а 2 ако је дошло до грешке која је спречила одређивање стања уређаја.
.SH "БЕЛЕШКЕ"
.sp
Since version 2.37 \fBlosetup\fP uses \fBLOOP_CONFIGURE\fP ioctl to set up a new loop device by one ioctl call. The old versions use \fBLOOP_SET_FD\fP and \fBLOOP_SET_STATUS64\fP ioctls to do the same.
.SH "ОКРУЖЕЊЕ"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
укључује излаз прочишћавања.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
укључује излаз „libsmartcols“ прочишћавања.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.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
За пријављивање грешака, користите „https://github.com/util\-linux/util\-linux/issues[issue tracker]“.
.SH "ДОСТУПНОСТ"
.sp
Наредба \fBlosetup\fP је део „util\-linux“ пакета који се може преузети са \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Архиве Линукс кернела" "."