Blame SOURCES/README

da1320
The microcode_ctl package contains microcode files (vendor-provided binary data
da1320
and/or code in proprietary format that affects behaviour of a device) for Intel
da1320
CPUs that may be loaded into the CPU during boot.
da1320
da1320
This directory contains information regarding various aspects of the provided
da1320
microcode files and their usage.
da1320
da1320
 * LICENSE.intel-ucode
da1320
   "license" file from the Intel x86 CPU microcode archive.
da1320
 * README
da1320
   This file.
da1320
 * README.caveats
da1320
   Caveats (mechanism for enabling/disabling usage of sets of microcode files
da1320
   based on caveat configuration and user preferences) documentation.
da1320
   Also contains general information about microcode update behaviour and links
da1320
   with additional information about the relevant microarchitectural
da1320
   vulnerabilities.
da1320
 * README.intel-ucode
da1320
   "README.md" file from the Intel x86 CPU microcode archive.
da1320
 * RELEASE_NOTES.intel-ucode
da1320
   "releasenote.md" file from the Intel x86 CPU microcode archive.
da1320
 * SECURITY.intel-ucode
da1320
   "security.md" file from the Intel x86 CPU microcode archive.
da1320
 * SUMMARY.intel-ucode
2c8f3d
   Information about supplied microcode files extracted from their headers,
2c8f3d
   in a table form.  Columns have the following meaning:
2c8f3d
    * "Path": path to the microcode file under one of the following directories:
2c8f3d
       * /usr/share/microcode_ctl/ucode_with_caveats/intel
2c8f3d
       * /usr/share/microcode_ctl/ucode_with_caveats
2c8f3d
       * /usr/share/microcode_ctl
2c8f3d
       * /lib/firmware
2c8f3d
       * /etc/firmware
2c8f3d
    * "Offset": offset of the microcode blob within the micocode file in bytes.
2c8f3d
    * "Ext. Offset": offset of the extended signature header within
2c8f3d
      the microcode file in bytes.
2c8f3d
    * "Data Size": size of microcode data in bytes.  0 means 2000 bytes.
2c8f3d
    * "Total Size": size of microcode blob in bytes, incuding headers.
2c8f3d
      0 means 2048 bytes.
2c8f3d
    * "CPUID": CPU ID signature (in format returned by the CPUID instruction).
2c8f3d
    * "Platform ID Mask": mask of suitable Platform IDs (provided in bits
2c8f3d
      52..50 of MSR 0x17).
2c8f3d
    * "Revision": microcode revision.
2c8f3d
    * "Date": microcode creation date.
2c8f3d
    * "Checksum": sum (in base 1<< 32) of all 32-bit values comprising
2c8f3d
      the microcode (from Offset up to Offset + Total Size).
2c8f3d
    * "Codenames": list of known CPU codenames associated with the CPUID
2c8f3d
      and Platform ID Mask combination.
2c8f3d
   Please refer to README.cavets, section "Microcode file structure"
2c8f3d
   for additional information regarding microcode header fields.
da1320
 * caveats
2c8f3d
   Directory that contains readme files for each specific caveat.