0 - en to it-IT translation catalogue (113 entries)

en: Documentation
it-IT: Documentazione

en: Solving problems
it-IT: Risoluzione dei problemi

en: Log files
it-IT: File di registro

en: Manual
it-IT: Manuale

en: Solving Problems and Finding Relevant Information
it-IT: Risoluzione dei problemi e reperimento delle principali informazioni

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.
it-IT: La qualità più importante di un amministratore è saper far fronte a qualsiasi situazione, nota o ignota. Questo capitolo suggerisce alcuni metodi che si spera permetteranno di isolare la causa di qualunque problema si possa incontrare, così da poterlo risolvere.

en: Documentation Sources
it-IT: Fonti documentali

en: <primary>documentation</primary>
it-IT: <primary>documentazione</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.
it-IT: Prima di comprendere cosa sta relamente succedendo quando c'è un problema, bisogna conoscere il ruolo teorico giocato da ciascun programma coinvolto nel problema. Per fare questo, per avere la migliore visione si deve consultare la loro documentazione; ma dal momento che queste documentazioni molte e posso essere sparse in lungo e in largo, si dovrebbero conoscere tutti i posti in cui si potrebbero trovare.

en: Manual Pages
it-IT: Pagine di manuale

en: <primary>manual pages</primary>
it-IT: <primary>pagine di manuale</primary>

en: <primary>manual pages</primary><secondary><command>man</command></secondary>
it-IT: <primary>pagine del manuale</primary><secondary><command>man</command></secondary>

en: <primary>documentation</primary><secondary>manual pages</secondary>
it-IT: <primary>documentazione</primary><secondary>pagine manuale</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/man/</filename></secondary>
it-IT: <primary>documentazione</primary><secondary><filename>/usr/share/man/</filename></secondary>

en: <emphasis>CULTURE</emphasis> <acronym>RTFM</acronym>
it-IT: <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.
it-IT: Questo acronimo sta per "Read the F**king Manual" («Leggi il f**tuto manuale»), ma può anche esere esteso in una variante più gentile, "Read the Fine Manual" ("Leggi l'ottimo manuale"). Questa frase viene talvolta usata per dare risposte (laconiche) a domande fatte da novellini. È una risposta piuttosto brusca, e tradisce un certo fastidio nel rispondere a una domanda fatta da qualcuno che non si è neanche scomodato a leggere la documentazione. Qualcuno dice che questa risposta classica sia meglio di nessuna risposta (visto che indica che la documentazione contiene la risposta cercata), o di una risposta più prolissa e arrabbiata.

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" />
it-IT: In ogni caso, se qualcuno risponde "RTFM", è bene non prendersela. Dal momento che questa risposta può essere considerata fastidiosa, forse sarebbe meglio evitarsela fin dall'inizio. Se l'informazione cercata non sta nel manuale, il che è possibile, sarebbe meglio dirlo, preferibilmente nella domanda iniziale. Si dovrebbero anche descrivere i vari passi compiuti personalmente per cercare informazioni prima di fare una domanda su un forum. Seguire le linee guida di Eric Raymond è un buon modo per evitare gli errori più comuni e ottenere risposte utili. <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" />).
it-IT: Le pagine di manuale, sebbene relativamente laconiche, contengono una grande quantità di informazioni importanti. Daremo una rapida occhiata al comando per vederle fornito dal pacchetto <emphasis role="pkg">man-db</emphasis>. Si deve scrivere semplicemente <command>man <replaceable>pagina-di-manuale</replaceable></command> — di solito la pagina di manuale ha lo stesso nome del comando di cui si cerca la documentazione. Per esempio, per conoscere le possibili opzioni del comando <command>cp</command>, digitare il comando <command>man cp</command> al prompt di shell (vedere il riquadro <xref linkend="sidebar.shell" />).

en: <emphasis>BACK TO BASICS</emphasis> The shell, a command line interpreter
it-IT: <emphasis>FONDAMENTALI</emphasis> La shell, un interprete a riga di comando

