+#: ../inspector/virt-inspector.pod:209
+msgid ""
+"As with E<lt>rootE<gt>, devices are from the point of view of libguestfs, "
+"and may have completely different names inside the guest. Only mountable "
+"filesystems appear in this list, not things like swap devices."
+msgstr ""
+
+#. type: =head2
+#: ../inspector/virt-inspector.pod:214
+msgid "E<lt>filesystemsE<gt>"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:216
+msgid ""
+"E<lt>filesystemsE<gt> is like E<lt>mountpointsE<gt> but covers I<all> "
+"filesystems belonging to the guest, including swap and empty partitions. "
+"(In the rare case of a multi-boot guest, it covers filesystems belonging to "
+"this OS or shared with this OS and other OSes)."
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:222
+msgid "You might see something like this:"
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:224
+#, no-wrap
+msgid ""
+" <operatingsystems>\n"
+" <operatingsystem>\n"
+" ...\n"
+" <filesystems>\n"
+" <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
+" <type>ext4</type>\n"
+" <label>Fedora-13-x86_64</label>\n"
+" <uuid>e6a4db1e-15c2-477b-ac2a-699181c396aa</uuid>\n"
+" </filesystem>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:234
+msgid ""
+"The optional elements within E<lt>filesystemE<gt> are the filesystem type, "
+"the label, and the UUID."
+msgstr ""
+
+#. type: =head2
+#: ../inspector/virt-inspector.pod:237
+msgid "E<lt>applicationsE<gt>"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:239
+msgid ""
+"The related elements E<lt>package_formatE<gt>, E<lt>package_managementE<gt> "
+"and E<lt>applicationsE<gt> describe applications installed in the virtual "
+"machine."
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:243
+msgid ""
+"E<lt>package_formatE<gt>, if present, describes the packaging system used. "
+"Typical values would be C<rpm> and C<deb>."
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:246
+msgid ""
+"E<lt>package_managementE<gt>, if present, describes the package manager. "
+"Typical values include C<yum>, C<up2date> and C<apt>"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:249
+msgid "E<lt>applicationsE<gt> lists the packages or applications installed."
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:252
+#, no-wrap
+msgid ""
+" <operatingsystems>\n"
+" <operatingsystem>\n"
+" ...\n"
+" <applications>\n"
+" <application>\n"
+" <name>coreutils</name>\n"
+" <version>8.5</version>\n"
+" <release>1</release>\n"
+" </application>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:262
+msgid ""
+"The version and release fields may not be available for some types guests. "
+"Other fields are possible, see "
+"L<guestfs(3)/guestfs_inspect_list_applications>."
+msgstr ""
+
+#. type: =head2
+#: ../inspector/virt-inspector.pod:266
+msgid "E<lt>drive_mappingsE<gt>"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:268
+msgid ""
+"For operating systems like Windows which use drive letters, virt-inspector "
+"is able to find out how drive letters map to filesystems."
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:272
+#, no-wrap
+msgid ""
+" <operatingsystems>\n"
+" <operatingsystem>\n"
+" ...\n"
+" <drive_mappings>\n"
+" <drive_mapping name=\"C\">/dev/sda2</drive_mapping>\n"
+" <drive_mapping name=\"E\">/dev/sdb1</drive_mapping>\n"
+" </drive_mappings>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:280
+msgid ""
+"In the example above, drive C maps to the filesystem on the second partition "
+"on the first disk, and drive E maps to the filesystem on the first partition "
+"on the second disk."
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:284
+msgid ""
+"Note that this only covers permanent local filesystem mappings, not things "
+"like network shares. Furthermore NTFS volume mount points may not be listed "
+"here."
+msgstr ""
+
+#. type: =head2
+#: ../inspector/virt-inspector.pod:288
+msgid "E<lt>iconE<gt>"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:290
+msgid ""
+"Virt-inspector is sometimes able to extract an icon or logo for the guest. "
+"The icon is returned as base64-encoded PNG data. Note that the icon can be "
+"very large and high quality."
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:294
+#, no-wrap
+msgid ""
+" <operatingsystems>\n"
+" <operatingsystem>\n"
+" ...\n"
+" <icon>\n"
+" iVBORw0KGgoAAAANSUhEUgAAAGAAAABg[.......]\n"
+" [... many lines of base64 data ...]\n"
+" </icon>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:302
+msgid ""
+"To display the icon, you have to extract it and convert the base64 data back "
+"to a binary file. Use an XPath query or simply an editor to extract the "
+"data, then use the coreutils L<base64(1)> program to do the conversion back "
+"to a PNG file:"
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:307
+#, no-wrap
+msgid ""
+" base64 -i -d < icon.data > icon.png\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../inspector/virt-inspector.pod:309
+msgid "INSPECTING INSTALL DISKS, LIVE CDs"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:311
+msgid ""
+"Virt-inspector can detect some operating system installers on install disks, "
+"live CDs, bootable USB keys and more."
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:314
+msgid ""
+"In this case the E<lt>formatE<gt> tag will contain C<installer> and other "
+"fields may be present to indicate a live CD, network installer, or one part "
+"of a multipart CD. For example:"
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:318
+#, no-wrap
+msgid ""
+" <operatingsystems>\n"
+" <operatingsystem>\n"
+" <root>/dev/sda</root>\n"
+" <name>linux</name>\n"
+" <arch>i386</arch>\n"
+" <distro>ubuntu</distro>\n"
+" <product_name>Ubuntu 10.10 "Maverick "
+"Meerkat"</product_name>\n"
+" <major_version>10</major_version>\n"
+" <minor_version>10</minor_version>\n"
+" <format>installer</format>\n"
+" <live/>\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: ../inspector/virt-inspector.pod:330
+msgid "USING XPATH"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:332
+msgid ""
+"You can use the XPath query language to select parts of the XML. We "
+"recommend using C<xmlstarlet> to perform XPath queries from the command "
+"line."
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:338
+#, no-wrap
+msgid ""
+" $ virt-inspector -d Guest | xmlstarlet sel -t -c '//filesystems'\n"
+" <filesystems>\n"
+" <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
+" <type>ext4</type>\n"
+" [...]\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:344
+#, no-wrap
+msgid ""
+" $ virt-inspector -d Guest | \\\n"
+" xmlstarlet sel -t -c \"string(//filesystem[@dev='/dev/sda1']/type)\"\n"
+" ext4\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:348
+#, no-wrap
+msgid ""
+" $ virt-inspector -d Guest | \\\n"
+" xmlstarlet sel -t -v '//icon' | base64 -i -d | display -\n"
+" [displays the guest icon, if there is one]\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: ../inspector/virt-inspector.pod:359
+msgid "OLD VERSIONS OF VIRT-INSPECTOR"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:361
+msgid ""
+"Early versions of libguestfs shipped with a different virt-inspector program "
+"written in Perl (the current version is written in C). The XML output of "
+"the Perl virt-inspector was different and it could also output in other "
+"formats like text."
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:366
+msgid "The old virt-inspector is no longer supported or shipped with libguestfs."
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:369
+msgid ""
+"To confuse matters further, in Red Hat Enterprise Linux 6 we ship two "
+"versions of virt-inspector with different names:"
+msgstr ""
+
+#. type: verbatim
+#: ../inspector/virt-inspector.pod:372
+#, no-wrap
+msgid ""
+" virt-inspector Old Perl version.\n"
+" virt-inspector2 New C version.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:382
+msgid ""
+"L<guestfs(3)>, L<guestfish(1)>, L<http://www.w3.org/TR/xpath/>, "
+"L<base64(1)>, L<xmlstarlet(1)>, L<http://libguestfs.org/>."
+msgstr ""
+
+#. type: textblock
+#: ../inspector/virt-inspector.pod:399
+msgid "Matthew Booth L<mbooth@redhat.com>"
+msgstr ""
+
+#. type: textblock
+#: ../java/examples/guestfs-java.pod:5
+msgid "guestfs-java - How to use libguestfs from Java"
+msgstr ""
+
+#. type: verbatim
+#: ../java/examples/guestfs-java.pod:9
+#, no-wrap
+msgid ""
+" import com.redhat.et.libguestfs.*;\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../java/examples/guestfs-java.pod:11
+#, no-wrap
+msgid ""
+" GuestFS g = new GuestFS ();\n"
+" g.add_drive_opts (\"disk.img\", null);\n"
+" g.launch ();\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../java/examples/guestfs-java.pod:17
+msgid ""
+"This manual page documents how to call libguestfs from the Java programming "
+"language. This page just documents the differences from the C API and gives "
+"some examples. If you are not familiar with using libguestfs, you also need "
+"to read L<guestfs(3)>."
+msgstr ""
+
+#. type: =head2
+#: ../java/examples/guestfs-java.pod:22 ../ocaml/examples/guestfs-ocaml.pod:53
+msgid "CLOSING THE HANDLE"
+msgstr ""
+
+#. type: textblock
+#: ../java/examples/guestfs-java.pod:24
+msgid ""
+"The handle is closed when it is reaped by the garbage collector. Because "
+"libguestfs handles include a lot of state, it is also possible to close (and "
+"hence free) them explicitly by calling the C<close> method."
+msgstr ""
+
+#. type: =head2
+#: ../java/examples/guestfs-java.pod:29 ../ocaml/examples/guestfs-ocaml.pod:60 ../python/examples/guestfs-python.pod:21 ../ruby/examples/guestfs-ruby.pod:22
+msgid "EXCEPTIONS"
+msgstr ""
+
+#. type: textblock
+#: ../java/examples/guestfs-java.pod:31
+msgid ""
+"Errors from libguestfs functions are mapped into the C<LibGuestFSException> "
+"exception. This has a single parameter which is the error message (a "
+"C<String>)."
+msgstr ""
+
+#. type: textblock
+#: ../java/examples/guestfs-java.pod:35
+msgid "Calling any method on a closed handle raises the same exception."
+msgstr ""
+
+#. type: textblock
+#: ../java/examples/guestfs-java.pod:47
+msgid ""
+"L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-erlang(3)>, "
+"L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, "
+"L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, L<http://libguestfs.org/>, "
+"L<http://caml.inria.fr/>."
+msgstr ""
+
+#. type: textblock
+#: ../ocaml/examples/guestfs-ocaml.pod:5
+msgid "guestfs-ocaml - How to use libguestfs from OCaml"
+msgstr ""
+
+#. type: textblock
+#: ../ocaml/examples/guestfs-ocaml.pod:9
+msgid "Module style:"
+msgstr ""
+
+#. type: verbatim
+#: ../ocaml/examples/guestfs-ocaml.pod:11
+#, no-wrap
+msgid ""
+" let g = Guestfs.create () in\n"
+" Guestfs.add_drive_opts g ~format:\"raw\" ~readonly:true \"disk.img\";\n"
+" Guestfs.launch g;\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../ocaml/examples/guestfs-ocaml.pod:15
+msgid "Object-oriented style:"
+msgstr ""
+
+#. type: verbatim
+#: ../ocaml/examples/guestfs-ocaml.pod:17
+#, no-wrap
+msgid ""
+" let g = new Guestfs.guestfs () in\n"
+" g#add_drive_opts ~format:\"raw\" ~readonly:true \"disk.img\";\n"
+" g#launch ();\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../ocaml/examples/guestfs-ocaml.pod:21
+#, no-wrap
+msgid ""
+" ocamlfind opt prog.ml -package guestfs -linkpkg -o prog\n"
+"or:\n"
+" ocamlopt -I +guestfs mlguestfs.cmxa prog.ml -o prog\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../ocaml/examples/guestfs-ocaml.pod:27
git.annexia.org / libguestfs.git / blobdiff