From: Gabriel Ribeiro <ic.gabrielribeiro@gmail.com>
To: linux-doc@vger.kernel.org
Cc: danielmaraboo@gmail.com, corbet@lwn.net,
skhan@linuxfoundation.org, rdunlap@infradead.org,
sashal@kernel.org, kees@kernel.org, linux-kernel@vger.kernel.org,
Gabriel Ribeiro <ic.gabrielribeiro@gmail.com>
Subject: [PATCH] docs: translations: pt_BR: add init troubleshooting guide
Date: Sat, 31 Oct 2026 11:32:16 -0300 [thread overview]
Message-ID: <20261031143216.70219-1-ic.gabrielribeiro@gmail.com> (raw)
Signed-off-by: Gabriel Ribeiro <ic.gabrielribeiro@gmail.com>
---
.../translations/pt_BR/admin-guide/index.rst | 6 +-
.../translations/pt_BR/admin-guide/init.rst | 58 +++++++++++++++++++
2 files changed, 63 insertions(+), 1 deletion(-)
create mode 100644 Documentation/translations/pt_BR/admin-guide/init.rst
diff --git a/Documentation/translations/pt_BR/admin-guide/index.rst b/Documentation/translations/pt_BR/admin-guide/index.rst
index f0f096a74..cb5a64f82 100644
--- a/Documentation/translations/pt_BR/admin-guide/index.rst
+++ b/Documentation/translations/pt_BR/admin-guide/index.rst
@@ -72,6 +72,11 @@ Rastreando e identificando problemas
Aqui está um conjunto de documentos voltados a usuários que estão tentando
rastrear problemas e bugs em particular.
+.. toctree::
+ :maxdepth: 1
+
+ init
+
Todolist:
* reporting-issues
@@ -83,7 +88,6 @@ Todolist:
* tainted-kernels
* ramoops
* dynamic-debug-howto
-* init
* kdump/index
* perf/index
* pstore-blk
diff --git a/Documentation/translations/pt_BR/admin-guide/init.rst b/Documentation/translations/pt_BR/admin-guide/init.rst
new file mode 100644
index 000000000..2532c07c0
--- /dev/null
+++ b/Documentation/translations/pt_BR/admin-guide/init.rst
@@ -0,0 +1,58 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+Explicando a mensagem de travamento na inicialização: "No working init found."
+==============================================================================
+:Autores: Andreas Mohr <andi at lisas period de>
+ Cristian Souza <cristianmsbr at gmail period com>
+
+Este documento apresenta algumas causas gerais da falha ao carregar o binário
+init (listadas aproximadamente na ordem em que ocorrem).
+
+1) **Não foi possível montar o sistema de arquivos raiz**: Defina o parâmetro
+ do kernel "debug" (no arquivo de configuração do carregador de inicialização
+ ou em CONFIG_CMDLINE) para obter mensagens mais detalhadas do kernel.
+
+2) **O binário init não existe no sistema de arquivos raiz**: Certifique-se de
+ que o tipo do sistema de arquivos raiz está correto (e de que o parâmetro
+ do kernel ``root=`` aponta para a partição correta) e de que os drivers
+ necessários — como os de hardware de armazenamento (por exemplo, SCSI ou
+ USB!) e os de sistema de arquivos (ext3, jffs2 etc.) — são compilados no
+ kernel (ou, alternativamente, estão disponíveis como módulos a serem
+ pré-carregados por um initrd).
+
+3) **Dispositivo de console com problemas**: Possivelmente há um conflito na
+ configuração de ``console=`` que deixa o console inicial indisponível. Por
+ exemplo, alguns consoles seriais não são confiáveis devido a problemas com
+ IRQs seriais (por exemplo, ausência de configuração baseada em interrupções).
+ Tente especificar outro dispositivo no parâmetro ``console=`` ou, por
+ exemplo, usar ``netconsole=``.
+
+4) **O binário existe, mas as dependências não estão disponíveis**: Por
+ exemplo, bibliotecas necessárias ao binário init, como
+ ``/lib/ld-linux.so.2``, podem estar ausentes ou danificadas. Use
+ ``readelf -d <INIT>|grep NEEDED`` para descobrir quais bibliotecas são
+ necessárias.
+
+5) **Não é possível carregar o binário**: Certifique-se de que a arquitetura
+ do binário corresponda à do hardware. Por exemplo, pode haver uma
+ incompatibilidade entre i386 e x86_64 ou uma tentativa de carregar um binário
+ x86 em hardware ARM. Se você tentou carregar aqui um arquivo que não é
+ binário (um script de shell?), certifique-se de que o script
+ especifique um interpretador na linha de shebang do script (``#!/...``)
+ que funcione corretamente, incluindo suas dependências de
+ biblioteca. Antes de investigar scripts, é melhor testar primeiro um
+ binário simples que não seja um script, como ``/bin/sh``, e confirmar que
+ ele é executado com sucesso. Para saber mais, adicione código a
+ ``init/main.c`` para exibir os valores de retorno de kernel_execve().
+
+Amplie esta explicação sempre que encontrar novas causas de falha (afinal,
+carregar o binário init é uma etapa de transição CRÍTICA e difícil, que deve ser
+tão tranquila quanto possível); em seguida, envie um patch à LKML.
+Outras tarefas pendentes:
+
+- Implementar as várias chamadas de ``run_init_process()`` usando um array de
+ estruturas, para armazenar o valor de retorno de cada chamada a
+ ``kernel_execve()`` e, em caso de falha, percorrer **todos** os resultados e
+ registrá-los (uma correção de usabilidade muito importante).
+- Tentar tornar a própria implementação mais útil em geral, por exemplo,
+ fornecendo mensagens de erro adicionais nos pontos afetados.
--
2.56.0
reply other threads:[~2026-10-31 14:32 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261031143216.70219-1-ic.gabrielribeiro@gmail.com \
--to=ic.gabrielribeiro@gmail.com \
--cc=corbet@lwn.net \
--cc=danielmaraboo@gmail.com \
--cc=kees@kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=rdunlap@infradead.org \
--cc=sashal@kernel.org \
--cc=skhan@linuxfoundation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®