en: <primary>command line interpreter</primary>
it-IT: <primary>interprete a riga di 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.
it-IT: Un interprete a riga di comando, detto anche «shell», è un programma che esegue comandi inseriti dall'utente o memorizzati in uno script. In modalità interattiva, visualizza un prompt (che di solito termina per <literal>$</literal> per un utente normale o per <literal>#</literal> per un amministratore), che indica che è pronto a leggere un nuovo comando. <xref linkend="short-remedial-course" /> descrive i fondamentali dell'uso della 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>.
it-IT: La shell predefinita e più comunemente usata è la <command>bash</command> (Bourne Again SHell), ma ce ne sono altre, fra cui <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>).
it-IT: Fra le altre cose, la maggior parte delle shell offrono aiuto (digitare <command>help</command>) ed assistenza durante l'inserimento da prompt, come il completamento dei nomi dei comandi o dei file (che di solito si attiva premendo il tasto <keycap>tab</keycap>) od il richiamo di comandi precedenti (gestione cronologia; cioè controllare la mappatura per "pagina su" e "pagina giù" in <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:
it-IT: Le pagine di manuale non documentano solo i comandi ed i programmi accessibili dalla riga di comando, ma anche i file di configurazione, le chiamate di sistema, le funzioni di libreria e così via. A volte alcuni nomi possono collidere. Per esempio, il comando <command>read</command> della shell ha lo stesso nome della chiamata di sistema <function>read</function>. Per questo le pagine di manuale sono organizzate in sezioni numerate:

en: commands that can be executed from the command line;
it-IT: comandi eseguibili dalla riga di comando;

en: system calls (functions provided by the kernel);
it-IT: chiamate di sistema (funzioni fornite dal kernel);

en: library functions (provided by system libraries);
it-IT: funzioni di libreria (fornite dalle librerie di sistema);

en: devices (on Unix-like systems, these are special files, usually placed in the <filename>/dev/</filename> directory);
it-IT: dispositivi (sui sistemi Unix-like, questi sono file speciali, di solito posti nella directory <filename>/dev/</filename>);

en: configuration files (formats and conventions);
it-IT: file di configurazione (formati e convenzioni);

en: games;
it-IT: giochi;

en: sets of macros and standards;
it-IT: insiemi di macro e standard;

en: system administration commands;
it-IT: comandi di amministrazione del sistema;

en: kernel routines.
it-IT: routine del kernel.

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.
it-IT: È possibile specificare la sezione della pagina di manuale che si sta cercando: per vedere la documentazione della chiamata di sistema <function>read</function>, si scriverà <command>man 2 read</command>. Quando non è esplicitamente specificata una sezione, verrà mostrata la prima sezione che ha una pagina di manuale col nome richiesto. Perciò, <command>man shadow</command> restituirà <citerefentry><refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum></citerefentry> perché non ci sono pagine di manuale per <foreignphrase>shadow</foreignphrase> nelle sezioni da 1 a 4.

en: <emphasis>TIP</emphasis> <command>whatis</command>
it-IT: <emphasis>SUGGERIMENTO</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>.
it-IT: Se non si vuole guardare la pagina di manuale completa ma solo una breve descrizione per confermare che è ciò che si cerca, si scriva semplicemente <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.
it-IT: Questa breve descrizione è inclusa nella sezione <emphasis>NOME</emphasis> all'inizio di tutte le pagine di manuale.

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.
it-IT: Ovviamente, se non si conoscono i nomi dei comandi, il manuale non sarà molto utile. Per questo scopo c'è il comando <command>apropos</command>, che aiuta a cercare all'interno delle pagine di manuale, o più precisamente nelle loro descrizioni brevi. Ogni pagina di manuale comincia in pratica con un riassunto di una riga. <command>apropos</command>, restituisce una lista di pagine di manuale che menzionano le parole chiave richieste. Con una scelta oculata, si può trovare il nome del comando che serve.

en: Finding <command>cp</command> with <command>apropos</command>
it-IT: Trovare <command>cp</command> con <command>apropos</command>

