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 descrivere l'anomalia (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 digitare 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 peghiamo di avviare segnalazioni di anomalie in Firefox o Thunderbird utilizzando l'iterfaccia Launchpad. Nella maggior parte dei casi non sarano presi in considerazioni e sarannno chiusi 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 nascostein 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

Assicuratevi che lo sviluppatore possa riprodurre l'anomalia. Fornite ogni dettaglio possibile riguardante il bug, in particolare una sequenza esplicita delle azioni da compiere per riprodurre il bug. 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 un a soluzione temporanea.

Problemi con uno specifico sito web

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

• 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 ptrebbe non sapere come dovrebbe apparire 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 corretamene, 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, aleegare uno screenshot di come dovrebbe apparire.

Crash

Alcune cose da considerare

Per cortesia evitare il presupposto che se avete sperimentato un crash, anche 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 appare. 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 versdione Aurora o Nightly (che hanno il segnalatore di crash disabilitato) si dovrà ottenere la stacktrace manualmente utilizzando gdb. In taluni casi unio 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".

Hangs, or excessive CPU usage

If Firefox or Thunderbird appears to completely lock up, you must provide a stacktrace of the hung process with your bug report. In most cases, hangs are quite random and non-reproducible, so please don't submit reports without this information.

If it appears to be using excessive CPU, please first try disabling addons and plugins. If the problem is with Firefox, are you viewing pages with Flash or video content, animated gif's or other animations? Does the problem stop when you no longer view these?

If none of your addons are causing excessive CPU usage, and you're not viewing videos or Flash content, then there are a couple of things you can do to make your bug report more useful. First, please get a stacktrace whilst the process is spinning the CPU. Secondly, it would be great if you could try to use something like sysprof, which is available in the Software Center (see Sysprof, System-wide Performance Profiler for Linux

Some people also run the application in strace when reporting issues with excessive CPU usage. In general, the output of strace is not all that useful when debugging an issue where the process is CPU bound.

Getting a stacktrace of a hung process

Getting a stacktrace of a hung process is quite easy. First, please install gdb and the required debugging symbols as advised in Run Firefox in a Debugger.

If the hang is reproducible, just run Firefox or Thunderbird as described in Run Firefox in a Debugger and get a stacktrace when the application has hung.

If the hang is not reproducible and you want to get a stacktrace of an already hung process, you will need to attach gdb to it. To do this, first run:

 pidof firefox

..or..

 pidof thunderbird-bin

...to get the PID of the process. Then do:

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

...now you can get a stacktrace as advised below (assuming the process was hung before attaching gdb)

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

If you're debugging excessive CPU rather than a hang, please repeat the following steps a few times:

 (gdb) continue
...# now press CTRL+C to interrupt it again
 (gdb) bt full
 (gdb) thread apply all backtrace full

Then:

 (gdb) quit

Please remember to attach the resulting file to your bug report.

Excessive memory usage

If you are reporting a bug about excessive memory usage, you must copy and paste the contents of "about:memory" in to your bug report, once you have reported this with Apport.

In the future, we hope to automate this step.

Note that debugging memory leaks in Firefox is quite involved. If you're feeling adventurous, please take a look at Debugging memory leaks and Debugging Mozilla with Valgrind

Check the Error Console

Some bugs may result in unhandled JS exceptions or other error messages being logged to the error console, and these may provide a strong clue as to the cause of a bug. To view these, open the error console from "Tools -> Web Developer -> Error Console", and select "Errors".

Note, you many need to enable the menuitem to access the error console. To do this, open "about:config", and set "devtools.errorconsole.enabled" to "true"

Other specific issues

Problems with menus on systems that use a global menubar

By default, the unity shell shipped in Ubuntu 11.04 and newer displays application menubars in the top panel. Some other desktop environments may also provide similar functionality (there is a plasmoid for KDE which does this).

In these environments, problems with the menus are not always an application bug.

If you experience an issue with the content of the menubar, menus or menuitems (ie, what the actual text says, what the icons display or the state of any radio or check items), then this should be reported as an application bug (against Firefox or Thunderbird). If you experience an issue with actions (ie, what happens when you click on a menuitem), then this might be an application bug too.

In general, any problem with the view of the menubar, menus or menuitems is normally a bug with the desktop shell instead. Examples of this might include:

• Alignment of elements in the menu
• Colour or theming of the menus
• Menus not responding correctly to events (ie, submenus not opening on mouseover or menuitems not highlighting on mouseover)
• Menus appearing in the wrong place
• Menus appearing behind windows
• Problems with how large menus overflow
• Menus not hiding when clicking on another area of the screen, or multiple menus appearing at the same time

If you have an issue like any of the above, please don't report a bug against Firefox or Thunderbird. You should report a bug against the particular desktop shell you are using instead (ie, 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