'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: System-Administration
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "LOSETUP" "8" "2024-04-27" "util\-linux 2.40" "System\-Administration"
.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 "BEZEICHNUNG"
losetup \- Loop\-Geräte einrichten und steuern
.SH "ÜBERSICHT"
.sp
Informationen erhalten:
.sp
\fBlosetup\fP [\fIloopdev\fP]
.sp
\fBlosetup\fP \fB\-l\fP [\fB\-a\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIfile\fP [\fB\-o\fP \fIoffset\fP]
.sp
Ein Loop\-Gerät abhängen:
.sp
\fBlosetup\fP \fB\-d\fP \fIloopdev\fP ...
.sp
Alle zugehörigen Loop\-Geräte abhängen:
.sp
\fBlosetup\fP \fB\-D\fP
.sp
Ein Loop\-Gerät einrichten:
.sp
\fBlosetup\fP [\fB\-o\fP \fIoffset\fP] [\fB\-\-sizelimit\fP \fIsize\fP] [\fB\-\-sector\-size\fP \fIsize\fP] [\fB\-\-loop\-ref\fP \fIname\fP] [\fB\-Pr\fP] [\fB\-\-show\fP] \fB\-f\fP|\fIloopdev file\fP
.sp
Größe eines Loop\-Geräts ändern:
.sp
\fBlosetup\fP \fB\-c\fP \fIloopdev\fP
.SH "BESCHREIBUNG"
.sp
\fBlosetup\fP 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 \fIloopdev\fP argument is given, the status of the corresponding loop device is shown. If no option is given, all loop devices are shown.
.sp
Beachten Sie, dass das alte Ausgabeformat (d.h. \fBlosetup \-a\fP) mit durch Kommata getrennten Zeichenketten als veraltet markiert wurde und nun das Ausgabeformat mit \fB\-\-list\fP bevorzugt wird.
.sp
Es ist möglich, mehrere unabhängige Loop\-Geräte für die gleiche zugrunde liegende Datei anzulegen. \fBDiese Art der Einrichtung kann gefährlich sein, kann Datenverlust, Beschädigungen und Überschreibungen verursachen\fP. Verwenden Sie während der Einrichtung \fB\-\-nooverlap\fP mit \fB\-\-find\fP, um dieses Problem zu vermeiden.
.sp
Die Einrichtung des Loop−Geräts ist keine atomare Aktion, wenn sie zusammen mit \fB\-\-find\fP verwendet wird, und \fBlosetup\fP schützt diese Aktion nicht durch eine Sperre. Die Anzahl der Versuche ist intern auf maximal 16 beschränkt. Es wird empfohlen, beispielsweise \fBflock\fP(1) zu verwenden, um eine Kollision in stark parallelisierten Anwendungsfällen zu verwenden.
.SH "OPTIONEN"
.sp
Den Argumenten \fIGröße\fP und \fIVersatz\fP 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.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
zeigt den Status aller Loop\-Geräte an. Beachten Sie, dass gewöhnliche Benutzer nicht auf alle Informationen zugreifen können. Siehe auch \fB\-\-list\fP. Das frühere Format (wie es ohne \fB\-\-list\fP ausgegeben wird) ist veraltet.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\fP \fILoop\-Gerät\fP...
.RS 4
hängt die Datei oder das Gerät aus, das dem oder den angegebenen Loop\-Gerät(en) zugeordnet ist. Beachten Sie, dass der Kernel seit Linux v3.7 die »lazy device destruction« (lockere Gerätezerstörung) verwendet. Der Abhängevorgang gibt keinen \fBEBUSY\fP\-Fehler mehr zurück, falls das Gerät aktiv vom System verwendet wird, aber es wird mit einer »autoclear«\-Markierung versehen und später zerstört.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
hängt alle zugehörigen Loop\-Geräte ab.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIDatei\fP]
.RS 4
sucht nach dem ersten ungenutzten Loop\-Gerät. Wenn ein \fIDatei\fP\-Argument vorhanden ist, wird das gefundene Gerät als Loop\-Gerät verwendet. Anderenfalls wird einfach dessen Name ausgegeben.
.RE
.sp
\fB\-\-show\fP
.RS 4
zeigt den Namen des zugehörigen Loop\-Geräts an, wenn die Option \fB\-f\fP und das Argument \fIDatei\fP vorhanden sind.
.RE
.sp
\fB\-L\fP, \fB\-\-nooverlap\fP
.RS 4
prüft auf Konflikte zwischen Loop\-Geräten, um die Situation zu vermeiden, bei der die gleiche zugrunde liegende Datei von mehreren Loop\-Geräten gemeinsam verwendet wird. Wenn die Datei bereits von einem anderen Gerät verwendet wird, dann wird das Gerät erneut verwendet, anstatt ein neues zu einzurichten. Diese Option ist nur zusammen mit \fB\-\-find\fP sinnvoll.
.RE
.sp
\fB\-j\fP, \fB\-\-associated\fP \fIDatei\fP [\fB\-o\fP \fIVersatz\fP]
.RS 4
zeigt den Status aller Loop\-Geräte an, die der angegebenen \fIDatei\fP zugeordnet sind.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIVersatz\fP
.RS 4
verschiebt den Start der Daten um den angegebenen \fIVersatz\fP in Byte in der Datei oder dem angegebenen Gerät. Dem \fIVersatz\fP dürfen multiplikative Suffixe folgen; siehe oben.
.RE
.sp
\fB\-\-loop\-ref\fP \fIZeichenkette\fP
.RS 4
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 \fIstring\fP. 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 \fB\-\-output\fP +REF) and it is restricted to 64 bytes.
.RE
.sp
\fB\-\-sizelimit\fP \fIGröße\fP
.RS 4
setzt das Ende der Daten auf nicht mehr als die angegebene \fIGröße\fP in Byte nach dem Anfang der Daten. Der \fIGröße\fP dürfen multiplikative Suffixe folgen; siehe oben.
.RE
.sp
\fB\-b\fP, \fB\-\-sector\-size\fP \fIGröße\fP
.RS 4
legt die logische Sektorengröße des Loop\-Geräts in Bytes fest (seit Linux 4.14). Die Option darf sowohl beim Erstellen neuer Loop\-Geräte als auch als einzelner Befehl zum Ändern der Sektorengröße eines bereits existierenden Loop\-Geräts verwendet werden.
.RE
.sp
\fB\-c\fP, \fB\-\-set\-capacity\fP \fILoop\-Gerät\fP
.RS 4
zwingt den Loop\-Treiber, die Größe der Datei neu einzulesen, der das angegebene Loop\-Gerät zugeordnet ist.
.RE
.sp
\fB\-P\fP, \fB\-\-partscan\fP
.RS 4
zwingt den Kernel, die Partitionstabelle auf einem neu erstellten Loop\-Gerät einzulesen. Beachten Sie, dass das Einlesen der Partitionstabelle von den Sektorengrößen abhängt. Die standardmäßige Sektorengröße ist 512 Byte, anderenfalls müssen Sie die Option \fB\-\-sector\-size\fP zusammen mit \fB\-\-partscan\fP verwenden.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-only\fP
.RS 4
richtet ein schreibgeschütztes Loop\-Gerät ein.
.RE
.sp
\fB\-\-direct\-io\fP[\fB=on\fP|\fBoff\fP]
.RS 4
aktiviert oder deaktiviert die direkten Ein\-/Ausgaben für die zugrunde liegende Datei. Das optionale Argument kann entweder \fBon\fP oder \fBoff\fP sein. Wird kein optionales Argument angegeben, ist \fBon\fP die Vorgabe.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
aktiviert den ausführlichen Modus.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
gibt, falls ein Loop−Gerät oder die Option \fB\-a\fP angegeben ist, die Standardspalten für entweder das angegebene Loop\-Gerät oder alle Loop\-Geräte aus; die Vorgabe ist die Ausgabe von Informationen zu allen Geräten. Siehe auch \fB\-\-output\fP, \fB\-\-noheadings\fP, \fB\-\-raw\fP und \fB\-\-json\fP.
.RE
.sp
\fB\-O\fP, \fB\-\-output\fP \fISpalte\fP[,\fISpalte\fP]...
.RS 4
gibt an, welche Spalten mit \fB\-\-list\fP ausgegeben werden sollen. Mit \fB\-\-help\fP erhalten Sie eine Liste aller unterstützten Spalten.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
gibt alle verfügbaren Spalten aus.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
zeigt bei der Ausgabe mit \fB\-\-list\fP keine Überschriften an.
.RE
.sp
\fB\-\-raw\fP
.RS 4
verwendet das Rohformat für die Ausgabe mit \fB\-\-list\fP.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
verwendet das JSON\-Format für die Ausgabe mit \fB\-\-list\fP.
.RE
.SH "VERSCHLÜSSELUNG"
.sp
\fBCryptoloop is no longer supported in favor of dm\-crypt.\fP For more details see \fBcryptsetup\fP(8).
.SH "EXIT\-STATUS"
.sp
\fBlosetup\fP returns 0 on success, nonzero on failure. When \fBlosetup\fP 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.
.SH "ANMERKUNGEN"
.sp
Seit Version 2.37 verwendet \fBlosetup\fP das Ioctl \fBLOOP_CONFIGURE\fP, um ein neues Loop\-Gerät mit einem einzigen Ioctl\-Aufruf einzurichten. Die alten Versionen verwenden die Ioctls \fBLOOP_SET_FD\fP und \fBLOOP_SET_STATUS64\fP, um das gleiche zu erreichen.
.SH "UMGEBUNGSVARIABLEN"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
aktiviert die Debug\-Ausgabe.
.RE
.SH "DATEIEN"
.sp
\fI/dev/loop[0..N]\fP
.RS 4
Loop\-Blockgeräte
.RE
.sp
\fI/dev/loop\-control\fP
.RS 4
Loop\-Steuergerät
.RE
.SH "BEISPIEL"
.sp
Die folgenden Befehle können als Beispiel für die Nutzung eines Loop\-Geräts verwendet werden.
.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 "AUTOREN"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ","
basierend auf der Originalversion von
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "VERFÜGBARKEIT"
.sp
Der Befehl \fBlosetup\fP ist Teil des Pakets util\-linux, welches aus dem \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" ""
heruntergeladen werden kann.