Man page 3 : libblkid

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

#include <blkid.h>

cc fichier.c -lblkid

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.

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 tampon /etc/blkid.tab 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 tampon permet aux utilisateurs sans droit (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 tampon 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 fichier tampon 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 évaluer 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 fichier tampon est hautement recommandée (même s'il est vide) car les périphériques seront parcourus au plus une fois et le tampon sur le disque sera mis à jour si possible.

Dans certains cas (noyau modulaire), les périphériques bloc ne sont pas encore visibles tant qu'ils n'ont pas été accédés une première fois. Il est donc essentiel qu'il existe une façon de trouver ces périphériques sans énumérer seulement les périphériques visibles. Ainsi, l'utilisation du fichier tampon est nécessaire dans ce cas.

L'emplacement standard du fichier tampon /etc/blkid.conf peut être surchargé par la variable d'environnement BLKID_FILE. Les options suivantes contrôlent la bibliothèque libblkid :

• SEND_UEVENT=<yes|not>
      Envoyer « uevent » lorsque le lien symbolique /dev/disk/by-{label,uuid}/ ne correspond pas à l'étiquette LABEL ou l'identifiant UUID du périphérique. Par défaut à Oui.
• CACHE_FILE=<chemin>
      Surcharge l'emplacement du fichier de tampon. Cette option peut être surchargée par la variable d'environnement BLKID_FILE. Par défaut, /etc/blkid.tab.
• EVALUATE=<methodes>
      Définir la ou les méthodes d'évaluation des LABEL et UUID. Actuellement, libblkid gère les méthodes « udev » et « scan ». Plus d'une méthode peut être indiquée dans une liste séparée par des virgules. La valeur par défaut est « udev, scan ». La méthode « udev » utilise les liens symboliques /dev/disk/by-* et la méthode « scan » utilise les périphériques bloc depuis le fichier /proc/partitions.

libblkid a été écrite par Andreas Dilger pour les utilitaires du système de fichier ext2 avec des apports de Ted Ts'o. Elle a subi par la suite de modifications importantes de la part de Ted Ts'o. Le code de détection bas niveau a été réécrit par Karel Zak.

• /etc/blkid.tab
                    Données tampon extraites depuis chaque périphérique bloc reconnu.
• /etc/blkid.conf
      fichier de configuration

libblkid fait partie du paquet util-linux depuis la version 2.15, elle est disponible sur <URL:ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/>.

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

blkid(8), findfs(8)

La traduction de cette page de manuel est maintenue par les membres de la liste <debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.