summaryrefslogtreecommitdiffstats
path: root/chromium/docs/website/site/for-testers/bug-reporting-guidelines/hanging-tabs/index.md
blob: 6b9131aab9001c44189294e88cf7040e293048a9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
---
breadcrumbs:
- - /for-testers
  - For Testers
- - /for-testers/bug-reporting-guidelines
  - Bug Life Cycle and Reporting Guidelines
page_name: hanging-tabs
title: Reporting a Hang Bug
---

To investigate problems when Chrome is frozen/locked-up/unresponsive, we
generally need a dump of the affected processes.

Exactly how to do this depends on your operating system:

## Windows

1.  [Download Process Explorer from
            Microsoft](http://technet.microsoft.com/en-us/sysinternals/bb896653).
            (This tool is like a more advanced version of the Task Manager; we
            will use it to create minidumps).
2.  Extract and launch Process Explorer
3.  Right click on the hung Chrome process, and choose "Create Dump"
            --> "Create Minidump..." (If you aren't sure which one is
            misbehaving, repeat this step for each Chrome process)
4.  Attach the minidump file(s) to your bug report

Please note that minidump files can contain some information about your
computer, including the path to where Chrome is installed.

## Mac

1.  Verify you've turned crash reporting on. Go to the page
            chrome://settings/advanced using the address bar. Then verify that
            **Automatically send usage statistics and crash reports to Google**
            is checked.
2.  Open the Task Manager under the **Wrench menu > Tools > Task
            Manager**.
3.  If the columns at the top of the Task Manager window do not include
            "Process ID", then right-click on the table header and check the
            "Process ID" box.
4.  Note the process ID of the hung tab.
5.  Kill the process in a way that causes it to print a crash dump:

*   Open a terminal window and `kill -ABRT *<ProcessID>*` where
            `*<ProcessID>*` is the one you noted above. Copy and paste the crash
            ID dumped to the console into your bug:
    *   You can additionally find the crash dump in
                ~/Library/Application Support/Google/Chrome/Crash Reports/

## Linux

1.  Depending on your sandboxing configuration and Chrome version, you
            may need to pass "--allow-sandbox-debugging" when starting Chrome
            (see [this bug](http://crbug.com/169369)).
2.  Verify you've turned crash reporting on. Go to the page
            chrome://settings/advanced using the address bar. Then verify that
            **Automatically send usage statistics and crash reports to Google**
            is checked.
3.  Open the Task Manager under the **Wrench menu &gt; Tools &gt; Task
            Manager**.
4.  If the columns at the top of the Task Manager window do not include
            "Process ID", then right-click on the window and check the "Process
            ID" box.
5.  Note the process ID of the hung tab.
6.  Kill the process in a way that causes it to print a crash dump:

*   Open a terminal window and `kill -SEGV *<ProcessID>*` where
            `*<ProcessID>*` is the one you noted above. Copy and paste the crash
            ID dumped to the console into your bug:
    *   You can find the crash dump in your `~/.xsession-errors` file
                (assuming you didn't launch Chromium from a terminal yourself)