mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
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®