Segnalare anomalie

Introduzione

È possibile aiutare gli sviluppatori di Ubuntu a migliorare Firefox o Thunderbird fornendo loro utili segnalazioni di anomalie. Ciò implica dover fornire il maggior numero di informazioni possibili per descriverla (consultare How to report Bugs).

È possibile che per alcune di queste istruzioni si debba usare il terminale, se non si è certi di come fare, consultare la guida sul terminale per una veloce introduzione.

Riceviamo un numero considerevole di segnalazioni contro Firefox da parte di utenti Ubuntu, ma purtroppo la maggior parte di esse non contiene abbastanza informazioni per descrivere sufficientemente il problema o determinarne la causa. Vi preghiamo di capire che non possediamo le necessarie risorse umane per analizzare ogni singola segnalazione e continuamente richiedere informazioni che dovrebbero già essere fornite in partenza. Per aumentare le possibilità che uno sviluppatore prenda in esame una vostra segnalazione è necessario seguire queste linee guida.

In seguito alcune istruzioni su come segnalare un'anomalia:

Utilizzo di Apport

Tutte le anomalie inerenti Firefox e Thunderbird devono essere inviate tramite Apport (a meno di problemi che ne impediscano l'uso). Per Firefox, è possibile fare ciò scegliendo la voce "Segnala un problema..." dal menu Aiuto, oppure premendo Alt+F2 e digitando ubuntu-bug firefox.

Per Thunderbird, premere Alt+F2 e digitare ubuntu-bug thunderbird.

Utilizzando Apport, verranno automaticamente allegati i file necessari, risparmiando così il tempo che si perderebbe per richiederli. Vi preghiamo di non avviare segnalazioni di anomalie in Firefox o Thunderbird utilizzando l'iterfaccia Launchpad. Nella maggior parte dei casi non sarano prese in considerazioni e sarannno chiuse con la richiesta di risegnalarla utilizzando Apport. Per cortesia non sciupate il tempo degli sviluppatori o dei bug triagers utilizzando l'interfaccia Launchpad.

Provare l'esecuzione in modalità sicura

Alcuni problemi sono causati da temi di terze parti, addons e plugins, oppure personalizzazioni nascoste in about:config. Tutto ciò può essere disabilitato temporaneamente eseguendo Firefox o Thunderbird in modalità sicura.

Per eseguire Firefox in modalità sicura occorre accertarsi che sia completamente chiuso, premere Alt+F2 ed eseguire firefox -safe-mode. Per eseguire Thunderbird in modalità sicura occorre chiuderne tutte le finestre, premere Alt+F2 ed eseguire thunderbird -safe-mode.

Se il problema non si presenta in modalità sicura, quindi è dovuto o a qualche addons o a qualche personalizzazione. In questo caso vi preghiamo di non segnalare l'anomalia contro Firefox o Thunderbird in Ubuntu. Se ne avete il tempo provate ad isolare il componente difettoso e segnalatene il problema al relativo sviluppatore.

Link to Mozilla Documentation

Siate specifici

Assicurarsi che lo sviluppatore possa riprodurre l'anomalia. Fornire ogni dettaglio possibile riguardante il bug, in particolare una sequenza esplicita delle azioni da compiere per riprodurlo. Si prega di non pensare che solo perché si verifica un bug sia facile per gli altri riprodurlo.

Controllare se il bug è già stato segnalato

Preghiamo di verificare che il bug non sia già stato segnalato. Comprendiamo che a volte è difficile sapere cosa cercare, e che lo è ancora di più in mezzo ad una moltitudine di altre segnalazioni, ma è uno sforzo necessario.

Cercare il proprio problema in SUMO

Controllare su http://support.mozilla.org/, per vedere se qualcuno ha già richiesto supporto per un problema simile al vostro. Potreste scoprire che il problema non è realmente un bug oppure che è già stato segnalato. Potreste anche trovare una soluzione temporanea.

Problemi con uno specifico sito web

Se Firefox non visualiza correttamente un sito web è necessario fornire le seguenti informazioni se possibile:

• Uno screenshot che mostri chiaramente il problema.
  • Rammentiamo che il problema potrebbe non essere ovvio a chi non ha familiarità con il sito in questione e potrebbe non sapere come dovrebbe apparire il sito normalmente. In questo caso siete pregati di descrivere cosa è sbagliato.
  • Rimuovere le informazioni personali dagli screenshot allegati.
• L' URL della pagina che causa problemi (preferibilmente un URL che non richieda iscrizione, comprendiamo però che a volte ciò non è possibile).

Potreste restare sorpresi, ma riceviamo segnalazioni inerenti siti web non visualizzati correttamene, senza alcuna di queste informazioni fornita. Capirete senz'altro che richiedere e spiegare è una perdita di tempo.

Quando si sperimenta un problema con un sito web, vi preghiamo di provare come segue:

• Provare ad utilizzare un'altro browser (non-Gecko) tipo (es, Chromium o Epiphany).
  • Per cortesia nella descrizione segnalare quale altro browser è stato testato.
• Se il sito web funziona correttamente con un altro browser, allegare uno screenshot di come dovrebbe apparire.

Crash

Alcune cose da considerare

Per cortesia evitare il presupposto che se avete sperimentato un crash, chiunque altro possa riprodurlo agevolmente. Tutte le segnalazione di crash devono avere allegato una completa stacktrace ed una completa descrizione dei passi da seguire per riprodurre il crash. Se il problema si amnifesta solamente con uno specifico sito web, vi preghiamo di allegare l'URL.

Ad esempio, questi tipi di segnalazioni sono inutili e non riceveranno, nostro malgrado, alcuna attenzione:

• A volte dopo aver clicato un link firefox crasha e appare la finestra "segnalare questo crash agli sviluppatori".

...e...

• Dopo l'ultimo aggiornamento automatico a Mozilla Firefox browser 7.01. non riesco più a vedere video promozionali sui siti web. Quando cerco di farlo firefox crasha completamente e devo riavviarlo.

(Questi sono esempi reali. Vi preghiamo di essere accurati)

Invio dei Crashes a Mozilla

Se si sta utilizzando un canale rilascio o beta, la maniera più giusta per sottoporre ad analisi una segnalazione è di inviarla direttamente a Mozilla quando la segnalazione di crash compare. In molti casi non è necessario segnalare il bug anche in Launchpad, specialmente se la segnalazione di crash è già linkata ad una segnalazione upstream su Bugzilla, oppure il crash è già stato sperimentato su un sistema diverso da Ubuntu (es. altre distribuzioni Linux o anche Windows e Mac OS). Se si è certi che il problema si presenta solo su Ubuntu e non è già stato segnalato su upstream Bugzilla (oppure se ritenete che gli sviluppatori Ubuntu ne debbano essere a conoscenza) è possibile aprire un bug in Launchpad.

Nel momento in cui si dovrà segnalare l'anomalia anche in Launchpad si deve anche fornire l' ID della segnalazione fatta, e per cortesia utilizzare Apport.

Per trovare l'ID del crash che avete riportato, andare nel menù Aiuto -> Risoluzione dei problemi e fare clic sul link about:crashes. Ciò si applica sia a Firefox che a Thunderbird.

Nota: Le segnalazioni fatte tramite Apport di Firefox o Thunderbird 13 conterranno automaticamente l'ID della segnalazione fatta su Bugzilla.

Eseguire Firefox in un debugger

Se si sta usando una versione Aurora o Nightly (che hanno il segnalatore di crash disabilitato) si dovrà ottenere la stacktrace manualmente utilizzando gdb. In taluni casi uno sviluppatore potrebbe chiedervi ciò per poter analizzare la stack delle variabili locali, che non sono visibili nell'interfaccia upstream Socorro.

Innanzitutto installare gdb:

 sudo apt-get install gdb

Quindi i necessari simboli di debugging.

Per Firefox:

 sudo apt-get install firefox-dbg

Per Thunderbird:

 sudo apt-get install thunderbird-dbg

Questi altri sono utili per entrambi, per installarli:

 sudo apt-get install libgtk2.0-0-dbg libglib2.0-0-dbg  libx11-6-dbg libpango1.0-0-dbg libc6-dbg

Dopo avere chiuso completamente Firefox, avviare Firefox dal terminale con il comando:

 firefox -g 2>&1 | tee ~/gdb.txt
 (gdb) handle SIG33 pass nostop noprint
 (gdb) set pagination 0
 (gdb) run
... # run and reproduce crash
 (gdb) bt full
 (gdb) thread apply all backtrace full
 (gdb) info registers
 (gdb) quit

1. Ora ~/gdb.txt conterrà le informazioni necessarie a processare la vostra segnalazione. Quindi siete pregati di allegarlo alla segnalazione.

Utilizza e il medesimo procedimento per Thunderbird, sostituendo "firefox" con "thunderbird".

Blocchi o eccessivo uso della CPU

Se Firefox o Thunderbird sembrano completamente bloccati, assieme alla segnalazione è indispensabile fornire anche una stacktrace. In molti casi i blocchi sono casuali e non-riproducibili, quindi non si devono aprire segnalazioni senza queste informazioni.

Se si rileva un eccessivo uso della CPU, provare prima a disabilitare addons e plugins. Se il problema si verifica con Firefox, si stanno per caso visualizzando pagine Flash, con contenuti video, gif animate o altre animazioni? Se non si stanno visualizzando queste, il problema persiste?

Se nessun addons sta causando un eccesivo uso della CPU e non si stanno visualizzando contenuti Flash, allora ci sono ancora un paio di cose da fare per rendere ottimale la segnalazione. Primo ottenere una stacktrace mentre il processo 'fa girare' la CPU. Secondo sarebbe grandioso effettuare una prova anche con uno strumento quele sysprof, che è possibile trovare nel Software Center (vedere Sysprof, System-wide Performance Profiler for Linux).

Alcuni, quando eseguono la segnalazione, eseguono l'applicazione anche in strace per un'anomalia inerente un eccesssivo uso della CPU. In generale l'output di strace non è affatto utile nei casi in cui il processo limita la CPU.

Ottenere una stacktrace da un processo bloccato

Ottenere una stack trace da un processo bloccato è abbastanza semplice. Innanzitutto installare i simboli di debugging come spiegato in Eseguire Firefox in un debugger.

Se il blocco è riproducibile, basta eseguire Firefox o Thunderbird come descritto in Eseguire Firefox in un debuggerRun_Firefox_in_a_Debugger|Run Firefox in a Debugger]] ed ottenere la stacktrace quando l'applicazione si blocca.

