BEZEICHNUNG

       libblkid - Bibliothek zur Identifizierung von blockorientierten Geräten

ÜBERSICHT

       #include <blkid.h>

       cc Datei.c -lblkid

BESCHREIBUNG

       Die Bibliothek libblkid wird zur Identifizierung von blockorientierten Geräten (Platten) im Hinblick auf
       deren Inhalt (z.B. Dateisystemtyp) und zum Ermitteln zusätzlicher Informationen wie Dateisystem- oder
       Datenträgerbezeichnungen, eindeutiger Kennzeichner oder Seriennummern verwendet. Ein häufiger
       Anwendungsfall ist, die Verwendung der Markierungen LABEL= und UUID= zu ermöglichen, anstatt spezifische
       Namen blockorientierter Geräte statisch in Konfigurationsdateien zu kodieren. Im Abschnitt MARKIERUNGEN
       finden Sie eine Liste aller verfügbaren Markierungen.

       Der systemnahe Teil der Bibliothek erlaubt außerdem die Ermittlung von Informationen zu Partitionen und
       der Topologie blockorientierter Geräte.

       Der anwendungsnahe Teil der Bibliothek hält Informationen zu blockorientierten Geräten in einer
       Zwischenspeicherdatei vor und wird verifiziert, um stets gültig zu sein, bevor die Rückgabe an den
       Benutzer erfolgt (nur falls der Benutzer lesenden Zugriff auf die blockorientierte Roh-Gerät hat,
       ansonsten nicht). Die Zwischenspeicherdatei ermöglicht auch unprivilegierten Benutzern (normalerweise
       allen außer »root« oder jenen, die nicht zur Gruppe »disk« gehören), Geräte nach Bezeichnung oder Kennung
       zu ermitteln. Der vorgegebene Ort der Zwischenspeicherdatei kann durch die Umgebungsvariable BLKID_FILE
       außer Kraft gesetzt werden.

       In Situationen, in denen es um die Ermittlung von Informationen zu einem einzelnen bekannten Gerät geht,
       wird die Performance nicht davon beeinflusst, ob die Zwischenspeicherdatei verwendet wird oder nicht (es
       sei denn, Sie sind nicht in der Lage, das blockorientierte Gerät direkt zu lesen).

       Der anwendungsnahe Teil der Bibliothek unterstützt zwei Methoden zur Ermittlung von LABEL bzw. UUID. Er
       liest Informationen direkt aus einem blockorientierten Gerät oder aus Udev-Symlinks der Form
       »/dev/disk/by-*«. Die Udev-Methode wird standardmäßig bevorzugt.

       Wenn Sie mit mehreren Geräten umgehen, wird die Verwendung des Zwischenspeichers ausdrücklich empfohlen
       (selbst wenn dieser leer ist), da Geräte höchstens einmalig eingelesen werden und der Zwischenspeicher
       auf der Platte aktualisiert wird, wenn möglich.

       In einigen Fällen (modulare Kernel) sind blockorientierte Geräte gar nicht sichtbar, bevor der erste
       Zugriff darauf erfolgt ist. Daher muss es einen Weg geben, diese Geräte zu ermitteln, ohne nur die
       sichtbaren Geräte aufzuzählen. So ist die Verwendung der Zwischenspeicherdatei in dieser Situation
       zwingend notwendig.

KONFIGURATIONSDATEI

       Der vorgegebene Ort der Konfigurationsdatei /etc/blkid.conf_ kann durch die Umgebungsvariable *BLKID_CONF
       außer Kraft gesetzt werden. Weitere Details zur Konfigurationsdatei finden Sie in der Handbuchseite zu
       blkid(8).

MARKIERUNGEN

       Alle verfügbaren Markierungen sind nachfolgend aufgelistet. Nicht jedes Dateisystem unterstützt alle
       Markierungen. Um eine Markierung zu aktivieren, setzen Sie einen der folgenden Schalter mit
       blkid_probe_set_superblocks_flags():

       BLKID_SUBLKS_TYPE

           •   TYP - Dateisystemtyp

       BLKID_SUBLKS_SECTYPE

           •   SEC_TYPE - sekundärer Dateisystemtyp

       BLKID_SUBLKS_LABEL

           •   LABEL - Dateisystembezeichnung

       BLKID_SUBLKS_LABELRAW

           •   LABEL_RAW - Rohbezeichnung aus dem Superblock des Dateisystems

       BLKID_SUBLKS_UUID

           •   UUID - Dateisystem-UUID (Kleinschreibung)

           •   UUID_SUB - Unterdatenträger-UUID (z.B. btrfs)

           •   LOGUUID - externe Protokoll-UUID (z.B. xfs)

       BLKID_SUBLKS_UUIDRAW

           •   UUID_RAW - Roh-UUID aus dem Superblock des Dateisystems

       BLKID_SUBLKS_USAGE

           •   USAGE - Aufrufzeichenkette: »raid«, »filesystem«, usw.

       BLKID_SUBLKS_VERSION

           •   VERSION - Dateisystemversion

       BLKID_SUBLKS_MAGIC

           •   SBMAGIC - Magic-Zeichenkette des Superblocks

           •   SBMAGIC_OFFSET - offset of SBMAGIC

       BLKID_SUBLKS_FSINFO

           •   FSSIZE - Größe des Dateisystems. Beachten Sie, dass dies für XFS den gleichen Wert wie lsblk(8)
               ausgibt (ohne die XFS-Metadaten), für Ext4 jedoch die Größe einschließlich Metadaten sowie für
               Btrfs den Overhead der RAID-Konfiguration nicht mitzählt (redundante Daten).

           •   FSLASTBLOCK - letzter Dateisystemblock / Gesamtanzahl der Dateisystemblöcke

           •   FSBLOCKSIZE - Blockgröße des Dateisystems

               Die folgenden Markierungen sind immer aktiviert

           •   BLOCK_SIZE - minimale Blockgröße, auf die das Dateisystem zugreifen kann

           •   MOUNT - Cluster-Einhängename (nur ocfs)

           •   EXT_JOURNAL - externe Journal-UUID

           •   SYSTEM_ID - ISO9660-Systembezeichner

           •   VOLUME_SET_ID - ISO9660-Datenträgersatzbezeichner

           •   DATA_PREPARER_ID - ISO9660-Datenbezeichner

           •   PUBLISHER_ID - ISO9660-Bezeichner des Veröffentlichers

           •   APPLICATION_ID - ISO9660-Anwendungsbezeichner

           •   BOOT_SYSTEM_ID - ISO9660-Bootsystem-Bezeichner

AUTOREN

       libblkid> wurde von Andreas Dilger für die Dienstprogramme des Ext2-Dateiystems mit Beiträgen von Ted
       Ts’o geschrieben. Die Bibliothek wurde in Folge von Ted Ts’o stark verändert.

       Der systemnahe Prüfcode wurde von Karel Zak neu geschrieben.

COPYING

       libblkid ist unter den Bedingungen der GNU Library General Public License (LGPL) verfügbar, entweder in
       Version 2, oder (nach Ihrem Ermessen) in jeder neueren Version.

SIEHE AUCH

       blkid(8), findfs(8)

FEHLER MELDEN

       Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf
       https://github.com/util-linux/util-linux/issues.

VERFÜGBARKEIT

       Die Bibliothek libblkid ist seit Version 2.15 Teil des Pakets util-linux, welches aus dem
       Linux-Kernel-Archiv <https://www.kernel.org/pub/linux/utils/util-linux/> heruntergeladen werden kann.

util-linux 2.39.3                                  2025-06-05                                        LIBBLKID(3)