LSBLK(8) Administracja systemem LSBLK(8) NAZWA lsblk - wypisuje urzadzenia blokowe SKLADNIA lsblk [opcje] [urzadzenie...] OPIS lsblk wypisuje informacje o wszystkich dostepnych lub podanych urzadzeniach blokowych. Polecenie lsblk odczytuje system plikow sysfs i udev db w celu zebrania informacji. Jesli baza udev jest niedostepna lub skompilowano lsblk bez obslugi udev, stara sie on odczytac etykiety, UUID-y i typy systemow plikow z urzadzenia blokowego. W tym przypadku wymagane sa uprawnienia roota. Domyslnie, polecenie wypisuje informacje o wszystkich urzadzeniach (z wyjatkiem dyskow RAM). To samo urzadzenie moze pojawic sie ponownie w drzewie, jesli jest zwiazane z innymi urzadzeniami. W przypadku bardziej skomplikowanych sytuacji, zaleca sie korzystanie z opcji --merge, aby laczyc grupy urzadzen i opisywac zlozone relacje N:M. Wyjscie w postaci drzewa (lub tablica children[] w wyjsciu JSON) jest wlaczane tylko wtedy, gdy w wyjsciu obecna jest kolumna NAME albo gdy uzyto opcji wiersza polecenia --tree. Zob. tez opcje --nodeps i --list, sterujace formatowaniem drzewa. Domyslny wynik, jak rowniez domyslny wynik z opcji takich jak --fs i --topology moze ulec zmianie. Gdy to tylko mozliwe, nalezy unikac uzywania domyslnych wynikow w swoich skryptach. Prosze zawsze jawnie okreslac oczekiwane kolumny opcja --output lista-kolumn oraz --list w srodowiskach wymagajacego stabilnego wyniku. Wszystkie dostepne kolumny wypisze polecenie lsblk --list-columns. Prosze zauwazyc, ze lsblk moze byc wykonane w momencie, gdy udev nie ma jeszcze wszystkich informacji o ostatnio dodanych lub zmodyfikowanych urzadzeniach. W takim przypadku, zaleca sie uzycie najpierw udevadm settle, aby dokonac synchronizacji z udev. Relacja pomiedzy urzadzeniem blokowym a systemem plikow nie zawsze jest jak jeden do jednego. System plikow moze uzywac wiecej urzadzen blokowych lub ten sam system plikow moze byc dostepny w kilku lokalizacjach. Jest to powod, dla ktorego lsblk udostepnia kolumny MOUNTPOINT i MOUNTPOINTS (odpowiednio: punkt i punkt*y* montowania). Kolumna MOUNTPOINT wyswietla pojedynczy punkt montowania (zwykle ostatnio zamontowany system plikow), a kolumna MOUNTPOINTS wyswietla wielowierszowa komorke zawierajaca wszystkie punkty montowania zwiazane z urzadzeniem. OPCJE -A, --noempty Nie wypisuje pustych urzadzen. -a, --all Wylacza wszelkie wbudowane filtry i wypisuje rowniez wszystkie puste urzadzenia oraz dyski 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 Wypisuje informacje o funkcjach "discard" (TRIM, UNMAP) przy kazdym urzadzeniu. -d, --nodeps Nie wypisuje urzadzen nadrzednych ani podrzednych. Przykladowo lsblk --nodeps /dev/sda wypisze informacje tylko o urzadzeniu sda. -E, --dedup kolumna Kolumna jest kluczem deduplikujacym, sluzacym do usuniecia duplikatow z wynikowego drzewa. Jesli dla urzadzenia nie jest dostepny klucz, lub urzadzenie jest partycja, a nadrzedne urzadzenie zawierajace caly dysk udostepnia ten sam klucz, to urzadzenie zawsze zostanie wyswietlone. Typowym zastosowaniem jest unikniecie duplikatow w systemach z urzadzeniami dostepnymi w wielu sciezkach, np. za pomoca opcji -E WWN. -e, --exclude lista Pomija urzadzenia podane w liscie urzadzen, okreslone glownymi numerami urzadzen i oddzielone przecinkami. Domyslnie pomijane sa dyski RAM (glowny numer urzadzenia rowny 1), jesli nie podano opcji --all. Filtr ma zastosowanie jedynie do urzadzen najwyzszego poziomu. Moze byc to mylace, w przypadku formatu wynikowego --list, w ktorym hierarchia urzadzen nie jest oczywista. -f, --fs Wypisuje informacje o systemach plikow. Jest to odpowiednik -o NAME,FSTYPE,FSVER,LABEL,UUID,FSAVAIL,FSUSE%,MOUNTPOINTS. Pelne informacje o systemach plikow i macierzach RAID sa udostepniane przez polecenie 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 lista Obejmuje urzadzenia podane w liscie urzadzen, okreslone glownymi numerami urzadzen i oddzielone przecinkami. Filtr ma zastosowanie jedynie do urzadzen najwyzszego poziomu. Moze byc to mylace w przypadku formatu wynikowego --list, w ktorym hierarchia urzadzen nie jest oczywista. -i, --ascii Do formatowania drzewa uzywa znakow ASCII. -J, --json Uzywa formatu wyjsciowego JSON. Zdecydowanie zaleca sie uzywanie opcji --output oraz -tree, jesli sa potrzebne. Prosze zauwazyc, ze children[] jest uzywane tylko, gdy korzysta sie z opcji --tree lub kolumny NAME. -l, --list Wypisuje wynik w postaci listy. Brak w nim informacji o powiazaniach pomiedzy urzadzeniami, a od wersji 2.34 kazde urzadzenie jest pokazane tylko raz, o ile nie podano opcji --pairs lub --raw (wyniki nadajace sie do automatycznego przetwarzania sa wstecznie kompatybilne). -M, --merge Grupuje urzadzenia nadrzedne dla poddrzew, aby uczynic wynik czytelniejszym w przypadku urzadzen RAID i urzadzen o wielu sciezkach. Wymagany jest wynik w postaci drzewa. -m, --perms Wypisuje informacje o posiadaczu, grupie i trybie urzadzenia. Jest to odpowiednik -o NAME,SIZE,OWNER,GROUP,MODE. -N, --nvme Wypisuje informacje tylko o urzadzeniach NVMe. -v, --virtio Wypisuje informacje tylko o urzadzeniach virtio. -n, --noheadings Nie wypisuje naglowka. -o, --output lista Okresla wypisywane kolumny. Liste obslugiwanych kolumn mozna poznac podajac opcje --list-columns. Kolumny moga miec wplyw na wynik w postaci drzewa. Domyslnie drzewo jest uzywane do kolumny "NAME" (zob. tez --tree). Domyslna liste kolumn mozna rozszerzyc, jesli liste poda sie w formacie +lista (np. lsblk -o +UUID). -O, --output-all Wypisuje wszystkie dostepne kolumny. -P, --pairs Tworzy wynik w formie par klucz="wartosc". Wynikowe wiersze sa wciaz posortowane wg powiazan miedzy urzadzeniami. Wszystkie potencjalnie niebezpieczne wartosci znakow sa cytowane szesnastkowo (\x). Zob. tez opcje --shell. -p, --paths Wypisuje pelne sciezki urzadzen. -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 Partycje:SIZE:sum \ --ct-filter 'TYPE=="disk"' --ct CaleDyski:SIZE:sum -r, --raw Wypisuje wynik w formacie surowym. Wynikowe wiersze sa wciaz posortowane wg powiazan miedzy urzadzeniami. Wszystkie potencjalnie niebezpieczne znaki sa cytowane szesnastkowo (\x) w kolumnach NAME, KNAME, LABEL, PARTLABEL i MOUNTPOINT. -S, --scsi Wypisuje informacje jedynie o urzadzeniach SCSI. Wszystkie partycje, urzadzenia podrzedne i kieszenie na urzadzenia sa ignorowane. -s, --inverse Wypisuje zaleznosci w odwroconej kolejnosci. Jesli zazadano formatu --list, to wiersze sa wciaz posortowane wg powiazan miedzy urzadzeniami. -T, --tree[=kolumna] Wymusza format w postaci drzewa. Jesli podano kolumne, to drzewo jest wyswietlone w danej kolumnie. Domyslnie jest to kolumna NAME. -t, --topology Wypisuje informacje o topologii urzadzenia blokowego. Jest to odpowiednik -o NAME,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,RA,WSAME. -w, --width liczba Okresla szerokosc wyjscia jako liczbe znakow. Domyslnie jest to liczba kolumn terminala, a jesli polecenie nie jest wykonywane w terminalu, to szerokosc nie jest domyslnie limitowana. Opcja wymusza rowniez przyjecie przez lsblk, ze znaki kontrolne terminala i niebezpieczne znaki nie sa dozwolone. Zakladanym zastosowaniem tej opcji jest np. uzycie lsblk przez polecenie watch(1). -x, --sort kolumna Sortuje wynik wedlug kolumny. Opcja ta wlacza domyslnie format wyjsciowy --list. Mozna rowniez polaczyc ja z opcja --tree, aby wymusic format w postaci drzewa; wowczas jego galezie sa posortowane wedlug kolumny. -y, --shell Nazwy kolumn mozna zmodyfikowac, aby zawieraly jedynie znaki dozwolone do identyfikatorow zmiennych powloki, np. MIN_IO i FSUSE_PCT, zamiast MIN-IO i FSUSE%. Przydaje sie to np. z opcja --pairs. Prosze zauwazyc, ze funkcja ta byla automatycznie wlaczona z opcja --pairs w wersji 2.37, lecz ze wzgledu na problemy z kompatybilnoscia, teraz konieczne jest zazadanie takiego zachowania opcja --shell. -z, --zoned Wypisuje informacje zwiazane ze strefa dla kazdego urzadzenia. --sysroot katalog Pozyskuje dane dla systemu Linux innego niz ten, z ktorego uruchomiono lsblk. Podany katalog jest korzeniem systemu Linux, ktory ma byc sprawdzony. Rzeczywiste wezly urzadzenia w katalogu docelowym mozna zastapic plikami tekstowymi z atrybutami udev. --properties-by lista Opcja okresla metody uzywane przez lsblk do zebrania informacji o systemach plikow i tablicach partycji. Lista jest lista nazw metod, rozdzielonych przecinkiem. Domyslne ustawienie to "file,udev,blkid". Obslugiwane sa nastepujace metody: udev Odczytuje dane z bazy danych udev. Jesli sie to nie powiedzie, przechodzi do nastepnej metody. blkid Odczytuje dane bezposrednio z urzadzenia za pomoca libblkid. Jesli sie to nie powiedzie, przechodzi do nastepnej metody. file Odczytuje dane z pliku. Metoda ta jest wykorzystywana tylko, jesli podano opcje --sysroot. Metoda ta zawsze zatrzymuje dalsze odpytywanie. none Wcale nie odpytuje. Metoda ta zawsze zatrzymuje dalsze odpytywanie. -h, --help Wyswietla ten tekst i wychodzi. -V, --version Wyswietla wersje i wychodzi. STATUS ZAKONCZENIA 0 sukces 1 niepowodzenie 32 nie znaleziono zadnych podanych urzadzen 64 znaleziono jedynie czesc podanych urzadzen KOLORY Kolorowanie wyjsciowe zaimplementowano poprzez terminal-colors.d(5). Jawne kolorowanie mozna wylaczyc za pomoca pustego pliku /etc/terminal-colors.d/lsblk.disable dla polecenia lsblk albo dla wszystkich narzedzi plikiem /etc/terminal-colors.d/disable Od wersji 2.41, obslugiwana jest rowniez zmienna srodowiskowa $NO_COLOR, sluzaca do wylaczenia kolorowania wyjscia, o ile nie wlaczy sie je wprost opcja wiersza polecen. Globalne ustawienie przeslonia $XDG_CONFIG_HOME/terminal-colors.d lub $HOME/.config/terminal-colors.d danego uzytkownika. Prosze zauwazyc, ze kolorowanie wyjscia moze byc domyslnie wlaczone i wowczas katalogi terminal-colors.d moga jeszcze nie istniec. SRODOWISKO LSBLK_DEBUG=all wlacza wyjscie debugowania lsblk. LIBBLKID_DEBUG=all wlacza wyjscie debugowania libblkid. LIBMOUNT_DEBUG=all wlacza wyjscie debugowania libmount. LIBSMARTCOLS_DEBUG=all wlacza wyjscie debugowania libsmartcols. LIBSMARTCOLS_DEBUG_PADDING=on uzywa widocznych znakow wypelnienia. LSBLK_COLUMNS= specifies a comma-separated list of output columns to print. All columns listed by --list-columns can be used. UWAGI W przypadku partycji, czesc informacji (np. atrybuty kolejki), jest dziedziczona z urzadzenia nadrzednego. Polecenie lsblk musi byc w stanie odszukac kazde urzadzenie blokowe przez nr-glowny:nr-poboczny (major:minor), co jest dokonywane za pomoca /sys/dev/block. Ten katalog urzadzen blokowych sysfs pojawil sie w wersji jadra 2.6.27 (pazdziernik 2008). Jesli z tak odpowiednio nowym jadrem wystepuja problemy, prosze sprawdzic, czy jadro zbudowano z wlaczona opcja CONFIG_SYSFS. AUTORZY Milan Broz , Karel Zak ZOBACZ TAKZE blkid(8), findmnt(8) ls(1), scols-filter(5) ZGLASZANIE BLEDOW Problemy nalezy zglaszac w systemie sledzenia bledow . DOSTEPNOSC Polecenie lsblk jest czescia pakietu util-linux, ktory mozna pobrac ze strony Archiwum jadra Linux . util-linux 2.42.2 2026-06-16 LSBLK(8)