0 - en to pt-BR translation catalogue (112 entries)

en: Documentation
pt-BR: Documentação

en: Solving problems
pt-BR: Resolvendo problemas

en: Log files
pt-BR: Arquivos Log

en: Solving Problems and Finding Relevant Information
pt-BR: Resolvendo Problemas e Encontrando Informações Relevantes

en: For an administrator, the most important skill is to be able to cope with any situation, known or unknown. This chapter gives a number of methods that will — hopefully — allow you to isolate the cause of any problem that you will encounter, so that you may be able to resolve them.
pt-BR: Para um administrador, a habilidade mais importante é ser capaz de lidar com qualquer situação, conhecida ou desconhecida. Este capítulo apresenta uma série de métodos que - esperamos - permitam isolar a causa de qualquer problema que você vai encontrar, de modo que você pode ser capaz de resolvê-los.

en: Documentation Sources
pt-BR: Fontes de documentação

en: <primary>documentation</primary>
pt-BR: <primary>documentação</primary>

en: Before you can understand what is really going on when there is a problem, you need to know the theoretical role played by each program involved in the problem. To do this, the best reflex to have is consult their documentation; but since these documentations are many and can be scattered far and wide, you should know all the places where they can be found.
pt-BR: Antes que você possa entender o que está realmente acontecendo quando há um problema, você precisa conhecer o papel teórico desempenhado por cada programa envolvido no problema. Para fazer isso, a melhor coisa a fazer é consultar a documentação; mas uma vez que estes documentos são muitos e dispersos, você deve conhecer todos os lugares onde podem ser encontrados.

en: Manual Pages
pt-BR: Páginas de Manual

en: <primary>manual pages</primary>
pt-BR: <primary>páginas de manual</primary>

en: <primary>documentation</primary><secondary>manual pages</secondary>
pt-BR: <primary>documentação</primary><secondary>páginas de manual</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/man/</filename></secondary>
pt-BR: <primary>documentação</primary><secondary><filename>/usr/share/man/</filename></secondary>

en: <emphasis>CULTURE</emphasis> <acronym>RTFM</acronym>
pt-BR: <emphasis>CULTURA</emphasis> <acronym>RTFM</acronym>

en: This acronym stands for “Read the F***ing Manual”, but can also be expanded in a friendlier variant, “Read the Fine Manual”. This phrase is sometimes used in (terse) responses to questions from newbies. It is rather abrupt, and betrays a certain annoyance at a question asked by someone who has not even bothered to read the documentation. Some say that this classic response is better than no response at all (since it indicates that the documentation contains the information sought), or than a more verbose and angry answer.
pt-BR: Esta sigla significa "Read the F**king Manual" - "Leia a P*rra do Manual", mas também pode ser expandida em uma variante mais amigável, "Read the Fine Manual" - "Leia o Excelente Manual". Esta frase é usada às vezes como uma resposta (resumida) para perguntas dos novatos. É um pouco abrupta, e denuncia um certo incômodo em uma pergunta feita por alguém que nem sequer se preocupou em ler a documentação. Alguns dizem que esta resposta clássica é melhor do que nenhuma resposta (já que indica que a documentação contém as informações solicitadas), ou do que uma resposta mais longa e agressiva.

en: In any case, if someone responds “RTFM” to you, it is often wise not to take offense. Since this answer may be perceived as vexing, you might want to try and avoid receiving it. If the information that you need is not in the manual, which can happen, you might want to say so, preferably in your initial question. You should also describe the various steps that you have personally taken to find information before you raised a question on a forum. Following Eric Raymond's guidelines is a good way to avoid the most common mistakes and get useful answers. <ulink type="block" url="http://catb.org/~esr/faqs/smart-questions.html" />
pt-BR: Em qualquer caso, se alguém responde "RTFM" para você, muitas vezes é sábio não se ofender. Uma vez que esta resposta pode ser percebida como irritante, você pode querer tentar evitar recebê-la. Se a informação que você precisa não está no manual, o que pode acontecer, você pode dizer isto, de preferência na sua pergunta inicial. Você também deve descrever as várias etapas que você pessoalmente realizou para encontrar informações antes de você levantar uma questão em um fórum. Seguir as orientações de Eric Raymond é uma boa maneira de evitar os erros mais comuns e obter respostas úteis. <ulink type="block" url="http://catb.org/~esr/faqs/smart-questions.html" /> (em inglês)

en: Manual pages, while relatively terse in style, contain a great deal of essential information. We will quickly go over the command for viewing them, provided by the <emphasis role="pkg">man-db</emphasis> package. Simply type <command>man <replaceable>manual-page</replaceable></command> — the manual page usually goes by the same name as the command whose documentation is sought. For example, to learn about the possible options for the <command>cp</command> command, you would type the <command>man cp</command> command at the shell prompt (see sidebar <xref linkend="sidebar.shell" />).
pt-BR: Páginas de manual, apesar de relativamente concisas em estilo, contêm uma grande quantidade de informações essenciais. Vamos rapidamente passar pelo comando para visualizá-las, fornecido pelo pacote <emphasis role="pkg">man-db</emphasis>. Basta digitar <command>man <replaceable>página-do-manual</replaceable></command> - a página do manual normalmente atende pelo mesmo nome que o comando cuja documentação é solicitada. Por exemplo, para aprender sobre as opções possíveis para o comando <command>cp</command>, você deve digitar <command>man cp</command> no prompt do shell (veja barra lateral <xref linkend="sidebar.shell" />).

en: <emphasis>BACK TO BASICS</emphasis> The shell, a command line interpreter
pt-BR: <emphasis>DE VOLTA AO BÁSICO</emphasis> O shell, um interpretador de linha de comando

