Scroll to navigation

LSBLK(8) Администрација система LSBLK(8)

НАЗИВ

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.

По основи, наредба исписује све блок уређаје (осим RAM дискова) у формату налик стаблу. Исти уређај се може поновити у стаблу ако се односи на друге уређаје. Опција --merge се препоручује за компликованија подешавања за прикупљање група уређаја и описивање сложених N:M односа.

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 списак-колона и --list у окружењима у којима се захтева стабилан излаз.

Use lsblk --list-columns to get a list of all available columns.

Знајте да lsblk може бити извршен у време када udev још нема све информације о недавно додатим и измењеним уређајима. У том случају препоручује се коришћење udevadm settle пре lsblk за усклађивање са „udev“-ом.

Однос између блок уређаја и система датотека није увек један на један. Систем датотека може да користи више блок уређаја или истом систему датотека може да се приступи преко више путања. Ово је разлог зашто lsblk пружа колоне ТАЧКАКАЧЕЊА и ТАЧКЕКАЧЕЊА (мн.). Колона ТАЧКАКАЧЕЊА приказује само једну тачку качења (обично последње прикачени примерак система датотека), а колона ТАЧКЕКАЧЕЊА приказује по ћелији са више редова све тачке качења придружене уређају.

ОПЦИЈЕ

-A, --noempty

Не исписује празне уређаје.

-a, --all

Искључује све уграђене филтере и исписује све празне уређаје и RAM диск уређаје такође.

-b, --bytes

Исписује величине у бајтовима уместо у људима читљивом формату.

По основи, јединица, у којој су изражене величине, је бајт, а префикси јединице су у степену 2^10 (1024). Скраћенице симбола су изложене скраћен да би се постигла боља читљивост, излагањем само првог њиховог слова; примери: „1 KiB“ и „1 MiB“ се према томе приказују као „1 K“ и „1 M“, тако избегавајући намерно помињање „iB“, које је део ових скраћеница.

-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 списак

Изузима уређаје наведене на списку зарезом раздвојених већих бројева уређаја. Знајте да су RAM дискови (већи=1) по основи искључени ако --all није наведено. Филтер се примењује само на уређаје највишег нивоа. Ово може бити збуњујуће за --list излазни формат где хијерархија уређаја није очигледна.

-f, --fs

Укључује информације о системима датотека. Ова опција је еквивалент са -o НАЗИВ,ВРСТАСД,ИЗДСД,НАТПИС,УУИД,ДОСТУПСД,КОРИСТСД%,ТАЧКЕКАЧЕЊА. Ауторитативне информације о системима датотека и раидима су обезбеђене наредбом blkid(8).

-I, --include списак

Укључује уређаје наведене на списку зарезом раздвојених већих бројева уређаја. Филтер се примењује само на уређаје највишег нивоа. Ово може бити збуњујуће за --list излазни формат где хијерархија уређаја није очигледна.

-i, --ascii

Користи АСКРИ знакове за форматирање стабла.

-J, --json

Use JSON output format. It’s strongly recommended to use --output and also --tree if necessary. Note that children[] is used only if NAME column or --tree is used.

-l, --list

Даје излаз у облику списка. Излаз не обезбеђује информације о односима између уређаја а од издања 2.34 сваки уређај се исписује само једном ако --pairs или --raw није наведено (обрадиви излази су задржани на наопако сагласни начин).

-M, --merge

Групише родитеље подстабала да обезбеди читљивији излаз за РАИД-е и уређаје са више путања. Излаз налик стаблу је неопходан.

-m, --perms

Даје информације о власнику, групи и режиму уређаја. Ово је еквивалент са -o НАЗИВ,ВЕЛИЧИНА,ВЛАСНИК,ГРУПА,РЕЖИМ.

-N, --nvme

Само излазне информације о „NVMe“ уређајима.

-v, --virtio

Само излазне информације о „virtio“ уређајима.

-n, --noheadings

Не исписује ред заглавља.

-o, --output списак

Specify which output columns to print. Use --list-columns to get a list of all supported columns. The columns may affect tree-like output. The default is to use tree for the column 'NAME' (see also --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 expr

Colorize lines matching the expression. This feature is EXPERIMENTAL. See also scols-filter(5).

--ct name [: param [: function ]]

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 expr

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<кôд>) у колонама НАЗИВ, КНАЗИВ, НАТПИС, ПАРТНАТПИС и ТАЧКАКАЧЕЊА.

-S, --scsi

Исписује само информације о SCSI уређајима. Све партиције, подређени и држачи уређаја се занемарују.

-s, --inverse

Исписује зависности обрнутим редом. Ако је --list излаз захтеван тада су редови још увек поређани према зависностима.

-T, --tree[=колона]

Приморава формат излаза налик стаблу. Ако је колона наведена, тада се стабло исписује у колони. Основно је НАЗИВ колоне.

-t, --topology

Исписује информације о топологији блок уређаја. Ова опција је еквивалент са

-o НАЗИВ,ПОРАВНАЊЕ,МИН-УИ,ОПЦ-УИ,ФИЗ-СЕК,ДНВ-СЕК,РОТА,ЗАКА,RQ-ВЕЛ,RA,W-ИСТО.

-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 директоријум

Прикупља податке за Линукс примерак поред примерка из ког је наредба lsblk проистекла. Наведени директоријум је корен система Линукс примерка који ће бити прегледан. Стварни чворови уређаја у циљном директоријуму се могу заменити датотекама текста са „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. Овај блок директоријум система датотека се појавио у кернелу 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“ који се може преузети са Архиве Линукс кернела <https://www.kernel.org/pub/linux/utils/util-linux/>.

2024-10-01 util-linux 2.40.2