Commit 507127f7 authored by R Veera Kumar's avatar R Veera Kumar Committed by Greg Kroah-Hartman

staging: vc04_services: interface: vchi: Correct long line comments and make them C89 style

Correct long lines of comments to respect 80 character per line
limit and make them C89 style one.
Found using checkpatch.pl.
Signed-off-by: default avatarR Veera Kumar <vkor@vkten.in>
Link: https://lore.kernel.org/r/20200320024337.4754-1-vkor@vkten.inSigned-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 56faa3c8
...@@ -33,10 +33,14 @@ enum vchi_crc_control { ...@@ -33,10 +33,14 @@ enum vchi_crc_control {
enum vchi_callback_reason { enum vchi_callback_reason {
VCHI_CALLBACK_REASON_MIN, VCHI_CALLBACK_REASON_MIN,
//This indicates that there is data available /*
//handle is the msg id that was transmitted with the data * This indicates that there is data available handle is the msg id that
// When a message is received and there was no FULL message available previously, send callback * was transmitted with the data
// Tasks get kicked by the callback, reset their event and try and read from the fifo until it fails * When a message is received and there was no FULL message available
* previously, send callback
* Tasks get kicked by the callback, reset their event and try and read
* from the fifo until it fails
*/
VCHI_CALLBACK_MSG_AVAILABLE, VCHI_CALLBACK_MSG_AVAILABLE,
VCHI_CALLBACK_MSG_SENT, VCHI_CALLBACK_MSG_SENT,
VCHI_CALLBACK_MSG_SPACE_AVAILABLE, // XXX not yet implemented VCHI_CALLBACK_MSG_SPACE_AVAILABLE, // XXX not yet implemented
...@@ -51,9 +55,11 @@ enum vchi_callback_reason { ...@@ -51,9 +55,11 @@ enum vchi_callback_reason {
VCHI_CALLBACK_SERVICE_CLOSED, VCHI_CALLBACK_SERVICE_CLOSED,
// this side has sent XOFF to peer due to lack of data consumption by service /*
// (suggests the service may need to take some recovery action if it has * this side has sent XOFF to peer due to lack of data consumption by
// been deliberately holding off consuming data) * service (suggests the service may need to take some recovery action
* if it has been deliberately holding off consuming data)
*/
VCHI_CALLBACK_SENT_XOFF, VCHI_CALLBACK_SENT_XOFF,
VCHI_CALLBACK_SENT_XON, VCHI_CALLBACK_SENT_XON,
...@@ -112,12 +118,16 @@ struct vchi_msg_vector { ...@@ -112,12 +118,16 @@ struct vchi_msg_vector {
int32_t vec_len; int32_t vec_len;
}; };
// Iterator structure for reading ahead through received message queue. Allocated by client, /*
// initialised by vchi_msg_look_ahead. Fields are for internal VCHI use only. * Iterator structure for reading ahead through received message queue.
// Iterates over messages in queue at the instant of the call to vchi_msg_lookahead - * Allocated by client, initialised by vchi_msg_look_ahead. Fields are for
// will not proceed to messages received since. Behaviour is undefined if an iterator * internal VCHI use only.
// is used again after messages for that service are removed/dequeued by any * Iterates over messages in queue at the instant of the call to
// means other than vchi_msg_iter_... calls on the iterator itself. * vchi_msg_lookahead - will not proceed to messages received since.
* Behaviour is undefined if an iterator is used again after messages for that
* service are removed/dequeued by any means other than vchi_msg_iter_...
* calls on the iterator itself.
*/
struct vchi_msg_iter { struct vchi_msg_iter {
struct opaque_vchi_service_t *service; struct opaque_vchi_service_t *service;
void *last; void *last;
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment