From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=209.85.221.179 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1793676894; b=alnbw0TR13t+wcfM9z1Uaw0SF6yIlWVEhvhUFwMZ2Js0797LgMfeKv1bx7+kHGb2T0ip /kzh1B/qQtwOga8ZhkqwcAi+Fn5RiVvJ8jKUezpW4TA+jJeLDKTcGAOxaMmeK6yM+iITL IfEuaMPGf59E0Hevuq7xhlqrYhJ+RqVrBcwl0kQTxjyA/c9ysyBy96/LTvwuyXMc3Fh2N RxsBOCb2RnoDJcEwVodJH0XT79MsKt7yusaTKUxrCMWUBKHZ3D65xLU/DiwfH6PXz6PFL RSklz0A1H95N8Vpz4M+cJcKux8nGcPMRITVqHC5SdyLQ2nDFRXzEuglNgPKq3yMoXJw== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1793676894; h=DMARC-Filter:Received:DKIM-Signature:X-Google-DKIM-Signature: X-Gm-Message-State:X-Gm-Gg:X-Received:Received:From:To:Cc:Subject: Date:Message-ID:X-Mailer:MIME-Version:Content-Type: Content-Transfer-Encoding; bh=BhOPZw6RsJhz6XrObnIEiqRUu1EHWPuCcuVjWz0UweE=; b=kSRwe4jDcEm3uljSp8kKme/FS/Yd9O8dkDOsKCn7UkMH5Ub5PFeuUfKIBiCy7UqoltlR eWNTn+ao4yN0u/QBKLp1U6EBpvkYPh4dMUV1xx7KNXSkY3wNpe9GB8DNquc0jJ7VtiNOR 4xRGm8mq8sszzDN60NTDeAK4kd8QucYE8EdJAc1TV2rKm6ZqfIDegE8vfarmuEnqNU7s1 lKZs18c0VZnvA989/CCNXcC/fNjV9FiseclMUgShEED1qwwKNzPzXLBH3ICme4dkudZJv OFffpt1p9GTNNo3wWuFiYmqw9fUCtRVsQjse+hxuIjoRTOI7V2e9XrXEmSYNydynEDg== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20260707 header.b=liDJZSqv; arc=none smtp.remote-ip=209.85.221.179 Received: from mail-vk1-f179.google.com (mail-vk1-f179.google.com [209.85.221.179]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 6E5BB606A329 for ; Tue, 3 Nov 2026 03:34:54 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 6E5BB606A329 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key, unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20260707 header.b=liDJZSqv Received: by mail-vk1-f179.google.com with SMTP id 71dfb90a1353d-5ead4026fe6so1492908e0c.2 for ; Mon, 02 Nov 2026 19:34:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20260707; t=1793676893; x=1794281693; darn=vger.kernel.org; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to :content-type; bh=BhOPZw6RsJhz6XrObnIEiqRUu1EHWPuCcuVjWz0UweE=; b=liDJZSqvXHo1AFqXrDnjlBlQGa0D1SK+aUXzusxrq8ByonhrtNVi4JdZrYTpY1rS92 zsFElmS+9Oxb8sPd6Ovpp0rIiKwJzP5/uGJaUFReEDnYxF9W3E9CRXNZcPpEZMWh0Mlq NF2bMyt7nczSAPyyN1Fvq8yz9h5bDxcL+VGYo9HX7DK+pBvisbu0kcYuTCeJAKMLCuBt TCxteu0wFmBqUgpqefU5gE5ZqXJoEmHR1T6cN8B3V43YJodFiaV3sPnVYJPs8fzdOLcY iJOcRjQ1uuSJqIJoBQtvc5N5JO9+ItJ461GNGtLOlf7TbiOq9ISHQufIjSDcC2ZJNFQM KHdg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1793676893; x=1794281693; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to:content-type; bh=BhOPZw6RsJhz6XrObnIEiqRUu1EHWPuCcuVjWz0UweE=; b=QiSRF3JKOGEvMKLHO8HsJQoPXZ15bIo8f8tbZ47U+8DrZCdEX1j8RRHMXRY+KGaIR+ hZrAoyqjVhU/WcCX4KUAmAlinza5katvreWbcUwVsPMBUFxN1rw4oKBJ5gMmOnYKp7Sk i+HvbDYzQ9FZ1dRCDltfjl9KZeXYCqDIV/XbiNPiIrqUNaowp4F0H7CzvWQrClkChK/F X6lP3LZ2KGZeQuvrW3WgzqDiBYmcDhiTDfWVZ/bo2NythY7O5ms/Rs7/N56aaRRZ1xPj lsrb7dMeImLWm6o0AIUaxOfdSihla8rv9A0BWWLuVnWut5hohPjFUGOn4RTKxZAyMP3M 4lhw== X-Gm-Message-State: APuU4Z89Auew8vd3dajjO+wB2kLn9l4SAyE+4j3x+BXMwaLqZM0rAAK/ ZlHuiYUlFodwh020KEh3QscYxJ8H8baBbIjVjbSGp73+KxYghxNQaHnzw0XIWG9o X-Gm-Gg: AYBFou396spotO0REtOpIhjm/GkrHFKClw4YstTPMuX8+pMHfLnXEDYNtcnXqcdaS8j y8Elq7NL7Q4PxWM9iUj4NNTxlNXv0g4S6ec71pAvzDO6tlE6s7sdlgzuGBLMudX1VMio/++Yzxu IyWw/8Jc3D2YQylFTVIcPmVBPmUsMajBPv7IJR7AS9hoOt31cinlvHzoJoo8A8XYYdv8bNDpPuv GRbG1a6ABaGSw8Iu6SGEf12DYZyzFWDmZPCc04DwZTAp5VV/polEaq91/8kyXc/vnCe+2PjCEL8 nMi5DYJyfEt7pEGShkZAix4ZXdZ3reSLIdVYHOYT5LA4S2OTFVSNYR45xPjUgkNLqoPevcElbNf B2lRBa3IX17kprsgVqStSZ3pEJqOSZ+fn4V+EI8XMmo7PJToNUITvYtycL0g3lLzXwbGx0GMKWv iQ4MCKz5E11QzviXlQnEZDew/kPUi2ObgfkixNBNd4yta8AOwtfjov0aPgApwQ7u/Lvw9jhrQgP K3BpdiqCwieHRr9deMSv0KgZw7y/MD+OkgpMbezu1xnutWp4iAvP/ixzBFEGq3P8JOObS1oAxQc 7Q6lC0g5ICfu71ARUq0UCigRpdsr1IKv3bu3+3f+/iIsnD1GWFTHKASDhFCeAs2P899rqJbhp21 zN7Y= X-Received: by 2002:a05:6122:e248:b0:5e9:7458:9bb2 with SMTP id 71dfb90a1353d-5ec6881779bmr4897050e0c.5.1793676893209; Mon, 02 Nov 2026 19:34:53 -0800 (PST) Received: from dell-pro-plus ([2804:29b8:5080:dd51:d55c:b555:e096:bdc4]) by smtp.gmail.com with ESMTPSA id 71dfb90a1353d-5ec8c2385a6sm3925412e0c.14.2026.11.02.19.34.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 02 Nov 2026 19:34:52 -0800 (PST) From: Gabriel Ribeiro 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, ic.gabrielribeiro@gmail.com Subject: [PATCH v2] docs: translations: pt_BR: add init troubleshooting guide Date: Tue, 3 Nov 2026 00:33:49 -0300 Message-ID: <20261103033349.908133-1-ic.gabrielribeiro@gmail.com> X-Mailer: git-send-email 2.56.0 X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Translate the init troubleshooting guide into Brazilian Portuguese and link it from the pt_BR admin-guide index. Signed-off-by: Gabriel Ribeiro --- Changes in v2: - Add a commit-message body. - Match the punctuation in item 2 to the source. - Translate "painless" as "o mais simples possível". .../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 f0f096a74e..cb5a64f829 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 0000000000..f372668ae5 --- /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 + Cristian Souza + +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 |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 +tornada o mais simples 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