greybus: tracing: refine comments

I believe that duplicating the tracepoint name in comments prior to
the tracepoint is redundant, and doesn't add a lot of value.

I also believe that we can provide a little more information about
what exactly an event means, or when exactly it is called.

I don't claim this is a huge improvement, but it's a proposal.

Signed-off-by: Alex Elder <elder@linaro.org>
Reviewed-by: Bryan O'Donoghue <bryan.odonoghue@linaro.org>
Reviewed-by: Jeffrey Carlyle <jcarlyle@google.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@google.com>
This commit is contained in:
Alex Elder 2016-05-20 11:44:57 -05:00 committed by Greg Kroah-Hartman
parent 58a8813763
commit 206dc534e9
1 changed files with 13 additions and 14 deletions

View File

@ -58,32 +58,31 @@ DECLARE_EVENT_CLASS(gb_message,
TP_ARGS(message))
/*
* tracepoint name greybus:gb_message_send
* description send a greybus message
* Occurs immediately before calling a host device's message_send()
* method.
*/
DEFINE_MESSAGE_EVENT(gb_message_send);
/*
* tracepoint name greybus:gb_message_recv_request
* description receive a greybus request
* Occurs after an incoming request message has been received
*/
DEFINE_MESSAGE_EVENT(gb_message_recv_request);
/*
* tracepoint name greybus:gb_message_recv_response
* description receive a greybus response
* Occurs after an incoming response message has been received,
* after its matching request has been found.
*/
DEFINE_MESSAGE_EVENT(gb_message_recv_response);
/*
* tracepoint name greybus:gb_message_cancel_outgoing
* description cancel outgoing greybus request
* Occurs after an operation has been canceled, possibly before the
* cancellation is complete.
*/
DEFINE_MESSAGE_EVENT(gb_message_cancel_outgoing);
/*
* tracepoint name greybus:gb_message_cancel_incoming
* description cancel incoming greybus request
* Occurs when an incoming request is cancelled; if the response has
* been queued for sending, this occurs after it is sent.
*/
DEFINE_MESSAGE_EVENT(gb_message_cancel_incoming);
@ -188,14 +187,14 @@ DECLARE_EVENT_CLASS(gb_host_device,
TP_ARGS(hd, intf_cport_id, payload_size))
/*
* tracepoint name greybus:gb_host_device_send
* description tracepoint representing the point data are transmitted
* Occurs immediately before calling usb_submit_urb() to send a
* message to the UniPro bridge.
*/
DEFINE_HD_EVENT(gb_host_device_send);
/*
* tracepoint name greybus:gb_host_device_recv
* description tracepoint representing the point data are received
* Occurs after receiving a UniPro message via the USB subsystem,
* just prior to handing it to the Greybus core for handling.
*/
DEFINE_HD_EVENT(gb_host_device_recv);