Thunderbird:Testing:Shutdown Hang: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
If you close, shut down or exit Thunderbird and it is still running, then you have a shutdown hang. But you shouldn't just report with no additional information, because there are many causes and symptoms for hangs.  
If you close, shut down or exit Thunderbird and it is still running, then you have a shutdown hang. But you shouldn't just report the issue with no detailed information, because there are many causes and symptoms for hangs.  


= Symptoms =
= Symptoms =


So it is helpful to  
To be most helpful, you will want to  
* '''describe the environment'''  
* '''describe the environment'''  
* '''obtain a stacktrace'''
* '''obtain a hang stacktrace'''
* '''determine steps to reproduce''', a sequence of steps that occur '''before''' you shut down
* '''determine steps to reproduce''', a sequence of steps that occur '''before''' you shut down
It is important that you provide as much of information as possible, and state how often you see the hang (always, rarely, etc).


'''Describe the environment''' - Answer these easy questions in a bug report:
'''Describe the environment''' - Answer these easy questions in a bug report:
# Operating system, version, and Thunderbird version
# Operating system and version, and Thunderbird version
# Does Thunderbird hang started in [https://support.mozillamessaging.com/en-US/kb/Safe+Mode safe mode]? If it can't be reproduced in safe mode then the problem could be an extension, and you will want to experiment by disabling add-ons until you find the add-on causing the problem, then contact the add-on author.
# How often you see the hang (always, rarely, etc)?
# Does Thunderbird hang when started in [https://support.mozillamessaging.com/en-US/kb/Safe+Mode safe mode]? If it doesn't hang in safe mode then the problem could be an extension, and you will want to experiment by disabling add-ons until you find which add-on is causing the problem, then contact the add-on author.
#* does hang happen without calendar/lightning extension? ({{Bug|532435}})
#* does hang happen without calendar/lightning extension? ({{Bug|532435}})
# Does Thunderbird hang with [[Thunderbird:Testing:Antivirus_Related_Performance_Issues|firewall or antivirus software]] disabled? If it does not, then the problem is with that software, not Thunderbird.
# Does Thunderbird hang with [[Thunderbird:Testing:Antivirus_Related_Performance_Issues|firewall or antivirus software]] disabled? If it does not, then the problem is with that software, not Thunderbird.
# CPU usage - is usage high (pegged), zero, low, or other?
# CPU usage - is usage high (maxed or pegged), zero, low, or other?
# run netstat - any thunderbird connections to ldap, imap mail server, or other protocols?
# run netstat - any thunderbird connections to ldap, imap mail server, or other protocols?
#* MS-Windows in a dos command window, do netstat -a -b -o) - are
#* MS-Windows: in a dos command window, do netstat -a -b -o
#* linux, do netstat -tp grep -i thunderbird  
#* linux/Mac: do netstat -tp | grep -i thunderbird  
# Is gloda indexing enabled or disabled? (Tools|Options|Advanced|General)
# Is gloda indexing enabled or disabled? (Tools|Options|Advanced|General)
# Are your mail accounts pop, imap, or a combination?
# Are your mail accounts pop, imap, or a combination?
Line 25: Line 24:
# If imap connections are shown in the netstat results above and if needed by the devoloper, get an [[MailNews:Logging|imap:5 log]] in a log file, which can be attached to a bug report
# If imap connections are shown in the netstat results above and if needed by the devoloper, get an [[MailNews:Logging|imap:5 log]] in a log file, which can be attached to a bug report


'''To recap, you should concisely report: OS & Thunderbird version, safe mode, cpu, netstat results, indexing on or off, pop or imap account types, sleep/hibernate usage, online/offline usage'''
:To recap, please concisely report: OS & Thunderbird version, frequency, safe mode results, cpu, netstat results, indexing on or off, pop or imap account types, sleep/hibernate usage, online/offline usage


