LOSETUP(8) Administration Système LOSETUP(8)

losetup - Mettre en place et contrôler des périphériques boucle

Obtenir des informations :

losetup [périphérique_boucle]

losetup -l [-a]

losetup -j fichier [-o position]

Détacher un périphérique boucle :

losetup -d périphérique_boucle ...

Détacher tous les périphériques boucle associés :

losetup -D

Mettre en place un périphérique boucle :

losetup [-o offset] [--sizelimit size] [--sector-size size] [-Pr] [--show] -f|loopdev file

Redimensionner un périphérique boucle :

losetup -c périphérique_boucle

losetup 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’état d’un périphérique boucle. Si seul l’argument périphérique_boucle est fourni, l’état actuel du périphérique correspondant est affiché. Sans option, tous les périphériques boucle sont affichés.

Remarquez que l’ancien format de sortie (c’est-à-dire losetup -a) avec des chaînes séparées par des virgules est obsolète, le format de sortie --list devrait être utilisé à la place.

Il est possible de créer davantage de périphériques boucle indépendants à partir du même fichier de sauvegarde. Cela peut être dangereux, causer des pertes de données, une corruption ou des réécritures. --nooverlap est à utiliser avec --find lors de la configuration pour éviter ce problème.

The loop device setup is not an atomic operation when used with --find, and losetup 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 flock(1) to avoid a collision in heavily parallel use cases.

Les arguments taille et position 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.

-a, --all

Show the status of all loop devices. Note that not all information is accessible for non-root users. See also --list. The old output format (as printed without --list) is deprecated.

-d, --detach périphérique_boucle...

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 EBUSY 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.

-D, --detach-all

Détacher tous les périphériques boucle associés.

-f, --find [fichier]

Déterminer le premier périphérique boucle non utilisé. Si un argument fichier est fourni, utiliser le périphérique trouvé comme un périphérique boucle, sinon, afficher son nom.

--show

Afficher le nom du périphérique boucle assigné si l’option -f et un argument fichier sont présents.

-L, --nooverlap

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 --find.

-j, --associated fichier [-o position]

Montrer l’état de tous les périphériques boucle associés au fichier.

-o, --offset position

Le début des données est déplacé de position octets dans le fichier ou le périphérique indiqué. position peut être suivie d’un préfixe multiplicatif, voir ci-dessus.

--sizelimit taille

La fin des données est définie au maximum à taille octets après le début des données. taille peut être suivie d’un préfixe multiplicatif, voir ci-dessus.

-b, --sector-size taille

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.

-c, --set-capacity périphérique_boucle

Forcer le pilote de boucle à relire la taille du fichier associé au périphérique boucle indiqué.

-P, --partscan

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 --sector-size avec l’option --partscan.

-r, --read-only

Configurer un périphérique boucle en lecture seule.

--direct-io[=on|off]

Enable or disable direct I/O for the backing file. The optional argument can be either on or off. If the optional argument is omitted, it defaults to on.

-v, --verbose

Mode détaillé.

-l, --list

Si un périphérique boucle ou que l’option -a 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 --output, --noheadings, --raw et --json.

-O, --output colonne[,colonne]...

Indiquer les colonnes à afficher pour la sortie --list. Utilisez B*--help* pour obtenir une liste de toutes les colonnes disponibles.

--output-all

Afficher toutes les colonnes disponibles.

-n, --noheadings

Ne pas afficher les en-têtes pour le format de sortie --list.

--raw

Utiliser l’affichage au format --list brut.

-J, --json

Utiliser le format JSON pour l’affichage --list.

cryptoloop n’est plus pris en charge et est remplacé par dm-crypt. Pour plus de précisions, consultez cryptsetup(8).

losetup renvoie 0 en cas de réussite et une valeur non nulle en cas d’échec. Lorsque losetup affiche l’état d’un périphérique boucle, il renvoie 1 si le périphérique n’est pas configuré et 2 si une erreur est survenue empêchant de déterminer l’état du périphérique.

Since version 2.37 losetup uses LOOP_CONFIGURE ioctl to setup a new loop device by one ioctl call. The old versions use LOOP_SET_FD and LOOP_SET_STATUS64 ioctls to do the same.

LOOPDEV_DEBUG=all

Activer la sortie de débogage.

/dev/loop[0..N]

Périphériques bloc boucle.

/dev/loop-control

Périphériques de contrôle boucle.

Les commandes suivantes sont des exemples d’utilisation du périphérique boucle :

# 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

Karel Zak <kzak@redhat.com> à partir de la version originale de Theodore Ts’o <tytso@athena.mit.edu>.

Pour signaler un bogue, utilisez le gestionnaire de bogues sur <https://github.com/util-linux/util-linux/issues>.

La commande losetup fait partie du paquet util-linux, elle est disponible sur l’archive du noyau Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.

2024-12-05 util-linux 2.39.3