Man page - guestfs-python(3)

Packages contains this manual

Available languages:

en ja uk

Manual

guestfs-python

名 前
書 式
説 明
python_return_dict=True
例 外
MORE DOCUMENTATION
USING PYTHON BINDINGS IN A VIRTUALENV
例 1: デ ィ ス ク イ メ ー ジ の 作 成
例 2: 仮 想 マ シ ン の デ ィ ス ク イ メ ー ジ の 検 査
関 連 項 目
著 者
COPYRIGHT
LICENSE
BUGS

名 前

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

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 "RuntimeError" with a single string argument which is the error message.

MORE DOCUMENTATION

Type:

$ 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-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

Copyright (C) 2010-2023 Red Hat Inc.

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.