[Pkg-libvirt-commits] [libguestfs] 22/37: Imported Upstream version 1.15.5
Hilko Bengen
bengen at moszumanska.debian.org
Sun Dec 22 18:13:39 UTC 2013
This is an automated email from the git hooks/post-receive script.
bengen pushed a commit to annotated tag debian/1%1.15.10-1
in repository libguestfs.
commit 0a565299fe7c8f0c69555de1eb6e9c5ee55433bb
Author: Hilko Bengen <bengen at debian.org>
Date: Tue Nov 22 09:25:57 2011 +0100
Imported Upstream version 1.15.5
---
.gitignore | 3 +
BUGS | 5 +-
ChangeLog | 19 +
Makefile.am | 1 +
Makefile.in | 1 +
configure | 26 +-
configure.ac | 2 +-
contrib/intro/libguestfs-intro.html | 119 ++++-
contrib/intro/talk.txt | 33 +-
debian/changelog | 4 +-
examples/Makefile.am | 22 +-
examples/Makefile.in | 22 +-
examples/guestfs-testing.pod | 296 ++++++++++++
libguestfs.pc | 2 +-
po-docs/ja.po | 831 ++++++++++++++++++++++++++++----
po-docs/ja/guestfish.1 | 2 +-
po-docs/ja/guestfs-testing.pod | 293 ++++++++++++
po-docs/ja/guestfs.3 | 4 +-
po-docs/ja/guestfs.pod | 2 +-
po-docs/ja/guestmount.1 | 2 +-
po-docs/ja/libguestfs-test-tool.1 | 2 +-
po-docs/ja/virt-alignment-scan.1 | 2 +-
po-docs/ja/virt-cat.1 | 2 +-
po-docs/ja/virt-copy-in.1 | 2 +-
po-docs/ja/virt-copy-out.1 | 2 +-
po-docs/ja/virt-df.1 | 2 +-
po-docs/ja/virt-edit.1 | 2 +-
po-docs/ja/virt-filesystems.1 | 2 +-
po-docs/ja/virt-inspector.1 | 2 +-
po-docs/ja/virt-list-filesystems.1 | 2 +-
po-docs/ja/virt-list-partitions.1 | 2 +-
po-docs/ja/virt-ls.1 | 2 +-
po-docs/ja/virt-make-fs.1 | 2 +-
po-docs/ja/virt-rescue.1 | 2 +-
po-docs/ja/virt-resize.1 | 2 +-
po-docs/ja/virt-sparsify.1 | 2 +-
po-docs/ja/virt-sysprep.1 | 2 +-
po-docs/ja/virt-tar-in.1 | 2 +-
po-docs/ja/virt-tar-out.1 | 2 +-
po-docs/ja/virt-tar.1 | 2 +-
po-docs/ja/virt-win-reg.1 | 2 +-
po-docs/libguestfs-docs.pot | 749 +++++++++++++++++++++++++++--
po-docs/uk.po | 917 ++++++++++++++++++++++++++++++++----
po-docs/uk/guestfish.1 | 2 +-
po-docs/uk/guestfs-testing.pod | 293 ++++++++++++
po-docs/uk/guestfs.3 | 4 +-
po-docs/uk/guestfs.pod | 2 +-
po-docs/uk/guestmount.1 | 2 +-
po-docs/uk/libguestfs-test-tool.1 | 2 +-
po-docs/uk/virt-alignment-scan.1 | 2 +-
po-docs/uk/virt-cat.1 | 2 +-
po-docs/uk/virt-copy-in.1 | 2 +-
po-docs/uk/virt-copy-out.1 | 2 +-
po-docs/uk/virt-df.1 | 2 +-
po-docs/uk/virt-edit.1 | 2 +-
po-docs/uk/virt-filesystems.1 | 2 +-
po-docs/uk/virt-inspector.1 | 2 +-
po-docs/uk/virt-list-filesystems.1 | 2 +-
po-docs/uk/virt-list-partitions.1 | 2 +-
po-docs/uk/virt-ls.1 | 2 +-
po-docs/uk/virt-make-fs.1 | 2 +-
po-docs/uk/virt-rescue.1 | 2 +-
po-docs/uk/virt-resize.1 | 2 +-
po-docs/uk/virt-sparsify.1 | 2 +-
po-docs/uk/virt-sysprep.1 | 2 +-
po-docs/uk/virt-tar-in.1 | 2 +-
po-docs/uk/virt-tar-out.1 | 2 +-
po-docs/uk/virt-tar.1 | 2 +-
po-docs/uk/virt-win-reg.1 | 2 +-
po/en_GB.gmo | Bin 10781 -> 10781 bytes
po/en_GB.po | 2 +-
po/es.gmo | Bin 92709 -> 92709 bytes
po/es.po | 2 +-
po/gu.gmo | Bin 53605 -> 53605 bytes
po/gu.po | 2 +-
po/hi.gmo | Bin 43389 -> 43389 bytes
po/hi.po | 2 +-
po/kn.gmo | Bin 52822 -> 52822 bytes
po/kn.po | 2 +-
po/libguestfs.pot | 4 +-
po/ml.gmo | Bin 56355 -> 56355 bytes
po/ml.po | 2 +-
po/mr.gmo | Bin 104937 -> 104937 bytes
po/mr.po | 2 +-
po/nl.gmo | Bin 90946 -> 90946 bytes
po/nl.po | 2 +-
po/or.gmo | Bin 52173 -> 52173 bytes
po/or.po | 2 +-
po/pa.gmo | Bin 90834 -> 90834 bytes
po/pa.po | 2 +-
po/pl.gmo | Bin 95389 -> 95389 bytes
po/pl.po | 2 +-
po/ta.gmo | Bin 47311 -> 47311 bytes
po/ta.po | 2 +-
po/te.gmo | Bin 49970 -> 49970 bytes
po/te.po | 2 +-
po/uk.gmo | Bin 125123 -> 125123 bytes
po/uk.po | 2 +-
ruby/Makefile.am | 4 +-
ruby/Makefile.in | 4 +-
ruby/Rakefile.in | 18 +-
ruby/run-bindtests | 2 +-
src/guestfs.pod | 1 +
103 files changed, 3462 insertions(+), 341 deletions(-)
diff --git a/.gitignore b/.gitignore
index d8f4628..9ebd4c7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -88,9 +88,11 @@ erlang/guestfs.erl
examples/create_disk
examples/guestfs-examples.3
examples/guestfs-recipes.1
+examples/guestfs-testing.1
examples/inspect_vm
examples/stamp-guestfs-examples.pod
examples/stamp-guestfs-recipes.pod
+examples/stamp-guestfs-testing.pod
examples/virt-dhcp-address
fish/cmds.c
fish/cmds_gperf.c
@@ -138,6 +140,7 @@ html/guestfs-perl.3.html
html/guestfs-python.3.html
html/guestfs-recipes.1.html
html/guestfs-ruby.3.html
+html/guestfs-testing.1.html
html/guestmount.1.html
html/virt-alignment-scan.1.html
html/virt-cat.1.html
diff --git a/BUGS b/BUGS
index f611ed3..4c5cdb2 100644
--- a/BUGS
+++ b/BUGS
@@ -1,5 +1,5 @@
NOTE: This file is automatically generated from "update-bugs.sh".
-Last updated: 2011-11-17
+Last updated: 2011-11-21
This contains a local list of the bugs that are open against
libguestfs. Bugs are tracked in the Red Hat Bugzilla database
@@ -59,9 +59,6 @@ Bugs in NEW or ASSIGNED state are open and waiting for someone to fix.
745606 NEW https://bugzilla.redhat.com/show_bug.cgi?id=745606
libguestfs: error: part_list: could not parse row from output of parted print command
-752916 NEW https://bugzilla.redhat.com/show_bug.cgi?id=752916
- hivex has implicit pointer conversions
-
563450 NEW https://bugzilla.redhat.com/show_bug.cgi?id=563450
list-devices returns devices of different types out of order
diff --git a/ChangeLog b/ChangeLog
index c2503ff..ca3d7aa 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,22 @@
+2011-11-21 Richard W.M. Jones <rjones at redhat.com>
+
+ guestfs-testing: Link to libguestfs-test-tool.
+
+ contrib: Update introduction to libguestfs.
+
+2011-11-21 Hilko Bengen <bengen at hilluzination.de>
+
+ out-of-tree build: ruby
+
+2011-11-20 Richard W.M. Jones <rjones at redhat.com>
+
+ Add guestfs-testing(1) man page.
+ This contains suggested manual tests that users can run.
+
+2011-11-17 Richard W.M. Jones <rjones at redhat.com>
+
+ Version 1.15.4.
+
2011-11-17 Matthew Booth <mbooth at redhat.com>
New API: mdadm-detail.
diff --git a/Makefile.am b/Makefile.am
index 115c699..a223600 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -161,6 +161,7 @@ HTMLFILES = \
html/guestfs-python.3.html \
html/guestfs-recipes.1.html \
html/guestfs-ruby.3.html \
+ html/guestfs-testing.1.html \
html/guestfish.1.html \
html/guestmount.1.html \
html/virt-alignment-scan.1.html \
diff --git a/Makefile.in b/Makefile.in
index b554b95..99f3ca5 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -1391,6 +1391,7 @@ HTMLFILES = \
html/guestfs-python.3.html \
html/guestfs-recipes.1.html \
html/guestfs-ruby.3.html \
+ html/guestfs-testing.1.html \
html/guestfish.1.html \
html/guestmount.1.html \
html/virt-alignment-scan.1.html \
diff --git a/configure b/configure
index 2a353ef..e2980d0 100755
--- a/configure
+++ b/configure
@@ -1,6 +1,6 @@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.68 for libguestfs 1.15.4.
+# Generated by GNU Autoconf 2.68 for libguestfs 1.15.5.
#
#
# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
@@ -567,8 +567,8 @@ MAKEFLAGS=
# Identity of this package.
PACKAGE_NAME='libguestfs'
PACKAGE_TARNAME='libguestfs'
-PACKAGE_VERSION='1.15.4'
-PACKAGE_STRING='libguestfs 1.15.4'
+PACKAGE_VERSION='1.15.5'
+PACKAGE_STRING='libguestfs 1.15.5'
PACKAGE_BUGREPORT=''
PACKAGE_URL=''
@@ -2279,7 +2279,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
-\`configure' configures libguestfs 1.15.4 to adapt to many kinds of systems.
+\`configure' configures libguestfs 1.15.5 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@@ -2349,7 +2349,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
- short | recursive ) echo "Configuration of libguestfs 1.15.4:";;
+ short | recursive ) echo "Configuration of libguestfs 1.15.5:";;
esac
cat <<\_ACEOF
@@ -2519,7 +2519,7 @@ fi
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
-libguestfs configure 1.15.4
+libguestfs configure 1.15.5
generated by GNU Autoconf 2.68
Copyright (C) 2010 Free Software Foundation, Inc.
@@ -3261,7 +3261,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
-It was created by libguestfs $as_me 1.15.4, which was
+It was created by libguestfs $as_me 1.15.5, which was
generated by GNU Autoconf 2.68. Invocation command line was
$ $0 $@
@@ -4168,7 +4168,7 @@ fi
# Define the identity of the package.
PACKAGE='libguestfs'
- VERSION='1.15.4'
+ VERSION='1.15.5'
cat >>confdefs.h <<_ACEOF
@@ -4265,8 +4265,8 @@ else
fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: libguestfs version 1.15.4$libguestfs_extra" >&5
-$as_echo "$as_me: libguestfs version 1.15.4$libguestfs_extra" >&6;}
+{ $as_echo "$as_me:${as_lineno-$LINENO}: libguestfs version 1.15.5$libguestfs_extra" >&5
+$as_echo "$as_me: libguestfs version 1.15.5$libguestfs_extra" >&6;}
$as_echo "#define PACKAGE_VERSION_MAJOR 1" >>confdefs.h
@@ -4275,7 +4275,7 @@ $as_echo "#define PACKAGE_VERSION_MAJOR 1" >>confdefs.h
$as_echo "#define PACKAGE_VERSION_MINOR 15" >>confdefs.h
-$as_echo "#define PACKAGE_VERSION_RELEASE 4" >>confdefs.h
+$as_echo "#define PACKAGE_VERSION_RELEASE 5" >>confdefs.h
cat >>confdefs.h <<_ACEOF
@@ -53172,7 +53172,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
-This file was extended by libguestfs $as_me 1.15.4, which was
+This file was extended by libguestfs $as_me 1.15.5, which was
generated by GNU Autoconf 2.68. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@@ -53242,7 +53242,7 @@ _ACEOF
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\
-libguestfs config.status 1.15.4
+libguestfs config.status 1.15.5
configured by $0, generated by GNU Autoconf 2.68,
with options \\"\$ac_cs_config\\"
diff --git a/configure.ac b/configure.ac
index 3003099..7b82ee1 100644
--- a/configure.ac
+++ b/configure.ac
@@ -20,7 +20,7 @@
# freeform string.
m4_define([libguestfs_major], [1])
m4_define([libguestfs_minor], [15])
-m4_define([libguestfs_release], [4])
+m4_define([libguestfs_release], [5])
AC_INIT([libguestfs],libguestfs_major.libguestfs_minor.libguestfs_release)
AC_CONFIG_AUX_DIR([build-aux])
diff --git a/contrib/intro/libguestfs-intro.html b/contrib/intro/libguestfs-intro.html
index 67bdf9b..fe1e833 100644
--- a/contrib/intro/libguestfs-intro.html
+++ b/contrib/intro/libguestfs-intro.html
@@ -179,16 +179,28 @@ get_blkid_tag (const char *device, const char *tag)
</object>
<table>
- <tr><td valign="top" style="padding-bottom: 1.5em;">
+ <tr><td valign="top" style="padding-bottom: 1.5em;" colspan="2">
<pre>
-<b>guestfish -N fs -m /dev/sda1 <<EOF</b>
- <font style="color: green;">mkdir /etc
- upload /etc/resolv.conf /etc/resolv.conf
- write /etc/hostname "test01.redhat.com"</font>
+<b>guestfish -N bootrootlv:/dev/VG/LV:ext4:ext4:10G:256M <<EOF</b>
+ <font style="color: green;">mount-options "" /dev/VG/LV /
+ mkdir /boot
+ mount-options "" /dev/sda1 /boot
+ txz-in filesystem.tar.xz /
+ write /etc/HOSTNAME "test01.example.com\n"
+ upload /etc/resolv.conf /etc/resolv.conf</font>
<b>EOF</b>
+<b>guestmount -a test1.img -i mnt/</b>
+<b>ls mnt</b>
+bin dev home lib mnt proc sbin tmp var
+boot etc initrd.img lost+found old-root root sys usr vmlinuz
+<b>cat mnt/etc/HOSTNAME</b>
+test01.example.com
+<b>fusermount -u mnt</b>
</pre>
-<p class="sourcelnk"><a href="http://libguestfs.org/guestfish.1.html">manual ...</a></p>
- </td><td valign="top">
+<p class="sourcelnk"><a href="http://libguestfs.org/guestfish.1.html">manual for guestfish ...</a> <br/>
+<a href="http://libguestfs.org/guestmount.1.html">manual for guestmount ...</a></p>
+ </td></tr>
+ <tr><td valign="top" style="padding-bottom: 1.5em;">
<pre>
<b>virt-df -a /dev/vg/F15x32 -h</b>
Filesystem Size Used Available Use%
@@ -196,14 +208,30 @@ F15x32:/dev/sda1 484M 31M 428M 7%
F15x32:/dev/vg_f15x32/lv_root 5.5G 3.4G 1.8G 63%
</pre>
<p class="sourcelnk"><a href="http://libguestfs.org/virt-df.1.html">manual ...</a></p>
+ </td>
+ <td valign="top" style="padding-bottom: 1.5em;">
+<pre>
+<b>virt-cat -c qemu:///system -d WinXP 'c:\boot.ini'</b>
+[boot loader]
+timeout=30
+default=multi(0)disk(0)rdisk(0)partition(1)\WINDOWS
+[operating systems]
+multi(0)disk(0)rdisk(0)partition(1)\WINDOWS=
+"Microsoft Windows XP Professional" /noexecute=optin
+/fastdetect
+</pre>
+<p class="sourcelnk"><a href="http://libguestfs.org/virt-cat.1.html">manual ...</a></p>
</td></tr>
- <tr><td valign="top">
+ <tr><td valign="top" style="padding-bottom: 1.5em;">
<pre>
<b>virt-edit -c qemu:///system -d F15x32 /etc/passwd</b>
-<i>(launches editor)</i>
+<i>(launches text editor to edit guest /etc/passwd)</i>
+
+<b>virt-edit -c qemu:///system -d F15x32 /etc/passwd \
+ -e 's/^root:.*?:/root::/'</b>
</pre>
<p class="sourcelnk"><a href="http://libguestfs.org/virt-edit.1.html">manual ...</a></p>
- </td><td valign="top">
+ </td><td valign="top" style="padding-bottom: 1.5em;">
<pre>
<b>virt-win-reg -c qemu:///system --unsafe-printable-strings \
Win7x32 'HKLM\SYSTEM\ControlSet001\Services\Tcpip\Parameters' \
@@ -217,8 +245,20 @@ F15x32:/dev/vg_f15x32/lv_root 5.5G 3.4G 1.8G 63%
<h2>Inspection</h2>
<pre>
-$ <b>virt-inspector -c qemu:///system -d Win7x32</b>
+$ <b>virt-filesystems -c qemu:///system -d Win7x32 --all --long -h --uuid</b>
+Name Type VFS Label MBR Size Parent UUID
+/dev/sda1 filesystem ntfs System Reserved - 100M - F81C92571C92112C
+/dev/sda2 filesystem ntfs - - 20G - F2E8996AE8992E3B
+/dev/sda1 partition - - 07 100M /dev/sda -
+/dev/sda2 partition - - 07 20G /dev/sda -
+/dev/sda device - - - 20G - -
+</pre>
+<p class="sourcelnk">
+<a href="http://libguestfs.org/virt-filesystems.1.html">manual ...</a>
+</p>
+<pre>
+$ <b>virt-inspector -c qemu:///system -d Win7x32</b>
<font style="color: #888;"><?xml version="1.0"?></font>
<font style="color: #888;"><operatingsystems></font>
<font style="color: #888;"><operatingsystem></font>
@@ -235,18 +275,10 @@ $ <b>virt-inspector -c qemu:///system -d Win7x32</b>
<font style="color: #888;"><hostname></font>win7x32<font style="color: #888;"></hostname></font>
<i>... etc ...</i>
</pre>
-<p class="sourcelnk"><a href="win7.xml">full XML ...</a></p>
-
- <table>
- <tr><td colspan="2" align="middle">
- <small><i>Click to enlarge the images</i></small>
- </td></tr>
- <tr><td width="50%">
- <a href="virt-manager.png"><img src="virt-manager-t.png"></a>
- </td><td width="50%" align="middle" valign="top">
- <a href="vmm-icons.png"><img src="vmm-icons-t.png"></a>
- </td></tr>
- </table>
+<p class="sourcelnk">
+<a href="win7.xml">full XML ...</a> <br/>
+<a href="http://libguestfs.org/virt-inspector.1.html">manual ...</a>
+</p>
<pre>
char **roots;
@@ -290,15 +322,47 @@ $ <b>virt-inspector -c qemu:///system -d Win7x32</b>
</pre>
<p class="sourcelnk"><a href="http://git.annexia.org/?p=libguestfs.git;a=blob;f=rescue/virt-rescue.c;h=0c0036460434f1365d9591d6b2b805d999b07056;hb=HEAD#l351">full source ...</a></p>
+ <table>
+ <tr><td colspan="2" align="middle">
+ <small><i>Click to enlarge the images</i></small>
+ </td></tr>
+ <tr><td width="50%">
+ <a href="virt-manager.png"><img src="virt-manager-t.png"></a>
+ </td><td width="50%" align="middle" valign="top">
+ <a href="vmm-icons.png"><img src="vmm-icons-t.png"></a>
+ </td></tr>
+ </table>
+
+
+
+
+ <h2>Graphical browsers</h2>
+
+ <p>
+ <img src="https://rwmj.files.wordpress.com/2011/07/guestfs-browser1.png?w=438&h=450"/>
+ </p>
+ <p>
+ <img src="https://rwmj.files.wordpress.com/2011/07/guestfs-browser2.png?w=438&h=450"/>
+ </p>
+ <p>
+ <img src="https://rwmj.files.wordpress.com/2011/07/guestfs-browser3.png?w=366&h=450"/>
+ </p>
- <h2>V2V & P2V</h2>
+ <p>
+ <img src="https://rwmj.files.wordpress.com/2011/07/guestfs-browser4.png?w=366&h=450"/>
+ </p>
+ <p class="sourcelnk"><a href="https://rwmj.wordpress.com/2011/07/29/some-screenshots-from-the-new-guest-filesystem-browser/">source ...</a></p>
+ <p>
+ <img src="https://rwmj.files.wordpress.com/2009/11/file-browser.png?w=500"/>
+ </p>
+ <p class="sourcelnk"><a href="https://rwmj.wordpress.com/2009/11/03/browsing-guests-using-fuse/">source ...</a></p>
- <h2>Read more ...</h2>
+ <h2>Find out more ...</h2>
<p>
<a href="http://libguestfs.org/">libguestfs.org</a> is the
@@ -318,6 +382,11 @@ $ <b>virt-inspector -c qemu:///system -d Win7x32</b>
local man command.
</p>
+ <p>
+ For information about virt-v2v and virt-p2v, see
+ <a href="http://libguestfs.org/virt-v2v/">http://libguestfs.org/virt-v2v/</a>
+ </p>
+
<hr/>
<p style="font-size: 70%;">
diff --git a/contrib/intro/talk.txt b/contrib/intro/talk.txt
index d28bcc4..6fda60b 100644
--- a/contrib/intro/talk.txt
+++ b/contrib/intro/talk.txt
@@ -45,7 +45,7 @@ This is something that is possible using the libguestfs
API, but we don't encourage it. There are three reasons
why we don't encourage and support this: one is that
because we're calling this from a C program, it's hard
-to construct shell commands and deal with quoting issues.
+to construct shell commands.
Secondly it's hard to parse the result from commands
(think about parted or lvs which are two commands that
produce quite complex output that is hard to parse).
@@ -100,8 +100,8 @@ are many more than are shown here.
Starting at the top, "guestfish" is a shell for the API,
letting you write simple shell scripts. If you look at
the code examples below, you can see a small guestfish
-script that creates a new raw format partitioned filesystem
-with some content.
+script that creates a complete guest. Then we mount it on
+the host using guestmount (FUSE) and browse around.
Going round clockwise:
@@ -116,7 +116,6 @@ programs like the GNOME Nautilus file browser.
"virt-rescue" lets you use the appliance directly, and
it's a useful way to rescue guests by hand.
-You just want to hammer out some shell commands manually.
"virt-win-reg" lets you read and write Windows Registry
entries. There is a rather complex example below right.
@@ -135,3 +134,29 @@ obsolete.
[4 Inspection]
+Next I want to look at another aspect of the API which is
+called "inspection".
+
+Inspection means taking arbitrary disk images and finding
+out what they contain, from just what partitions and filesystems
+are in a disk image, to whether and what operating system(s)
+it contains, to what applications are installed.
+
+The two main command-line tools are virt-filesystems and
+virt-inspector, and you can see the output from these tools.
+However this information is also available through the
+API. The example there shows getting operating system
+inspection data from a C program. Programs can also get
+inspection information, as you can see in the screenshots
+from the latest virt-manager.
+
+[5 Graphical browsers]
+
+I've concentrated a lot on command line tools, but you can
+also use libguestfs from graphical programs. I wrote an
+experimental program called guestfs-browser, and there are
+screenshots shown. But many people will simply want to mount
+a filesystem on the host using guestmount, and then use
+ordinary tools. At the bottom is a screenshot of GNOME
+Nautilus browsing into a guest filesystem.
+
diff --git a/debian/changelog b/debian/changelog
index db4c0d3..c083a8b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,6 @@
-libguestfs (1.15.4-1) unstable; urgency=low
+libguestfs (1.15.5-1) unstable; urgency=low
- * release: New upstream version 1.15.4.
+ * release: New upstream version 1.15.5.
-- Richard W.M. Jones <rjones at redhat.com> Thu, 9 Dec 2010 12:00:00 +0000
diff --git a/examples/Makefile.am b/examples/Makefile.am
index 8d6accd..d898c99 100644
--- a/examples/Makefile.am
+++ b/examples/Makefile.am
@@ -18,11 +18,13 @@
EXTRA_DIST = \
LICENSE \
guestfs-examples.pod \
- guestfs-recipes.pod
+ guestfs-recipes.pod \
+ guestfs-testing.pod
CLEANFILES = \
stamp-guestfs-examples.pod \
- stamp-guestfs-recipes.pod
+ stamp-guestfs-recipes.pod \
+ stamp-guestfs-testing.pod
noinst_PROGRAMS = create_disk inspect_vm
if HAVE_HIVEX
@@ -57,10 +59,12 @@ virt_dhcp_address_LDADD = \
man_MANS = \
guestfs-examples.3 \
- guestfs-recipes.1
+ guestfs-recipes.1 \
+ guestfs-testing.1
noinst_DATA = \
$(top_builddir)/html/guestfs-examples.3.html \
- $(top_builddir)/html/guestfs-recipes.1.html
+ $(top_builddir)/html/guestfs-recipes.1.html \
+ $(top_builddir)/html/guestfs-testing.1.html
guestfs-examples.3 $(top_builddir)/html/guestfs-examples.3.html: stamp-guestfs-examples.pod
@@ -83,3 +87,13 @@ stamp-guestfs-recipes.pod: guestfs-recipes.pod
--html $(top_builddir)/html/guestfs-recipes.1.html \
$<
touch $@
+
+guestfs-testing.1 $(top_builddir)/html/guestfs-testing.1.html: stamp-guestfs-testing.pod
+
+stamp-guestfs-testing.pod: guestfs-testing.pod
+ $(top_builddir)/podwrapper.sh \
+ --section 1 \
+ --man guestfs-testing.1 \
+ --html $(top_builddir)/html/guestfs-testing.1.html \
+ $<
+ touch $@
diff --git a/examples/Makefile.in b/examples/Makefile.in
index e43d02f..27b03af 100644
--- a/examples/Makefile.in
+++ b/examples/Makefile.in
@@ -1257,11 +1257,13 @@ top_srcdir = @top_srcdir@
EXTRA_DIST = \
LICENSE \
guestfs-examples.pod \
- guestfs-recipes.pod
+ guestfs-recipes.pod \
+ guestfs-testing.pod
CLEANFILES = \
stamp-guestfs-examples.pod \
- stamp-guestfs-recipes.pod
+ stamp-guestfs-recipes.pod \
+ stamp-guestfs-testing.pod
create_disk_SOURCES = create_disk.c
create_disk_CFLAGS = \
@@ -1294,11 +1296,13 @@ virt_dhcp_address_LDADD = \
man_MANS = \
guestfs-examples.3 \
- guestfs-recipes.1
+ guestfs-recipes.1 \
+ guestfs-testing.1
noinst_DATA = \
$(top_builddir)/html/guestfs-examples.3.html \
- $(top_builddir)/html/guestfs-recipes.1.html
+ $(top_builddir)/html/guestfs-recipes.1.html \
+ $(top_builddir)/html/guestfs-testing.1.html
all: all-am
@@ -1758,6 +1762,16 @@ stamp-guestfs-recipes.pod: guestfs-recipes.pod
$<
touch $@
+guestfs-testing.1 $(top_builddir)/html/guestfs-testing.1.html: stamp-guestfs-testing.pod
+
+stamp-guestfs-testing.pod: guestfs-testing.pod
+ $(top_builddir)/podwrapper.sh \
+ --section 1 \
+ --man guestfs-testing.1 \
+ --html $(top_builddir)/html/guestfs-testing.1.html \
+ $<
+ touch $@
+
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:
diff --git a/examples/guestfs-testing.pod b/examples/guestfs-testing.pod
new file mode 100644
index 0000000..adf5b04
--- /dev/null
+++ b/examples/guestfs-testing.pod
@@ -0,0 +1,296 @@
+=encoding utf8
+
+=head1 NAME
+
+guestfs-testing - manual testing of libguestfs, you can help!
+
+=head1 DESCRIPTION
+
+This page has manual tests you can try on libguestfs. Everyone has a
+slightly different combination of platform, hardware and guests, so
+this testing is very valuable. Thanks for helping out!
+
+These tests require libguestfs E<ge> 1.14.
+
+Tests marked with a B<*> (asterisk) can B<destroy data> if you're not
+careful. The others are safe and won't modify anything.
+
+You can report bugs you find through this link:
+
+https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
+
+or post on the mailing list (registration is B<not> required, but if
+you're not registered then you'll have to wait for a moderator to
+manually approve your message):
+
+https://www.redhat.com/mailman/listinfo/libguestfs
+
+=head1 TESTS
+
+=head2 Check KVM acceleration is being used.
+
+If your host has hardware virt acceleration, then with a hot cache
+libguestfs should be able to start up in a few seconds. Run the
+following command a few times:
+
+ time guestfish -a /dev/null run
+
+After a few runs, the time should settle down to a few seconds (under
+5 seconds on fast 64 bit hardware).
+
+How to check for hardware virt:
+
+http://virt-tools.org/learning/check-hardware-virt/
+
+If the command above does not work at all, use
+L<libguestfs-test-tool(1)>.
+
+=head2 Run virt-alignment-scan on all your guests.
+
+Run L<virt-alignment-scan(1)> on guests or disk images:
+
+ virt-alignment-scan -a /path/to/disk.img
+
+or:
+
+ virt-alignment-scan -d Guest
+
+Does the alignment report match how the guest partitions are aligned?
+
+=head2 Run virt-cat on some files in guests.
+
+L<virt-cat(1)> can display files from guests. For a Linux guest, try:
+
+ virt-cat LinuxGuest /etc/passwd
+
+A recent feature is support for Windows paths, for example:
+
+ virt-cat WindowsGuest 'c:\windows\win.ini'
+
+An even better test is if you have a Windows guest with multiple
+drives. Do C<D:>, C<E:> etc paths work correctly?
+
+=head2 B<*> Copy some files into a B<shut off> guest.
+
+L<virt-copy-in(1)> can recursively copy files and directories
+into a guest or disk image.
+
+ virt-copy-in -d Guest /etc /tmp
+
+This should copy local directory C</etc> to C</tmp/etc> in the guest
+(recursively). If you boot the guest, can you see all of the copied
+files and directories?
+
+Shut the guest down and try copying multiple files and directories:
+
+ virt-copy-in -d Guest /home /etc/issue /tmp
+
+=head2 Copy some files out of a guest.
+
+L<virt-copy-out(1)> can recursively copy files and directories
+out of a guest or disk image.
+
+ virt-copy-out -d Guest /home .
+
+Note the final space and period in the command is not a typo.
+
+This should copy C</home> from the guest into the current directory.
+
+=head2 Run virt-df.
+
+L<virt-df(1)> lists disk space. Run:
+
+ virt-df
+
+Do the results match what's reported inside the guests?
+
+=head2 Try importing virt-df CSV output into a spreadsheet or database.
+
+Run:
+
+ virt-df --csv > /tmp/report.csv
+
+Now try to load this into your favorite spreadsheet or database. Are
+the results reproduced faithfully in the spreadsheet/database?
+
+http://www.postgresql.org/docs/8.1/static/sql-copy.html
+http://dev.mysql.com/doc/refman/5.1/en/load-data.html
+
+=head2 B<*> Edit a file in a B<shut off> guest.
+
+L<virt-edit(1)> can edit files in guests. Try this command on
+a RHEL or Fedora guest:
+
+ virt-edit LinuxGuest /etc/sysconfig/network
+
+On other Linux guests try editing other files such as:
+
+ virt-edit LinuxGuest /etc/motd
+
+Are the changes seen inside the guest when it is booted?
+
+=head2 Display the filesystems / partitions / LVs in a guest.
+
+L<virt-filesystems(1)> can be used to display filesystems in
+a guest. Try this command on any disk image or guest:
+
+ virt-filesystems -a /path/to/disk.img --all --long -h
+
+or:
+
+ virt-filesystems -d Guest --all --long -h
+
+Do the results match what is seen in the guest?
+
+=head2 Run virt-inspector on all your guests.
+
+Use L<virt-inspector(1)> to get a report on all of your guests or disk
+images:
+
+ virt-inspector -a /path/to/disk.img | less
+
+or:
+
+ virt-inspector -d Guest | less
+
+Do the results match what is actually in the guest?
+
+=head2 Try the auditing features of virt-ls on all your guests.
+
+List all setuid or setgid programs in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^- [42]'
+
+List all public-writable directories in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^d ...7'
+
+List all Unix domain sockets in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^s'
+
+List all regular files with filenames ending in '.png':
+
+ virt-ls -lR -d Guest / | grep -i '^-.*\.png$'
+
+Display files larger than 10MB in home directories:
+
+ virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'
+
+Find everything modified in the last 7 days:
+
+ virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'
+
+Find regular files modified in the last 24 hours:
+
+ virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'
+
+Do the results match what is in the guest?
+
+=head2 Create a disk image from a tarball.
+
+Use L<virt-make-fs(1)> to create a disk image from any tarball
+that you happen to have:
+
+ virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img
+
+Add 'output.img' as a raw disk to an existing guest. Check the guest
+can see the files. This test is particularly useful if you try it
+with a Windows guest.
+
+Try other partitioning schemes, eg. I<--partition=gpt>.
+
+Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>.
+
+=head2 B<*> Run virt-rescue on a B<shut off> disk image or guest.
+
+Use L<virt-rescue(1)> to examine, rescue or repair a B<shut off> guest
+or disk image:
+
+ virt-rescue -a /path/to/disk.img
+
+or:
+
+ virt-rescue -d Guest
+
+Can you use ordinary shell commands to examine the guest?
+
+=head2 B<*> Resize your guests.
+
+Use L<virt-resize(1)> to give a guest some more disk space. For
+example, if you have a disk image that is smaller than 30G, increase
+it to 30G by doing:
+
+ truncate -s 30G newdisk.img
+ virt-filesystems -a /path/to/olddisk.img --all --long -h
+ virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1
+ qemu-kvm -m 1024 -hda newdisk.img
+
+Does the guest still boot? Try expanding other partitions.
+
+=head2 B<*> Sparsify a guest disk.
+
+Using L<virt-sparsify(1)>, make a disk image more sparse:
+
+ virt-sparsify /path/to/olddisk.img newdisk.img
+
+Is C<newdisk.img> still bootable after sparsifying? Is the resulting
+disk image smaller (use C<du> to check)?
+
+=head2 B<*> "sysprep" a B<shut off> Linux guest.
+
+Note that this really will mess up an existing guest, so it's better
+to clone the guest before trying this.
+
+ virt-sysprep --hostname newhost.example.com -a /path/to/disk.img
+
+Was the sysprep successful? After booting, what changes were made and
+were they successful?
+
+=head2 Dump the Windows Registry from your Windows guests.
+
+Use L<virt-win-reg(1)> to dump out the Windows Registry from
+any Windows guests that you have.
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\Software' |
+ less
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\System' |
+ less
+
+Does the output match running C<regedit> inside the guest?
+
+A recent feature is the ability to dump user registries, so try this,
+replacing I<username> with the name of a local user in the guest:
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\username' |
+ less
+
+=head1 SEE ALSO
+
+L<guestfs(3)>,
+L<guestfish(1)>,
+L<guestfs-examples(3)>,
+L<http://libguestfs.org/>.
+
+=head1 AUTHORS
+
+Richard W.M. Jones (C<rjones at redhat dot com>)
+
+=head1 COPYRIGHT
+
+Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
diff --git a/libguestfs.pc b/libguestfs.pc
index e04f6b6..c5e0d4d 100644
--- a/libguestfs.pc
+++ b/libguestfs.pc
@@ -4,7 +4,7 @@ libdir=${exec_prefix}/lib
includedir=${prefix}/include
Name: libguestfs
-Version: 1.15.4
+Version: 1.15.5
Description: libguestfs library for accessing and modifying VM images
Requires:
Cflags:
diff --git a/po-docs/ja.po b/po-docs/ja.po
index 22bf6d7..fc821a3 100644
--- a/po-docs/ja.po
+++ b/po-docs/ja.po
@@ -9,7 +9,7 @@ msgid ""
msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: libguestfs at redhat.com\n"
-"POT-Creation-Date: 2011-11-17 13:11+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:15+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Japanese <trans-ja at lists.fedoraproject.org>\n"
@@ -24,15 +24,16 @@ msgstr ""
#: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3
#: ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3
#: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3
-#: ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3
-#: ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3
-#: ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3
-#: ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3
-#: ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3
-#: ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3
-#: ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3
-#: ../ruby/examples/guestfs-ruby.pod:3 ../sparsify/virt-sparsify.pod:3
-#: ../src/guestfs.pod:3 ../test-tool/libguestfs-test-tool.pod:3
+#: ../examples/guestfs-recipes.pod:14 ../examples/guestfs-testing.pod:3
+#: ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3
+#: ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3
+#: ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3
+#: ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3
+#: ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3
+#: ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3
+#: ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3
+#: ../sparsify/virt-sparsify.pod:3 ../src/guestfs.pod:3
+#: ../test-tool/libguestfs-test-tool.pod:3
#: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
#: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31
#: ../tools/virt-win-reg.pl:35
@@ -86,11 +87,12 @@ msgstr ""
#: ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27
#: ../erlang/examples/guestfs-erlang.pod:16
#: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
-#: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19
-#: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21
-#: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20
-#: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15
-#: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18
+#: ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30
+#: ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13
+#: ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15
+#: ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19
+#: ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25
+#: ../perl/examples/guestfs-perl.pod:18
#: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31
#: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
#: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23
@@ -973,8 +975,8 @@ msgstr ""
#: ../src/guestfs.pod:2656 ../src/guestfs.pod:2662 ../src/guestfs.pod:3062
#: ../src/guestfs.pod:3067 ../src/guestfs.pod:3071 ../src/guestfs.pod:3075
#: ../src/guestfs.pod:3079 ../src/guestfs.pod:3093 ../src/guestfs.pod:3098
-#: ../src/guestfs.pod:3329 ../src/guestfs.pod:3333 ../src/guestfs.pod:3337
-#: ../src/guestfs.pod:3341 ../tools/virt-win-reg.pl:197
+#: ../src/guestfs.pod:3330 ../src/guestfs.pod:3334 ../src/guestfs.pod:3338
+#: ../src/guestfs.pod:3342 ../tools/virt-win-reg.pl:197
#: ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208
#: ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727
#: ../tools/virt-win-reg.pl:733
@@ -1032,11 +1034,12 @@ msgstr ""
#: ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:227
#: ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97
#: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
-#: ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50
-#: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
-#: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:317
-#: ../inspector/virt-inspector.pod:395 ../java/examples/guestfs-java.pod:45
-#: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
+#: ../examples/guestfs-testing.pod:269 ../fish/guestfish.pod:1268
+#: ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39
+#: ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41
+#: ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:395
+#: ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78
+#: ../perl/examples/guestfs-perl.pod:39
#: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:325
#: ../resize/virt-resize.pod:688 ../ruby/examples/guestfs-ruby.pod:36
#: ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3270
@@ -1084,14 +1087,15 @@ msgstr ""
#: ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:239
#: ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114
#: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401
-#: ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64
-#: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62
-#: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:332
-#: ../inspector/virt-inspector.pod:418 ../java/examples/guestfs-java.pod:62
-#: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56
+#: ../examples/guestfs-testing.pod:280 ../fish/guestfish.pod:1300
+#: ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53
+#: ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55
+#: ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:418
+#: ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95
+#: ../perl/examples/guestfs-perl.pod:56
#: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:338
#: ../resize/virt-resize.pod:715 ../ruby/examples/guestfs-ruby.pod:52
-#: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3352
+#: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3353
#: ../test-tool/libguestfs-test-tool.pod:110
#: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
#: ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:315
@@ -2319,7 +2323,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:41
+#: ../cat/virt-ls.pod:41 ../examples/guestfs-testing.pod:160
msgid "List all setuid or setgid programs in a Linux virtual machine:"
msgstr ""
@@ -2332,7 +2336,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:45
+#: ../cat/virt-ls.pod:45 ../examples/guestfs-testing.pod:164
msgid "List all public-writable directories in a Linux virtual machine:"
msgstr ""
@@ -2345,7 +2349,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:49
+#: ../cat/virt-ls.pod:49 ../examples/guestfs-testing.pod:168
msgid "List all Unix domain sockets in a Linux virtual machine:"
msgstr ""
@@ -2358,7 +2362,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:53
+#: ../cat/virt-ls.pod:53 ../examples/guestfs-testing.pod:172
msgid "List all regular files with filenames ending in '.png':"
msgstr ""
@@ -2384,7 +2388,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:61
+#: ../cat/virt-ls.pod:61 ../examples/guestfs-testing.pod:180
msgid "Find everything modified in the last 7 days:"
msgstr ""
@@ -2397,7 +2401,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:65
+#: ../cat/virt-ls.pod:65 ../examples/guestfs-testing.pod:184
msgid "Find regular files modified in the last 24 hours:"
msgstr ""
@@ -4777,13 +4781,14 @@ msgstr ""
#. type: =head1
#: ../erlang/examples/guestfs-erlang.pod:110
#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397
-#: ../fish/guestfish.pod:1296 ../fish/virt-copy-in.pod:60
-#: ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58
-#: ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328
-#: ../inspector/virt-inspector.pod:404 ../java/examples/guestfs-java.pod:58
-#: ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52
+#: ../examples/guestfs-testing.pod:276 ../fish/guestfish.pod:1296
+#: ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49
+#: ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51
+#: ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:404
+#: ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91
+#: ../perl/examples/guestfs-perl.pod:52
#: ../python/examples/guestfs-python.pod:54
-#: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3348
+#: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3349
#: ../test-tool/libguestfs-test-tool.pod:106
msgid "AUTHORS"
msgstr ""
@@ -4791,20 +4796,21 @@ msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:112
#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399
-#: ../fish/guestfish.pod:1298 ../fish/virt-copy-in.pod:62
-#: ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60
-#: ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330
-#: ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93
-#: ../perl/examples/guestfs-perl.pod:54
+#: ../examples/guestfs-testing.pod:278 ../fish/guestfish.pod:1298
+#: ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51
+#: ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53
+#: ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60
+#: ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54
#: ../python/examples/guestfs-python.pod:56
-#: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3350
+#: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3351
#: ../test-tool/libguestfs-test-tool.pod:108
msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:116
-#: ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58
+#: ../examples/guestfs-testing.pod:282 ../java/examples/guestfs-java.pod:64
+#: ../perl/examples/guestfs-perl.pod:58
msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
@@ -4823,11 +4829,11 @@ msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:121
#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408
-#: ../java/examples/guestfs-java.pod:69
+#: ../examples/guestfs-testing.pod:284 ../java/examples/guestfs-java.pod:69
#: ../ocaml/examples/guestfs-ocaml.pod:102
#: ../perl/examples/guestfs-perl.pod:63
#: ../python/examples/guestfs-python.pod:65
-#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3357
+#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3358
msgid ""
"This library is free software; you can redistribute it and/or modify it "
"under the terms of the GNU Lesser General Public License as published by the "
@@ -4838,11 +4844,11 @@ msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:126
#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413
-#: ../java/examples/guestfs-java.pod:74
+#: ../examples/guestfs-testing.pod:289 ../java/examples/guestfs-java.pod:74
#: ../ocaml/examples/guestfs-ocaml.pod:107
#: ../perl/examples/guestfs-perl.pod:68
#: ../python/examples/guestfs-python.pod:70
-#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3362
+#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3363
msgid ""
"This library is distributed in the hope that it will be useful, but WITHOUT "
"ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
@@ -4853,11 +4859,11 @@ msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:131
#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418
-#: ../java/examples/guestfs-java.pod:79
+#: ../examples/guestfs-testing.pod:294 ../java/examples/guestfs-java.pod:79
#: ../ocaml/examples/guestfs-ocaml.pod:112
#: ../perl/examples/guestfs-perl.pod:73
#: ../python/examples/guestfs-python.pod:75
-#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3367
+#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3368
msgid ""
"You should have received a copy of the GNU Lesser General Public License "
"along with this library; if not, write to the Free Software Foundation, "
@@ -5197,7 +5203,7 @@ msgid ""
msgstr ""
#. type: verbatim
-#: ../examples/guestfs-recipes.pod:126
+#: ../examples/guestfs-recipes.pod:126 ../examples/guestfs-testing.pod:93
#, no-wrap
msgid ""
" virt-copy-out -d Guest /home .\n"
@@ -5763,6 +5769,683 @@ msgstr ""
msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
+#. type: textblock
+#: ../examples/guestfs-testing.pod:5
+msgid "guestfs-testing - manual testing of libguestfs, you can help!"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:9
+msgid ""
+"This page has manual tests you can try on libguestfs. Everyone has a "
+"slightly different combination of platform, hardware and guests, so this "
+"testing is very valuable. Thanks for helping out!"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:13
+msgid "These tests require libguestfs E<ge> 1.14."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:15
+msgid ""
+"Tests marked with a B<*> (asterisk) can B<destroy data> if you're not "
+"careful. The others are safe and won't modify anything."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:18
+msgid "You can report bugs you find through this link:"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:20
+msgid ""
+"https://bugzilla.redhat.com/enter_bug.cgi?"
+"component=libguestfs&product=Virtualization+Tools"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:22
+msgid ""
+"or post on the mailing list (registration is B<not> required, but if you're "
+"not registered then you'll have to wait for a moderator to manually approve "
+"your message):"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:26
+msgid "https://www.redhat.com/mailman/listinfo/libguestfs"
+msgstr ""
+
+#. type: =head1
+#: ../examples/guestfs-testing.pod:28
+msgid "TESTS"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:30
+msgid "Check KVM acceleration is being used."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:32
+msgid ""
+"If your host has hardware virt acceleration, then with a hot cache "
+"libguestfs should be able to start up in a few seconds. Run the following "
+"command a few times:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:36
+#, no-wrap
+msgid ""
+" time guestfish -a /dev/null run\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:38
+msgid ""
+"After a few runs, the time should settle down to a few seconds (under 5 "
+"seconds on fast 64 bit hardware)."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:41
+msgid "How to check for hardware virt:"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:43
+msgid "http://virt-tools.org/learning/check-hardware-virt/"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:45
+msgid ""
+"If the command above does not work at all, use L<libguestfs-test-tool(1)>."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:48
+msgid "Run virt-alignment-scan on all your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:50
+msgid "Run L<virt-alignment-scan(1)> on guests or disk images:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:52
+#, no-wrap
+msgid ""
+" virt-alignment-scan -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:139
+#: ../examples/guestfs-testing.pod:152 ../examples/guestfs-testing.pod:212
+#: ../src/guestfs.pod:2792
+msgid "or:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:56
+#, no-wrap
+msgid ""
+" virt-alignment-scan -d Guest\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:58
+msgid "Does the alignment report match how the guest partitions are aligned?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:60
+msgid "Run virt-cat on some files in guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:62
+msgid "L<virt-cat(1)> can display files from guests. For a Linux guest, try:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:64
+#, no-wrap
+msgid ""
+" virt-cat LinuxGuest /etc/passwd\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:66
+msgid "A recent feature is support for Windows paths, for example:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:68
+#, no-wrap
+msgid ""
+" virt-cat WindowsGuest 'c:\\windows\\win.ini'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:70
+msgid ""
+"An even better test is if you have a Windows guest with multiple drives. Do "
+"C<D:>, C<E:> etc paths work correctly?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:73
+msgid "B<*> Copy some files into a B<shut off> guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:75
+msgid ""
+"L<virt-copy-in(1)> can recursively copy files and directories into a guest "
+"or disk image."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:78
+#, no-wrap
+msgid ""
+" virt-copy-in -d Guest /etc /tmp\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:80
+msgid ""
+"This should copy local directory C</etc> to C</tmp/etc> in the guest "
+"(recursively). If you boot the guest, can you see all of the copied files "
+"and directories?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:84
+msgid "Shut the guest down and try copying multiple files and directories:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:86
+#, no-wrap
+msgid ""
+" virt-copy-in -d Guest /home /etc/issue /tmp\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:88
+msgid "Copy some files out of a guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:90
+msgid ""
+"L<virt-copy-out(1)> can recursively copy files and directories out of a "
+"guest or disk image."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:95
+msgid "Note the final space and period in the command is not a typo."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:97
+msgid "This should copy C</home> from the guest into the current directory."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:99
+msgid "Run virt-df."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:101
+msgid "L<virt-df(1)> lists disk space. Run:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:103
+#, no-wrap
+msgid ""
+" virt-df\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:105
+msgid "Do the results match what's reported inside the guests?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:107
+msgid "Try importing virt-df CSV output into a spreadsheet or database."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:109 ../src/guestfs.pod:3083
+msgid "Run:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:111
+#, no-wrap
+msgid ""
+" virt-df --csv > /tmp/report.csv\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:113
+msgid ""
+"Now try to load this into your favorite spreadsheet or database. Are the "
+"results reproduced faithfully in the spreadsheet/database?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:116
+msgid ""
+"http://www.postgresql.org/docs/8.1/static/sql-copy.html http://dev.mysql.com/"
+"doc/refman/5.1/en/load-data.html"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:119
+msgid "B<*> Edit a file in a B<shut off> guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:121
+msgid ""
+"L<virt-edit(1)> can edit files in guests. Try this command on a RHEL or "
+"Fedora guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:124
+#, no-wrap
+msgid ""
+" virt-edit LinuxGuest /etc/sysconfig/network\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:126
+msgid "On other Linux guests try editing other files such as:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:128
+#, no-wrap
+msgid ""
+" virt-edit LinuxGuest /etc/motd\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:130
+msgid "Are the changes seen inside the guest when it is booted?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:132
+msgid "Display the filesystems / partitions / LVs in a guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:134
+msgid ""
+"L<virt-filesystems(1)> can be used to display filesystems in a guest. Try "
+"this command on any disk image or guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:137
+#, no-wrap
+msgid ""
+" virt-filesystems -a /path/to/disk.img --all --long -h\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:141
+#, no-wrap
+msgid ""
+" virt-filesystems -d Guest --all --long -h\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:143
+msgid "Do the results match what is seen in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:145
+msgid "Run virt-inspector on all your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:147
+msgid ""
+"Use L<virt-inspector(1)> to get a report on all of your guests or disk "
+"images:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:150
+#, no-wrap
+msgid ""
+" virt-inspector -a /path/to/disk.img | less\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:154
+#, no-wrap
+msgid ""
+" virt-inspector -d Guest | less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:156
+msgid "Do the results match what is actually in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:158
+msgid "Try the auditing features of virt-ls on all your guests."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:162
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^- [42]'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:166
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^d ...7'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:170
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^s'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:174
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:176
+msgid "Display files larger than 10MB in home directories:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:178
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:182
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:186
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:188
+msgid "Do the results match what is in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:190
+msgid "Create a disk image from a tarball."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:192
+msgid ""
+"Use L<virt-make-fs(1)> to create a disk image from any tarball that you "
+"happen to have:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:195
+#, no-wrap
+msgid ""
+" virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:197
+msgid ""
+"Add 'output.img' as a raw disk to an existing guest. Check the guest can "
+"see the files. This test is particularly useful if you try it with a "
+"Windows guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:201
+msgid "Try other partitioning schemes, eg. I<--partition=gpt>."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:203
+msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:205
+msgid "B<*> Run virt-rescue on a B<shut off> disk image or guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:207
+msgid ""
+"Use L<virt-rescue(1)> to examine, rescue or repair a B<shut off> guest or "
+"disk image:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:210
+#, no-wrap
+msgid ""
+" virt-rescue -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:214
+#, no-wrap
+msgid ""
+" virt-rescue -d Guest\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:216
+msgid "Can you use ordinary shell commands to examine the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:218
+msgid "B<*> Resize your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:220
+msgid ""
+"Use L<virt-resize(1)> to give a guest some more disk space. For example, if "
+"you have a disk image that is smaller than 30G, increase it to 30G by doing:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:224
+#, no-wrap
+msgid ""
+" truncate -s 30G newdisk.img\n"
+" virt-filesystems -a /path/to/olddisk.img --all --long -h\n"
+" virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1\n"
+" qemu-kvm -m 1024 -hda newdisk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:229
+msgid "Does the guest still boot? Try expanding other partitions."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:231
+msgid "B<*> Sparsify a guest disk."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:233
+msgid "Using L<virt-sparsify(1)>, make a disk image more sparse:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:235
+#, no-wrap
+msgid ""
+" virt-sparsify /path/to/olddisk.img newdisk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:237
+msgid ""
+"Is C<newdisk.img> still bootable after sparsifying? Is the resulting disk "
+"image smaller (use C<du> to check)?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:240
+msgid "B<*> \"sysprep\" a B<shut off> Linux guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:242
+msgid ""
+"Note that this really will mess up an existing guest, so it's better to "
+"clone the guest before trying this."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:245
+#, no-wrap
+msgid ""
+" virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:247
+msgid ""
+"Was the sysprep successful? After booting, what changes were made and were "
+"they successful?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:250
+msgid "Dump the Windows Registry from your Windows guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:252
+msgid ""
+"Use L<virt-win-reg(1)> to dump out the Windows Registry from any Windows "
+"guests that you have."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:255
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:258
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:261
+msgid "Does the output match running C<regedit> inside the guest?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:263
+msgid ""
+"A recent feature is the ability to dump user registries, so try this, "
+"replacing I<username> with the name of a local user in the guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:266
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:271
+msgid ""
+"L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<http://libguestfs."
+"org/>."
+msgstr ""
+
#. type: =head2
#: ../fish/guestfish-actions.pod:1
msgid "add-cdrom"
@@ -21202,7 +21885,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3354
+#: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3355
#: ../test-tool/libguestfs-test-tool.pod:112
msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
@@ -40139,11 +40822,6 @@ msgstr ""
msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
msgstr ""
-#. type: textblock
-#: ../src/guestfs.pod:2792
-msgid "or:"
-msgstr ""
-
#. type: verbatim
#: ../src/guestfs.pod:2794
#, no-wrap
@@ -40762,11 +41440,6 @@ msgstr ""
msgid "Push and pull from Transifex."
msgstr ""
-#. type: textblock
-#: ../src/guestfs.pod:3083
-msgid "Run:"
-msgstr ""
-
#. type: verbatim
#: ../src/guestfs.pod:3085
#, no-wrap
@@ -41052,70 +41725,70 @@ msgid ""
"L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, "
"L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue"
"(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>, L<virt-sysprep(1)>, L<virt-tar"
-"(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)>, "
-"L<febootstrap(1)>, L<febootstrap-supermin-helper(8)>, L<hivex(3)>, L<stap(1)"
-">, L<http://libguestfs.org/>."
+"(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<guestfs-"
+"testing(1)>, L<qemu(1)>, L<febootstrap(1)>, L<febootstrap-supermin-helper(8)"
+">, L<hivex(3)>, L<stap(1)>, L<http://libguestfs.org/>."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3308
+#: ../src/guestfs.pod:3309
msgid ""
"Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
"(8)>, L<disktype(1)>."
msgstr ""
#. type: =head1
-#: ../src/guestfs.pod:3315 ../tools/virt-make-fs.pl:571
+#: ../src/guestfs.pod:3316 ../tools/virt-make-fs.pl:571
#: ../tools/virt-win-reg.pl:772
msgid "BUGS"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3317
+#: ../src/guestfs.pod:3318
msgid "To get a list of bugs against libguestfs use this link:"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3319
+#: ../src/guestfs.pod:3320
msgid ""
"L<https://bugzilla.redhat.com/buglist.cgi?"
"component=libguestfs&product=Virtualization+Tools>"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3321
+#: ../src/guestfs.pod:3322
msgid "To report a new bug against libguestfs use this link:"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3323
+#: ../src/guestfs.pod:3324
msgid ""
"L<https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools>"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3325
+#: ../src/guestfs.pod:3326
msgid "When reporting a bug, please check:"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3331
+#: ../src/guestfs.pod:3332
msgid "That the bug hasn't been reported already."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3335
+#: ../src/guestfs.pod:3336
msgid "That you are testing a recent version."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3339
+#: ../src/guestfs.pod:3340
msgid "Describe the bug accurately, and give a way to reproduce it."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3343
+#: ../src/guestfs.pod:3344
msgid ""
"Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
"bug report."
diff --git a/po-docs/ja/guestfish.1 b/po-docs/ja/guestfish.1
index de59aa9..907322a 100644
--- a/po-docs/ja/guestfish.1
+++ b/po-docs/ja/guestfish.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "guestfish 1"
-.TH guestfish 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH guestfish 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/guestfs-testing.pod b/po-docs/ja/guestfs-testing.pod
new file mode 100644
index 0000000..c65bd76
--- /dev/null
+++ b/po-docs/ja/guestfs-testing.pod
@@ -0,0 +1,293 @@
+=encoding utf8
+
+=head1 名前
+
+guestfs-testing - manual testing of libguestfs, you can help!
+
+=head1 DESCRIPTION
+
+This page has manual tests you can try on libguestfs. Everyone has a
+slightly different combination of platform, hardware and guests, so this
+testing is very valuable. Thanks for helping out!
+
+These tests require libguestfs E<ge> 1.14.
+
+Tests marked with a B<*> (asterisk) can B<destroy data> if you're not
+careful. The others are safe and won't modify anything.
+
+You can report bugs you find through this link:
+
+https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
+
+or post on the mailing list (registration is B<not> required, but if you're
+not registered then you'll have to wait for a moderator to manually approve
+your message):
+
+https://www.redhat.com/mailman/listinfo/libguestfs
+
+=head1 TESTS
+
+=head2 Check KVM acceleration is being used.
+
+If your host has hardware virt acceleration, then with a hot cache
+libguestfs should be able to start up in a few seconds. Run the following
+command a few times:
+
+ time guestfish -a /dev/null run
+
+After a few runs, the time should settle down to a few seconds (under 5
+seconds on fast 64 bit hardware).
+
+How to check for hardware virt:
+
+http://virt-tools.org/learning/check-hardware-virt/
+
+If the command above does not work at all, use L<libguestfs-test-tool(1)>.
+
+=head2 Run virt-alignment-scan on all your guests.
+
+Run L<virt-alignment-scan(1)> on guests or disk images:
+
+ virt-alignment-scan -a /path/to/disk.img
+
+or:
+
+ virt-alignment-scan -d Guest
+
+Does the alignment report match how the guest partitions are aligned?
+
+=head2 Run virt-cat on some files in guests.
+
+L<virt-cat(1)> can display files from guests. For a Linux guest, try:
+
+ virt-cat LinuxGuest /etc/passwd
+
+A recent feature is support for Windows paths, for example:
+
+ virt-cat WindowsGuest 'c:\windows\win.ini'
+
+An even better test is if you have a Windows guest with multiple drives. Do
+C<D:>, C<E:> etc paths work correctly?
+
+=head2 B<*> Copy some files into a B<shut off> guest.
+
+L<virt-copy-in(1)> can recursively copy files and directories into a guest
+or disk image.
+
+ virt-copy-in -d Guest /etc /tmp
+
+This should copy local directory C</etc> to C</tmp/etc> in the guest
+(recursively). If you boot the guest, can you see all of the copied files
+and directories?
+
+Shut the guest down and try copying multiple files and directories:
+
+ virt-copy-in -d Guest /home /etc/issue /tmp
+
+=head2 Copy some files out of a guest.
+
+L<virt-copy-out(1)> can recursively copy files and directories out of a
+guest or disk image.
+
+ virt-copy-out -d Guest /home .
+
+Note the final space and period in the command is not a typo.
+
+This should copy C</home> from the guest into the current directory.
+
+=head2 Run virt-df.
+
+L<virt-df(1)> lists disk space. Run:
+
+ virt-df
+
+Do the results match what's reported inside the guests?
+
+=head2 Try importing virt-df CSV output into a spreadsheet or database.
+
+Run:
+
+ virt-df --csv > /tmp/report.csv
+
+Now try to load this into your favorite spreadsheet or database. Are the
+results reproduced faithfully in the spreadsheet/database?
+
+http://www.postgresql.org/docs/8.1/static/sql-copy.html
+http://dev.mysql.com/doc/refman/5.1/en/load-data.html
+
+=head2 B<*> Edit a file in a B<shut off> guest.
+
+L<virt-edit(1)> can edit files in guests. Try this command on a RHEL or
+Fedora guest:
+
+ virt-edit LinuxGuest /etc/sysconfig/network
+
+On other Linux guests try editing other files such as:
+
+ virt-edit LinuxGuest /etc/motd
+
+Are the changes seen inside the guest when it is booted?
+
+=head2 Display the filesystems / partitions / LVs in a guest.
+
+L<virt-filesystems(1)> can be used to display filesystems in a guest. Try
+this command on any disk image or guest:
+
+ virt-filesystems -a /path/to/disk.img --all --long -h
+
+or:
+
+ virt-filesystems -d Guest --all --long -h
+
+Do the results match what is seen in the guest?
+
+=head2 Run virt-inspector on all your guests.
+
+Use L<virt-inspector(1)> to get a report on all of your guests or disk
+images:
+
+ virt-inspector -a /path/to/disk.img | less
+
+or:
+
+ virt-inspector -d Guest | less
+
+Do the results match what is actually in the guest?
+
+=head2 Try the auditing features of virt-ls on all your guests.
+
+List all setuid or setgid programs in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^- [42]'
+
+List all public-writable directories in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^d ...7'
+
+List all Unix domain sockets in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^s'
+
+List all regular files with filenames ending in '.png':
+
+ virt-ls -lR -d Guest / | grep -i '^-.*\.png$'
+
+Display files larger than 10MB in home directories:
+
+ virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'
+
+Find everything modified in the last 7 days:
+
+ virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'
+
+Find regular files modified in the last 24 hours:
+
+ virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'
+
+Do the results match what is in the guest?
+
+=head2 Create a disk image from a tarball.
+
+Use L<virt-make-fs(1)> to create a disk image from any tarball that you
+happen to have:
+
+ virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img
+
+Add 'output.img' as a raw disk to an existing guest. Check the guest can
+see the files. This test is particularly useful if you try it with a
+Windows guest.
+
+Try other partitioning schemes, eg. I<--partition=gpt>.
+
+Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>.
+
+=head2 B<*> Run virt-rescue on a B<shut off> disk image or guest.
+
+Use L<virt-rescue(1)> to examine, rescue or repair a B<shut off> guest or
+disk image:
+
+ virt-rescue -a /path/to/disk.img
+
+or:
+
+ virt-rescue -d Guest
+
+Can you use ordinary shell commands to examine the guest?
+
+=head2 B<*> Resize your guests.
+
+Use L<virt-resize(1)> to give a guest some more disk space. For example, if
+you have a disk image that is smaller than 30G, increase it to 30G by doing:
+
+ truncate -s 30G newdisk.img
+ virt-filesystems -a /path/to/olddisk.img --all --long -h
+ virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1
+ qemu-kvm -m 1024 -hda newdisk.img
+
+Does the guest still boot? Try expanding other partitions.
+
+=head2 B<*> Sparsify a guest disk.
+
+Using L<virt-sparsify(1)>, make a disk image more sparse:
+
+ virt-sparsify /path/to/olddisk.img newdisk.img
+
+Is C<newdisk.img> still bootable after sparsifying? Is the resulting disk
+image smaller (use C<du> to check)?
+
+=head2 B<*> "sysprep" a B<shut off> Linux guest.
+
+Note that this really will mess up an existing guest, so it's better to
+clone the guest before trying this.
+
+ virt-sysprep --hostname newhost.example.com -a /path/to/disk.img
+
+Was the sysprep successful? After booting, what changes were made and were
+they successful?
+
+=head2 Dump the Windows Registry from your Windows guests.
+
+Use L<virt-win-reg(1)> to dump out the Windows Registry from any Windows
+guests that you have.
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\Software' |
+ less
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\System' |
+ less
+
+Does the output match running C<regedit> inside the guest?
+
+A recent feature is the ability to dump user registries, so try this,
+replacing I<username> with the name of a local user in the guest:
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\username' |
+ less
+
+=head1 SEE ALSO
+
+L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>,
+L<http://libguestfs.org/>.
+
+=head1 AUTHORS
+
+Richard W.M. Jones (C<rjones at redhat dot com>)
+
+=head1 COPYRIGHT
+
+Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>
+
+This library is free software; you can redistribute it and/or modify it
+under the terms of the GNU Lesser General Public License as published by the
+Free Software Foundation; either version 2 of the License, or (at your
+option) any later version.
+
+This library is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with this library; if not, write to the Free Software Foundation,
+Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
diff --git a/po-docs/ja/guestfs.3 b/po-docs/ja/guestfs.3
index e7667a0..c6232b5 100644
--- a/po-docs/ja/guestfs.3
+++ b/po-docs/ja/guestfs.3
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "guestfs 3"
-.TH guestfs 3 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH guestfs 3 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -12081,7 +12081,7 @@ use in case \f(CW\*(C`/var/tmp\*(C'\fR is not large enough.
\&\fIvirt\-list\-partitions\fR\|(1), \fIvirt\-ls\fR\|(1), \fIvirt\-make\-fs\fR\|(1),
\&\fIvirt\-rescue\fR\|(1), \fIvirt\-resize\fR\|(1), \fIvirt\-sparsify\fR\|(1),
\&\fIvirt\-sysprep\fR\|(1), \fIvirt\-tar\fR\|(1), \fIvirt\-tar\-in\fR\|(1), \fIvirt\-tar\-out\fR\|(1),
-\&\fIvirt\-win\-reg\fR\|(1), \fIqemu\fR\|(1), \fIfebootstrap\fR\|(1),
+\&\fIvirt\-win\-reg\fR\|(1), \fIguestfs\-testing\fR\|(1), \fIqemu\fR\|(1), \fIfebootstrap\fR\|(1),
\&\fIfebootstrap\-supermin\-helper\fR\|(8), \fIhivex\fR\|(3), \fIstap\fR\|(1),
<http://libguestfs.org/>.
.PP
diff --git a/po-docs/ja/guestfs.pod b/po-docs/ja/guestfs.pod
index 2e38280..11bc9d0 100644
--- a/po-docs/ja/guestfs.pod
+++ b/po-docs/ja/guestfs.pod
@@ -3163,7 +3163,7 @@ L<virt-inspector(1)>, L<virt-list-filesystems(1)>,
L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>,
L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>,
L<virt-sysprep(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>,
-L<virt-win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>,
+L<virt-win-reg(1)>, L<guestfs-testing(1)>, L<qemu(1)>, L<febootstrap(1)>,
L<febootstrap-supermin-helper(8)>, L<hivex(3)>, L<stap(1)>,
L<http://libguestfs.org/>.
diff --git a/po-docs/ja/guestmount.1 b/po-docs/ja/guestmount.1
index e97fb6a..b3fdd7a 100644
--- a/po-docs/ja/guestmount.1
+++ b/po-docs/ja/guestmount.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "guestmount 1"
-.TH guestmount 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH guestmount 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/libguestfs-test-tool.1 b/po-docs/ja/libguestfs-test-tool.1
index b102630..c7849ac 100644
--- a/po-docs/ja/libguestfs-test-tool.1
+++ b/po-docs/ja/libguestfs-test-tool.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "libguestfs-test-tool 1"
-.TH libguestfs-test-tool 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH libguestfs-test-tool 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-alignment-scan.1 b/po-docs/ja/virt-alignment-scan.1
index 548eac8..5b709a5 100644
--- a/po-docs/ja/virt-alignment-scan.1
+++ b/po-docs/ja/virt-alignment-scan.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-alignment-scan 1"
-.TH virt-alignment-scan 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-alignment-scan 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-cat.1 b/po-docs/ja/virt-cat.1
index 3bfa6e4..81fbabe 100644
--- a/po-docs/ja/virt-cat.1
+++ b/po-docs/ja/virt-cat.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-cat 1"
-.TH virt-cat 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-cat 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-copy-in.1 b/po-docs/ja/virt-copy-in.1
index b5ad4c5..73615ac 100644
--- a/po-docs/ja/virt-copy-in.1
+++ b/po-docs/ja/virt-copy-in.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-copy-in 1"
-.TH virt-copy-in 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-copy-in 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-copy-out.1 b/po-docs/ja/virt-copy-out.1
index a30909f..e2574db 100644
--- a/po-docs/ja/virt-copy-out.1
+++ b/po-docs/ja/virt-copy-out.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-copy-out 1"
-.TH virt-copy-out 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-copy-out 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-df.1 b/po-docs/ja/virt-df.1
index eda691e..c1f5b26 100644
--- a/po-docs/ja/virt-df.1
+++ b/po-docs/ja/virt-df.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-df 1"
-.TH virt-df 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-df 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-edit.1 b/po-docs/ja/virt-edit.1
index b33f8ee..fb7877b 100644
--- a/po-docs/ja/virt-edit.1
+++ b/po-docs/ja/virt-edit.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-edit 1"
-.TH virt-edit 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-edit 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-filesystems.1 b/po-docs/ja/virt-filesystems.1
index a89a369..1f4a077 100644
--- a/po-docs/ja/virt-filesystems.1
+++ b/po-docs/ja/virt-filesystems.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-filesystems 1"
-.TH virt-filesystems 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-filesystems 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-inspector.1 b/po-docs/ja/virt-inspector.1
index f8f76cf..ade38ff 100644
--- a/po-docs/ja/virt-inspector.1
+++ b/po-docs/ja/virt-inspector.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-inspector 1"
-.TH virt-inspector 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-inspector 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-list-filesystems.1 b/po-docs/ja/virt-list-filesystems.1
index a0cb7ef..b936410 100644
--- a/po-docs/ja/virt-list-filesystems.1
+++ b/po-docs/ja/virt-list-filesystems.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-list-filesystems.pl 1"
-.TH virt-list-filesystems.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-list-filesystems.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-list-partitions.1 b/po-docs/ja/virt-list-partitions.1
index ddf87d5..6a7b42a 100644
--- a/po-docs/ja/virt-list-partitions.1
+++ b/po-docs/ja/virt-list-partitions.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-list-partitions.pl 1"
-.TH virt-list-partitions.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-list-partitions.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-ls.1 b/po-docs/ja/virt-ls.1
index b67eb07..a572967 100644
--- a/po-docs/ja/virt-ls.1
+++ b/po-docs/ja/virt-ls.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-ls 1"
-.TH virt-ls 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-ls 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-make-fs.1 b/po-docs/ja/virt-make-fs.1
index 612abce..562ad23 100644
--- a/po-docs/ja/virt-make-fs.1
+++ b/po-docs/ja/virt-make-fs.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-make-fs.pl 1"
-.TH virt-make-fs.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-make-fs.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-rescue.1 b/po-docs/ja/virt-rescue.1
index ad1f292..0586869 100644
--- a/po-docs/ja/virt-rescue.1
+++ b/po-docs/ja/virt-rescue.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-rescue 1"
-.TH virt-rescue 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-rescue 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-resize.1 b/po-docs/ja/virt-resize.1
index eb7c388..8adbb90 100644
--- a/po-docs/ja/virt-resize.1
+++ b/po-docs/ja/virt-resize.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-resize 1"
-.TH virt-resize 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-resize 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-sparsify.1 b/po-docs/ja/virt-sparsify.1
index bc8b04a..db5e789 100644
--- a/po-docs/ja/virt-sparsify.1
+++ b/po-docs/ja/virt-sparsify.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-sparsify 1"
-.TH virt-sparsify 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-sparsify 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-sysprep.1 b/po-docs/ja/virt-sysprep.1
index 477cd01..5935a01 100644
--- a/po-docs/ja/virt-sysprep.1
+++ b/po-docs/ja/virt-sysprep.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-sysprep 1"
-.TH virt-sysprep 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-sysprep 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-tar-in.1 b/po-docs/ja/virt-tar-in.1
index e6ab8b0..ea0107a 100644
--- a/po-docs/ja/virt-tar-in.1
+++ b/po-docs/ja/virt-tar-in.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-tar-in 1"
-.TH virt-tar-in 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-tar-in 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-tar-out.1 b/po-docs/ja/virt-tar-out.1
index c82a7fe..63af837 100644
--- a/po-docs/ja/virt-tar-out.1
+++ b/po-docs/ja/virt-tar-out.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-tar-out 1"
-.TH virt-tar-out 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-tar-out 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-tar.1 b/po-docs/ja/virt-tar.1
index 9468dea..ff76b73 100644
--- a/po-docs/ja/virt-tar.1
+++ b/po-docs/ja/virt-tar.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-tar.pl 1"
-.TH virt-tar.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-tar.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/ja/virt-win-reg.1 b/po-docs/ja/virt-win-reg.1
index 093fe10..ca5d825 100644
--- a/po-docs/ja/virt-win-reg.1
+++ b/po-docs/ja/virt-win-reg.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-win-reg.pl 1"
-.TH virt-win-reg.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-win-reg.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot
index cd641d6..a65563d 100644
--- a/po-docs/libguestfs-docs.pot
+++ b/po-docs/libguestfs-docs.pot
@@ -6,9 +6,9 @@
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: libguestfs 1.15.4\n"
+"Project-Id-Version: libguestfs 1.15.5\n"
"Report-Msgid-Bugs-To: libguestfs at redhat.com\n"
-"POT-Creation-Date: 2011-11-17 13:11+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <LL at li.org>\n"
@@ -18,7 +18,7 @@ msgstr ""
"Content-Transfer-Encoding: 8bit\n"
#. type: =head1
-#: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3 ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3 ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3 ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3 ../java/ [...]
+#: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3 ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3 ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3 ../examples/guestfs-recipes.pod:14 ../examples/guestfs-testing.pod:3 ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3 ../inspe [...]
msgid "NAME"
msgstr ""
@@ -49,7 +49,7 @@ msgid ""
msgstr ""
#. type: =head1
-#: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16 ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18 ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20 ../inspector/virt-inspector [...]
+#: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 ../erlang/examples/guestfs-erlang.pod:16 ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18 ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 ../fuse/guestmount. [...]
msgid "DESCRIPTION"
msgstr ""
@@ -697,7 +697,7 @@ msgid "This program returns:"
msgstr ""
#. type: =item
-#: ../align/virt-alignment-scan.pod:324 ../align/virt-alignment-scan.pod:330 ../align/virt-alignment-scan.pod:336 ../align/virt-alignment-scan.pod:343 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318 ../clone/vi [...]
+#: ../align/virt-alignment-scan.pod:324 ../align/virt-alignment-scan.pod:330 ../align/virt-alignment-scan.pod:336 ../align/virt-alignment-scan.pod:343 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318 ../clone/vi [...]
msgid "*"
msgstr ""
@@ -746,7 +746,7 @@ msgid ""
msgstr ""
#. type: =head1
-#: ../align/virt-alignment-scan.pod:352 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:227 ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:317 ../inspector/vir [...]
+#: ../align/virt-alignment-scan.pod:352 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:227 ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:269 ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse [...]
msgid "SEE ALSO"
msgstr ""
@@ -768,7 +768,7 @@ msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
msgstr ""
#. type: =head1
-#: ../align/virt-alignment-scan.pod:365 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:239 ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:332 ../inspector/vi [...]
+#: ../align/virt-alignment-scan.pod:365 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:239 ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:280 ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fus [...]
msgid "COPYRIGHT"
msgstr ""
@@ -1917,7 +1917,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:41
+#: ../cat/virt-ls.pod:41 ../examples/guestfs-testing.pod:160
msgid "List all setuid or setgid programs in a Linux virtual machine:"
msgstr ""
@@ -1930,7 +1930,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:45
+#: ../cat/virt-ls.pod:45 ../examples/guestfs-testing.pod:164
msgid "List all public-writable directories in a Linux virtual machine:"
msgstr ""
@@ -1943,7 +1943,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:49
+#: ../cat/virt-ls.pod:49 ../examples/guestfs-testing.pod:168
msgid "List all Unix domain sockets in a Linux virtual machine:"
msgstr ""
@@ -1956,7 +1956,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:53
+#: ../cat/virt-ls.pod:53 ../examples/guestfs-testing.pod:172
msgid "List all regular files with filenames ending in '.png':"
msgstr ""
@@ -1982,7 +1982,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:61
+#: ../cat/virt-ls.pod:61 ../examples/guestfs-testing.pod:180
msgid "Find everything modified in the last 7 days:"
msgstr ""
@@ -1995,7 +1995,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:65
+#: ../cat/virt-ls.pod:65 ../examples/guestfs-testing.pod:184
msgid "Find regular files modified in the last 24 hours:"
msgstr ""
@@ -4343,17 +4343,17 @@ msgid ""
msgstr ""
#. type: =head1
-#: ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 ../fish/guestfish.pod:1296 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:404 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/gu [...]
+#: ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:276 ../fish/guestfish.pod:1296 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:404 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guest [...]
msgid "AUTHORS"
msgstr ""
#. type: textblock
-#: ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 ../fish/guestfish.pod:1298 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod [...]
+#: ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 ../examples/guestfs-testing.pod:278 ../fish/guestfish.pod:1298 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/gu [...]
msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
msgstr ""
#. type: textblock
-#: ../erlang/examples/guestfs-erlang.pod:116 ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58
+#: ../erlang/examples/guestfs-erlang.pod:116 ../examples/guestfs-testing.pod:282 ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58
msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
@@ -4365,7 +4365,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3357
+#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 ../examples/guestfs-testing.pod:284 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3358
msgid ""
"This library is free software; you can redistribute it and/or modify it "
"under the terms of the GNU Lesser General Public License as published by the "
@@ -4374,7 +4374,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3362
+#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 ../examples/guestfs-testing.pod:289 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3363
msgid ""
"This library is distributed in the hope that it will be useful, but WITHOUT "
"ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
@@ -4383,7 +4383,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3367
+#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 ../examples/guestfs-testing.pod:294 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3368
msgid ""
"You should have received a copy of the GNU Lesser General Public License "
"along with this library; if not, write to the Free Software Foundation, "
@@ -4710,7 +4710,7 @@ msgid "To export C</home> from a VM into a local directory use L<virt-copy-out(1
msgstr ""
#. type: verbatim
-#: ../examples/guestfs-recipes.pod:126
+#: ../examples/guestfs-recipes.pod:126 ../examples/guestfs-testing.pod:93
#, no-wrap
msgid ""
" virt-copy-out -d Guest /home .\n"
@@ -5256,6 +5256,679 @@ msgstr ""
msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
+#. type: textblock
+#: ../examples/guestfs-testing.pod:5
+msgid "guestfs-testing - manual testing of libguestfs, you can help!"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:9
+msgid ""
+"This page has manual tests you can try on libguestfs. Everyone has a "
+"slightly different combination of platform, hardware and guests, so this "
+"testing is very valuable. Thanks for helping out!"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:13
+msgid "These tests require libguestfs E<ge> 1.14."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:15
+msgid ""
+"Tests marked with a B<*> (asterisk) can B<destroy data> if you're not "
+"careful. The others are safe and won't modify anything."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:18
+msgid "You can report bugs you find through this link:"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:20
+msgid "https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:22
+msgid ""
+"or post on the mailing list (registration is B<not> required, but if you're "
+"not registered then you'll have to wait for a moderator to manually approve "
+"your message):"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:26
+msgid "https://www.redhat.com/mailman/listinfo/libguestfs"
+msgstr ""
+
+#. type: =head1
+#: ../examples/guestfs-testing.pod:28
+msgid "TESTS"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:30
+msgid "Check KVM acceleration is being used."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:32
+msgid ""
+"If your host has hardware virt acceleration, then with a hot cache "
+"libguestfs should be able to start up in a few seconds. Run the following "
+"command a few times:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:36
+#, no-wrap
+msgid ""
+" time guestfish -a /dev/null run\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:38
+msgid ""
+"After a few runs, the time should settle down to a few seconds (under 5 "
+"seconds on fast 64 bit hardware)."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:41
+msgid "How to check for hardware virt:"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:43
+msgid "http://virt-tools.org/learning/check-hardware-virt/"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:45
+msgid "If the command above does not work at all, use L<libguestfs-test-tool(1)>."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:48
+msgid "Run virt-alignment-scan on all your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:50
+msgid "Run L<virt-alignment-scan(1)> on guests or disk images:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:52
+#, no-wrap
+msgid ""
+" virt-alignment-scan -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:139 ../examples/guestfs-testing.pod:152 ../examples/guestfs-testing.pod:212 ../src/guestfs.pod:2792
+msgid "or:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:56
+#, no-wrap
+msgid ""
+" virt-alignment-scan -d Guest\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:58
+msgid "Does the alignment report match how the guest partitions are aligned?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:60
+msgid "Run virt-cat on some files in guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:62
+msgid "L<virt-cat(1)> can display files from guests. For a Linux guest, try:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:64
+#, no-wrap
+msgid ""
+" virt-cat LinuxGuest /etc/passwd\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:66
+msgid "A recent feature is support for Windows paths, for example:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:68
+#, no-wrap
+msgid ""
+" virt-cat WindowsGuest 'c:\\windows\\win.ini'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:70
+msgid ""
+"An even better test is if you have a Windows guest with multiple drives. Do "
+"C<D:>, C<E:> etc paths work correctly?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:73
+msgid "B<*> Copy some files into a B<shut off> guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:75
+msgid ""
+"L<virt-copy-in(1)> can recursively copy files and directories into a guest "
+"or disk image."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:78
+#, no-wrap
+msgid ""
+" virt-copy-in -d Guest /etc /tmp\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:80
+msgid ""
+"This should copy local directory C</etc> to C</tmp/etc> in the guest "
+"(recursively). If you boot the guest, can you see all of the copied files "
+"and directories?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:84
+msgid "Shut the guest down and try copying multiple files and directories:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:86
+#, no-wrap
+msgid ""
+" virt-copy-in -d Guest /home /etc/issue /tmp\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:88
+msgid "Copy some files out of a guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:90
+msgid ""
+"L<virt-copy-out(1)> can recursively copy files and directories out of a "
+"guest or disk image."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:95
+msgid "Note the final space and period in the command is not a typo."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:97
+msgid "This should copy C</home> from the guest into the current directory."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:99
+msgid "Run virt-df."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:101
+msgid "L<virt-df(1)> lists disk space. Run:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:103
+#, no-wrap
+msgid ""
+" virt-df\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:105
+msgid "Do the results match what's reported inside the guests?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:107
+msgid "Try importing virt-df CSV output into a spreadsheet or database."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:109 ../src/guestfs.pod:3083
+msgid "Run:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:111
+#, no-wrap
+msgid ""
+" virt-df --csv > /tmp/report.csv\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:113
+msgid ""
+"Now try to load this into your favorite spreadsheet or database. Are the "
+"results reproduced faithfully in the spreadsheet/database?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:116
+msgid ""
+"http://www.postgresql.org/docs/8.1/static/sql-copy.html "
+"http://dev.mysql.com/doc/refman/5.1/en/load-data.html"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:119
+msgid "B<*> Edit a file in a B<shut off> guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:121
+msgid ""
+"L<virt-edit(1)> can edit files in guests. Try this command on a RHEL or "
+"Fedora guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:124
+#, no-wrap
+msgid ""
+" virt-edit LinuxGuest /etc/sysconfig/network\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:126
+msgid "On other Linux guests try editing other files such as:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:128
+#, no-wrap
+msgid ""
+" virt-edit LinuxGuest /etc/motd\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:130
+msgid "Are the changes seen inside the guest when it is booted?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:132
+msgid "Display the filesystems / partitions / LVs in a guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:134
+msgid ""
+"L<virt-filesystems(1)> can be used to display filesystems in a guest. Try "
+"this command on any disk image or guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:137
+#, no-wrap
+msgid ""
+" virt-filesystems -a /path/to/disk.img --all --long -h\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:141
+#, no-wrap
+msgid ""
+" virt-filesystems -d Guest --all --long -h\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:143
+msgid "Do the results match what is seen in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:145
+msgid "Run virt-inspector on all your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:147
+msgid ""
+"Use L<virt-inspector(1)> to get a report on all of your guests or disk "
+"images:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:150
+#, no-wrap
+msgid ""
+" virt-inspector -a /path/to/disk.img | less\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:154
+#, no-wrap
+msgid ""
+" virt-inspector -d Guest | less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:156
+msgid "Do the results match what is actually in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:158
+msgid "Try the auditing features of virt-ls on all your guests."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:162
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^- [42]'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:166
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^d ...7'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:170
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^s'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:174
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:176
+msgid "Display files larger than 10MB in home directories:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:178
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:182
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:186
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:188
+msgid "Do the results match what is in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:190
+msgid "Create a disk image from a tarball."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:192
+msgid ""
+"Use L<virt-make-fs(1)> to create a disk image from any tarball that you "
+"happen to have:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:195
+#, no-wrap
+msgid ""
+" virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:197
+msgid ""
+"Add 'output.img' as a raw disk to an existing guest. Check the guest can "
+"see the files. This test is particularly useful if you try it with a "
+"Windows guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:201
+msgid "Try other partitioning schemes, eg. I<--partition=gpt>."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:203
+msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:205
+msgid "B<*> Run virt-rescue on a B<shut off> disk image or guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:207
+msgid ""
+"Use L<virt-rescue(1)> to examine, rescue or repair a B<shut off> guest or "
+"disk image:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:210
+#, no-wrap
+msgid ""
+" virt-rescue -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:214
+#, no-wrap
+msgid ""
+" virt-rescue -d Guest\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:216
+msgid "Can you use ordinary shell commands to examine the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:218
+msgid "B<*> Resize your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:220
+msgid ""
+"Use L<virt-resize(1)> to give a guest some more disk space. For example, if "
+"you have a disk image that is smaller than 30G, increase it to 30G by doing:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:224
+#, no-wrap
+msgid ""
+" truncate -s 30G newdisk.img\n"
+" virt-filesystems -a /path/to/olddisk.img --all --long -h\n"
+" virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1\n"
+" qemu-kvm -m 1024 -hda newdisk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:229
+msgid "Does the guest still boot? Try expanding other partitions."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:231
+msgid "B<*> Sparsify a guest disk."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:233
+msgid "Using L<virt-sparsify(1)>, make a disk image more sparse:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:235
+#, no-wrap
+msgid ""
+" virt-sparsify /path/to/olddisk.img newdisk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:237
+msgid ""
+"Is C<newdisk.img> still bootable after sparsifying? Is the resulting disk "
+"image smaller (use C<du> to check)?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:240
+msgid "B<*> \"sysprep\" a B<shut off> Linux guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:242
+msgid ""
+"Note that this really will mess up an existing guest, so it's better to "
+"clone the guest before trying this."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:245
+#, no-wrap
+msgid ""
+" virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:247
+msgid ""
+"Was the sysprep successful? After booting, what changes were made and were "
+"they successful?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:250
+msgid "Dump the Windows Registry from your Windows guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:252
+msgid ""
+"Use L<virt-win-reg(1)> to dump out the Windows Registry from any Windows "
+"guests that you have."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:255
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:258
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:261
+msgid "Does the output match running C<regedit> inside the guest?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:263
+msgid ""
+"A recent feature is the ability to dump user registries, so try this, "
+"replacing I<username> with the name of a local user in the guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:266
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' "
+"|\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:271
+msgid ""
+"L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, "
+"L<http://libguestfs.org/>."
+msgstr ""
+
#. type: =head2
#: ../fish/guestfish-actions.pod:1
msgid "add-cdrom"
@@ -20509,7 +21182,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3354 ../test-tool/libguestfs-test-tool.pod:112
+#: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3355 ../test-tool/libguestfs-test-tool.pod:112
msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
@@ -39091,11 +39764,6 @@ msgstr ""
msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
msgstr ""
-#. type: textblock
-#: ../src/guestfs.pod:2792
-msgid "or:"
-msgstr ""
-
#. type: verbatim
#: ../src/guestfs.pod:2794
#, no-wrap
@@ -39713,11 +40381,6 @@ msgstr ""
msgid "Push and pull from Transifex."
msgstr ""
-#. type: textblock
-#: ../src/guestfs.pod:3083
-msgid "Run:"
-msgstr ""
-
#. type: verbatim
#: ../src/guestfs.pod:3085
#, no-wrap
@@ -40005,65 +40668,65 @@ msgid ""
"L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, "
"L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>, "
"L<virt-sysprep(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, "
-"L<virt-win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>, "
+"L<virt-win-reg(1)>, L<guestfs-testing(1)>, L<qemu(1)>, L<febootstrap(1)>, "
"L<febootstrap-supermin-helper(8)>, L<hivex(3)>, L<stap(1)>, "
"L<http://libguestfs.org/>."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3308
+#: ../src/guestfs.pod:3309
msgid ""
"Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, "
"L<lvm(8)>, L<disktype(1)>."
msgstr ""
#. type: =head1
-#: ../src/guestfs.pod:3315 ../tools/virt-make-fs.pl:571 ../tools/virt-win-reg.pl:772
+#: ../src/guestfs.pod:3316 ../tools/virt-make-fs.pl:571 ../tools/virt-win-reg.pl:772
msgid "BUGS"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3317
+#: ../src/guestfs.pod:3318
msgid "To get a list of bugs against libguestfs use this link:"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3319
+#: ../src/guestfs.pod:3320
msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3321
+#: ../src/guestfs.pod:3322
msgid "To report a new bug against libguestfs use this link:"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3323
+#: ../src/guestfs.pod:3324
msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3325
+#: ../src/guestfs.pod:3326
msgid "When reporting a bug, please check:"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3331
+#: ../src/guestfs.pod:3332
msgid "That the bug hasn't been reported already."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3335
+#: ../src/guestfs.pod:3336
msgid "That you are testing a recent version."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3339
+#: ../src/guestfs.pod:3340
msgid "Describe the bug accurately, and give a way to reproduce it."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3343
+#: ../src/guestfs.pod:3344
msgid ""
"Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
"bug report."
diff --git a/po-docs/uk.po b/po-docs/uk.po
index 6b791d8..eca1bd0 100644
--- a/po-docs/uk.po
+++ b/po-docs/uk.po
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: libguestfs at redhat.com\n"
-"POT-Creation-Date: 2011-11-17 13:11+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:15+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Ukrainian <trans-uk at lists.fedoraproject.org>\n"
@@ -24,15 +24,16 @@ msgstr ""
#: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3
#: ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3
#: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3
-#: ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3
-#: ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3
-#: ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3
-#: ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3
-#: ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3
-#: ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3
-#: ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3
-#: ../ruby/examples/guestfs-ruby.pod:3 ../sparsify/virt-sparsify.pod:3
-#: ../src/guestfs.pod:3 ../test-tool/libguestfs-test-tool.pod:3
+#: ../examples/guestfs-recipes.pod:14 ../examples/guestfs-testing.pod:3
+#: ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3
+#: ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3
+#: ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3
+#: ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3
+#: ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3
+#: ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3
+#: ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3
+#: ../sparsify/virt-sparsify.pod:3 ../src/guestfs.pod:3
+#: ../test-tool/libguestfs-test-tool.pod:3
#: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
#: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31
#: ../tools/virt-win-reg.pl:35
@@ -86,11 +87,12 @@ msgstr ""
#: ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27
#: ../erlang/examples/guestfs-erlang.pod:16
#: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
-#: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19
-#: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21
-#: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20
-#: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15
-#: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18
+#: ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30
+#: ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13
+#: ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15
+#: ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19
+#: ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25
+#: ../perl/examples/guestfs-perl.pod:18
#: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31
#: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
#: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23
@@ -973,8 +975,8 @@ msgstr ""
#: ../src/guestfs.pod:2656 ../src/guestfs.pod:2662 ../src/guestfs.pod:3062
#: ../src/guestfs.pod:3067 ../src/guestfs.pod:3071 ../src/guestfs.pod:3075
#: ../src/guestfs.pod:3079 ../src/guestfs.pod:3093 ../src/guestfs.pod:3098
-#: ../src/guestfs.pod:3329 ../src/guestfs.pod:3333 ../src/guestfs.pod:3337
-#: ../src/guestfs.pod:3341 ../tools/virt-win-reg.pl:197
+#: ../src/guestfs.pod:3330 ../src/guestfs.pod:3334 ../src/guestfs.pod:3338
+#: ../src/guestfs.pod:3342 ../tools/virt-win-reg.pl:197
#: ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208
#: ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727
#: ../tools/virt-win-reg.pl:733
@@ -1032,11 +1034,12 @@ msgstr ""
#: ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:227
#: ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97
#: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
-#: ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50
-#: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
-#: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:317
-#: ../inspector/virt-inspector.pod:395 ../java/examples/guestfs-java.pod:45
-#: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
+#: ../examples/guestfs-testing.pod:269 ../fish/guestfish.pod:1268
+#: ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39
+#: ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41
+#: ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:395
+#: ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78
+#: ../perl/examples/guestfs-perl.pod:39
#: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:325
#: ../resize/virt-resize.pod:688 ../ruby/examples/guestfs-ruby.pod:36
#: ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3270
@@ -1084,14 +1087,15 @@ msgstr "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
#: ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:239
#: ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114
#: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401
-#: ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64
-#: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62
-#: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:332
-#: ../inspector/virt-inspector.pod:418 ../java/examples/guestfs-java.pod:62
-#: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56
+#: ../examples/guestfs-testing.pod:280 ../fish/guestfish.pod:1300
+#: ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53
+#: ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55
+#: ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:418
+#: ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95
+#: ../perl/examples/guestfs-perl.pod:56
#: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:338
#: ../resize/virt-resize.pod:715 ../ruby/examples/guestfs-ruby.pod:52
-#: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3352
+#: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3353
#: ../test-tool/libguestfs-test-tool.pod:110
#: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
#: ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:315
@@ -2391,7 +2395,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:41
+#: ../cat/virt-ls.pod:41 ../examples/guestfs-testing.pod:160
msgid "List all setuid or setgid programs in a Linux virtual machine:"
msgstr ""
@@ -2404,7 +2408,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:45
+#: ../cat/virt-ls.pod:45 ../examples/guestfs-testing.pod:164
msgid "List all public-writable directories in a Linux virtual machine:"
msgstr ""
@@ -2417,7 +2421,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:49
+#: ../cat/virt-ls.pod:49 ../examples/guestfs-testing.pod:168
msgid "List all Unix domain sockets in a Linux virtual machine:"
msgstr ""
@@ -2430,7 +2434,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:53
+#: ../cat/virt-ls.pod:53 ../examples/guestfs-testing.pod:172
msgid "List all regular files with filenames ending in '.png':"
msgstr ""
@@ -2456,7 +2460,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:61
+#: ../cat/virt-ls.pod:61 ../examples/guestfs-testing.pod:180
msgid "Find everything modified in the last 7 days:"
msgstr ""
@@ -2469,7 +2473,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../cat/virt-ls.pod:65
+#: ../cat/virt-ls.pod:65 ../examples/guestfs-testing.pod:184
msgid "Find regular files modified in the last 24 hours:"
msgstr ""
@@ -4890,13 +4894,14 @@ msgstr ""
#. type: =head1
#: ../erlang/examples/guestfs-erlang.pod:110
#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397
-#: ../fish/guestfish.pod:1296 ../fish/virt-copy-in.pod:60
-#: ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58
-#: ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328
-#: ../inspector/virt-inspector.pod:404 ../java/examples/guestfs-java.pod:58
-#: ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52
+#: ../examples/guestfs-testing.pod:276 ../fish/guestfish.pod:1296
+#: ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49
+#: ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51
+#: ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:404
+#: ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91
+#: ../perl/examples/guestfs-perl.pod:52
#: ../python/examples/guestfs-python.pod:54
-#: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3348
+#: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3349
#: ../test-tool/libguestfs-test-tool.pod:106
msgid "AUTHORS"
msgstr "АВТОРИ"
@@ -4904,20 +4909,21 @@ msgstr "АВТОРИ"
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:112
#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399
-#: ../fish/guestfish.pod:1298 ../fish/virt-copy-in.pod:62
-#: ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60
-#: ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330
-#: ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93
-#: ../perl/examples/guestfs-perl.pod:54
+#: ../examples/guestfs-testing.pod:278 ../fish/guestfish.pod:1298
+#: ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51
+#: ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53
+#: ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60
+#: ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54
#: ../python/examples/guestfs-python.pod:56
-#: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3350
+#: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3351
#: ../test-tool/libguestfs-test-tool.pod:108
msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
msgstr "Richard W.M. Jones (C<rjones at redhat dot com>)"
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:116
-#: ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58
+#: ../examples/guestfs-testing.pod:282 ../java/examples/guestfs-java.pod:64
+#: ../perl/examples/guestfs-perl.pod:58
msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
@@ -4936,11 +4942,11 @@ msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:121
#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408
-#: ../java/examples/guestfs-java.pod:69
+#: ../examples/guestfs-testing.pod:284 ../java/examples/guestfs-java.pod:69
#: ../ocaml/examples/guestfs-ocaml.pod:102
#: ../perl/examples/guestfs-perl.pod:63
#: ../python/examples/guestfs-python.pod:65
-#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3357
+#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3358
msgid ""
"This library is free software; you can redistribute it and/or modify it "
"under the terms of the GNU Lesser General Public License as published by the "
@@ -4951,11 +4957,11 @@ msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:126
#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413
-#: ../java/examples/guestfs-java.pod:74
+#: ../examples/guestfs-testing.pod:289 ../java/examples/guestfs-java.pod:74
#: ../ocaml/examples/guestfs-ocaml.pod:107
#: ../perl/examples/guestfs-perl.pod:68
#: ../python/examples/guestfs-python.pod:70
-#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3362
+#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3363
msgid ""
"This library is distributed in the hope that it will be useful, but WITHOUT "
"ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
@@ -4966,11 +4972,11 @@ msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:131
#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418
-#: ../java/examples/guestfs-java.pod:79
+#: ../examples/guestfs-testing.pod:294 ../java/examples/guestfs-java.pod:79
#: ../ocaml/examples/guestfs-ocaml.pod:112
#: ../perl/examples/guestfs-perl.pod:73
#: ../python/examples/guestfs-python.pod:75
-#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3367
+#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3368
msgid ""
"You should have received a copy of the GNU Lesser General Public License "
"along with this library; if not, write to the Free Software Foundation, "
@@ -5316,7 +5322,7 @@ msgid ""
msgstr ""
#. type: verbatim
-#: ../examples/guestfs-recipes.pod:126
+#: ../examples/guestfs-recipes.pod:126 ../examples/guestfs-testing.pod:93
#, no-wrap
msgid ""
" virt-copy-out -d Guest /home .\n"
@@ -5882,6 +5888,769 @@ msgstr ""
msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
+#. type: textblock
+#: ../examples/guestfs-testing.pod:5
+msgid "guestfs-testing - manual testing of libguestfs, you can help!"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:9
+msgid ""
+"This page has manual tests you can try on libguestfs. Everyone has a "
+"slightly different combination of platform, hardware and guests, so this "
+"testing is very valuable. Thanks for helping out!"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:13
+msgid "These tests require libguestfs E<ge> 1.14."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:15
+msgid ""
+"Tests marked with a B<*> (asterisk) can B<destroy data> if you're not "
+"careful. The others are safe and won't modify anything."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:18
+msgid "You can report bugs you find through this link:"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:20
+#, fuzzy
+#| msgid ""
+#| "L<https://bugzilla.redhat.com/enter_bug.cgi?"
+#| "component=libguestfs&product=Virtualization+Tools>"
+msgid ""
+"https://bugzilla.redhat.com/enter_bug.cgi?"
+"component=libguestfs&product=Virtualization+Tools"
+msgstr ""
+"L<https://bugzilla.redhat.com/enter_bug.cgi?"
+"component=libguestfs&product=Virtualization+Tools>"
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:22
+msgid ""
+"or post on the mailing list (registration is B<not> required, but if you're "
+"not registered then you'll have to wait for a moderator to manually approve "
+"your message):"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:26
+msgid "https://www.redhat.com/mailman/listinfo/libguestfs"
+msgstr ""
+
+#. type: =head1
+#: ../examples/guestfs-testing.pod:28
+msgid "TESTS"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:30
+msgid "Check KVM acceleration is being used."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:32
+msgid ""
+"If your host has hardware virt acceleration, then with a hot cache "
+"libguestfs should be able to start up in a few seconds. Run the following "
+"command a few times:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:36
+#, no-wrap
+msgid ""
+" time guestfish -a /dev/null run\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:38
+msgid ""
+"After a few runs, the time should settle down to a few seconds (under 5 "
+"seconds on fast 64 bit hardware)."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:41
+msgid "How to check for hardware virt:"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:43
+msgid "http://virt-tools.org/learning/check-hardware-virt/"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:45
+msgid ""
+"If the command above does not work at all, use L<libguestfs-test-tool(1)>."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:48
+msgid "Run virt-alignment-scan on all your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:50
+msgid "Run L<virt-alignment-scan(1)> on guests or disk images:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:52
+#, no-wrap
+msgid ""
+" virt-alignment-scan -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:139
+#: ../examples/guestfs-testing.pod:152 ../examples/guestfs-testing.pod:212
+#: ../src/guestfs.pod:2792
+msgid "or:"
+msgstr "або:"
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:56
+#, no-wrap
+msgid ""
+" virt-alignment-scan -d Guest\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:58
+msgid "Does the alignment report match how the guest partitions are aligned?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:60
+#, fuzzy
+#| msgid ""
+#| " virt-cat domname file\n"
+#| "\n"
+msgid "Run virt-cat on some files in guests."
+msgstr ""
+" virt-cat назва_домену файл\n"
+"\n"
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:62
+msgid "L<virt-cat(1)> can display files from guests. For a Linux guest, try:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:64
+#, fuzzy, no-wrap
+#| msgid ""
+#| " virt-cat -d mydomain /etc/fstab\n"
+#| "\n"
+msgid ""
+" virt-cat LinuxGuest /etc/passwd\n"
+"\n"
+msgstr ""
+" virt-cat -d mydomain /etc/fstab\n"
+"\n"
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:66
+msgid "A recent feature is support for Windows paths, for example:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:68
+#, no-wrap
+msgid ""
+" virt-cat WindowsGuest 'c:\\windows\\win.ini'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:70
+msgid ""
+"An even better test is if you have a Windows guest with multiple drives. Do "
+"C<D:>, C<E:> etc paths work correctly?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:73
+msgid "B<*> Copy some files into a B<shut off> guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:75
+msgid ""
+"L<virt-copy-in(1)> can recursively copy files and directories into a guest "
+"or disk image."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:78
+#, no-wrap
+msgid ""
+" virt-copy-in -d Guest /etc /tmp\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:80
+msgid ""
+"This should copy local directory C</etc> to C</tmp/etc> in the guest "
+"(recursively). If you boot the guest, can you see all of the copied files "
+"and directories?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:84
+msgid "Shut the guest down and try copying multiple files and directories:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:86
+#, no-wrap
+msgid ""
+" virt-copy-in -d Guest /home /etc/issue /tmp\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:88
+msgid "Copy some files out of a guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:90
+msgid ""
+"L<virt-copy-out(1)> can recursively copy files and directories out of a "
+"guest or disk image."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:95
+msgid "Note the final space and period in the command is not a typo."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:97
+msgid "This should copy C</home> from the guest into the current directory."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:99
+msgid "Run virt-df."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:101
+msgid "L<virt-df(1)> lists disk space. Run:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:103
+#, fuzzy, no-wrap
+#| msgid ""
+#| " df\n"
+#| "\n"
+msgid ""
+" virt-df\n"
+"\n"
+msgstr ""
+" df\n"
+"\n"
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:105
+msgid "Do the results match what's reported inside the guests?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:107
+msgid "Try importing virt-df CSV output into a spreadsheet or database."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:109 ../src/guestfs.pod:3083
+msgid "Run:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:111
+#, no-wrap
+msgid ""
+" virt-df --csv > /tmp/report.csv\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:113
+msgid ""
+"Now try to load this into your favorite spreadsheet or database. Are the "
+"results reproduced faithfully in the spreadsheet/database?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:116
+msgid ""
+"http://www.postgresql.org/docs/8.1/static/sql-copy.html http://dev.mysql.com/"
+"doc/refman/5.1/en/load-data.html"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:119
+msgid "B<*> Edit a file in a B<shut off> guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:121
+msgid ""
+"L<virt-edit(1)> can edit files in guests. Try this command on a RHEL or "
+"Fedora guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:124
+#, no-wrap
+msgid ""
+" virt-edit LinuxGuest /etc/sysconfig/network\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:126
+msgid "On other Linux guests try editing other files such as:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:128
+#, no-wrap
+msgid ""
+" virt-edit LinuxGuest /etc/motd\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:130
+msgid "Are the changes seen inside the guest when it is booted?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:132
+msgid "Display the filesystems / partitions / LVs in a guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:134
+msgid ""
+"L<virt-filesystems(1)> can be used to display filesystems in a guest. Try "
+"this command on any disk image or guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:137
+#, fuzzy, no-wrap
+#| msgid ""
+#| " virt-filesystems --format=raw -a disk.img\n"
+#| "\n"
+msgid ""
+" virt-filesystems -a /path/to/disk.img --all --long -h\n"
+"\n"
+msgstr ""
+" virt-filesystems --format=raw -a диск.img\n"
+"\n"
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:141
+#, fuzzy, no-wrap
+#| msgid ""
+#| " virt-filesystems [--options] -d domname\n"
+#| "\n"
+msgid ""
+" virt-filesystems -d Guest --all --long -h\n"
+"\n"
+msgstr ""
+" virt-filesystems [--параметри] -d назва_домену\n"
+"\n"
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:143
+msgid "Do the results match what is seen in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:145
+msgid "Run virt-inspector on all your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:147
+msgid ""
+"Use L<virt-inspector(1)> to get a report on all of your guests or disk "
+"images:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:150
+#, fuzzy, no-wrap
+#| msgid ""
+#| " virt-cat disk.img file\n"
+#| "\n"
+msgid ""
+" virt-inspector -a /path/to/disk.img | less\n"
+"\n"
+msgstr ""
+" virt-cat диск.img файл\n"
+"\n"
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:154
+#, no-wrap
+msgid ""
+" virt-inspector -d Guest | less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:156
+msgid "Do the results match what is actually in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:158
+msgid "Try the auditing features of virt-ls on all your guests."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:162
+#, fuzzy, no-wrap
+#| msgid ""
+#| " $ virt-ls -R -d guest /tmp\n"
+#| " foo\n"
+#| " foo/bar\n"
+#| " [etc.]\n"
+#| "\n"
+msgid ""
+" virt-ls -lR -d Guest / | grep '^- [42]'\n"
+"\n"
+msgstr ""
+" $ virt-ls -R -d guest /tmp\n"
+" foo\n"
+" foo/bar\n"
+" [тощо]\n"
+"\n"
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:166
+#, fuzzy, no-wrap
+#| msgid ""
+#| " $ virt-ls -R -d guest /tmp\n"
+#| " foo\n"
+#| " foo/bar\n"
+#| " [etc.]\n"
+#| "\n"
+msgid ""
+" virt-ls -lR -d Guest / | grep '^d ...7'\n"
+"\n"
+msgstr ""
+" $ virt-ls -R -d guest /tmp\n"
+" foo\n"
+" foo/bar\n"
+" [тощо]\n"
+"\n"
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:170
+#, fuzzy, no-wrap
+#| msgid ""
+#| " $ virt-ls -R -d guest /tmp\n"
+#| " foo\n"
+#| " foo/bar\n"
+#| " [etc.]\n"
+#| "\n"
+msgid ""
+" virt-ls -lR -d Guest / | grep '^s'\n"
+"\n"
+msgstr ""
+" $ virt-ls -R -d guest /tmp\n"
+" foo\n"
+" foo/bar\n"
+" [тощо]\n"
+"\n"
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:174
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:176
+msgid "Display files larger than 10MB in home directories:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:178
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:182
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:186
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:188
+msgid "Do the results match what is in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:190
+msgid "Create a disk image from a tarball."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:192
+msgid ""
+"Use L<virt-make-fs(1)> to create a disk image from any tarball that you "
+"happen to have:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:195
+#, no-wrap
+msgid ""
+" virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:197
+msgid ""
+"Add 'output.img' as a raw disk to an existing guest. Check the guest can "
+"see the files. This test is particularly useful if you try it with a "
+"Windows guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:201
+msgid "Try other partitioning schemes, eg. I<--partition=gpt>."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:203
+msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:205
+msgid "B<*> Run virt-rescue on a B<shut off> disk image or guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:207
+msgid ""
+"Use L<virt-rescue(1)> to examine, rescue or repair a B<shut off> guest or "
+"disk image:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:210
+#, fuzzy, no-wrap
+#| msgid ""
+#| " virt-cat disk.img file\n"
+#| "\n"
+msgid ""
+" virt-rescue -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+" virt-cat диск.img файл\n"
+"\n"
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:214
+#, no-wrap
+msgid ""
+" virt-rescue -d Guest\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:216
+msgid "Can you use ordinary shell commands to examine the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:218
+msgid "B<*> Resize your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:220
+msgid ""
+"Use L<virt-resize(1)> to give a guest some more disk space. For example, if "
+"you have a disk image that is smaller than 30G, increase it to 30G by doing:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:224
+#, no-wrap
+msgid ""
+" truncate -s 30G newdisk.img\n"
+" virt-filesystems -a /path/to/olddisk.img --all --long -h\n"
+" virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1\n"
+" qemu-kvm -m 1024 -hda newdisk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:229
+msgid "Does the guest still boot? Try expanding other partitions."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:231
+msgid "B<*> Sparsify a guest disk."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:233
+msgid "Using L<virt-sparsify(1)>, make a disk image more sparse:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:235
+#, fuzzy, no-wrap
+#| msgid ""
+#| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
+#| "\n"
+msgid ""
+" virt-sparsify /path/to/olddisk.img newdisk.img\n"
+"\n"
+msgstr ""
+" virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
+"\n"
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:237
+msgid ""
+"Is C<newdisk.img> still bootable after sparsifying? Is the resulting disk "
+"image smaller (use C<du> to check)?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:240
+msgid "B<*> \"sysprep\" a B<shut off> Linux guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:242
+msgid ""
+"Note that this really will mess up an existing guest, so it's better to "
+"clone the guest before trying this."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:245
+#, no-wrap
+msgid ""
+" virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:247
+msgid ""
+"Was the sysprep successful? After booting, what changes were made and were "
+"they successful?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:250
+msgid "Dump the Windows Registry from your Windows guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:252
+msgid ""
+"Use L<virt-win-reg(1)> to dump out the Windows Registry from any Windows "
+"guests that you have."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:255
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:258
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:261
+msgid "Does the output match running C<regedit> inside the guest?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:263
+msgid ""
+"A recent feature is the ability to dump user registries, so try this, "
+"replacing I<username> with the name of a local user in the guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:266
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:271
+#, fuzzy
+#| msgid ""
+#| "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, "
+#| "L<virt-tar-out(1)>, L<http://libguestfs.org/>."
+msgid ""
+"L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<http://libguestfs."
+"org/>."
+msgstr ""
+"L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
+"tar-out(1)>, L<http://libguestfs.org/>."
+
#. type: =head2
#: ../fish/guestfish-actions.pod:1
msgid "add-cdrom"
@@ -21836,7 +22605,7 @@ msgid ""
msgstr ""
#. type: textblock
-#: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3354
+#: ../fish/guestfish.pod:1302 ../src/guestfs.pod:3355
#: ../test-tool/libguestfs-test-tool.pod:112
msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
@@ -41494,11 +42263,6 @@ msgstr ""
msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
msgstr ""
-#. type: textblock
-#: ../src/guestfs.pod:2792
-msgid "or:"
-msgstr "або:"
-
#. type: verbatim
#: ../src/guestfs.pod:2794
#, no-wrap
@@ -42121,11 +42885,6 @@ msgstr ""
msgid "Push and pull from Transifex."
msgstr ""
-#. type: textblock
-#: ../src/guestfs.pod:3083
-msgid "Run:"
-msgstr ""
-
#. type: verbatim
#: ../src/guestfs.pod:3085
#, no-wrap
@@ -42411,33 +43170,33 @@ msgid ""
"L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, "
"L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue"
"(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>, L<virt-sysprep(1)>, L<virt-tar"
-"(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)>, "
-"L<febootstrap(1)>, L<febootstrap-supermin-helper(8)>, L<hivex(3)>, L<stap(1)"
-">, L<http://libguestfs.org/>."
+"(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<guestfs-"
+"testing(1)>, L<qemu(1)>, L<febootstrap(1)>, L<febootstrap-supermin-helper(8)"
+">, L<hivex(3)>, L<stap(1)>, L<http://libguestfs.org/>."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3308
+#: ../src/guestfs.pod:3309
msgid ""
"Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
"(8)>, L<disktype(1)>."
msgstr ""
#. type: =head1
-#: ../src/guestfs.pod:3315 ../tools/virt-make-fs.pl:571
+#: ../src/guestfs.pod:3316 ../tools/virt-make-fs.pl:571
#: ../tools/virt-win-reg.pl:772
msgid "BUGS"
msgstr "ВАДИ"
#. type: textblock
-#: ../src/guestfs.pod:3317
+#: ../src/guestfs.pod:3318
msgid "To get a list of bugs against libguestfs use this link:"
msgstr ""
"Щоб переглянути список відомих вад у libguestfs, скористайтеся таким "
"посиланням:"
#. type: textblock
-#: ../src/guestfs.pod:3319
+#: ../src/guestfs.pod:3320
msgid ""
"L<https://bugzilla.redhat.com/buglist.cgi?"
"component=libguestfs&product=Virtualization+Tools>"
@@ -42446,12 +43205,12 @@ msgstr ""
"component=libguestfs&product=Virtualization+Tools>"
#. type: textblock
-#: ../src/guestfs.pod:3321
+#: ../src/guestfs.pod:3322
msgid "To report a new bug against libguestfs use this link:"
msgstr "Для звітування щодо вад у libguestfs скористайтеся цим посиланням:"
#. type: textblock
-#: ../src/guestfs.pod:3323
+#: ../src/guestfs.pod:3324
msgid ""
"L<https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools>"
@@ -42460,27 +43219,27 @@ msgstr ""
"component=libguestfs&product=Virtualization+Tools>"
#. type: textblock
-#: ../src/guestfs.pod:3325
+#: ../src/guestfs.pod:3326
msgid "When reporting a bug, please check:"
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3331
+#: ../src/guestfs.pod:3332
msgid "That the bug hasn't been reported already."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3335
+#: ../src/guestfs.pod:3336
msgid "That you are testing a recent version."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3339
+#: ../src/guestfs.pod:3340
msgid "Describe the bug accurately, and give a way to reproduce it."
msgstr ""
#. type: textblock
-#: ../src/guestfs.pod:3343
+#: ../src/guestfs.pod:3344
msgid ""
"Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
"bug report."
diff --git a/po-docs/uk/guestfish.1 b/po-docs/uk/guestfish.1
index f086d09..d466e9f 100644
--- a/po-docs/uk/guestfish.1
+++ b/po-docs/uk/guestfish.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "guestfish 1"
-.TH guestfish 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH guestfish 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/guestfs-testing.pod b/po-docs/uk/guestfs-testing.pod
new file mode 100644
index 0000000..3014447
--- /dev/null
+++ b/po-docs/uk/guestfs-testing.pod
@@ -0,0 +1,293 @@
+=encoding utf8
+
+=head1 НАЗВА
+
+guestfs-testing - manual testing of libguestfs, you can help!
+
+=head1 ОПИС
+
+This page has manual tests you can try on libguestfs. Everyone has a
+slightly different combination of platform, hardware and guests, so this
+testing is very valuable. Thanks for helping out!
+
+These tests require libguestfs E<ge> 1.14.
+
+Tests marked with a B<*> (asterisk) can B<destroy data> if you're not
+careful. The others are safe and won't modify anything.
+
+You can report bugs you find through this link:
+
+https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
+
+or post on the mailing list (registration is B<not> required, but if you're
+not registered then you'll have to wait for a moderator to manually approve
+your message):
+
+https://www.redhat.com/mailman/listinfo/libguestfs
+
+=head1 TESTS
+
+=head2 Check KVM acceleration is being used.
+
+If your host has hardware virt acceleration, then with a hot cache
+libguestfs should be able to start up in a few seconds. Run the following
+command a few times:
+
+ time guestfish -a /dev/null run
+
+After a few runs, the time should settle down to a few seconds (under 5
+seconds on fast 64 bit hardware).
+
+How to check for hardware virt:
+
+http://virt-tools.org/learning/check-hardware-virt/
+
+If the command above does not work at all, use L<libguestfs-test-tool(1)>.
+
+=head2 Run virt-alignment-scan on all your guests.
+
+Run L<virt-alignment-scan(1)> on guests or disk images:
+
+ virt-alignment-scan -a /path/to/disk.img
+
+або:
+
+ virt-alignment-scan -d Guest
+
+Does the alignment report match how the guest partitions are aligned?
+
+=head2 Run virt-cat on some files in guests.
+
+L<virt-cat(1)> can display files from guests. For a Linux guest, try:
+
+ virt-cat LinuxGuest /etc/passwd
+
+A recent feature is support for Windows paths, for example:
+
+ virt-cat WindowsGuest 'c:\windows\win.ini'
+
+An even better test is if you have a Windows guest with multiple drives. Do
+C<D:>, C<E:> etc paths work correctly?
+
+=head2 B<*> Copy some files into a B<shut off> guest.
+
+L<virt-copy-in(1)> can recursively copy files and directories into a guest
+or disk image.
+
+ virt-copy-in -d Guest /etc /tmp
+
+This should copy local directory C</etc> to C</tmp/etc> in the guest
+(recursively). If you boot the guest, can you see all of the copied files
+and directories?
+
+Shut the guest down and try copying multiple files and directories:
+
+ virt-copy-in -d Guest /home /etc/issue /tmp
+
+=head2 Copy some files out of a guest.
+
+L<virt-copy-out(1)> can recursively copy files and directories out of a
+guest or disk image.
+
+ virt-copy-out -d Guest /home .
+
+Note the final space and period in the command is not a typo.
+
+This should copy C</home> from the guest into the current directory.
+
+=head2 Run virt-df.
+
+L<virt-df(1)> lists disk space. Run:
+
+ virt-df
+
+Do the results match what's reported inside the guests?
+
+=head2 Try importing virt-df CSV output into a spreadsheet or database.
+
+Run:
+
+ virt-df --csv > /tmp/report.csv
+
+Now try to load this into your favorite spreadsheet or database. Are the
+results reproduced faithfully in the spreadsheet/database?
+
+http://www.postgresql.org/docs/8.1/static/sql-copy.html
+http://dev.mysql.com/doc/refman/5.1/en/load-data.html
+
+=head2 B<*> Edit a file in a B<shut off> guest.
+
+L<virt-edit(1)> can edit files in guests. Try this command on a RHEL or
+Fedora guest:
+
+ virt-edit LinuxGuest /etc/sysconfig/network
+
+On other Linux guests try editing other files such as:
+
+ virt-edit LinuxGuest /etc/motd
+
+Are the changes seen inside the guest when it is booted?
+
+=head2 Display the filesystems / partitions / LVs in a guest.
+
+L<virt-filesystems(1)> can be used to display filesystems in a guest. Try
+this command on any disk image or guest:
+
+ virt-filesystems -a /path/to/disk.img --all --long -h
+
+або:
+
+ virt-filesystems -d Guest --all --long -h
+
+Do the results match what is seen in the guest?
+
+=head2 Run virt-inspector on all your guests.
+
+Use L<virt-inspector(1)> to get a report on all of your guests or disk
+images:
+
+ virt-inspector -a /path/to/disk.img | less
+
+або:
+
+ virt-inspector -d Guest | less
+
+Do the results match what is actually in the guest?
+
+=head2 Try the auditing features of virt-ls on all your guests.
+
+List all setuid or setgid programs in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^- [42]'
+
+List all public-writable directories in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^d ...7'
+
+List all Unix domain sockets in a Linux virtual machine:
+
+ virt-ls -lR -d Guest / | grep '^s'
+
+List all regular files with filenames ending in '.png':
+
+ virt-ls -lR -d Guest / | grep -i '^-.*\.png$'
+
+Display files larger than 10MB in home directories:
+
+ virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'
+
+Find everything modified in the last 7 days:
+
+ virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'
+
+Find regular files modified in the last 24 hours:
+
+ virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'
+
+Do the results match what is in the guest?
+
+=head2 Create a disk image from a tarball.
+
+Use L<virt-make-fs(1)> to create a disk image from any tarball that you
+happen to have:
+
+ virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img
+
+Add 'output.img' as a raw disk to an existing guest. Check the guest can
+see the files. This test is particularly useful if you try it with a
+Windows guest.
+
+Try other partitioning schemes, eg. I<--partition=gpt>.
+
+Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>.
+
+=head2 B<*> Run virt-rescue on a B<shut off> disk image or guest.
+
+Use L<virt-rescue(1)> to examine, rescue or repair a B<shut off> guest or
+disk image:
+
+ virt-rescue -a /path/to/disk.img
+
+або:
+
+ virt-rescue -d Guest
+
+Can you use ordinary shell commands to examine the guest?
+
+=head2 B<*> Resize your guests.
+
+Use L<virt-resize(1)> to give a guest some more disk space. For example, if
+you have a disk image that is smaller than 30G, increase it to 30G by doing:
+
+ truncate -s 30G newdisk.img
+ virt-filesystems -a /path/to/olddisk.img --all --long -h
+ virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1
+ qemu-kvm -m 1024 -hda newdisk.img
+
+Does the guest still boot? Try expanding other partitions.
+
+=head2 B<*> Sparsify a guest disk.
+
+Using L<virt-sparsify(1)>, make a disk image more sparse:
+
+ virt-sparsify /path/to/olddisk.img newdisk.img
+
+Is C<newdisk.img> still bootable after sparsifying? Is the resulting disk
+image smaller (use C<du> to check)?
+
+=head2 B<*> "sysprep" a B<shut off> Linux guest.
+
+Note that this really will mess up an existing guest, so it's better to
+clone the guest before trying this.
+
+ virt-sysprep --hostname newhost.example.com -a /path/to/disk.img
+
+Was the sysprep successful? After booting, what changes were made and were
+they successful?
+
+=head2 Dump the Windows Registry from your Windows guests.
+
+Use L<virt-win-reg(1)> to dump out the Windows Registry from any Windows
+guests that you have.
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\Software' |
+ less
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\System' |
+ less
+
+Does the output match running C<regedit> inside the guest?
+
+A recent feature is the ability to dump user registries, so try this,
+replacing I<username> with the name of a local user in the guest:
+
+ virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\username' |
+ less
+
+=head1 ТАКОЖ ПЕРЕГЛЯНЬТЕ
+
+L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>,
+L<http://libguestfs.org/>.
+
+=head1 АВТОРИ
+
+Richard W.M. Jones (C<rjones at redhat dot com>)
+
+=head1 АВТОРСЬКІ ПРАВА
+
+Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>
+
+This library is free software; you can redistribute it and/or modify it
+under the terms of the GNU Lesser General Public License as published by the
+Free Software Foundation; either version 2 of the License, or (at your
+option) any later version.
+
+This library is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with this library; if not, write to the Free Software Foundation,
+Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
diff --git a/po-docs/uk/guestfs.3 b/po-docs/uk/guestfs.3
index c5fc356..bbd0dba 100644
--- a/po-docs/uk/guestfs.3
+++ b/po-docs/uk/guestfs.3
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "guestfs 3"
-.TH guestfs 3 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH guestfs 3 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -12084,7 +12084,7 @@ use in case \f(CW\*(C`/var/tmp\*(C'\fR is not large enough.
\&\fIvirt\-list\-partitions\fR\|(1), \fIvirt\-ls\fR\|(1), \fIvirt\-make\-fs\fR\|(1),
\&\fIvirt\-rescue\fR\|(1), \fIvirt\-resize\fR\|(1), \fIvirt\-sparsify\fR\|(1),
\&\fIvirt\-sysprep\fR\|(1), \fIvirt\-tar\fR\|(1), \fIvirt\-tar\-in\fR\|(1), \fIvirt\-tar\-out\fR\|(1),
-\&\fIvirt\-win\-reg\fR\|(1), \fIqemu\fR\|(1), \fIfebootstrap\fR\|(1),
+\&\fIvirt\-win\-reg\fR\|(1), \fIguestfs\-testing\fR\|(1), \fIqemu\fR\|(1), \fIfebootstrap\fR\|(1),
\&\fIfebootstrap\-supermin\-helper\fR\|(8), \fIhivex\fR\|(3), \fIstap\fR\|(1),
<http://libguestfs.org/>.
.PP
diff --git a/po-docs/uk/guestfs.pod b/po-docs/uk/guestfs.pod
index 2b90947..72687b5 100644
--- a/po-docs/uk/guestfs.pod
+++ b/po-docs/uk/guestfs.pod
@@ -3166,7 +3166,7 @@ L<virt-inspector(1)>, L<virt-list-filesystems(1)>,
L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>,
L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-sparsify(1)>,
L<virt-sysprep(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>,
-L<virt-win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>,
+L<virt-win-reg(1)>, L<guestfs-testing(1)>, L<qemu(1)>, L<febootstrap(1)>,
L<febootstrap-supermin-helper(8)>, L<hivex(3)>, L<stap(1)>,
L<http://libguestfs.org/>.
diff --git a/po-docs/uk/guestmount.1 b/po-docs/uk/guestmount.1
index 5f693db..3569d60 100644
--- a/po-docs/uk/guestmount.1
+++ b/po-docs/uk/guestmount.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "guestmount 1"
-.TH guestmount 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH guestmount 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/libguestfs-test-tool.1 b/po-docs/uk/libguestfs-test-tool.1
index d5ba625..e437a5b 100644
--- a/po-docs/uk/libguestfs-test-tool.1
+++ b/po-docs/uk/libguestfs-test-tool.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "libguestfs-test-tool 1"
-.TH libguestfs-test-tool 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH libguestfs-test-tool 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-alignment-scan.1 b/po-docs/uk/virt-alignment-scan.1
index 81dbb27..45ff6a0 100644
--- a/po-docs/uk/virt-alignment-scan.1
+++ b/po-docs/uk/virt-alignment-scan.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-alignment-scan 1"
-.TH virt-alignment-scan 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-alignment-scan 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-cat.1 b/po-docs/uk/virt-cat.1
index c985a6c..2bf62d8 100644
--- a/po-docs/uk/virt-cat.1
+++ b/po-docs/uk/virt-cat.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-cat 1"
-.TH virt-cat 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-cat 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-copy-in.1 b/po-docs/uk/virt-copy-in.1
index 2c85e2b..b3a39d6 100644
--- a/po-docs/uk/virt-copy-in.1
+++ b/po-docs/uk/virt-copy-in.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-copy-in 1"
-.TH virt-copy-in 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-copy-in 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-copy-out.1 b/po-docs/uk/virt-copy-out.1
index ceeed17..da77196 100644
--- a/po-docs/uk/virt-copy-out.1
+++ b/po-docs/uk/virt-copy-out.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-copy-out 1"
-.TH virt-copy-out 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-copy-out 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-df.1 b/po-docs/uk/virt-df.1
index 60b663d..caddad2 100644
--- a/po-docs/uk/virt-df.1
+++ b/po-docs/uk/virt-df.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-df 1"
-.TH virt-df 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-df 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-edit.1 b/po-docs/uk/virt-edit.1
index 3021713..2cdfd8a 100644
--- a/po-docs/uk/virt-edit.1
+++ b/po-docs/uk/virt-edit.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-edit 1"
-.TH virt-edit 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-edit 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-filesystems.1 b/po-docs/uk/virt-filesystems.1
index 1c364d6..7c077c0 100644
--- a/po-docs/uk/virt-filesystems.1
+++ b/po-docs/uk/virt-filesystems.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-filesystems 1"
-.TH virt-filesystems 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-filesystems 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-inspector.1 b/po-docs/uk/virt-inspector.1
index bc5c057..9f20ff5 100644
--- a/po-docs/uk/virt-inspector.1
+++ b/po-docs/uk/virt-inspector.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-inspector 1"
-.TH virt-inspector 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-inspector 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-list-filesystems.1 b/po-docs/uk/virt-list-filesystems.1
index 5c0425f..a2b8624 100644
--- a/po-docs/uk/virt-list-filesystems.1
+++ b/po-docs/uk/virt-list-filesystems.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-list-filesystems.pl 1"
-.TH virt-list-filesystems.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-list-filesystems.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-list-partitions.1 b/po-docs/uk/virt-list-partitions.1
index 3d3a0eb..1e4ad78 100644
--- a/po-docs/uk/virt-list-partitions.1
+++ b/po-docs/uk/virt-list-partitions.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-list-partitions.pl 1"
-.TH virt-list-partitions.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-list-partitions.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-ls.1 b/po-docs/uk/virt-ls.1
index 9eef2fe..e23f319 100644
--- a/po-docs/uk/virt-ls.1
+++ b/po-docs/uk/virt-ls.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-ls 1"
-.TH virt-ls 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-ls 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-make-fs.1 b/po-docs/uk/virt-make-fs.1
index 5c342cc..23478dd 100644
--- a/po-docs/uk/virt-make-fs.1
+++ b/po-docs/uk/virt-make-fs.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-make-fs.pl 1"
-.TH virt-make-fs.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-make-fs.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-rescue.1 b/po-docs/uk/virt-rescue.1
index 8419d3e..fb15b25 100644
--- a/po-docs/uk/virt-rescue.1
+++ b/po-docs/uk/virt-rescue.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-rescue 1"
-.TH virt-rescue 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-rescue 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-resize.1 b/po-docs/uk/virt-resize.1
index b5227bb..a530f4b 100644
--- a/po-docs/uk/virt-resize.1
+++ b/po-docs/uk/virt-resize.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-resize 1"
-.TH virt-resize 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-resize 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-sparsify.1 b/po-docs/uk/virt-sparsify.1
index 24d5f30..0bc756f 100644
--- a/po-docs/uk/virt-sparsify.1
+++ b/po-docs/uk/virt-sparsify.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-sparsify 1"
-.TH virt-sparsify 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-sparsify 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-sysprep.1 b/po-docs/uk/virt-sysprep.1
index 7be1acc..bcd63fb 100644
--- a/po-docs/uk/virt-sysprep.1
+++ b/po-docs/uk/virt-sysprep.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-sysprep 1"
-.TH virt-sysprep 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-sysprep 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-tar-in.1 b/po-docs/uk/virt-tar-in.1
index f1a09dd..df47aa0 100644
--- a/po-docs/uk/virt-tar-in.1
+++ b/po-docs/uk/virt-tar-in.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-tar-in 1"
-.TH virt-tar-in 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-tar-in 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-tar-out.1 b/po-docs/uk/virt-tar-out.1
index 2171975..048fb48 100644
--- a/po-docs/uk/virt-tar-out.1
+++ b/po-docs/uk/virt-tar-out.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-tar-out 1"
-.TH virt-tar-out 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-tar-out 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-tar.1 b/po-docs/uk/virt-tar.1
index b7ac180..58340f2 100644
--- a/po-docs/uk/virt-tar.1
+++ b/po-docs/uk/virt-tar.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-tar.pl 1"
-.TH virt-tar.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-tar.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po-docs/uk/virt-win-reg.1 b/po-docs/uk/virt-win-reg.1
index ef2971e..2ed5f72 100644
--- a/po-docs/uk/virt-win-reg.1
+++ b/po-docs/uk/virt-win-reg.1
@@ -62,7 +62,7 @@
.\" ========================================================================
.\"
.IX Title "virt-win-reg.pl 1"
-.TH virt-win-reg.pl 1 "2011-11-17" "libguestfs-1.15.4" "Virtualization Support"
+.TH virt-win-reg.pl 1 "2011-11-21" "libguestfs-1.15.5" "Virtualization Support"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/po/en_GB.gmo b/po/en_GB.gmo
index f2814b2..1ad07f3 100644
Binary files a/po/en_GB.gmo and b/po/en_GB.gmo differ
diff --git a/po/en_GB.po b/po/en_GB.po
index f265015..3846ab4 100644
--- a/po/en_GB.po
+++ b/po/en_GB.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: English (United Kingdom) (http://www.transifex.net/projects/p/"
diff --git a/po/es.gmo b/po/es.gmo
index d936d7c..91ab4b7 100644
Binary files a/po/es.gmo and b/po/es.gmo differ
diff --git a/po/es.po b/po/es.po
index 7197780..b13c0e5 100644
--- a/po/es.po
+++ b/po/es.po
@@ -10,7 +10,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Spanish (Castilian) <trans-es at lists.fedoraproject.org>\n"
diff --git a/po/gu.gmo b/po/gu.gmo
index d24a365..f646d97 100644
Binary files a/po/gu.gmo and b/po/gu.gmo differ
diff --git a/po/gu.po b/po/gu.po
index bf7ed1a..465f47b 100644
--- a/po/gu.po
+++ b/po/gu.po
@@ -10,7 +10,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Gujarati <trans-gu at lists.fedoraproject.org>\n"
diff --git a/po/hi.gmo b/po/hi.gmo
index bda159d..fd19770 100644
Binary files a/po/hi.gmo and b/po/hi.gmo differ
diff --git a/po/hi.po b/po/hi.po
index d68bd27..2ced6a5 100644
--- a/po/hi.po
+++ b/po/hi.po
@@ -10,7 +10,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Hindi <indlinux-hindi at lists.sourceforge.net>\n"
diff --git a/po/kn.gmo b/po/kn.gmo
index cb26faa..f9c277b 100644
Binary files a/po/kn.gmo and b/po/kn.gmo differ
diff --git a/po/kn.po b/po/kn.po
index c884ed3..cbc5d19 100644
--- a/po/kn.po
+++ b/po/kn.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Kannada (http://www.transifex.net/projects/p/fedora/team/"
diff --git a/po/libguestfs.pot b/po/libguestfs.pot
index ba345f9..9e10862 100644
--- a/po/libguestfs.pot
+++ b/po/libguestfs.pot
@@ -6,10 +6,10 @@
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: libguestfs 1.15.4\n"
+"Project-Id-Version: libguestfs 1.15.5\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <LL at li.org>\n"
diff --git a/po/ml.gmo b/po/ml.gmo
index 3d3a4ba..c23d39f 100644
Binary files a/po/ml.gmo and b/po/ml.gmo differ
diff --git a/po/ml.po b/po/ml.po
index 4de9f42..e074943 100644
--- a/po/ml.po
+++ b/po/ml.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Malayalam <discuss at lists.smc.org.in>\n"
diff --git a/po/mr.gmo b/po/mr.gmo
index 1c83e48..2b31a94 100644
Binary files a/po/mr.gmo and b/po/mr.gmo differ
diff --git a/po/mr.po b/po/mr.po
index cd13531..56eccb8 100644
--- a/po/mr.po
+++ b/po/mr.po
@@ -10,7 +10,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Marathi (http://www.transifex.net/projects/p/fedora/team/"
diff --git a/po/nl.gmo b/po/nl.gmo
index d14181a..c1851a1 100644
Binary files a/po/nl.gmo and b/po/nl.gmo differ
diff --git a/po/nl.po b/po/nl.po
index c3e465d..267bd77 100644
--- a/po/nl.po
+++ b/po/nl.po
@@ -11,7 +11,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Dutch (http://www.transifex.net/projects/p/fedora/team/nl/)\n"
diff --git a/po/or.gmo b/po/or.gmo
index 2e806df..a737555 100644
Binary files a/po/or.gmo and b/po/or.gmo differ
diff --git a/po/or.po b/po/or.po
index e2e8b0b..ae4bfcb 100644
--- a/po/or.po
+++ b/po/or.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Oriya (http://www.transifex.net/projects/p/fedora/team/or/)\n"
diff --git a/po/pa.gmo b/po/pa.gmo
index 0aecc41..4fb1d9d 100644
Binary files a/po/pa.gmo and b/po/pa.gmo differ
diff --git a/po/pa.po b/po/pa.po
index 46e2072..6d65092 100644
--- a/po/pa.po
+++ b/po/pa.po
@@ -10,7 +10,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Panjabi (Punjabi) <punjabi-users at lists.sf.net>\n"
diff --git a/po/pl.gmo b/po/pl.gmo
index 50cc2cb..197b9cf 100644
Binary files a/po/pl.gmo and b/po/pl.gmo differ
diff --git a/po/pl.po b/po/pl.po
index df71594..540b8ba 100644
--- a/po/pl.po
+++ b/po/pl.po
@@ -10,7 +10,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Polish (http://www.transifex.net/projects/p/fedora/team/pl/)\n"
diff --git a/po/ta.gmo b/po/ta.gmo
index d025262..161d785 100644
Binary files a/po/ta.gmo and b/po/ta.gmo differ
diff --git a/po/ta.po b/po/ta.po
index ce32026..2053119 100644
--- a/po/ta.po
+++ b/po/ta.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Tamil <tamil-users at lists.fedoraproject.org>\n"
diff --git a/po/te.gmo b/po/te.gmo
index 09d8a59..e081600 100644
Binary files a/po/te.gmo and b/po/te.gmo differ
diff --git a/po/te.po b/po/te.po
index c1237f1..b1f16ce 100644
--- a/po/te.po
+++ b/po/te.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Telugu (http://www.transifex.net/projects/p/fedora/team/te/)\n"
diff --git a/po/uk.gmo b/po/uk.gmo
index 04369a5..ac57843 100644
Binary files a/po/uk.gmo and b/po/uk.gmo differ
diff --git a/po/uk.po b/po/uk.po
index 70675c7..96164a1 100644
--- a/po/uk.po
+++ b/po/uk.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2011-11-17 13:10+0000\n"
+"POT-Creation-Date: 2011-11-21 13:23+0000\n"
"PO-Revision-Date: 2011-10-27 09:11+0000\n"
"Last-Translator: rjones <rjones at redhat.com>\n"
"Language-Team: Ukrainian <trans-uk at lists.fedoraproject.org>\n"
diff --git a/ruby/Makefile.am b/ruby/Makefile.am
index 88d3323..757855a 100644
--- a/ruby/Makefile.am
+++ b/ruby/Makefile.am
@@ -61,7 +61,7 @@ RUBY_SITEARCH := $(shell ruby -rrbconfig -e "puts Config::CONFIG['sitearchdir']"
install:
$(MKDIR_P) $(DESTDIR)$(RUBY_SITELIB)
$(MKDIR_P) $(DESTDIR)$(RUBY_SITEARCH)
- $(INSTALL) -p -m 0644 lib/guestfs.rb $(DESTDIR)$(RUBY_SITELIB)
- $(INSTALL) -p -m 0755 ext/guestfs/_guestfs.so $(DESTDIR)$(RUBY_SITEARCH)
+ $(INSTALL) -p -m 0644 $(srcdir)/lib/guestfs.rb $(DESTDIR)$(RUBY_SITELIB)
+ $(INSTALL) -p -m 0755 $(builddir)/ext/guestfs/_guestfs.so $(DESTDIR)$(RUBY_SITEARCH)
endif
diff --git a/ruby/Makefile.in b/ruby/Makefile.in
index 33da059..46cdf27 100644
--- a/ruby/Makefile.in
+++ b/ruby/Makefile.in
@@ -1535,8 +1535,8 @@ appliance: force
@HAVE_RUBY_TRUE at install:
@HAVE_RUBY_TRUE@ $(MKDIR_P) $(DESTDIR)$(RUBY_SITELIB)
@HAVE_RUBY_TRUE@ $(MKDIR_P) $(DESTDIR)$(RUBY_SITEARCH)
- at HAVE_RUBY_TRUE@ $(INSTALL) -p -m 0644 lib/guestfs.rb $(DESTDIR)$(RUBY_SITELIB)
- at HAVE_RUBY_TRUE@ $(INSTALL) -p -m 0755 ext/guestfs/_guestfs.so $(DESTDIR)$(RUBY_SITEARCH)
+ at HAVE_RUBY_TRUE@ $(INSTALL) -p -m 0644 $(srcdir)/lib/guestfs.rb $(DESTDIR)$(RUBY_SITELIB)
+ at HAVE_RUBY_TRUE@ $(INSTALL) -p -m 0755 $(builddir)/ext/guestfs/_guestfs.so $(DESTDIR)$(RUBY_SITEARCH)
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
diff --git a/ruby/Rakefile.in b/ruby/Rakefile.in
index 7c5a63a..f4bf901 100644
--- a/ruby/Rakefile.in
+++ b/ruby/Rakefile.in
@@ -24,7 +24,7 @@ require 'rake/gempackagetask'
PKG_NAME='@PACKAGE_NAME@'
PKG_VERSION='@PACKAGE_VERSION@'
-EXT_CONF='@srcdir@/ext/guestfs/extconf.rb'
+EXT_CONF='@abs_srcdir@/ext/guestfs/extconf.rb'
MAKEFILE='@builddir@/ext/guestfs/Makefile'
GUESTFS_MODULE='@builddir@/ext/guestfs/_guestfs.so'
GUESTFS_SRC='@srcdir@/ext/guestfs/_guestfs.c'
@@ -38,13 +38,13 @@ CLOBBER.include [ "@builddir@/config.save", "@builddir@/ext/**/mkmf.log",
# Build locally
file MAKEFILE => EXT_CONF do |t|
- unless sh "top_srcdir=$(pwd)/@top_srcdir@; top_builddir=$(pwd)/@top_builddir@; export ARCHFLAGS=\"-arch $(uname -m)\"; cd #{File::dirname(EXT_CONF)}; ruby #{File::basename(EXT_CONF)} --with-_guestfs-include=$top_srcdir/src --with-_guestfs-lib=$top_builddir/src/.libs"
+ unless sh "top_srcdir=$(pwd)/@top_srcdir@; top_builddir=$(pwd)/@top_builddir@; export ARCHFLAGS=\"-arch $(uname -m)\"; mkdir -p @builddir@/ext/guestfs; cd @builddir@/ext/guestfs; ruby #{EXT_CONF} --with-_guestfs-include=$top_srcdir/src --with-_guestfs-lib=$top_builddir/src/.libs"
$stderr.puts "Failed to run extconf"
break
end
end
file GUESTFS_MODULE => [ MAKEFILE, GUESTFS_SRC ] do |t|
- Dir::chdir(File::dirname(EXT_CONF)) do
+ Dir::chdir("@builddir@/ext/guestfs") do
unless sh "make"
$stderr.puts "make failed"
break
@@ -61,19 +61,19 @@ end
task :test => :build
RDOC_FILES = FileList[
- "README.rdoc",
- "lib/**/*.rb",
- "ext/**/*.[ch]"
+ "@srcdir@/README.rdoc",
+ "@srcdir@/lib/**/*.rb",
+ "@srcdir@/ext/**/*.[ch]"
]
Rake::RDocTask.new do |rd|
- rd.main = "README.rdoc"
+ rd.main = "@srcdir@/README.rdoc"
rd.rdoc_dir = "doc/site/api"
rd.rdoc_files.include(RDOC_FILES)
end
Rake::RDocTask.new(:ri) do |rd|
- rd.main = "README.rdoc"
+ rd.main = "@srcdir@/README.rdoc"
rd.rdoc_dir = "doc/ri"
rd.options << "--ri-system"
rd.rdoc_files.include(RDOC_FILES)
@@ -82,7 +82,7 @@ end
# Package tasks
PKG_FILES = FileList[
- "Rakefile", "COPYING", "README", "NEWS", "README.rdoc",
+ "Rakefile", "COPYING", "README", "NEWS", "@srcdir@/README.rdoc",
"lib/**/*.rb",
"ext/**/*.[ch]", "ext/**/MANIFEST", "ext/**/extconf.rb",
"tests/**/*",
diff --git a/ruby/run-bindtests b/ruby/run-bindtests
index a78b5f6..4cac863 100755
--- a/ruby/run-bindtests
+++ b/ruby/run-bindtests
@@ -18,5 +18,5 @@
set -e
-ruby -Ilib -Iext/guestfs bindtests.rb > bindtests.tmp
+ruby -I${srcdir}/lib -Iext/guestfs ${srcdir}/bindtests.rb > bindtests.tmp
diff -u ${srcdir}/../bindtests bindtests.tmp
diff --git a/src/guestfs.pod b/src/guestfs.pod
index e6a16a6..0358d8a 100644
--- a/src/guestfs.pod
+++ b/src/guestfs.pod
@@ -3298,6 +3298,7 @@ L<virt-tar(1)>,
L<virt-tar-in(1)>,
L<virt-tar-out(1)>,
L<virt-win-reg(1)>,
+L<guestfs-testing(1)>,
L<qemu(1)>,
L<febootstrap(1)>,
L<febootstrap-supermin-helper(8)>,
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-libvirt/libguestfs.git
More information about the Pkg-libvirt-commits
mailing list