ОПИС¶
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.
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
список-стовпчиків
разом зі
списком
стовпчиків
у
середовищах,
де
потрібне
виведення
стабільного
набору
даних.
Скористайтеся
lsblk --list-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).
--hyperlink[=режим]
Print mountpoint paths as terminal hyperlinks. The
mode can be set to "always", "never", or
"auto". The optional argument when can be set to
"auto", "never", or "always". If the when
argument is omitted, it will default to "auto". The "auto"
setting means that hyperlinks will only be used if the output is on a
terminal.
-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.
-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.
--properties-by
список
This option specifies the methods used by
lsblk to
gather information about filesystems and partition tables. The list is a
comma-separated list of method names. The default setting is
"file,udev,blkid". The supported methods are:
udev
Reads data from udev DB. If unsuccessful, it continues to
the next probing method.
blkid
Reads data directly from the device using libblkid. If
unsuccessful, it continues to the next probing method.
file
Reads data from a file. This method is only used if the
--sysroot option is specified. This method always stops probing if used.
none
Не
виконувати
зондування.
Цей метод
завжди
зупиняє
зондування.
-h, --help
Вивести
текст
довідки і
завершити
роботу.
-V, --version
Показати
дані щодо
версії і
завершити
роботу.
