Release 4.16 drivers/pci/pci.h

Directory: drivers/pci
/* SPDX-License-Identifier: GPL-2.0 */
#ifndef DRIVERS_PCI_H

#define DRIVERS_PCI_H


#define PCI_FIND_CAP_TTL	48


#define PCI_VSEC_ID_INTEL_TBT	0x1234	
/* Thunderbolt */

extern const unsigned char pcie_link_speed[];

bool pcie_cap_has_lnkctl(const struct pci_dev *dev);

/* Functions internal to the PCI core code */

int pci_create_sysfs_dev_files(struct pci_dev *pdev);
void pci_remove_sysfs_dev_files(struct pci_dev *pdev);
#if !defined(CONFIG_DMI) && !defined(CONFIG_ACPI)


static inline void pci_create_firmware_label_files(struct pci_dev *pdev)
{ return; }
Contributors
Person Tokens Prop Commits CommitProp
Narendra K 13 100.00% 2 100.00%
Total 13 100.00% 2 100.00%



static inline void pci_remove_firmware_label_files(struct pci_dev *pdev)
{ return; }
Contributors
Person Tokens Prop Commits CommitProp
Narendra K 13 100.00% 2 100.00%
Total 13 100.00% 2 100.00%

#else
void pci_create_firmware_label_files(struct pci_dev *pdev);
void pci_remove_firmware_label_files(struct pci_dev *pdev);
#endif
void pci_cleanup_rom(struct pci_dev *dev);


enum pci_mmap_api {
	
PCI_MMAP_SYSFS,	/* mmap on /sys/bus/pci/devices/<BDF>/resource<N> */
	
PCI_MMAP_PROCFS	/* mmap on /proc/bus/pci/<BDF> */
};
int pci_mmap_fits(struct pci_dev *pdev, int resno, struct vm_area_struct *vmai,
		  enum pci_mmap_api mmap_api);

int pci_probe_reset_function(struct pci_dev *dev);

/**
 * struct pci_platform_pm_ops - Firmware PM callbacks
 *
 * @is_manageable: returns 'true' if given device is power manageable by the
 *                 platform firmware
 *
 * @set_state: invokes the platform firmware to set the device's power state
 *
 * @get_state: queries the platform firmware for a device's current power state
 *
 * @choose_state: returns PCI power state of given device preferred by the
 *                platform; to be used during system-wide transitions from a
 *                sleeping state to the working state and vice versa
 *
 * @set_wakeup: enables/disables wakeup capability for the device
 *
 * @need_resume: returns 'true' if the given device (which is currently
 *               suspended) needs to be resumed to be configured for system
 *               wakeup.
 *
 * If given platform is generally capable of power managing PCI devices, all of
 * these callbacks are mandatory.
 */

struct pci_platform_pm_ops {
	
bool (*is_manageable)(struct pci_dev *dev);
	
int (*set_state)(struct pci_dev *dev, pci_power_t state);
	
pci_power_t (*get_state)(struct pci_dev *dev);
	
pci_power_t (*choose_state)(struct pci_dev *dev);
	
int (*set_wakeup)(struct pci_dev *dev, bool enable);
	
bool (*need_resume)(struct pci_dev *dev);
};

int pci_set_platform_pm(const struct pci_platform_pm_ops *ops);
void pci_update_current_state(struct pci_dev *dev, pci_power_t state);
void pci_power_up(struct pci_dev *dev);
void pci_disable_enabled_device(struct pci_dev *dev);
int pci_finish_runtime_suspend(struct pci_dev *dev);
int __pci_pme_wakeup(struct pci_dev *dev, void *ign);
void pci_pme_restore(struct pci_dev *dev);
bool pci_dev_keep_suspended(struct pci_dev *dev);
void pci_dev_complete_resume(struct pci_dev *pci_dev);
void pci_config_pm_runtime_get(struct pci_dev *dev);
void pci_config_pm_runtime_put(struct pci_dev *dev);
void pci_pm_init(struct pci_dev *dev);
void pci_ea_init(struct pci_dev *dev);
void pci_allocate_cap_save_buffers(struct pci_dev *dev);
void pci_free_cap_save_buffers(struct pci_dev *dev);
bool pci_bridge_d3_possible(struct pci_dev *dev);
void pci_bridge_d3_update(struct pci_dev *dev);



