Live manual Debian Live

# Debian Live Manual

# Segnalare bug

661

# 14. Segnalare bug

662

Live systems are far from being perfect, but we want to make it as close as possible to perfect - with your help. Do not hesitate to report a bug. It is better to fill a report twice than never. However, this chapter includes recommendations on how to file good bug reports.

663

Per gli impazienti

664

- First check whether the bugs has been reported already. You can see the full list of bugs that are assigned to the live-team at ‹https://bugs.debian.org/cgi-bin/pkgreport.cgi?maint=debian-live%40lists.debian.org›.

665

- Before submitting a bug report always try to reproduce the bug with the most recent versions of the packages of live-build, live-boot, live-config and live-tools that you're using.

666

- Si cerchi di fornire informazioni il più dettagliate possibile riguardo il bug. Questo comprende (almeno) la versione di live-build, live-boot, live-config e live-tools utilizzata e la distribuzione del sistema live che si sta creando.

667

14.1 Problemi noti

668

Currently known issues are listed in the BTS at ‹https://bugs.debian.org/cgi-bin/pkgreport.cgi?maint=debian-live%40lists.debian.org›.

669

Note: Since Debian testing and Debian unstable distributions are moving targets, when you specify either of them as the target system distribution, a successful build may not always be possible.

670

Se questo causa troppe difficoltà, non creare un sistema basato su testing o unstable ma usare piuttosto stable. live-build si basa su stable in modo predefinito.

671

It is out of the scope of this manual to train you to correctly identify and fix problems in packages of the development distributions, however, you can always try the following: If a build fails when the target distribution is testing, try unstable. If unstable does work, revert to testing and pin the newer version of the failing package from unstable (see APT pinning for details).

672

14.2 Fare la ricerca

673

Prima di riportare il bug si prega di cercare sul web il messaggio d'errore o il sintomo ottenuti. Poiché è altamente improbabile essere l'unica persona ad incontrare un certo problema, c'è sempre la possibilità che sia stato discusso altrove e che siano stati proposte una soluzione, una patch o soluzione temporanea.

674

You should pay particular attention to the live systems mailing list, as well as the homepage, as these are likely to contain the most up-to-date information. If such information exists, always include the references to it in your bug report.

675

In aggiunta bisogna controllare l'attuale elenco dei bug riguardanti live-build, live-boot, live-config e live-tools per vedere se sia già stato segnalato qualcosa di simile.

676

14.3 Ricompilare da zero

677

Per essere certi che un particolare bug non sia causato dalla creazione di un sistema non pulito, ricostruire sempre l'intero sistema da zero per vedere se il bug sia riproducibile.

678

14.4 Usare pacchetti aggiornati

679

Using outdated packages can cause significant problems when trying to reproduce (and ultimately fix) your problem. Make sure your build system is up-to-date and any packages included in your image are up-to-date as well. If possible, try to reproduce the bug with the newest code from source, see Installation for details.

680

14.5 Raccogliere informazioni

681

Nella segnalazione si invita a fornire informazioni sufficienti. Dovrebbe almeno contenere l'esatta versione di live-build nella quale si è trovato il bug e i passi per riprodurlo. Con un po' di buon senso si può includere qualsiasi altro dettaglio rilevante che si ritiene utile per la risoluzione del problema.

682

Affinché la segnalazione del bug sia migliore possibile, si richiedono almeno le seguenti informazioni:

683

- Architettura del sistema ospitante

684

- Distribution of the host system

685

- Versione di live-build sul sistema ospitante

686

- Version of debootstrap on the host system

687

- Architettura del sistema live

688

- Distribuzione del sistema live

689

- Versione di live-boot sul sistema ospitante

690

- Versione di live-config sul sistema live

691

- Versione di live-tools sul sistema ospitante

692

È possibile generare un registro del processo di costruzione usando il comando `tee`. Si raccomanda di farlo automaticamente con uno script `auto/build`; (si veda Gestire una configurazione per i dettagli).

693

# lb build 2>&1 | tee build.log

694

All'avvio, live-boot e live-config conservano i loro registri in `/var/log/live/`. Controllarvi gli errori.

695

