0 - en to fr-FR translation catalogue (86 entries)

en: Solving problems
fr-FR: Résolution de problèmes

en: Log files
fr-FR: Fichiers logs

en: Manual
fr-FR: Manuel

en: Solving Problems and Finding Relevant Information
fr-FR: Résolution de problèmes et sources d'informations

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.
fr-FR: Pour un administrateur, le plus important est d'être capable de faire face à toute situation, connue ou inconnue. Nous proposons dans ce chapitre un ensemble de méthodes qui vous permettront — nous l'espérons — d'isoler la cause des problèmes que vous ne manquerez pas de rencontrer, pour mieux les résoudre ensuite.

en: Documentation Sources
fr-FR: Les sources de documentation

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.
fr-FR: Avant de pouvoir comprendre ce qui se passe réellement en cas de problème, il faut connaître le rôle théorique de chaque programme impliqué. Pour cela, rien de tel que de consulter leurs documentations ; mais celles-ci étant multiples et dispersées, il convient de les connaître toutes.

en: Manual Pages
fr-FR: Les pages de manuel

en: <primary>manual pages</primary>
fr-FR: <primary>manuel, pages de</primary>

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.
fr-FR: Ce sigle est l'abréviation de <foreignphrase>Read The F...ing Manual</foreignphrase> (« Lis le f**tu manuel »), mais on rencontre parfois une variante moins grossière avec <foreignphrase>Read The Fine Manual</foreignphrase> (« Lis le fameux manuel »). Des traductions alternatives comme « Relis Trois Fois le Manuel » existent aussi. Cette interjection sert parfois de réponse (laconique) à des questions en provenance de débutants ; elle est assez abrupte et laisse transparaître une certaine irritation par rapport à une question posée par quelqu'un qui n'a pas pris la peine de lire la documentation. D'autres personnes affirment que cette réponse classique vaut mieux qu'aucune réponse (puisqu'elle indique que la documentation contient l'information recherchée), voire qu'une réponse courroucée plus développée.

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" />
fr-FR: Dans tous les cas, lorsqu'on se voit répondre « RTFM », il est souvent judicieux de ne pas s'offusquer. Et cette réponse pouvant être perçue comme vexante, on s'efforcera de ne pas la susciter. Si l'information requise n'est pas dans le manuel, ce qui peut arriver, il conviendra au contraire de le préciser (de préférence dans la question initiale) ; on décrira également le cheminement suivi lors de la recherche d'informations effectuée personnellement avant de poser la question sur un forum. On pourra pour cela suivre quelques recommandations de bon sens, formalisées par Eric Raymond. <ulink type="block" url="http://www.gnurou.org/writing/smartquestionsfr" />

en: <emphasis>BACK TO BASICS</emphasis> The shell, a command line interpreter
fr-FR: <emphasis>B.A.-BA</emphasis> Interpréteur de commandes

en: <primary>command line interpreter</primary>
fr-FR: <primary>interpréteur de commandes</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.
fr-FR: Un interpréteur de commandes — souvent désigné par shell en anglais — est un programme qui exécute les commandes saisies par l'utilisateur ou stockées dans un script. En mode interactif, il affiche une invite (finissant généralement par <literal>$</literal> pour un utilisateur normal, ou par <literal>#</literal> pour l'administrateur) indiquant qu'il est prêt à lire une nouvelle commande. L'<xref linkend="short-remedial-course" /> décrit les bases de l'utilisation de l'interpréteur de commandes.

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>.
fr-FR: L'interpréteur de commandes le plus usité est probablement <command>bash</command> <foreignphrase>(Bourne Again SHell)</foreignphrase> mais d'autres existent : <command>dash</command>, <command>csh</command>, <command>tcsh</command>, <command>zsh</command>, etc.

en: commands that can be executed from the command line;
fr-FR: commandes exécutables depuis l'interpréteur ;

en: system calls (functions provided by the kernel);
fr-FR: appels système (fonctions fournies par le noyau) ;

en: library functions (provided by system libraries);
fr-FR: fonctions de bibliothèques (fournies par les bibliothèques système) ;

