Provided by: manpages-fr_4.10.0-1_all
NOM
losetup - Mettre en place et contrôler des périphériques boucle
SYNOPSIS
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 position] [--sizelimit taille] [--sector-size taille. [-Pr] [--show] -f|périphérique_boucle fichier Redimensionner un périphérique boucle : losetup -c périphérique_boucle
DESCRIPTION
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. La configuration du périphérique boucle n’est pas une opération atomique lorsqu’elle est utilisée avec --find et losetup ne protège pas cette opération par un verrou. Le nombre d’essais est restreint en interne à un maximum de 16. Il est recommandé d’utiliser par exemple flock(1) pour éviter une collision dans les cas d’utilisations massivement parallèles.
OPTIONS
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 Montrer l’état de tous les périphériques boucle. Remarquez que tous les renseignements ne sont pas accessibles aux utilisateurs ordinaires. Consultez également --list. L’ancien format de sortie (tel qu’affiché sans --list)) est obsolète. -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 Régler la taille de secteur logique du périphérique boucle en octet (depuis Linux 4.14). Cette option peut être utilisée pour créer un nouveau périphérique boucle ainsi que pour une commande autonome modifiant la taille de secteur d’un périphérique boucle déjà existant. -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] Activer ou désactiver les E/S directes pour le fichier de sauvegarde. L’argument facultatif peut être on ou off. En absence d’argument, off est la valeur par défaut. -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 --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. -V, --version Afficher le nom et la version du logiciel et quitter. -h, --help Afficher l’aide-mémoire puis quitter.
CHIFFREMENT
cryptoloop n’est plus pris en charge et est remplacé par dm-crypt. Pour plus de précisions, consultez cryptsetup(8).
CODE DE RETOUR
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.
ENVIRONNEMENT
LOOPDEV_DEBUG=all Activer la sortie de débogage.
FICHIERS
/dev/loop[0..N] Périphériques bloc boucle. /dev/loop-control Périphériques de contrôle boucle.
EXEMPLE
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
AUTEURS
Karel Zak <kzak@redhat.com> à partir de la version originale de Theodore Ts'o <tytso@athena.mit.edu>
DISPONIBILITÉ
La commande losetup fait partie du paquet util-linux, elle est disponible sur <htps://www.kernel.org/pub/linux/utils/util-linux/>.
TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess <ccb@club-internet.fr>, Michel Quercia <quercia AT cal DOT enst DOT fr>, Thierry Vignaud <tvignaud@mandriva.com>, Frédéric Delanoy <delanoy_f@yahoo.com>, Thierry Vignaud <tvignaud@mandriva.com>, Christophe Sauthier <christophe@sauthier.com>, Sébastien Blanchet, Jérôme Perzyna <jperzyna@yahoo.fr>, Aymeric Nys <aymeric AT nnx POINT com>, Alain Portal <aportal@univ-montp2.fr>, Thomas Huriaux <thomas.huriaux@gmail.com>, Yves Rütschlé <l10n@rutschle.net>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Philippe Piette <foudre-blanche@skynet.be>, Jean-Baka Domelevo-Entfellner <domelevo@gmail.com>, Nicolas Haller <nicolas@boiteameuh.org>, Sylvain Archenault <sylvain.archenault@laposte.net>, Valéry Perrin <valery.perrin.debian@free.fr>, Jade Alglave <jade.alglave@ens-lyon.org>, Nicolas François <nicolas.francois@centraliens.net>, Alexandre Kuoch <alex.kuoch@gmail.com>, Lyes Zemmouche <iliaas@hotmail.fr>, Florentin Duneau <fduneau@gmail.com>, Alexandre Normand <aj.normand@free.fr>, David Prévot <david@tilapin.org> et Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr> Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org ⟨⟩.