static inline void pci_wakeup_event(struct pci_dev *dev)
{
	/* Wait 100 ms before the system can be put into a sleep state. */
	pm_wakeup_event(&dev->dev, 100);
}

Contributors
Person Tokens Prop Commits CommitProp
Rafael J. Wysocki 23 100.00% 1 100.00%
Total 23 100.00% 1 100.00%



static inline bool pci_has_subordinate(struct pci_dev *pci_dev)
{
	return !!(pci_dev->subordinate);
}

Contributors
Person Tokens Prop Commits CommitProp
Rafael J. Wysocki 20 95.24% 1 50.00%
Yijing Wang 1 4.76% 1 50.00%
Total 21 100.00% 2 100.00%



static inline bool pci_power_manageable(struct pci_dev *pci_dev)
{
	/*
         * Currently we allow normal PCI devices and PCI bridges transition
         * into D3 if their bridge_d3 is set.
         */
	return !pci_has_subordinate(pci_dev) || pci_dev->bridge_d3;
}

Contributors
Person Tokens Prop Commits CommitProp
Mika Westerberg 24 100.00% 1 100.00%
Total 24 100.00% 1 100.00%


struct pci_vpd_ops {
	
ssize_t (*read)(struct pci_dev *dev, loff_t pos, size_t count, void *buf);
	
ssize_t (*write)(struct pci_dev *dev, loff_t pos, size_t count, const void *buf);
	
int (*set_size)(struct pci_dev *dev, size_t len);
};


struct pci_vpd {
	
const struct pci_vpd_ops *ops;
	
struct bin_attribute *attr;	/* Descriptor for sysfs VPD entry */
	
struct mutex	lock;
	
unsigned int	len;
	
u16		flag;
	
u8		cap;
	
u8		busy:1;
	
u8		valid:1;
};

int pci_vpd_init(struct pci_dev *dev);
void pci_vpd_release(struct pci_dev *dev);

/* PCI /proc functions */
#ifdef CONFIG_PROC_FS
int pci_proc_attach_device(struct pci_dev *dev);
int pci_proc_detach_device(struct pci_dev *dev);
int pci_proc_detach_bus(struct pci_bus *bus);
#else


static inline int pci_proc_attach_device(struct pci_dev *dev) { return 0; }
Contributors
Person Tokens Prop Commits CommitProp
Greg Kroah-Hartman 15 100.00% 1 100.00%
Total 15 100.00% 1 100.00%



static inline int pci_proc_detach_device(struct pci_dev *dev) { return 0; }
Contributors
Person Tokens Prop Commits CommitProp
Greg Kroah-Hartman 15 100.00% 1 100.00%
Total 15 100.00% 1 100.00%



static inline int pci_proc_detach_bus(struct pci_bus *bus) { return 0; }
Contributors
Person Tokens Prop Commits CommitProp
Greg Kroah-Hartman 15 100.00% 1 100.00%
Total 15 100.00% 1 100.00%

#endif

/* Functions for PCI Hotplug drivers to use */
int pci_hp_add_bridge(struct pci_dev *dev);

#ifdef HAVE_PCI_LEGACY
void pci_create_legacy_files(struct pci_bus *bus);
void pci_remove_legacy_files(struct pci_bus *bus);
#else


static inline void pci_create_legacy_files(struct pci_bus *bus) { return; }
Contributors
Person Tokens Prop Commits CommitProp
Benjamin Herrenschmidt 13 100.00% 1 100.00%
Total 13 100.00% 1 100.00%



static inline void pci_remove_legacy_files(struct pci_bus *bus) { return; }
Contributors
Person Tokens Prop Commits CommitProp
Benjamin Herrenschmidt 13 100.00% 1 100.00%
Total 13 100.00% 1 100.00%

#endif

