diff options
Diffstat (limited to 'po-docs')
| -rw-r--r-- | po-docs/ja.po | 241 | ||||
| -rw-r--r-- | po-docs/libguestfs-docs.pot | 243 | ||||
| -rw-r--r-- | po-docs/uk.po | 241 |
3 files changed, 382 insertions, 343 deletions
diff --git a/po-docs/ja.po b/po-docs/ja.po index 6e75a3a4..d5dfa8bd 100644 --- a/po-docs/ja.po +++ b/po-docs/ja.po @@ -11,7 +11,7 @@ msgid "" msgstr "" "Project-Id-Version: libguestfs\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2012-06-14 16:19+0200\n" +"POT-Creation-Date: 2012-06-22 22:05+0200\n" "PO-Revision-Date: 2012-05-21 13:20+0000\n" "Last-Translator: rjones <rjones@redhat.com>\n" "Language-Team: Japanese <trans-ja@lists.fedoraproject.org>\n" @@ -1249,7 +1249,7 @@ msgstr "" #: ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 #: ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 #: ../erlang/examples/guestfs-erlang.pod:97 -#: ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:648 +#: ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:652 #: ../examples/guestfs-performance.pod:364 ../examples/guestfs-recipes.pod:384 #: ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1280 #: ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 @@ -1307,7 +1307,7 @@ msgstr "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" #: ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 #: ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 #: ../erlang/examples/guestfs-erlang.pod:114 -#: ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:658 +#: ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:662 #: ../examples/guestfs-performance.pod:379 ../examples/guestfs-recipes.pod:401 #: ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1312 #: ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 @@ -1702,7 +1702,7 @@ msgstr "" #. type: =head1 #: ../appliance/libguestfs-make-fixed-appliance.pod:153 #: ../erlang/examples/guestfs-erlang.pod:110 -#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:654 +#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:658 #: ../examples/guestfs-performance.pod:375 ../examples/guestfs-recipes.pod:397 #: ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1308 #: ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 @@ -1719,7 +1719,7 @@ msgstr "著者" #. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:155 #: ../erlang/examples/guestfs-erlang.pod:112 -#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:656 +#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:660 #: ../examples/guestfs-performance.pod:377 ../examples/guestfs-recipes.pod:399 #: ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1310 #: ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 @@ -5009,7 +5009,7 @@ msgstr "" #. type: textblock #: ../erlang/examples/guestfs-erlang.pod:121 -#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:662 +#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:666 #: ../examples/guestfs-performance.pod:383 ../examples/guestfs-recipes.pod:408 #: ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 #: ../ocaml/examples/guestfs-ocaml.pod:102 @@ -5029,7 +5029,7 @@ msgstr "" #. type: textblock #: ../erlang/examples/guestfs-erlang.pod:126 -#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:667 +#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:671 #: ../examples/guestfs-performance.pod:388 ../examples/guestfs-recipes.pod:413 #: ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 #: ../ocaml/examples/guestfs-ocaml.pod:107 @@ -5049,7 +5049,7 @@ msgstr "" #. type: textblock #: ../erlang/examples/guestfs-erlang.pod:131 -#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:672 +#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:676 #: ../examples/guestfs-performance.pod:393 ../examples/guestfs-recipes.pod:418 #: ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 #: ../ocaml/examples/guestfs-ocaml.pod:112 @@ -5594,7 +5594,7 @@ msgstr "" #. type: =end #: ../examples/guestfs-faq.pod:219 ../examples/guestfs-faq.pod:224 -#: ../examples/guestfs-faq.pod:421 ../examples/guestfs-faq.pod:426 +#: ../examples/guestfs-faq.pod:425 ../examples/guestfs-faq.pod:430 #: ../src/guestfs.pod:2332 ../src/guestfs.pod:2337 msgid "html" msgstr "HTML" @@ -5705,7 +5705,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:272 ../examples/guestfs-faq.pod:294 +#: ../examples/guestfs-faq.pod:272 ../examples/guestfs-faq.pod:298 #, no-wrap msgid "" " sudo chmod 0644 /boot/vmlinuz*\n" @@ -5743,6 +5743,19 @@ msgstr "" #. type: textblock #: ../examples/guestfs-faq.pod:287 +msgid "After installing or updating febootstrap, rebuild the appliance:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-faq.pod:289 +#, no-wrap +msgid "" +" sudo update-guestfs-appliance\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-faq.pod:291 msgid "" "You need seabios E<ge> 0.6.2-0ubuntu2.1 or E<ge> 0.6.2-0ubuntu3 from: " "L<http://packages.ubuntu.com/precise-updates/seabios> or L<http://packages." @@ -5750,37 +5763,37 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:292 +#: ../examples/guestfs-faq.pod:296 msgid "Also you need to do (see above):" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:296 +#: ../examples/guestfs-faq.pod:300 msgid "Other Linux distro" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:298 +#: ../examples/guestfs-faq.pod:302 msgid "Compile from source (next section)." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:300 +#: ../examples/guestfs-faq.pod:304 msgid "Other non-Linux distro" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:302 +#: ../examples/guestfs-faq.pod:306 msgid "You'll have to compile from source, and port it." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:306 +#: ../examples/guestfs-faq.pod:310 msgid "How can I compile and install libguestfs from source?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:308 +#: ../examples/guestfs-faq.pod:312 msgid "" "If your Linux distro has a working port of febootstrap (that is, Fedora, Red " "Hat Enterprise Linux >= 6.3, Debian, Ubuntu and ArchLinux) then you should " @@ -5790,33 +5803,33 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:314 +#: ../examples/guestfs-faq.pod:318 msgid "" "If you I<don't> have febootstrap, you will need to use the \"fixed appliance " "method\". See: L<http://libguestfs.org/download/binaries/appliance/>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:318 +#: ../examples/guestfs-faq.pod:322 msgid "Patches to port febootstrap to more Linux distros are welcome." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:320 +#: ../examples/guestfs-faq.pod:324 msgid "" "Why do I get an error when I try to rebuild from the source RPMs supplied by " "Red Hat / Fedora?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:323 +#: ../examples/guestfs-faq.pod:327 msgid "" "Because of the complexity of building the libguestfs appliance, the source " "RPMs provided cannot be rebuilt directly using C<rpmbuild> or C<mock>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:327 +#: ../examples/guestfs-faq.pod:331 msgid "" "If you use Koji (which is open source software and may be installed " "locally), then the SRPMs can be rebuilt in Koji. L<https://fedoraproject." @@ -5824,7 +5837,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:331 +#: ../examples/guestfs-faq.pod:335 msgid "" "If you don't have or want to use Koji, then you have to give libguestfs " "access to the network so it can download the RPMs for building the " @@ -5833,7 +5846,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:337 +#: ../examples/guestfs-faq.pod:341 #, no-wrap msgid "" " %libguestfs_buildnet 1\n" @@ -5841,12 +5854,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:339 +#: ../examples/guestfs-faq.pod:343 msgid "If you are using mock, do:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:341 +#: ../examples/guestfs-faq.pod:345 #, no-wrap msgid "" " mock -D '%libguestfs_buildnet 1' [etc]\n" @@ -5854,22 +5867,22 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:343 +#: ../examples/guestfs-faq.pod:347 msgid "Libguestfs has a really long list of dependencies!" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:345 +#: ../examples/guestfs-faq.pod:349 msgid "That's because it does a lot of things." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:347 +#: ../examples/guestfs-faq.pod:351 msgid "How can I speed up libguestfs builds?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:349 +#: ../examples/guestfs-faq.pod:353 msgid "" "By far the most important thing you can do is to install and properly " "configure Squid. Note that the default configuration that ships with Squid " @@ -5877,7 +5890,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:353 +#: ../examples/guestfs-faq.pod:357 msgid "" "A very good place to start with Squid configuration is here: L<https://" "fedoraproject.org/wiki/Extras/" @@ -5885,38 +5898,38 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:356 +#: ../examples/guestfs-faq.pod:360 msgid "" "Make sure Squid is running, and that the environment variables C<" "$http_proxy> and C<$ftp_proxy> are pointing to it." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:359 +#: ../examples/guestfs-faq.pod:363 msgid "" "With Squid running and correctly configured, appliance builds should be " "reduced to a few minutes." msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:362 +#: ../examples/guestfs-faq.pod:366 msgid "SPEED, DISK SPACE USED BY LIBGUESTFS" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:364 +#: ../examples/guestfs-faq.pod:368 msgid "" "Note: Most of the information in this section has moved: L<guestfs-" "performance(1)>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:367 +#: ../examples/guestfs-faq.pod:371 msgid "Upload or write seem very slow." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:369 +#: ../examples/guestfs-faq.pod:373 msgid "" "In libguestfs E<lt> 1.13.16, the mount command (L<guestfs(3)/guestfs_mount>) " "enabled option C<-o sync> implicitly. This causes very poor write " @@ -5924,14 +5937,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:374 +#: ../examples/guestfs-faq.pod:378 msgid "" "For libguestfs E<lt> 1.13.16, replace mount with C<mount-options>, leaving " "the first parameter as an empty string." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:377 +#: ../examples/guestfs-faq.pod:381 msgid "" "You can also do this with more recent versions of libguestfs, but if you " "know that you are using libguestfs ≥ 1.13.16 then it's safe to use plain " @@ -5939,7 +5952,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:381 +#: ../examples/guestfs-faq.pod:385 msgid "" "If the underlying disk is not fully allocated (eg. sparse raw or qcow2) then " "writes can be slow because the host operating system has to do costly disk " @@ -5949,17 +5962,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:387 +#: ../examples/guestfs-faq.pod:391 msgid "Libguestfs uses too much disk space!" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:389 +#: ../examples/guestfs-faq.pod:393 msgid "libguestfs caches a large-ish appliance in:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:391 +#: ../examples/guestfs-faq.pod:395 #, no-wrap msgid "" " /var/tmp/.guestfs-<UID>\n" @@ -5967,36 +5980,36 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:393 +#: ../examples/guestfs-faq.pod:397 msgid "" "If the environment variable C<TMPDIR> is defined, then C<$TMPDIR/.guestfs-" "E<lt>UIDE<gt>> is used instead." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:396 +#: ../examples/guestfs-faq.pod:400 msgid "It is safe to delete this directory when you are not using libguestfs." msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:398 +#: ../examples/guestfs-faq.pod:402 msgid "USING LIBGUESTFS IN YOUR OWN PROGRAMS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:400 +#: ../examples/guestfs-faq.pod:404 msgid "The API has hundreds of methods, where do I start?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:402 +#: ../examples/guestfs-faq.pod:406 msgid "" "We recommend you start by reading the API overview: L<guestfs(3)/API " "OVERVIEW>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:405 +#: ../examples/guestfs-faq.pod:409 msgid "" "Although the API overview covers the C API, it is still worth reading even " "if you are going to use another programming language, because the API is the " @@ -6004,7 +6017,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:410 +#: ../examples/guestfs-faq.pod:414 #, no-wrap msgid "" " C guestfs_ln_sf (g, target, linkname);\n" @@ -6017,7 +6030,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:417 +#: ../examples/guestfs-faq.pod:421 msgid "" "Once you're familiar with the API overview, you should look at this list of " "starting points for other language bindings: L<guestfs(3)/USING LIBGUESTFS " @@ -6025,18 +6038,18 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:423 +#: ../examples/guestfs-faq.pod:427 msgid "<!-- old anchor for the next section --> <a name=\"debug\"/>" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:428 +#: ../examples/guestfs-faq.pod:432 msgid "" "Can I use libguestfs in my proprietary / closed source / commercial program?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:430 +#: ../examples/guestfs-faq.pod:434 msgid "" "In general, yes. However this is not legal advice. You should read the " "license that comes with libguestfs, and if you have specific questions about " @@ -6046,43 +6059,43 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:437 +#: ../examples/guestfs-faq.pod:441 msgid "DEBUGGING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:439 +#: ../examples/guestfs-faq.pod:443 msgid "" "How do I debug when using any libguestfs program or tool (eg. virt-v2v or " "virt-df)?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:442 +#: ../examples/guestfs-faq.pod:446 msgid "" "There are two C<LIBGUESTFS_*> environment variables you can set in order to " "get more information from libguestfs." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:447 +#: ../examples/guestfs-faq.pod:451 msgid "C<LIBGUESTFS_TRACE>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:449 +#: ../examples/guestfs-faq.pod:453 msgid "" "Set this to 1 and libguestfs will print out each command / API call in a " "format which is similar to guestfish commands." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:452 +#: ../examples/guestfs-faq.pod:456 msgid "C<LIBGUESTFS_DEBUG>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:454 +#: ../examples/guestfs-faq.pod:458 msgid "" "Set this to 1 in order to enable massive amounts of debug messages. If you " "think there is some problem inside the libguestfs appliance, then you should " @@ -6090,12 +6103,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:460 +#: ../examples/guestfs-faq.pod:464 msgid "To set these from the shell, do this before running the program:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:462 +#: ../examples/guestfs-faq.pod:466 #, no-wrap msgid "" " export LIBGUESTFS_TRACE=1\n" @@ -6104,12 +6117,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:465 +#: ../examples/guestfs-faq.pod:469 msgid "For csh/tcsh the equivalent commands would be:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:467 +#: ../examples/guestfs-faq.pod:471 #, no-wrap msgid "" " setenv LIBGUESTFS_TRACE 1\n" @@ -6118,17 +6131,17 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:470 +#: ../examples/guestfs-faq.pod:474 msgid "For further information, see: L<guestfs(3)/ENVIRONMENT VARIABLES>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:472 +#: ../examples/guestfs-faq.pod:476 msgid "How do I debug when using guestfish?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:474 +#: ../examples/guestfs-faq.pod:478 msgid "" "You can use the same environment variables above. Alternatively use the " "guestfish options -x (to trace commands) or -v (to get the full debug " @@ -6136,60 +6149,60 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:478 +#: ../examples/guestfs-faq.pod:482 msgid "For further information, see: L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:480 +#: ../examples/guestfs-faq.pod:484 msgid "How do I debug when using the API?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:482 +#: ../examples/guestfs-faq.pod:486 msgid "" "Call L<guestfs(3)/guestfs_set_trace> to enable command traces, and/or " "L<guestfs(3)/guestfs_set_verbose> to enable debug messages." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:485 +#: ../examples/guestfs-faq.pod:489 msgid "" "For best results, call these functions as early as possible, just after " "creating the guestfs handle if you can, and definitely before calling launch." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:489 +#: ../examples/guestfs-faq.pod:493 msgid "How do I capture debug output and put it into my logging system?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:491 +#: ../examples/guestfs-faq.pod:495 msgid "" "Use the event API. For examples, see: L<guestfs(3)/SETTING CALLBACKS TO " "HANDLE EVENTS>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:494 +#: ../examples/guestfs-faq.pod:498 msgid "Digging deeper into the appliance boot process." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:496 +#: ../examples/guestfs-faq.pod:500 msgid "" "Enable debugging and then read this documentation on the appliance boot " "process: L<guestfs(3)/INTERNALS>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:499 +#: ../examples/guestfs-faq.pod:503 msgid "libguestfs hangs or fails during run/launch." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:501 +#: ../examples/guestfs-faq.pod:505 msgid "" "Enable debugging and look at the full output. If you cannot work out what " "is going on, file a bug report, including the I<complete> output of " @@ -6197,17 +6210,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:505 +#: ../examples/guestfs-faq.pod:509 msgid "DESIGN/INTERNALS OF LIBGUESTFS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:507 +#: ../examples/guestfs-faq.pod:511 msgid "Why don't you do everything through the FUSE / filesystem interface?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:510 +#: ../examples/guestfs-faq.pod:514 msgid "" "We offer a command called L<guestmount(1)> which lets you mount guest " "filesystems on the host. This is implemented as a FUSE module. Why don't " @@ -6216,7 +6229,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:515 +#: ../examples/guestfs-faq.pod:519 msgid "" "The reasons are twofold. Firstly, libguestfs offers API calls for doing " "things like creating and deleting partitions and logical volumes, which " @@ -6230,7 +6243,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:525 +#: ../examples/guestfs-faq.pod:529 msgid "" "The second reason is for efficiency. FUSE itself is reasonably efficient, " "but it does make lots of small, independent calls into the FUSE module. In " @@ -6243,17 +6256,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:535 +#: ../examples/guestfs-faq.pod:539 msgid "Why don't you do everything through GVFS?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:537 +#: ../examples/guestfs-faq.pod:541 msgid "The problems are similar to the problems with FUSE." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:539 +#: ../examples/guestfs-faq.pod:543 msgid "" "GVFS is a better abstraction than POSIX/FUSE. There is an FTP backend for " "GVFS, which is encouraging because FTP is conceptually similar to the " @@ -6263,12 +6276,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:545 +#: ../examples/guestfs-faq.pod:549 msgid "Can I use C<guestfish --ro> as a way to backup my virtual machines?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:547 +#: ../examples/guestfs-faq.pod:551 msgid "" "Usually this is not a good idea. The question is answered in more detail in " "this mailing list posting: L<https://www.redhat.com/archives/libguestfs/2010-" @@ -6276,19 +6289,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:551 +#: ../examples/guestfs-faq.pod:555 msgid "What's the difference between guestfish and virt-rescue?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:553 +#: ../examples/guestfs-faq.pod:557 msgid "" "A lot of people are confused by the two superficially similar tools we " "provide:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:556 +#: ../examples/guestfs-faq.pod:560 #, no-wrap msgid "" " $ guestfish --ro -a guest.img\n" @@ -6298,7 +6311,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:560 +#: ../examples/guestfs-faq.pod:564 #, no-wrap msgid "" " $ virt-rescue --ro guest.img\n" @@ -6307,7 +6320,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:563 +#: ../examples/guestfs-faq.pod:567 msgid "" "And the related question which then arises is why you can't type in full " "shell commands with all the --options in guestfish (but you can in L<virt-" @@ -6315,7 +6328,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:567 +#: ../examples/guestfs-faq.pod:571 msgid "" "L<guestfish(1)> is a program providing structured access to the L<guestfs(3)" "> API. It happens to be a nice interactive shell too, but its primary " @@ -6326,7 +6339,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:574 +#: ../examples/guestfs-faq.pod:578 msgid "" "L<virt-rescue(1)> is a free-for-all freeform way to boot the libguestfs " "appliance and make arbitrary changes to your VM. It's not structured, you " @@ -6335,7 +6348,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:579 +#: ../examples/guestfs-faq.pod:583 msgid "" "But, libguestfs also has a \"backdoor\" into the appliance allowing you to " "send arbitrary shell commands. It's not as flexible as virt-rescue, because " @@ -6343,7 +6356,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:584 +#: ../examples/guestfs-faq.pod:588 #, no-wrap msgid "" " ><fs> debug sh \"cmd arg1 arg2 ...\"\n" @@ -6351,7 +6364,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:586 +#: ../examples/guestfs-faq.pod:590 msgid "" "Note that you should B<not> rely on this. It could be removed or changed in " "future. If your program needs some operation, please add it to the " @@ -6359,7 +6372,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:590 +#: ../examples/guestfs-faq.pod:594 msgid "" "What's the deal with C<guestfish -i>? Why does virt-cat only work on a real " "VM image, but virt-df works on any disk image? What does \"no root device " @@ -6367,28 +6380,28 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:595 +#: ../examples/guestfs-faq.pod:599 msgid "" "These questions are all related at a fundamental level which may not be " "immediately obvious." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:598 +#: ../examples/guestfs-faq.pod:602 msgid "" "At the L<guestfs(3)> API level, a \"disk image\" is just a pile of " "partitions and filesystems." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:601 +#: ../examples/guestfs-faq.pod:605 msgid "" "In contrast, when the virtual machine boots, it mounts those filesystems " "into a consistent hierarchy such as:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:604 +#: ../examples/guestfs-faq.pod:608 #, no-wrap msgid "" " / (/dev/sda2)\n" @@ -6414,12 +6427,12 @@ msgstr "" "\n" #. type: textblock -#: ../examples/guestfs-faq.pod:614 +#: ../examples/guestfs-faq.pod:618 msgid "(or drive letters on Windows)." msgstr "(または Windows におけるドライブレター)。" #. type: textblock -#: ../examples/guestfs-faq.pod:616 +#: ../examples/guestfs-faq.pod:620 msgid "" "The API first of all sees the disk image at the \"pile of filesystems\" " "level. But it also has a way to inspect the disk image to see if it " @@ -6428,12 +6441,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:621 +#: ../examples/guestfs-faq.pod:625 msgid "Users expect some tools (like L<virt-cat(1)>) to work with VM paths:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:623 +#: ../examples/guestfs-faq.pod:627 #, no-wrap msgid "" " virt-cat fedora.img /var/log/messages\n" @@ -6441,7 +6454,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:625 +#: ../examples/guestfs-faq.pod:629 msgid "" "How does virt-cat know that C</var> is a separate partition? The trick is " "that virt-cat performs inspection on the disk image, and uses that to " @@ -6449,7 +6462,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:629 +#: ../examples/guestfs-faq.pod:633 msgid "" "Some tools (including L<virt-cat(1)>, L<virt-edit(1)>, L<virt-ls(1)>) use " "inspection to map VM paths. Other tools, such as L<virt-df(1)> and L<virt-" @@ -6458,7 +6471,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:634 +#: ../examples/guestfs-faq.pod:638 msgid "" "L<guestfish(1)> is in an interesting middle ground. If you use the I<-a> " "and I<-m> command line options, then you have to tell guestfish exactly how " @@ -6466,14 +6479,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:639 +#: ../examples/guestfs-faq.pod:643 msgid "" "If you use the I<-i> option, libguestfs performs inspection and mounts the " "filesystems for you." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:642 +#: ../examples/guestfs-faq.pod:646 msgid "" "The error C<no root device found in this operating system image> is related " "to this. It means inspection was unable to locate an operating system " @@ -6483,12 +6496,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:650 +#: ../examples/guestfs-faq.pod:654 msgid "L<guestfish(1)>, L<guestfs(3)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:660 ../examples/guestfs-performance.pod:381 +#: ../examples/guestfs-faq.pod:664 ../examples/guestfs-performance.pod:381 msgid "Copyright (C) 2012 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 762b8839..845b9d2e 100644 --- a/po-docs/libguestfs-docs.pot +++ b/po-docs/libguestfs-docs.pot @@ -6,9 +6,9 @@ #, fuzzy msgid "" msgstr "" -"Project-Id-Version: libguestfs 1.19.9\n" +"Project-Id-Version: libguestfs 1.19.10\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2012-06-18 16:31+0200\n" +"POT-Creation-Date: 2012-06-22 22:05+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" @@ -800,7 +800,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:375 ../appliance/libguestfs-make-fixed-appliance.pod:144 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:648 ../examples/guestfs-performance.pod:364 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1280 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:286 ../src/guestfs.pod:3353 ../sysprep/virt-sysprep.pod:432 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:591 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:757 +#: ../align/virt-alignment-scan.pod:375 ../appliance/libguestfs-make-fixed-appliance.pod:144 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:652 ../examples/guestfs-performance.pod:364 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1280 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../format/virt-format.pod:177 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:501 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:340 ../resize/virt-resize.pod:702 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:286 ../src/guestfs.pod:3353 ../sysprep/virt-sysprep.pod:432 ../test-tool/libguestfs-test-tool.pod:106 ../tools/virt-list-filesystems.pl:197 ../tools/virt-list-partitions.pl:267 ../tools/virt-make-fs.pl:591 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "" @@ -822,7 +822,7 @@ msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" msgstr "" #. type: =head1 -#: ../align/virt-alignment-scan.pod:388 ../appliance/libguestfs-make-fixed-appliance.pod:157 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:658 ../examples/guestfs-performance.pod:379 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1312 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:303 ../src/guestfs.pod:3441 ../sysprep/virt-sysprep.pod:453 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:621 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787 +#: ../align/virt-alignment-scan.pod:388 ../appliance/libguestfs-make-fixed-appliance.pod:157 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:662 ../examples/guestfs-performance.pod:379 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1312 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../format/virt-format.pod:191 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:524 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:353 ../resize/virt-resize.pod:729 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:303 ../src/guestfs.pod:3441 ../sysprep/virt-sysprep.pod:453 ../test-tool/libguestfs-test-tool.pod:116 ../tools/virt-list-filesystems.pl:214 ../tools/virt-list-partitions.pl:283 ../tools/virt-make-fs.pl:621 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787 msgid "COPYRIGHT" msgstr "" @@ -1123,12 +1123,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:654 ../examples/guestfs-performance.pod:375 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1308 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3437 ../sysprep/virt-sysprep.pod:447 ../test-tool/libguestfs-test-tool.pod:112 +#: ../appliance/libguestfs-make-fixed-appliance.pod:153 ../erlang/examples/guestfs-erlang.pod:110 ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:658 ../examples/guestfs-performance.pod:375 ../examples/guestfs-recipes.pod:397 ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1308 ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:510 ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 ../python/examples/guestfs-python.pod:54 ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3437 ../sysprep/virt-sysprep.pod:447 ../test-tool/libguestfs-test-tool.pod:112 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../appliance/libguestfs-make-fixed-appliance.pod:155 ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:656 ../examples/guestfs-performance.pod:377 ../examples/guestfs-recipes.pod:399 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3439 ../test-tool/libguestfs-test-tool.pod:114 +#: ../appliance/libguestfs-make-fixed-appliance.pod:155 ../erlang/examples/guestfs-erlang.pod:112 ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:660 ../examples/guestfs-performance.pod:377 ../examples/guestfs-recipes.pod:399 ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 ../python/examples/guestfs-python.pod:56 ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3439 ../test-tool/libguestfs-test-tool.pod:114 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)" msgstr "" @@ -3957,7 +3957,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:662 ../examples/guestfs-performance.pod:383 ../examples/guestfs-recipes.pod:408 ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3446 +#: ../erlang/examples/guestfs-erlang.pod:121 ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:666 ../examples/guestfs-performance.pod:383 ../examples/guestfs-recipes.pod:408 ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 ../ocaml/examples/guestfs-ocaml.pod:102 ../perl/examples/guestfs-perl.pod:63 ../python/examples/guestfs-python.pod:65 ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3446 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 " @@ -3966,7 +3966,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:667 ../examples/guestfs-performance.pod:388 ../examples/guestfs-recipes.pod:413 ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3451 +#: ../erlang/examples/guestfs-erlang.pod:126 ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:671 ../examples/guestfs-performance.pod:388 ../examples/guestfs-recipes.pod:413 ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 ../ocaml/examples/guestfs-ocaml.pod:107 ../perl/examples/guestfs-perl.pod:68 ../python/examples/guestfs-python.pod:70 ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3451 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 " @@ -3975,7 +3975,7 @@ msgid "" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:672 ../examples/guestfs-performance.pod:393 ../examples/guestfs-recipes.pod:418 ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3456 +#: ../erlang/examples/guestfs-erlang.pod:131 ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:676 ../examples/guestfs-performance.pod:393 ../examples/guestfs-recipes.pod:418 ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 ../ocaml/examples/guestfs-ocaml.pod:112 ../perl/examples/guestfs-perl.pod:73 ../python/examples/guestfs-python.pod:75 ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3456 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, " @@ -4473,7 +4473,7 @@ msgid "DOWNLOADING, INSTALLING, COMPILING LIBGUESTFS" msgstr "" #. type: =end -#: ../examples/guestfs-faq.pod:219 ../examples/guestfs-faq.pod:224 ../examples/guestfs-faq.pod:421 ../examples/guestfs-faq.pod:426 ../src/guestfs.pod:2332 ../src/guestfs.pod:2337 +#: ../examples/guestfs-faq.pod:219 ../examples/guestfs-faq.pod:224 ../examples/guestfs-faq.pod:425 ../examples/guestfs-faq.pod:430 ../src/guestfs.pod:2332 ../src/guestfs.pod:2337 msgid "html" msgstr "" @@ -4584,7 +4584,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:272 ../examples/guestfs-faq.pod:294 +#: ../examples/guestfs-faq.pod:272 ../examples/guestfs-faq.pod:298 #, no-wrap msgid "" " sudo chmod 0644 /boot/vmlinuz*\n" @@ -4622,6 +4622,19 @@ msgstr "" #. type: textblock #: ../examples/guestfs-faq.pod:287 +msgid "After installing or updating febootstrap, rebuild the appliance:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-faq.pod:289 +#, no-wrap +msgid "" +" sudo update-guestfs-appliance\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-faq.pod:291 msgid "" "You need seabios E<ge> 0.6.2-0ubuntu2.1 or E<ge> 0.6.2-0ubuntu3 from: " "L<http://packages.ubuntu.com/precise-updates/seabios> or " @@ -4629,37 +4642,37 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:292 +#: ../examples/guestfs-faq.pod:296 msgid "Also you need to do (see above):" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:296 +#: ../examples/guestfs-faq.pod:300 msgid "Other Linux distro" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:298 +#: ../examples/guestfs-faq.pod:302 msgid "Compile from source (next section)." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:300 +#: ../examples/guestfs-faq.pod:304 msgid "Other non-Linux distro" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:302 +#: ../examples/guestfs-faq.pod:306 msgid "You'll have to compile from source, and port it." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:306 +#: ../examples/guestfs-faq.pod:310 msgid "How can I compile and install libguestfs from source?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:308 +#: ../examples/guestfs-faq.pod:312 msgid "" "If your Linux distro has a working port of febootstrap (that is, Fedora, Red " "Hat Enterprise Linux >= 6.3, Debian, Ubuntu and ArchLinux) then you should " @@ -4669,33 +4682,33 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:314 +#: ../examples/guestfs-faq.pod:318 msgid "" "If you I<don't> have febootstrap, you will need to use the \"fixed appliance " "method\". See: L<http://libguestfs.org/download/binaries/appliance/>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:318 +#: ../examples/guestfs-faq.pod:322 msgid "Patches to port febootstrap to more Linux distros are welcome." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:320 +#: ../examples/guestfs-faq.pod:324 msgid "" "Why do I get an error when I try to rebuild from the source RPMs supplied by " "Red Hat / Fedora?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:323 +#: ../examples/guestfs-faq.pod:327 msgid "" "Because of the complexity of building the libguestfs appliance, the source " "RPMs provided cannot be rebuilt directly using C<rpmbuild> or C<mock>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:327 +#: ../examples/guestfs-faq.pod:331 msgid "" "If you use Koji (which is open source software and may be installed " "locally), then the SRPMs can be rebuilt in Koji. " @@ -4703,7 +4716,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:331 +#: ../examples/guestfs-faq.pod:335 msgid "" "If you don't have or want to use Koji, then you have to give libguestfs " "access to the network so it can download the RPMs for building the " @@ -4712,7 +4725,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:337 +#: ../examples/guestfs-faq.pod:341 #, no-wrap msgid "" " %libguestfs_buildnet 1\n" @@ -4720,12 +4733,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:339 +#: ../examples/guestfs-faq.pod:343 msgid "If you are using mock, do:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:341 +#: ../examples/guestfs-faq.pod:345 #, no-wrap msgid "" " mock -D '%libguestfs_buildnet 1' [etc]\n" @@ -4733,22 +4746,22 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:343 +#: ../examples/guestfs-faq.pod:347 msgid "Libguestfs has a really long list of dependencies!" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:345 +#: ../examples/guestfs-faq.pod:349 msgid "That's because it does a lot of things." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:347 +#: ../examples/guestfs-faq.pod:351 msgid "How can I speed up libguestfs builds?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:349 +#: ../examples/guestfs-faq.pod:353 msgid "" "By far the most important thing you can do is to install and properly " "configure Squid. Note that the default configuration that ships with Squid " @@ -4756,45 +4769,45 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:353 +#: ../examples/guestfs-faq.pod:357 msgid "" "A very good place to start with Squid configuration is here: " "L<https://fedoraproject.org/wiki/Extras/MockTricks#Using_Squid_to_Speed_Up_Mock_package_downloads>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:356 +#: ../examples/guestfs-faq.pod:360 msgid "" "Make sure Squid is running, and that the environment variables " "C<$http_proxy> and C<$ftp_proxy> are pointing to it." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:359 +#: ../examples/guestfs-faq.pod:363 msgid "" "With Squid running and correctly configured, appliance builds should be " "reduced to a few minutes." msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:362 +#: ../examples/guestfs-faq.pod:366 msgid "SPEED, DISK SPACE USED BY LIBGUESTFS" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:364 +#: ../examples/guestfs-faq.pod:368 msgid "" "Note: Most of the information in this section has moved: " "L<guestfs-performance(1)>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:367 +#: ../examples/guestfs-faq.pod:371 msgid "Upload or write seem very slow." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:369 +#: ../examples/guestfs-faq.pod:373 msgid "" "In libguestfs E<lt> 1.13.16, the mount command (L<guestfs(3)/guestfs_mount>) " "enabled option C<-o sync> implicitly. This causes very poor write " @@ -4802,14 +4815,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:374 +#: ../examples/guestfs-faq.pod:378 msgid "" "For libguestfs E<lt> 1.13.16, replace mount with C<mount-options>, leaving " "the first parameter as an empty string." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:377 +#: ../examples/guestfs-faq.pod:381 msgid "" "You can also do this with more recent versions of libguestfs, but if you " "know that you are using libguestfs ≥ 1.13.16 then it's safe to use plain " @@ -4817,7 +4830,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:381 +#: ../examples/guestfs-faq.pod:385 msgid "" "If the underlying disk is not fully allocated (eg. sparse raw or qcow2) then " "writes can be slow because the host operating system has to do costly disk " @@ -4827,17 +4840,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:387 +#: ../examples/guestfs-faq.pod:391 msgid "Libguestfs uses too much disk space!" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:389 +#: ../examples/guestfs-faq.pod:393 msgid "libguestfs caches a large-ish appliance in:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:391 +#: ../examples/guestfs-faq.pod:395 #, no-wrap msgid "" " /var/tmp/.guestfs-<UID>\n" @@ -4845,36 +4858,36 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:393 +#: ../examples/guestfs-faq.pod:397 msgid "" "If the environment variable C<TMPDIR> is defined, then " "C<$TMPDIR/.guestfs-E<lt>UIDE<gt>> is used instead." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:396 +#: ../examples/guestfs-faq.pod:400 msgid "It is safe to delete this directory when you are not using libguestfs." msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:398 +#: ../examples/guestfs-faq.pod:402 msgid "USING LIBGUESTFS IN YOUR OWN PROGRAMS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:400 +#: ../examples/guestfs-faq.pod:404 msgid "The API has hundreds of methods, where do I start?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:402 +#: ../examples/guestfs-faq.pod:406 msgid "" "We recommend you start by reading the API overview: L<guestfs(3)/API " "OVERVIEW>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:405 +#: ../examples/guestfs-faq.pod:409 msgid "" "Although the API overview covers the C API, it is still worth reading even " "if you are going to use another programming language, because the API is the " @@ -4882,7 +4895,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:410 +#: ../examples/guestfs-faq.pod:414 #, no-wrap msgid "" " C guestfs_ln_sf (g, target, linkname);\n" @@ -4895,7 +4908,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:417 +#: ../examples/guestfs-faq.pod:421 msgid "" "Once you're familiar with the API overview, you should look at this list of " "starting points for other language bindings: L<guestfs(3)/USING LIBGUESTFS " @@ -4903,17 +4916,17 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:423 +#: ../examples/guestfs-faq.pod:427 msgid "<!-- old anchor for the next section --> <a name=\"debug\"/>" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:428 +#: ../examples/guestfs-faq.pod:432 msgid "Can I use libguestfs in my proprietary / closed source / commercial program?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:430 +#: ../examples/guestfs-faq.pod:434 msgid "" "In general, yes. However this is not legal advice. You should read the " "license that comes with libguestfs, and if you have specific questions about " @@ -4923,43 +4936,43 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:437 +#: ../examples/guestfs-faq.pod:441 msgid "DEBUGGING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:439 +#: ../examples/guestfs-faq.pod:443 msgid "" "How do I debug when using any libguestfs program or tool (eg. virt-v2v or " "virt-df)?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:442 +#: ../examples/guestfs-faq.pod:446 msgid "" "There are two C<LIBGUESTFS_*> environment variables you can set in order to " "get more information from libguestfs." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:447 +#: ../examples/guestfs-faq.pod:451 msgid "C<LIBGUESTFS_TRACE>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:449 +#: ../examples/guestfs-faq.pod:453 msgid "" "Set this to 1 and libguestfs will print out each command / API call in a " "format which is similar to guestfish commands." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:452 +#: ../examples/guestfs-faq.pod:456 msgid "C<LIBGUESTFS_DEBUG>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:454 +#: ../examples/guestfs-faq.pod:458 msgid "" "Set this to 1 in order to enable massive amounts of debug messages. If you " "think there is some problem inside the libguestfs appliance, then you should " @@ -4967,12 +4980,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:460 +#: ../examples/guestfs-faq.pod:464 msgid "To set these from the shell, do this before running the program:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:462 +#: ../examples/guestfs-faq.pod:466 #, no-wrap msgid "" " export LIBGUESTFS_TRACE=1\n" @@ -4981,12 +4994,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:465 +#: ../examples/guestfs-faq.pod:469 msgid "For csh/tcsh the equivalent commands would be:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:467 +#: ../examples/guestfs-faq.pod:471 #, no-wrap msgid "" " setenv LIBGUESTFS_TRACE 1\n" @@ -4995,17 +5008,17 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:470 +#: ../examples/guestfs-faq.pod:474 msgid "For further information, see: L<guestfs(3)/ENVIRONMENT VARIABLES>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:472 +#: ../examples/guestfs-faq.pod:476 msgid "How do I debug when using guestfish?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:474 +#: ../examples/guestfs-faq.pod:478 msgid "" "You can use the same environment variables above. Alternatively use the " "guestfish options -x (to trace commands) or -v (to get the full debug " @@ -5013,24 +5026,24 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:478 +#: ../examples/guestfs-faq.pod:482 msgid "For further information, see: L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:480 +#: ../examples/guestfs-faq.pod:484 msgid "How do I debug when using the API?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:482 +#: ../examples/guestfs-faq.pod:486 msgid "" "Call L<guestfs(3)/guestfs_set_trace> to enable command traces, and/or " "L<guestfs(3)/guestfs_set_verbose> to enable debug messages." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:485 +#: ../examples/guestfs-faq.pod:489 msgid "" "For best results, call these functions as early as possible, just after " "creating the guestfs handle if you can, and definitely before calling " @@ -5038,36 +5051,36 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:489 +#: ../examples/guestfs-faq.pod:493 msgid "How do I capture debug output and put it into my logging system?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:491 +#: ../examples/guestfs-faq.pod:495 msgid "" "Use the event API. For examples, see: L<guestfs(3)/SETTING CALLBACKS TO " "HANDLE EVENTS>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:494 +#: ../examples/guestfs-faq.pod:498 msgid "Digging deeper into the appliance boot process." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:496 +#: ../examples/guestfs-faq.pod:500 msgid "" "Enable debugging and then read this documentation on the appliance boot " "process: L<guestfs(3)/INTERNALS>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:499 +#: ../examples/guestfs-faq.pod:503 msgid "libguestfs hangs or fails during run/launch." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:501 +#: ../examples/guestfs-faq.pod:505 msgid "" "Enable debugging and look at the full output. If you cannot work out what " "is going on, file a bug report, including the I<complete> output of " @@ -5075,17 +5088,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:505 +#: ../examples/guestfs-faq.pod:509 msgid "DESIGN/INTERNALS OF LIBGUESTFS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:507 +#: ../examples/guestfs-faq.pod:511 msgid "Why don't you do everything through the FUSE / filesystem interface?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:510 +#: ../examples/guestfs-faq.pod:514 msgid "" "We offer a command called L<guestmount(1)> which lets you mount guest " "filesystems on the host. This is implemented as a FUSE module. Why don't " @@ -5094,7 +5107,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:515 +#: ../examples/guestfs-faq.pod:519 msgid "" "The reasons are twofold. Firstly, libguestfs offers API calls for doing " "things like creating and deleting partitions and logical volumes, which " @@ -5108,7 +5121,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:525 +#: ../examples/guestfs-faq.pod:529 msgid "" "The second reason is for efficiency. FUSE itself is reasonably efficient, " "but it does make lots of small, independent calls into the FUSE module. In " @@ -5121,17 +5134,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:535 +#: ../examples/guestfs-faq.pod:539 msgid "Why don't you do everything through GVFS?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:537 +#: ../examples/guestfs-faq.pod:541 msgid "The problems are similar to the problems with FUSE." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:539 +#: ../examples/guestfs-faq.pod:543 msgid "" "GVFS is a better abstraction than POSIX/FUSE. There is an FTP backend for " "GVFS, which is encouraging because FTP is conceptually similar to the " @@ -5141,12 +5154,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:545 +#: ../examples/guestfs-faq.pod:549 msgid "Can I use C<guestfish --ro> as a way to backup my virtual machines?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:547 +#: ../examples/guestfs-faq.pod:551 msgid "" "Usually this is not a good idea. The question is answered in more detail in " "this mailing list posting: " @@ -5154,19 +5167,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:551 +#: ../examples/guestfs-faq.pod:555 msgid "What's the difference between guestfish and virt-rescue?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:553 +#: ../examples/guestfs-faq.pod:557 msgid "" "A lot of people are confused by the two superficially similar tools we " "provide:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:556 +#: ../examples/guestfs-faq.pod:560 #, no-wrap msgid "" " $ guestfish --ro -a guest.img\n" @@ -5176,7 +5189,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:560 +#: ../examples/guestfs-faq.pod:564 #, no-wrap msgid "" " $ virt-rescue --ro guest.img\n" @@ -5185,7 +5198,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:563 +#: ../examples/guestfs-faq.pod:567 msgid "" "And the related question which then arises is why you can't type in full " "shell commands with all the --options in guestfish (but you can in " @@ -5193,7 +5206,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:567 +#: ../examples/guestfs-faq.pod:571 msgid "" "L<guestfish(1)> is a program providing structured access to the " "L<guestfs(3)> API. It happens to be a nice interactive shell too, but its " @@ -5204,7 +5217,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:574 +#: ../examples/guestfs-faq.pod:578 msgid "" "L<virt-rescue(1)> is a free-for-all freeform way to boot the libguestfs " "appliance and make arbitrary changes to your VM. It's not structured, you " @@ -5213,7 +5226,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:579 +#: ../examples/guestfs-faq.pod:583 msgid "" "But, libguestfs also has a \"backdoor\" into the appliance allowing you to " "send arbitrary shell commands. It's not as flexible as virt-rescue, because " @@ -5221,7 +5234,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:584 +#: ../examples/guestfs-faq.pod:588 #, no-wrap msgid "" " ><fs> debug sh \"cmd arg1 arg2 ...\"\n" @@ -5229,7 +5242,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:586 +#: ../examples/guestfs-faq.pod:590 msgid "" "Note that you should B<not> rely on this. It could be removed or changed in " "future. If your program needs some operation, please add it to the " @@ -5237,7 +5250,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:590 +#: ../examples/guestfs-faq.pod:594 msgid "" "What's the deal with C<guestfish -i>? Why does virt-cat only work on a real " "VM image, but virt-df works on any disk image? What does \"no root device " @@ -5245,28 +5258,28 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:595 +#: ../examples/guestfs-faq.pod:599 msgid "" "These questions are all related at a fundamental level which may not be " "immediately obvious." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:598 +#: ../examples/guestfs-faq.pod:602 msgid "" "At the L<guestfs(3)> API level, a \"disk image\" is just a pile of " "partitions and filesystems." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:601 +#: ../examples/guestfs-faq.pod:605 msgid "" "In contrast, when the virtual machine boots, it mounts those filesystems " "into a consistent hierarchy such as:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:604 +#: ../examples/guestfs-faq.pod:608 #, no-wrap msgid "" " / (/dev/sda2)\n" @@ -5282,12 +5295,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:614 +#: ../examples/guestfs-faq.pod:618 msgid "(or drive letters on Windows)." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:616 +#: ../examples/guestfs-faq.pod:620 msgid "" "The API first of all sees the disk image at the \"pile of filesystems\" " "level. But it also has a way to inspect the disk image to see if it " @@ -5296,12 +5309,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:621 +#: ../examples/guestfs-faq.pod:625 msgid "Users expect some tools (like L<virt-cat(1)>) to work with VM paths:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:623 +#: ../examples/guestfs-faq.pod:627 #, no-wrap msgid "" " virt-cat fedora.img /var/log/messages\n" @@ -5309,7 +5322,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:625 +#: ../examples/guestfs-faq.pod:629 msgid "" "How does virt-cat know that C</var> is a separate partition? The trick is " "that virt-cat performs inspection on the disk image, and uses that to " @@ -5317,7 +5330,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:629 +#: ../examples/guestfs-faq.pod:633 msgid "" "Some tools (including L<virt-cat(1)>, L<virt-edit(1)>, L<virt-ls(1)>) use " "inspection to map VM paths. Other tools, such as L<virt-df(1)> and " @@ -5326,7 +5339,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:634 +#: ../examples/guestfs-faq.pod:638 msgid "" "L<guestfish(1)> is in an interesting middle ground. If you use the I<-a> " "and I<-m> command line options, then you have to tell guestfish exactly how " @@ -5334,14 +5347,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:639 +#: ../examples/guestfs-faq.pod:643 msgid "" "If you use the I<-i> option, libguestfs performs inspection and mounts the " "filesystems for you." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:642 +#: ../examples/guestfs-faq.pod:646 msgid "" "The error C<no root device found in this operating system image> is related " "to this. It means inspection was unable to locate an operating system " @@ -5351,12 +5364,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:650 +#: ../examples/guestfs-faq.pod:654 msgid "L<guestfish(1)>, L<guestfs(3)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:660 ../examples/guestfs-performance.pod:381 +#: ../examples/guestfs-faq.pod:664 ../examples/guestfs-performance.pod:381 msgid "Copyright (C) 2012 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" diff --git a/po-docs/uk.po b/po-docs/uk.po index d7536804..48809cb3 100644 --- a/po-docs/uk.po +++ b/po-docs/uk.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: libguestfs\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2012-06-14 16:19+0200\n" +"POT-Creation-Date: 2012-06-22 22:05+0200\n" "PO-Revision-Date: 2012-05-21 13:20+0000\n" "Last-Translator: rjones <rjones@redhat.com>\n" "Language-Team: Ukrainian <trans-uk@lists.fedoraproject.org>\n" @@ -1207,7 +1207,7 @@ msgstr "" #: ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:389 #: ../cat/virt-ls.pod:495 ../df/virt-df.pod:253 ../edit/virt-edit.pod:368 #: ../erlang/examples/guestfs-erlang.pod:97 -#: ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:648 +#: ../examples/guestfs-examples.pod:33 ../examples/guestfs-faq.pod:652 #: ../examples/guestfs-performance.pod:364 ../examples/guestfs-recipes.pod:384 #: ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1280 #: ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 @@ -1265,7 +1265,7 @@ msgstr "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" #: ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:404 #: ../cat/virt-ls.pod:511 ../df/virt-df.pod:265 ../edit/virt-edit.pod:386 #: ../erlang/examples/guestfs-erlang.pod:114 -#: ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:658 +#: ../examples/guestfs-examples.pod:49 ../examples/guestfs-faq.pod:662 #: ../examples/guestfs-performance.pod:379 ../examples/guestfs-recipes.pod:401 #: ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1312 #: ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 @@ -1662,7 +1662,7 @@ msgstr "" #. type: =head1 #: ../appliance/libguestfs-make-fixed-appliance.pod:153 #: ../erlang/examples/guestfs-erlang.pod:110 -#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:654 +#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-faq.pod:658 #: ../examples/guestfs-performance.pod:375 ../examples/guestfs-recipes.pod:397 #: ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1308 #: ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 @@ -1679,7 +1679,7 @@ msgstr "АВТОРИ" #. type: textblock #: ../appliance/libguestfs-make-fixed-appliance.pod:155 #: ../erlang/examples/guestfs-erlang.pod:112 -#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:656 +#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-faq.pod:660 #: ../examples/guestfs-performance.pod:377 ../examples/guestfs-recipes.pod:399 #: ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1310 #: ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 @@ -4776,7 +4776,7 @@ msgstr "" #. type: textblock #: ../erlang/examples/guestfs-erlang.pod:121 -#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:662 +#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-faq.pod:666 #: ../examples/guestfs-performance.pod:383 ../examples/guestfs-recipes.pod:408 #: ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 #: ../ocaml/examples/guestfs-ocaml.pod:102 @@ -4792,7 +4792,7 @@ msgstr "" #. type: textblock #: ../erlang/examples/guestfs-erlang.pod:126 -#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:667 +#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-faq.pod:671 #: ../examples/guestfs-performance.pod:388 ../examples/guestfs-recipes.pod:413 #: ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 #: ../ocaml/examples/guestfs-ocaml.pod:107 @@ -4812,7 +4812,7 @@ msgstr "" #. type: textblock #: ../erlang/examples/guestfs-erlang.pod:131 -#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:672 +#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-faq.pod:676 #: ../examples/guestfs-performance.pod:393 ../examples/guestfs-recipes.pod:418 #: ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 #: ../ocaml/examples/guestfs-ocaml.pod:112 @@ -5360,7 +5360,7 @@ msgstr "" #. type: =end #: ../examples/guestfs-faq.pod:219 ../examples/guestfs-faq.pod:224 -#: ../examples/guestfs-faq.pod:421 ../examples/guestfs-faq.pod:426 +#: ../examples/guestfs-faq.pod:425 ../examples/guestfs-faq.pod:430 #: ../src/guestfs.pod:2332 ../src/guestfs.pod:2337 msgid "html" msgstr "html" @@ -5475,7 +5475,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:272 ../examples/guestfs-faq.pod:294 +#: ../examples/guestfs-faq.pod:272 ../examples/guestfs-faq.pod:298 #, no-wrap msgid "" " sudo chmod 0644 /boot/vmlinuz*\n" @@ -5513,6 +5513,19 @@ msgstr "" #. type: textblock #: ../examples/guestfs-faq.pod:287 +msgid "After installing or updating febootstrap, rebuild the appliance:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-faq.pod:289 +#, no-wrap +msgid "" +" sudo update-guestfs-appliance\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-faq.pod:291 msgid "" "You need seabios E<ge> 0.6.2-0ubuntu2.1 or E<ge> 0.6.2-0ubuntu3 from: " "L<http://packages.ubuntu.com/precise-updates/seabios> or L<http://packages." @@ -5520,37 +5533,37 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:292 +#: ../examples/guestfs-faq.pod:296 msgid "Also you need to do (see above):" msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:296 +#: ../examples/guestfs-faq.pod:300 msgid "Other Linux distro" msgstr "Інші дистрибутиви Linux" #. type: textblock -#: ../examples/guestfs-faq.pod:298 +#: ../examples/guestfs-faq.pod:302 msgid "Compile from source (next section)." msgstr "Можна зібрати з початкових кодів (наступний розділ)." #. type: =item -#: ../examples/guestfs-faq.pod:300 +#: ../examples/guestfs-faq.pod:304 msgid "Other non-Linux distro" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:302 +#: ../examples/guestfs-faq.pod:306 msgid "You'll have to compile from source, and port it." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:306 +#: ../examples/guestfs-faq.pod:310 msgid "How can I compile and install libguestfs from source?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:308 +#: ../examples/guestfs-faq.pod:312 msgid "" "If your Linux distro has a working port of febootstrap (that is, Fedora, Red " "Hat Enterprise Linux >= 6.3, Debian, Ubuntu and ArchLinux) then you should " @@ -5560,33 +5573,33 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:314 +#: ../examples/guestfs-faq.pod:318 msgid "" "If you I<don't> have febootstrap, you will need to use the \"fixed appliance " "method\". See: L<http://libguestfs.org/download/binaries/appliance/>" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:318 +#: ../examples/guestfs-faq.pod:322 msgid "Patches to port febootstrap to more Linux distros are welcome." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:320 +#: ../examples/guestfs-faq.pod:324 msgid "" "Why do I get an error when I try to rebuild from the source RPMs supplied by " "Red Hat / Fedora?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:323 +#: ../examples/guestfs-faq.pod:327 msgid "" "Because of the complexity of building the libguestfs appliance, the source " "RPMs provided cannot be rebuilt directly using C<rpmbuild> or C<mock>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:327 +#: ../examples/guestfs-faq.pod:331 msgid "" "If you use Koji (which is open source software and may be installed " "locally), then the SRPMs can be rebuilt in Koji. L<https://fedoraproject." @@ -5594,7 +5607,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:331 +#: ../examples/guestfs-faq.pod:335 msgid "" "If you don't have or want to use Koji, then you have to give libguestfs " "access to the network so it can download the RPMs for building the " @@ -5603,7 +5616,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:337 +#: ../examples/guestfs-faq.pod:341 #, no-wrap msgid "" " %libguestfs_buildnet 1\n" @@ -5611,12 +5624,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:339 +#: ../examples/guestfs-faq.pod:343 msgid "If you are using mock, do:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:341 +#: ../examples/guestfs-faq.pod:345 #, no-wrap msgid "" " mock -D '%libguestfs_buildnet 1' [etc]\n" @@ -5624,22 +5637,22 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:343 +#: ../examples/guestfs-faq.pod:347 msgid "Libguestfs has a really long list of dependencies!" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:345 +#: ../examples/guestfs-faq.pod:349 msgid "That's because it does a lot of things." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:347 +#: ../examples/guestfs-faq.pod:351 msgid "How can I speed up libguestfs builds?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:349 +#: ../examples/guestfs-faq.pod:353 msgid "" "By far the most important thing you can do is to install and properly " "configure Squid. Note that the default configuration that ships with Squid " @@ -5647,7 +5660,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:353 +#: ../examples/guestfs-faq.pod:357 msgid "" "A very good place to start with Squid configuration is here: L<https://" "fedoraproject.org/wiki/Extras/" @@ -5655,38 +5668,38 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:356 +#: ../examples/guestfs-faq.pod:360 msgid "" "Make sure Squid is running, and that the environment variables C<" "$http_proxy> and C<$ftp_proxy> are pointing to it." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:359 +#: ../examples/guestfs-faq.pod:363 msgid "" "With Squid running and correctly configured, appliance builds should be " "reduced to a few minutes." msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:362 +#: ../examples/guestfs-faq.pod:366 msgid "SPEED, DISK SPACE USED BY LIBGUESTFS" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:364 +#: ../examples/guestfs-faq.pod:368 msgid "" "Note: Most of the information in this section has moved: L<guestfs-" "performance(1)>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:367 +#: ../examples/guestfs-faq.pod:371 msgid "Upload or write seem very slow." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:369 +#: ../examples/guestfs-faq.pod:373 msgid "" "In libguestfs E<lt> 1.13.16, the mount command (L<guestfs(3)/guestfs_mount>) " "enabled option C<-o sync> implicitly. This causes very poor write " @@ -5694,14 +5707,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:374 +#: ../examples/guestfs-faq.pod:378 msgid "" "For libguestfs E<lt> 1.13.16, replace mount with C<mount-options>, leaving " "the first parameter as an empty string." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:377 +#: ../examples/guestfs-faq.pod:381 msgid "" "You can also do this with more recent versions of libguestfs, but if you " "know that you are using libguestfs ≥ 1.13.16 then it's safe to use plain " @@ -5709,7 +5722,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:381 +#: ../examples/guestfs-faq.pod:385 msgid "" "If the underlying disk is not fully allocated (eg. sparse raw or qcow2) then " "writes can be slow because the host operating system has to do costly disk " @@ -5719,17 +5732,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:387 +#: ../examples/guestfs-faq.pod:391 msgid "Libguestfs uses too much disk space!" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:389 +#: ../examples/guestfs-faq.pod:393 msgid "libguestfs caches a large-ish appliance in:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:391 +#: ../examples/guestfs-faq.pod:395 #, no-wrap msgid "" " /var/tmp/.guestfs-<UID>\n" @@ -5737,36 +5750,36 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:393 +#: ../examples/guestfs-faq.pod:397 msgid "" "If the environment variable C<TMPDIR> is defined, then C<$TMPDIR/.guestfs-" "E<lt>UIDE<gt>> is used instead." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:396 +#: ../examples/guestfs-faq.pod:400 msgid "It is safe to delete this directory when you are not using libguestfs." msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:398 +#: ../examples/guestfs-faq.pod:402 msgid "USING LIBGUESTFS IN YOUR OWN PROGRAMS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:400 +#: ../examples/guestfs-faq.pod:404 msgid "The API has hundreds of methods, where do I start?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:402 +#: ../examples/guestfs-faq.pod:406 msgid "" "We recommend you start by reading the API overview: L<guestfs(3)/API " "OVERVIEW>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:405 +#: ../examples/guestfs-faq.pod:409 msgid "" "Although the API overview covers the C API, it is still worth reading even " "if you are going to use another programming language, because the API is the " @@ -5774,7 +5787,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:410 +#: ../examples/guestfs-faq.pod:414 #, no-wrap msgid "" " C guestfs_ln_sf (g, target, linkname);\n" @@ -5787,7 +5800,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:417 +#: ../examples/guestfs-faq.pod:421 msgid "" "Once you're familiar with the API overview, you should look at this list of " "starting points for other language bindings: L<guestfs(3)/USING LIBGUESTFS " @@ -5795,18 +5808,18 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:423 +#: ../examples/guestfs-faq.pod:427 msgid "<!-- old anchor for the next section --> <a name=\"debug\"/>" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:428 +#: ../examples/guestfs-faq.pod:432 msgid "" "Can I use libguestfs in my proprietary / closed source / commercial program?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:430 +#: ../examples/guestfs-faq.pod:434 msgid "" "In general, yes. However this is not legal advice. You should read the " "license that comes with libguestfs, and if you have specific questions about " @@ -5816,43 +5829,43 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:437 +#: ../examples/guestfs-faq.pod:441 msgid "DEBUGGING LIBGUESTFS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:439 +#: ../examples/guestfs-faq.pod:443 msgid "" "How do I debug when using any libguestfs program or tool (eg. virt-v2v or " "virt-df)?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:442 +#: ../examples/guestfs-faq.pod:446 msgid "" "There are two C<LIBGUESTFS_*> environment variables you can set in order to " "get more information from libguestfs." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:447 +#: ../examples/guestfs-faq.pod:451 msgid "C<LIBGUESTFS_TRACE>" msgstr "C<LIBGUESTFS_TRACE>" #. type: textblock -#: ../examples/guestfs-faq.pod:449 +#: ../examples/guestfs-faq.pod:453 msgid "" "Set this to 1 and libguestfs will print out each command / API call in a " "format which is similar to guestfish commands." msgstr "" #. type: =item -#: ../examples/guestfs-faq.pod:452 +#: ../examples/guestfs-faq.pod:456 msgid "C<LIBGUESTFS_DEBUG>" msgstr "C<LIBGUESTFS_DEBUG>" #. type: textblock -#: ../examples/guestfs-faq.pod:454 +#: ../examples/guestfs-faq.pod:458 msgid "" "Set this to 1 in order to enable massive amounts of debug messages. If you " "think there is some problem inside the libguestfs appliance, then you should " @@ -5860,12 +5873,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:460 +#: ../examples/guestfs-faq.pod:464 msgid "To set these from the shell, do this before running the program:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:462 +#: ../examples/guestfs-faq.pod:466 #, no-wrap msgid "" " export LIBGUESTFS_TRACE=1\n" @@ -5874,12 +5887,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:465 +#: ../examples/guestfs-faq.pod:469 msgid "For csh/tcsh the equivalent commands would be:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:467 +#: ../examples/guestfs-faq.pod:471 #, no-wrap msgid "" " setenv LIBGUESTFS_TRACE 1\n" @@ -5888,17 +5901,17 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:470 +#: ../examples/guestfs-faq.pod:474 msgid "For further information, see: L<guestfs(3)/ENVIRONMENT VARIABLES>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:472 +#: ../examples/guestfs-faq.pod:476 msgid "How do I debug when using guestfish?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:474 +#: ../examples/guestfs-faq.pod:478 msgid "" "You can use the same environment variables above. Alternatively use the " "guestfish options -x (to trace commands) or -v (to get the full debug " @@ -5906,60 +5919,60 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:478 +#: ../examples/guestfs-faq.pod:482 msgid "For further information, see: L<guestfish(1)>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:480 +#: ../examples/guestfs-faq.pod:484 msgid "How do I debug when using the API?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:482 +#: ../examples/guestfs-faq.pod:486 msgid "" "Call L<guestfs(3)/guestfs_set_trace> to enable command traces, and/or " "L<guestfs(3)/guestfs_set_verbose> to enable debug messages." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:485 +#: ../examples/guestfs-faq.pod:489 msgid "" "For best results, call these functions as early as possible, just after " "creating the guestfs handle if you can, and definitely before calling launch." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:489 +#: ../examples/guestfs-faq.pod:493 msgid "How do I capture debug output and put it into my logging system?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:491 +#: ../examples/guestfs-faq.pod:495 msgid "" "Use the event API. For examples, see: L<guestfs(3)/SETTING CALLBACKS TO " "HANDLE EVENTS>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:494 +#: ../examples/guestfs-faq.pod:498 msgid "Digging deeper into the appliance boot process." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:496 +#: ../examples/guestfs-faq.pod:500 msgid "" "Enable debugging and then read this documentation on the appliance boot " "process: L<guestfs(3)/INTERNALS>." msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:499 +#: ../examples/guestfs-faq.pod:503 msgid "libguestfs hangs or fails during run/launch." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:501 +#: ../examples/guestfs-faq.pod:505 msgid "" "Enable debugging and look at the full output. If you cannot work out what " "is going on, file a bug report, including the I<complete> output of " @@ -5967,17 +5980,17 @@ msgid "" msgstr "" #. type: =head1 -#: ../examples/guestfs-faq.pod:505 +#: ../examples/guestfs-faq.pod:509 msgid "DESIGN/INTERNALS OF LIBGUESTFS" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:507 +#: ../examples/guestfs-faq.pod:511 msgid "Why don't you do everything through the FUSE / filesystem interface?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:510 +#: ../examples/guestfs-faq.pod:514 msgid "" "We offer a command called L<guestmount(1)> which lets you mount guest " "filesystems on the host. This is implemented as a FUSE module. Why don't " @@ -5986,7 +5999,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:515 +#: ../examples/guestfs-faq.pod:519 msgid "" "The reasons are twofold. Firstly, libguestfs offers API calls for doing " "things like creating and deleting partitions and logical volumes, which " @@ -6000,7 +6013,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:525 +#: ../examples/guestfs-faq.pod:529 msgid "" "The second reason is for efficiency. FUSE itself is reasonably efficient, " "but it does make lots of small, independent calls into the FUSE module. In " @@ -6013,17 +6026,17 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:535 +#: ../examples/guestfs-faq.pod:539 msgid "Why don't you do everything through GVFS?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:537 +#: ../examples/guestfs-faq.pod:541 msgid "The problems are similar to the problems with FUSE." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:539 +#: ../examples/guestfs-faq.pod:543 msgid "" "GVFS is a better abstraction than POSIX/FUSE. There is an FTP backend for " "GVFS, which is encouraging because FTP is conceptually similar to the " @@ -6033,12 +6046,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:545 +#: ../examples/guestfs-faq.pod:549 msgid "Can I use C<guestfish --ro> as a way to backup my virtual machines?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:547 +#: ../examples/guestfs-faq.pod:551 msgid "" "Usually this is not a good idea. The question is answered in more detail in " "this mailing list posting: L<https://www.redhat.com/archives/libguestfs/2010-" @@ -6046,19 +6059,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:551 +#: ../examples/guestfs-faq.pod:555 msgid "What's the difference between guestfish and virt-rescue?" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:553 +#: ../examples/guestfs-faq.pod:557 msgid "" "A lot of people are confused by the two superficially similar tools we " "provide:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:556 +#: ../examples/guestfs-faq.pod:560 #, no-wrap msgid "" " $ guestfish --ro -a guest.img\n" @@ -6068,7 +6081,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:560 +#: ../examples/guestfs-faq.pod:564 #, no-wrap msgid "" " $ virt-rescue --ro guest.img\n" @@ -6077,7 +6090,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:563 +#: ../examples/guestfs-faq.pod:567 msgid "" "And the related question which then arises is why you can't type in full " "shell commands with all the --options in guestfish (but you can in L<virt-" @@ -6085,7 +6098,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:567 +#: ../examples/guestfs-faq.pod:571 msgid "" "L<guestfish(1)> is a program providing structured access to the L<guestfs(3)" "> API. It happens to be a nice interactive shell too, but its primary " @@ -6096,7 +6109,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:574 +#: ../examples/guestfs-faq.pod:578 msgid "" "L<virt-rescue(1)> is a free-for-all freeform way to boot the libguestfs " "appliance and make arbitrary changes to your VM. It's not structured, you " @@ -6105,7 +6118,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:579 +#: ../examples/guestfs-faq.pod:583 msgid "" "But, libguestfs also has a \"backdoor\" into the appliance allowing you to " "send arbitrary shell commands. It's not as flexible as virt-rescue, because " @@ -6113,7 +6126,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:584 +#: ../examples/guestfs-faq.pod:588 #, no-wrap msgid "" " ><fs> debug sh \"cmd arg1 arg2 ...\"\n" @@ -6121,7 +6134,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:586 +#: ../examples/guestfs-faq.pod:590 msgid "" "Note that you should B<not> rely on this. It could be removed or changed in " "future. If your program needs some operation, please add it to the " @@ -6129,7 +6142,7 @@ msgid "" msgstr "" #. type: =head2 -#: ../examples/guestfs-faq.pod:590 +#: ../examples/guestfs-faq.pod:594 msgid "" "What's the deal with C<guestfish -i>? Why does virt-cat only work on a real " "VM image, but virt-df works on any disk image? What does \"no root device " @@ -6137,28 +6150,28 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:595 +#: ../examples/guestfs-faq.pod:599 msgid "" "These questions are all related at a fundamental level which may not be " "immediately obvious." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:598 +#: ../examples/guestfs-faq.pod:602 msgid "" "At the L<guestfs(3)> API level, a \"disk image\" is just a pile of " "partitions and filesystems." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:601 +#: ../examples/guestfs-faq.pod:605 msgid "" "In contrast, when the virtual machine boots, it mounts those filesystems " "into a consistent hierarchy such as:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:604 +#: ../examples/guestfs-faq.pod:608 #, no-wrap msgid "" " / (/dev/sda2)\n" @@ -6174,12 +6187,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:614 +#: ../examples/guestfs-faq.pod:618 msgid "(or drive letters on Windows)." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:616 +#: ../examples/guestfs-faq.pod:620 msgid "" "The API first of all sees the disk image at the \"pile of filesystems\" " "level. But it also has a way to inspect the disk image to see if it " @@ -6188,12 +6201,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:621 +#: ../examples/guestfs-faq.pod:625 msgid "Users expect some tools (like L<virt-cat(1)>) to work with VM paths:" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:623 +#: ../examples/guestfs-faq.pod:627 #, no-wrap msgid "" " virt-cat fedora.img /var/log/messages\n" @@ -6201,7 +6214,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:625 +#: ../examples/guestfs-faq.pod:629 msgid "" "How does virt-cat know that C</var> is a separate partition? The trick is " "that virt-cat performs inspection on the disk image, and uses that to " @@ -6209,7 +6222,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:629 +#: ../examples/guestfs-faq.pod:633 msgid "" "Some tools (including L<virt-cat(1)>, L<virt-edit(1)>, L<virt-ls(1)>) use " "inspection to map VM paths. Other tools, such as L<virt-df(1)> and L<virt-" @@ -6218,7 +6231,7 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:634 +#: ../examples/guestfs-faq.pod:638 msgid "" "L<guestfish(1)> is in an interesting middle ground. If you use the I<-a> " "and I<-m> command line options, then you have to tell guestfish exactly how " @@ -6226,14 +6239,14 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:639 +#: ../examples/guestfs-faq.pod:643 msgid "" "If you use the I<-i> option, libguestfs performs inspection and mounts the " "filesystems for you." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:642 +#: ../examples/guestfs-faq.pod:646 msgid "" "The error C<no root device found in this operating system image> is related " "to this. It means inspection was unable to locate an operating system " @@ -6243,12 +6256,12 @@ msgid "" msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:650 +#: ../examples/guestfs-faq.pod:654 msgid "L<guestfish(1)>, L<guestfs(3)>, L<http://libguestfs.org/>." msgstr "" #. type: textblock -#: ../examples/guestfs-faq.pod:660 ../examples/guestfs-performance.pod:381 +#: ../examples/guestfs-faq.pod:664 ../examples/guestfs-performance.pod:381 msgid "Copyright (C) 2012 Red Hat Inc. L<http://libguestfs.org/>" msgstr "" |