[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [RFC PATCH 04/22] x86/msr-index: add references to vendor manuals


  • To: Edwin Török <edwin.torok@xxxxxxxxx>
  • From: Jan Beulich <jbeulich@xxxxxxxx>
  • Date: Mon, 30 Oct 2023 17:15:35 +0100
  • Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=suse.com; dmarc=pass action=none header.from=suse.com; dkim=pass header.d=suse.com; arc=none
  • Arc-message-signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=ZiiBrW5vEf0m1/y2G0GNTDRRH2fhWo4h1V/uCWDYIc0=; b=iB7xDECzuju1UFk5EUBgah/fEhwffFyk2Q8Ng8lnBcG6cNtm6jXW0bNqv6dy4XBgaXBCSgQ4HmD/qregBUr3EAfy1hLGi4PhYLvWB3Jr+KZS9gWf3J5xYnsrP9SZc02CV512Pk5eojREaGFvMjkn9L39kIk19ounPzydHRE7aORBKhIYlOyzOcKxo/KOONd3WLPf6h+LjF2aTROcU2QUTH6AwBQv7bQPlVAq+PODDjjXWh4W4lCGr/J6MEChUXvMRzo8soyH1hXV2rzY0kx6j+hPXLTmMi2zGvdWE+1ysZgsjTwebBpfK9vOhuX8gMxbs3O99MqkJRFnfSo1eFl32Q==
  • Arc-seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=aYlgKipF9vrfqf+dPhyIOIDD6DqIJP5PtApLvRdqkm0zIQx2ea8ZO6PpD2NsKnr7ilwS0npMCLgzgkfrgS/KtcIFNFl3/yuI1PBepTbs9EYwSuaR0Dvz/seUMG54RbUCMVk/XZOJRdnDXunnvm7OKBMblINv3Ngz5ttPTnQos8gIPig1S0JjbVDaytULidVbEfDQQ/CC0jCuCpyR6aoVZxr/H94elOu+vRGUmPmrH1t06HX1OE8bWb90IIYXvP5h3d5mMunRkqGbPkXExLNuDAhzWKKrGO+B3/KPhwPVXpALWbb0GvFSSXYKPpqCq7msJfeMuhqQ/loipHpGIUSoUg==
  • Authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=suse.com;
  • Cc: Edwin Török <edvin.torok@xxxxxxxxxx>, Andrew Cooper <andrew.cooper3@xxxxxxxxxx>, Roger Pau Monné <roger.pau@xxxxxxxxxx>, Wei Liu <wl@xxxxxxx>, xen-devel@xxxxxxxxxxxxxxxxxxxx
  • Delivery-date: Mon, 30 Oct 2023 16:15:42 +0000
  • List-id: Xen developer discussion <xen-devel.lists.xenproject.org>

On 25.10.2023 21:29, Edwin Török wrote:
> To more easily lookup the semantics of these MSRs add references to
> vendor manuals.

As much as I appreciate the intention, ...

> --- a/xen/arch/x86/include/asm/msr-index.h
> +++ b/xen/arch/x86/include/asm/msr-index.h
> @@ -13,6 +13,16 @@
>   * Blocks of related constants should be sorted by MSR index.  The constant
>   * names should be as concise as possible, and the bit names may have an
>   * abbreviated name.  Exceptions will be considered on a case-by-case basis.
> + *
> + * References:
> + * - 
> https://software.intel.com/content/www/us/en/develop/articles/intel-sdm.html
> + *    Intel(R) 64 and IA-32 architectures SDM volume 4: Model-specific 
> registers
> + *    Chapter 2, "Model-Specific Registers (MSRs)"

... at least Intel's URL has changed several times over the years. Volume
and chapter numbers change even more frequently. Any such is liable to go
stale at some point.

Jan

> + * - https://developer.amd.com/resources/developer-guides-manuals/
> + *    AMD64 Architecture Programmer’s Manual Volume 2: System Programming
> + *    Appendix A "MSR Cross-Reference"
> + *
>   */
>  
>  #define MSR_P5_MC_ADDR                      0




 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.