+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:5
+msgid "virt-sparsify - Make a virtual machine disk sparse"
+msgstr ""
+
+#. type: verbatim
+#: ../sparsify/virt-sparsify.pod:9
+#, no-wrap
+msgid ""
+" virt-sparsify [--options] indisk outdisk\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:13
+msgid ""
+"Virt-sparsify is a tool which can make a virtual machine disk (or any disk "
+"image) sparse a.k.a. thin-provisioned. This means that free space within "
+"the disk image can be converted back to free space on the host."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:18
+msgid ""
+"Virt-sparsify can locate and sparsify free space in most filesystems "
+"(eg. ext2/3/4, btrfs, NTFS, etc.), and also in LVM physical volumes."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:21
+msgid ""
+"Virt-sparsify can also convert between some disk formats, for example "
+"converting a raw disk image to a thin-provisioned qcow2 image."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:24
+msgid ""
+"Virt-sparsify can operate on any disk image, not just ones from virtual "
+"machines. If a virtual machine has more than one attached disk, you must "
+"sparsify each one separately."
+msgstr ""
+
+#. type: =head2
+#: ../sparsify/virt-sparsify.pod:28
+msgid "IMPORTANT LIMITATIONS"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:34
+msgid ""
+"Virt-sparsify does not do in-place modifications. It copies from a source "
+"image to a destination image, leaving the source unchanged. I<Check that "
+"the sparsification was successful before deleting the source image>."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:41
+msgid "The virtual machine I<must be shut down> before using this tool."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:45
+msgid ""
+"Virt-sparsify may require up to 2x the virtual size of the source disk image "
+"(1 temporary copy + 1 destination image). This is in the worst case and "
+"usually much less space is required."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:51
+msgid "Virt-sparsify cannot resize disk images. To do that, use L<virt-resize(1)>."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:56
+msgid "Virt-sparsify cannot handle encrypted disks."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:60
+msgid ""
+"Virt-sparsify cannot yet sparsify the space between partitions. Note that "
+"this space is often used for critical items like bootloaders so it's not "
+"really unused."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:66
+msgid ""
+"Virt-sparsify does not yet know how to sparsify swapspace. It is not safe "
+"to do this unless we can be sure there is no hibernation data, so at the "
+"moment swap partitions are ignored."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:72
+msgid ""
+"You may also want to read the manual pages for the associated tools "
+"L<virt-filesystems(1)> and L<virt-df(1)> before starting."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:77
+msgid "Typical usage is:"
+msgstr ""
+
+#. type: verbatim
+#: ../sparsify/virt-sparsify.pod:79
+#, no-wrap
+msgid ""
+" virt-sparsify indisk outdisk\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:81
+msgid ""
+"which copies C<indisk> to C<outdisk>, making the output sparse. C<outdisk> "
+"is created, or overwritten if it already exists. The format of the input "
+"disk is detected (eg. qcow2) and the same format is used for the output "
+"disk."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:86
+msgid "To convert between formats, use the I<--convert> option:"
+msgstr ""
+
+#. type: verbatim
+#: ../sparsify/virt-sparsify.pod:88
+#, no-wrap
+msgid ""
+" virt-sparsify disk.raw --convert qcow2 disk.qcow2\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:90
+msgid ""
+"Virt-sparsify tries to zero and sparsify free space on every filesystem it "
+"can find within the source disk image. You can get it to ignore (don't zero "
+"free space on) certain filesystems by doing:"
+msgstr ""
+
+#. type: verbatim
+#: ../sparsify/virt-sparsify.pod:94
+#, no-wrap
+msgid ""
+" virt-sparsify --ignore /dev/sda1 indisk outdisk\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:96
+msgid "See L<virt-filesystems(1)> to get a list of filesystems within a disk image."
+msgstr ""
+
+#. type: =item
+#: ../sparsify/virt-sparsify.pod:107
+msgid "B<--convert> raw"
+msgstr ""
+
+#. type: =item
+#: ../sparsify/virt-sparsify.pod:109
+msgid "B<--convert> qcow2"
+msgstr ""
+
+#. type: =item
+#: ../sparsify/virt-sparsify.pod:111
+msgid "B<--convert> [other formats]"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:113
+msgid ""
+"Use C<output-format> as the format for the destination image. If this is "
+"not specified, then the input format is used."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:116
+msgid "Supported and known-working output formats are: C<raw>, C<qcow2>."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:118
+msgid ""
+"You can also use any format supported by the L<qemu-img(1)> program, "
+"eg. C<vdi> or C<vmdk>, but support for other formats is reliant on qemu."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:122
+msgid ""
+"Specifying the I<--convert> option is usually a good idea, because then "
+"virt-sparsify doesn't need to try to guess the input format."
+msgstr ""
+
+#. type: =item
+#: ../sparsify/virt-sparsify.pod:127
+msgid "B<--format> qcow2"
+msgstr ""
+
+#. type: =item
+#: ../sparsify/virt-sparsify.pod:135
+msgid "B<--ignore> filesystem"
+msgstr ""
+
+#. type: =item
+#: ../sparsify/virt-sparsify.pod:137
+msgid "B<--ignore> volgroup"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:139
+msgid ""
+"Ignore the named filesystem. Free space on the filesystem will not be "
+"zeroed, but existing blocks of zeroes will still be sparsified."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:142
+msgid ""
+"In the second form, this ignores the named volume group. Use the volume "
+"group name without the C</dev/> prefix, eg. I<--ignore vg_foo>"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:157
+msgid "This disables progress bars and other unnecessary output."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:179
+msgid ""
+"The I<--machine-readable> option can be used to make the output more machine "
+"friendly, which is useful when calling virt-sparsify from other programs, "
+"GUIs etc."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:185
+msgid ""
+"Firstly use the option on its own to query the capabilities of the "
+"virt-sparsify binary. Typical output looks like this:"
+msgstr ""
+
+#. type: verbatim
+#: ../sparsify/virt-sparsify.pod:188
+#, no-wrap
+msgid ""
+" $ virt-sparsify --machine-readable\n"
+" virt-sparsify\n"
+" ntfs\n"
+" btrfs\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:218
+msgid ""
+"The calling program should treat messages sent to stderr as error messages. "
+"In addition, virt-sparsify exits with a non-zero status code if there was a "
+"fatal error."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:224
+msgid ""
+"All versions of virt-sparsify have supported the I<--machine-readable> "
+"option."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:238
+msgid ""
+"Location of the temporary directory used for the potentially large temporary "
+"overlay file."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:241
+msgid ""
+"You should ensure there is enough free space in the worst case for a full "
+"copy of the source disk (I<virtual> size), or else set C<$TMPDIR> to point "
+"to another directory that has enough space."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:245
+msgid "This defaults to C</tmp>."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:249
+msgid "For other environment variables, see L<guestfs(3)/ENVIRONMENT VARIABLES>."
+msgstr ""
+
+#. type: textblock
+#: ../sparsify/virt-sparsify.pod:253
+msgid ""
+"L<virt-filesystems(1)>, L<virt-df(1)>, L<virt-resize(1)>, L<virt-rescue(1)>, "
+"L<guestfs(3)>, L<guestfish(1)>, L<truncate(1)>, L<fallocate(1)>, "
+"L<qemu-img(1)>, L<http://libguestfs.org/>."
+msgstr ""
+
git.annexia.org / libguestfs.git / blobdiff