From: Josh Hilke <jrhilke@google.com>
To: Alex Williamson <alex@shazbot.org>
Cc: David Matlack <dmatlack@google.com>,
Josh Hilke <jrhilke@google.com>,
kvm@vger.kernel.org, linux-kernel@vger.kernel.org,
Sean Christopherson <seanjc@google.com>,
Vipin Sharma <vipinsh@google.com>
Subject: [PATCH v8] vfio: selftests: Find devices that have VFIO selftest drivers
Date: Wed, 18 Nov 2026 06:43:08 +0000 [thread overview]
Message-ID: <20261118064309.219592-1-jrhilke@google.com> (raw)
Add list_supported_devices.sh to print the PCI addresses and names of
devices on the host that have a VFIO selftest driver. Group the output
into supported and unusable sections based on whether vfio-pci is loaded
and whether the vfio-pci denylist blocks the device.
Add -q to print only the PCI addresses of usable devices so the output
can go straight to setup.sh. Add -a for use with -q to include unusable
devices as well.
When vfio-pci is loaded with disable_denylist=Y, the script lists the
denylisted devices under "Supported (on denylist, but denylist
disabled):" and includes them in the -q output. When vfio-pci is not
loaded, the script lists all devices as unusable and omits them from -q
unless -a is also passed.
Example on a host with Intel IOAT and Intel DSA devices when vfio-pci is
loaded with disable_denylist=N:
$ ./list_supported_devices.sh
Supported:
0000:00:04.0 - Intel IOAT SKX [8086:2021]
...
Unusable (available, but denylisted by the kernel):
0000:6a:01.0 - Intel DSA SPR [8086:0b25]
...
To use denylisted devices, load vfio-pci with disable_denylist=1
(or boot the kernel with vfio_pci.disable_denylist=1).
$ ./list_supported_devices.sh -q
0000:00:04.0
...
$ ./list_supported_devices.sh -q -a
0000:00:04.0
...
0000:6a:01.0
...
Suggested-by: Sean Christopherson <seanjc@google.com>
Signed-off-by: Josh Hilke <jrhilke@google.com>
---
Changelog
v7 -> v8
- Group devices under Supported and Unusable headers instead of
repeating denylist state on every line, and shorten the denylist hint
at the end of the denylisted section. Suggested by Sean.
- Check /sys/bus/pci/drivers/vfio-pci to verify that vfio-pci is loaded,
mark devices as unusable when it is not loaded, and omit them from -q
unless -a is passed. Suggested by Sean.
- Add -a for use with -q to include unusable devices in the SBDF output.
Suggested by Sean.
v7: https://lore.kernel.org/kvm/20261106051726.3964374-1-jrhilke@google.com/
v6: https://lore.kernel.org/kvm/20260602222941.3133236-1-jrhilke@google.com/
v5: https://lore.kernel.org/kvm/20260602185615.3025904-1-jrhilke@google.com/
tools/testing/selftests/vfio/Makefile | 1 +
.../vfio/scripts/list_supported_devices.sh | 199 ++++++++++++++++++
2 files changed, 200 insertions(+)
create mode 100755 tools/testing/selftests/vfio/scripts/list_supported_devices.sh
diff --git a/tools/testing/selftests/vfio/Makefile b/tools/testing/selftests/vfio/Makefile
index 2c32c48db509..160aa989828f 100644
--- a/tools/testing/selftests/vfio/Makefile
+++ b/tools/testing/selftests/vfio/Makefile
@@ -16,6 +16,7 @@ TEST_GEN_PROGS += vfio_pci_sriov_uapi_test
TEST_FILES += scripts/cleanup.sh
TEST_FILES += scripts/lib.sh
+TEST_FILES += scripts/list_supported_devices.sh
TEST_FILES += scripts/run.sh
TEST_FILES += scripts/setup.sh
diff --git a/tools/testing/selftests/vfio/scripts/list_supported_devices.sh b/tools/testing/selftests/vfio/scripts/list_supported_devices.sh
new file mode 100755
index 000000000000..c909b2aedd01
--- /dev/null
+++ b/tools/testing/selftests/vfio/scripts/list_supported_devices.sh
@@ -0,0 +1,199 @@
+#!/bin/bash
+# SPDX-License-Identifier: GPL-2.0-or-later
+
+# Devices that have a driver in selftests/vfio/lib/drivers.
+readonly DEVICES=(
+ "8086:0b25,Intel DSA SPR"
+ "8086:11fb,Intel DSA GNR-D"
+ "8086:1212,Intel DSA DMR"
+ "8086:2021,Intel IOAT SKX"
+ "8086:10c9,Intel 82576 Gigabit Ethernet Controller"
+ "15b3:1011,Mellanox Connect-IB"
+ "15b3:1012,Mellanox Connect-IB VF"
+ "15b3:1013,Mellanox ConnectX-4"
+ "15b3:1014,Mellanox ConnectX-4 VF"
+ "15b3:1015,Mellanox ConnectX-4LX"
+ "15b3:1016,Mellanox ConnectX-4LX VF"
+ "15b3:1017,Mellanox ConnectX-5"
+ "15b3:1018,Mellanox ConnectX-5 VF"
+ "15b3:1019,Mellanox ConnectX-5 Ex"
+ "15b3:101a,Mellanox ConnectX-5 Ex VF"
+ "15b3:101b,Mellanox ConnectX-6"
+ "15b3:101c,Mellanox ConnectX-6 VF"
+ "15b3:101d,Mellanox ConnectX-6 Dx"
+ "15b3:101e,Mellanox ConnectX-6 Dx VF"
+ "15b3:101f,Mellanox ConnectX-6 LX"
+ "15b3:1021,Mellanox ConnectX-7"
+ "15b3:1023,Mellanox ConnectX-8"
+ "15b3:1025,Mellanox ConnectX-9"
+ "15b3:1027,Mellanox ConnectX-10"
+ "15b3:2101,Mellanox ConnectX-10 NVLink-C2C"
+ "15b3:a2d2,Mellanox BlueField integrated ConnectX-5"
+ "15b3:a2d3,Mellanox BlueField integrated ConnectX-5 VF"
+ "15b3:a2d6,Mellanox BlueField-2 integrated ConnectX-6 Dx"
+ "15b3:a2dc,Mellanox BlueField-3 integrated ConnectX-7"
+ "15b3:a2df,Mellanox BlueField-4 integrated ConnectX-8"
+)
+
+# Devices in DEVICES that are also on the vfio-pci denylist. The denylist is
+# in vfio_pci_dev_in_denylist() in drivers/vfio/pci/vfio_pci.c.
+readonly DENYLIST=(
+ "8086:0b25"
+)
+
+readonly DISABLE_DENYLIST=/sys/module/vfio_pci/parameters/disable_denylist
+readonly VFIO_PCI_DRIVER=/sys/bus/pci/drivers/vfio-pci
+
+function vfio_pci_loaded() {
+ [ -d ${VFIO_PCI_DRIVER} ]
+}
+
+function denylisted() {
+ local id
+
+ for id in "${DENYLIST[@]}"; do
+ [ "${id}" = "${1}" ] && return 0
+ done
+
+ return 1
+}
+
+function denylist_enforced() {
+ local value
+
+ read -r value 2>/dev/null < ${DISABLE_DENYLIST}
+ [ "${value}" != "Y" ]
+}
+
+function is_blocked() {
+ if ! vfio_pci_loaded; then
+ return 0
+ fi
+
+ denylisted ${1} && denylist_enforced
+}
+
+function device_name() {
+ local entry
+
+ for entry in "${DEVICES[@]}"; do
+ if [ "${entry%%,*}" = "${1}" ]; then
+ echo "${entry#*,}"
+ return 0
+ fi
+ done
+
+ return 1
+}
+
+function print_allowed_devices() {
+ local device
+
+ if vfio_pci_loaded; then
+ echo "Supported:"
+ else
+ echo "Unusable (available, but vfio-pci not loaded):"
+ fi
+
+ for device in "$@"; do
+ echo " ${device}"
+ done
+}
+
+function print_denylisted_devices() {
+ local device
+
+ if ! vfio_pci_loaded; then
+ echo "Unusable (available, but vfio-pci not loaded, and denylisted by the kernel):"
+ elif denylist_enforced; then
+ echo "Unusable (available, but denylisted by the kernel):"
+ else
+ echo "Supported (on denylist, but denylist disabled):"
+ fi
+
+ for device in "$@"; do
+ echo " ${device}"
+ done
+
+ if ! vfio_pci_loaded || denylist_enforced; then
+ echo
+ echo " To use denylisted devices, load vfio-pci with disable_denylist=1"
+ echo " (or boot the kernel with vfio_pci.disable_denylist=1)."
+ fi
+}
+
+function usage() {
+ echo "Usage: $0 [-q] [-a]" >&2
+ echo >&2
+ echo "Options:" >&2
+ echo " -q Print only the PCI addresses of usable devices." >&2
+ echo " -a Include unusable devices when used with -q." >&2
+ exit 1
+}
+
+# Print the segment:bus:device.function numbers of PCI devices that can be used
+# to run VFIO selftests.
+function main() {
+ local denylisted_devices=()
+ local allowed_devices=()
+ local quiet=""
+ local all=""
+ local vendor
+ local device
+ local name
+ local bdf
+ local opt
+ local id
+
+ while getopts "qa" opt; do
+ case $opt in
+ q) quiet="true" ;;
+ a) all="true" ;;
+ \?) usage ;;
+ esac
+ done
+
+ if [ "${all}" ] && [ -z "${quiet}" ]; then
+ usage
+ fi
+
+ for bdf in $(ls /sys/bus/pci/devices); do
+ read -r vendor < /sys/bus/pci/devices/${bdf}/vendor
+ read -r device < /sys/bus/pci/devices/${bdf}/device
+ printf -v id "%04x:%04x" ${vendor} ${device}
+
+ name=$(device_name ${id}) || continue
+
+ if [ "${quiet}" ]; then
+ if [ "${all}" ] || ! is_blocked ${id}; then
+ echo "${bdf}"
+ fi
+ continue
+ fi
+
+ if denylisted ${id}; then
+ denylisted_devices+=("${bdf} - ${name} [${id}]")
+ else
+ allowed_devices+=("${bdf} - ${name} [${id}]")
+ fi
+ done
+
+ if [ "${quiet}" ]; then
+ return 0
+ fi
+
+ if [ ${#allowed_devices[@]} -eq 0 ] && [ ${#denylisted_devices[@]} -eq 0 ]; then
+ echo "No devices with a VFIO selftest driver found." >&2
+ return 0
+ fi
+
+ if [ ${#allowed_devices[@]} -gt 0 ]; then
+ print_allowed_devices "${allowed_devices[@]}"
+ fi
+
+ if [ ${#denylisted_devices[@]} -gt 0 ]; then
+ print_denylisted_devices "${denylisted_devices[@]}"
+ fi
+}
+
+main "$@"
--
2.56.0.679.gc527c65306-goog
next reply other threads:[~2026-11-18 6:43 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-18 6:43 Josh Hilke [this message]
2026-11-19 0:43 ` [PATCH v8] vfio: selftests: Find devices that have VFIO selftest drivers David Matlack
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261118064309.219592-1-jrhilke@google.com \
--to=jrhilke@google.com \
--cc=alex@shazbot.org \
--cc=dmatlack@google.com \
--cc=kvm@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=seanjc@google.com \
--cc=vipinsh@google.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.