534
contributi
Come formulare quesiti tecnici al forum: differenze tra le versioni
Come formulare quesiti tecnici al forum (visualizza wikitesto)
Versione delle 07:04, 24 mar 2021
, 24 mar 2021errore nei titooi
Aki (discussione | contributi) |
m (errore nei titooi) |
||
| (38 versioni intermedie di 6 utenti non mostrate) | |||
| Riga 1: | Riga 1: | ||
== Premessa == | == Premessa == | ||
Come indicato nel [http://forum.debianizzati.org/viewtopic.php?f=47&t=40020#p103886 regolamento] di http://forum.debianizzati.org, è raccomandabile che i quesiti tecnici siano formulati in modo da essere sufficientemente informativi: un quesito ben posto, infatti, è generalmente la premessa ad una risposta rapida e, spesso, soddisfacente sia per chi la pone che per chi la riceve (per una più approfondita lettura si rimanda a [http://catb.org/esr/faqs/smart-questions.html "How To Ask Questions The Smart Way"]). | Come indicato nel [http://forum.debianizzati.org/viewtopic.php?f=47&t=40020#p103886 regolamento] di http://forum.debianizzati.org, è raccomandabile che i quesiti tecnici siano formulati in modo da essere sufficientemente informativi: un quesito ben posto, infatti, è generalmente la premessa ad una risposta rapida e, spesso, soddisfacente sia per chi la pone che per chi la riceve (per una più approfondita lettura si rimanda a [http://catb.org/esr/faqs/smart-questions.html "How To Ask Questions The Smart Way"]). | ||
Peraltro, è indicativo di poca educazione del richiedente impegnare - inutilmente - il tempo dei propri corrispondenti a fronte di descrizioni intenzionalmente poco comprensibili o omissive di elementi fondamentali. | |||
== Obiettivo == | == Obiettivo == | ||
Il presente documento intende suggerire ai frequentatori del forum un ''metodo'' ed alcune ''istruzioni operative'' per corredare di elementi oggettivi un eventuale quesito tecnico; ciò sia allo scopo di analizzarlo nel miglior modo possibile che di proporre eventuali suggerimenti e/o soluzioni il più possibile pertinenti. Resta inteso che le istruzioni operative suggerite: | Il presente documento intende suggerire ai frequentatori del forum un ''metodo'' ed alcune ''istruzioni operative'' per corredare di elementi oggettivi un eventuale quesito tecnico; ciò sia allo scopo di analizzarlo nel miglior modo possibile che di proporre eventuali suggerimenti e/o soluzioni il più possibile pertinenti. Resta inteso che le istruzioni operative suggerite: | ||
* rappresentano solo un atto di indirizzo ed hanno carattere puramente esemplificativo poiché non possono essere esaustive dell'infinito numero di possibili quesiti; l'utente, di volta in volta, potrà aggiungere o rimuovere le istruzioni che riterrà opportune o che gli/le saranno suggerite nel forum; | * rappresentano solo un atto di indirizzo ed hanno carattere puramente esemplificativo poiché non possono essere esaustive dell'infinito numero di possibili quesiti; l'utente, di volta in volta, potrà aggiungere o rimuovere le istruzioni che riterrà opportune o che gli/le saranno suggerite nel forum; | ||
* non sostituiscono la preliminare "fase istruttoria" (precedente all'invio del quesito) di cui [http://forum.debianizzati.org/ | * non sostituiscono la preliminare "fase istruttoria" (precedente all'invio del quesito) di cui [http://forum.debianizzati.org/viewtopic.php?f=47&t=40020#p103886 all'articolo 6 del regolamento] del forum; | ||
== Metodo == | == Metodo == | ||
Il metodo qui suggerito prevede l'uso di registrazioni informatiche relative al funzionamento del software e dell'hardware (in gergo tecnico, ''log''). In particolare, si ricorda che: | Il metodo qui suggerito prevede l'uso di registrazioni informatiche relative al funzionamento del software e dell'hardware (in gergo tecnico, ''log''). In particolare, si ricorda che: | ||
* il sistema operativo Debian GNU/Linux genera sistematicamente ''log di sistema'' durante le sue ordinarie attività: i principali log possono essere consultati nella directory < | * il sistema operativo Debian GNU/Linux genera sistematicamente ''log di sistema'' durante le sue ordinarie attività: i principali log possono essere consultati nella directory <code>/var/log/</code> accessibile all'utente <code>root</code>[https://www.debian.org/doc/manuals/debian-reference/ch09.it.html#_the_log_daemon]; | ||
* altri log possono essere generati quando necessario ricorrendo, ad esempio, al comando < | * altri log possono essere generati quando necessario ricorrendo, ad esempio, al comando <code>script</code>[https://www.debian.org/doc/manuals/debian-reference/ch01.it.html#_recording_the_shell_activities]: alcuni esempi sono indicati nel paragrafo successivo. Si ricorda che il comando <code>script</code> è utilizzato generalmente in modalità interattiva (consultare la pagine di manuale di <code>script</code> per maggiori dettagli). | ||
Si raccomanda, quindi, di | Si raccomanda, quindi, di includere nei messaggi contenenti i quesiti tecnici: | ||
# una descrizione accurata del fenomeno osservato; | |||
# i riferimenti dell'eventuale documentazione già reperita e consultata; validi riferimenti per potersi documentare sono: | |||
## la guida all'installazione di Debian [https://www.debian.org/releases/stable/installmanual.it.html] | |||
## le note di rilascio di Debian (ad esempio, della corrente versione "stabile" [https://www.debian.org/releases/jessie/index.it.html]) | |||
## la guida di riferimento di Debian [https://www.debian.org/doc/manuals/debian-reference/index.it.html] | |||
## il "wiki" di Debian [https://wiki.debian.org/it/FrontPage] | |||
## le guide del forum http://forum.debianizzati.org [[Pagina principale | guide.debianizzati.org/]] | |||
## la funzione di ricerca del forum stesso [http://forum.debianizzati.org/search.php] | |||
# l'indicazione della versione di Debian[https://www.debian.org/releases/index.it.html] e dell'architettura[https://www.debian.org/ports/index.it.html] utilizzata; | |||
# una descrizione accurata dell'hardware (produttore e modello) interessato al quesito, preferibilmente con riferimento alle specifiche tecniche (ad esempio, il manuale d'uso) documentate sul sito internet del produttore; | |||
# gli stralci dei file di log ritenuti pertinenti; in tal caso, nel testo del messaggio del forum, è preferibile che all'inzio dello stralcio sia posto il tag [CODE] ed alla fine il tag [/CODE] in modo che il testo interposto sia formattato come "codice"; | # gli stralci dei file di log ritenuti pertinenti; in tal caso, nel testo del messaggio del forum, è preferibile che all'inzio dello stralcio sia posto il tag [CODE] ed alla fine il tag [/CODE] in modo che il testo interposto sia formattato come "codice"; | ||
# in alternativa, è possibile - dopo averli valutati - sottoporre i file di log nella loro interezza all'attenzione del forum: a tal fine, si può ricorrere: | # in alternativa, è possibile - dopo averli valutati - sottoporre i file di log nella loro interezza all'attenzione del forum: a tal fine, si può ricorrere: | ||
## a servizi gratuiti (come, ad esempio, http:// | ## a servizi gratuiti (come, ad esempio, http://paste.debian.net/) che permettono di condividere, per un periodo limitato, i contenuti desiderati attraverso una URL temporanea ; in tal caso, quest'ultima URL dovrà essere trascritta nel testo del messaggio; | ||
## alla funzione del forum che consente di allegare un file in formato | ## alla funzione del forum che consente di allegare un file (ad esempio, in formato ''gzip'') al messaggio contenente il quesito (entro il limite massimo di dimensione automaticamente imposto dal software del forum); | ||
# nei casi di anomalie particolarmente difficili da documentare, e se tecnicamente possibile, si consiglia di allegare fotografie o riferimenti a brevi registrazioni video di ciò che compare sullo schermo del computer al momento dell'anomalia. | |||
== Istruzioni operative == | == Istruzioni operative == | ||
Si raccomanda di indicare sempre le principali caratteristiche tecniche della propria installazione Debian GNU/Linux. A tal fine, è possibile impartire, ad esempio, i comandi: | Si raccomanda di indicare sempre le principali caratteristiche tecniche della propria installazione Debian GNU/Linux. A tal fine, è possibile impartire, ad esempio, da una finestra di terminale (quindi, in modalità interattiva) i seguenti comandi: | ||
<pre> | <pre> | ||
script log.txt | script log.txt | ||
lsb_release -a | |||
dmesg | dmesg | ||
su -l -c "lspci -knn" | |||
lspci - | lsusb | ||
lsusb -v | su -l -c "lsusb -v" | ||
exit | exit | ||
</pre>che genereranno un file di log chiamato '''< | gzip -c log.txt > log.gz | ||
* la versione di debian installata ( | </pre>che genereranno un file di log chiamato '''<code>log.txt</code>''' che conterrà le seguenti informazioni: | ||
* il log del kernel a partire dall'avvio del sistema (comando < | * la versione di debian installata (comando <code>lsb_release -a</code>); | ||
* l'elenco delle periferiche PCI (comando < | * il log del kernel a partire dall'avvio del sistema (comando <code>dmesg</code>); | ||
* l'elenco delle periferiche PCI (comando <code>lspci</code>) e USB (comando <code>lsusb</code>) riconosciute dal sistema operativo (nota: il comando <code>su</code> richiederà l'inserimento della password dell'utente root, cioè dell'amministratore di sistema). | |||
Le stesse informazioni sono disponibili nel file compresso in formato gzip chiamato '''<code>log.gz</code>'''. | |||
A discrezione del richiedente ed in funzione del tipo di quesito è, naturalmente, possibile generare ''log'' relativi ad altri e più specifici aspetti del funzionamento del sistema operativo o di specifiche applicazioni; ad esempio, è possibile impartire i seguenti comandi: | A discrezione del richiedente ed in funzione del tipo di quesito è, naturalmente, possibile generare ''log'' relativi ad altri e più specifici aspetti del funzionamento del sistema operativo o di specifiche applicazioni; ad esempio, è possibile impartire i seguenti comandi: | ||
<pre> | <pre> | ||
| Riga 42: | Riga 60: | ||
cat /etc/apt/sources.list | cat /etc/apt/sources.list | ||
cat /etc/X11/xorg.conf | cat /etc/X11/xorg.conf | ||
su -c "cat /var/log/Xorg.0.log" | su -l -c "cat /var/log/Xorg.0.log" | ||
su -l -c "aptitude install wget" | |||
wget http://www.alsa-project.org/alsa-info.sh | |||
bash ./alsa-info.sh --stdout --no-upload | |||
exit | exit | ||
gzip -c log2.txt > log2.gz | |||
</pre> | </pre> | ||
che genereranno un file di log chiamato '''< | che genereranno un file di log chiamato '''<code>log2.txt</code>''' che conterrà le seguenti informazioni: | ||
* l'elenco delle partizioni disco montate (comando < | * l'elenco delle partizioni disco montate (comando <code>mount</code>) e la configurazione dei ''file system'' del sistema (file <code>/etc/fstab</code>); | ||
* la configurazione del sistema di rete (file < | * la configurazione del sistema di rete (file <code>/etc/network/interface</code>) e l'attuale stato delle periferiche di rete (comando <code>ip</code>); | ||
* la configurazione del gestore di pacchetti (file < | * la configurazione del gestore di pacchetti (file <code>/etc/apt/sources.list</code>); | ||
* la configurazione del server X (file < | * la configurazione del server X (file <code>/etc/X11/xorg.conf</code>, se presente) ed il file di log relativo al suo funzionamento (file <code>/var/log/Xorg.0.log</code>); | ||
* la configurazione del sistema audio ALSA e delle librerie correlate (script <code>alsa-info.sh</code> prelevato dal sito del progetto ALSA usando il programma <code>wget</code> di cui è verificata ed eventualmente effettuata l'installazione con il comando <code>aptitude install wget</code>). | |||
Le stesse informazioni sono disponibili nel file compresso in formato gzip chiamato '''<code>log2.gz</code>'''. | |||
== Creazione automatica di un file di log == | |||
Per quanti desiderassero generare automaticamente un file di log è possibile far riferimento ad una guida specifica per la [[Creazione automatica di un file di log per inviare quesiti al forum]]. | |||
== Conclusioni == | == Conclusioni == | ||
| Riga 62: | Riga 90: | ||
== Riferimenti == | == Riferimenti == | ||
1) Debian | 1) Debian Reference Guida, 9.2.1. Demoni di registro, https://www.debian.org/doc/manuals/debian-reference/ch09.it.html#_the_log_daemon | ||
2) Debian Reference Guida, 1.4.9. Registrare le attività della shell, https://www.debian.org/doc/manuals/debian-reference/ch01.it.html#_recording_the_shell_activities | |||
3) Debian Installation Guide, http://www.debian.org/releases/stable/installmanual.it.html | |||
4) Debian Release Notes for Stable release, http://www.debian.org/releases/stable/installmanual.it.html | |||
5) Debian Reference Guide, Table of Contents, https://www.debian.org/doc/manuals/debian-reference/index.it.html | |||
6) Debian Wiki, Main Page, https://wiki.debian.org/it/FrontPage | |||
7) Guide del Forum Debianizzati.org, [[Indice Guide]] | |||
8) Forum Debianizzati.org, funzione di ricerca, http://forum.debianizzati.org/search.php | |||
9) Versioni e rilasci di Debian, https://www.debian.org/releases/index.it.html | |||
10) Architetture supportate dal progetto Debian, https://www.debian.org/ports/index.it.html | |||
11) Regolamento Forum Debianizzati.org, http://forum.debianizzati.org/viewtopic.php?f=25&t=40984 | |||
--- | |||
'''Lo staff di Debianizzati.Org''' | |||
[[Categoria:Debianizzati]] | |||