=head1 NAME

guestfs-gobject - How to use libguestfs with the GObject bindings

=head1 SYNOPSIS

From Javascript using gjs:

 const Guestfs = imports.gi.Guestfs;
 var g = new Guestfs.Session();
 g.add_drive('disk.img', null);
 g.launch();
 g.close();

=head1 DESCRIPTION

This manual page documents how to call libguestfs using GObject
bindings, especially from Javascript.

Note that the GObject bindings have problems handling 64 bit values.
You should not use the GObject bindings if there are native bindings
for your language.  For example, to use libguestfs from Python you are
strongly advised to use the Python native bindings instead (see
L<guestfs-python(3)>).

This page just documents the differences from the C API and gives some
examples.  If you are not familiar with using libguestfs, you also
need to read L<guestfs(3)>.

=head1 JAVASCRIPT

Using gjs, you can write a C<.js> file containing:

 const Guestfs = imports.gi.Guestfs;
 var g = new Guestfs.Session();
 g.add_drive('disk.img', null);
 g.launch();
 g.close();

and then run it using:

 gjs program.js

=head1 SEE ALSO

L<guestfs(3)>,
L<guestfs-examples(3)>,
L<guestfs-erlang(3)>,
L<guestfs-golang(3)>,
L<guestfs-java(3)>,
L<guestfs-lua(3)>,
L<guestfs-perl(3)>,
L<guestfs-python(3)>,
L<guestfs-recipes(1)>,
L<guestfs-ruby(3)>,
L<http://libguestfs.org/>.

=head1 AUTHORS

Richard W.M. Jones (C<rjones at redhat dot com>)

=head1 COPYRIGHT

Copyright (C) 2012-2025 Red Hat Inc.
