diff options
Diffstat (limited to 'REPORTING-BUGS')
-rw-r--r-- | REPORTING-BUGS | 43 |
1 files changed, 22 insertions, 21 deletions
diff --git a/REPORTING-BUGS b/REPORTING-BUGS index 55a6074ccbb7..ad709e4ccb7c 100644 --- a/REPORTING-BUGS +++ b/REPORTING-BUGS | |||
@@ -1,30 +1,31 @@ | |||
1 | [Some of this is taken from Frohwalt Egerer's original linux-kernel FAQ] | 1 | [Some of this is taken from Frohwalt Egerer's original linux-kernel FAQ] |
2 | 2 | ||
3 | What follows is a suggested procedure for reporting Linux bugs. You | 3 | What follows is a suggested procedure for reporting Linux bugs. You aren't |
4 | aren't obliged to use the bug reporting format, it is provided as a guide | 4 | obliged to use the bug reporting format, it is provided as a guide to the |
5 | to the kind of information that can be useful to developers - no more. | 5 | kind of information that can be useful to developers - no more. |
6 | 6 | ||
7 | If the failure includes an "OOPS:" type message in your log or on | 7 | If the failure includes an "OOPS:" type message in your log or on screen |
8 | screen please read "Documentation/oops-tracing.txt" before posting your | 8 | please read "Documentation/oops-tracing.txt" before posting your bug |
9 | bug report. This explains what you should do with the "Oops" information | 9 | report. This explains what you should do with the "Oops" information to |
10 | to make it useful to the recipient. | 10 | make it useful to the recipient. |
11 | |||
12 | Send the output to the maintainer of the kernel area that seems to be | ||
13 | involved with the problem, and cc the relevant mailing list. Don't worry | ||
14 | too much about getting the wrong person. If you are unsure send it to the | ||
15 | person responsible for the code relevant to what you were doing. If it | ||
16 | occurs repeatably try and describe how to recreate it. That is worth even | ||
17 | more than the oops itself. The list of maintainers and mailing lists is | ||
18 | in the MAINTAINERS file in this directory. If you know the file name that | ||
19 | causes the problem you can use the following command in this directory to | ||
20 | find some of the maintainers of that file: | ||
11 | 21 | ||
12 | Send the output to the maintainer of the kernel area that seems to | ||
13 | be involved with the problem, and cc the relevant mailing list. Don't | ||
14 | worry too much about getting the wrong person. If you are unsure send it | ||
15 | to the person responsible for the code relevant to what you were doing. | ||
16 | If it occurs repeatably try and describe how to recreate it. That is | ||
17 | worth even more than the oops itself. The list of maintainers and | ||
18 | mailing lists is in the MAINTAINERS file in this directory. If you | ||
19 | know the file name that causes the problem you can use the following | ||
20 | command in this directory to find some of the maintainers of that file: | ||
21 | perl scripts/get_maintainer.pl -f <filename> | 22 | perl scripts/get_maintainer.pl -f <filename> |
22 | 23 | ||
23 | If it is a security bug, please copy the Security Contact listed | 24 | If it is a security bug, please copy the Security Contact listed in the |
24 | in the MAINTAINERS file. They can help coordinate bugfix and disclosure. | 25 | MAINTAINERS file. They can help coordinate bugfix and disclosure. See |
25 | See Documentation/SecurityBugs for more information. | 26 | Documentation/SecurityBugs for more information. |
26 | 27 | ||
27 | If you are totally stumped as to whom to send the report, send it to | 28 | If you are totally stumped as to whom to send the report, send it to |
28 | linux-kernel@vger.kernel.org. (For more information on the linux-kernel | 29 | linux-kernel@vger.kernel.org. (For more information on the linux-kernel |
29 | mailing list see http://www.tux.org/lkml/). | 30 | mailing list see http://www.tux.org/lkml/). |
30 | 31 | ||
@@ -33,7 +34,7 @@ list. Having a standardized bug report form makes it easier for you not to | |||
33 | overlook things, and easier for the developers to find the pieces of | 34 | overlook things, and easier for the developers to find the pieces of |
34 | information they're really interested in. Don't feel you have to follow it. | 35 | information they're really interested in. Don't feel you have to follow it. |
35 | 36 | ||
36 | First run the ver_linux script included as scripts/ver_linux, which | 37 | First run the ver_linux script included as scripts/ver_linux, which |
37 | reports the version of some important subsystems. Run this script with | 38 | reports the version of some important subsystems. Run this script with |
38 | the command "sh scripts/ver_linux". | 39 | the command "sh scripts/ver_linux". |
39 | 40 | ||