€•      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒEnglish”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ/process/maintainer-kvm-x86”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Simplified)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/zh_CN/process/maintainer-kvm-x86”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/zh_TW/process/maintainer-kvm-x86”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/it_IT/process/maintainer-kvm-x86”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ja_JP/process/maintainer-kvm-x86”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ko_KR/process/maintainer-kvm-x86”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/sp_SP/process/maintainer-kvm-x86”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒPortuguese (Brazilian)”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1hµhhh²hh³Œ[/var/lib/git/docbuild/linux/Documentation/translations/pt_BR/process/maintainer-kvm-x86.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒKVM x86”h]”hŒKVM x86”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒ	PrefÃ¡cio”h]”hŒ	PrefÃ¡cio”…””}”(hhàh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÝh²hh³hÇh´KubhŒ	paragraph”“”)”}”(hX  O KVM se esforÃ§a para ser uma comunidade acolhedora; as contribuiÃ§Ãµes de
recÃ©m-chegados sÃ£o valorizadas e incentivadas. Por favor, nÃ£o se sinta
desanimado ou intimidado pela extensÃ£o deste documento e pelas muitas
regras/diretrizes que ele contÃ©m. Todo mundo comete erros e todo mundo jÃ¡ foi um
novato em algum momento. Desde que vocÃª faÃ§a um esforÃ§o honesto para seguir as
diretrizes do KVM x86, seja receptivo ao feedback e aprenda com os erros que
cometer, vocÃª serÃ¡ recebido de braÃ§os abertos, nÃ£o com tochas e forquilhas.”h]”hX  O KVM se esforÃ§a para ser uma comunidade acolhedora; as contribuiÃ§Ãµes de
recÃ©m-chegados sÃ£o valorizadas e incentivadas. Por favor, nÃ£o se sinta
desanimado ou intimidado pela extensÃ£o deste documento e pelas muitas
regras/diretrizes que ele contÃ©m. Todo mundo comete erros e todo mundo jÃ¡ foi um
novato em algum momento. Desde que vocÃª faÃ§a um esforÃ§o honesto para seguir as
diretrizes do KVM x86, seja receptivo ao feedback e aprenda com os erros que
cometer, vocÃª serÃ¡ recebido de braÃ§os abertos, nÃ£o com tochas e forquilhas.”…””}”(hhðh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K	hhÝh²hubeh}”(h]”Œprefacio”ah ]”h"]”Œ	prefÃ¡cio”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒ(TL;DR)”h]”hŒ(TL;DR)”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj  h²hh³hÇh´Kubhï)”}”(hŒTTestes sÃ£o obrigatÃ³rios. Seja consistente com os estilos e padrÃµes estabelecidos.”h]”hŒTTestes sÃ£o obrigatÃ³rios. Seja consistente com os estilos e padrÃµes estabelecidos.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj  h²hubeh}”(h]”Œtl-dr”ah ]”h"]”Œ(tl;dr)”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒÃrvores”h]”hŒÃrvores”…””}”(hj0  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj-  h²hh³hÇh´Kubhï)”}”(hX[  O KVM x86 estÃ¡ atualmente em um perÃ­odo de transiÃ§Ã£o: deixando de fazer parte da
Ã¡rvore principal do KVM para se tornar "apenas mais uma arquitetura KVM". Como tal,
o KVM x86 estÃ¡ dividido entre a Ã¡rvore principal do KVM,
``git.kernel.org/pub/scm/virt/kvm/kvm.git``, e uma Ã¡rvore especÃ­fica para KVM x86,
``github.com/kvm-x86/linux.git``.”h]”(hŒéO KVM x86 estÃ¡ atualmente em um perÃ­odo de transiÃ§Ã£o: deixando de fazer parte da
Ã¡rvore principal do KVM para se tornar â€œapenas mais uma arquitetura KVMâ€. Como tal,
o KVM x86 estÃ¡ dividido entre a Ã¡rvore principal do KVM,
”…””}”(hj>  h²hh³Nh´NubhŒliteral”“”)”}”(hŒ+``git.kernel.org/pub/scm/virt/kvm/kvm.git``”h]”hŒ'git.kernel.org/pub/scm/virt/kvm/kvm.git”…””}”(hjH  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj>  ubhŒ*, e uma Ã¡rvore especÃ­fica para KVM x86,
”…””}”(hj>  h²hh³Nh´NubjG  )”}”(hŒ ``github.com/kvm-x86/linux.git``”h]”hŒgithub.com/kvm-x86/linux.git”…””}”(hjZ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj>  ubhŒ.”…””}”(hj>  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj-  h²hubhï)”}”(hXŽ  De modo geral, as correÃ§Ãµes (fixes) para o ciclo atual sÃ£o aplicadas diretamente
na Ã¡rvore principal do KVM, enquanto todo o desenvolvimento para o prÃ³ximo ciclo
Ã© roteado atravÃ©s da Ã¡rvore do KVM x86. No caso improvÃ¡vel de uma correÃ§Ã£o para o
ciclo atual ser roteada atravÃ©s da Ã¡rvore do KVM x86, ela serÃ¡ aplicada Ã  branch
``fixes`` antes de seguir para a Ã¡rvore principal do KVM.”h]”(hXT  De modo geral, as correÃ§Ãµes (fixes) para o ciclo atual sÃ£o aplicadas diretamente
na Ã¡rvore principal do KVM, enquanto todo o desenvolvimento para o prÃ³ximo ciclo
Ã© roteado atravÃ©s da Ã¡rvore do KVM x86. No caso improvÃ¡vel de uma correÃ§Ã£o para o
ciclo atual ser roteada atravÃ©s da Ã¡rvore do KVM x86, ela serÃ¡ aplicada Ã  branch
”…””}”(hjr  h²hh³Nh´NubjG  )”}”(hŒ	``fixes``”h]”hŒfixes”…””}”(hjz  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjr  ubhŒ1 antes de seguir para a Ã¡rvore principal do KVM.”…””}”(hjr  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj-  h²hubhï)”}”(hŒ{Note que espera-se que este perÃ­odo de transiÃ§Ã£o dure bastante tempo, ou seja,
serÃ¡ o status quo em um futuro prÃ³ximo.”h]”hŒ{Note que espera-se que este perÃ­odo de transiÃ§Ã£o dure bastante tempo, ou seja,
serÃ¡ o status quo em um futuro prÃ³ximo.”…””}”(hj’  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K#hj-  h²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒBranches”h]”hŒBranches”…””}”(hj£  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj   h²hh³hÇh´K'ubhï)”}”(hX  A Ã¡rvore do KVM x86 Ã© organizada em mÃºltiplas branches de tÃ³picos (topic
branches). O objetivo de usar branches de tÃ³picos mais granulares Ã© facilitar o
acompanhamento de uma Ã¡rea especÃ­fica de desenvolvimento e limitar os danos
colaterais de erros humanos e/ou commits com bugs; por exemplo, descartar o
commit HEAD de uma branch de tÃ³pico nÃ£o tem impacto nos hashes SHA1 de outros
commits em andamento, e a necessidade de rejeitar um pull request devido a bugs
atrasa apenas aquela branch de tÃ³pico especÃ­fica.”h]”hX  A Ã¡rvore do KVM x86 Ã© organizada em mÃºltiplas branches de tÃ³picos (topic
branches). O objetivo de usar branches de tÃ³picos mais granulares Ã© facilitar o
acompanhamento de uma Ã¡rea especÃ­fica de desenvolvimento e limitar os danos
colaterais de erros humanos e/ou commits com bugs; por exemplo, descartar o
commit HEAD de uma branch de tÃ³pico nÃ£o tem impacto nos hashes SHA1 de outros
commits em andamento, e a necessidade de rejeitar um pull request devido a bugs
atrasa apenas aquela branch de tÃ³pico especÃ­fica.”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K(hj   h²hubhï)”}”(hX  Todas as branches de tÃ³picos, exceto a ``next`` e a ``fixes``, sÃ£o incorporadas
na ``next`` via um "Cthulhu merge" conforme a necessidade, ou seja, sempre que
uma branch de tÃ³pico Ã© atualizada. Como resultado, force pushes para a branch
``next`` sÃ£o comuns.”h]”(hŒ(Todas as branches de tÃ³picos, exceto a ”…””}”(hj¿  h²hh³Nh´NubjG  )”}”(hŒ``next``”h]”hŒnext”…””}”(hjÇ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj¿  ubhŒ e a ”…””}”(hj¿  h²hh³Nh´NubjG  )”}”(hŒ	``fixes``”h]”hŒfixes”…””}”(hjÙ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj¿  ubhŒ, sÃ£o incorporadas
na ”…””}”(hj¿  h²hh³Nh´NubjG  )”}”(hŒ``next``”h]”hŒnext”…””}”(hjë  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj¿  ubhŒ˜ via um â€œCthulhu mergeâ€ conforme a necessidade, ou seja, sempre que
uma branch de tÃ³pico Ã© atualizada. Como resultado, force pushes para a branch
”…””}”(hj¿  h²hh³Nh´NubjG  )”}”(hŒ``next``”h]”hŒnext”…””}”(hjý  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj¿  ubhŒ sÃ£o comuns.”…””}”(hj¿  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K0hj   h²hubeh}”(h]”Œbranches”ah ]”h"]”Œbranches”ah$]”h&]”uh1hÈhj-  h²hh³hÇh´K'ubhÉ)”}”(hhh]”(hÎ)”}”(hŒCiclo de Vida”h]”hŒCiclo de Vida”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj  h²hh³hÇh´K6ubhï)”}”(hŒÊAs correÃ§Ãµes (fixes) destinadas ao lanÃ§amento atual, tambÃ©m conhecido como
mainline, sÃ£o normalmente aplicadas diretamente na Ã¡rvore principal do KVM, ou
seja, nÃ£o passam pela Ã¡rvore do KVM x86.”h]”hŒÊAs correÃ§Ãµes (fixes) destinadas ao lanÃ§amento atual, tambÃ©m conhecido como
mainline, sÃ£o normalmente aplicadas diretamente na Ã¡rvore principal do KVM, ou
seja, nÃ£o passam pela Ã¡rvore do KVM x86.”…””}”(hj.  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K7hj  h²hubhï)”}”(hXÛ  As mudanÃ§as destinadas ao prÃ³ximo lanÃ§amento sÃ£o roteadas atravÃ©s da Ã¡rvore do
KVM x86. Pull requests (do KVM x86 para o KVM principal) sÃ£o enviados para cada
branch de tÃ³pico do KVM x86, normalmente na semana anterior Ã  abertura da janela
de merge por Linus, por exemplo, na semana seguinte ao rc7 para lanÃ§amentos
"normais". Se tudo correr bem, as branches de tÃ³picos sÃ£o incorporadas ao pull
request principal do KVM enviado durante a janela de merge de Linus.”h]”hXß  As mudanÃ§as destinadas ao prÃ³ximo lanÃ§amento sÃ£o roteadas atravÃ©s da Ã¡rvore do
KVM x86. Pull requests (do KVM x86 para o KVM principal) sÃ£o enviados para cada
branch de tÃ³pico do KVM x86, normalmente na semana anterior Ã  abertura da janela
de merge por Linus, por exemplo, na semana seguinte ao rc7 para lanÃ§amentos
â€œnormaisâ€. Se tudo correr bem, as branches de tÃ³picos sÃ£o incorporadas ao pull
request principal do KVM enviado durante a janela de merge de Linus.”…””}”(hj<  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K;hj  h²hubhï)”}”(hX+  A Ã¡rvore do KVM x86 nÃ£o possui sua prÃ³pria janela de merge oficial, mas hÃ¡ um
"soft close" (fechamento flexÃ­vel) por volta do rc5 para novos recursos, e um
"soft close" por volta do rc6 para correÃ§Ãµes (para o prÃ³ximo lanÃ§amento; veja
acima para correÃ§Ãµes destinadas ao lanÃ§amento atual).”h]”hX3  A Ã¡rvore do KVM x86 nÃ£o possui sua prÃ³pria janela de merge oficial, mas hÃ¡ um
â€œsoft closeâ€ (fechamento flexÃ­vel) por volta do rc5 para novos recursos, e um
â€œsoft closeâ€ por volta do rc6 para correÃ§Ãµes (para o prÃ³ximo lanÃ§amento; veja
acima para correÃ§Ãµes destinadas ao lanÃ§amento atual).”…””}”(hjJ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KBhj  h²hubeh}”(h]”Œciclo-de-vida”ah ]”h"]”Œciclo de vida”ah$]”h&]”uh1hÈhj-  h²hh³hÇh´K6ubeh}”(h]”Œarvores”ah ]”h"]”ŒÃ¡rvores”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒ
Cronograma”h]”hŒ
Cronograma”…””}”(hjk  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh  h²hh³hÇh´KHubhï)”}”(hXü  As submissÃµes sÃ£o normalmente revisadas e aplicadas em ordem FIFO (primeiro a
entrar, primeiro a sair), com alguma margem de manobra para o tamanho de uma
sÃ©rie, patches que estÃ£o "cache hot", etc. CorreÃ§Ãµes (fixes), especialmente para
o lanÃ§amento atual e/ou Ã¡rvores estÃ¡veis (stable trees), tÃªm prioridade na fila.
Patches que serÃ£o aceitos atravÃ©s de uma Ã¡rvore nÃ£o-KVM (mais frequentemente
atravÃ©s da Ã¡rvore "tip") e/ou que possuam outros "acks"/revisÃµes tambÃ©m ganham
certa prioridade.”h]”hX  As submissÃµes sÃ£o normalmente revisadas e aplicadas em ordem FIFO (primeiro a
entrar, primeiro a sair), com alguma margem de manobra para o tamanho de uma
sÃ©rie, patches que estÃ£o â€œcache hotâ€, etc. CorreÃ§Ãµes (fixes), especialmente para
o lanÃ§amento atual e/ou Ã¡rvores estÃ¡veis (stable trees), tÃªm prioridade na fila.
Patches que serÃ£o aceitos atravÃ©s de uma Ã¡rvore nÃ£o-KVM (mais frequentemente
atravÃ©s da Ã¡rvore â€œtipâ€) e/ou que possuam outros â€œacksâ€/revisÃµes tambÃ©m ganham
certa prioridade.”…””}”(hjy  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KIhjh  h²hubhï)”}”(hŒóNote que a grande maioria das revisÃµes Ã© feita entre o rc1 e o rc6,
aproximadamente. O perÃ­odo entre o rc6 e o prÃ³ximo rc1 Ã© usado para colocar
outras tarefas em dia, ou seja, o "silÃªncio de rÃ¡dio" durante este perÃ­odo nÃ£o Ã©
incomum.”h]”hŒ÷Note que a grande maioria das revisÃµes Ã© feita entre o rc1 e o rc6,
aproximadamente. O perÃ­odo entre o rc6 e o prÃ³ximo rc1 Ã© usado para colocar
outras tarefas em dia, ou seja, o â€œsilÃªncio de rÃ¡dioâ€ durante este perÃ­odo nÃ£o Ã©
incomum.”…””}”(hj‡  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KQhjh  h²hubhï)”}”(hXÖ  Pings para obter uma atualizaÃ§Ã£o de status sÃ£o bem-vindos, mas tenha em mente o
tempo do ciclo de lanÃ§amento atual e tenha expectativas realistas. Se vocÃª estÃ¡
dando um ping para aceitaÃ§Ã£o â€” ou seja, nÃ£o apenas para feedback ou uma
atualizaÃ§Ã£o â€” por favor, faÃ§a tudo o que puder, dentro do razoÃ¡vel, para garantir
que seus patches estejam prontos para o merge! Pings em sÃ©ries que quebram o
build ou falham em testes resultam em mantenedores infelizes!”h]”hXÖ  Pings para obter uma atualizaÃ§Ã£o de status sÃ£o bem-vindos, mas tenha em mente o
tempo do ciclo de lanÃ§amento atual e tenha expectativas realistas. Se vocÃª estÃ¡
dando um ping para aceitaÃ§Ã£o â€” ou seja, nÃ£o apenas para feedback ou uma
atualizaÃ§Ã£o â€” por favor, faÃ§a tudo o que puder, dentro do razoÃ¡vel, para garantir
que seus patches estejam prontos para o merge! Pings em sÃ©ries que quebram o
build ou falham em testes resultam em mantenedores infelizes!”…””}”(hj•  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KVhjh  h²hubeh}”(h]”Œ
cronograma”ah ]”h"]”Œ
cronograma”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KHubhÉ)”}”(hhh]”(hÎ)”}”(hŒDesenvolvimento”h]”hŒDesenvolvimento”…””}”(hj®  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj«  h²hh³hÇh´K^ubhÉ)”}”(hhh]”(hÎ)”}”(hŒÃrvore/Branch Base”h]”hŒÃrvore/Branch Base”…””}”(hj¿  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj¼  h²hh³hÇh´Kaubhï)”}”(hXº  CorreÃ§Ãµes destinadas ao lanÃ§amento atual, tambÃ©m conhecido como mainline, devem
ser baseadas em ``git://git.kernel.org/pub/scm/virt/kvm/kvm.git master``. Note
que as correÃ§Ãµes nÃ£o garantem inclusÃ£o automÃ¡tica no lanÃ§amento atual. NÃ£o
existe uma regra Ãºnica, mas tipicamente apenas correÃ§Ãµes para bugs que sejam
urgentes, crÃ­ticos e/ou que tenham sido introduzidos no lanÃ§amento atual devem
ser destinadas ao lanÃ§amento atual.”h]”(hŒdCorreÃ§Ãµes destinadas ao lanÃ§amento atual, tambÃ©m conhecido como mainline, devem
ser baseadas em ”…””}”(hjÍ  h²hh³Nh´NubjG  )”}”(hŒ8``git://git.kernel.org/pub/scm/virt/kvm/kvm.git master``”h]”hŒ4git://git.kernel.org/pub/scm/virt/kvm/kvm.git master”…””}”(hjÕ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjÍ  ubhX  . Note
que as correÃ§Ãµes nÃ£o garantem inclusÃ£o automÃ¡tica no lanÃ§amento atual. NÃ£o
existe uma regra Ãºnica, mas tipicamente apenas correÃ§Ãµes para bugs que sejam
urgentes, crÃ­ticos e/ou que tenham sido introduzidos no lanÃ§amento atual devem
ser destinadas ao lanÃ§amento atual.”…””}”(hjÍ  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kbhj¼  h²hubhï)”}”(hŒüTodo o restante deve ser baseado em ``kvm-x86/next``, ou seja, nÃ£o hÃ¡
necessidade de selecionar uma branch de tÃ³pico especÃ­fica como base. Se houver
conflitos e/ou dependÃªncias entre as branches de tÃ³picos, Ã© trabalho do
mantenedor resolvÃª-los.”h]”(hŒ$Todo o restante deve ser baseado em ”…””}”(hjí  h²hh³Nh´NubjG  )”}”(hŒ``kvm-x86/next``”h]”hŒkvm-x86/next”…””}”(hjõ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjí  ubhŒÈ, ou seja, nÃ£o hÃ¡
necessidade de selecionar uma branch de tÃ³pico especÃ­fica como base. Se houver
conflitos e/ou dependÃªncias entre as branches de tÃ³picos, Ã© trabalho do
mantenedor resolvÃª-los.”…””}”(hjí  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kihj¼  h²hubhï)”}”(hXs  A Ãºnica exceÃ§Ã£o ao uso da ``kvm-x86/next`` como base Ã© se um patch/sÃ©rie for uma
sÃ©rie multi-arquitetura (multi-arch), ou seja, possuir modificaÃ§Ãµes nÃ£o triviais
no cÃ³digo comum do KVM e/ou possuir mudanÃ§as mais do que superficiais no cÃ³digo
de outras arquiteturas. Patches/sÃ©ries multi-arquitetura devem, em vez disso,
ser baseados em um ponto comum e estÃ¡vel no histÃ³rico do KVM, por exemplo, o
release candidate no qual a ``kvm-x86 next`` se baseia. Se vocÃª nÃ£o tiver
certeza se um patch/sÃ©rie Ã© verdadeiramente multi-arquitetura, erre pelo lado da
cautela e trate-o como tal, ou seja, use uma base comum.”h]”(hŒA Ãºnica exceÃ§Ã£o ao uso da ”…””}”(hj  h²hh³Nh´NubjG  )”}”(hŒ``kvm-x86/next``”h]”hŒkvm-x86/next”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj  ubhX‹   como base Ã© se um patch/sÃ©rie for uma
sÃ©rie multi-arquitetura (multi-arch), ou seja, possuir modificaÃ§Ãµes nÃ£o triviais
no cÃ³digo comum do KVM e/ou possuir mudanÃ§as mais do que superficiais no cÃ³digo
de outras arquiteturas. Patches/sÃ©ries multi-arquitetura devem, em vez disso,
ser baseados em um ponto comum e estÃ¡vel no histÃ³rico do KVM, por exemplo, o
release candidate no qual a ”…””}”(hj  h²hh³Nh´NubjG  )”}”(hŒ``kvm-x86 next``”h]”hŒkvm-x86 next”…””}”(hj'  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj  ubhŒ« se baseia. Se vocÃª nÃ£o tiver
certeza se um patch/sÃ©rie Ã© verdadeiramente multi-arquitetura, erre pelo lado da
cautela e trate-o como tal, ou seja, use uma base comum.”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Knhj¼  h²hubeh}”(h]”Œarvore-branch-base”ah ]”h"]”ŒÃ¡rvore/branch base”ah$]”h&]”uh1hÈhj«  h²hh³hÇh´KaubhÉ)”}”(hhh]”(hÎ)”}”(hŒEstilo de CodificaÃ§Ã£o”h]”hŒEstilo de CodificaÃ§Ã£o”…””}”(hjJ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjG  h²hh³hÇh´Kxubhï)”}”(hŒ›Quando se trata de estilo, nomenclatura, padrÃµes, etc., a consistÃªncia Ã© a
prioridade nÃºmero um no KVM x86. Se tudo mais falhar, siga o que jÃ¡ existe.”h]”hŒ›Quando se trata de estilo, nomenclatura, padrÃµes, etc., a consistÃªncia Ã© a
prioridade nÃºmero um no KVM x86. Se tudo mais falhar, siga o que jÃ¡ existe.”…””}”(hjX  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KyhjG  h²hubhï)”}”(hXA  Com algumas ressalvas listadas abaixo, siga o estilo de codificaÃ§Ã£o preferido
dos mantenedores da Ã¡rvore "tip" (:ref:`maintainer-tip-coding-style`), jÃ¡ que
patches/sÃ©ries frequentemente tocam tanto arquivos do KVM quanto arquivos x86
nÃ£o-KVM, ou seja, atraem a atenÃ§Ã£o de mantenedores do KVM *e* da Ã¡rvore "tip".”h]”(hŒwCom algumas ressalvas listadas abaixo, siga o estilo de codificaÃ§Ã£o preferido
dos mantenedores da Ã¡rvore â€œtipâ€ (”…””}”(hjf  h²hh³Nh´Nubh)”}”(hŒ":ref:`maintainer-tip-coding-style`”h]”hŒinline”“”)”}”(hjp  h]”hŒmaintainer-tip-coding-style”…””}”(hjt  h²hh³Nh´Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1jr  hjn  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œ-translations/pt_BR/process/maintainer-kvm-x86”Œ	refdomain”j  Œreftype”Œref”Œrefexplicit”‰Œrefwarn”ˆŒ	reftarget”Œmaintainer-tip-coding-style”uh1hh³hÇh´K|hjf  ubhŒ—), jÃ¡ que
patches/sÃ©ries frequentemente tocam tanto arquivos do KVM quanto arquivos x86
nÃ£o-KVM, ou seja, atraem a atenÃ§Ã£o de mantenedores do KVM ”…””}”(hjf  h²hh³Nh´NubhŒemphasis”“”)”}”(hŒ*e*”h]”hŒe”…””}”(hj™  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hjf  ubhŒ da Ã¡rvore â€œtipâ€.”…””}”(hjf  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K|hjG  h²hubhï)”}”(hŒÏO uso de "reverse fir tree" (Ã¡rvore de abeto invertida), tambÃ©m conhecido como
"Ã¡rvore de Natal invertida", para declaraÃ§Ãµes de variÃ¡veis nÃ£o Ã© estritamente
obrigatÃ³rio, embora ainda seja preferido.”h]”hŒ×O uso de â€œreverse fir treeâ€ (Ã¡rvore de abeto invertida), tambÃ©m conhecido como
â€œÃ¡rvore de Natal invertidaâ€, para declaraÃ§Ãµes de variÃ¡veis nÃ£o Ã© estritamente
obrigatÃ³rio, embora ainda seja preferido.”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KhjG  h²hubhï)”}”(hX-  Exceto por alguns casos excepcionais, nÃ£o use comentÃ¡rios kernel-doc para
funÃ§Ãµes. A grande maioria das funÃ§Ãµes "pÃºblicas" do KVM nÃ£o sÃ£o verdadeiramente
pÃºblicas, pois se destinam apenas ao consumo interno do KVM (hÃ¡ planos para
privatizar os headers e exports do KVM para reforÃ§ar isso).”h]”hX1  Exceto por alguns casos excepcionais, nÃ£o use comentÃ¡rios kernel-doc para
funÃ§Ãµes. A grande maioria das funÃ§Ãµes â€œpÃºblicasâ€ do KVM nÃ£o sÃ£o verdadeiramente
pÃºblicas, pois se destinam apenas ao consumo interno do KVM (hÃ¡ planos para
privatizar os headers e exports do KVM para reforÃ§ar isso).”…””}”(hj¿  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K…hjG  h²hubeh}”(h]”Œestilo-de-codificacao”ah ]”h"]”Œestilo de codificaÃ§Ã£o”ah$]”h&]”uh1hÈhj«  h²hh³hÇh´KxubhÉ)”}”(hhh]”(hÎ)”}”(hŒComentÃ¡rios”h]”hŒComentÃ¡rios”…””}”(hjØ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÕ  h²hh³hÇh´K‹ubhï)”}”(hXS  Escreva comentÃ¡rios usando o modo imperativo e evite pronomes. Use comentÃ¡rios
para fornecer uma visÃ£o geral de alto nÃ­vel do cÃ³digo e/ou para explicar por
que o cÃ³digo faz o que faz. NÃ£o reitere o que o cÃ³digo faz literalmente; deixe
o cÃ³digo falar por si mesmo. Se o cÃ³digo em si for inescrutÃ¡vel, comentÃ¡rios
nÃ£o ajudarÃ£o.”h]”hXS  Escreva comentÃ¡rios usando o modo imperativo e evite pronomes. Use comentÃ¡rios
para fornecer uma visÃ£o geral de alto nÃ­vel do cÃ³digo e/ou para explicar por
que o cÃ³digo faz o que faz. NÃ£o reitere o que o cÃ³digo faz literalmente; deixe
o cÃ³digo falar por si mesmo. Se o cÃ³digo em si for inescrutÃ¡vel, comentÃ¡rios
nÃ£o ajudarÃ£o.”…””}”(hjæ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KŒhjÕ  h²hubeh}”(h]”Œcomentarios”ah ]”h"]”ŒcomentÃ¡rios”ah$]”h&]”uh1hÈhj«  h²hh³hÇh´K‹ubhÉ)”}”(hhh]”(hÎ)”}”(hŒReferÃªncias ao SDM e ao APM”h]”hŒReferÃªncias ao SDM e ao APM”…””}”(hjÿ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjü  h²hh³hÇh´K“ubhï)”}”(hXR  Grande parte da base de cÃ³digo do KVM estÃ¡ diretamente ligada ao comportamento
arquitetural definido no Manual de Desenvolvimento de Software (SDM) da Intel e
no Manual do Programador de Arquitetura (APM) da AMD. O uso de "Intel SDM" e
"AMD APM", ou atÃ© mesmo apenas "SDM" ou "APM", sem contexto adicional, Ã©
perfeitamente aceitÃ¡vel.”h]”hXb  Grande parte da base de cÃ³digo do KVM estÃ¡ diretamente ligada ao comportamento
arquitetural definido no Manual de Desenvolvimento de Software (SDM) da Intel e
no Manual do Programador de Arquitetura (APM) da AMD. O uso de â€œIntel SDMâ€ e
â€œAMD APMâ€, ou atÃ© mesmo apenas â€œSDMâ€ ou â€œAPMâ€, sem contexto adicional, Ã©
perfeitamente aceitÃ¡vel.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K”hjü  h²hubhï)”}”(hXJ  NÃ£o faÃ§a referÃªncia a seÃ§Ãµes, tabelas, figuras, etc., por nÃºmero, especialmente
em comentÃ¡rios. Em vez disso, se necessÃ¡rio (veja abaixo), copie e cole o trecho
relevante e referencie seÃ§Ãµes/tabelas/figuras pelo nome. Os layouts do SDM e do
APM mudam constantemente e, portanto, os nÃºmeros/rÃ³tulos nÃ£o sÃ£o estÃ¡veis.”h]”hXJ  NÃ£o faÃ§a referÃªncia a seÃ§Ãµes, tabelas, figuras, etc., por nÃºmero, especialmente
em comentÃ¡rios. Em vez disso, se necessÃ¡rio (veja abaixo), copie e cole o trecho
relevante e referencie seÃ§Ãµes/tabelas/figuras pelo nome. Os layouts do SDM e do
APM mudam constantemente e, portanto, os nÃºmeros/rÃ³tulos nÃ£o sÃ£o estÃ¡veis.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kšhjü  h²hubhï)”}”(hX£  De modo geral, nÃ£o faÃ§a referÃªncia explÃ­cita nem copie e cole do SDM ou do APM
em comentÃ¡rios. Com poucas exceÃ§Ãµes, o KVM *deve* respeitar o comportamento
arquitetural; portanto, subentende-se que o comportamento do KVM estÃ¡ emulando o
comportamento do SDM e/ou do APM. Note que fazer referÃªncia ao SDM/APM em
changelogs para justificar a mudanÃ§a e fornecer contexto Ã© perfeitamente
aceitÃ¡vel e incentivado.”h]”(hŒDe modo geral, nÃ£o faÃ§a referÃªncia explÃ­cita nem copie e cole do SDM ou do APM
em comentÃ¡rios. Com poucas exceÃ§Ãµes, o KVM ”…””}”(hj)  h²hh³Nh´Nubj˜  )”}”(hŒ*deve*”h]”hŒdeve”…””}”(hj1  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj)  ubhX   respeitar o comportamento
arquitetural; portanto, subentende-se que o comportamento do KVM estÃ¡ emulando o
comportamento do SDM e/ou do APM. Note que fazer referÃªncia ao SDM/APM em
changelogs para justificar a mudanÃ§a e fornecer contexto Ã© perfeitamente
aceitÃ¡vel e incentivado.”…””}”(hj)  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KŸhjü  h²hubeh}”(h]”Œreferencias-ao-sdm-e-ao-apm”ah ]”h"]”ŒreferÃªncias ao sdm e ao apm”ah$]”h&]”uh1hÈhj«  h²hh³hÇh´K“ubhÉ)”}”(hhh]”(hÎ)”}”(hŒShortlog”h]”hŒShortlog”…””}”(hjT  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjQ  h²hh³hÇh´K§ubhï)”}”(hŒ^O formato de prefixo preferencial Ã© ``KVM: <topic>:``, onde ``<topic>`` Ã© um dos
seguintes::”h]”(hŒ%O formato de prefixo preferencial Ã© ”…””}”(hjb  h²hh³Nh´NubjG  )”}”(hŒ``KVM: <topic>:``”h]”hŒKVM: <topic>:”…””}”(hjj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjb  ubhŒ, onde ”…””}”(hjb  h²hh³Nh´NubjG  )”}”(hŒ``<topic>``”h]”hŒ<topic>”…””}”(hj|  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjb  ubhŒ Ã© um dos
seguintes:”…””}”(hjb  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K¨hjQ  h²hubhŒliteral_block”“”)”}”(hŒI- x86
- x86/mmu
- x86/pmu
- x86/xen
- selftests
- SVM
- nSVM
- VMX
- nVMX”h]”hŒI- x86
- x86/mmu
- x86/pmu
- x86/xen
- selftests
- SVM
- nSVM
- VMX
- nVMX”…””}”hj–  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j”  h³hÇh´K«hjQ  h²hubhï)”}”(hŒû**NÃƒO use x86/kvm!** ``x86/kvm`` Ã© usado exclusivamente para mudanÃ§as no Linux
como convidado (guest) de um KVM, ou seja, para ``arch/x86/kernel/kvm.c``. NÃ£o
use nomes de arquivos ou caminhos completos de arquivos como prefixo do
assunto/shortlog.”h]”(hŒstrong”“”)”}”(hŒ**NÃƒO use x86/kvm!**”h]”hŒNÃƒO use x86/kvm!”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j¨  hj¤  ubhŒ ”…””}”(hj¤  h²hh³Nh´NubjG  )”}”(hŒ``x86/kvm``”h]”hŒx86/kvm”…””}”(hj¼  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj¤  ubhŒa Ã© usado exclusivamente para mudanÃ§as no Linux
como convidado (guest) de um KVM, ou seja, para ”…””}”(hj¤  h²hh³Nh´NubjG  )”}”(hŒ``arch/x86/kernel/kvm.c``”h]”hŒarch/x86/kernel/kvm.c”…””}”(hjÎ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj¤  ubhŒ`. NÃ£o
use nomes de arquivos ou caminhos completos de arquivos como prefixo do
assunto/shortlog.”…””}”(hj¤  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KµhjQ  h²hubhï)”}”(hŒ†Note que estes nÃ£o se alinham com as branches de tÃ³picos (as branches de tÃ³picos
se preocupam muito mais com conflitos de cÃ³digo).”h]”hŒ†Note que estes nÃ£o se alinham com as branches de tÃ³picos (as branches de tÃ³picos
se preocupam muito mais com conflitos de cÃ³digo).”…””}”(hjæ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KºhjQ  h²hubhï)”}”(hŒhTodos os nomes sÃ£o sensÃ­veis a maiÃºsculas e minÃºsculas! ``KVM: x86:`` Ã© bom,
``kvm: vmx:`` nÃ£o Ã©.”h]”(hŒ<Todos os nomes sÃ£o sensÃ­veis a maiÃºsculas e minÃºsculas! ”…””}”(hjô  h²hh³Nh´NubjG  )”}”(hŒ``KVM: x86:``”h]”hŒ	KVM: x86:”…””}”(hjü  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjô  ubhŒ	 Ã© bom,
”…””}”(hjô  h²hh³Nh´NubjG  )”}”(hŒ``kvm: vmx:``”h]”hŒ	kvm: vmx:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjô  ubhŒ	 nÃ£o Ã©.”…””}”(hjô  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K½hjQ  h²hubhï)”}”(hŒwComece com letra maiÃºscula a primeira palavra da descriÃ§Ã£o condensada do patch,
mas omita a pontuaÃ§Ã£o final. Ex.::”h]”hŒvComece com letra maiÃºscula a primeira palavra da descriÃ§Ã£o condensada do patch,
mas omita a pontuaÃ§Ã£o final. Ex.:”…””}”(hj&  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KÀhjQ  h²hubj•  )”}”(hŒ:KVM: x86: Fix a null pointer dereference in function_xyz()”h]”hŒ:KVM: x86: Fix a null pointer dereference in function_xyz()”…””}”hj4  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j”  h³hÇh´KÃhjQ  h²hubhï)”}”(hŒe nÃ£o::”h]”hŒe nÃ£o:”…””}”(hjB  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KÅhjQ  h²hubj•  )”}”(hŒ9kvm: x86: fix a null pointer dereference in function_xyz.”h]”hŒ9kvm: x86: fix a null pointer dereference in function_xyz.”…””}”hjP  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j”  h³hÇh´KÇhjQ  h²hubhï)”}”(hŒáSe um patch tocar em mÃºltiplos tÃ³picos, suba na Ã¡rvore conceitual para encontrar
o primeiro pai comum (que geralmente Ã© apenas ``x86``). Em caso de dÃºvida,
``git log caminho/do/arquivo`` deve fornecer uma dica razoÃ¡vel.”h]”(hŒƒSe um patch tocar em mÃºltiplos tÃ³picos, suba na Ã¡rvore conceitual para encontrar
o primeiro pai comum (que geralmente Ã© apenas ”…””}”(hj^  h²hh³Nh´NubjG  )”}”(hŒ``x86``”h]”hŒx86”…””}”(hjf  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj^  ubhŒ). Em caso de dÃºvida,
”…””}”(hj^  h²hh³Nh´NubjG  )”}”(hŒ``git log caminho/do/arquivo``”h]”hŒgit log caminho/do/arquivo”…””}”(hjx  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj^  ubhŒ" deve fornecer uma dica razoÃ¡vel.”…””}”(hj^  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KÉhjQ  h²hubhï)”}”(hŒ¯Novos tÃ³picos surgem ocasionalmente, mas, por favor, inicie uma discussÃ£o na
lista se desejar propor a introduÃ§Ã£o de um novo tÃ³pico; ou seja, nÃ£o aja por
conta prÃ³pria.”h]”hŒ¯Novos tÃ³picos surgem ocasionalmente, mas, por favor, inicie uma discussÃ£o na
lista se desejar propor a introduÃ§Ã£o de um novo tÃ³pico; ou seja, nÃ£o aja por
conta prÃ³pria.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KÍhjQ  h²hubhï)”}”(hX“  Veja :ref:`the_canonical_patch_format` para mais informaÃ§Ãµes, com uma ressalva:
nÃ£o trate o limite de 70-75 caracteres como um limite absoluto e rÃ­gido. Em
vez disso, use 75 caracteres como um limite firme, mas nÃ£o rÃ­gido, e use 80
caracteres como um limite intransponÃ­vel. Ou seja, permita que o shortlog
ultrapasse alguns caracteres do limite padrÃ£o se vocÃª tiver um bom motivo para
fazÃª-lo.”h]”(hŒVeja ”…””}”(hjž  h²hh³Nh´Nubh)”}”(hŒ!:ref:`the_canonical_patch_format`”h]”js  )”}”(hj¨  h]”hŒthe_canonical_patch_format”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”(j~  Œstd”Œstd-ref”eh"]”h$]”h&]”uh1jr  hj¦  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j‹  Œ	refdomain”j´  Œreftype”Œref”Œrefexplicit”‰Œrefwarn”ˆj‘  Œthe_canonical_patch_format”uh1hh³hÇh´KÑhjž  ubhXm   para mais informaÃ§Ãµes, com uma ressalva:
nÃ£o trate o limite de 70-75 caracteres como um limite absoluto e rÃ­gido. Em
vez disso, use 75 caracteres como um limite firme, mas nÃ£o rÃ­gido, e use 80
caracteres como um limite intransponÃ­vel. Ou seja, permita que o shortlog
ultrapasse alguns caracteres do limite padrÃ£o se vocÃª tiver um bom motivo para
fazÃª-lo.”…””}”(hjž  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KÑhjQ  h²hubeh}”(h]”Œshortlog”ah ]”h"]”Œshortlog”ah$]”h&]”uh1hÈhj«  h²hh³hÇh´K§ubhÉ)”}”(hhh]”(hÎ)”}”(hŒ	Changelog”h]”hŒ	Changelog”…””}”(hjÛ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjØ  h²hh³hÇh´KÙubhï)”}”(hŒ\O mais importante: escreva os changelogs usando o modo imperativo e evite o uso
de pronomes.”h]”hŒ\O mais importante: escreva os changelogs usando o modo imperativo e evite o uso
de pronomes.”…””}”(hjé  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KÚhjØ  h²hubhï)”}”(hX—  Veja :ref:`describe_changes` para mais informaÃ§Ãµes, com uma ressalva: comece com
uma breve descriÃ§Ã£o das mudanÃ§as reais e, em seguida, apresente o contexto e o
histÃ³rico. Note! Esta ordem entra em conflito direto com a abordagem preferida
da Ã¡rvore "tip"! Por favor, siga o estilo preferido da Ã¡rvore "tip" ao enviar
patches que visam primariamente o cÃ³digo de arch/x86 que _NÃƒO_ seja cÃ³digo KVM.”h]”(hŒVeja ”…””}”(hj÷  h²hh³Nh´Nubh)”}”(hŒ:ref:`describe_changes`”h]”js  )”}”(hj  h]”hŒdescribe_changes”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”(j~  Œstd”Œstd-ref”eh"]”h$]”h&]”uh1jr  hjÿ  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j‹  Œ	refdomain”j  Œreftype”Œref”Œrefexplicit”‰Œrefwarn”ˆj‘  Œdescribe_changes”uh1hh³hÇh´KÝhj÷  ubhXƒ   para mais informaÃ§Ãµes, com uma ressalva: comece com
uma breve descriÃ§Ã£o das mudanÃ§as reais e, em seguida, apresente o contexto e o
histÃ³rico. Note! Esta ordem entra em conflito direto com a abordagem preferida
da Ã¡rvore â€œtipâ€! Por favor, siga o estilo preferido da Ã¡rvore â€œtipâ€ ao enviar
patches que visam primariamente o cÃ³digo de arch/x86 que _NÃƒO_ seja cÃ³digo KVM.”…””}”(hj÷  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KÝhjØ  h²hubhï)”}”(hXË  Declarar o que um patch faz antes de mergulhar nos detalhes Ã© preferido pelo KVM
x86 por vÃ¡rios motivos. Primeiro e mais importante, qual cÃ³digo estÃ¡ sendo
realmente alterado Ã©, reconhecidamente, a informaÃ§Ã£o mais importante e,
portanto, essa informaÃ§Ã£o deve ser fÃ¡cil de encontrar. Changelogs que escondem
"o que estÃ¡ mudando de fato" em uma Ãºnica linha apÃ³s 3 ou mais parÃ¡grafos de
histÃ³rico tornam muito difÃ­cil encontrar essa informaÃ§Ã£o.”h]”hXÏ  Declarar o que um patch faz antes de mergulhar nos detalhes Ã© preferido pelo KVM
x86 por vÃ¡rios motivos. Primeiro e mais importante, qual cÃ³digo estÃ¡ sendo
realmente alterado Ã©, reconhecidamente, a informaÃ§Ã£o mais importante e,
portanto, essa informaÃ§Ã£o deve ser fÃ¡cil de encontrar. Changelogs que escondem
â€œo que estÃ¡ mudando de fatoâ€ em uma Ãºnica linha apÃ³s 3 ou mais parÃ¡grafos de
histÃ³rico tornam muito difÃ­cil encontrar essa informaÃ§Ã£o.”…””}”(hj)  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KãhjØ  h²hubhï)”}”(hXÄ  Para uma revisÃ£o inicial, pode-se argumentar que "o que estÃ¡ quebrado" Ã© mais
importante, mas para uma leitura rÃ¡pida de logs e arqueologia do git, os
detalhes minuciosos importam cada vez menos. Por exemplo, ao fazer uma sÃ©rie de
"git blame", os detalhes de cada mudanÃ§a ao longo do caminho sÃ£o inÃºteis; os
detalhes sÃ³ importam para o culpado. Fornecer "o que mudou" facilita determinar
rapidamente se um commit pode ou nÃ£o ser de interesse.”h]”hXÐ  Para uma revisÃ£o inicial, pode-se argumentar que â€œo que estÃ¡ quebradoâ€ Ã© mais
importante, mas para uma leitura rÃ¡pida de logs e arqueologia do git, os
detalhes minuciosos importam cada vez menos. Por exemplo, ao fazer uma sÃ©rie de
â€œgit blameâ€, os detalhes de cada mudanÃ§a ao longo do caminho sÃ£o inÃºteis; os
detalhes sÃ³ importam para o culpado. Fornecer â€œo que mudouâ€ facilita determinar
rapidamente se um commit pode ou nÃ£o ser de interesse.”…””}”(hj7  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KêhjØ  h²hubhï)”}”(hXÞ  Outro benefÃ­cio de declarar "o que estÃ¡ mudando" primeiro Ã© que quase sempre Ã©
possÃ­vel declarar "o que estÃ¡ mudando" em uma Ãºnica frase. Por outro lado,
exceto pelos bugs mais simples, todos exigem vÃ¡rias frases ou parÃ¡grafos para
descrever totalmente o problema. Se tanto "o que estÃ¡ mudando" quanto "qual Ã© o
bug" forem super curtos, a ordem nÃ£o importa. Mas se um for mais curto (quase
sempre o "o que estÃ¡ mudando"), entÃ£o cobrir o mais curto primeiro Ã© vantajoso
porque Ã© menos inconveniente para leitores/revisores que tÃªm uma preferÃªncia de
ordenaÃ§Ã£o estrita. Ex: ter que pular uma frase para chegar ao contexto Ã© menos
doloroso do que ter que pular trÃªs parÃ¡grafos para chegar ao "o que estÃ¡
mudando".”h]”hXö  Outro benefÃ­cio de declarar â€œo que estÃ¡ mudandoâ€ primeiro Ã© que quase sempre Ã©
possÃ­vel declarar â€œo que estÃ¡ mudandoâ€ em uma Ãºnica frase. Por outro lado,
exceto pelos bugs mais simples, todos exigem vÃ¡rias frases ou parÃ¡grafos para
descrever totalmente o problema. Se tanto â€œo que estÃ¡ mudandoâ€ quanto â€œqual Ã© o
bugâ€ forem super curtos, a ordem nÃ£o importa. Mas se um for mais curto (quase
sempre o â€œo que estÃ¡ mudandoâ€), entÃ£o cobrir o mais curto primeiro Ã© vantajoso
porque Ã© menos inconveniente para leitores/revisores que tÃªm uma preferÃªncia de
ordenaÃ§Ã£o estrita. Ex: ter que pular uma frase para chegar ao contexto Ã© menos
doloroso do que ter que pular trÃªs parÃ¡grafos para chegar ao â€œo que estÃ¡
mudandoâ€.”…””}”(hjE  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KñhjØ  h²hubeh}”(h]”Œ	changelog”ah ]”h"]”Œ	changelog”ah$]”h&]”uh1hÈhj«  h²hh³hÇh´KÙubhÉ)”}”(hhh]”(hÎ)”}”(hŒCorreÃ§Ãµes (Fixes)”h]”hŒCorreÃ§Ãµes (Fixes)”…””}”(hj^  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj[  h²hh³hÇh´Kýubhï)”}”(hŒÛSe uma mudanÃ§a corrige um bug do KVM/kernel, adicione uma tag Fixes:, mesmo que
a mudanÃ§a nÃ£o precise ser portada (backported) para kernels estÃ¡veis, e mesmo
que a mudanÃ§a corrija um bug em uma versÃ£o mais antiga.”h]”hŒÛSe uma mudanÃ§a corrige um bug do KVM/kernel, adicione uma tag Fixes:, mesmo que
a mudanÃ§a nÃ£o precise ser portada (backported) para kernels estÃ¡veis, e mesmo
que a mudanÃ§a corrija um bug em uma versÃ£o mais antiga.”…””}”(hjl  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Kþhj[  h²hubhï)”}”(hX¡  Por outro lado, se uma correÃ§Ã£o realmente precisar de backport, marque
explicitamente o patch com "Cc: stable@vger.kernel.org" (embora o e-mail em si
nÃ£o precise enviar cÃ³pia para a lista stable); o KVM x86 opta por nÃ£o realizar
o backport automÃ¡tico de tags Fixes: por padrÃ£o. Alguns patches selecionados
automaticamente sÃ£o portados, mas exigem aprovaÃ§Ã£o explÃ­cita do mantenedor
(pesquise por MANUALSEL).”h]”(hŒkPor outro lado, se uma correÃ§Ã£o realmente precisar de backport, marque
explicitamente o patch com â€œCc: ”…””}”(hjz  h²hh³Nh´NubhŒ	reference”“”)”}”(hŒstable@vger.kernel.org”h]”hŒstable@vger.kernel.org”…””}”(hj„  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:stable@vger.kernel.org”uh1j‚  hjz  ubhX$  â€ (embora o e-mail em si
nÃ£o precise enviar cÃ³pia para a lista stable); o KVM x86 opta por nÃ£o realizar
o backport automÃ¡tico de tags Fixes: por padrÃ£o. Alguns patches selecionados
automaticamente sÃ£o portados, mas exigem aprovaÃ§Ã£o explÃ­cita do mantenedor
(pesquise por MANUALSEL).”…””}”(hjz  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Mhj[  h²hubeh}”(h]”Œcorrecoes-fixes”ah ]”h"]”ŒcorreÃ§Ãµes (fixes)”ah$]”h&]”uh1hÈhj«  h²hh³hÇh´KýubhÉ)”}”(hhh]”(hÎ)”}”(hŒReferÃªncias a FunÃ§Ãµes”h]”hŒReferÃªncias a FunÃ§Ãµes”…””}”(hj©  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj¦  h²hh³hÇh´M
ubhï)”}”(hŒÞQuando uma funÃ§Ã£o for mencionada em um comentÃ¡rio, changelog ou shortlog (ou em
qualquer outro lugar, aliÃ¡s), use o formato ``nome_da_funcao()``. Os parÃªnteses
fornecem contexto e removem a ambiguidade da referÃªncia.”h]”(hŒ€Quando uma funÃ§Ã£o for mencionada em um comentÃ¡rio, changelog ou shortlog (ou em
qualquer outro lugar, aliÃ¡s), use o formato ”…””}”(hj·  h²hh³Nh´NubjG  )”}”(hŒ``nome_da_funcao()``”h]”hŒnome_da_funcao()”…””}”(hj¿  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj·  ubhŒJ. Os parÃªnteses
fornecem contexto e removem a ambiguidade da referÃªncia.”…””}”(hj·  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Mhj¦  h²hubeh}”(h]”Œreferencias-a-funcoes”ah ]”h"]”ŒreferÃªncias a funÃ§Ãµes”ah$]”h&]”uh1hÈhj«  h²hh³hÇh´M
ubeh}”(h]”Œdesenvolvimento”ah ]”h"]”Œdesenvolvimento”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K^ubhÉ)”}”(hhh]”(hÎ)”}”(hŒTestes”h]”hŒTestes”…””}”(hjê  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjç  h²hh³hÇh´Mubhï)”}”(hX9  No mÃ­nimo, *todos* os patches de uma sÃ©rie devem compilar sem erros para
KVM_INTEL=m, KVM_AMD=m e KVM_WERROR=y. Compilar cada combinaÃ§Ã£o possÃ­vel de
Kconfigs nÃ£o Ã© viÃ¡vel, mas quanto mais, melhor. KVM_SMM, KVM_XEN, PROVE_LOCKING
e X86_64 sÃ£o opÃ§Ãµes (knobs) particularmente interessantes para se testar.”h]”(hŒNo mÃ­nimo, ”…””}”(hjø  h²hh³Nh´Nubj˜  )”}”(hŒ*todos*”h]”hŒtodos”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hjø  ubhX&   os patches de uma sÃ©rie devem compilar sem erros para
KVM_INTEL=m, KVM_AMD=m e KVM_WERROR=y. Compilar cada combinaÃ§Ã£o possÃ­vel de
Kconfigs nÃ£o Ã© viÃ¡vel, mas quanto mais, melhor. KVM_SMM, KVM_XEN, PROVE_LOCKING
e X86_64 sÃ£o opÃ§Ãµes (knobs) particularmente interessantes para se testar.”…””}”(hjø  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Mhjç  h²hubhï)”}”(hXÜ  A execuÃ§Ã£o de KVM selftests e KVM-unit-tests tambÃ©m Ã© obrigatÃ³ria (e, para
afirmar o Ã³bvio, os testes precisam passar). A Ãºnica exceÃ§Ã£o Ã© para mudanÃ§as
que tenham probabilidade insignificante de afetar o comportamento em tempo de
execuÃ§Ã£o, por exemplo, patches que apenas modificam comentÃ¡rios. Sempre que
possÃ­vel e relevante, o teste tanto em Intel quanto em AMD Ã© fortemente
preferido. A inicializaÃ§Ã£o de uma VM real Ã© incentivada, mas nÃ£o obrigatÃ³ria.”h]”hXÜ  A execuÃ§Ã£o de KVM selftests e KVM-unit-tests tambÃ©m Ã© obrigatÃ³ria (e, para
afirmar o Ã³bvio, os testes precisam passar). A Ãºnica exceÃ§Ã£o Ã© para mudanÃ§as
que tenham probabilidade insignificante de afetar o comportamento em tempo de
execuÃ§Ã£o, por exemplo, patches que apenas modificam comentÃ¡rios. Sempre que
possÃ­vel e relevante, o teste tanto em Intel quanto em AMD Ã© fortemente
preferido. A inicializaÃ§Ã£o de uma VM real Ã© incentivada, mas nÃ£o obrigatÃ³ria.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Mhjç  h²hubhï)”}”(hX¯  Para mudanÃ§as que tocam o cÃ³digo de shadow paging do KVM, executar com o TDP
(EPT/NPT) desabilitado Ã© obrigatÃ³rio. Para mudanÃ§as que afetam o cÃ³digo comum da
MMU do KVM, a execuÃ§Ã£o com o TDP desabilitado Ã© fortemente incentivada. Para
todas as outras mudanÃ§as, se o cÃ³digo sendo modificado depender de e/ou
interagir com um parÃ¢metro de mÃ³dulo (module param), o teste com as
configuraÃ§Ãµes relevantes Ã© obrigatÃ³rio.”h]”hX¯  Para mudanÃ§as que tocam o cÃ³digo de shadow paging do KVM, executar com o TDP
(EPT/NPT) desabilitado Ã© obrigatÃ³rio. Para mudanÃ§as que afetam o cÃ³digo comum da
MMU do KVM, a execuÃ§Ã£o com o TDP desabilitado Ã© fortemente incentivada. Para
todas as outras mudanÃ§as, se o cÃ³digo sendo modificado depender de e/ou
interagir com um parÃ¢metro de mÃ³dulo (module param), o teste com as
configuraÃ§Ãµes relevantes Ã© obrigatÃ³rio.”…””}”(hj&  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Mhjç  h²hubhï)”}”(hŒÒNote que o KVM selftests e o KVM-unit-tests possuem falhas conhecidas. Se vocÃª
suspeitar que uma falha nÃ£o se deve Ã s suas alteraÃ§Ãµes, verifique se a *exata
mesma* falha ocorre com e sem as suas mudanÃ§as.”h]”(hŒ›Note que o KVM selftests e o KVM-unit-tests possuem falhas conhecidas. Se vocÃª
suspeitar que uma falha nÃ£o se deve Ã s suas alteraÃ§Ãµes, verifique se a ”…””}”(hj4  h²hh³Nh´Nubj˜  )”}”(hŒ*exata
mesma*”h]”hŒexata
mesma”…””}”(hj<  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj4  ubhŒ* falha ocorre com e sem as suas mudanÃ§as.”…””}”(hj4  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M$hjç  h²hubhï)”}”(hŒªMudanÃ§as que tocam a documentaÃ§Ã£o em reStructuredText, ou seja, arquivos .rst,
devem compilar o htmldocs de forma limpa, ou seja, sem novos avisos (warnings)
ou erros.”h]”hŒªMudanÃ§as que tocam a documentaÃ§Ã£o em reStructuredText, ou seja, arquivos .rst,
devem compilar o htmldocs de forma limpa, ou seja, sem novos avisos (warnings)
ou erros.”…””}”(hjT  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M(hjç  h²hubhï)”}”(hŒÚSe vocÃª nÃ£o puder testar totalmente uma mudanÃ§a, por exemplo, devido Ã  falta de
hardware, declare claramente qual nÃ­vel de teste vocÃª foi capaz de realizar,
por exemplo, na cover letter (carta de apresentaÃ§Ã£o).”h]”hŒÚSe vocÃª nÃ£o puder testar totalmente uma mudanÃ§a, por exemplo, devido Ã  falta de
hardware, declare claramente qual nÃ­vel de teste vocÃª foi capaz de realizar,
por exemplo, na cover letter (carta de apresentaÃ§Ã£o).”…””}”(hjb  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M,hjç  h²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒNovos Recursos”h]”hŒNovos Recursos”…””}”(hjs  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjp  h²hh³hÇh´M1ubhï)”}”(hXH  Com uma exceÃ§Ã£o, novos recursos *devem* vir acompanhados de cobertura de testes.
Testes especÃ­ficos do KVM nÃ£o sÃ£o estritamente obrigatÃ³rios, por exemplo, se a
cobertura for fornecida ao executar uma VM convidada (guest) suficientemente
habilitada, ou ao executar um selftest de kernel relacionado em uma VM, mas
testes dedicados do KVM sÃ£o preferidos em todos os casos. Casos de teste
negativos, em particular, sÃ£o obrigatÃ³rios para a habilitaÃ§Ã£o de novos recursos
de hardware, jÃ¡ que fluxos de erro e exceÃ§Ã£o raramente sÃ£o exercitados
simplesmente ao executar uma VM.”h]”(hŒ"Com uma exceÃ§Ã£o, novos recursos ”…””}”(hj  h²hh³Nh´Nubj˜  )”}”(hŒ*devem*”h]”hŒdevem”…””}”(hj‰  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj  ubhX   vir acompanhados de cobertura de testes.
Testes especÃ­ficos do KVM nÃ£o sÃ£o estritamente obrigatÃ³rios, por exemplo, se a
cobertura for fornecida ao executar uma VM convidada (guest) suficientemente
habilitada, ou ao executar um selftest de kernel relacionado em uma VM, mas
testes dedicados do KVM sÃ£o preferidos em todos os casos. Casos de teste
negativos, em particular, sÃ£o obrigatÃ³rios para a habilitaÃ§Ã£o de novos recursos
de hardware, jÃ¡ que fluxos de erro e exceÃ§Ã£o raramente sÃ£o exercitados
simplesmente ao executar uma VM.”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M2hjp  h²hubhï)”}”(hX  A Ãºnica exceÃ§Ã£o a esta regra Ã© se o KVM estiver simplesmente anunciando suporte
para um recurso via KVM_GET_SUPPORTED_CPUID, ou seja, para instruÃ§Ãµes/recursos
que o KVM nÃ£o pode impedir um convidado de usar e para os quais nÃ£o hÃ¡ uma
habilitaÃ§Ã£o real.”h]”hX  A Ãºnica exceÃ§Ã£o a esta regra Ã© se o KVM estiver simplesmente anunciando suporte
para um recurso via KVM_GET_SUPPORTED_CPUID, ou seja, para instruÃ§Ãµes/recursos
que o KVM nÃ£o pode impedir um convidado de usar e para os quais nÃ£o hÃ¡ uma
habilitaÃ§Ã£o real.”…””}”(hj¡  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M;hjp  h²hubhï)”}”(hŒÖNote que "novos recursos" nÃ£o significa apenas "novos recursos de hardware"!
Novos recursos que nÃ£o podem ser bem validados usando os KVM selftests e/ou
KVM-unit-tests existentes devem vir acompanhados de testes.”h]”hŒÞNote que â€œnovos recursosâ€ nÃ£o significa apenas â€œnovos recursos de hardwareâ€!
Novos recursos que nÃ£o podem ser bem validados usando os KVM selftests e/ou
KVM-unit-tests existentes devem vir acompanhados de testes.”…””}”(hj¯  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M@hjp  h²hubhï)”}”(hXk  Enviar o desenvolvimento de novos recursos sem testes para obter feedback
antecipado Ã© mais do que bem-vindo, mas tais submissÃµes devem ser marcadas como
RFC, e a carta de apresentaÃ§Ã£o (cover letter) deve declarar claramente que tipo
de feedback Ã© solicitado/esperado. NÃ£o abuse do processo de RFC; as RFCs
normalmente nÃ£o receberÃ£o uma revisÃ£o profunda.”h]”hXk  Enviar o desenvolvimento de novos recursos sem testes para obter feedback
antecipado Ã© mais do que bem-vindo, mas tais submissÃµes devem ser marcadas como
RFC, e a carta de apresentaÃ§Ã£o (cover letter) deve declarar claramente que tipo
de feedback Ã© solicitado/esperado. NÃ£o abuse do processo de RFC; as RFCs
normalmente nÃ£o receberÃ£o uma revisÃ£o profunda.”…””}”(hj½  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MDhjp  h²hubeh}”(h]”Œnovos-recursos”ah ]”h"]”Œnovos recursos”ah$]”h&]”uh1hÈhjç  h²hh³hÇh´M1ubhÉ)”}”(hhh]”(hÎ)”}”(hŒCorreÃ§Ãµes de Bugs”h]”hŒCorreÃ§Ãµes de Bugs”…””}”(hjÖ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÓ  h²hh³hÇh´MKubhï)”}”(hX/  Exceto por bugs "Ã³bvios" encontrados por inspeÃ§Ã£o, as correÃ§Ãµes devem vir
acompanhadas de um reprodutor (reproducer) para o bug que estÃ¡ sendo corrigido.
Em muitos casos, o reprodutor Ã© implÃ­cito, por exemplo, para erros de build e
falhas de teste, mas ainda assim deve estar claro para os leitores o que estÃ¡
quebrado e como verificar a correÃ§Ã£o. Alguma margem de manobra Ã© dada para
bugs encontrados atravÃ©s de cargas de trabalho ou testes nÃ£o pÃºblicos, mas a
disponibilizaÃ§Ã£o de testes de regressÃ£o para tais bugs Ã© fortemente preferida.”h]”hX3  Exceto por bugs â€œÃ³bviosâ€ encontrados por inspeÃ§Ã£o, as correÃ§Ãµes devem vir
acompanhadas de um reprodutor (reproducer) para o bug que estÃ¡ sendo corrigido.
Em muitos casos, o reprodutor Ã© implÃ­cito, por exemplo, para erros de build e
falhas de teste, mas ainda assim deve estar claro para os leitores o que estÃ¡
quebrado e como verificar a correÃ§Ã£o. Alguma margem de manobra Ã© dada para
bugs encontrados atravÃ©s de cargas de trabalho ou testes nÃ£o pÃºblicos, mas a
disponibilizaÃ§Ã£o de testes de regressÃ£o para tais bugs Ã© fortemente preferida.”…””}”(hjä  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MLhjÓ  h²hubhï)”}”(hXW  Em geral, testes de regressÃ£o sÃ£o preferidos para qualquer bug que nÃ£o seja
trivial de ser atingido. Por exemplo, mesmo que o bug tenha sido originalmente
encontrado por um fuzzer como o syzkaller, um teste de regressÃ£o direcionado
pode ser justificÃ¡vel se o bug exigir que se atinja uma condiÃ§Ã£o de corrida do
tipo "uma em um milhÃ£o".”h]”hX[  Em geral, testes de regressÃ£o sÃ£o preferidos para qualquer bug que nÃ£o seja
trivial de ser atingido. Por exemplo, mesmo que o bug tenha sido originalmente
encontrado por um fuzzer como o syzkaller, um teste de regressÃ£o direcionado
pode ser justificÃ¡vel se o bug exigir que se atinja uma condiÃ§Ã£o de corrida do
tipo â€œuma em um milhÃ£oâ€.”…””}”(hjò  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MThjÓ  h²hubhï)”}”(hŒ¼Note que os bugs do KVM raramente sÃ£o urgentes *e* nÃ£o triviais de reproduzir.
Pergunte a si mesmo se um bug Ã© realmente o fim do mundo antes de enviar uma
correÃ§Ã£o sem um reprodutor.”h]”(hŒ0Note que os bugs do KVM raramente sÃ£o urgentes ”…””}”(hj   h²hh³Nh´Nubj˜  )”}”(hŒ*e*”h]”hŒe”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj   ubhŒ‰ nÃ£o triviais de reproduzir.
Pergunte a si mesmo se um bug Ã© realmente o fim do mundo antes de enviar uma
correÃ§Ã£o sem um reprodutor.”…””}”(hj   h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MZhjÓ  h²hubeh}”(h]”Œcorrecoes-de-bugs”ah ]”h"]”ŒcorreÃ§Ãµes de bugs”ah$]”h&]”uh1hÈhjç  h²hh³hÇh´MKubeh}”(h]”Œtestes”ah ]”h"]”Œtestes”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´MubhÉ)”}”(hhh]”(hÎ)”}”(hŒPostagem”h]”hŒPostagem”…””}”(hj3  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj0  h²hh³hÇh´M_ubhÉ)”}”(hhh]”(hÎ)”}”(hŒLinks”h]”hŒLinks”…””}”(hjD  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjA  h²hh³hÇh´Mbubhï)”}”(hXã  NÃ£o faÃ§a referÃªncia explÃ­cita a relatÃ³rios de bugs, versÃµes anteriores de um
patch/sÃ©rie, etc., atravÃ©s de cabeÃ§alhos ``In-Reply-To:``. O uso de
``In-Reply-To:`` torna-se uma bagunÃ§a infernal para grandes sÃ©ries e/ou quando
o nÃºmero de versÃµes aumenta, e o ``In-Reply-To:`` Ã© inÃºtil para qualquer
pessoa que nÃ£o tenha a mensagem original, por exemplo, se alguÃ©m nÃ£o estava
em cÃ³pia (Cc) no relatÃ³rio do bug ou se a lista de destinatÃ¡rios mudar entre
as versÃµes.”h]”(hŒNÃ£o faÃ§a referÃªncia explÃ­cita a relatÃ³rios de bugs, versÃµes anteriores de um
patch/sÃ©rie, etc., atravÃ©s de cabeÃ§alhos ”…””}”(hjR  h²hh³Nh´NubjG  )”}”(hŒ``In-Reply-To:``”h]”hŒIn-Reply-To:”…””}”(hjZ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjR  ubhŒ. O uso de
”…””}”(hjR  h²hh³Nh´NubjG  )”}”(hŒ``In-Reply-To:``”h]”hŒIn-Reply-To:”…””}”(hjl  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjR  ubhŒd torna-se uma bagunÃ§a infernal para grandes sÃ©ries e/ou quando
o nÃºmero de versÃµes aumenta, e o ”…””}”(hjR  h²hh³Nh´NubjG  )”}”(hŒ``In-Reply-To:``”h]”hŒIn-Reply-To:”…””}”(hj~  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjR  ubhŒÅ Ã© inÃºtil para qualquer
pessoa que nÃ£o tenha a mensagem original, por exemplo, se alguÃ©m nÃ£o estava
em cÃ³pia (Cc) no relatÃ³rio do bug ou se a lista de destinatÃ¡rios mudar entre
as versÃµes.”…””}”(hjR  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MchjA  h²hubhï)”}”(hX  Para vincular a um relatÃ³rio de bug, versÃ£o anterior ou qualquer coisa de
interesse, use links do lore. Para referenciar versÃ£o(Ãµes) anterior(es), de modo
geral, nÃ£o inclua um Link: no changelog, pois nÃ£o hÃ¡ necessidade de registrar o
histÃ³rico no git; ou seja, coloque o link na carta de apresentaÃ§Ã£o (cover
letter) ou na seÃ§Ã£o que o git ignora. ForneÃ§a um Link: formal para relatÃ³rios
de bugs e/ou discussÃµes que levaram ao patch. O contexto de por que uma mudanÃ§a
foi feita Ã© altamente valioso para futuros leitores.”h]”hX  Para vincular a um relatÃ³rio de bug, versÃ£o anterior ou qualquer coisa de
interesse, use links do lore. Para referenciar versÃ£o(Ãµes) anterior(es), de modo
geral, nÃ£o inclua um Link: no changelog, pois nÃ£o hÃ¡ necessidade de registrar o
histÃ³rico no git; ou seja, coloque o link na carta de apresentaÃ§Ã£o (cover
letter) ou na seÃ§Ã£o que o git ignora. ForneÃ§a um Link: formal para relatÃ³rios
de bugs e/ou discussÃµes que levaram ao patch. O contexto de por que uma mudanÃ§a
foi feita Ã© altamente valioso para futuros leitores.”…””}”(hj–  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MkhjA  h²hubeh}”(h]”Œlinks”ah ]”h"]”Œlinks”ah$]”h&]”uh1hÈhj0  h²hh³hÇh´MbubhÉ)”}”(hhh]”(hÎ)”}”(hŒBase do Git (Git Base)”h]”hŒBase do Git (Git Base)”…””}”(hj¯  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj¬  h²hh³hÇh´Mtubhï)”}”(hŒáSe vocÃª estiver usando o git versÃ£o 2.9.0 ou posterior (Googlers, isso inclui
todos vocÃªs!), use ``git format-patch`` com a flag ``--base`` para incluir
automaticamente as informaÃ§Ãµes da Ã¡rvore base nos patches gerados.”h]”(hŒdSe vocÃª estiver usando o git versÃ£o 2.9.0 ou posterior (Googlers, isso inclui
todos vocÃªs!), use ”…””}”(hj½  h²hh³Nh´NubjG  )”}”(hŒ``git format-patch``”h]”hŒgit format-patch”…””}”(hjÅ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj½  ubhŒ com a flag ”…””}”(hj½  h²hh³Nh´NubjG  )”}”(hŒ
``--base``”h]”hŒ--base”…””}”(hj×  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hj½  ubhŒS para incluir
automaticamente as informaÃ§Ãµes da Ã¡rvore base nos patches gerados.”…””}”(hj½  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Muhj¬  h²hubhï)”}”(hXš  Note que ``--base=auto`` funciona conforme o esperado se, e somente se, o
upstream de uma branch estiver definido para a branch de tÃ³pico base; por
exemplo, ele farÃ¡ a coisa errada se o seu upstream estiver definido para o seu
repositÃ³rio pessoal para fins de backup. Uma soluÃ§Ã£o "auto" alternativa Ã©
derivar os nomes das suas branches de desenvolvimento com base no seu tÃ³pico
KVM x86 e alimentar isso no ``--base``. Por exemplo,
``x86/pmu/minha_branch`` e, em seguida, escrever um pequeno wrapper para
extrair ``pmu`` do nome da branch atual para resultar em ``--base=x/pmu``, onde
``x`` Ã© o nome que seu repositÃ³rio usa para rastrear o remoto do KVM x86.”h]”(hŒ	Note que ”…””}”(hjï  h²hh³Nh´NubjG  )”}”(hŒ``--base=auto``”h]”hŒ--base=auto”…””}”(hj÷  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjï  ubhX‰   funciona conforme o esperado se, e somente se, o
upstream de uma branch estiver definido para a branch de tÃ³pico base; por
exemplo, ele farÃ¡ a coisa errada se o seu upstream estiver definido para o seu
repositÃ³rio pessoal para fins de backup. Uma soluÃ§Ã£o â€œautoâ€ alternativa Ã©
derivar os nomes das suas branches de desenvolvimento com base no seu tÃ³pico
KVM x86 e alimentar isso no ”…””}”(hjï  h²hh³Nh´NubjG  )”}”(hŒ
``--base``”h]”hŒ--base”…””}”(hj		  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjï  ubhŒ. Por exemplo,
”…””}”(hjï  h²hh³Nh´NubjG  )”}”(hŒ``x86/pmu/minha_branch``”h]”hŒx86/pmu/minha_branch”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjï  ubhŒ9 e, em seguida, escrever um pequeno wrapper para
extrair ”…””}”(hjï  h²hh³Nh´NubjG  )”}”(hŒ``pmu``”h]”hŒpmu”…””}”(hj-	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjï  ubhŒ* do nome da branch atual para resultar em ”…””}”(hjï  h²hh³Nh´NubjG  )”}”(hŒ``--base=x/pmu``”h]”hŒ--base=x/pmu”…””}”(hj?	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjï  ubhŒ, onde
”…””}”(hjï  h²hh³Nh´NubjG  )”}”(hŒ``x``”h]”hŒx”…””}”(hjQ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jF  hjï  ubhŒF Ã© o nome que seu repositÃ³rio usa para rastrear o remoto do KVM x86.”…””}”(hjï  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Myhj¬  h²hubeh}”(h]”Œbase-do-git-git-base”ah ]”h"]”Œbase do git (git base)”ah$]”h&]”uh1hÈhj0  h²hh³hÇh´MtubhÉ)”}”(hhh]”(hÎ)”}”(hŒPostagem Conjunta de Testes”h]”hŒPostagem Conjunta de Testes”…””}”(hjt	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjq	  h²hh³hÇh´M„ubhï)”}”(hXâ  KVM selftests que estÃ£o associados a mudanÃ§as no KVM, por exemplo, testes de
regressÃ£o para correÃ§Ãµes de bugs, devem ser postados junto com as mudanÃ§as do
KVM como uma Ãºnica sÃ©rie. As regras padrÃ£o do kernel para bissecÃ§Ã£o (bisection)
se aplicam, ou seja, mudanÃ§as no KVM que resultem em falhas de teste devem ser
ordenadas apÃ³s as atualizaÃ§Ãµes dos selftests e, vice-versa, novos testes que
falhem devido a bugs do KVM devem ser ordenados apÃ³s as correÃ§Ãµes do KVM.”h]”hXâ  KVM selftests que estÃ£o associados a mudanÃ§as no KVM, por exemplo, testes de
regressÃ£o para correÃ§Ãµes de bugs, devem ser postados junto com as mudanÃ§as do
KVM como uma Ãºnica sÃ©rie. As regras padrÃ£o do kernel para bissecÃ§Ã£o (bisection)
se aplicam, ou seja, mudanÃ§as no KVM que resultem em falhas de teste devem ser
ordenadas apÃ³s as atualizaÃ§Ãµes dos selftests e, vice-versa, novos testes que
falhem devido a bugs do KVM devem ser ordenados apÃ³s as correÃ§Ãµes do KVM.”…””}”(hj‚	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M…hjq	  h²hubhï)”}”(hX«  KVM-unit-tests devem *sempre* ser postados separadamente. Ferramentas, como o
b4 am, nÃ£o sabem que o KVM-unit-tests Ã© um repositÃ³rio separado e ficam
confusas quando os patches de uma sÃ©rie se aplicam a Ã¡rvores diferentes. Para
vincular os patches do KVM-unit-tests aos patches do KVM, poste primeiro as
mudanÃ§as do KVM e, em seguida, forneÃ§a um link do lore para o patch/sÃ©rie do
KVM no(s) patch(es) do KVM-unit-tests.”h]”(hŒKVM-unit-tests devem ”…””}”(hj	  h²hh³Nh´Nubj˜  )”}”(hŒ*sempre*”h]”hŒsempre”…””}”(hj˜	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj	  ubhXŽ   ser postados separadamente. Ferramentas, como o
b4 am, nÃ£o sabem que o KVM-unit-tests Ã© um repositÃ³rio separado e ficam
confusas quando os patches de uma sÃ©rie se aplicam a Ã¡rvores diferentes. Para
vincular os patches do KVM-unit-tests aos patches do KVM, poste primeiro as
mudanÃ§as do KVM e, em seguida, forneÃ§a um link do lore para o patch/sÃ©rie do
KVM no(s) patch(es) do KVM-unit-tests.”…””}”(hj	  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MŒhjq	  h²hubeh}”(h]”Œpostagem-conjunta-de-testes”ah ]”h"]”Œpostagem conjunta de testes”ah$]”h&]”uh1hÈhj0  h²hh³hÇh´M„ubeh}”(h]”Œpostagem”ah ]”h"]”Œpostagem”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´M_ubhÉ)”}”(hhh]”(hÎ)”}”(hŒNotificaÃ§Ãµes”h]”hŒNotificaÃ§Ãµes”…””}”(hjÃ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÀ	  h²hh³hÇh´M”ubhï)”}”(hX,  Quando um patch/sÃ©rie Ã© oficialmente aceito, um e-mail de notificaÃ§Ã£o serÃ¡
enviado em resposta Ã  postagem original (carta de apresentaÃ§Ã£o para sÃ©ries de
mÃºltiplos patches). A notificaÃ§Ã£o incluirÃ¡ a Ã¡rvore e a branch de tÃ³pico,
juntamente com os SHA1s dos commits dos patches aplicados.”h]”hX,  Quando um patch/sÃ©rie Ã© oficialmente aceito, um e-mail de notificaÃ§Ã£o serÃ¡
enviado em resposta Ã  postagem original (carta de apresentaÃ§Ã£o para sÃ©ries de
mÃºltiplos patches). A notificaÃ§Ã£o incluirÃ¡ a Ã¡rvore e a branch de tÃ³pico,
juntamente com os SHA1s dos commits dos patches aplicados.”…””}”(hjÑ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M•hjÀ	  h²hubhï)”}”(hX	  Se um subconjunto de patches for aplicado, isso serÃ¡ claramente declarado na
notificaÃ§Ã£o. A menos que seja dito o contrÃ¡rio, subentende-se que quaisquer
patches na sÃ©rie que nÃ£o foram aceitos precisam de mais trabalho e devem ser
enviados em uma nova versÃ£o.”h]”hX	  Se um subconjunto de patches for aplicado, isso serÃ¡ claramente declarado na
notificaÃ§Ã£o. A menos que seja dito o contrÃ¡rio, subentende-se que quaisquer
patches na sÃ©rie que nÃ£o foram aceitos precisam de mais trabalho e devem ser
enviados em uma nova versÃ£o.”…””}”(hjß	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MšhjÀ	  h²hubhï)”}”(hŒÇSe, por algum motivo, um patch for descartado apÃ³s ter sido oficialmente
aceito, uma resposta serÃ¡ enviada ao e-mail de notificaÃ§Ã£o explicando o porquÃª
do descarte, bem como os prÃ³ximos passos.”h]”hŒÇSe, por algum motivo, um patch for descartado apÃ³s ter sido oficialmente
aceito, uma resposta serÃ¡ enviada ao e-mail de notificaÃ§Ã£o explicando o porquÃª
do descarte, bem como os prÃ³ximos passos.”…””}”(hjí	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´MŸhjÀ	  h²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒEstabilidade de SHA1”h]”hŒEstabilidade de SHA1”…””}”(hjþ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjû	  h²hh³hÇh´M¤ubhï)”}”(hXÖ  Os SHA1s nÃ£o tÃªm garantia de serem 100% estÃ¡veis atÃ© que cheguem na Ã¡rvore do
Linus! Um SHA1 Ã© *geralmente* estÃ¡vel uma vez que a notificaÃ§Ã£o tenha sido
enviada, mas imprevistos acontecem. Na maioria dos casos, uma atualizaÃ§Ã£o no
e-mail de notificaÃ§Ã£o serÃ¡ fornecida se o SHA1 de um patch aplicado mudar. No
entanto, em alguns cenÃ¡rios, por exemplo, se todas as branches do KVM x86
precisarem de rebase, as notificaÃ§Ãµes individuais nÃ£o serÃ£o enviadas.”h]”(hŒeOs SHA1s nÃ£o tÃªm garantia de serem 100% estÃ¡veis atÃ© que cheguem na Ã¡rvore do
Linus! Um SHA1 Ã© ”…””}”(hj
  h²hh³Nh´Nubj˜  )”}”(hŒ*geralmente*”h]”hŒ
geralmente”…””}”(hj
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hj
  ubhXe   estÃ¡vel uma vez que a notificaÃ§Ã£o tenha sido
enviada, mas imprevistos acontecem. Na maioria dos casos, uma atualizaÃ§Ã£o no
e-mail de notificaÃ§Ã£o serÃ¡ fornecida se o SHA1 de um patch aplicado mudar. No
entanto, em alguns cenÃ¡rios, por exemplo, se todas as branches do KVM x86
precisarem de rebase, as notificaÃ§Ãµes individuais nÃ£o serÃ£o enviadas.”…””}”(hj
  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M¥hjû	  h²hubeh}”(h]”Œestabilidade-de-sha1”ah ]”h"]”Œestabilidade de sha1”ah$]”h&]”uh1hÈhjÀ	  h²hh³hÇh´M¤ubeh}”(h]”Œnotificacoes”ah ]”h"]”ŒnotificaÃ§Ãµes”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´M”ubhÉ)”}”(hhh]”(hÎ)”}”(hŒVulnerabilidades”h]”hŒVulnerabilidades”…””}”(hj?
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj<
  h²hh³hÇh´M­ubhï)”}”(hX  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.”h]”(hŒ¸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 ”…””}”(hjM
  h²hh³Nh´Nubj˜  )”}”(hŒ*seu*”h]”hŒseu”…””}”(hjU
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j—  hjM
  ubhŒo prÃ³prio hospedeiro (L2 atacando L1), sÃ£o de
interesse particular para o KVM. Por favor, siga o protocolo em
”…””}”(hjM
  h²hh³Nh´Nubh)”}”(hŒ:ref:`securitybugs`”h]”js  )”}”(hji
  h]”hŒsecuritybugs”…””}”(hjk
  h²hh³Nh´Nubah}”(h]”h ]”(j~  Œstd”Œstd-ref”eh"]”h$]”h&]”uh1jr  hjg
  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”j‹  Œ	refdomain”ju
  Œreftype”Œref”Œrefexplicit”•¹      ‰Œrefwarn”ˆj‘  Œsecuritybugs”uh1hh³hÇh´M®hjM
  ubhŒP se vocÃª suspeitar que um bug possa levar a um escape,
vazamento de dados, etc.”…””}”(hjM
  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´M®hj<
  h²hubeh}”(h]”Œvulnerabilidades”ah ]”h"]”Œvulnerabilidades”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´M­ubeh}”(h]”Œkvm-x86”ah ]”h"]”Œkvm x86”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÍNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jÄ
  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jž
  j›
  j  j   j*  j'  je  jb  j  j  j]  jZ  j¨  j¥  jä  já  jD  jA  jÒ  jÏ  jù  jö  jN  jK  jÕ  jÒ  jX  jU  j£  j   jÜ  jÙ  j-  j*  jÐ  jÍ  j%  j"  j½	  jº	  j©  j¦  jn	  jk	  jµ	  j²	  j9
  j6
  j1
  j.
  j–
  j“
  uŒ	nametypes”}”(jž
  ‰j  ‰j*  ‰je  ‰j  ‰j]  ‰j¨  ‰jä  ‰jD  ‰jÒ  ‰jù  ‰jN  ‰jÕ  ‰jX  ‰j£  ‰jÜ  ‰j-  ‰jÐ  ‰j%  ‰j½	  ‰j©  ‰jn	  ‰jµ	  ‰j9
  ‰j1
  ‰j–
  ‰uh}”(j›
  hÊj   hÝj'  j  jb  j-  j  j   jZ  j  j¥  jh  já  j«  jA  j¼  jÏ  jG  jö  jÕ  jK  jü  jÒ  jQ  jU  jØ  j   j[  jÙ  j¦  j*  jç  jÍ  jp  j"  jÓ  jº	  j0  j¦  jA  jk	  j¬  j²	  jq	  j6
  jÀ	  j.
  jû	  j“
  j<
  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.