Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8f7020d3 authored by Randy Dunlap's avatar Randy Dunlap Committed by Greg Kroah-Hartman
Browse files

[PATCH] kernel-doc: PCI fixes 



PCI: add descriptions for missing function parameters.
Eliminate all kernel-doc warnings here.

Signed-off-by: default avatarRandy Dunlap <rdunlap@xenotime.net>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@suse.de>
parent f05aab8e

drivers/pci/msi.c

+2 −0
Original line number Diff line number Diff line
@@ -575,6 +575,8 @@ static int msi_capability_init(struct pci_dev *dev) 
/**

 * msix_capability_init - configure device's MSI-X capability

 * @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

 * single MSI-X vector. A return of zero indicates the successful setup of

drivers/pci/pci-driver.c

+9 −4
Original line number Diff line number Diff line
@@ -26,7 +26,10 @@ struct pci_dynid { 
#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,

 * 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, 


/**

 * __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.

 * side-effect: pci_dev->driver is set to drv when drv claims pci_dev.
@@ -440,8 +445,8 @@ pci_dev_driver(const struct pci_dev *dev) 


/**

 * 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

 * @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

 * system is in its list of supported devices. Returns the matching

drivers/pci/pci.c

+4 −3
Original line number Diff line number Diff line
@@ -252,6 +252,8 @@ pci_restore_bars(struct pci_dev *dev) 
		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

 * @dev: PCI device to be suspended
@@ -266,7 +268,6 @@ pci_restore_bars(struct pci_dev *dev) 
 * -EIO if device does not support PCI PM.

 * 0 if we can successfully change the power state.

 */

int (*platform_pci_set_power_state)(struct pci_dev *dev, pci_power_t t);

int

pci_set_power_state(struct pci_dev *dev, pci_power_t state)

{
@@ -808,8 +809,8 @@ pci_clear_mwi(struct pci_dev *dev) 


/**

 * pci_intx - enables/disables PCI INTx for device dev

 * @dev: the PCI device to operate on

 * @enable: boolean

 * @pdev: the PCI device to operate on

 * @enable: boolean: whether to enable or disable PCI INTx

 *

 * Enables/disables PCI INTx for device dev

 */

drivers/pci/probe.c

+1 −0
Original line number Diff line number Diff line
@@ -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.

 * @dev: PCI device

 *

 * 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