Ubuntu Manpage: lsblk - виведення списку блокових пристроїв

Provided by: util-linux-locales_2.40.2-14ubuntu1.1_all

НАЗВА

       lsblk - виведення списку блокових пристроїв

КОРОТКИЙ ОПИС

       lsblk [options] [device...]

ОПИС

lsblk lists information about all available or the specified block devices. The lsblk command reads the
sysfs filesystem and udev db to gather information. If the udev db is not available or lsblk is compiled
without udev support, then it tries to read LABELs, UUIDs and filesystem types from the block device. In
this case root permissions are necessary.

By default, the command prints all block devices (except RAM disks) in a tree-like format. The same
device can be repeated in the tree if it relates to other devices. The --merge option is recommended for
more complicated setups to gather groups of devices and describe complex N:M relationships.

The tree-like output (or children[] array in the JSON output) is enabled only if NAME column it present
in the output or when --tree command line option is used. See also --nodeps and --list to control the
tree formatting.

Типовий формат виведення, а також типовий формат виведення для параметрів, подібних до --fs та
--topology, може бути змінено авторами програми. Тому, коли це можливо, вам слід уникати обробки типових
виведених даних у ваших скриптах. Завжди явно визначайте очікувані стовпчики за допомогою параметра
--output список-стовпчиків разом зі списком стовпчиків у середовищах, де потрібне виведення стабільного
набору даних.

Use lsblk --list-columns to get a list of all available columns.

Зауважте, що lsblk може бути запущено у момент, коли udev не має усіх даних щодо нещодавно доданих або
змінених пристроїв. У цьому випадку рекомендуємо скористатися командою udevadm settle до команди lsblk,
щоб синхронізувати дані udev.

Зв’язок між блоковими пристроями і файловими системами не завжди є однозначним. Для файлової системи може
бути використано декілька блокових пристроїв, а одна файлова система може бути доступною за декількома
шляхами. Ось чому lsblk показує стовпчики MOUNTPOINT та MOUNTPOINTS (множина). У стовпчику MOUNTPOINT
буде показано лише одну точку монтування (зазвичай, останній змонтований екземпляр файлової системи), а у
стовпчику MOUNTPOINTS буде показано багаторядкову комірку усіх точок монтування, які пов’язано із
пристроєм.

ПАРАМЕТРИ

-A, --noempty
Не виводити даних для порожніх пристроїв.

-a, --all
Вимкнути усі вбудовані фільтри і вивести список усіх порожніх пристроїв, а також дискових пристроїв в
оперативній пам’яті.

-b, --bytes
Вивести розмір у байтах, а не у зручному для читання форматі.

Типово, одиницею, у якій показано розміри, є байт, а префікси одиниць є степенями 2^10 (1024). Для
забезпечення зручності читання відбувається скорочення позначень до першої літери запису; приклади:
«1 КіБ» та «1 МіБ» буде показано як «1 K» та «1 M», із вилученням «іБ», яке є частиною цих скорочень.

-H, --list-columns
List the available columns, use with --json or --raw to get output in machine-readable format.

-D, --discard
Вивести відомості щодо можливостей відкидання (TRIM, UNMAP) для кожного з пристроїв.

-d, --nodeps
Не виводити пристрої-утримувачі або підлеглі пристрої. Наприклад, lsblk --nodeps /dev/sda виведе дані
лише щодо пристрою sda.

-E, --dedup стовпчик
Скористатися стовпчиком як ключем для усування дублікатів в ієрархії виведених даних. Якщо ключ
виявиться недоступним для пристрою або пристрій буде розділом і батьківський пристрій усього диска
надають той самий ключ, буде завжди виведено дані пристрою.

Звичайним використанням є усування дублікатів з виведення для системних пристроїв із багатьма
шляхами, наприклад, за допомогою -E WWN.

-e, --exclude список
Виключити пристрої, які вказано у списку номерів основних пристроїв, які відокремлено комами.
Зауважте, що диски в оперативній пам’яті (основний=1) типово виключено, якщо не вказано --all. Фільтр
буде застосовано лише до пристроїв верхнього рівня. Це може заплутати показ у форматі виведення
--list, де визначення ієрархії пристроїв не є очевидним.

-f, --fs
Вивести дані щодо файлових систем. Цей параметр є еквівалентним до -o
NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS. Надійні дані щодо файлових систем та RAID
буде надано командою blkid(8).

