'\" t
.\"     Title: lsblk
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: Systemadministration
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "LSBLK" "8" "2026-05-18" "util\-linux 2.42.1" "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
Print sizes in bytes rather than in human\-readable form.
.sp
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, .\|.\|..
.RE
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
List the columns that can be specified with the \fB\-\-output\fP option. Can be used with \fB\-\-json\fP or \fB\-\-raw\fP to get the list in a machine\-readable 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\fIwhen\fP]
.RS 4
Print paths as terminal hyperlinks. The optional \fIwhen\fP argument can be \fBalways\fP, \fBnever\fP, or \fBauto\fP. If the argument is omitted, it defaults to \fBauto\fP, which means that hyperlinks will only be used when the output goes to a 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 \fIexpression\fP
.RS 4
Print only the devices that meet the conditions specified by \fIexpression\fP. The filter is assessed prior to \fBlsblk\fP 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 \fBgrep\fP(1).
.sp
This feature is EXPERIMENTAL. See also \fBscols\-filter\fP(5).
.sp
For example, to exclude sda and sdb, but print everything else (\*(Aq!~\*(Aq is a negative regular\-expression matching operator):
.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 \fIexpression\fP
.RS 4
Colorize lines matching \fIexpression\fP.
.sp
This feature is EXPERIMENTAL. See also \fBscols\-filter\fP(5).
.RE
.sp
\fB\-\-ct\fP \fIname\fP[\fB:\fP\fIparameter\fP[\fB:\fP\fIfunction\fP]]
.RS 4
Define a custom counter. Custom counters are printed after the standard output. The \fIname\fP is the custom name of the counter, the optional \fIparameter\fP is the name of the column to be used for the counter, and the optional \fIfunction\fP specifies the aggregation function. Supported functions are: \fBcount\fP, \fBmin\fP, \fBmax\fP, \fBsum\fP. The default function is \fBcount\fP. If \fIparameter\fP is not specified, then the counter counts the number of lines.
.sp
This feature is EXPERIMENTAL. See also \fB\-\-ct\-filter\fP.
.sp
For example, \fB\-\-ct MyCounter:SIZE:sum\fP reports the total of the SIZE values. To report the number of SATA disks, one can use:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
lsblk \-\-ct\-filter \*(AqTYPE=="disk" && TRAN=="sata"\*(Aq \(rs
      \-\-ct "Number of SATA devices"
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-\-ct\-filter\fP \fIexpression\fP
.RS 4
Define a restriction for the next counter.
.sp
This feature is EXPERIMENTAL. See also \fB\-\-ct\fP and \fBscols\-filter\fP(5).
.sp
For example, to aggregate sizes by device type:
.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 NAMN,INRIKTNING,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
\fBfil\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
\fBingen\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
specifies a comma\-separated list of output columns to print. All columns listed by \fB\-\-list\-columns\fP can be used.
.RE
.SH "ANTECKNINGAR"
.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" "."