LIBBLKID(3)

NOM
libblkid - Bibliothèque d'identification de périphériques bloc

SYNOPSIS

#include <blkid.h>

cc file.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

        • TYPE - type de système de fichier

BLKID_SUBLKS_SECTYPE

        • SEC_TYPE - type de système de fichier secondaire

BLKID_SUBLKS_LABEL

        • LABEL - étiquette du système de fichier

BLKID_SUBLKS_LABELRAW

        • LABEL_RAW - étiquette brute du superbloc du système de fichier

BLKID_SUBLKS_UUID

        • UUID - UUID du système de fichier (en minuscules)

        • UUID_SUB - uuid du sous-volume (par ex. btrfs)

        • LOGUUID - external log UUID (e.g. xfs)

BLKID_SUBLKS_UUIDRAW

        • UUID_RAW - UUID brut du superbloc du système de fichier

BLKID_SUBLKS_USAGE

        • USAGE - chaîne d’utilisation : « raid », « filesystem », etc.

BLKID_SUBLKS_VERSION

        • VERSION - version du système de fichier

BLKID_SUBLKS_MAGIC

        • SBMAGIC - chaîne magique du super bloc

        • SBMAGIC_OFFSET - offset de SBMAGIC

BLKID_SUBLKS_FSINFO

        • 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).

        • FSLASTBLOCK - dernier fsblock/nombre total de fsblocks

        • FSBLOCKSIZE - taille de bloc du système de fichiers

Les étiquettes suivantes sont toujours disponibles

        • BLOCK_SIZE - taille de bloc minimale accessible par le système de fichiers

        • MOUNT - nom de montage du cluster (uniquement pour ocfs)

        • EXT_JOURNAL - UUID du journal externe

        • SYSTEM_ID - identificateur système ISO9660

        • VOLUME_SET_ID - identificateur ISO9660 d’ensemble de volume

        • DATA_PREPARER_ID - identificateur ISO9660 des données

        • PUBLISHER_ID - identificateur ISO9660 de l’éditeur

        • APPLICATION_ID - identificateur ISO9660 de l’application

        • BOOT_SYSTEM_ID - identificateur ISO9660 du système d’amorçage

AUTEURS

libblkid was written by Andreas Dilger for the ext2 filesystem utilities, with input from Ted Ts’o. The library was subsequently heavily modified by Ted Ts’o.

Le code de détection bas niveau a été réécrit par Karel Zak.

COPYRIGHT

libblkid is available under the terms of the GNU Library General Public License (LGPL), version 2 (or at your discretion any later version).

VOIR AUSSI

blkid(8), findfs(8)

SIGNALER DES BOGUES

Pour signaler un bogue, utilisez le gestionnaire de bogues sur

DISPONIBILITÉ

La bibliothèque libblkid fait partie du paquet util-linux depuis la version 2.15. Elle est disponible sur