+#. 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:161 ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 ../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 ""
+"You can try comparing this to the results from L<df(1)> inside the guest, "
+"but there are some provisos:"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:112
+msgid "The guest must be idle."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:116
+msgid "The guest disks must be synched using L<sync(1)>."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:120
+msgid ""
+"Any action such as booting the guest will write log files causing the "
+"numbers to change."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:125
+msgid ""
+"We don't guarantee that the numbers will be identical even under these "
+"circumstances. They should be similar. It would indicate a bug if you saw "
+"greatly differing numbers."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:129
+msgid "Try importing virt-df CSV output into a spreadsheet or database."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3088
+msgid "Run:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:133
+#, no-wrap
+msgid ""
+" virt-df --csv > /tmp/report.csv\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:135
+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:138
+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:141
+msgid "B<*> Edit a file in a B<shut off> guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:143
+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:146
+#, no-wrap
+msgid ""
+" virt-edit LinuxGuest /etc/sysconfig/network\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:148
+msgid "On other Linux guests try editing other files such as:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:150
+#, no-wrap
+msgid ""
+" virt-edit LinuxGuest /etc/motd\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:152
+msgid "Are the changes seen inside the guest when it is booted?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:154
+msgid "Display the filesystems / partitions / LVs in a guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:156
+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:159
+#, no-wrap
+msgid ""
+" virt-filesystems -a /path/to/disk.img --all --long -h\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:163
+#, no-wrap
+msgid ""
+" virt-filesystems -d Guest --all --long -h\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:165
+msgid "Do the results match what is seen in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:167
+msgid "Run virt-inspector on all your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:169
+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:172
+#, no-wrap
+msgid ""
+" virt-inspector -a /path/to/disk.img | less\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:176
+#, no-wrap
+msgid ""
+" virt-inspector -d Guest | less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:178
+msgid "Do the results match what is actually in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:180
+msgid "Try the auditing features of virt-ls on all your guests."
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:184
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^- [42]'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:188
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^d ...7'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:192
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep '^s'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:196
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:198
+msgid "Display files larger than 10MB in home directories:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:200
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:204
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:208
+#, no-wrap
+msgid ""
+" virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:210
+msgid "Do the results match what is in the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:212
+msgid "Create a disk image from a tarball."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:214
+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:217
+#, 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:219
+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:223
+msgid "Try other partitioning schemes, eg. I<--partition=gpt>."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:225
+msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:227
+msgid "B<*> Run virt-rescue on a B<shut off> disk image or guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:229
+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:232
+#, no-wrap
+msgid ""
+" virt-rescue -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:236
+#, no-wrap
+msgid ""
+" virt-rescue -d Guest\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:238
+msgid "Can you use ordinary shell commands to examine the guest?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:240
+msgid "B<*> Resize your guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:242
+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:246
+#, 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:251
+msgid "Does the guest still boot? Try expanding other partitions."
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:253
+msgid "B<*> Sparsify a guest disk."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:255
+msgid "Using L<virt-sparsify(1)>, make a disk image more sparse:"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:257
+#, no-wrap
+msgid ""
+" virt-sparsify /path/to/olddisk.img newdisk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:259
+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:262
+msgid "B<*> \"sysprep\" a B<shut off> Linux guest."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:264
+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:267
+#, no-wrap
+msgid ""
+" virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:269
+msgid ""
+"Was the sysprep successful? After booting, what changes were made and were "
+"they successful?"
+msgstr ""
+
+#. type: =head2
+#: ../examples/guestfs-testing.pod:272
+msgid "Dump the Windows Registry from your Windows guests."
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:274
+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:277
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../examples/guestfs-testing.pod:280
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:283
+msgid "Does the output match running C<regedit> inside the guest?"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:285
+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:288
+#, no-wrap
+msgid ""
+" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' "
+"|\n"
+" less\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../examples/guestfs-testing.pod:293
+msgid ""
+"L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, "
+"L<http://libguestfs.org/>."
+msgstr ""
+
git.annexia.org / libguestfs.git / blobdiff