'\" t
.\"     Title: libblkid
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-03-29
.\"    Manual: Manuel du programmeur
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "LIBBLKID" "3" "2025-03-29" "util\-linux 2.41" "Manuel du programmeur"
.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 "NOM"
libblkid \- Bibliothèque d\*(Aqidentification de périphériques bloc
.SH "SYNOPSIS"
.sp
\fB#include <blkid.h>\fP
.sp
\fBcc\fP \fIfichier.c\fP \fB\-lblkid\fP
.SH "DESCRIPTION"
.sp
La bibliothèque \fBlibblkid\fP est utilisée pour identifier les périphériques bloc à leur contenu (par exemple un type de système de fichiers), pour extraire des informations additionnelles comme les noms de volumes, les étiquettes, les identifiants uniques, les numéros de série d\(cqun système de fichiers. Une utilisation courante est de permettre d\(cqidentifier un périphérique bloc par son étiquette (\fBLABEL=\fP) ou son identifiant unique (\fBUUID=\fP) en lieu et place d\(cqun lien direct dans des fichiers de configuration. Consultez la liste des étiquettes disponibles dans la section \fBÉTIQUETTES\fP.
.sp
La partie bas niveau de la bibliothèque permet aussi d\(cqextraire les renseignements sur les partitions et la topologie de périphérique bloc.
.sp
La partie haut niveau de la bibliothèque garde les renseignements sur les périphériques bloc dans un fichier cache dont la validité est vérifiée avant d\(cqêtre renvoyé à l\(cqutilisateur (si l\(cqutilisateur a les permissions de lecture sur le périphérique bloc brut, sinon, non). Le fichier cache permet aux utilisateurs ordinaires (tous les utilisateurs n\(cqappartenant pas au groupe « disk » et autres que le superutilisateur) de chercher des périphériques par étiquette ou identifiant. L\(cqemplacement standard du fichier cache peut être surchargé par la variable d\(cqenvironnement \fBBLKID_FILE\fP.
.sp
Dans le cas d\(cqune récupération d\(cqinformations à propos d\(cqun seul périphérique connu, que le cache soit utilisé ou non n\(cqa pas d\(cqimpact sur les performances (à moins de pouvoir lire le périphérique bloc directement).
.sp
La partie haut niveau de la bibliothèque prend en charge deux méthodes pour déterminer l\(cqétiquette ou l\(cqUUID. Elle lit les renseignements directement sur le périphérique bloc ou dans les liens symboliques /dev/disk/by\-* d\(cqudev. La méthode udev est celle préférée par défaut.
.sp
Si plusieurs périphériques sont concernés, l\(cqutilisation du cache est hautement recommandée (même s\(cqil est vide) car les périphériques seront parcourus au plus une fois et le cache sur disque sera mis à jour si possible.
.sp
Dans certains cas (noyau modulaire), les périphériques bloc ne sont pas visibles avant d’avoir été accédés une première fois. Une façon de trouver ces périphériques sans énumérer seulement les périphériques visibles est donc primordiale. Ainsi, l\(cqutilisation du fichier cache est \fBnécessaire\fP dans ce cas.
.SH "FICHIER DE CONFIGURATION"
.sp
L\(cqemplacement standard du fichier de configuration \fI/etc/blkid.conf\fP peut être remplacé par la variable d\(cqenvironnement \fBBLKID_CONF\fP. Plus de précisions sur le fichier de configuration sont disponibles dans la page de manuel \fBblkid\fP(8).
.SH "ÉTIQUETTES"
.sp
Toutes les étiquettes disponibles sont listées ci\-dessous. Toutes les étiquettes ne sont pas supportées par tous les systèmes de fichiers. Pour activer une étiquette, activez un des fanions suivants avec \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 \- type de système de fichier
.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 \- type de système de fichier secondaire
.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 \- étiquette du système de fichier
.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 \- étiquette brute du superbloc du système de fichier
.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 du système de fichier (en minuscules)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UUID_SUB \- uuid du sous\-volume (par ex. btrfs)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
LOGUUID \- external log UUID (e.g. 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 \- UUID brut du superbloc du système de fichier
.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 \- chaîne d\(cqutilisation : « raid », « filesystem », etc.
.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 \- version du système de fichier
.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 \- chaîne magique du super bloc
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SBMAGIC_OFFSET \- offset de 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 \- taille du système de fichiers. Notez que pour XFS, la même valeur que lsblk est retournée (sans les méta\-données de XFS) mais pour ext4, la taille avec méta\-données est retournée et pour BTRFS, le supplément de la configuration RAID est compté (données redondantes).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSLASTBLOCK \- dernier fsblock/nombre total de fsblocks
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSBLOCKSIZE \- taille de bloc du système de fichiers
.RE
.RE
.sp
Les étiquettes suivantes sont toujours disponibles
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
BLOCK_SIZE \- taille de bloc minimale accessible par le système de fichiers
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
MOUNT \- nom de montage du cluster (uniquement pour ocfs)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
EXT_JOURNAL \- UUID du journal externe
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SYSTEM_ID \- identificateur système ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
VOLUME_SET_ID \- identificateur ISO9660 d\(cqensemble de volume
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
DATA_PREPARER_ID \- identificateur ISO9660 des données
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
PUBLISHER_ID \- identificateur ISO9660 de l\(cqéditeur
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
APPLICATION_ID \- identificateur ISO9660 de l\(cqapplication
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
BOOT_SYSTEM_ID \- identificateur ISO9660 du système d\(cqamorçage
.RE
.RE
.SH "AUTEURS"
.sp
\fBlibblkid\fP a été écrite par Andreas Dilger pour les utilitaires du système de fichiers ext2 avec des apports de Ted Ts\(cqo. Elle a subi par la suite des modifications importantes de la part de Ted Ts\(cqo.
.sp
Le code de détection bas niveau a été réécrit par Karel Zak.
.SH "COPYRIGHT"
.sp
\fBlibblkid\fP est disponible selon les termes de la licence GNU Library General Public Licence (LGPL), version 2 (ou selon vos préférences, toute version plus récente).
.SH "VOIR AUSSI"
.sp
\fBblkid\fP(8), \fBfindfs\fP(8)
.SH "SIGNALER DES BOGUES"
.sp
Pour signaler un bogue, utilisez le \c
.URL "https://github.com/util\-linux/util\-linux/issues" "gestionnaire de bogues" "."
.SH "DISPONIBILITÉ"
.sp
La bibliothèque \fBlibblkid\fP fait partie du paquet util\-linux depuis la version 2.15. Elle est disponible sur \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "l’archive du noyau Linux" "."