/* Lock for read/write access to pci device and bus lists */
extern struct rw_semaphore pci_bus_sem;

extern raw_spinlock_t pci_lock;

extern unsigned int pci_pm_d3_delay;

#ifdef CONFIG_PCI_MSI
void pci_no_msi(void);
#else


static inline void pci_no_msi(void) { }
Contributors
Person Tokens Prop Commits CommitProp
Matthew Wilcox 8 100.00% 1 100.00%
Total 8 100.00% 1 100.00%

#endif



static inline void pci_msi_set_enable(struct pci_dev *dev, int enable)
{
	u16 control;

	pci_read_config_word(dev, dev->msi_cap + PCI_MSI_FLAGS, &control);
	control &= ~PCI_MSI_FLAGS_ENABLE;
	if (enable)
		control |= PCI_MSI_FLAGS_ENABLE;
	pci_write_config_word(dev, dev->msi_cap + PCI_MSI_FLAGS, control);
}

Contributors
Person Tokens Prop Commits CommitProp
Michael S. Tsirkin 58 100.00% 1 100.00%
Total 58 100.00% 1 100.00%



static inline void pci_msix_clear_and_set_ctrl(struct pci_dev *dev, u16 clear, u16 set)
{
	u16 ctrl;

	pci_read_config_word(dev, dev->msix_cap + PCI_MSIX_FLAGS, &ctrl);
	ctrl &= ~clear;
	ctrl |= set;
	pci_write_config_word(dev, dev->msix_cap + PCI_MSIX_FLAGS, ctrl);
}

Contributors
Person Tokens Prop Commits CommitProp
Michael S. Tsirkin 57 100.00% 1 100.00%
Total 57 100.00% 1 100.00%

void pci_realloc_get_opt(char *);



static inline int pci_no_d1d2(struct pci_dev *dev)
{
	unsigned int parent_dstates = 0;

	if (dev->bus->self)
		parent_dstates = dev->bus->self->no_d1d2;
	return (dev->no_d1d2 || parent_dstates);

}
Contributors
Person Tokens Prop Commits CommitProp
Kristen Carlson Accardi 45 100.00% 1 100.00%
Total 45 100.00% 1 100.00%

extern const struct attribute_group *pci_dev_groups[];
extern const struct attribute_group *pcibus_groups[];
extern const struct device_type pci_dev_type;
extern const struct attribute_group *pci_bus_groups[];


/**
 * pci_match_one_device - Tell if a PCI device structure has a matching
 *                        PCI device id structure
 * @id: single PCI device id structure to match
 * @dev: the PCI device structure to match against
 *
 * Returns the matching pci_device_id structure or %NULL if there is no match.
 */

static inline const struct pci_device_id *

pci_match_one_device(const struct pci_device_id *id, const struct pci_dev *dev)
{
	if ((id->vendor == PCI_ANY_ID || id->vendor == dev->vendor) &&
	    (id->device == PCI_ANY_ID || id->device == dev->device) &&
	    (id->subvendor == PCI_ANY_ID || id->subvendor == dev->subsystem_vendor) &&
	    (id->subdevice == PCI_ANY_ID || id->subdevice == dev->subsystem_device) &&
	    !((id->class ^ dev->class) & id->class_mask))
		return id;
	return NULL;
}

Contributors
Person Tokens Prop Commits CommitProp
Greg Kroah-Hartman 111 100.00% 1 100.00%
Total 111 100.00% 1 100.00%

/* PCI slot sysfs helper code */

#define to_pci_slot(s) container_of(s, struct pci_slot, kobj)

extern struct kset *pci_slots_kset;


struct pci_slot_attribute {
	
struct attribute attr;
	
ssize_t (*show)(struct pci_slot *, char *);
	
ssize_t (*store)(struct pci_slot *, const char *, size_t);
};

#define to_pci_slot_attr(s) container_of(s, struct pci_slot_attribute, attr)


enum pci_bar_type {
	
pci_bar_unknown,	/* Standard PCI BAR probe */
	
pci_bar_io,		/* An I/O port BAR */
	
pci_bar_mem32,		/* A 32-bit memory BAR */
	
pci_bar_mem64,		/* A 64-bit memory BAR */
};