en: <emphasis>TIP</emphasis> Browsing by following links
it-IT: <emphasis>SUGGERIMENTO</emphasis> Sfogliare seguendo i collegamenti

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.
it-IT: Molte pagine di manuale hanno una sezione «VEDERE ANCHE», di solito alla fine. Si riferisce ad altre pagine di manuale che trattano comandi simili oppure a documentazione esterna. In questo modo, è possibile trovare documentazione relativa a ciò che si stava cercando anche quando la prima scelta non è ottimale.

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" />
it-IT: Il comando <command>man</command> non è l'unico modo di consultare le pagine di manuale; infatti, anche <command>khelpcenter</command>, <command>konqueror</command> (in KDE) e <command>yelp</command> (in GNOME) offrono questa possibilità. Esiste anche un'interfaccia web, fornita dal pacchetto <command>man2html</command>, che permette di vedere le pagine di manuale in un browser web. In un computer in cui è installato questo pacchetto, si può usare questo URL dopo aver seguito le istruzioni in <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.
it-IT: Questa utilità richiede un server web. Per questo si dovrebbe installare questo pacchetto su uno dei propri server: tutti gli utenti della rete locale potrebbero beneficiare di questo servizio (comprese macchine non Linux) e così non si è obbligati a installare un server HTTP su ogni macchina. Se il proprio server è accessibile anche da altre reti, potrebbe essere opportuno restringere l'accesso a questo servizio solo agli utenti della rete locale.

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" />
it-IT: Ultimo ma non meno importante, è possibile visualizzare tutte le pagine manuali disponibili in Debian (anche quelle che non sono installate sul computer) su <literal>manpages.debian.org</literal>. Esso offre ogni pagina di manuale in più versioni, una per ogni versione Debian. <ulink type="block" url="https://manpages.debian.org" />

en: <emphasis>DEBIAN POLICY</emphasis> Required man pages
it-IT: <emphasis>DEBIAN POLICY</emphasis> Pagine di manuale richieste

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.
it-IT: Debian richiede che ogni programma abbia una pagina di manuale. Se l'autore a monte non ne fornisce una, il manutentore del pacchetto Debian di solito scriverà una pagina minimale che quantomeno indirizzerà il lettore alla documentazione originale.

en: <emphasis>info</emphasis> Documents
it-IT: Documenti <emphasis>info</emphasis>

en: <primary>documentation</primary><secondary>info documents</secondary>
it-IT: <primary>documentazione</primary><secondary>documenti informativi</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/info/</filename></secondary>
it-IT: <primary>documentazione</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).
it-IT: Il progetto GNU ha scritto manuali per la maggior parte dei suoi programmi in formato <emphasis>info</emphasis>; per questo motivo molte pagine di manuale rimandano alla corrispondente documentazione <emphasis>info</emphasis>. Questo formato offre alcuni vantaggi, ma il programma predefinito per visualizzare questi documenti (è chiamato <command>info</command>) è anche leggermente più complesso. Si farebbe bene ad usare invece <command>pinfo</command> (dal pacchetto <emphasis role="pkg">pinfo</emphasis>).

en: <primary><command>pinfo</command></primary>
it-IT: <primary><command>info</command></primary>

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.
it-IT: La documentazione <emphasis>info</emphasis> ha una struttura gerarchica e se si invoca <command>info</command> senza parametri, verrà mostrata una lista dei nodi disponibili al primo livello. Di solito, i nodi riportano i nomi dei comandi corrispondenti.

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" />
it-IT: Con <command>pinfo</command> è facile effettuare la navigazione tra questi nodi utilizzando i tasti freccia. In alternativa, è anche possibile utilizzare un browser grafico, che è molto più intuitivo. Inoltre, si possono utilizzare <command>konqueror</command> e <command>yelp</command>; il pacchetto <command>info2www</command> fornisce anche un'interfaccia 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.
it-IT: Notare che il sistema <emphasis>info</emphasis> non permette traduzioni, al contrario del sistema di pagine <command>man</command>. Perciò i documenti <emphasis>info</emphasis> sono quasi sempre in Inglese. Tuttavia, quando si chiede al programma <command>pinfo</command> di visualizzare una pagina <emphasis>info</emphasis> non esistente, questo ricadrà sulla pagina <emphasis>man</emphasis> con lo stesso nome (se esiste), che potrebbe essere stata tradotta.

en: Specific Documentation
it-IT: Documentazione specifica

en: <primary>documentation</primary><secondary>package documentation</secondary>
it-IT: <primary>documentazione</primary><secondary>documentazione del pacchetto</secondary>

