Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

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: Sebastian Ott <sebott@linux.vnet.ibm.com>
Signed-off-by: Martin Schwidefsky <schwidefsky@de.ibm.com>

authored by

Sebastian Ott and committed by
Martin Schwidefsky
364e3f90 65875530

+9 -11
+5 -5
drivers/s390/cio/chp.c
··· 412 412 413 413 /** 414 414 * chp_update_desc - update channel-path description 415 - * @chp - channel-path 415 + * @chp: channel-path 416 416 * 417 417 * Update the channel-path description of the specified channel-path 418 418 * including channel measurement related information. ··· 438 438 439 439 /** 440 440 * chp_new - register a new channel-path 441 - * @chpid - channel-path ID 441 + * @chpid: channel-path ID 442 442 * 443 443 * Create and register data structure representing new channel-path. Return 444 444 * zero on success, non-zero otherwise. ··· 730 730 731 731 /** 732 732 * chp_cfg_schedule - schedule chpid configuration request 733 - * @chpid - channel-path ID 734 - * @configure - Non-zero for configure, zero for deconfigure 733 + * @chpid: channel-path ID 734 + * @configure: Non-zero for configure, zero for deconfigure 735 735 * 736 736 * Schedule a channel-path configuration/deconfiguration request. 737 737 */ ··· 747 747 748 748 /** 749 749 * chp_cfg_cancel_deconfigure - cancel chpid deconfiguration request 750 - * @chpid - channel-path ID 750 + * @chpid: channel-path ID 751 751 * 752 752 * Cancel an active channel-path deconfiguration request if it has not yet 753 753 * been performed.
+1 -1
drivers/s390/cio/cio.c
··· 1059 1059 1060 1060 /** 1061 1061 * cio_tm_intrg - perform interrogate function 1062 - * @sch - subchannel on which to perform the interrogate function 1062 + * @sch: subchannel on which to perform the interrogate function 1063 1063 * 1064 1064 * If the specified subchannel is running in transport-mode, perform the 1065 1065 * interrogate function. Return zero on success, non-zero otherwie.
+1 -1
drivers/s390/cio/itcw.c
··· 15 15 #include <asm/fcx.h> 16 16 #include <asm/itcw.h> 17 17 18 - /** 18 + /* 19 19 * struct itcw - incremental tcw helper data type 20 20 * 21 21 * This structure serves as a handle for the incremental construction of a
+1 -3
drivers/s390/cio/qdio_main.c
··· 72 72 * @mask: which output queues to process 73 73 * @bb: busy bit indicator, set only if SIGA-w/wt could not access a buffer 74 74 * @fc: function code to perform 75 + * @aob: asynchronous operation block 75 76 * 76 77 * Returns condition code. 77 78 * Note: For IQDC unicast queues only the highest priority queue is processed. ··· 1762 1761 * @response: Response code will be stored at this address 1763 1762 * @cb: Callback function will be executed for each element 1764 1763 * of the address list 1765 - * @priv: Pointer passed from the caller to qdio_pnso_brinfo() 1766 - * @type: Type of the address entry passed to the callback 1767 - * @entry: Entry containg the address of the specified type 1768 1764 * @priv: Pointer to pass to the callback function. 1769 1765 * 1770 1766 * Performs "Store-network-bridging-information list" operation and calls
+1 -1
drivers/s390/cio/vfio_ccw_cp.c
··· 835 835 836 836 /** 837 837 * cp_iova_pinned() - check if an iova is pinned for a ccw chain. 838 - * @cmd: ccwchain command on which to perform the operation 838 + * @cp: channel_program on which to perform the operation 839 839 * @iova: the iova to check 840 840 * 841 841 * If the @iova is currently pinned for the ccw chain, return true;