Kernel/Atualização

This page is a translated version of the page Kernel/Upgrade and the translation is 17% complete.

Outdated translations are marked like this.

Other languages:

Este artigo descreve as etapas para atualizar para uma nova versão do kernel Linux.

Fazer um novo kernel a partir das novas sources é basicamente o mesmo processo de quando inicialmente se instalou o sistema. A única diferença é que é possível economizar tempo ajustando as configurações do kernel antigo para as mudanças feitas no kernel novo, ao invés de checar todas as opções do kernel (usando make menuconfig, por exemplo) novamente.

Um novo kernel pode ter opções ou recursos que o kernel antigo não possui, ou pode não ter mais um recurso ou opção que o kernel antigo ainda possua. Assim, o arquivo de configuração do novo kernel pode ter novas entradas que o arquivo de configuração do kernel antigo não possui e pode não ter mais entradas que estejam presentes no arquivo de configuração do kernel antigo.

Este artigo é um guia de como lidar com essas mudanças no arquivo de configuração, convertendo a configuração antiga para uma configuração que possa ser usada no kernel novo.

A atualização do kernel no Gentoo envolve esses passos:

Passo 1: Baixar as sources do kernel novo.
Passo 2: Configurar o symlink correto para o kernel novo.
Passo 3: Ir para o diretório do kernel novo.
Passo 4: Ajustar o arquivo .config de acordo com as opções de configuração adicionadas ou removidas do kernel novo.
Passo 5: Compilar o kernel e o initramfs.
Passo 6: Atualizar o bootloader.
Passo 7: Remover ou deixar o kernel antigo.

Importante
It is wise to make a backup of the kernel configuration so that the previous configurations are not lost. Many users devote considerable time to figure out the best configuration for the system, and losing that information is definitely not wanted. One of the ways introduced in Copy the previous kernel configuration of this article can be used for making a backup of the configuration file.

Uma atualização do kernel pode ser uma boa ideia quando novas sources do kernel forem instaladas. Novas sources do kernel são às vezes instaladas durante a atualização do sistema, executando o seguinte comando:

root #emerge --ask --update --deep --with-bdeps=y --newuse @world

Claro, eles podem ser instalados diretamente usando o comando. (substitua gentoo-sources por hardened-sources caso utilize o perfil hardened):

root #emerge --ask --update --deep --with-bdeps=y --newuse sys-kernel/gentoo-sources

A instalação de novas sources do kernel não fornece ao usuário um novo kernel. É necessário compilar um novo kernel a partir das novas sources e, em seguida, reiniciar o sistema para realmente executar o novo kernel.

Set symlink to new kernel sources

The kernel configuration is saved in a file named .config in the directory that holds the kernel sources, a symlink is used to point to that directory.

O symlink /usr/src/linux deve sempre apontar para o diretório que contém as sources do kernel que atualmente é executado. Isso pode ser feito de três maneiras:

Instalando as sources do kernel com USE="symlink"
Configurando o link com eselect
Atualização manual do link simbólico

Configurando o link com eselect

Para definir symlink com eselect:

root #eselect kernel list

Available kernel symlink targets:
 [1] linux-3.14.14-gentoo *
 [2] linux-3.16.3-gentoo

Isso fornece as sources de kernel disponíveis. O asterisco indica as sources escolhidas.

Para alterar as sources do kernel, e.g. Para a segunda entrada, faça:

root #eselect kernel set 2

Atualização manual do link simbólico

Para definir o link simbólico manualmente:

root #

ln -sf /usr/src/linux-3.16.3 /usr/src/linux

root #ls -l /usr/src/linux

lrwxrwxrwx 1 root root 19 Oct  4 10:21 /usr/src/linux -> linux-3.16.3-gentoo

Instalando as fontes do kernel com o USE flag symlink

Isso fará com que o /usr/src/linux aponte para as fontes do kernel recém-instaladas.

Se necessário, ele ainda pode ser modificado posteriormente com um dos outros dois métodos.

Moving to the new kernel folder

Now that the symbolic link has been modified, change the working directory to the new kernel folder.

user $cd /usr/src/linux

Nota
This command is still necessary even if the working directory was already /usr/src/linux when the symlink was modified. Until the new symlink is actually followed, the console will still be in the old kernel's directory.

Adjusting the .config file for the new kernel

Copy the previous kernel configuration

A configuração do kernel antigo precisa ser copiada para o novo. Pode ser encontrado em vários lugares:

Em procfs, se a opção do kernel Habilitar acesso ao .config através de /proc/config.gz foi ativada no kernel presente:

root #zcat /proc/config.gz > /usr/src/linux/.config

