Commit 2f0cd59c authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Bjorn Helgaas
Browse files

PCI: Fix kernel-doc markup 

Update kernel-doc so the names in the doc match the prototypes.

Link: https://lore.kernel.org/r/f19caf7a68f8365c8b573a42b4ac89ec21925c73.1603469755.git.mchehab+huawei@kernel.org


Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: default avatarBjorn Helgaas <bhelgaas@google.com>
parent f8394f23

drivers/pci/p2pdma.c

+5 −5
Original line number Diff line number Diff line
@@ -609,7 +609,7 @@ bool pci_has_p2pmem(struct pci_dev *pdev) 
EXPORT_SYMBOL_GPL(pci_has_p2pmem);



/**

 * pci_p2pmem_find - find a peer-to-peer DMA memory device compatible with

 * pci_p2pmem_find_many - find a peer-to-peer DMA memory device compatible with

 *	the specified list of clients and shortest distance (as determined

 *	by pci_p2pmem_dma())

 * @clients: array of devices to check (NULL-terminated)
@@ -674,7 +674,7 @@ struct pci_dev *pci_p2pmem_find_many(struct device **clients, int num_clients) 
EXPORT_SYMBOL_GPL(pci_p2pmem_find_many);



/**

 * pci_alloc_p2p_mem - allocate peer-to-peer DMA memory

 * pci_alloc_p2pmem - allocate peer-to-peer DMA memory

 * @pdev: the device to allocate memory from

 * @size: number of bytes to allocate

 *
@@ -727,7 +727,7 @@ void pci_free_p2pmem(struct pci_dev *pdev, void *addr, size_t size) 
EXPORT_SYMBOL_GPL(pci_free_p2pmem);



/**

 * pci_virt_to_bus - return the PCI bus address for a given virtual

 * pci_p2pmem_virt_to_bus - return the PCI bus address for a given virtual

 *	address obtained with pci_alloc_p2pmem()

 * @pdev: the device the memory was allocated from

 * @addr: address of the memory that was allocated
@@ -859,7 +859,7 @@ static int __pci_p2pdma_map_sg(struct pci_p2pdma_pagemap *p2p_pgmap, 
}



/**

 * pci_p2pdma_map_sg - map a PCI peer-to-peer scatterlist for DMA

 * pci_p2pdma_map_sg_attrs - map a PCI peer-to-peer scatterlist for DMA

 * @dev: device doing the DMA request

 * @sg: scatter list to map

 * @nents: elements in the scatterlist
@@ -896,7 +896,7 @@ int pci_p2pdma_map_sg_attrs(struct device *dev, struct scatterlist *sg, 
EXPORT_SYMBOL_GPL(pci_p2pdma_map_sg_attrs);



/**

 * pci_p2pdma_unmap_sg - unmap a PCI peer-to-peer scatterlist that was

 * pci_p2pdma_unmap_sg_attrs - unmap a PCI peer-to-peer scatterlist that was

 *	mapped with pci_p2pdma_map_sg()

 * @dev: device doing the DMA request

 * @sg: scatter list to map

drivers/pci/pci-driver.c

+2 −2
Original line number Diff line number Diff line
@@ -90,7 +90,7 @@ static void pci_free_dynids(struct pci_driver *drv) 
}



/**

 * store_new_id - sysfs frontend to pci_add_dynid()

 * new_id_store - sysfs frontend to pci_add_dynid()

 * @driver: target device driver

 * @buf: buffer for scanning device ID data

 * @count: input size
@@ -158,7 +158,7 @@ static ssize_t new_id_store(struct device_driver *driver, const char *buf, 
static DRIVER_ATTR_WO(new_id);



/**

 * store_remove_id - remove a PCI device ID from this driver

 * remove_id_store - remove a PCI device ID from this driver

 * @driver: target device driver

 * @buf: buffer for scanning device ID data

 * @count: input size

drivers/pci/pci.c

+1 −1
Original line number Diff line number Diff line
@@ -3480,7 +3480,7 @@ bool pci_acs_enabled(struct pci_dev *pdev, u16 acs_flags) 
}



/**

 * pci_acs_path_enable - test ACS flags from start to end in a hierarchy

 * pci_acs_path_enabled - test ACS flags from start to end in a hierarchy

 * @start: starting downstream device

 * @end: ending upstream device or NULL to search to the root bus

 * @acs_flags: required flags

drivers/pci/probe.c

+2 −2
Original line number Diff line number Diff line
@@ -165,7 +165,7 @@ static inline unsigned long decode_bar(struct pci_dev *dev, u32 bar) 
#define PCI_COMMAND_DECODE_ENABLE	(PCI_COMMAND_MEMORY | PCI_COMMAND_IO)



/**

 * pci_read_base - Read a PCI BAR

 * __pci_read_base - Read a PCI BAR

 * @dev: the PCI device

 * @type: type of the BAR

 * @res: resource buffer to be filled in
@@ -1612,7 +1612,7 @@ static bool pci_ext_cfg_is_aliased(struct pci_dev *dev) 
}



/**

 * pci_cfg_space_size - Get the configuration space size of the PCI device

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

drivers/pci/slot.c

+3 −2
Original line number Diff line number Diff line
@@ -323,7 +323,7 @@ EXPORT_SYMBOL_GPL(pci_destroy_slot); 
#if defined(CONFIG_HOTPLUG_PCI) || defined(CONFIG_HOTPLUG_PCI_MODULE)

#include <linux/pci_hotplug.h>

/**

 * pci_hp_create_link - create symbolic link to the hotplug driver module.

 * pci_hp_create_module_link - create symbolic link to hotplug driver module

 * @pci_slot: struct pci_slot

 *

 * Helper function for pci_hotplug_core.c to create symbolic link to
@@ -349,7 +349,8 @@ void pci_hp_create_module_link(struct pci_slot *pci_slot) 
EXPORT_SYMBOL_GPL(pci_hp_create_module_link);



/**

 * pci_hp_remove_link - remove symbolic link to the hotplug driver module.

 * pci_hp_remove_module_link - remove symbolic link to the hotplug driver

 * 	module.

 * @pci_slot: struct pci_slot

 *

 * Helper function for pci_hotplug_core.c to remove symbolic link to