Add a new bus method to fetch device-specific CPU sets.
authorjhb <jhb@FreeBSD.org>
Mon, 9 May 2016 20:50:21 +0000 (20:50 +0000)
committerjhb <jhb@FreeBSD.org>
Mon, 9 May 2016 20:50:21 +0000 (20:50 +0000)
commit6bae79f8842b4f026c5eb55ae62aaa98dd23758d
treeaf412c855aeec6fd0582f885ff22d5e9bcb786e0
parentd9dcbf122a91dc40fc5a03b50adf8fb347ddccfe
Add a new bus method to fetch device-specific CPU sets.

bus_get_cpus() returns a specified set of CPUs for a device.  It accepts
an enum for the second parameter that indicates the type of cpuset to
request.  Currently two valus are supported:

 - LOCAL_CPUS (on x86 this returns all the CPUs in the package closest to
   the device when DEVICE_NUMA is enabled)
 - INTR_CPUS (like LOCAL_CPUS but only returns 1 SMT thread for each core)

For systems that do not support NUMA (or if it is not enabled in the kernel
config), LOCAL_CPUS fails with EINVAL.  INTR_CPUS is mapped to 'all_cpus'
by default.  The idea is that INTR_CPUS should always return a valid set.

Device drivers which want to use per-CPU interrupts should start using
INTR_CPUS instead of simply assigning interrupts to all available CPUs.
In the future we may wish to add tunables to control the policy of
INTR_CPUS (e.g. should it be local-only or global, should it ignore
SMT threads or not).

The x86 nexus driver exposes the internal set of interrupt CPUs from the
the x86 interrupt code via INTR_CPUS.

The ACPI bus driver and PCI bridge drivers use _PXM to return a suitable
LOCAL_CPUS set when _PXM exists and DEVICE_NUMA is enabled.  They also and
the global INTR_CPUS set from the nexus driver with the per-domain set from
_PXM to generate a local INTR_CPUS set for child devices.

Compared to the r298933, this version uses 'struct _cpuset' in
<sys/bus.h> instead of 'cpuset_t' to avoid requiring <sys/param.h>
(<sys/_cpuset.h> still requires <sys/param.h> for MAXCPU even though
<sys/_bitset.h> does not after recent changes).
16 files changed:
share/man/man9/BUS_GET_CPUS.9 [new file with mode: 0644]
share/man/man9/Makefile
sys/amd64/include/intr_machdep.h
sys/dev/acpica/acpi.c
sys/dev/acpica/acpi_pci.c
sys/dev/acpica/acpi_pcib.c
sys/dev/acpica/acpi_pcib_acpi.c
sys/dev/acpica/acpi_pcib_pci.c
sys/dev/acpica/acpi_pcibvar.h
sys/dev/acpica/acpivar.h
sys/i386/include/intr_machdep.h
sys/kern/bus_if.m
sys/kern/subr_bus.c
sys/sys/bus.h
sys/x86/x86/intr_machdep.c
sys/x86/x86/nexus.c