'\" t
.\"     Title: lsblk
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-03-29
.\"    Manual: Administrare sistem
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "LSBLK" "8" "2025-03-29" "util\-linux 2.41" "Administrare sistem"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NUME"
lsblk \- listează dispozitivele bloc
.SH "REZUMAT"
.sp
\fBlsblk\fP [opțiuni] [\fIdispozitiv\fP...]
.SH "DESCRIERE"
.sp
\fBlsblk\fP listează informații despre toate dispozitivele de bloc disponibile sau despre cele specificate. Comanda \fBlsblk\fP citește sistemul de fișiere \fBsysfs\fP și \fBdb udev\fP pentru a aduna informații. În cazul în care db udev nu este disponibilă sau \fBlsblk\fP 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.
.sp
Î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 \fB\-\-merge\fP este recomandată pentru configurații mai complicate pentru a aduna grupuri de dispozitive și a descrie relații complexe N:M.
.sp
Ieșirea de tip arbore (sau matricea \fBchildren[]\fP î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ă \fB\-\-tree\fP. A se vedea, de asemenea, opțiunile \fB\-\-nodeps\fP și \fB\-\-list\fP pentru a controla formatarea arborelui.
.sp
Ieșirea implicită, precum și ieșirea implicită din opțiuni precum \fB\-\-fs\fP și \fB\-\-topologie\fP, 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 \fB\-\-output\fP \fIlistă\-coloane\fP și \fB\-\-list\fP în mediile în care este necesară o ieșire stabilă.
.sp
Utilizați \fBlsblk \-\-list\-columns\fP pentru a obține o listă cu toate coloanele disponibile.
.sp
Rețineți că \fBlsblk\fP poate fi executată în momentul în care \fBudev\fP nu are încă toate informațiile despre dispozitivele adăugate sau modificate recent. În acest caz, se recomandă să se utilizeze \fBudevadm settle\fP înainte de \fBlsblk\fP pentru a se sincroniza cu udev.
.sp
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 \fBlsblk\fP 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.
.SH "OPȚIUNI"
.sp
\fB\-A\fP, \fB\-\-noempty\fP
.RS 4
Nu afișează dispozitivele goale.
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Dezactivează toate filtrele încorporate și listează toate dispozitivele goale, precum și dispozitivele de disc RAM.
.RE
.sp
\fB\-b\fP, \fB\-\-bytes\fP
.RS 4
Afișează dimensiunile în octeți, mai degrabă decât într\-un format ușor de citit de către om.
.sp
În mod implicit, unitatea în care sunt exprimate mărimile este octetul, iar prefixele unităților sunt exprimate în putere de 2^10 (1024). Abrevierile simbolurilor sunt prezentate trunchiat pentru a se obține o mai bună lizibilitate, prin prezentarea doar a primei litere a acestora; exemple: „1 KiB [en]/ 1 Kio [ro]” și „1 MiB [en] / 1 Mio [ro]" se expun ca "1 K" și respectiv "1 M", omițându\-se intenționat mențiunea „iB”, care face parte din aceste abrevieri.
.RE
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
Listează coloanele disponibile, se utilizează cu \fB\-\-json\fP sau \fB\-\-raw\fP pentru a obține o ieșire în format care poate fi citit de către mașină.
.RE
.sp
\fB\-D\fP, \fB\-\-discard\fP
.RS 4
Afișează informații despre capacitățile de eliminare a discurilor (TRIM, UNMAP) pentru fiecare dispozitiv.
.RE
.sp
\fB\-d\fP, \fB\-\-nodeps\fP
.RS 4
Nu afișează dispozitivele purtătoare(partiția extinsă) sau dispozitivele secundare. De exemplu, \fBlsblk \-\-nodeps /dev/sda\fP afișează numai informații despre dispozitivul sda.
.RE
.sp
\fB\-E\fP, \fB\-\-dedup\fP \fIcoloana\fP
.RS 4
Utilizează \fIcoloana\fP 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.
.sp
Cazul obișnuit de utilizare este acela de a elimina duplicarea ieșirii pe dispozitive cu mai multe rute de sistem, de exemplu prin \fB\-E WWN\fP.
.RE
.sp
\fB\-e\fP, \fB\-\-exclude\fP \fIlistă\fP
.RS 4
Exclude dispozitivele specificate de \fIlista\fP 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ă \fB\-\-all\fP. Filtrul se aplică numai dispozitivelor de nivel superior. Acest lucru poate fi derutant pentru formatul de ieșire \fB\-\-list\fP în care ierarhia dispozitivelor nu este evidentă.
.RE
.sp
\fB\-f\fP, \fB\-\-fs\fP
.RS 4
Afișează informații despre sistemele de fișiere. Această opțiune este echivalentă cu \fB\-o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS\fP. Informațiile autorizate despre sistemele de fișiere și RAID\-uri sunt furnizate de comanda \fBblkid\fP(8).
.RE
.sp
\fB\-\-hyperlink\fP[\fB=\fP\fImod\fP]
.RS 4
Imprimă traseele punctelor de montare ca hiperlegături de terminal. Argumentul \fImod\fP poate fi definit la „always” (întotdeauna), „never” (niciodată) sau „auto”. Argumentul opțional \fIcând\fP poate fi definit la „auto”, „never” sau „always”. Dacă argumentul \fIcând\fP este omis, se va utiliza în mod implicit „auto”. Valoarea „auto” înseamnă că hiperlegăturile vor fi utilizate numai dacă ieșirea este pe un terminal.
.RE
.sp
\fB\-I\fP, \fB\-\-include\fP \fIlistă\fP
.RS 4
Include dispozitivele specificate de \fIlista\fP 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 \fB\-\-list\fP în care ierarhia dispozitivelor nu este evidentă.
.RE
.sp
\fB\-i\fP, \fB\-\-ascii\fP
.RS 4
Utilizează caractere ASCII pentru formatarea arborelui.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
Utilizează formatul de ieșire JSON. Se recomandă cu tărie utilizarea opțiunii \fB\-\-output\fP și, de asemenea, a opțiunii*\-\-tree*, dacă este necesar. Rețineți că \fBchildren[]\fP este utilizată numai în cazul în care se utilizează coloana NAME sau \fB\-\-tree\fP.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
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ă \fB\-\-pairs\fP sau \fB\-\-raw\fP (ieșirile analizabile sunt menținute în mod de compatibilitate retroactivă).
.RE
.sp
\fB\-M\fP, \fB\-\-merge\fP
.RS 4
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.
.RE
.sp
\fB\-m\fP, \fB\-\-perms\fP
.RS 4
Afișează informații despre proprietarul, grupul și modul dispozitivului. Această opțiune este echivalentă cu \fB\-o NAME,SIZE,OWNER,GROUP,MODE\fP.
.RE
.sp
\fB\-N\fP, \fB\-\-nvme\fP
.RS 4
Afișează informații numai despre dispozitivele NVMe.
.RE
.sp
\fB\-v\fP, \fB\-\-virtio\fP
.RS 4
Afișează informații numai despre dispozitivele VirtIO.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Nu imprimă o linie de antet.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIlistă\fP
.RS 4
Specifică ce coloane de ieșire se vor imprima. Utilizați opțiunea \fB\-\-list\-columns\fP 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 \fB\-\-tree\fP).
.sp
Lista implicită de coloane poate fi extinsă dacă \fIlista\fP este specificată în formatul \fI+listă\fP (de exemplu, \fBlsblk \-o +UUID\fP).
.RE
.sp
\fB\-O\fP, \fB\-\-output\-all\fP
.RS 4
Afișează toate coloanele disponibile.
.RE
.sp
\fB\-P\fP, \fB\-\-pairs\fP
.RS 4
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 (\(rsx<code>). A se vedea, de asemenea, opțiunea \fB\-\-shell\fP.
.RE
.sp
\fB\-p\fP, \fB\-\-paths\fP
.RS 4
Afișează rutele complete ale dispozitivelor.
.RE
.sp
\fB\-Q\fP, \fB\-\-filter\fP \fIexpresia\fP
.RS 4
Afișează numai dispozitivele care îndeplinesc condițiile specificate de \fIexpresie\fP. Filtrul este evaluat înainte ca «lsblk» să colecteze date pentru toate coloanele de ieșire. Numai datele necesare pentru evaluarea leneșă a expresiei sunt preluate din sistem. Această abordare poate îmbunătăți performanța în comparație cu post\-filtrarea, așa cum se face în mod obișnuit cu instrumente precum grep(1).
.sp
Această caracteristică este EXPERIMENTALĂ. A se vedea, de asemenea, \fBscols\-filter\fP(5). De exemplu, exclude sda și sdb, dar afișează toate celelalte (\*(Aq!~\*(Aq este un operator de potrivire a expresiilor regulate negative):
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
lsblk \-\-filter \*(AqNAME !~ "sd[ab]"\*(Aq
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-\-highlight\fP \fIexpresia\fP
.RS 4
Colorează liniile care corespund expresiei. Această funcție este EXPERIMENTALĂ. A se vedea, de asemenea, \fBscols\-filter\fP(5).
.RE
.sp
\fB\-\-ct\fP \fInume\fP [: \fIparametru\fP [: \fIfuncție\fP ]]
.RS 4
Definește un contor personalizat. Contoarele sunt afișate după ieșirea standard. \fInume\fP este numele personalizat al contorului, opționalul \fIparametru\fP este numele coloanei care urmează să fie utilizată pentru contor, iar opționalul \fIfuncție\fP specifică funcția de agregare, funcțiile acceptate fiind: count, min, max sau sum. Valoarea implicită este count.
.sp
Dacă \fIparametru\fP nu este specificat, atunci contorul numără numărul de linii. Această caracteristică este EXPERIMENTALĂ. A se vedea, de asemenea, opțiunea \fB\-\-ct\-filter\fP.
.sp
De exemplu, \fB\-\-ct MyCounter:SIZE:sum\fP va număra rezumatul pentru SIZE de pe toate liniile; și pentru a număra numărul de discuri SATA, este posibil să se folosească:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
lsblk \-\-ct\-filter \*(AqTYPE=="disk" && TRAN=="sata"\*(Aq \-\-ct "Numărul de dispozitive SATA"
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-\-ct\-filter\fP \fIexpresia\fP
.RS 4
Definește o restricție pentru următorul contor. Această funcție este EXPERIMENTALĂ. A se vedea, de asemenea, \fB\-\-ct\fP și \fBscols\-filter\fP(5). De exemplu, agregarea dimensiunilor în funcție de tipul de dispozitiv:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
lsblk \-\-ct\-filter \*(AqTYPE=="part"\*(Aq \-\-ct Partitions:SIZE:sum \(rs
      \-\-ct\-filter \*(AqTYPE=="disk"\*(Aq \-\-ct WholeDisks:SIZE:sum
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
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 (\(rsx<cod>) în coloanele NAME, KNAME, LABEL, PARTLABEL și MOUNTPOINT.
.RE
.sp
\fB\-S\fP, \fB\-\-scsi\fP
.RS 4
Afișează informații numai despre dispozitivele SCSI. Toate partițiile, dispozitivele secundare și dispozitivele purtătoare sunt ignorate.
.RE
.sp
\fB\-s\fP, \fB\-\-inverse\fP
.RS 4
Afișează dependențele în ordine inversă. Dacă se solicită ieșirea \fB\-\-list\fP, atunci liniile sunt în continuare ordonate în funcție de dependențe.
.RE
.sp
\fB\-T\fP, \fB\-\-tree\fP[\fB=\fP\fIcoloana\fP]
.RS 4
Forțează un format de ieșire de tip arborescent. Dacă se specifică \fIcoloana\fP, atunci se afișează un arbore în coloana respectivă. Valoarea implicită este coloana NAME.
.RE
.sp
\fB\-t\fP, \fB\-\-topology\fP
.RS 4
Afișează informații despre topologia blocului de dispozitive. Această opțiune este echivalentă cu
.sp
\fB\-o NAME,ALIGNMENT,MIN\-IO,OPT\-IO,PHY\-SEC,LOG\-SEC,ROTA,SCHED,RQ\-SIZE,RA,WSAME\fP.
.RE
.sp
\fB\-w\fP, \fB\-\-width\fP \fInumăr\fP
.RS 4
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, \fBlsblk\fP să presupună că nu sunt permise caracterele de control de terminal și caracterele nesigure. Cazul de utilizare preconizat este, de exemplu, atunci când \fBlsblk\fP este utilizat de comanda \fBwatch\fP(1).
.RE
.sp
\fB\-x\fP, \fB\-\-sort\fP \fIcoloana\fP
.RS 4
Sortează liniile de ieșire după \fIcoloană\fP. Această opțiune activează în mod implicit formatul de ieșire \fB\-\-listă\fP. Este posibil să se utilizeze opțiunea \fB\-\-tree\fP pentru a forța ieșirea sub formă de arbore, iar ramurile arborelui sunt sortate după \fIcoloană\fP.
.RE
.sp
\fB\-y\fP, \fB\-\-shell\fP
.RS 4
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 \fB\-\-pairs\fP. Rețineți că această caracteristică a fost activată automat pentru \fB\-\-pairs\fP în versiunea 2.37, dar, din cauza unor probleme de compatibilitate, acum este necesar să solicitați acest comportament prin \fB\-\-shell\fP.
.RE
.sp
\fB\-z\fP, \fB\-\-zoned\fP
.RS 4
Afișează informațiile legate de zonă pentru fiecare dispozitiv.
.RE
.sp
\fB\-\-sysroot\fP \fIdirector\fP
.RS 4
Adună date pentru o instanță Linux, alta decât cea de la care este emisă comanda \fBlsblk\fP. 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.
.RE
.sp
\fB\-\-properties\-by\fP \fIlistă\fP
.RS 4
Această opțiune specifică metodele utilizate de \fBlsblk\fP 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:
.sp
\fBudev\fP
.RS 4
Citește datele din BD udev. Dacă nu reușește, trece la următoarea metodă de sondare.
.RE
.sp
\fBblkid\fP
.RS 4
Citește datele direct de pe dispozitiv utilizând libblkid. Dacă nu reușește, trece la următoarea metodă de sondare.
.RE
.sp
\fBfile\fP
.RS 4
Citește date dintr\-un fișier „\fBfile\fP”. Această metodă este utilizată numai dacă este specificată opțiunea „\-\-sysroot”. Această metodă oprește întotdeauna sondarea dacă este utilizată.
.RE
.sp
\fBnone\fP
.RS 4
Nu efectuează sondarea. Această metodă oprește întotdeauna sondarea.
.RE
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afișează acest mesaj de ajutor și iese.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afișează versiunea și iese.
.RE
.SH "STARE DE IEȘIRE"
.sp
0
.RS 4
succes
.RE
.sp
1
.RS 4
eșec
.RE
.sp
32
.RS 4
niciunul dintre dispozitivele specificate nu a fost găsit
.RE
.sp
64
.RS 4
unele dispozitive specificate au fost găsite, altele nu au fost găsite
.RE
.SH "MEDIU"
.sp
\fBLSBLK_DEBUG\fP=all
.RS 4
activează ieșirea de depanare a \fBlsblk\fP.
.RE
.sp
\fBLIBBLKID_DEBUG\fP=all
.RS 4
activează ieșirea de depanare a \fBlibblkid\fP.
.RE
.sp
\fBLIBMOUNT_DEBUG\fP=all
.RS 4
activează ieșirea de depanare a \fBlibmount\fP.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
activează ieșirea de depanare a \fBlibsmartcols\fP.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
utilizează caractere de umplutură vizibile.
.RE
.SH "NOTE"
.sp
În cazul partițiilor, unele informații (de exemplu, atributele cozii) sunt moștenite de la dispozitivul părinte.
.sp
Comanda \fBlsblk\fP trebuie să fie capabilă să caute fiecare dispozitiv de bloc după numerele major:minor, ceea ce se face folosind \fI/sys/dev/block\fP. Acest director de blocuri sysfs a apărut în nucleul 2.6.27 (octombrie 2008). În cazul în care apar probleme cu un nucleu suficient de nou, verificați dacă opțiunea \fBCONFIG_SYSFS\fP a fost activată în momentul compilării nucleului.
.SH "AUTORI"
.sp
.MTO "gmazyland\(atgmail.com" "Milan Broz" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "CONSULTAȚI ȘI"
.sp
\fBblkid\fP(8), \fBfindmnt\fP(8) \fBls\fP(1), \fBscols\-filter\fP(5)
.SH "RAPORTAREA ERORILOR"
.sp
Pentru rapoarte de eroare, folosiți \c
.URL "https://github.com/util\-linux/util\-linux/issues" "sistemul de urmărire al erorilor" "."
.SH "DISPONIBILITATE"
.sp
Comanda \fBlsblk\fP face parte din pachetul util\-linux care poate fi descărcat de la \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."