Se il blocco non è riproducibile e volete ottenere una stacktrace di un processo già bloccato, è necessario allacciargli gdb. Per fare cio, innanzitutto eseguire:

 pidof firefox

..oppure..

 pidof thunderbird-bin

...per ottenere il PID del processo. Quindi eseguire:

 gdb 2>&1 | tee ~/gdb.txt
 (gdb) handle SIG33 pass nostop noprint
 (gdb) set pagination 0
 (gdb) attach <pid>

...ora si otterrà uno stacktrace come preannunciato (ammesso che il processo fosse realmente bloccato prima dell'allacciamento di gdb)

 (gdb) bt full
 (gdb) thread apply all backtrace full

Se si sta eseguendo il debugging per un eccessivo uso della CPU invece di un blocco, vi peghiamo di eseguire i seguenti passi alcune volte:

 (gdb) continue
...# ora premere CTRL+C per interromperlo ancora
 (gdb) bt full
 (gdb) thread apply all backtrace full

Quindi:

 (gdb) quit

Per cortesia ricordare di allegare i risultanti file alla vostra segnalazione.

Excessivo utilizzo della memoria

Quando si segnala un bug inerente un eccessivo utilizzo della memoria, si deve copiare ed incollare il contenuto di "about:memory" eseguita tramite Apport.

In futuro speriamo di poter rendere automatico questo passaggio.

Si tenga presente che Firefox resta abbastanza coinvolto nel debugging di carenze di memoria. Se vi sentite avventurosi, consultare Debugging memory leaks e Debugging Mozilla with Valgrind

Controllare la consle degli errori

Alcuni bug possono scaturire da eccezioni JS non gestite "unhandled JS exceptions" o altri messaggi d'errore visibili nella console degli errori, e questi ultimi possono fornire un valido indizio sulla causa di un bug. Per visualizzarli, aprire la console degli errori da "Strumenti -> Sviluppo web -> Console degli errori" e selezionare "Errori".

Nota: potrebbe essere necessario abilitare la voce nel menù per poter accedere alla console degli errori. per fare ciò, aprire "about:config" ed impostare "devtools.errorconsole.enabled" su "true"

Altri specifici problemi

Problemi coi menù in un sistema che usa una barra unica per i menù

Per impostazione predefinita, Unity visualizza la barra menù delle applicazioni nel pannello superiore. Anche altri ambienti desktop potrebbero fornire questa funzionalità (un plasmoide KDE fornisce appunto questa funzionalità).

In questo tipo di ambienti i problemi con i menù non sono sempre bug nelle applicazioni.

Se si sperimenta un problema con il contenuto della barra menù, il menù o le sue voci (es. ciò che dice il testo, cosa mostrano le icone o lo stato di un bottone radio o check), questo potrebbe essere segnalato come un bug in un'applicazione (es.Firefox o Thunderbird). Se invece si sperimenta un difetto nelle azioni (es, ciò che succede quando si clicca una voce del menù), anche questo potrebbe essere un bug nell'applicazione.

In generale, qualsiasi problema di visualizzazione della barra menù, menù o suoi componenti (voci o icone) è invece un bug in Unity o inerente applicazione in un diverso ambiente desktop. Alcuni esempi potrebbero essere:

• Allineamento degli elementi nel menù
• Colore o tema dei menù
• Menù che non rispondono correttamente ad un evento (es.sottomenù che non si aprono al passaggio del mouse o suoi componenti che non cambiano colore al passaggio del mouse)
• Menù visualizzati in un posto sbagliato
• Problemi con le dimensioni dei menù
• Menù che non scompaiono quando si clicca in un'altra area dello schermo o menù multipli che appaiono contemporaneamente

In uno dei casi soprariportati si prega di non segnalare l'anomalia contro Firefox o Thundrbird ma contro l'interfaccia in uso (es. Unity).

No context menu available in the global menubar / can't manage bookmarks using the global menubar

When using Unity, there is no context menu in any of the window menus, and the menus do not provide the ability to drag and drop bookmarks to sort them. This is not a bug. Here is an explanation why:

• The menus are not a bookmark editor. Firefox already has a dedicated tool for managing bookmarks
• No other application on the default install provides a context menu in its window menus. Not having one in Firefox improves consistency and removes an element of surprise (ie, when you right click on a menu in another application and realize that it invokes the menuitems action rather than showing a context menu)
• The functionality is not supported by any other components involved with providing the menubar (ie, dbusmenu, unity and even GTK), and so, there isn't any change we could make in Firefox that would add this functionality to the global menubar.

Please don't report this issue as a bug.

The "Open with" dialog does not offer a choice of applications

When downloading a file type that Firefox is unable to view, Firefox presents a dialog that gives you the option of saving the file to disk or opening the file with an application installed on your system ("Open With"). However, "Open With" currently only offers the default handler for the particular file type, and the only way to specify an alternative application is to navigate the filesystem.

This is a Firefox limitation that we're already well aware of. Please don't report new bugs for this problem.

See Bug 18995

"Secure Connection Failed" errors

If you see a warning with the title "Secure Connection Failed" and the text "The certificate is not trusted because the issuer certificate is unknown (Error code: sec_error_unknown_issuer)" when visiting a website with a https URL, then this means that Firefox is not able to chain the websites certificate to a trusted CA.

This could be a problem with the server, or it could be that somebody is impersonating the server. It is generally not a bug with Firefox

If a site provides a certificate signed by an intermediate CA (one which is not in the root store, but with a trust chain to an existing root), the server must provide the intermediate certificates. Failure to do this will result in this error.

For certificates signed by RapidSSL (Geotrust)

On December 9, 2010, Geotrust updated their certificate signing process and all certificates issued after this date require the installation of the RapidSSL intermediate on the server. Some sites forget to do this, which results in this error. This is a bug with the website

See http://blog.clickssl.com/2010/12/rapidssl-error-on-firefox-this-connection-is-untrusted/

This online validation tool can tell you which intermediate a server is missing

Requests for inclusion of new CA's

In some cases when experiencing "unknown issuer" errors when visiting certain sites, it may be tempting to open a bug report to request that the issuer CA is added to the root store shipped with Firefox. Doing this would defeat the whole trust system. There is a well defined process for CA's to request that their certificate(s) be added and be shipped with Firefox. Details of this can be found at https://wiki.mozilla.org/CA:How_to_apply

We will not bypass this process under any circumstances, so please make these types of requests. Requests of this type will be rejected.

Problems launching external applications

Ubuntu ships an Apparmor profile with Firefox, but this is disabled by default. If you have problems opening files in external applications from Firefox, or problems with extensions which need to start external helpers, then please make sure that the Apparmor profile is disabled or in complain mode before reporting a bug.

To make sure that the profile is not in enforce mode, run sudo aa-status. You will see output which looks a bit like this:

apparmor module is loaded.
18 profiles are loaded.
18 profiles are in enforce mode.
   /sbin/dhclient
   /usr/bin/evince
   /usr/bin/evince-previewer
   /usr/bin/evince-thumbnailer
   /usr/lib/NetworkManager/nm-dhcp-client.action
   /usr/lib/connman/scripts/dhclient-script
   /usr/lib/cups/backend/cups-pdf
   /usr/lib/firefox-7.0.1/firefox{,*[^s][^h]}
   /usr/lib/firefox-7.0.1/firefox{,*[^s][^h]}//browser_java
   /usr/lib/firefox-7.0.1/firefox{,*[^s][^h]}//browser_openjdk
   /usr/lib/lightdm/lightdm-guest-session-wrapper
   /usr/lib/telepathy/mission-control-5
   /usr/lib/telepathy/telepathy-*
   /usr/sbin/cupsd
   /usr/sbin/dhcpd3
   /usr/sbin/mysqld-akonadi
   /usr/sbin/tcpdump
   /usr/share/gdm/guest-session/Xsession
0 profiles are in complain mode.
6 processes have profiles defined.
6 processes are in enforce mode.
   /sbin/dhclient (7094)
   /usr/lib/telepathy/mission-control-5 (2397)
   /usr/lib/telepathy/telepathy-* (4975)
   /usr/lib/telepathy/telepathy-* (7101)
   /usr/lib/telepathy/telepathy-* (7102)
   /usr/sbin/cupsd (1210)
0 processes are in complain mode.
0 processes are unconfined but have a profile defined.

If there are entries starting with "/usr/lib/firefox" in the section "profiles are in enforce mode", then the Firefox profile has been enabled and set to enforce mode. In this case, please set it to complain mode and try again. To do this, please run sudo aa-complain /usr/bin/firefox. (Note, you will need to install apparmor-utils to do this)

If this works and the particular executable is from a software package in the Ubuntu archive, then we may consider adding an exception to the Apparmor profile. In this case, please report a bug using Apport. If the executable is from 3rd party software outside of the Ubuntu archive, then you will need to either keep the Apparmor profile disabled, or add an exception locally in /etc/apparmor.d/local/usr.bin.firefox.

See AppArmor

"The bookmarks and history system will not be functional"

If you see this error when starting Firefox and you are unable to access or modify your bookmarks, please take a look at this support article: The bookmarks and history system will not be functional.

This is not usually a bug, but is normally caused by a corrupt places.sqlite or broken permissions in your profile folder. Please don't report a bug about this, unless you are unable to resolve the issue by following the steps in the support article.

XML errors and broken UI after upgrade

After each release, some of our users report bugs that look a bit like this:

 XML Parsing Error: error in processing external entity reference
 Location: jar:file:///usr/lib/firefox/chrome/toolkit.jar!/content/global/netError.xhtml
 Line Number 10, Column 3:  %netErrorDTD;
--^

Other symptoms include missing UI elements after an upgrade or other kinds of XML errors in dialogue boxes or on firefox's stderr.

This is one of the things that typically happens if you don't restart your Firefox after an upgrade. Please do not report this as a bug. There is already a bug report open about this.

Closed Bug Reports

If you find your bug report to be closed, it has been done by someone on our team for specific reasons. If you have a problem or wish to dispute the action, please use the bug report to ask for more information.

Bug Triage and Procedures

Visit BugProcedures for an Introduction and best practices on how to process Mozilla bugs.

CategoryMozillaTeam, CategoryBugSquad, CategoryDebugging