НАЗВА

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

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

       lsblk [параметри] [пристрій...]

ОПИС

       lsblk виводить список відомостей про усі доступні або вказані блокові пристрої. Команда
       lsblk читає файлову систему sysfs і базу даних udev для збирання відомостей. Якщо база
       даних udev є недоступною або lsblk зібрано без підтримки udev, програма намагається
       прочитати з блокового пристрою LABEL, UUID та типи файлових систем. У цьому випадку
       обов’язковими є права доступу root.

       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.

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

       Use lsblk --help 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», із
           вилученням «іБ», яке є частиною цих скорочень.

       -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, якщо потрібно.

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

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

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

       -N, --nvme
           Output info about NVMe devices only.

       -v, --virtio
           Output info about virtio devices only.

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

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

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

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

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

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

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

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

       ls(1), blkid(8), findmnt(8)

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

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

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

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