NOTE: This file is automatically generated from "update-bugs".
-Last updated: 2010-09-01 17:45:44
+Last updated: 2010-09-04 13:42:30
This contains a local list of the bugs that are open against
libguestfs. Bugs are tracked in the Red Hat Bugzilla database
579664 VERIFIED https://bugzilla.redhat.com/show_bug.cgi?id=579664
guestfish doesn't report error when there is not enough space for image allocation
-582144 VERIFIED https://bugzilla.redhat.com/show_bug.cgi?id=582144
- $g->aug_set doesn't allow a NULL value
-
598771 VERIFIED https://bugzilla.redhat.com/show_bug.cgi?id=598771
guestfish 'help' command should indicate error in exit status with an unknown command
# major/minor/release must be numbers
m4_define([libguestfs_major], [1])
m4_define([libguestfs_minor], [5])
-m4_define([libguestfs_release], [7])
+m4_define([libguestfs_release], [8])
# extra can be any string
m4_define([libguestfs_extra], [])
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
-"POT-Creation-Date: 2010-09-02 20:33+0200\n"
+"POT-Creation-Date: 2010-09-04 10:26+0200\n"
"PO-Revision-Date: 2010-09-02 14:46+0100\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
msgid ""
"Libguestfs is a library that can be linked with C and C++ management "
"programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
-"Haskell or C#). You can also use it from shell scripts or the command line."
+"PHP, Haskell or C#). You can also use it from shell scripts or the command "
+"line."
msgstr ""
# type: textblock
# type: =item
#: ../src/guestfs.pod:345 ../src/guestfs.pod:350 ../src/guestfs.pod:355
#: ../src/guestfs.pod:359 ../src/guestfs.pod:364 ../src/guestfs.pod:368
-#: ../src/guestfs.pod:373 ../src/guestfs.pod:1214 ../src/guestfs.pod:1219
-#: ../src/guestfs.pod:1223 ../src/guestfs.pod:1325 ../src/guestfs.pod:1329
-#: ../src/guestfs.pod:1333 ../src/guestfs.pod:1338 ../src/guestfs.pod:1346
-#: ../src/guestfs.pod:1365 ../src/guestfs.pod:1373 ../src/guestfs.pod:1587
-#: ../src/guestfs.pod:1593 ../src/guestfs.pod:1598 ../src/guestfs.pod:1604
-#: ../src/guestfs.pod:1711 ../src/guestfs.pod:1715 ../src/guestfs.pod:1719
-#: ../src/guestfs.pod:1723 ../src/guestfs-actions.pod:14
+#: ../src/guestfs.pod:373 ../src/guestfs.pod:1226 ../src/guestfs.pod:1231
+#: ../src/guestfs.pod:1235 ../src/guestfs.pod:1337 ../src/guestfs.pod:1341
+#: ../src/guestfs.pod:1345 ../src/guestfs.pod:1350 ../src/guestfs.pod:1358
+#: ../src/guestfs.pod:1377 ../src/guestfs.pod:1385 ../src/guestfs.pod:1599
+#: ../src/guestfs.pod:1605 ../src/guestfs.pod:1610 ../src/guestfs.pod:1616
+#: ../src/guestfs.pod:1723 ../src/guestfs.pod:1727 ../src/guestfs.pod:1731
+#: ../src/guestfs.pod:1735 ../src/guestfs-actions.pod:14
#: ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:372
#: ../src/guestfs-actions.pod:380 ../src/guestfs-actions.pod:387
#: ../src/guestfs-actions.pod:394 ../src/guestfs-actions.pod:1257
# type: =item
#: ../src/guestfs.pod:629
-msgid "B<Python>"
+msgid "B<PHP>"
msgstr ""
# type: textblock
#: ../src/guestfs.pod:631
+msgid ""
+"For documentation see C<README-PHP> supplied with libguestfs sources or in "
+"the php-libguestfs package for your distribution."
+msgstr ""
+
+# type: textblock
+#: ../src/guestfs.pod:634
+msgid "The PHP binding only works correctly on 64 bit machines."
+msgstr ""
+
+# type: =item
+#: ../src/guestfs.pod:636
+msgid "B<Python>"
+msgstr ""
+
+# type: textblock
+#: ../src/guestfs.pod:638
msgid "For documentation do:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:633
+#: ../src/guestfs.pod:640
#, no-wrap
msgid ""
" $ python\n"
msgstr ""
# type: =item
-#: ../src/guestfs.pod:637
+#: ../src/guestfs.pod:644
msgid "B<Ruby>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:639
+#: ../src/guestfs.pod:646
msgid ""
"Use the Guestfs module. There is no Ruby-specific documentation, but you "
"can find examples written in Ruby in the libguestfs source."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:642
+#: ../src/guestfs.pod:649
msgid "B<shell scripts>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:644
+#: ../src/guestfs.pod:651
msgid "For documentation see L<guestfish(1)>."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:648
+#: ../src/guestfs.pod:655
msgid "LIBGUESTFS GOTCHAS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:650
+#: ../src/guestfs.pod:657
msgid ""
"L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
"system [...] that works in the way it is documented but is counterintuitive "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:654
+#: ../src/guestfs.pod:661
msgid ""
"Since we developed libguestfs and the associated tools, there are several "
"things we would have designed differently, but are now stuck with for "
msgstr ""
# type: =item
-#: ../src/guestfs.pod:662
+#: ../src/guestfs.pod:669
msgid "Autosync / forgetting to sync."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:664
+#: ../src/guestfs.pod:671
msgid ""
"When modifying a filesystem from C or another language, you B<must> unmount "
"all filesystems and call L</guestfs_sync> explicitly before you close the "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:668
+#: ../src/guestfs.pod:675
#, no-wrap
msgid ""
" guestfs_set_autosync (g, 1);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:670
+#: ../src/guestfs.pod:677
msgid ""
"to have the unmount/sync done automatically for you when the handle 'g' is "
"closed. (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:674
+#: ../src/guestfs.pod:681
msgid ""
"If you forget to do this, then it is entirely possible that your changes "
"won't be written out, or will be partially written, or (very rarely) that "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:678
+#: ../src/guestfs.pod:685
msgid ""
"Note that in L<guestfish(3)> autosync is the default. So quick and dirty "
"guestfish scripts that forget to sync will work just fine, which can make "
msgstr ""
# type: =item
-#: ../src/guestfs.pod:682
+#: ../src/guestfs.pod:689
msgid "Mount option C<-o sync> should not be the default."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:684
+#: ../src/guestfs.pod:691
msgid ""
"If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly. "
"However C<-o sync> does not add any reliability benefit, but does have a "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:688
+#: ../src/guestfs.pod:695
msgid ""
"The work around is to use L</guestfs_mount_options> and set the mount "
"options that you actually want to use."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:691
+#: ../src/guestfs.pod:698
msgid "Read-only should be the default."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:693
+#: ../src/guestfs.pod:700
msgid ""
"In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
"specify I<--rw> if you want to make changes to the image."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:696
+#: ../src/guestfs.pod:703
msgid "This would reduce the potential to corrupt live VM images."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:698
+#: ../src/guestfs.pod:705
msgid ""
"Note that many filesystems change the disk when you just mount and unmount, "
"even if you didn't perform any writes. You need to use L</"
msgstr ""
# type: =item
-#: ../src/guestfs.pod:702
+#: ../src/guestfs.pod:709
msgid "guestfish command line is hard to use."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:704
+#: ../src/guestfs.pod:711
msgid ""
"C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
"examination). It tries to run a guestfish command C<disk.img> which doesn't "
msgstr ""
# type: =item
-#: ../src/guestfs.pod:711
+#: ../src/guestfs.pod:718
msgid "guestfish megabyte modifiers don't work right on all commands"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:713
+#: ../src/guestfs.pod:720
msgid ""
"In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
"other modifiers). What guestfish actually does is to multiply the number "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:720
+#: ../src/guestfs.pod:727
msgid "The most common is L</guestfs_lvcreate>. The guestfish command:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:722
+#: ../src/guestfs.pod:729
#, no-wrap
msgid ""
" lvcreate LV VG 100M\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:724
+#: ../src/guestfs.pod:731
msgid ""
"does not do what you might expect. Instead because L</guestfs_lvcreate> is "
"already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:729
+#: ../src/guestfs.pod:736
msgid ""
"This could be fixed in the generator by specially marking parameters and "
"return values which take bytes or other units."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:732
+#: ../src/guestfs.pod:739
msgid "Library should return errno with error messages."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:734
+#: ../src/guestfs.pod:741
msgid ""
"It would be a nice-to-have to be able to get the original value of 'errno' "
"from inside the appliance along error paths (where set). Currently "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:740
+#: ../src/guestfs.pod:747
msgid ""
"In libguestfs 1.5.4, the protocol was changed so that the Linux errno is "
"sent back from the daemon."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:745
+#: ../src/guestfs.pod:752
msgid "PROTOCOL LIMITS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:747
+#: ../src/guestfs.pod:754
msgid ""
"Internally libguestfs uses a message-based protocol to pass API calls and "
"their responses to and from a small \"appliance\" (see L</INTERNALS> for "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:755
+#: ../src/guestfs.pod:762
msgid ""
"A simple call such as L</guestfs_cat> returns its result (the file data) in "
"a simple string. Because this string is at some point internally encoded as "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:761
+#: ../src/guestfs.pod:768
msgid ""
"In order to transfer large files into and out of the guest filesystem, you "
"need to use particular calls that support this. The sections L</UPLOADING> "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:765
+#: ../src/guestfs.pod:772
msgid ""
"You might also consider mounting the disk image using our FUSE filesystem "
"support (L<guestmount(1)>)."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:768
+#: ../src/guestfs.pod:775
msgid "KEYS AND PASSPHRASES"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:770
+#: ../src/guestfs.pod:777
msgid ""
"Certain libguestfs calls take a parameter that contains sensitive key "
"material, passed in as a C string."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:773
+#: ../src/guestfs.pod:780
msgid ""
"In the future we would hope to change the libguestfs implementation so that "
"keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:778
+#: ../src/guestfs.pod:785
msgid ""
"Therefore you should be aware that any key parameter you pass to libguestfs "
"might end up being written out to the swap partition. If this is a concern, "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:783
+#: ../src/guestfs.pod:790
msgid "CONNECTION MANAGEMENT"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:785
+#: ../src/guestfs.pod:792
msgid "guestfs_h *"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:787
+#: ../src/guestfs.pod:794
msgid ""
"C<guestfs_h> is the opaque type representing a connection handle. Create a "
"handle by calling L</guestfs_create>. Call L</guestfs_close> to free the "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:791
+#: ../src/guestfs.pod:798
msgid ""
"For information on using multiple handles and threads, see the section L</"
"MULTIPLE HANDLES AND MULTIPLE THREADS> below."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:794
+#: ../src/guestfs.pod:801
msgid "guestfs_create"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:796
+#: ../src/guestfs.pod:803
#, no-wrap
msgid ""
" guestfs_h *guestfs_create (void);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:798
+#: ../src/guestfs.pod:805
msgid "Create a connection handle."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:800
+#: ../src/guestfs.pod:807
msgid "You have to call L</guestfs_add_drive> on the handle at least once."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:802
+#: ../src/guestfs.pod:809
msgid ""
"This function returns a non-NULL pointer to a handle on success or NULL on "
"error."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:805
+#: ../src/guestfs.pod:812
msgid "After configuring the handle, you have to call L</guestfs_launch>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:807
+#: ../src/guestfs.pod:814
msgid ""
"You may also want to configure error handling for the handle. See L</ERROR "
"HANDLING> section below."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:810
+#: ../src/guestfs.pod:817
msgid "guestfs_close"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:812
+#: ../src/guestfs.pod:819
#, no-wrap
msgid ""
" void guestfs_close (guestfs_h *g);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:814
+#: ../src/guestfs.pod:821
msgid "This closes the connection handle and frees up all resources used."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:816
+#: ../src/guestfs.pod:823
msgid "ERROR HANDLING"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:818
+#: ../src/guestfs.pod:825
msgid ""
"The convention in all functions that return C<int> is that they return C<-1> "
"to indicate an error. You can get additional information on errors by "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:823
+#: ../src/guestfs.pod:830
msgid "The default error handler prints the information string to C<stderr>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:825
+#: ../src/guestfs.pod:832
msgid ""
"Out of memory errors are handled differently. The default action is to call "
"L<abort(3)>. If this is undesirable, then you can set a handler using L</"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:829
+#: ../src/guestfs.pod:836
msgid "guestfs_last_error"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:831
+#: ../src/guestfs.pod:838
#, no-wrap
msgid ""
" const char *guestfs_last_error (guestfs_h *g);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:833
+#: ../src/guestfs.pod:840
msgid ""
"This returns the last error message that happened on C<g>. If there has not "
"been an error since the handle was created, then this returns C<NULL>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:837
+#: ../src/guestfs.pod:844
msgid ""
"The lifetime of the returned string is until the next error occurs, or L</"
"guestfs_close> is called."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:840
+#: ../src/guestfs.pod:847
msgid ""
"The error string is not localized (ie. is always in English), because this "
"makes searching for error messages in search engines give the largest number "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:844
+#: ../src/guestfs.pod:851
msgid "guestfs_set_error_handler"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:846
+#: ../src/guestfs.pod:853
#, no-wrap
msgid ""
" typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:853
+#: ../src/guestfs.pod:860
msgid ""
"The callback C<cb> will be called if there is an error. The parameters "
"passed to the callback are an opaque data pointer and the error message "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:857
+#: ../src/guestfs.pod:864
msgid ""
"Note that the message string C<msg> is freed as soon as the callback "
"function returns, so if you want to stash it somewhere you must make your "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:861
+#: ../src/guestfs.pod:868
msgid "The default handler prints messages on C<stderr>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:863
+#: ../src/guestfs.pod:870
msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:865
+#: ../src/guestfs.pod:872
msgid "guestfs_get_error_handler"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:867
+#: ../src/guestfs.pod:874
#, no-wrap
msgid ""
" guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:870
+#: ../src/guestfs.pod:877
msgid "Returns the current error handler callback."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:872
+#: ../src/guestfs.pod:879
msgid "guestfs_set_out_of_memory_handler"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:874
+#: ../src/guestfs.pod:881
#, no-wrap
msgid ""
" typedef void (*guestfs_abort_cb) (void);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:878
+#: ../src/guestfs.pod:885
msgid ""
"The callback C<cb> will be called if there is an out of memory situation. "
"I<Note this callback must not return>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:881
+#: ../src/guestfs.pod:888
msgid "The default is to call L<abort(3)>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:883
+#: ../src/guestfs.pod:890
msgid ""
"You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:886
+#: ../src/guestfs.pod:893
msgid "guestfs_get_out_of_memory_handler"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:888
+#: ../src/guestfs.pod:895
#, no-wrap
msgid ""
" guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:890
+#: ../src/guestfs.pod:897
msgid "This returns the current out of memory handler."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:892
+#: ../src/guestfs.pod:899
msgid "PATH"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:894
+#: ../src/guestfs.pod:901
msgid ""
"Libguestfs needs a kernel and initrd.img, which it finds by looking along an "
"internal path."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:897
+#: ../src/guestfs.pod:904
msgid ""
"By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
"usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:900
+#: ../src/guestfs.pod:907
msgid ""
"Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
"to change the directories that libguestfs will search in. The value is a "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:907
+#: ../src/guestfs.pod:914
msgid "HIGH-LEVEL API ACTIONS"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:909
+#: ../src/guestfs.pod:916
msgid "ABI GUARANTEE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:911
+#: ../src/guestfs.pod:918
msgid ""
"We guarantee the libguestfs ABI (binary interface), for public, high-level "
"actions as outlined in this section. Although we will deprecate some "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:917 ../fish/guestfish.pod:898
+#: ../src/guestfs.pod:924 ../fish/guestfish.pod:898
msgid "@ACTIONS@"
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:919
+#: ../src/guestfs.pod:926
msgid "STRUCTURES"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:921
+#: ../src/guestfs.pod:928
msgid "@STRUCTS@"
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:923
+#: ../src/guestfs.pod:930
msgid "AVAILABILITY"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:925
+#: ../src/guestfs.pod:932
msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:927
+#: ../src/guestfs.pod:934
msgid ""
"Using L</guestfs_available> you can test availability of the following "
"groups of functions. This test queries the appliance to see if the "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:932
+#: ../src/guestfs.pod:939
msgid "@AVAILABILITY@"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:934
+#: ../src/guestfs.pod:941
msgid "GUESTFISH supported COMMAND"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:936
+#: ../src/guestfs.pod:943
msgid ""
"In L<guestfish(3)> there is a handy interactive command C<supported> which "
"prints out the available groups and whether they are supported by this build "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:941
+#: ../src/guestfs.pod:948
msgid "SINGLE CALLS AT COMPILE TIME"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:943
+#: ../src/guestfs.pod:950
msgid ""
-"If you need to test whether a single libguestfs function is available at "
-"compile time, we recommend using build tools such as autoconf or cmake. For "
-"example in autotools you could use:"
+"Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
+"function, such as:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:948
+#: ../src/guestfs.pod:953
+#, no-wrap
+msgid ""
+" #define LIBGUESTFS_HAVE_DD 1\n"
+"\n"
+msgstr ""
+
+# type: textblock
+#: ../src/guestfs.pod:955
+msgid "if L</guestfs_dd> is available."
+msgstr ""
+
+# type: textblock
+#: ../src/guestfs.pod:957
+msgid ""
+"Before version 1.5.8, if you needed to test whether a single libguestfs "
+"function is available at compile time, we recommended using build tools such "
+"as autoconf or cmake. For example in autotools you could use:"
+msgstr ""
+
+# type: verbatim
+#: ../src/guestfs.pod:962
#, no-wrap
msgid ""
" AC_CHECK_LIB([guestfs],[guestfs_create])\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:951
+#: ../src/guestfs.pod:965
msgid ""
"which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
"in your program."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:954
+#: ../src/guestfs.pod:968
msgid "SINGLE CALLS AT RUN TIME"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:956
+#: ../src/guestfs.pod:970
msgid ""
"Testing at compile time doesn't guarantee that a function really exists in "
"the library. The reason is that you might be dynamically linked against a "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:963
+#: ../src/guestfs.pod:977
msgid ""
"You can use L<dlopen(3)> to test if a function is available at run time, as "
"in this example program (note that you still need the compile time check as "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:967
-#, no-wrap
-msgid ""
-" #include <config.h>\n"
-" \n"
-msgstr ""
-
-# type: verbatim
-#: ../src/guestfs.pod:969
+#: ../src/guestfs.pod:981
#, no-wrap
msgid ""
" #include <stdio.h>\n"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:975
+#: ../src/guestfs.pod:987
#, no-wrap
msgid ""
" main ()\n"
" {\n"
-" #ifdef HAVE_GUESTFS_DD\n"
+" #ifdef LIBGUESTFS_HAVE_DD\n"
" void *dl;\n"
" int has_function;\n"
" \n"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:981
+#: ../src/guestfs.pod:993
#, no-wrap
msgid ""
" /* Test if the function guestfs_dd is really available. */\n"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:990
+#: ../src/guestfs.pod:1002
#, no-wrap
msgid ""
" if (!has_function)\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1003
+#: ../src/guestfs.pod:1015
msgid ""
"You may think the above is an awful lot of hassle, and it is. There are "
"other ways outside of the C linking system to ensure that this kind of "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1008
+#: ../src/guestfs.pod:1020
#, no-wrap
msgid ""
" Requires: libguestfs >= 1.0.80\n"
msgstr ""
# type: =end
-#: ../src/guestfs.pod:1010 ../src/guestfs.pod:1015
+#: ../src/guestfs.pod:1022 ../src/guestfs.pod:1027
msgid "html"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1012
+#: ../src/guestfs.pod:1024
msgid ""
"<!-- old anchor for the next section --> <a name="
"\"state_machine_and_low_level_event_api\"/>"
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1017
+#: ../src/guestfs.pod:1029
msgid "ARCHITECTURE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1019
+#: ../src/guestfs.pod:1031
msgid ""
"Internally, libguestfs is implemented by running an appliance (a special "
"type of small virtual machine) using L<qemu(1)>. Qemu runs as a child "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1023
+#: ../src/guestfs.pod:1035
#, no-wrap
msgid ""
" ___________________\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1043
+#: ../src/guestfs.pod:1055
msgid ""
"The library, linked to the main program, creates the child process and hence "
"the appliance in the L</guestfs_launch> function."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1046
+#: ../src/guestfs.pod:1058
msgid ""
"Inside the appliance is a Linux kernel and a complete stack of userspace "
"tools (such as LVM and ext2 programs) and a small controlling daemon called "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1055
+#: ../src/guestfs.pod:1067
msgid ""
"A common misunderstanding is that the appliance \"is\" the virtual machine. "
"Although the disk image you are attached to might also be used by some "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1062
+#: ../src/guestfs.pod:1074
msgid "STATE MACHINE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1064
+#: ../src/guestfs.pod:1076
msgid "libguestfs uses a state machine to model the child process:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1066
+#: ../src/guestfs.pod:1078
#, no-wrap
msgid ""
" |\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1088
+#: ../src/guestfs.pod:1100
msgid ""
"The normal transitions are (1) CONFIG (when the handle is created, but there "
"is no child process), (2) LAUNCHING (when the child process is booting up), "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1093
+#: ../src/guestfs.pod:1105
msgid ""
"The guest may be killed by L</guestfs_kill_subprocess>, or may die "
"asynchronously at any time (eg. due to some internal error), and that causes "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1097
+#: ../src/guestfs.pod:1109
msgid ""
"Configuration commands for qemu such as L</guestfs_add_drive> can only be "
"issued when in the CONFIG state."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1100
+#: ../src/guestfs.pod:1112
msgid ""
"The high-level API offers two calls that go from CONFIG through LAUNCHING to "
"READY. L</guestfs_launch> blocks until the child process is READY to accept "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1106
+#: ../src/guestfs.pod:1118
msgid ""
"High-level API actions such as L</guestfs_mount> can only be issued when in "
"the READY state. These high-level API calls block waiting for the command "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1114
+#: ../src/guestfs.pod:1126
msgid ""
"Finally, the child process sends asynchronous messages back to the main "
"program, such as kernel log messages. Mostly these are ignored by the high-"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1119
+#: ../src/guestfs.pod:1131
msgid "SETTING CALLBACKS TO HANDLE EVENTS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1121
+#: ../src/guestfs.pod:1133
msgid ""
"The child process generates events in some situations. Current events "
"include: receiving a log message, the child process exits."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1124
+#: ../src/guestfs.pod:1136
msgid ""
"Use the C<guestfs_set_*_callback> functions to set a callback for different "
"types of events."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1127
+#: ../src/guestfs.pod:1139
msgid ""
"Only I<one callback of each type> can be registered for each handle. "
"Calling C<guestfs_set_*_callback> again overwrites the previous callback of "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1132
+#: ../src/guestfs.pod:1144
msgid "guestfs_set_log_message_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1134
+#: ../src/guestfs.pod:1146
#, no-wrap
msgid ""
" typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1140
+#: ../src/guestfs.pod:1152
msgid ""
"The callback function C<cb> will be called whenever qemu or the guest writes "
"anything to the console."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1143
+#: ../src/guestfs.pod:1155
msgid "Use this function to capture kernel messages and similar."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1145
+#: ../src/guestfs.pod:1157
msgid ""
"Normally there is no log message handler, and log messages are just "
"discarded."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1148
+#: ../src/guestfs.pod:1160
msgid "guestfs_set_subprocess_quit_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1150
+#: ../src/guestfs.pod:1162
#, no-wrap
msgid ""
" typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1155
+#: ../src/guestfs.pod:1167
msgid ""
"The callback function C<cb> will be called when the child process quits, "
"either asynchronously or if killed by L</guestfs_kill_subprocess>. (This "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1160
+#: ../src/guestfs.pod:1172
msgid "guestfs_set_launch_done_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1162
+#: ../src/guestfs.pod:1174
#, no-wrap
msgid ""
" typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1167
+#: ../src/guestfs.pod:1179
msgid ""
"The callback function C<cb> will be called when the child process becomes "
"ready first time after it has been launched. (This corresponds to a "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1171
+#: ../src/guestfs.pod:1183
msgid "guestfs_set_close_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1173
+#: ../src/guestfs.pod:1185
#, no-wrap
msgid ""
" typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1178
+#: ../src/guestfs.pod:1190
msgid ""
"The callback function C<cb> will be called while the handle is being closed "
"(synchronously from L</guestfs_close>)."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1181
+#: ../src/guestfs.pod:1193
msgid ""
"Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
"handles that are open when the program exits. This means that this callback "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1189
+#: ../src/guestfs.pod:1201
msgid "guestfs_set_progress_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1191
+#: ../src/guestfs.pod:1203
#, no-wrap
msgid ""
" typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1198
+#: ../src/guestfs.pod:1210
msgid ""
"Some long-running operations can generate progress messages. If this "
"callback is registered, then it will be called each time a progress message "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1204
+#: ../src/guestfs.pod:1216
msgid ""
"The callback receives two numbers: C<position> and C<total>. The units of "
"C<total> are not defined, although for some operations C<total> may relate "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1210
+#: ../src/guestfs.pod:1222
msgid "The only defined and stable parts of the API are:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1216
+#: ../src/guestfs.pod:1228
msgid ""
"The callback can display to the user some type of progress bar or indicator "
"which shows the ratio of C<position>:C<total>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1221
+#: ../src/guestfs.pod:1233
msgid "0 E<lt>= C<position> E<lt>= C<total>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1225
+#: ../src/guestfs.pod:1237
msgid ""
"If any progress notification is sent during a call, then a final progress "
"notification is always sent when C<position> = C<total>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1228
+#: ../src/guestfs.pod:1240
msgid ""
"This is to simplify caller code, so callers can easily set the progress "
"indicator to \"100%\" at the end of the operation, without requiring special "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1234
+#: ../src/guestfs.pod:1246
msgid ""
"The callback also receives the procedure number and serial number of the "
"call. These are only useful for debugging protocol issues, and the callback "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1239
+#: ../src/guestfs.pod:1251
msgid "PRIVATE DATA AREA"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1241
+#: ../src/guestfs.pod:1253
msgid ""
"You can attach named pieces of private data to the libguestfs handle, and "
"fetch them by name for the lifetime of the handle. This is called the "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1245
+#: ../src/guestfs.pod:1257
msgid "To attach a named piece of data, use the following call:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1247
+#: ../src/guestfs.pod:1259
#, no-wrap
msgid ""
" void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1249
+#: ../src/guestfs.pod:1261
msgid ""
"C<key> is the name to associate with this data, and C<data> is an arbitrary "
"pointer (which can be C<NULL>). Any previous item with the same name is "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1253
+#: ../src/guestfs.pod:1265
msgid ""
"You can use any C<key> you want, but names beginning with an underscore "
"character are reserved for internal libguestfs purposes (for implementing "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1258
+#: ../src/guestfs.pod:1270
msgid "To retrieve the pointer, use:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1260
+#: ../src/guestfs.pod:1272
#, no-wrap
msgid ""
" void *guestfs_get_private (guestfs_h *g, const char *key);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1262
+#: ../src/guestfs.pod:1274
msgid ""
"This function returns C<NULL> if either no data is found associated with "
"C<key>, or if the user previously set the C<key>'s C<data> pointer to "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1266
+#: ../src/guestfs.pod:1278
msgid ""
"Libguestfs does not try to look at or interpret the C<data> pointer in any "
"way. As far as libguestfs is concerned, it need not be a valid pointer at "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1274
+#: ../src/guestfs.pod:1286
msgid ""
"The private data area is implemented using a hash table, and should be "
"reasonably efficient for moderate numbers of keys."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1277
+#: ../src/guestfs.pod:1289
msgid "BLOCK DEVICE NAMING"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1279
+#: ../src/guestfs.pod:1291
msgid ""
"In the kernel there is now quite a profusion of schemata for naming block "
"devices (in this context, by I<block device> I mean a physical or virtual "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1291
+#: ../src/guestfs.pod:1303
msgid ""
"As discussed above, libguestfs uses a qemu appliance running an embedded "
"Linux kernel to access block devices. We can run a variety of appliances "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1295
+#: ../src/guestfs.pod:1307
msgid ""
"This causes a problem for libguestfs because many API calls use device or "
"partition names. Working scripts and the recipe (example) scripts that we "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1300
+#: ../src/guestfs.pod:1312
msgid ""
"Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>. "
"Internally C</dev/sd*> names are translated, if necessary, to other names as "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1306
+#: ../src/guestfs.pod:1318
msgid ""
"Note that this I<only> applies to parameters. The L</guestfs_list_devices>, "
"L</guestfs_list_partitions> and similar calls return the true names of the "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1311
+#: ../src/guestfs.pod:1323
msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1313
+#: ../src/guestfs.pod:1325
msgid ""
"Usually this translation is transparent. However in some (very rare) cases "
"you may need to know the exact algorithm. Such cases include where you use "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1319
+#: ../src/guestfs.pod:1331
msgid ""
"The algorithm is applied only to I<parameters> which are known to be either "
"device or partition names. Return values from functions such as L</"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1327
+#: ../src/guestfs.pod:1339
msgid "Is the string a parameter which is a device or partition name?"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1331
+#: ../src/guestfs.pod:1343
msgid "Does the string begin with C</dev/sd>?"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1335
+#: ../src/guestfs.pod:1347
msgid ""
"Does the named device exist? If so, we use that device. However if I<not> "
"then we continue with this algorithm."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1340
+#: ../src/guestfs.pod:1352
msgid "Replace initial C</dev/sd> string with C</dev/hd>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1342
+#: ../src/guestfs.pod:1354
msgid "For example, change C</dev/sda2> to C</dev/hda2>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1344
+#: ../src/guestfs.pod:1356
msgid "If that named device exists, use it. If not, continue."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1348
+#: ../src/guestfs.pod:1360
msgid "Replace initial C</dev/sd> string with C</dev/vd>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1350
+#: ../src/guestfs.pod:1362
msgid "If that named device exists, use it. If not, return an error."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1354
+#: ../src/guestfs.pod:1366
msgid "PORTABILITY CONCERNS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1356
+#: ../src/guestfs.pod:1368
msgid ""
"Although the standard naming scheme and automatic translation is useful for "
"simple programs and guestfish scripts, for larger programs it is best not to "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1360
+#: ../src/guestfs.pod:1372
msgid ""
"Where possible for maximum future portability programs using libguestfs "
"should use these future-proof techniques:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1367
+#: ../src/guestfs.pod:1379
msgid ""
"Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
"device names, and then use those names directly."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1370
+#: ../src/guestfs.pod:1382
msgid ""
"Since those device names exist by definition, they will never be translated."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1375
+#: ../src/guestfs.pod:1387
msgid ""
"Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
"filesystem labels."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1380
+#: ../src/guestfs.pod:1392
msgid "INTERNALS"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1382
+#: ../src/guestfs.pod:1394
msgid "COMMUNICATION PROTOCOL"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1384
+#: ../src/guestfs.pod:1396
msgid ""
"Don't rely on using this protocol directly. This section documents how it "
"currently works, but it may change at any time."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1387
+#: ../src/guestfs.pod:1399
msgid ""
"The protocol used to talk between the library and the daemon running inside "
"the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1391
+#: ../src/guestfs.pod:1403
msgid ""
"The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
"this file is automatically generated)."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1394
+#: ../src/guestfs.pod:1406
msgid ""
"There are two broad cases, ordinary functions that don't have any C<FileIn> "
"and C<FileOut> parameters, which are handled with very simple request/reply "
msgstr ""
# type: =head3
-#: ../src/guestfs.pod:1401
+#: ../src/guestfs.pod:1413
msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1403
+#: ../src/guestfs.pod:1415
msgid "For ordinary functions, the request message is:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1405
+#: ../src/guestfs.pod:1417
#, no-wrap
msgid ""
" total length (header + arguments,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1410
+#: ../src/guestfs.pod:1422
msgid ""
"The total length field allows the daemon to allocate a fixed size buffer "
"into which it slurps the rest of the message. As a result, the total length "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1416
+#: ../src/guestfs.pod:1428
msgid ""
"Note also that many functions don't take any arguments, in which case the "
"C<guestfs_I<foo>_args> is completely omitted."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1419
+#: ../src/guestfs.pod:1431
msgid ""
"The header contains the procedure number (C<guestfs_proc>) which is how the "
"receiver knows what type of args structure to expect, or none at all."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1423
+#: ../src/guestfs.pod:1435
msgid "The reply message for ordinary functions is:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1425
+#: ../src/guestfs.pod:1437
#, no-wrap
msgid ""
" total length (header + ret,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1430
+#: ../src/guestfs.pod:1442
msgid ""
"As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
"functions that return no formal return values."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1433
+#: ../src/guestfs.pod:1445
msgid ""
"As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1436
+#: ../src/guestfs.pod:1448
msgid ""
"In the case of an error, a flag is set in the header, and the reply message "
"is slightly changed:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1439
+#: ../src/guestfs.pod:1451
#, no-wrap
msgid ""
" total length (header + error,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1444
+#: ../src/guestfs.pod:1456
msgid ""
"The C<guestfs_message_error> structure contains the error message as a "
"string."
msgstr ""
# type: =head3
-#: ../src/guestfs.pod:1447
+#: ../src/guestfs.pod:1459
msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1449
+#: ../src/guestfs.pod:1461
msgid ""
"A C<FileIn> parameter indicates that we transfer a file I<into> the guest. "
"The normal request message is sent (see above). However this is followed by "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1453
+#: ../src/guestfs.pod:1465
#, no-wrap
msgid ""
" total length (header + arguments,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1461
+#: ../src/guestfs.pod:1473
msgid "The \"sequence of chunks\" is:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1463
+#: ../src/guestfs.pod:1475
#, no-wrap
msgid ""
" length of chunk (not including length word itself)\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1471
+#: ../src/guestfs.pod:1483
msgid ""
"The final chunk has the C<data_len> field set to zero. Additionally a flag "
"is set in the final chunk to indicate either successful completion or early "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1475
+#: ../src/guestfs.pod:1487
msgid ""
"At time of writing there are no functions that have more than one FileIn "
"parameter. However this is (theoretically) supported, by sending the "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1480
+#: ../src/guestfs.pod:1492
msgid ""
"Both the library (sender) I<and> the daemon (receiver) may cancel the "
"transfer. The library does this by sending a chunk with a special flag set "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1486
+#: ../src/guestfs.pod:1498
msgid ""
"The daemon may also cancel. It does this by writing a special word "
"C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1495
+#: ../src/guestfs.pod:1507
msgid ""
"This protocol allows the transfer of arbitrary sized files (no 32 bit "
"limit), and also files where the size is not known in advance (eg. from "
msgstr ""
# type: =head3
-#: ../src/guestfs.pod:1501
+#: ../src/guestfs.pod:1513
msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1503
+#: ../src/guestfs.pod:1515
msgid ""
"The protocol for FileOut parameters is exactly the same as for FileIn "
"parameters, but with the roles of daemon and library reversed."
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1506
+#: ../src/guestfs.pod:1518
#, no-wrap
msgid ""
" total length (header + ret,\n"
msgstr ""
# type: =head3
-#: ../src/guestfs.pod:1514
+#: ../src/guestfs.pod:1526
msgid "INITIAL MESSAGE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1516
+#: ../src/guestfs.pod:1528
msgid ""
"Because the underlying channel (QEmu -net channel) doesn't have any sort of "
"connection control, when the daemon launches it sends an initial word "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1521
+#: ../src/guestfs.pod:1533
msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1523
+#: ../src/guestfs.pod:1535
msgid ""
"All high-level libguestfs actions are synchronous. If you want to use "
"libguestfs asynchronously then you must create a thread."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1526
+#: ../src/guestfs.pod:1538
msgid ""
"Only use the handle from a single thread. Either use the handle exclusively "
"from one thread, or provide your own mutex so that two threads cannot issue "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1530
+#: ../src/guestfs.pod:1542
msgid "QEMU WRAPPERS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1532
+#: ../src/guestfs.pod:1544
msgid ""
"If you want to compile your own qemu, run qemu from a non-standard location, "
"or pass extra arguments to qemu, then you can write a shell-script wrapper "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1536
+#: ../src/guestfs.pod:1548
msgid ""
"There is one important rule to remember: you I<must C<exec qemu>> as the "
"last command in the shell script (so that qemu replaces the shell and "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1541
+#: ../src/guestfs.pod:1553
msgid ""
"Here is an example of a wrapper, where I have built my own copy of qemu from "
"source:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1544
+#: ../src/guestfs.pod:1556
#, no-wrap
msgid ""
" #!/bin/sh -\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1548
+#: ../src/guestfs.pod:1560
msgid ""
"Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
"then use it by setting the LIBGUESTFS_QEMU environment variable. For "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1552
+#: ../src/guestfs.pod:1564
#, no-wrap
msgid ""
" LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1554
+#: ../src/guestfs.pod:1566
msgid ""
"Note that libguestfs also calls qemu with the -help and -version options in "
"order to determine features."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1557
+#: ../src/guestfs.pod:1569
msgid "LIBGUESTFS VERSION NUMBERS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1559
+#: ../src/guestfs.pod:1571
msgid ""
"Since April 2010, libguestfs has started to make separate development and "
"stable releases, along with corresponding branches in our git repository. "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1564
+#: ../src/guestfs.pod:1576
#, no-wrap
msgid ""
" even numbers for stable: 1.2.x, 1.4.x, ...\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1575
+#: ../src/guestfs.pod:1587
msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1577
+#: ../src/guestfs.pod:1589
msgid ""
"As time passes we cherry pick fixes from the development branch and backport "
"those into the stable branch, the effect being that the stable branch should "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1583
+#: ../src/guestfs.pod:1595
msgid "Our criteria for backporting changes are:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1589
+#: ../src/guestfs.pod:1601
msgid ""
"Documentation changes which don't affect any code are backported unless the "
"documentation refers to a future feature which is not in stable."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1595
+#: ../src/guestfs.pod:1607
msgid ""
"Bug fixes which are not controversial, fix obvious problems, and have been "
"well tested are backported."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1600
+#: ../src/guestfs.pod:1612
msgid ""
"Simple rearrangements of code which shouldn't affect how it works get "
"backported. This is so that the code in the two branches doesn't get too "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1606
+#: ../src/guestfs.pod:1618
msgid ""
"We I<don't> backport new features, new APIs, new tools etc, except in one "
"exceptional case: the new feature is required in order to implement an "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1612
+#: ../src/guestfs.pod:1624
msgid ""
"A new stable branch starts when we think the new features in development are "
"substantial and compelling enough over the current stable branch to warrant "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1620 ../fish/guestfish.pod:905
+#: ../src/guestfs.pod:1632 ../fish/guestfish.pod:905
#: ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:312
#: ../tools/virt-rescue.pl:226
msgid "ENVIRONMENT VARIABLES"
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1624 ../fish/guestfish.pod:925
+#: ../src/guestfs.pod:1636 ../fish/guestfish.pod:925
msgid "LIBGUESTFS_APPEND"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1626 ../fish/guestfish.pod:927
+#: ../src/guestfs.pod:1638 ../fish/guestfish.pod:927
msgid "Pass additional options to the guest kernel."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1628 ../fish/guestfish.pod:929
+#: ../src/guestfs.pod:1640 ../fish/guestfish.pod:929
msgid "LIBGUESTFS_DEBUG"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1630
+#: ../src/guestfs.pod:1642
msgid ""
"Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same "
"effect as calling C<guestfs_set_verbose (g, 1)>."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1633 ../fish/guestfish.pod:934
+#: ../src/guestfs.pod:1645 ../fish/guestfish.pod:934
msgid "LIBGUESTFS_MEMSIZE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1635 ../fish/guestfish.pod:936
+#: ../src/guestfs.pod:1647 ../fish/guestfish.pod:936
msgid ""
"Set the memory allocated to the qemu process, in megabytes. For example:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1638 ../fish/guestfish.pod:939
+#: ../src/guestfs.pod:1650 ../fish/guestfish.pod:939
#, no-wrap
msgid ""
" LIBGUESTFS_MEMSIZE=700\n"
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1640 ../fish/guestfish.pod:941
+#: ../src/guestfs.pod:1652 ../fish/guestfish.pod:941
msgid "LIBGUESTFS_PATH"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1642
+#: ../src/guestfs.pod:1654
msgid ""
"Set the path that libguestfs uses to search for kernel and initrd.img. See "
"the discussion of paths in section PATH above."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1645 ../fish/guestfish.pod:946
+#: ../src/guestfs.pod:1657 ../fish/guestfish.pod:946
msgid "LIBGUESTFS_QEMU"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1647 ../fish/guestfish.pod:948
+#: ../src/guestfs.pod:1659 ../fish/guestfish.pod:948
msgid ""
"Set the default qemu binary that libguestfs uses. If not set, then the qemu "
"which was found at compile time by the configure script is used."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1651
+#: ../src/guestfs.pod:1663
msgid "See also L</QEMU WRAPPERS> above."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1653 ../fish/guestfish.pod:952
+#: ../src/guestfs.pod:1665 ../fish/guestfish.pod:952
msgid "LIBGUESTFS_TRACE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1655
+#: ../src/guestfs.pod:1667
msgid ""
"Set C<LIBGUESTFS_TRACE=1> to enable command traces. This has the same "
"effect as calling C<guestfs_set_trace (g, 1)>."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1658 ../fish/guestfish.pod:961
+#: ../src/guestfs.pod:1670 ../fish/guestfish.pod:961
msgid "TMPDIR"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1660 ../fish/guestfish.pod:963
+#: ../src/guestfs.pod:1672 ../fish/guestfish.pod:963
msgid "Location of temporary directory, defaults to C</tmp>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1662 ../fish/guestfish.pod:965
+#: ../src/guestfs.pod:1674 ../fish/guestfish.pod:965
msgid ""
"If libguestfs was compiled to use the supermin appliance then each handle "
"will require rather a large amount of space in this directory for short "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1670 ../fish/guestfish.pod:1023
+#: ../src/guestfs.pod:1682 ../fish/guestfish.pod:1023
#: ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:178
#: ../inspector/virt-inspector.pl:846 ../tools/virt-cat.pl:163
#: ../tools/virt-df.pl:482 ../tools/virt-edit.pl:325
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1672
+#: ../src/guestfs.pod:1684
msgid ""
"L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-edit"
"(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1690
+#: ../src/guestfs.pod:1702
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:1697 ../tools/virt-make-fs.pl:541
+#: ../src/guestfs.pod:1709 ../tools/virt-make-fs.pl:541
#: ../tools/virt-win-reg.pl:476
msgid "BUGS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1699
+#: ../src/guestfs.pod:1711
msgid "To get a list of bugs against libguestfs use this link:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1701
+#: ../src/guestfs.pod:1713
msgid ""
"L<https://bugzilla.redhat.com/buglist.cgi?"
"component=libguestfs&product=Virtualization+Tools>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1703
+#: ../src/guestfs.pod:1715
msgid "To report a new bug against libguestfs use this link:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1705
+#: ../src/guestfs.pod:1717
msgid ""
"L<https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1707
+#: ../src/guestfs.pod:1719
msgid "When reporting a bug, please check:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1713
+#: ../src/guestfs.pod:1725
msgid "That the bug hasn't been reported already."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1717
+#: ../src/guestfs.pod:1729
msgid "That you are testing a recent version."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1721
+#: ../src/guestfs.pod:1733
msgid "Describe the bug accurately, and give a way to reproduce it."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1725
+#: ../src/guestfs.pod:1737
msgid ""
"Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
"bug report."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1730 ../fish/guestfish.pod:1039
+#: ../src/guestfs.pod:1742 ../fish/guestfish.pod:1039
#: ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:189
#: ../inspector/virt-inspector.pl:855
msgid "AUTHORS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1732 ../fish/guestfish.pod:1041
+#: ../src/guestfs.pod:1744 ../fish/guestfish.pod:1041
#: ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:191
msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1734 ../fish/guestfish.pod:1043
+#: ../src/guestfs.pod:1746 ../fish/guestfish.pod:1043
#: ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:193
#: ../inspector/virt-inspector.pl:861 ../tools/virt-cat.pl:177
#: ../tools/virt-df.pl:495 ../tools/virt-edit.pl:341
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1736 ../fish/guestfish.pod:1045
+#: ../src/guestfs.pod:1748 ../fish/guestfish.pod:1045
msgid "Copyright (C) 2009-2010 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1739
+#: ../src/guestfs.pod:1751
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 "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1744
+#: ../src/guestfs.pod:1756
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 "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1749
+#: ../src/guestfs.pod:1761
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, "
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: libguestfs 1.5.7\n"
+"Project-Id-Version: libguestfs 1.5.8\n"
"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
-"POT-Creation-Date: 2010-09-02 20:33+0200\n"
+"POT-Creation-Date: 2010-09-04 10:26+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
msgid ""
"Libguestfs is a library that can be linked with C and C++ management "
"programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
-"Haskell or C#). You can also use it from shell scripts or the command line."
+"PHP, Haskell or C#). You can also use it from shell scripts or the command "
+"line."
msgstr ""
# type: textblock
msgstr ""
# type: =item
-#: ../src/guestfs.pod:345 ../src/guestfs.pod:350 ../src/guestfs.pod:355 ../src/guestfs.pod:359 ../src/guestfs.pod:364 ../src/guestfs.pod:368 ../src/guestfs.pod:373 ../src/guestfs.pod:1214 ../src/guestfs.pod:1219 ../src/guestfs.pod:1223 ../src/guestfs.pod:1325 ../src/guestfs.pod:1329 ../src/guestfs.pod:1333 ../src/guestfs.pod:1338 ../src/guestfs.pod:1346 ../src/guestfs.pod:1365 ../src/guestfs.pod:1373 ../src/guestfs.pod:1587 ../src/guestfs.pod:1593 ../src/guestfs.pod:1598 ../src/guestfs.pod:1604 ../src/guestfs.pod:1711 ../src/guestfs.pod:1715 ../src/guestfs.pod:1719 ../src/guestfs.pod:1723 ../src/guestfs-actions.pod:14 ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:372 ../src/guestfs-actions.pod:380 ../src/guestfs-actions.pod:387 ../src/guestfs-actions.pod:394 ../src/guestfs-actions.pod:1257 ../src/guestfs-actions.pod:1261 ../src/guestfs-actions.pod:1265 ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:1281 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1299 ../src/guestfs-actions.pod:1303 ../src/guestfs-actions.pod:1426 ../src/guestfs-actions.pod:1430 ../src/guestfs-actions.pod:1435 ../src/guestfs-actions.pod:1440 ../src/guestfs-actions.pod:1492 ../src/guestfs-actions.pod:1496 ../src/guestfs-actions.pod:1501 ../fish/guestfish.pod:309 ../fish/guestfish.pod:313 ../fish/guestfish.pod:317 ../fish/guestfish.pod:321 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:300 ../fish/guestfish-actions.pod:308 ../fish/guestfish-actions.pod:315 ../fish/guestfish-actions.pod:322 ../fish/guestfish-actions.pod:998 ../fish/guestfish-actions.pod:1002 ../fish/guestfish-actions.pod:1006 ../fish/guestfish-actions.pod:1010 ../fish/guestfish-actions.pod:1018 ../fish/guestfish-actions.pod:1022 ../fish/guestfish-actions.pod:1026 ../fish/guestfish-actions.pod:1036 ../fish/guestfish-actions.pod:1040 ../fish/guestfish-actions.pod:1044 ../fish/guestfish-actions.pod:1134 ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:1148 ../fish/guestfish-actions.pod:1190 ../fish/guestfish-actions.pod:1194 ../fish/guestfish-actions.pod:1199 ../tools/virt-resize.pl:324 ../tools/virt-resize.pl:329 ../tools/virt-resize.pl:339
+#: ../src/guestfs.pod:345 ../src/guestfs.pod:350 ../src/guestfs.pod:355 ../src/guestfs.pod:359 ../src/guestfs.pod:364 ../src/guestfs.pod:368 ../src/guestfs.pod:373 ../src/guestfs.pod:1226 ../src/guestfs.pod:1231 ../src/guestfs.pod:1235 ../src/guestfs.pod:1337 ../src/guestfs.pod:1341 ../src/guestfs.pod:1345 ../src/guestfs.pod:1350 ../src/guestfs.pod:1358 ../src/guestfs.pod:1377 ../src/guestfs.pod:1385 ../src/guestfs.pod:1599 ../src/guestfs.pod:1605 ../src/guestfs.pod:1610 ../src/guestfs.pod:1616 ../src/guestfs.pod:1723 ../src/guestfs.pod:1727 ../src/guestfs.pod:1731 ../src/guestfs.pod:1735 ../src/guestfs-actions.pod:14 ../src/guestfs-actions.pod:21 ../src/guestfs-actions.pod:372 ../src/guestfs-actions.pod:380 ../src/guestfs-actions.pod:387 ../src/guestfs-actions.pod:394 ../src/guestfs-actions.pod:1257 ../src/guestfs-actions.pod:1261 ../src/guestfs-actions.pod:1265 ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:1281 ../src/guestfs-actions.pod:1285 ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1299 ../src/guestfs-actions.pod:1303 ../src/guestfs-actions.pod:1426 ../src/guestfs-actions.pod:1430 ../src/guestfs-actions.pod:1435 ../src/guestfs-actions.pod:1440 ../src/guestfs-actions.pod:1492 ../src/guestfs-actions.pod:1496 ../src/guestfs-actions.pod:1501 ../fish/guestfish.pod:309 ../fish/guestfish.pod:313 ../fish/guestfish.pod:317 ../fish/guestfish.pod:321 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:300 ../fish/guestfish-actions.pod:308 ../fish/guestfish-actions.pod:315 ../fish/guestfish-actions.pod:322 ../fish/guestfish-actions.pod:998 ../fish/guestfish-actions.pod:1002 ../fish/guestfish-actions.pod:1006 ../fish/guestfish-actions.pod:1010 ../fish/guestfish-actions.pod:1018 ../fish/guestfish-actions.pod:1022 ../fish/guestfish-actions.pod:1026 ../fish/guestfish-actions.pod:1036 ../fish/guestfish-actions.pod:1040 ../fish/guestfish-actions.pod:1044 ../fish/guestfish-actions.pod:1134 ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1143 ../fish/guestfish-actions.pod:1148 ../fish/guestfish-actions.pod:1190 ../fish/guestfish-actions.pod:1194 ../fish/guestfish-actions.pod:1199 ../tools/virt-resize.pl:324 ../tools/virt-resize.pl:329 ../tools/virt-resize.pl:339
msgid "*"
msgstr ""
# type: =item
#: ../src/guestfs.pod:629
-msgid "B<Python>"
+msgid "B<PHP>"
msgstr ""
# type: textblock
#: ../src/guestfs.pod:631
+msgid ""
+"For documentation see C<README-PHP> supplied with libguestfs sources or in "
+"the php-libguestfs package for your distribution."
+msgstr ""
+
+# type: textblock
+#: ../src/guestfs.pod:634
+msgid "The PHP binding only works correctly on 64 bit machines."
+msgstr ""
+
+# type: =item
+#: ../src/guestfs.pod:636
+msgid "B<Python>"
+msgstr ""
+
+# type: textblock
+#: ../src/guestfs.pod:638
msgid "For documentation do:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:633
+#: ../src/guestfs.pod:640
#, no-wrap
msgid ""
" $ python\n"
msgstr ""
# type: =item
-#: ../src/guestfs.pod:637
+#: ../src/guestfs.pod:644
msgid "B<Ruby>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:639
+#: ../src/guestfs.pod:646
msgid ""
"Use the Guestfs module. There is no Ruby-specific documentation, but you "
"can find examples written in Ruby in the libguestfs source."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:642
+#: ../src/guestfs.pod:649
msgid "B<shell scripts>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:644
+#: ../src/guestfs.pod:651
msgid "For documentation see L<guestfish(1)>."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:648
+#: ../src/guestfs.pod:655
msgid "LIBGUESTFS GOTCHAS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:650
+#: ../src/guestfs.pod:657
msgid ""
"L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
"system [...] that works in the way it is documented but is counterintuitive "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:654
+#: ../src/guestfs.pod:661
msgid ""
"Since we developed libguestfs and the associated tools, there are several "
"things we would have designed differently, but are now stuck with for "
msgstr ""
# type: =item
-#: ../src/guestfs.pod:662
+#: ../src/guestfs.pod:669
msgid "Autosync / forgetting to sync."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:664
+#: ../src/guestfs.pod:671
msgid ""
"When modifying a filesystem from C or another language, you B<must> unmount "
"all filesystems and call L</guestfs_sync> explicitly before you close the "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:668
+#: ../src/guestfs.pod:675
#, no-wrap
msgid ""
" guestfs_set_autosync (g, 1);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:670
+#: ../src/guestfs.pod:677
msgid ""
"to have the unmount/sync done automatically for you when the handle 'g' is "
"closed. (This feature is called \"autosync\", L</guestfs_set_autosync> "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:674
+#: ../src/guestfs.pod:681
msgid ""
"If you forget to do this, then it is entirely possible that your changes "
"won't be written out, or will be partially written, or (very rarely) that "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:678
+#: ../src/guestfs.pod:685
msgid ""
"Note that in L<guestfish(3)> autosync is the default. So quick and dirty "
"guestfish scripts that forget to sync will work just fine, which can make "
msgstr ""
# type: =item
-#: ../src/guestfs.pod:682
+#: ../src/guestfs.pod:689
msgid "Mount option C<-o sync> should not be the default."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:684
+#: ../src/guestfs.pod:691
msgid ""
"If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly. "
"However C<-o sync> does not add any reliability benefit, but does have a "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:688
+#: ../src/guestfs.pod:695
msgid ""
"The work around is to use L</guestfs_mount_options> and set the mount "
"options that you actually want to use."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:691
+#: ../src/guestfs.pod:698
msgid "Read-only should be the default."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:693
+#: ../src/guestfs.pod:700
msgid ""
"In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
"specify I<--rw> if you want to make changes to the image."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:696
+#: ../src/guestfs.pod:703
msgid "This would reduce the potential to corrupt live VM images."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:698
+#: ../src/guestfs.pod:705
msgid ""
"Note that many filesystems change the disk when you just mount and unmount, "
"even if you didn't perform any writes. You need to use "
msgstr ""
# type: =item
-#: ../src/guestfs.pod:702
+#: ../src/guestfs.pod:709
msgid "guestfish command line is hard to use."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:704
+#: ../src/guestfs.pod:711
msgid ""
"C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
"examination). It tries to run a guestfish command C<disk.img> which doesn't "
msgstr ""
# type: =item
-#: ../src/guestfs.pod:711
+#: ../src/guestfs.pod:718
msgid "guestfish megabyte modifiers don't work right on all commands"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:713
+#: ../src/guestfs.pod:720
msgid ""
"In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
"other modifiers). What guestfish actually does is to multiply the number "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:720
+#: ../src/guestfs.pod:727
msgid "The most common is L</guestfs_lvcreate>. The guestfish command:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:722
+#: ../src/guestfs.pod:729
#, no-wrap
msgid ""
" lvcreate LV VG 100M\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:724
+#: ../src/guestfs.pod:731
msgid ""
"does not do what you might expect. Instead because L</guestfs_lvcreate> is "
"already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:729
+#: ../src/guestfs.pod:736
msgid ""
"This could be fixed in the generator by specially marking parameters and "
"return values which take bytes or other units."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:732
+#: ../src/guestfs.pod:739
msgid "Library should return errno with error messages."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:734
+#: ../src/guestfs.pod:741
msgid ""
"It would be a nice-to-have to be able to get the original value of 'errno' "
"from inside the appliance along error paths (where set). Currently "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:740
+#: ../src/guestfs.pod:747
msgid ""
"In libguestfs 1.5.4, the protocol was changed so that the Linux errno is "
"sent back from the daemon."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:745
+#: ../src/guestfs.pod:752
msgid "PROTOCOL LIMITS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:747
+#: ../src/guestfs.pod:754
msgid ""
"Internally libguestfs uses a message-based protocol to pass API calls and "
"their responses to and from a small \"appliance\" (see L</INTERNALS> for "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:755
+#: ../src/guestfs.pod:762
msgid ""
"A simple call such as L</guestfs_cat> returns its result (the file data) in "
"a simple string. Because this string is at some point internally encoded as "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:761
+#: ../src/guestfs.pod:768
msgid ""
"In order to transfer large files into and out of the guest filesystem, you "
"need to use particular calls that support this. The sections L</UPLOADING> "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:765
+#: ../src/guestfs.pod:772
msgid ""
"You might also consider mounting the disk image using our FUSE filesystem "
"support (L<guestmount(1)>)."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:768
+#: ../src/guestfs.pod:775
msgid "KEYS AND PASSPHRASES"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:770
+#: ../src/guestfs.pod:777
msgid ""
"Certain libguestfs calls take a parameter that contains sensitive key "
"material, passed in as a C string."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:773
+#: ../src/guestfs.pod:780
msgid ""
"In the future we would hope to change the libguestfs implementation so that "
"keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:778
+#: ../src/guestfs.pod:785
msgid ""
"Therefore you should be aware that any key parameter you pass to libguestfs "
"might end up being written out to the swap partition. If this is a concern, "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:783
+#: ../src/guestfs.pod:790
msgid "CONNECTION MANAGEMENT"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:785
+#: ../src/guestfs.pod:792
msgid "guestfs_h *"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:787
+#: ../src/guestfs.pod:794
msgid ""
"C<guestfs_h> is the opaque type representing a connection handle. Create a "
"handle by calling L</guestfs_create>. Call L</guestfs_close> to free the "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:791
+#: ../src/guestfs.pod:798
msgid ""
"For information on using multiple handles and threads, see the section "
"L</MULTIPLE HANDLES AND MULTIPLE THREADS> below."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:794
+#: ../src/guestfs.pod:801
msgid "guestfs_create"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:796
+#: ../src/guestfs.pod:803
#, no-wrap
msgid ""
" guestfs_h *guestfs_create (void);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:798
+#: ../src/guestfs.pod:805
msgid "Create a connection handle."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:800
+#: ../src/guestfs.pod:807
msgid "You have to call L</guestfs_add_drive> on the handle at least once."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:802
+#: ../src/guestfs.pod:809
msgid ""
"This function returns a non-NULL pointer to a handle on success or NULL on "
"error."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:805
+#: ../src/guestfs.pod:812
msgid "After configuring the handle, you have to call L</guestfs_launch>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:807
+#: ../src/guestfs.pod:814
msgid ""
"You may also want to configure error handling for the handle. See L</ERROR "
"HANDLING> section below."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:810
+#: ../src/guestfs.pod:817
msgid "guestfs_close"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:812
+#: ../src/guestfs.pod:819
#, no-wrap
msgid ""
" void guestfs_close (guestfs_h *g);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:814
+#: ../src/guestfs.pod:821
msgid "This closes the connection handle and frees up all resources used."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:816
+#: ../src/guestfs.pod:823
msgid "ERROR HANDLING"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:818
+#: ../src/guestfs.pod:825
msgid ""
"The convention in all functions that return C<int> is that they return C<-1> "
"to indicate an error. You can get additional information on errors by "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:823
+#: ../src/guestfs.pod:830
msgid "The default error handler prints the information string to C<stderr>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:825
+#: ../src/guestfs.pod:832
msgid ""
"Out of memory errors are handled differently. The default action is to call "
"L<abort(3)>. If this is undesirable, then you can set a handler using "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:829
+#: ../src/guestfs.pod:836
msgid "guestfs_last_error"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:831
+#: ../src/guestfs.pod:838
#, no-wrap
msgid ""
" const char *guestfs_last_error (guestfs_h *g);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:833
+#: ../src/guestfs.pod:840
msgid ""
"This returns the last error message that happened on C<g>. If there has not "
"been an error since the handle was created, then this returns C<NULL>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:837
+#: ../src/guestfs.pod:844
msgid ""
"The lifetime of the returned string is until the next error occurs, or "
"L</guestfs_close> is called."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:840
+#: ../src/guestfs.pod:847
msgid ""
"The error string is not localized (ie. is always in English), because this "
"makes searching for error messages in search engines give the largest number "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:844
+#: ../src/guestfs.pod:851
msgid "guestfs_set_error_handler"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:846
+#: ../src/guestfs.pod:853
#, no-wrap
msgid ""
" typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:853
+#: ../src/guestfs.pod:860
msgid ""
"The callback C<cb> will be called if there is an error. The parameters "
"passed to the callback are an opaque data pointer and the error message "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:857
+#: ../src/guestfs.pod:864
msgid ""
"Note that the message string C<msg> is freed as soon as the callback "
"function returns, so if you want to stash it somewhere you must make your "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:861
+#: ../src/guestfs.pod:868
msgid "The default handler prints messages on C<stderr>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:863
+#: ../src/guestfs.pod:870
msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:865
+#: ../src/guestfs.pod:872
msgid "guestfs_get_error_handler"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:867
+#: ../src/guestfs.pod:874
#, no-wrap
msgid ""
" guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:870
+#: ../src/guestfs.pod:877
msgid "Returns the current error handler callback."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:872
+#: ../src/guestfs.pod:879
msgid "guestfs_set_out_of_memory_handler"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:874
+#: ../src/guestfs.pod:881
#, no-wrap
msgid ""
" typedef void (*guestfs_abort_cb) (void);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:878
+#: ../src/guestfs.pod:885
msgid ""
"The callback C<cb> will be called if there is an out of memory situation. "
"I<Note this callback must not return>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:881
+#: ../src/guestfs.pod:888
msgid "The default is to call L<abort(3)>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:883
+#: ../src/guestfs.pod:890
msgid "You cannot set C<cb> to C<NULL>. You can't ignore out of memory situations."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:886
+#: ../src/guestfs.pod:893
msgid "guestfs_get_out_of_memory_handler"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:888
+#: ../src/guestfs.pod:895
#, no-wrap
msgid ""
" guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:890
+#: ../src/guestfs.pod:897
msgid "This returns the current out of memory handler."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:892
+#: ../src/guestfs.pod:899
msgid "PATH"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:894
+#: ../src/guestfs.pod:901
msgid ""
"Libguestfs needs a kernel and initrd.img, which it finds by looking along an "
"internal path."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:897
+#: ../src/guestfs.pod:904
msgid ""
"By default it looks for these in the directory C<$libdir/guestfs> "
"(eg. C</usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:900
+#: ../src/guestfs.pod:907
msgid ""
"Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
"to change the directories that libguestfs will search in. The value is a "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:907
+#: ../src/guestfs.pod:914
msgid "HIGH-LEVEL API ACTIONS"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:909
+#: ../src/guestfs.pod:916
msgid "ABI GUARANTEE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:911
+#: ../src/guestfs.pod:918
msgid ""
"We guarantee the libguestfs ABI (binary interface), for public, high-level "
"actions as outlined in this section. Although we will deprecate some "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:917 ../fish/guestfish.pod:898
+#: ../src/guestfs.pod:924 ../fish/guestfish.pod:898
msgid "@ACTIONS@"
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:919
+#: ../src/guestfs.pod:926
msgid "STRUCTURES"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:921
+#: ../src/guestfs.pod:928
msgid "@STRUCTS@"
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:923
+#: ../src/guestfs.pod:930
msgid "AVAILABILITY"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:925
+#: ../src/guestfs.pod:932
msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:927
+#: ../src/guestfs.pod:934
msgid ""
"Using L</guestfs_available> you can test availability of the following "
"groups of functions. This test queries the appliance to see if the "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:932
+#: ../src/guestfs.pod:939
msgid "@AVAILABILITY@"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:934
+#: ../src/guestfs.pod:941
msgid "GUESTFISH supported COMMAND"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:936
+#: ../src/guestfs.pod:943
msgid ""
"In L<guestfish(3)> there is a handy interactive command C<supported> which "
"prints out the available groups and whether they are supported by this build "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:941
+#: ../src/guestfs.pod:948
msgid "SINGLE CALLS AT COMPILE TIME"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:943
+#: ../src/guestfs.pod:950
msgid ""
-"If you need to test whether a single libguestfs function is available at "
-"compile time, we recommend using build tools such as autoconf or cmake. For "
-"example in autotools you could use:"
+"Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
+"function, such as:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:948
+#: ../src/guestfs.pod:953
+#, no-wrap
+msgid ""
+" #define LIBGUESTFS_HAVE_DD 1\n"
+"\n"
+msgstr ""
+
+# type: textblock
+#: ../src/guestfs.pod:955
+msgid "if L</guestfs_dd> is available."
+msgstr ""
+
+# type: textblock
+#: ../src/guestfs.pod:957
+msgid ""
+"Before version 1.5.8, if you needed to test whether a single libguestfs "
+"function is available at compile time, we recommended using build tools such "
+"as autoconf or cmake. For example in autotools you could use:"
+msgstr ""
+
+# type: verbatim
+#: ../src/guestfs.pod:962
#, no-wrap
msgid ""
" AC_CHECK_LIB([guestfs],[guestfs_create])\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:951
+#: ../src/guestfs.pod:965
msgid ""
"which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
"in your program."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:954
+#: ../src/guestfs.pod:968
msgid "SINGLE CALLS AT RUN TIME"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:956
+#: ../src/guestfs.pod:970
msgid ""
"Testing at compile time doesn't guarantee that a function really exists in "
"the library. The reason is that you might be dynamically linked against a "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:963
+#: ../src/guestfs.pod:977
msgid ""
"You can use L<dlopen(3)> to test if a function is available at run time, as "
"in this example program (note that you still need the compile time check as "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:967
-#, no-wrap
-msgid ""
-" #include <config.h>\n"
-" \n"
-msgstr ""
-
-# type: verbatim
-#: ../src/guestfs.pod:969
+#: ../src/guestfs.pod:981
#, no-wrap
msgid ""
" #include <stdio.h>\n"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:975
+#: ../src/guestfs.pod:987
#, no-wrap
msgid ""
" main ()\n"
" {\n"
-" #ifdef HAVE_GUESTFS_DD\n"
+" #ifdef LIBGUESTFS_HAVE_DD\n"
" void *dl;\n"
" int has_function;\n"
" \n"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:981
+#: ../src/guestfs.pod:993
#, no-wrap
msgid ""
" /* Test if the function guestfs_dd is really available. */\n"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:990
+#: ../src/guestfs.pod:1002
#, no-wrap
msgid ""
" if (!has_function)\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1003
+#: ../src/guestfs.pod:1015
msgid ""
"You may think the above is an awful lot of hassle, and it is. There are "
"other ways outside of the C linking system to ensure that this kind of "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1008
+#: ../src/guestfs.pod:1020
#, no-wrap
msgid ""
" Requires: libguestfs >= 1.0.80\n"
msgstr ""
# type: =end
-#: ../src/guestfs.pod:1010 ../src/guestfs.pod:1015
+#: ../src/guestfs.pod:1022 ../src/guestfs.pod:1027
msgid "html"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1012
+#: ../src/guestfs.pod:1024
msgid ""
"<!-- old anchor for the next section --> <a "
"name=\"state_machine_and_low_level_event_api\"/>"
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1017
+#: ../src/guestfs.pod:1029
msgid "ARCHITECTURE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1019
+#: ../src/guestfs.pod:1031
msgid ""
"Internally, libguestfs is implemented by running an appliance (a special "
"type of small virtual machine) using L<qemu(1)>. Qemu runs as a child "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1023
+#: ../src/guestfs.pod:1035
#, no-wrap
msgid ""
" ___________________\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1043
+#: ../src/guestfs.pod:1055
msgid ""
"The library, linked to the main program, creates the child process and hence "
"the appliance in the L</guestfs_launch> function."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1046
+#: ../src/guestfs.pod:1058
msgid ""
"Inside the appliance is a Linux kernel and a complete stack of userspace "
"tools (such as LVM and ext2 programs) and a small controlling daemon called "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1055
+#: ../src/guestfs.pod:1067
msgid ""
"A common misunderstanding is that the appliance \"is\" the virtual machine. "
"Although the disk image you are attached to might also be used by some "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1062
+#: ../src/guestfs.pod:1074
msgid "STATE MACHINE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1064
+#: ../src/guestfs.pod:1076
msgid "libguestfs uses a state machine to model the child process:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1066
+#: ../src/guestfs.pod:1078
#, no-wrap
msgid ""
" |\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1088
+#: ../src/guestfs.pod:1100
msgid ""
"The normal transitions are (1) CONFIG (when the handle is created, but there "
"is no child process), (2) LAUNCHING (when the child process is booting up), "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1093
+#: ../src/guestfs.pod:1105
msgid ""
"The guest may be killed by L</guestfs_kill_subprocess>, or may die "
"asynchronously at any time (eg. due to some internal error), and that causes "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1097
+#: ../src/guestfs.pod:1109
msgid ""
"Configuration commands for qemu such as L</guestfs_add_drive> can only be "
"issued when in the CONFIG state."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1100
+#: ../src/guestfs.pod:1112
msgid ""
"The high-level API offers two calls that go from CONFIG through LAUNCHING to "
"READY. L</guestfs_launch> blocks until the child process is READY to accept "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1106
+#: ../src/guestfs.pod:1118
msgid ""
"High-level API actions such as L</guestfs_mount> can only be issued when in "
"the READY state. These high-level API calls block waiting for the command "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1114
+#: ../src/guestfs.pod:1126
msgid ""
"Finally, the child process sends asynchronous messages back to the main "
"program, such as kernel log messages. Mostly these are ignored by the "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1119
+#: ../src/guestfs.pod:1131
msgid "SETTING CALLBACKS TO HANDLE EVENTS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1121
+#: ../src/guestfs.pod:1133
msgid ""
"The child process generates events in some situations. Current events "
"include: receiving a log message, the child process exits."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1124
+#: ../src/guestfs.pod:1136
msgid ""
"Use the C<guestfs_set_*_callback> functions to set a callback for different "
"types of events."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1127
+#: ../src/guestfs.pod:1139
msgid ""
"Only I<one callback of each type> can be registered for each handle. "
"Calling C<guestfs_set_*_callback> again overwrites the previous callback of "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1132
+#: ../src/guestfs.pod:1144
msgid "guestfs_set_log_message_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1134
+#: ../src/guestfs.pod:1146
#, no-wrap
msgid ""
" typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1140
+#: ../src/guestfs.pod:1152
msgid ""
"The callback function C<cb> will be called whenever qemu or the guest writes "
"anything to the console."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1143
+#: ../src/guestfs.pod:1155
msgid "Use this function to capture kernel messages and similar."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1145
+#: ../src/guestfs.pod:1157
msgid ""
"Normally there is no log message handler, and log messages are just "
"discarded."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1148
+#: ../src/guestfs.pod:1160
msgid "guestfs_set_subprocess_quit_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1150
+#: ../src/guestfs.pod:1162
#, no-wrap
msgid ""
" typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1155
+#: ../src/guestfs.pod:1167
msgid ""
"The callback function C<cb> will be called when the child process quits, "
"either asynchronously or if killed by L</guestfs_kill_subprocess>. (This "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1160
+#: ../src/guestfs.pod:1172
msgid "guestfs_set_launch_done_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1162
+#: ../src/guestfs.pod:1174
#, no-wrap
msgid ""
" typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1167
+#: ../src/guestfs.pod:1179
msgid ""
"The callback function C<cb> will be called when the child process becomes "
"ready first time after it has been launched. (This corresponds to a "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1171
+#: ../src/guestfs.pod:1183
msgid "guestfs_set_close_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1173
+#: ../src/guestfs.pod:1185
#, no-wrap
msgid ""
" typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1178
+#: ../src/guestfs.pod:1190
msgid ""
"The callback function C<cb> will be called while the handle is being closed "
"(synchronously from L</guestfs_close>)."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1181
+#: ../src/guestfs.pod:1193
msgid ""
"Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
"handles that are open when the program exits. This means that this callback "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1189
+#: ../src/guestfs.pod:1201
msgid "guestfs_set_progress_callback"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1191
+#: ../src/guestfs.pod:1203
#, no-wrap
msgid ""
" typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1198
+#: ../src/guestfs.pod:1210
msgid ""
"Some long-running operations can generate progress messages. If this "
"callback is registered, then it will be called each time a progress message "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1204
+#: ../src/guestfs.pod:1216
msgid ""
"The callback receives two numbers: C<position> and C<total>. The units of "
"C<total> are not defined, although for some operations C<total> may relate "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1210
+#: ../src/guestfs.pod:1222
msgid "The only defined and stable parts of the API are:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1216
+#: ../src/guestfs.pod:1228
msgid ""
"The callback can display to the user some type of progress bar or indicator "
"which shows the ratio of C<position>:C<total>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1221
+#: ../src/guestfs.pod:1233
msgid "0 E<lt>= C<position> E<lt>= C<total>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1225
+#: ../src/guestfs.pod:1237
msgid ""
"If any progress notification is sent during a call, then a final progress "
"notification is always sent when C<position> = C<total>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1228
+#: ../src/guestfs.pod:1240
msgid ""
"This is to simplify caller code, so callers can easily set the progress "
"indicator to \"100%\" at the end of the operation, without requiring special "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1234
+#: ../src/guestfs.pod:1246
msgid ""
"The callback also receives the procedure number and serial number of the "
"call. These are only useful for debugging protocol issues, and the callback "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1239
+#: ../src/guestfs.pod:1251
msgid "PRIVATE DATA AREA"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1241
+#: ../src/guestfs.pod:1253
msgid ""
"You can attach named pieces of private data to the libguestfs handle, and "
"fetch them by name for the lifetime of the handle. This is called the "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1245
+#: ../src/guestfs.pod:1257
msgid "To attach a named piece of data, use the following call:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1247
+#: ../src/guestfs.pod:1259
#, no-wrap
msgid ""
" void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1249
+#: ../src/guestfs.pod:1261
msgid ""
"C<key> is the name to associate with this data, and C<data> is an arbitrary "
"pointer (which can be C<NULL>). Any previous item with the same name is "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1253
+#: ../src/guestfs.pod:1265
msgid ""
"You can use any C<key> you want, but names beginning with an underscore "
"character are reserved for internal libguestfs purposes (for implementing "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1258
+#: ../src/guestfs.pod:1270
msgid "To retrieve the pointer, use:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1260
+#: ../src/guestfs.pod:1272
#, no-wrap
msgid ""
" void *guestfs_get_private (guestfs_h *g, const char *key);\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1262
+#: ../src/guestfs.pod:1274
msgid ""
"This function returns C<NULL> if either no data is found associated with "
"C<key>, or if the user previously set the C<key>'s C<data> pointer to "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1266
+#: ../src/guestfs.pod:1278
msgid ""
"Libguestfs does not try to look at or interpret the C<data> pointer in any "
"way. As far as libguestfs is concerned, it need not be a valid pointer at "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1274
+#: ../src/guestfs.pod:1286
msgid ""
"The private data area is implemented using a hash table, and should be "
"reasonably efficient for moderate numbers of keys."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1277
+#: ../src/guestfs.pod:1289
msgid "BLOCK DEVICE NAMING"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1279
+#: ../src/guestfs.pod:1291
msgid ""
"In the kernel there is now quite a profusion of schemata for naming block "
"devices (in this context, by I<block device> I mean a physical or virtual "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1291
+#: ../src/guestfs.pod:1303
msgid ""
"As discussed above, libguestfs uses a qemu appliance running an embedded "
"Linux kernel to access block devices. We can run a variety of appliances "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1295
+#: ../src/guestfs.pod:1307
msgid ""
"This causes a problem for libguestfs because many API calls use device or "
"partition names. Working scripts and the recipe (example) scripts that we "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1300
+#: ../src/guestfs.pod:1312
msgid ""
"Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>. "
"Internally C</dev/sd*> names are translated, if necessary, to other names as "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1306
+#: ../src/guestfs.pod:1318
msgid ""
"Note that this I<only> applies to parameters. The L</guestfs_list_devices>, "
"L</guestfs_list_partitions> and similar calls return the true names of the "
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1311
+#: ../src/guestfs.pod:1323
msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1313
+#: ../src/guestfs.pod:1325
msgid ""
"Usually this translation is transparent. However in some (very rare) cases "
"you may need to know the exact algorithm. Such cases include where you use "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1319
+#: ../src/guestfs.pod:1331
msgid ""
"The algorithm is applied only to I<parameters> which are known to be either "
"device or partition names. Return values from functions such as "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1327
+#: ../src/guestfs.pod:1339
msgid "Is the string a parameter which is a device or partition name?"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1331
+#: ../src/guestfs.pod:1343
msgid "Does the string begin with C</dev/sd>?"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1335
+#: ../src/guestfs.pod:1347
msgid ""
"Does the named device exist? If so, we use that device. However if I<not> "
"then we continue with this algorithm."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1340
+#: ../src/guestfs.pod:1352
msgid "Replace initial C</dev/sd> string with C</dev/hd>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1342
+#: ../src/guestfs.pod:1354
msgid "For example, change C</dev/sda2> to C</dev/hda2>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1344
+#: ../src/guestfs.pod:1356
msgid "If that named device exists, use it. If not, continue."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1348
+#: ../src/guestfs.pod:1360
msgid "Replace initial C</dev/sd> string with C</dev/vd>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1350
+#: ../src/guestfs.pod:1362
msgid "If that named device exists, use it. If not, return an error."
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1354
+#: ../src/guestfs.pod:1366
msgid "PORTABILITY CONCERNS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1356
+#: ../src/guestfs.pod:1368
msgid ""
"Although the standard naming scheme and automatic translation is useful for "
"simple programs and guestfish scripts, for larger programs it is best not to "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1360
+#: ../src/guestfs.pod:1372
msgid ""
"Where possible for maximum future portability programs using libguestfs "
"should use these future-proof techniques:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1367
+#: ../src/guestfs.pod:1379
msgid ""
"Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
"device names, and then use those names directly."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1370
+#: ../src/guestfs.pod:1382
msgid "Since those device names exist by definition, they will never be translated."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1375
+#: ../src/guestfs.pod:1387
msgid ""
"Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
"filesystem labels."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1380
+#: ../src/guestfs.pod:1392
msgid "INTERNALS"
msgstr ""
# type: =head2
-#: ../src/guestfs.pod:1382
+#: ../src/guestfs.pod:1394
msgid "COMMUNICATION PROTOCOL"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1384
+#: ../src/guestfs.pod:1396
msgid ""
"Don't rely on using this protocol directly. This section documents how it "
"currently works, but it may change at any time."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1387
+#: ../src/guestfs.pod:1399
msgid ""
"The protocol used to talk between the library and the daemon running inside "
"the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1391
+#: ../src/guestfs.pod:1403
msgid ""
"The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
"this file is automatically generated)."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1394
+#: ../src/guestfs.pod:1406
msgid ""
"There are two broad cases, ordinary functions that don't have any C<FileIn> "
"and C<FileOut> parameters, which are handled with very simple request/reply "
msgstr ""
# type: =head3
-#: ../src/guestfs.pod:1401
+#: ../src/guestfs.pod:1413
msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1403
+#: ../src/guestfs.pod:1415
msgid "For ordinary functions, the request message is:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1405
+#: ../src/guestfs.pod:1417
#, no-wrap
msgid ""
" total length (header + arguments,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1410
+#: ../src/guestfs.pod:1422
msgid ""
"The total length field allows the daemon to allocate a fixed size buffer "
"into which it slurps the rest of the message. As a result, the total length "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1416
+#: ../src/guestfs.pod:1428
msgid ""
"Note also that many functions don't take any arguments, in which case the "
"C<guestfs_I<foo>_args> is completely omitted."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1419
+#: ../src/guestfs.pod:1431
msgid ""
"The header contains the procedure number (C<guestfs_proc>) which is how the "
"receiver knows what type of args structure to expect, or none at all."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1423
+#: ../src/guestfs.pod:1435
msgid "The reply message for ordinary functions is:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1425
+#: ../src/guestfs.pod:1437
#, no-wrap
msgid ""
" total length (header + ret,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1430
+#: ../src/guestfs.pod:1442
msgid ""
"As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
"functions that return no formal return values."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1433
+#: ../src/guestfs.pod:1445
msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1436
+#: ../src/guestfs.pod:1448
msgid ""
"In the case of an error, a flag is set in the header, and the reply message "
"is slightly changed:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1439
+#: ../src/guestfs.pod:1451
#, no-wrap
msgid ""
" total length (header + error,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1444
+#: ../src/guestfs.pod:1456
msgid ""
"The C<guestfs_message_error> structure contains the error message as a "
"string."
msgstr ""
# type: =head3
-#: ../src/guestfs.pod:1447
+#: ../src/guestfs.pod:1459
msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1449
+#: ../src/guestfs.pod:1461
msgid ""
"A C<FileIn> parameter indicates that we transfer a file I<into> the guest. "
"The normal request message is sent (see above). However this is followed by "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1453
+#: ../src/guestfs.pod:1465
#, no-wrap
msgid ""
" total length (header + arguments,\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1461
+#: ../src/guestfs.pod:1473
msgid "The \"sequence of chunks\" is:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1463
+#: ../src/guestfs.pod:1475
#, no-wrap
msgid ""
" length of chunk (not including length word itself)\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1471
+#: ../src/guestfs.pod:1483
msgid ""
"The final chunk has the C<data_len> field set to zero. Additionally a flag "
"is set in the final chunk to indicate either successful completion or early "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1475
+#: ../src/guestfs.pod:1487
msgid ""
"At time of writing there are no functions that have more than one FileIn "
"parameter. However this is (theoretically) supported, by sending the "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1480
+#: ../src/guestfs.pod:1492
msgid ""
"Both the library (sender) I<and> the daemon (receiver) may cancel the "
"transfer. The library does this by sending a chunk with a special flag set "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1486
+#: ../src/guestfs.pod:1498
msgid ""
"The daemon may also cancel. It does this by writing a special word "
"C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1495
+#: ../src/guestfs.pod:1507
msgid ""
"This protocol allows the transfer of arbitrary sized files (no 32 bit "
"limit), and also files where the size is not known in advance (eg. from "
msgstr ""
# type: =head3
-#: ../src/guestfs.pod:1501
+#: ../src/guestfs.pod:1513
msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1503
+#: ../src/guestfs.pod:1515
msgid ""
"The protocol for FileOut parameters is exactly the same as for FileIn "
"parameters, but with the roles of daemon and library reversed."
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1506
+#: ../src/guestfs.pod:1518
#, no-wrap
msgid ""
" total length (header + ret,\n"
msgstr ""
# type: =head3
-#: ../src/guestfs.pod:1514
+#: ../src/guestfs.pod:1526
msgid "INITIAL MESSAGE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1516
+#: ../src/guestfs.pod:1528
msgid ""
"Because the underlying channel (QEmu -net channel) doesn't have any sort of "
"connection control, when the daemon launches it sends an initial word "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1521
+#: ../src/guestfs.pod:1533
msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1523
+#: ../src/guestfs.pod:1535
msgid ""
"All high-level libguestfs actions are synchronous. If you want to use "
"libguestfs asynchronously then you must create a thread."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1526
+#: ../src/guestfs.pod:1538
msgid ""
"Only use the handle from a single thread. Either use the handle exclusively "
"from one thread, or provide your own mutex so that two threads cannot issue "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1530
+#: ../src/guestfs.pod:1542
msgid "QEMU WRAPPERS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1532
+#: ../src/guestfs.pod:1544
msgid ""
"If you want to compile your own qemu, run qemu from a non-standard location, "
"or pass extra arguments to qemu, then you can write a shell-script wrapper "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1536
+#: ../src/guestfs.pod:1548
msgid ""
"There is one important rule to remember: you I<must C<exec qemu>> as the "
"last command in the shell script (so that qemu replaces the shell and "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1541
+#: ../src/guestfs.pod:1553
msgid ""
"Here is an example of a wrapper, where I have built my own copy of qemu from "
"source:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1544
+#: ../src/guestfs.pod:1556
#, no-wrap
msgid ""
" #!/bin/sh -\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1548
+#: ../src/guestfs.pod:1560
msgid ""
"Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
"then use it by setting the LIBGUESTFS_QEMU environment variable. For "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1552
+#: ../src/guestfs.pod:1564
#, no-wrap
msgid ""
" LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1554
+#: ../src/guestfs.pod:1566
msgid ""
"Note that libguestfs also calls qemu with the -help and -version options in "
"order to determine features."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1557
+#: ../src/guestfs.pod:1569
msgid "LIBGUESTFS VERSION NUMBERS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1559
+#: ../src/guestfs.pod:1571
msgid ""
"Since April 2010, libguestfs has started to make separate development and "
"stable releases, along with corresponding branches in our git repository. "
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1564
+#: ../src/guestfs.pod:1576
#, no-wrap
msgid ""
" even numbers for stable: 1.2.x, 1.4.x, ...\n"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1575
+#: ../src/guestfs.pod:1587
msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1577
+#: ../src/guestfs.pod:1589
msgid ""
"As time passes we cherry pick fixes from the development branch and backport "
"those into the stable branch, the effect being that the stable branch should "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1583
+#: ../src/guestfs.pod:1595
msgid "Our criteria for backporting changes are:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1589
+#: ../src/guestfs.pod:1601
msgid ""
"Documentation changes which don't affect any code are backported unless the "
"documentation refers to a future feature which is not in stable."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1595
+#: ../src/guestfs.pod:1607
msgid ""
"Bug fixes which are not controversial, fix obvious problems, and have been "
"well tested are backported."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1600
+#: ../src/guestfs.pod:1612
msgid ""
"Simple rearrangements of code which shouldn't affect how it works get "
"backported. This is so that the code in the two branches doesn't get too "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1606
+#: ../src/guestfs.pod:1618
msgid ""
"We I<don't> backport new features, new APIs, new tools etc, except in one "
"exceptional case: the new feature is required in order to implement an "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1612
+#: ../src/guestfs.pod:1624
msgid ""
"A new stable branch starts when we think the new features in development are "
"substantial and compelling enough over the current stable branch to warrant "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1620 ../fish/guestfish.pod:905 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:312 ../tools/virt-rescue.pl:226
+#: ../src/guestfs.pod:1632 ../fish/guestfish.pod:905 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:312 ../tools/virt-rescue.pl:226
msgid "ENVIRONMENT VARIABLES"
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1624 ../fish/guestfish.pod:925
+#: ../src/guestfs.pod:1636 ../fish/guestfish.pod:925
msgid "LIBGUESTFS_APPEND"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1626 ../fish/guestfish.pod:927
+#: ../src/guestfs.pod:1638 ../fish/guestfish.pod:927
msgid "Pass additional options to the guest kernel."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1628 ../fish/guestfish.pod:929
+#: ../src/guestfs.pod:1640 ../fish/guestfish.pod:929
msgid "LIBGUESTFS_DEBUG"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1630
+#: ../src/guestfs.pod:1642
msgid ""
"Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages. This has the same "
"effect as calling C<guestfs_set_verbose (g, 1)>."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1633 ../fish/guestfish.pod:934
+#: ../src/guestfs.pod:1645 ../fish/guestfish.pod:934
msgid "LIBGUESTFS_MEMSIZE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1635 ../fish/guestfish.pod:936
+#: ../src/guestfs.pod:1647 ../fish/guestfish.pod:936
msgid "Set the memory allocated to the qemu process, in megabytes. For example:"
msgstr ""
# type: verbatim
-#: ../src/guestfs.pod:1638 ../fish/guestfish.pod:939
+#: ../src/guestfs.pod:1650 ../fish/guestfish.pod:939
#, no-wrap
msgid ""
" LIBGUESTFS_MEMSIZE=700\n"
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1640 ../fish/guestfish.pod:941
+#: ../src/guestfs.pod:1652 ../fish/guestfish.pod:941
msgid "LIBGUESTFS_PATH"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1642
+#: ../src/guestfs.pod:1654
msgid ""
"Set the path that libguestfs uses to search for kernel and initrd.img. See "
"the discussion of paths in section PATH above."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1645 ../fish/guestfish.pod:946
+#: ../src/guestfs.pod:1657 ../fish/guestfish.pod:946
msgid "LIBGUESTFS_QEMU"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1647 ../fish/guestfish.pod:948
+#: ../src/guestfs.pod:1659 ../fish/guestfish.pod:948
msgid ""
"Set the default qemu binary that libguestfs uses. If not set, then the qemu "
"which was found at compile time by the configure script is used."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1651
+#: ../src/guestfs.pod:1663
msgid "See also L</QEMU WRAPPERS> above."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1653 ../fish/guestfish.pod:952
+#: ../src/guestfs.pod:1665 ../fish/guestfish.pod:952
msgid "LIBGUESTFS_TRACE"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1655
+#: ../src/guestfs.pod:1667
msgid ""
"Set C<LIBGUESTFS_TRACE=1> to enable command traces. This has the same "
"effect as calling C<guestfs_set_trace (g, 1)>."
msgstr ""
# type: =item
-#: ../src/guestfs.pod:1658 ../fish/guestfish.pod:961
+#: ../src/guestfs.pod:1670 ../fish/guestfish.pod:961
msgid "TMPDIR"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1660 ../fish/guestfish.pod:963
+#: ../src/guestfs.pod:1672 ../fish/guestfish.pod:963
msgid "Location of temporary directory, defaults to C</tmp>."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1662 ../fish/guestfish.pod:965
+#: ../src/guestfs.pod:1674 ../fish/guestfish.pod:965
msgid ""
"If libguestfs was compiled to use the supermin appliance then each handle "
"will require rather a large amount of space in this directory for short "
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1670 ../fish/guestfish.pod:1023 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:178 ../inspector/virt-inspector.pl:846 ../tools/virt-cat.pl:163 ../tools/virt-df.pl:482 ../tools/virt-edit.pl:325 ../tools/virt-list-filesystems.pl:191 ../tools/virt-list-partitions.pl:229 ../tools/virt-ls.pl:210 ../tools/virt-make-fs.pl:527 ../tools/virt-rescue.pl:231 ../tools/virt-resize.pl:1390 ../tools/virt-tar.pl:257 ../tools/virt-win-reg.pl:461
+#: ../src/guestfs.pod:1682 ../fish/guestfish.pod:1023 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:178 ../inspector/virt-inspector.pl:846 ../tools/virt-cat.pl:163 ../tools/virt-df.pl:482 ../tools/virt-edit.pl:325 ../tools/virt-list-filesystems.pl:191 ../tools/virt-list-partitions.pl:229 ../tools/virt-ls.pl:210 ../tools/virt-make-fs.pl:527 ../tools/virt-rescue.pl:231 ../tools/virt-resize.pl:1390 ../tools/virt-tar.pl:257 ../tools/virt-win-reg.pl:461
msgid "SEE ALSO"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1672
+#: ../src/guestfs.pod:1684
msgid ""
"L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-df(1)>, "
"L<virt-edit(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1690
+#: ../src/guestfs.pod:1702
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:1697 ../tools/virt-make-fs.pl:541 ../tools/virt-win-reg.pl:476
+#: ../src/guestfs.pod:1709 ../tools/virt-make-fs.pl:541 ../tools/virt-win-reg.pl:476
msgid "BUGS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1699
+#: ../src/guestfs.pod:1711
msgid "To get a list of bugs against libguestfs use this link:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1701
+#: ../src/guestfs.pod:1713
msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1703
+#: ../src/guestfs.pod:1715
msgid "To report a new bug against libguestfs use this link:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1705
+#: ../src/guestfs.pod:1717
msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1707
+#: ../src/guestfs.pod:1719
msgid "When reporting a bug, please check:"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1713
+#: ../src/guestfs.pod:1725
msgid "That the bug hasn't been reported already."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1717
+#: ../src/guestfs.pod:1729
msgid "That you are testing a recent version."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1721
+#: ../src/guestfs.pod:1733
msgid "Describe the bug accurately, and give a way to reproduce it."
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1725
+#: ../src/guestfs.pod:1737
msgid ""
"Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
"bug report."
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1730 ../fish/guestfish.pod:1039 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:189 ../inspector/virt-inspector.pl:855
+#: ../src/guestfs.pod:1742 ../fish/guestfish.pod:1039 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:189 ../inspector/virt-inspector.pl:855
msgid "AUTHORS"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1732 ../fish/guestfish.pod:1041 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:191
+#: ../src/guestfs.pod:1744 ../fish/guestfish.pod:1041 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:191
msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
msgstr ""
# type: =head1
-#: ../src/guestfs.pod:1734 ../fish/guestfish.pod:1043 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:193 ../inspector/virt-inspector.pl:861 ../tools/virt-cat.pl:177 ../tools/virt-df.pl:495 ../tools/virt-edit.pl:341 ../tools/virt-list-filesystems.pl:207 ../tools/virt-list-partitions.pl:244 ../tools/virt-ls.pl:225 ../tools/virt-make-fs.pl:556 ../tools/virt-rescue.pl:245 ../tools/virt-resize.pl:1411 ../tools/virt-tar.pl:272 ../tools/virt-win-reg.pl:491
+#: ../src/guestfs.pod:1746 ../fish/guestfish.pod:1043 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:193 ../inspector/virt-inspector.pl:861 ../tools/virt-cat.pl:177 ../tools/virt-df.pl:495 ../tools/virt-edit.pl:341 ../tools/virt-list-filesystems.pl:207 ../tools/virt-list-partitions.pl:244 ../tools/virt-ls.pl:225 ../tools/virt-make-fs.pl:556 ../tools/virt-rescue.pl:245 ../tools/virt-resize.pl:1411 ../tools/virt-tar.pl:272 ../tools/virt-win-reg.pl:491
msgid "COPYRIGHT"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1736 ../fish/guestfish.pod:1045
+#: ../src/guestfs.pod:1748 ../fish/guestfish.pod:1045
msgid "Copyright (C) 2009-2010 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1739
+#: ../src/guestfs.pod:1751
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 "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1744
+#: ../src/guestfs.pod:1756
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 "
msgstr ""
# type: textblock
-#: ../src/guestfs.pod:1749
+#: ../src/guestfs.pod:1761
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, "
"Project-Id-Version: libguestfs.master\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: \n"
"Last-Translator: Héctor Daniel Cabrera <logan@fedoraproject.org>\n"
"Language-Team: Fedora Spanish <trans-es@lists.fedoraproject.org>\n"
"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: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-02-02 13:45+0530\n"
"Last-Translator: Sweta Kothari <swkothar@redhat.com>\n"
"Language-Team: Gujarati\n"
"Project-Id-Version: libguestfs.master.libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-02-16 12:57+0530\n"
"Last-Translator: Rajesh Ranjan <rranjan@redhat.com>\n"
"Language-Team: Hindi <Red Hat>\n"
"Project-Id-Version: libguestfs 1.0.83\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-02-24 11:56+0530\n"
"Last-Translator: Shankar Prasad <svenkate@redhat.com>\n"
"Language-Team: kn-IN <>\n"
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: libguestfs 1.5.7\n"
+"Project-Id-Version: libguestfs 1.5.8\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Project-Id-Version: libguestfs.master.libguestfs.ml\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-02-02 18:35+0530\n"
"Last-Translator: Ani Peter | അനി പീറ്റര് <apeter@redhat.com>\n"
"Language-Team: Swathanthra Malayalam Computing | സ്വതന്ത്ര മലയാളം കമ്പ്യൂട്ടിങ് <smc-"
"Project-Id-Version: mr\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-02-03 19:10+0530\n"
"Last-Translator: Sandeep Shedmake <sshedmak@redhat.com>\n"
"Language-Team: Marathi <fedora-trans-mr@redhat.com>\n"
msgid ""
msgstr ""
"Project-Id-Version: libguestfs 1.5.4\n"
-"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?component=li"
-"bguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-08-24 13:09+0100\n"
+"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
+"component=libguestfs&product=Virtualization+Tools\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-09-02 15:28+0200\n"
"Last-Translator: Geert Warrink <geert.warrink@onsnet.nu>\n"
"Language-Team: Fedora\n"
-"Language: nl\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
+"Language: nl\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"X-Generator: Virtaal 0.6.1\n"
msgid "use '%s filename' to edit a file\n"
msgstr "gebruik '%s bestandsnaam' om een bestand te bewerken\n"
-#: fish/fish.c:103 fuse/guestmount.c:879
+#: fish/fish.c:111 fuse/guestmount.c:880
#, c-format
msgid "Try `%s --help' for more information.\n"
msgstr "Probeer `%s --help' voor meer informatie\n"
-#: fish/fish.c:107
-#, c-format
+#: fish/fish.c:115
+#, fuzzy, c-format
msgid ""
"%s: guest filesystem shell\n"
"%s lets you edit virtual machine filesystems\n"
" -m|--mount dev[:mnt] Mount dev on mnt (if omitted, /)\n"
" -n|--no-sync Don't autosync\n"
" -N|--new type Create prepared disk (test1.img, ...)\n"
+" --progress-bars Enable progress bars even when not interactive\n"
+" --no-progress-bars Disable progress bars\n"
" --remote[=pid] Send commands to remote %s\n"
" -r|--ro Mount read-only\n"
" --selinux Enable SELinux support\n"
" -V|--version Laat versie zien en sluit af\n"
"Voor meer informatie, bekijk de man pagina %s(1).\n"
-#: fish/fish.c:207 fuse/guestmount.c:976
+#: fish/fish.c:221 fuse/guestmount.c:977
#, c-format
msgid "guestfs_create: failed to create handle\n"
msgstr "guestfs_create: hendel aanmaken mislukte\n"
-#: fish/fish.c:246
+#: fish/fish.c:260
#, c-format
msgid "%s: --listen=PID: PID was not a number: %s\n"
msgstr "%s: --listen=PID: PID was geen getal: %s\n"
-#: fish/fish.c:253
+#: fish/fish.c:267
#, c-format
msgid ""
"%s: remote: $GUESTFISH_PID must be set to the PID of the remote process\n"
-msgstr "%s: remote: $GUESTFISH_PID moet ingesteld worden op de PID van het proces op "
+msgstr ""
+"%s: remote: $GUESTFISH_PID moet ingesteld worden op de PID van het proces op "
"afstand\n"
-#: fish/fish.c:264 fuse/guestmount.c:1021
+#: fish/fish.c:282 fuse/guestmount.c:1022
#, c-format
msgid "%s: unknown long option: %s (%d)\n"
msgstr "%s: onbekende lange optie: %s (%d)\n"
-#: fish/fish.c:330
+#: fish/fish.c:348
#, c-format
msgid "%s: only one -f parameter can be given\n"
msgstr "%s: er kan slechts een -f parameter opgegeven worden\n"
-#: fish/fish.c:463
+#: fish/fish.c:484
#, c-format
msgid "%s: cannot use --listen and --remote options at the same time\n"
-msgstr "%s: de --listen en --remote opties kunnen niet tegelijkertijd gebruikt "
+msgstr ""
+"%s: de --listen en --remote opties kunnen niet tegelijkertijd gebruikt "
"worden\n"
-#: fish/fish.c:471
+#: fish/fish.c:492
#, c-format
msgid "%s: extra parameters on the command line with --listen flag\n"
msgstr "%s: extra parameters op de commando regel met --listen vlag\n"
-#: fish/fish.c:477
+#: fish/fish.c:498
#, c-format
msgid "%s: cannot use --listen and --file options at the same time\n"
-msgstr "%s: de --listen en --file opties kunnen niet tegelijkertijd gebruikt worden\n"
+msgstr ""
+"%s: de --listen en --file opties kunnen niet tegelijkertijd gebruikt worden\n"
+
+#: fish/fish.c:555
+#, c-format
+msgid "guestfish: could not access termcap or terminfo database.\n"
+msgstr ""
+
+#: fish/fish.c:559
+#, c-format
+msgid "guestfish: terminal type \"%s\" not defined.\n"
+msgstr ""
-#: fish/fish.c:553
+#: fish/fish.c:612
#, c-format
msgid "guestfish: too many drives added on the command line\n"
msgstr "guestfish: te veel schijven toegevoegd op de commando regel\n"
-#: fish/fish.c:685
+#: fish/fish.c:744
#, c-format
msgid ""
"\n"
" 'quit' om de shell te verlaten\n"
"\n"
-#: fish/fish.c:772
+#: fish/fish.c:831
#, c-format
msgid "%s: unterminated double quote\n"
msgstr "%s: niet afgesloten dubbel aanhalingsteken\n"
-#: fish/fish.c:778 fish/fish.c:795
+#: fish/fish.c:837 fish/fish.c:854
#, c-format
msgid "%s: command arguments not separated by whitespace\n"
msgstr "%s: commando argumenten niet gescheiden door spaties\n"
-#: fish/fish.c:789
+#: fish/fish.c:848
#, c-format
msgid "%s: unterminated single quote\n"
msgstr "%s: niet afgesloten enkel aanhalingsteken\n"
-#: fish/fish.c:844
+#: fish/fish.c:903
#, c-format
msgid "%s: internal error parsing string at '%s'\n"
msgstr "%s: interne fout bij ontleden van tekenreeks op '%s'\n"
-#: fish/fish.c:861
+#: fish/fish.c:920
#, c-format
msgid "%s: too many arguments\n"
msgstr "%s: teveel argumenten\n"
-#: fish/fish.c:890
+#: fish/fish.c:949
#, c-format
msgid "%s: empty command on command line\n"
msgstr "%s: leeg commando op commando regel\n"
-#: fish/fish.c:1056
+#: fish/fish.c:1117
msgid "display a list of commands or help on a command"
msgstr "laat een lijst van commando's of hulp over een commando zien"
-#: fish/fish.c:1058
+#: fish/fish.c:1119
msgid "read the manual"
msgstr "lees de manual"
-#: fish/fish.c:1060
+#: fish/fish.c:1121
msgid "quit guestfish"
msgstr "sluit guestfish af"
-#: fish/fish.c:1063
+#: fish/fish.c:1124
msgid "allocate an image"
msgstr "wijs een image toe"
-#: fish/fish.c:1065
+#: fish/fish.c:1126
msgid "display a line of text"
msgstr "laat een regel tekst zien"
-#: fish/fish.c:1067
+#: fish/fish.c:1128
msgid "edit a file in the image"
msgstr "bewerk een bestand in de image"
-#: fish/fish.c:1069
+#: fish/fish.c:1130
msgid "local change directory"
msgstr "verander locale map"
-#: fish/fish.c:1071
+#: fish/fish.c:1132
msgid "expand wildcards in command"
msgstr "expandeer wildcards in commando"
-#: fish/fish.c:1073
+#: fish/fish.c:1134
msgid "view a file in the pager"
msgstr "bekijk een bestand in de pager"
-#: fish/fish.c:1075
+#: fish/fish.c:1136
msgid "close and reopen libguestfs handle"
msgstr "sluit en open libguestfs hendel"
-#: fish/fish.c:1077
+#: fish/fish.c:1138
msgid "allocate a sparse image file"
msgstr "wijs een sparse image bestand toe"
-#: fish/fish.c:1079
+#: fish/fish.c:1140
msgid "list supported groups of commands"
msgstr "laat ondersteunde groep commando's zien"
-#: fish/fish.c:1081
+#: fish/fish.c:1142
msgid "measure time taken to run command"
msgstr "meet de tijd nodig voor uitvoeren van commando"
-#: fish/fish.c:1093
+#: fish/fish.c:1154
#, c-format
msgid ""
"alloc - allocate an image\n"
"alloc - wijs een image toe\n"
" alloc <bestandsnaam> <grootte>\n"
"\n"
-" Dit creëert een leeg (gevuld met nullen) bestand van de gegeven grootte,\n"
+" Dit creëert een leeg (gevuld met nullen) bestand van de gegeven "
+"grootte,\n"
" en voegt dan toe zodat het verder onderzocht kan worden.\n"
"\n"
" Voor meer geavanceerd aanmaken van een image, bekijk je het qemu-img "
"\n"
" Grootte kan gespecificeerd worden met de standaard suffix, b.v. '1M'.\n"
-#: fish/fish.c:1106
+#: fish/fish.c:1167
#, c-format
msgid ""
"echo - display a line of text\n"
"\n"
" Dit echoot de parameters naar de terminal.\n"
-#: fish/fish.c:1115
+#: fish/fish.c:1176
#, c-format
msgid ""
"edit - edit a file in the image\n"
" OPMERKING: Dit zal niet betrouwbaar werken voor grote bestanden\n"
" (> 2 MB) of binaire bestanden met \\0 bytes.\n"
-#: fish/fish.c:1131
+#: fish/fish.c:1192
#, c-format
msgid ""
"lcd - local change directory\n"
" nuttig als je bestanden wilt downloaden naar een bepaalde\n"
" plaats.\n"
-#: fish/fish.c:1140
+#: fish/fish.c:1201
#, c-format
msgid ""
"glob - expand wildcards in command\n"
" commando args. Merk op dat het commando herhaaldelijk wordt\n"
" gedraaid, een keer voor ieder geëxpandeerd argument.\n"
-#: fish/fish.c:1150
+#: fish/fish.c:1211
#, c-format
msgid ""
"man - read the manual\n"
"\n"
" Opent de manual pagina voor guestfish.\n"
-#: fish/fish.c:1157
+#: fish/fish.c:1218
#, c-format
msgid ""
"help - display a list of commands or help on a command\n"
" help cmd\n"
" help\n"
-#: fish/fish.c:1164
+#: fish/fish.c:1225
#, c-format
msgid ""
"more - view a file in the pager\n"
" OPMERKINK: Dit zal niet betrouwbaar werken voor grote bestanden\n"
" (> 2 MB) of binaire bestanden met \\0 bytes.\n"
-#: fish/fish.c:1182
+#: fish/fish.c:1243
#, c-format
msgid ""
"quit - quit guestfish\n"
"quit - sluit guestfish af\n"
" quit\n"
-#: fish/fish.c:1187
+#: fish/fish.c:1248
#, c-format
msgid ""
"reopen - close and reopen the libguestfs handle\n"
"te gebruiken, omdat de hendel correct gesloten wordt als guestfish\n"
"afgesloten wordt. Het is soms echter nuttig voor het testen.\n"
-#: fish/fish.c:1196
+#: fish/fish.c:1257
#, c-format
msgid ""
"sparse - allocate a sparse image file\n"
"\n"
" Groote kan gespecificeerd worden met standaard suffix, b.v. '1M'.\n"
-#: fish/fish.c:1217
+#: fish/fish.c:1278
#, c-format
msgid ""
"supported - list supported groups of commands\n"
"\n"
" Zie ook guestfs(3) sectie AVAILABILITY.\n"
-#: fish/fish.c:1229
+#: fish/fish.c:1290
#, c-format
msgid ""
"time - measure time taken to run command\n"
" Dit draait <commando> zoals gewoonlijk, en geeft daarna\n"
" de verstreken tijd terug.\n"
-#: fish/fish.c:1237
+#: fish/fish.c:1298
#, c-format
msgid "%s: command not known, use -h to list all commands\n"
msgstr "%s: commando niet bekend, gebruik -h om alle commando's te tonen\n"
-#: fish/fish.c:1253
+#: fish/fish.c:1314
#, c-format
msgid ""
"Did you mean to open a disk image? guestfish -a disk.img\n"
"Voor een lijst commando's: guestfish -h\n"
"Voor complete documentatie: man guestfish\n"
-#: fish/fish.c:1410
+#: fish/fish.c:1471
#, c-format
msgid "Runaway quote in string \"%s\"\n"
msgstr "Los aanhalingsteken in tekenreeks \"%s\"\n"
-#: fish/fish.c:1745
+#: fish/fish.c:1806
#, c-format
msgid "Enter key or passphrase (\"%s\"): "
msgstr "Vul sleutel of wachtzin in (\"%s\"): "
#, c-format
msgid ""
"guestfish: multi-boot operating systems are not supported by the -i option\n"
-msgstr "guestfish: multi-opstart besturingssystemen worden niet ondersteund door de "
-"-i optie\n"
+msgstr ""
+"guestfish: multi-opstart besturingssystemen worden niet ondersteund door de -"
+"i optie\n"
#: fish/inspect.c:101
#, c-format
#: fish/prep.c:241
#, c-format
msgid "guestfish: error creating prepared disk image '%s' on '%s': "
-msgstr "guestfish: fout bij creëren van aangemaakte schijf image '%s' op '%s': "
+msgstr ""
+"guestfish: fout bij creëren van aangemaakte schijf image '%s' op '%s': "
#: fish/prep.c:258 fish/prep.c:265 fish/prep.c:280
msgid "failed to allocate disk"
msgid ""
"guestfish: protocol error: version mismatch, server version '%s' does not "
"match client version '%s'. The two versions must match exactly.\n"
-msgstr "guestfish: protocol fout: versie komt niet overeen, server versie '%s' komt "
+msgstr ""
+"guestfish: protocol fout: versie komt niet overeen, server versie '%s' komt "
"niet overeen met cliënt versie '%s'. De twee versies moeten exact "
"overeenkomen.\n"
#: fish/rc.c:355 fish/rc.c:369
#, c-format
msgid "guestfish: protocol error: could not send initial greeting to server\n"
-msgstr "guestfish: protocol fout: kon initiële groeten niet naar de server sturen\n"
+msgstr ""
+"guestfish: protocol fout: kon initiële groeten niet naar de server sturen\n"
#: fish/rc.c:380
#, c-format
#: fish/virt.c:114
#, c-format
msgid "guestfish: unable to parse XML information returned by libvirt\n"
-msgstr "guestfish: kan XML informatie teruggegeven door libvirt niet ontleden\n"
+msgstr ""
+"guestfish: kan XML informatie teruggegeven door libvirt niet ontleden\n"
#: fish/virt.c:120
#, c-format
msgid "guestfish: libvirt domain '%s' has no disks\n"
msgstr "guestfish: libvirt domein '%s' heeft geen schijven\n"
-#: fuse/guestmount.c:883
+#: fuse/guestmount.c:884
#, c-format
msgid ""
"%s: FUSE module for libguestfs\n"
" -v|--verbose Breedsprakige boodschappen\n"
" -V|--version Laat versie zien en sluit af\n"
-#: fuse/guestmount.c:1092
+#: fuse/guestmount.c:1096
#, c-format
msgid "%s: must have at least one -a and at least one -m option\n"
msgstr "%s: moet tenminste een -a en tenminste een -m optie hebben\n"
-#: fuse/guestmount.c:1100
+#: fuse/guestmount.c:1104
#, c-format
msgid "%s: you must specify a mountpoint in the host filesystem\n"
-msgstr "%s: je moet een aankoppel punt in het host bestandssysteem specificeren\n"
+msgstr ""
+"%s: je moet een aankoppel punt in het host bestandssysteem specificeren\n"
#: inspector/virt-inspector.pl:200
msgid "virt-inspector: no image or VM names given"
#: inspector/virt-inspector.pl:324
msgid ""
"virt-inspector: no YAML support, try installing perl-YAML or libyaml-perl\n"
-msgstr "virt-inspector: geen YAML ondersteuning, probeer perl-YAML of libyaml-perl "
+msgstr ""
+"virt-inspector: geen YAML ondersteuning, probeer perl-YAML of libyaml-perl "
"te installeren\n"
#: inspector/virt-inspector.pl:363
msgid "external command failed: %s"
msgstr "extern commando mislukte: %s"
-#: src/guestfs.c:176
+#: src/guestfs.c:179
#, c-format
msgid "guestfs_close: called twice on the same handle\n"
msgstr "guestfs_close: twee keer dezelfde hendel aangeroepen\n"
-#: src/guestfs.c:279
+#: src/guestfs.c:284
#, c-format
msgid "libguestfs: error: %s\n"
msgstr "libguestfs: foutr: %s\n"
msgid "%s: cannot create temporary directory"
msgstr "%s: kan geen tijdelijke map aanmaken"
-#: src/launch.c:603
+#: src/launch.c:606
msgid "guestfs_launch failed, see earlier error messages"
msgstr "guestfs_launch mislukte, bekijk de eerdere fout boodschap"
-#: src/launch.c:616
+#: src/launch.c:619
msgid "qemu launched and contacted daemon, but state != READY"
-msgstr "qemu gelanceerd en contact opgenomen met daemon, maar toestand != READY"
+msgstr ""
+"qemu gelanceerd en contact opgenomen met daemon, maar toestand != READY"
-#: src/launch.c:753
+#: src/launch.c:756
#, c-format
msgid ""
"%s: command failed: If qemu is located on a non-standard path, try setting "
"%s: commando mislukte: Als qemu zich op een niet standaard pad bevindt, "
"probeer je het instellen van de LIBGUESTFS_QEMU omgevingsvariabele."
-#: src/launch.c:845
+#: src/launch.c:848
msgid "qemu has not been launched yet"
msgstr "qemu is nog niet gelanceerd"
-#: src/launch.c:856
+#: src/launch.c:859
msgid "no subprocess to kill"
msgstr "geen sub-proces om af te schieten"
#, c-format
msgid ""
"check_for_daemon_cancellation_or_eof: read 0x%x from daemon, expected 0x%x\n"
-msgstr "check_for_daemon_cancellation_or_eof: 0x%x gelezen van daemon, verwachte 0x%"
+msgstr ""
+"check_for_daemon_cancellation_or_eof: 0x%x gelezen van daemon, verwachte 0x%"
"x\n"
-#: src/proto.c:439 src/proto.c:493
+#: src/proto.c:453 src/proto.c:514
msgid "unexpected end of file when reading from daemon"
msgstr "onverwacht einde van bestand bij het lezen van daemon"
-#: src/proto.c:455
+#: src/proto.c:474
#, c-format
msgid "received magic signature from guestfsd, but in state %d"
msgstr "magie ondertekening ontvangen van guestfsd, maar de toestand is %d"
-#: src/proto.c:470
+#: src/proto.c:491
#, c-format
msgid "message length (%u) > maximum possible size (%d)"
msgstr "boodschap lengte (%u) > maximaal mogelijke grootte (%d)"
-#: src/proto.c:600
+#: src/proto.c:641
#, c-format
msgid "guestfs___send: state %d != BUSY"
msgstr "guestfs___send: toestand %d != BUSY"
-#: src/proto.c:622
+#: src/proto.c:663
msgid "xdr_guestfs_message_header failed"
msgstr "xdr_guestfs_message_header mislukte"
-#: src/proto.c:631
+#: src/proto.c:672
msgid "dispatch failed to marshal args"
msgstr "verzending faalde om argumenten te rangschikken"
-#: src/proto.c:761
+#: src/proto.c:802
#, c-format
msgid "send_file_chunk: state %d != READY"
msgstr "send_file_chunk: toestand %d != READY"
-#: src/proto.c:777
+#: src/proto.c:818
#, c-format
msgid "xdr_guestfs_chunk failed (buf = %p, buflen = %zu)"
msgstr "xdr_guestfs_chunk mislukted (buf = %p, buflen = %zu)"
-#: src/proto.c:900
+#: src/proto.c:941
#, c-format
msgid "%s: error in chunked encoding"
msgstr "%s: fout in chunk codering"
-#: src/proto.c:928
+#: src/proto.c:969
msgid "write to daemon socket"
msgstr "schrijven naar daemon socket"
-#: src/proto.c:951
+#: src/proto.c:992
msgid "receive_file_data: parse error in reply callback"
msgstr "receive_file_data: ontleed fout in antwoord callback"
-#: src/proto.c:956
+#: src/proto.c:997
msgid "receive_file_data: unexpected flag received when reading file chunks"
msgstr ""
"receive_file_data: onverwachte vlag ontvangen bij het lezen van bestand "
"chunks"
-#: src/proto.c:964
+#: src/proto.c:1005
msgid "failed to parse file chunk"
msgstr "bestand chunk ontleden mislukte"
-#: src/proto.c:973
+#: src/proto.c:1014
msgid "file receive cancelled by daemon"
msgstr "bestand ontvangen geannuleerd door daemon"
#: test-tool/test-tool.c:263
#, c-format
msgid "libguestfs-test-tool: could not run helper program, or helper failed\n"
-msgstr "libguestfs-test-tool: kon hulp programma niet draaien, of hulp programma "
+msgstr ""
+"libguestfs-test-tool: kon hulp programma niet draaien, of hulp programma "
"mislukte\n"
#: test-tool/test-tool.c:294
#: tools/virt-edit.pl:177
msgid "multiboot operating systems are not supported by virt-edit"
-msgstr "multi-opstart besturingssystemen worden niet ondersteund door virt-edit"
+msgstr ""
+"multi-opstart besturingssystemen worden niet ondersteund door virt-edit"
#: tools/virt-edit.pl:203
msgid "File not changed.\n"
#: tools/virt-ls.pl:186
msgid "multiboot operating systems are not supported by virt-ls\n"
-msgstr "multi-opstart besturingssystemen worden niet ondersteund door virt-ls\n"
+msgstr ""
+"multi-opstart besturingssystemen worden niet ondersteund door virt-ls\n"
#: tools/virt-make-fs.pl:291
msgid "virt-make-fs input output\n"
#: tools/virt-make-fs.pl:401
msgid ""
"qemu-img create: failed to create disk image, see earlier error messages\n"
-msgstr "qemu-img create: aanmaken schijf image mislukte, zie eerdere fout "
+msgstr ""
+"qemu-img create: aanmaken schijf image mislukte, zie eerdere fout "
"boodschappen\n"
#: tools/virt-make-fs.pl:412
msgid "virt-make-fs: NTFS support was disabled when libguestfs was compiled\n"
-msgstr "virt-make-fs: NTFS ondersteuning was uitgezet toen libguestfs gecompileerd "
+msgstr ""
+"virt-make-fs: NTFS ondersteuning was uitgezet toen libguestfs gecompileerd "
"werd\n"
#: tools/virt-make-fs.pl:437
"bestandssysteem niet correct bepaald heeft. Lees de BUGS sectie van de man "
"pagina.\n"
-#: tools/virt-rescue.pl:194
+#: tools/virt-rescue.pl:195
msgid "virt-rescue: no image or VM names rescue given"
msgstr "virt-rescue: geen image of VM namen redding opgegeven"
msgid "virt-resize: sorry this program does not work on a 32 bit host\n"
msgstr "virt-resize: sorry, dit programma werkt niet op een 32-bit host\n"
-#: tools/virt-resize.pl:526
+#: tools/virt-resize.pl:528
#, perl-brace-format
msgid "virt-resize: {file}: does not exist or is not readable\n"
msgstr "virt-resize: {file}: bestaat niet of is niet leesbaar\n"
-#: tools/virt-resize.pl:528
+#: tools/virt-resize.pl:530
#, perl-brace-format
msgid ""
"virt-resize: {file}: does not exist or is not writable\n"
"Je moet de bestemming schijf aanmaken voordat je dit programma uitvoert.\n"
"Lees de virt-resize(1) man pagina voor meer informatie.\n"
-#: tools/virt-resize.pl:553 tools/virt-resize.pl:556
+#: tools/virt-resize.pl:555 tools/virt-resize.pl:558
#, perl-brace-format
msgid ""
"virt-resize: {file}: file is too small to be a disk image ({sz} bytes)\n"
-msgstr "virt-resize: {file}: bestand is te klein om een schijf image te zijn ({sz} "
+msgstr ""
+"virt-resize: {file}: bestand is te klein om een schijf image te zijn ({sz} "
"bytes)\n"
-#: tools/virt-resize.pl:720
+#: tools/virt-resize.pl:723
#, perl-brace-format
msgid "virt-resize: no logical volume called {n}\n"
msgstr "virt-resize: geen logische gevolume aangeroepen {n}\n"
-#: tools/virt-resize.pl:740
+#: tools/virt-resize.pl:743
#, perl-brace-format
msgid ""
"{p}: partition not found in the source disk image, when using the '{opt}' "
"command line option\n"
-msgstr "{p}: partitie niet gevonden on de bron schijf image bij gebruik van de "
+msgstr ""
+"{p}: partitie niet gevonden on de bron schijf image bij gebruik van de "
"'{opt}' commando-regel optie\n"
-#: tools/virt-resize.pl:746
+#: tools/virt-resize.pl:749
#, perl-brace-format
msgid ""
"{p}: partition ignored, you cannot use it in another command line argument\n"
-msgstr "{p}: partitie genegeerd, je kunt het niet in een ander commando-regel "
+msgstr ""
+"{p}: partitie genegeerd, je kunt het niet in een ander commando-regel "
"argument gebruiken\n"
-#: tools/virt-resize.pl:750
+#: tools/virt-resize.pl:753
#, perl-brace-format
msgid ""
"{p}: partition deleted, you cannot use it in another command line argument\n"
-msgstr "{p}: partitie verwijderd, je kunt het niet in een ander commando-regel "
+msgstr ""
+"{p}: partitie verwijderd, je kunt het niet in een ander commando-regel "
"argument gebruiken\n"
-#: tools/virt-resize.pl:792
+#: tools/virt-resize.pl:795
#, perl-brace-format
msgid "{p}: this partition has already been marked for resizing\n"
msgstr "{p}: deze partitie is al gemarkeerd voor het veranderen in grootte\n"
-#: tools/virt-resize.pl:800
+#: tools/virt-resize.pl:803
#, perl-brace-format
msgid "{p}: missing size field in {o} option\n"
msgstr "{p}: ontbrekende grootte veld in {o} optie\n"
-#: tools/virt-resize.pl:817
+#: tools/virt-resize.pl:820
#, perl-brace-format
msgid "{p}: {f}: cannot parse size field\n"
msgstr "{p}: {f}: kan size veld niet ontleden\n"
-#: tools/virt-resize.pl:822
+#: tools/virt-resize.pl:825
#, perl-brace-format
msgid "{p}: new size is zero or negative\n"
msgstr "{p}: nieuwe grootte is nul of negatief\n"
-#: tools/virt-resize.pl:845
+#: tools/virt-resize.pl:848
#, perl-brace-format
msgid ""
"{p}: cannot make this partition smaller because it contains a\n"
"fysieke volume, of andere inhoud bevat die groter is dan de nieuwe grootte.\n"
"Je moet de inhoud eerst in grootte veranderen, bekijk virt-resize(1).\n"
-#: tools/virt-resize.pl:861
+#: tools/virt-resize.pl:864
msgid "virt-resize: you cannot use options --expand and --shrink together\n"
-msgstr "virt-resize: je kunt de opties --expand en --shrink niet tezamen gebruiken\n"
+msgstr ""
+"virt-resize: je kunt de opties --expand en --shrink niet tezamen gebruiken\n"
-#: tools/virt-resize.pl:910
+#: tools/virt-resize.pl:913
#, perl-brace-format
msgid ""
"virt-resize: error: cannot use --expand when there is no surplus space to\n"
"is\n"
"voor het expanderen. Je moet de doel schijf tenminste {h} groter maken.\n"
-#: tools/virt-resize.pl:925
+#: tools/virt-resize.pl:928
msgid ""
"virt-resize: error: cannot use --shrink because there is no deficit\n"
"(see 'deficit' in the virt-resize(1) man page)\n"
"virt-resize: fout: kan --shrink niet gebruiken omdat er geen deficit is\n"
"(zie 'deficit' in de virt-resize(1) man pagina)\n"
-#: tools/virt-resize.pl:940
+#: tools/virt-resize.pl:943
msgid "Summary of changes:\n"
msgstr "Samenvatting van de veranderingen:\n"
-#: tools/virt-resize.pl:944
+#: tools/virt-resize.pl:947
#, perl-brace-format
msgid "{p}: partition will be ignored\n"
msgstr "{p}: partitie zal genegeerd worden\n"
-#: tools/virt-resize.pl:946
+#: tools/virt-resize.pl:949
#, perl-brace-format
msgid "{p}: partition will be deleted\n"
msgstr "{p}: partitie zal verwijderd worden\n"
-#: tools/virt-resize.pl:948
+#: tools/virt-resize.pl:951
#, perl-brace-format
msgid "{p}: partition will be resized from {oldsize} to {newsize}\n"
-msgstr "{p}: partitie zal in grootte veranderd worden van {oldsize} naar {newsize}\n"
+msgstr ""
+"{p}: partitie zal in grootte veranderd worden van {oldsize} naar {newsize}\n"
-#: tools/virt-resize.pl:953
+#: tools/virt-resize.pl:956
#, perl-brace-format
msgid "{p}: content will be expanded using the '{meth}' method\n"
msgstr "{p}: inhoud zal geëxpandeerd worden met de '{meth}' methode\n"
-#: tools/virt-resize.pl:958
+#: tools/virt-resize.pl:961
#, perl-brace-format
msgid "{p}: partition will be left alone\n"
msgstr "{p}: partitie zal met rust gelaten worden\n"
-#: tools/virt-resize.pl:963
+#: tools/virt-resize.pl:966
#, perl-brace-format
msgid "{n}: LV will be expanded to maximum size\n"
msgstr "{n}: LV zal geëxpandeerd worden tot de maximale grootte\n"
-#: tools/virt-resize.pl:969
+#: tools/virt-resize.pl:972
#, perl-brace-format
msgid "{n}: content will be expanded using the '{meth}' method\n"
msgstr "{n}: inhoud zal geëxpandeerd worden met de '{meth}' methode\n"
-#: tools/virt-resize.pl:976
+#: tools/virt-resize.pl:979
#, perl-brace-format
msgid "There is a surplus of {spl} bytes ({h}).\n"
msgstr "Er is een overschot van {spl} bytes ({h}).\n"
-#: tools/virt-resize.pl:981
+#: tools/virt-resize.pl:984
msgid "An extra partition will be created for the surplus.\n"
msgstr "Er zal een extra partitie aangemaakt worden voor het overschot.\n"
-#: tools/virt-resize.pl:983
+#: tools/virt-resize.pl:986
msgid ""
"The surplus space is not large enough for an extra partition to be created\n"
"and so it will just be ignored.\n"
"De overschot ruimte is niet groot genoeg om een extra partitie aan te maken\n"
"en daarom genegeerd worden.\n"
-#: tools/virt-resize.pl:986
+#: tools/virt-resize.pl:989
msgid ""
"The surplus space will be ignored. Run a partitioning program in the guest\n"
"to partition this extra space if you want.\n"
"programma in de gast\n"
"om deze extra ruimte te partitioneren als je dat wilt.\n"
-#: tools/virt-resize.pl:989
+#: tools/virt-resize.pl:992
#, perl-brace-format
msgid ""
"virt-resize: error: there is a deficit of {def} bytes ({h}).\n"
"Je moet de doel schijf tenminste deze hoeveelheid groter maken,\n"
"of jouw in grootte verander verzoek aanpassen.\n"
-#: tools/virt-resize.pl:1030
+#: tools/virt-resize.pl:1033
msgid "virt-resize: source disk does not have a first partition\n"
msgstr "virt-resize: bron schijf heeft geen eerste partitie\n"
-#: tools/virt-resize.pl:1126
-#, perl-brace-format
-msgid "Copying {p} ..."
+#: tools/virt-resize.pl:1128
+#, fuzzy, perl-brace-format
+msgid "Copying {p} ...\n"
msgstr "{p} kopiëren ..."
-#: tools/virt-resize.pl:1133
-msgid "done"
-msgstr "voltooid"
-
-#: tools/virt-resize.pl:1191 tools/virt-resize.pl:1249
+#: tools/virt-resize.pl:1189 tools/virt-resize.pl:1247
#, perl-brace-format
msgid "Expanding {p} using the '{meth}' method\n"
msgstr "{p} expanderen met de '{meth}' methode\n"
#: tools/virt-tar.pl:162 tools/virt-tar.pl:169
msgid "virt-tar: extract/upload mode specified twice on the command line\n"
-msgstr "virt-tar: extraheer/upload mode twee keer gespecificeerd op de commando-"
+msgstr ""
+"virt-tar: extraheer/upload mode twee keer gespecificeerd op de commando-"
"regel\n"
#: tools/virt-tar.pl:190
#: tools/virt-tar.pl:229
msgid "multiboot operating systems are not supported by virt-tar\n"
-msgstr "multi-opstart besturingssystemen worden niet ondersteund door virt-tar\n"
+msgstr ""
+"multi-opstart besturingssystemen worden niet ondersteund door virt-tar\n"
#: tools/virt-win-reg.pl:259
msgid "no libvirt domain name or disk image given\n"
msgid ""
"expecting 1 or 2 more parameters, subkey path and optionally the value to "
"export\n"
-msgstr "verwacht 1 of 2 extra parameters, subkey pad en optioneel de waarde om te "
+msgstr ""
+"verwacht 1 of 2 extra parameters, subkey pad en optioneel de waarde om te "
"exporteren\n"
#: tools/virt-win-reg.pl:408
#, perl-brace-format
msgid "virt-win-reg: {p}: could not upload registry file: {err}\n"
msgstr "virt-win-reg: {p}: kon registry bestand niet uploaden: {err}\n"
+
+#~ msgid "done"
+#~ msgstr "voltooid"
"Project-Id-Version: libguestfs.master.or\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-02-01 18:17+0530\n"
"Last-Translator: Manoj Kumar Giri <mgiri@redhat.com>\n"
"Language-Team: Oriya <oriya-it@googlegroups.com>\n"
"Project-Id-Version: libguestfs 1.0.81\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-01-29 12:50+0530\n"
"Last-Translator: Jaswinder Singh <jsingh@redhat.com>\n"
"Language-Team: Punjabi/Panjabi <kde-i18n-doc@kde.org>\n"
"Project-Id-Version: pl\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-08-23 19:13+0200\n"
"Last-Translator: Piotr Drąg <piotrdrag@gmail.com>\n"
"Language-Team: Polish <trans-pl@lists.fedoraproject.org>\n"
"Project-Id-Version: libguestfs 1.0.81\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-01-29 13:38+0530\n"
"Last-Translator: I. Felix <ifelix@redhat.com>\n"
"Language-Team: ta_IN <kde-i18n-doc@kde.org>\n"
"Project-Id-Version: libguestfs.master.libguestfs\n"
"Report-Msgid-Bugs-To: https://bugzilla.redhat.com/enter_bug.cgi?"
"component=libguestfs&product=Virtualization+Tools\n"
-"POT-Creation-Date: 2010-09-01 17:45+0100\n"
+"POT-Creation-Date: 2010-09-04 10:26+0100\n"
"PO-Revision-Date: 2010-01-27 20:03+0530\n"
"Last-Translator: Krishna Babu K <kkrothap@redhat.com>\n"
"Language-Team: Telugu <en@li.org>\n"