Inoltre, per escludere altri errori è sempre una buona idea creare un tar della propria directory `config/` e caricarlo da qualche parte (non inviarlo come allegato alla mailing list), in modo che sia per noi possibile riprodurre gli errori incontrati. Se ciò causa problemi (ad esempio a causa della dimensione) si può utilizzare l'output di `lb config --dump` che produce un sommario dell'albero di configurazione (elenca i file nelle sottodirectory di `config/` ma non le include).

696

Ricordarsi che i file di registro da inviare vanno creati con l'impostazione della lingua inglese, ad esempio eseguendo il comando live-build preponendo `LC_ALL=C` oppure `LC_ALL=en_US`.

697

14.6 Se possibile isolare il caso non andato a buon fine

698

Se possibile, isolare il caso non andato a buon fine alla variazione più piccola che lo causa. Non è sempre facile da fare, perciò non preoccupatevi se non riuscite a gestirlo per la vostra segnalazione. Tuttavia, se si pianifica bene il ciclo di sviluppo adottando piccole modifiche per ogni iterazione, si riuscirà ad isolare il problema creando una configurazione semplificata che si avvicina all'attuale con l'aggiunta delle sole modifiche problematiche. Se si incontrano serie difficoltà nel trovare la causa, potrebbe essere che sono stati inseriti troppi cambiamenti in una sola volta e bisogna cambiare approccio.

699

14.7 Segnalare il bug del pacchetto giusto

700

In genere bisogna riportare gli errori in fase di compilazione verso il pacchetto live-build, quelli di avvio verso live-boot e quelli in fase di esecuzione a live-config. Se non siete certi di quale sia il pacchetto appropriato o serve maggiore aiuto prima della segnalazione, inviate una segnalazione per lo pseudo-pacchetto debian-live. Ce ne occuperemo riassegnandolo dove più appropriato.

701

Tuttavia vi saremmo grati se tentate di restringere il campo in base a dove appare il bug.

702

14.7.1 Durante la compilazione mentre esegue il bootstrap

703

live-build first bootstraps a basic Debian system with debootstrap. If a bug appears here, check if the error is related to a specific Debian package (most likely), or if it is related to the bootstrapping tool itself.

704

In both cases, this is not a bug in the live system, but rather in Debian itself and probably we cannot fix it directly. Please report such a bug against the bootstrapping tool or the failing package.

705

14.7.2 Durante la compilazione mentre installa i pacchetti

706

live-build installa pacchetti aggiuntivi dall'archivio Debian e può fallire a seconda della distribuzione Debian e lo stato dell'archivio giornaliero.Se il bug appare a questo punto, controllare che l'errore sia riproducibile su un sistema normale.

707

If this is the case, this is not a bug in the live system, but rather in Debian - please report it against the failing package. Running debootstrap separately from the Live system build or running `lb bootstrap --debug` will give you more information.

708

Se si verifica un problema utilizzando un mirror locale o un qualsiasi tipo di proxy è bene riprodurlo avviando da un mirror ufficiale.

709

14.7.3 In fase di avvio

710

Se l'immagine non si avvia segnalarlo alla mailing list con le informazioni richieste in Raccogliere informazioni. Non dimenticare di menzionare esattamente come e quando l'immagine fallisce, utilizzando la virtualizzazione o hardware reale. Se si utilizza un qualsiasi sistema di virtualizzazione provare sempre su hardware reale prima di segnalare un bug; anche fornire un'istantanea dello schermo può essere molto utile.

711

14.7.4 In fase di esecuzione

712

If a package was successfully installed, but fails while actually running the Live system, this is probably a bug in live-config.

713

14.8 Dove segnalare i bug

714

The Debian Live Project keeps track of all bugs in the Bug Tracking System (BTS). For information on how to use the system, please see ‹https://bugs.debian.org/›. You can also submit the bugs by using the `reportbug` command from the package with the same name.

715

Si noti che i bug trovati nelle distribuzioni derivate da Debian (come Ubuntu e altre) non vanno segnalati a Debian BTS a meno che non siano riproducibili anche su un sistema Debian utilizzando pacchetti ufficiali Debian.