docs/welcome/pt_BR/bugreports.html

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="pt-BR" xml:lang="pt-BR">
   4 <head>
   5 <!--
   6  *
   7  * Copyright 2008-2012, Haiku. All rights reserved.
   8  * Distributed under the terms of the MIT License.
   9  *
  10  * Authors:
  11  *              Niels Reedijk, Matt Madia and Ingo Weinhold who wrote
  12  *              http://dev.haiku-os.org/wiki/ and http://dev.haiku-os.org/wiki/ReportingBugs
  13  *              Humdinger <humdingerb@gmail.com>
  14  * Translators:
  15  *              tiagoms
  16  *              Adriano Duarte
  17  *              Humdinger
  18  *
  19 -->
  20         <meta http-equiv="content-type" content="text/html; charset=utf-8" />
  21         <meta name="robots" content="all" />
  22         <title>Reportando erros</title>
  23         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  24         <link rel="stylesheet" type="text/css" href="../Haiku-doc.css" />
  25 </head>
  26 <body>
  27
  28 <div id="banner">
  29 <div><span>Guia do Usuário</span></div>
  30 </div>
  31
  32 <div class="nav">
  33 <div class="inner">
  34 <ul class="lang-menu">
  35 <li class="now"><img src="../images/flags/pt_BR.png" alt="" /> Português (Brazil)</li>
  36 <li><a href="../ca/bugreports.html"><img src="../images/flags/ca.png" alt="" />Català</a></li>
  37 <li><a href="../de/bugreports.html"><img src="../images/flags/de.png" alt="" />Deutsch</a></li>
  38 <li><a href="../en/bugreports.html"><img src="../images/flags/gb.png" alt="" />English</a></li>
  39 <li><a href="../es/bugreports.html"><img src="../images/flags/es.png" alt="" />Español</a></li>
  40 <li><a href="../fr/bugreports.html"><img src="../images/flags/fr.png" alt="" />Français</a></li>
  41 <li><a href="../it/bugreports.html"><img src="../images/flags/it.png" alt="" />Italiano</a></li>
  42 <li><a href="../hu/bugreports.html"><img src="../images/flags/hu.png" alt="" />Magyar</a></li>
  43 <li><a href="../pl/bugreports.html"><img src="../images/flags/pl.png" alt="" />Polski</a></li>
  44 <li><a href="../pt_PT/bugreports.html"><img src="../images/flags/pt_PT.png" alt="" />Português</a></li>
  45 <li><a href="../ro/bugreports.html"><img src="../images/flags/ro.png" alt="" />Română</a></li>
  46 <li><a href="../sk/bugreports.html"><img src="../images/flags/sk.png" alt="" />Slovenčina</a></li>
  47 <li><a href="../fi/bugreports.html"><img src="../images/flags/fi.png" alt="" />Suomi</a></li>
  48 <li><a href="../sv_SE/bugreports.html"><img src="../images/flags/sv_SE.png" alt="" />Svenska</a></li>
  49 <li><a href="../zh_CN/bugreports.html"><img src="../images/flags/zh_CN.png" alt="" /> 中文 ［中文］</a></li>
  50 <li><a href="../ru/bugreports.html"><img src="../images/flags/ru.png" alt="" />Русский</a></li>
  51 <li><a href="../uk/bugreports.html"><img src="../images/flags/uk.png" alt="" />Українська</a></li>
  52 <li><a href="../jp/bugreports.html"><img src="../images/flags/jp.png" alt="" />日本語</a></li>
  53 </ul>
  54 <span>
  55     <a href="../welcome_pt_BR.html" class="uplink">Welcome</a>
  56 </span></div>
  57 </div>
  58
  59 <div id="content">
  60 <div>
  61 <div class="box-info">A tradução desta página ainda não está completa. Até lá, partes incompletas mostrarão o original em inglês.</div>
  62
  63 <table class="index" id="index" summary="index">
  64 <tr class="heading"><td>Índice</td></tr>
  65 <tr class="index"><td><a href="#account">Obtendo uma conta do Trac</a><br />
  66                 <a href="#report">Criando um relatório de erro</a><br />
  67                 <a href="#app">Erros de aplicativo</a><br />
  68                   <a href="#server">Erros de servidor</a><br />
  69                   <a href="#kernel">Erros de Kernel</a><br />
  70                   <a href="#kdl">Terra da Depuração do Kernel - KDL</a><br />
  71                   <a href="#syslog">Relatório de Sistema</a><br />
  72                   <a href="#onscreen">Saída de depuração na tela</a><br />
  73                   <a href="#hardware">Erros de Dispositivo/Driver</a><br />
  74                   <a href="#next">O que vem a seguir?</a></td></tr>
  75 </table>
  76
  77 <h1>Reportando erros</h1>
  78
  79 <p>Uma vez que nossos desenvolvedores não são capazes de testar todas as combinações de hardware nem todas as diferentes formas de interação com o sistema operacional, nós contamos com os usuários para dar-nos algum retorno sobre como as coisas funcionam em seu equipamento. Uma vez que o Haiku é ainda um tanto jovem, é muito provável que irá encontrar erros. Agradecemos por dispor de tempo para reportá-los. Juntos melhoraremos o Haiku, bit a bit.</p>
  80 <p>Para manter nosso rastreador de erros eficaz, é essencial obedecer à <a href="http://dev.haiku-os.org/wiki/BugTrackerEtiquette">Etiqueta do Rastreador de Erros</a>.</p>
  81
  82 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
  83 <a id="account" name="accout">Obtendo uma conta do Trac</a></h2>
  84 <p>Para arquivar um tíquete, é necessária uma conta no <a href="http://dev.haiku-os.org/register" title="Registro no Rastreador de Erros do Haiku">Rastreador de Erros do Haiku</a>.<br />
  85 Ao criar uma nova conta, certifique-se de <b>informar seu endereço de correio eletrônico</b>, necessário para obter privilégios básicos para modificação do tíquete. Assegure-se de <b>verificar sua pasta de correspondência indesejada</b> logo depois, afinal toda verificação de correios importantes costuma acabar aí.</p>
  86
  87 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
  88 <a id="report" name="report">Criando um relatório de erro</a></h2>
  89 <p>Antes de reportar um erro, por favor <a href="http://dev.haiku-os.org/query?status=new&amp;status=assigned&amp;status=reopened&amp;status=closed&amp;summary=%7Etext+you+want+to+search+for&amp;order=priority">certifique-se</a> de que ele ainda não existe. Pode-se também utilizar a função de <a href="http://dev.haiku-os.org/search?q=&amp;noquickjump=1&amp;ticket=on">pesquisa</a> para isso.<br />
  90 Após constatar que é um erro original, torne sua informação a mais acurada possível:</p>
  91 <ul>
  92         <li><p>Tente reproduzir o problema na versão atual do Haiku. Imagens pré-compiladas para o propósito de testes estão <a href="http://haiku-files.org/">disponíveis</a>.</p></li>
  93         <li><p>Inclua informação básica sobre como está testando o Haiku (em equipamento real, no VMWare, no QEMU, etc.).</p></li>
  94         <li><p>Mention which revision you are running. You can find this information in <span class="menu">About Haiku...</span> from the Deskbar menu. Also mention what kind of Haiku build you are testing (gcc2, gcc4, gcc2hybrid, gcc4hybrid). The downloadable images are named accordingly, for a self-built image you should know how you built it.</p></li>
  95         <li><p>Descreva o problema que está experimentando. Tente ser o mais acurado possível: descreva o comportamento atual e o comportamento que deseja.</p></li>
  96         <li><p>Descreva que passos precisa realizar a fim de expor o erro. Isto ajudará os desenvolvedores a reproduzir o erro.</p></li>
  97         <li><p>Anexe toda a informação que tiver. Se é um erro de interface gráfica, ou um erro em um dos aplicativos, tente obter uma imagem da tela pressionando a tecla <span class="key">PRINT</span>.</p></li>
  98 </ul>
  99
 100 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 101 <a id="app" name="app">Erros de Aplicativo</a></h2>
 102 <p>Quando um aplicativo trava, deve-se executar o depurador a partir do alerta que aparece na tela. Isto abrirá uma janela do Terminal com o gdb (o depurador GNU) rodando nele. Executando <span class="cli">bt</span>, cria-se um "rastro" que deverá ser copiado inteiramente (incluindo a parte antes de executar o comando <span class="cli">bt</span>) e anexado ao tíquete.</p>
 103
 104 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 105 <a id="server" name="server">Erros de servidor</a></h2>
 106 <p>When vital servers like the app server, the registrar or the input server crash, you won't see the usual crash alert. Instead the whole screen will be cleared white and a gdb session will be started, its output appearing directly on screen. Likely you will still be able to move the mouse, which will overwrite the white and gdb output on screen. Applications still running (like ProcessController or the clock in the Deskbar) might also draw over the debugger output on screen.<br />
 107 Besides everything being more ugly and inconvenient, basically the same applies as for application bugs. Most importantly procure a back trace (<span class="cli">bt</span> command). You may need to take a picture of the screen with a digital camera, since you won't be able to copy the text anywhere.<br />
 108 Depending on what exactly crashed, you can try to save a crash report on the Desktop with <span class="cli">save-report</span> and then press the power button once to try shutting cleanly down.</p>
 109
 110 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 111 <a id="kernel" name="kernel">Erros do Kernel</a></h2>
 112 <p>Erros de Kernel são sempre os únicos com os efeitos mais graves e ao mesmo tempo os mais difíceis de depurar. Existem diferentes tipos de sintomas, os quais mais provavelmente apontam um problema de kernel ou de driver:</p>
 113 <ul>
 114 <li><p>O sistema aciona a Terra da Depuração do Kernel (KDL) por si mesmo. A parte superior da tela torna-se branca e várias linhas de texto são mostradas. A segunda linha diz "<i>Bem vindo a Terra da Depuração do Kernel...</i>", a linha acima dela afirma a razão imediata para entrar na KDL.</p></li>
 115 <li><p>O sistema reinicia espontaneamente.</p></li>
 116 <li><p>O sistema congela completamente. Não se pode mover o mouse e nenhum aplicativo faz nada mais. Um importante teste naquela situação é, se ainda puder entrar na KDL pelo atalho <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span> (<span class="key">SysReq</span> sendo <span class="key">PRINT</span> na maioria dos teclados). Aguarde ao menos um minuto para ver se algo acontece.</p></li>
 117 <li><p>O sistema não inicializa corretamente. Ele pode reiniciar espontaneamente ou pára em algum ponto (por exemplo, em algum ícone da tela de inicialização). No último caso tente também <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span>.</p></li>
 118 <li><p>O sistema inteiro ou alguma parte do equipamento não se comporta corretamente. Por exemplo, ele pode ficar muito lento, ocorrerem erros ou algo não funcionar absolutamente, a primeira verificação óbvia é se o Haiku já o suporta completamente (por exemplo, perguntando em uma lista de discussão ou num fórum).</p></li>
 119 </ul>
 120 <p>Observe que enquanto o último ponto parece indicar uma relação com hardware, todos os outros sintomas podem ser causados também por um erro num driver de dispositivo. Caso tenha uma suspeita de que parte do hardware ou o driver correspondente pode ter algo a ver com o problema, verifique se removendo/desabilitando o dispositivo ou o driver faz alguma diferença. Por exemplo, se há suspeita sobre o Wifi, pode-se procurar na  BIOS uma opção para desabilitá-lo. Ou se não, pode remover o driver Wifi responsável a partir da sua instalação do Haiku (em <span class="path">/boot/system/add-ons/kernel/drivers/bin</span>).</p>
 121
 122 <h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 123 <a id="kdl" name="kdl">Terra da Depuração do Kernel  - KDL</a></h3>
 124 <p>Se o sistema não entrar no KDL por si mesmo, pode-se fazê-lo intencionalmente invocando através do atalho de teclado <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span>.<br />
 125 Observe que no KDL seu teclado pode não funcionar. Teclados PS/2 sempre funcionam, teclados USB conectados via controladores UHCI apenas se alguém entrou no KDL via atalho de teclado ao menos uma vez. USB OHCI não é suportado no momento.</p>
 126 <p>O KDL propriamente é uma espécie de shell. Alguém pode executar comandos que exibem informação sobre o sistema. Os seguintes comandos podem ser de interesse:</p>
 127 <table summary="layout" border="0" cellpadding="2" cellspacing="0">
 128 <tr><td><span class="cli">bt</span> (conhecido como sc)</td><td> </td><td>Exibe um rastro. Se o sistema entrar no KDL por sua própria vontade, sempre o execute.</td></tr>
 129 <tr><td><span class="cli">ints</span></td><td> </td><td>Mostra as interrupções de dispositivos tratadas e não tratadas.</td></tr>
 130 <tr><td class="onelinetop"><span class="cli">co</span> (conhecido como continue)</td><td> </td><td>Sai do depurador do kernel e continua a operação normal do sistema, se for possível.</td></tr>
 131 <tr><td><span class="cli">reboot</span></td><td> </td><td>Reinicia o sistema imediatamente. Perder-se-á todos os dados não salvos e até mesmo aqueles que tenham sido salvos, mas que não tenham sido gravados no disco.</td></tr>
 132 </table>
 133 <p>Para mais informações, veja o artigo <a href="http://www.haiku-os.org/documents/dev/welcome_to_kernel_debugging_land">Bem vindo à Terra da Depuração do Kernel</a>.</p>
 134 <p>A saída do KDL é enviada para uma porta serial (caso tenha um, um cabo respectivo e um segundo computador conectado a ele, pode-se capturar a saída lá através de um programa de terminal) e para o relatório do sistema. Entretanto, se não puder sair do KDL ela não será escrita no arquivo de relatório do sistema. Todavia, existe uma opção de depuração do carregador da inicialização que permite capturá-la (veja abaixo).</p>
 135 <p>Pode-se gerar códigos QR a partir da saída do KDL que pode então ser convertido para texto utilizando smartphones ou dispositivos similares. Veja a postagem de blog <a href="http://www.haiku-os.org/blog/mmlr/2012-07-01_qr_encode_your_kdl_output">QR codifica sua saída do KDL</a> sobre como obter saída de dados do KDL utilizando aquela funcionalidade.</p>
 136
 137 <h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 138 <a id="syslog" name="syslog">Relatório de sistema</a></h3>
 139 <p><b>This is the preferred method for gaining information from a non-booting system.</b><br />
 140 The syslog (short for system log) contains valuable information about what has happened in your system, including the output of KDL sessions. It's usually a good idea to attach it to the kernel related Trac ticket. The syslog is written to the file <span class="path">/boot/system/var/log/syslog</span>. Since writing to a file requires a working system, the most recent output might not have made it to the syslog when a kernel problem occurs (particularly on spontaneous reboots or uncontinuable KDL sessions).</p>
 141 <p>The option <span class="menu">Enable debug syslog</span> in the boot loader's <span class="menu">Debug menu</span> makes the syslog persistent. If the option <span class="menu">Save syslog from previous session during boot</span> is activated in the boot loader options (as it is by default), you'll find the syslog of your last session as <span class="path">/boot/system/var/log/previous_syslog</span>.<br />
 142 If you're not able to boot to get to the previous_syslog, you have to enter the boot loader menu by holding down <span class="key">SHIFT</span> while booting.<br />
 143 In the boot loader's <span class="menu">Debug menu</span> you should find the entries <span class="menu">Display syslog from previous session</span> and <span class="menu">Save syslog from previous session</span>. The former displays the syslog on screen, the latter allows you to save it as a file to disk. Note that at the moment only FAT32 volumes are supported for saving the file. If you want to use a USB stick, but have plugged it in too late so that it isn't recognized yet, you can reset the machine and re-enter the boot loader menu. Note: Don't accidentally boot any operating system or the data will be lost.</p>
 144
 145 <h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 146 <a id="onscreen" name="onscreen">Saída de depuração na tela</a></h3>
 147 <p><b>A saída em tela é útil apenas para depurar problemas muito específicos e é conhecido por ter problemas (de tempo). Não a utilize, se não precisar.</b><br />
 148 Isto é relevante apenas quando o Haiku falha ao inicializar na sua máquina e a <span class="menu">Opção de relatório de sistema do depurador</span> não funciona por alguma razão. Antes da logo de inicialização do Haiku aparecer, pressione <span class="key">SHIFT</span> para entrar no menu do carregador de inicialização. Selecione <span class="menu">Selecionar opções de modo seguro</span>. Próximo do fim, <span class="menu">[ ] Habilitar saída de depuração na tela</span> será listada. (Observação: As outras opções podem ser habilitadas numa tentativa de inicializar o Haiku. Se o Haiku inicializar apenas quando uma ou mais opções forem ativadas, assegure-se de mencionar quais são.)<br />
 149 Finalmente selecione <span class="menu">Voltar para o menu principal</span> e então <span class="menu">Continuar a inicialização</span>.<br />
 150 Uma ou mais páginas de texto serão exibidas na tela, apenas as últimas poucas linhas precisam ser incluídas no seu tíquete. Há mais informações em <a href="../../userguide/pt_BR/bootloader.html">Carregador de Inicialização</a>.</p>
 151
 152 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 153 <a id="hardware" name="hardware">Erros de Dispositivo/Driver</a></h2>
 154 <p>Enquanto estiver lidando com um erro relativo a dispositivo/driver, deve-se anexar as seguintes informações como arquivos de texto:</p>
 155
 156 <table summary="layout" border="0" cellpadding="2" cellspacing="0">
 157 <tr><td>- <span class="cli">listdev</span></td><td> </td><td>Uma lista detalhada do seu dispositivo, incluindo fornecedor e id's pci, similar ao  <span class="cli">lshw</span> e <span class="cli">lspci</span> do Linux.</td></tr>
 158 <tr><td>- <span class="cli">listusb -v</span></td><td> </td><td>Supondo que seja um problema relacionado a USB, é similar ao <span class="cli">lsusb</span>.</td></tr>
 159 <tr><td>- <span class="cli">open /var/log/syslog</span></td><td> </td><td>O relatório primário de sistema utilizado pelo Haiku, parecido com a depuração na tela durante a inicialização. Com o comando <span class="cli">open</span> pode-se cortar a parte relevante do relatório de sistema em um editor de texto.</td></tr>
 160 <tr><td class="onelinetop">- <span class="cli">listimage | grep drivers/</span></td><td> </td><td>Lista todos os drivers utilizados.</td></tr>
 161 <tr><td>- <span class="cli">ints</span></td><td> </td><td>Apenas disponível na <i>Terra da Deupração do Kernel</i> (ver acima). Exibe a utilização das interrupções. There shouldn't be too many that are shared by different devices.</td></tr>
 162 <tr><td colspan="3">- Saída de depuração na tela (Uma opção de  modo de segurança em tempo de inicialização).</td></tr>
 163 </table>
 164
 165 <p>Os primeiros quatro comandos são executados no Terminal. Adicione um <span class="cli"> &gt; output.txt</span> após um comando e ele será direcionado para um arquivo de texto chamado "output.txt" que pode ser anexado a seu relatório de erro ou mensagem de correio eletrônico.</p>
 166
 167 <h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 168 <a id="next" name="next">O que vem a seguir?</a></h2>
 169 <p>Após o erro ter sido reportado, um desenvolvedor irá dar uma olhada e tentar classificá-lo. Lembre-se, nós somos voluntários e, como tais, algumas vezes um relatório de erro pode ficar sem resposta por um tempo. Adicionar informação nova quando disponível geralmente ajuda a selecionar o problema mais rapidamente, mas não tente 'incrementar' o erro adicionando comentários não descritivos.</p>
 170 <p>Lembre-se, reportar um erro não é algo a que se dispensa um pouco de tempo e então está resolvido. Se reportou um erro, então você é parte do processo de desenvolvimento do  Haiku. Desenvolvedores podem aparecer com perguntas enquanto eles estão tentando consertar o erro. Por favor esteja disponível para respondê-los. Considere sua participação 'terminada' quando o erro estiver marcado como 'corrigido'.</p>
 171
 172 </div>
 173 </div>
 174
 175 <div class="nav">
 176 <div class="inner"><span>
 177     <a href="../welcome_pt_BR.html" class="uplink">Welcome</a>
 178 </span></div>
 179 </div>
 180
 181 </body>
 182 </html>