diff options
Diffstat (limited to 'po-docs/uk.po')
| -rw-r--r-- | po-docs/uk.po | 305 |
1 files changed, 174 insertions, 131 deletions
diff --git a/po-docs/uk.po b/po-docs/uk.po index ff1f1c61..60daa9fb 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-01 20:31+0200\n" +"POT-Creation-Date: 2012-06-21 13:32+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" @@ -1022,7 +1022,7 @@ msgstr "" #. type: =head1 #: ../align/virt-alignment-scan.pod:334 ../cat/virt-cat.pod:231 #: ../cat/virt-filesystems.pod:377 ../cat/virt-ls.pod:483 -#: ../df/virt-df.pod:241 ../edit/virt-edit.pod:342 +#: ../df/virt-df.pod:241 ../edit/virt-edit.pod:356 #: ../inspector/virt-inspector.pod:366 ../rescue/virt-rescue.pod:318 #: ../resize/virt-resize.pod:690 ../sysprep/virt-sysprep.pod:421 #: ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 @@ -1034,7 +1034,7 @@ msgstr "ЕКРАНУВАННЯ СИМВОЛІВ У ОБОЛОНЦІ" #. type: textblock #: ../align/virt-alignment-scan.pod:336 ../cat/virt-cat.pod:233 #: ../cat/virt-filesystems.pod:379 ../cat/virt-ls.pod:485 -#: ../df/virt-df.pod:243 ../edit/virt-edit.pod:344 +#: ../df/virt-df.pod:243 ../edit/virt-edit.pod:358 #: ../inspector/virt-inspector.pod:368 ../rescue/virt-rescue.pod:320 #: ../resize/virt-resize.pod:692 ../sysprep/virt-sysprep.pod:423 #: ../tools/virt-list-filesystems.pl:192 ../tools/virt-list-partitions.pl:262 @@ -1051,7 +1051,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:341 #: ../appliance/libguestfs-make-fixed-appliance.pod:134 #: ../cat/virt-cat.pod:238 ../cat/virt-filesystems.pod:384 -#: ../cat/virt-ls.pod:490 ../df/virt-df.pod:248 ../edit/virt-edit.pod:349 +#: ../cat/virt-ls.pod:490 ../df/virt-df.pod:248 ../edit/virt-edit.pod:363 #: ../fish/guestfish.pod:1126 ../format/virt-format.pod:173 #: ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:496 #: ../resize/virt-resize.pod:697 ../sparsify/virt-sparsify.pod:254 @@ -1205,9 +1205,9 @@ msgstr "" #: ../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:354 +#: ../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 @@ -1237,7 +1237,7 @@ msgstr "" #. type: =head1 #: ../align/virt-alignment-scan.pod:384 ../cat/virt-cat.pod:252 #: ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:507 -#: ../df/virt-df.pod:261 ../edit/virt-edit.pod:368 +#: ../df/virt-df.pod:261 ../edit/virt-edit.pod:382 #: ../format/virt-format.pod:187 ../rescue/virt-rescue.pod:349 #: ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:299 #: ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 @@ -1249,7 +1249,7 @@ msgstr "АВТОР" #. type: textblock #: ../align/virt-alignment-scan.pod:386 ../cat/virt-cat.pod:254 #: ../cat/virt-filesystems.pod:402 ../cat/virt-ls.pod:509 -#: ../df/virt-df.pod:263 ../edit/virt-edit.pod:370 +#: ../df/virt-df.pod:263 ../edit/virt-edit.pod:384 #: ../format/virt-format.pod:189 ../inspector/virt-inspector.pod:516 #: ../rescue/virt-rescue.pod:351 ../resize/virt-resize.pod:727 #: ../sparsify/virt-sparsify.pod:301 ../sysprep/virt-sysprep.pod:449 @@ -1263,9 +1263,9 @@ msgstr "Richard W.M. Jones L<http://people.redhat.com/~rjones/>" #: ../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:372 +#: ../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 @@ -1292,7 +1292,7 @@ msgstr "© Red Hat Inc., 2011" #: ../align/virt-alignment-scan.pod:392 #: ../appliance/libguestfs-make-fixed-appliance.pod:162 #: ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:408 -#: ../cat/virt-ls.pod:515 ../df/virt-df.pod:269 ../edit/virt-edit.pod:376 +#: ../cat/virt-ls.pod:515 ../df/virt-df.pod:269 ../edit/virt-edit.pod:390 #: ../fish/guestfish.pod:1317 ../fish/virt-copy-in.pod:69 #: ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 #: ../fish/virt-tar-out.pod:60 ../format/virt-format.pod:195 @@ -1318,7 +1318,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:397 #: ../appliance/libguestfs-make-fixed-appliance.pod:167 #: ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:413 -#: ../cat/virt-ls.pod:520 ../df/virt-df.pod:274 ../edit/virt-edit.pod:381 +#: ../cat/virt-ls.pod:520 ../df/virt-df.pod:274 ../edit/virt-edit.pod:395 #: ../fish/guestfish.pod:1322 ../fish/virt-copy-in.pod:74 #: ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 #: ../fish/virt-tar-out.pod:65 ../format/virt-format.pod:200 @@ -1344,7 +1344,7 @@ msgstr "" #: ../align/virt-alignment-scan.pod:402 #: ../appliance/libguestfs-make-fixed-appliance.pod:172 #: ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:418 -#: ../cat/virt-ls.pod:525 ../df/virt-df.pod:279 ../edit/virt-edit.pod:386 +#: ../cat/virt-ls.pod:525 ../df/virt-df.pod:279 ../edit/virt-edit.pod:400 #: ../fish/guestfish.pod:1327 ../fish/virt-copy-in.pod:79 #: ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 #: ../fish/virt-tar-out.pod:70 ../format/virt-format.pod:205 @@ -1636,7 +1636,7 @@ msgstr "" #. type: =head1 #: ../appliance/libguestfs-make-fixed-appliance.pod:139 -#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1131 +#: ../edit/virt-edit.pod:343 ../fish/guestfish.pod:1131 #: ../rescue/virt-rescue.pod:313 ../sparsify/virt-sparsify.pod:259 #: ../src/guestfs.pod:3267 ../test-tool/libguestfs-test-tool.pod:101 msgid "ENVIRONMENT VARIABLES" @@ -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 @@ -2124,7 +2124,7 @@ msgstr "" #. type: textblock #: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:386 -#: ../cat/virt-ls.pod:492 ../df/virt-df.pod:250 ../edit/virt-edit.pod:351 +#: ../cat/virt-ls.pod:492 ../df/virt-df.pod:250 ../edit/virt-edit.pod:365 #: ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:498 #: ../resize/virt-resize.pod:699 ../sparsify/virt-sparsify.pod:256 msgid "" @@ -3664,7 +3664,7 @@ msgstr "" "L<http://libguestfs.org/>." #. type: textblock -#: ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:374 +#: ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:388 #: ../rescue/virt-rescue.pod:355 ../tools/virt-list-partitions.pl:285 msgid "Copyright (C) 2009-2012 Red Hat Inc." msgstr "© Red Hat Inc., 2009–2012" @@ -4466,25 +4466,55 @@ msgid "" "\n" msgstr "" +#. type: =head1 +#: ../edit/virt-edit.pod:329 +#, fuzzy +#| msgid "CVE-2010-3851" +msgid "CVE-2012-2690" +msgstr "CVE-2010-3851" + +#. type: textblock +#: ../edit/virt-edit.pod:331 +msgid "" +"Old versions of both virt-edit and the guestfish C<edit> command created a " +"new file containing the changes but did not set the permissions, etc of the " +"new file to match the old one. The result of this was that if you edited a " +"security sensitive file such as C</etc/shadow> then it would be left world-" +"readable after the edit." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:337 +msgid "" +"This issue was assigned CVE-2012-2690, and is fixed in libguestfs E<ge> 1.16." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:340 +msgid "" +"For further information, see https://bugzilla.redhat.com/show_bug.cgi?" +"id=788642" +msgstr "" + #. type: =item -#: ../edit/virt-edit.pod:333 +#: ../edit/virt-edit.pod:347 msgid "C<EDITOR>" msgstr "C<EDITOR>" #. type: textblock -#: ../edit/virt-edit.pod:335 +#: ../edit/virt-edit.pod:349 msgid "" "If set, this string is used as the editor. It may contain arguments, eg. C<" "\"emacs -nw\">" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:338 +#: ../edit/virt-edit.pod:352 msgid "If not set, C<vi> is used." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:356 +#: ../edit/virt-edit.pod:370 msgid "" "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-" "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, " @@ -4746,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 @@ -4762,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 @@ -4782,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 @@ -5330,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:2322 ../src/guestfs.pod:2327 msgid "html" msgstr "html" @@ -5445,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" @@ -5483,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." @@ -5490,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 " @@ -5530,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." @@ -5564,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 " @@ -5573,7 +5616,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../examples/guestfs-faq.pod:337 +#: ../examples/guestfs-faq.pod:341 #, no-wrap msgid "" " %libguestfs_buildnet 1\n" @@ -5581,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" @@ -5594,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 " @@ -5617,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/" @@ -5625,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 " @@ -5664,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 " @@ -5679,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 " @@ -5689,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" @@ -5707,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 " @@ -5744,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" @@ -5757,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 " @@ -5765,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 " @@ -5786,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 " @@ -5830,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" @@ -5844,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" @@ -5858,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 " @@ -5876,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 " @@ -5937,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 " @@ -5956,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 " @@ -5970,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 " @@ -5983,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 " @@ -6003,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-" @@ -6016,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" @@ -6038,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" @@ -6047,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-" @@ -6055,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 " @@ -6066,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 " @@ -6075,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 " @@ -6083,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" @@ -6091,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 " @@ -6099,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 " @@ -6107,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" @@ -6144,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 " @@ -6158,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" @@ -6171,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 " @@ -6179,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-" @@ -6188,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 " @@ -6196,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 " @@ -6213,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 "" |