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.