EfiFs

EFIFS - Drivers do sistema de arquivos EFI

Esta é uma implementação GPLV3+ de drivers de sistema de arquivos EFI independentes, com base nos drivers somente leitura GRUB 2.0.

Para informações adicionais, bem como drivers pré -compilados, consulte https://efi.akeo.ie

Requisitos

• Visual Studio 2022 (Windows), Mingw (Windows), GCC (Linux) ou EDK2.
• Um cliente Git capaz de inicializar/atualizar submódulos
• Qemu v2.7 ou mais tarde se depurar com o Visual Studio (NB: você pode encontrar binários do Qemu Windows aqui)

Compilação

Comum

• Pegue os submódulos Git com git submodule init e git submodule update .
  Observe que isso funciona apenas se você clonou o diretório usando git .
• Aplique 0001-GRUB-fixes.patch no subdiretório grub . Isso aplica as alterações necessárias para a compilação bem -sucedida do GRUB.

Visual Studio (não EDK2)

• Abra o arquivo de solução e pressione F5 para compilar e depurar o driver padrão.

GCC (não EDK2)

• make o diretório principal. Se necessário, você também pode emitir algo como make ARCH=<arch> CROSS_COMPILE=<tuple> <tuple> <arch> é um de ia32 , x64 , arm , aa64 , riscv64 ou loongarch64 (a abreviation crossurshi e a abre, como up /efi/boot/boot[ARCH].efi boot/boot/boot-march, arm-linux-gnueabi- ou aarch64-linux-gnu- . por exemplo, make ARCH=aa64 CROSS_COMPILE=aarch64-linux-gnu-

Edk2

• Abra um prompt de comando elevado e crie um link simbólico chamado EfiFsPkg , dentro do seu diretório EDK2, para a fonte EFIFS. No Windows, a partir de um prompt elevado, você pode executar algo como mklink /D EfiFsPkg C:efifs e no linux ln -s ../efifs EfiFsPkg .
• De um prompt de comando, defina o Grub para segmentar a plataforma para a qual você está compilando, invocando:
  • (Windows) set_grub_cpu.cmd <arch>
  • (Linux) ./set_grub_cpu.sh <arch>
    Onde <arch> é um dos ia32 , x64 , arm , aarch64 , riscv64 ou loongarch64 . Observe que você deve invocar o script set_grub_cpu sempre que alternar o destino .
• Depois de invocar edksetup.bat (Windows) ou edksetup.sh (Linux), execute algo como:

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

  onde <toolchain> é algo como VS2022 (Windows) ou GCC5 (Linux).
  NB: Para construir um motorista individual, como o NTFS, você também pode usar algo como:

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

• Um script do Windows para construir os drivers, usando o EDK2 com o VS2022 também é fornecido como edk2_build_drivers.cmd .

Teste

Se o Qemu estiver instalado, a solução do Visual Studio configurará e testará os drivers usando o QEMU (ao baixar também uma amostra de imagem para cada sistema de arquivos de destino). Observe, no entanto, que o VS Debugging espera que uma versão de 64 bits do Qemu seja instalada em C:Program Filesqemu (que você pode baixar aqui). Se não for esse o caso, você deve editar .msvcdebug.vbs de acordo.

Para testar fora do Visual Studio, verifique se você tem pelo menos um disco com uma partição de destino usando o sistema de arquivos de destino, que não está sendo tratado por outros drivers de sistema de arquivos EFI. Em seguida, inicialize no shell EFI e execute o seguinte:

• load fs0:<fs_name>_<arch>.efi ou onde quer que seu motorista fosse copiado
• map -r Isso deve disponibilizar um novo fs# , por exemplo, fs2:
• Agora você deve poder navegar e acessar conteúdo (no modo somente leitura)
• Para saída de log, defina a variável FS_LOGGING shell como 1 ou mais
• Para descarregar, use o comando drivers e depois unload com o ID do driver

Visual Studio 2022 e suporte ARM/ARM64

Lembre -se de que, para ativar o suporte de compilação ARM/ARM64 no Visual Studio 2022, você deve ir à tela de componentes individuais no aplicativo de configuração e selecionar os compiladores de braço e as bibliotecas lá, pois não aparecem na tela de cargas de trabalho padrão:

Notas adicionais

Esta é uma implementação pura de GPLV3+ de drivers EFI. Foi tomado muito cuidado para não usar nenhum código de fontes compatíveis com GPLV3, como fsw_efi da Refind (somente GPLV2) ou o driver gordo da Intel (requer um aviso de direitos autorais extra).

No entanto, observe que alguns arquivos (as fontes não grub_#### em ./src/ ) são licenciados em GPLV2+ em vez de GPLV3+ e que, assim como as fontes GPLV3+, cuidamos muito de garantir que possamos ser totalmente compatíveis com as obras licenciadoras ou relíquias.

Bônus: comandos para compilar EFIFs usando EDK2 em uma baunilha 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