Minki/linux
1
0
Fork 1
mirror of https://github.com/torvalds/linux.git synced 2024-11-10 22:21:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

s390/cio: fix kernel-doc usage

Browse Source 
Fix the kernel-doc usage in cio to get rid of (W=1) build warnings like:
drivers/s390/cio/cio.c:1068: warning: No description found for parameter 'sch'

Signed-off-by: Sebastian Ott <sebott@linux.vnet.ibm.com>
Signed-off-by: Martin Schwidefsky <schwidefsky@de.ibm.com>
This commit is contained in:
Sebastian Ott 2018-01-29 12:55:29 +01:00 committed by Martin Schwidefsky
parent 6587553031
commit 364e3f90f8
5 changed files with 9 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
drivers/s390/cio/chp.c
View File

@ -412,7 +412,7 @@ static void chp_release(struct device *dev)
/** /**
* chp_update_desc - update channel-path description * chp_update_desc - update channel-path description
* @chp - channel-path * @chp: channel-path
* *
* Update the channel-path description of the specified channel-path * Update the channel-path description of the specified channel-path
* including channel measurement related information. * including channel measurement related information.
@ -438,7 +438,7 @@ int chp_update_desc(struct channel_path *chp)
/** /**
* chp_new - register a new channel-path * chp_new - register a new channel-path
* @chpid - channel-path ID * @chpid: channel-path ID
* *
* Create and register data structure representing new channel-path. Return * Create and register data structure representing new channel-path. Return
* zero on success, non-zero otherwise. * zero on success, non-zero otherwise.
@ -730,8 +730,8 @@ static void cfg_func(struct work_struct *work)
/** /**
* chp_cfg_schedule - schedule chpid configuration request * chp_cfg_schedule - schedule chpid configuration request
* @chpid - channel-path ID * @chpid: channel-path ID
* @configure - Non-zero for configure, zero for deconfigure * @configure: Non-zero for configure, zero for deconfigure
* *
* Schedule a channel-path configuration/deconfiguration request. * Schedule a channel-path configuration/deconfiguration request.
*/ */
@ -747,7 +747,7 @@ void chp_cfg_schedule(struct chp_id chpid, int configure)
/** /**
* chp_cfg_cancel_deconfigure - cancel chpid deconfiguration request * chp_cfg_cancel_deconfigure - cancel chpid deconfiguration request
* @chpid - channel-path ID * @chpid: channel-path ID
* *
* Cancel an active channel-path deconfiguration request if it has not yet * Cancel an active channel-path deconfiguration request if it has not yet
* been performed. * been performed.

2
drivers/s390/cio/cio.c
View File

@ -1059,7 +1059,7 @@ EXPORT_SYMBOL_GPL(cio_tm_start_key);
/** /**
* cio_tm_intrg - perform interrogate function * cio_tm_intrg - perform interrogate function
* @sch - subchannel on which to perform the interrogate function * @sch: subchannel on which to perform the interrogate function
* *
* If the specified subchannel is running in transport-mode, perform the * If the specified subchannel is running in transport-mode, perform the
* interrogate function. Return zero on success, non-zero otherwie. * interrogate function. Return zero on success, non-zero otherwie.

2
drivers/s390/cio/itcw.c
View File

@ -15,7 +15,7 @@
#include <asm/fcx.h> #include <asm/fcx.h>
#include <asm/itcw.h> #include <asm/itcw.h>
/** /*
* struct itcw - incremental tcw helper data type * struct itcw - incremental tcw helper data type
* *
* This structure serves as a handle for the incremental construction of a * This structure serves as a handle for the incremental construction of a

4
drivers/s390/cio/qdio_main.c
View File

@ -72,6 +72,7 @@ static inline int do_siga_input(unsigned long schid, unsigned int mask,
* @mask: which output queues to process * @mask: which output queues to process
* @bb: busy bit indicator, set only if SIGA-w/wt could not access a buffer * @bb: busy bit indicator, set only if SIGA-w/wt could not access a buffer
* @fc: function code to perform * @fc: function code to perform
* @aob: asynchronous operation block
* *
* Returns condition code. * Returns condition code.
* Note: For IQDC unicast queues only the highest priority queue is processed. * Note: For IQDC unicast queues only the highest priority queue is processed.
@ -1761,9 +1762,6 @@ EXPORT_SYMBOL(qdio_stop_irq);
* @response: Response code will be stored at this address * @response: Response code will be stored at this address
* @cb: Callback function will be executed for each element * @cb: Callback function will be executed for each element
* of the address list * of the address list
* @priv: Pointer passed from the caller to qdio_pnso_brinfo()
* @type: Type of the address entry passed to the callback
* @entry: Entry containg the address of the specified type
* @priv: Pointer to pass to the callback function. * @priv: Pointer to pass to the callback function.
* *
* Performs "Store-network-bridging-information list" operation and calls * Performs "Store-network-bridging-information list" operation and calls

2
drivers/s390/cio/vfio_ccw_cp.c
View File

@ -835,7 +835,7 @@ void cp_update_scsw(struct channel_program *cp, union scsw *scsw)
/** /**
* cp_iova_pinned() - check if an iova is pinned for a ccw chain. * cp_iova_pinned() - check if an iova is pinned for a ccw chain.
* @cmd: ccwchain command on which to perform the operation * @cp: channel_program on which to perform the operation
* @iova: the iova to check * @iova: the iova to check
* *
* If the @iova is currently pinned for the ccw chain, return true; * If the @iova is currently pinned for the ccw chain, return true;