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: Sebastian Ott <sebott@linux.vnet.ibm.com>
Signed-off-by: Martin Schwidefsky <schwidefsky@de.ibm.com>
This commit is contained in:
Sebastian Ott 2016-06-23 11:09:26 +02:00 committed by Martin Schwidefsky
parent 0f5d050cea
commit 388b74d3a9

View File

@ -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 * @cdev: ccw device
* *
* Return non-zero if there is a path group, zero otherwise. * 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); 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 * @cdev: ccw device
* *
* Return non-zero if device is operating in multipath mode, zero otherwise. * 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 * @cdev: device to obtain the descriptor for
* @chp_idx: index of the channel path * @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 * @cdev: device to obtain the id for
* @dev_id: where to fill in the values * @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); 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 * @cdev: ccw device on which to perform the start function
* @tcw: transport-command word to be started * @tcw: transport-command word to be started
* @intparm: user defined parameter to be passed to the interrupt handler * @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); 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 * @cdev: ccw device on which to perform the start function
* @tcw: transport-command word to be started * @tcw: transport-command word to be started
* @intparm: user defined parameter to be passed to the interrupt handler * @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); 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 * @cdev: ccw device on which to perform the start function
* @tcw: transport-command word to be started * @tcw: transport-command word to be started
* @intparm: user defined parameter to be passed to the interrupt handler * @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); 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 * @cdev: ccw device on which to perform the start function
* @tcw: transport-command word to be started * @tcw: transport-command word to be started
* @intparm: user defined parameter to be passed to the interrupt handler * @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); 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 * @cdev: ccw device for which the max data count is accumulated
* @mask: mask of paths to use * @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); 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 * @cdev: ccw device on which to perform the interrogate function
* *
* Perform an interrogate function on the given ccw device. Return zero on * 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); 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 * @cdev: device to obtain the id for
* @schid: where to fill in the values * @schid: where to fill in the values
*/ */