名前

       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 "RuntimeException" 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-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.