Files
libguestfs/perl
Richard Jones f93cbe5756 Use mount-options instead of mount to avoid implicit -o sync.
guestfs_mount adds -o sync implicitly.  This causes a very large
performance problem for write-intensive programs (eg. virt-v2v).

Document this as a "gotcha".

Change the tests, guestfish, Sys::Guestfs::Lib, guestmount to use
mount-options instead.

(Note that this gotcha does not affect mount-ro).

The source of the performance problem was first identified by
Matthew Booth.
2010-02-10 10:46:23 +00:00
..

Sys::Guestfs
------------

This directory contains the Perl bindings for the libguestfs API.

The basic libguestfs bindings have the name 'Sys::Guestfs'.

As with all other language bindings, these bindings are generated
automatically.  See src/generator.ml.

Sys::Guestfs::Lib
-----------------

Because we use Perl for writing lots of additional tools around
libguestfs, the Perl bindings also contain an extra library of useful
functions, called 'Sys::Guestfs::Lib'.  This extra library is entirely
optional, and only enhances the usefulness of the ordinary libguestfs
API.

One of the features of this library is tighter libvirt integration.