0 - en to ca-ES translation catalogue (111 entries)

en: Documentation
ca-ES: Documentació

en: Solving problems
ca-ES: Solucionant problemes

en: Log files
ca-ES: Fitxers de registre

en: Solving Problems and Finding Relevant Information
ca-ES: Solucionar problemes i trobar informació rellevant

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.
ca-ES: Per a un administrador, l'habilitat més important és poder fer front a qualsevol situació, coneguda o desconeguda. Aquest capítol dóna una sèrie de mètodes que, esperem, us permetran aïllar la causa de qualsevol problema que trobeu, de manera que pugueu resoldre'l.

en: Documentation Sources
ca-ES: Fonts de documentació

en: <primary>documentation</primary>
ca-ES: <primary>documentació</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.
ca-ES: Abans de poder entendre què passa realment quan hi ha un problema, heu de conèixer el rol teòric que exerceix cada programa implicat en el problema. Per fer-ho, el millor reflex és consultar la seva documentació; però com que la documentació pot ser molta i poden estar escampada arreu, hauríeu de saber tots els llocs on es pot trobar.

en: Manual Pages
ca-ES: Pàgines de manual

en: <primary>manual pages</primary>
ca-ES: <primary>pàgines de manual</primary>

en: <primary>documentation</primary><secondary>manual pages</secondary>
ca-ES: <primary>documentació</primary><secondary>pàgines de manual</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/man/</filename></secondary>
ca-ES: <primary>documentació</primary><secondary><filename>/usr/share/man/</filename></secondary>

