Commit 364e3f90 authored by Sebastian Ott's avatar Sebastian Ott Committed by Martin Schwidefsky
Browse files

s390/cio: fix kernel-doc usage 



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: default avatarSebastian Ott <sebott@linux.vnet.ibm.com>
Signed-off-by: default avatarMartin Schwidefsky <schwidefsky@de.ibm.com>
parent 65875530

drivers/s390/cio/chp.c

+5 −5
Original line number Diff line number Diff line
@@ -412,7 +412,7 @@ static void chp_release(struct device *dev) 


/**

 * chp_update_desc - update channel-path description

 * @chp - channel-path

 * @chp: channel-path

 *

 * Update the channel-path description of the specified channel-path

 * including channel measurement related information.
@@ -438,7 +438,7 @@ int chp_update_desc(struct channel_path *chp) 


/**

 * 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

 * 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

 * @chpid - channel-path ID

 * @configure - Non-zero for configure, zero for deconfigure

 * @chpid: channel-path ID

 * @configure: Non-zero for configure, zero for deconfigure

 *

 * 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

 * @chpid - channel-path ID

 * @chpid: channel-path ID

 *

 * Cancel an active channel-path deconfiguration request if it has not yet

 * been performed.

drivers/s390/cio/cio.c

+1 −1
Original line number Diff line number Diff line
@@ -1059,7 +1059,7 @@ EXPORT_SYMBOL_GPL(cio_tm_start_key); 


/**

 * 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

 * interrogate function. Return zero on success, non-zero otherwie.

drivers/s390/cio/itcw.c

+1 −1
Original line number Diff line number Diff line
@@ -15,7 +15,7 @@ 
#include <asm/fcx.h>

#include <asm/itcw.h>



/**

/*

 * struct itcw - incremental tcw helper data type

 *

 * This structure serves as a handle for the incremental construction of a

drivers/s390/cio/qdio_main.c

+1 −3
Original line number Diff line number Diff line
@@ -72,6 +72,7 @@ static inline int do_siga_input(unsigned long schid, unsigned int mask, 
 * @mask: which output queues to process

 * @bb: busy bit indicator, set only if SIGA-w/wt could not access a buffer

 * @fc: function code to perform

 * @aob: asynchronous operation block

 *

 * Returns condition code.

 * 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

 * @cb: 		Callback function will be executed for each element

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

 *

 * Performs "Store-network-bridging-information list" operation and calls

drivers/s390/cio/vfio_ccw_cp.c

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

 * @cmd: ccwchain command on which to perform the operation

 * @cp: channel_program on which to perform the operation

 * @iova: the iova to check

 *

 * If the @iova is currently pinned for the ccw chain, return true;