en: devices (on Unix-like systems, these are special files, usually placed in the <filename>/dev/</filename> directory);
fr-FR: périphériques (sous les systèmes dérivés d'Unix, ce sont des fichiers spéciaux, habituellement placés sous <filename>/dev/</filename>) ;

en: configuration files (formats and conventions);
fr-FR: fichiers de configuration (formats et conventions) ;

en: games;
fr-FR: jeux ;

en: sets of macros and standards;
fr-FR: ensemble de macros et de standards ;

en: system administration commands;
fr-FR: commandes d'administration système ;

en: kernel routines.
fr-FR: routines du noyau.

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.
fr-FR: Il est possible de préciser la section de la page de manuel recherchée : pour consulter la documentation de l'appel système <function>read</function>, on tapera donc <command>man 2 read</command>. En l'absence d'une section explicite, c'est la première section abritant une page du nom demandé qui sera utilisée. Ainsi, <command>man shadow</command> renvoie <citerefentry><refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum></citerefentry> parce qu'il n'y a pas de pages de manuel <foreignphrase>shadow</foreignphrase> dans les sections 1 à 4.

en: <emphasis>TIP</emphasis> <command>whatis</command>
fr-FR: <emphasis>ASTUCE</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>.
fr-FR: Si vous ne voulez pas consulter la page de manuel complète mais obtenir uniquement une description courte de la commande pour confirmer qu'il s'agit bien de celle que vous cherchez, tapez simplement <command>whatis <replaceable>commande</replaceable></command>.

en: This short description is included in the <emphasis>NAME</emphasis> section at the beginning of all manual pages.
fr-FR: Cette description courte — présente dans toutes les pages de manuel — se retrouve dans la section <emphasis>NAME</emphasis> (ou <emphasis>NOM</emphasis>) qui les débute toutes.

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.
fr-FR: Évidemment, si vous ne connaissez pas les noms des commandes, le manuel ne vous sera pas d'un grand secours. C'est l'objet de la commande <command>apropos</command>, qui permet de mener une recherche dans les pages de manuel, ou plus précisément dans leurs descriptions courtes : chaque page de manuel commence en effet par un résumé en une ligne des fonctions documentées plus en détail par la suite. <command>apropos</command> renvoie donc une liste des pages de manuel dont la description mentionne le ou les mots-clés demandés. En choisissant bien ceux-ci, on trouvera le nom de la commande recherchée.

en: Finding <command>cp</command> with <command>apropos</command>
fr-FR: Retrouver <command>cp</command> avec <command>apropos</command>

en: <emphasis>TIP</emphasis> Browsing by following links
fr-FR: <emphasis>ASTUCE</emphasis> Naviguer de proche en proche

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.
fr-FR: Beaucoup de pages de manuel disposent d'un paragraphe <foreignphrase>SEE ALSO</foreignphrase> ou VOIR AUSSI, généralement à la fin. Il renvoie vers d'autres pages de manuel portant sur des notions ou commandes proches de celle en cours d'examen, ou vers des documentations externes. Il est ainsi possible de retrouver la documentation pertinente même quand le premier choix n'est pas optimal.

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.
fr-FR: Cet utilitaire a donc besoin d'un serveur web. C'est pourquoi vous choisirez d'installer ce paquet sur l'un de vos serveurs : tous les utilisateurs du réseau local bénéficieront du service (y compris les postes non Linux) et vous éviterez de devoir mettre en place un serveur HTTP sur chaque poste. Par ailleurs, si votre serveur est accessible depuis l'extérieur, il peut être souhaitable de restreindre l'accès à ce service aux seuls utilisateurs du réseau local.

en: <emphasis>DEBIAN POLICY</emphasis> Required man pages
fr-FR: <emphasis>CHARTE DEBIAN</emphasis> Pages de manuel obligatoires

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.
fr-FR: Debian impose à chaque programme d'être accompagné d'une page de manuel. Si l'auteur amont ne la fournit pas, le développeur Debian rédige en général une page minimaliste qui renverra au moins le lecteur à l'emplacement de la documentation originale.

en: <emphasis>info</emphasis> Documents
fr-FR: Documentation au format <emphasis>info</emphasis>

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).
fr-FR: Le projet GNU a rédigé les manuels de la plupart de ses programmes au format <emphasis>info</emphasis> ; c'est pourquoi de nombreuses pages de manuel renvoient vers la documentation <emphasis>info</emphasis> correspondante. Ce format offre quelques avantages mais le programme qui permet de consulter ces documentations est également un peu plus complexe. Il est recommandé d'utiliser <command>pinfo</command> à la place (dans le 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.
fr-FR: La documentation <emphasis>info</emphasis> a une structure hiérarchique et <command>pinfo</command> invoqué sans paramètres affichera la liste des nœuds disponibles au premier niveau. Habituellement, un nœud porte le nom de la commande correspondante.

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" />
fr-FR: Dans <command>pinfo</command>, la navigation entre les nœuds se fait simplement avec les touches flèches. Alternativement, vous pouvez aussi employer un navigateur graphique, beaucoup plus convivial. À nouveau, <command>konqueror</command> et <command>yelp</command> conviennent ; le paquet <command>info2www</command> fournit également une 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.
fr-FR: On notera que le système <emphasis>info</emphasis> ne permet pas de traduction, contrairement au système de pages <command>man</command>. Ses pages sont donc presque systématiquement en anglais. Cependant, lorsqu'on demande au programme <command>pinfo</command> d'afficher une page <emphasis>info</emphasis> inexistante, il se rabattra sur la page <emphasis>man</emphasis> du même nom, si celle-ci existe ; cette dernière pourra donc éventuellement exister en français.

en: Specific Documentation
fr-FR: La documentation spécifique

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.
fr-FR: Chaque paquet intègre sa documentation spécifique : même les logiciels les moins bien documentés disposent en général au moins d'un fichier <filename>README</filename> (« lisez-moi ») contenant quelques informations intéressantes et/ou importantes. Cette documentation est installée dans le répertoire <filename>/usr/share/doc/<replaceable>paquet</replaceable>/</filename> (où <replaceable>paquet</replaceable> représente le nom du paquet). Si elle est très volumineuse, elle peut ne pas être intégrée au paquet du programme mais constituer son propre paquet, alors intitulé <literal><replaceable>paquet</replaceable>-doc</literal>. Le paquet du programme recommande en général le paquet de documentation pour le mettre en exergue.

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" />).
fr-FR: Dans le répertoire <filename>/usr/share/doc/<replaceable>paquet</replaceable>/</filename> se trouvent également quelques fichiers fournis par Debian qui complètent la documentation du point de vue des particularités ou améliorations du paquet par rapport à une installation traditionnelle du logiciel. Le fichier <filename>README.Debian</filename> signale ainsi toutes les adaptations effectuées pour être en conformité avec la charte Debian. Le fichier <filename>changelog.Debian.gz</filename> permet quant à lui de suivre les modifications apportées au paquet au fil du temps : il est très utile pour essayer de comprendre ce qui a changé entre deux versions installées et qui n'ont apparemment pas le même comportement. Enfin, on trouve parfois un fichier <filename>NEWS.Debian.gz</filename> documentant les changements majeurs du programme qui peuvent concerner directement l'administrateur (voir <xref linkend="sect.dist-upgrade-problems" />).

en: Websites
fr-FR: Les sites web

en: <emphasis>TIP</emphasis> From error to solution
fr-FR: <emphasis>ASTUCE</emphasis> De l'erreur à la solution

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.
fr-FR: Si le logiciel renvoie un message d'erreur très spécifique, saisissez-le dans un moteur de recherche (entre apostrophes doubles « <literal>"</literal> » pour ne pas rechercher les mots individuellement, mais l'expression complète) : dans la majorité des cas, les premiers liens renvoyés contiendront la réponse que vous cherchez.

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.).
fr-FR: Dans d'autres cas, on aura simplement une erreur très générique comme « Permission non accordée » ; il conviendra alors de vérifier les permissions des éléments en jeu (fichiers, identité des utilisateurs, groupes, 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" />
fr-FR: Si vous ne connaissez pas l'adresse du site web du logiciel, il y a différents moyens de l'obtenir. Vérifiez en premier lieu si un champ <literal>Homepage</literal> n'est pas présent dans les méta-informations du paquet (<command>apt show <replaceable>paquet</replaceable></command>). Alternativement, la description du paquet peut contenir un pointeur sur le site web officiel du logiciel. Si aucune URL n'y est indiquée, il convient alors d'examiner <filename>/usr/share/doc/<replaceable>paquet</replaceable>/copyright</filename>. Le mainteneur Debian y mentionne en effet l'endroit où il a récupéré le code source du programme et il est probable qu'il s'agisse justement du site web en question. Si à ce stade votre recherche est toujours infructueuse, il faut consulter un annuaire de logiciels libres comme celui de la FSF ou Framasoft, ou encore directement effectuer une recherche sur un moteur comme Google ou Yahoo. <ulink type="block" url="https://directory.fsf.org/wiki/Main_Page" /> <ulink type="block" url="http://framasoft.org/" />