en: <emphasis>CULTURE</emphasis> <acronym>RTFM</acronym>
ca-ES: <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.
ca-ES: Aquest acrònim significa “Llegiu el fotut manual” (de l'anglès «Read The F**king Manual»), però també es pot ampliar en una variant més amigable, “Llegiu l'excel·lent manual” (de l'anglès «Read the Fine Manual»). Aquesta frase s'utilitza de vegades en respostes (matusseres) a preguntes de principiants. És una mica abrupte i destil·la una certa molèstia a una pregunta formulada per algú que ni tan sols s'ha molestat a llegir la documentació. Alguns diuen que aquesta resposta clàssica és millor que cap resposta (ja que indica que la documentació conté la informació buscada), o que una resposta més detallada i enutjada.

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" />
ca-ES: En qualsevol cas, si algú us respon "RTFM", sovint és prudent no ofendre's. Com que aquesta resposta es pot percebre com una ofensa, és possible que vulgueu intentar evitar rebre-la. Si la informació que es necessita no està al manual, fet que pot passar, ho hauríeu de dir, preferiblement, a la pregunta inicial. També hauríeu de descriure els diferents passos que heu seguit per a trobar informació abans de plantejar una pregunta en un fòrum. Seguint les directrius d'Eric Raymond, és una bona manera d'evitar els errors més comuns i obtenir respostes útils. <ulink type="block" url="http://catb.org/~esr/faqs/smart-questions.html" />

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" />).
ca-ES: Les pàgines de manual, tot i que relativament d'estil breu, contenen molta informació essencial. Ràpidament passarem per sobre de l'ordre per a veure'ls, proporcionada pel paquet <emphasis role="pkg">man-db</emphasis>. Escriviu simplement <command>man <replaceable>pàgina-de-manual</replaceable></command> — la pàgina manual sol tenir el mateix nom que l'ordre la documentació de la qual es busca. Per exemple, per aprendre sobre les possibles opcions per a l'ordre <command>cp</command>, hauríeu d'escriure l'ordre <command>man cp</command> a l'indicador de la «shell» (vegeu la barra lateral <xref linkend="sidebar.shell" />).

en: <emphasis>BACK TO BASICS</emphasis> The shell, a command line interpreter
ca-ES: <emphasis>TORNAR A LES BASES</emphasis> La «shell», l'intèrpret de la línia d'ordres

en: <primary>command line interpreter</primary>
ca-ES: <primary>intèrpret de la línea d'ordres</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.
ca-ES: Un intèrpret de línia d'ordres, també anomenat «shell», és un programa que executa ordres que l'usuari ha introduït o bé que s'emmagatzemen en un «script». En mode interactiu, mostra un indicador (en anglès «prompt», normalment acabant en <literal>$</literal> per a un usuari normal, o per <literal>#</literal> per a un administrador) indicant que està a punt de llegir una ordre nova. <xref linkend="short-remedial-course" /> descriu els fonaments d'utilitzar una «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>.
ca-ES: El intèrpret d'ordres per defecte i més utilitzat és <command>bash</command> (Bourne Again Shell), però n'hi ha d'altres, incloent-hi <command>dash</command>, <command>csh</command>, <command>tcsh</command> i <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>).
ca-ES: Entre altres coses, la majoria d'intèrprets d'ordres ofereixen ajuda (escriviu <command>help</command>) i assistència durant l'entrada a l'indicador, com ara la finalització dels noms d'ordres o de fitxers (que podeu activar en general prement la tecla de tabulació <keycap>tab</keycap>), o recuperant ordres prèvies (gestió de l'historial; comproveu les assignacions per les tecles "pàgina amunt" i "pàgina avall" a <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:
ca-ES: Les pàgines de manual no només documenten ordres i programes accessibles des de la línia d'ordres, sinó també fitxers de configuració, crides al sistema, funcions de biblioteca, etc. De vegades els noms poden coincidir. Per exemple, l'ordre <command>read</command> de l'intèrpret de comandes té el mateix nom que la crida al sistema<function>read</function>. Per això les pàgines de manual s'organitzen en seccions numerades:

en: commands that can be executed from the command line;
ca-ES: ordres que es poden executar des de la línia d'ordres;

en: system calls (functions provided by the kernel);
ca-ES: crides al sistema (funcions proporcionades pel nucli);

en: library functions (provided by system libraries);
ca-ES: funcions de biblioteca (proporcionades per biblioteques del sistema);

en: devices (on Unix-like systems, these are special files, usually placed in the <filename>/dev/</filename> directory);
ca-ES: dispositius (en sistemes de tipus Unix aquests són fitxers especials, normalment situats al directori <filename>/dev/</filename>);

en: configuration files (formats and conventions);
ca-ES: fitxers de configuració (formats i convencions);

en: games;
ca-ES: jocs;

en: sets of macros and standards;
ca-ES: conjunts de “macros” i estàndards;

en: system administration commands;
ca-ES: ordres d'administració del sistema;

en: kernel routines.
ca-ES: rutines del nucli.

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.
ca-ES: És possible especificar la secció de la pàgina de manual que esteu cercant: per veure la documentació per a la crida al sistema <function>read</function> escriureu <command>man 2 read</command>. Quan no s'especifica explícitament cap secció, es mostrarà la primera secció que tingui una pàgina manual amb el nom sol·licitat. Per tant, <command>man shadow</command> mostrarà <citerefentry><refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum></citerefentry> perquè no hi ha pàgines de manual de <foreignphrase>shadow</foreignphrase> en les seccions 1 a 4.

en: <emphasis>TIP</emphasis> <command>whatis</command>
ca-ES: <emphasis>SUGGERIMENT</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>.
ca-ES: Si no voleu mirar la pàgina completa del manual, però només una breu descripció per confirmar que és el que esteu cercant, simplement introduïu l'ordre <command>whatis <replaceable>ordre</replaceable></command>.

en: This short description is included in the <emphasis>NAME</emphasis> section at the beginning of all manual pages.
ca-ES: Aquesta breu descripció s'inclou a la secció <emphasis>NOM</emphasis> al principi de totes les pàgines 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.
ca-ES: Per descomptat, si no coneixeu els noms de les ordres, el manual no us servirà de molt. Aquest és el propòsit de l'ordre <command>apropos</command>, que us ajuda a realitzar una cerca a les pàgines de manual, o més específicament en les seves descripcions curtes. Cada pàgina de manual comença normalment amb un resum d'una línia. <command>apropos</command> retorna una llista de pàgines de manual el resum de les quals menciona les paraules clau sol·licitades. Si les trieu bé, trobareu el nom de l'ordre que necessiteu.

en: Finding <command>cp</command> with <command>apropos</command>
ca-ES: Trobar <command>cp</command> amb <command>apropos</command>

en: <emphasis>TIP</emphasis> Browsing by following links
ca-ES: <emphasis>SUGGERIMENT</emphasis> Navegar seguint enllaços

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.
ca-ES: Moltes pàgines de manual tenen una secció “VEGEU TAMBÉ” («SEE ALSO»), normalment al final. Es refereix a altres pàgines de manual rellevants per a ordres similars, o a documentació externa. D'aquesta manera, és possible trobar la documentació pertinent fins i tot quan la primera opció no és l'òptima.

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" />
ca-ES: L'ordre <command>man</command> no és l'únic mitjà de consultar les pàgines de manual, ja que els programes <command>khelpcenter</command> i <command>konqueror</command> (de KDE) i <command>yelp</command> (sota GNOME) també ofereixen aquesta possibilitat. També hi ha una interfície web, proporcionada pel paquet <command>man2html</command>, que permet veure pàgines manuals en un navegador web. En un ordinador on aquest paquet està instal·lat, utilitzeu aquest URL després de seguir les instruccions a <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.
ca-ES: Aquesta utilitat requereix un servidor web. Per això hauríeu de triar instal·lar aquest paquet en un dels vostres servidors: tots els usuaris de la xarxa local podrien beneficiar-se d'aquest servei (incloent màquines no Linux), i això us permetrà no haver de configurar un servidor HTTP a cada estació de treball. Si el vostre servidor també és accessible des d'altres xarxes, pot ser desitjable restringir l'accés a aquest servei només als usuaris de la xarxa 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" />
ca-ES: Finalment, però no menys important, podeu veure totes les pàgines de manual disponibles a Debian (fins i tot les que no estan instal·lades a la vostra màquina) al servei <literal>manpages.debian.org</literal>. Ofereix cada pàgina de manual en múltiples versions, una per a cada versió de Debian. <ulink type="block" url="https://manpages.debian.org" />

en: <emphasis>DEBIAN POLICY</emphasis> Required man pages
ca-ES: <emphasis>NORMATIVA DEBIAN</emphasis> Pàgines de manual obligatòries

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.
ca-ES: Debian requereix que cada programa tingui una pàgina de manual. Si l'autor principal no en proporciona cap, el mantenidor del paquet Debian normalment n'escriurà una pàgina mínima que, com a mínim, dirigirà el lector a la ubicació de la documentació original.

en: <emphasis>info</emphasis> Documents
ca-ES: Documents <emphasis>info</emphasis>

en: <primary>documentation</primary><secondary>info documents</secondary>
ca-ES: <primary>documentació</primary><secondary>documents info</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/info/</filename></secondary>
ca-ES: <primary>documentació</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).
ca-ES: El projecte GNU ha escrit manuals per a la majoria dels seus programes en el format <emphasis>info</emphasis>; per això moltes pàgines manuals es refereixen a la documentació <emphasis>info</emphasis> corresponent. Aquest format ofereix alguns avantatges, però el programa per defecte per veure aquests documents (que s'anomena <command>info</command>) també és una mica més complex. Us convindria utilitzar <command>pinfo</command> en el seu lloc (el podeu trobar al paquet <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.
ca-ES: La documentació <emphasis>info</emphasis> té una estructura jeràrquica, i si invoqueu <command>pinfo</command> sense paràmetres, mostrarà una llista dels nodes disponibles al primer nivell. Normalment, els nodes porten el nom de les ordres corresponents.

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" />
ca-ES: Amb <command>pinfo</command>, la navegació entre aquests nodes és fàcil d'aconseguir amb les tecles de fletxa. Alternativament, també podeu utilitzar un navegador gràfic, que és molt més fàcil d'usar. Una vegada més, el <command>konqueror</command> i el <command>yelp</command> funcionen; el paquet <command>info2www</command> també proporciona una interfície 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.
ca-ES: Tingueu en compte que el sistema <emphasis>info</emphasis> no és adequat per a la traducció, a diferència del sistema de pàgines <command>man</command>. Els documents <emphasis>info</emphasis> estan, per tant, gairebé sempre en anglès. No obstant això, quan demaneu al programa <command>pinfo</command> que mostri una pàgina <emphasis>info</emphasis> no existent, acabarà anant a la pàgina <emphasis>man</emphasis> amb el mateix nom (si existeix) que, aquesta, sí que podria estar traduïda.

en: Specific Documentation
ca-ES: Documentació específica

en: <primary>documentation</primary><secondary>package documentation</secondary>
ca-ES: <primary>documentació</primary><secondary>documentació del paquet</secondary>

en: <primary>documentation</primary><secondary>documentation package</secondary>
ca-ES: <primary>documentació</primary><secondary>paquet de documentació</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/doc/<replaceable>package</replaceable>/</filename></secondary>
ca-ES: <primary>documentació</primary><secondary><filename>/usr/share/doc/<replaceable>paquet</replaceable>/</filename></secondary>

en: <primary>documentation</primary><secondary><emphasis role="pkg"><replaceable>package</replaceable>-doc</emphasis></secondary>
ca-ES: <primary>documentació</primary><secondary><emphasis role="pkg"><replaceable>paquet</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.
ca-ES: Cada paquet inclou la seva pròpia documentació. Fins i tot els programes menys ben documentats generalment tenen un fitxer <filename>README</filename> que conté alguna informació interessant i/o important. Aquesta documentació està instal·lada al directori <filename>/usr/share/doc/<replaceable>paquet</replaceable>/</filename> (on <replaceable>paquet</replaceable> representa el nom del paquet). Si la documentació és particularment gran, pot no ser inclosa en el paquet principal del programa, sinó que pot estar separada en un paquet dedicat que normalment s'anomena <literal><replaceable>paquet</replaceable>-doc</literal>. El paquet principal generalment recomana el paquet de documentació perquè el pugueu trobar fàcilment.

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" />).
ca-ES: El directori <filename>/usr/share/doc/<replaceable>paquet</replaceable>/</filename> també conté alguns fitxers proporcionats per Debian que completen la documentació especificant les particularitats o millores del paquet en comparació amb una instal·lació tradicional del programari. El fitxer <filename>README.Debian</filename> també indica totes les adaptacions fetes per a complir amb la Normativa de Debian. El fitxer <filename>changelog.Debian.gz</filename> permet a l'usuari seguir les modificacions fetes al paquet amb el temps: és molt útil intentar entendre què ha canviat entre dues versions instal·lades que no tenen el mateix comportament. Finalment, a vegades hi ha un fitxer <filename>NEWS.Debian.gz</filename> que documenta els principals canvis del programa que poden afectar directament l'administrador (vegeu <xref linkend="sect.dist-upgrade-problems" />).

en: Websites
ca-ES: Llocs web

en: <primary>documentation</primary><secondary>websites</secondary>
ca-ES: <primary>documentació</primary><secondary>llocs web</secondary>

en: <emphasis>TIP</emphasis> From error to solution
ca-ES: <emphasis>SUGGERIMENT</emphasis> De l'error a la solució

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.
ca-ES: Si el programari retorna un missatge d'error molt específic, introduïu-lo al motor de cerca (entre cometes dobles, <literal>"</literal>, per tal de cercar no paraules clau individuals, sinó per a la frase completa). En la majoria dels casos, els primers enllaços retornats contindran la resposta que necessiteu.

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.).
ca-ES: En altres casos, obtindreu errors molt generals, com ara “permís denegat”. En aquest cas, és millor comprovar els permisos dels elements implicats (fitxers, ID d'usuari, grups, 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" />
ca-ES: Si no sabeu l'adreça del lloc web del programa, hi ha diversos mitjans per obtenir-la. Primer, comproveu si hi ha un camp <literal>Homepage</literal> a la metainformació del paquet (<command>apt show <replaceable>paquet</replaceable></command>). Alternativament, la descripció del paquet pot contenir un enllaç al lloc web oficial del programa. Si no s'indica cap URL, consulteu <filename>/usr/share/doc/<replaceable>paquet</replaceable>/copyright</filename>. El mantenidor de Debian generalment indica en aquest fitxer on va obtenir el codi font del programa, i és probable que sigui el lloc web que heu de trobar. Si en aquesta etapa la vostra cerca encara no és fructífera, consulteu un directori de programari lliure, com el Directori de Programari Lliure de FSF, o cerqueu directament amb un motor de cerca, com ara Google, DuckDuckGo, Yahoo, etc. <ulink type="block" url="https://directory.fsf.org/wiki/Main_Page" />

en: <primary>Free Software Directory</primary>
ca-ES: <primary>Directori de programari lliure</primary>

en: <primary>documentation</primary><secondary><literal>wiki.debian.org</literal></secondary>
ca-ES: <primary>documentación</primary><secondary><literal>wiki.debian.org</literal></secondary>

en: <primary>documentation</primary><secondary>HOWTO</secondary>
ca-ES: <primary>documentació</primary><secondary>HOWTO</secondary>

en: <primary>documentation</primary><secondary>tutorials</secondary>
ca-ES: <primary>documentació</primary><secondary>tutorials</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.
ca-ES: Un <emphasis>HOWTO</emphasis> és un document que descriu, en termes concrets i pas a pas, com (de l'anglès «how to...”) arribar a un objectiu predefinit. Els objectius coberts són relativament variats, però sovint tenen naturalesa tècnica: per exemple, la configuració de l'emmascarament IP, la configuració de RAID via programari, la instal·lació d'un servidor Samba, etc. Aquests documents sovint intenten cobrir tots els possibles problemes que poden ocórrer durant l'aplicació d'una determinada tecnologia.

en: <primary>Linux Documentation Project</primary>
ca-ES: <primary>Projecte de documentació de Linux</primary>

en: Debian also provides tutorials for its users: <ulink type="block" url="https://www.debian.org/doc/" />
ca-ES: Debian també proporciona tutorials per als seus usuaris: <ulink type="block" url="https://www.debian.org/doc/" />

en: Common Procedures
ca-ES: Procediments comuns

en: <primary>standard procedure</primary>
ca-ES: <primary>procediment estàndard</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.
ca-ES: El propòsit d'aquesta secció és presentar alguns consells generals sobre certes operacions que un administrador haurà de realitzar amb freqüència. Per descomptat, aquests procediments no abastaran tots els casos possibles de manera exhaustiva, però poden servir de punt de partida per als casos més difícils.

en: <emphasis>DISCOVERY</emphasis> Documentation in other languages
ca-ES: <emphasis>DESCOBRIMENT</emphasis>Documentació en altres idiomes

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).
ca-ES: Sovint, la documentació traduïda a una llengua no anglesa està disponible en un paquet separat amb el nom del paquet corresponent, seguit per <literal>-<replaceable>lang</replaceable></literal> (on <replaceable>lang</replaceable> és el codi ISO de dues lletres per a la llengua).

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.
ca-ES: Per exemple, el paquet <emphasis role="pkg">debian-reference-fr</emphasis> és la versió francesa de les guies de referència per Debian (inicialment escrites en anglès per Osamau Aoki), i el paquet <emphasis role="pkg">manpages-de</emphasis> conté la versió alemanya de les pàgines de manual sobre l'ús de GNU/Linux.

en: <primary>documentation</primary><secondary><emphasis role="pkg">manpages-<replaceable>lang</replaceable></emphasis></secondary>
ca-ES: <primary>documentació</primary><secondary><emphasis role="pkg">manpages-<replaceable>lang</replaceable></emphasis></secondary>

en: Configuring a Program
ca-ES: Configurar un programa

en: <primary>configuration</primary><secondary>program configuration</secondary>
ca-ES: <primary>configuración</primary><secondary>configuració d'un programa</secondary>

en: <primary>program</primary><secondary>configuration</secondary>
ca-ES: <primary>programa</primary><secondary>configuració</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.
ca-ES: Tot seguit, hauríeu de mirar la documentació oficial del programari — acudiu a <xref linkend="sect.documentation-sources" /> per identificar les diferents fonts de documentació existents. L'ordre <command>dpkg -L <replaceable>paquet</replaceable></command> dóna una llista de fitxers inclosos en el paquet; per tant, podeu identificar ràpidament la documentació disponible (així com els fitxers de configuració, situats a <filename>/etc/</filename>). L'ordre <command>dpkg -s <replaceable>paquet</replaceable></command> mostra les metadades del paquet i mostra els possibles paquets recomanats o suggerits; allà podeu trobar documentació o una utilitat que facilitarà la configuració del programari.

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.
ca-ES: Finalment, els fitxers de configuració estan sovint “autodocumentats” amb molts comentaris explicatius que detallen els diversos valors possibles per a cada configuració. Tant és així que a vegades n'hi ha prou amb triar una línia per activar d'entre les disponibles. En alguns casos es proporcionen exemples de fitxers de configuració al directori <filename>/usr/share/doc/<replaceable>paquet</replaceable>/examples/</filename>. Poden servir com a base per al vostre propi fitxer de configuració.

en: <emphasis>DEBIAN POLICY</emphasis> Location of examples
ca-ES: <emphasis>Normativa Debian</emphasis> Ubicació dels exemples

en: <primary>examples, location</primary>
ca-ES: <primary>exemples, ubicació</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.
ca-ES: Tots els exemples s'han d'instal·lar al directori <filename>/usr/share/doc/<replaceable>paquet</replaceable>/examples/</filename>. Això pot ser un fitxer de configuració, codi font de programa (un exemple sobre l'ús d'una biblioteca), o un «script» de conversió de dades que l'administrador pot utilitzar en certs casos (com ara per inicialitzar una base de dades). Si l'exemple és específic a una arquitectura en particular, s'hauria d'instal·lar a <filename>/usr/lib/<replaceable>paquet</replaceable>/examples/</filename> i hauria d'haver-hi un enllaç que assenyali a aquest fitxer al directori <filename>/usr/share/doc/<replaceable>paquet</replaceable>/examples/</filename>.

en: Monitoring What Daemons Are Doing
ca-ES: Monitoritzar què fan els dimonis

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.
ca-ES: Comprendre el que fa un dimoni és una mica més complicat, ja que no interactua directament amb l'administrador. Per comprovar que un dimoni està funcionant realment cal verificar-ho. Per exemple, per comprovar el dimoni Apache (servidor web), proveu-ho amb una sol·licitud HTTP.

en: <emphasis>BACK TO BASICS</emphasis> Daemon
ca-ES: <emphasis>TORNAR A LES BASES</emphasis> Dimoni

en: <primary>daemon</primary>
ca-ES: <primary>dimoni</primary>

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.).
ca-ES: Un dimoni és un programa que no és explícitament invocat per l'usuari i que es manté en segon pla, esperant que es compleixi una determinada condició per a realitzar una tasca. Molts programes de servidor són dimonis, un terme que explica que la lletra “d” és freqüentment present al final del seu nom (<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.
ca-ES: Per permetre aquestes proves, cada dimoni generalment registra tot el que fa, així com qualsevol error que troba, en el que s'anomenen "fitxers de registre" o "registres de sistema" («logs» en anglès). Els registres s'emmagatzemen a <filename>/var/log/</filename> o un dels seus subdirectoris. Per conèixer el nom precís d'un fitxer de registre per a cada dimoni, consulteu-ne la documentació. Nota: una única prova no sempre és suficient si no cobreix tots els casos d'ús possibles; alguns problemes només ocorren en circumstàncies particulars.

en: <emphasis>TOOL</emphasis> The <command>rsyslogd</command> daemon
ca-ES: <emphasis>EINA</emphasis> El dimoni <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).
ca-ES: El <command>rsyslogd</command> és especial: recull registres (missatges interns del sistema) que li són enviats per altres programes. Cada entrada de registre s'associa amb un subsistema (correu electrònic, nucli, autenticació, etc.) i una prioritat; <command>rsyslog</command> processa aquests dos ítems d'informació per decidir què fer. El missatge de registre es pot enregistrar en diversos fitxers de registre, i/o enviar-se a una consola d'administració. Els detalls es defineixen al fitxer de configuració <filename>/etc/rsyslog.conf</filename> (documentat a la pàgina manual del mateix nom que es proporciona al paquet <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).
ca-ES: Certes funcions C, que estan especialitzades en l'enviament de registres, simplifiquen l'ús del dimoni <command>rsyslogd</command>. Tanmateix, alguns dimonis gestionen els seus propis fitxers de registre (aquest és el cas, per exemple, de <command>samba</command>, que implementa els recursos compartits de Windows en 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).
ca-ES: Tingueu en compte que quan <command>systemd</command> està en ús, els registres són recollits per <command>systemd</command> abans de ser reenviats a <command>rsyslogd</command>. Per tant, també estan disponibles a través de l'historial de <command>systemd</command> i es poden consultar amb <command>journalctl</command> (vegeu <xref linkend="sect.systemd" /> per als detalls).

