EfiFs

EFIFS - Pilotes du système de fichiers EFI

Il s'agit d'une implémentation GPLV3 + des pilotes de système de fichiers EFI autonomes, basés sur les pilotes en lecture seule GRUB 2.0.

Pour des informations supplémentaires ainsi que les pilotes précompilés, voir https://efi.akeo.ie

Exigences

• Visual Studio 2022 (Windows), Mingw (Windows), GCC (Linux) ou EDK2.
• Un client GIT capable d'initialiser / mettre à jour les sous-modules
• Qemu v2.7 ou version ultérieure si le débogage avec Visual Studio (NB: vous pouvez trouver des binaires Windows Qemu ici)

Compilation

Commun

• Répondez les sous-modules GIT avec git submodule init et git submodule update .
  Remarque Cela ne fonctionne que si vous avez cloné le répertoire à l'aide de git .
• Appliquer 0001-GRUB-fixes.patch au sous-répertoire grub . Cela applique les modifications nécessaires à une compilation réussie de Grub.

Visual Studio (non EDK2)

• Ouvrez le fichier de solution et appuyez sur F5 pour compiler et déboguer le pilote par défaut.

GCC (non EDK2)

• Run make dans le répertoire supérieur. Si nécessaire, vous pouvez également émettre quelque chose comme make ARCH=<arch> CROSS_COMPILE=<tuple> où <arch> est l'un des ia32 , x64 , arm , aa64 , riscv64 ou loongarch64 (l'abréviation officielle UEFI pour un arch, comme cela est utilisé dans /efi/boot/boot[ARCH].efi <tuple> /Arch. arm-linux-gnueabi- ou aarch64-linux-gnu- . par exemple make ARCH=aa64 CROSS_COMPILE=aarch64-linux-gnu-

Edk2

• Ouvrez une invite de commande élevée et créez un lien symbolique appelé EfiFsPkg , à l'intérieur de votre répertoire EDK2, à la source EFIFS. Sur Windows, à partir d'une invite surélevée, vous pouvez exécuter quelque chose comme mklink /D EfiFsPkg C:efifs , et sur Linux ln -s ../efifs EfiFsPkg .
• À partir d'une invite de commande, définissez Grub pour cibler la plate-forme pour laquelle vous composez en invoquant:
  • (Windows) set_grub_cpu.cmd <arch>
  • (Linux) ./set_grub_cpu.sh <arch>
    Où <arch> est l'un des ia32 , x64 , arm , aarch64 , riscv64 ou loongarch64 . Notez que vous devez invoquer le script set_grub_cpu chaque fois que vous changez la cible .
• Après avoir appelé edksetup.bat (windows) ou edksetup.sh (linux) exécutez quelque chose comme:

   build -a X64 -b RELEASE -t <toolchain> -p EfiFsPkg/EfiFsPkg.dsc
  

  Où <toolchain> est quelque chose comme VS2022 (Windows) ou GCC5 (Linux).
  NB: Pour construire un pilote individuel, comme NTFS, vous pouvez également utiliser quelque chose comme:

   build -a X64 -b RELEASE -t <toolchain> -p EfiFsPkg/EfiFsPkg.dsc -m EfiFsPkg/EfiFsPkg/Ntfs.inf
  

• Un script Windows pour construire les pilotes, en utilisant EDK2 avec VS2022, est également fourni en tant edk2_build_drivers.cmd .

Essai

Si QEMU est installé, la solution Visual Studio configure et testera les pilotes à l'aide de QEMU (en téléchargeant également un exemple d'image pour chaque système de fichiers cibles). Notez cependant que VS Debogging s'attend à ce qu'une version 64 bits de Qemu soit installée dans C:Program Filesqemu (que vous pouvez télécharger ici). Si ce n'est pas le cas, vous devez modifier .msvcdebug.vbs en conséquence.

Pour les tests en dehors de Visual Studio, assurez-vous d'avoir au moins un disque avec une partition cible à l'aide du système de fichiers cible, qui n'est pas géré par d'autres pilotes de système de fichiers EFI. Démarrez ensuite dans le shell EFI et exécutez ce qui suit:

• load fs0:<fs_name>_<arch>.efi ou partout où votre pilote a été copié
• map -r Cela devrait rendre un nouveau fs# disponible, par exemple fs2:
• Vous devriez maintenant pouvoir naviguer et accéder au contenu (en mode en lecture seule)
• Pour la sortie de l'enregistrement, définissez la variable Shell FS_LOGGING à 1 ou plus
• Pour décharger, utilisez la commande drivers , puis unload avec l'ID de pilote

Visual Studio 2022 et ARM / ARM64 Support

Veuillez être conscient que, pour activer la prise en charge de la compilation ARM / ARM64 dans Visual Studio 2022, vous devez accéder à l'écran des composants individuels dans l'application de configuration et sélectionner les compilateurs ARM et les bibliothèques là-bas, car ils n'apparaissent pas dans l'écran de charges de travail par défaut:

Notes supplémentaires

Il s'agit d'une implémentation GPLV3 + pure des pilotes EFI. Un grand soin a été pris pour ne pas utiliser de code à partir de sources compatibles non GPLV3, telles que fsw_efi de Refind (GPLV2 uniquement) ou le conducteur de gros d'Intel (nécessite un avis supplémentaire du droit d'auteur).

Notez cependant que certains fichiers (les sources non grub_#### sous ./src/ ) sont sous licence GPLV2 + plutôt que GPLV3 + et que, tout comme les sources GPLV3 +, nous avons pris grand soin de nous assurer que nous sommes entièrement conformes à toutes les questions de licence ou de relicites.

Bonus: Commandes pour compiler les EFIF à l'aide d'Edk2 sur une vanille Debian GNU / Linux 10.x

 sudo apt install nasm uuid-dev gcc-multilib gcc-aarch64-linux-gnu gcc-arm-linux-gnueabi gcc-riscv64-linux-gnu
git clone --recurse-submodules https://github.com/tianocore/edk2.git
cd edk2
make -C BaseTools
git clone --recurse-submodules https://github.com/pbatard/EfiFs.git EfiFsPkg
cd EfiFsPkg/grub
git apply ../0001-GRUB-fixes.patch
cd -
export GCC5_ARM_PREFIX=arm-linux-gnueabi-
export GCC5_AARCH64_PREFIX=aarch64-linux-gnu-
export GCC5_RISCV64_PREFIX=riscv64-linux-gnu-
source edksetup.sh --reconfig
./EfiFsPkg/set_grub_cpu.sh X64
build -a X64 -b RELEASE -t GCC5 -p EfiFsPkg/EfiFsPkg.dsc
./EfiFsPkg/set_grub_cpu.sh IA32
build -a IA32 -b RELEASE -t GCC5 -p EfiFsPkg/EfiFsPkg.dsc
./EfiFsPkg/set_grub_cpu.sh AARCH64
build -a AARCH64 -b RELEASE -t GCC5 -p EfiFsPkg/EfiFsPkg.dsc
./EfiFsPkg/set_grub_cpu.sh ARM
build -a ARM -b RELEASE -t GCC5 -p EfiFsPkg/EfiFsPkg.dsc
./EfiFsPkg/set_grub_cpu.sh RISCV64
build -a RISCV64 -b RELEASE -t GCC5 -p EfiFsPkg/EfiFsPkg.dsc