en: <primary>documentation</primary><secondary>documentation package</secondary>
it-IT: <primary>documentazione</primary><secondary>documentazione del pacchetto</secondary>

en: <primary>documentation</primary><secondary><filename>/usr/share/doc/<replaceable>package</replaceable>/</filename></secondary>
it-IT: <primary>documentazione</primary><secondary><filename>/usr/share/doc/<replaceable>pacchetto</replaceable>/</filename></secondary>

en: <primary>documentation</primary><secondary><emphasis role="pkg"><replaceable>package</replaceable>-doc</emphasis></secondary>
it-IT: <primary>documentazione</primary><secondary><emphasis role="pkg"><replaceable>pacchetto</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.
it-IT: Ogni pacchetto include la propria documentazione. Anche i programmi meno documentati in generale hanno un file <filename>README</filename> che contiene informazioni interessanti o importanti. Questa documentazione è installata nella directory <filename>/usr/share/doc/<replaceable>pacchetto</replaceable>/</filename> (dove <replaceable>pacchetto</replaceable> rappresenta il nome del pacchetto). Se la documentazione è particolarmente grande, potrebbe non essere inclusa nel pacchetto principale del programma, ma piuttosto separata in un pacchetto dedicato che di solito di chiama <literal><replaceable>pacchetto</replaceable>-doc</literal>. Di solito il pacchetto principale raccomanda il pacchetto con la documentazione, dimodoché è facile trovarla.

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" />).
it-IT: Nella directory <filename>/usr/share/doc/<replaceable>pacchetto</replaceable>/</filename> ci sono inoltre alcuni file forniti da Debian che completano la documentazione specificando le peculiarità del pacchetto o dei miglioramenti rispetto a un'installazione tradizionale del software. Il file <filename>README.Debian</filename> indica inoltre tutti gli adattamenti fatti per aderire alla Policy di Debian. Il file <filename>changelog.Debian.gz</filename> permette all'utente di seguire le modifiche fatte al pacchetto nel tempo: è molto utile per cercare di capire cos'è cambiato fra due versioni installate che non hanno lo stesso comportamento. Infine, a volte è presente un file <filename>NEWS.Debian.gz</filename> che documenta i principali cambiamenti al programma che possono interessare direttamente l'amministratore (vedere <xref linkend="sect.dist-upgrade-problems" />).

en: Websites
it-IT: Siti web

en: <primary>documentation</primary><secondary>websites</secondary>
it-IT: <primary>documentazione</primary><secondary>siti web</secondary>

en: <emphasis>TIP</emphasis> From error to solution
it-IT: <emphasis>SUGGERIMENTO</emphasis> Dall'errore alla soluzione

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.
it-IT: Se il software restituisce un messaggio d'errore molto specifico, si può inserirlo nel motore di ricerca (fra doppie virgolette, <literal>"</literal>, per cercare non le singole parole chiave, ma la frase completa). Nella maggior parte dei casi, i primi collegamenti restituiti conterranno la risposta cercata.

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.).
it-IT: In altri casi si otterranno errori molto generici, come «Permesso negato». In questo caso, è meglio controllare i permessi degli elementi coinvolti (file, ID utente, gruppi, ecc.).

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" />
it-IT: Se non si conosce l'indirizzo del sito web del software, ci sono diversi modi per ottenerlo. Prima di tutto, controllare se esiste un campo <literal>Homepage</literal> nelle meta-informazioni del pacchetto (<command>apt show <replaceable>pacchetto</replaceable></command>). In alternativa, la descrizione del pacchetto potrebbe contenere un collegamento al sito web ufficiale del programma. Se non è indicato alcun URL, cercare nel file <filename>/usr/share/doc/<replaceable>pacchetto</replaceable>/copyright</filename>. Il manutentore Debian, di solito, indica in questo file dove è stato preso il codice sorgente del programma ed è probabile che questo sia il sito web cercato. Qualora la ricerca sia ancora infruttuosa, consultare una directory di software libero, come la Free Software Directory di FSF, oppure utilizzando direttamente un motore di ricerca, come Google, DuckDuckGo, Yahoo, ecc. <ulink type="block" url="https://directory.fsf.org/wiki/Main_Page" />