Do kernel antigo. Isso só funcionará se o kernel antigo tiver sido compilado com CONFIG_IKCONFIG:

root #/usr/src/linux/scripts/extract-ikconfig /path/to/old/kernel >/usr/src/linux/.config

No diretório /boot, se a configuração foi instalada lá:

root #cp /boot/config-3.14.14-gentoo /usr/src/linux/.config

No diretório do kernel atualmente em execução:

root #cp /usr/src/linux-3.14.14-gentoo/.config /usr/src/linux/

No diretório /etc/kernels/, embora SAVE_CONFIG="yes" é definido em /etc/genkernel.conf e genkernel for utilizado anteriormente:

root #cp /etc/kernels/kernel-config-x86_64-3.14.14-gentoo /usr/src/linux/.config

Configurando o novo kernel

Nota
Invoking make oldconfig and make menuconfig can be done automatically via genkernel in the build process by enabling the OLDCONFIG and MENUCONFIG parameters in /etc/genkernel.conf. If OLDCONFIG is enabled in genkernel's configuration or if it's going to be enabled by passing --oldconfig option to genkernel command, jump to the build section in this article.

Para usar a configuração do kernel antigo com o novo kernel, ele precisa ser convertido. A conversão pode ser feita executando make silentoldconfig ou make olddefconfig. Use um ou outro, não ambos.

make silentoldconfig

Importante
make syncconfig has become an internal implementation detail; make oldconfig should be used when possible. The make silentoldconfig target has been removed as of Linux version 4.19 and higher.

A configuração a seguir é como a configuração baseada em texto com make config. Para novas opções de configuração, o usuário é solicitado a tomar uma decisão. Por exemplo:

root #

cd /usr/src/linux

root #make silentoldconfig

Anticipatory I/O scheduler (IOSCHED_AS) [Y/n/m/?] (NEW)

A string (NEW) no final da linha está marcado a opção como nova. Da esquerda para a direita, em colchetes, são as possíveis respostas: Sim, Não, Módulos ou ? para mostrar a ajuda. É recomendado (i.e. padrão) a resposta capitalizada (aqui é S). A ajuda esclarece a opção ou driver.

Infelizmente make silentoldconfig não mostra muito mais informações para cada opção, como o contexto, por isso às vezes é difícil dar a resposta certa. Neste caso, o melhor caminho a seguir é lembrar o nome da opção e revê-lo depois através de uma das graphical kernel ferramentas de configuração do kernel.

make olddefconfig

Todas as novas opções de configuração devem ser definidas (i.e. padrão) usando make olddefconfig:

root #

cd /usr/src/linux

root #make olddefconfig

make help

Use make help para ver outros métodos de conversão disponíveis:

root #make help

Observing the difference

A diff tool can be used to compare the old and new .config files to see what options have been added:

user $

comm -2 -3  <(sort .config) <(sort .config.old)

# CONFIG_BATTERY_RT5033 is not set
# Compiler: gcc (Gentoo 12.2.1_p20230428-r1 p2) 12.2.1 20230428
# Linux/x86 4.19.284-gentoo Kernel Configuration
CONFIG_ARCH_USE_MEMREMAP_PROT=y
CONFIG_GCC_VERSION=120201
CONFIG_GENTOO_PRINT_FIRMWARE_INFO=y
CONFIG_INET_TABLE_PERTURB_ORDER=16
CONFIG_PLUGIN_HOSTCC=""
CONFIG_RANDOM_TRUST_BOOTLOADER=y
CONFIG_UNIX_SCM=y
CONFIG_USER_NS=y

And which have been removed:

user $

comm -1 -3  <(sort .config) <(sort .config.old)

# CONFIG_GCC_PLUGINS is not set
# CONFIG_NVM is not set
# CONFIG_RANDOM_TRUST_CPU is not set
# CONFIG_USER_NS is not set
# Compiler: gcc (Gentoo 10.2.0-r5 p6) 10.2.0
# Linux/x86 4.19.184-gentoo Kernel Configuration
CONFIG_GCC_VERSION=100200
CONFIG_PLUGIN_HOSTCC="g++"

Alternatively, the kernel provides a script to cleanly compare two config files even if the options have moved in the file itself:

user $/usr/src/linux/scripts/diffconfig .config.old .config

make menuconfig

The options can then be researched and changed if necessary by running:

root #make menuconfig

The menuconfig target is helpful because it safely handles kernel symbol dependency resolution.

Compilação

Importante
Quando módulos externos do kernel são instalados (como nvidia ou zfs), pode ser necessário executar make modules_prepare como descrito abaixo antes de compilar o kernel. Alguns módulos não podem ser instalados ou preparados antes que o kernel tenha sido construído.