en: <primary>Free Software Directory</primary>
fr-FR: <primary>annuaire de logiciels libres</primary>

en: Tutorials (<emphasis>HOWTO</emphasis>)
fr-FR: Les tutoriels (<foreignphrase>HOWTO</foreignphrase>)

en: <primary><emphasis>HOWTO</emphasis></primary>
fr-FR: <primary><foreignphrase>HOWTO</foreignphrase></primary>

en: <primary>documentation</primary><secondary>tutorials</secondary>
fr-FR: <primary>documentation</primary><secondary>tutoriels</secondary>

en: <primary>Linux Documentation Project</primary>
fr-FR: <primary><foreignphrase>Linux Documentation Project</foreignphrase></primary>

en: Common Procedures
fr-FR: Procédures types

en: <primary>standard procedure</primary>
fr-FR: <primary>procédure type</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.
fr-FR: Cette section vise à présenter quelques conseils génériques portant sur certaines opérations qu'un administrateur est souvent amené à effectuer. Ces procédures ne couvriront évidemment pas tous les cas de figure de manière exhaustive, mais pourront servir de points de départ pour les cas les plus ardus.

en: <emphasis>DISCOVERY</emphasis> Documentation in other languages
fr-FR: <emphasis>DÉCOUVERTE</emphasis> Documentation dans d'autres langues

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).
fr-FR: Il arrive fréquemment qu'une documentation traduite en français soit disponible dans un paquet séparé portant le nom du paquet correspondant suivi de <literal>-fr</literal> (code ISO officiel de la langue française).