en: <primary>documentation</primary><secondary><literal>wiki.debian.org</literal></secondary>
it-IT: <primary>documentazione</primary><secondary><literal>wiki.debian.org</literal></secondary>

en: Tutorials (<emphasis>HOWTO</emphasis>)
it-IT: Esercitazioni (<emphasis>HOWTO</emphasis>)

en: <primary>documentation</primary><secondary>HOWTO</secondary>
it-IT: <primary>documentazione</primary><secondary>HOWTO</secondary>

en: <primary>documentation</primary><secondary>tutorials</secondary>
it-IT: <primary>documentazione</primary><secondary>guide</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.
it-IT: Un <emphasis>HOWTO</emphasis> è un documento che descrive, in termini concreti e passo dopo passo, "come" raggiungere un obiettivo predefinito. Gli obiettivi trattati sono abbastanza variegati, ma spesso di natura tecnica: per esempio, impostare il mascheramento degli IP, configurare un RAID software, installare un server Samba ecc. Questi documenti spesso cercano di coprire tutti i potenziali problemi che potrebbero verificarsi durante l'implementazione di una determinata tecnologia.

en: Debian also provides tutorials for its users: <ulink type="block" url="https://www.debian.org/doc/" />
it-IT: Debian fornisce anche tutorial per i suoi utenti: <ulink type="block" url="https://www.debian.org/doc/" />

en: Common Procedures
it-IT: Procedure comuni

en: <primary>standard procedure</primary>
it-IT: <primary>procedura standard</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.
it-IT: Lo scopo di questa sezione è di presentare qualche suggerimento generale su certe operazioni che un amministratore dovrà effettuare di frequente. Queste procedure ovviamente non copriranno ogni caso possibile in modo esauriente, ma possono servire come punti di partenza per i casi più difficili.

en: <emphasis>DISCOVERY</emphasis> Documentation in other languages
it-IT: <emphasis>SCOPERTA</emphasis> Documentazione in altre lingue

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).
it-IT: Della documentazione tradotta in lingua non inglese è spesso disponibile in un pacchetto separato col nome del pacchetto corrispondente seguito da <literal>-<replaceable>lingua</replaceable></literal> (dove <replaceable>lingua</replaceable> è il codice ISO di due lettere per la lingua).

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.
it-IT: Per esempio, il pacchetto <emphasis role="pkg">debian-reference-fr</emphasis> è la versione francese delle guide di riferimento per Debian (inizialmente scritta in inglese da Osamu Aoki) ed il pacchetto <emphasis role="pkg">manpages-de</emphasis> contiene la versione tedesca delle pagine di manuale per l'utilizzo di GNU/Linux.

en: <primary>documentation</primary><secondary><emphasis role="pkg">manpages-<replaceable>lang</replaceable></emphasis></secondary>
it-IT: <primary>documentazione</primary><secondary><emphasis role="pkg">manpages-<replaceable>lang</replaceable></emphasis></secondary>

en: Configuring a Program
it-IT: Configurare un programma

en: <primary>configuration</primary><secondary>program configuration</secondary>
it-IT: <primary>configurazione</primary><secondary>configurazione di un programma</secondary>

en: <primary>program</primary><secondary>configuration</secondary>
it-IT: <primary>programma</primary><secondary>configurazione</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.
it-IT: Quindi, si dovrebbe guardare la documentazione ufficiale del software — riferirsi alla <xref linkend="sect.documentation-sources" /> per identificare le varie fonti di informazione esistenti. Il comando <command>dpkg -L <replaceable>pacchetto</replaceable></command> dà una lista di file inclusi nel pacchetto; è quindi possibile identificare rapidamente la documentazione disponibile (oltre ai file di configurazione, situati in <filename>/etc/</filename>). <command>dpkg -s <replaceable>pacchetto</replaceable></command> fornisce l'intestazione del pacchetto e mostra i possibili pacchetti raccomandati o suggeriti, fra cui si può trovare la documentazione o l'utilità che potrebbe facilitare la configurazione del 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.
it-IT: Infine, i file di configurazione sono spesso auto-documentati con molti commenti che spiegano in dettaglio i possibili valori di ogni impostazione di configurazione, a volte al punto tale che basta scegliere una riga da attivare fra quelle disponibili. In alcuni casi, nella directory <filename>/usr/share/doc/<replaceable>pacchetto</replaceable>/examples/</filename> sono forniti degli esempi di file di configurazione che possono servire come base per i propri file di configurazione.

