'\" t
.\"     Title: blkid
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-03-19
.\"    Manual: Administracja systemem
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "BLKID" "8" "2025-03-19" "util\-linux 2.41" "Administracja systemem"
.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 "NAZWA"
blkid \- lokalizuje urządzenie blokowe lub wypisuje jego atrybuty
.SH "SKŁADNIA"
.sp
\fBblkid\fP \fB\-\-label\fP \fIetykieta\fP | \fB\-\-uuid\fP \fIuuid\fP
.sp
\fBblkid\fP [\fB\-\-no\-encoding\fP \fB\-\-garbage\-collect\fP \fB\-\-list\-one\fP \fB\-\-cache\-file\fP \fIplik\fP] [\fB\-\-output\fP \fIformat\fP] [\fB\-\-match\-tag\fP \fIznacznik\fP] [\fB\-\-match\-token\fP \fINAZWA=wartość\fP] [\fIurządzenie\fP...]
.sp
\fBblkid\fP \fB\-\-probe\fP [\fB\-\-offset\fP \fIprzesunięcie\fP] [\fB\-\-output\fP \fIformat\fP] [\fB\-\-size\fP \fIrozmiar\fP] [\fB\-\-match\-tag\fP \fIznacznik\fP] [\fB\-\-match\-types\fP \fIlista\fP] [\fB\-\-usages\fP \fIlista\fP] [\fB\-\-no\-part\-details\fP] \fIurządzenie\fP...
.sp
\fBblkid\fP \fB\-\-info\fP [\fB\-\-output format\fP] [\fB\-\-match\-tag\fP \fIznacznik\fP] \fIurządzenie\fP...
.SH "OPIS"
.sp
Program \fBblkid\fP jest interfejsem wiersza poleceń do pracy z biblioteką \fBlibblkid\fP(3). Potrafi określić typ zawartości (np. system plików lub przestrzeń wymiany) występującej w urządzeniu blokowym, jak również atrybuty (tokeny, pary NAZWA=wartość) z metadanych zawartości (np. pól LABEL lub UUID).
.sp
\fBZaleca się korzystać z polecenia\fP \fBlsblk\fP(8), \fBaby uzyskać informacje o urządzeniach blokowych lub lsblk \-\-fs aby uzyskać przegląd systemów plików albo z\fP \fBfindmnt\fP(8) \fBaby poszukać już zamontowanych systemów plików.\fP
.RS 3
.ll -.6i
.sp
\fBlsblk\fP(8) udostępnia więcej informacji, umożliwia lepszą kontrolę nad formatowaniem wyjścia, jest prostszy do użycia w skryptach i nie wymaga uprawnień roota do faktycznego uzyskania informacji. \fBblkid\fP odczytuje informacje bezpośrednio z urządzeń i w przypadku użytkowników innych niż root, zwraca niezweryfikowane informacje zbuforowane. \fBblkid\fP jest przeznaczony głównie do usług systemowych i testowania funkcjonalności \fBlibblkid\fP(3).
.br
.RE
.ll
.sp
Gdy poda się \fIurządzenie\fP, wyświetlane są tokeny jedynie z tego urządzenia. W wierszu polecenia można podać wiele argumentów \fIurządzenie\fP. Jeśli nie poda się żadnego, pokazywane są wszystkie partycje lub urządzenia niespartycjonowane, które pojawiają się w \fI/proc/partitions\fP, o ile tylko są rozpoznane.
.sp
\fBblkid\fP ma dwa główne tryby działania: szukanie urządzenia po określonej parze NAZWA=wartość lub wyświetlanie par NAZWA=wartość dla jednego lub więcej określonych urządzeń.
.sp
Z powodów bezpieczeństwa, \fBblkid\fP po cichu ignoruje wszelkie urządzenia, których sprawdzenie daje niejednoznaczne wyniki (wykryto wiele kolidujących systemów plików). W takim przypadku tryb sondowania niskopoziomowego (\fB\-p\fP) zapewni więcej informacji i dodatkowy status zakończenia. Zaleca się korzystać z \fBwipefs\fP(8) w celu uzyskania szczegółowego przeglądu i usunięcia staroci (łańcuchów magicznych) z takiego urządzenia.
.SH "OPCJE"
.sp
Po argumentach \fIrozmiar\fP i \fIprzesunięcie\fP mogą występować przyrostki oznaczające wielokrotność: KiB (=1024), MiB (=1024*1024), itd. dla GiB, TiB, PiB, EiB, ZiB i YiB (cząstka "iB" jest opcjonalna, tzn. np. "K" znaczy to samo co "KiB") lub przyrostki KB (=1000), MB (=1000*1000), itd. dla GB, TB, PB, EB, ZB i YB.
.sp
\fB\-c\fP, \fB\-\-cache\-file\fP \fIplik\-pamięci\-podręcznej\fP
.RS 4
Odczytuje z podanego \fIpliku\-pamięci\-podręcznej\fP, zamiast z domyślnego (więcej szczegółów w rozdziale *PLIK KONFIGURACYJNY). Aby uruchomić program z pustym plikiem pamięci podręcznej (tj. nie zgłaszać urządzeń poprzednio przeskanowanych, które mogą już nie być dostępne), proszę podać \fI/dev/null\fP jako argument.
.RE
.sp
\fB\-d\fP, \fB\-\-no\-encoding\fP
.RS 4
Nie koduje znaków niedrukowalnych. Domyślnie, znaki niedrukowalne są kodowane za pomocą notacji ^ i M\-. Proszę zauważyć, że format wyjściowy \fB\-\-output udev\fP używa innego kodowania, którego nie można wyłączyć.
.RE
.sp
\fB\-D\fP, \fB\-\-no\-part\-details\fP
.RS 4
Nie wypisuje informacji (znaczników PART_ENTRY_*) z tablicy partycji, w trybie sondowania niskopoziomowego.
.RE
.sp
\fB\-g\fP, \fB\-\-garbage\-collect\fP
.RS 4
Dokonuje odśmiecenia pamięci podręcznej blkid, aby usunąć urządzenia, które już nie istnieją.
.RE
.sp
\fB\-H\fP, \fB\-\-hint\fP \fIustawienie\fP
.RS 4
Ustawia podpowiedź dla sondowania. Podpowiedzi są opcjonalnym sposobem zmuszenia funkcji sondujących do sprawdzenia np. innego położenia. Obecnie obsługiwane jest ustawienie "session_offset=\fIliczba\fP", ustawiające przesunięcie sesji na wielosesyjnym UDF\-ie.
.RE
.sp
\fB\-i\fP, \fB\-\-info\fP
.RS 4
Wyświetla informacji o limitach wejścia/wyjścia (inaczej topologii wejścia/wyjścia). Automatycznie włączony zostanie format wyjściowy "export". Opcję tę można łączyć z opcją \fB\-\-probe\fP.
.RE
.sp
\fB\-k\fP, \fB\-\-list\-filesystems\fP
.RS 4
Wypisuje wszystkie znane systemy plików oraz RAID i wychodzi.
.RE
.sp
\fB\-l\fP, \fB\-\-list\-one\fP
.RS 4
Szuka tylko jednego urządzenia pasującego do podanego z opcją \fB\-\-match\-token\fP parametru wyszukiwania. Jeśli wystąpi wiele urządzeń pasujących do podanego parametru wyszukiwania, zwracane jest urządzenie o najwyższym priorytecie i/lub pierwsze odnalezione urządzenie o podanym priorytecie (lecz zob. niżej informację o udev). Typy urządzeń, od najwyższego priorytetu, to: Device Mapper, EVMS, LVM, MD i na końcu zwykłe urządzenia blokowe. Jeśli nie poda się tej opcji, \fBblkid\fP wypisze wszystkie urządzenia pasujące do parametru wyszukiwania.
.sp
Opcja ta zmusza \fBblkid\fP do korzystania z udev, jeśli w \fB\-\-match\-token\fP korzysta się z tokenów LABEL lub UUID. Celem jest zapewnienie wyniku spójnego z innymi urządzeniami (jak \fBmount\fP(8) itp.) w systemach, gdzie ten sam znacznik jest używany wobec wielu urządzeń.
.RE
.sp
\fB\-L\fP, \fB\-\-label\fP \fIetykieta\fP
.RS 4
Szuka urządzenia używającego podanej \fIetykiety\fP systemu plików; równoważne \fB\-\-list\-one \-\-output device \-\-match\-token LABEL=\fP\fIetykieta\fP. Ta metoda wyszukiwania może rzetelnie korzystać z dowiązań symbolicznych udev /dev/disk/by\-label (w zależności od ustawienia w \fI/etc/blkid.conf\fP). Proszę unikać bezpośredniego korzystania z dowiązań symbolicznych; nie jest pewne korzystanie z nich bez weryfikacji. Opcja \fB\-\-label\fP działa na systemach z i bez udev.
.sp
Niestety, pierwotne \fBblkid\fP(8) z e2fsprogs używa opcji \fB\-L\fP jako synonimu \fB\-o list\fP. Aby poprawić przenośność, proszę korzystać w swoich skryptach z \fB\-l \-o device \-t LABEL=\fP\fIetykieta\fP i \fB\-o list\fP, zamiast z opcji \fB\-L\fP.
.RE
.sp
\fB\-n\fP, \fB\-\-match\-types\fP \fIlista\fP
.RS 4
Ogranicza funkcje sondowania do podanej \fIlisty\fP typów (nazw) superbloków (separatorem jest przecinek). Elementy listy można poprzedzić przedrostkiem "no" aby określić, które typy zignorować. Na przykład:
.sp
\fBblkid \-\-probe \-\-match\-types vfat,ext3,ext4 /dev/sda1\fP
.sp
sonduje pod kątem systemów plików vfat, ext3 i ext4, a
.sp
\fBblkid \-\-probe \-\-match\-types nominix /dev/sda1\fP
.sp
sonduje pod kątem wszystkich obsługiwanych formatem poza systemami plików minix. Opcja ta jest przydatna tylko w połączeniu z \fB\-\-probe\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIformat\fP
.RS 4
Używa podanego formatu wyjściowego. Proszę zauważyć, że koeljność zmiennych i urządzeń nie jest stała. Zob. też opcję \fB\-s\fP. Parametrem \fIformat\fP może być:
.sp
\fBfull\fP
.RS 4
wypisuje wszystkie znaczniki (domyślnie)
.RE
.sp
\fBvalue\fP
.RS 4
wypisuje wartość znaczników
.RE
.sp
\fBlist\fP
.RS 4
wypisuje urządzenia w formacie przyjaznym dla użytkownika; format wyjściowy nieobsługiwany w przypadku sondowania niskopoziomowego (\fB\-\-probe\fP lub \fB\-\-info\fP).
.sp
Ten format wyjściowy jest \fBPRZESTARZAŁY\fP na rzecz polecenia \fBlsblk\fP(8).
.RE
.sp
\fBdevice\fP
.RS 4
wypisuje tylko nazwę urządzenia; format wyjściowy włączany zawsze przy korzystaniu z opcji \fB\-\-label\fP i \fB\-\-uuid\fP
.RE
.sp
\fBudev\fP
.RS 4
wypisuje pary klucz="wartość" umożliwiając łatwy import do środowiska udev; klucze są poprzedzone przedrostkami ID_FS_ lub ID_PART_. Wartość może być zmodyfikowana, aby być bezpieczną dla środowiska udev; dozwolone są proste znaki ASCII, znaki cytowane szesnastkowo i prawidłowe znaki UTF\-8, wszystko pozostałe (w tym białe znaki) jest zastępowane przez znak \*(Aq_\*(Aq. Klucze z przyrostkiem \fI_ENC\fP korzystają z cytowania szesnastkowego, ze względu na niebezpieczne znaki.
.sp
Wyjście udev zwraca znacznik ID_FS_AMBIVALENT, jeśli wykryto więcej superbloków, a znaczniki ID_PART_ENTRY_* są zawsze zwracane dla wszystkich partycji, w tym partycji pustych.
.sp
Ten format wyjściowy jest \fBPRZESTARZAŁY\fP
.RE
.sp
\fBexport\fP
.RS 4
wypisuje pary klucz=wartość umożliwiając łatwy import do środowiska; format wyjściowy włączany automatycznie, jeśli zażądano informacji o limitach wejścia/wyjścia (I/O Limits; opcja \fB\-\-info\fP).
.sp
Znaki niedrukowalne są kodowane za pomocą notacji ^ i M\-, a wszystkie potencjalnie niebezpieczne znaki są cytowane.
.RE
.sp
\fBjson\fP
.RS 4
Wypisuje wpisy znaczników w obiektach JSON.
.RE
.RE
.sp
\fB\-O\fP, \fB\-\-offset\fP \fIprzesunięcie\fP
.RS 4
Sonduje na podanym \fIprzesunięciu\fP (przydatne tylko z \fB\-\-probe\fP). Opcję tę można łączyć z opcją \fB\-\-info\fP.
.RE
.sp
\fB\-p\fP, \fB\-\-probe\fP
.RS 4
Przełącza się na niskopoziomowy tryb sondowania superbloku (z pominięciem pamięci podręcznej).
.sp
Proszę zauważyć, że to niskopoziomowe sondowanie zwraca także informacje o typie tablicy partycji (znacznik PTTYPE) oraz partycjach (znaczniki PART_ENTRY_*). Nazwy znaczników tworzone przy sondowaniu niskopoziomowy opierają się na nazwach używanych wewnętrznie przez libblkid i mogą różnić się od wyniku wykonania bez opcji \fB\-\-probe\fP (np. PART_ENTRY_UUID= vs PARTUUID=). Zob. też \fB\-\-no\-part\-details\fP.
.RE
.sp
\fB\-s\fP, \fB\-\-match\-tag\fP \fIznacznik\fP
.RS 4
Dla każdego (podanego) urządzenia, pokazuje jedynie znaczniki pasujące do \fIznacznika\fP. Można podać opcję \fB\-\-match\-tag\fP wielokrotnie. Jeśli nie poda się znacznika, pokazywane są tokeny dla wszystkich (podanych) urządzeń. Aby jedynie odświeżyć pamięć podręczną bez pokazywania tokenów, należy podać \fB\-\-match\-tag none\fP bez innych opcji.
.RE
.sp
\fB\-S\fP, \fB\-\-size\fP \fIrozmiar\fP
.RS 4
Przesłania rozmiar urządzenia/pliku (przydatne tylko z \fB\-\-probe\fP).
.RE
.sp
\fB\-t\fP, \fB\-\-match\-token\fP \fINAZWA=wartość\fP
.RS 4
Szuka urządzeń blokowych, z tokenami o nazwach \fINAZWA\fP, które mają wartość \fIwartość\fP i wyświetla odnalezione urządzenia. Częstymi wartościami \fINAZWY\fP są: \fBTYPE\fP, \fBLABEL\fP i \fBUUID\fP. Jeśli w wierszu polecenia nie podano urządzeń, przeszukane będą wszystkie urządzenia blokowe; w innym przypadku \- tylko podane urządzenia.
.RE
.sp
\fB\-u\fP, \fB\-\-usages\fP \fIlista\fP
.RS 4
Ogranicza funkcje sondujące do podanej \fIlisty\fP typów "zastosowań" (z przecinkiem jako separatorem). Obsługiwanymi typami zastosowań są: filesystem (system plików), raid, crypto (kryptografia) i other (inne). Listę pozycji można poprzedzić przedrostkiem "no", aby określić typy zastosowań do zignorowania. Na przykład:
.sp
\fBblkid \-\-probe \-\-usages filesystem,other /dev/sda1\fP
.sp
sonduje pod kątem systemów plików i innych formatów (np. przestrzeni wymiany), a
.sp
\fBblkid \-\-probe \-\-usages noraid /dev/sda1\fP
.sp
sonduje pod kątem wszystkich obsługiwanych formatów z wyjątkiem RAID\-ów. Opcja jest przydatna tylko w połączeniu z \fB\-\-probe\fP.
.RE
.sp
\fB\-U\fP, \fB\-\-uuid\fP \fIuuid\fP
.RS 4
Wyszukuje urządzenia, które używa podanego \fIuuid\-u\fP systemu plików. Więcej szczegółów w opisie opcji \fB\-\-label\fP.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "STATUS ZAKOŃCZENIA"
.sp
Jeśli podane urządzenie lub urządzenie opisane określonym tokenem (opcja \fB\-\-match\-token\fP) zostało odnalezione i dało się zebrać jakieś informacje o urządzeniu, zwracany jest status zakończenia równy 0. Proszę zauważyć, że opcja \fB\-\-match\-tag\fP filtruje znaczniki wyjściowe, ale nie wpływa na status zakończenia.
.sp
Jeśli nie odnaleziono podanego tokenu lub nie dało się zidentyfikować (podanych) urządzeń albo gdy nie dało się zebrać jakichkolwiek informacji o identyfikatorach urządzenia lub jego zawartości, zwracany jest status zakończenia równy 2.
.sp
W przypadku błędnego użycia lub innych błędów, zwracany jest status zakończenia równy 4.
.sp
Jeśli w trybie sondowania niskopoziomowego (\fB\-p\fP) wykryto niejednoznaczny wynik, zwracany jest status zakończenia równy 8.
.SH "CONFIGURATION FILE"
.sp
Standardowe położenie pliku konfiguracyjnego \fI/etc/blkid.conf\fP można przesłonić zmienną środowiskową \fBBLKID_CONF\fP. Poniższe opcje kontrolują bibliotekę libblkid:
.sp
\fISEND_UEVENT=<yes|not>\fP
.RS 4
Wysyła uevent gdy dowiązanie symboliczne \fI/dev/disk/by\-{label,uuid,partuuid,partlabel}/\fP nie pasuje do LABEL, UUID, PARTUUID lub PARTLABEL na urządzeniu. Domyślnie "yes" (tak).
.RE
.sp
\fICACHE_FILE=<ścieżka>\fP
.RS 4
Przesłania standardowe położenie pliku pamięci podręcznej. Ustawienie to można przesłonić zmienną środowiskową \fBBLKID_FILE\fP. Domyślnie \fI/run/blkid/blkid.tab\fP albo \fI/etc/blkid.tab\fP w systemach bez katalogu \fI/run\fP.
.RE
.sp
\fIEVALUATE=<metody>\fP
.RS 4
Określa metodę/metody sprawdzania LABEL i UUID. Obecnie biblioteka libblkid obsługuje metody "udev" i "scan". Można podać więcej niż jedną metodę, w liście rozdzielonej przecinkiem. Domyślnie "udev,scan". Metoda "udev" używa dowiązań symbolicznych \fI/dev/disk/by\-*\fP, a metoda "scan" skanuje wszystkie urządzenia blokowe z pliku \fI/proc/partitions\fP.
.RE
.SH "ŚRODOWISKO"
.sp
Ustawienie \fILIBBLKID_DEBUG=all\fP włącza wyjście debugowania.
.SH "AUTORZY"
.sp
\fBblkid\fP zostało napisane przez Andreasa Dilgera (do libblkid) i usprawnione przez Theodore\(cqa Ts\(cqo i Karela Zaka.
.SH "ZOBACZ TAKŻE"
.sp
\fBlibblkid\fP(3), \fBfindfs\fP(8), \fBlsblk\fP(8), \fBwipefs\fP(8)
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBblkid\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."
