linux/Documentation
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
..
2013-11-12 15:01:39 +09:00
2013-04-02 09:39:55 -07:00
2013-10-17 21:18:32 +02:00
2013-07-24 22:06:34 -07:00
2013-01-10 01:27:46 +01:00
2013-07-25 12:34:15 +02:00
2013-09-15 17:41:30 -04:00
2013-10-16 13:35:02 -07:00
2013-11-14 11:04:40 -08:00
2013-09-25 12:34:32 +01:00
2013-04-16 18:47:19 +09:00
2012-12-05 23:52:10 +00:00
2013-10-24 10:51:33 +02:00
2013-09-05 16:36:21 -06:00