en: Configuring a Program
fr-FR: Configuration d'un logiciel

en: <primary>configuration</primary><secondary>program configuration</secondary>
fr-FR: <primary>configuration</primary><secondary>d'un logiciel</secondary>

en: <primary>program</primary><secondary>configuration</secondary>
fr-FR: <primary>logiciel</primary><secondary>configuration</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.
fr-FR: Ensuite, il faut consulter la documentation officielle du logiciel — référez-vous à la <xref linkend="sect.documentation-sources" /> pour identifier les différentes sources de documentation. La commande <command>dpkg -L <replaceable>paquet</replaceable></command> donne la liste des fichiers inclus dans le paquet ; on pourra ainsi repérer rapidement les documentations disponibles (ainsi que les fichiers de configuration, situés dans <filename>/etc/</filename>). <command>dpkg -s <replaceable>paquet</replaceable></command> produit les métadonnées du paquet et donne les éventuels paquets recommandés ou suggérés : on pourra y trouver de la documentation ou un utilitaire facilitant la configuration du logiciel.

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.
fr-FR: Enfin, les fichiers de configuration sont souvent autodocumentés par de nombreux commentaires explicatifs détaillant les différentes valeurs possibles de chaque paramètre — à tel point qu'il suffit parfois de choisir la ligne à activer parmi celles proposées. Dans certains cas, des exemples de fichiers de configuration sont fournis dans le répertoire <filename>/usr/share/doc/<replaceable>paquet</replaceable>/examples/</filename>. Ils pourront alors servir de base à votre propre fichier de configuration.

en: <emphasis>DEBIAN POLICY</emphasis> Location of examples
fr-FR: <emphasis>CHARTE DEBIAN</emphasis> Emplacement des exemples

en: <primary>examples, location</primary>
fr-FR: <primary>exemples, emplacement</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.
fr-FR: Tout exemple doit être installé dans le répertoire <filename>/usr/share/doc/<replaceable>paquet</replaceable>/examples/</filename>. Il peut s'agir d'un fichier de configuration, d'un code source de programme (exemple d'emploi d'une bibliothèque), ou d'un script de conversion de données que l'administrateur pourrait employer dans certains cas (comme pour initialiser une base de données). Si l'exemple est spécifique à une architecture, il convient de l'installer dans <filename>/usr/lib/<replaceable>paquet</replaceable>/examples/</filename> et de créer un lien pointant sur lui dans le répertoire <filename>/usr/share/doc/<replaceable>paquet</replaceable>/examples/</filename>.

en: Monitoring What Daemons Are Doing
fr-FR: Surveiller l'activité des démons

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.
fr-FR: Un démon complique un peu la compréhension des situations, puisqu'il n'interagit pas directement avec l'administrateur. Pour vérifier son fonctionnement, il est donc nécessaire de le tester, par exemple avec une requête HTTP pour le démon Apache (un serveur web).

en: <emphasis>BACK TO BASICS</emphasis> Daemon
fr-FR: <emphasis>B.A.-BA</emphasis> Démon