-I, --include список
Включити пристрої, які вказано у списку номерів основних пристроїв, які відокремлено комами. Фільтр
буде застосовано лише до пристроїв верхнього рівня. Це може заплутати показ у форматі виведення
--list, де визначення ієрархії пристроїв не є очевидним.

-i, --ascii
Використати символи ASCII для форматування ієрархії.

-J, --json
Скористатися форматом виведення JSON. Наполегливо рекомендуємо скористатися --output, а також --tree,
якщо потрібно. Зауважте, що children[] буде використано, лише якщо використано стовпчик NAME або
--tree.

-l, --list
Вивести дані у форматі списку. У виведених даних не буде надано відомостей щодо взаємозв’язок між
пристроями, а починаючи з версії 2.34, запис кожного пристрою буде виведено лише раз, якщо не вказано
--pairs або --raw (супровід придатного до обробки виведення передбачено лише для зворотної
сумісності).

-M, --merge
Згрупувати батьківські записи підлеглих ієрархій з метою створення зручнішого для читання виведення
для RAID і пристроїв із багатьма шляхами. Потрібне деревоподібне виведення.

-m, --perms
Вивести дані щодо власника, групи і режиму доступу до пристрою. Цей параметр еквівалентний до -o
NAME,SIZE,OWNER,GROUP,MODE.

-N, --nvme
Вивести дані лише щодо пристроїв NVMe.

-v, --virtio
Вивести дані лише щодо пристроїв virtio.

-n, --noheadings
Не виводити рядок заголовка.

-o, --output список
Визначити, які стовпчики слід використовувати для виведення. Скористайтеся параметром --list-columns,
щоб переглянути список підтримуваних стовпчиків*). Вибрані стовпчики можуть впливати на деревоподібне
виведення. Типовим варіантом є використання ієрархії для стовпчика «NAME» (див. також --tree).

Типовий список стовпчиків може бути розширено, якщо список вказано у форматі +список (наприклад,
lsblk -o +UUID)

-O, --output-all
Вивести список усіх доступних стовпчиків.

-P, --pairs
Вивести дані у формі пар ключ="значення". Рядки виведення буде упорядковано за залежностями. Усі
потенційно небезпечні символи значень буде екрановано (\x<код>). Див. також параметр --shell.

-p, --paths
Виводити шляхи до пристроїв повністю.

-Q, --filter вираз
Print only the devices that meet the conditions specified by the expr. The filter is assessed prior
to lsblk collecting data for all output columns. Only the necessary data for the lazy evaluation of
the expression is retrieved from the system. This approach can enhance performance when compared to
post-filtering, as commonly done by tools such as grep(1).

This feature is EXPERIMENTAL. See also scols-filter(5). For example exclude sda and sdb, but print
everything else ('!~' is a negative regular expression matching operator):

lsblk --filter 'NAME !~ "sd[ab]"'

--highlight вираз
Colorize lines matching the expression. This feature is EXPERIMENTAL. See also scols-filter(5).

--ct назва [: параметр [: функція ]]
Define a custom counter. The counters are printed after the standard output. The name is the custom
name of the counter, the optional param is the name of the column to be used for the counter, and the
optional function specifies the aggregation function, supported functions are: count, min, max, or
sum. The default is count.

If the param is not specified, then the counter counts the number of lines. This feature is
EXPERIMENTAL. See also --ct-filter.

For example, --ct MyCounter:SIZE:sum will count the summary for SIZE from all lines; and to count the
number of SATA disks, it is possible to use:

lsblk --ct-filter 'TYPE=="disk" && TRAN=="sata"' --ct "Number of SATA devices"

--ct-filter вираз
Define a restriction for the next counter. This feature is EXPERIMENTAL. See also --ct and
scols-filter(5). For example, aggregate sizes by device type:

lsblk --ct-filter 'TYPE=="part"' --ct Partitions:SIZE:sum \
--ct-filter 'TYPE=="disk"' --ct WholeDisks:SIZE:sum

-r, --raw
Вивести дані у необробленому форматі. Рядки виведення буде упорядковано за залежностями. Усі
потенційно небезпечні символи значень буде екрановано (\x<код>) у стовпчиках NAME, KNAME, LABEL,
PARTLABEL і MOUNTPOINT.

