[Xen-changelog] [xen master] libxl: Document device parameter of libxl_device_<type>_add functions

[patchbot@xxxxxxx]

commit 405254bbb2fdbfa8a428fd144ea7585812af9e8a
Author:     Euan Harris <euan.harris@xxxxxxxxxx>
AuthorDate: Tue Nov 18 17:07:41 2014 +0000
Commit:     Ian Campbell <ian.campbell@xxxxxxxxxx>
CommitDate: Thu Nov 20 15:31:50 2014 +0000

    libxl: Document device parameter of libxl_device_<type>_add functions
    
    The device parameter of libxl_device_<type>_add is an in/out parameter.
    Unspecified fields are filled in with appropriate values for the created
    device when the function returns.  Document this behaviour.
    
    Signed-off-by: Euan Harris <euan.harris@xxxxxxxxxx>
    Acked-by: Ian Jackson <ian.jackson@xxxxxxxxxxxxx>
---
 tools/libxl/libxl.h |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)

diff --git a/tools/libxl/libxl.h b/tools/libxl/libxl.h
index c3451bd..41d6e8d 100644
--- a/tools/libxl/libxl.h
+++ b/tools/libxl/libxl.h
@@ -1109,6 +1109,10 @@ void libxl_vtpminfo_list_free(libxl_vtpminfo *, int 
nr_vtpms);
  *   domain to connect to the device and therefore cannot block on the
  *   guest.
  *
+ *   device is an in/out parameter:  fields left unspecified when the
+ *   structure is passed in are filled in with appropriate values for
+ *   the device created.
+ *
  * libxl_device_<type>_remove(ctx, domid, device):
  *
  *   Removes the given device from the specified domain by performing
--
generated by git-patchbot for /home/xen/git/xen.git#master

_______________________________________________
Xen-changelog mailing list
Xen-changelog@xxxxxxxxxxxxx
http://lists.xensource.com/xen-changelog