![]() |
![]() |
![]() |
![]() |
The Libvirt GLib library provides glue to integrate core libvirt infrastructure with the GLib library. This enables consistent error reporting procedures and a common event loop implementation for applications.
Before using any functions in the Libvirt GLib library, it must be initialized
by calling gvir_init
or gvir_init_check
.
Example 1. Initializing the Libvirt GLib library
int main(int argc, char **argv) { ...setup... gvir_init(&argc, &argv); ...more setup... gtk_main(); return 0; }
void gvir_init (int *argc
,char ***argv
);
Call this function before using any other Libvirt GLib functions in your applications. It will initialize everything needed to operate the toolkit and parses some standard command line options.
Although you are expected to pass the argc
, argv
parameters from main()
to this
function, it is possible to pass NULL if argv
is not available or commandline
handling is not required.
argc
and argv
are adjusted accordingly so your own code will never see those
standard arguments.
This method will also turn on debug logging of the library if the
LIBVIRT_GLIB_DEBUG
environment variable is set.
This function will terminate your program if it was unable to initialize
for some reason. If you want the program to fall back to an alternate
mode of operation call gvir_init_check
instead.
argc |
Address of the argc parameter of your |
[inout] |
argv |
Address of the argv parameter of main() , or NULL . Any options
understood by GTK+ are stripped before return. |
[array length=argc][inout][allow-none][transfer none] |
gboolean gvir_init_check (int *argc
,char ***argv
,GError **err
);
This function does the same work as gvir_init()
with only a single
change: It does not terminate the program if the Libvirt GLib library
can't be initialized. Instead it returns FALSE
on failure.
This way the application can fall back to some other mode of operation.
argc |
Address of the argc parameter of your |
[inout] |
argv |
Address of the argv parameter of main() , or NULL . Any options
understood by GTK+ are stripped before return. |
[array length=argc][inout][allow-none][transfer none] |
err |
filled with the error information if initialized failed. |