* [PATCH v2] staging: vc04_services: interface: vchi: Correct long lines and style of comments
@ 2020-03-19 10:01 R Veera Kumar
2020-03-19 14:11 ` Greg Kroah-Hartman
0 siblings, 1 reply; 2+ messages in thread
From: R Veera Kumar @ 2020-03-19 10:01 UTC (permalink / raw)
To: Greg Kroah-Hartman; +Cc: Nicolas Saenz Julienne, outreachy-kernel
Correct long lines of comments to respect
80 character line limit.
Change the comments to C89 style.
Found using checkpatch.pl.
Signed-off-by: R Veera Kumar <vkor@vkten.in>
---
Changes in v2:
- Change the comments to C89 style
---
.../interface/vchi/vchi_common.h | 90 +++++++++++--------
1 file changed, 52 insertions(+), 38 deletions(-)
diff --git a/drivers/staging/vc04_services/interface/vchi/vchi_common.h b/drivers/staging/vc04_services/interface/vchi/vchi_common.h
index 141af16ce031..29fbe4505223 100644
--- a/drivers/staging/vc04_services/interface/vchi/vchi_common.h
+++ b/drivers/staging/vc04_services/interface/vchi/vchi_common.h
@@ -4,70 +4,80 @@
#ifndef VCHI_COMMON_H_
#define VCHI_COMMON_H_
-//flags used when sending messages (must be bitmapped)
+/* flags used when sending messages (must be bitmapped) */
enum vchi_flags {
VCHI_FLAGS_NONE = 0x0,
- VCHI_FLAGS_BLOCK_UNTIL_OP_COMPLETE = 0x1, // waits for message to be received, or sent (NB. not the same as being seen on other side)
- VCHI_FLAGS_CALLBACK_WHEN_OP_COMPLETE = 0x2, // run a callback when message sent
- VCHI_FLAGS_BLOCK_UNTIL_QUEUED = 0x4, // return once the transfer is in a queue ready to go
+ VCHI_FLAGS_BLOCK_UNTIL_OP_COMPLETE = 0x1, /* waits for message to be
+ received, or sent (NB. not the same as being seen on other side) */
+ VCHI_FLAGS_CALLBACK_WHEN_OP_COMPLETE = 0x2, /* run a callback when
+ message sent */
+ VCHI_FLAGS_BLOCK_UNTIL_QUEUED = 0x4, /* return once the transfer
+ is in a queue ready to go */
VCHI_FLAGS_ALLOW_PARTIAL = 0x8,
VCHI_FLAGS_BLOCK_UNTIL_DATA_READ = 0x10,
VCHI_FLAGS_CALLBACK_WHEN_DATA_READ = 0x20,
- VCHI_FLAGS_ALIGN_SLOT = 0x000080, // internal use only
- VCHI_FLAGS_BULK_AUX_QUEUED = 0x010000, // internal use only
- VCHI_FLAGS_BULK_AUX_COMPLETE = 0x020000, // internal use only
- VCHI_FLAGS_BULK_DATA_QUEUED = 0x040000, // internal use only
- VCHI_FLAGS_BULK_DATA_COMPLETE = 0x080000, // internal use only
+ VCHI_FLAGS_ALIGN_SLOT = 0x000080, /* internal use only */
+ VCHI_FLAGS_BULK_AUX_QUEUED = 0x010000, /* internal use only */
+ VCHI_FLAGS_BULK_AUX_COMPLETE = 0x020000, /* internal use only */
+ VCHI_FLAGS_BULK_DATA_QUEUED = 0x040000, /* internal use only */
+ VCHI_FLAGS_BULK_DATA_COMPLETE = 0x080000, /* internal use only */
VCHI_FLAGS_INTERNAL = 0xFF0000
};
-// constants for vchi_crc_control()
+/* constants for vchi_crc_control() */
enum vchi_crc_control {
VCHI_CRC_NOTHING = -1,
VCHI_CRC_PER_SERVICE = 0,
VCHI_CRC_EVERYTHING = 1,
};
-//callback reasons when an event occurs on a service
+/* callback reasons when an event occurs on a service */
enum vchi_callback_reason {
VCHI_CALLBACK_REASON_MIN,
- //This indicates that there is data available
- //handle is the msg id that was transmitted with the data
- // 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
+/*
+ * This indicates that there is data available handle is the msg id that
+ * was transmitted with the data
+ * 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_SENT,
- VCHI_CALLBACK_MSG_SPACE_AVAILABLE, // XXX not yet implemented
+ VCHI_CALLBACK_MSG_SPACE_AVAILABLE, /* XXX not yet implemented */
- // This indicates that a transfer from the other side has completed
+ /* This indicates that a transfer from the other side has completed */
VCHI_CALLBACK_BULK_RECEIVED,
- //This indicates that data queued up to be sent has now gone
- //handle is the msg id that was used when sending the data
+ /* This indicates that data queued up to be sent has now gone handle
+ is the msg id that was used when sending the data */
VCHI_CALLBACK_BULK_SENT,
- VCHI_CALLBACK_BULK_RX_SPACE_AVAILABLE, // XXX not yet implemented
- VCHI_CALLBACK_BULK_TX_SPACE_AVAILABLE, // XXX not yet implemented
+ VCHI_CALLBACK_BULK_RX_SPACE_AVAILABLE, /* XXX not yet implemented */
+ VCHI_CALLBACK_BULK_TX_SPACE_AVAILABLE, /* XXX not yet implemented */
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
- // been deliberately holding off consuming data)
+ /*
+ * 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 been deliberately holding off consuming data)
+ */
VCHI_CALLBACK_SENT_XOFF,
VCHI_CALLBACK_SENT_XON,
- // indicates that a bulk transfer has finished reading the source buffer
+ /* indicates that a bulk transfer has finished reading the source
+ buffer */
VCHI_CALLBACK_BULK_DATA_READ,
- // power notification events (currently host side only)
+ /* power notification events (currently host side only) */
VCHI_CALLBACK_PEER_OFF,
VCHI_CALLBACK_PEER_SUSPENDED,
VCHI_CALLBACK_PEER_ON,
VCHI_CALLBACK_PEER_RESUMED,
VCHI_CALLBACK_FORCED_POWER_OFF,
- // some extra notifications provided by vchiq_arm
+ /* some extra notifications provided by vchiq_arm */
VCHI_CALLBACK_SERVICE_OPENED,
VCHI_CALLBACK_BULK_RECEIVE_ABORTED,
VCHI_CALLBACK_BULK_TRANSMIT_ABORTED,
@@ -75,7 +85,7 @@ enum vchi_callback_reason {
VCHI_CALLBACK_REASON_MAX
};
-// service control options
+/* service control options */
enum vchi_service_option {
VCHI_SERVICE_OPTION_MIN,
@@ -85,10 +95,10 @@ enum vchi_service_option {
VCHI_SERVICE_OPTION_MAX
};
-//Callback used by all services / bulk transfers
-typedef void (*vchi_callback)(void *callback_param, //my service local param
+/* Callback used by all services / bulk transfers */
+typedef void (*vchi_callback)(void *callback_param, /* my service local param */
enum vchi_callback_reason reason,
- void *handle); //for transmitting msg's only
+ void *handle); /* for transmitting msg's only */
/*
* Define vector struct for scatter-gather (vector) operations
@@ -112,12 +122,16 @@ struct vchi_msg_vector {
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.
-// Iterates over messages in queue at the instant of the call to 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.
+/*
+ * 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.
+ * Iterates over messages in queue at the instant of the call to
+ * 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 opaque_vchi_service_t *service;
void *last;
@@ -125,4 +139,4 @@ struct vchi_msg_iter {
void *remove;
};
-#endif // VCHI_COMMON_H_
+#endif /* VCHI_COMMON_H_ */
--
2.20.1
^ permalink raw reply related [flat|nested] 2+ messages in thread
* Re: [PATCH v2] staging: vc04_services: interface: vchi: Correct long lines and style of comments
2020-03-19 10:01 [PATCH v2] staging: vc04_services: interface: vchi: Correct long lines and style of comments R Veera Kumar
@ 2020-03-19 14:11 ` Greg Kroah-Hartman
0 siblings, 0 replies; 2+ messages in thread
From: Greg Kroah-Hartman @ 2020-03-19 14:11 UTC (permalink / raw)
To: R Veera Kumar; +Cc: Nicolas Saenz Julienne, outreachy-kernel
On Thu, Mar 19, 2020 at 03:31:10PM +0530, R Veera Kumar wrote:
> Correct long lines of comments to respect
> 80 character line limit.
> Change the comments to C89 style.
> Found using checkpatch.pl.
>
> Signed-off-by: R Veera Kumar <vkor@vkten.in>
> ---
> Changes in v2:
> - Change the comments to C89 style
> ---
> .../interface/vchi/vchi_common.h | 90 +++++++++++--------
> 1 file changed, 52 insertions(+), 38 deletions(-)
>
> diff --git a/drivers/staging/vc04_services/interface/vchi/vchi_common.h b/drivers/staging/vc04_services/interface/vchi/vchi_common.h
> index 141af16ce031..29fbe4505223 100644
> --- a/drivers/staging/vc04_services/interface/vchi/vchi_common.h
> +++ b/drivers/staging/vc04_services/interface/vchi/vchi_common.h
> @@ -4,70 +4,80 @@
> #ifndef VCHI_COMMON_H_
> #define VCHI_COMMON_H_
>
> -//flags used when sending messages (must be bitmapped)
> +/* flags used when sending messages (must be bitmapped) */
There is nothing wrong with the // comment used here, or in this file,
why are you changing them?
> enum vchi_flags {
> VCHI_FLAGS_NONE = 0x0,
> - VCHI_FLAGS_BLOCK_UNTIL_OP_COMPLETE = 0x1, // waits for message to be received, or sent (NB. not the same as being seen on other side)
> - VCHI_FLAGS_CALLBACK_WHEN_OP_COMPLETE = 0x2, // run a callback when message sent
> - VCHI_FLAGS_BLOCK_UNTIL_QUEUED = 0x4, // return once the transfer is in a queue ready to go
> + VCHI_FLAGS_BLOCK_UNTIL_OP_COMPLETE = 0x1, /* waits for message to be
> + received, or sent (NB. not the same as being seen on other side) */
Does that look readable?
Please be more careful.
greg k-h
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2020-03-19 14:11 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-03-19 10:01 [PATCH v2] staging: vc04_services: interface: vchi: Correct long lines and style of comments R Veera Kumar
2020-03-19 14:11 ` Greg Kroah-Hartman
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.