From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <linux-kernel-owner@vger.kernel.org>
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
	id S1756683AbcGIIRX (ORCPT <rfc822;w@1wt.eu>);
	Sat, 9 Jul 2016 04:17:23 -0400
Received: from mx2.suse.de ([195.135.220.15]:45585 "EHLO mx2.suse.de"
	rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP
	id S1751088AbcGIIRT (ORCPT <rfc822;linux-kernel@vger.kernel.org>);
	Sat, 9 Jul 2016 04:17:19 -0400
Date: Sat, 9 Jul 2016 10:17:16 +0200
From: Borislav Petkov <bp@suse.de>
To: Ingo Molnar <mingo@kernel.org>
Cc: "Luck, Tony" <tony.luck@intel.com>, "Yu, Fenghua" <fenghua.yu@intel.com>,
        Thomas Gleixner <tglx@linutronix.de>,
        "Anvin, H Peter" <h.peter.anvin@intel.com>,
        Ingo Molnar <mingo@elte.hu>, Stephane Eranian <eranian@google.com>,
        Peter Zijlstra <peterz@infradead.org>,
        Vikas Shivappa <vikas.shivappa@linux.intel.com>,
        "Shankar, Ravi V" <ravi.v.shankar@intel.com>,
        linux-kernel <linux-kernel@vger.kernel.org>, x86 <x86@kernel.org>
Subject: Re: [PATCH v2 2/3] Documentation, ABI: Add a document entry for
 cache id
Message-ID: <20160709081716.GA8725@pd.tnic>
References: <1467842838-57246-1-git-send-email-fenghua.yu@intel.com>
 <1467842838-57246-3-git-send-email-fenghua.yu@intel.com>
 <20160708084146.GA4508@gmail.com>
 <3E5A0FA7E9CA944F9D5414FEC6C712205DFD3208@ORSMSX106.amr.corp.intel.com>
 <3908561D78D1C84285E8C5FCA982C28F3A15599C@ORSMSX114.amr.corp.intel.com>
 <20160708180746.GB4429@gmail.com>
 <20160708184110.GD3938@pd.tnic>
 <3908561D78D1C84285E8C5FCA982C28F3A155BD7@ORSMSX114.amr.corp.intel.com>
 <20160708185541.GE3938@pd.tnic>
 <20160708193457.GA18734@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <20160708193457.GA18734@gmail.com>
User-Agent: Mutt/1.5.24 (2015-08-30)
Sender: linux-kernel-owner@vger.kernel.org
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On Fri, Jul 08, 2016 at 09:34:57PM +0200, Ingo Molnar wrote:
>   The cache-id identifies a hardware cache of the system within a given
>   cache-index category of caches. The (cache-index,cache-id) pair is

I'd say something like:

   "... within a given cache index in a set of cache indices. The
   "index" name is simply a nomenclature from CPUID's leaf 4 which
   enumerates all caches on the system by referring to each one as a
   cache index. ... "

Because this way we hint at from where the "index" thing comes and
people can go and read the SDM for more info.

And also we're explaining what it is because, IMHO, whatever formulation
or spelling we do with "cache index", there's simply not a good way of
explaining what it means without *actually* explaining it and where it
comes from.

:-)

-- 
Regards/Gruss,
    Boris.

SUSE Linux GmbH, GF: Felix Imendörffer, Jane Smithard, Graham Norton, HRB 21284 (AG Nürnberg)
--