MetallibSupportPkg

MetallibSupportPkg

Uma coleção de utilitários relacionados à correção de bibliotecas Metal ( .metallib ) no macOS, especificamente com o objetivo de restaurar o suporte para hardware legado (ou seja, GPUs baseadas em Metal 3802 no macOS Sequoia).

Lógica

MetallibSupportPkg abriga a biblioteca python metal_libraries , que foi desenvolvida para agilizar a aplicação de patches da Metal Library por meio do seguinte:

1. Buscando programaticamente o macOS Sequoia IPSW mais recente.
2. Extraia o volume do sistema DMG do IPSW.
3. Se a imagem do disco estiver criptografada por AEA, descriptografe usando aastuff .
4. Monte a imagem do disco e extraia todos os arquivos .metallib suportados.
5. Corrija os arquivos .metallib para suportar GPUs Metal 3802.
6. Converta o diretório em um pacote de distribuição macOS (PKG).

Notas sobre correção de arquivos .metallib individuais:

1. Cada arquivo .metallib é na verdade uma coleção de arquivos .air . É necessário extraí-los usando o formato zhouwei.
   • metallib/patch.py: _unpack_metallib_to_air()
2. Certos arquivos .metallib são, na verdade, arquivos FAT Mach-O. Portanto, eles precisam ser afinados manualmente (o utilitário lipo da Apple não suporta a arquitetura AIR64 que precisamos).
   • metallib/patch.py: _thin_file()
3. Os arquivos .air precisam ser descompilados em seguida para .ll (LLVM IR) usando o utilitário metal-objdump da Apple.
   • metallib/patch.py: _decompile_air_to_ll()
4. Com o LLVM IR, podemos começar a corrigir a versão AIR para v26 (em comparação com a v27 do Sequoia), bem como outras alterações necessárias.
   • metallib/patch.py: _patch_ll()
5. Para compilar IR para .air , usamos o utilitário metal da Apple.
   • metallib/patch.py: _recompile_ll_to_air()
6. Para empacotar cada .air em uma coleção .metallib , usamos o utilitário metallib da Apple.
   • metallib/patch.py: _pack_air_to_metallib()

Depois de concluído, os arquivos .metallib resultantes deverão funcionar com GPUs baseadas em Metal 3802 no macOS Sequoia.

Uso

MetallibSupportPkg não se destina a ser usado por usuários em geral, o seguinte é destinado a desenvolvedores.

Instale as dependências necessárias:

python3 -m pip install -r requirements.txt
# Note Xcode is required to be installed for the `metal` and `metal-objdump` utilities

Buscar URL IPSW:

python3 metallib.py -d
# Example result: UniversalMac_15.0_24A5279h_Restore.ipsw

Extraia o volume do sistema do IPSW:

python3 metallib.py -e < path_to_ipsw >
# Example result: 090-49684-056.dmg

Buscar bibliotecas Metal do volume do sistema, irá extrair para 15.x- :

python3 metallib.py -f < path_to_system_volume >
# Example result: 15.0-24A5279h

Bibliotecas de Patch Metal:

 # Directory containing the Metal libraries
python3 metallib.py -p < path_to_metallib_dir >
# Individual Metal library
python3 metallib.py -p < path_to_metallib >

Converta bibliotecas Metal em pacote macOS:

python3 metallib.py -z < path_to_metallib_dir >
# Example result: MetallibSupportPkg-15.0-24A5279h.pkg 

---

 usage: metallib.py [-h] [-d] [-e EXTRACT] [-f FETCH] [-p PATCH] [-b BUILD_SYS_PATCH] [-z BUILD_PKG] [-c]

Download, extract, fetch, and patch Metal libraries.

options:
  -h, --help            show this help message and exit
  -d, --download        Download the latest IPSW.
  -e EXTRACT, --extract EXTRACT
                        Extract the system volume from an IPSW.
  -f FETCH, --fetch FETCH
                        Fetch Metal libraries from the system volume.
  -p PATCH, --patch PATCH
                        Patch Metal libraries.
  -b BUILD_SYS_PATCH, --build-sys-patch BUILD_SYS_PATCH
                        Build a system patch dictionary.
  -z BUILD_PKG, --build-pkg BUILD_PKG
                        Build a macOS package.
  -c, --continuous-integration
                        Run in continuous integration mode.