LOSETUP(8) Systemadministration LOSETUP(8) NAMN losetup - stalla in och styra loop-enheter SYNOPSIS Stall in en loop-enhet: losetup [options] -f|loopdev file Hamta information: losetup [-l] [-a|loopdev] losetup -j fil [-o offset] Recalibrate the size of a loop device: losetup -c loopdev Detach loop devices: losetup -d loopdev ... losetup -D Prevent loop devices from getting listed: losetup --remove loopdev ... BESKRIVNING losetup anvands for att associera loop-enheter med vanliga filer eller blockenheter, for att koppla bort loop-enheter och for att fraga om status for en loop-enhet. Om endast argumentet loopdev anges visas statusen for motsvarande loop-enhet. Om ingen flagga anges visas alla loop-enheter. Observera att det gamla utmatningsformatet (dvs. losetup -a) med kommaseparerade strangar inte langre anvands till forman for utmatningsformatet --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. Loop device setup ar inte en atomar operation nar den anvands med --find, och losetup skyddar inte denna operation med nagot las. Antalet forsok ar internt begransat till maximalt 16. Vi rekommenderar att du anvander t.ex. flock(1) for att undvika kollisioner i mycket parallella anvandningsfall. FLAGGOR Argumenten storlek och offset kan foljas av de multiplikativa suffixen KiB (=1024), MiB (=1024*1024), och sa vidare for GiB, TiB, PiB, EiB, ZiB och YiB (iB ar valfritt, t.ex. har "K" samma betydelse som "KiB") eller suffixen KB (=1000), MB (=1000*1000), och sa vidare for GB, TB, PB, EB, ZB och YB. -a, --all Visa status for alla loop-enheter. Observera att all information inte ar tillganglig for anvandare som inte ar root. Se aven --list. Det gamla utdataformatet (som skrivs ut utan --list) ar foraldrat. -d, --detach loopdev... Avlagsna filen eller enheten som ar associerad med den eller de angivna loop-enheterna. Observera att sedan Linux v3.7 anvander karnan "lazy device destruction". Detach-operationen returnerar inte EBUSY-felet langre om enheten anvands aktivt av systemet, men den ar markerad med autoclear-flaggan och forstors senare. Aven om enheten inte anvands kan loop-enheten forstoras senare. Om du behover vanta pa att loopenheten ska tas bort helt och hallet, anropar du udevadm settle efter losetup. -D, --detach-all Koppla bort alla tillhorande loop-enheter. -f, --find [fil] Hitta den forsta oanvanda loop-enheten. Om ett fil-argument finns, anvand den funna enheten som loop-enhet. Annars skrivs bara dess namn ut. --show Visa namnet pa den tilldelade loop-enheten om flaggan -f och ett fil-argument finns. -L, --nooverlap Kontrollera om det finns konflikter mellan loop-enheter for att undvika situationer dar samma backingfil delas av flera loop-enheter. Om filen redan anvands av en annan enhet, ateranvand da enheten i stallet for att skapa en ny. Flaggan ar endast meningsfullt med --find. -j, --associated fil [-o offset] Visar status for alla loop-enheter som ar kopplade till den angivna filen. -o, --offset offset Datastarten flyttas offset byte in i den angivna filen eller enheten. offset kan foljas av de multiplikativa suffixen, se ovan. --loop-ref strang 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 storlek Dataslutet satts till hogst storlek bytes efter datastarten. storlek kan foljas av de multiplikativa suffixen, se ovan. -b, --sector-size storlek Ange den logiska sektorstorleken for loop-enheten i byte (sedan Linux 4.14). Flaggan kan anvandas nar du skapar en ny loop-enhet samt som ett fristaende kommando for att andra sektorstorleken pa en redan befintlig loop-enhet. -c, --set-capacity loopdev Tvinga loopdrivrutinen att lasa om storleken pa filen som ar associerad med den angivna loopenheten. -P, --partscan Tvinga karnan att skanna partitionstabellen pa en nyskapad loop-enhet. Observera att tolkningen av partitionstabellen beror pa sektorstorleken. Standard ar att sektorstorleken ar 512 byte, annars maste du anvanda flaggan --sector-size tillsammans med --partscan. -r, --read-only Stall in en skrivskyddad loop-enhet. --direct-io[=on|off] Aktivera eller inaktivera direkt I/O for stodfilen. Standardinstallningen ar off. Om du anger antingen --direct-io eller --direct-io=on aktiveras det. Men --direct-io=off kan anges for att uttryckligen stanga av det. -l, --list Om en slingenhet eller flaggan -a anges, skriv ut standardkolumnerna for antingen den angivna slingenheten eller alla slingenheter; standard ar att skriva ut information om alla enheter. Se aven --output, --noheadings, --raw och --json. -O, --output column[,column]... Ange de kolumner som ska skrivas ut for --list-utdata. Anvand --help for att fa en lista over alla kolumner som stods. --output-all Skriv ut alla tillgangliga kolumner. -n, --noheadings Skriv inte ut rubriker for utdataformatet --list. --raw Anvand det raa utdataformatet --list. -J, --json Anvand JSON-format for --list-utdata. --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 Visa hjalptext och avsluta. -V, --version Visa version och avsluta. 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. ENCRYPTION Cryptoloop stods inte langre till forman for dm-crypt. For mer information se cryptsetup(8). AVSLUTSSTATUS losetup returnerar 0 vid framgang, icke-noll vid misslyckande. Nar losetup visar status for en loop-enhet returnerar den 1 om enheten inte ar konfigurerad och 2 om ett fel intraffade som gjorde det omojligt att faststalla enhetens status. ANTECKNINGAR 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. MILJO LOOPDEV_DEBUG=all aktiverar felsokningsutmatning. LIBSMARTCOLS_DEBUG=all aktiverar libsmartcols felsokningsutdata. LIBSMARTCOLS_DEBUG_PADDING=on anvanda synliga utfyllnadstecken. FILER /dev/loop[0..N] /dev/loop[0..N] enheter for slingblock /dev/loop-kontroll kontrollenhet for slinga EXEMPEL Foljande kommandon kan anvandas som exempel pa hur loop-enheten anvands. # 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 UPPHOVSPERSONER Karel Zak , baserad pa originalversionen fran Theodore Ts'o . FELRAPPORTERING For felrapporter, anvand felhanteraren . TILLGANGLIGHET Kommandot losetup ingar i paketet util-linux som kan hamtas fran Linux Kernel Archive . util-linux 2.42.1 2026-05-18 LOSETUP(8)