From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=74.125.82.172 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1792469654; b=22gcloBZ32CNmTDjGxhwSHfjPtrPwN1dvq9JVpi+NohFoGw0jIC4eHj6N39Nem9GOxWr 7VY2dfe7hcMKcfaF4zX+faRhr+nslAkLnkd3QjDxuE1VMajJ3ki8SCq2mjgkWv6HPCFI8 JhMQ2qbwq6YlCTtUoabWVgSYjdl8Mvw53o4+LFn6/NXUOQptj7QGNzEIfWu24E81DAr+b clEX2bEF0+ay/RZa2CgfwY6c0eaTICoSf4lf2D9Y5g3gLzM1VBHm88kuTpF30KX51LWpz RWdf0w6uj0O9S8kQRFbDl1YubdTB9u3k8227xs5I4B9Xf8wpQKAouu2OfV4eKbOXTOw== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1792469654; h=DMARC-Filter:Received:DKIM-Signature:X-Google-DKIM-Signature: X-Forwarded-Encrypted:X-Gm-Message-State:X-Gm-Gg:X-Received:Received: From:To:Cc:Subject:Date:Message-ID:X-Mailer:In-Reply-To:References: MIME-Version:Content-Type:Content-Transfer-Encoding; bh=6qxPO83MwstX+FjXhsjKFpIDrm4MWUPHITZsYJi7m8s=; b=5OPrUT2ObA/88bPRLqEIPXCiSVoQVJMRxHsODMurn1qyRsIUPZDus+QZvhC5q+HunYZb RcsFgwz57bwgUKk5JJfBR3+ik9J92fAk+rIc0q/ujJgG0716vYGkVVxs1JTBuRLGD0DWT rVqDTskQKyPKsrVgsK3L9cmfvtS+qc801jlfN8nR0FP0AM5Jel0CaZ64RfMSgShbd12+w 0twruqHiTuOXlTuLC4O2/Unaj30spPQqVocPVyEdgHeY3mwlFHv/gVOdijKDgHlTU+nJO LihvDYT5qrGNAxjdnzZp+I6VOousVrQFGLzbLXpaiwjHwnJSTWZvnCQLP0VwmgsvhdQ== 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=20251104 header.b=BGk+haZa; arc=none smtp.remote-ip=74.125.82.172 Received: from mail-dy1-f172.google.com (mail-dy1-f172.google.com [74.125.82.172]) (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 2F911606A31E for ; Tue, 20 Oct 2026 04:14:12 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 2F911606A31E 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=20251104 header.b=BGk+haZa Received: by mail-dy1-f172.google.com with SMTP id 5a478bee46e88-35cd4e8bdbdso6812611eec.1 for ; Mon, 19 Oct 2026 21:14:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1792469652; x=1793074452; darn=vger.kernel.org; h=content-transfer-encoding:content-type:mime-version:references :in-reply-to:message-id:date:subject:cc:to:from:from:to:cc:subject :date:message-id:reply-to:content-type; bh=6qxPO83MwstX+FjXhsjKFpIDrm4MWUPHITZsYJi7m8s=; b=BGk+haZaY97myaC6uSU11n3qvvvCFMYV7WE98KKkqAgHtAM65XQu6vtcxT9c3skJ1r aY/xgD/0i5VHtWUwwApJugGCo6UUASRqfP4Ze+peGxXkz6Vn5aPmiS4pSuYpTMRewAb3 2VB7sHp429EvIhhsRdx2IUNZlBHswtCFiPkYQViExxIfGVXhAk5ND4pz/be4hTMdmHzZ sGlS/earsMHpOKIL0P2LGpE+c9PdeUHudjJL/vnA5VQzVL1flHxID4Lnr+MA7kOuf+BC MfqYpvaRzQ4/yWnMo92+leDXJnrB6Uh2+OAzM74En/dEzLYQc+KB5WxhNE1h4S8fLKep o9ag== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1792469652; x=1793074452; h=content-transfer-encoding:content-type:mime-version:references :in-reply-to: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=6qxPO83MwstX+FjXhsjKFpIDrm4MWUPHITZsYJi7m8s=; b=mCZO4DyXWGYjhGzVODOwDMPx+aAj8EKG5GACmgnoaRdWXH2jYdzNiSJW3X/hoqo2E5 pvZc1rPY65K4kNO0QTz+a1AWCp56CqzpKDHPFpNxCLhQnr/tD0g4QjN1k1dmuDoPbpm3 10P2xTg3YadUOQmSSHXFpvCd86eGiHunxtARk3ZWSny4nFKEnf8/S0yl7B4O8FuO3ZiF ST2oHsLC3anRGjCpbYr7o6srzyr6qBQQIMKvtDt5s9zs5e4P9ihxIgivj28PQEv1FeC9 PP7oNRWwvL+GzDFLbSn386Wv7L8L2Rdupb8KEOTqfY/ac+Ku7pcMCzV22qWr7zm9dShE a9iA== X-Forwarded-Encrypted: i=1; AKwUvBw6AjntrCXdTpinvhDOj1mQN8NKSUuidF354mF8xDMr6y0j+VGiIvd988GLTDaQRzIftIiOAsQw/aw=@vger.kernel.org X-Gm-Message-State: AFq9FYKRsTONssdlaYbtbF80we7mIELkkzBKTsu1HdN/za3p2ZhtIAwi eaoCoTiyWea7s/WJgZBnvAFC+zNsQ8A7IpdH1zzXM5K41dD2q0JMi7JS X-Gm-Gg: AYBFou2UVoPYz6te7OchXsNM5AobsZYJqpBVjO66cjo3DzUnP/0NbuMMXzKhv6eAiH+ QoV/BOsU6oKJgqDbDJgqt9YjLMrJJvPBwLDnUdV3lZikMVE/KENK1T+5Cg8rxIm2STWNsBaCCFt Qy0Y+dbXFuO73IzU5O78BJia2Rmn3jLgb58VuWPAwCqOnmTtcfjl42ViFoRcN0arCkyRTR0yj+L 1avct6p/aeVkrzaSwSi1WfDZcTX7jQCNC1toXZ/vTOL2lDxFWY0slN51h0AQaYUaZsZMGfUeK22 W1ssDXSdj/cz0+L8A7wekQ/zpTl1klxeukeQm0ascvrD5KFZcinMpHt5OkocH8vHD199tj35lDR Egexb9NYLh4drJbEC5MlgV+x7z97HOXBx0ul8x6hSGZr6L2pzvTGtO1dN+FCUq/8RuF9qfLL0+q /NgpR7IA1evNQpiDrr0mBTtQsKTAzL2YLr3DoQFhEEyO9USP9Jhmpwmkapsbc8HcCsal0ZRmCyc ak= X-Received: by 2002:a05:7301:430c:b0:358:8f02:e0ca with SMTP id 5a478bee46e88-361a1668b25mr13231785eec.9.1792469652048; Mon, 19 Oct 2026 21:14:12 -0700 (PDT) Received: from fedora ([2804:29b8:508d:af45:a398:9dc5:b37c:dfa8]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-360826875b3sm38861428eec.21.2026.10.19.21.14.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 19 Oct 2026 21:14:11 -0700 (PDT) From: Lucas Adryell Ramalho To: danielmaraboo@gmail.com, corbet@lwn.net Cc: skhan@linuxfoundation.org, rdunlap@infradead.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Lucas Adryell Ramalho Subject: [PATCH v2 3/3] docs: translations: pt_BR: Translate stable-kernel-rules.rst Date: Tue, 20 Oct 2026 01:13:38 -0300 Message-ID: <20261020041340.447727-4-lucasadramalho@gmail.com> X-Mailer: git-send-email 2.55.0 In-Reply-To: <20261020041340.447727-1-lucasadramalho@gmail.com> References: <20261020041340.447727-1-lucasadramalho@gmail.com> 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 stable kernel rules documentation into Brazilian Portuguese. Signed-off-by: Lucas Adryell Ramalho --- .../translations/pt_BR/process/index.rst | 1 + .../pt_BR/process/stable-kernel-rules.rst | 258 ++++++++++++++++++ 2 files changed, 259 insertions(+) create mode 100644 Documentation/translations/pt_BR/process/stable-kernel-rules.rst diff --git a/Documentation/translations/pt_BR/process/index.rst b/Documentation/translations/pt_BR/process/index.rst index 31704e28d..29f6c7735 100644 --- a/Documentation/translations/pt_BR/process/index.rst +++ b/Documentation/translations/pt_BR/process/index.rst @@ -63,6 +63,7 @@ Estas são as regras pelas quais tentamos viver na comunidade do kernel Declaração de Aplicação do Kernel Linux Declaração sobre Drivers do Kernel A interface de drivers do kernel Linux + Tudo o que você sempre quis saber sobre as versões estáveis do Linux Estilo de gerenciamento do kernel Linux Diretrizes para pesquisadores Assistentes de código diff --git a/Documentation/translations/pt_BR/process/stable-kernel-rules.rst b/Documentation/translations/pt_BR/process/stable-kernel-rules.rst new file mode 100644 index 000000000..201c87150 --- /dev/null +++ b/Documentation/translations/pt_BR/process/stable-kernel-rules.rst @@ -0,0 +1,258 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. _pt_BR_stable_kernel_rules: + +Tudo o que você sempre quis saber sobre as versões estáveis do Linux +==================================================================== + +Regras sobre quais tipos de correções são aceitos na árvore "-stable" e +quais não são: + +- A correção, ou uma equivalente, já deve existir na linha principal do + Linux (upstream). +- Deve estar obviamente correta e ter sido testada. +- Não pode ter mais de 100 linhas, incluindo o contexto. +- Deve seguir as regras de + :ref:`Documentation/translations/pt_BR/process/submitting-patches.rst + `. +- Deve corrigir um erro real que afete as pessoas ou apenas adicionar um ID + de dispositivo. Em mais detalhes, o primeiro caso inclui: + + - Corrigir um problema como um oops, travamento, corrupção de dados, + problema real de segurança, peculiaridade de hardware, erro de + compilação (exceto itens CONFIG_BROKEN) ou algum problema do tipo "isso + não é nada bom". + - Problemas graves relatados por usuários de um kernel de distribuição + também podem ser considerados se as correções resolverem um problema + notável de desempenho ou interatividade. Como essas correções não são + tão óbvias e apresentam maior risco de causar uma regressão sutil, elas + só devem ser enviadas pelo mantenedor do kernel da distribuição e + devem incluir um complemento com um link para uma entrada no Bugzilla, + se houver, e informações adicionais sobre o impacto percebido pelo + usuário. + - Não são aceitos problemas do tipo "isto pode ser um problema...", como + uma "condição de corrida teórica", a menos que também seja fornecida + uma explicação de como o erro pode ser explorado. + - Não são aceitas correções "triviais" sem benefício para os usuários + (alterações ortográficas, limpeza de espaços em branco etc.). + + +Procedimento para enviar correções à árvore -stable +---------------------------------------------------- + +.. note:: + + Correções de segurança não devem ser tratadas exclusivamente pelo + processo de revisão -stable; devem seguir os procedimentos em + :ref:`Documentation/translations/pt_BR/process/security-bugs.rst + `. + +Há três opções para enviar uma alteração às árvores -stable: + +1. Adicionar uma "stable tag" à descrição de uma correção que será enviada + para inclusão na linha principal. +2. Pedir à equipe stable que inclua uma correção já integrada à linha + principal. +3. Enviar à equipe stable uma correção equivalente a uma alteração já + integrada à linha principal. + +As seções abaixo descrevem cada opção em mais detalhes. + +A :ref:`pt_BR_option_1` é **fortemente** preferida; é a opção mais fácil e +mais comum. +A :ref:`pt_BR_option_2` destina-se principalmente a alterações para as +quais o backport não foi considerado no momento do envio. +A :ref:`pt_BR_option_3` é uma alternativa às opções anteriores quando uma +correção integrada à linha principal precisa de ajustes para ser aplicada +a séries mais antigas (por exemplo, devido a alterações na API). + +Ao usar a opção 2 ou 3, você pode pedir que sua alteração seja incluída em +séries stable específicas. Nesse caso, certifique-se de que a correção ou +uma equivalente seja aplicável, tenha sido enviada ou já esteja presente em +todas as árvores stable mais novas que ainda recebem suporte. Isso evita +regressões que os usuários poderiam encontrar ao atualizar. Por exemplo, +uma correção integrada para 5.19-rc1 poderia ser portada para +5.10.y, mas não para 5.15.y. + +.. _pt_BR_option_1: + +Opção 1 +******* + +Para que uma correção enviada para inclusão na linha principal seja +selecionada automaticamente depois pelas árvores stable, adicione esta +etiqueta à seção de assinaturas (sign-off):: + + Cc: stable@vger.kernel.org + +Use ``Cc: stable@kernel.org`` em vez disso ao corrigir vulnerabilidades +ainda não divulgadas: isso reduz a chance de expor acidentalmente a +correção ao público por meio do 'git send-email', pois as mensagens +enviadas a esse endereço não são entregues. + +Depois que a correção for integrada à linha principal, ela será aplicada à +árvore stable sem que o autor ou o mantenedor do subsistema precise fazer +mais nada. + +Para enviar instruções adicionais à equipe stable, use um comentário em +linha no estilo do shell para passar observações arbitrárias ou +predefinidas: + +* Especifique pré-requisitos adicionais para a seleção por cherry-pick:: + + Cc: # 3.3.x: a1f84a3: sched: Check for idle + Cc: # 3.3.x: 1b9508f: sched: Rate-limit newidle + Cc: # 3.3.x: fd21073: sched: Fix affinity logic + Cc: # 3.3.x + Signed-off-by: Ingo Molnar + + A sequência de etiquetas indica que se deve executar:: + + git cherry-pick a1f84a3 + git cherry-pick 1b9508f + git cherry-pick fd21073 + git cherry-pick + + Observe que, em uma série de correções, não é necessário listar como + pré-requisitos as correções que fazem parte da própria série. Por + exemplo, nesta série:: + + patch1 + patch2 + + patch2 depende de patch1, mas não é necessário listar patch1 como + pré-requisito de patch2 se você já tiver marcado patch1 para inclusão no + stable. + +* Indique os pré-requisitos de versão do kernel:: + + Cc: # 3.3.x + + A etiqueta indica que se deve executar:: + + git cherry-pick + + em cada árvore -stable a partir da versão especificada. + + Observe que essa etiqueta é desnecessária se a equipe stable puder + deduzir as versões apropriadas a partir das etiquetas Fixes:. + +* Adiar a inclusão de correções:: + + Cc: # after -rc3 + +* Aponte problemas conhecidos:: + + Cc: # see patch description, needs adjustments for <= 6.3 + +Também há uma variante da etiqueta stable que pode ser usada para fazer com +que as ferramentas de backport da equipe stable (por exemplo, AUTOSEL ou +scripts que procuram commits com uma etiqueta 'Fixes:') ignorem uma +alteração:: + + Cc: # reason goes here, and must be present + +.. _pt_BR_option_2: + +Opção 2 +******* + +Se a correção já tiver sido integrada à linha principal, envie um e-mail +para stable@vger.kernel.org com o assunto da correção, o ID do commit, o +motivo pelo qual você acredita que ela deve ser aplicada e as versões do +kernel às quais deve ser aplicada. + +.. _pt_BR_option_3: + +Opção 3 +******* + +Depois de verificar que a correção segue as regras acima, envie-a para +stable@vger.kernel.org e indique as versões do kernel às quais deseja que +ela seja aplicada. Nesse caso, você deve indicar o ID do commit upstream no +registro de alterações do envio, em uma linha separada acima do texto do +commit, assim:: + + commit upstream. + +Ou, alternativamente:: + + [ Upstream commit ] + +Se a correção enviada diferir da correção upstream original (por exemplo, +porque precisou ser adaptada à API mais antiga), isso deve ser documentado +e justificado com muita clareza na descrição da correção. + + +Acompanhamento do envio +----------------------- + +O remetente receberá um ACK quando a correção for aceita na fila, ou um NAK +se for rejeitada. Essa resposta pode levar alguns dias, dependendo da +disponibilidade dos membros da equipe stable. + +Se for aceita, a correção será adicionada à fila -stable para revisão por +outros desenvolvedores e pelo mantenedor do subsistema relevante. + + +Ciclo de revisão +---------------- + +- Quando os mantenedores -stable decidirem iniciar um ciclo de revisão, as + correções serão enviadas ao comitê de revisão, ao mantenedor da área + afetada pela correção (a menos que o remetente seja o mantenedor dessa + área) e em cópia (CC:) para a lista de discussão linux-kernel. +- O comitê de revisão tem 48 horas para aprovar (ACK) ou rejeitar (NAK) a + correção. +- Se um membro do comitê rejeitar a correção ou membros da lista + linux-kernel apresentarem objeções levantando problemas que os + mantenedores e os membros não perceberam, a correção será removida da + fila. +- As correções aprovadas serão publicadas novamente como parte de uma + versão candidata (-rc), para serem testadas por desenvolvedores e + testadores. +- Geralmente é publicada apenas uma versão -rc. No entanto, se houver + problemas pendentes, algumas correções poderão ser modificadas ou + removidas, ou outras poderão ser adicionadas à fila. Nesse caso, versões + -rc adicionais serão publicadas e testadas até que nenhum problema seja + encontrado. +- É possível responder às versões -rc na lista de discussão enviando um + e-mail "Tested-by:" com as informações de teste desejadas. As etiquetas + "Tested-by:" serão reunidas e adicionadas ao commit de lançamento. +- Ao final do ciclo de revisão, a nova versão -stable será lançada com + todas as correções enfileiradas e testadas. +- Correções de segurança serão aceitas diretamente na árvore -stable pela + equipe de segurança do kernel e não passarão pelo ciclo normal de + revisão. Entre em contato com a equipe de segurança do kernel para saber + mais sobre esse procedimento. + + +Árvores +------- + +- As filas de correções, tanto das versões concluídas quanto das versões em + andamento, podem ser encontradas em: + + https://git.kernel.org/pub/scm/linux/kernel/git/stable/stable-queue.git + +- As versões finalizadas e identificadas por tags de todos os kernels + estáveis podem ser encontradas em ramificações separadas por versão em: + + https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git + +- As versões candidatas de todas as versões do kernel stable podem ser + encontradas em: + + https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable-rc.git/ + + .. warning:: + A árvore -stable-rc é um instantâneo da árvore stable-queue e muda com + frequência; por isso, é rebaseada frequentemente. Ela deve ser usada + apenas para testes (por exemplo, por sistemas de integração contínua). + + +Comitê de revisão +----------------- + +- É formado por vários desenvolvedores do kernel que se voluntariaram para + essa tarefa e por alguns que não se voluntariaram. -- 2.55.0