Received: by 2002:a25:6193:0:0:0:0:0 with SMTP id v141csp4570157ybb; Tue, 14 Apr 2020 09:49:30 -0700 (PDT) X-Google-Smtp-Source: APiQypKmD5CZ+Q2r1IVVzzv7smFkIaH72WAOnB7UoutoobD3tehh7px1t43Yjm0t/Ex7/elHDLCJ X-Received: by 2002:a17:906:af59:: with SMTP id ly25mr1018736ejb.65.1586882969903; Tue, 14 Apr 2020 09:49:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1586882969; cv=none; d=google.com; s=arc-20160816; b=GG+T/8C6v8zzv8POjX0VmUmqDeNWU6MbUoEppoXdN5P5f7+MISImWyuDqZul+m+PQo tTEmnPDTISTTFlIz8sY8k8vpiLRQy2BD6b51Vv0VH7BNv5tSqN5ulx8k08xLwFKFFrmz jqRbsLE6hk/nLnFB9xHDt4MMEcbGsmT8hQ19ooJ53mierNumNvfje/+ezuZh8gCNLLPe V2pV8EbNyDjLw4E2S8udTbHlIN9IzaJF/yqNzrrpPSo1gPbdDo7KjYCkt2O90ZDYQIWH HTaIhdU/dIqrxah59QM2LnMpCqTfi60C/Re8xxO9J3yugQS7vy6BFiIXQ/9yHSaz6IAB OkEw== 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:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date; bh=mmBx0jRgkMEnexinSI2OOckZDYWrAaMXPSHp/vipRwI=; b=YhXsVJJoVhKzHpgpWNXxiOYGBVL3F4FUZZ8TALk6dZavaeW+g6uBSxeZPSY89yd8fm 79Cw51RV+8LR+oes3R9wxJH/NNmUf2Gx/K7PDtX3m55K1S6wxTNmtf37zYdPjSX6LK9H fUzRm0MxQSF0HxyJ+jkt3UEk4RAN/CocW//GNglXQBDcSaNt3tBi0XTvhERxA5lqtDKR 5iQHaH8/MwratzQYQMK0Do5jcp1tcMFedKGODbiKYblrFghdai8gnmV5UC2pSXEhsMuq XBuAJtUwnB6TOZQV450d0+bGooF2BsLxNfVv2lZkGMBzwDfZ6It47JUSJETp83AbYLZE pHCw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id h21si8467075ejc.152.2020.04.14.09.49.06; Tue, 14 Apr 2020 09:49:29 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2440569AbgDNPi3 (ORCPT + 99 others); Tue, 14 Apr 2020 11:38:29 -0400 Received: from ms.lwn.net ([45.79.88.28]:46198 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2440553AbgDNPiP (ORCPT ); Tue, 14 Apr 2020 11:38:15 -0400 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 27DD977D; Tue, 14 Apr 2020 15:38:10 +0000 (UTC) Date: Tue, 14 Apr 2020 09:38:09 -0600 From: Jonathan Corbet To: deven.desai@linux.microsoft.com Cc: agk@redhat.com, axboe@kernel.dk, snitzer@redhat.com, jmorris@namei.org, serge@hallyn.com, zohar@linux.ibm.com, linux-integrity@vger.kernel.org, linux-security-module@vger.kernel.org, dm-devel@redhat.com, linux-block@vger.kernel.org, tyhicks@linux.microsoft.com, pasha.tatashin@soleen.com, sashal@kernel.org, jaskarankhurana@linux.microsoft.com, nramas@linux.microsoft.com, mdsakib@linux.microsoft.com, linux-kernel@vger.kernel.org Subject: Re: [RFC PATCH v2 11/12] documentation: Add IPE Documentation Message-ID: <20200414093809.2c6ef93b@lwn.net> In-Reply-To: <20200406221439.1469862-12-deven.desai@linux.microsoft.com> References: <20200406221439.1469862-1-deven.desai@linux.microsoft.com> <20200406221439.1469862-12-deven.desai@linux.microsoft.com> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 6 Apr 2020 15:14:38 -0700 deven.desai@linux.microsoft.com wrote: > From: Deven Bowers > > Add IPE's documentation to the kernel tree. > > Signed-off-by: Deven Bowers Thanks for including this nice documentation from the outset! I have a couple of tiny nits to pick, but nothing really substantive to complain about, so: Acked-by: Jonathan Corbet [...] > +IPE is a Linux Security Module, which allows for a configurable policy I'd drop the comma (I told you these were nits!) [...] > +IPE Policy > +~~~~~~~~~~ > + > +IPE policy is designed to be both forward compatible and backwards > +compatible. There is one required line, at the top of the policy, > +indicating the policy name, and the policy version, for instance: > + > +:: > + > + policy_name="Ex Policy" policy_version=0.0.0 This pattern can be compressed a bit by just putting the "::" at the end of the last line of text: indicating the policy name, and the policy version, for instance:: policy_name="Ex Policy" policy_version=0.0.0 The result is a bit more readable in the plain-text format, IMO, and renders exactly the same in Sphinx. Thanks, jon