rapidio: fix new kernel-doc warnings
Fix a bunch of new rapidio kernel-doc warnings: Warning(include/linux/rio.h:123): No description found for parameter 'comp_tag' Warning(include/linux/rio.h:123): No description found for parameter 'phys_efptr' Warning(include/linux/rio.h:123): No description found for parameter 'em_efptr' Warning(include/linux/rio.h:123): No description found for parameter 'pwcback' Warning(include/linux/rio.h:247): No description found for parameter 'set_domain' Warning(include/linux/rio.h:247): No description found for parameter 'get_domain' Warning(drivers/rapidio/rio-scan.c:1133): No description found for parameter 'rdev' Warning(drivers/rapidio/rio-scan.c:1133): Excess function parameter 'port' description in 'rio_init_em' Warning(drivers/rapidio/rio.c:349): No description found for parameter 'rdev' Warning(drivers/rapidio/rio.c:349): Excess function parameter 'mport' description in 'rio_request_inb_pwrite' Warning(drivers/rapidio/rio.c:393): No description found for parameter 'port' Warning(drivers/rapidio/rio.c:393): No description found for parameter 'local' Warning(drivers/rapidio/rio.c:393): No description found for parameter 'destid' Warning(drivers/rapidio/rio.c:393): No description found for parameter 'hopcount' Warning(drivers/rapidio/rio.c:393): Excess function parameter 'rdev' description in 'rio_mport_get_physefb' Warning(drivers/rapidio/rio.c:845): Excess function parameter 'local' description in 'rio_std_route_clr_table' Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com> Cc: Alexandre Bounine <alexandre.bounine@idt.com> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
This commit is contained in:
parent
06b2e9886e
commit
97ef6f7449
3 changed files with 13 additions and 5 deletions
|
@ -1124,7 +1124,7 @@ static void rio_update_route_tables(struct rio_mport *port)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* rio_init_em - Initializes RIO Error Management (for switches)
|
* rio_init_em - Initializes RIO Error Management (for switches)
|
||||||
* @port: Master port associated with the RIO network
|
* @rdev: RIO device
|
||||||
*
|
*
|
||||||
* For each enumerated switch, call device-specific error management
|
* For each enumerated switch, call device-specific error management
|
||||||
* initialization routine (if supplied by the switch driver).
|
* initialization routine (if supplied by the switch driver).
|
||||||
|
|
|
@ -338,7 +338,7 @@ int rio_release_outb_dbell(struct rio_dev *rdev, struct resource *res)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* rio_request_inb_pwrite - request inbound port-write message service
|
* rio_request_inb_pwrite - request inbound port-write message service
|
||||||
* @mport: RIO device to which register inbound port-write callback routine
|
* @rdev: RIO device to which register inbound port-write callback routine
|
||||||
* @pwcback: Callback routine to execute when port-write is received
|
* @pwcback: Callback routine to execute when port-write is received
|
||||||
*
|
*
|
||||||
* Binds a port-write callback function to the RapidIO device.
|
* Binds a port-write callback function to the RapidIO device.
|
||||||
|
@ -385,7 +385,10 @@ EXPORT_SYMBOL_GPL(rio_release_inb_pwrite);
|
||||||
/**
|
/**
|
||||||
* rio_mport_get_physefb - Helper function that returns register offset
|
* rio_mport_get_physefb - Helper function that returns register offset
|
||||||
* for Physical Layer Extended Features Block.
|
* for Physical Layer Extended Features Block.
|
||||||
* @rdev: RIO device
|
* @port: Master port to issue transaction
|
||||||
|
* @local: Indicate a local master port or remote device access
|
||||||
|
* @destid: Destination ID of the device
|
||||||
|
* @hopcount: Number of switch hops to the device
|
||||||
*/
|
*/
|
||||||
u32
|
u32
|
||||||
rio_mport_get_physefb(struct rio_mport *port, int local,
|
rio_mport_get_physefb(struct rio_mport *port, int local,
|
||||||
|
@ -430,7 +433,7 @@ rio_mport_get_physefb(struct rio_mport *port, int local,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* rio_get_comptag - Begin or continue searching for a RIO device by component tag
|
* rio_get_comptag - Begin or continue searching for a RIO device by component tag
|
||||||
* @comp_tag: RIO component tad to match
|
* @comp_tag: RIO component tag to match
|
||||||
* @from: Previous RIO device found in search, or %NULL for new search
|
* @from: Previous RIO device found in search, or %NULL for new search
|
||||||
*
|
*
|
||||||
* Iterates through the list of known RIO devices. If a RIO device is
|
* Iterates through the list of known RIO devices. If a RIO device is
|
||||||
|
@ -835,7 +838,6 @@ int rio_std_route_get_entry(struct rio_mport *mport, u16 destid, u8 hopcount,
|
||||||
* rio_std_route_clr_table - Clear swotch route table using standard registers
|
* rio_std_route_clr_table - Clear swotch route table using standard registers
|
||||||
* defined in RIO specification rev.1.3.
|
* defined in RIO specification rev.1.3.
|
||||||
* @mport: Master port to issue transaction
|
* @mport: Master port to issue transaction
|
||||||
* @local: Indicate a local master port or remote device access
|
|
||||||
* @destid: Destination ID of the device
|
* @destid: Destination ID of the device
|
||||||
* @hopcount: Number of switch hops to the device
|
* @hopcount: Number of switch hops to the device
|
||||||
* @table: routing table ID (global or port-specific)
|
* @table: routing table ID (global or port-specific)
|
||||||
|
|
|
@ -88,11 +88,15 @@ union rio_pw_msg;
|
||||||
* @swpinfo: Switch port info
|
* @swpinfo: Switch port info
|
||||||
* @src_ops: Source operation capabilities
|
* @src_ops: Source operation capabilities
|
||||||
* @dst_ops: Destination operation capabilities
|
* @dst_ops: Destination operation capabilities
|
||||||
|
* @comp_tag: RIO component tag
|
||||||
|
* @phys_efptr: RIO device extended features pointer
|
||||||
|
* @em_efptr: RIO Error Management features pointer
|
||||||
* @dma_mask: Mask of bits of RIO address this device implements
|
* @dma_mask: Mask of bits of RIO address this device implements
|
||||||
* @rswitch: Pointer to &struct rio_switch if valid for this device
|
* @rswitch: Pointer to &struct rio_switch if valid for this device
|
||||||
* @driver: Driver claiming this device
|
* @driver: Driver claiming this device
|
||||||
* @dev: Device model device
|
* @dev: Device model device
|
||||||
* @riores: RIO resources this device owns
|
* @riores: RIO resources this device owns
|
||||||
|
* @pwcback: port-write callback function for this device
|
||||||
* @destid: Network destination ID
|
* @destid: Network destination ID
|
||||||
*/
|
*/
|
||||||
struct rio_dev {
|
struct rio_dev {
|
||||||
|
@ -222,6 +226,8 @@ struct rio_net {
|
||||||
* @add_entry: Callback for switch-specific route add function
|
* @add_entry: Callback for switch-specific route add function
|
||||||
* @get_entry: Callback for switch-specific route get function
|
* @get_entry: Callback for switch-specific route get function
|
||||||
* @clr_table: Callback for switch-specific clear route table function
|
* @clr_table: Callback for switch-specific clear route table function
|
||||||
|
* @set_domain: Callback for switch-specific domain setting function
|
||||||
|
* @get_domain: Callback for switch-specific domain get function
|
||||||
* @em_init: Callback for switch-specific error management initialization function
|
* @em_init: Callback for switch-specific error management initialization function
|
||||||
* @em_handle: Callback for switch-specific error management handler function
|
* @em_handle: Callback for switch-specific error management handler function
|
||||||
*/
|
*/
|
||||||
|
|
Loading…
Reference in a new issue