+#: ../src/guestfs-actions.pod:2748
+msgid "guestfs_inspect_get_icon"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:2750
+#, no-wrap
+msgid ""
+" char *\n"
+" guestfs_inspect_get_icon (guestfs_h *g,\n"
+" const char *root,\n"
+" size_t *size_r,\n"
+" ...);\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:2761
+#, no-wrap
+msgid ""
+" GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n"
+" GUESTFS_INSPECT_GET_ICON_HIGHQUALITY, int highquality,\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2764 ../fish/guestfish-actions.pod:1877
+msgid ""
+"This function returns an icon corresponding to the inspected operating "
+"system. The icon is returned as a buffer containing a PNG image (re-encoded "
+"to PNG if necessary)."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2768 ../fish/guestfish-actions.pod:1881
+msgid ""
+"If it was not possible to get an icon this function returns a zero-length "
+"(non-NULL) buffer. I<Callers must check for this case>."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2771 ../fish/guestfish-actions.pod:1884
+msgid ""
+"Libguestfs will start by looking for a file called C</etc/favicon.png> or "
+"C<C:\\etc\\favicon.png> and if it has the correct format, the contents of "
+"this file will be returned. You can disable favicons by passing the "
+"optional C<favicon> boolean as false (default is true)."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2777 ../fish/guestfish-actions.pod:1890
+msgid ""
+"If finding the favicon fails, then we look in other places in the guest for "
+"a suitable icon."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2780 ../fish/guestfish-actions.pod:1893
+msgid ""
+"If the optional C<highquality> boolean is true then only high quality icons "
+"are returned, which means only icons of high resolution with an alpha "
+"channel. The default (false) is to return any icon we can, even if it is of "
+"substandard quality."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2791 ../fish/guestfish-actions.pod:1904
+msgid ""
+"Unlike most other inspection API calls, the guest's disks must be mounted up "
+"before you call this, since it needs to read information from the guest "
+"filesystem during the call."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2797 ../fish/guestfish-actions.pod:1910
+msgid ""
+"B<Security:> The icon data comes from the untrusted guest, and should be "
+"treated with caution. PNG files have been known to contain exploits. "
+"Ensure that libpng (or other relevant libraries) are fully up to date before "
+"trying to process or display the icon."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2805 ../fish/guestfish-actions.pod:1918
+msgid ""
+"The PNG image returned can be any size. It might not be square. Libguestfs "
+"tries to return the largest, highest quality icon available. The "
+"application must scale the icon to the required size."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2812 ../fish/guestfish-actions.pod:1925
+msgid ""
+"Extracting icons from Windows guests requires the external C<wrestool> "
+"program from the C<icoutils> package, and several programs (C<bmptopnm>, "
+"C<pnmtopng>, C<pamcut>) from the C<netpbm> package. These must be "
+"installed separately."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2819 ../fish/guestfish-actions.pod:1932
+msgid ""
+"Operating system icons are usually trademarks. Seek legal advice before "
+"using trademarks in applications."
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2828 ../src/guestfs-actions.pod:3653 ../src/guestfs-actions.pod:4872
+msgid "(Added in 1.11.12)"
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:2830
+msgid "guestfs_inspect_get_icon_va"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:2832
+#, no-wrap
+msgid ""
+" char *\n"
+" guestfs_inspect_get_icon_va (guestfs_h *g,\n"
+" const char *root,\n"
+" size_t *size_r,\n"
+" va_list args);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2838
+msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:2842
+msgid "guestfs_inspect_get_icon_argv"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-actions.pod:2844
+#, no-wrap
+msgid ""
+" char *\n"
+" guestfs_inspect_get_icon_argv (guestfs_h *g,\n"
+" const char *root,\n"
+" size_t *size_r,\n"
+" const struct guestfs_inspect_get_icon_argv "
+"*optargs);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../src/guestfs-actions.pod:2850
+msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>."
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-actions.pod:2854
git.annexia.org / libguestfs.git / blobdiff