'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: Systemadministration
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "LOSETUP" "8" "2026-05-18" "util\-linux 2.42.1" "Systemadministration"
.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 "NAMN"
losetup \- ställa in och styra loop\-enheter
.SH "SYNOPSIS"
.sp
Ställ in en loop\-enhet:
.sp
\fBlosetup\fP [options] \fB\-f\fP|\fIloopdev file\fP
.sp
Hämta information:
.sp
\fBlosetup\fP [\fB\-l\fP] [\fB\-a\fP|\fIloopdev\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIfil\fP [\fB\-o\fP \fIoffset\fP]
.sp
Recalibrate the size of a loop device:
.sp
\fBlosetup\fP \fB\-c\fP \fIloopdev\fP
.sp
Detach loop devices:
.sp
\fBlosetup\fP \fB\-d\fP \fIloopdev\fP .\|.\|.
.sp
\fBlosetup\fP \fB\-D\fP
.sp
Prevent loop devices from getting listed:
.sp
\fBlosetup\fP \fB\-\-remove\fP \fIloopdev\fP .\|.\|.
.SH "BESKRIVNING"
.sp
\fBlosetup\fP används för att associera loop\-enheter med vanliga filer eller blockenheter, för att koppla bort loop\-enheter och för att fråga om status för en loop\-enhet. Om endast argumentet \fIloopdev\fP anges visas statusen för motsvarande loop\-enhet. Om ingen flagga anges visas alla loop\-enheter.
.sp
Observera att det gamla utmatningsformatet (dvs. \fBlosetup \-a\fP) med kommaseparerade strängar inte längre används till förmån för utmatningsformatet \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
Loop device setup är inte en atomär operation när den används med \fB\-\-find\fP, och \fBlosetup\fP skyddar inte denna operation med något lås. Antalet försök är internt begränsat till maximalt 16. Vi rekommenderar att du använder t.ex. \fBflock\fP(1) för att undvika kollisioner i mycket parallella användningsfall.
.SH "FLAGGOR"
.sp
Argumenten \fIstorlek\fP och \fIoffset\fP kan följas av de multiplikativa suffixen KiB (=1024), MiB (=1024*1024), och så vidare för GiB, TiB, PiB, EiB, ZiB och YiB (iB är valfritt, t.ex. har "K" samma betydelse som "KiB") eller suffixen KB (=1000), MB (=1000*1000), och så vidare för GB, TB, PB, EB, ZB och YB.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Visa status för alla loop\-enheter. Observera att all information inte är tillgänglig för användare som inte är root. Se även \fB\-\-list\fP. Det gamla utdataformatet (som skrivs ut utan \fB\-\-list\fP) är föråldrat.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\fP \fIloopdev\fP.\|.\|.
.RS 4
Avlägsna filen eller enheten som är associerad med den eller de angivna loop\-enheterna. Observera att sedan Linux v3.7 använder kärnan "lazy device destruction". Detach\-operationen returnerar inte \fBEBUSY\fP\-felet längre om enheten används aktivt av systemet, men den är markerad med autoclear\-flaggan och förstörs senare. Även om enheten inte används kan loop\-enheten förstöras senare. Om du behöver vänta på att loopenheten ska tas bort helt och hållet, anropar du \fBudevadm settle\fP efter \fBlosetup\fP.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
Koppla bort alla tillhörande loop\-enheter.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIfil\fP]
.RS 4
Hitta den första oanvända loop\-enheten. Om ett \fIfil\fP\-argument finns, använd den funna enheten som loop\-enhet. Annars skrivs bara dess namn ut.
.RE
.sp
\fB\-\-show\fP
.RS 4
Visa namnet på den tilldelade loop\-enheten om flaggan \fB\-f\fP och ett \fIfil\fP\-argument finns.
.RE
.sp
\fB\-L\fP, \fB\-\-nooverlap\fP
.RS 4
Kontrollera om det finns konflikter mellan loop\-enheter för att undvika situationer där samma backingfil delas av flera loop\-enheter. Om filen redan används av en annan enhet, återanvänd då enheten i stället för att skapa en ny. Flaggan är endast meningsfullt med \fB\-\-find\fP.
.RE
.sp
\fB\-j\fP, \fB\-\-associated\fP \fIfil\fP [\fB\-o\fP \fIoffset\fP]
.RS 4
Visar status för alla loop\-enheter som är kopplade till den angivna \fIfilen\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIoffset\fP
.RS 4
Datastarten flyttas \fIoffset\fP byte in i den angivna filen eller enheten. \fIoffset\fP kan följas av de multiplikativa suffixen, se ovan.
.RE
.sp
\fB\-\-loop\-ref\fP \fIsträng\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 \fIstorlek\fP
.RS 4
Dataslutet sätts till högst \fIstorlek\fP bytes efter datastarten. \fIstorlek\fP kan följas av de multiplikativa suffixen, se ovan.
.RE
.sp
\fB\-b\fP, \fB\-\-sector\-size\fP \fIstorlek\fP
.RS 4
Ange den logiska sektorstorleken för loop\-enheten i byte (sedan Linux 4.14). Flaggan kan användas när du skapar en ny loop\-enhet samt som ett fristående kommando för att ändra sektorstorleken på en redan befintlig loop\-enhet.
.RE
.sp
\fB\-c\fP, \fB\-\-set\-capacity\fP \fIloopdev\fP
.RS 4
Tvinga loopdrivrutinen att läsa om storleken på filen som är associerad med den angivna loopenheten.
.RE
.sp
\fB\-P\fP, \fB\-\-partscan\fP
.RS 4
Tvinga kärnan att skanna partitionstabellen på en nyskapad loop\-enhet. Observera att tolkningen av partitionstabellen beror på sektorstorleken. Standard är att sektorstorleken är 512 byte, annars måste du använda flaggan \fB\-\-sector\-size\fP tillsammans med \fB\-\-partscan\fP.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-only\fP
.RS 4
Ställ in en skrivskyddad loop\-enhet.
.RE
.sp
\fB\-\-direct\-io\fP[\fB=on\fP|\fBoff\fP]
.RS 4
Aktivera eller inaktivera direkt I/O för stödfilen. Standardinställningen är \fBoff\fP. Om du anger antingen \fB\-\-direct\-io\fP eller \fB\-\-direct\-io=on\fP aktiveras det. Men \fB\-\-direct\-io=off\fP kan anges för att uttryckligen stänga av det.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
Om en slingenhet eller flaggan \fB\-a\fP anges, skriv ut standardkolumnerna för antingen den angivna slingenheten eller alla slingenheter; standard är att skriva ut information om alla enheter. Se även \fB\-\-output\fP, \fB\-\-noheadings\fP, \fB\-\-raw\fP och \fB\-\-json\fP.
.RE
.sp
\fB\-O\fP, \fB\-\-output\fP \fIcolumn\fP[,\fIcolumn\fP].\|.\|.
.RS 4
Ange de kolumner som ska skrivas ut för \fB\-\-list\fP\-utdata. Använd \fB\-\-help\fP för att få en lista över alla kolumner som stöds.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
Skriv ut alla tillgängliga kolumner.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Skriv inte ut rubriker för utdataformatet \fB\-\-list\fP.
.RE
.sp
\fB\-\-raw\fP
.RS 4
Använd det råa utdataformatet \fB\-\-list\fP.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
Använd JSON\-format för \fB\-\-list\fP\-utdata.
.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
Visa hjälptext och avsluta.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Visa version och avsluta.
.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 "ENCRYPTION"
.sp
\fBCryptoloop stöds inte längre till förmån för dm\-crypt.\fP För mer information se \fBcryptsetup\fP(8).
.SH "AVSLUTSSTATUS"
.sp
\fBlosetup\fP returnerar 0 vid framgång, icke\-noll vid misslyckande. När \fBlosetup\fP visar status för en loop\-enhet returnerar den 1 om enheten inte är konfigurerad och 2 om ett fel inträffade som gjorde det omöjligt att fastställa enhetens status.
.SH "ANTECKNINGAR"
.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 "MILJÖ"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
aktiverar felsökningsutmatning.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
aktiverar libsmartcols felsökningsutdata.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
använda synliga utfyllnadstecken.
.RE
.SH "FILER"
.sp
\fI/dev/loop[0..N]\fP \fI/dev/loop[0..N]\fP
.RS 4
enheter för slingblock
.RE
.sp
\fI/dev/loop\-kontroll\fP
.RS 4
kontrollenhet för slinga
.RE
.SH "EXEMPEL"
.sp
Följande kommandon kan användas som exempel på hur loop\-enheten används.
.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 "UPPHOVSPERSONER"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ","
baserad på originalversionen från
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
.SH "FELRAPPORTERING"
.sp
För felrapporter, använd \c
.URL "https://github.com/util\-linux/util\-linux/issues" "felhanteraren" "."
.SH "TILLGÄNGLIGHET"
.sp
Kommandot \fBlosetup\fP ingår i paketet util\-linux som kan hämtas från \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."