en: <emphasis>DEBIAN POLICY</emphasis> Location of examples
it-IT: <emphasis>DEBIAN POLICY</emphasis> Posizione degli esempi

en: <primary>examples, location</primary>
it-IT: <primary>esempi, posizione</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.
it-IT: Tutti gli esempi devono essere installati nella directory <filename>/usr/share/doc/<replaceable>pacchetto</replaceable>/examples/</filename>. Possono essere un file di configurazione, il sorgente di un programma (un esempio di uso di una libreria) o uno script di conversione di dati che l'amministratore può usare in certi casi (ad esempio per inizializzare un database). Se l'esempio è specifico per una particolare architettura, deve essere installato in <filename>/usr/lib/<replaceable>pacchetto</replaceable>/examples/</filename> e si può creare un collegamento che punta a quel file nella directory <filename>/usr/share/doc/<replaceable>pacchetto</replaceable>/examples/</filename>.

en: Monitoring What Daemons Are Doing
it-IT: Monitorare l'attività dei demoni

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.
it-IT: Capiere cos'è un demone è qualcosa di più complicato, dal momento che non interagisce direttamente con l'amministratore. Per controllare se un demone è effettivamente in funzione, bisogna fare delle prove. Ad esempio, per controllare il demone Apache (server web), si deve fare una prova con una richiesta HTTP.

en: <emphasis>BACK TO BASICS</emphasis> Daemon
it-IT: <emphasis>FONDAMENTALI</emphasis> Demone

en: <primary>daemon</primary>
it-IT: <primary>demone</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.).
it-IT: Un demone è un programma non invocato esplicitamente dall'utente e che rimane sullo sfondo, aspettando che si realizzi una cerca condizione prima di eseguire un compito. Molti programmi server sono demoni, un termine che spiega perché la lettera «d» è spesso presente alla fine del loro nome (<command>sshd</command>, <command>smtpd</command>, <command>httpd</command> ecc.).

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.
it-IT: Per consentire queste prove, ogni demone in generale registra tutto ciò che fa, così come ogni errore che incontra, in quelli che vengono chiamati «file di registro» o «registri di sistema». I registri sono salvati in <filename>/var/log/</filename> o una sua sottodirectory. Per sapere il nome esatto di un file di registro per ciascun demone, vedere la sua documentazione. Nota: una sola prova non sempre è sufficiente, se questa non copre tutti i possibili casi d'uso; alcuni problemi si manifestano solo in circostanze particolari.

en: <emphasis>TOOL</emphasis> The <command>rsyslogd</command> daemon
it-IT: <emphasis>STRUMENTO</emphasis> Il demone <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).
it-IT: <command>rsyslogd</command> è speciale: raccoglie i log (messaggi interni di sistema) che gli vengono inviati da altri programmi. A ciascun messaggio è associato un sottosistema (e-mail, kernel, autenticazione, ecc.) ed una priorità; <command>rsyslogd</command> elabora queste due informazioni per decidere cosa fare. Il messaggio di log può essere scritto in diversi file e/o inviato ad una console di amministrazione. I dettagli sono definiti nel file di configurazione <filename>/etc/rsyslog.conf</filename> (documentato nella pagina di manuale omonima fornita dal pacchetto <emphasis role="pkg">rsyslog-doc</emphasis> package).

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).
it-IT: Alcune funzioni C, specializzate nell'invio di log, semplificano l'uso del demone <command>rsyslogd</command>. Tuttavia alcuni demoni gestiscono da soli i propri file di registro (è il caso, ad esempio, di <command>samba</command>, che implementa le cartelle di rete Windows su 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).
it-IT: Si noti che quando <command>systemd</command> è in uso, iregistri sono in realtà raccolti da <command>systemd</command> prima di essere trasmetto a <command>rsyslogd</command>. Sono quindi disponibili anche tramite il giornale di <command>systemd</command> e possono essere consultati con <command>journalctl</command> (vedi <xref linkend="sect.systemd" /> per dettagli).