en: Asking for Help on a Mailing List
ca-ES: Demanar ajuda en una llista de correu

en: <primary>mailing lists</primary>
ca-ES: <primary>llistes de correu</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" />
ca-ES: Si les diverses cerques no us han ajudat a arribar a l'arrel d'un problema, és possible obtenir ajuda d'altres persones, potser més experimentades. Aquest és exactament el propòsit de la llista de correu <email>debian-user@lists.debian.org</email> i de les específiques per a un idioma <email>debian-user-<replaceable>idioma</replaceable>@lists.debian.org</email>. Igual que en qualsevol comunitat, hi ha normes que han de respectar-se. Abans de fer cap pregunta, hauríeu de comprovar que el problema no estigui ja tractat en discussions recents a la llista o per cap documentació 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>
ca-ES: <primary>llistes de correu</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>
ca-ES: <primary>llistes de correu</primary><secondary><email>debian-user-<replaceable>idioma</replaceable>@lists.debian.org</email></secondary>

en: <emphasis>BACK TO BASICS</emphasis> Netiquette applies
ca-ES: <emphasis>TORNAR A LES BASES</emphasis> S'aplica la «netiquette»

en: <primary>Code of Conduct</primary>
ca-ES: <primary>Codi de Conducta</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" />
ca-ES: En general, per a tota la correspondència a les llistes de correu electrònic, s'han de seguir les “normes de la xarxa” (en anglès «netiquette»). Aquest terme es refereix a un conjunt de normes de sentit comú, des de la cortesia comuna fins a errors que haurien d'evitar-se. <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" />
ca-ES: A més, per a qualsevol canal de comunicació gestionat pel projecte Debian, esteu subjecte al Codi de Conducta de 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/" />
ca-ES: Un cop es compleixin aquestes dues condicions, podeu pensar a descriure el vostre problema a la llista de correu. Incloeu-hi tota la informació rellevant possible: proves diverses realitzades, documentació consultada, com s'ha intentat diagnosticar el problema, els paquets en qüestió o els que poden estar implicats, etc. Comproveu el sistema de seguiment d'errors de Debian (BTS, descrit a la barra lateral <xref linkend="sect.bts" />) per a problemes similars, i esmenteu els resultats d'aquesta cerca, proporcionant enllaços als errors trobats. El BTS comença a: <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.
ca-ES: Com més cortesos i precisos sigueu, majors són les possibilitats d'obtenir una resposta o, almenys, alguns elements de resposta. Si rebeu informació rellevant per correu electrònic privat, penseu a resumir aquesta informació públicament perquè uns altres puguin beneficiar-se'n. Això també permet que els arxius de la llista, cercats a través de diversos motors de cerca, mostrin la resolució per a altres que puguin tenir la mateixa pregunta.

