From patchwork Wed Feb 14 08:00:30 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Greg KH X-Patchwork-Id: 200857 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:bc8a:b0:106:860b:bbdd with SMTP id dn10csp1055991dyb; Wed, 14 Feb 2024 00:02:04 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCX6l3pfMCeS2OiPIVzw1RLTf+dWJnst4t9rtHwyWLOciictAjVCpYUaNL8m+8e1FowKGfW7CvHcNj8HCTYqcAWlz4+slA== X-Google-Smtp-Source: AGHT+IGCmUjY3BA9noZDjGfAEGI79ub3kn0tC/VIyvdlYdRH0/iMPa7yrEGK6P8BrNbat1u8BzKH X-Received: by 2002:a05:6870:3312:b0:219:7915:e995 with SMTP id x18-20020a056870331200b002197915e995mr1907644oae.19.1707897724458; Wed, 14 Feb 2024 00:02:04 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1707897724; cv=pass; d=google.com; s=arc-20160816; b=PNDxlWodZH7fTraSoGqKg0EqxPh2EesMeTFFbQZx4ZvQsXICpaOGlqpMDh0MrC4Mi+ fn3yH9qz/51LVekOupx7gHBwoxxNQHaTTr5xqsbjJRaHoqtKK0aRZdL1Uz9LG6ZO+Fer HhIhcwypv4TCtKCNPaS9Oa3YUhrdQR81309C2fMgeHsz968tXspsZcwBXN+F5miYjujp od4VxIASjDLksj0OazKlYl8/qxyQqqGc0XNbPVwjWnhFHyn/TACQiZS33RdgvV5Ce658 FE8C5hnqnQTFLacqzFswiJU5qeSfNCP/CGat42OiLNa8t2FQ3WMdFozL8rkzv2wlxKMS K5+Q== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:lines:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=rTxRH3wmnnoqP5WpiEIplEtDSxhLN+T9WMI4UaKSxsU=; fh=eru68CqPqqR2ViGcxGQPqMDpA7ovdOYA4x+NRq56NkU=; b=oemwRZx0Xn+AK+t8kCoOGSJ4GkZG++Y+Um0/ivdedF+gWB9Fa1Bnk0EmO7TWyo1prW zOY6aE47o088uWItUigUctnbFhzn2QaCAahJ722/NwDu9211YxDN+ebVXyFCKCW6tNTR uLqwrkIQL+QqxLhlOP+5I25DGRX6JWy7XB9O9cS01H1nzK7lRJ1VgjiZfCgYT4eenroi 2HuDXYmegMXOgFUNNvk5SH5apjf+04Z1NR62AOHr6j3cvEshIFIopJHIbdZigxx6YMOP QHuF0k3gVJI0msb0bM4Yr5039gFmrNUUftdzkS1e/5G8HXl2XkJihjX/NPoNlVsp3C4F 67FA==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@linuxfoundation.org header.s=korg header.b="XGOvXL/8"; arc=pass (i=1 dkim=pass dkdomain=linuxfoundation.org); spf=pass (google.com: domain of linux-kernel+bounces-64852-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-64852-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linuxfoundation.org X-Forwarded-Encrypted: i=2; AJvYcCXAMIJBt6ognMFGxabvl90e3m7qtdTEf2njx7eg0uV7ak6NJkUQraBC3OPbyw4We9IJh3QSoym7QXHnMn/HcLK05WMJvg== Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [2604:1380:45d1:ec00::1]) by mx.google.com with ESMTPS id vu9-20020a05620a560900b007835218c6f3si9839942qkn.230.2024.02.14.00.02.04 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 14 Feb 2024 00:02:04 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-64852-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@linuxfoundation.org header.s=korg header.b="XGOvXL/8"; arc=pass (i=1 dkim=pass dkdomain=linuxfoundation.org); spf=pass (google.com: domain of linux-kernel+bounces-64852-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-64852-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linuxfoundation.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id 0A18C1C2724C for ; Wed, 14 Feb 2024 08:01:20 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 3BD7012E73; Wed, 14 Feb 2024 08:00:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linuxfoundation.org header.i=@linuxfoundation.org header.b="XGOvXL/8" Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A01CF12E43; Wed, 14 Feb 2024 08:00:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1707897639; cv=none; b=t92wYzKppPbNOgympaA8QMu2Bu6JyEk8PEbADrYhAKg5GLzE11ndeM8PvhISH/Vo1H28pLJ0E6L7hhYU2muUCMhbCZx0qcs9Zu6BphRxzDlRyDW07Xagw0t7jtYiFrHYcUWS1goWthP2twPYNyXupLw9s+6M/4sBrHPKxYRSW0M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1707897639; c=relaxed/simple; bh=FmvLaKNhnIFQSuhbWRcDujMa+s+t+I+o5kK0EywbO78=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=gLGygs031uok+IpN9jCiHsRpqHjUKOef8lk+LktU9qyCfFEj1GHLFnXpdDK7uY9BLtJQf3gytc11KGiB6otl3TSGK3JpMvFxiFUeVO3UlPzrofRKNjXSLZekbqPKknELDiSBnBZeMaMk59Jhcspju/MjJf/nNFrszyT8ahe+JDk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linuxfoundation.org header.i=@linuxfoundation.org header.b=XGOvXL/8; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 8F5ECC43394; Wed, 14 Feb 2024 08:00:38 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=linuxfoundation.org; s=korg; t=1707897639; bh=FmvLaKNhnIFQSuhbWRcDujMa+s+t+I+o5kK0EywbO78=; h=From:To:Cc:Subject:Date:From; b=XGOvXL/8iOjG1X58cQE/qDUHLGF/1cHQjE1e3f4SAdQWodf1imzAnGjl/c8XqFmGM PpuuwwcsvjQr5uTYtmtR/2DWsLdNYSVyifU0EhHOpZsYM4g+QRnJ3VHG3PrgmfmeQw BZsouhEhW13Nf15KhFQpwwgWw7phgcFc+MB57FPE= From: Greg Kroah-Hartman To: corbet@lwn.net, workflows@vger.kernel.org Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, security@kernel.org, Greg Kroah-Hartman , Kees Cook , Sasha Levin , Lee Jones Subject: [PATCH v3] Documentation: Document the Linux Kernel CVE process Date: Wed, 14 Feb 2024 09:00:30 +0100 Message-ID: <2024021430-blanching-spotter-c7c8@gregkh> X-Mailer: git-send-email 2.43.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Lines: 179 X-Developer-Signature: v=1; a=openpgp-sha256; l=8803; i=gregkh@linuxfoundation.org; h=from:subject:message-id; bh=FmvLaKNhnIFQSuhbWRcDujMa+s+t+I+o5kK0EywbO78=; b=owGbwMvMwCRo6H6F97bub03G02pJDKlniuW2uSR9PGwa03xOXG7K1qUxjvMT2xYYpL88s3nnz un5vYItHbEsDIJMDLJiiixftvEc3V9xSNHL0PY0zBxWJpAhDFycAjCRxdYM82Py9FNuPq9fkNzw /OvZHy+OuuiHaDAsWPfkurjtYZNDs0/lSYu7/VS8bRHRDwA= X-Developer-Key: i=gregkh@linuxfoundation.org; a=openpgp; fpr=F4B60CC5BF78C2214A313DCB3147D40DDB2DFB29 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1790810842447927624 X-GMAIL-MSGID: 1790860564539439490 The Linux kernel project now has the ability to assign CVEs to fixed issues, so document the process and how individual developers can get a CVE if one is not automatically assigned for their fixes. Reviewed-by: Kees Cook Signed-off-by: Greg Kroah-Hartman Signed-off-by: Sasha Levin Signed-off-by: Lee Jones Reviewed-by: Lukas Bulwahn Reviewed-by: Krzysztof Kozlowski Reviewed-by: Konstantin Ryabitsev --- v3: fix up wording in security-bugs.rst based on the changes to the cve assignment process from v1, thanks to a private reviewer for pointing that out. v2: Grammer fixes based on review from Randy Updated paragraph about how CVE identifiers will be assigned (automatically when added to stable trees, or ask us for one directly before that happens if so desired) Documentation/process/cve.rst | 120 ++++++++++++++++++++++++ Documentation/process/index.rst | 1 + Documentation/process/security-bugs.rst | 5 +- 3 files changed, 123 insertions(+), 3 deletions(-) create mode 100644 Documentation/process/cve.rst diff --git a/Documentation/process/cve.rst b/Documentation/process/cve.rst new file mode 100644 index 000000000000..6465e6a79c18 --- /dev/null +++ b/Documentation/process/cve.rst @@ -0,0 +1,120 @@ +CVEs +==== + +Common Vulnerabilities and Exposure (CVE®) numbers were developed as an +unambiguous way to identify, define, and catalog publicly disclosed +security vulnerabilities. Over time, their usefulness has declined with +regards to the kernel project, and CVE numbers were very often assigned +in inappropriate ways and for inappropriate reasons. Because of this, +the kernel development community has tended to avoid them. However, the +combination of continuing pressure to assign CVEs and other forms of +security identifiers, and ongoing abuses by community members outside of +the kernel community has made it clear that the kernel community should +have control over those assignments. + +The Linux kernel developer team does have the ability to assign CVEs for +potential Linux kernel security issues. This assignment is independent +of the :doc:`normal Linux kernel security bug reporting +process<../process/security_bugs>`. + +A list of all assigned CVEs for the Linux kernel can be found in the +archives of the linux-cve mailing list, as seen on +https://lore.kernel.org/linux-cve-announce/. To get notice of the +assigned CVEs, please subscribe to that mailing list. + +Process +------- + +As part of the normal stable release process, kernel changes that are +potentially security issues are identified by the developers responsible +for CVE number assignments and have CVE numbers automatically assigned +to them. These assignments are published on the linux-cve-announce +mailing list as announcements on a frequent basis. + +Note, due to the layer at which the Linux kernel is in a system, almost +any bug might be exploitable to compromise the security of the kernel, +but the possibility of exploitation is often not evident when the bug is +fixed. Because of this, the CVE assignment team is overly cautious and +assign CVE numbers to any bugfix that they identify. This +explains the seemingly large number of CVEs that are issued by the Linux +kernel team. + +If the CVE assignment team misses a specific fix that any user feels +should have a CVE assigned to it, please email them at +and the team there will work with you on it. Note that no potential +security issues should be sent to this alias, it is ONLY for assignment +of CVEs for fixes that are already in released kernel trees. If you +feel you have found an unfixed security issue, please follow the +:doc:`normal Linux kernel security bug reporting +process<../process/security_bugs>`. + +No CVEs will be automatically assigned for unfixed security issues in +the Linux kernel; assignment will only automatically happen after a fix +is available and applied to a stable kernel tree, and it will be tracked +that way by the git commit id of the original fix. If anyone wishes to +have a CVE assigned before an issue is resolved with a commit, please +contact the kernel CVE assignment team at to get an +identifier assigned from their batch of reserved identifiers. + +No CVEs will be assigned for any issue found in a version of the kernel +that is not currently being actively supported by the Stable/LTS kernel +team. A list of the currently supported kernel branches can be found at +https://kernel.org/category/releases.html + +Disputes of assigned CVEs +------------------------- + +The authority to dispute or modify an assigned CVE for a specific kernel +change lies solely with the maintainers of the relevant subsystem +affected. This principle ensures a high degree of accuracy and +accountability in vulnerability reporting. Only those individuals with +deep expertise and intimate knowledge of the subsystem can effectively +assess the validity and scope of a reported vulnerability and determine +its appropriate CVE designation. Any attempt to modify or dispute a CVE +outside of this designated authority could lead to confusion, inaccurate +reporting, and ultimately, compromised systems. + +Invalid CVEs +------------ + +If a security issue is found in a Linux kernel that is only supported by +a Linux distribution due to the changes that have been made by that +distribution, or due to the distribution supporting a kernel version +that is no longer one of the kernel.org supported releases, then a CVE +can not be assigned by the Linux kernel CVE team, and must be asked for +from that Linux distribution itself. + +Any CVE that is assigned against the Linux kernel for an actively +supported kernel version, by any group other than the kernel assignment +CVE team should not be treated as a valid CVE. Please notify the +kernel CVE assignment team at so that they can work to +invalidate such entries through the CNA remediation process. + +Applicability of specific CVEs +------------------------------ + +As the Linux kernel can be used in many different ways, with many +different ways of accessing it by external users, or no access at all, +the applicability of any specific CVE is up to the user of Linux to +determine, it is not up to the CVE assignment team. Please do not +contact us to attempt to determine the applicability of any specific +CVE. + +Also, as the source tree is so large, and any one system only uses a +small subset of the source tree, any users of Linux should be aware that +large numbers of assigned CVEs are not relevant for their systems. + +In short, we do not know your use case, and we do not know what portions +of the kernel that you use, so there is no way for us to determine if a +specific CVE is relevant for your system. + +As always, it is best to take all released kernel changes, as they are +tested together in a unified whole by many community members, and not as +individual cherry-picked changes. Also note that for many bugs, the +solution to the overall problem is not found in a single change, but by +the sum of many fixes on top of each other. Ideally CVEs will be +assigned to all fixes for all issues, but sometimes we do not notice +fixes in released kernels, so do not assume that because a specific +change does not have a CVE assigned to it, that it is not relevant to +take. + diff --git a/Documentation/process/index.rst b/Documentation/process/index.rst index 6cb732dfcc72..de9cbb7bd7eb 100644 --- a/Documentation/process/index.rst +++ b/Documentation/process/index.rst @@ -81,6 +81,7 @@ of special classes of bugs: regressions and security problems. handling-regressions security-bugs + cve embargoed-hardware-issues Maintainer information diff --git a/Documentation/process/security-bugs.rst b/Documentation/process/security-bugs.rst index 692a3ba56cca..56c560a00b37 100644 --- a/Documentation/process/security-bugs.rst +++ b/Documentation/process/security-bugs.rst @@ -99,9 +99,8 @@ CVE assignment The security team does not assign CVEs, nor do we require them for reports or fixes, as this can needlessly complicate the process and may delay the bug handling. If a reporter wishes to have a CVE identifier -assigned, they should find one by themselves, for example by contacting -MITRE directly. However under no circumstances will a patch inclusion -be delayed to wait for a CVE identifier to arrive. +assigned for a confirmed issue, they can contact the :doc:`kernel CVE +assignment team<../process/cve>` to obtain one. Non-disclosure agreements -------------------------