Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

releasenote.md: cleanup and fixes #71

Open
wants to merge 10 commits into
base: main
Choose a base branch
from

Conversation

esyr-rh
Copy link
Contributor

@esyr-rh esyr-rh commented Aug 22, 2023

This patch set does some cleanup to releasenote.md and fixes various inaccuracies in recent release notes:

  • fix up white space usage (eliminate U+0080 usage and most of the trailing spaces);
  • remove excess "Release Notes" first-level headers;
  • sort the entries in microcode-20230808 tables;
  • fix incorrect platform mask for RPL-H/P/U (0xc0 instead of 0x07) in microcode-20230214 and microcode-20230512 release notes;
  • fix incorrect stepping for RPL-S (B0 insteas of S0);
  • add missing RPL-U (06-ba-03/e0) entry in the "New Platforms" section of microcode-20230808 release notes;
  • remove the duplicating 06-ba-03/e0 entry in the "Updated Platforms" section microcode-20230808 release notes;
  • fix old revisions for 06-8e-09/10 and 06-55-04/b7 entries in microcode-20230808 release notes;
  • add old revisions for 06-be-00/11, 06-ba-02/e0, and 06-ba-03/e0 entries in the "Updated Platforms" section of microcode-20230808 release notes.

Its usage has been started in microcode-20230214 (and only in the "Updated
Platforms" section entries, not in the "New Platforms" one
(up to microcode-20230808) or section headers) and is quite baffling,
as it is visually indistinguishable from a space character (and this
patch is a testament to that), serves no discernible purpose,
but (poorly) thwarts attempts to programmatically parse and compare the release
notes, and pollutes any copy-pasted text.

Signed-off-by: Eugene Syromiatnikov <[email protected]>
The notes for the last two releases contain some trailing spaces
in random places that seemingly serve no particular purpose.

Signed-off-by: Eugene Syromiatnikov <[email protected]>
Starting with microcode-20220809, the first-level "Release Notes" header
is duplicated for unknown reason;  remove it, as it does not make sense
to have it multiple times in the middle of the document, consider the
fact that first-level header is usually reserved for the document name
(and it seems that it indeed bears that role).

* releasenote.md: Remove all "Release Notes" headers after the first
one.

Signed-off-by: Eugene Syromiatnikov <[email protected]>
…cally

microcode-20230214 seemingly (but not fully;  the "New Platforms" section
still have used the old sorting order) have switched the entries order
from sorting on the FF-MM-SS/PI field to sorting on the Codename field
(which is arguably significantly less useful and much more confusing,
especially in cases of CPUIDs spanning several code names,
such as 06-8e-0[9ac]).  However, it is impossible to devise the sorting
order of the entries in the microcode-20230808 changelog table, which
makes it even more difficult to navigate, so this patch just changes it
to the lastly used one.

Signed-off-by: Eugene Syromiatnikov <[email protected]>
microcode-20230214, microcode-20230512, and microcode-20230512-rev2
release notes state that the platform mask for CPUIDs with FF-MM-SS
06-ba-02 and 06-ba-03 is 0x07, but it is, in fact, 0xc0:

    $ iucode_tool -L microcode-20230{214,512,512-rev2}/intel-ucode/06-ba-0[23]
    microcode bundle 1: microcode-20230214/intel-ucode/06-ba-02
      001/001: sig 0x000b06a2, pf_mask 0xc0, 2022-12-08, rev 0x410e, size 212992
               sig 0x000b06a2, pf_mask 0xc0, 2022-12-08, rev 0x410e
               sig 0x000b06a3, pf_mask 0xc0, 2022-12-08, rev 0x410e
    microcode bundle 2: microcode-20230214/intel-ucode/06-ba-03
      002/001: sig 0x000b06a2, pf_mask 0xc0, 2022-12-08, rev 0x410e, size 212992
               sig 0x000b06a2, pf_mask 0xc0, 2022-12-08, rev 0x410e
               sig 0x000b06a3, pf_mask 0xc0, 2022-12-08, rev 0x410e
    microcode bundle 3: microcode-20230512/intel-ucode/06-ba-02
      003/001: sig 0x000b06a2, pf_mask 0xc0, 2023-02-22, rev 0x4112, size 212992
               sig 0x000b06a2, pf_mask 0xc0, 2023-02-22, rev 0x4112
               sig 0x000b06a3, pf_mask 0xc0, 2023-02-22, rev 0x4112
    microcode bundle 4: microcode-20230512/intel-ucode/06-ba-03
      004/001: sig 0x000b06a2, pf_mask 0xc0, 2023-02-22, rev 0x4112, size 212992
               sig 0x000b06a2, pf_mask 0xc0, 2023-02-22, rev 0x4112
               sig 0x000b06a3, pf_mask 0xc0, 2023-02-22, rev 0x4112
    microcode bundle 5: microcode-20230512-rev2/intel-ucode/06-ba-02
      005/001: sig 0x000b06a2, pf_mask 0xc0, 2023-02-22, rev 0x4112, size 212992
               sig 0x000b06a2, pf_mask 0xc0, 2023-02-22, rev 0x4112
               sig 0x000b06a3, pf_mask 0xc0, 2023-02-22, rev 0x4112
    microcode bundle 6: microcode-20230512-rev2/intel-ucode/06-ba-03
      006/001: sig 0x000b06a2, pf_mask 0xc0, 2023-02-22, rev 0x4112, size 212992
               sig 0x000b06a2, pf_mask 0xc0, 2023-02-22, rev 0x4112
               sig 0x000b06a3, pf_mask 0xc0, 2023-02-22, rev 0x4112

