'\" t
.\"     Title: libblkid
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-05-14
.\"    Manual: Programmierhandbuch
.\"    Source: util-linux 2.40.1
.\"  Language: English
.\"
.TH "LIBBLKID" "3" "2024-05-14" "util\-linux 2.40.1" "Programmierhandbuch"
.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 "BEZEICHNUNG"
libblkid \- Bibliothek zur Identifizierung von blockorientierten Geräten
.SH "ÜBERSICHT"
.sp
\fB#include <blkid.h>\fP
.sp
\fBcc\fP \fIfile.c\fP \fB\-lblkid\fP
.SH "BESCHREIBUNG"
.sp
Die Bibliothek \fBlibblkid\fP 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 \fBLABEL=\fP und \fBUUID=\fP zu ermöglichen, anstatt spezifische Namen blockorientierter Geräte statisch in Konfigurationsdateien zu kodieren. Im Abschnitt \fBMARKIERUNGEN\fP finden Sie eine Liste aller verfügbaren Markierungen.
.sp
Der systemnahe Teil der Bibliothek erlaubt außerdem die Ermittlung von Informationen zu Partitionen und der Topologie blockorientierter Geräte.
.sp
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 \fBBLKID_FILE\fP außer Kraft gesetzt werden.
.sp
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).
.sp
Der anwendungsnahe Teil der Bibliothek unterstützt zwei Methoden zur Ermittlung von \fBLABEL\fP bzw. \fBUUID\fP. 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.
.sp
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.
.sp
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 \fBzwingend notwendig\fP.
.SH "KONFIGURATIONSDATEI"
.sp
Der vorgegebene Ort der Konfigurationsdatei \fB/etc/blkid.conf_ kann durch die Umgebungsvariable *BLKID_CONF\fP außer Kraft gesetzt werden. Weitere Details zur Konfigurationsdatei finden Sie in der Handbuchseite zu \fBblkid\fP(8).
.SH "MARKIERUNGEN"
.sp
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 \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
.\}
TYP \- Dateisystemtyp
.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 \- sekundärer Dateisystemtyp
.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 \- Dateisystembezeichnung
.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 \- Rohbezeichnung aus dem Superblock des Dateisystems
.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 \- Dateisystem\-UUID (Kleinschreibung)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UUID_SUB \- Unterdatenträger\-UUID (z.B. btrfs)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
LOGUUID \- externe Protokoll\-UUID (z.B. 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 \- Roh\-UUID aus dem Superblock des Dateisystems
.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 \- Aufrufzeichenkette: »raid«, »filesystem«, usw.
.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 \- Dateisystemversion
.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 \- Magic\-Zeichenkette des Superblocks
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SBMAGIC_OFFSET \- offset of 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 \- Größe des Dateisystems. Beachten Sie, dass dies für XFS den gleichen Wert wie \fBlsblk\fP(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).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSLASTBLOCK \- letzter Dateisystemblock / Gesamtanzahl der Dateisystemblöcke
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSBLOCKSIZE \- Blockgröße des Dateisystems
.sp
Die folgenden Markierungen sind immer aktiviert
.RS 4
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
BLOCK_SIZE \- minimale Blockgröße, auf die das Dateisystem zugreifen kann
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
MOUNT \- Cluster\-Einhängename (nur ocfs)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
EXT_JOURNAL \- externe Journal\-UUID
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SYSTEM_ID \- ISO9660\-Systembezeichner
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
VOLUME_SET_ID \- ISO9660\-Datenträgersatzbezeichner
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
DATA_PREPARER_ID \- ISO9660\-Datenbezeichner
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
PUBLISHER_ID \- ISO9660\-Bezeichner des Veröffentlichers
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
APPLICATION_ID \- ISO9660\-Anwendungsbezeichner
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
BOOT_SYSTEM_ID \- ISO9660\-Bootsystem\-Bezeichner
.RE
.RE
.SH "AUTOREN"
.sp
\fBlibblkid\fP was written by Andreas Dilger for the ext2 filesystem utilities, with input from Ted Ts\(cqo. The library was subsequently heavily modified by Ted Ts\(cqo.
.sp
Der systemnahe Prüfcode wurde von Karel Zak neu geschrieben.
.SH "COPYING"
.sp
\fBlibblkid\fP is available under the terms of the GNU Library General Public License (LGPL), version 2 (or at your discretion any later version).
.SH "SIEHE AUCH"
.sp
\fBblkid\fP(8),
\fBfindfs\fP(8)
.SH "FEHLER MELDEN"
.sp
Nutzen Sie zum Melden von Fehlern das Fehlererfassungssystem auf \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "VERFÜGBARKEIT"
.sp
Die Bibliothek \fBlibblkid\fP ist seit Version 2.15 Teil des Pakets util\-linux, welches aus dem \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux\-Kernel\-Archiv" ""
heruntergeladen werden kann.