linux/arch/x86/kernel/microcode_intel.c
<<
>>
Prefs
   1/*
   2 *      Intel CPU Microcode Update Driver for Linux
   3 *
   4 *      Copyright (C) 2000-2006 Tigran Aivazian <tigran@aivazian.fsnet.co.uk>
   5 *                    2006      Shaohua Li <shaohua.li@intel.com>
   6 *
   7 *      This driver allows to upgrade microcode on Intel processors
   8 *      belonging to IA-32 family - PentiumPro, Pentium II,
   9 *      Pentium III, Xeon, Pentium 4, etc.
  10 *
  11 *      Reference: Section 8.11 of Volume 3a, IA-32 Intel? Architecture
  12 *      Software Developer's Manual
  13 *      Order Number 253668 or free download from:
  14 *
  15 *      http://developer.intel.com/Assets/PDF/manual/253668.pdf 
  16 *
  17 *      For more information, go to http://www.urbanmyth.org/microcode
  18 *
  19 *      This program is free software; you can redistribute it and/or
  20 *      modify it under the terms of the GNU General Public License
  21 *      as published by the Free Software Foundation; either version
  22 *      2 of the License, or (at your option) any later version.
  23 *
  24 *      1.0     16 Feb 2000, Tigran Aivazian <tigran@sco.com>
  25 *              Initial release.
  26 *      1.01    18 Feb 2000, Tigran Aivazian <tigran@sco.com>
  27 *              Added read() support + cleanups.
  28 *      1.02    21 Feb 2000, Tigran Aivazian <tigran@sco.com>
  29 *              Added 'device trimming' support. open(O_WRONLY) zeroes
  30 *              and frees the saved copy of applied microcode.
  31 *      1.03    29 Feb 2000, Tigran Aivazian <tigran@sco.com>
  32 *              Made to use devfs (/dev/cpu/microcode) + cleanups.
  33 *      1.04    06 Jun 2000, Simon Trimmer <simon@veritas.com>
  34 *              Added misc device support (now uses both devfs and misc).
  35 *              Added MICROCODE_IOCFREE ioctl to clear memory.
  36 *      1.05    09 Jun 2000, Simon Trimmer <simon@veritas.com>
  37 *              Messages for error cases (non Intel & no suitable microcode).
  38 *      1.06    03 Aug 2000, Tigran Aivazian <tigran@veritas.com>
  39 *              Removed ->release(). Removed exclusive open and status bitmap.
  40 *              Added microcode_rwsem to serialize read()/write()/ioctl().
  41 *              Removed global kernel lock usage.
  42 *      1.07    07 Sep 2000, Tigran Aivazian <tigran@veritas.com>
  43 *              Write 0 to 0x8B msr and then cpuid before reading revision,
  44 *              so that it works even if there were no update done by the
  45 *              BIOS. Otherwise, reading from 0x8B gives junk (which happened
  46 *              to be 0 on my machine which is why it worked even when I
  47 *              disabled update by the BIOS)
  48 *              Thanks to Eric W. Biederman <ebiederman@lnxi.com> for the fix.
  49 *      1.08    11 Dec 2000, Richard Schaal <richard.schaal@intel.com> and
  50 *                           Tigran Aivazian <tigran@veritas.com>
  51 *              Intel Pentium 4 processor support and bugfixes.
  52 *      1.09    30 Oct 2001, Tigran Aivazian <tigran@veritas.com>
  53 *              Bugfix for HT (Hyper-Threading) enabled processors
  54 *              whereby processor resources are shared by all logical processors
  55 *              in a single CPU package.
  56 *      1.10    28 Feb 2002 Asit K Mallick <asit.k.mallick@intel.com> and
  57 *              Tigran Aivazian <tigran@veritas.com>,
  58 *              Serialize updates as required on HT processors due to
  59 *              speculative nature of implementation.
  60 *      1.11    22 Mar 2002 Tigran Aivazian <tigran@veritas.com>
  61 *              Fix the panic when writing zero-length microcode chunk.
  62 *      1.12    29 Sep 2003 Nitin Kamble <nitin.a.kamble@intel.com>,
  63 *              Jun Nakajima <jun.nakajima@intel.com>
  64 *              Support for the microcode updates in the new format.
  65 *      1.13    10 Oct 2003 Tigran Aivazian <tigran@veritas.com>
  66 *              Removed ->read() method and obsoleted MICROCODE_IOCFREE ioctl
  67 *              because we no longer hold a copy of applied microcode
  68 *              in kernel memory.
  69 *      1.14    25 Jun 2004 Tigran Aivazian <tigran@veritas.com>
  70 *              Fix sigmatch() macro to handle old CPUs with pf == 0.
  71 *              Thanks to Stuart Swales for pointing out this bug.
  72 */
  73
  74#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  75
  76#include <linux/firmware.h>
  77#include <linux/uaccess.h>
  78#include <linux/kernel.h>
  79#include <linux/module.h>
  80#include <linux/vmalloc.h>
  81
  82#include <asm/microcode.h>
  83#include <asm/processor.h>
  84#include <asm/msr.h>
  85
  86MODULE_DESCRIPTION("Microcode Update Driver");
  87MODULE_AUTHOR("Tigran Aivazian <tigran@aivazian.fsnet.co.uk>");
  88MODULE_LICENSE("GPL");
  89
  90struct microcode_header_intel {
  91        unsigned int            hdrver;
  92        unsigned int            rev;
  93        unsigned int            date;
  94        unsigned int            sig;
  95        unsigned int            cksum;
  96        unsigned int            ldrver;
  97        unsigned int            pf;
  98        unsigned int            datasize;
  99        unsigned int            totalsize;
 100        unsigned int            reserved[3];
 101};
 102
 103struct microcode_intel {
 104        struct microcode_header_intel hdr;
 105        unsigned int            bits[0];
 106};
 107
 108/* microcode format is extended from prescott processors */
 109struct extended_signature {
 110        unsigned int            sig;
 111        unsigned int            pf;
 112        unsigned int            cksum;
 113};
 114
 115struct extended_sigtable {
 116        unsigned int            count;
 117        unsigned int            cksum;
 118        unsigned int            reserved[3];
 119        struct extended_signature sigs[0];
 120};
 121
 122#define DEFAULT_UCODE_DATASIZE  (2000)
 123#define MC_HEADER_SIZE          (sizeof(struct microcode_header_intel))
 124#define DEFAULT_UCODE_TOTALSIZE (DEFAULT_UCODE_DATASIZE + MC_HEADER_SIZE)
 125#define EXT_HEADER_SIZE         (sizeof(struct extended_sigtable))
 126#define EXT_SIGNATURE_SIZE      (sizeof(struct extended_signature))
 127#define DWSIZE                  (sizeof(u32))
 128
 129#define get_totalsize(mc) \
 130        (((struct microcode_intel *)mc)->hdr.totalsize ? \
 131         ((struct microcode_intel *)mc)->hdr.totalsize : \
 132         DEFAULT_UCODE_TOTALSIZE)
 133
 134#define get_datasize(mc) \
 135        (((struct microcode_intel *)mc)->hdr.datasize ? \
 136         ((struct microcode_intel *)mc)->hdr.datasize : DEFAULT_UCODE_DATASIZE)
 137
 138#define sigmatch(s1, s2, p1, p2) \
 139        (((s1) == (s2)) && (((p1) & (p2)) || (((p1) == 0) && ((p2) == 0))))
 140
 141#define exttable_size(et) ((et)->count * EXT_SIGNATURE_SIZE + EXT_HEADER_SIZE)
 142
 143static int collect_cpu_info(int cpu_num, struct cpu_signature *csig)
 144{
 145        struct cpuinfo_x86 *c = &cpu_data(cpu_num);
 146        unsigned int val[2];
 147
 148        memset(csig, 0, sizeof(*csig));
 149
 150        csig->sig = cpuid_eax(0x00000001);
 151
 152        if ((c->x86_model >= 5) || (c->x86 > 6)) {
 153                /* get processor flags from MSR 0x17 */
 154                rdmsr(MSR_IA32_PLATFORM_ID, val[0], val[1]);
 155                csig->pf = 1 << ((val[1] >> 18) & 7);
 156        }
 157
 158        csig->rev = c->microcode;
 159        pr_info("CPU%d sig=0x%x, pf=0x%x, revision=0x%x\n",
 160                cpu_num, csig->sig, csig->pf, csig->rev);
 161
 162        return 0;
 163}
 164
 165static inline int update_match_cpu(struct cpu_signature *csig, int sig, int pf)
 166{
 167        return (!sigmatch(sig, csig->sig, pf, csig->pf)) ? 0 : 1;
 168}
 169
 170static inline int
 171update_match_revision(struct microcode_header_intel *mc_header, int rev)
 172{
 173        return (mc_header->rev <= rev) ? 0 : 1;
 174}
 175
 176static int microcode_sanity_check(void *mc)
 177{
 178        unsigned long total_size, data_size, ext_table_size;
 179        struct microcode_header_intel *mc_header = mc;
 180        struct extended_sigtable *ext_header = NULL;
 181        int sum, orig_sum, ext_sigcount = 0, i;
 182        struct extended_signature *ext_sig;
 183
 184        total_size = get_totalsize(mc_header);
 185        data_size = get_datasize(mc_header);
 186
 187        if (data_size + MC_HEADER_SIZE > total_size) {
 188                pr_err("error! Bad data size in microcode data file\n");
 189                return -EINVAL;
 190        }
 191
 192        if (mc_header->ldrver != 1 || mc_header->hdrver != 1) {
 193                pr_err("error! Unknown microcode update format\n");
 194                return -EINVAL;
 195        }
 196        ext_table_size = total_size - (MC_HEADER_SIZE + data_size);
 197        if (ext_table_size) {
 198                if ((ext_table_size < EXT_HEADER_SIZE)
 199                 || ((ext_table_size - EXT_HEADER_SIZE) % EXT_SIGNATURE_SIZE)) {
 200                        pr_err("error! Small exttable size in microcode data file\n");
 201                        return -EINVAL;
 202                }
 203                ext_header = mc + MC_HEADER_SIZE + data_size;
 204                if (ext_table_size != exttable_size(ext_header)) {
 205                        pr_err("error! Bad exttable size in microcode data file\n");
 206                        return -EFAULT;
 207                }
 208                ext_sigcount = ext_header->count;
 209        }
 210
 211        /* check extended table checksum */
 212        if (ext_table_size) {
 213                int ext_table_sum = 0;
 214                int *ext_tablep = (int *)ext_header;
 215
 216                i = ext_table_size / DWSIZE;
 217                while (i--)
 218                        ext_table_sum += ext_tablep[i];
 219                if (ext_table_sum) {
 220                        pr_warning("aborting, bad extended signature table checksum\n");
 221                        return -EINVAL;
 222                }
 223        }
 224
 225        /* calculate the checksum */
 226        orig_sum = 0;
 227        i = (MC_HEADER_SIZE + data_size) / DWSIZE;
 228        while (i--)
 229                orig_sum += ((int *)mc)[i];
 230        if (orig_sum) {
 231                pr_err("aborting, bad checksum\n");
 232                return -EINVAL;
 233        }
 234        if (!ext_table_size)
 235                return 0;
 236        /* check extended signature checksum */
 237        for (i = 0; i < ext_sigcount; i++) {
 238                ext_sig = (void *)ext_header + EXT_HEADER_SIZE +
 239                          EXT_SIGNATURE_SIZE * i;
 240                sum = orig_sum
 241                        - (mc_header->sig + mc_header->pf + mc_header->cksum)
 242                        + (ext_sig->sig + ext_sig->pf + ext_sig->cksum);
 243                if (sum) {
 244                        pr_err("aborting, bad checksum\n");
 245                        return -EINVAL;
 246                }
 247        }
 248        return 0;
 249}
 250
 251/*
 252 * return 0 - no update found
 253 * return 1 - found update
 254 */
 255static int
 256get_matching_microcode(struct cpu_signature *cpu_sig, void *mc, int rev)
 257{
 258        struct microcode_header_intel *mc_header = mc;
 259        struct extended_sigtable *ext_header;
 260        unsigned long total_size = get_totalsize(mc_header);
 261        int ext_sigcount, i;
 262        struct extended_signature *ext_sig;
 263
 264        if (!update_match_revision(mc_header, rev))
 265                return 0;
 266
 267        if (update_match_cpu(cpu_sig, mc_header->sig, mc_header->pf))
 268                return 1;
 269
 270        /* Look for ext. headers: */
 271        if (total_size <= get_datasize(mc_header) + MC_HEADER_SIZE)
 272                return 0;
 273
 274        ext_header = mc + get_datasize(mc_header) + MC_HEADER_SIZE;
 275        ext_sigcount = ext_header->count;
 276        ext_sig = (void *)ext_header + EXT_HEADER_SIZE;
 277
 278        for (i = 0; i < ext_sigcount; i++) {
 279                if (update_match_cpu(cpu_sig, ext_sig->sig, ext_sig->pf))
 280                        return 1;
 281                ext_sig++;
 282        }
 283        return 0;
 284}
 285
 286static int apply_microcode(int cpu)
 287{
 288        struct microcode_intel *mc_intel;
 289        struct ucode_cpu_info *uci;
 290        unsigned int val[2];
 291        int cpu_num = raw_smp_processor_id();
 292        struct cpuinfo_x86 *c = &cpu_data(cpu_num);
 293
 294        uci = ucode_cpu_info + cpu;
 295        mc_intel = uci->mc;
 296
 297        /* We should bind the task to the CPU */
 298        BUG_ON(cpu_num != cpu);
 299
 300        if (mc_intel == NULL)
 301                return 0;
 302
 303        /* write microcode via MSR 0x79 */
 304        wrmsr(MSR_IA32_UCODE_WRITE,
 305              (unsigned long) mc_intel->bits,
 306              (unsigned long) mc_intel->bits >> 16 >> 16);
 307        wrmsr(MSR_IA32_UCODE_REV, 0, 0);
 308
 309        /* As documented in the SDM: Do a CPUID 1 here */
 310        sync_core();
 311
 312        /* get the current revision from MSR 0x8B */
 313        rdmsr(MSR_IA32_UCODE_REV, val[0], val[1]);
 314
 315        if (val[1] != mc_intel->hdr.rev) {
 316                pr_err("CPU%d update to revision 0x%x failed\n",
 317                       cpu_num, mc_intel->hdr.rev);
 318                return -1;
 319        }
 320        pr_info("CPU%d updated to revision 0x%x, date = %04x-%02x-%02x\n",
 321                cpu_num, val[1],
 322                mc_intel->hdr.date & 0xffff,
 323                mc_intel->hdr.date >> 24,
 324                (mc_intel->hdr.date >> 16) & 0xff);
 325
 326        uci->cpu_sig.rev = val[1];
 327        c->microcode = val[1];
 328
 329        return 0;
 330}
 331
 332static enum ucode_state generic_load_microcode(int cpu, void *data, size_t size,
 333                                int (*get_ucode_data)(void *, const void *, size_t))
 334{
 335        struct ucode_cpu_info *uci = ucode_cpu_info + cpu;
 336        u8 *ucode_ptr = data, *new_mc = NULL, *mc = NULL;
 337        int new_rev = uci->cpu_sig.rev;
 338        unsigned int leftover = size;
 339        enum ucode_state state = UCODE_OK;
 340        unsigned int curr_mc_size = 0;
 341
 342        while (leftover) {
 343                struct microcode_header_intel mc_header;
 344                unsigned int mc_size;
 345
 346                if (get_ucode_data(&mc_header, ucode_ptr, sizeof(mc_header)))
 347                        break;
 348
 349                mc_size = get_totalsize(&mc_header);
 350                if (!mc_size || mc_size > leftover) {
 351                        pr_err("error! Bad data in microcode data file\n");
 352                        break;
 353                }
 354
 355                /* For performance reasons, reuse mc area when possible */
 356                if (!mc || mc_size > curr_mc_size) {
 357                        vfree(mc);
 358                        mc = vmalloc(mc_size);
 359                        if (!mc)
 360                                break;
 361                        curr_mc_size = mc_size;
 362                }
 363
 364                if (get_ucode_data(mc, ucode_ptr, mc_size) ||
 365                    microcode_sanity_check(mc) < 0) {
 366                        break;
 367                }
 368
 369                if (get_matching_microcode(&uci->cpu_sig, mc, new_rev)) {
 370                        vfree(new_mc);
 371                        new_rev = mc_header.rev;
 372                        new_mc  = mc;
 373                        mc = NULL;      /* trigger new vmalloc */
 374                }
 375
 376                ucode_ptr += mc_size;
 377                leftover  -= mc_size;
 378        }
 379
 380        vfree(mc);
 381
 382        if (leftover) {
 383                vfree(new_mc);
 384                state = UCODE_ERROR;
 385                goto out;
 386        }
 387
 388        if (!new_mc) {
 389                state = UCODE_NFOUND;
 390                goto out;
 391        }
 392
 393        vfree(uci->mc);
 394        uci->mc = (struct microcode_intel *)new_mc;
 395
 396        pr_debug("CPU%d found a matching microcode update with version 0x%x (current=0x%x)\n",
 397                 cpu, new_rev, uci->cpu_sig.rev);
 398out:
 399        return state;
 400}
 401
 402static int get_ucode_fw(void *to, const void *from, size_t n)
 403{
 404        memcpy(to, from, n);
 405        return 0;
 406}
 407
 408static enum ucode_state request_microcode_fw(int cpu, struct device *device)
 409{
 410        char name[30];
 411        struct cpuinfo_x86 *c = &cpu_data(cpu);
 412        const struct firmware *firmware;
 413        enum ucode_state ret;
 414
 415        sprintf(name, "intel-ucode/%02x-%02x-%02x",
 416                c->x86, c->x86_model, c->x86_mask);
 417
 418        if (request_firmware(&firmware, name, device)) {
 419                pr_debug("data file %s load failed\n", name);
 420                return UCODE_NFOUND;
 421        }
 422
 423        ret = generic_load_microcode(cpu, (void *)firmware->data,
 424                                     firmware->size, &get_ucode_fw);
 425
 426        release_firmware(firmware);
 427
 428        return ret;
 429}
 430
 431static int get_ucode_user(void *to, const void *from, size_t n)
 432{
 433        return copy_from_user(to, from, n);
 434}
 435
 436static enum ucode_state
 437request_microcode_user(int cpu, const void __user *buf, size_t size)
 438{
 439        return generic_load_microcode(cpu, (void *)buf, size, &get_ucode_user);
 440}
 441
 442static void microcode_fini_cpu(int cpu)
 443{
 444        struct ucode_cpu_info *uci = ucode_cpu_info + cpu;
 445
 446        vfree(uci->mc);
 447        uci->mc = NULL;
 448}
 449
 450static struct microcode_ops microcode_intel_ops = {
 451        .request_microcode_user           = request_microcode_user,
 452        .request_microcode_fw             = request_microcode_fw,
 453        .collect_cpu_info                 = collect_cpu_info,
 454        .apply_microcode                  = apply_microcode,
 455        .microcode_fini_cpu               = microcode_fini_cpu,
 456};
 457
 458struct microcode_ops * __init init_intel_microcode(void)
 459{
 460        struct cpuinfo_x86 *c = &cpu_data(0);
 461
 462        if (c->x86_vendor != X86_VENDOR_INTEL || c->x86 < 6 ||
 463            cpu_has(c, X86_FEATURE_IA64)) {
 464                pr_err("Intel CPU family 0x%x not supported\n", c->x86);
 465                return NULL;
 466        }
 467
 468        return &microcode_intel_ops;
 469}
 470
 471