int pci_configure_extended_tags(struct pci_dev *dev, void *ign);
bool pci_bus_read_dev_vendor_id(struct pci_bus *bus, int devfn, u32 *pl,
				int crs_timeout);
int pci_setup_device(struct pci_dev *dev);
int __pci_read_base(struct pci_dev *dev, enum pci_bar_type type,
		    struct resource *res, unsigned int reg);
void pci_configure_ari(struct pci_dev *dev);
void __pci_bus_size_bridges(struct pci_bus *bus,
			struct list_head *realloc_head);
void __pci_bus_assign_resources(const struct pci_bus *bus,
				struct list_head *realloc_head,
				struct list_head *fail_head);
bool pci_bus_clip_resource(struct pci_dev *dev, int idx);

void pci_reassigndev_resource_alignment(struct pci_dev *dev);
void pci_disable_bridge_window(struct pci_dev *dev);

/* Single Root I/O Virtualization */

struct pci_sriov {
	
int		pos;		/* Capability position */
	
int		nres;		/* Number of resources */
	
u32		cap;		/* SR-IOV Capabilities */
	
u16		ctrl;		/* SR-IOV Control */
	
u16		total_VFs;	/* Total VFs associated with the PF */
	
u16		initial_VFs;	/* Initial VFs associated with the PF */
	
u16		num_VFs;	/* Number of VFs available */
	
u16		offset;		/* First VF Routing ID offset */
	
u16		stride;		/* Following VF stride */
	
u16		vf_device;	/* VF device ID */
	
u32		pgsz;		/* Page size for BAR alignment */
	
u8		link;		/* Function Dependency Link */
	
u8		max_VF_buses;	/* Max buses consumed by VFs */
	
u16		driver_max_VFs;	/* Max num VFs driver supports */
	
struct pci_dev	*dev;		/* Lowest numbered PF */
	
struct pci_dev	*self;		/* This PF */
	
resource_size_t	barsz[PCI_SRIOV_NUM_BARS];	/* VF BAR size */
	
bool		drivers_autoprobe; /* Auto probing of VFs by driver */
};

/* pci_dev priv_flags */

#define PCI_DEV_DISCONNECTED 0



static inline int pci_dev_set_disconnected(struct pci_dev *dev, void *unused)
{
	set_bit(PCI_DEV_DISCONNECTED, &dev->priv_flags);
	return 0;
}

Contributors
Person Tokens Prop Commits CommitProp
Keith Busch 29 100.00% 1 100.00%
Total 29 100.00% 1 100.00%



static inline bool pci_dev_is_disconnected(const struct pci_dev *dev)
{
	return test_bit(PCI_DEV_DISCONNECTED, &dev->priv_flags);
}

Contributors
Person Tokens Prop Commits CommitProp
Keith Busch 24 100.00% 1 100.00%
Total 24 100.00% 1 100.00%

#ifdef CONFIG_PCI_ATS
void pci_restore_ats_state(struct pci_dev *dev);
#else


static inline void pci_restore_ats_state(struct pci_dev *dev)
{
}
Contributors
Person Tokens Prop Commits CommitProp
Xudong Hao 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%

#endif /* CONFIG_PCI_ATS */

#ifdef CONFIG_PCI_IOV
int pci_iov_init(struct pci_dev *dev);
void pci_iov_release(struct pci_dev *dev);
void pci_iov_update_resource(struct pci_dev *dev, int resno);
resource_size_t pci_sriov_resource_alignment(struct pci_dev *dev, int resno);
void pci_restore_iov_state(struct pci_dev *dev);
int pci_iov_bus_range(struct pci_bus *bus);

#else


static inline int pci_iov_init(struct pci_dev *dev)
{
	return -ENODEV;
}
Contributors
Person Tokens Prop Commits CommitProp
Yu Zhao 16 100.00% 1 100.00%
Total 16 100.00% 1 100.00%



static inline void pci_iov_release(struct pci_dev *dev)

