LOSETUP(8) | System-Administration | LOSETUP(8) |
BEZEICHNUNG¶
losetup - Loop-Geräte einrichten und steuern
ÜBERSICHT¶
Informationen erhalten:
losetup [Loop-Gerät]
losetup -l [-a]
losetup -j Datei [-o Versatz]
Ein Loop-Gerät abhängen:
losetup -d Loop-Gerät ...
Alle zugehörigen Loop-Geräte abhängen:
losetup -D
Ein Loop-Gerät einrichten:
losetup [-o Versatz] [--sizelimit Größe] [--sector-size Größe] [--loop-ref Name] [-Pr] [--show] -f|Loop-Gerät Datei
Größe eines Loop-Geräts ändern:
losetup -c Loop-Gerät
BESCHREIBUNG¶
losetup wird zum Zuweisen von Loop-Geräten zu regulären Dateien oder blockorientierten Geräten, zum Abhängen von Loop-Geräten und zum Abfragen des Status eines Loop-Gerätes verwendet. Wenn nur das Argument Loop-Gerät angegeben ist, wird der Status des korrespondierenden Loop-Geräts angezeigt. Falls keine Option angegeben ist, werden alle Loop-Geräte angezeigt.
Beachten Sie, dass das alte Ausgabeformat (d.h. losetup -a) mit durch Kommata getrennten Zeichenketten als veraltet markiert wurde und nun das Ausgabeformat mit --list bevorzugt wird.
Es ist möglich, mehrere unabhängige Loop-Geräte für die gleiche zugrunde liegende Datei anzulegen. Diese Art der Einrichtung kann gefährlich sein, kann Datenverlust, Beschädigungen und Überschreibungen verursachen. Verwenden Sie während der Einrichtung --nooverlap mit --find, um dieses Problem zu vermeiden.
Die Einrichtung des Loop−Geräts ist keine atomare Aktion, wenn sie zusammen mit --find verwendet wird, und losetup schützt diese Aktion nicht durch eine Sperre. Die Anzahl der Versuche ist intern auf maximal 16 beschränkt. Es wird empfohlen, beispielsweise flock(1) zu verwenden, um eine Kollision in stark parallelisierten Anwendungsfällen zu verwenden.
OPTIONEN¶
Den Argumenten Größe und Versatz können die multiplikativen Suffixe KiB (=1024), MiB (=1024*1024) und so weiter für GiB, TiB, PiB, EiB, ZiB und YiB folgen (das »iB« ist optional, zum Beispiel ist »K« gleichbedeutend mit »KiB«) oder die Suffixe KB (=1000), MB (=1000*1000) und so weiter für GB, TB, PB, EB, ZB und YB.
-a, --all
-d, --detach Loop-Gerät...
-D, --detach-all
-f, --find [Datei]
--show
-L, --nooverlap
-j, --associated Datei [-o Versatz]
-o, --offset Versatz
--loop-ref Zeichenkette
--sizelimit Größe
-b, --sector-size Größe
-c, --set-capacity Loop-Gerät
-P, --partscan
-r, --read-only
--direct-io[=on|off]
-v, --verbose
-l, --list
-O, --output Spalte[,Spalte]...
--output-all
-n, --noheadings
--raw
-J, --json
VERSCHLÜSSELUNG¶
Cryptoloop wird zugunsten von dm-crypt nicht mehr unterstützt. Für weitere Details siehe cryptsetup(8).
EXIT-STATUS¶
losetup gibt 0 im Erfolgsfall und einen von 0 verschiedenen Wert bei einem Fehlschlag zurück. Wenn losetup den Status eines Loop-Geräts anzeigt, wird 1 zurückgegeben, falls das Gerät nicht eingerichtet ist und 2, falls ein Fehler aufgetreten ist, der die Statusermittlung des Geräts verhindert hat.
ANMERKUNGEN¶
Seit Version 2.37 verwendet losetup das Ioctl LOOP_CONFIGURE, um ein neues Loop-Gerät mit einem einzigen Ioctl-Aufruf einzurichten. Die alten Versionen verwenden die Ioctls LOOP_SET_FD und LOOP_SET_STATUS64, um das gleiche zu erreichen.
UMGEBUNGSVARIABLEN¶
LOOPDEV_DEBUG=all
DATEIEN¶
/dev/loop[0..N]
/dev/loop-control
BEISPIEL¶
Die folgenden Befehle können als Beispiel für die Nutzung eines Loop-Geräts verwendet werden.
# 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
AUTOREN¶
Karel Zak <kzak@redhat.com>, basierend auf der Originalversion von Theodore Ts’o <tytso@athena.mit.edu>.
FEHLER MELDEN¶
Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf <https://github.com/util-linux/util-linux/issues>.
VERFÜGBARKEIT¶
Der Befehl losetup ist Teil des Pakets util-linux, welches aus dem Linux-Kernel-Archiv <https://www.kernel.org/pub/linux/utils/util-linux/> heruntergeladen werden kann.
2024-11-13 | util-linux 2.40.2 |