提交 8f7020d3 编写于 作者: R Randy Dunlap 提交者: Greg Kroah-Hartman

[PATCH] kernel-doc: PCI fixes

PCI: add descriptions for missing function parameters.
Eliminate all kernel-doc warnings here.
Signed-off-by: NRandy Dunlap <rdunlap@xenotime.net>
Signed-off-by: NGreg Kroah-Hartman <gregkh@suse.de>
上级 f05aab8e
...@@ -575,6 +575,8 @@ static int msi_capability_init(struct pci_dev *dev) ...@@ -575,6 +575,8 @@ static int msi_capability_init(struct pci_dev *dev)
/** /**
* msix_capability_init - configure device's MSI-X capability * msix_capability_init - configure device's MSI-X capability
* @dev: pointer to the pci_dev data structure of MSI-X device function * @dev: pointer to the pci_dev data structure of MSI-X device function
* @entries: pointer to an array of struct msix_entry entries
* @nvec: number of @entries
* *
* Setup the MSI-X capability structure of device function with a * Setup the MSI-X capability structure of device function with a
* single MSI-X vector. A return of zero indicates the successful setup of * single MSI-X vector. A return of zero indicates the successful setup of
......
...@@ -26,7 +26,10 @@ struct pci_dynid { ...@@ -26,7 +26,10 @@ struct pci_dynid {
#ifdef CONFIG_HOTPLUG #ifdef CONFIG_HOTPLUG
/** /**
* store_new_id * store_new_id - add a new PCI device ID to this driver and re-probe devices
* @driver: target device driver
* @buf: buffer for scanning device ID data
* @count: input size
* *
* Adds a new dynamic pci device ID to this driver, * Adds a new dynamic pci device ID to this driver,
* and causes the driver to probe for all devices again. * and causes the driver to probe for all devices again.
...@@ -194,6 +197,8 @@ static int pci_call_probe(struct pci_driver *drv, struct pci_dev *dev, ...@@ -194,6 +197,8 @@ static int pci_call_probe(struct pci_driver *drv, struct pci_dev *dev,
/** /**
* __pci_device_probe() * __pci_device_probe()
* @drv: driver to call to check if it wants the PCI device
* @pci_dev: PCI device being probed
* *
* returns 0 on success, else error. * returns 0 on success, else error.
* side-effect: pci_dev->driver is set to drv when drv claims pci_dev. * side-effect: pci_dev->driver is set to drv when drv claims pci_dev.
...@@ -440,11 +445,11 @@ pci_dev_driver(const struct pci_dev *dev) ...@@ -440,11 +445,11 @@ pci_dev_driver(const struct pci_dev *dev)
/** /**
* pci_bus_match - Tell if a PCI device structure has a matching PCI device id structure * pci_bus_match - Tell if a PCI device structure has a matching PCI device id structure
* @ids: array of PCI device id structures to search in
* @dev: the PCI device structure to match against * @dev: the PCI device structure to match against
* @drv: the device driver to search for matching PCI device id structures
* *
* Used by a driver to check whether a PCI device present in the * Used by a driver to check whether a PCI device present in the
* system is in its list of supported devices.Returns the matching * system is in its list of supported devices. Returns the matching
* pci_device_id structure or %NULL if there is no match. * pci_device_id structure or %NULL if there is no match.
*/ */
static int pci_bus_match(struct device *dev, struct device_driver *drv) static int pci_bus_match(struct device *dev, struct device_driver *drv)
......
...@@ -252,6 +252,8 @@ pci_restore_bars(struct pci_dev *dev) ...@@ -252,6 +252,8 @@ pci_restore_bars(struct pci_dev *dev)
pci_update_resource(dev, &dev->resource[i], i); pci_update_resource(dev, &dev->resource[i], i);
} }
int (*platform_pci_set_power_state)(struct pci_dev *dev, pci_power_t t);
/** /**
* pci_set_power_state - Set the power state of a PCI device * pci_set_power_state - Set the power state of a PCI device
* @dev: PCI device to be suspended * @dev: PCI device to be suspended
...@@ -266,7 +268,6 @@ pci_restore_bars(struct pci_dev *dev) ...@@ -266,7 +268,6 @@ pci_restore_bars(struct pci_dev *dev)
* -EIO if device does not support PCI PM. * -EIO if device does not support PCI PM.
* 0 if we can successfully change the power state. * 0 if we can successfully change the power state.
*/ */
int (*platform_pci_set_power_state)(struct pci_dev *dev, pci_power_t t);
int int
pci_set_power_state(struct pci_dev *dev, pci_power_t state) pci_set_power_state(struct pci_dev *dev, pci_power_t state)
{ {
...@@ -808,8 +809,8 @@ pci_clear_mwi(struct pci_dev *dev) ...@@ -808,8 +809,8 @@ pci_clear_mwi(struct pci_dev *dev)
/** /**
* pci_intx - enables/disables PCI INTx for device dev * pci_intx - enables/disables PCI INTx for device dev
* @dev: the PCI device to operate on * @pdev: the PCI device to operate on
* @enable: boolean * @enable: boolean: whether to enable or disable PCI INTx
* *
* Enables/disables PCI INTx for device dev * Enables/disables PCI INTx for device dev
*/ */
......
...@@ -669,6 +669,7 @@ static void pci_release_dev(struct device *dev) ...@@ -669,6 +669,7 @@ static void pci_release_dev(struct device *dev)
/** /**
* pci_cfg_space_size - get the configuration space size of the PCI device. * pci_cfg_space_size - get the configuration space size of the PCI device.
* @dev: PCI device
* *
* Regular PCI devices have 256 bytes, but PCI-X 2 and PCI Express devices * Regular PCI devices have 256 bytes, but PCI-X 2 and PCI Express devices
* have 4096 bytes. Even if the device is capable, that doesn't mean we can * have 4096 bytes. Even if the device is capable, that doesn't mean we can
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册