summaryrefslogtreecommitdiffstats
path: root/Documentation/driver-api/index.rst
diff options
context:
space:
mode:
authorZeng Chi <zengchi@kylinos.cn>2026-09-21 18:24:42 +0800
committerSean Christopherson <seanjc@google.com>2026-09-22 08:36:16 -0700
commit119e9db233ad0f4cbd4cfb9f9385a7bca378b37d (patch)
tree660d50d4139cb750fbde1ae3432452c20726c99d /Documentation/driver-api/index.rst
downloadlinux-stable-119e9db233ad0f4cbd4cfb9f9385a7bca378b37d.tar.gz
linux-stable-119e9db233ad0f4cbd4cfb9f9385a7bca378b37d.zip
KVM: Don't pre-reserve xarray entries when storing empty/NULL attributesgrafted
Skip the xarray reservation loop when clearing all memory attributes, as storing NULL only erases the entry and never needs to allocate, so no reservation (and no cleanup of a failed one) is required in that case. Suggested-by: Sean Christopherson <seanjc@google.com> Cc: David Ballesteros <davimaba.v@proton.me> Signed-off-by: Zeng Chi <zengchi@kylinos.cn> Link: https://patch.msgid.link/20260921102442.1232375-1-zeng_chi911@163.com [sean: split to separate patch] Signed-off-by: Sean Christopherson <seanjc@google.com>
Diffstat (limited to 'Documentation/driver-api/index.rst')
-rw-r--r--Documentation/driver-api/index.rst152
1 files changed, 152 insertions, 0 deletions
diff --git a/Documentation/driver-api/index.rst b/Documentation/driver-api/index.rst
new file mode 100644
index 000000000..6601a2586
--- /dev/null
+++ b/Documentation/driver-api/index.rst
@@ -0,0 +1,152 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+==============================
+Driver implementer's API guide
+==============================
+
+The kernel offers a wide variety of interfaces to support the development
+of device drivers. This document is an only somewhat organized collection
+of some of those interfaces — it will hopefully get better over time! The
+available subsections can be seen below.
+
+
+General information for driver authors
+======================================
+
+This section contains documentation that should, at some point or other, be
+of interest to most developers working on device drivers.
+
+.. toctree::
+ :maxdepth: 1
+
+ basics
+ driver-model/index
+ device_link
+ infrastructure
+ ioctl
+ pm/index
+
+Useful support libraries
+========================
+
+This section contains documentation that should, at some point or other, be
+of interest to most developers working on device drivers.
+
+.. toctree::
+ :maxdepth: 1
+
+ early-userspace/index
+ connector
+ device-io
+ devfreq
+ dma-buf
+ component
+ io-mapping
+ io_ordering
+ uio-howto
+ vfio-mediated-device
+ vfio
+ vfio-pci-device-specific-driver-acceptance
+
+Bus-level documentation
+=======================
+
+.. toctree::
+ :maxdepth: 1
+
+ auxiliary_bus
+ cxl/index
+ eisa
+ firewire
+ i3c/index
+ isa
+ men-chameleon-bus
+ pci/index
+ rapidio/index
+ slimbus
+ usb/index
+ virtio/index
+ vme
+ w1
+ xillybus
+
+
+Subsystem-specific APIs
+=======================
+
+.. toctree::
+ :maxdepth: 1
+
+ 80211/index
+ acpi/index
+ backlight/lp855x-driver.rst
+ clk
+ coco/index
+ console
+ crypto/index
+ dmaengine/index
+ dpll
+ edac
+ extcon
+ firmware/index
+ fpga/index
+ frame-buffer
+ aperture
+ generic-counter
+ generic_pt
+ gpio/index
+ hsi
+ hte/index
+ hw-recoverable-errors
+ i2c
+ iio/index
+ infiniband
+ input
+ interconnect
+ ipmb
+ ipmi
+ issei/index
+ libata
+ mailbox
+ md/index
+ media/index
+ mei/index
+ memory-devices/index
+ message-based
+ misc_devices
+ miscellaneous
+ mmc/index
+ mtd/index
+ mtdnand
+ nfc/index
+ ntb
+ nvdimm/index
+ nvmem
+ parport-lowlevel
+ phy/index
+ pin-control
+ pldmfw/index
+ pps
+ ptp
+ pwm
+ pwrseq
+ regulator
+ reset
+ rfkill
+ s390-drivers
+ scsi
+ serial/index
+ sm501
+ soundwire/index
+ spi
+ surface_aggregator/index
+ switchtec
+ sync_file
+ target
+ tee
+ thermal/index
+ tty/index
+ wbrf
+ wmi
+ xilinx/index
+ zorro