guestfs-python(3) 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 "RuntimeException" with a single string argument which is the error message.

MORE DOCUMENTATION

Type:

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

例 1: ディスクイメージの作成

@EXAMPLE1@

例 2: 仮想マシンのディスクイメージの検査

@EXAMPLE2@

著者

Richard W.M. Jones ("rjones at redhat dot com")

COPYRIGHT

Copyright (C) 2010-2012 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.