guestfs-python - Python から libguestfs
を使用する方法
import guestfs
g = guestfs.GuestFS(python_return_dict=True)
g.add_drive_opts("disk.img", format="raw", readonly=1)
g.launch()
This manual page documents how to call libguestfs from the Python programming
language. 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
guestfs(3).
All new code should construct the handle using:
g = guestfs.GuestFS(python_return_dict=True)
This indicates that your program wants to receive Python dicts for methods in
the API that return hashtables.
In a future version of libguestfs, this will become the default.
Errors from libguestfs functions are mapped into "RuntimeException"
with a single string argument which is the error message.
Type:
$ python
>>> import guestfs
>>> help(guestfs)
These bindings are
not available in pypi owing to a licensing problem.
See
https://bugzilla.redhat.com/1075594 for current status.
However we do publish a Python distribution for selected stable versions of
libguestfs in
http://libguestfs.org/download/python. You can use it like this:
pip install http://libguestfs.org/download/python/guestfs-1.XX.YY.tar.gz
@EXAMPLE1@
@EXAMPLE2@
guestfs(3),
guestfs-examples(3),
guestfs-erlang(3),
guestfs-gobject(3),
guestfs-golang(3),
guestfs-java(3),
guestfs-lua(3),
guestfs-ocaml(3),
guestfs-perl(3),
guestfs-recipes(1),
guestfs-ruby(3),
http://libguestfs.org/.
Richard W.M. Jones ("rjones at redhat dot com")
Copyright (C) 2010-2012 Red Hat Inc.
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
When reporting a bug, please supply:
- •
- The version of libguestfs.
- •
- Where you got libguestfs (eg. which Linux distro, compiled
from source, etc)
- •
- Describe the bug accurately and give a way to reproduce
it.
- •
- Run libguestfs-test-tool(1) and paste the
complete, unedited output into the bug report.