'\" t
.\"     Title: lsblk
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-21
.\"    Manual: Systemadministration
.\"    Source: util-linux 2.42.4
.\"  Language: English
.\"
.TH "LSBLK" "8" "2026-09-21" "util\-linux 2.42.4" "Systemadministration"
.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 "NAMN"
lsblk \- lista blockenheter
.SH "SYNOPSIS"
.sp
\fBlsblk\fP [flaggor] [\fIenhet\fP.\|.\|.]
.SH "BESKRIVNING"
.sp
\fBlsblk\fP listar information om alla tillgängliga eller de angivna blockenheterna. Kommandot \fBlsblk\fP läser filsystemet \fBsysfs\fP och \fBudev db\fP för att samla information. Om udev db inte är tillgänglig eller om \fBlsblk\fP är kompilerat utan udev\-stöd försöker det läsa LABELs, UUIDs och filsystemtyper från blockenheten. I det här fallet krävs root\-behörighet.
.sp
Som standard skriver kommandot ut alla blockenheter (utom RAM\-diskar) i ett trädliknande format. Samma enhet kan upprepas i trädet om den är relaterad till andra enheter. Flaggan \fB\-\-merge\fP rekommenderas för mer komplicerade konfigurationer för att samla grupper av enheter och beskriva komplexa N:M\-relationer.
.sp
Den trädliknande utmatningen (eller \fBchildren[]\fP\-arrayen i JSON\-utmatningen) aktiveras endast om NAME\-kolumnen finns i utmatningen eller när kommandoradsflaggan \fB\-\-tree\fP används. Se även \fB\-\-nodeps\fP och \fB\-\-list\fP för att styra trädformateringen.
.sp
Standardutdata, liksom standardutdata från flaggor som \fB\-\-fs\fP och \fB\-\-topology\fP, kan komma att ändras. Så när det är möjligt bör du undvika att använda standardutdata i dina skript. Definiera alltid förväntade kolumner explicit genom att använda \fB\-\-output\fP \fIcolumns\-list\fP och \fB\-\-list\fP i miljöer där en stabil utdata krävs.
.sp
Använd \fBlsblk \-\-list\-columns\fP för att få en lista över alla tillgängliga kolumner.
.sp
Observera att \fBlsblk\fP kan utföras vid en tidpunkt då \fBudev\fP ännu inte har all information om nyligen tillagda eller ändrade enheter. I det här fallet rekommenderas att du använder \fBudevadm settle\fP före \fBlsblk\fP för att synkronisera med udev.
.sp
Förhållandet mellan blockenheter och filsystem är inte alltid ett till ett. Filsystemet kan använda fler blockenheter, eller så kan samma filsystem vara tillgängligt via fler sökvägar. Detta är anledningen till att \fBlsblk\fP tillhandahåller kolumnerna MOUNTPOINT och MOUNTPOINTS (pl.). Kolumnen MOUNTPOINT visar bara en monteringspunkt (vanligtvis den senast monterade instansen av filsystemet), och kolumnen MOUNTPOINTS visar med cell med flera rader alla monteringspunkter som är associerade med enheten.
.SH "FLAGGOR"
.sp
\fB\-A\fP, \fB\-\-noempty\fP
.RS 4
Skriv inte ut tomma enheter.
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Inaktivera alla inbyggda filter och lista alla tomma enheter och RAM\-disk\-enheter också.
.RE
.sp
\fB\-b\fP, \fB\-\-bytes\fP
.RS 4
Skriv ut storlekar i byte i stället för i läsbart format.
.sp
Som standard visas storlekar i enheter som är potenser av 1024 byte. Enheternas formella förkortningar (KiB, MiB, GiB, …) förkortas ytterligare till endast den första bokstaven: K, M, G, ….
.RE
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
Lista kolumnerna som kan anges med flaggan \fB\-\-output\fP. Kan användas med \fB\-\-json\fP eller \fB\-\-raw\fP för att få listan i maskinläsbart format.
.RE
.sp
\fB\-D\fP, \fB\-\-discard\fP
.RS 4
Skriv ut information om borttagningsfunktionerna (TRIM, UNMAP) för varje enhet.
.RE
.sp
\fB\-d\fP, \fB\-\-nodeps\fP
.RS 4
Skriv inte ut innehavarenheter eller slavar. Exempel: \fBlsblk \-\-nodeps /dev/sda\fP skriver endast ut information om enheten sda.
.RE
.sp
\fB\-E\fP, \fB\-\-dedup\fP \fIcolumn\fP
.RS 4
Använd \fIkolumn\fP som en avdupliceringsnyckel för att avduplicera utdataträdet. Om nyckeln inte är tillgänglig för enheten, eller om enheten är en partition och föräldrars enhet för hela disken har samma nyckel, skrivs enheten alltid ut.
.sp
Det vanliga användningsområdet är att avdubbla utdata på systemets enheter med flera vägar, t.ex. genom \fB\-E WWN\fP.
.RE
.sp
\fB\-e\fP, \fB\-\-exclude\fP \fIlista\fP
.RS 4
Uteslut de enheter som anges i den kommaseparerade \fIlistan\fP med större enhetsnummer. Observera att RAM\-diskar (major=1) utesluts som standard om \fB\-\-all\fP inte anges. Filtret tillämpas endast på enheterna på den översta nivån. Detta kan vara förvirrande för \fB\-\-list\fP\-utdataformat där enheternas hierarki inte är uppenbar.
.RE
.sp
\fB\-f\fP, \fB\-\-fs\fP
.RS 4
Skriv ut information om filsystem. Denna flagga är likvärdigt med \fB\-o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS\fP. Den auktoritativa informationen om filsystem och raider tillhandahålls av kommandot \fBblkid\fP(8).
.RE
.sp
\fB\-\-hyperlink\fP[\fB=\fP\fInär\fP]
.RS 4
Skriv ut sökvägar som hyperlänkar i terminalen. Det valfria argumentet \fInär\fP kan vara \fBalways\fP, \fBnever\fP eller \fBauto\fP. Om argumentet utelämnas används \fBauto\fP, vilket innebär att hyperlänkar endast används när utdata går till en terminal.
.RE
.sp
\fB\-I\fP, \fB\-\-include\fP \fIlista\fP
.RS 4
Inkludera enheter som specificeras av den kommaseparerade \fIlistan\fP med större enhetsnummer. Filtret tillämpas endast på enheterna på den översta nivån. Detta kan vara förvirrande för utdataformatet \fB\-\-list\fP där enheternas hierarki inte är uppenbar.
.RE
.sp
\fB\-i\fP, \fB\-\-ascii\fP
.RS 4
Använd ASCII\-tecken för trädformatering.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
Använd JSON\-utdataformat. Vi rekommenderar starkt att du använder \fB\-\-output\fP och även \fB\-\-tree\fP om det behövs. Observera att \fBchildren[]\fP endast används om NAME\-kolumnen eller \fB\-\-tree\fP används.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
Producerar utdata i form av en lista. Utdata ger ingen information om relationer mellan enheter och sedan version 2.34 skrivs varje enhet ut endast en gång om \fB\-\-pairs\fP eller \fB\-\-raw\fP inte anges (de tolkningsbara utdata bibehålls på ett bakåtkompatibelt sätt).
.RE
.sp
\fB\-M\fP, \fB\-\-merge\fP
.RS 4
Gruppera föräldrar till underträd för att ge mer läsbar utdata för RAID och Multi\-path\-enheter. Den trädliknande utmatningen är nödvändig.
.RE
.sp
\fB\-m\fP, \fB\-\-perms\fP
.RS 4
Skriv ut information om enhetens ägare, grupp och läge. Denna flagga är likvärdigt med \fB\-o NAME,SIZE,OWNER,GROUP,MODE\fP.
.RE
.sp
\fB\-N\fP, \fB\-\-nvme\fP
.RS 4
Utmatar endast information om NVMe\-enheter.
.RE
.sp
\fB\-v\fP, \fB\-\-virtio\fP
.RS 4
Utmatar endast information om virtio\-enheter.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Skriv inte ut någon rubrikrad.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIlista\fP
.RS 4
Ange vilka utdatakolumner som ska skrivas ut. Använd \fB\-\-list\-columns\fP för att få en lista över alla kolumner som stöds. Kolumnerna kan påverka trädliknande utdata. Standardinställningen är att använda tree för kolumnen \*(AqNAME\*(Aq (se även \fB\-\-tree\fP).
.sp
Standardlistan med kolumner kan utökas om \fIlista\fP anges i formatet \fI+list\fP (t.ex. \fBlsblk \-o +UUID\fP).
.RE
.sp
\fB\-O\fP, \fB\-\-output\-all\fP
.RS 4
Skriv ut alla tillgängliga kolumner.
.RE
.sp
\fB\-P\fP, \fB\-\-pairs\fP
.RS 4
Producerar utdata i form av nyckel="värde"\-par. Utdataraderna är fortfarande ordnade efter beroenden. Alla potentiellt osäkra värde\-tecken är hexadecalerade (\(rsx<code>). Se även flaggan \fB\-\-shell\fP.
.RE
.sp
\fB\-p\fP, \fB\-\-paths\fP
.RS 4
Skriv ut fullständiga enhetssökvägar.
.RE
.sp
\fB\-Q\fP, \fB\-\-filter\fP \fIuttryck\fP
.RS 4
Skriv endast ut enheter som uppfyller villkoren i \fIuttryck\fP. Filtret utvärderas innan \fBlsblk\fP samlar in data för alla utdatakolumner. Endast data som behövs för uttryckets lata utvärdering hämtas från systemet. Detta kan förbättra prestandan jämfört med efterfiltrering, som ofta görs med verktyg som \fBgrep\fP(1).
.sp
Denna funktion är EXPERIMENTELL. Se även \fBscols\-filter\fP(5).
.sp
Exempelvis, för att utesluta sda och sdb men skriva ut allt annat (”!~” är en operator för negativ matchning med reguljära uttryck):
.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 \fIuttryck\fP
.RS 4
Färglägg rader som matchar \fIuttryck\fP.
.sp
Denna funktion är EXPERIMENTELL. Se även \fBscols\-filter\fP(5).
.RE
.sp
\fB\-\-ct\fP \fInamn\fP[\fB:\fP\fIparameter\fP[\fB:\fP\fIfunktion\fP]]
.RS 4
Definiera en anpassad räknare. Anpassade räknare skrivs ut efter den vanliga utmatningen. \fInamn\fP är räknarens anpassade namn, valfria \fIparameter\fP är namnet på kolumnen som ska användas för räknaren och valfria \fIfunktion\fP anger aggregeringsfunktionen. Funktioner som stöds är \fBcount\fP, \fBmin\fP, \fBmax\fP, \fBsum\fP. Standardfunktionen är \fBcount\fP. Om \fIparameter\fP inte anges räknas antalet rader.
.sp
Denna funktion är EXPERIMENTELL. Se även \fB\-\-ct\-filter\fP.
.sp
Till exempel rapporterar \fB\-\-ct MyCounter:SIZE:sum\fP summan av SIZE\-värdena. För att rapportera antalet SATA\-diskar kan man använda:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
lsblk \-\-ct\-filter \*(AqTYPE=="disk" && TRAN=="sata"\*(Aq \(rs
      \-\-ct "Antal SATA\-enheter"
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-\-ct\-filter\fP \fIuttryck\fP
.RS 4
Definiera en begränsning för nästa räknare.
.sp
Denna funktion är EXPERIMENTELL. Se även \fB\-\-ct\fP och \fBscols\-filter\fP(5).
.sp
Exempelvis för att summera storlekar efter enhetstyp:
.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
Producerar utdata i råformat. Utdataraderna är fortfarande ordnade efter beroenden. Alla potentiellt osäkra tecken är hexadecalerade (\(rsx<code>) i kolumnerna NAME, KNAME, LABEL, PARTLABEL och MOUNTPOINT.
.RE
.sp
\fB\-S\fP, \fB\-\-scsi\fP
.RS 4
Utmatar endast information om SCSI\-enheter. Alla partitioner, slavar och innehavarenheter ignoreras.
.RE
.sp
\fB\-s\fP, \fB\-\-inverse\fP
.RS 4
Skriv ut beroenden i omvänd ordning. Om utskriften \fB\-\-list\fP begärs är raderna fortfarande ordnade efter beroenden.
.RE
.sp
\fB\-T\fP, \fB\-\-tree\fP[\fB=\fP\fIcolumn\fP]
.RS 4
Tvinga fram ett trädliknande utdataformat. Om \fIcolumn\fP anges skrivs ett träd ut i kolumnen. Standard är NAME\-kolumnen.
.RE
.sp
\fB\-t\fP, \fB\-\-topology\fP
.RS 4
Utmatar information om blockenhetens topologi. Denna flagga är likvärdigt med
.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 \fInummer\fP
.RS 4
Anger utmatningsbredd som ett antal tecken. Standardvärdet är antalet terminalkolumner, och om det inte körs på en terminal begränsas inte utmatningsbredden alls som standard. Den här flaggan tvingar också \fBlsblk\fP att anta att terminalens kontrolltecken och osäkra tecken inte är tillåtna. Det förväntade användningsfallet är t.ex. när \fBlsblk\fP används av kommandot \fBwatch\fP(1).
.RE
.sp
\fB\-x\fP, \fB\-\-sort\fP \fIcolumn\fP
.RS 4
Sortera utdatarader efter \fIkolumn\fP. Denna flagga aktiverar \fB\-\-list\fP utdataformat som standard. Det är möjligt att använda flaggan \fB\-\-tree\fP för att tvinga fram trädliknande utdata och då sorteras trädgrenarna efter \fIkolumn\fP.
.RE
.sp
\fB\-y\fP, \fB\-\-shell\fP
.RS 4
Kolumnnamnet ändras så att det endast innehåller tecken som är tillåtna för identifiering av skalvariabler, t.ex. MIN_IO och FSUSE_PCT i stället för MIN\-IO och FSUSE%. Detta kan t.ex. användas med \fB\-\-pairs\fP. Observera att den här funktionen aktiverades automatiskt för \fB\-\-pairs\fP i version 2.37, men på grund av kompatibilitetsproblem är det nu nödvändigt att begära detta beteende med \fB\-\-shell\fP.
.RE
.sp
\fB\-z\fP, \fB\-\-zoned\fP
.RS 4
Skriv ut zonrelaterad information för varje enhet.
.RE
.sp
\fB\-\-sysroot\fP \fIkatalog\fP
.RS 4
Samlar in data för en annan Linux\-instans än den instans från vilken kommandot \fBlsblk\fP utfärdades. Den angivna katalogen är systemroten för den Linux\-instans som ska inspekteras. De verkliga enhetsnoderna i målkatalogen kan ersättas av textfiler med udev\-attribut.
.RE
.sp
\fB\-\-properties\-by\fP \fIlista\fP
.RS 4
Den här flaggan anger de metoder som \fBlsblk\fP använder för att samla in information om filsystem och partitionstabeller. Listan är en kommaseparerad lista med metodnamn. Standardinställningen är "file,udev,blkid". De metoder som stöds är:
.sp
\fBudev\fP
.RS 4
Läser data från udev DB. Om det inte lyckas går den vidare till nästa sonderingsmetod.
.RE
.sp
\fBblkid\fP
.RS 4
Läser data direkt från enheten med hjälp av libblkid. Om det inte lyckas går den vidare till nästa probningsmetod.
.RE
.sp
\fBfile\fP
.RS 4
Läser data från en fil. Den här metoden används endast om flaggan \-\-sysroot har angetts. Denna metod stoppar alltid probing om den används.
.RE
.sp
\fBnone\fP
.RS 4
Sondar inte. Denna metod stoppar alltid sonderingen.
.RE
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Visa hjälptext och avsluta.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Visa version och avsluta.
.RE
.SH "AVSLUTSSTATUS"
.sp
0
.RS 4
lyckades
.RE
.sp
1
.RS 4
misslyckande
.RE
.sp
32
.RS 4
ingen av de angivna enheterna hittades
.RE
.sp
64
.RS 4
vissa specificerade enheter hittades, andra hittades inte
.RE
.SH "FÄRGER"
.sp
Färgläggningen av utdata implementeras av \fBterminal\-colors.d\fP(5) funktionalitet. Implicit färgläggning kan inaktiveras med en tom fil
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/lsblk.disable\fP
.br
.RE
.ll
.sp
för kommandot \fBlsblk\fP eller för alla verktyg med
.RS 3
.ll -.6i
.sp
\fI/etc/terminal\-colors.d/disable\fP
.br
.RE
.ll
.sp
Sedan version 2.41 stöds även miljövariabeln $NO_COLOR som inaktiverar färgläggning av utdata om den inte uttryckligen aktiveras med en kommandoradsflagga.
.sp
Den användarspecifika \fI$XDG_CONFIG_HOME/terminal\-colors.d\fP eller \fI$HOME/.config/terminal\-colors.d\fP åsidosätter den globala inställningen.
.sp
Observera att färgläggningen av utdata kan vara aktiverad som standard, och i så fall behöver inte \fIterminal\-colors.d\fP\-katalogerna finnas ännu.
.SH "MILJÖ"
.sp
\fBLSBLK_DEBUG\fP=all
.RS 4
aktiverar \fBlsblk\fP felsökningsutdata.
.RE
.sp
\fBLIBBLKID_DEBUG\fP=all
.RS 4
aktiverar \fBlibblkid\fP felsökningsutdata.
.RE
.sp
\fBLIBMOUNT_DEBUG\fP=all
.RS 4
aktiverar \fBlibmount\fP felsökningsutdata.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
aktiverar libsmartcols felsökningsutdata.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
använda synliga utfyllnadstecken.
.RE
.sp
\fBLSBLK_COLUMNS\fP=
.RS 4
anger en kommaseparerad lista över utdatakolumner att skriva ut. Alla kolumner som listas av \fB\-\-list\-columns\fP kan användas.
.RE
.SH "ANMÄRKNINGAR"
.sp
För partitioner ärvs viss information (t.ex. köattribut) från den överordnade enheten.
.sp
Kommandot \fBlsblk\fP måste kunna slå upp varje blockenhet med major\- och minor\-nummer, vilket görs med hjälp av \fI/sys/dev/block\fP. Denna sysfs\-blockkatalog dök upp i kärnan 2.6.27 (oktober 2008). Om du får problem med en tillräckligt ny kärna, kontrollera att \fBCONFIG_SYSFS\fP var aktiverat när kärnan byggdes.
.SH "UPPHOVSPERSONER"
.sp
.MTO "gmazyland\(atgmail.com" "Milan Broz" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "SE ÄVEN"
.sp
\fBblkid\fP(8), \fBfindmnt\fP(8) \fBls\fP(1), \fBscols\-filter\fP(5)
.SH "FELRAPPORTERING"
.sp
För felrapporter, använd \c
.URL "https://github.com/util\-linux/util\-linux/issues" "felhanteraren" "."
.SH "TILLGÄNGLIGHET"
.sp
Kommandot \fBlsblk\fP ingår i paketet util\-linux som kan hämtas från \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."