Re: [PATCH] docs: translations: pt_BR: translate gdb-kernel-debugging

From: Daniel Pereira

Date: Sat Nov 14 2026 - 14:10:33 EST


Hi Giovanna,

> +Configurações:
> +--------------

The original heading is "Setup"; please drop the stray colon.

> +- Crie uma máquina virtual Linux para QEMU/KVM (veja http://www.linux-kvm.org
> + ttp://www.qemu.org para mais detalhes). Para desenvolvimento cruzado,

The "e" ("and") between the two URLs is missing.

> +- Instale esse kernel no sistema convidado e desative o KASLR se
> + necessário, adicionando “nokaslr” à linha de comando do kernel. Como
> + alternativa, o QEMU permite inicializar o kernel diretamente
> + usando -kernel, -append, -initrd troca de comando de linha.

Please use straight quotes for "nokaslr", as in the rest of the file.
The last sentence is garbled; something like "usando as opções de
linha de comando -kernel, -append e -initrd" would be better.

> + você deve construir(Build) o kernel com CONFIG_RANDOMIZE_BASE
> +- Construa (Build) o kernel com CONFIG_GDB_SCRIPTS habilitado, mas deixe

Drop the English "(Build)" and fix the spacing ("construir(Build)",
"gdb(necessário").

> +- Construa os scripts gdb(necessário no kernel v5.1 ou superior)
> +
> + - Crie scripts_gdb

The command is lost and the "::" literal block is gone, so this
renders as an indented quote instead of code. It should be something
like:

- Construa os scripts gdb (necessário em kernels v5.1 e superiores)::

make scripts_gdb

> +- Inicie a gdb: gdb vmlinux
> +
> + Observação: algumas distribuições podem restringir o carregamento
> + [...]
> + Para ~/.gdbinit. Veja gdb help para mais detalhes.

"Inicie a gdb" should be "Inicie o gdb". The "Observação" block is
indented 4 spaces instead of 2 (as in the original), so it renders as
a nested block quote. Also "Para ~/.gdbinit" should be "para".

> +Exemplos de uso do Linux-provided gdb helpers
> +----------------------------------------------

Please translate "Linux-provided gdb helpers".

> +- Examinar os campos da estrutura da tarefa atual (compatível apenas com
> + x86 e arm64)::
> +
> + (gdb) p $lx_per_cpu(runqueues).nr_running

The "$lx_current().pid" / "$lx_current().comm" example was dropped,
and the $lx_per_cpu commands ended up under this item. The original
has two separate items: this one (with the $lx_current example) and
"Make use of the per-cpu function for the current or a specified CPU"
(with the $lx_per_cpu example). Both are needed.

> +- Explore os hrtimers usando o auxiliar `container_of`::

> + variável `task_struct`

The original has no backticks around container_of or task_struct.

> + função lx_current -- Voltar à tarefa atual
> + função lx_module -- Encontrar o módulo pelo nome e retornar a variável
> + do módulo

This is gdb output, which is printed in English; "function" must not
be translated. The original also keeps one command per line, without
wrapping.

> + Guia de depuração do kernel com gdb <gdb-kernel-debugging>

The other toctree entries in index.rst have no custom title. Please
keep the same style (plain "gdb-kernel-debugging") or explain why this
one differs.
Also, the patch no longer applies on current docs-next: index.rst now
has a toctree with userspace_debugging_guide. Please rebase before
sending v2.

Daniel