DESCRIERE¶
lsblk listează informații despre toate
dispozitivele de bloc disponibile sau despre cele specificate. Comanda
lsblk citește sistemul de fișiere sysfs
și db udev pentru a aduna informații. În cazul
în care db udev nu este disponibilă sau lsblk este
compilată fără suport udev, atunci
încearcă să citească ETICHETELE, UUID-urile
și tipurile de sisteme de fișiere de pe dispozitivul bloc.
În acest caz, sunt necesare permisiuni de root.
În mod implicit, comanda va afișa toate
dispozitivele bloc (cu excepția discurilor RAM) într-un format
arborescent. Același dispozitiv poate fi repetat în arbore
dacă are legătură cu alte dispozitive. Opțiunea
--merge este recomandată pentru configurații mai
complicate pentru a aduna grupuri de dispozitive și a descrie
relații complexe N:M.
Ieșirea de tip arbore (sau matricea children[]
în ieșirea JSON) este activată numai dacă
coloana NAME este prezentă în ieșire sau dacă se
utilizează opțiunea de linie de comandă --tree.
A se vedea, de asemenea, opțiunile --nodeps și
--list pentru a controla formatarea arborelui.
Ieșirea implicită, precum și ieșirea
implicită din opțiuni precum --fs și
--topologie, poate fi modificată. Așadar, ori de
câte ori este posibil, ar trebui să evitați să
utilizați ieșirile implicite în scripturile
dumneavoastră. Definiți întotdeauna în mod
explicit coloanele așteptate folosind --output
listă-coloane și --list în mediile
în care este necesară o ieșire stabilă.
Utilizați lsblk --list-columns pentru a
obține o listă cu toate coloanele disponibile.
Rețineți că lsblk poate fi
executată în momentul în care udev nu are
încă toate informațiile despre dispozitivele
adăugate sau modificate recent. În acest caz, se
recomandă să se utilizeze udevadm settle înainte
de lsblk pentru a se sincroniza cu udev.
Relația dintre dispozitivele de bloc și sistemele de
fișiere nu este întotdeauna unu la unu. Sistemul de
fișiere poate utiliza mai multe dispozitive de blocare sau
același sistem de fișiere poate fi accesibil prin mai multe
rute. Acesta este motivul pentru care lsblk oferă coloanele
MOUNTPOINT și MOUNTPOINTS (pl.). Coloana MOUNTPOINT
afișează un singur punct de montare (de obicei, ultima
instanță montată a sistemului de fișiere), iar
coloana MOUNTPOINTS afișează prin celule cu mai multe
rânduri toate punctele de montare asociate cu dispozitivul.
OPȚIUNI¶
-A, --noempty
Nu afișează dispozitivele goale.
-a, --all
Dezactivează toate filtrele încorporate
și listează toate dispozitivele goale, precum și
dispozitivele de disc RAM.
-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
Afișează informații despre
capacitățile de eliminare a discurilor (TRIM, UNMAP) pentru
fiecare dispozitiv.
-d, --nodeps
Nu afișează dispozitivele
purtătoare(partiția extinsă) sau dispozitivele secundare.
De exemplu, lsblk --nodeps /dev/sda afișează numai
informații despre dispozitivul sda.
-E, --dedup coloana
Utilizează
coloana ca o cheie de
de-duplicare pentru a de-duplica arborele de ieșire. Dacă cheia
nu este disponibilă pentru dispozitiv sau dacă dispozitivul este
o partiție, iar dispozitivul parental de tip „whole-disk”
(întregul-disc) oferă aceeași cheie, atunci dispozitivul
este întotdeauna afișat.
Cazul obișnuit de utilizare este acela de a elimina
duplicarea ieșirii pe dispozitive cu mai multe rute de sistem, de
exemplu prin -E WWN.
-e, --exclude listă
Exclude dispozitivele specificate de lista de
numere de dispozitive majore separate prin virgule. Rețineți
că discurile RAM (major=1) sunt excluse în mod implicit
dacă nu se specifică --all. Filtrul se aplică
numai dispozitivelor de nivel superior. Acest lucru poate fi derutant pentru
formatul de ieșire --list în care ierarhia dispozitivelor
nu este evidentă.
-f, --fs
Afișează informații despre sistemele
de fișiere. Această opțiune este echivalentă cu
-o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS.
Informațiile autorizate despre sistemele de fișiere și
RAID-uri sunt furnizate de comanda
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ă
Include dispozitivele specificate de lista de
numere de dispozitive majore separate prin virgule. Filtrul se aplică
numai la dispozitivele de nivel superior. Acest lucru poate fi derutant pentru
formatul de ieșire --list în care ierarhia dispozitivelor
nu este evidentă.
-i, --ascii
Utilizează caractere ASCII pentru formatarea
arborelui.
-J, --json
Utilizează formatul de ieșire JSON. Se
recomandă cu tărie utilizarea opțiunii --output
și, de asemenea, a opțiunii*--tree*, dacă este necesar.
Rețineți că children[] este utilizată numai
în cazul în care se utilizează coloana NAME sau
--tree.
-l, --list
Produce o ieșire sub forma unei liste.
Ieșirea nu oferă informații despre relațiile
dintre dispozitive și, începând cu versiunea 2.34,
fiecare dispozitiv este afișat o singură dată dacă
nu se specifică --pairs sau --raw (ieșirile
analizabile sunt menținute în mod de compatibilitate
retroactivă).
-M, --merge
Grupează părinții subarborelor
pentru a oferi o ieșire mai ușor de citit pentru dispozitivele
RAID și Multi-path. Este necesară o ieșire de tip
arbore.
-m, --perms
Afișează informații despre
proprietarul, grupul și modul dispozitivului. Această
opțiune este echivalentă cu -o
NAME,SIZE,OWNER,GROUP,MODE.
-N, --nvme
Afișează informații numai despre
dispozitivele NVMe.
-v, --virtio
Afișează informații numai despre
dispozitivele VirtIO.
-n, --noheadings
Nu imprimă o linie de antet.
-o, --output listă
Specifică ce coloane de ieșire se vor
imprima. Utilizați opțiunea
--list-columns pentru a
obține o listă cu toate coloanele acceptate. Coloanele pot
afecta ieșirea de tip arbore. În mod implicit, se
utilizează o structură arborescentă pentru coloana
"„NAME” (a se vedea, de asemenea, opțiunea
--tree).
Lista implicită de coloane poate fi extinsă
dacă lista este specificată în formatul
+listă (de exemplu, lsblk -o +UUID).
-O, --output-all
Afișează toate coloanele disponibile.
-P, --pairs
Produce ieșirea sub formă de perechi
cheie=„valoare”. Liniile de ieșire sunt în
continuare ordonate în funcție de dependențe. Toate
caracterele potențial nesigure ale valorilor sunt eludate în
format hexazecimal (\x<code>). A se vedea, de asemenea, opțiunea
--shell.
-p, --paths
Afișează rutele complete ale
dispozitivelor.
-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
Produce ieșirea în format brut. Liniile de
ieșire sunt în continuare ordonate în funcție de
dependențe. Toate caracterele potențial nesigure sunt eludate
în format hexazecimal (\x<cod>) în coloanele NAME, KNAME,
LABEL, PARTLABEL și MOUNTPOINT.
-S, --scsi
Afișează informații numai despre
dispozitivele SCSI. Toate partițiile, dispozitivele secundare și
dispozitivele purtătoare sunt ignorate.
-s, --inverse
Afișează dependențele în
ordine inversă. Dacă se solicită ieșirea
--list, atunci liniile sunt în continuare ordonate în
funcție de dependențe.
-T, --tree[=coloana]
Forțează un format de ieșire de tip
arborescent. Dacă se specifică coloana, atunci se
afișează un arbore în coloana respectivă. Valoarea
implicită este coloana NAME.
-t, --topology
Afișează informații despre topologia
blocului de dispozitive. Această opțiune este echivalentă
cu
-o
NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME.
-w, --width număr
Specifică lățimea de ieșire
ca număr de caractere. Valoarea implicită este numărul de
coloane ale terminalului, iar dacă nu este executată pe un
terminal, atunci lățimea de ieșire nu este
restricționată deloc în mod implicit. Această
opțiune forțează, de asemenea,
lsblk să
presupună că nu sunt permise caracterele de control de terminal
și caracterele nesigure. Cazul de utilizare preconizat este, de
exemplu, atunci când
lsblk este utilizat de comanda
watch(1).
-x, --sort coloana
Sortează liniile de ieșire după
coloană. Această opțiune activează
în mod implicit formatul de ieșire --listă. Este
posibil să se utilizeze opțiunea --tree pentru a
forța ieșirea sub formă de arbore, iar ramurile arborelui
sunt sortate după coloană.
-y, --shell
Numele coloanei va fi modificat pentru a conține
numai caracterele permise pentru identificatorii variabilelor de shell, de
exemplu, MIN_IO și FSUSE_PCT în loc de MIN-IO și FSUSE%.
Acest lucru este utilizabil, de exemplu, cu --pairs.
Rețineți că această caracteristică a fost
activată automat pentru --pairs în versiunea 2.37, dar,
din cauza unor probleme de compatibilitate, acum este necesar să
solicitați acest comportament prin --shell.
-z, --zoned
Afișează informațiile legate de
zonă pentru fiecare dispozitiv.
--sysroot director
Adună date pentru o instanță Linux,
alta decât cea de la care este emisă comanda lsblk.
Directorul specificat este rădăcina de sistem a instanței
Linux care urmează să fie inspectată. Nodurile de
dispozitive reale din directorul țintă pot fi înlocuite
de fișiere text cu atribute udev.
--properties-by listă
Această opțiune specifică metodele
utilizate de
lsblk pentru a colecta informații despre sistemele
de fișiere și tabelele de partiții. Lista este o
listă de nume de metode separate prin virgule. Preconfigurarea
implicită este „file,udev,blkid”. Metodele acceptate
sunt:
udev
Citește datele din BD udev. Dacă nu
reușește, trece la următoarea metodă de
sondare.
blkid
Citește datele direct de pe dispozitiv
utilizând libblkid. Dacă nu reușește, trece la
următoarea metodă de sondare.
file
Citește date dintr-un fișier
„file”. Această metodă este
utilizată numai dacă este specificată opțiunea
„--sysroot”. Această metodă oprește
întotdeauna sondarea dacă este utilizată.
none
Nu efectuează sondarea. Această
metodă oprește întotdeauna sondarea.
-h, --help
Afișează acest mesaj de ajutor și
iese.
-V, --version
Afișează versiunea și iese.
