rpc: clarify "void *" values passed to client callbacks

Signed-off-by: Daniel P. Berrange <berrange@redhat.com>

diff --git a/src/rpc/virnetserverclient.h b/src/rpc/virnetserverclient.h
index 0fa8745191a82756281b638f2b9293511c0c2a14..14ace9e522e3b6628231b68a97ce34b847ee6ee2 100644 (file)
--- a/src/rpc/virnetserverclient.h
+++ b/src/rpc/virnetserverclient.h
@@ -41,11 +41,20 @@ typedef int (*virNetServerClientFilterFunc)(virNetServerClientPtr client,
                                             virNetMessagePtr msg,
                                             void *opaque);
 
+/*
+ * @data: value allocated by virNetServerClintPrivNew(PostExecRestart) callback
+ */
 typedef virJSONValuePtr (*virNetServerClientPrivPreExecRestart)(virNetServerClientPtr client,
                                                                 void *data);
+/*
+ * @opaque: value of @privOpaque from virNetServerClientNewPostExecRestart
+ */
 typedef void *(*virNetServerClientPrivNewPostExecRestart)(virNetServerClientPtr client,
                                                           virJSONValuePtr object,
                                                           void *opaque);
+/*
+ * @opaque: value of @privOpaque from virNetServerClientNew
+ */
 typedef void *(*virNetServerClientPrivNew)(virNetServerClientPtr client,
                                            void *opaque);