LIBBLKID(3) | Manuel du programmeur | LIBBLKID(3) |
NOM¶
libblkid - Bibliothèque d'identification de périphériques bloc
SYNOPSIS¶
#include <blkid.h>
cc fichier.c -lblkid
DESCRIPTION¶
La bibliothèque libblkid 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’un système de fichiers. Une utilisation courante est de permettre d’identifier un périphérique bloc par son étiquette (LABEL=) ou son identifiant unique (UUID=) en lieu et place d’un lien direct dans des fichiers de configuration. Consultez la liste des étiquettes disponibles dans la section ÉTIQUETTES.
La partie bas niveau de la bibliothèque permet aussi d’extraire les renseignements sur les partitions et la topologie de périphérique bloc.
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’être renvoyé à l’utilisateur (si l’utilisateur 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’appartenant pas au groupe « disk » et autres que le superutilisateur) de chercher des périphériques par étiquette ou identifiant. L’emplacement standard du fichier cache peut être surchargé par la variable d’environnement BLKID_FILE.
Dans le cas d’une récupération d’informations à propos d’un seul périphérique connu, que le cache soit utilisé ou non n’a pas d’impact sur les performances (à moins de pouvoir lire le périphérique bloc directement).
La partie haut niveau de la bibliothèque prend en charge deux méthodes pour déterminer l’étiquette ou l’UUID. Elle lit les renseignements directement sur le périphérique bloc ou dans les liens symboliques /dev/disk/by-* d’udev. La méthode udev est celle préférée par défaut.
Si plusieurs périphériques sont concernés, l’utilisation du cache est hautement recommandée (même s’il est vide) car les périphériques seront parcourus au plus une fois et le cache sur disque sera mis à jour si possible.
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’utilisation du fichier cache est nécessaire dans ce cas.
FICHIER DE CONFIGURATION¶
L’emplacement standard du fichier de configuration /etc/blkid.conf peut être remplacé par la variable d’environnement BLKID_CONF. Plus de précisions sur le fichier de configuration sont disponibles dans la page de manuel blkid(8).
ÉTIQUETTES¶
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 blkid_probe_set_superblocks_flags() :
BLKID_SUBLKS_TYPE
BLKID_SUBLKS_SECTYPE
BLKID_SUBLKS_LABEL
BLKID_SUBLKS_LABELRAW
BLKID_SUBLKS_UUID
BLKID_SUBLKS_UUIDRAW
BLKID_SUBLKS_USAGE
BLKID_SUBLKS_VERSION
BLKID_SUBLKS_MAGIC
BLKID_SUBLKS_FSINFO
Les étiquettes suivantes sont toujours disponibles
AUTEURS¶
libblkid a été écrite par Andreas Dilger pour les utilitaires du système de fichiers ext2 avec des apports de Ted Ts’o. Elle a subi par la suite des modifications importantes de la part de Ted Ts’o.
Le code de détection bas niveau a été réécrit par Karel Zak.
COPYRIGHT¶
libblkid 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).
VOIR AUSSI¶
SIGNALER DES BOGUES¶
Pour signaler un bogue, utilisez le gestionnaire de bogues sur <https://github.com/util-linux/util-linux/issues>.
DISPONIBILITɶ
La bibliothèque libblkid fait partie du paquet util-linux depuis la version 2.15. Elle est disponible sur l’archive du noyau Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.
2025-01-14 | util-linux 2.40.4 |