-S, --scsi
Вивести дані лише щодо пристроїв SCSI. Усі розділи, допоміжні пристрої та пристрої утримання буде
проігноровано.

-s, --inverse
Вивести залежності в оберненому порядку. Якщо буде надіслано запит щодо виведення --list, рядки все
одно буде упорядковано за залежностями.

-T, --tree[=стовпчик]
Примусово використати деревоподібний формат виведення. Якщо вказано стовпчик, ієрархію буде виведено
у стовпчик. Типовим є стовпчик NAME.

-t, --topology
Вивести дані щодо топології блокового пристрою. Цей параметр є еквівалентним до такого

-o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME.

-h, --help
Вивести текст довідки і завершити роботу.

-V, --version
Вивести дані щодо версії і завершити роботу.

-w, --width число
Вказує ширину виведення у кількості символів. Типовою шириною є кількість стовпчиків у терміналі, а
якщо програму запущено не у терміналі, ширину виведення типово взагалі не обмежено. Цей параметр
примушує lsblk до припущення, що не можна використовувати символи керування терміналом та небезпечні
символи. Прикладом застосування є використання lsblk командою watch(1).

-x, --sort стовпчик
Упорядкувати рядки виведення за стовпчиком. Цей параметр типово вмикає формат виведення --list. Можна
скористатися параметром --tree для примусового використання деревоподібного виведення, а гілки дерева
буде упорядковано за стовпчиком.

-y, --shell
Назву стовпчика буде змінено так, щоб вона містила лише символи, які є дозволеними для
ідентифікаторів змінних командної оболонки, наприклад, MIN_IO і FSUSE_PCT замість MIN-IO і FSUSE%. Це
корисно, зокрема, з --pairs. Зауважте, що цю можливість було автоматично увімкнено для --pairs у
версії 2.37, але через проблеми із сумісністю у нових версіях потрібно викликати таку поведінку за
допомогою параметра --shell.

-z, --zoned
Вивести пов’язані із зоною дані для кожного пристрою.

--sysroot каталог
Зібрати дані для екземпляра Linux, відмінного від екземпляра, з якого запущено команду lsblk.
Вказаний каталог є кореневим каталогом системи екземпляра Linux, ревізію якого слід виконати.
Справжні вузли пристроїв у каталозі призначення може бути замінено текстовими файлами з атрибутами
udev.

СТАН ВИХОДУ

       0
           успіх

       1
           помилка

       32
           не знайдено вказаних пристроїв

       64
           знайдено якісь із вказаних пристроїв, деякі не знайдено

СЕРЕДОВИЩЕ

       LSBLK_DEBUG=all
           вмикає діагностичне виведення у lsblk.

       LIBBLKID_DEBUG=all
           вмикає показ діагностичних повідомлень libblkid.

       LIBMOUNT_DEBUG=all
           вмикає показ діагностичних повідомлень libmount.

       LIBSMARTCOLS_DEBUG=all
           вмикає показ діагностичних повідомлень libsmartcols.

       LIBSMARTCOLS_DEBUG_PADDING=on
           використати символи візуального доповнення.

ЗАУВАЖЕННЯ

       Для розділів деякі дані (наприклад атрибути черги) успадковуються від батьківського пристрою.

       Команда lsblk повинна мати можливість шукати усі блокові пристрої за числами основний:підлеглий. Це
       завдання виконується за допомогою /sys/dev/block. Цей блоковий каталог sysfs з’явився у ядрі 2.6.27
       (жовтень 2008 року). Якщо виникнуть проблеми із достатньо новим ядром, перевірте, чи було увімкнено
       CONFIG_SYSFS під час збирання ядра.

АВТОРИ

       Milan Broz <gmazyland@gmail.com>, Karel Zak <kzak@redhat.com>

ТАКОЖ ПЕРЕГЛЯНЬТЕ

       blkid(8), findmnt(8) ls(1), scols-filter(5)

ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ

       Для звітування щодо вад скористайтеся системою стеження за вадами -
       https://github.com/util-linux/util-linux/issues.

ДОСТУП ДО ПРОГРАМИ

       Програма lsblk є частиною пакунка util-linux, який можна отримати з архіву ядра Linux
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.40.2                                  2025-06-05                                           LSBLK(8)