'\" t
.\"     Title: libblkid
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: Podręcznik programisty
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "LIBBLKID" "3" "2026-09-02" "util\-linux 2.42.3" "Podręcznik programisty"
.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"
libblkid \- biblioteka identyfikacji urządzeń blokowych
.SH "SKŁADNIA"
.sp
\fB#include <blkid.h>\fP
.sp
\fBcc\fP \fIfile.c\fP \fB\-lblkid\fP
.SH "OPIS"
.sp
Biblioteka \fBlibblkid\fP służy do identyfikacji urządzeń blokowych (dysków) w zakresie zawartości (np. typu systemu plików) oraz pozyskiwania dodatkowych informacji, takich jak etykiety systemu plików/nazwy woluminów, unikalne identyfikatory/numery seryjne. Częstym zastosowaniem jest możliwość użycia znaczników \fBLABEL=\fP i \fBUUID=\fP zamiast ustawionych na sztywno nazw urządzeń blokowych w plikach konfiguracyjnych. W rozdziale \fBZNACZNIKI\fP znajduje się lista wszystkich dostępnych znaczników.
.sp
Niskopoziomowa część biblioteki pozwala również pozyskiwać informacje o topologii urządzeń blokowych i partycji.
.sp
Wysokopoziomowa część biblioteki buforuje informacje o urządzeniach blokowych w pliku podręcznym i weryfikuje, czy są one wciąż prawidłowe, przed zwróceniem ich użytkownikowi (jeśli użytkownik ma uprawnienia do odczytu surowego urządzenia blokowego, w innym przypadku tak się nie dzieje). Plik podręczny pozwala również zlokalizować urządzenia na podstawie etykiety/identyfikatora użytkownikom nieuprzywilejowanym (zwykle innym niż root, lub nieujętych w grupie "disk"). Standardowe położenie pliku podręcznego można przesłonić zmienną środowiskową \fBBLKID_FILE\fP.
.sp
W sytuacjach, gdy uzyskuje się informacje o pojedynczym, znanym urządzeniu, na wydajność nie ma wpływu to, czy plik podręczny jest używany czy nie (chyba, że nie można bezpośrednio odczytać urządzenia blokowego).
.sp
Wysokopoziomowa część biblioteki obsługuje dwie metody sprawdzenia \fBLABEL/UUID\fP. Odczytuje informacje bezpośrednio z urządzenia blokowego lub odczytuje informacje z dowiązań symbolicznych udev w /dev/disk/by\-*. Domyślnie preferowana jest metoda udev.
.sp
Jeśli bada się wiele urządzeń, bardzo zalecane jest korzystanie z pliku podręcznego (nawet jeśli jest pusty), ponieważ urządzenia zostaną przeskanowane co najwyżej jednokrotnie i plik podręczny zostanie zaktualizowany, jeśli to możliwe.
.sp
W niektórych sytuacjach (jądra modularne), urządzenia blokowane nie są nawet widoczne do momentu uzyskania dostępu po raz pierwszy, więc istnienie metody na zlokalizowanie tych urządzeń bez wymieniania jedynie widocznych urządzeń jest krytyczne, zatem użycie pliku podręcznego w takich sytuacjach jest \fBwymagane\fP.
.SH "PLIK KONFIGURACYJNY"
.sp
Standardowe położenie pliku konfiguracyjnego \fI/etc/blkid.conf\fP można przesłonić zmienną środowiskową \fBBLKID_CONF\fP. Więcej informacji na temat pliku konfiguracyjnego można znaleźć w podręczniku \fBblkid\fP(8).
.SH "ZNACZNIKI"
.sp
Wszystkie dostępne znaczniki wypisano poniżej. Nie wszystkie są obsługiwane we wszystkich systemach plików. Aby włączyć znacznik, należy ustawić jeden z poniższych znaczników za pomocą \fBblkid_probe_set_superblocks_flags\fP():
.sp
BLKID_SUBLKS_TYPE
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
TYPE \- typ systemu plików
.RE
.RE
.sp
BLKID_SUBLKS_SECTYPE
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SEC_TYPE \- drugorzędny typ systemu plików
.RE
.RE
.sp
BLKID_SUBLKS_LABEL
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
LABEL \- etykieta systemu plików
.RE
.RE
.sp
BLKID_SUBLKS_LABELRAW
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
LABEL_RAW \- surowa etykieta z superbloku syst. pl.
.RE
.RE
.sp
BLKID_SUBLKS_UUID
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UUID \- UUID systemu plików (małe litery)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UUID_SUB \- UUID członka puli lub UUID elementu urządzenia itp. (np. zfs, btrfs, .\|.\|.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
LOGUUID \- UUID zewnętrznego dziennika (np. xfs)
.RE
.RE
.sp
BLKID_SUBLKS_UUIDRAW
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UUID_RAW \- surowy UUID z superbloku syst. pl.
.RE
.RE
.sp
BLKID_SUBLKS_USAGE
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
USAGE \- łańcuch opisujący użycie: "raid", "filesystem", itp.
.RE
.RE
.sp
BLKID_SUBLKS_VERSION
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
VERSION \- wersja systemu plików
.RE
.RE
.sp
BLKID_SUBLKS_MAGIC
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SBMAGIC \- łańcuch magiczny superbloku
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SBMAGIC_OFFSET \- przesunięcie SBMAGIC
.RE
.RE
.sp
BLKID_SUBLKS_FSINFO
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSSIZE \- rozmiar systemu plików. Proszę zauważyć, że w przypadku XFS zwrócona będzie ta sama wartość co przez lsblk (bez metadanych XFS), natomiast w przypadku ext4 zwrócony będzie rozmiar z metadanymi, a w przypadku BTRFS wartość nie obejmuje narzutu konfiguracji RAID (danych nadmiarowych).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSLASTBLOCK \- ostatni blok systemu plików/całkowita ich liczba
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSBLOCKSIZE \- rozmiar bloku systemu plików
.RE
.RE
.sp
Poniższe znaczniki są zawsze włączone
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
BLOCK_SIZE \- najmniejszy rozmiar bloku dostępny z systemu plików
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
MOUNT \- nazwa montowania klastra (tylko ocfs)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
EXT_JOURNAL \- UUID zewnętrznego dziennika
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SYSTEM_ID \- identyfikator systemu w ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
VOLUME_SET_ID \- identyfikator zbioru woluminów w ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
DATA_PREPARER_ID \- identyfikator danych w ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
PUBLISHER_ID \- identyfikator wydawcy w ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
APPLICATION_ID \- identyfikator programu w ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
BOOT_SYSTEM_ID \- identyfikator systemu rozruchowego w ISO9660
.RE
.RE
.SH "AUTORZY"
.sp
\fBlibblkid\fP napisał Andreas Dilger w ramach narzędzi systemu plików ext2, ze wskazówkami Teda Ts\(cqo. Biblioteka została następnie mocno zmieniona przez Teda Ts\(cqo.
.sp
Niskopoziomowy kod sprawdzania został przepisany przez Karela Zaka.
.SH "KOPIOWANIE"
.sp
\fBlibblkid\fP jest dostępny na warunkach licencji GNU Library General Public License (LGPL), w wersji 2 (lub dowolnie wybranej przez użytkownika wersji późniejszej).
.SH "ZOBACZ TAKŻE"
.sp
\fBblkid\fP(8), \fBfindfs\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
Biblioteka \fBlibblkid\fP jest częścią pakietu util\-linux od wersji 2.15. Można go pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."