[libvirt] [PATCH libvirt-glib] docs: Document gvir_connection_get_{storage_pools, networks, domains}
Christophe Fergeau
cfergeau at redhat.com
Wed Jul 27 08:27:17 UTC 2016
Acked-by: Christophe Fergeau <cfergeau at redhat.com>
(I'm assuming you can push to libvirt-glib, let me know if that's not
the case).
Christophe
On Wed, Jul 27, 2016 at 08:59:54AM +0200, Guido Günther wrote:
> In contrast to libvirt itself all get_* methods need to prefetch the
> corresponding information first so document this.
> ---
> libvirt-gobject/libvirt-gobject-connection.c | 15 +++++++++++++++
> 1 file changed, 15 insertions(+)
>
> diff --git a/libvirt-gobject/libvirt-gobject-connection.c b/libvirt-gobject/libvirt-gobject-connection.c
> index 00d5eda..3f17265 100644
> --- a/libvirt-gobject/libvirt-gobject-connection.c
> +++ b/libvirt-gobject/libvirt-gobject-connection.c
> @@ -700,6 +700,11 @@ void gvir_connection_close(GVirConnection *conn)
> * gvir_connection_fetch_domains:
> * @conn: a #GVirConnection
> * @cancellable: (allow-none)(transfer none): cancellation object
> + *
> + * Use this method to fetch all domains managed by connection
> + * @conn. Use e.g. #gvir_connection_find_domain_by_id or
> + * #gvir_connection_get_domain afterwards to query the fetched
> + * domains.
> */
> gboolean gvir_connection_fetch_domains(GVirConnection *conn,
> GCancellable *cancellable,
> @@ -783,6 +788,11 @@ cleanup:
> * gvir_connection_fetch_storage_pools:
> * @conn: a #GVirConnection
> * @cancellable: (allow-none)(transfer none): cancellation object
> + *
> + * Use this method to fetch all storage pools managed by connection
> + * @conn. Use e.g. #gvir_connection_find_storage_pool_by_name or
> + * #gvir_connection_get_storage_pools afterwards to query the fetched
> + * pools.
> */
> gboolean gvir_connection_fetch_storage_pools(GVirConnection *conn,
> GCancellable *cancellable,
> @@ -1722,6 +1732,11 @@ GVirInterface *gvir_connection_find_interface_by_mac(GVirConnection *conn,
> * gvir_connection_fetch_networks:
> * @conn: a #GVirConnection
> * @cancellable: (allow-none)(transfer none): cancellation object
> + *
> + * Use this method to fetch all networks managed by connection
> + * @conn. Use e.g. #gvir_connection_find_network_by_name or
> + * #gvir_connection_get_networks afterwards to query the fetched
> + * domains.
> */
> gboolean gvir_connection_fetch_networks(GVirConnection *conn,
> GCancellable *cancellable,
> --
> 2.8.1
>
> --
> libvir-list mailing list
> libvir-list at redhat.com
> https://www.redhat.com/mailman/listinfo/libvir-list
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20160727/b568ad02/attachment-0001.sig>
More information about the libvir-list
mailing list