forked from Minki/linux
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:
parent
0f5d050cea
commit
388b74d3a9
@ -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
|
||||||
*/
|
*/
|
||||||
|
Loading…
Reference in New Issue
Block a user