diff mbox series

libxl: event: Document lifetime API for libxl_childproc_setmode

Message ID 20200117181207.7087-1-ian.jackson@eu.citrix.com (mailing list archive)
State New, archived
Headers show
Series libxl: event: Document lifetime API for libxl_childproc_setmode | expand

Commit Message

Ian Jackson Jan. 17, 2020, 6:12 p.m. UTC
There is already an identical comment for
libxl_osevent_register_hooks.

libxl_childproc_setmode's hooks parameter has the same property and
this should be documented.

Reported-by; George Dunlap <george.dunlap@citrix.com>
Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
---
 tools/libxl/libxl_event.h | 2 ++
 1 file changed, 2 insertions(+)

Comments

Wei Liu Jan. 20, 2020, 12:06 p.m. UTC | #1
On Fri, Jan 17, 2020 at 06:12:07PM +0000, Ian Jackson wrote:
> There is already an identical comment for
> libxl_osevent_register_hooks.
> 
> libxl_childproc_setmode's hooks parameter has the same property and
> this should be documented.
> 
> Reported-by; George Dunlap <george.dunlap@citrix.com>
> Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>

Acked-by: Wei Liu <wl@xen.org>
diff mbox series

Patch

diff --git a/tools/libxl/libxl_event.h b/tools/libxl/libxl_event.h
index d1517f7456..8d0aa6417e 100644
--- a/tools/libxl/libxl_event.h
+++ b/tools/libxl/libxl_event.h
@@ -548,6 +548,8 @@  typedef struct {
  * May not be called when libxl might have any child processes, or the
  * behaviour is undefined.  So it is best to call this at
  * initialisation.
+ *
+ * The value *hooks is not copied and must outlast the libxl_ctx.
  */
 void libxl_childproc_setmode(libxl_ctx *ctx, const libxl_childproc_hooks *hooks,
                              void *user);