en: Asking for Help on a Mailing List
it-IT: Chiedere aiuto su una lista di posta

en: <primary>mailing lists</primary>
it-IT: <primary>mailing list</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" />
it-IT: Se dopo svariate ricerche non si è ancora individuata la causa di un problema, è possibile chiedere aiuto ad altre persone, magari più esperte. Questo è proprio lo scopo della mailing list <email>debian-user@lists.debian.org</email> e di quelle in lingua specifica <email>debian-user-<replaceable>lang</replaceable>@lists.debian.org</email>. Come ogni comunità, anche questa ha delle regole che devono essere seguite. Prima di porre domande, controllare che il problema non sia già stato trattato da discussioni recenti in lista o dalla documentazione ufficiale. <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>
it-IT: <primary>mailing list</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>
it-IT: <primary>mailing list</primary><secondary><email>debian-user-<replaceable>lang</replaceable>@lists.debian.org</email></secondary>

en: <emphasis>BACK TO BASICS</emphasis> Netiquette applies
it-IT: <emphasis>FONDAMENTALI</emphasis> Vale la netiquette

en: <primary>Code of Conduct</primary>
it-IT: <primary>Codice di condotta</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" />
it-IT: In generale, per tutta la corrispondenza sulle liste di posta elettronica, si devono seguire le regole della netiquette. Questo termine si riferisce ad un insieme di regole di buon senso, dalla comune cortesia a errori che dovrebbero essere evitati. <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" />
it-IT: Inoltre, per ogni canale di comunicazione gestita dal progetto Debian, bisogna attenersi al Codice di Condotta di 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/" />
it-IT: Soddisfatte queste due condizioni, si può pensare a descrivere il problema alla lista. Includere quante più informazioni pertinenti possibili: quali prove sono state effettuate, che documentazione è stata consultata, come si è tentato di diagnosticare il problema, i pacchetti coinvolti o quelli che potrebbero esserlo, ecc. Controllare il Sistema di Tracciamento dei Bug di Debian (BTS, descritto nel riquadro <xref linkend="sect.bts" />) alla ricerca di problemi simili fancendo menzione dei risultati e fornendo i collegamenti ai bug trovati. Il BTS comincia su: <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.
it-IT: Più cortesia e precisione sono state usate, maggiori sono le possibilità di ricevere una risposta completa, o, almeno, parziale. Se si ricevono informazioni importanti via posta elettronica privata, sarebbe meglio riassumerle in pubblico in modo che anche altri possano trarne beneficio. Permettere agli archivi della lista, che vengono ricercati tramite vari motori di ricerca, di mostrare la soluzione per altri che potrebbero avere la stessa domanda.

en: Reporting a Bug When a Problem Is Too Difficult
it-IT: Segnalare un bug quando un problema è troppo difficile

en: <primary>report a bug</primary>
it-IT: <primary>segnalare un 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.
it-IT: Se tutti gli sforzi per risolvere un problema falliscono, è possibile che la soluzione non sia responsabilità propria e che il problema sia dovuto a un bug nel programma. In questo caso, la procedura corretta è di segnalare il bug a Debian o direttamente agli sviluppatori a monte. Per farlo, isolare il più possibile il problema e creare una situazione minimale di prova in cui questo possa essere riprodotto. Se si sa quale programma è la causa apparente del problema, si può trovare il pacchetto corrispondente usando il comando<command>dpkg -S <replaceable>file_in_questione</replaceable></command>. Controllare il sistema di tracciamento dei bug (<literal>https://bugs.debian.org/<replaceable>pacchetto</replaceable></literal>) per assicurarsi che il bug non sia già stato segnalato. È possibile inviare la propria segnalazione, usando il comando <command>reportbug</command>, includendo quante più informazioni possibile, soprattutto una descrizione completa di quei casi minimali di prova che permetteranno a chiunque di ricreare il 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!
it-IT: Quanto visto in questo capitolo aiuta ad affrontare concretamente problemi come quelli che si potrebbero incontrare durante i prossimi capitoli. Li si utilizzi ogni volta che è necessario!
