linux/Documentation/PCI
Alexander Gordeev 302a2523c2 PCI/MSI: Add pci_enable_msi_range() and pci_enable_msix_range()
This adds pci_enable_msi_range(), which supersedes the pci_enable_msi()
and pci_enable_msi_block() MSI interfaces.

It also adds pci_enable_msix_range(), which supersedes the
pci_enable_msix() MSI-X interface.

The old interfaces have three categories of return values:

    negative: failure; caller should not retry
    positive: failure; value indicates number of interrupts that *could*
	have been allocated, and caller may retry with a smaller request
    zero: success; at least as many interrupts allocated as requested

It is error-prone to handle these three cases correctly in drivers.

The new functions return either a negative error code or a number of
successfully allocated MSI/MSI-X interrupts, which is expected to lead to
clearer device driver code.

pci_enable_msi(), pci_enable_msi_block() and pci_enable_msix() still exist
unchanged, but are deprecated and may be removed after callers are updated.

[bhelgaas: tweak changelog]
Suggested-by: Ben Hutchings <bhutchings@solarflare.com>
Signed-off-by: Alexander Gordeev <agordeev@redhat.com>
Signed-off-by: Bjorn Helgaas <bhelgaas@google.com>
Reviewed-by: Tejun Heo <tj@kernel.org>
2014-01-03 17:17:55 -07:00
..
00-INDEX Create/use more directory structure in the Documentation/ tree. 2008-11-14 17:28:53 +00:00
MSI-HOWTO.txt PCI/MSI: Add pci_enable_msi_range() and pci_enable_msix_range() 2014-01-03 17:17:55 -07:00
pci-error-recovery.txt Documentation/: it's -> its where appropriate 2010-04-23 02:09:52 +02:00
pci-iov-howto.txt Documentation: remove __dev* attributes. 2013-01-03 15:57:16 -08:00
pci.txt PCI: Update pci_find_slot() description in pci.txt 2013-09-25 15:43:33 -06:00
pcieaer-howto.txt PCI: aerdrv: introduce default_downstream_reset_link 2010-05-11 12:01:38 -07:00
PCIEBUS-HOWTO.txt PCI: Documentation: fix minor PCIe HOWTO thinko 2009-02-13 13:59:19 -08:00