Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 388b74d3 authored by Sebastian Ott's avatar Sebastian Ott Committed by Martin Schwidefsky
Browse files

s390/cio/device_ops: fix kernel doc 



Fix an incorrect kernel doc comment in device_ops.c. Also
provide proper function markups while at it.

Signed-off-by: default avatarSebastian Ott <sebott@linux.vnet.ibm.com>
Signed-off-by: default avatarMartin Schwidefsky <schwidefsky@de.ibm.com>
parent 0f5d050c

drivers/s390/cio/device_ops.c

+11 −11
Original line number Diff line number Diff line
@@ -97,7 +97,7 @@ void ccw_device_clear_options(struct ccw_device *cdev, unsigned long flags) 
}



/**

 * ccw_device_is_pathgroup - determine if paths to this device are grouped

 * ccw_device_is_pathgroup() - determine if paths to this device are grouped

 * @cdev: ccw device

 *

 * Return non-zero if there is a path group, zero otherwise.
@@ -109,7 +109,7 @@ int ccw_device_is_pathgroup(struct ccw_device *cdev) 
EXPORT_SYMBOL(ccw_device_is_pathgroup);



/**

 * ccw_device_is_multipath - determine if device is operating in multipath mode

 * ccw_device_is_multipath() - determine if device is operating in multipath mode

 * @cdev: ccw device

 *

 * Return non-zero if device is operating in multipath mode, zero otherwise.
@@ -457,7 +457,7 @@ __u8 ccw_device_get_path_mask(struct ccw_device *cdev) 
}



/**

 * chp_get_chp_desc - return newly allocated channel-path descriptor

 * ccw_device_get_chp_desc() - return newly allocated channel-path descriptor

 * @cdev: device to obtain the descriptor for

 * @chp_idx: index of the channel path

 *
@@ -477,7 +477,7 @@ struct channel_path_desc *ccw_device_get_chp_desc(struct ccw_device *cdev, 
}



/**

 * ccw_device_get_id - obtain a ccw device id

 * ccw_device_get_id() - obtain a ccw device id

 * @cdev: device to obtain the id for

 * @dev_id: where to fill in the values

 */
@@ -488,7 +488,7 @@ void ccw_device_get_id(struct ccw_device *cdev, struct ccw_dev_id *dev_id) 
EXPORT_SYMBOL(ccw_device_get_id);



/**

 * ccw_device_tm_start_key - perform start function

 * ccw_device_tm_start_key() - perform start function

 * @cdev: ccw device on which to perform the start function

 * @tcw: transport-command word to be started

 * @intparm: user defined parameter to be passed to the interrupt handler
@@ -533,7 +533,7 @@ int ccw_device_tm_start_key(struct ccw_device *cdev, struct tcw *tcw, 
EXPORT_SYMBOL(ccw_device_tm_start_key);



/**

 * ccw_device_tm_start_timeout_key - perform start function

 * ccw_device_tm_start_timeout_key() - perform start function

 * @cdev: ccw device on which to perform the start function

 * @tcw: transport-command word to be started

 * @intparm: user defined parameter to be passed to the interrupt handler
@@ -559,7 +559,7 @@ int ccw_device_tm_start_timeout_key(struct ccw_device *cdev, struct tcw *tcw, 
EXPORT_SYMBOL(ccw_device_tm_start_timeout_key);



/**

 * ccw_device_tm_start - perform start function

 * ccw_device_tm_start() - perform start function

 * @cdev: ccw device on which to perform the start function

 * @tcw: transport-command word to be started

 * @intparm: user defined parameter to be passed to the interrupt handler
@@ -577,7 +577,7 @@ int ccw_device_tm_start(struct ccw_device *cdev, struct tcw *tcw, 
EXPORT_SYMBOL(ccw_device_tm_start);



/**

 * ccw_device_tm_start_timeout - perform start function

 * ccw_device_tm_start_timeout() - perform start function

 * @cdev: ccw device on which to perform the start function

 * @tcw: transport-command word to be started

 * @intparm: user defined parameter to be passed to the interrupt handler
@@ -596,7 +596,7 @@ int ccw_device_tm_start_timeout(struct ccw_device *cdev, struct tcw *tcw, 
EXPORT_SYMBOL(ccw_device_tm_start_timeout);



/**

 * ccw_device_get_mdc - accumulate max data count

 * ccw_device_get_mdc() - accumulate max data count

 * @cdev: ccw device for which the max data count is accumulated

 * @mask: mask of paths to use

 *
@@ -642,7 +642,7 @@ int ccw_device_get_mdc(struct ccw_device *cdev, u8 mask) 
EXPORT_SYMBOL(ccw_device_get_mdc);



/**

 * ccw_device_tm_intrg - perform interrogate function

 * ccw_device_tm_intrg() - perform interrogate function

 * @cdev: ccw device on which to perform the interrogate function

 *

 * Perform an interrogate function on the given ccw device. Return zero on
@@ -664,7 +664,7 @@ int ccw_device_tm_intrg(struct ccw_device *cdev) 
EXPORT_SYMBOL(ccw_device_tm_intrg);



/**

 * ccw_device_get_schid - obtain a subchannel id

 * ccw_device_get_schid() - obtain a subchannel id

 * @cdev: device to obtain the id for

 * @schid: where to fill in the values

 */