mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-21 08:19:28 +00:00
![Alexander Gordeev](/assets/img/avatar_default.png)
Because of the encoding of the "Multiple Message Capable" and "Multiple Message Enable" fields, a device can only advertise that it's capable of a power-of-two number of vectors, and the OS can only enable a power-of-two number. For example, a device that's limited internally to using 18 vectors would have to advertise that it's capable of 32. The 14 extra vectors consume vector numbers and IRQ descriptors even though the device can't actually use them. This fix introduces a 'msi_desc::nvec_used' field to address this issue. When non-zero, it is the actual number of MSIs the device will send, as requested by the device driver. This value should be used by architectures to set up and tear down only as many interrupt resources as the device will actually use. Note, although the existing 'msi_desc::multiple' field might seem redundant, in fact it is not. The number of MSIs advertised need not be the smallest power-of-two larger than the number of MSIs the device will send. Thus, it is not always possible to derive the former from the latter, so we need to keep them both to handle this case. [bhelgaas: changelog, rename to "nvec_used"] Signed-off-by: Alexander Gordeev <agordeev@redhat.com> Signed-off-by: Bjorn Helgaas <bhelgaas@google.com>
62 lines
1.8 KiB
C
62 lines
1.8 KiB
C
#ifndef LINUX_MSI_H
|
|
#define LINUX_MSI_H
|
|
|
|
#include <linux/kobject.h>
|
|
#include <linux/list.h>
|
|
|
|
struct msi_msg {
|
|
u32 address_lo; /* low 32 bits of msi message address */
|
|
u32 address_hi; /* high 32 bits of msi message address */
|
|
u32 data; /* 16 bits of msi message data */
|
|
};
|
|
|
|
/* Helper functions */
|
|
struct irq_data;
|
|
struct msi_desc;
|
|
void mask_msi_irq(struct irq_data *data);
|
|
void unmask_msi_irq(struct irq_data *data);
|
|
void __read_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
|
|
void __get_cached_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
|
|
void __write_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
|
|
void read_msi_msg(unsigned int irq, struct msi_msg *msg);
|
|
void get_cached_msi_msg(unsigned int irq, struct msi_msg *msg);
|
|
void write_msi_msg(unsigned int irq, struct msi_msg *msg);
|
|
|
|
struct msi_desc {
|
|
struct {
|
|
__u8 is_msix : 1;
|
|
__u8 multiple: 3; /* log2 number of messages */
|
|
__u8 maskbit : 1; /* mask-pending bit supported ? */
|
|
__u8 is_64 : 1; /* Address size: 0=32bit 1=64bit */
|
|
__u8 pos; /* Location of the msi capability */
|
|
__u16 entry_nr; /* specific enabled entry */
|
|
unsigned default_irq; /* default pre-assigned irq */
|
|
} msi_attrib;
|
|
|
|
u32 masked; /* mask bits */
|
|
unsigned int irq;
|
|
unsigned int nvec_used; /* number of messages */
|
|
struct list_head list;
|
|
|
|
union {
|
|
void __iomem *mask_base;
|
|
u8 mask_pos;
|
|
};
|
|
struct pci_dev *dev;
|
|
|
|
/* Last set MSI message */
|
|
struct msi_msg msg;
|
|
|
|
struct kobject kobj;
|
|
};
|
|
|
|
/*
|
|
* The arch hook for setup up msi irqs
|
|
*/
|
|
int arch_setup_msi_irq(struct pci_dev *dev, struct msi_desc *desc);
|
|
void arch_teardown_msi_irq(unsigned int irq);
|
|
int arch_setup_msi_irqs(struct pci_dev *dev, int nvec, int type);
|
|
void arch_teardown_msi_irqs(struct pci_dev *dev);
|
|
int arch_msi_check_device(struct pci_dev* dev, int nvec, int type);
|
|
|
|
#endif /* LINUX_MSI_H */
|