Dynamic Kernel Module Support (Português)

From ArchWiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Status de tradução: Esse artigo é uma tradução de Dynamic Kernel Module Support. Data da última tradução: 2020-03-20. Você pode ajudar a sincronizar a tradução, se houver alterações na versão em inglês.

Da Wikipédia:

Dynamic Kernel Module Support (DKMS) (em Português: Suporte Dinâmico de Módulo de Kernel) é um programa/framework que permite gerar módulos do kernel do Linux cujos fontes residam fora da árvore de fontes. O conceito é poder ter os módulos automaticamente reconstruídos quando uma nova versão do kernel é instalada.

Isto significa que o usuário não precisa esperar que uma companhia, projeto ou mantenedor de pacotes lancem uma nova versão do módulo. Desde a introdução dos hooks do pacman, a recompilação de módulos do kernel é automaticamente providenciada quando um kernel é atualizado.

Instalação

Instale o pacote dkms e o header para o kernel (ou kernels, se mais de um estiver instalado). Por exemplo, para o kernel padrão linux este deverá ser linux-headers. Outros kernels têm seus respectivos headers.

Um bom número de módulos que residem fora da árvore do kernel tem sua variante para DKMS; alguns deles estão em repositórios oficiais, outros são encontrados no AUR.

Atualizações

Apesar da recompilação de módulos DKMS ser comumente discreta durante uma atualização de kernel, pode ocorrer da recompilação falhar. Você deve prestar uma atenção extra nas saídas do pacman. Isto se aplica em particular se o sistema depende do módulo DKMS para inicializar e/ou se você usar um kernel personalizado que não esteja nos repositórios oficiais.

Para lidar com alterações no kernel, correções de bugs ou adicionar recursos necessários extra, considere atualizar o pacote DKMS antes de reinicializar o sistema.

Uso

Utilização para invocar DKMS manualmente.

É possível usar autocompletar fazendo:

# source /usr/share/bash-completion/completions/dkms

Listar módulos

Para listar a situação atual dos módulos, versões e kernels em árvore:

# dkms status

Recompilar módulos

Recompilar todos os módulos para o kernel atualmente em execução:

# dkms autoinstall

ou para um kernel específico:

# dkms autoinstall -k 3.16.4-1-ARCH

Para compilar um módulo específico para o kernel atualmente em execução:

# dkms install -m nvidia -v 334.21

ou simplesmente:

# dkms install nvidia/334.21

Para compilar um módulo para todos os kernels:

# dkms install nvidia/334.21 --all

Remover módulos

Para remover um módulo (antigos que não foram automaticamente removidos):

# dkms remove -m nvidia -v 331.49 --all

ou simplesmente:

# dkms remove nvidia/331.49 --all

Se o pacote dkms é removido, a informação pertinente a arquivos de compilação de módulos anteriores é perdida. Se é este o caso, navegue por /usr/lib/modules/KERNELVERSION-ARCH e remova todos os arquivos e diretórios que não estiverem mais em uso.

Criação de pacote DKMS

Aqui há alguns guias a serem seguidos durante a criação de um pacote DKMS.

Nome do pacote

Pacotes DKMS são nomeados acrescentando "-dkms" ao nome do pacote original.

A variável $_pkgname é comumente usada abaixo de $pkgname para descrever o nome do pacote menos o sufixo "-dkms" (por exemplo, _pkgname=${pkgname%-*}). Isto é útil para ajudar a manter as similaridades entre o pacote PKGBUILD original e sua variante DKMS.

Dependências

Dependências devem ser herdadas da versão original com dkms adicionado e linux-headers removido (listado pelo pacote DKMS como opcional).

Local da fonte de compilação

Fontes de compilação devem ir para dentro de (este é o diretório padrão de compilação para DKMS):

/usr/src/NOME_PACOTE-VERSÃO_PACOTE

No diretório do pacote, uma configuração DKMS diz ao DKMS como compilar o módulo (dkms.conf), incluindo as variáveis NOME_PACOTE e VERSÃO_PACOTE.

  • NOME_PACOTE - o nome do projeto atual (geralmente $_pkgname ou $_pkgbase).
  • VERSÃO_PACOTE - por convenção, também este deve ser $pkgver.

Aplicação de correções (patching)

As fontes (sources) podem ser corrigidas tanto diretamente no PKGBUILD como através do dkms.conf.

Carregamento automático do módulo em .install

O carregamento e descarregamento dos módulos deve caber ao usuário. Considere a possibilidade de um módulo falhar ao ser carregado.

Também perceba que você não deve chamar depmod explicitamente para atualizar as dependências de seu módulo do kernel. Pacman chama as funções do DKMS dkms install e dkms remove automaticamente como hooks. dkms install garante que depmod seja chamado ao final do processo. dkms install depende de dkms build (para compilar a fonte para o kernel atual), que por sua vez depende de dkms add (para adicionar um link simbólico de /var/lib/dkms/<pacote>/<versão>/source para /usr/src/<pacote>).

Exemplo

Aqui um exemplo de um pacote que edita dkms.conf de acordo com seu nome de pacote e versão.

PKGBUILD

PKGBUILD
# Maintainer: foo <foo(at)example(dot)org>
# Contributor: bar <bar(at)example(dot)org>

_pkgbase=example
pkgname=example-dkms
pkgver=1
pkgrel=1
pkgdesc="The Example kernel modules (DKMS)"
arch=('i686' 'x86_64')
url="https://www.example.org/"
license=('GPL2')
depends=('dkms')
conflicts=("${_pkgbase}")
install=${pkgname}.install
source=("${url}/files/tarball.tar.gz"
        'dkms.conf'
        'linux-3.14.patch')
md5sums=(use 'updpkgsums')

prepare() {
  cd ${_pkgbase}-${pkgver}

  # Patch
  patch -p1 -i "${srcdir}"/linux-3.14.patch

}

package() {
  # Install
  make DESTDIR="${pkgdir}" install

  # Copy dkms.conf
  install -Dm644 dkms.conf "${pkgdir}"/usr/src/${_pkgbase}-${pkgver}/dkms.conf

  # Set name and version
  sed -e "s/@_PKGBASE@/${_pkgbase}/" \
      -e "s/@PKGVER@/${pkgver}/" \
      -i "${pkgdir}"/usr/src/${_pkgbase}-${pkgver}/dkms.conf

  # Copy sources (including Makefile)
  cp -r ${_pkgbase}/* "${pkgdir}"/usr/src/${_pkgbase}-${pkgver}/
}

dkms.conf

dkms.conf
PACKAGE_NAME="@_PKGBASE@"
PACKAGE_VERSION="@PKGVER@"
MAKE[0]="make --uname_r=$kernelver"
CLEAN="make clean"
BUILT_MODULE_NAME[0]="@_PKGBASE@"
DEST_MODULE_LOCATION[0]="/kernel/drivers/misc"
AUTOINSTALL="yes"

.install

Uma vez que pacman possui hooks DKMS implementados, você não deve especificar uma configuração estrita para DKMS em seu arquivo .install. Chamadas a dkms install e dkms remove serão automáticas.

Veja também