blob: 164bf71149fdf2e6ad099b45196cbd6d1d8347cc [file] [log] [blame]
Mauro Carvalho Chehab609d99a2016-09-19 08:07:56 -03001.. _securitybugs:
2
Mauro Carvalho Chehab1d7078d2016-09-19 08:07:49 -03003Security bugs
4=============
5
Linus Torvalds1da177e2005-04-16 15:20:36 -07006Linux kernel developers take security very seriously. As such, we'd
7like to know when a security bug is found so that it can be fixed and
8disclosed as quickly as possible. Please report security bugs to the
9Linux kernel security team.
10
Mauro Carvalho Chehab9d850252016-09-21 09:51:11 -030011Contact
12-------
Linus Torvalds1da177e2005-04-16 15:20:36 -070013
14The Linux kernel security team can be contacted by email at
15<security@kernel.org>. This is a private list of security officers
16who will help verify the bug report and develop and release a fix.
Kees Cook49978be2017-03-06 11:13:51 -080017If you already have a fix, please include it with your report, as
18that can speed up the process considerably. It is possible that the
19security team will bring in extra help from area maintainers to
20understand and fix the security vulnerability.
Linus Torvalds1da177e2005-04-16 15:20:36 -070021
22As it is with any bug, the more information provided the easier it
23will be to diagnose and fix. Please review the procedure outlined in
Kees Cook49978be2017-03-06 11:13:51 -080024admin-guide/reporting-bugs.rst if you are unclear about what
25information is helpful. Any exploit code is very helpful and will not
26be released without consent from the reporter unless it has already been
27made public.
Linus Torvalds1da177e2005-04-16 15:20:36 -070028
Will Deacon14fdc2c2018-10-22 16:39:01 +010029Disclosure and embargoed information
30------------------------------------
Linus Torvalds1da177e2005-04-16 15:20:36 -070031
Will Deacon14fdc2c2018-10-22 16:39:01 +010032The security list is not a disclosure channel. For that, see Coordination
33below.
Dave Hansen7f5d4652018-03-07 13:46:24 -080034
Will Deacon14fdc2c2018-10-22 16:39:01 +010035Once a robust fix has been developed, our preference is to release the
36fix in a timely fashion, treating it no differently than any of the other
37thousands of changes and fixes the Linux kernel project releases every
38month.
39
40However, at the request of the reporter, we will postpone releasing the
41fix for up to 5 business days after the date of the report or after the
42embargo has lifted; whichever comes first. The only exception to that
43rule is if the bug is publicly known, in which case the preference is to
44release the fix as soon as it's available.
45
46Whilst embargoed information may be shared with trusted individuals in
47order to develop a fix, such information will not be published alongside
48the fix or on any other disclosure channel without the permission of the
49reporter. This includes but is not limited to the original bug report
50and followup discussions (if any), exploits, CVE information or the
51identity of the reporter.
52
53In other words our only interest is in getting bugs fixed. All other
54information submitted to the security list and any followup discussions
55of the report are treated confidentially even after the embargo has been
56lifted, in perpetuity.
Linus Torvalds1da177e2005-04-16 15:20:36 -070057
Kees Cook49978be2017-03-06 11:13:51 -080058Coordination
59------------
60
61Fixes for sensitive bugs, such as those that might lead to privilege
62escalations, may need to be coordinated with the private
63<linux-distros@vs.openwall.org> mailing list so that distribution vendors
64are well prepared to issue a fixed kernel upon public disclosure of the
65upstream fix. Distros will need some time to test the proposed patch and
66will generally request at least a few days of embargo, and vendor update
67publication prefers to happen Tuesday through Thursday. When appropriate,
68the security team can assist with this coordination, or the reporter can
69include linux-distros from the start. In this case, remember to prefix
70the email Subject line with "[vs]" as described in the linux-distros wiki:
71<http://oss-security.openwall.org/wiki/mailing-lists/distros#how-to-use-the-lists>
72
73CVE assignment
74--------------
75
76The security team does not normally assign CVEs, nor do we require them
77for reports or fixes, as this can needlessly complicate the process and
78may delay the bug handling. If a reporter wishes to have a CVE identifier
79assigned ahead of public disclosure, they will need to contact the private
80linux-distros list, described above. When such a CVE identifier is known
81before a patch is provided, it is desirable to mention it in the commit
Will Deacon14fdc2c2018-10-22 16:39:01 +010082message if the reporter agrees.
Kees Cook49978be2017-03-06 11:13:51 -080083
Mauro Carvalho Chehab9d850252016-09-21 09:51:11 -030084Non-disclosure agreements
85-------------------------
Linus Torvalds1da177e2005-04-16 15:20:36 -070086
87The Linux kernel security team is not a formal body and therefore unable
88to enter any non-disclosure agreements.