'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-01-05
.\"    Manual: Administration Système
.\"    Source: util-linux 2.39.3
.\"  Language: English
.\"
.TH "LOSETUP" "8" "2024-01-05" "util\-linux 2.39.3" "Administration Système"
.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 "NOM"
losetup \- Mettre en place et contrôler des périphériques boucle
.SH "SYNOPSIS"
.sp
Obtenir des informations :
.sp
\fBlosetup\fP [\fIpériphérique_boucle\fP]
.sp
\fBlosetup\fP \fB\-l\fP [\fB\-a\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIfichier\fP [\fB\-o\fP \fIposition\fP]
.sp
Détacher un périphérique boucle :
.sp
\fBlosetup\fP \fB\-d\fP \fIpériphérique_boucle\fP ...
.sp
Détacher tous les périphériques boucle associés :
.sp
\fBlosetup\fP \fB\-D\fP
.sp
Mettre en place un périphérique boucle :
.sp
\fBlosetup\fP [\fB\-o\fP \fIoffset\fP] [\fB\-\-sizelimit\fP \fIsize\fP] [\fB\-\-sector\-size\fP \fIsize\fP] [\fB\-Pr\fP] [\fB\-\-show\fP] \fB\-f\fP|\fIloopdev file\fP
.sp
Redimensionner un périphérique boucle :
.sp
\fBlosetup\fP \fB\-c\fP \fIpériphérique_boucle\fP
.SH "DESCRIPTION"
.sp
\fBlosetup\fP est utilisé pour associer les périphériques boucle avec des fichiers normaux ou des périphériques bloc, pour détacher et pour connaître l\(cqétat d\(cqun périphérique boucle. Si seul l\(cqargument \fIpériphérique_boucle\fP est fourni, l\(cqétat actuel du périphérique correspondant est affiché. Sans option, tous les périphériques boucle sont affichés.
.sp
Remarquez que l’ancien format de sortie (c’est\-à\-dire \fBlosetup \-a\fP) avec des chaînes séparées par des virgules est obsolète, le format de sortie \fB\-\-list\fP devrait être utilisé à la place.
.sp
Il est possible de créer davantage de périphériques boucle indépendants à partir du même fichier de sauvegarde. \fBCela peut être dangereux, causer des pertes de données, une corruption ou des réécritures\fP. \fB\-\-nooverlap\fP est à utiliser avec \fB\-\-find\fP lors de la configuration pour éviter ce problème.
.sp
The loop device setup is not an atomic operation when used with \fB\-\-find\fP, and \fBlosetup\fP does not protect this operation by any lock. The number of attempts is internally restricted to a maximum of 16. It is recommended to use for example \fBflock\fP(1) to avoid a collision in heavily parallel use cases.
.SH "OPTIONS"
.sp
Les arguments \fItaille\fP et \fIposition\fP peuvent être suivis des suffixes multiplicatifs KiB=1024, MiB=1024*1024, etc., pour GiB, TiB, PiB, EiB, ZiB et YiB (la partie « iB » est facultative, par exemple « K » est identique à « KiB ») ou des suffixes KB=1000, MB=1000*1000, etc., pour GB, TB, PB, EB, ZB et YB.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Show the status of all loop devices. Note that not all information is accessible for non\-root users. See also \fB\-\-list\fP. The old output format (as printed without \fB\-\-list\fP) is deprecated.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\fP \fIpériphérique_boucle\fP...
.RS 4
Détacher le fichier ou le périphérique associé avec le(s) périphérique(s) indiqué(s). Remarquez que depuis sa version 3.7 le noyau Linux utilise « la destruction paresseuse de périphérique ». L’opération de détachement ne renvoie plus une erreur \fBEBUSY\fP si le périphérique est utilisé activement par le système, mais il est marqué par le drapeau « autoclear » et détruit plus tard.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
Détacher tous les périphériques boucle associés.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIfichier\fP]
.RS 4
Déterminer le premier périphérique boucle non utilisé. Si un argument \fIfichier\fP est fourni, utiliser le périphérique trouvé comme un périphérique boucle, sinon, afficher son nom.
.RE
.sp
\fB\-\-show\fP
.RS 4
Afficher le nom du périphérique boucle assigné si l\(cqoption \fB\-f\fP et un argument \fIfichier\fP sont présents.
.RE
.sp
\fB\-L\fP, \fB\-\-nooverlap\fP
.RS 4
Rechercher l’existence de conflits entre des périphériques boucle pour éviter une situation où le même fichier de sauvegarde est partagé par d’autres périphériques boucle. Si le fichier est déjà utilisé par un autre périphérique alors réutiliser le périphérique plutôt que d’en utiliser un nouveau. Cette option n’a de sens qu’avec l’option \fB\-\-find\fP.
.RE
.sp
\fB\-j\fP, \fB\-\-associated\fP \fIfichier\fP [\fB\-o\fP \fIposition\fP]
.RS 4
Montrer l\(cqétat de tous les périphériques boucle associés au \fIfichier\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIposition\fP
.RS 4
Le début des données est déplacé de \fIposition\fP octets dans le fichier ou le périphérique indiqué. \fIposition\fP peut être suivie d’un préfixe multiplicatif, voir ci\-dessus.
.RE
.sp
\fB\-\-sizelimit\fP \fItaille\fP
.RS 4
La fin des données est définie au maximum à \fItaille\fP octets après le début des données. \fItaille\fP peut être suivie d’un préfixe multiplicatif, voir ci\-dessus.
.RE
.sp
\fB\-b\fP, \fB\-\-sector\-size\fP \fItaille\fP
.RS 4
Set the logical sector size of the loop device in bytes (since Linux 4.14). The option may be used when creating a new loop device as well as a stand\-alone command to modify sector size of the already existing loop device.
.RE
.sp
\fB\-c\fP, \fB\-\-set\-capacity\fP \fIpériphérique_boucle\fP
.RS 4
Forcer le pilote de boucle à relire la taille du fichier associé au périphérique boucle indiqué.
.RE
.sp
\fB\-P\fP, \fB\-\-partscan\fP
.RS 4
Forcer le noyau à analyser la table de partitionnement d’un périphérique boucle nouvellement créé. Remarquez que l’analyse de cette table dépend de la taille de secteur. Par défaut, c’est 512 octets, sinon vous devez utiliser l’option \fB\-\-sector\-size\fP avec l’option \fB\-\-partscan\fP.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-only\fP
.RS 4
Configurer un périphérique boucle en lecture seule.
.RE
.sp
\fB\-\-direct\-io\fP[\fB=on\fP|\fBoff\fP]
.RS 4
Enable or disable direct I/O for the backing file. The optional argument can be either \fBon\fP or \fBoff\fP. If the optional argument is omitted, it defaults to \fBon\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Mode détaillé.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
Si un périphérique boucle ou que l’option \fB\-a\fP est indiqué, afficher les colonnes par défaut soit pour le périphérique boucle indiqué, soit pour tous les périphériques boucle. Les informations sur tous les périphériques sont affichées par défaut. Consultez également \fB\-\-output\fP, \fB\-\-noheadings\fP, \fB\-\-raw\fP et \fB\-\-json\fP.
.RE
.sp
\fB\-O\fP, \fB\-\-output\fP \fIcolonne\fP[,\fIcolonne\fP]...
.RS 4
Indiquer les colonnes à afficher pour la sortie \fB\-\-list\fP. Utilisez B*\-\-help* pour obtenir une liste de toutes les colonnes disponibles.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
Afficher toutes les colonnes disponibles.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Ne pas afficher les en\-têtes pour le format de sortie \fB\-\-list\fP.
.RE
.sp
\fB\-\-raw\fP
.RS 4
Utiliser l\(cqaffichage au format \fB\-\-list\fP brut.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
Utiliser le format JSON pour l\(cqaffichage \fB\-\-list\fP.
.RE
.SH "CHIFFREMENT"
.sp
\fBcryptoloop n’est plus pris en charge et est remplacé par dm\-crypt.\fP Pour plus de précisions, consultez \fBcryptsetup\fP(8).
.SH "CODE DE RETOUR"
.sp
\fBlosetup\fP renvoie 0 en cas de réussite et une valeur non nulle en cas d\(cqéchec. Lorsque \fBlosetup\fP affiche l\(cqétat d\(cqun périphérique boucle, il renvoie 1 si le périphérique n\(cqest pas configuré et 2 si une erreur est survenue empêchant de déterminer l\(cqétat du périphérique.
.SH "NOTES"
.sp
Since version 2.37 \fBlosetup\fP uses \fBLOOP_CONFIGURE\fP ioctl to setup 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 "ENVIRONNEMENT"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
Activer la sortie de débogage.
.RE
.SH "FICHIERS"
.sp
\fI/dev/loop[0..N]\fP
.RS 4
Périphériques bloc boucle.
.RE
.sp
\fI/dev/loop\-control\fP
.RS 4
Périphériques de contrôle boucle.
.RE
.SH "EXEMPLE"
.sp
Les commandes suivantes sont des exemples d\(cqutilisation du périphérique boucle :
.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 "AUTEURS"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ""
à partir de la version originale de
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
.SH "SIGNALER DES BOGUES"
.sp
Pour signaler un bogue, utilisez le gestionnaire de bogues sur \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "DISPONIBILITÉ"
.sp
La commande \fBlosetup\fP fait partie du paquet util\-linux, elle est disponible sur \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "l’archive du noyau Linux" "."