en: Reporting a Bug When a Problem Is Too Difficult
ca-ES: Informar d'un error quan un problema és massa difícil

en: <primary>report a bug</primary>
ca-ES: <primary>informar d'un error</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.
ca-ES: Si tots els esforços per resoldre un problema fracassen, és possible que la resolució no sigui la vostra responsabilitat, i que el problema es degui a un error del programa. En aquest cas, el procediment adequat és informar de l'error a Debian o directament als desenvolupadors originals. Per a això, aïlleu el problema en la mesura que sigui possible i crea una situació de prova mínima en la qual es pot reproduir. Si sabeu quin programa és la causa aparent del problema, podeu trobar el seu paquet corresponent utilitzant l'ordre <command>dpkg -S <replaceable>fitxer_en_qüestió</replaceable></command>. Comproveu el sistema de seguiment d'errors (<literal>https://bugs.debian.org/<replaceable>paquet</replaceable></literal>) per assegurar-vos que no s'hagi informat ja de l'error. A continuació, podeu enviar el vostre propi informe d'error, utilitzant l'ordre <command>reportbug</command>, incloent-hi tota la informació possible, especialment una descripció completa d'aquests casos de prova mínims que permetran a qualsevol poder reproduir l'error.

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!
ca-ES: Els elements d'aquest capítol són un mitjà per a resoldre de manera efectiva qüestions que poden sorgir en els següents capítols. Utilitzeu-los tan sovint com calgui!