en: <primary>command line interpreter</primary>
pt-BR: <primary>interpretador de linha de comando</primary>

en: A command line interpreter, also called a “shell”, is a program that executes commands that are either entered by the user or stored in a script. In interactive mode, it displays a prompt (usually ending in <literal>$</literal> for a normal user, or by <literal>#</literal> for an administrator) indicating that it is ready to read a new command. <xref linkend="short-remedial-course" /> describes the basics of using the shell.
pt-BR: Um interpretador de linha de comando, também chamado de "shell", é um programa que executa comandos que são ou inseridos pelo usuário ou armazenados em um script. No modo interativo, ele exibe um prompt (geralmente terminando em <literal>$</literal> para um usuário normal, ou por <literal>#</literal> para um administrador) indicando que ele está pronto para ler um novo comando. <xref linkend="short-remedial-course" /> descreve os fundamentos para usar o shell.

en: The default and most commonly used shell is <command>bash</command> (Bourne Again SHell), but there are others, including <command>dash</command>, <command>csh</command>, <command>tcsh</command> and <command>zsh</command>.
pt-BR: O shell padrão e mais comumente usado é o <command>bash</command> (Bourne Again SHell), mas existem outros, incluindo <command>dash</command>, <command>csh</command>, <command>tcsh</command> e <command>zsh</command>.

en: Among other things, most shells offer help (type <command>help</command>) and assistance during input at the prompt, such as the completion of command or file names (which you can generally activate by pressing the <keycap>tab</keycap> key), or recalling previous commands (history management; i.e. check out the mappings for "page up" and "page down" in <filename>/etc/inputrc</filename>).
pt-BR: Entre outras coisas, a maioria dos shells oferecem ajuda (digite <command>help</command>) e auxílio no prompt durante a entrada, tais como a completação de nomes de comandos ou arquivos (que você ativa apertando geralmente a tecla <keycap>tab</keycap>), ou recordando comandos anteriores (gestão de histórico: i.e. verifique os mapeamentos para "page up" e "page down" em <filename>/etc/inputrc</filename>).

en: Man pages not only document commands and programs accessible from the command line, but also configuration files, system calls, library functions, and so forth. Sometimes names can collide. For example, the shell's <command>read</command> command has the same name as the <function>read</function> system call. This is why manual pages are organized in numbered sections:
pt-BR: Páginas de manual não apenas documentam comandos e programas acessíveis a partir da linha de comando, mas também arquivos de configuração, chamadas de sistema, funções de biblioteca, e assim por diante. Às vezes os nomes podem colidir. Por exemplo, o comando <command>read</command> do shell tem o mesmo nome que a chamada de sistema <function>read</function>. É por isso que as páginas de manual são organizadas em seções numeradas:

en: commands that can be executed from the command line;
pt-BR: comandos que podem ser executados da linha de comando;

en: system calls (functions provided by the kernel);
pt-BR: chamadas de sistema (funções disponibilizadas pelo kernel);

en: library functions (provided by system libraries);
pt-BR: funções da biblioteca (fornecidas pelas bibliotecas do sistema);

en: devices (on Unix-like systems, these are special files, usually placed in the <filename>/dev/</filename> directory);
pt-BR: dispositivos (em sistemas similares ao Unix, estes são arquivos especiais, geralmente colocados no diretório <filename>/dev/</filename>);

en: configuration files (formats and conventions);
pt-BR: arquivos de configuração (formatos e convenções);

en: games;
pt-BR: jogos;

en: sets of macros and standards;
pt-BR: conjunto de macros e padrões;

en: system administration commands;
pt-BR: comandos de administração do sistema;

en: kernel routines.
pt-BR: rotinas do núcleo.

en: It is possible to specify the section of the manual page that you are looking for: to view the documentation for the <function>read</function> system call, you would type <command>man 2 read</command>. When no section is explicitly specified, the first section that has a manual page with the requested name will be shown. Thus, <command>man shadow</command> returns <citerefentry><refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum></citerefentry> because there are no manual pages for <foreignphrase>shadow</foreignphrase> in sections 1 to 4.
pt-BR: É possível especificar a seção da página do manual que você está procurando: para ver a documentação para o chamada de sistema <function>read</function>, você deve digitar <command>man 2 read</command>. Quando a seção não é especificada explicitamente, a primeira seção que tiver uma página de manual com o nome solicitado será mostrada. Assim, <command>man shadow</command> retorna <citerefentry><refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum></citerefentry> porque não há páginas de manual para <foreignphrase>shadow</foreignphrase> nas seções de 1 a 4.

en: <emphasis>TIP</emphasis> <command>whatis</command>
pt-BR: <emphasis>DICA</emphasis> <command>whatis</command>

en: If you do not want to look at the full manual page, but only a short description to confirm that it is what you are looking for, simply enter <command>whatis <replaceable>command</replaceable></command>.
pt-BR: Se você não quer ler a página de manual completa, mas apenas uma descrição breve para confirmar que é o que você está procurando, basta digitar <command>whatis <replaceable>comando</replaceable></command>.

en: This short description is included in the <emphasis>NAME</emphasis> section at the beginning of all manual pages.
pt-BR: Esta pequena descrição está incluída na seção <emphasis>NOME</emphasis> no início de todas as páginas de manual.

en: Of course, if you do not know the names of the commands, the manual is not going to be of much use to you. This is the purpose of the <command>apropos</command> command, which helps you conduct a search in the manual pages, or more specifically in their short descriptions. Each manual page begins essentially with a one line summary. <command>apropos</command> returns a list of manual pages whose summary mentions the requested keyword(s). If you choose them well, you will find the name of the command that you need.
pt-BR: obviamente que se você não sabe os nomes dos comandos, o manual não vai ser de muita utilidade para você. Este é o propósito do comando <command>apropos</command>, o que ajuda você a realizar uma busca nas páginas de manual, ou mais especificamente em suas descrições curtas. Cada página do manual começa essencialmente com um resumo de uma linha. <command>apropos</command> retorna uma lista de páginas de manual que mencionam a(s) palavra(s)-chave solicitada(s). Se você escolher bem, você encontrará o nome do comando que você precisa.

en: Finding <command>cp</command> with <command>apropos</command>
pt-BR: Procurando <command>cp</command> com <command>apropos</command>

en: <emphasis>TIP</emphasis> Browsing by following links
pt-BR: <emphasis>DICA</emphasis> Navegando através de links

en: Many manual pages have a “SEE ALSO” section, usually at the end. It refers to other manual pages relevant to similar commands, or to external documentation. In this way, it is possible to find relevant documentation even when the first choice is not optimal.
pt-BR: Muitas páginas do manual têm uma seção "VEJA TAMBÉM", geralmente no final. Refere-se a outras páginas de manuais relevantes para comandos semelhantes, ou a documentação externa. Desta forma, é possível encontrar documentação relevante, mesmo quando a primeira escolha não é ótima.

en: The <command>man</command> command is not the only means of consulting the manual pages, since <command>khelpcenter</command> and <command>konqueror</command> (by KDE) and <command>yelp</command> (under GNOME) programs also offer this possibility. There is also a web interface, provided by the <command>man2html</command> package, which allows you to view manual pages in a web browser. On a computer where this package is installed, use this URL after following the instructions in <filename>/usr/share/doc/man2html/README.Debian</filename>: <ulink type="block" url="http://localhost/cgi-bin/man/man2html" />
pt-BR: O comando <command>man</command> não é o único meio de consulta às páginas do manual, já que os programas <command>khelpcenter</command> e <command>konqueror</command> (do KDE) e <command>yelp</command> (no GNOME) também oferecem essa possibilidade. Há também uma interface web, fornecida pelo pacote <command>man2html</command>, que permite visualizar páginas de manual em um navegador web. Em um computador onde esse pacote está instalado, use esta URL depois de seguir as instruções em <filename>/usr/share/doc/man2html/README.Debian</filename>: <ulink type="block" url="http://localhost/cgi-bin/man/man2html" />

en: This utility requires a web server. This is why you should choose to install this package on one of your servers: all users of the local network could benefit from this service (including non-Linux machines), and this will allow you not to set up an HTTP server on each workstation. If your server is also accessible from other networks, it may be desirable to restrict access to this service only to users of the local network.
pt-BR: Este utilitário requer um servidor web. É por isso que você deve optar por instalar este pacote em um dos servidores: todos os usuários da rede local poderão se beneficiar deste serviço (incluindo máquinas não-Linux), e isso permitirá que você não configure um servidor HTTP em cada estação de trabalho. Se o seu servidor também é acessível a partir de outras redes, pode ser desejável restringir o acesso a este serviço apenas para usuários da rede local.

en: Last but not least, you can view all manual pages available in Debian (even those that are not installed on your machine) on the <literal>manpages.debian.org</literal> service. It offers each manual page in multiple versions, one for each Debian release. <ulink type="block" url="https://manpages.debian.org" />
pt-BR: Por último mas não menos importante, você pode ver todas as páginas de manual disponíveis no Debian (mesmo as que não estão instaladas na sua máquina) no serviço <literal>manpages.debian.org</literal>. Ele oferece cada página de manual em múltiplas versões, uma para cada lançamento do Debian. <ulink type="block" url="https://manpages.debian.org" />

en: <emphasis>DEBIAN POLICY</emphasis> Required man pages
pt-BR: <emphasis>POLÍTICA DEBIAN</emphasis> Páginas de manual necessárias

en: Debian requires each program to have a manual page. If the upstream author does not provide one, the Debian package maintainer will usually write a minimal page that will at the very least direct the reader to the location of the original documentation.
pt-BR: O Debian requer que cada programa tenha uma página de manual. Se o autor original não fornecer uma, o mantenedor do pacote Debian normalmente irá escrever uma página mínima que dirá ao leitor, no mínimo, o local da documentação original.

en: <emphasis>info</emphasis> Documents
pt-BR: Documentos de <emphasis>info</emphasis>

en: <primary>documentation</primary><secondary>info documents</secondary>
pt-BR: <primary>documentação</primary><secondary>documentos info</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/info/</filename></secondary>
pt-BR: <primary>documentação</primary><secondary><filename>/usr/share/info/</filename></secondary>

en: The GNU project has written manuals for most of its programs in the <emphasis>info</emphasis> format; this is why many manual pages refer to the corresponding <emphasis>info</emphasis> documentation. This format offers some advantages, but the default program to view these documents (it is called <command>info</command>) is also slightly more complex. You would be well advised to use <command>pinfo</command> instead (from the <emphasis role="pkg">pinfo</emphasis> package).
pt-BR: O projeto GNU escreveu manuais para a maioria de seus programas no formato <emphasis>info</emphasis>; é por isso que muitas páginas do manual referem-se à documentação <emphasis>info</emphasis> correspondente. Esse formato oferece algumas vantagens, mas o programa padrão para ver estes documentos (chamado <command>info</command>) é também um pouco mais complexo. Esteja você aconselhado a usar o <command>pinfo</command> em seu lugar (do pacote <emphasis role="pkg">pinfo</emphasis>).

en: The <emphasis>info</emphasis> documentation has a hierarchical structure, and if you invoke <command>pinfo</command> without parameters, it will display a list of the nodes available at the first level. Usually, nodes bear the name of the corresponding commands.
pt-BR: A documentação <emphasis>info</emphasis> tem uma estrutura hierárquica, e se você invocar <command>pinfo</command> sem parâmetros, ele irá mostrar uma lista de nós disponíveis no primeiro nível. Normalmente, os nós levam o nome dos comandos correspondentes.

en: With <command>pinfo</command> navigating between these nodes is easy to achieve with the arrow keys. Alternatively, you could also use a graphical browser, which is a lot more user-friendly. Again, <command>konqueror</command> and <command>yelp</command> work; the <command>info2www</command> package also provides a web interface. <ulink type="block" url="http://localhost/cgi-bin/info2www" />
pt-BR: Com o <command>pinfo</command> a navegação por esses nós é facilmente feita através das teclas de seta. Alternativamente, você também pode usar um navegador gráfico, que é muito mais amigável com o usuário. Mais uma vez, o <command>konqueror</command> e o <command>yelp</command> funcionam; o pacote <command>info2www</command> também fornece uma interface web. <ulink type="block" url="http://localhost/cgi-bin/info2www" />

en: Note that the <emphasis>info</emphasis> system is not suitable for translation, unlike the <command>man</command> page system. <emphasis>info</emphasis> documents are thus almost always in English. However, when you ask the <command>pinfo</command> program to display a non-existing <emphasis>info</emphasis> page, it will fall back on the <emphasis>man</emphasis> page by the same name (if it exists), which might be translated.
pt-BR: Observe que o sistema <emphasis>info</emphasis> não é adequado para tradução, ao contrário do Sistema de página <command>man</command>. Documentos <emphasis>info</emphasis> são, portanto, quase sempre em Inglês. No entanto, quando você pedir ao sistema <command>pinfo</command> para exibir uma página <emphasis>info</emphasis> inexistente, ele retornará a página <emphasis>man</emphasis> com o mesmo nome (se existir), que pode estar traduzida.

en: Specific Documentation
pt-BR: Documentação Específica

en: <primary>documentation</primary><secondary>package documentation</secondary>
pt-BR: <primary>documentação</primary><secondary>documentação do pacote</secondary>

en: <primary>documentation</primary><secondary>documentation package</secondary>
pt-BR: <primary>documentação</primary><secondary>documentação de pacote</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/doc/<replaceable>package</replaceable>/</filename></secondary>
pt-BR: <primary>documentação</primary><secondary><filename>/usr/share/doc/<replaceable>pacote</replaceable>/</filename></secondary>

en: <primary>documentation</primary><secondary><emphasis role="pkg"><replaceable>package</replaceable>-doc</emphasis></secondary>
pt-BR: <primary>documentação</primary><secondary><emphasis role="pkg"><replaceable>pacote</replaceable>-doc</emphasis></secondary>

en: Each package includes its own documentation. Even the least well documented programs generally have a <filename>README</filename> file containing some interesting and/or important information. This documentation is installed in the <filename>/usr/share/doc/<replaceable>package</replaceable>/</filename> directory (where <replaceable>package</replaceable> represents the name of the package). If the documentation is particularly large, it may not be included in the program's main package, but might be offloaded to a dedicated package which is usually named <literal><replaceable>package</replaceable>-doc</literal>. The main package generally recommends the documentation package so that you can easily find it.
pt-BR: Cada pacote inclui a sua própria documentação. Mesmo os programas mais mal documentados costumam ter um arquivo <filename>README</filename> que contém algumas informações interessantes e/ou importantes. Esta documentação está instalada no diretório <filename>/usr/share/doc/<replaceable>pacote</replaceable>/</filename> (onde <replaceable>pacote</replaceable> é o nome do pacote). Se a documentação é particularmente grande, não pode ser incluída no pacote principal do programa, mas pode ser transferida para um pacote dedicado que normalmente é chamado <literal><replaceable>pacote</replaceable>-doc</literal>. O pacote principal geralmente recomenda o pacote de documentação para que você possa encontrá-lo facilmente.

en: The <filename>/usr/share/doc/<replaceable>package</replaceable>/</filename> directory also contains some files provided by Debian which complete the documentation by specifying the package's particularities or improvements compared to a traditional installation of the software. The <filename>README.Debian</filename> file also indicates all of the adaptations that were made to comply with the Debian Policy. The <filename>changelog.Debian.gz</filename> file allows the user to follow the modifications made to the package over time: it is very useful to try to understand what has changed between two installed versions that do not have the same behavior. Finally, there is sometimes a <filename>NEWS.Debian.gz</filename> file which documents the major changes in the program that may directly concern the administrator (see <xref linkend="sect.dist-upgrade-problems" />).
pt-BR: O diretório <filename>/usr/share/doc/<replaceable>package</replaceable>/</filename> também contém alguns arquivos fornecidos pelo Debian que completam a documentação especificando as particularidades do pacote ou melhorias em relação a uma instalação tradicional do software. O arquivo <filename>README.Debian</filename> também indica todas as adaptações que foram feitas para cumprir com a política Debian. O arquivo <filename>changelog.Debian.gz</filename> permite ao usuário acompanhar as modificações feitas no pacote ao longo do tempo: é muito útil para tentar entender o que mudou entre as duas versões instaladas que não têm o mesmo comportamento. Finalmente, às vezes existe um arquivo <filename>NEWS.Debian.gz</filename> que documenta as maiores mudanças no programa que pode diretamente se referir ao administrador (veja <xref linkend="sect.dist-upgrade-problems" />).

en: Websites
pt-BR: Paginas da Internet

en: <primary>documentation</primary><secondary>websites</secondary>
pt-BR: <primary>documentação</primary><secondary>websites</secondary>

en: <emphasis>TIP</emphasis> From error to solution
pt-BR: <emphasis>DICA</emphasis> Do erro à solução

en: If the software returns a very specific error message, enter it into the search engine (between double quotes, <literal>"</literal>, in order to search not for individual keywords, but for the complete phrase). In most cases, the first links returned will contain the answer that you need.
pt-BR: Se o software retorna uma mensagem de erro muito específica, inseri-lo no motor de busca (entre aspas, <literal>"</literal>, a fim de não procurar por palavras-chave individuais, mas para a frase completa). Na maioria dos casos, os primeiros links retornados conterão a resposta que você precisa.

en: In other cases, you will get very general errors, such as “Permission denied”. In this case, it is best to check the permissions of the elements involved (files, user ID, groups, etc.).
pt-BR: Em outros casos, você vai ter erros muito gerais, como "Permissão negada". Neste caso, o melhor é verificar as permissões dos elementos envolvidos (arquivos, identificação de usuário, grupos, etc).

en: If you do not know the address for the software's website, there are various means of getting it. First, check if there is a <literal>Homepage</literal> field in the package's meta-information (<command>apt show <replaceable>package</replaceable></command>). Alternately, the package description may contain a link to the program's official website. If no URL is indicated, look at <filename>/usr/share/doc/<replaceable>package</replaceable>/copyright</filename>. The Debian maintainer generally indicates in this file where they got the program's source code, and this is likely to be the website that you need to find. If at this stage your search is still unfruitful, consult a free software directory, such as FSF's Free Software Directory, or search directly with a search engine, such as Google, DuckDuckGo, Yahoo, etc. <ulink type="block" url="https://directory.fsf.org/wiki/Main_Page" />
pt-BR: Se você não sabe o endereço para o site do software, existem vários meios de consegui-lo. Primeiro, verifique se existe um campo <literal>Homepage</literal> na meta-informação do pacote (<command>apt show <replaceable>pacote</replaceable></command>). Alternativamente, a descrição do pacote pode conter um link para o site oficial do programa. Se nenhuma URL for indicada, olhe em <filename>/usr/share/doc/<replaceable>pacote</replaceable>/copyright</filename>. O mantenedor do Debian geralmente indica neste arquivo de onde ele pegou o código-fonte do programa, e este é provavelmente o site que você precisa encontrar. Se nesta fase a sua pesquisa ainda é infrutífera, consulte um diretório de software livre, como o Diretório de Software Livre da FSF, ou procure diretamente com um motor de busca, como Google, DuckDuckGo, Yahoo, etc. <ulink type="block" url="https://directory.fsf.org/wiki/Main_Page" />

en: <primary>Free Software Directory</primary>
pt-BR: <primary>Diretório de Software Livre</primary>

en: <primary>documentation</primary><secondary><literal>wiki.debian.org</literal></secondary>
pt-BR: <primary>documentação</primary><secondary><literal>wiki.debian.org</literal></secondary>

en: Tutorials (<emphasis>HOWTO</emphasis>)
pt-BR: Tutoriais (<emphasis>HOWTO</emphasis>)

en: <primary>documentation</primary><secondary>HOWTO</secondary>
pt-BR: <primary>documentação</primary><secondary>HOWTO</secondary>

en: <primary>documentation</primary><secondary>tutorials</secondary>
pt-BR: <primary>documentação</primary><secondary>tutoriais</secondary>

en: A <emphasis>HOWTO</emphasis> is a document that describes, in concrete terms and step by step, “how to” reach a predefined goal. The covered goals are relatively varied, but often technical in nature: for example, setting up IP Masquerading, configuring software RAID, installing a Samba server, etc. These documents often attempt to cover all of the potential problems likely to occur during the implementation of a given technology.
pt-BR: Um <emphasis>HOWTO</emphasis> é um documento que descreve, em termos concretos e passo a passo, como atingir uma meta pré-definida. Os objetivos cobertos são relativamente variados, mas muitas vezes de natureza técnica: por exemplo, a criação de mascara IP, configuração do software RAID, a instalação de um servidor Samba, etc. Estes documentos geralmente tentam cobrir todos os potenciais problemas susceptíveis de ocorrer durante a execução de uma determinada tecnologia.

en: <primary>Linux Documentation Project</primary>
pt-BR: <primary>Projeto de Documentação Linux</primary>

en: Debian also provides tutorials for its users: <ulink type="block" url="https://www.debian.org/doc/" />
pt-BR: O Debian também fornece tutoriais para seus usuários: <ulink type="block" url="https://www.debian.org/doc/" />

en: Common Procedures
pt-BR: Procedimentos comuns

en: <primary>standard procedure</primary>
pt-BR: <primary>procedimento padrão</primary>

en: The purpose of this section is to present some general tips on certain operations that an administrator will frequently have to perform. These procedures will of course not cover every possible case in an exhaustive way, but they may serve as starting points for the more difficult cases.
pt-BR: O objetivo desta seção é apresentar algumas dicas gerais sobre determinadas operações que um administrador frequentemente têm de realizar. Estes procedimentos é claro não cobrirão todos os casos possíveis de forma exaustiva, mas podem servir como pontos de partida para os casos mais difíceis.

en: <emphasis>DISCOVERY</emphasis> Documentation in other languages
pt-BR: <emphasis>DESCOBRIMENTO</emphasis> Documentação em outros idiomas

en: Often, documentation translated into a non-English language is available in a separate package with the name of the corresponding package, followed by <literal>-<replaceable>lang</replaceable></literal> (where <replaceable>lang</replaceable> is the two-letter ISO code for the language).
pt-BR: Muitas vezes, a documentação traduzida para uma língua não-inglesa está disponível em um pacote separado com o nome do pacote correspondente, seguido por <literal>-<replaceable>lang</replaceable></literal> (onde <replaceable>lang</replaceable> é o código de duas letras ISO para a linguagem).

en: For instance, the <emphasis role="pkg">debian-reference-fr</emphasis> package is the French version of the reference guides for Debian (initially written in English by Osamu Aoki), and the <emphasis role="pkg">manpages-de</emphasis> package contains the German version of the manual pages about using GNU/Linux.
pt-BR: Por exemplo, o pacote <emphasis role="pkg">debian-reference-fr</emphasis> é a versão francesa dos guias de referência para o Debian (inicialmente escritos em inglês por Osamu Aoki), e o pacote <emphasis role="pkg">manpages-de</emphasis> contém a versão em alemão das páginas de manual sobre como usar o GNU/Linux.

en: <primary>documentation</primary><secondary><emphasis role="pkg">manpages-<replaceable>lang</replaceable></emphasis></secondary>
pt-BR: <primary>documentação</primary><secondary><emphasis role="pkg">manpages-<replaceable>lang</replaceable></emphasis></secondary>

en: Configuring a Program
pt-BR: Configurando um Programa

en: <primary>configuration</primary><secondary>program configuration</secondary>
pt-BR: <primary>configuração</primary><secondary>configuração do programa</secondary>

en: <primary>program</primary><secondary>configuration</secondary>
pt-BR: <primary>programa</primary><secondary>configuração</secondary>

en: Then, you should look at the software's official documentation — refer to <xref linkend="sect.documentation-sources" /> to identify the various existing documentation sources. The <command>dpkg -L <replaceable>package</replaceable></command> command gives a list of files included in the package; you can therefore quickly identify the available documentation (as well as the configuration files, located in <filename>/etc/</filename>). <command>dpkg -s <replaceable>package</replaceable></command> displays the package meta-data and shows any possible recommended or suggested packages; in there, you can find documentation or a utility that will ease the configuration of the software.
pt-BR: Então, você deve olhar a documentação oficial do software - consulte a <xref linkend="sect.documentation-sources" /> para identificar as várias fontes de documentação existente. O comando <command>dpkg-L <replaceable>pacote</replaceable></command> fornece uma lista de arquivos incluídos no pacote, você pode, portanto, identificar rapidamente a documentação disponível (bem como os arquivos de configuração, localizados em <filename>/etc/</filename>). <command>dpkg-s <replaceable> pacote</replaceable></command> exibe os metadados do pacote e mostra todos os pacotes possíveis recomendados ou sugeridos; lá, você pode encontrar a documentação ou um utilitário que irá facilitar a configuração do software.

en: Finally, the configuration files are often self-documented by many explanatory comments detailing the various possible values for each configuration setting. So much so that it is sometimes enough to just choose a line to activate from among those available. In some cases, examples of configuration files are provided in the <filename>/usr/share/doc/<replaceable>package</replaceable>/examples/</filename> directory. They may serve as a basis for your own configuration file.
pt-BR: Finalmente, os arquivos de configuração são muitas vezes auto-documentados por muitos comentários explicativos, detalhando os vários valores possíveis para cada configuração. Tanto que às vezes é apenas o suficiente escolher uma linha para ativar entre as disponíveis. Em alguns casos, exemplos de arquivos de configuração são fornecidos no diretório <filename>/usr/share/doc/<replaceable>pacote</replaceable>/examples/</filename>. Eles podem servir de base para o seu próprio arquivo de configuração.

en: <emphasis>DEBIAN POLICY</emphasis> Location of examples
pt-BR: <emphasis>POLITICA DEBIAN</emphasis> Localização de exemplos

en: <primary>examples, location</primary>
pt-BR: <primary>exemplos, localização</primary>

en: All examples must be installed in the <filename>/usr/share/doc/<replaceable>package</replaceable>/examples/</filename> directory. This may be a configuration file, program source code (an example of the use of a library), or a data conversion script that the administrator can use in certain cases (such as to initialize a database). If the example is specific to a particular architecture, it should be installed in <filename>/usr/lib/<replaceable>package</replaceable>/examples/</filename> and there should be a link pointing to that file in the <filename>/usr/share/doc/<replaceable>package</replaceable>/examples/</filename> directory.
pt-BR: Todos os exemplos devem ser instalados no diretório <filename>/usr/share/doc/<replaceable>pacote</replaceable>/examples/</filename>. Este pode ser um ficheiro de configuração, o código de fonte do programa (um exemplo da utilização de uma biblioteca), ou um script de conversão de dados que o administrador pode utilizar, em certos casos (tal como para inicializar uma base de dados). Se o exemplo é específico para uma arquitetura particular, ele deve ser instalado em <filename>/usr/lib/<replaceable>pacote</replaceable>/examples/</filename> e deve haver um link apontando para esse arquivo no <filename>/usr/share/doc/pacote<replaceable></replaceable>/exemplos/</filename>.

en: Monitoring What Daemons Are Doing
pt-BR: Monitorando o que o Daemons esta fazendo

en: Understanding what a daemon does is somewhat more complicated, since it does not interact directly with the administrator. To check that a daemon is actually working, you need to test it. For example, to check the Apache (web server) daemon, test it with an HTTP request.
pt-BR: Entender o que um daemon faz é um pouco mais complicado, uma vez que não interagem diretamente com o administrador. Para verificar se um daemon está realmente trabalhando, você precisa testá-lo. Por exemplo, para verificar o daemon Apache (servidor web), testá-lo com uma solicitação HTTP.

en: <emphasis>BACK TO BASICS</emphasis> Daemon
pt-BR: <emphasis>DE VOLTA AO BÁSICO</emphasis> Daemon

en: A daemon is a program that is not explicitly invoked by the user and that stays in the background, waiting for a certain condition to be met before performing a task. Many server programs are daemons, a term that explains that the letter “d” is frequently present at the end of their name (<command>sshd</command>, <command>smtpd</command>, <command>httpd</command>, etc.).
pt-BR: Um daemon é um programa que não é explicitamente invocado pelo usuário e que fica por trás, à espera de uma determinada condição ser cumprida antes de executar uma tarefa. Muitos programas de servidor são daemons, um termo que explica que a letra "d" está frequentemente presente no final do seu nome (<command>sshd</command>, <command>smtpd</command>, <command>httpd</command>, etc.).

en: To allow such tests, each daemon generally records everything that it does, as well as any errors that it encounters, in what are called “log files” or “system logs”. Logs are stored in <filename>/var/log/</filename> or one of its subdirectories. To know the precise name of a log file for each daemon, see its documentation. Note: a single test is not always sufficient if it does not cover all the possible usage cases; some problems only occur in particular circumstances.
pt-BR: Para permitir esses testes, cada daemon geralmente registra tudo o que ele faz, bem como de quaisquer erros que encontrar, no que são chamados "arquivos de log" ou "logs do sistema". Os logs são armazenados em <filename>/var/log/</filename> ou um de seus subdiretórios. Para saber o nome exato de um arquivo de log para cada daemon, consulte a documentação. Nota: um único teste nem sempre é suficiente se não cobrir todos os casos de uso possíveis, alguns problemas só ocorrem em determinadas circunstâncias.

en: <emphasis>TOOL</emphasis> The <command>rsyslogd</command> daemon
pt-BR: <emphasis>FERRAMENTA</emphasis> O daemon <command>rsyslogd</command>

en: <command>rsyslogd</command> is special: it collects logs (internal system messages) that are sent to it by other programs. Each log entry is associated with a subsystem (e-mail, kernel, authentication, etc.) and a priority; <command>rsyslogd</command> processes these two pieces of information to decide on what to do. The log message may be recorded in various log files, and/or sent to an administration console. The details are defined in the <filename>/etc/rsyslog.conf</filename> configuration file (documented in the manual page of the same name provided in the <emphasis role="pkg">rsyslog-doc</emphasis> package).
pt-BR: <command>rsyslogd</command> é especial: ele coleta os logs (mensagens do sistema interno) que são enviados a ele por outros programas. Cada entrada de log é associada a um subsistema (e-mail, kernel autenticação, etc) e uma prioridade, <command>rsyslogd</command> processa essas duas informações para decidir o que fazer. A mensagem de log pode ser gravada em vários arquivos de log e/ou enviados para um console de administração. Os detalhes são definidos no arquivo de configuração <filename>/etc/rsyslog.conf</filename> (documentado na página de manual com o mesmo nome fornecido no pacote <emphasis role="pkg">rsyslog-doc</emphasis>).

en: Certain C functions, which are specialized in sending logs, simplify the use of the <command>rsyslogd</command> daemon. However some daemons manage their own log files (this is the case, for example, of <command>samba</command>, which implements Windows shares on Linux).
pt-BR: Certas funções C, que são especializadas em enviar logs, simplificam o uso do daemon <command>rsyslogd</command>. No entanto, alguns daemons gerem os seus próprios arquivos de log (este é o caso, por exemplo, do <command>samba</command>, que implementa compartilhamento do Windows no Linux).

en: Note that when <command>systemd</command> is in use, the logs are actually collected by <command>systemd</command> before being forwarded to <command>rsyslogd</command>. They are thus also available via <command>systemd</command>'s journal and can be consulted with <command>journalctl</command> (see <xref linkend="sect.systemd" /> for details).
pt-BR: Note que quando o <command>systemd</command> está em uso, os logs, na realidade, são coletados pelo <command>systemd</command> antes de serem repassados para o <command>rsyslogd</command>. Sendo assim, eles estão disponíveis via o "journal" do <command>systemd</command> e podem ser consultados com o <command>journalctl</command> (veja <xref linkend="sect.systemd" /> para detalhes).

en: Asking for Help on a Mailing List
pt-BR: Pedindo ajuda em uma lista

en: <primary>mailing lists</primary>
pt-BR: <primary>listas de email</primary>

en: If your various searches haven't helped you to get to the root of a problem, it is possible to get help from other, perhaps more experienced people. This is exactly the purpose of the <email>debian-user@lists.debian.org</email> mailing list and its language specific siblings <email>debian-user-<replaceable>lang</replaceable>@lists.debian.org</email>. As with any community, it has rules that need to be followed. Before asking any question, you should check that your problem isn't already covered by recent discussions on the list or by any official documentation. <ulink type="block" url="https://wiki.debian.org/DebianMailingLists" /> <ulink type="block" url="https://lists.debian.org/debian-user/" /> <ulink type="block" url="https://lists.debian.org/users.html" />
pt-BR: Se as suas várias buscas não tiverem ajudado a chegar à raiz de um problema, é possível obter ajuda de outras pessoas, talvez mais experientes. Este é exatamente o objetivo da lista <email>debian-user@lists.debian.org</email> e suas parceiras em outras línguas <email>debian-user-<replaceable>lang</replaceable>@lists.debian.org</email>. Como em qualquer comunidade, tem regras que precisam ser seguidas. Antes de fazer qualquer pergunta, você deve verificar se o seu problema não foi abordado por debates recentes na lista ou em qualquer documentação oficial. <ulink type="block" url="https://wiki.debian.org/DebianMailingLists" /> <ulink type="block" url="https://lists.debian.org/debian-user/" /> <ulink type="block" url="https://lists.debian.org/users.html" />

en: <primary>mailing lists</primary><secondary><email>debian-user@lists.debian.org</email></secondary>
pt-BR: <primary>listas de email</primary><secondary><email>debian-user@lists.debian.org</email></secondary>

en: <primary>mailing lists</primary><secondary><email>debian-user-<replaceable>lang</replaceable>@lists.debian.org</email></secondary>
pt-BR: <primary>listas de email</primary><secondary><email>debian-user-<replaceable>lang</replaceable>@lists.debian.org</email></secondary>

en: <emphasis>BACK TO BASICS</emphasis> Netiquette applies
pt-BR: <emphasis>DE VOLTA AO BÁSICO</emphasis> Aplicar Netiquette

en: <primary>Netiquette</primary>
pt-BR: <primary>Netiqueta</primary>

en: <primary>Code of Conduct</primary>
pt-BR: <primary>Código de Conduta</primary>

en: In general, for all correspondence on e-mail lists, the rules of Netiquette should be followed. This term refers to a set of common sense rules, from common courtesy to mistakes that should be avoided. <ulink type="block" url="https://tools.ietf.org/html/rfc1855" />
pt-BR: Em geral, para toda a correspondência em listas de discussão, as regras de netiqueta devem ser seguidas. Este termo refere-se a um conjunto de regras de senso comum, a partir de cortesia comum para erros que devem ser evitados. <ulink type="block" url="https://tools.ietf.org/html/rfc1855" />

en: Furthermore, for any communication channel managed by the Debian project, you are bound by the Debian Code of Conduct: <ulink type="block" url="https://www.debian.org/code_of_conduct" />
pt-BR: Além disso, para qualquer canal de comunicação gerenciado pelo projeto Debian, você está submetido ao Código de Conduta Debian: <ulink type="block" url="https://www.debian.org/code_of_conduct" />

en: Once those two conditions are met, you can think of describing your problem to the mailing list. Include as much relevant information as possible: various tests conducted, documentation consulted, how you attempted to diagnose the problem, the packages concerned or those that may be involved, etc. Check the Debian Bug Tracking System (BTS, described in sidebar <xref linkend="sect.bts" />) for similar problems, and mention the results of that search, providing links to bugs found. BTS starts on: <ulink type="block" url="https://bugs.debian.org/" />
pt-BR: Uma vez satisfeitas estas duas condições, você pode pensar em descrever o seu problema para a lista de discussão. Inclua o máximo de informações relevantes possíveis: vários testes realizados, documentação consultada, como você tentou diagnosticar o problema, os pacotes em questão ou aqueles que podem estar envolvidos, etc. Verifique o Sistema de Acompanhamento de Bugs (BTS, descrito na barra lateral <xref linkend="sect.bts" />) para problemas semelhantes, e mencione os resultados dessa pesquisa, fornecendo links para bugs encontrados. BTS começa em: <ulink type="block" url="https://bugs.debian.org/" />

en: The more courteous and precise you have been, the greater your chances are of getting an answer, or, at least, some elements of response. If you receive relevant information by private e-mail, think of summarizing this information publicly so that others can benefit. This also allows the list's archives, searched through various search engines, to show the resolution for others who may have the same question.
pt-BR: O mais cortês e preciso que você tenha sido, as maiores chances suas de obter uma resposta, ou, pelo menos, alguns elementos de resposta. Se você receber informações relevantes por e-mail privado, pense em resumir esta informação publicamente para que outros possam beneficiar. Isto também permite que os arquivos da lista, pesquisados através de vários motores de busca, mostrem a resolução para outros que podem ter a mesma pergunta.

en: Reporting a Bug When a Problem Is Too Difficult
pt-BR: Reportando um Bug Quando um Problema É Muito Difícil

en: <primary>report a bug</primary>
pt-BR: <primary>relatar um bug</primary>

en: If all of your efforts to resolve a problem fail, it is possible that a resolution is not your responsibility, and that the problem is due to a bug in the program. In this case, the proper procedure is to report the bug to Debian or directly to the upstream developers. To do this, isolate the problem as much as possible and create a minimal test situation in which it can be reproduced. If you know which program is the apparent cause of the problem, you can find its corresponding package using the command, <command>dpkg -S <replaceable>file_in_question</replaceable></command>. Check the Bug Tracking System (<literal>https://bugs.debian.org/<replaceable>package</replaceable></literal>) to ensure that the bug has not already been reported. You can then send your own bug report, using the <command>reportbug</command> command, including as much information as possible, especially a complete description of those minimal test cases that will allow anyone to recreate the bug.
pt-BR: Se todos os seus esforços para resolver um problema falhar, é possível que uma resolução não seja de sua responsabilidade, e que o problema é devido a um bug no programa. Neste caso, o procedimento correto é relatar o bug ao Debian ou diretamente aos desenvolvedores. Para fazer isso, isolar o problema, tanto quanto possível e criar uma situação de teste mínimo em que pode ser reproduzido. Se você souber qual o programa que é a causa aparente do problema, você pode encontrar o seu pacote correspondente usando o comando, <command>dpkg-S<replaceable>arquivo_em_questao</replaceable></command>. Verifique o Sistema de Rastreamento de Bugs (<literal>https://bugs.debian.org/<replaceable>pacote</replaceable></literal>) para assegurar que o erro não tenha sido relatado. Você pode então enviar o seu relatório de bug próprio, usando o comando <command>reportbug</command>, incluindo as informações, tanto quanto possível, especialmente uma descrição completa dos casos de teste mínimo que permitirá que qualquer pessoa recrie o bug.

en: The elements of this chapter are a means of effectively resolving issues that the following chapters may bring about. Use them as often as necessary!
pt-BR: Os elementos deste capítulo são um meio eficaz para resolver os problemas que os capítulos que se seguem podem trazer. Use-os sempre que necessário!