{
}
Contributors
Person Tokens Prop Commits CommitProp
Yu Zhao 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%



static inline void pci_restore_iov_state(struct pci_dev *dev)
{
}
Contributors
Person Tokens Prop Commits CommitProp
Yu Zhao 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%



static inline int pci_iov_bus_range(struct pci_bus *bus)
{
	return 0;
}

Contributors
Person Tokens Prop Commits CommitProp
Yu Zhao 15 100.00% 1 100.00%
Total 15 100.00% 1 100.00%

#endif /* CONFIG_PCI_IOV */

unsigned long pci_cardbus_resource_alignment(struct resource *);



static inline resource_size_t pci_resource_alignment(struct pci_dev *dev,
						     struct resource *res)
{
#ifdef CONFIG_PCI_IOV
	int resno = res - dev->resource;

	if (resno >= PCI_IOV_RESOURCES && resno <= PCI_IOV_RESOURCE_END)
		return pci_sriov_resource_alignment(dev, resno);
#endif
	if (dev->class >> 8 == PCI_CLASS_BRIDGE_CARDBUS)
		return pci_cardbus_resource_alignment(res);
	return resource_alignment(res);
}

Contributors
Person Tokens Prop Commits CommitProp
Chris Wright 54 76.06% 1 33.33%
Ram Pai 16 22.54% 1 33.33%
Cam Macdonell 1 1.41% 1 33.33%
Total 71 100.00% 3 100.00%

void pci_enable_acs(struct pci_dev *dev);

#ifdef CONFIG_PCIEASPM
void pcie_aspm_init_link_state(struct pci_dev *pdev);
void pcie_aspm_exit_link_state(struct pci_dev *pdev);
void pcie_aspm_pm_state_change(struct pci_dev *pdev);
void pcie_aspm_powersave_config_link(struct pci_dev *pdev);
#else


static inline void pcie_aspm_init_link_state(struct pci_dev *pdev) { }
Contributors
Person Tokens Prop Commits CommitProp
Björn Helgaas 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%



static inline void pcie_aspm_exit_link_state(struct pci_dev *pdev) { }
Contributors
Person Tokens Prop Commits CommitProp
Björn Helgaas 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%



static inline void pcie_aspm_pm_state_change(struct pci_dev *pdev) { }
Contributors
Person Tokens Prop Commits CommitProp
Björn Helgaas 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%



static inline void pcie_aspm_powersave_config_link(struct pci_dev *pdev) { }
Contributors
Person Tokens Prop Commits CommitProp
Björn Helgaas 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%

#endif

#ifdef CONFIG_PCIEASPM_DEBUG
void pcie_aspm_create_sysfs_dev_files(struct pci_dev *pdev);
void pcie_aspm_remove_sysfs_dev_files(struct pci_dev *pdev);
#else


static inline void pcie_aspm_create_sysfs_dev_files(struct pci_dev *pdev) { }
Contributors
Person Tokens Prop Commits CommitProp
Björn Helgaas 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%



static inline void pcie_aspm_remove_sysfs_dev_files(struct pci_dev *pdev) { }
Contributors
Person Tokens Prop Commits CommitProp
Björn Helgaas 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%

#endif

#ifdef CONFIG_PCIE_PTM
void pci_ptm_init(struct pci_dev *dev);
#else


static inline void pci_ptm_init(struct pci_dev *dev) { }
Contributors
Person Tokens Prop Commits CommitProp
Jonathan Yong 11 100.00% 1 100.00%
Total 11 100.00% 1 100.00%

#endif


struct pci_dev_reset_methods {
	
u16 vendor;
	
u16 device;
	
int (*reset)(struct pci_dev *dev, int probe);
};

#ifdef CONFIG_PCI_QUIRKS
int pci_dev_specific_reset(struct pci_dev *dev, int probe);
#else


static inline int pci_dev_specific_reset(struct pci_dev *dev, int probe)
{
	return -ENOTTY;
}
Contributors
Person Tokens Prop Commits CommitProp
Rafael J. Wysocki 19 100.00% 1 100.00%
Total 19 100.00% 1 100.00%

