1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * CPU Microcode Update Driver for Linux
9 * X86 CPU microcode early update for Linux:
15 * This driver allows to upgrade microcode on x86 processors.
18 #define pr_fmt(fmt) "microcode: " fmt
20 #include <linux/platform_device.h>
21 #include <linux/stop_machine.h>
22 #include <linux/syscore_ops.h>
23 #include <linux/miscdevice.h>
24 #include <linux/capability.h>
25 #include <linux/firmware.h>
26 #include <linux/kernel.h>
27 #include <linux/delay.h>
28 #include <linux/mutex.h>
29 #include <linux/cpu.h>
30 #include <linux/nmi.h>
34 #include <asm/microcode_intel.h>
35 #include <asm/cpu_device_id.h>
36 #include <asm/microcode_amd.h>
37 #include <asm/perf_event.h>
38 #include <asm/microcode.h>
39 #include <asm/processor.h>
40 #include <asm/cmdline.h>
41 #include <asm/setup.h>
43 #define DRIVER_VERSION "2.2"
45 static struct microcode_ops *microcode_ops;
46 static bool dis_ucode_ldr = true;
50 LIST_HEAD(microcode_cache);
55 * All non cpu-hotplug-callback call sites use:
57 * - microcode_mutex to synchronize with each other;
58 * - cpus_read_lock/unlock() to synchronize with
59 * the cpu-hotplug-callback call sites.
61 * We guarantee that only a single cpu is being
62 * updated at any particular moment of time.
64 static DEFINE_MUTEX(microcode_mutex);
66 struct ucode_cpu_info ucode_cpu_info[NR_CPUS];
69 struct cpu_signature *cpu_sig;
74 * Those patch levels cannot be updated to newer ones and thus should be final.
76 static u32 final_levels[] = {
80 0, /* T-101 terminator */
84 * Check the current patch level on this CPU.
87 * - true: if update should stop
90 static bool amd_check_current_patch_level(void)
95 native_rdmsr(MSR_AMD64_PATCH_LEVEL, lvl, dummy);
97 if (IS_ENABLED(CONFIG_X86_32))
98 levels = (u32 *)__pa_nodebug(&final_levels);
100 levels = final_levels;
102 for (i = 0; levels[i]; i++) {
103 if (lvl == levels[i])
109 static bool __init check_loader_disabled_bsp(void)
111 static const char *__dis_opt_str = "dis_ucode_ldr";
114 const char *cmdline = (const char *)__pa_nodebug(boot_command_line);
115 const char *option = (const char *)__pa_nodebug(__dis_opt_str);
116 bool *res = (bool *)__pa_nodebug(&dis_ucode_ldr);
118 #else /* CONFIG_X86_64 */
119 const char *cmdline = boot_command_line;
120 const char *option = __dis_opt_str;
121 bool *res = &dis_ucode_ldr;
125 * CPUID(1).ECX[31]: reserved for hypervisor use. This is still not
126 * completely accurate as xen pv guests don't see that CPUID bit set but
127 * that's good enough as they don't land on the BSP path anyway.
129 if (native_cpuid_ecx(1) & BIT(31))
132 if (x86_cpuid_vendor() == X86_VENDOR_AMD) {
133 if (amd_check_current_patch_level())
137 if (cmdline_find_option_bool(cmdline, option) <= 0)
143 void __init load_ucode_bsp(void)
145 unsigned int cpuid_1_eax;
151 cpuid_1_eax = native_cpuid_eax(1);
153 switch (x86_cpuid_vendor()) {
154 case X86_VENDOR_INTEL:
155 if (x86_family(cpuid_1_eax) < 6)
160 if (x86_family(cpuid_1_eax) < 0x10)
169 if (check_loader_disabled_bsp())
173 load_ucode_intel_bsp();
175 load_ucode_amd_bsp(cpuid_1_eax);
178 static bool check_loader_disabled_ap(void)
181 return *((bool *)__pa_nodebug(&dis_ucode_ldr));
183 return dis_ucode_ldr;
187 void load_ucode_ap(void)
189 unsigned int cpuid_1_eax;
191 if (check_loader_disabled_ap())
194 cpuid_1_eax = native_cpuid_eax(1);
196 switch (x86_cpuid_vendor()) {
197 case X86_VENDOR_INTEL:
198 if (x86_family(cpuid_1_eax) >= 6)
199 load_ucode_intel_ap();
202 if (x86_family(cpuid_1_eax) >= 0x10)
203 load_ucode_amd_ap(cpuid_1_eax);
210 static int __init save_microcode_in_initrd(void)
212 struct cpuinfo_x86 *c = &boot_cpu_data;
215 switch (c->x86_vendor) {
216 case X86_VENDOR_INTEL:
218 ret = save_microcode_in_initrd_intel();
222 ret = save_microcode_in_initrd_amd(cpuid_eax(1));
233 struct cpio_data find_microcode_in_initrd(const char *path, bool use_pa)
235 #ifdef CONFIG_BLK_DEV_INITRD
236 unsigned long start = 0;
240 struct boot_params *params;
243 params = (struct boot_params *)__pa_nodebug(&boot_params);
245 params = &boot_params;
247 size = params->hdr.ramdisk_size;
250 * Set start only if we have an initrd image. We cannot use initrd_start
251 * because it is not set that early yet.
254 start = params->hdr.ramdisk_image;
256 # else /* CONFIG_X86_64 */
257 size = (unsigned long)boot_params.ext_ramdisk_size << 32;
258 size |= boot_params.hdr.ramdisk_size;
261 start = (unsigned long)boot_params.ext_ramdisk_image << 32;
262 start |= boot_params.hdr.ramdisk_image;
264 start += PAGE_OFFSET;
269 * Fixup the start address: after reserve_initrd() runs, initrd_start
270 * has the virtual address of the beginning of the initrd. It also
271 * possibly relocates the ramdisk. In either case, initrd_start contains
272 * the updated address so use that instead.
274 * initrd_gone is for the hotplug case where we've thrown out initrd
279 return (struct cpio_data){ NULL, 0, "" };
281 start = initrd_start;
284 * The picture with physical addresses is a bit different: we
285 * need to get the *physical* address to which the ramdisk was
286 * relocated, i.e., relocated_ramdisk (not initrd_start) and
287 * since we're running from physical addresses, we need to access
288 * relocated_ramdisk through its *physical* address too.
290 u64 *rr = (u64 *)__pa_nodebug(&relocated_ramdisk);
295 return find_cpio_data(path, (void *)start, size, NULL);
296 #else /* !CONFIG_BLK_DEV_INITRD */
297 return (struct cpio_data){ NULL, 0, "" };
301 void reload_early_microcode(unsigned int cpu)
305 vendor = x86_cpuid_vendor();
306 family = x86_cpuid_family();
309 case X86_VENDOR_INTEL:
311 reload_ucode_intel();
315 reload_ucode_amd(cpu);
322 /* fake device for request_firmware */
323 static struct platform_device *microcode_pdev;
325 #ifdef CONFIG_MICROCODE_LATE_LOADING
327 * Late loading dance. Why the heavy-handed stomp_machine effort?
329 * - HT siblings must be idle and not execute other code while the other sibling
330 * is loading microcode in order to avoid any negative interactions caused by
333 * - In addition, microcode update on the cores must be serialized until this
334 * requirement can be relaxed in the future. Right now, this is conservative
337 #define SPINUNIT 100 /* 100 nsec */
339 static int check_online_cpus(void)
344 * Make sure all CPUs are online. It's fine for SMT to be disabled if
345 * all the primary threads are still online.
347 for_each_present_cpu(cpu) {
348 if (topology_is_primary_thread(cpu) && !cpu_online(cpu)) {
349 pr_err("Not all CPUs online, aborting microcode update.\n");
357 static atomic_t late_cpus_in;
358 static atomic_t late_cpus_out;
360 static int __wait_for_cpus(atomic_t *t, long long timeout)
362 int all_cpus = num_online_cpus();
366 while (atomic_read(t) < all_cpus) {
367 if (timeout < SPINUNIT) {
368 pr_err("Timeout while waiting for CPUs rendezvous, remaining: %d\n",
369 all_cpus - atomic_read(t));
376 touch_nmi_watchdog();
384 * 0 - success (no update done or microcode was updated)
386 static int __reload_late(void *info)
388 int cpu = smp_processor_id();
389 enum ucode_state err;
393 * Wait for all CPUs to arrive. A load will not be attempted unless all
396 if (__wait_for_cpus(&late_cpus_in, NSEC_PER_SEC))
400 * On an SMT system, it suffices to load the microcode on one sibling of
401 * the core because the microcode engine is shared between the threads.
402 * Synchronization still needs to take place so that no concurrent
403 * loading attempts happen on multiple threads of an SMT core. See
406 if (cpumask_first(topology_sibling_cpumask(cpu)) == cpu)
407 err = microcode_ops->apply_microcode(cpu);
409 goto wait_for_siblings;
411 if (err >= UCODE_NFOUND) {
412 if (err == UCODE_ERROR)
413 pr_warn("Error reloading microcode on CPU %d\n", cpu);
419 if (__wait_for_cpus(&late_cpus_out, NSEC_PER_SEC))
420 panic("Timeout during microcode update!\n");
423 * At least one thread has completed update on each core.
424 * For others, simply call the update to make sure the
425 * per-cpu cpuinfo can be updated with right microcode
428 if (cpumask_first(topology_sibling_cpumask(cpu)) != cpu)
429 err = microcode_ops->apply_microcode(cpu);
435 * Reload microcode late on all CPUs. Wait for a sec until they
436 * all gather together.
438 static int microcode_reload_late(void)
440 int old = boot_cpu_data.microcode, ret;
441 struct cpuinfo_x86 prev_info;
443 pr_err("Attempting late microcode loading - it is dangerous and taints the kernel.\n");
444 pr_err("You should switch to early loading, if possible.\n");
446 atomic_set(&late_cpus_in, 0);
447 atomic_set(&late_cpus_out, 0);
450 * Take a snapshot before the microcode update in order to compare and
451 * check whether any bits changed after an update.
453 store_cpu_caps(&prev_info);
455 ret = stop_machine_cpuslocked(__reload_late, NULL, cpu_online_mask);
457 pr_info("Reload succeeded, microcode revision: 0x%x -> 0x%x\n",
458 old, boot_cpu_data.microcode);
459 microcode_check(&prev_info);
461 pr_info("Reload failed, current microcode revision: 0x%x\n",
462 boot_cpu_data.microcode);
468 static ssize_t reload_store(struct device *dev,
469 struct device_attribute *attr,
470 const char *buf, size_t size)
472 enum ucode_state tmp_ret = UCODE_OK;
473 int bsp = boot_cpu_data.cpu_index;
477 ret = kstrtoul(buf, 0, &val);
483 ret = check_online_cpus();
487 tmp_ret = microcode_ops->request_microcode_fw(bsp, µcode_pdev->dev);
488 if (tmp_ret != UCODE_NEW)
491 mutex_lock(µcode_mutex);
492 ret = microcode_reload_late();
493 mutex_unlock(µcode_mutex);
501 add_taint(TAINT_CPU_OUT_OF_SPEC, LOCKDEP_STILL_OK);
506 static DEVICE_ATTR_WO(reload);
509 static ssize_t version_show(struct device *dev,
510 struct device_attribute *attr, char *buf)
512 struct ucode_cpu_info *uci = ucode_cpu_info + dev->id;
514 return sprintf(buf, "0x%x\n", uci->cpu_sig.rev);
517 static ssize_t processor_flags_show(struct device *dev,
518 struct device_attribute *attr, char *buf)
520 struct ucode_cpu_info *uci = ucode_cpu_info + dev->id;
522 return sprintf(buf, "0x%x\n", uci->cpu_sig.pf);
525 static DEVICE_ATTR_RO(version);
526 static DEVICE_ATTR_RO(processor_flags);
528 static struct attribute *mc_default_attrs[] = {
529 &dev_attr_version.attr,
530 &dev_attr_processor_flags.attr,
534 static const struct attribute_group mc_attr_group = {
535 .attrs = mc_default_attrs,
539 static void microcode_fini_cpu(int cpu)
541 if (microcode_ops->microcode_fini_cpu)
542 microcode_ops->microcode_fini_cpu(cpu);
545 static enum ucode_state microcode_init_cpu(int cpu)
547 struct ucode_cpu_info *uci = ucode_cpu_info + cpu;
549 memset(uci, 0, sizeof(*uci));
551 microcode_ops->collect_cpu_info(cpu, &uci->cpu_sig);
553 return microcode_ops->apply_microcode(cpu);
557 * microcode_bsp_resume - Update boot CPU microcode during resume.
559 void microcode_bsp_resume(void)
561 int cpu = smp_processor_id();
562 struct ucode_cpu_info *uci = ucode_cpu_info + cpu;
565 microcode_ops->apply_microcode(cpu);
567 reload_early_microcode(cpu);
570 static struct syscore_ops mc_syscore_ops = {
571 .resume = microcode_bsp_resume,
574 static int mc_cpu_starting(unsigned int cpu)
576 enum ucode_state err = microcode_ops->apply_microcode(cpu);
578 pr_debug("%s: CPU%d, err: %d\n", __func__, cpu, err);
580 return err == UCODE_ERROR;
583 static int mc_cpu_online(unsigned int cpu)
585 struct device *dev = get_cpu_device(cpu);
587 if (sysfs_create_group(&dev->kobj, &mc_attr_group))
588 pr_err("Failed to create group for CPU%d\n", cpu);
592 static int mc_cpu_down_prep(unsigned int cpu)
596 dev = get_cpu_device(cpu);
598 microcode_fini_cpu(cpu);
600 /* Suspend is in progress, only remove the interface */
601 sysfs_remove_group(&dev->kobj, &mc_attr_group);
602 pr_debug("%s: CPU%d\n", __func__, cpu);
607 static void setup_online_cpu(struct work_struct *work)
609 int cpu = smp_processor_id();
610 enum ucode_state err;
612 err = microcode_init_cpu(cpu);
613 if (err == UCODE_ERROR) {
614 pr_err("Error applying microcode on CPU%d\n", cpu);
621 static struct attribute *cpu_root_microcode_attrs[] = {
622 #ifdef CONFIG_MICROCODE_LATE_LOADING
623 &dev_attr_reload.attr,
628 static const struct attribute_group cpu_root_microcode_group = {
630 .attrs = cpu_root_microcode_attrs,
633 static int __init microcode_init(void)
635 struct cpuinfo_x86 *c = &boot_cpu_data;
641 if (c->x86_vendor == X86_VENDOR_INTEL)
642 microcode_ops = init_intel_microcode();
643 else if (c->x86_vendor == X86_VENDOR_AMD)
644 microcode_ops = init_amd_microcode();
646 pr_err("no support for this CPU vendor\n");
651 microcode_pdev = platform_device_register_simple("microcode", -1, NULL, 0);
652 if (IS_ERR(microcode_pdev))
653 return PTR_ERR(microcode_pdev);
655 error = sysfs_create_group(&cpu_subsys.dev_root->kobj, &cpu_root_microcode_group);
657 pr_err("Error creating microcode group!\n");
661 /* Do per-CPU setup */
662 schedule_on_each_cpu(setup_online_cpu);
664 register_syscore_ops(&mc_syscore_ops);
665 cpuhp_setup_state_nocalls(CPUHP_AP_MICROCODE_LOADER, "x86/microcode:starting",
666 mc_cpu_starting, NULL);
667 cpuhp_setup_state_nocalls(CPUHP_AP_ONLINE_DYN, "x86/microcode:online",
668 mc_cpu_online, mc_cpu_down_prep);
670 pr_info("Microcode Update Driver: v%s.", DRIVER_VERSION);
675 platform_device_unregister(microcode_pdev);
679 fs_initcall(save_microcode_in_initrd);
680 late_initcall(microcode_init);