lsblk - lister les périphériques de stockage
SYNTAXE
lsblk [options] [périphérique...]
DESCRIPTION
lsblk affiche des informations sur tous les périphériques de stockage disponibles ou sur les périphériques spécifiés. La commande lsblk lit le système de fichiers sysfs et la base de données udev pour recueillir des informations. Si la base de données udev n'est pas disponible ou si lsblk est compilé sans prise en charge d'udev, il tente alors de lire les étiquettes, les UUID et les types de systèmes de fichiers à partir du périphérique de stockage. Dans ce cas, les privilèges root sont nécessaires.
Par défaut, la commande affiche tous les périphériques de stockage (à l'exception des disques RAM) dans un format arborescent. Le même périphérique peut être répété dans l'arborescence s'il est lié à d'autres périphériques. L'option --merge est recommandée pour les configurations plus complexes afin de regrouper les périphériques et de décrire des relations N:M complexes.
L'affichage arborescent (ou le tableau children[] dans la sortie JSON) n'est activé que si la colonne NAME est présente dans la sortie ou si l'option de ligne de commande --tree est utilisée. Voir également --nodeps et --list pour contrôler le formatage de l'arborescence.
La sortie par défaut, ainsi que la sortie par défaut des options telles que --fs et --topology, sont susceptibles de changer. Par conséquent, chaque fois que cela est possible, vous devez éviter d'utiliser les sorties par défaut dans vos scripts. Définissez toujours explicitement les colonnes attendues en utilisant --output columns-list et --list dans les environnements où une sortie stable est requise.
Utilisez lsblk --list-columns pour obtenir une liste de toutes les colonnes disponibles.
Notez que lsblk peut être exécuté à un moment où udev ne dispose pas encore de toutes les informations sur les périphériques récemment ajoutés ou modifiés. Dans ce cas, il est recommandé d'utiliser udevadm settle avant lsblk pour se synchroniser avec udev.
La relation entre les périphériques de stockage et les systèmes de fichiers n'est pas toujours une relation un-à-un. Le système de fichiers peut utiliser plusieurs périphériques de stockage, ou le même système de fichiers peut être accessible via plusieurs chemins. C'est la raison pour laquelle lsblk fournit les colonnes MOUNTPOINT et MOUNTPOINTS (pl.). La colonne MOUNTPOINT affiche uniquement un point de montage (généralement la dernière instance montée du système de fichiers), et la colonne MOUNTPOINTS affiche dans une cellule multiligne tous les points de montage associés au périphérique.
OPTIONS
-A, --noempty
N'affiche pas les périphériques vides.
-a, --all
Désactive tous les filtres intégrés et affiche tous les périphériques vides et les périphériques de disque RAM.
-b, --bytes
Affiche les tailles en octets plutôt qu'au format lisible par l'homme.
Par défaut, l'unité, en laquelle les tailles sont exprimées, est l'octet, et les préfixes d'unité sont en puissance de 2^10 (1024). Les abréviations des symboles sont affichées tronquées afin d'améliorer la lisibilité, en affichant uniquement la première lettre de celles-ci ; par exemple, « 1 KiB » et « 1 MiB » sont respectivement affichées comme « 1 K » et « 1 M », omettant intentionnellement la mention « iB », qui fait partie de ces abréviations.
-H, --list-columns
Affiche les colonnes disponibles. Utilisez-le avec --json ou --raw pour obtenir une sortie au format lisible par machine.
-D, --discard
Affiche des informations sur les capacités de suppression (TRIM, UNMAP) de chaque périphérique.
-d, --nodeps
N’affiche pas les périphériques ou les esclaves dépendants. Par exemple, lsblk --nodeps /dev/sda affiche uniquement les informations sur le périphérique sda.
-E, --dedup column
Utilise une colonne comme clé de déduplication pour dédupliquer l’arborescence de sortie. Si la clé n’est pas disponible pour le périphérique, ou si le périphérique est une partition et que le périphérique disque parent fournit la même clé, le périphérique est toujours affiché.
Le cas d’utilisation habituel consiste à dédupliquer la sortie sur les systèmes à chemins multiples, par exemple avec -E WWN.
-e, --exclude list
Exclut les périphériques spécifiés par la liste séparée par des virgules des numéros de périphérique principaux. Notez que les disques RAM (principal=1) sont exclus par défaut si --all n’est pas spécifié. Le filtre est appliqué uniquement aux périphériques de niveau supérieur. Cela peut prêter à confusion pour le format de sortie --list, où la hiérarchie des périphériques n’est pas évidente.
-f, --fs
Affiche des informations sur les systèmes de fichiers. Cette option est équivalente à -o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS. Les informations faisant autorité sur les systèmes de fichiers et les RAID sont fournies par la commande blkid(8).
--hyperlink[=mode]
Affiche les chemins d’accès aux points de montage sous forme d’hyperliens de terminal. Le mode peut être défini sur « toujours », « jamais » ou « automatique ». L’argument facultatif when peut être défini sur « automatique », « jamais » ou « toujours ». Si l’argument when est omis, il prendra par défaut la valeur « automatique ». Le paramètre « automatique » signifie que les hyperliens ne seront utilisés que si la sortie se fait sur un terminal.
-I, --include list
Inclut les périphériques spécifiés par la liste séparée par des virgules des numéros de périphérique principaux. Le filtre est appliqué uniquement aux périphériques de niveau supérieur. Cela peut prêter à confusion pour le format de sortie --list, où la hiérarchie des périphériques n’est pas évidente.
-i, --ascii
Utilise des caractères ASCII pour le formatage de l’arborescence.
-J, --json
Utilise le format de sortie JSON. Il est fortement recommandé d’utiliser --output et également --tree si nécessaire. Notez que children[] n’est utilisé que si la colonne NAME ou --tree est utilisée.
-l, --list
Produit une sortie sous forme de liste. La sortie ne fournit pas d’informations sur les relations entre les périphériques et, depuis la version 2.34, chaque périphérique est affiché une seule fois si --pairs ou --raw n’est pas spécifié (les sorties analysables sont maintenues de manière rétrocompatible).
-M, --merge
Regroupe les parents des sous-arborescences pour fournir une sortie plus lisible pour les RAID et les périphériques à chemins multiples. La sortie sous forme d’arborescence est requise.
-m, --perms
Affiche des informations sur le propriétaire, le groupe et le mode du périphérique. Cette option est équivalente à -o NAME,SIZE,OWNER,GROUP,MODE.
-N, --nvme
Affiche des informations uniquement sur les périphériques NVMe.
-v, --virtio
Affiche des informations uniquement sur les périphériques virtio.
-n, --noheadings
N’affiche pas d’en-tête.
-o, --output list
Spécifie les colonnes de sortie à afficher. Utilisez --list-columns pour obtenir une liste de toutes les colonnes prises en charge. Les colonnes peuvent affecter la sortie sous forme d’arborescence. Par défaut, une arborescence est utilisée pour la colonne « NAME » (voir également --tree).
^ sblk -T
-d, --nodeps
Do not print slaves and holders.
-D, --nodeps-all
Do not print slaves, holders, or partitions.
-f, --fs
Output filesystem information.
-i, --ascii
Do not use non-ASCII characters in the output.
-l, --list
Produce list output. This is the default output format.
-m, --perms
Print permissions for each block device.
-n, --noheadings
Do not print the header line.
-o, --output list
Specify the output format. The default output is NAME,MAJ,MIN,RM,SIZE,RO,TYPE,MOUNTPOINT.
La liste par défaut des colonnes peut être étendue si une liste est spécifiée au format +liste (par exemple,
lsblk -o +UUID).
-O, --output-all
Afficher toutes les colonnes disponibles.
-P, --pairs
Produire une sortie sous forme de paires clé="valeur". Les lignes de sortie sont toujours ordonnées par
dépendances. Tous les caractères de valeur potentiellement dangereux sont échappés en hexadécimal (\x<code>). Voir également
l'option --shell.
-p, --paths
Afficher les chemins d'accès complets aux périphériques.
-Q, --filter expr
Afficher uniquement les périphériques qui répondent aux conditions spécifiées par l'expression. Le filtre est évalué
avant que `lsblk` ne collecte les données pour toutes les colonnes de sortie. Seules les données nécessaires à l'évaluation
paresseuse de l'expression sont récupérées à partir du système. Cette approche peut améliorer les performances par rapport
au filtrage ultérieur, comme c'est souvent le cas avec des outils tels que [grep]({filename}../../grep)(1).
Cette fonctionnalité est EXPERIMENTALE. Voir également scols-filter(5). Par exemple, pour exclure sda et sdb, mais afficher
tout le reste ('!~' est un opérateur de correspondance d'expression régulière négative) :
`lsblk --filter 'NAME !~ "sd[ab]"`
--highlight expr
Coloriser les lignes correspondant à l'expression. Cette fonctionnalité est EXPERIMENTALE. Voir également
scols-filter(5).
--ct name [: param [: function ]]
Définir un compteur personnalisé. Les compteurs sont affichés après la sortie standard. Le nom est le nom personnalisé du
compteur, le paramètre optionnel est le nom de la colonne à utiliser pour le compteur, et la fonction optionnelle spécifie
la fonction d'agrégation, les fonctions prises en charge sont : count, min, max ou sum. La valeur par défaut est count.
Si le paramètre n'est pas spécifié, le compteur compte alors le nombre de lignes. Cette fonctionnalité est
EXPERIMENTALE. Voir également --ct-filter.
Par exemple, --ct MyCounter:SIZE:sum comptera la somme de la valeur SIZE pour toutes les lignes ; et pour compter le nombre
de disques SATA, il est possible d'utiliser :
`lsblk --ct-filter 'TYPE=="disk" && TRAN=="sata"' --ct "Nombre de périphériques SATA"`
--ct-filter expr
Définir une restriction pour le compteur suivant. Cette fonctionnalité est EXPERIMENTALE. Voir également --ct et
scols-filter(5). Par exemple, pour agréger les tailles par type de périphérique :
`lsblk --ct-filter 'TYPE=="part"' --ct Partitions:SIZE:sum \
--ct-filter 'TYPE=="disk"' --ct WholeDisks:SIZE:sum`
-r, --raw
Produire une sortie au format brut. Les lignes de sortie sont toujours ordonnées par dépendances. Tous les caractères
potentiellement dangereux sont échappés en hexadécimal (\x<code>) dans les colonnes NAME, KNAME, LABEL, PARTLABEL et
MOUNTPOINT.
-S, --scsi
Afficher uniquement les informations sur les périphériques SCSI. Toutes les partitions, les périphériques esclaves et les
périphériques hôtes sont ignorés.
-s, --inverse
Afficher les dépendances dans l'ordre inverse. Si la sortie --list est demandée, les lignes sont toujours ordonnées par
dépendances.
-T, --tree[=column]
Forcer le format de sortie arborescent. Si une colonne est spécifiée, une arborescence est affichée dans la colonne. La
valeur par défaut est la colonne NAME.
-t, --topology
Afficher les informations sur la topologie des périphériques de bloc. Cette option est équivalente à
`lsblk -T`
-d, --nodeps
N'afficher pas les périphériques esclaves et hôtes.
-D, --nodeps-all
N'afficher pas les périphériques esclaves, hôtes ni les partitions.
-f, --fs
Afficher les informations sur le système de fichiers.
-i, --ascii
N'utiliser pas de caractères non ASCII dans la sortie.
-l, --list
Produire une sortie sous forme de liste. Il s'agit du format de sortie par défaut.
-m, --perms
Afficher les permissions de chaque périphérique de bloc.
-n, --noheadings
N'afficher pas la ligne d'en-tête.
-o, --output list
Spécifier le format de sortie. La sortie par défaut est NAME,MAJ,MIN,RM,SIZE,RO,TYPE,MOUNTPOINT.
-o NOM,ALIGNEMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME.
-w, --width nombre
Spécifie la largeur de sortie en nombre de caractères. La valeur par défaut est le nombre de colonnes du terminal, et si ce n’est pas exécuté sur un terminal, la largeur de sortie n’est pas limitée par défaut. Cette option force également lsblk à supposer que les caractères de contrôle du terminal et les caractères non sécurisés ne sont pas autorisés. Le cas d’utilisation prévu est, par exemple, lorsque lsblk est utilisé par la commande watch(1).
-x, --sort colonne
Trie les lignes de sortie par colonne. Cette option active par défaut le format de sortie --list. Il est possible d’utiliser l’option --tree pour forcer une sortie de type arbre, et les branches de l’arbre sont alors triées par la colonne.
-y, --shell
Le nom de la colonne sera modifié pour ne contenir que les caractères autorisés pour les identificateurs de variables shell, par exemple, MIN_IO et FSUSE_PCT au lieu de MIN-IO et FSUSE%. Ceci peut être utilisé, par exemple, avec --pairs. Notez que cette fonctionnalité a été activée automatiquement pour --pairs dans la version 2.37, mais en raison de problèmes de compatibilité, il est maintenant nécessaire de demander ce comportement avec --shell.
-z, --zoned
Affiche les informations relatives à la zone pour chaque périphérique.
--sysroot répertoire
Collecte des données pour une instance Linux autre que l’instance à partir de laquelle la commande lsblk est exécutée. Le répertoire spécifié est le répertoire racine du système de l’instance Linux à inspecter. Les nœuds de périphérique réels dans le répertoire cible peuvent être remplacés par des fichiers texte contenant des attributs udev.
--properties-by liste
Cette option spécifie les méthodes utilisées par lsblk pour collecter des informations sur les systèmes de fichiers et les tables de partition. La liste est une liste de noms de méthodes séparés par des virgules. La valeur par défaut est « file,udev,blkid ». Les méthodes prises en charge sont :
udev
Lit les données à partir de la base de données udev. En cas d’échec, il passe à la méthode de sondage suivante.
blkid
Lit les données directement à partir du périphérique à l’aide de libblkid. En cas d’échec, il passe à la méthode de sondage suivante.
file
Lit les données à partir d’un fichier. Cette méthode n’est utilisée que si l’option --sysroot est spécifiée. Cette méthode arrête toujours le sondage lorsqu’elle est utilisée.
none
Ne sonde pas. Cette méthode arrête toujours le sondage.
-h, --help
Affiche le texte d’aide et quitte.
-V, --version
Affiche la version et quitte.
CODE DE RETOUR
0 succès
1 échec
32 aucun des périphériques spécifiés n’a été trouvé
64 certains des périphériques spécifiés ont été trouvés, d’autres non
ENVIRONNEMENT
LSBLK_DEBUG=all
active la sortie de débogage de lsblk.
LIBBLKID_DEBUG=all
active la sortie de débogage de libblkid.
LIBMOUNT_DEBUG=all
active la sortie de débogage de libmount.
LIBSMARTCOLS_DEBUG=all
active la sortie de débogage de libsmartcols.
LIBSMARTCOLS_DEBUG_PADDING=on
utilise les caractères de remplissage visibles.
NOTES
Pour les partitions, certaines informations (par exemple, les attributs de file d’attente) sont héritées du périphérique parent.
La commande lsblk doit être en mesure de rechercher chaque périphérique bloc par numéro principal : secondaire, ce qui est fait en utilisant /sys/dev/block. Ce répertoire sysfs block est apparu dans le noyau 2.6.27 (octobre 2008). En cas de problèmes avec un noyau suffisamment récent, vérifiez que CONFIG_SYSFS était activé au moment de la compilation du noyau.
AUTEURS
Milan Broz <_>, Karel Zak <_>
VOIR AUSSI
blkid(8), findmnt(8) ls(1), scols-filter(5)
SIGNALEMENT DE BUGS
Pour les signalements de bugs, utilisez le suivi des problèmes [https://github.com/util-linux/util-linux/issues].
DISPONIBILITÉ
La commande lsblk fait partie du paquet util-linux qui peut être téléchargé depuis l’archive du noyau Linux [https://www.kernel.org/pub/linux/utils/util-linux/].