Au-delà de Linux® From Scratch (édition System V) - Version 12.0

Chapitre 5. Systèmes de fichiers et gestion de disque

btrfs-progs-6.3.3

Introduction à btrfs-progs

Le paquet btrfs-progs contient les outils d'administration et de débogage pour le système de fichier en B-arbre (btrfs).

This package is known to build and work properly using an LFS 12.0 platform.

Informations sur le paquet

  • Téléchargement (HTTP) : https://www.kernel.org/pub/linux/kernel/people/kdave/btrfs-progs/btrfs-progs-v6.3.3.tar.xz

  • Téléchargement (FTP) :

  • Somme de contrôle MD5 : 1b5705b3e9503f09a9598dad1e7bfbc8

  • Taille du téléchargement : 3,0 Mo

  • Estimation de l'espace disque requis : 62 Mo (les fichiers temporaires créés pendant les tests ont besoin de jusqu'à 10 Go)

  • Estimation du temps de construction : 0,2 SBU (plus 3,8 SBU pour les tests, jusqu'à 80 SBU sur des disques lents si reiserfsprogs est installé)

Dépendances de Btrfs-progs

Requises

LZO-2.10

Facultatives

LVM2-2.03.22 (dmsetup est utilisé dans les tests), reiserfsprogs-3.6.27 (pour les tests) et sphinx-7.1.2 (requis pour construire la documentation)

Configuration du noyau

Activez les options suivantes dans la configuration du noyau et recompilez le noyau : 

File systems --->
  <*/M> Btrfs filesystem support                                      [BTRFS_FS]

En plus de ce qui précède et des options requises pour LVM2-2.03.22 et reiserfsprogs-3.6.27, les options suivantes doivent être activées pour lancer les tests : 

File systems --->
  <*/M> Reiserfs support (deprecated)                              [REISERFS_FS]
  [*]     ReiserFS extended attributes                       [REISERFS_FS_XATTR]
  [*]       ReiserFS POSIX Access Control Lists          [REISERFS_FS_POSIX_ACL]
  <*/M> Btrfs filesystem support                                      [BTRFS_FS]
  [*]     Btrfs POSIX Access Control Lists                  [BTRFS_FS_POSIX_ACL]

Installation de btrfs-progs

Installez btrfs-progs en exécutant les commandes suivantes : 

./configure --prefix=/usr           \
            --disable-static        \
            --disable-documentation &&
make
[Note]

Note

Certains tests ont besoin de grep construit avec les expressions régulières de perl. Pour cela, reconstruisez grep avec les instruction du chapitre 8 de LFS après avoir installé pcre2-10.42.

Avant de lancer les tests, construisez un programme support : 

make fssum

Pour tester les résultats, lancez (en tant qu'utilisateur root) : 

pushd tests
   ./fsck-tests.sh
   ./mkfs-tests.sh
   ./cli-tests.sh
   sed 's/,orphan_file//' /etc/mke2fs.conf >./custom_mke2fs.conf &&
   export MKE2FS_CONFIG=$PWD/custom_mke2fs.conf                  &&
   ./convert-tests.sh
   unset MKE2FS_CONFIG && rm custom_mke2fs.conf
   ./misc-tests.sh
   ./fuzz-tests.sh
popd
[Note]

Note

Si les options du noyau mentionnées plus haut ne sont pas activées, certains tests échouent, et empêchent tous les autres tests de se lancer, parce que l'image disque de test n'est pas démontée proprement.

Installez le paquet en tant qu'utilisateur root : 

make install

Si vous avez passé --disable-documentation à configure et avez besoin des pages de manuel, installez-les en exécutant, en tant qu'utilisateur root : 

for i in 5 8; do
   install Documentation/*.$i /usr/share/man/man$i
done

Explication des commandes

--disable-static : Ce paramètre empêche l'installation des versions statiques des bibliothèques.

--disable-documentation : ce paramètre désactive la reconstruction des pages de manuel car il nécessite sphinx-7.1.2.

sed 's/,orphan_file//" ... : dans cette version de btrfs-progs, le programme btrfs-convert produit un système de fichiers btrfs qui contient des erreurs si vous convertissez depuis un système de fichiers ext4 créé avec la fonctionnalité « orphan_file ». Cette commande crée un fichier de configuration personnalisé qui empêche de créer un système de fichiers avec cette fonctionnalité.

Utiliser le programme btrfs-convert

Cette version de btrfs-progs ne convertit pas correctement les systèmes de fichiers ext4 en btrfs si la fonctionnalité ext4 orphan_file est activée. Si vous devez convertir un tel système de fichiers, vous devez d'abord exécuter : 

tune2fs -O ^orphan_file /dev/sdxx

où /dev/sdxx est la partition du système de fichiers que vous voulez convertir.

Contents

Programmes installés: btrfs, btrfs-convert, btrfs-find-root, btrfs-image, btrfs-map-logical, btrfs-select-super, btrfsck (lien vers btrfs), btrfstune, fsck.btrfs et mkfs.btrfs
Bibliothèques installées: libbtrfs.so et libbtrfsutil.so
Répertoires installés: /usr/include/btrfs

Descriptions courtes

btrfs

est l'interface principale dans les opérations du système de fichiers btrfs

btrfs-convert

convertit un système de fichier depuis ext2/3/4 ou reiserfs vers btrfs (voir la section intitulée « Utiliser le programme btrfs-convert » plus haut)

btrfs-find-root

est un filtre pour trouver la racine btrfs

btrfs-map-logical

relie les espaces logiques btrfs aux espaces physiques

btrfs-select-super

écrase les super-blocs principaux avec une copie de sauvegarde

btrfstune

affine divers paramètres du système de fichier

fsck.btrfs

ne fait rien, mais est présent pour être cohérent avec fstab

mkfs.btrfs

crée un système de fichier btrfs