Having configured the new kernel as described in the previous sections, if external kernel modules are installed (like nvidia or zfs), it may be necessary to prepare them before building the new kernel, and then to rebuild the modules with the newly built kernel:

root #make modules_prepare

Nota
Using the -jN option with make (where N is the number of parallel jobs) can speed up the compilation process on multi-threaded systems. For example, make -j5 on a system with four logical cores.

Having built both the kernel and the modules, both should be installed:

root #

make modules_install

root #

make install

Finally, the bootloader must be reconfigured to account for the new kernel filenames, as described below. initramfs must be rebuilt if one is used as well.

Automated build and installation

It is possible to automatically build and install the newly emerged kernel using Portage hooks. While other approaches are also possible, the following is based on genkernel and gentoo-sources package. It requires the following prerequisites:

genkernel all is able to build and install the kernel to which the /usr/src/linux symlink points into $BOOTDIR and the bootloader.
The symlink use flag is set for the kernel ebuild.

If those are fulfilled, simply install a post_pkg_postinst Portage hook as shown below. Keep in mind this calls genkernel with --no-module-rebuild, since using module-rebuild would run emerge in emerge, and result in a deadlock waiting on the lock file. Remember to run emerge @module-rebuild after any update that includes a kernel upgrade.

FILE /etc/portage/env/sys-kernel/gentoo-sourcesAutomated kernel build and installation portage hook

post_pkg_postinst() {
# Eselect the new kernel or genkernel will build the current one
	eselect kernel set linux-"${KV}"
	CURRENT_KV=$(uname -r)
# Check if genkernel has been run previously for the running kernel and use that config
	if [[ -f "${EROOT}/etc/kernels/kernel-config-${CURRENT_KV}" ]] ; then
		genkernel --no-module-rebuild --kernel-config="${EROOT}/etc/kernels/kernel-config-${CURRENT_KV}" all
# Use latest kernel config from current kernel
	elif [[ -f "${EROOT}/usr/src/linux-${CURRENT_KV}/.config" ]] ; then
		genkernel --no-module-rebuild --kernel-config="${EROOT}/usr/src/linux-${CURRENT_KV}/.config" all
# Use known running good kernel
	elif [[ -f /proc/config.gz ]] ; then
		zcat /proc/config.gz >> "${EROOT}/tmp/genkernel.config"
		genkernel --no-module-rebuild --kernel-config="${EROOT}/tmp/genkernel.config" all
		rm "${EROOT}/tmp/genkernel.config"
# No valid configs known, compile a clean one
	else
		genkernel --no-module-rebuild all
	fi
}

Solução de problemas de compilação

Ao presenciar problemas de compilação durante a reconstrução do kernel atual, uma ajuda seria a limpeza das sources do kernel. Certifique-se de fazer backup do arquivo .config, pois a operação irá removê-lo. Certifique-se de não usar .bak ou ~ de sufixo no backup pois make distclean irá limpar também.

root #

cp .config /usr/src/kernel_config_bk

root #

make distclean

root #mv /usr/src/kernel_config_bk .config

Update the bootloader

The upgraded and installed kernel must be registered with the bootloader or directly with the UEFI firmware, see Kernel/Configuration. Users of GRUB can use the method below, users of other bootloaders must consult the Handbook.

Make sure /boot partition is mounted.

Using grub-mkconfig

The following command can be executed for updating GRUB's configuration file:

root #grub-mkconfig -o /boot/grub/grub.cfg

Aviso
If GRUB itself was upgraded (besides the kernel), for instance as part of a world set upgrade, it is necessary to also re-install GRUB, otherwise it may not boot. See GRUB#GRUB Bootloader Installation for details.

Dica
By enabling the grub USE flag on sys-kernel/installkernel grub-mkconfig will be regenerated automatically every time a new kernel is installed.

Systemd-boot

A systemd-boot configuration file for the new kernel is generated automatically when the kernel is installed. No manual action is required.

Removendo kernel antigo

Veja em remoção do kernel.

Recursos externos

kernel changelog com algumas explicações de novos recursos

Kernel/Atualização

Contents

Instalando e usando um novo kernel

Set symlink to new kernel sources

Configurando o link com eselect

Atualização manual do link simbólico

Instalando as fontes do kernel com o USE flag symlink

Moving to the new kernel folder

Adjusting the .config file for the new kernel

Copy the previous kernel configuration

Configurando o novo kernel

make silentoldconfig

make olddefconfig

make help

Observing the difference

make menuconfig

Compilação

Automated build and installation

Solução de problemas de compilação

Update the bootloader

Using grub-mkconfig

Systemd-boot

Removendo kernel antigo

See also

Recursos externos