'\" t
.\"     Title: blkid
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Administration Système
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "BLKID" "8" "2024-04-27" "util\-linux 2.40" "Administration Système"
.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"
blkid \- Trouver ou afficher les attributs de périphérique en mode bloc
.SH "SYNOPSIS"
.sp
\fBblkid\fP \fB\-\-label\fP \fIlabel\fP | \fB\-\-uuid\fP \fIuuid\fP
.sp
\fBblkid\fP [\fB\-\-no\-encoding\fP \fB\-\-garbage\-collect\fP \fB\-\-list\-one\fP \fB\-\-cache\-file\fP \fIfile\fP] [\fB\-\-output\fP \fIformat\fP] [\fB\-\-match\-tag\fP \fItag\fP] [\fB\-\-match\-token\fP \fINAME=value\fP] [\fIdevice\fP...]
.sp
\fBblkid\fP \fB\-\-probe\fP [\fB\-\-offset\fP \fIoffset\fP] [\fB\-\-output\fP \fIformat\fP] [\fB\-\-size\fP \fIsize\fP] [\fB\-\-match\-tag\fP \fItag\fP] [\fB\-\-match\-types\fP \fIlist\fP] [\fB\-\-usages\fP \fIlist\fP] [\fB\-\-no\-part\-details\fP] \fIdevice\fP...
.sp
\fBblkid\fP \fB\-\-info\fP [\fB\-\-output format\fP] [\fB\-\-match\-tag\fP \fItag\fP] \fIdevice\fP...
.SH "DESCRIPTION"
.sp
Le programme \fBblkid\fP est une interface en ligne de commande pour la bibliothèque \fBlibblkid\fP(3). Il peut déterminer le type de contenu (par exemple, un système de fichiers ou une partition d\(cqéchange) associé à un périphérique bloc et aussi les attributs (sous la forme de jetons NOM=valeur) des métadonnées (par exemple, l\(cqétiquette LABEL ou l\(cqUUID).
.sp
\fBIt is recommended to use\fP \fBlsblk\fP(8) \fBcommand to get information about block devices, or lsblk \-\-fs to get an overview of filesystems, or\fP \fBfindmnt\fP(8) \fBto search in already mounted filesystems.\fP
.RS 3
.ll -.6i
.sp
\fBlsblk\fP(8) provides more information, better control on output formatting, easy to use in scripts and it does not require root permissions to get actual information. \fBblkid\fP reads information directly from devices and for non\-root users it returns cached unverified information. \fBblkid\fP is mostly designed for system services and to test \fBlibblkid\fP(3) functionality.
.br
.RE
.ll
.sp
Quand un \fIpériphérique\fP est indiqué, seuls les jetons pour ce \fIpériphérique\fP sont affichés. Plusieurs arguments \fIpériphérique\fP peuvent être indiqués sur la ligne de commande. Si aucun n\(cqest donné, tous les partitions et périphériques non partitionnés apparaissant dans \fI/proc/partitions\fP seront affichés, s\(cqils sont reconnus.
.sp
\fBblkid\fP has two main forms of operation: either searching for a device with a specific NAME=value pair, or displaying NAME=value pairs for one or more specified devices.
.sp
Pour des raisons de sécurité, \fBblkid\fP ignore silencieusement tous les périphériques quand le résultat des détections est ambivalent (plusieurs périphériques en conflit sont détectés). Le mode bas niveau (\fB\-p\fP) fournit plus d’informations et un code de retour supplémentaire. Il est recommandé d’utiliser \fBwipefs\fP(8) pour une vue d’ensemble détaillée et pour supprimer toutes les choses obsolètes (chaînes magiques) sur le périphérique.
.SH "OPTIONS"
.sp
Les arguments \fItaille\fP et \fIposition\fP peuvent être suivis de suffixes multiplicatifs comme KiB=1024, MiB=1024*1024, etc., pour GiB, TiB, PiB, EiB, ZiB et YiB (la partie « iB » est facultative, par exemple « K » est identique à « KiB ») ou des suffixes KB=1000, MB=1000*1000, etc., pour GB, TB, PB, EB, ZB et YB.
.sp
\fB\-c\fP, \fB\-\-cache\-file\fP \fIfichier_cache\fP
.RS 4
Read from \fIcachefile\fP instead of reading from the default cache file (see the \fBCONFIGURATION FILE\fP section for more details). If you want to start with a clean cache (i.e., don\(cqt report devices previously scanned but not necessarily available at this time), specify \fI/dev/null\fP.
.RE
.sp
\fB\-d\fP, \fB\-\-no\-encoding\fP
.RS 4
Ne pas encoder les caractères non imprimables. Les caractères non imprimables sont encodés par les notations ^ et M\- par défaut. Remarquez que le format de sortie \fB\-\-output udev\fP utilise un encodage différent qui ne peut pas être désactivé.
.RE
.sp
\fB\-D\fP, \fB\-\-no\-part\-details\fP
.RS 4
Ne pas afficher d’information (indicateurs PART_ENTRY_*) de la table de partitions dans le mode de détection bas niveau.
.RE
.sp
\fB\-g\fP, \fB\-\-garbage\-collect\fP
.RS 4
Lancer le ramasse\-miettes sur le cache de \fBblkid\fP pour supprimer les périphériques qui n\(cqexistent plus.
.RE
.sp
\fB\-H\fP, \fB\-\-hint\fP \fIsetting\fP
.RS 4
Set probing hint. The hints are an optional way to force probing functions to check, for example, another location. The currently supported is "session_offset=\fInumber\fP" to set session offset on multi\-session UDF.
.RE
.sp
\fB\-i\fP, \fB\-\-info\fP
.RS 4
Afficher les renseignements de limites (topologie) d\(cqE/S. Le format de sortie \fBexport\fP est automatiquement activé. Cette option peut être utilisée avec l\(cqoption \fB\-\-probe\fP.
.RE
.sp
\fB\-k\fP, \fB\-\-list\-filesystems\fP
.RS 4
Afficher tous les systèmes de fichiers et RAID connus et quitter.
.RE
.sp
\fB\-l\fP, \fB\-\-list\-one\fP
.RS 4
Ne rechercher qu’un périphérique correspondant au paramètre demandé indiqué avec l\(cqoption \fB\-\-match\-token\fP. Si plusieurs périphériques correspondent, le périphérique de priorité la plus haute sera affiché ou le premier périphérique avec la priorité voulue (mais consultez ci\-dessous la remarque sur udev). Voici les types de périphériques par priorité décroissante : Device Mapper, EVMS, LVM, MD, puis les périphériques bloc classiques. Si cette option n\(cqest pas utilisée, \fBblkid\fP affichera tous les périphériques qui correspondent à la recherche.
.sp
Cette option oblige \fBblkid\fP à utiliser les jetons LABEL ou UUID dans \fB\-\-match\-token\fP. Le but est de fournir une sortie cohérente avec celle d’autres outils (tel \fBmount\fP(8), etc.) sur les systèmes où le même indicateur est utilisé pour plusieurs périphériques.
.RE
.sp
\fB\-L\fP, \fB\-\-label\fP \fIétiquette\fP
.RS 4
Rechercher le périphérique qui utilise cette \fIétiquette\fP de système de fichiers ; c’est équivalent à : \fB\-\-list\-one \-\-output device \-\-match\-token LABEL=\fP\fIétiquette\fP. Cette méthode de recherche est capable d\(cqutiliser de manière fiable les liens symboliques udev du type /dev/disk/by\-label (suivant une configuration définie dans \fI/etc/blkid.conf\fP). Évitez d\(cqutiliser directement les liens symboliques, car leur utilisation n’est pas sûre sans vérification. L\(cqoption \fB\-\-label\fP fonctionne sur des systèmes avec ou sans udev.
.sp
Malheureusement, le \fBblkid\fP(8) d\(cqorigine d\(cqe2fsprogs utilise l\(cqoption \fB\-L\fP comme synonyme de \fB\-o list\fP. Pour assurer la portabilité, l\(cqutilisation de \fB\-l \-o device \-t LABEL=\fP\fIétiquette\fP et B*\-o list* est à préférer dans les scripts à l\(cqoption \fB\-L\fP.
.RE
.sp
\fB\-n\fP, \fB\-\-match\-types\fP \fIliste\fP
.RS 4
Restreindre les fonctions de détection à la \fIliste\fP séparée par des virgules de types (noms) de superblocs. Les types peuvent être préfixés dans la liste par \fBno\fP pour signifier qu\(cqils doivent être ignorés. Par exemple :
.sp
\fBblkid \-\-probe \-\-match\-types vfat,ext3,ext4 /dev/sda1\fP
.sp
détecte les systèmes de fichiers VFAT, ext3 et ext4, et
.sp
\fBblkid \-\-probe \-\-match\-types nominix /dev/sda1\fP
.sp
détecte tous les formats gérés sauf les systèmes de fichiers MINIX. Cette option n\(cqest utile qu\(cqavec l\(cqoption \fB\-\-probe\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIformat\fP
.RS 4
Utiliser le format de sortie indiqué. Remarquez que l’ordre des variables et des périphériques n’est pas fixé. Consultez également l’option \fB\-s\fP. Le paramètre \fIformat\fP peut prendre une des valeurs suivantes :
.sp
\fBfull\fP
.RS 4
Afficher tous les indicateurs (option par défaut).
.RE
.sp
\fBvalue\fP
.RS 4
Afficher la valeur des indicateurs.
.RE
.sp
\fBlist\fP
.RS 4
Afficher les périphériques dans un format agréable. Ce format d\(cqaffichage n\(cqest pas pris en charge pour la détection bas niveau (\fB\-\-probe\fP ou \fB\-\-info\fP).
.sp
Ce format d’affichage est \fBobsolète\fP, remplacé par la commande \fBlsblk\fP(8).
.RE
.sp
\fBpériphérique\fP
.RS 4
Afficher seulement le nom de périphérique. Ce format d\(cqaffichage est toujours activé pour les options \fB\-\-label\fP et \fB\-\-uuid\fP.
.RE
.sp
\fBudev\fP
.RS 4
Afficher les paires clé="valeur" pour une importation aisée dans l’environnement udev. Les clés sont préfixées avec ID_FS_ ou ID_PART_. La valeur peut être modifiée pour être sûre dans l’environnement udev. Sont permises l’ASCII pur, la protection par valeur hexadécimale et l’UTF\-8 valable. Toutes les autres valeurs (y compris les espaces blancs) sont remplacées par « _ ». Les clés avec le suffixe \fI_ENC\fP utilisent la protection hexadécimale pour les caractères non sûrs.
.sp
La sortie udev renvoie l\(cqindicateur ID_FS_AMBIVALENT si plusieurs superblocs sont détectés et des indicateurs ID_PART_ENTRY_* sont toujours renvoyés pour toutes les partitions, y compris les partitions vides.
.sp
Ce format d’affichage est \fBobsolète\fP.
.RE
.sp
\fBexport\fP
.RS 4
Afficher les couples de clé=valeur pour les importer facilement dans l\(cqenvironnement. Ce format de sortie est automatiquement activé quand des limites d\(cqE/S (option \fB\-\-info\fP) sont demandées.
.sp
Les caractères non imprimables sont encodés par les notations ^ et M\- et tous les caractères potentiellement non sûrs sont protégés.
.RE
.RE
.sp
\fB\-O\fP, \fB\-\-offset\fP \fIposition\fP
.RS 4
Détecter à la \fIposition\fP donnée (seulement utile avec \fB\-\-probe\fP). Cette option peut être utilisée avec l\(cqoption \fB\-\-info\fP.
.RE
.sp
\fB\-p\fP, \fB\-\-probe\fP
.RS 4
Passer en mode de détection bas niveau de superbloc (en contournant le cache).
.sp
Remarquez que la détection bas niveau renvoie aussi des informations sur le type de table de partitions (indicateur PTTYPE) et sur les partitions (indicateurs PART_ENTRY_*). Les noms d’indicateurs produits par la détection bas niveau sont basés sur les noms utilisés en interne par libblkid et peuvent être différents lorsqu’elle est exécutée sans \fB\-\-probe\fP (par exemple, PART_ENTRY_UUID= vs PARTUUID=). Consultez aussi \fB\-\-no\-part\-details\fP.
.RE
.sp
\fB\-s\fP, \fB\-\-match\-tag\fP \fIindicateur\fP
.RS 4
Pour chaque périphérique indiqué, n\(cqafficher que les indicateurs qui correspondent à \fIindicateur\fP. L\(cqoption \fB\-\-match\-tag\fP peut être indiquée plusieurs fois. Si aucun indicateur n\(cqest indiqué, tous les jetons sont affichés pour tous les périphériques indiqués. Pour ne faire que rafraîchir le cache sans afficher de jeton, utilisez \fB\-\-match\-tag none\fP sans aucune autre option.
.RE
.sp
\fB\-S\fP, \fB\-\-size\fP \fItaille\fP
.RS 4
Remplacer la taille du périphérique ou du fichier (seulement utile avec \fB\-\-probe\fP).
.RE
.sp
\fB\-t\fP, \fB\-\-match\-token\fP \fINOM=valeur\fP
.RS 4
Rechercher les périphériques bloc qui possèdent des jetons nommés \fINOM\fP et qui ont pour valeur \fIvaleur\fP, puis afficher les périphériques trouvés. Les valeurs usuelles de \fINOM\fP sont \fBTYPE\fP, \fBLABEL\fP et \fBUUID\fP. S\(cqil n\(cqy a pas de périphérique précisé sur la ligne de commande, tous les périphériques bloc seront analysés ; sinon, seuls les périphériques indiqués par l\(cqutilisateur seront étudiés.
.RE
.sp
\fB\-u\fP, \fB\-\-usages\fP \fIliste\fP
.RS 4
Restreindre les fonctions de détection à la \fIliste\fP séparée par des virgules de types d\*(Aq« utilisation ». Les types d\(cqutilisation gérés sont : filesystem (système de fichiers), raid (RAID), crypto (chiffré) et other (autre). Les types d\(cqutilisation peuvent être préfixés dans la liste par \fBno\fP pour signifier qu\(cqils doivent être ignorés. Par exemple :
.sp
\fBblkid \-\-probe \-\-usages filesystem,other /dev/sda1\fP
.sp
détecte tous les formats de systèmes de fichiers et autres (par exemple, les espaces d\(cqéchange) et
.sp
\fBblkid \-\-probe \-\-usages noraid /dev/sda1\fP
.sp
détecte tous les formats gérés sauf les RAID. Cette option n\(cqest utile qu\(cqavec l\(cqoption \fB\-\-probe\fP.
.RE
.sp
\fB\-U\fP, \fB\-\-uuid\fP \fIUUID\fP
.RS 4
Chercher le périphérique qui utilise cet \fIUUID\fP de système de fichiers. Pour plus de précisions, consultez l\(cqoption \fB\-\-label\fP.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afficher l’aide\-mémoire puis quitter.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afficher le numéro de version et quitter.
.RE
.SH "CODE DE RETOUR"
.sp
Si le périphérique indiqué ou celui adressé par l’indicateur précisé (option \fB\-\-match\-token\fP) a été trouvé et qu’il est possible de réunir quelques informations à son propos, un code de retour 0 est renvoyé. Remarquez que l’option \fB\-\-match\-tag\fP filtre les indicateurs de sortie, mais qu’elle n’affecte pas le code de retour.
.sp
Si le jeton indiqué n\(cqa pas été trouvé, ou si aucun périphérique (indiqué) n\(cqa pu être identifié, ou qu’il est impossible d’obtenir une information sur les identificateurs ou le contenu de périphérique, un code de retour 2 est renvoyé.
.sp
Pour les erreurs d\(cqutilisation et autres, un code de retour 4 est renvoyé.
.sp
Si un résultat de détection bas niveau ambivalent a été détecté (\fB\-p\fP), un code de retour 8 est renvoyé.
.SH "FICHIER DE CONFIGURATION"
.sp
The standard location of the \fI/etc/blkid.conf\fP config file can be overridden by the environment variable \fBBLKID_CONF\fP. The following options control the libblkid library:
.sp
\fISEND_UEVENT=<yes|not>\fP
.RS 4
Envoyer « uevent » lorsque le lien symbolique _/dev/disk/by\-{label,uuid,partuuid,partlabel}/ ne correspond pas au LABEL, UUID, PARTUUID ou PARTLABEL du périphérique. \fByes\fP par défaut.
.RE
.sp
\fICACHE_FILE=<chemin>\fP
.RS 4
Remplacer l\(cqemplacement standard du fichier de cache. Cette option peut être remplacée par la variable d\(cqenvironnement \fBBLKID_FILE\fP. \fI/run/blkid/blkid.tab\fP par défaut ou \fI/etc/blkid.tab\fP sur les systèmes sans répertoire \fI/run\fP.
.RE
.sp
\fIEVALUATE=<méthodes>\fP
.RS 4
Définir la ou les méthodes d\(cqévaluation des LABEL et UUID. Actuellement, libblkid gère les méthodes « udev » et « scan ». Plus d\(cqune 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 \fI/dev/disk/by\-\fB\fP d’*udev\fP et la méthode « scan » analyse tous les périphériques bloc du fichier \fI/proc/partitions\fP.
.RE
.SH "ENVIRONNEMENT"
.sp
La configuration \fILIBBLKID_DEBUG=all\fP active la sortie de débogage.
.SH "AUTEURS"
.sp
\fBblkid\fP was written by Andreas Dilger for libblkid and improved by Theodore Ts\(cqo and Karel Zak.
.SH "VOIR AUSSI"
.sp
\fBlibblkid\fP(3),
\fBfindfs\fP(8),
\fBlsblk\fP(8),
\fBwipefs\fP(8)
.SH "SIGNALER DES BOGUES"
.sp
Pour signaler un bogue, utilisez le gestionnaire de bogues sur \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "DISPONIBILITÉ"
.sp
La commande \fBblkid\fP fait partie du paquet util\-linux, elle est disponible sur \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "l’archive du noyau Linux" "."