НАЗВА

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