НАЗВА¶

guestfs-python — як використовувати libguestfs з Python

КОРОТКИЙ ОПИС¶

 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).

python_return_dict=True¶

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.

ДОДАТКОВА ДОКУМЕНТАЦІЯ¶

Тип:

 $ python
 >>> import guestfs
 >>> help (guestfs)

USING PYTHON BINDINGS IN A VIRTUALENV¶

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

ПРИКЛАД 1. СТВОРЕННЯ ОБРАЗУ ДИСКА¶

@EXAMPLE1@

ПРИКЛАД 2. ПЕРЕВІРКА ОБРАЗУ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ¶

@EXAMPLE2@

ТАКОЖ ПЕРЕГЛЯНЬТЕ¶

guestfs(3), guestfs-examples(3), guestfs-erlang(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")

АВТОРСЬКІ ПРАВА¶

© Red Hat Inc., 2010–2012

LICENSE¶

BUGS¶

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.