* [PATCH 1/5] docs: translations: pt_BR: point refs at the translated documents
2026-09-16 17:41 [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Daniel Pereira
@ 2026-09-16 17:41 ` Daniel Pereira
2026-09-16 17:41 ` [PATCH 2/5] docs: translations: pt_BR: add admin-guide index Daniel Pereira
` (4 subsequent siblings)
5 siblings, 0 replies; 7+ messages in thread
From: Daniel Pereira @ 2026-09-16 17:41 UTC (permalink / raw)
To: Jonathan Corbet; +Cc: linux-doc
Several pt_BR documents referenced the English version of documents that
are already translated, in some cases rendering an English title in the
middle of a Portuguese sentence. Add the missing pt_BR anchors, repoint
the references at the translations, and fix the broken paths and stray
punctuation found along the way.
Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
.../pt_BR/process/adding-syscalls.rst | 2 +-
.../code-of-conduct-interpretation.rst | 2 ++
.../pt_BR/process/code-of-conduct.rst | 4 +--
.../pt_BR/process/coding-style.rst | 2 ++
.../translations/pt_BR/process/cve.rst | 4 +--
.../pt_BR/process/development-process.rst | 2 ++
.../pt_BR/process/maintainer-handbooks.rst | 4 +--
.../pt_BR/process/maintainer-kvm-x86.rst | 4 +--
.../process/maintainer-soc-clean-dts.rst | 5 ++--
.../pt_BR/process/management-style.rst | 7 +++---
.../pt_BR/process/security-bugs.rst | 25 +++++++++++--------
.../pt_BR/process/submit-checklist.rst | 4 +--
.../pt_BR/process/submitting-patches.rst | 2 ++
13 files changed, 40 insertions(+), 27 deletions(-)
diff --git a/Documentation/translations/pt_BR/process/adding-syscalls.rst b/Documentation/translations/pt_BR/process/adding-syscalls.rst
index 37b0dd0e2..99607ee5f 100644
--- a/Documentation/translations/pt_BR/process/adding-syscalls.rst
+++ b/Documentation/translations/pt_BR/process/adding-syscalls.rst
@@ -7,7 +7,7 @@ Adicionando uma Nova Chamada de Sistema
Este documento descreve o que está envolvido na adição de uma nova chamada de
sistema (system call) ao kernel Linux, indo além dos conselhos normais de
submissão em
-:ref:`Documentation/process/submitting-patches.rst <submittingpatches>`.
+:ref:`Documentation/translations/pt_BR/process/submitting-patches.rst <pt_BR_submittingpatches>`.
Alternativas às Chamadas de Sistema
diff --git a/Documentation/translations/pt_BR/process/code-of-conduct-interpretation.rst b/Documentation/translations/pt_BR/process/code-of-conduct-interpretation.rst
index 866c9f7e7..c40886e3d 100644
--- a/Documentation/translations/pt_BR/process/code-of-conduct-interpretation.rst
+++ b/Documentation/translations/pt_BR/process/code-of-conduct-interpretation.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_code_of_conduct_interpretation:
+
Interpretação do Código de Conduta do Kernel Linux
==================================================
diff --git a/Documentation/translations/pt_BR/process/code-of-conduct.rst b/Documentation/translations/pt_BR/process/code-of-conduct.rst
index 1ab171bf2..8a3da70b7 100644
--- a/Documentation/translations/pt_BR/process/code-of-conduct.rst
+++ b/Documentation/translations/pt_BR/process/code-of-conduct.rst
@@ -84,5 +84,5 @@ disponível em https://www.contributor-covenant.org/version/1/4/code-of-conduct.
Interpretação
=============
-Consulte o documento :ref:`code_of_conduct_interpretation` para entender como a
-comunidade do kernel Linux interpretará este documento.
+Consulte o documento :ref:`pt_BR_code_of_conduct_interpretation` para
+entender como a comunidade do kernel Linux interpretará este documento.
diff --git a/Documentation/translations/pt_BR/process/coding-style.rst b/Documentation/translations/pt_BR/process/coding-style.rst
index 26dcd1246..ac9bf0a71 100644
--- a/Documentation/translations/pt_BR/process/coding-style.rst
+++ b/Documentation/translations/pt_BR/process/coding-style.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_codingstyle:
+
Estilo de codificação do kernel Linux
=====================================
diff --git a/Documentation/translations/pt_BR/process/cve.rst b/Documentation/translations/pt_BR/process/cve.rst
index 18f4b11be..83977eda3 100644
--- a/Documentation/translations/pt_BR/process/cve.rst
+++ b/Documentation/translations/pt_BR/process/cve.rst
@@ -18,7 +18,7 @@ essas atribuições.
A equipe de desenvolvedores do kernel Linux tem a capacidade de atribuir CVEs
para possíveis problemas de segurança do kernel Linux. Essa atribuição é
independente do processo normal de relato de bugs de segurança do kernel
-Linux, descrito em :ref:`securitybugs`.
+Linux, descrito em :ref:`pt_BR_securitybugs`.
Uma lista de todos os CVEs atribuídos ao kernel Linux pode ser encontrada nos
arquivos da lista de discussão linux-cve, como visto em
@@ -51,7 +51,7 @@ ele é SOMENTE para atribuição de CVEs a correções que já estejam em árvor
kernel lançadas. Se você acredita ter encontrado um problema de segurança
ainda
não corrigido, por favor siga o processo normal de relato de bugs de segurança do kernel
-Linux, descrito em :ref:`securitybugs`.
+Linux, descrito em :ref:`pt_BR_securitybugs`.
Nenhum CVE será atribuído automaticamente para problemas de segurança ainda
não corrigidos no kernel Linux; a atribuição só acontecerá automaticamente
diff --git a/Documentation/translations/pt_BR/process/development-process.rst b/Documentation/translations/pt_BR/process/development-process.rst
index d303ab92b..e1441cec8 100644
--- a/Documentation/translations/pt_BR/process/development-process.rst
+++ b/Documentation/translations/pt_BR/process/development-process.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_development_process_main:
+
Guia para o Processo de Desenvolvimento do Kernel
=================================================
diff --git a/Documentation/translations/pt_BR/process/maintainer-handbooks.rst b/Documentation/translations/pt_BR/process/maintainer-handbooks.rst
index b7aab788f..130730650 100644
--- a/Documentation/translations/pt_BR/process/maintainer-handbooks.rst
+++ b/Documentation/translations/pt_BR/process/maintainer-handbooks.rst
@@ -5,8 +5,8 @@ Notas sobre o processo de desenvolvimento de subsistemas e mantenedores
O propósito deste documento é fornecer informações específicas de
subsistemas que são suplementares ao manual geral do processo de
-desenvolvimento.
-:ref:`Documentation/process <development_process_main>`.
+desenvolvimento
+:ref:`Documentation/translations/pt_BR/process <pt_BR_development_process_main>`.
Para desenvolvedores, veja abaixo todos os guias específicos de
subsistemas conhecidos. Se o subsistema para o qual você está
diff --git a/Documentation/translations/pt_BR/process/maintainer-kvm-x86.rst b/Documentation/translations/pt_BR/process/maintainer-kvm-x86.rst
index d9fd272fb..ef133d32c 100644
--- a/Documentation/translations/pt_BR/process/maintainer-kvm-x86.rst
+++ b/Documentation/translations/pt_BR/process/maintainer-kvm-x86.rst
@@ -431,5 +431,5 @@ Bugs que podem ser explorados pelo convidado (guest) para atacar o hospedeiro
(host) (kernel ou espaço do usuário), ou que podem ser explorados por uma VM
aninhada (nested) contra o *seu* próprio hospedeiro (L2 atacando L1), são de
interesse particular para o KVM. Por favor, siga o protocolo em
-:ref:`securitybugs` se você suspeitar que um bug possa levar a um escape,
-vazamento de dados, etc.
+:ref:`pt_BR_securitybugs` se você suspeitar que um bug possa levar a um
+escape, vazamento de dados, etc.
diff --git a/Documentation/translations/pt_BR/process/maintainer-soc-clean-dts.rst b/Documentation/translations/pt_BR/process/maintainer-soc-clean-dts.rst
index a7e7bf0f1..7256c7153 100644
--- a/Documentation/translations/pt_BR/process/maintainer-soc-clean-dts.rst
+++ b/Documentation/translations/pt_BR/process/maintainer-soc-clean-dts.rst
@@ -8,8 +8,9 @@ Visão Geral
-----------
As plataformas SoC ou subarquiteturas devem seguir todas as regras de
-Documentation/process/maintainer-soc.rst. Este documento, referenciado em
-MAINTAINERS, impõe requisitos adicionais listados abaixo.
+Documentation/translations/pt_BR/process/maintainer-soc.rst. Este
+documento, referenciado em MAINTAINERS, impõe requisitos adicionais
+listados abaixo.
Conformidade Estrita com DT Schema de DTS e dtc
-----------------------------------------------
diff --git a/Documentation/translations/pt_BR/process/management-style.rst b/Documentation/translations/pt_BR/process/management-style.rst
index b92f8705c..c40b19b90 100644
--- a/Documentation/translations/pt_BR/process/management-style.rst
+++ b/Documentation/translations/pt_BR/process/management-style.rst
@@ -5,9 +5,10 @@ Estilo de gerenciamento do kernel Linux
Este é um documento curto descrevendo o estilo de gerenciamento preferido (ou
inventado, dependendo de quem você perguntar) para o kernel do Linux. Ele se
-destina a espelhar o documento :ref:`process/coding-style.rst <codingstyle>` em
-algum grau, e foi escrito principalmente para evitar responder [#f1]_ as mesmas
-(ou semelhantes) perguntas repetidamente.
+destina a espelhar o documento
+:ref:`Documentation/translations/pt_BR/process/coding-style.rst <pt_BR_codingstyle>`
+em algum grau, e foi escrito principalmente para evitar responder [#f1]_ as
+mesmas (ou semelhantes) perguntas repetidamente.
Estilo de gerenciamento é muito pessoal e muito mais difícil de quantificar do
que simples regras de estilo de codificação, então este documento pode ou não ter
diff --git a/Documentation/translations/pt_BR/process/security-bugs.rst b/Documentation/translations/pt_BR/process/security-bugs.rst
index 72c771869..321575657 100644
--- a/Documentation/translations/pt_BR/process/security-bugs.rst
+++ b/Documentation/translations/pt_BR/process/security-bugs.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_securitybugs:
+
Falhas de segurança
===================
@@ -59,11 +61,11 @@ Além disso, as seguintes informações são altamente desejáveis:
mantenedores, mesmo que a correção acabe não sendo a correta, pois ajuda a
entender o bug. Ao propor uma correção testada, por favor, formate-a
sempre de uma maneira que possa ser mesclada imediatamente (consulte
- Documentation/process/submitting-patches.rst). Isso evitará algumas trocas
- de mensagens caso ela seja aceita, e você receberá o crédito por
- encontrar e corrigir o problema. Observe que, neste caso, apenas uma tag
- ``Signed-off-by:`` é necessária, sem ``Reported-by:`` quando o relator e
- o autor forem a mesma pessoa.
+ Documentation/translations/pt_BR/process/submitting-patches.rst). Isso
+ evitará algumas trocas de mensagens caso ela seja aceita, e você receberá
+ o crédito por encontrar e corrigir o problema. Observe que, neste caso,
+ apenas uma tag ``Signed-off-by:`` é necessária, sem ``Reported-by:``
+ quando o relator e o autor forem a mesma pessoa.
* **mitigações**: com muita frequência, durante a análise de um bug,
surgem algumas maneiras de mitigar o problema. É útil compartilhá-las,
@@ -228,8 +230,8 @@ a tornar esses relatórios desnecessariamente difíceis de lidar:
Se a correção não puder ser testada porque depende de hardware raro ou de
protocolos de rede quase extintos, é provável que o problema não seja um
bug de segurança. Em qualquer caso, se uma correção for proposta, ela deve
- aderir a Documentation/process/submitting-patches.rst e incluir uma tag
- 'Fixes:' designando o commit que introduziu o bug.
+ aderir a Documentation/translations/pt_BR/process/submitting-patches.rst
+ e incluir uma tag 'Fixes:' designando o commit que introduziu o bug.
A falha em considerar estes pontos expõe seu relatório ao risco de ser
ignorado.
@@ -280,7 +282,7 @@ entender e corrigir a vulnerabilidade de segurança.
Por favor, envie e-mails em **texto simples** sem anexos, sempre que possível.
É muito mais difícil ter uma discussão com citações de contexto sobre um
problema complexo se todos os detalhes estiverem ocultos em anexos. Pense nisso
-como uma :doc:`regular path submission </../../../process/submitting-patches>`
+como uma :doc:`submissão pelo caminho normal <submitting-patches>`
(mesmo que você ainda não tenha um patch): descreva o problema e o impacto,
liste as etapas de reprodução e siga com uma proposta de correção, tudo em
texto simples. Relatórios formatados em Markdown, HTML e RST são
@@ -288,8 +290,9 @@ particularmente malvistos, pois são bastante difíceis de ler por humanos e
incentivam o uso de visualizadores dedicados, às vezes online, o que por
definição não é aceitável para um relatório de segurança confidencial. Note
que alguns clientes de e-mail tendem a corromper a formatação de texto simples
-por padrão; por favor, consulte Documentation/process/email-clients.rst para
-mais informações.
+por padrão; por favor, consulte
+Documentation/translations/pt_BR/process/email-clients.rst para mais
+informações.
Divulgação e informações sob embargo
------------------------------------
@@ -359,7 +362,7 @@ A equipe de segurança não atribui CVEs, nem os exigimos para relatórios ou
correções, pois isso pode complicar desnecessariamente o processo e adiar o
tratamento do bug. Se um relator desejar que um identificador CVE seja
atribuído para um problema confirmado, ele pode entrar em contato com a
-:doc:`kernel CVE assignment team<../../../process/cve>` para obter um.
+:doc:`equipe de atribuição de CVEs do kernel <cve>` para obter um.
Acordo de não divulgação
------------------------
diff --git a/Documentation/translations/pt_BR/process/submit-checklist.rst b/Documentation/translations/pt_BR/process/submit-checklist.rst
index 003fc9568..3e0ee38b9 100644
--- a/Documentation/translations/pt_BR/process/submit-checklist.rst
+++ b/Documentation/translations/pt_BR/process/submit-checklist.rst
@@ -8,7 +8,7 @@ Aqui estão algumas coisas básicas que os desenvolvedores devem fazer se
quiserem ver suas submissões de patches de kernel aceitas mais rapidamente.
Estas diretrizes vão além da documentação fornecida em
-:ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
+:ref:`Documentation/translations/pt_BR/process/submitting-patches.rst <pt_BR_submittingpatches>`
e em outros locais sobre o envio de patches para o kernel Linux.
Revise seu código
@@ -19,7 +19,7 @@ Revise seu código
os que você usa de forma indireta.
2) Verifique o estilo geral do seu patch conforme detalhado em
- :ref:`Documentation//process/coding-style.rst <codingstyle>`.
+ :ref:`Documentation/translations/pt_BR/process/coding-style.rst <pt_BR_codingstyle>`.
3) Todas as barreiras de memória {por exemplo, ``barrier()``, ``rmb()``,
``wmb()``} precisam de um comentário no código-fonte que explique a
diff --git a/Documentation/translations/pt_BR/process/submitting-patches.rst b/Documentation/translations/pt_BR/process/submitting-patches.rst
index 8cf1aae52..aad926c17 100644
--- a/Documentation/translations/pt_BR/process/submitting-patches.rst
+++ b/Documentation/translations/pt_BR/process/submitting-patches.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_submittingpatches:
+
Enviando patches: o guia essencial para colocar o seu código no kernel
======================================================================
--
2.47.3
^ permalink raw reply related [flat|nested] 7+ messages in thread* [PATCH 2/5] docs: translations: pt_BR: add admin-guide index
2026-09-16 17:41 [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Daniel Pereira
2026-09-16 17:41 ` [PATCH 1/5] docs: translations: pt_BR: point refs at the translated documents Daniel Pereira
@ 2026-09-16 17:41 ` Daniel Pereira
2026-09-16 17:41 ` [PATCH 3/5] docs: translations: pt_BR: translate admin-guide/README.rst Daniel Pereira
` (3 subsequent siblings)
5 siblings, 0 replies; 7+ messages in thread
From: Daniel Pereira @ 2026-09-16 17:41 UTC (permalink / raw)
To: Jonathan Corbet; +Cc: linux-doc
Add a Brazilian Portuguese index for admin-guide, mirroring the section
layout of the original. No document has been translated yet, so every
entry is listed under a Todolist marker instead of a toctree, the same
way the zh_CN translation tracks its pending files; entries move into a
toctree as they get translated.
Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
.../translations/pt_BR/admin-guide/index.rst | 186 ++++++++++++++++++
Documentation/translations/pt_BR/index.rst | 10 +
2 files changed, 196 insertions(+)
create mode 100644 Documentation/translations/pt_BR/admin-guide/index.rst
diff --git a/Documentation/translations/pt_BR/admin-guide/index.rst b/Documentation/translations/pt_BR/admin-guide/index.rst
new file mode 100644
index 000000000..a5ad5baa3
--- /dev/null
+++ b/Documentation/translations/pt_BR/admin-guide/index.rst
@@ -0,0 +1,186 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. raw:: latex
+
+ \renewcommand\thesection*
+ \renewcommand\thesubsection*
+
+==================================================
+Guia do usuário e do administrador do kernel Linux
+==================================================
+
+A seguir está uma coleção de documentos voltados ao usuário que foram
+adicionados ao kernel ao longo do tempo. Ainda há pouca ordem ou organização
+geral aqui --- este material não foi escrito para ser um documento único e
+coerente! Com sorte, as coisas melhorarão rapidamente com o tempo.
+
+Guias gerais para a administração do kernel
+-------------------------------------------
+
+Esta seção inicial contém informações gerais, incluindo o arquivo README que
+descreve o kernel como um todo, documentação sobre os parâmetros do kernel,
+etc.
+
+Todolist:
+
+* README
+* devices
+* features
+
+Uma grande parte da interface administrativa do kernel são os sistemas de
+arquivos virtuais /proc e sysfs; estes documentos descrevem como interagir
+com eles.
+
+Todolist:
+
+* sysfs-rules
+* sysctl/index
+* cputopology
+* abi
+
+Documentação relacionada à segurança:
+
+Todolist:
+
+* hw-vuln/index
+* LSM/index
+* perf-security
+
+Inicializando o kernel
+----------------------
+
+Todolist:
+
+* bootconfig
+* kernel-parameters
+* efi-stub
+* initrd
+
+Rastreando e identificando problemas
+------------------------------------
+
+Aqui está um conjunto de documentos voltados a usuários que estão tentando
+rastrear problemas e bugs em particular.
+
+Todolist:
+
+* reporting-issues
+* reporting-regressions
+* quickly-build-trimmed-linux
+* verify-bugs-and-bisect-regressions
+* bug-hunting
+* bug-bisect
+* tainted-kernels
+* ramoops
+* dynamic-debug-howto
+* init
+* kdump/index
+* perf/index
+* pstore-blk
+* clearing-warn-once
+* kernel-per-CPU-kthreads
+* lockup-watchdogs
+* RAS/index
+* sysrq
+
+Subsistemas centrais do kernel
+------------------------------
+
+Estes documentos descrevem interfaces de administração dos subsistemas
+centrais do kernel, que provavelmente são de interesse em quase qualquer
+sistema.
+
+Todolist:
+
+* cgroup-v2
+* cgroup-v1/index
+* cpu-isolation
+* cpu-load
+* mm/index
+* module-signing
+* namespaces/index
+* numastat
+* pm/index
+* syscall-user-dispatch
+
+Suporte a formatos binários não nativos. Observe que alguns destes
+documentos são ... antigos ...
+
+Todolist:
+
+* binfmt-misc
+* java
+* mono
+
+Administração da camada de blocos e de sistemas de arquivos
+-----------------------------------------------------------
+
+Todolist:
+
+* bcache
+* binderfs
+* blockdev/index
+* cifs/index
+* device-mapper/index
+* ext4
+* filesystem-monitoring
+* nfs/index
+* iostats
+* jfs
+* md
+* ufs
+* xfs
+
+Guias específicos de dispositivos
+---------------------------------
+
+Como configurar o seu hardware dentro do sistema Linux.
+
+Todolist:
+
+* acpi/index
+* aoe/index
+* auxdisplay/index
+* braille-console
+* btmrvl
+* dell_rbu
+* edid
+* gpio/index
+* hw_random
+* laptops/index
+* lcd-panel-cgram
+* media/index
+* nvme-multipath
+* parport
+* pnp
+* rapidio
+* rtc
+* serial-console
+* svga
+* thermal/index
+* thunderbolt
+* vga-softcursor
+* video-output
+
+Análise de carga de trabalho
+----------------------------
+
+Este é o início de uma seção com informações de interesse para
+desenvolvedores de aplicações e integradores de sistemas que fazem análise
+do kernel Linux para aplicações críticas de segurança. Documentos que dão
+suporte à análise das interações do kernel com as aplicações, e às
+expectativas dos principais subsistemas do kernel, serão encontrados aqui.
+
+Todolist:
+
+* workload-tracing
+
+Todo o resto
+------------
+
+Alguns documentos difíceis de categorizar e geralmente obsoletos.
+
+Todolist:
+
+* ldm
+* unicode
diff --git a/Documentation/translations/pt_BR/index.rst b/Documentation/translations/pt_BR/index.rst
index 462267e92..5557c5e4e 100644
--- a/Documentation/translations/pt_BR/index.rst
+++ b/Documentation/translations/pt_BR/index.rst
@@ -67,3 +67,13 @@ kernel e sobre como ver seu trabalho integrado.
:maxdepth: 1
process/index
+
+Guias do usuário e do administrador
+===================================
+
+Os guias para usuários e administradores do kernel Linux.
+
+.. toctree::
+ :maxdepth: 1
+
+ admin-guide/index
--
2.47.3
^ permalink raw reply related [flat|nested] 7+ messages in thread* [PATCH 3/5] docs: translations: pt_BR: translate admin-guide/README.rst
2026-09-16 17:41 [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Daniel Pereira
2026-09-16 17:41 ` [PATCH 1/5] docs: translations: pt_BR: point refs at the translated documents Daniel Pereira
2026-09-16 17:41 ` [PATCH 2/5] docs: translations: pt_BR: add admin-guide index Daniel Pereira
@ 2026-09-16 17:41 ` Daniel Pereira
2026-09-16 17:41 ` [PATCH 4/5] docs: translations: pt_BR: translate admin-guide/devices.rst Daniel Pereira
` (2 subsequent siblings)
5 siblings, 0 replies; 7+ messages in thread
From: Daniel Pereira @ 2026-09-16 17:41 UTC (permalink / raw)
To: Jonathan Corbet; +Cc: linux-doc
Translate the kernel README into Brazilian Portuguese and move it from
the Todolist into the toctree of the admin-guide index. References to
changes.rst and applying-patches.rst point at the pt_BR translations,
since both are already translated.
Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
.../translations/pt_BR/admin-guide/README.rst | 382 ++++++++++++++++++
.../translations/pt_BR/admin-guide/index.rst | 6 +-
2 files changed, 387 insertions(+), 1 deletion(-)
create mode 100644 Documentation/translations/pt_BR/admin-guide/README.rst
diff --git a/Documentation/translations/pt_BR/admin-guide/README.rst b/Documentation/translations/pt_BR/admin-guide/README.rst
new file mode 100644
index 000000000..1843f89b1
--- /dev/null
+++ b/Documentation/translations/pt_BR/admin-guide/README.rst
@@ -0,0 +1,382 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. _pt_BR_readme:
+
+Versão 6.x do kernel Linux <http://kernel.org/>
+===============================================
+
+Estas são as notas de lançamento da versão 6 do Linux. Leia-as com atenção,
+pois elas dizem do que se trata tudo isso, explicam como instalar o kernel e
+o que fazer se algo der errado.
+
+O que é o Linux?
+----------------
+
+ O Linux é um clone do sistema operacional Unix, escrito do zero por Linus
+ Torvalds com a ajuda de uma equipe pouco organizada de hackers espalhados
+ pela Internet. Ele busca a conformidade com o POSIX e com a Single UNIX
+ Specification.
+
+ Possui todos os recursos que você esperaria de um Unix moderno e completo,
+ incluindo multitarefa real, memória virtual, bibliotecas compartilhadas,
+ carregamento sob demanda (demand loading), executáveis compartilhados com
+ cópia-na-escrita (copy-on-write), gerenciamento de memória adequado e rede
+ multipilha, incluindo IPv4 e IPv6.
+
+ É distribuído sob a GNU General Public License v2 --- veja o arquivo
+ COPYING que o acompanha para mais detalhes.
+
+Em qual hardware ele roda?
+--------------------------
+
+ Embora tenha sido originalmente desenvolvido primeiro para PCs de 32 bits
+ baseados em x86 (386 ou superior), hoje o Linux também roda (pelo menos)
+ nas arquiteturas Compaq Alpha AXP, Sun SPARC e UltraSPARC, Motorola 68000,
+ PowerPC, PowerPC64, ARM, Hitachi SuperH, Cell, IBM S/390, MIPS, HP PA-RISC,
+ Intel IA-64, DEC VAX, AMD x86-64 Xtensa e ARC.
+
+ O Linux é facilmente portável para a maioria das arquiteturas de propósito
+ geral de 32 ou 64 bits, desde que possuam uma unidade de gerenciamento de
+ memória paginada (PMMU) e um port do compilador C da GNU (gcc), parte da
+ GNU Compiler Collection (GCC). O Linux também já foi portado para diversas
+ arquiteturas sem PMMU, embora a funcionalidade fique, obviamente, um tanto
+ limitada.
+ O Linux também foi portado para si mesmo. Você pode agora executar o kernel
+ como uma aplicação de espaço de usuário --- isso se chama UserMode Linux
+ (UML).
+
+Documentação
+------------
+
+ - Há muita documentação disponível, tanto em formato eletrônico na Internet
+ quanto em livros, tanto específica do Linux quanto referente a questões
+ gerais do UNIX. Eu recomendaria procurar nos subdiretórios de documentação
+ de qualquer site FTP do Linux pelos livros do LDP (Linux Documentation
+ Project). Este README não pretende ser a documentação do sistema: existem
+ fontes muito melhores disponíveis.
+
+ - Existem vários arquivos README no subdiretório Documentation/: eles
+ normalmente contêm notas de instalação específicas do kernel para alguns
+ drivers, por exemplo. Por favor, leia o arquivo
+ Documentation/translations/pt_BR/process/changes.rst, pois ele contém
+ informações sobre os problemas que podem resultar da atualização do seu
+ kernel.
+
+Instalando o código-fonte do kernel
+-----------------------------------
+
+ - Se você instalar as fontes completas, coloque o tarball do kernel em um
+ diretório no qual você tenha permissões (por exemplo, o seu diretório
+ pessoal) e o descompacte::
+
+ xz -cd linux-6.x.tar.xz | tar xvf -
+
+ Substitua "X" pelo número da versão do kernel mais recente.
+
+ NÃO use a área /usr/src/linux! Essa área possui um conjunto (geralmente
+ incompleto) de cabeçalhos do kernel que são usados pelos arquivos de
+ cabeçalho da biblioteca. Eles devem corresponder à biblioteca, e não ser
+ bagunçados por qualquer que seja o kernel-do-dia.
+
+ - Você também pode atualizar entre versões 6.x aplicando patches. Os patches
+ são distribuídos no formato xz. Para instalar aplicando patches, obtenha
+ todos os arquivos de patch mais novos, entre no diretório de nível
+ superior do código-fonte do kernel (linux-6.x) e execute::
+
+ xz -cd ../patch-6.x.xz | patch -p1
+
+ Substitua "x" para todas as versões maiores que a versão "x" da sua árvore
+ de fontes atual, **em ordem**, e deve dar tudo certo. Talvez você queira
+ remover os arquivos de backup (algum-nome-de-arquivo~ ou
+ algum-nome-de-arquivo.orig) e certificar-se de que não há patches que
+ falharam (algum-nome-de-arquivo# ou algum-nome-de-arquivo.rej). Se
+ houver, ou você ou eu cometemos um erro.
+
+ Diferentemente dos patches para os kernels 6.x, os patches para os kernels
+ 6.x.y (também conhecidos como kernels -stable) não são incrementais; em vez
+ disso, eles se aplicam diretamente ao kernel 6.x base. Por exemplo, se o
+ seu kernel base é o 6.0 e você quer aplicar o patch 6.0.3, você não deve
+ aplicar antes os patches 6.0.1 e 6.0.2. Da mesma forma, se você está
+ rodando a versão 6.0.2 do kernel e quer saltar para a 6.0.3, você deve
+ primeiro reverter o patch 6.0.2 (ou seja, patch -R) **antes** de aplicar o
+ patch 6.0.3. Você pode ler mais sobre isso em
+ Documentation/translations/pt_BR/process/applying-patches.rst.
+
+ Como alternativa, o script patch-kernel pode ser usado para automatizar
+ esse processo. Ele determina a versão atual do kernel e aplica quaisquer
+ patches encontrados::
+
+ linux/scripts/patch-kernel linux
+
+ O primeiro argumento no comando acima é a localização do código-fonte do
+ kernel. Os patches são aplicados a partir do diretório atual, mas um
+ diretório alternativo pode ser especificado como segundo argumento.
+
+ - Certifique-se de que não há arquivos .o e dependências obsoletos espalhados
+ por aí::
+
+ cd linux
+ make mrproper
+
+ Agora você deve ter as fontes instaladas corretamente.
+
+Requisitos de software
+----------------------
+
+ Compilar e executar os kernels 6.x exige versões atualizadas de vários
+ pacotes de software. Consulte
+ Documentation/translations/pt_BR/process/changes.rst para os números de
+ versão mínimos exigidos e como obter atualizações desses pacotes. Esteja
+ ciente de que usar versões excessivamente antigas desses pacotes pode
+ causar erros indiretos, muito difíceis de rastrear; portanto, não presuma
+ que basta atualizar os pacotes quando problemas óbvios surgirem durante a
+ compilação ou a execução.
+
+Diretório de compilação do kernel
+---------------------------------
+
+ Ao compilar o kernel, todos os arquivos de saída serão, por padrão,
+ armazenados junto com o código-fonte do kernel.
+ Usar a opção ``make O=output/dir`` permite especificar um local alternativo
+ para os arquivos de saída (incluindo o .config).
+ Exemplo::
+
+ código-fonte do kernel: /usr/src/linux-6.x
+ diretório de compilação: /home/nome/build/kernel
+
+ Para configurar e compilar o kernel, use::
+
+ cd /usr/src/linux-6.x
+ make O=/home/nome/build/kernel menuconfig
+ make O=/home/nome/build/kernel
+ sudo make O=/home/nome/build/kernel modules_install install
+
+ Observe: se a opção ``O=output/dir`` for usada, ela deve ser usada em todas
+ as invocações do make.
+
+Configurando o kernel
+---------------------
+
+ Não pule esta etapa, mesmo que você esteja atualizando apenas uma versão
+ menor. Novas opções de configuração são adicionadas a cada lançamento, e
+ problemas estranhos aparecerão se os arquivos de configuração não estiverem
+ preparados como esperado. Se você quiser levar a sua configuração existente
+ para uma nova versão com o mínimo de trabalho, use ``make oldconfig``, que
+ perguntará apenas as respostas para as novas questões.
+
+ - Comandos alternativos de configuração são::
+
+ "make config" Interface em texto puro.
+
+ "make menuconfig" Menus coloridos, listas de seleção e diálogos, em
+ modo texto.
+
+ "make nconfig" Menus coloridos aprimorados, em modo texto.
+
+ "make xconfig" Ferramenta de configuração baseada em Qt.
+
+ "make gconfig" Ferramenta de configuração baseada em GTK.
+
+ "make oldconfig" Assume o padrão para todas as questões com base no
+ conteúdo do seu arquivo ./.config existente e
+ pergunta sobre os novos símbolos de configuração.
+
+ "make olddefconfig"
+ Como o anterior, mas define os novos símbolos com
+ seus valores padrão, sem perguntar.
+
+ "make defconfig" Cria um arquivo ./.config usando os valores padrão
+ dos símbolos, vindos de
+ arch/$ARCH/configs/defconfig ou de
+ arch/$ARCH/configs/${PLATFORM}_defconfig,
+ dependendo da arquitetura.
+
+ "make ${PLATFORM}_defconfig"
+ Cria um arquivo ./.config usando os valores padrão
+ dos símbolos vindos de
+ arch/$ARCH/configs/${PLATFORM}_defconfig.
+ Use "make help" para obter uma lista de todas as
+ plataformas disponíveis para a sua arquitetura.
+
+ "make allyesconfig"
+ Cria um arquivo ./.config definindo os valores dos
+ símbolos como 'y' sempre que possível.
+
+ "make allmodconfig"
+ Cria um arquivo ./.config definindo os valores dos
+ símbolos como 'm' sempre que possível.
+
+ "make allnoconfig" Cria um arquivo ./.config definindo os valores dos
+ símbolos como 'n' sempre que possível.
+
+ "make randconfig" Cria um arquivo ./.config definindo os valores dos
+ símbolos aleatoriamente.
+
+ "make localmodconfig" Cria uma configuração baseada na configuração
+ atual e nos módulos carregados (lsmod). Desativa
+ qualquer opção de módulo que não seja necessária
+ para os módulos carregados.
+
+ Para criar um localmodconfig para outra máquina,
+ armazene o lsmod daquela máquina em um arquivo e
+ o passe como parâmetro LSMOD.
+
+ Além disso, você pode preservar módulos em certas
+ pastas ou arquivos kconfig especificando seus
+ caminhos no parâmetro LMC_KEEP.
+
+ alvo$ lsmod > /tmp/mylsmod
+ alvo$ scp /tmp/mylsmod host:/tmp
+
+ host$ make LSMOD=/tmp/mylsmod \
+ LMC_KEEP="drivers/usb:drivers/gpu:fs" \
+ localmodconfig
+
+ O acima também funciona em compilação cruzada.
+
+ "make localyesconfig" Semelhante ao localmodconfig, exceto que converte
+ todas as opções de módulo em opções embutidas
+ (=y). Você também pode preservar módulos com o
+ LMC_KEEP.
+
+ "make kvm_guest.config" Habilita opções adicionais para suporte a
+ kernel convidado do kvm.
+
+ "make xen.config" Habilita opções adicionais para suporte a kernel
+ convidado dom0 do xen.
+
+ "make tinyconfig" Configura o menor kernel possível.
+
+ Você pode encontrar mais informações sobre o uso das ferramentas de
+ configuração do kernel Linux em Documentation/kbuild/kconfig.rst.
+
+ - NOTAS sobre o ``make config``:
+
+ - Ter drivers desnecessários deixará o kernel maior e, em algumas
+ circunstâncias, pode levar a problemas: sondar uma placa controladora
+ inexistente pode confundir as suas outras controladoras.
+
+ - Um kernel com emulação matemática compilada ainda usará o
+ coprocessador, se houver um presente: a emulação matemática
+ simplesmente nunca será usada nesse caso. O kernel ficará um pouco
+ maior, mas funcionará em máquinas diferentes, independentemente de
+ terem ou não um coprocessador matemático.
+
+ - Os detalhes de configuração de "kernel hacking" normalmente resultam em
+ um kernel maior ou mais lento (ou ambos), e podem até tornar o kernel
+ menos estável, ao configurar algumas rotinas para tentar ativamente
+ quebrar código ruim e encontrar problemas no kernel (kmalloc()).
+ Portanto, você provavelmente deve responder 'n' às questões sobre
+ recursos de "development", "experimental" ou "debugging".
+
+Compilando o kernel
+-------------------
+
+ - Certifique-se de ter pelo menos o gcc 8.1 disponível.
+ Para mais informações, consulte
+ Documentation/translations/pt_BR/process/changes.rst.
+
+ - Execute um ``make`` para criar uma imagem compactada do kernel. Também é
+ possível executar ``make install`` se você tiver o lilo instalado ou se a
+ sua distribuição possuir um script de instalação reconhecido pelo
+ instalador do kernel. A maioria das distribuições populares terá um script
+ de instalação reconhecido. Talvez você queira verificar antes a
+ configuração da sua distribuição.
+
+ Para fazer a instalação de fato, você precisa ser root, mas nada da
+ compilação normal deve exigir isso. Não tome o nome de root em vão.
+
+ - Se você configurou qualquer parte do kernel como ``modules``, também terá
+ que executar ``make modules_install``.
+
+ - Saída detalhada (verbose) da compilação do kernel:
+
+ Normalmente, o sistema de compilação do kernel roda em um modo bastante
+ silencioso (mas não totalmente). No entanto, às vezes você ou outros
+ desenvolvedores do kernel precisam ver os comandos de compilação, de
+ ligação (link) ou outros exatamente como são executados. Para isso, use o
+ modo de compilação "verbose". Isso é feito passando ``V=1`` ao comando
+ ``make``, por exemplo::
+
+ make V=1 all
+
+ Para que o sistema de compilação também informe o motivo da recompilação
+ de cada alvo, use ``V=2``. O padrão é ``V=0``.
+
+ - Mantenha um kernel de backup à mão, caso algo dê errado. Isso é
+ especialmente verdadeiro para as versões de desenvolvimento, já que cada
+ novo lançamento contém código novo que não foi depurado. Certifique-se de
+ manter também um backup dos módulos correspondentes àquele kernel. Se
+ você estiver instalando um novo kernel com o mesmo número de versão do seu
+ kernel em funcionamento, faça um backup do seu diretório de módulos antes
+ de executar um ``make modules_install``.
+
+ Como alternativa, antes de compilar, use a opção de configuração do kernel
+ "LOCALVERSION" para acrescentar um sufixo único à versão normal do kernel.
+ A LOCALVERSION pode ser definida no menu "General Setup".
+
+ - Para inicializar o seu novo kernel, você precisará copiar a imagem do
+ kernel (por exemplo, .../linux/arch/x86/boot/bzImage após a compilação)
+ para o local onde o seu kernel inicializável habitual se encontra.
+
+ - Inicializar um kernel diretamente de um dispositivo de armazenamento, sem
+ a ajuda de um gerenciador de inicialização como o LILO ou o GRUB, não é
+ mais suportado na BIOS (sistemas não EFI). Em sistemas UEFI/EFI, no
+ entanto, você pode usar o EFISTUB, que permite à placa-mãe inicializar
+ diretamente no kernel. Em estações de trabalho e desktops modernos,
+ geralmente recomenda-se usar um gerenciador de inicialização, pois podem
+ surgir dificuldades com múltiplos kernels e com o secure boot.
+ Para mais detalhes sobre o EFISTUB, veja
+ "Documentation/admin-guide/efi-stub.rst".
+
+ - É importante observar que, desde 2016, o LILO (LInux LOader) não está mais
+ em desenvolvimento ativo, embora, por ter sido extremamente popular,
+ apareça com frequência na documentação. Alternativas populares incluem
+ GRUB2, rEFInd, Syslinux, systemd-boot ou EFISTUB. Por diversas razões, não
+ é recomendável usar software que não esteja mais em desenvolvimento ativo.
+
+ - É provável que a sua distribuição inclua um script de instalação e que
+ executar ``make install`` seja tudo o que é necessário. Caso não seja
+ assim, você terá que identificar o seu gerenciador de inicialização e
+ consultar a documentação dele, ou configurar a sua EFI.
+
+Instruções legadas do LILO
+--------------------------
+
+
+ - Se você usa o LILO, as imagens do kernel são especificadas no arquivo
+ /etc/lilo.conf. O arquivo de imagem do kernel geralmente é /vmlinuz,
+ /boot/vmlinuz, /bzImage ou /boot/bzImage. Para usar o novo kernel, salve
+ uma cópia da imagem antiga e copie a nova imagem por cima da antiga.
+ Então, você DEVE EXECUTAR O LILO NOVAMENTE para atualizar o mapa de
+ carregamento! Se não fizer isso, não conseguirá inicializar a nova imagem
+ do kernel.
+
+ - Reinstalar o LILO geralmente é uma questão de executar /sbin/lilo. Talvez
+ você queira editar o /etc/lilo.conf para especificar uma entrada para a
+ sua imagem antiga do kernel (digamos, /vmlinux.old), caso a nova não
+ funcione. Veja a documentação do LILO para mais informações.
+
+ - Após reinstalar o LILO, deve estar tudo pronto. Desligue o sistema,
+ reinicie e aproveite!
+
+ - Se algum dia você precisar alterar o dispositivo raiz padrão, o modo de
+ vídeo, etc. na imagem do kernel, use as opções de inicialização do seu
+ gerenciador de inicialização onde for apropriado. Não é necessário
+ recompilar o kernel para alterar esses parâmetros.
+
+ - Reinicie com o novo kernel e aproveite.
+
+
+Se algo der errado
+------------------
+
+Se você tiver problemas que pareçam ser causados por bugs do kernel, por
+favor, siga as instruções em
+'Documentation/admin-guide/reporting-issues.rst'.
+
+Dicas sobre como entender os relatórios de bugs do kernel estão em
+'Documentation/admin-guide/bug-hunting.rst'. Mais sobre depuração do kernel
+com o gdb está em
+'Documentation/process/debugging/gdb-kernel-debugging.rst' e
+'Documentation/process/debugging/kgdb.rst'.
diff --git a/Documentation/translations/pt_BR/admin-guide/index.rst b/Documentation/translations/pt_BR/admin-guide/index.rst
index a5ad5baa3..716f6c1f7 100644
--- a/Documentation/translations/pt_BR/admin-guide/index.rst
+++ b/Documentation/translations/pt_BR/admin-guide/index.rst
@@ -21,9 +21,13 @@ Esta seção inicial contém informações gerais, incluindo o arquivo README qu
descreve o kernel como um todo, documentação sobre os parâmetros do kernel,
etc.
+.. toctree::
+ :maxdepth: 1
+
+ README
+
Todolist:
-* README
* devices
* features
--
2.47.3
^ permalink raw reply related [flat|nested] 7+ messages in thread* [PATCH 4/5] docs: translations: pt_BR: translate admin-guide/devices.rst
2026-09-16 17:41 [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Daniel Pereira
` (2 preceding siblings ...)
2026-09-16 17:41 ` [PATCH 3/5] docs: translations: pt_BR: translate admin-guide/README.rst Daniel Pereira
@ 2026-09-16 17:41 ` Daniel Pereira
2026-09-16 17:41 ` [PATCH 5/5] docs: translations: pt_BR: point howto.rst at the translated documents Daniel Pereira
2026-09-26 15:26 ` [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Jonathan Corbet
5 siblings, 0 replies; 7+ messages in thread
From: Daniel Pereira @ 2026-09-16 17:41 UTC (permalink / raw)
To: Jonathan Corbet; +Cc: linux-doc
Translate the Linux Device List document into Brazilian Portuguese and
move it from the Todolist into the toctree of the admin-guide index. The
device registry itself is pulled in with a literal include of the
original devices.txt, so the numbers stay in a single place.
Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
.../pt_BR/admin-guide/devices.rst | 278 ++++++++++++++++++
.../translations/pt_BR/admin-guide/index.rst | 2 +-
2 files changed, 279 insertions(+), 1 deletion(-)
create mode 100644 Documentation/translations/pt_BR/admin-guide/devices.rst
diff --git a/Documentation/translations/pt_BR/admin-guide/devices.rst b/Documentation/translations/pt_BR/admin-guide/devices.rst
new file mode 100644
index 000000000..614a32c33
--- /dev/null
+++ b/Documentation/translations/pt_BR/admin-guide/devices.rst
@@ -0,0 +1,278 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. _pt_BR_admin_devices:
+
+Dispositivos alocados no Linux (versão 4.x+)
+============================================
+
+Esta lista é a Linux Device List, o registro oficial dos números de
+dispositivo alocados e dos nós do diretório ``/dev`` para o sistema
+operacional Linux.
+
+A versão deste documento em lanana.org não é mais mantida. Esta versão, no
+kernel Linux mainline, é o documento mestre. Atualizações devem ser enviadas
+como patches aos mantenedores do kernel (veja o documento
+:ref:`Documentation/translations/pt_BR/process/submitting-patches.rst <pt_BR_submittingpatches>`).
+Explore especificamente as seções intituladas "CHAR and MISC DRIVERS" e
+"BLOCK LAYER" no arquivo MAINTAINERS para encontrar os mantenedores certos
+a envolver para dispositivos de caractere e de bloco.
+
+Este documento é incluído por referência no Filesystem Hierarchy Standard
+(FHS). O FHS está disponível em https://www.pathname.com/fhs/.
+
+Alocações marcadas com (68k/Amiga) aplicam-se somente ao Linux/68k na
+plataforma Amiga. Alocações marcadas com (68k/Atari) aplicam-se somente ao
+Linux/68k na plataforma Atari.
+
+Este documento está em domínio público. Os autores solicitam, no entanto,
+que versões semanticamente alteradas não sejam distribuídas sem permissão
+dos autores, presumindo-se que os autores possam ser contatados sem um
+esforço desarrazoado.
+
+
+.. attention::
+
+ AUTORES DE DRIVERS DE DISPOSITIVO, POR FAVOR LEIAM ISTO
+
+ O Linux agora possui amplo suporte à alocação dinâmica de numeração de
+ dispositivos e pode usar ``sysfs`` e ``udev`` (``systemd``) para lidar com
+ as necessidades de nomenclatura. Ainda existem algumas exceções na área de
+ dispositivos seriais e de inicialização. Antes de pedir um número de
+ dispositivo, certifique-se de que você realmente precisa de um.
+
+ Para ter um número maior (major) alocado, ou um número menor (minor) nas
+ situações em que isso se aplica (por exemplo, busmice), por favor envie um
+ patch aos autores conforme indicado acima.
+
+ Mantenha a descrição do dispositivo *no mesmo formato desta lista*. A razão
+ para isso é que essa é a única maneira que encontramos de garantir que
+ temos todas as informações necessárias para publicar o seu dispositivo e
+ evitar conflitos.
+
+ Por fim, às vezes temos que bancar a "polícia do espaço de nomes". Por
+ favor, não se ofenda. Frequentemente recebemos submissões de nomes em
+ ``/dev`` que fatalmente causariam conflitos no futuro. Estamos tentando
+ evitar chegar a uma situação em que teríamos que sofrer uma mudança
+ incompatível para a frente. Portanto, por favor, consulte-nos **antes** de
+ tornar públicos, de qualquer forma, os nomes e números do seu dispositivo
+ --- pelo menos até o ponto em que seria minimamente difícil alterá-los.
+
+ Sua cooperação é apreciada.
+
+.. include:: ../../../admin-guide/devices.txt
+ :literal:
+
+Entradas adicionais do diretório ``/dev/``
+------------------------------------------
+
+Esta seção detalha as entradas adicionais que devem ou podem existir no
+diretório /dev. É preferível que os links simbólicos usem a mesma forma
+(absoluta ou relativa) indicada aqui. Os links são classificados como
+"físicos" (hard) ou "simbólicos", dependendo do tipo de link preferido; se
+possível, o tipo de link indicado deve ser usado.
+
+Links obrigatórios
+++++++++++++++++++
+
+Estes links devem existir em todos os sistemas:
+
+=============== =============== =============== ==============================
+/dev/fd /proc/self/fd simbólico Descritores de arquivo
+/dev/stdin fd/0 simbólico Descritor de arquivo da stdin
+/dev/stdout fd/1 simbólico Descritor de arquivo da stdout
+/dev/stderr fd/2 simbólico Descritor de arquivo da stderr
+/dev/nfsd socksys simbólico Exigido pelo iBCS-2
+/dev/X0R null simbólico Exigido pelo iBCS-2
+=============== =============== =============== ==============================
+
+Observação: ``/dev/X0R`` é <letra X>-<dígito 0>-<letra R>.
+
+Links recomendados
+++++++++++++++++++
+
+Recomenda-se que estes links existam em todos os sistemas:
+
+
+=============== =============== =============== ==========================
+/dev/core /proc/kcore simbólico Compatibilidade retroativa
+/dev/ramdisk ram0 simbólico Compatibilidade retroativa
+/dev/ftape qft0 simbólico Compatibilidade retroativa
+/dev/bttv0 video0 simbólico Compatibilidade retroativa
+/dev/radio radio0 simbólico Compatibilidade retroativa
+/dev/i2o* /dev/i2o/* simbólico Compatibilidade retroativa
+=============== =============== =============== ==========================
+
+Os nomes alternativos ``/dev/scd?``, sugeridos anteriormente para os
+``/dev/sr?`` de CD-ROM e outras unidades ópticas (que usam comandos SCSI),
+foram removidos na versão 174 do ``udev``, lançada em 2011.
+
+Links definidos localmente
+++++++++++++++++++++++++++
+
+Os links a seguir podem ser estabelecidos localmente para se adequar à
+configuração do sistema. Isto é meramente uma tabulação da prática
+existente, e não constitui uma recomendação. No entanto, se existirem, eles
+devem ter os seguintes usos.
+
+=============== ================= =============== ==============================
+/dev/mouse porta de mouse simbólico Dispositivo de mouse atual
+/dev/tape unidade de fita simbólico Dispositivo de fita atual
+/dev/cdrom unidade de CD-ROM simbólico Dispositivo de CD-ROM atual
+/dev/scanner scanner simbólico Scanner atual
+/dev/modem porta de modem simbólico Dispositivo de discagem atual
+/dev/root dispositivo raiz simbólico Sistema de arquivos raiz atual
+/dev/swap área de swap simbólico Dispositivo de swap atual
+=============== ================= =============== ==============================
+
+O ``/dev/modem`` não deve ser usado para um modem que suporte tanto discagem
+de entrada quanto de saída, pois isso tende a causar problemas com arquivos
+de trava (lock). Se existir, o ``/dev/modem`` deve apontar para o
+dispositivo TTY primário apropriado (o uso dos dispositivos alternativos de
+saída é obsoleto).
+
+Para dispositivos SCSI, o ``/dev/tape`` e o ``/dev/cdrom`` devem apontar
+para os dispositivos *cozidos* (*cooked*) (``/dev/st*`` e ``/dev/sr*``,
+respectivamente), enquanto o ``/dev/scanner`` deve apontar para o
+dispositivo SCSI genérico apropriado (``/dev/sg*``).
+
+O ``/dev/mouse`` pode apontar para um dispositivo TTY serial primário, um
+dispositivo de mouse em hardware, ou um socket para um programa de driver de
+mouse (por exemplo, ``/dev/gpmdata``).
+
+Sockets e pipes
++++++++++++++++
+
+Sockets e pipes nomeados não transitórios podem existir em /dev. As entradas
+comuns são:
+
+=============== ======== =============================
+/dev/printer socket socket local do lpd
+/dev/log socket socket local do syslog
+/dev/gpmdata socket multiplexador de mouse do gpm
+=============== ======== =============================
+
+Pontos de montagem
+++++++++++++++++++
+
+Os nomes a seguir são reservados para a montagem de sistemas de arquivos
+especiais sob /dev. Esses sistemas de arquivos especiais fornecem interfaces
+do kernel que não podem ser fornecidas com nós de dispositivo padrão.
+
+=============== ======== ==================================================
+/dev/pts devpts Sistema de arquivos de escravos PTY
+/dev/shm tmpfs Acesso de manutenção à memória compartilhada POSIX
+=============== ======== ==================================================
+
+Dispositivos de terminal
+------------------------
+
+Dispositivos de terminal, ou TTY, são uma classe especial de dispositivos de
+caractere. Um dispositivo de terminal é qualquer dispositivo que possa atuar
+como terminal de controle de uma sessão; isso inclui consoles virtuais,
+portas seriais e pseudoterminais (PTYs).
+
+Todos os dispositivos de terminal compartilham um conjunto comum de
+capacidades conhecidas como disciplinas de linha (line disciplines); estas
+incluem a disciplina de linha de terminal comum, bem como os modos SLIP e
+PPP.
+
+Todos os dispositivos de terminal são nomeados de forma semelhante; esta
+seção explica a nomenclatura e o uso dos vários tipos de TTY. Observe que as
+convenções de nomenclatura incluem várias verrugas históricas; algumas delas
+são específicas do Linux, algumas foram herdadas de outros sistemas, e
+algumas refletem o Linux tendo superado uma convenção emprestada.
+
+Um sinal de cerquilha (``#``) em um nome de dispositivo é usado aqui para
+indicar um número decimal sem zeros à esquerda.
+
+Consoles virtuais e o dispositivo de console
+++++++++++++++++++++++++++++++++++++++++++++
+
+Consoles virtuais são telas de terminal em tela cheia no monitor de vídeo do
+sistema. Consoles virtuais são nomeados ``/dev/tty#``, com a numeração
+começando em ``/dev/tty1``; o ``/dev/tty0`` é o console virtual atual.
+O ``/dev/tty0`` é o dispositivo que deve ser usado para acessar a placa de
+vídeo do sistema naquelas arquiteturas para as quais os dispositivos de
+frame buffer (``/dev/fb*``) não são aplicáveis. Não use o ``/dev/console``
+para esse fim.
+
+O dispositivo de console, ``/dev/console``, é o dispositivo para o qual as
+mensagens do sistema devem ser enviadas, e no qual os logins devem ser
+permitidos em modo monousuário. A partir do Linux 2.1.71, o ``/dev/console``
+é gerenciado pelo kernel; para versões anteriores, ele deve ser um link
+simbólico para o ``/dev/tty0``, para um console virtual específico como o
+``/dev/tty1``, ou para um dispositivo primário de porta serial (``tty*``,
+não ``cu*``), dependendo da configuração do sistema.
+
+Portas seriais
+++++++++++++++
+
+Portas seriais são portas seriais RS-232 e qualquer dispositivo que simule
+uma, seja em hardware (como modems internos) ou em software (como o driver
+ISDN). No Linux, cada porta serial possui dois nomes de dispositivo: o
+primário, ou de chamada de entrada (callin), e o alternativo, ou de chamada
+de saída (callout). Cada tipo de dispositivo é indicado por uma letra
+diferente. Para qualquer letra X, os nomes dos dispositivos são
+``/dev/ttyX#`` e ``/dev/cux#``, respectivamente; por razões históricas, o
+``/dev/ttyS#`` e o ``/dev/ttyC#`` correspondem ao ``/dev/cua#`` e ao
+``/dev/cub#``. No futuro, deve-se esperar que múltiplas letras sejam usadas;
+todas as letras serão maiúsculas para o dispositivo "tty" (por exemplo,
+``/dev/ttyDP#``) e minúsculas para o dispositivo "cu" (por exemplo,
+``/dev/cudp#``).
+
+Os nomes ``/dev/ttyQ#`` e ``/dev/cuq#`` são reservados para uso local.
+
+Os dispositivos alternativos provêem exclusão baseada no kernel e padrões um
+tanto diferentes dos dispositivos primários. Seu principal propósito é
+permitir o uso de portas seriais com programas sem suporte inerente a portas
+seriais, ou com suporte defeituoso. Seu uso é obsoleto, e eles podem ser
+removidos em uma versão futura do Linux.
+
+A arbitragem de portas seriais é provida pelo uso de arquivos de trava com
+os nomes ``/var/lock/LCK..ttyX#``. O conteúdo do arquivo de trava deve ser o
+PID do processo que está travando, como um número ASCII.
+
+É prática comum instalar links como /dev/modem, que apontam para portas
+seriais. Para garantir o travamento adequado na presença desses links,
+recomenda-se que o software persiga os links simbólicos e trave todos os
+nomes possíveis; adicionalmente, recomenda-se que um arquivo de trava seja
+instalado com o dispositivo alternativo correspondente. Para evitar
+impasses (deadlocks), recomenda-se que as travas sejam adquiridas na
+seguinte ordem, e liberadas na ordem inversa:
+
+ 1. O nome do link simbólico, se houver (``/var/lock/LCK..modem``)
+ 2. O nome "tty" (``/var/lock/LCK..ttyS2``)
+ 3. O nome do dispositivo alternativo (``/var/lock/LCK..cua2``)
+
+No caso de links simbólicos aninhados, os arquivos de trava devem ser
+instalados na ordem em que os links simbólicos são resolvidos.
+
+Sob nenhuma circunstância uma aplicação deve manter uma trava enquanto
+espera que outra seja liberada. Além disso, aplicações que tentam criar
+arquivos de trava para os nomes de dispositivo alternativos correspondentes
+devem levar em conta a possibilidade de serem usadas em um TTY que não seja
+de porta serial, para o qual nenhum dispositivo alternativo existiria.
+
+Pseudoterminais (PTYs)
+++++++++++++++++++++++
+
+Pseudoterminais, ou PTYs, são usados para criar sessões de login ou para
+prover outras capacidades que exijam uma disciplina de linha TTY (incluindo
+capacidade de SLIP ou PPP) a processos arbitrários geradores de dados. Cada
+PTY tem um lado mestre, nomeado ``/dev/pty[p-za-e][0-9a-f]``, e um lado
+escravo, nomeado ``/dev/tty[p-za-e][0-9a-f]``. O kernel arbitra o uso dos
+PTYs permitindo que cada lado mestre seja aberto apenas uma vez.
+
+Uma vez que o lado mestre tenha sido aberto, o dispositivo escravo
+correspondente pode ser usado da mesma maneira que qualquer dispositivo TTY.
+Os dispositivos mestre e escravo são conectados pelo kernel, gerando o
+equivalente a um pipe bidirecional com capacidades de TTY.
+
+Versões recentes dos kernels Linux e da GNU libc contêm suporte ao esquema
+de nomenclatura System V/Unix98 para PTYs, que atribui um dispositivo comum,
+``/dev/ptmx``, a todos os mestres (abri-lo lhe dará automaticamente um PTY
+não atribuído anteriormente) e um subdiretório, ``/dev/pts``, para os
+escravos; os escravos são nomeados com inteiros decimais (``/dev/pts/#`` em
+nossa notação). Isso remove o problema de esgotar o espaço de nomes e
+permite que o kernel crie automaticamente os nós de dispositivo para os
+escravos sob demanda, usando o sistema de arquivos "devpts".
diff --git a/Documentation/translations/pt_BR/admin-guide/index.rst b/Documentation/translations/pt_BR/admin-guide/index.rst
index 716f6c1f7..471b76f00 100644
--- a/Documentation/translations/pt_BR/admin-guide/index.rst
+++ b/Documentation/translations/pt_BR/admin-guide/index.rst
@@ -25,10 +25,10 @@ etc.
:maxdepth: 1
README
+ devices
Todolist:
-* devices
* features
Uma grande parte da interface administrativa do kernel são os sistemas de
--
2.47.3
^ permalink raw reply related [flat|nested] 7+ messages in thread* [PATCH 5/5] docs: translations: pt_BR: point howto.rst at the translated documents
2026-09-16 17:41 [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Daniel Pereira
` (3 preceding siblings ...)
2026-09-16 17:41 ` [PATCH 4/5] docs: translations: pt_BR: translate admin-guide/devices.rst Daniel Pereira
@ 2026-09-16 17:41 ` Daniel Pereira
2026-09-26 15:26 ` [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Jonathan Corbet
5 siblings, 0 replies; 7+ messages in thread
From: Daniel Pereira @ 2026-09-16 17:41 UTC (permalink / raw)
To: Jonathan Corbet; +Cc: linux-doc
The reading list in howto.rst referenced the English version of documents
that are already translated, so a reader of the translation was sent back
to the originals. Add the four missing pt_BR anchors and repoint the nine
references that have a translation available; the remaining three have no
pt_BR counterpart and are left alone.
Signed-off-by: Daniel Pereira <danielmaraboo@gmail.com>
---
.../pt_BR/process/applying-patches.rst | 2 ++
.../translations/pt_BR/process/howto.rst | 19 ++++++++++---------
.../pt_BR/process/kernel-docs.rst | 2 ++
.../pt_BR/process/license-rules.rst | 2 ++
.../pt_BR/process/management-style.rst | 2 ++
5 files changed, 18 insertions(+), 9 deletions(-)
diff --git a/Documentation/translations/pt_BR/process/applying-patches.rst b/Documentation/translations/pt_BR/process/applying-patches.rst
index 37a8d804d..143603b99 100644
--- a/Documentation/translations/pt_BR/process/applying-patches.rst
+++ b/Documentation/translations/pt_BR/process/applying-patches.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_applying_patches:
+
Aplicando Patches ao Kernel Linux
+++++++++++++++++++++++++++++++++
diff --git a/Documentation/translations/pt_BR/process/howto.rst b/Documentation/translations/pt_BR/process/howto.rst
index bcedee727..54ea7fad8 100644
--- a/Documentation/translations/pt_BR/process/howto.rst
+++ b/Documentation/translations/pt_BR/process/howto.rst
@@ -67,7 +67,8 @@ Questões Legais
O código-fonte do kernel Linux é lançado sob a GPL. Por favor, veja o arquivo
COPYING no diretório principal da árvore de fontes. As regras de licenciamento
do kernel Linux e como usar os identificadores `SPDX <https://spdx.org/>`_ no
-código-fonte estão descritas em :ref:`Documentation/process/license-rules.rst <kernel_licensing>`.
+código-fonte estão descritas em
+:ref:`Documentation/translations/pt_BR/process/license-rules.rst <pt_BR_kernel_licensing>`.
Se você tiver mais perguntas sobre a licença, por favor, entre em contato com
um advogado e não pergunte na lista de discussão do kernel Linux. As pessoas
nas listas de discussão não são advogados e você não deve confiar em suas
@@ -94,7 +95,7 @@ a lista linux-api@vger.kernel.org.
Aqui está uma lista de arquivos que estão na árvore de fontes do kernel e
que são de leitura obrigatória:
- :ref:`Documentation/admin-guide/README.rst <readme>`
+ :ref:`Documentation/translations/pt_BR/admin-guide/README.rst <pt_BR_readme>`
Este arquivo fornece um breve histórico sobre o kernel Linux e descreve
o que é necessário fazer para configurar e compilar o kernel. Pessoas
que são novas no kernel devem começar por aqui.
@@ -104,14 +105,14 @@ que são de leitura obrigatória:
software que são necessários para compilar e executar o kernel com
sucesso.
- :ref:`Documentation/process/coding-style.rst <codingstyle>`
+ :ref:`Documentation/translations/pt_BR/process/coding-style.rst <pt_BR_codingstyle>`
Este documento descreve o estilo de codificação do kernel Linux e parte
da fundamentação por trás dele. Espera-se que todo código novo siga as
diretrizes deste documento. A maioria dos mantenedores apenas aceitará
patches se essas regras forem seguidas, e muitas pessoas apenas
revisarão o código se ele estiver no estilo adequado.
- :ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
+ :ref:`Documentation/translations/pt_BR/process/submitting-patches.rst <pt_BR_submittingpatches>`
Este arquivo descreve em detalhes explícitos como criar e enviar
um patch com sucesso, incluindo (mas não limitado a):
@@ -144,12 +145,12 @@ Outras excelentes descrições de como criar patches adequadamente são:
do Linux e é muito importante para pessoas que estão migrando para o
Linux vindas do desenvolvimento em outros Sistemas Operacionais.
- :ref:`Documentation/process/security-bugs.rst <securitybugs>`
+ :ref:`Documentation/translations/pt_BR/process/security-bugs.rst <pt_BR_securitybugs>`
Se você acredita ter encontrado um problema de segurança no kernel Linux,
por favor, siga os passos descritos neste documento para ajudar a
notificar os desenvolvedores do kernel e auxiliar na resolução do problema.
- :ref:`Documentation/process/management-style.rst <managementstyle>`
+ :ref:`Documentation/translations/pt_BR/process/management-style.rst <pt_BR_managementstyle>`
Este documento descreve como os mantenedores do kernel Linux operam e o
ethos compartilhado por trás de suas metodologias. Esta é uma leitura
importante para qualquer pessoa nova no desenvolvimento do kernel (ou
@@ -162,12 +163,12 @@ Outras excelentes descrições de como criar patches adequadamente são:
versões estáveis (stable) do kernel e o que fazer se você desejar que
uma alteração seja incluída em um desses lançamentos.
- :ref:`Documentation/process/kernel-docs.rst <kernel_docs>`
+ :ref:`Documentation/translations/pt_BR/process/kernel-docs.rst <pt_BR_kernel_docs>`
Uma lista de documentação externa que pertence ao desenvolvimento do
kernel. Por favor, consulte esta lista caso não encontre o que está
procurando dentro da documentação interna do kernel.
- :ref:`Documentation/process/applying-patches.rst <applying_patches>`
+ :ref:`Documentation/translations/pt_BR/process/applying-patches.rst <pt_BR_applying_patches>`
Uma boa introdução descrevendo exatamente o que é um patch e como
aplicá-lo aos diferentes ramos (branches) de desenvolvimento do kernel.
@@ -435,7 +436,7 @@ individualmente, em vez de escrever tudo no topo do e-mail.
Se você adicionar patches ao seu e-mail, certifique-se de que sejam texto
puro legível, conforme declarado em
-:ref:`Documentation/process/submitting-patches.rst <submittingpatches>`.
+:ref:`Documentation/translations/pt_BR/process/submitting-patches.rst <pt_BR_submittingpatches>`.
Os desenvolvedores do kernel não querem lidar com anexos ou patches
compactados; eles podem querer comentar linhas individuais do seu patch,
o que só funciona dessa forma. Certifique-se de usar um programa de
diff --git a/Documentation/translations/pt_BR/process/kernel-docs.rst b/Documentation/translations/pt_BR/process/kernel-docs.rst
index 3c8d80ffa..6235b1e7b 100644
--- a/Documentation/translations/pt_BR/process/kernel-docs.rst
+++ b/Documentation/translations/pt_BR/process/kernel-docs.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_kernel_docs:
+
Índice de Documentação Adicional do Kernel
==========================================
diff --git a/Documentation/translations/pt_BR/process/license-rules.rst b/Documentation/translations/pt_BR/process/license-rules.rst
index 1e395dfea..7a801b2a4 100644
--- a/Documentation/translations/pt_BR/process/license-rules.rst
+++ b/Documentation/translations/pt_BR/process/license-rules.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_kernel_licensing:
+
Regras de licenciamento do kernel Linux
=======================================
diff --git a/Documentation/translations/pt_BR/process/management-style.rst b/Documentation/translations/pt_BR/process/management-style.rst
index c40b19b90..9d067e046 100644
--- a/Documentation/translations/pt_BR/process/management-style.rst
+++ b/Documentation/translations/pt_BR/process/management-style.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _pt_BR_managementstyle:
+
Estilo de gerenciamento do kernel Linux
=======================================
--
2.47.3
^ permalink raw reply related [flat|nested] 7+ messages in thread* Re: [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide
2026-09-16 17:41 [PATCH 0/5] docs: translations: pt_BR: fix refs and start admin-guide Daniel Pereira
` (4 preceding siblings ...)
2026-09-16 17:41 ` [PATCH 5/5] docs: translations: pt_BR: point howto.rst at the translated documents Daniel Pereira
@ 2026-09-26 15:26 ` Jonathan Corbet
5 siblings, 0 replies; 7+ messages in thread
From: Jonathan Corbet @ 2026-09-26 15:26 UTC (permalink / raw)
To: Daniel Pereira; +Cc: linux-doc
Daniel Pereira <danielmaraboo@gmail.com> writes:
> This series has two parts.
>
> Patches 1 and 5 fix cross-references across the existing pt_BR
> translation. Several documents pointed at the English version of files
> that are already translated, so a reader of the translation was sent
> back to the original. In code-of-conduct.rst and cve.rst the effect was
> visible in the rendered text, which quoted the English title of the
> referenced document in the middle of a Portuguese sentence. Nine pt_BR
> anchors were missing and are added here; other translations already
> define their own. References whose target has no pt_BR translation are
> left pointing at the English document.
>
> Patches 2 to 4 start the admin-guide translation. The index mirrors the
> section layout of the original and lists the pending documents under a
> Todolist marker, the same way zh_CN tracks its own, so that entries move
> into a toctree as they get translated. README.rst and devices.rst are
> the first two documents. For devices.rst the device registry itself is
> pulled in with a literal include of the original devices.txt, keeping
> the numbers in a single place.
>
> The series was built with "make htmldocs" and produces no new warnings;
> in particular there is no undefined label and no broken toctree entry.
> checkpatch is clean apart from the usual "does MAINTAINERS need
> updating?" advisory on the new files, which is already covered by
> F: Documentation/translations/pt_BR/.
>
> Daniel Pereira (5):
> docs: translations: pt_BR: point refs at the translated documents
> docs: translations: pt_BR: add admin-guide index
> docs: translations: pt_BR: translate admin-guide/README.rst
> docs: translations: pt_BR: translate admin-guide/devices.rst
> docs: translations: pt_BR: point howto.rst at the translated documents
Series applied, thanks.
jon
^ permalink raw reply [flat|nested] 7+ messages in thread