LIBBLKID(3) Manuel du programmeur LIBBLKID(3) NOM libblkid - Bibliotheque d'identification de peripheriques bloc SYNOPSIS #include cc fichier.c -lblkid DESCRIPTION La bibliotheque libblkid est utilisee pour identifier les peripheriques bloc a leur contenu (par exemple un type de systeme de fichiers), pour extraire des informations additionnelles comme les noms de volumes, les etiquettes, les identifiants uniques, les numeros de serie d'un systeme de fichiers. Une utilisation courante est de permettre d'identifier un peripherique bloc par son etiquette (LABEL=) ou son identifiant unique (UUID=) en lieu et place d'un lien direct dans des fichiers de configuration. Consultez la liste des etiquettes disponibles dans la section ETIQUETTES. La partie bas niveau de la bibliotheque permet aussi d'extraire les renseignements sur les partitions et la topologie de peripherique bloc. La partie haut niveau de la bibliotheque garde les renseignements sur les peripheriques bloc dans un fichier cache dont la validite est verifiee avant d'etre renvoye a l'utilisateur (si l'utilisateur a les permissions de lecture sur le peripherique 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 peripheriques par etiquette ou identifiant. L'emplacement standard du fichier cache peut etre surcharge par la variable d'environnement BLKID_FILE. Dans le cas d'une recuperation d'informations a propos d'un seul peripherique connu, que le cache soit utilise ou non n'a pas d'impact sur les performances (a moins de pouvoir lire le peripherique bloc directement). La partie haut niveau de la bibliotheque prend en charge deux methodes pour determiner l'etiquette ou l'UUID. Elle lit les renseignements directement sur le peripherique bloc ou dans les liens symboliques /dev/disk/by-* d'udev. La methode udev est celle preferee par defaut. Si plusieurs peripheriques sont concernes, l'utilisation du cache est hautement recommandee (meme s'il est vide) car les peripheriques seront parcourus au plus une fois et le cache sur disque sera mis a jour si possible. Dans certains cas (noyau modulaire), les peripheriques bloc ne sont pas visibles avant d'avoir ete accedes une premiere fois. Une facon de trouver ces peripheriques sans enumerer seulement les peripheriques visibles est donc primordiale. Ainsi, l'utilisation du fichier cache est necessaire dans ce cas. FICHIER DE CONFIGURATION L'emplacement standard du fichier de configuration /etc/blkid.conf peut etre remplace par la variable d'environnement BLKID_CONF. Plus de precisions sur le fichier de configuration sont disponibles dans la page de manuel blkid(8). ETIQUETTES Toutes les etiquettes disponibles sont listees ci-dessous. Toutes les etiquettes ne sont pas supportees par tous les systemes de fichiers. Pour activer une etiquette, activez un des fanions suivants avec blkid_probe_set_superblocks_flags() : BLKID_SUBLKS_TYPE o TYPE - type de systeme de fichier BLKID_SUBLKS_SECTYPE o SEC_TYPE - type de systeme de fichier secondaire BLKID_SUBLKS_LABEL o LABEL - etiquette du systeme de fichier BLKID_SUBLKS_LABELRAW o LABEL_RAW - etiquette brute du superbloc du systeme de fichier BLKID_SUBLKS_UUID o UUID - UUID du systeme de fichier (en minuscules) o UUID_SUB - uuid du sous-volume (par ex. btrfs) o LOGUUID - external log UUID (e.g. xfs) BLKID_SUBLKS_UUIDRAW o UUID_RAW - UUID brut du superbloc du systeme de fichier BLKID_SUBLKS_USAGE o USAGE - chaine d'utilisation : << raid >>, << filesystem >>, etc. BLKID_SUBLKS_VERSION o VERSION - version du systeme de fichier BLKID_SUBLKS_MAGIC o SBMAGIC - chaine magique du super bloc o SBMAGIC_OFFSET - offset de SBMAGIC BLKID_SUBLKS_FSINFO o FSSIZE - taille du systeme de fichiers. Notez que pour XFS, la meme valeur que lsblk est retournee (sans les meta-donnees de XFS) mais pour ext4, la taille avec meta-donnees est retournee et pour BTRFS, le supplement de la configuration RAID est compte (donnees redondantes). o FSLASTBLOCK - dernier fsblock/nombre total de fsblocks o FSBLOCKSIZE - taille de bloc du systeme de fichiers Les etiquettes suivantes sont toujours disponibles o BLOCK_SIZE - taille de bloc minimale accessible par le systeme de fichiers o MOUNT - nom de montage du cluster (uniquement pour ocfs) o EXT_JOURNAL - UUID du journal externe o SYSTEM_ID - identificateur systeme ISO9660 o VOLUME_SET_ID - identificateur ISO9660 d'ensemble de volume o DATA_PREPARER_ID - identificateur ISO9660 des donnees o PUBLISHER_ID - identificateur ISO9660 de l'editeur o APPLICATION_ID - identificateur ISO9660 de l'application o BOOT_SYSTEM_ID - identificateur ISO9660 du systeme d'amorcage AUTEURS libblkid a ete ecrite par Andreas Dilger pour les utilitaires du systeme 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 detection bas niveau a ete reecrit par Karel Zak. COPYRIGHT libblkid est disponible selon les termes de la licence GNU Library General Public Licence (LGPL), version 2 (ou selon vos preferences, toute version plus recente). VOIR AUSSI blkid(8), findfs(8) SIGNALER DES BOGUES Pour signaler un bogue, utilisez le gestionnaire de bogues . DISPONIBILITE La bibliotheque libblkid fait partie du paquet util-linux depuis la version 2.15. Elle est disponible sur l'archive du noyau Linux . util-linux 2.41 2025-03-29 LIBBLKID(3)