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 Wypisuje rozmiary w bajtach, zamiast w formacie czytelnym dla ludzi. Domyslnie jednostka w ktorej pokazywane sa rozmiary jest bajt, a przedrostki jednostek sa wielokrotnosciami 2^10 (1024). Symbole jednostek sa pokazywane w skroconej formie, aby poprawic czytelnosc, poprzez pokazanie jedynie pierwszej litery np. "1 KiB" i "1 MiB" staja sie odpowiednio: "1 K" i "1 M", tj. czastka "iB", bedaca czescia nazw jednostek, jest celowo pomijana. -H, --list-columns Wypisuje dostepne kolumny, w polaczeniu z --json lub --raw daje wynik w formacie czytelnym maszynowo. -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[=tryb] Wypisuje sciezki punktow montowan jako odnosniki na terminalu. Tryb mozna ustawic na "always" (zawsze), "never" (nigdy) lub "auto". Opcjonalny argument kiedy mozna ustawic na "auto", "never" lub "always". Jesli pominie sie argument kiedy, to domyslnie przyjmuje wartosc "auto". Ustawienie "auto" oznacza, ze odnosniki beda uzywane tylko wtedy, gdy wyjsciem jest 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 wyrazenie Wypisuje jedynie urzadzenia, ktore spelniaja warunki podane w wyrazeniu. Filtr jest stosowany przed zebraniem danych do wszystkich kolumn wyjsciowych przez lsblk. Z systemu pobierane sa jedynie dane, konieczne do leniwego sprawdzenia wyrazenia. Takie podejscie moze poprawic wydajnosc w porownaniu do pozniejszego filtrowania, ktore czesto jest dokonywane narzedziami takimi jak grep(1). Funkcja ta jest EKSPERYMENTALNA. Zob. tez scols-filter(5). Oto przyklad wylaczajacy sda i sdb, lecz wypisujacy wszystko inne ("!~" jest operatorem wyrazenia regularnego, dopasowujacym odwrotnosc): lsblk --filter 'NAME !~ "sd[ab]"' --highlight wyrazenie Koloruje wiersze pasujace do wyrazenia. Funkcja ta jest EKSPERYMENTALNA. Zob. tez scols-filter(5). --ct nazwa [: parametr [: funkcja ]] Definiuje wlasny licznik. Liczniki sa wypisywane po standardowych wynikach. Nazwa jest wlasna nazwa licznika, opcjonalny parametr jest nazwa zliczanej kolumny, a opcjonalna funkcja okresla funkcje zliczajaca, jedna z obslugiwanych: count, min, max lub sum. Domyslna jest count. Jesli nie poda sie parametru, licznik zliczy liczbe wierszy. Funkcja ta jest EKSPERYMENTALNA. Zob. tez --ct-filter. Na przyklad --ct MojLicznik:SIZE:sum zsumuje wielkosci rozmiaru (SIZE) ze wszystkich wierszy; natomiast aby zliczyc liczbe dyskow SATA mozna uzyc: lsblk --ct-filter 'TYPE=="disk" && TRAN=="sata"' --ct "Liczba urzadzen SATA" --ct-filter wyrazenie Definiuje ograniczenia dla kolejnego licznika. Funkcja ta jest EKSPERYMENTALNA. Zob. tez --ct i scols-filter(5). Na przyklad, aby zsumowac rozmiary urzadzen wedlug typu: 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 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. 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.41 2025-03-29 LSBLK(8)