en: <primary>daemon</primary>
fr-FR: <primary>démon</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.).
fr-FR: Un démon <foreignphrase>(daemon)</foreignphrase> est un programme non invoqué explicitement par l'utilisateur et qui reste en arrière-plan, attendant la réalisation d'une condition avant d'effectuer une tâche. Beaucoup de logiciels serveurs sont des démons — terme qui explique la lettre « d » souvent présente à la fin de leur 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.
fr-FR: Pour permettre ces vérifications, chaque démon garde généralement des traces de tout ce qu'il a fait ainsi que des erreurs qu'il a rencontrées — on les appelle logs (journaux de bord du système). Les logs sont stockés dans <filename>/var/log/</filename> ou l'un de ses sous-répertoires. Pour connaître le nom précis du fichier de log de chaque démon, on se référera à la documentation. Attention, un seul test ne suffit pas toujours s'il ne couvre pas la totalité des cas d'utilisation possibles : certains problèmes ne se manifestent que dans certaines circonstances particulières.

en: <emphasis>TOOL</emphasis> The <command>rsyslogd</command> daemon
fr-FR: <emphasis>OUTIL</emphasis> Le démon <command>rsyslogd</command>

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).
fr-FR: Certaines fonctions C, spécialisées dans l'envoi de traces, facilitent l'emploi du démon <command>rsyslogd</command>. Certains démons gèrent toutefois eux-mêmes leurs fichiers de logs (c'est par exemple le cas de <command>samba</command>, le serveur implémentant les partages Windows sur 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).
fr-FR: Notons que lorsque <command>systemd</command> est utilisé, les logs sont en réalité collectés par <command>systemd</command> avant d'être transmis à <command>rsyslogd</command>. Ils sont donc disponibles dans le journal de <command>systemd</command>, et peuvent être consultés avec <command>journalctl</command> (voir <xref linkend="sect.systemd" /> pour plus de détails).

en: Asking for Help on a Mailing List
fr-FR: Demander de l'aide sur une liste de diffusion

en: <primary>mailing lists</primary>
fr-FR: <primary>diffusion, listes de</primary>

en: <emphasis>BACK TO BASICS</emphasis> Netiquette applies
fr-FR: <emphasis>B.A.-BA</emphasis> La Netiquette s'applique

en: <primary>Code of Conduct</primary>
fr-FR: <primary>Code de conduite</primary>

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" />
fr-FR: De plus, tous les canaux de communication gérés par le projet Debian sont régis par le code de conduite 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/" />
fr-FR: Ces deux conditions remplies, vous pouvez envisager de décrire votre problème sur la liste de diffusion. Incluez le maximum d'informations pertinentes : les différents essais effectués, les documentations consultées, comment vous avez diagnostiqué le problème, les paquets concernés ou susceptibles d'être en cause. Consultez le système de suivi de bogues de Debian (BTS, ou <foreignphrase>Bug Tracking System</foreignphrase>, décrit dans l'encadré <xref linkend="sect.bts" />) à la recherche d'un problème similaire et mentionnez le résultat de cette recherche en fournissant les liens vers les bogues trouvés. Rappelons que toute exploration du BTS débute à la page suivante : <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.
fr-FR: Plus vous aurez été courtois et précis, plus grandes seront vos chances d'obtenir une réponse — ou du moins des éléments de réponse. Si vous recevez des informations intéressantes par courrier privé, pensez à faire une synthèse publique des réponses reçues afin que tout le monde puisse en profiter et que les archives de la liste, dûment explorées par divers moteurs de recherche, donnent directement la réponse à ceux qui se poseront la même question que vous.

en: Reporting a Bug When a Problem Is Too Difficult
fr-FR: Signaler un bogue en cas de problème incompréhensible

en: <primary>report a bug</primary>
fr-FR: <primary>signaler un bogue</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.
fr-FR: Si tous vos efforts pour résoudre un problème restent vains, il est possible que celui-ci ne relève pas de votre responsabilité et qu'il s'agisse en fait d'un bogue dans le programme récalcitrant. Dans ce cas, la procédure à adopter est de le signaler à Debian ou directement aux auteurs du logiciel. Pour cela, il convient d'isoler le mieux possible le problème et de créer une situation de test minimale qui permette de le reproduire. Si vous savez quel programme est la cause apparente du problème, il est possible de retrouver le paquet concerné à l'aide de la commande <command>dpkg -S <replaceable>fichier_en_cause</replaceable></command>. La consultation du système de suivi de bogues (<literal>https://bugs.debian.org/<replaceable>paquet</replaceable></literal>) permettra de vérifier que ce bogue n'a pas encore été répertorié. On pourra alors envoyer son propre rapport de bogue à l'aide de la commande <command>reportbug</command> — en incluant le maximum d'informations, en particulier la description complète du cas minimal de test qui permet de reproduire le bogue.

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!
fr-FR: Les éléments du présent chapitre constituent un moyen de résoudre efficacement les embarras que les chapitres suivants pourraient susciter. Faites-y donc appel aussi souvent que nécessaire !
