mirror of
https://github.com/libguestfs/libguestfs.git
synced 2026-03-21 22:53:37 +00:00
a57f6b8e2c
They will be removed in libguestfs 1.58 (the next but one version). Currently they don't actually compile. The larger problem is that they don't handle 64 bit quantities properly (using floats instead), meaning that any disk size or offset above a certain size will be improperly passed through the API, usually rounded to the nearest 53 bits.
69 lines
1.5 KiB
Plaintext
69 lines
1.5 KiB
Plaintext
=head1 NAME
|
|
|
|
guestfs-gobject - How to use libguestfs with the GObject bindings
|
|
|
|
=head1 DEPRECATED
|
|
|
|
These bindings are deprecated and will be removed in libguestfs 1.58.
|
|
|
|
=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.
|