Received: by 2002:a25:1506:0:0:0:0:0 with SMTP id 6csp2648543ybv; Fri, 21 Feb 2020 20:32:25 -0800 (PST) X-Google-Smtp-Source: APXvYqxuQ03yyMEULCvudFc1ldirp6f9eyFMSrNMf04jJ4KrY93L5/FKwXRUMtA9vS+UVFf2Ng7B X-Received: by 2002:aca:c515:: with SMTP id v21mr5057516oif.60.1582345945535; Fri, 21 Feb 2020 20:32:25 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1582345945; cv=none; d=google.com; s=arc-20160816; b=HcZOWA3pcGl/Qon1Sw4aAAf/8piV/rctg+LgDSKUwDBKZXrKoq9pwTXAKuqYPSVVBW jTX2Q8HcsD/P440FJVsHkZmCFfSVNJ8Cwrc3Qw46BUocvp8maxy2CiHI2Sw1zEQZIlBl ABQKRthq79xmYQHv3Pb836KXosAiijjUjzpaqAZeK+FBCZ3n3Jrr1F9vvIW6/YBbsHRK XpgchOuLz4U/vBcfET64M3dR3E8YimxFydmXynSAuUFwaPzmyW5NHjet38+OhKf1j9Z9 MFMuwOSVf4WB0UZtxLegc1tSVqb0DnGPxCOs0bspv8LC8+Qca40kD6J+3c3Cxil3iNCj mD5g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding :content-language:in-reply-to:mime-version:user-agent:date :message-id:from:references:cc:to:subject:dkim-signature; bh=weu/KcDRpOpBuiPQX3TPgAeSa5/F/jELKk7bJm5RqRs=; b=nyc4IUt1qKX3BKS+7WMVXfPSPgqNJRoyJ+Amy3FSzrV1eK7ILV4N1AGeYz7U7qLi4F AdRCT0aUL4NToaRYHjekLSwIqxuueVjfRtYXCY0lNZ7mtIs+s8tWztXIcHYtgITUAq2S 4qUbaG6wpWob0F9c+7ILLyVDLD7zdBEWj9R16VWWmE2ExKVsK/BoEPo5cQYlWvwY/J0E ChoTPrdQK2CdWKFQHRSCRjuHfqJwjguHabyTX44WnWnwVbX9o365G28gMJ0+ZKrqvtb0 sz5ejclZ16yEevLYUQ+j43B4cEU54Kb3SMOi56Wpox7BSIk5ROGEMUnO9r8ciO/waJpf 77qQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@infradead.org header.s=bombadil.20170209 header.b=JmklBm8z; 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 n14si2584227otk.179.2020.02.21.20.32.12; Fri, 21 Feb 2020 20:32:25 -0800 (PST) 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=fail header.i=@infradead.org header.s=bombadil.20170209 header.b=JmklBm8z; 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 S1728114AbgBVEcC (ORCPT + 99 others); Fri, 21 Feb 2020 23:32:02 -0500 Received: from bombadil.infradead.org ([198.137.202.133]:35466 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728049AbgBVEcC (ORCPT ); Fri, 21 Feb 2020 23:32:02 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:MIME-Version:Date:Message-ID:From:References:Cc:To: Subject:Sender:Reply-To:Content-ID:Content-Description; bh=weu/KcDRpOpBuiPQX3TPgAeSa5/F/jELKk7bJm5RqRs=; b=JmklBm8zv9rsGeiWi5aA5cP3Bl ClO6fGtR3iN9cLrDa1aml8g8dza+LaKnps9EwS6IFD461M/WFUBi/OqQRbsKImoA7MjkpLmP9MqiV GYgPWjss6Hso6VtPchx04O39ddiOEJ6GS6F266tnHyk0Nfe64mgv+wdyjJmyEJeLGEp1t3hClKlcH USHGGse3sGg3Etxvy7IZdl0zgwMFDYk3NI+/wvB7igSS+ZzfFZKwDdcPmz5hiyXUUonZfwKWd66VD TlbOkeqGMnA0qtLD9i3caCTik8DISK8wVFDJKWD9z1rXezrXqRxnAbr4zuihr6CU0GvS9MqwOmqRx 6rHykkWA==; Received: from [2601:1c0:6280:3f0::19c2] by bombadil.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1j5MA3-0006Dh-Qw; Sat, 22 Feb 2020 04:13:03 +0000 Subject: Re: [PATCH v26 22/22] docs: x86/sgx: Document SGX micro architecture and kernel internals To: Jarkko Sakkinen , linux-kernel@vger.kernel.org, x86@kernel.org, linux-sgx@vger.kernel.org Cc: akpm@linux-foundation.org, dave.hansen@intel.com, sean.j.christopherson@intel.com, nhorman@redhat.com, npmccallum@redhat.com, haitao.huang@intel.com, andriy.shevchenko@linux.intel.com, tglx@linutronix.de, kai.svahn@intel.com, bp@alien8.de, josh@joshtriplett.org, luto@kernel.org, kai.huang@intel.com, rientjes@google.com, cedric.xing@intel.com, puiterwijk@redhat.com, linux-doc@vger.kernel.org References: <20200209212609.7928-1-jarkko.sakkinen@linux.intel.com> <20200209212609.7928-23-jarkko.sakkinen@linux.intel.com> From: Randy Dunlap Message-ID: <01067247-f6ff-21f6-774f-cbb6e72bc99e@infradead.org> Date: Fri, 21 Feb 2020 20:13:02 -0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.4.1 MIME-Version: 1.0 In-Reply-To: <20200209212609.7928-23-jarkko.sakkinen@linux.intel.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi Jarkko, One minor fix below: On 2/9/20 1:26 PM, Jarkko Sakkinen wrote: > Document Intel SGX micro architecture and kernel internals. The motivation > is to make the core ideas approachable by keeping a fairly high abstraction > level. Fine-grained micro architecture details can be looked up from Intel > SDM Volume 3D. > > Cc: Andy Lutomirski > Cc: linux-doc@vger.kernel.org > Co-developed-by: Sean Christopherson > Signed-off-by: Sean Christopherson > Signed-off-by: Jarkko Sakkinen > --- > Documentation/x86/index.rst | 1 + > Documentation/x86/sgx.rst | 182 ++++++++++++++++++++++++++++++++++++ > 2 files changed, 183 insertions(+) > create mode 100644 Documentation/x86/sgx.rst > > diff --git a/Documentation/x86/sgx.rst b/Documentation/x86/sgx.rst > new file mode 100644 > index 000000000000..ccffb45b4f4d > --- /dev/null > +++ b/Documentation/x86/sgx.rst > @@ -0,0 +1,182 @@ > +.. SPDX-License-Identifier: GPL-2.0 > + > +============ > +Architecture > +============ > + > +Introduction > +============ > + > +*Software Guard eXtensions (SGX)* is a set of instructions that enable ring-3 > +applications to set aside private regions of code and data. These regions are > +called enclaves. An enclave can be entered to a fixed set of entry points. Only > +a CPU running inside the enclave can access its code and data. > + > +SGX support can be determined by > + > + ``grep /proc/cpuinfo`` grep sgx /proc/cpuinfo > + > +Enclave Page Cache > +================== ... and Acked-by: Randy Dunlap -- ~Randy