LSBLK(8)

НАЗВА
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.

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
    Print sizes in bytes rather than in human-readable form.

    By default, sizes are shown in units that are powers of 1024 bytes. The formal abbreviations for these units (KiB, MiB, GiB, ...) are further shortened to just their first letter: K, M, G, ....

-H, --list-columns
    List the columns that can be specified with the --output option. Can be used with --json or --raw to get the list in a 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[=when]
    Print paths as terminal hyperlinks. The optional when argument can be always, never, or auto. If the argument is omitted, it defaults to auto, which means that hyperlinks will only be used when the output goes to 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 expression
    Print only the devices that meet the conditions specified by expression. 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, to exclude sda and sdb, but print everything else ('!~' is a negative regular-expression matching operator):

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

--highlight expression
    Colorize lines matching expression.

    This feature is EXPERIMENTAL. See also scols-filter(5).

--ct name[:parameter[:function]]
    Define a custom counter. Custom counters are printed after the standard output. The name is the custom name of the counter, the optional parameter 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, sum. The default function is count. If parameter 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 reports the total of the SIZE values. To report the number of SATA disks, one can use:

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

--ct-filter expression
    Define a restriction for the next counter.

    This feature is EXPERIMENTAL. See also --ct and scols-filter(5).

    For example, to 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
    Показати дані щодо версії і завершити роботу.

СТАН ВИХОДУ

0
    успіх

1
    помилка

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

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

КОЛЬОРИ

Розфарбовування виведених даних реалізовано у можливості terminal-colors.d(5). Неявне розфарбовування може бути вимкнено спорожненням файла

    /etc/terminal-colors.d/{команда}.disable

для команди {команда} або для усіх інструментів

    /etc/terminal-colors.d/disable

Починаючи з версії 2.41, передбачено підтримку змінної середовища $NO_COLOR для вимикання розфарбовування виведених даних, якщо розфарбовування не буде явним чином увімкнено параметром командного рядка.

Специфічні для користувача $XDG_CONFIG_HOME/terminal-colors.d або $HOME/.config/terminal-colors.d мають пріоритет над загальними параметрами.

Зауважте, що можна типово увімкнути розфарбовування виведених даних і у цьому випадку каталоги terminal-colors.d не повинні існувати.

СЕРЕДОВИЩЕ

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

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

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

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

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

LSBLK_COLUMNS=
    specifies a comma-separated list of output columns to print. All columns listed by --list-columns can be used.

ЗАУВАЖЕННЯ

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

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

АВТОРИ

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

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

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

Для звітування щодо вад скористайтеся

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

Програма lsblk є частиною пакунка util-linux, який можна отримати з