lsblk - listar dispositivos de bloque
SINOPSIS
lsblk [opciones] [dispositivo...]
DESCRIPCIÓN
lsblk lista información sobre todos los dispositivos de bloque disponibles o los especificados. El comando lsblk lee el sistema de archivos sysfs y la base de datos de udev para recopilar información. Si la base de datos de udev no está disponible o lsblk se compila sin soporte de udev, entonces intenta leer las ETIQUETAS, UUID y los tipos de sistema de archivos desde el dispositivo de bloque. En este caso, se necesitan permisos de root.
De forma predeterminada, el comando imprime todos los dispositivos de bloque (excepto los discos RAM) en un formato de árbol. El mismo dispositivo se puede repetir en el árbol si se relaciona con otros dispositivos. La opción --merge se recomienda para configuraciones más complejas para recopilar grupos de dispositivos y describir relaciones N:M complejas.
La salida en forma de árbol (o la matriz children[] en la salida JSON) solo se habilita si la columna NAME está presente en la salida o cuando se usa la opción de línea de comandos --tree. Consulte también --nodeps y --list para controlar el formato del árbol.
La salida predeterminada, así como la salida predeterminada de las opciones como --fs y --topology, están sujetas a cambios. Por lo tanto, siempre que sea posible, debe evitar el uso de salidas predeterminadas en sus scripts. Siempre defina explícitamente las columnas esperadas utilizando --output columns-list y --list en entornos donde se requiere una salida estable.
Utilice lsblk --list-columns para obtener una lista de todas las columnas disponibles.
Tenga en cuenta que lsblk puede ejecutarse en un momento en que udev aún no tiene toda la información sobre los dispositivos agregados o modificados recientemente. En este caso, se recomienda utilizar udevadm settle antes de lsblk para sincronizarse con udev.
La relación entre los dispositivos de bloque y los sistemas de archivos no siempre es de uno a uno. El sistema de archivos puede utilizar más dispositivos de bloque, o el mismo sistema de archivos puede ser accesible mediante más rutas. Esta es la razón por la que lsblk proporciona las columnas MOUNTPOINT y MOUNTPOINTS (pl.). La columna MOUNTPOINT muestra solo un punto de montaje (generalmente la última instancia montada del sistema de archivos), y la columna MOUNTPOINTS muestra en una celda de varias líneas todos los puntos de montaje asociados con el dispositivo.
OPCIONES
-A, --noempty
No imprima los dispositivos vacíos.
-a, --all
Desactive todos los filtros integrados y liste todos los dispositivos vacíos y los dispositivos de disco RAM también.
-b, --bytes
Imprima los tamaños en bytes en lugar de en un formato legible por humanos.
De forma predeterminada, la unidad, en la que se expresan los tamaños, es byte, y los prefijos de unidad están en una potencia de 2^10 (1024). Las abreviaturas de los símbolos se muestran truncadas para lograr una mejor legibilidad, mostrando solo la primera letra de las mismas; ejemplos: "1 KiB" y "1 MiB" se muestran respectivamente como "1 K" y "1 M", omitiendo intencionalmente la mención "iB", que es parte de estas abreviaturas.
-H, --list-columns
Lista las columnas disponibles, úselo con --json o --raw para obtener la salida en un formato legible por máquina.
-D, --discard
Imprime información sobre las capacidades de eliminación (TRIM, UNMAP) para cada dispositivo.
-d, --nodeps
No imprima los dispositivos dependientes o esclavos. Por ejemplo, lsblk --nodeps /dev/sda imprime información solo sobre el dispositivo sda.
-E, --dedup column
Use la columna como clave de desduplicación para desduplicar el árbol de salida. Si la clave no está disponible para el dispositivo, o el dispositivo es una partición y el dispositivo completo principal proporciona la misma clave que el dispositivo, entonces siempre se imprime el dispositivo.
El caso de uso habitual es desduplicar la salida en dispositivos de múltiples rutas del sistema, por ejemplo, mediante -E
WWN.
-e, --exclude list
Excluya los dispositivos especificados por la lista separada por comas de números de dispositivo principal. Tenga en cuenta que los discos RAM (principal=1) se excluyen de forma predeterminada si no se especifica --all. El filtro se aplica solo a los dispositivos de nivel superior. Esto puede ser confuso para el formato de salida --list donde la jerarquía de los dispositivos no es obvia.
-f, --fs
Imprima información sobre los sistemas de archivos. Esta opción es equivalente a -o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS. La información definitiva sobre los sistemas de archivos y las matrices RAID se proporciona mediante el comando blkid(8).
--hyperlink[=mode]
Imprima las rutas de los puntos de montaje como hipervínculos de terminal. El modo se puede establecer en "always", "never" o "auto". El argumento opcional when se puede establecer en "auto", "never" o "always". Si se omite el argumento when, tendrá el valor predeterminado de "auto". La configuración "auto" significa que los hipervínculos solo se utilizarán si la salida está en un terminal.
-I, --include list
Incluya los dispositivos especificados por la lista separada por comas de números de dispositivo principal. El filtro se aplica solo a los dispositivos de nivel superior. Esto puede ser confuso para el formato de salida --list donde la jerarquía de los dispositivos no es obvia.
-i, --ascii
Utilice caracteres ASCII para el formato de árbol.
-J, --json
Utilice el formato de salida JSON. Se recomienda encarecidamente utilizar --output y también --tree si es necesario. Tenga en cuenta que children[] solo se utiliza si se utiliza la columna NAME o --tree.
-l, --list
Genere la salida en forma de lista. La salida no proporciona información sobre las relaciones entre los dispositivos y, a partir de la versión 2.34, cada dispositivo se imprime solo una vez si no se especifica --pairs o --raw (se mantienen las salidas analizables de forma compatible con versiones anteriores).
-M, --merge
Agrupe los elementos principales de los subárboles para proporcionar una salida más legible para las matrices RAID y los dispositivos de múltiples rutas. Se requiere la salida en forma de árbol.
-m, --perms
Imprima información sobre el propietario, el grupo y el modo del dispositivo. Esta opción es equivalente a -o NAME,SIZE,OWNER,GROUP,MODE.
-N, --nvme
Imprima información solo sobre los dispositivos NVMe.
-v, --virtio
Imprima información solo sobre los dispositivos virtio.
-n, --noheadings
No imprima una línea de encabezado.
-o, --output list
Especifique qué columnas de salida se deben imprimir. Utilice --list-columns para obtener una lista de todas las columnas admitidas. Las columnas pueden afectar la salida en forma de árbol. El valor predeterminado es utilizar el árbol para la columna 'NAME' (consulte también --tree).
La lista de columnas predeterminada se puede extender si se especifica una lista en el formato +list (por ejemplo, lsblk -o +UUID).
-O, --output-all
Mostrar todas las columnas disponibles.
-P, --pairs
Producir una salida en forma de pares clave="valor". Las líneas de salida siguen estando ordenadas por dependencias. Todos los caracteres potencialmente inseguros del valor se escapan en formato hexadecimal (\x<code>). Consulte también la opción --shell.
-P, --paths
Imprimir las rutas completas de los dispositivos.
-Q, --filter expr
Mostrar solo los dispositivos que cumplen las condiciones especificadas por la expresión. El filtro se evalúa antes de que lsblk recopile datos para todas las columnas de salida. Solo se recuperan los datos necesarios para la evaluación lenta de la expresión del sistema. Este enfoque puede mejorar el rendimiento en comparación con el filtrado posterior, como el que realizan comúnmente herramientas como grep(1).
Esta función es EXPERIMENTAL. Consulte también scols-filter(5). Por ejemplo, para excluir sda y sdb, pero
mostrar todo lo demás ('!~' es un operador de coincidencia de expresión regular negativa):
lsblk --filter 'NAME !~ "sd[ab]"'
--highlight expr
Colorear las líneas que coincidan con la expresión. Esta función es EXPERIMENTAL. Consulte también scols-filter(5).
--ct name [: param [: function ]]
Definir un contador personalizado. Los contadores se imprimen después de la salida estándar. El nombre es el nombre personalizado del contador, el parámetro opcional es el nombre de la columna que se utilizará para el contador, y la función opcional especifica la función de agregación. Las funciones admitidas son: count, min, max o sum. El valor predeterminado es count.
Si no se especifica el parámetro, el contador cuenta el número de líneas. Esta función es EXPERIMENTAL. Consulte también --ct-filter.
Por ejemplo, --ct MyCounter:SIZE:sum calculará el resumen de SIZE de todas las líneas; y para contar el número de discos SATA, es posible utilizar:
lsblk --ct-filter 'TYPE=="disk" && TRAN=="sata"' --ct "Número de dispositivos SATA"
--ct-filter expr
Definir una restricción para el siguiente contador. Esta función es EXPERIMENTAL. Consulte también --ct y scols-filter(5). Por ejemplo, para agregar tamaños por tipo de dispositivo:
lsblk --ct-filter 'TYPE=="part"' --ct Partitions:SIZE:sum \
--ct-filter 'TYPE=="disk"' --ct WholeDisks:SIZE:sum
-r, --raw
Producir una salida en formato sin procesar. Las líneas de salida siguen estando ordenadas por dependencias. Todos los caracteres potencialmente inseguros se escapan en formato hexadecimal (\x<code>) en las columnas NAME, KNAME, LABEL, PARTLABEL y MOUNTPOINT.
-S, --scsi
Mostrar información sobre los dispositivos SCSI únicamente. Se ignoran todos los particiones, esclavos y dispositivos secundarios.
-s, --inverse
Imprimir las dependencias en orden inverso. Si se solicita la salida --list, las líneas siguen estando ordenadas por dependencias.
-T, --tree[=column]
Forzar un formato de salida en forma de árbol. Si se especifica la columna, se imprime un árbol en esa columna. El valor predeterminado es la columna NAME.
-t, --topology
Mostrar información sobre la topología de los dispositivos de bloque. Esta opción es equivalente a
-o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME.
-w, --width número
Especifica el ancho de salida como un número de caracteres. El valor predeterminado es el número de columnas del terminal y, si no se ejecuta en un terminal, el ancho de salida no está restringido de forma predeterminada. Esta opción también obliga a lsblk a asumir que los caracteres de control del terminal y los caracteres no seguros no están permitidos. El caso de uso previsto es, por ejemplo, cuando lsblk se utiliza con el comando watch(1).
-x, --sort columna
Ordena las líneas de salida por columna. Esta opción habilita el formato de salida --list de forma predeterminada. Es posible utilizar la opción --tree para forzar una salida similar a un árbol y, a continuación, las ramas del árbol se ordenan por la columna.
-y, --shell
El nombre de la columna se modificará para contener solo los caracteres permitidos para los identificadores de variables de shell, por ejemplo, MIN_IO y FSUSE_PCT en lugar de MIN-IO y FSUSE%. Esto se puede utilizar, por ejemplo, con --pairs. Tenga en cuenta que esta característica se ha habilitado automáticamente para --pairs en la versión 2.37, pero debido a problemas de compatibilidad, ahora es necesario solicitar este comportamiento mediante --shell.
-z, --zoned
Imprime la información relacionada con la zona para cada dispositivo.
--sysroot directorio
Recopila datos para una instancia de Linux distinta de la instancia desde la que se emite el comando lsblk. El directorio especificado es el directorio raíz del sistema de la instancia de Linux que se va a inspeccionar. Los nodos de dispositivo reales en el directorio de destino pueden ser reemplazados por archivos de texto con atributos de udev.
--properties-by lista
Esta opción especifica los métodos que lsblk utiliza para recopilar información sobre los sistemas de archivos y las tablas de particiones. La lista es una lista separada por comas de nombres de métodos. La configuración predeterminada es "file,udev,blkid". Los métodos admitidos son:
udev
Lee los datos de la base de datos de udev. Si no tiene éxito, continúa con el siguiente método de sondeo.
blkid
Lee los datos directamente del dispositivo mediante libblkid. Si no tiene éxito, continúa con el siguiente método de sondeo.
file
Lee los datos de un archivo. Este método solo se utiliza si se especifica la opción --sysroot.
Este método siempre detiene el sondeo si se utiliza.
none
No realiza el sondeo. Este método siempre detiene el sondeo.
-h, --help
Muestra el texto de ayuda y sale.
-V, --version
Muestra la versión y sale.
ESTADO DE SALIDA
0 éxito
1 error
32 no se encontró ninguno de los dispositivos especificados
64 se encontraron algunos de los dispositivos especificados, no todos
ENTORNO
LSBLK_DEBUG=all
habilita la salida de depuración de lsblk.
LIBBLKID_DEBUG=all
habilita la salida de depuración de libblkid.
LIBMOUNT_DEBUG=all
habilita la salida de depuración de libmount.
LIBSMARTCOLS_DEBUG=all
habilita la salida de depuración de libsmartcols.
LIBSMARTCOLS_DEBUG_PADDING=on
utiliza caracteres de relleno visibles.
NOTAS
Para las particiones, cierta información (por ejemplo, los atributos de la cola) se hereda del dispositivo padre.
El comando lsblk debe poder buscar cada dispositivo de bloque por los números de mayor:menor, lo cual se realiza mediante el uso de /sys/dev/block. Este directorio de bloques sysfs apareció en el kernel 2.6.27 (octubre de 2008). En caso de problemas con un kernel lo suficientemente nuevo, compruebe que CONFIG_SYSFS estaba habilitado en el momento de la compilación del kernel.
AUTORES
Milan Broz <_>, Karel Zak <_>
VÉASE TAMBIÉN
blkid(8), findmnt(8) ls(1), scols-filter(5)
INFORMES DE ERRORES
Para informar sobre errores, utilice el rastreador de problemas [https://github.com/util-linux/util-linux/issues].
DISPONIBILIDAD
El comando lsblk forma parte del paquete util-linux, que se puede descargar de Linux Kernel Archive [https://www.kernel.org/pub/linux/utils/util-linux/].