#endif

#if defined(CONFIG_PCI_QUIRKS) && defined(CONFIG_ARM64)
int acpi_get_rc_resources(struct device *dev, const char *hid, u16 segment,
			  struct resource *res);
#endif

u32 pci_rebar_get_possible_sizes(struct pci_dev *pdev, int bar);
int pci_rebar_get_current_size(struct pci_dev *pdev, int bar);
int pci_rebar_set_size(struct pci_dev *pdev, int bar, int size);


static inline u64 pci_rebar_size_to_bytes(int size)
{
	return 1ULL << (size + 20);
}

Contributors
Person Tokens Prop Commits CommitProp
Christian König 19 100.00% 1 100.00%
Total 19 100.00% 1 100.00%

#endif /* DRIVERS_PCI_H */
Overall Contributors
Person Tokens Prop Commits CommitProp
Rafael J. Wysocki 233 11.64% 16 14.95%
Yu Zhao 220 10.99% 8 7.48%
Greg Kroah-Hartman 213 10.64% 10 9.35%
Björn Helgaas 183 9.15% 7 6.54%
Michael S. Tsirkin 124 6.20% 2 1.87%
Ben Hutchings 71 3.55% 1 0.93%
Yinghai Lu 68 3.40% 9 8.41%
Alexander Chiang 67 3.35% 2 1.87%
Chris Wright 65 3.25% 1 0.93%
Narendra K 61 3.05% 3 2.80%
Christian König 58 2.90% 1 0.93%
Keith Busch 58 2.90% 1 0.93%
Kristen Carlson Accardi 51 2.55% 2 1.87%
Benjamin Herrenschmidt 42 2.10% 1 0.93%
Mika Westerberg 39 1.95% 1 0.93%
Dongdong Liu 35 1.75% 1 0.93%
Jiang Liu 34 1.70% 1 0.93%
Ram Pai 29 1.45% 2 1.87%
Xudong Hao 28 1.40% 1 0.93%
Dexuan Cui 27 1.35% 1 0.93%
Jonathan Yong 27 1.35% 1 0.93%
David Shaohua Li 24 1.20% 2 1.87%
Lukas Wunner 20 1.00% 4 3.74%
Jon Smirl 19 0.95% 1 0.93%
Huang Ying 18 0.90% 1 0.93%
Jesse Barnes 16 0.80% 1 0.93%
Yuji Shimada 16 0.80% 1 0.93%
Hariprasad Shenai 15 0.75% 1 0.93%
Martin Wilck 15 0.75% 1 0.93%
Wei Yang 14 0.70% 3 2.80%
Matthew Wilcox 13 0.65% 1 0.93%
Sinan Kaya 13 0.65% 1 0.93%
John Rose 11 0.55% 1 0.93%
Stephen Hemminger 11 0.55% 1 0.93%
Sean O. Stalley 9 0.45% 1 0.93%
Allen M Kay 9 0.45% 1 0.93%
Daniel Stekloff 8 0.40% 1 0.93%
Andrew Morton 7 0.35% 1 0.93%
Jacob E Keller 7 0.35% 1 0.93%
Filippo Sironi 4 0.20% 1 0.93%
Jan Kiszka 4 0.20% 1 0.93%
Yanmin Zhang 3 0.15% 1 0.93%
Bodong Wang 3 0.15% 1 0.93%
Cam Macdonell 2 0.10% 1 0.93%
Donald Dutile 2 0.10% 1 0.93%
Yijing Wang 2 0.10% 2 1.87%
Julia Lawall 1 0.05% 1 0.93%
Bhumika Goyal 1 0.05% 1 0.93%
Mike Travis 1 0.05% 1 0.93%
Total 2001 100.00% 107 100.00%
Directory: drivers/pci

Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
Created with cregit.
Person	Tokens	Prop	Commits	CommitProp
Narendra K	13	100.00%	2	100.00%
Total	13	100.00%	2	100.00%
cregit-Linux how code gets into the kernel

Release 4.16 drivers/pci/pci.h

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Contributors

Overall Contributors
