Esta página aborda como configurar um novo recurso de kernel como um módulo GKI ou configurar um recurso de kernel interno existente como um módulo GKI.
Configurar um novo recurso como um módulo GKI
Para o novo recurso, edite
gki_defconfig
e defina o item de configuração do recurso do kernel necessário den
param
(=m
). Defina essa configuração emarch/arm64/configs/gki_defconfig
earch/x86/configs/gki_defconfig
.Adicione os arquivos KO (
.ko
) gerados para o recurso à seçãoCOMMON_GKI_MODULES_LIST
decommon/modules.bzl
. Adicione os arquivos em uma ordem classificada. Se você não tiver certeza de todos os arquivos gerados, a compilação falhará e listará todos os arquivos KO necessários para serem adicionados à lista.Adicione o mesmo conjunto de arquivos KO da etapa 2, classificados em ordem crescente para pesquisa binária em tempo de execução, a
common/android/gki_{ARCH}_protected_modules
para designar o módulo como um módulo GKI protegido. Atualize a lista de exportações protegidas para incluir as do módulo recém-adicionado emcommon/android/abi_gki_protected_exports_{ARCH}
usandotools/bazel run //common:kernel_aarch64_abi_update_protected_exports
paraaarch64
. Os módulos designados como módulos GKI protegidos ainda devem ser aprovados pelo Google para serem módulos protegidos oficiais.Certifique-se de que os arquivos KO recém-adicionados da etapa 2 sejam copiados para
out/<androidX-YZ>/dist/system_dlkm.img
eout/ androidX-YZ /dist/system_dlkm_staging_archive.tar.gz
. Os módulos no arquivosystem_dlkm_staging_archive.tar.gz
podem ser usados como entrada para gerar osystem_dlkm.img
na construção da plataforma.Envie suas alterações para revisão. Os módulos GKI são um recurso de kernel somente para Android, portanto, os patches de conversão de módulo não precisam ser enviados upstream. No entanto, você deve seguir outras diretrizes para enviar patches Android Common Kernel (ACK) .
Configurar um recurso interno do kernel como um módulo GKI
Para um recurso de kernel interno existente, edite
gki_defconfig
e defina o item de configuração do recurso de kernel necessário dey
param
(=m
). Defina essa configuração emarch/arm64/configs/gki_defconfig
earch/x86/configs/gki_defconfig
.Adicione os arquivos KO (
.ko
) gerados para o recurso à seçãoCOMMON_GKI_MODULES_LIST
decommon/modules.bzl
. Adicione os arquivos em uma ordem classificada. Se você não tiver certeza de todos os arquivos gerados, a compilação falhará e listará todos os arquivos KO necessários para serem adicionados à lista.Adicione o mesmo conjunto de arquivos KO da etapa 2, classificados em ordem crescente para pesquisa binária em tempo de execução, a
common/android/gki_{ARCH}_protected_modules
para designar o módulo como um módulo GKI protegido. Atualize a lista de exportações protegidas para incluir as do módulo recém-adicionado emcommon/android/abi_gki_protected_exports_{ARCH}
usandotools/bazel run //common:kernel_aarch64_abi_update_protected_exports
paraaarch64
. Os módulos designados como módulos GKI protegidos ainda devem ser aprovados pelo Google para serem módulos protegidos oficiais.Certifique-se de que os arquivos KO do módulo recém-convertidos da etapa 2 sejam copiados para
out/<androidX-YZ>/dist/system_dlkm.img
eout/ androidX-YZ /dist/system_dlkm_staging_archive.tar.gz
. Os módulos no arquivosystem_dlkm_staging_archive.tar.gz
podem ser usados como entrada para gerar osystem_dlkm.img
na construção da plataforma.Envie suas alterações para revisão. Os módulos GKI são um recurso de kernel somente para Android, portanto, os patches de conversão de módulo não precisam ser enviados upstream. No entanto, você deve seguir as outras diretrizes para enviar patches Android Common Kernel (ACK) .
Converter um módulo GKI protegido em desprotegido
Remova o módulo que está sendo convertido de protegido para desprotegido da lista de módulos protegidos em
common/android/gki_protected_modules
.Atualize a lista de exportações protegidas para excluir as do módulo desprotegido recém-convertido em
common/android/abi_gki_protected_exports_{ARCH}
usandotools/bazel run //common:kernel_aarch64_abi_update_protected_exports
paraaarch64
.Envie suas alterações para revisão. Os módulos GKI são um recurso de kernel somente para Android, portanto, os patches de conversão de módulo não precisam ser enviados upstream. No entanto, você deve seguir as outras diretrizes para enviar patches Android Common Kernel (ACK) .
Guia rápido de resolução de violação de símbolo de módulos GKI
Quando módulos não assinados violam a proteção de símbolo em vigor para módulos GKI, dois tipos de erros podem ser encontrados durante o carregamento do módulo, resultando em falha.
1. Módulo não assinado usando o símbolo protegido
Erro:
module: Protected symbol: some_kernel_function (err -13)
Causa:
O arquivo module.ko
é um módulo de fornecedor não assinado e tenta resolver o símbolo exportado do módulo GKI some_kernel_function
durante o carregamento, sem ser listado na lista de símbolos do fornecedor.
Resolução:
Se module.ko
não for um módulo GKI protegido, atualizar a lista de símbolos resolverá o erro incluindo some_kernel_function
na lista de símbolos do fornecedor. Como alternativa, use a versão GKI do module.ko
.
2. Módulo não assinado exportando o símbolo protegido
Erro:
module: exports protected symbol some_kernel_function
Causa:
O módulo que exporta o some_kernel_function
é um módulo GKI protegido e module.ko
é provavelmente uma versão personalizada não assinada desse módulo. Quando module.ko
tenta exportar some_kernel_function
, que só pode ser exportado por um módulo GKI assinado, o carregamento falha com esta mensagem.
Resolução:
Isso pode ser corrigido usando a versão GKI do módulo que exporta some_kernel_function
, se o módulo não assinado for uma versão personalizada.