Received: by 2002:ac0:a594:0:0:0:0:0 with SMTP id m20-v6csp793879imm; Mon, 21 May 2018 14:35:10 -0700 (PDT) X-Google-Smtp-Source: AB8JxZq0j6rqcaGaE00MA9UNxfmzG7ADw3fP1O+kg43OWMSgEXAUNtjbVTY9ze1l8Jl9TmdGly1L X-Received: by 2002:a62:f619:: with SMTP id x25-v6mr21395899pfh.106.1526938509995; Mon, 21 May 2018 14:35:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1526938509; cv=none; d=google.com; s=arc-20160816; b=ApbStcePhSOr9Z57KiW2ssba5kMNarVlkxK6CIauio3Ph+zrQ8T31v4ZuGJcukHw6k VB9rIViK7kffYMm0FMdN7rfvygXky65cy1ru+aE3PuyW2IjACj12ac2LiQP7IxKHNzhP JFYC+BBmry7PpasKqZfO1IrNqP71NmFIvzIeC8fbW18CCsiQ1KSMw/nXLp8GDC2MjhZV SrYaKZKt5XIB1NPjjrHzou//N9ZXNyjUmNWOhNDr6eQ88P5wy+YWL69mDSWel0+JzxLU rPmHm8vsYFpHc+zYH/LZM2rCa85l2DiqfFrCLnwFr/Y1NckGCzA6tN//iETwfbQ0heHM 6Qyg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:mime-version:user-agent:references :in-reply-to:message-id:date:subject:cc:to:from:dkim-signature :arc-authentication-results; bh=YVHyisg3OxkwQReBVlGNDJhiIgYd/wEk+FH1q+Gz31E=; b=MjupHHqsT5MyUDYoFJDEjhG+eiRbMc7Ym2bsZnp4eeTggFVRMSbvUVgdZAt2QDXEbQ 4wVwmVmiBGqNDQGc2pDngfjaYZdufNsNFqu6P36I93oC7lHoW44+JvYTaP5k0sh6TkWd YapoxouiZIMSmdLSQDDEf1JgGJwVmDETC/RIM3sbm3VyrqdayAKHxkWPJxlpSm0Vk2A9 ftL6wAzzOvsSvMRpj5T774VFpt1k0zAcaKTuAfCronk1hIw5CFD2HwLr6MezR7LfiP/5 tmm6+S6158uQN5XO5rGO+MLjoQGAPaudAoqfpWSqIdKaBxB6ud1jNMP7/LuPO0Lbuf6S I3sA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=10U2GHEY; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id a8-v6si14619786ple.222.2018.05.21.14.34.55; Mon, 21 May 2018 14:35:09 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=10U2GHEY; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932505AbeEUV0G (ORCPT + 99 others); Mon, 21 May 2018 17:26:06 -0400 Received: from mail.kernel.org ([198.145.29.99]:40850 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932164AbeEUV0C (ORCPT ); Mon, 21 May 2018 17:26:02 -0400 Received: from localhost (LFbn-1-12247-202.w90-92.abo.wanadoo.fr [90.92.61.202]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id F144220871; Mon, 21 May 2018 21:26:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1526937961; bh=ZXLchJOwFs/nxoNbmErEoR99a5uyslazchHe14R9mt0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=10U2GHEYf6VfeBVM31dp6vu6N4e3t0wxTcQ4vdFJiyN+KMkH/3Vvznm7RYj0YJYrb 4HzF/urhCtpWKXtAvs9Ey7BqLYBZp5tCGhkRnN9VImxp1BUA5drTDfauyMfav7jG49 7KqTZdmb1KIx9zpffBo8H5eRIXFSiUutbUAnclVo= From: Greg Kroah-Hartman To: linux-kernel@vger.kernel.org Cc: Greg Kroah-Hartman , stable@vger.kernel.org, Borislav Petkov , Thomas Gleixner Subject: [PATCH 4.16 089/110] Documentation/spec_ctrl: Do some minor cleanups Date: Mon, 21 May 2018 23:12:26 +0200 Message-Id: <20180521210513.908478454@linuxfoundation.org> X-Mailer: git-send-email 2.17.0 In-Reply-To: <20180521210503.823249477@linuxfoundation.org> References: <20180521210503.823249477@linuxfoundation.org> User-Agent: quilt/0.65 X-stable: review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 4.16-stable review patch. If anyone has any objections, please let me know. ------------------ From: Borislav Petkov commit dd0792699c4058e63c0715d9a7c2d40226fcdddc upstream Fix some typos, improve formulations, end sentences with a fullstop. Signed-off-by: Borislav Petkov Signed-off-by: Thomas Gleixner Signed-off-by: Greg Kroah-Hartman --- Documentation/userspace-api/spec_ctrl.rst | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) --- a/Documentation/userspace-api/spec_ctrl.rst +++ b/Documentation/userspace-api/spec_ctrl.rst @@ -2,13 +2,13 @@ Speculation Control =================== -Quite some CPUs have speculation related misfeatures which are in fact -vulnerabilites causing data leaks in various forms even accross privilege -domains. +Quite some CPUs have speculation-related misfeatures which are in +fact vulnerabilities causing data leaks in various forms even across +privilege domains. The kernel provides mitigation for such vulnerabilities in various -forms. Some of these mitigations are compile time configurable and some on -the kernel command line. +forms. Some of these mitigations are compile-time configurable and some +can be supplied on the kernel command line. There is also a class of mitigations which are very expensive, but they can be restricted to a certain set of processes or tasks in controlled @@ -32,18 +32,18 @@ the following meaning: Bit Define Description ==== ===================== =================================================== 0 PR_SPEC_PRCTL Mitigation can be controlled per task by - PR_SET_SPECULATION_CTRL + PR_SET_SPECULATION_CTRL. 1 PR_SPEC_ENABLE The speculation feature is enabled, mitigation is - disabled + disabled. 2 PR_SPEC_DISABLE The speculation feature is disabled, mitigation is - enabled + enabled. 3 PR_SPEC_FORCE_DISABLE Same as PR_SPEC_DISABLE, but cannot be undone. A subsequent prctl(..., PR_SPEC_ENABLE) will fail. ==== ===================== =================================================== If all bits are 0 the CPU is not affected by the speculation misfeature. -If PR_SPEC_PRCTL is set, then the per task control of the mitigation is +If PR_SPEC_PRCTL is set, then the per-task control of the mitigation is available. If not set, prctl(PR_SET_SPECULATION_CTRL) for the speculation misfeature will fail. @@ -61,9 +61,9 @@ Common error codes Value Meaning ======= ================================================================= EINVAL The prctl is not implemented by the architecture or unused - prctl(2) arguments are not 0 + prctl(2) arguments are not 0. -ENODEV arg2 is selecting a not supported speculation misfeature +ENODEV arg2 is selecting a not supported speculation misfeature. ======= ================================================================= PR_SET_SPECULATION_CTRL error codes @@ -74,7 +74,7 @@ Value Meaning 0 Success ERANGE arg3 is incorrect, i.e. it's neither PR_SPEC_ENABLE nor - PR_SPEC_DISABLE nor PR_SPEC_FORCE_DISABLE + PR_SPEC_DISABLE nor PR_SPEC_FORCE_DISABLE. ENXIO Control of the selected speculation misfeature is not possible. See PR_GET_SPECULATION_CTRL.