'''Obtain a stacktrace''' - If you can, please :
'''Obtain a hang stacktrace''' - If you can, please get a stacktrace using _'''hang'''_ instructions in these references, then attach stacktrace file to a bug report. Anywhere you see "Firefox" in the instructions, please substitute "Thunderbird".
* Get a stacktrace using _'''hang'''_ instructions in these references.  The stacktrace file can then be attached to a bug report.  
* Windows: [https://developer.mozilla.org/en/How_to_get_a_stacktrace_with_WinDbg] and use '''!analyze -v -hang''' instead of !analyze -v -f
** [https://developer.mozilla.org/En/How_to_get_a_stacktrace_for_a_bug_report How_to_get_a_stacktrace_for_a_bug_report]
* Mac: [[Thunderbird:Testing:Get_A_Debug_Thunderbird_Hang_Stack]]
** [[Thunderbird:Testing:Get_A_Debug_Thunderbird_Hang_Stack]]
* Linux: [https://developer.mozilla.org/En/How_to_get_a_stacktrace_for_a_bug_report#Alternative_ways_to_get_a_stacktrace]


'''Steps to reproduce''' - Please determine if there is a list of steps (1. first step, 2. second step, ...) which seem to cause the hang. This would be things you see and a sequence of steps that occur '''before''' you shut down. Often there isn't a single set of steps or a set of steps that cause the hang every time.  So you may need to experiment and test to determine steps. Because it is not always possible to determine steps, it is important is that you at least have all the other details listed above.
'''Steps to reproduce''' - Please determine if there is a list of steps  
:1. first step
:2. second step
:3. ...
which seem to cause the hang. This would be the things you see and a sequence of actions you do just '''before''' you shut down. You may need to experiment and test to find steps that seem reliable. But if you can't seem to find a unique set of steps, don't let that stop you from looking at the bug list or filing a bug report, because the environment information you have collected from the list above may be sufficient to identify the cause.


= Bugs =
= Bugs =


Filing a bug : If none of the '''bugs mentioned below''' fit your symptoms, please [https://bugzilla.mozilla.org/enter_bug.cgi?product=Thunderbird file a bug] and include all the information obtained in the steps above.
You might check the '''bugs mentioned below''' to see which fit your symptoms. If none match your symptoms please [https://bugzilla.mozilla.org/enter_bug.cgi?product=Thunderbird file a bug] and include all the information requested above.


'''All bugs: [http://bit.ly/bUY5HM Bugzilla query - open, invalid and fixed bugs from the beginning of time]'''
'''All hang bugs: [http://bit.ly/bUY5HM Bugzilla query - open, invalid and fixed bugs from the beginning of time]'''
<!-- see "shutdown hang" query at [[Thunderbird:Bug_Queries]] -->
<!-- see "shutdown hang" query at [[Thunderbird:Bug_Queries]] -->


'''Open bugs:'''
'''Open hang bugs:'''
* sort the bugzilla query above by status
* Click the Status column label of the bugzilla query link above to show bugs in Status order
* selected open bugs  
* selected open bugs  
** {{Bug|479373}} Hang on shutdown if there are outstanding SSL requests
** {{Bug|479373}} Hang on shutdown if there are outstanding SSL requests

Revision as of 21:53, 13 October 2010

If you close, shut down or exit Thunderbird and it is still running, then you have a shutdown hang. But you shouldn't just report the issue with no detailed information, because there are many causes and symptoms for hangs.

Symptoms

To be most helpful, you will want to

  • describe the environment
  • obtain a hang stacktrace
  • determine steps to reproduce, a sequence of steps that occur before you shut down

Describe the environment - Answer these easy questions in a bug report:

  1. Operating system and version, and Thunderbird version
  2. How often you see the hang (always, rarely, etc)?
  3. Does Thunderbird hang when started in safe mode? If it doesn't hang in safe mode then the problem could be an extension, and you will want to experiment by disabling add-ons until you find which add-on is causing the problem, then contact the add-on author.
    • does hang happen without calendar/lightning extension? (bug 532435)
  4. Does Thunderbird hang with firewall or antivirus software disabled? If it does not, then the problem is with that software, not Thunderbird.
  5. CPU usage - is usage high (maxed or pegged), zero, low, or other?
  6. run netstat - any thunderbird connections to ldap, imap mail server, or other protocols?
    • MS-Windows: in a dos command window, do netstat -a -b -o
    • linux/Mac: do netstat -tp | grep -i thunderbird
  7. Is gloda indexing enabled or disabled? (Tools|Options|Advanced|General)
  8. Are your mail accounts pop, imap, or a combination?
  9. Did the computer go into sleep or hibernate while Thunderbird was running?
  10. Was online or offline used, either via your explicit action, or automatically due to a dropped network connection?
  11. If imap connections are shown in the netstat results above and if needed by the devoloper, get an imap:5 log in a log file, which can be attached to a bug report
To recap, please concisely report: OS & Thunderbird version, frequency, safe mode results, cpu, netstat results, indexing on or off, pop or imap account types, sleep/hibernate usage, online/offline usage

Obtain a hang stacktrace - If you can, please get a stacktrace using _hang_ instructions in these references, then attach stacktrace file to a bug report. Anywhere you see "Firefox" in the instructions, please substitute "Thunderbird".

Steps to reproduce - Please determine if there is a list of steps

1. first step
2. second step
3. ...

which seem to cause the hang. This would be the things you see and a sequence of actions you do just before you shut down. You may need to experiment and test to find steps that seem reliable. But if you can't seem to find a unique set of steps, don't let that stop you from looking at the bug list or filing a bug report, because the environment information you have collected from the list above may be sufficient to identify the cause.

Bugs

You might check the bugs mentioned below to see which fit your symptoms. If none match your symptoms please file a bug and include all the information requested above.

All hang bugs: Bugzilla query - open, invalid and fixed bugs from the beginning of time

Open hang bugs:

  • Click the Status column label of the bugzilla query link above to show bugs in Status order
  • selected open bugs
    • bug 479373 Hang on shutdown if there are outstanding SSL requests
    • bug 508263 3.0b3 hangs on exit/shutdown with high cpu, no imap connections [Mac only?] [speculation: losing the network connection/sleeping]

References:

Fixed bugs in version 3 (most recent at top):

  • bug 494014 shutdown hang, high cpu, no open imap connections
  • bug 497598 hang on shutdown appending msg to imap folder via a filter
  • bug 487965 hang on shutdown with open imap connections and zero cpu
  • bug 420744 Shutdown fails with 100% cpu load when auto-complete over LDAP
  • bug 495551 hang on shutdown, zero cpu, few (1-2) imap connections - from imap url initiated during shutdown (modal alert from imap thread / proxy call to UI thread)
  • bug 516388 Hang when exiting Archives smart folder is used
  • bug 497059 Hang with unreliable wifi connection, either when re-connecting to email server, or on shutdown

Hangs caused by other software

  • bug 532435 Thunderbird 3.0RC 2 does not quit, high cpu, no imap connection and must be killed - with enigmail error [caused by Engimail]
  • and see INVALID bugs in the bugzilla query above