Also, fix incorrect RPL-U stepping in the microcode-20230214 table.

* releasenote.md (microcode-20230214, microcode-20230512,
microcode-20230512-rev2) <RPL-H 6+8, RPL-P 6+8>: Change the F-M-S field
from 06-ba-02/07 to 06-ba-02/c0.
(microcode-20230214) <RPL-U 2+8>: Change the F-M-S field from 06-ba-02/07
to 06-ba-03/c0.
(microcode-20230512, microcode-20230512-rev2) <RPL-U 2+8>: Change the F-M-S
field from 06-ba-03/07 to 06-ba-03/c0.

Signed-off-by: Eugene Syromiatnikov <[email protected]>
microcode-20221108, microcode-20230214, microcode-20230512,
and microcode-20230512-rev2 release notes (incorrectly) state RPL-S
(06-b7-01/32) stepping as S0, while microcode-20230808 release notes
state it as B0, and [1] confirms the correctness of the latter.

[1] "13th Generation Intel Core Processors.  Datasheet, Volume 1 of 2"
    Rev. 005, February 2023, section 15.0 "CPU And Device IDs"
    https://cdrdv2-public.intel.com/743844/743844-005.pdf

* releasenote.md (microcode-20221108, microcode-20230214,
microcode-20230512, microcode-20230512-rev2) <RPL-S>: Change
the stepping field value from "S0" to "B0".

Signed-off-by: Eugene Syromiatnikov <[email protected]>
microcode-20230808 release notes for CPUIDs 06-ba-02/e0 (RPL-H/P/PX 6+8),
06-ba-03/e0 (RPL-U 2+8), and 06-be-00/11 (ADL-N) are peculiar in a way
that these CPUIDs have their PF mask values changed (from 06-ba-02/c0,
06-ba-03/c0, and 06-be-00/01, respectively).  Since 06-ba-02/e0 and
06-be-00/11 are listed both in "New Platforms" and "Updated Platforms"
sections (which makes some sense, as it is both addition of the platform
0x10 and update for the rest of the platforms), it is natural to assume
that this is done this way on purpose, and that 06-ba-03/e0 of these three
is accidentally missing from the "New Platforms" section.

* releasenote.md (microcode-20230808) <New Platforms>: Add 06-ba-03/e0
(RPL-U 2+8) entry.

Signed-off-by: Eugene Syromiatnikov <[email protected]>
CFL-S stepping P0 (06-9e-0c/22) is already listed as "CFL-H/S"
and it has not been listed in the notes to the previous releases
separately.

* releasenote.md (microcode-20230808) <CFL-S P0>: Remove.

Signed-off-by: Eugene Syromiatnikov <[email protected]>
…ries

The values provided are from the microcode-20230214 release, even though
they have been updated in microcode-20230512.  Curiously, only one
entry of two with CPUID of 06-55-04/b7 has manifested this mistake.

* releasenote.md (microcode-20230808) <AML-Y22 H0>: Change the "Old Ver"
field from 000000f0 to 000000f2.
(microcode-20230808) <SKX-SP H0/M0/U0>: Change the "Old Ver" field
from 02006e05 to 02006f05.

Signed-off-by: Eugene Syromiatnikov <[email protected]>
…6-ba-03/e0

As has been mentioned already in commit "releasenote.md: add missing
06-ba-03/e0 to the new microcode section", platforms with CPUIDs 06-be-00,
06-ba-02, and 06-ba-03 have their platform mask changed and thusly listed
in both "New Platforms" and "Updated Platforms" sections
of microcode-20230808 release notes.  It is, however, puzzling to have
the "Old Ver" field of these entries empty in the "Updated Platforms"
section, so it seemingly make sense to populate it with the previous
microcode versions for the existing platforms.

* releasenote.md (microcode-20230808) <Updated Platforms>: Provide
00000010 as the "Old Ver" field value for ADL-N A0 (06-be-00/11,
nee 06-be-00/01);  provide 00004112 as the "Old Ver" field value
for RPL-H/P/PX 6+8 J0 (06-ba-02/e0, nee 06-ba-02/c0) and RPL-U 2+8 Q0
(06-ba-03/e0, nee 06-ba-03/c0).

Signed-off-by: Eugene Syromiatnikov <[email protected]>
@esyr-rh esyr-rh changed the title releasenot.md: cleanup and fixes releasenote.md: cleanup and fixes Aug 22, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant