From 84e15e784f982f4bb15196a2dd291db6d67f08d6 Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Tue, 30 Sep 2025 10:06:44 +0100 Subject: [PATCH] Version 1.57.4. --- configure.ac | 4 +- po-docs/libguestfs-docs.pot | 2003 ++++++++++++++++------------------- po/libguestfs.pot | 80 +- 3 files changed, 949 insertions(+), 1138 deletions(-) diff --git a/configure.ac b/configure.ac index 627058571..f93e8571c 100644 --- a/configure.ac +++ b/configure.ac @@ -20,8 +20,8 @@ # freeform string. m4_define([libguestfs_major], [1]) m4_define([libguestfs_minor], [57]) -m4_define([libguestfs_release], [3]) -m4_define([release_date], [2025-09-09]) +m4_define([libguestfs_release], [4]) +m4_define([release_date], [2025-09-30]) AC_INIT([libguestfs],libguestfs_major.libguestfs_minor.libguestfs_release) AC_SUBST([RELEASE_DATE],release_date) diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index cdd7135ad..7794eede3 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.57.3\n" +"Project-Id-Version: libguestfs 1.57.4\n" "Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n" -"POT-Creation-Date: 2025-09-09 19:11+0100\n" +"POT-Creation-Date: 2025-09-30 10:05+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -228,18 +228,18 @@ msgstr "" #: docs/guestfs-testing.pod:202 docs/internal-documentation.pod:46 #: docs/internal-documentation.pod:51 docs/internal-documentation.pod:1426 #: docs/internal-documentation.pod:1430 docs/internal-documentation.pod:1659 -#: docs/internal-documentation.pod:1663 docs/internal-documentation.pod:2588 -#: docs/internal-documentation.pod:2596 docs/internal-documentation.pod:2602 -#: docs/internal-documentation.pod:2609 docs/internal-documentation.pod:2867 -#: docs/internal-documentation.pod:2874 docs/internal-documentation.pod:2878 -#: docs/internal-documentation.pod:2907 docs/internal-documentation.pod:2914 -#: docs/internal-documentation.pod:2918 docs/internal-documentation.pod:2949 -#: docs/internal-documentation.pod:2954 docs/internal-documentation.pod:2961 -#: docs/internal-documentation.pod:3141 docs/internal-documentation.pod:3146 -#: docs/internal-documentation.pod:3262 docs/internal-documentation.pod:3266 -#: docs/internal-documentation.pod:3499 docs/internal-documentation.pod:3503 -#: docs/internal-documentation.pod:3507 docs/internal-documentation.pod:3512 -#: docs/internal-documentation.pod:4143 docs/internal-documentation.pod:4148 +#: docs/internal-documentation.pod:1663 docs/internal-documentation.pod:2512 +#: docs/internal-documentation.pod:2520 docs/internal-documentation.pod:2526 +#: docs/internal-documentation.pod:2533 docs/internal-documentation.pod:2791 +#: docs/internal-documentation.pod:2798 docs/internal-documentation.pod:2802 +#: docs/internal-documentation.pod:2831 docs/internal-documentation.pod:2838 +#: docs/internal-documentation.pod:2842 docs/internal-documentation.pod:2873 +#: docs/internal-documentation.pod:2878 docs/internal-documentation.pod:2885 +#: docs/internal-documentation.pod:3065 docs/internal-documentation.pod:3070 +#: docs/internal-documentation.pod:3186 docs/internal-documentation.pod:3190 +#: docs/internal-documentation.pod:3423 docs/internal-documentation.pod:3427 +#: docs/internal-documentation.pod:3431 docs/internal-documentation.pod:3436 +#: docs/internal-documentation.pod:4067 docs/internal-documentation.pod:4072 #: fish/guestfish-actions.pod:760 fish/guestfish-actions.pod:766 #: fish/guestfish-actions.pod:774 fish/guestfish-actions.pod:781 #: fish/guestfish-actions.pod:788 fish/guestfish-actions.pod:2688 @@ -990,7 +990,7 @@ msgstr "" #: common/mlcustomize/customize-options.pod:84 #: common/mlcustomize/v2v-customize-options.pod:84 #: docs/guestfs-building.pod:420 docs/guestfs-recipes.pod:508 -#: docs/internal-documentation.pod:3116 fish/guestfish.pod:238 +#: docs/internal-documentation.pod:3040 fish/guestfish.pod:238 #: fish/guestfish.pod:699 rescue/virt-rescue.pod:166 msgid "For example:" msgstr "" @@ -2524,7 +2524,7 @@ msgstr "" #. type: =item #: docs/guestfs-building.pod:73 -msgid "qemu E 1.3.0" +msgid "qemu E 7.2.0" msgstr "" #. type: textblock @@ -2540,7 +2540,7 @@ msgstr "" #. type: =item #: docs/guestfs-building.pod:77 -msgid "qemu-img E 1.3.0" +msgid "qemu-img E 7.2.0" msgstr "" #. type: =item @@ -2753,7 +2753,7 @@ msgstr "" #. type: =item #: docs/guestfs-building.pod:193 -msgid "libvirt E 0.10.2" +msgid "libvirt E 9.0.0" msgstr "" #. type: textblock @@ -7160,7 +7160,7 @@ msgid "F" msgstr "" #. type: textblock -#: docs/guestfs-hacking.pod:158 docs/internal-documentation.pod:2575 +#: docs/guestfs-hacking.pod:158 docs/internal-documentation.pod:2499 msgid "Mini-library for writing qemu command lines and qemu config files." msgstr "" @@ -11252,7 +11252,7 @@ msgstr "" #. type: textblock #: docs/guestfs-recipes.pod:310 docs/internal-documentation.pod:1353 -#: docs/internal-documentation.pod:3137 docs/internal-documentation.pod:3495 +#: docs/internal-documentation.pod:3061 docs/internal-documentation.pod:3419 #: fish/guestfish-actions.pod:3075 fish/guestfish-actions.pod:3712 #: fish/guestfish-actions.pod:4495 lib/guestfs-actions.pod:5119 #: lib/guestfs-actions.pod:6141 lib/guestfs-actions.pod:7228 @@ -33665,7 +33665,7 @@ msgid "Returns:" msgstr "" #. type: =item -#: docs/internal-documentation.pod:562 docs/internal-documentation.pod:3995 +#: docs/internal-documentation.pod:562 docs/internal-documentation.pod:3919 #: fuse/guestunmount.pod:131 msgid "C<1>" msgstr "" @@ -33676,7 +33676,7 @@ msgid "log message(s) were handled successfully" msgstr "" #. type: =item -#: docs/internal-documentation.pod:566 docs/internal-documentation.pod:3999 +#: docs/internal-documentation.pod:566 docs/internal-documentation.pod:3923 msgid "C<0>" msgstr "" @@ -33686,7 +33686,7 @@ msgid "connection to appliance closed" msgstr "" #. type: =item -#: docs/internal-documentation.pod:570 docs/internal-documentation.pod:4003 +#: docs/internal-documentation.pod:570 docs/internal-documentation.pod:3927 msgid "C<-1>" msgstr "" @@ -36165,243 +36165,84 @@ msgstr "" #. type: =head4 #: docs/internal-documentation.pod:1689 -msgid "Function C" +msgid "Function C" msgstr "" #. type: verbatim #: docs/internal-documentation.pod:1691 #, no-wrap msgid "" -" struct qemu_data *\n" -" guestfs_int_test_qemu (guestfs_h *g)\n" +" static int\n" +" generic_qmp_test (guestfs_h *g, const char *qmp_command, char **outp)\n" "\n" msgstr "" #. type: textblock #: docs/internal-documentation.pod:1694 -msgid "" -"Test that the qemu binary (or wrapper) runs, and do C and other " -"commands so we can find out the version of qemu and what options this qemu " -"supports." -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1698 -msgid "" -"This caches the results in the cachedir so that as long as the qemu binary " -"does not change, calling this is effectively free." +msgid "Run a generic QMP test on the QEMU binary." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1701 -msgid "Function C" -msgstr "" - -#. type: verbatim -#: docs/internal-documentation.pod:1703 -#, no-wrap -msgid "" -" static char *\n" -" cache_filename (guestfs_h *g, const char *cachedir,\n" -" const struct stat *statbuf, const char *suffix)\n" -"\n" -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1707 -msgid "Generate the filenames, for the stat file and the other cache files." -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1710 -msgid "" -"By including the size and mtime in the filename we also ensure that the same " -"user can use multiple versions of qemu without conflicts." -msgstr "" - -#. type: =head4 -#: docs/internal-documentation.pod:1713 -msgid "Function C" -msgstr "" - -#. type: verbatim -#: docs/internal-documentation.pod:1715 -#, no-wrap -msgid "" -" static void\n" -" parse_qemu_version (guestfs_h *g, const char *qemu_help,\n" -" struct version *qemu_version)\n" -"\n" -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1719 -msgid "" -"Parse the first line of C into the major and minor version of " -"qemu, but don't fail if parsing is not possible." -msgstr "" - -#. type: =head4 -#: docs/internal-documentation.pod:1722 -msgid "Function C" -msgstr "" - -#. type: verbatim -#: docs/internal-documentation.pod:1724 -#, no-wrap -msgid "" -" static void\n" -" parse_json (guestfs_h *g, const char *json, json_object **treep)\n" -"\n" -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1727 -msgid "Parse the json output from QMP. But don't fail if parsing is not possible." -msgstr "" - -#. type: =head4 -#: docs/internal-documentation.pod:1730 +#: docs/internal-documentation.pod:1696 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1732 +#: docs/internal-documentation.pod:1698 #, no-wrap msgid "" -" static void\n" -" parse_has_kvm (guestfs_h *g, const char *json, bool *ret)\n" +" static int\n" +" parse_has_kvm (guestfs_h *g, const char *json)\n" "\n" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1735 +#: docs/internal-documentation.pod:1701 msgid "" "Parse the json output from QMP query-kvm to find out if KVM is enabled on " -"this machine. Don't fail if parsing is not possible, assume KVM is " -"available." +"this machine." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1739 +#: docs/internal-documentation.pod:1704 msgid "" "The JSON output looks like: {\"return\": {\"enabled\": true, \"present\": " "true}}" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1742 -msgid "Function C" +#: docs/internal-documentation.pod:1707 +msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1744 -#, no-wrap -msgid "" -" static int\n" -" generic_read_cache (guestfs_h *g, const char *filename, char **strp)\n" -"\n" -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1747 -msgid "" -"Generic functions for reading and writing the cache files, used where we are " -"just reading and writing plain text strings." -msgstr "" - -#. type: =head4 -#: docs/internal-documentation.pod:1750 -msgid "Function C" -msgstr "" - -#. type: verbatim -#: docs/internal-documentation.pod:1752 -#, no-wrap -msgid "" -" static int\n" -" generic_qmp_test (guestfs_h *g, struct qemu_data *data,\n" -" const char *qmp_command,\n" -" char **outp)\n" -"\n" -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1757 -msgid "Run a generic QMP test on the QEMU binary." -msgstr "" - -#. type: =head4 -#: docs/internal-documentation.pod:1759 -msgid "Function C" -msgstr "" - -#. type: verbatim -#: docs/internal-documentation.pod:1761 -#, no-wrap -msgid "" -" struct version\n" -" guestfs_int_qemu_version (guestfs_h *g, struct qemu_data *data)\n" -"\n" -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1764 -msgid "Return the parsed version of qemu." -msgstr "" - -#. type: =head4 -#: docs/internal-documentation.pod:1766 -msgid "Function C" -msgstr "" - -#. type: verbatim -#: docs/internal-documentation.pod:1768 +#: docs/internal-documentation.pod:1709 #, no-wrap msgid "" " int\n" -" guestfs_int_qemu_supports (guestfs_h *g, const struct qemu_data *data,\n" -" const char *option)\n" +" guestfs_int_platform_has_kvm (guestfs_h *g)\n" "\n" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1772 -msgid "" -"Test if option is supported by qemu command line (just by grepping the help " -"text)." -msgstr "" - -#. type: =head4 -#: docs/internal-documentation.pod:1775 -msgid "Function C" -msgstr "" - -#. type: verbatim -#: docs/internal-documentation.pod:1777 -#, no-wrap -msgid "" -" int\n" -" guestfs_int_qemu_supports_device (guestfs_h *g,\n" -" const struct qemu_data *data,\n" -" const char *device_name)\n" -"\n" +#: docs/internal-documentation.pod:1712 +msgid "Test if the platform supports KVM." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1782 +#: docs/internal-documentation.pod:1714 msgid "" -"Test if device is supported by qemu (currently just greps the C output)." +"Only qemu \"knows\" this fact reliably, so we run qemu, query it using the " +"QMP \"query-kvm\" command, and parse the JSON output from that command." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1785 +#: docs/internal-documentation.pod:1718 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1787 +#: docs/internal-documentation.pod:1720 #, no-wrap msgid "" " char *\n" @@ -36410,17 +36251,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1790 +#: docs/internal-documentation.pod:1723 msgid "Escape a qemu parameter." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1792 +#: docs/internal-documentation.pod:1725 msgid "Every C<,> becomes C<,,>. The caller must free the returned string." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1794 +#: docs/internal-documentation.pod:1727 msgid "" "XXX This functionality is now only used when constructing a qemu-img command " "in F. We should extend the qemuopts library to cover this use " @@ -36428,12 +36269,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1798 +#: docs/internal-documentation.pod:1731 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1800 +#: docs/internal-documentation.pod:1733 #, no-wrap msgid "" " char *\n" @@ -36443,12 +36284,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1804 +#: docs/internal-documentation.pod:1737 msgid "Useful function to format a drive + protocol for qemu." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1806 +#: docs/internal-documentation.pod:1739 msgid "" "Note that the qemu parameter is the bit after C<\"file=\">. It is not " "escaped here, but would usually be escaped if passed to qemu as part of a " @@ -36456,91 +36297,71 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1810 +#: docs/internal-documentation.pod:1743 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1812 +#: docs/internal-documentation.pod:1745 #, no-wrap msgid "" " bool\n" -" guestfs_int_discard_possible (guestfs_h *g, struct drive *drv,\n" -" \t\t\t const struct version *qemu_version)\n" +" guestfs_int_discard_possible (guestfs_h *g, struct drive *drv)\n" "\n" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1816 +#: docs/internal-documentation.pod:1748 msgid "" -"Test if discard is both supported by qemu AND possible with the underlying " -"file or device. This returns C<1> if discard is possible. It returns C<0> " -"if not possible and sets the error to the reason why." +"Test if discard is possible with the underlying file or device. This " +"returns C<1> if discard is possible. It returns C<0> if not possible and " +"sets the error to the reason why." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1821 +#: docs/internal-documentation.pod:1752 msgid "This function is called when the user set C." msgstr "" -#. type: =head4 -#: docs/internal-documentation.pod:1823 -msgid "Function C" -msgstr "" - -#. type: verbatim -#: docs/internal-documentation.pod:1825 -#, no-wrap -msgid "" -" void\n" -" guestfs_int_free_qemu_data (struct qemu_data *data)\n" -"\n" -msgstr "" - -#. type: textblock -#: docs/internal-documentation.pod:1828 -msgid "Free the C." -msgstr "" - #. type: =head3 -#: docs/internal-documentation.pod:1830 +#: docs/internal-documentation.pod:1754 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1832 +#: docs/internal-documentation.pod:1756 msgid "Support for virt-rescue(1)." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1834 +#: docs/internal-documentation.pod:1758 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1836 +#: docs/internal-documentation.pod:1760 msgid "An expandable NULL-terminated vector of strings (like C)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1838 +#: docs/internal-documentation.pod:1762 msgid "Use the C macro to declare the stringsbuf." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1840 +#: docs/internal-documentation.pod:1764 msgid "" "Note: Don't confuse this with stringsbuf in the daemon which is a different " "type with different methods." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1843 +#: docs/internal-documentation.pod:1767 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1845 +#: docs/internal-documentation.pod:1769 #, no-wrap msgid "" " void\n" @@ -36550,25 +36371,25 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1848 docs/internal-documentation.pod:1858 -#: docs/internal-documentation.pod:1868 +#: docs/internal-documentation.pod:1772 docs/internal-documentation.pod:1782 +#: docs/internal-documentation.pod:1792 msgid "Add a string to the end of the list." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1850 +#: docs/internal-documentation.pod:1774 msgid "" "This doesn't call L on the string, so the string itself is stored " "inside the vector." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1853 +#: docs/internal-documentation.pod:1777 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1855 +#: docs/internal-documentation.pod:1779 #, no-wrap msgid "" " void\n" @@ -36578,17 +36399,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1860 +#: docs/internal-documentation.pod:1784 msgid "This makes a copy of the string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1862 +#: docs/internal-documentation.pod:1786 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1864 +#: docs/internal-documentation.pod:1788 #, no-wrap msgid "" " void\n" @@ -36598,17 +36419,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1870 +#: docs/internal-documentation.pod:1794 msgid "Uses an sprintf-like format string when creating the string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1872 +#: docs/internal-documentation.pod:1796 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1874 +#: docs/internal-documentation.pod:1798 #, no-wrap msgid "" " void\n" @@ -36617,22 +36438,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1877 +#: docs/internal-documentation.pod:1801 msgid "Finish the string buffer." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1879 +#: docs/internal-documentation.pod:1803 msgid "This adds the terminating NULL to the end of the vector." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1881 +#: docs/internal-documentation.pod:1805 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1883 +#: docs/internal-documentation.pod:1807 #, no-wrap msgid "" " void\n" @@ -36641,27 +36462,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1886 +#: docs/internal-documentation.pod:1810 msgid "Free the string buffer and the strings." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1888 +#: docs/internal-documentation.pod:1812 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1890 +#: docs/internal-documentation.pod:1814 msgid "Handle temporary directories." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1892 +#: docs/internal-documentation.pod:1816 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1894 +#: docs/internal-documentation.pod:1818 #, no-wrap msgid "" " static int\n" @@ -36671,7 +36492,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1898 +#: docs/internal-documentation.pod:1822 msgid "" "We need to make all tmpdir paths absolute because lots of places in the code " "assume this. Do it at the time we set the path or read the environment " @@ -36679,7 +36500,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1902 +#: docs/internal-documentation.pod:1826 msgid "" "The C parameter is a string displayed in error messages giving the " "context of the operation (eg. name of environment variable being used, or " @@ -36687,12 +36508,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1906 +#: docs/internal-documentation.pod:1830 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1908 +#: docs/internal-documentation.pod:1832 #, no-wrap msgid "" " char *\n" @@ -36701,22 +36522,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1911 +#: docs/internal-documentation.pod:1835 msgid "Implements the C API." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1913 +#: docs/internal-documentation.pod:1837 msgid "Note this actually calculates the tmpdir, so it never returns C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1916 +#: docs/internal-documentation.pod:1840 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1918 +#: docs/internal-documentation.pod:1842 #, no-wrap msgid "" " char *\n" @@ -36725,22 +36546,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1921 +#: docs/internal-documentation.pod:1845 msgid "Implements the C API." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1923 +#: docs/internal-documentation.pod:1847 msgid "Note this actually calculates the cachedir, so it never returns C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1925 +#: docs/internal-documentation.pod:1849 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1927 +#: docs/internal-documentation.pod:1851 #, no-wrap msgid "" " char *\n" @@ -36749,22 +36570,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1930 +#: docs/internal-documentation.pod:1854 msgid "Implements the C API." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1932 +#: docs/internal-documentation.pod:1856 msgid "Note this actually calculates the sockdir, so it never returns C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1935 +#: docs/internal-documentation.pod:1859 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1937 +#: docs/internal-documentation.pod:1861 #, no-wrap msgid "" " int\n" @@ -36773,7 +36594,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1940 +#: docs/internal-documentation.pod:1864 msgid "" "The Ctmpdir> (per-handle temporary directory) is not created when " "the handle is created. Instead we create it lazily before the first time it " @@ -36781,12 +36602,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1944 +#: docs/internal-documentation.pod:1868 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1946 +#: docs/internal-documentation.pod:1870 #, no-wrap msgid "" " char *\n" @@ -36796,22 +36617,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1950 +#: docs/internal-documentation.pod:1874 msgid "Generate unique temporary paths for temporary files." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1952 +#: docs/internal-documentation.pod:1876 msgid "Returns a unique path or NULL on error." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1954 +#: docs/internal-documentation.pod:1878 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1956 +#: docs/internal-documentation.pod:1880 #, no-wrap msgid "" " int\n" @@ -36821,17 +36642,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1960 +#: docs/internal-documentation.pod:1884 msgid "Create the path for a socket with the selected filename in the sockdir." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1963 +#: docs/internal-documentation.pod:1887 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1965 +#: docs/internal-documentation.pod:1889 #, no-wrap msgid "" " char *\n" @@ -36840,12 +36661,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1968 +#: docs/internal-documentation.pod:1892 msgid "Generate unique paths for PID files." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1970 +#: docs/internal-documentation.pod:1894 msgid "" "Returns a unique path or NULL on error. On success, the pathname points " "under sockdir and not tmpdir; daemons that write PID files after dropping " @@ -36853,12 +36674,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1974 +#: docs/internal-documentation.pod:1898 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1976 +#: docs/internal-documentation.pod:1900 #, no-wrap msgid "" " char *\n" @@ -36867,31 +36688,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1979 +#: docs/internal-documentation.pod:1903 msgid "" "Create the supermin appliance directory under cachedir, if it does not " "exist." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1982 +#: docs/internal-documentation.pod:1906 msgid "" "Sanity-check that the permissions on the cachedir are safe, in case it has " "been pre-created maliciously or tampered with." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1985 +#: docs/internal-documentation.pod:1909 msgid "Returns the directory name which the caller must free." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1987 +#: docs/internal-documentation.pod:1911 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1989 +#: docs/internal-documentation.pod:1913 #, no-wrap msgid "" " void\n" @@ -36900,7 +36721,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1992 +#: docs/internal-documentation.pod:1916 msgid "" "Recursively remove a temporary directory. If removal fails, just return " "(it's a temporary directory so it'll eventually be cleaned up by a temp " @@ -36908,27 +36729,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1996 +#: docs/internal-documentation.pod:1920 msgid "This is implemented using C because that's simpler and safer." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1999 +#: docs/internal-documentation.pod:1923 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2001 +#: docs/internal-documentation.pod:1925 msgid "Return current umask in a thread-safe way." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2003 +#: docs/internal-documentation.pod:1927 msgid "glibc documents, but does not actually implement, a \"getumask(3)\" call." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2006 +#: docs/internal-documentation.pod:1930 msgid "" "We use C from F for Linux E 4.7. For older " "Linux and other Unix, this file implements an expensive but thread-safe way " @@ -36936,17 +36757,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2010 +#: docs/internal-documentation.pod:1934 msgid "Thanks to: Josh Stone, Jiri Jaburek, Eric Blake." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2012 +#: docs/internal-documentation.pod:1936 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2014 +#: docs/internal-documentation.pod:1938 #, no-wrap msgid "" " int\n" @@ -36955,19 +36776,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2017 +#: docs/internal-documentation.pod:1941 msgid "" "Returns the current process's umask. On failure, returns C<-1> and sets the " "error in the guestfs handle." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2020 +#: docs/internal-documentation.pod:1944 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2022 +#: docs/internal-documentation.pod:1946 #, no-wrap msgid "" " static int\n" @@ -36976,12 +36797,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2025 +#: docs/internal-documentation.pod:1949 msgid "For Linux E 4.7 get the umask from F." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2027 +#: docs/internal-documentation.pod:1951 msgid "" "On failure this returns C<-1>. However if we could not open the F " "file or find the C entry in it, return C<-2> which causes the " @@ -36989,12 +36810,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2031 +#: docs/internal-documentation.pod:1955 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2033 +#: docs/internal-documentation.pod:1957 #, no-wrap msgid "" " static int\n" @@ -37003,34 +36824,34 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2036 +#: docs/internal-documentation.pod:1960 msgid "Fallback method of getting the umask using fork." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2038 +#: docs/internal-documentation.pod:1962 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2040 docs/internal-documentation.pod:2568 +#: docs/internal-documentation.pod:1964 docs/internal-documentation.pod:2492 msgid "Unit tests of internal functions." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2042 docs/internal-documentation.pod:2570 +#: docs/internal-documentation.pod:1966 docs/internal-documentation.pod:2494 msgid "" "These tests may use a libguestfs handle, but must not launch the handle. " "Also, avoid long-running tests." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2045 +#: docs/internal-documentation.pod:1969 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2047 +#: docs/internal-documentation.pod:1971 #, no-wrap msgid "" " static void\n" @@ -37039,17 +36860,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2050 +#: docs/internal-documentation.pod:1974 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2052 +#: docs/internal-documentation.pod:1976 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2054 +#: docs/internal-documentation.pod:1978 #, no-wrap msgid "" " static void\n" @@ -37058,17 +36879,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2057 +#: docs/internal-documentation.pod:1981 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2059 +#: docs/internal-documentation.pod:1983 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2061 +#: docs/internal-documentation.pod:1985 #, no-wrap msgid "" " static void\n" @@ -37077,17 +36898,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2064 +#: docs/internal-documentation.pod:1988 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2066 +#: docs/internal-documentation.pod:1990 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2068 +#: docs/internal-documentation.pod:1992 #, no-wrap msgid "" " static void\n" @@ -37096,17 +36917,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2071 +#: docs/internal-documentation.pod:1995 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2073 +#: docs/internal-documentation.pod:1997 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2075 +#: docs/internal-documentation.pod:1999 #, no-wrap msgid "" " static void\n" @@ -37115,17 +36936,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2078 +#: docs/internal-documentation.pod:2002 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2080 +#: docs/internal-documentation.pod:2004 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2082 +#: docs/internal-documentation.pod:2006 #, no-wrap msgid "" " static void\n" @@ -37134,17 +36955,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2085 +#: docs/internal-documentation.pod:2009 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2087 +#: docs/internal-documentation.pod:2011 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2089 +#: docs/internal-documentation.pod:2013 #, no-wrap msgid "" " static void\n" @@ -37153,17 +36974,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2092 +#: docs/internal-documentation.pod:2016 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2094 +#: docs/internal-documentation.pod:2018 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2096 +#: docs/internal-documentation.pod:2020 #, no-wrap msgid "" " static void\n" @@ -37172,24 +36993,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2099 +#: docs/internal-documentation.pod:2023 msgid "Test C etc." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2101 +#: docs/internal-documentation.pod:2025 msgid "" "XXX These tests could be made much more thorough. So far we simply test " "that it's not obviously broken." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2104 +#: docs/internal-documentation.pod:2028 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2106 +#: docs/internal-documentation.pod:2030 #, no-wrap msgid "" " static void\n" @@ -37198,12 +37019,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2109 +#: docs/internal-documentation.pod:2033 msgid "Test C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2111 +#: docs/internal-documentation.pod:2035 msgid "" "XXX I wanted to make this test run qemu, passing some parameters which need " "to be escaped, but I cannot think of a way to do that without launching a " @@ -37211,12 +37032,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2115 +#: docs/internal-documentation.pod:2039 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2117 +#: docs/internal-documentation.pod:2041 #, no-wrap msgid "" " static void\n" @@ -37225,27 +37046,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2120 +#: docs/internal-documentation.pod:2044 msgid "Test C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2122 +#: docs/internal-documentation.pod:2046 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2124 +#: docs/internal-documentation.pod:2048 msgid "This file provides simple version number management." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2126 +#: docs/internal-documentation.pod:2050 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2128 +#: docs/internal-documentation.pod:2052 #, no-wrap msgid "" " int\n" @@ -37255,13 +37076,13 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2131 +#: docs/internal-documentation.pod:2055 msgid "Parses a version from a string, looking for a C pattern." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2133 docs/internal-documentation.pod:2146 -#: docs/internal-documentation.pod:2159 +#: docs/internal-documentation.pod:2057 docs/internal-documentation.pod:2070 +#: docs/internal-documentation.pod:2083 msgid "" "Returns C<-1> on failure (like failed integer parsing), C<0> on missing " "match, and C<1> on match and successful parsing. C is changed only on " @@ -37269,12 +37090,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2137 +#: docs/internal-documentation.pod:2061 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2139 +#: docs/internal-documentation.pod:2063 #, no-wrap msgid "" " int\n" @@ -37284,19 +37105,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2143 +#: docs/internal-documentation.pod:2067 msgid "" "Parses a version from a string, using the specified C as regular " "expression which I provide (at least) two matches." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2150 +#: docs/internal-documentation.pod:2074 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2152 +#: docs/internal-documentation.pod:2076 #, no-wrap msgid "" " int\n" @@ -37306,19 +37127,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2156 +#: docs/internal-documentation.pod:2080 msgid "" "Parses a version from a string, either looking for a C pattern or " "considering it as whole integer." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2163 +#: docs/internal-documentation.pod:2087 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2165 +#: docs/internal-documentation.pod:2089 #, no-wrap msgid "" " int\n" @@ -37327,34 +37148,34 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2168 +#: docs/internal-documentation.pod:2092 msgid "Parse small, unsigned ints, as used in version numbers." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2170 +#: docs/internal-documentation.pod:2094 msgid "" "This will fail with an error if trailing characters are found after the " "integer." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2173 +#: docs/internal-documentation.pod:2097 msgid "Returns E C<0> on success, or C<-1> on failure." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2175 +#: docs/internal-documentation.pod:2099 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2177 +#: docs/internal-documentation.pod:2101 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2179 +#: docs/internal-documentation.pod:2103 #, no-wrap msgid "" " int\n" @@ -37364,12 +37185,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2182 +#: docs/internal-documentation.pod:2106 msgid "A safe version of L which retries if C is returned." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2185 +#: docs/internal-documentation.pod:2109 msgid "" "I this only needs to be used in the library, or in programs that " "install a non-restartable C handler (which is not the case for any " @@ -37377,7 +37198,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2189 +#: docs/internal-documentation.pod:2113 msgid "" "If the main program installs a SIGCHLD handler and sets it to be " "non-restartable, then what can happen is the library is waiting in a wait " @@ -37388,12 +37209,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2196 +#: docs/internal-documentation.pod:2120 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2198 +#: docs/internal-documentation.pod:2122 #, no-wrap msgid "" " void\n" @@ -37402,17 +37223,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2201 +#: docs/internal-documentation.pod:2125 msgid "Like C, but ignore errors." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2203 +#: docs/internal-documentation.pod:2127 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2205 +#: docs/internal-documentation.pod:2129 #, no-wrap msgid "" " int\n" @@ -37422,22 +37243,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2209 +#: docs/internal-documentation.pod:2133 msgid "A safe version of L which retries if C is returned." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2212 +#: docs/internal-documentation.pod:2136 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2214 +#: docs/internal-documentation.pod:2138 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2216 +#: docs/internal-documentation.pod:2140 #, no-wrap msgid "" " int\n" @@ -37447,12 +37268,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2220 +#: docs/internal-documentation.pod:2144 msgid "Read the whole file C into a memory buffer." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2222 +#: docs/internal-documentation.pod:2146 msgid "" "The memory buffer is initialized and returned in C. The size of the " "file in bytes is returned in C. The return buffer must be freed by " @@ -37460,19 +37281,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2226 +#: docs/internal-documentation.pod:2150 msgid "On error this sets the error in the handle and returns C<-1>." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2228 +#: docs/internal-documentation.pod:2152 msgid "" "For the convenience of callers, the returned buffer is NUL-terminated (the " "NUL is not included in the size)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2231 +#: docs/internal-documentation.pod:2155 msgid "" "The file must be a B, B, B file. In particular, do " "not use this function to read files that might be under control of an " @@ -37480,17 +37301,17 @@ msgid "" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2236 +#: docs/internal-documentation.pod:2160 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2238 +#: docs/internal-documentation.pod:2162 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2240 +#: docs/internal-documentation.pod:2164 msgid "" "This file implements common file editing in a range of utilities including " "L, L, L and " @@ -37498,19 +37319,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2244 +#: docs/internal-documentation.pod:2168 msgid "" "It contains the code for both interactive-(editor-)based editing and " "non-interactive editing using Perl snippets." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2247 +#: docs/internal-documentation.pod:2171 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2249 +#: docs/internal-documentation.pod:2173 #, no-wrap msgid "" " int\n" @@ -37520,38 +37341,38 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2253 +#: docs/internal-documentation.pod:2177 msgid "Edit C using the specified C application." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2255 docs/internal-documentation.pod:2274 +#: docs/internal-documentation.pod:2179 docs/internal-documentation.pod:2198 msgid "" "If C is not null, then a copy of C is saved with " "C appended to its file name." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2258 +#: docs/internal-documentation.pod:2182 msgid "" "If C is null, then the C<$EDITOR> environment variable will be " "queried for the editor application, leaving C as fallback if not set." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2262 +#: docs/internal-documentation.pod:2186 msgid "" "Returns C<-1> for failure, C<0> on success, C<1> if the editor did not " "change the file (e.g. the user closed the editor without saving)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2266 +#: docs/internal-documentation.pod:2190 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2268 +#: docs/internal-documentation.pod:2192 #, no-wrap msgid "" " int\n" @@ -37562,34 +37383,34 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2272 +#: docs/internal-documentation.pod:2196 msgid "Edit C running the specified C using Perl." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2277 +#: docs/internal-documentation.pod:2201 msgid "Returns C<-1> for failure, C<0> on success." msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2279 +#: docs/internal-documentation.pod:2203 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2281 +#: docs/internal-documentation.pod:2205 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2283 +#: docs/internal-documentation.pod:2207 msgid "" "This file parses the guestfish configuration file, usually " "F<~/.libguestfs-tools.rc> or F." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2286 +#: docs/internal-documentation.pod:2210 msgid "" "Note that C is called very early, before command line parsing, " "before the C flag has been set, even before the global handle C " @@ -37597,24 +37418,24 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2290 +#: docs/internal-documentation.pod:2214 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2292 +#: docs/internal-documentation.pod:2216 msgid "" "This file implements the decryption of disk images, usually done before " "mounting their partitions." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2295 +#: docs/internal-documentation.pod:2219 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2297 +#: docs/internal-documentation.pod:2221 #, no-wrap msgid "" " static char *\n" @@ -37623,7 +37444,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2300 +#: docs/internal-documentation.pod:2224 msgid "" "Make a LUKS map name from the partition or logical volume name, eg. " "C<\"/dev/vda2\" =E \"cryptvda2\">, or C<\"/dev/vg-ssd/lv-root7\" =E " @@ -37633,12 +37454,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2306 +#: docs/internal-documentation.pod:2230 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2308 +#: docs/internal-documentation.pod:2232 #, no-wrap msgid "" " void\n" @@ -37647,19 +37468,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2311 +#: docs/internal-documentation.pod:2235 msgid "" "Simple implementation of decryption: look for any encrypted partitions and " "decrypt them, then rescan for VGs." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2314 +#: docs/internal-documentation.pod:2238 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2316 +#: docs/internal-documentation.pod:2240 msgid "" "This file contains common code used to implement I<--short-options> and " "I<--long-options> in C virt tools. (The equivalent for OCaml virt tools is " @@ -37667,17 +37488,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2320 +#: docs/internal-documentation.pod:2244 msgid "These \"hidden\" options are used to implement bash tab completion." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2322 +#: docs/internal-documentation.pod:2246 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2324 +#: docs/internal-documentation.pod:2248 #, no-wrap msgid "" " void\n" @@ -37686,19 +37507,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2327 +#: docs/internal-documentation.pod:2251 msgid "" "Implements the internal C> flag, which just lists " "out the short options available. Used by bash completion." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2330 +#: docs/internal-documentation.pod:2254 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2332 +#: docs/internal-documentation.pod:2256 #, no-wrap msgid "" " void\n" @@ -37707,29 +37528,29 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2335 +#: docs/internal-documentation.pod:2259 msgid "" "Implements the internal C> flag, which just lists out " "the long options available. Used by bash completion." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2338 +#: docs/internal-documentation.pod:2262 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2340 +#: docs/internal-documentation.pod:2264 msgid "Implements the guestfish (and other tools) I<-d> option." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2342 +#: docs/internal-documentation.pod:2266 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2344 +#: docs/internal-documentation.pod:2268 #, no-wrap msgid "" " int\n" @@ -37738,22 +37559,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2347 +#: docs/internal-documentation.pod:2271 msgid "This function is called when a user invokes S>." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2349 +#: docs/internal-documentation.pod:2273 msgid "Returns the number of drives added (S 0>>), or C<-1> for failure." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2351 +#: docs/internal-documentation.pod:2275 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2353 +#: docs/internal-documentation.pod:2277 msgid "" "This file implements inspecting the guest and mounting the filesystems found " "in the right places. It is used by the L I<-i> option and " @@ -37761,12 +37582,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2358 +#: docs/internal-documentation.pod:2282 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2360 +#: docs/internal-documentation.pod:2284 #, no-wrap msgid "" " void\n" @@ -37775,17 +37596,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2363 +#: docs/internal-documentation.pod:2287 msgid "This function implements the I<-i> option." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2365 +#: docs/internal-documentation.pod:2289 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2367 +#: docs/internal-documentation.pod:2291 #, no-wrap msgid "" " void\n" @@ -37794,24 +37615,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2370 +#: docs/internal-documentation.pod:2294 msgid "" "This function is called only if C was called, and only " "after we've printed the prompt in interactive mode." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2373 +#: docs/internal-documentation.pod:2297 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2375 +#: docs/internal-documentation.pod:2299 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2377 +#: docs/internal-documentation.pod:2301 #, no-wrap msgid "" " char *\n" @@ -37820,31 +37641,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2380 +#: docs/internal-documentation.pod:2304 msgid "Read a passphrase ('Key') from F with echo off." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2382 +#: docs/internal-documentation.pod:2306 msgid "" "The caller (F) will call free on the string afterwards. Based " "on the code in cryptsetup file F." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2385 +#: docs/internal-documentation.pod:2309 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2387 +#: docs/internal-documentation.pod:2311 msgid "" "This file contains common options parsing code used by guestfish and many " "other tools which share a common options syntax." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2390 +#: docs/internal-documentation.pod:2314 msgid "" "For example, guestfish, virt-cat, virt-ls etc all support the I<-a> option, " "and that is handled in all of those tools using a macro C defined " @@ -37852,19 +37673,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2394 +#: docs/internal-documentation.pod:2318 msgid "" "There are a lot of common global variables used, C accumulates the " "list of drives, C for the I<-v> flag, and many more." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2398 +#: docs/internal-documentation.pod:2322 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2400 +#: docs/internal-documentation.pod:2324 #, no-wrap msgid "" " void\n" @@ -37874,17 +37695,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2404 +#: docs/internal-documentation.pod:2328 msgid "Handle the guestfish I<-a> option on the command line." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2406 +#: docs/internal-documentation.pod:2330 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2408 +#: docs/internal-documentation.pod:2332 #, no-wrap msgid "" " void\n" @@ -37893,17 +37714,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2411 +#: docs/internal-documentation.pod:2335 msgid "Handle the I<-d> option when passed on the command line." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2413 +#: docs/internal-documentation.pod:2337 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2415 +#: docs/internal-documentation.pod:2339 #, no-wrap msgid "" " static void\n" @@ -37913,19 +37734,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2419 +#: docs/internal-documentation.pod:2343 msgid "" "If the I<-m> option fails on any command, display a useful error message " "listing the mountpoints." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2422 +#: docs/internal-documentation.pod:2346 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2424 +#: docs/internal-documentation.pod:2348 msgid "" "This file implements URI parsing for the I<-a> option, in many utilities " "including L, L, L, " @@ -37933,17 +37754,17 @@ msgid "" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2428 +#: docs/internal-documentation.pod:2352 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2430 +#: docs/internal-documentation.pod:2354 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2432 +#: docs/internal-documentation.pod:2356 msgid "" "This file is used by C and some of the other tools when they are " "implicitly asked to operate over all libvirt domains (VMs), for example when " @@ -37951,17 +37772,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2437 +#: docs/internal-documentation.pod:2361 msgid "It hides the complexity of querying the list of domains from libvirt." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2440 +#: docs/internal-documentation.pod:2364 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2442 +#: docs/internal-documentation.pod:2366 #, no-wrap msgid "" " void\n" @@ -37970,17 +37791,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2445 +#: docs/internal-documentation.pod:2369 msgid "Frees up everything allocated by C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2447 +#: docs/internal-documentation.pod:2371 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2449 +#: docs/internal-documentation.pod:2373 #, no-wrap msgid "" " void\n" @@ -37989,24 +37810,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2452 +#: docs/internal-documentation.pod:2376 msgid "" "Read all libguest guests into the global variables C and " "C. The guests are ordered by name. This exits on any error." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2456 +#: docs/internal-documentation.pod:2380 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2458 +#: docs/internal-documentation.pod:2382 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2460 +#: docs/internal-documentation.pod:2384 #, no-wrap msgid "" " size_t\n" @@ -38015,7 +37836,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2463 +#: docs/internal-documentation.pod:2387 msgid "" "This function uses the output of C to estimate how many libguestfs " "appliances could be safely started in parallel. Note that it always returns " @@ -38023,12 +37844,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2467 +#: docs/internal-documentation.pod:2391 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2469 +#: docs/internal-documentation.pod:2393 #, no-wrap msgid "" " static char *\n" @@ -38037,17 +37858,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2472 +#: docs/internal-documentation.pod:2396 msgid "Run external command and read the first line of output." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2474 +#: docs/internal-documentation.pod:2398 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2476 +#: docs/internal-documentation.pod:2400 msgid "" "This file is used by C and some of the other tools when they need " "to run multiple parallel libguestfs instances to operate on a large number " @@ -38055,7 +37876,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2480 +#: docs/internal-documentation.pod:2404 msgid "" "It implements a multithreaded work queue. In addition it reorders the " "output so the output still appears in the same order as the input (ie. still " @@ -38063,12 +37884,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2484 +#: docs/internal-documentation.pod:2408 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2486 +#: docs/internal-documentation.pod:2410 #, no-wrap msgid "" " int\n" @@ -38077,12 +37898,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2489 +#: docs/internal-documentation.pod:2413 msgid "Run the threads and work through the global list of libvirt domains." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2492 +#: docs/internal-documentation.pod:2416 msgid "" "C is whatever the user passed in the I<-P> option, or C<0> if the " "user didn't use the I<-P> option (in which case the number of threads is " @@ -38090,14 +37911,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2496 +#: docs/internal-documentation.pod:2420 msgid "" "C (which may be C) is the global guestfs handle " "created by the options mini-library." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2499 +#: docs/internal-documentation.pod:2423 msgid "" "The work function (C) should do the work (inspecting the domain, etc.) " "on domain index C. However it I print out any result " @@ -38106,36 +37927,36 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2505 +#: docs/internal-documentation.pod:2429 msgid "" "The C function returns C<0> if all work items completed " "successfully, or C<-1> if there was an error." msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2508 +#: docs/internal-documentation.pod:2432 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2510 +#: docs/internal-documentation.pod:2434 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2512 +#: docs/internal-documentation.pod:2436 msgid "" "This file implements the progress bar in L, L " "and L." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2515 +#: docs/internal-documentation.pod:2439 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2517 +#: docs/internal-documentation.pod:2441 #, no-wrap msgid "" " struct progress_bar *\n" @@ -38144,12 +37965,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2520 +#: docs/internal-documentation.pod:2444 msgid "Initialize a progress bar struct." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2522 +#: docs/internal-documentation.pod:2446 msgid "" "It is intended that you can reuse the same struct for multiple commands (but " "only in a single thread). Call C before each new " @@ -38157,12 +37978,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2526 +#: docs/internal-documentation.pod:2450 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2528 +#: docs/internal-documentation.pod:2452 #, no-wrap msgid "" " void\n" @@ -38171,17 +37992,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2531 +#: docs/internal-documentation.pod:2455 msgid "Free a progress bar struct." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2533 +#: docs/internal-documentation.pod:2457 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2535 +#: docs/internal-documentation.pod:2459 #, no-wrap msgid "" " void\n" @@ -38190,17 +38011,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2538 +#: docs/internal-documentation.pod:2462 msgid "This function should be called just before you issue any command." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2540 +#: docs/internal-documentation.pod:2464 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2542 +#: docs/internal-documentation.pod:2466 #, no-wrap msgid "" " static double\n" @@ -38209,12 +38030,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2545 +#: docs/internal-documentation.pod:2469 msgid "Return remaining time estimate (in seconds) for current call." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2547 +#: docs/internal-documentation.pod:2471 msgid "" "This returns the running mean estimate of remaining time, but if the latest " "estimate of total time is greater than two s.d.'s from the running mean then " @@ -38223,12 +38044,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2553 +#: docs/internal-documentation.pod:2477 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2555 +#: docs/internal-documentation.pod:2479 #, no-wrap msgid "" " void\n" @@ -38238,32 +38059,32 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2559 +#: docs/internal-documentation.pod:2483 msgid "Set the position of the progress bar." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2561 +#: docs/internal-documentation.pod:2485 msgid "This should be called from a C event callback." msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2564 +#: docs/internal-documentation.pod:2488 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2566 +#: docs/internal-documentation.pod:2490 msgid "File F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2573 +#: docs/internal-documentation.pod:2497 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2577 +#: docs/internal-documentation.pod:2501 msgid "" "There are some shortcomings with the model used for qemu options which " "aren't clear until you try to convert options into a configuration file. " @@ -38273,19 +38094,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2584 +#: docs/internal-documentation.pod:2508 msgid "For reference here are the problems:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2590 +#: docs/internal-documentation.pod:2514 msgid "" "There's inconsistency in qemu between options and config file, eg. C<-smp " "4> becomes:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2593 +#: docs/internal-documentation.pod:2517 #, no-wrap msgid "" " [smp-opts]\n" @@ -38294,7 +38115,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2598 +#: docs/internal-documentation.pod:2522 msgid "" "Similar to the previous point, you can write either C<-smp 4> or C<-smp " "cpus=4> (although this won't work in very old qemu). When generating a " @@ -38302,7 +38123,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2604 +#: docs/internal-documentation.pod:2528 msgid "" "In C<-opt key=value,...> the C is really a tree/array specifier. The " "way this works is complicated but hinted at here: " @@ -38310,19 +38131,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2611 +#: docs/internal-documentation.pod:2535 msgid "" "Some options are syntactic sugar. eg. C<-kernel foo> is sugar for " "C<-machine kernel=foo>." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2616 +#: docs/internal-documentation.pod:2540 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2618 +#: docs/internal-documentation.pod:2542 #, no-wrap msgid "" " struct qemuopts *\n" @@ -38331,27 +38152,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2621 +#: docs/internal-documentation.pod:2545 msgid "Create an empty list of qemu options." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2623 +#: docs/internal-documentation.pod:2547 msgid "The caller must eventually free the list by calling C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2626 docs/internal-documentation.pod:2812 +#: docs/internal-documentation.pod:2550 docs/internal-documentation.pod:2736 msgid "Returns C on error, setting C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2628 +#: docs/internal-documentation.pod:2552 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2630 +#: docs/internal-documentation.pod:2554 #, no-wrap msgid "" " void\n" @@ -38360,17 +38181,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2633 +#: docs/internal-documentation.pod:2557 msgid "Free the list of qemu options." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2635 +#: docs/internal-documentation.pod:2559 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2637 +#: docs/internal-documentation.pod:2561 #, no-wrap msgid "" " int\n" @@ -38379,12 +38200,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2640 +#: docs/internal-documentation.pod:2564 msgid "Add a command line flag which has no argument. eg:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2642 +#: docs/internal-documentation.pod:2566 #, no-wrap msgid "" " qemuopts_add_flag (qopts, \"-no-user-config\");\n" @@ -38392,21 +38213,21 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2644 docs/internal-documentation.pod:2658 -#: docs/internal-documentation.pod:2673 docs/internal-documentation.pod:2714 -#: docs/internal-documentation.pod:2731 docs/internal-documentation.pod:2740 -#: docs/internal-documentation.pod:2754 docs/internal-documentation.pod:2768 -#: docs/internal-documentation.pod:2796 docs/internal-documentation.pod:2838 +#: docs/internal-documentation.pod:2568 docs/internal-documentation.pod:2582 +#: docs/internal-documentation.pod:2597 docs/internal-documentation.pod:2638 +#: docs/internal-documentation.pod:2655 docs/internal-documentation.pod:2664 +#: docs/internal-documentation.pod:2678 docs/internal-documentation.pod:2692 +#: docs/internal-documentation.pod:2720 docs/internal-documentation.pod:2762 msgid "Returns C<0> on success. Returns C<-1> on error, setting C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2646 +#: docs/internal-documentation.pod:2570 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2648 +#: docs/internal-documentation.pod:2572 #, no-wrap msgid "" " int\n" @@ -38416,12 +38237,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2651 +#: docs/internal-documentation.pod:2575 msgid "Add a command line flag which has a single argument. eg:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2653 +#: docs/internal-documentation.pod:2577 #, no-wrap msgid "" " qemuopts_add_arg (qopts, \"-m\", \"1024\");\n" @@ -38429,19 +38250,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2655 docs/internal-documentation.pod:2670 +#: docs/internal-documentation.pod:2579 docs/internal-documentation.pod:2594 msgid "" "Don't use this if the argument is a comma-separated list, since quoting will " "not be done properly. See C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2660 +#: docs/internal-documentation.pod:2584 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2662 +#: docs/internal-documentation.pod:2586 #, no-wrap msgid "" " int\n" @@ -38451,12 +38272,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2666 +#: docs/internal-documentation.pod:2590 msgid "Add a command line flag which has a single formatted argument. eg:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2668 +#: docs/internal-documentation.pod:2592 #, no-wrap msgid "" " qemuopts_add_arg_format (qopts, \"-m\", \"%d\", 1024);\n" @@ -38464,12 +38285,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2675 +#: docs/internal-documentation.pod:2599 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2677 +#: docs/internal-documentation.pod:2601 #, no-wrap msgid "" " int\n" @@ -38479,41 +38300,41 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2681 +#: docs/internal-documentation.pod:2605 msgid "" "This is like C except that no quoting is done on the " "value." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2684 +#: docs/internal-documentation.pod:2608 msgid "" "For C and C, this means that " "neither shell quoting nor qemu comma quoting is done on the value." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2688 +#: docs/internal-documentation.pod:2612 msgid "For C this means that qemu comma quoting is not done." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2691 +#: docs/internal-documentation.pod:2615 msgid "C will fail." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2693 +#: docs/internal-documentation.pod:2617 msgid "You should use this with great care." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2695 +#: docs/internal-documentation.pod:2619 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2697 +#: docs/internal-documentation.pod:2621 #, no-wrap msgid "" " int\n" @@ -38522,17 +38343,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2700 +#: docs/internal-documentation.pod:2624 msgid "Start an argument that takes a comma-separated list of fields." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2702 +#: docs/internal-documentation.pod:2626 msgid "Typical usage is like this (with error handling omitted):" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2704 +#: docs/internal-documentation.pod:2628 #, no-wrap msgid "" " qemuopts_start_arg_list (qopts, \"-drive\");\n" @@ -38543,22 +38364,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2709 +#: docs/internal-documentation.pod:2633 msgid "which would construct C<-drive file=foo,if=ide>" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2711 +#: docs/internal-documentation.pod:2635 msgid "See also C for a way to do simple cases in one call." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2716 +#: docs/internal-documentation.pod:2640 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2718 +#: docs/internal-documentation.pod:2642 #, no-wrap msgid "" " int\n" @@ -38568,12 +38389,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2722 +#: docs/internal-documentation.pod:2646 msgid "Add a command line flag which has a list of arguments. eg:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2724 +#: docs/internal-documentation.pod:2648 #, no-wrap msgid "" " qemuopts_add_arg_list (qopts, \"-drive\", \"file=foo\", \"if=ide\", " @@ -38582,7 +38403,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2726 +#: docs/internal-documentation.pod:2650 msgid "" "This is turned into a comma-separated list, like: C<-drive " "file=foo,if=ide>. Note that this handles qemu quoting properly, so " @@ -38590,12 +38411,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2733 +#: docs/internal-documentation.pod:2657 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2735 +#: docs/internal-documentation.pod:2659 #, no-wrap msgid "" " int\n" @@ -38604,17 +38425,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2738 +#: docs/internal-documentation.pod:2662 msgid "Set the qemu binary name." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2742 +#: docs/internal-documentation.pod:2666 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2744 +#: docs/internal-documentation.pod:2668 #, no-wrap msgid "" " int\n" @@ -38623,19 +38444,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2747 +#: docs/internal-documentation.pod:2671 msgid "Set the qemu binary name to C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2749 +#: docs/internal-documentation.pod:2673 msgid "" "As a special case if C is C, the binary is set to the KVM binary " "for the current host architecture:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2752 +#: docs/internal-documentation.pod:2676 #, no-wrap msgid "" " qemuopts_set_binary_by_arch (qopts, NULL);\n" @@ -38643,12 +38464,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2756 +#: docs/internal-documentation.pod:2680 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2758 +#: docs/internal-documentation.pod:2682 #, no-wrap msgid "" " int\n" @@ -38657,29 +38478,29 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2761 +#: docs/internal-documentation.pod:2685 msgid "Write the qemu options to a script." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2763 docs/internal-documentation.pod:2791 +#: docs/internal-documentation.pod:2687 docs/internal-documentation.pod:2715 msgid "C must be called first." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2765 +#: docs/internal-documentation.pod:2689 msgid "" "The script file will start with C<#!/bin/sh> and will be chmod to mode " "C<0755>." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2770 +#: docs/internal-documentation.pod:2694 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2772 +#: docs/internal-documentation.pod:2696 #, no-wrap msgid "" " static void\n" @@ -38688,17 +38509,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2775 +#: docs/internal-documentation.pod:2699 msgid "Print C to C, shell-quoting it if necessary." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2777 +#: docs/internal-documentation.pod:2701 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2779 +#: docs/internal-documentation.pod:2703 #, no-wrap msgid "" " static void\n" @@ -38707,17 +38528,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2782 +#: docs/internal-documentation.pod:2706 msgid "Print C to C doing both shell and qemu comma quoting." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2784 +#: docs/internal-documentation.pod:2708 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2786 +#: docs/internal-documentation.pod:2710 #, no-wrap msgid "" " int\n" @@ -38726,24 +38547,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2789 +#: docs/internal-documentation.pod:2713 msgid "Write the qemu options to a C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2793 +#: docs/internal-documentation.pod:2717 msgid "" "Only the qemu command line is written. The caller may need to add " "C<#!/bin/sh> and may need to chmod the resulting file to C<0755>." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2798 +#: docs/internal-documentation.pod:2722 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2800 +#: docs/internal-documentation.pod:2724 #, no-wrap msgid "" " char **\n" @@ -38752,31 +38573,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2803 +#: docs/internal-documentation.pod:2727 msgid "" "Return a NULL-terminated argument list, of the kind that can be passed " "directly to L." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2806 +#: docs/internal-documentation.pod:2730 msgid "" "C must be called first. It will be returned as " "C in the returned list." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2809 +#: docs/internal-documentation.pod:2733 msgid "The list of strings and the strings themselves must be freed by the caller." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2814 +#: docs/internal-documentation.pod:2738 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2816 +#: docs/internal-documentation.pod:2740 #, no-wrap msgid "" " int\n" @@ -38785,14 +38606,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2819 +#: docs/internal-documentation.pod:2743 msgid "" "Write the qemu options to a qemu config file, suitable for reading in using " "C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2822 +#: docs/internal-documentation.pod:2746 msgid "" "Note that qemu config files have limitations on content and quoting, so not " "all qemuopts structs can be written (this function returns an error in these " @@ -38802,14 +38623,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2828 +#: docs/internal-documentation.pod:2752 msgid "" "Also, command line argument names and config file sections sometimes have " "different names. For example the equivalent of C<-m 1024> is:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2832 +#: docs/internal-documentation.pod:2756 #, no-wrap msgid "" " [memory]\n" @@ -38818,19 +38639,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2835 +#: docs/internal-documentation.pod:2759 msgid "" "This code does I attempt to convert between the two forms. You just " "need to know how to do that yourself." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2840 +#: docs/internal-documentation.pod:2764 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2842 +#: docs/internal-documentation.pod:2766 #, no-wrap msgid "" " int\n" @@ -38839,22 +38660,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2845 +#: docs/internal-documentation.pod:2769 msgid "Same as C, but this writes to a C." msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2847 +#: docs/internal-documentation.pod:2771 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2849 +#: docs/internal-documentation.pod:2773 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2851 docs/internal-documentation.pod:2891 +#: docs/internal-documentation.pod:2775 docs/internal-documentation.pod:2815 msgid "" "Libguestfs uses C macros to simplify temporary allocations. They " "are implemented using the C<__attribute__((cleanup))> feature of gcc and " @@ -38862,7 +38683,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2856 docs/internal-documentation.pod:2896 +#: docs/internal-documentation.pod:2780 docs/internal-documentation.pod:2820 #, no-wrap msgid "" " fn ()\n" @@ -38875,12 +38696,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2863 docs/internal-documentation.pod:2903 +#: docs/internal-documentation.pod:2787 docs/internal-documentation.pod:2827 msgid "There are a few catches to be aware of with the cleanup mechanism:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2869 docs/internal-documentation.pod:2909 +#: docs/internal-documentation.pod:2793 docs/internal-documentation.pod:2833 msgid "" "If a cleanup variable is not initialized, then you can end up calling " "L with an undefined value, resulting in the program crashing. For " @@ -38889,43 +38710,43 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2876 docs/internal-documentation.pod:2916 +#: docs/internal-documentation.pod:2800 docs/internal-documentation.pod:2840 msgid "Don't mark variables holding return values as cleanup variables." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2880 docs/internal-documentation.pod:2920 +#: docs/internal-documentation.pod:2804 docs/internal-documentation.pod:2844 msgid "" "The C function shouldn't use cleanup variables since it is normally " "exited by calling L, and that doesn't call the cleanup handlers." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2886 docs/internal-documentation.pod:2926 +#: docs/internal-documentation.pod:2810 docs/internal-documentation.pod:2850 msgid "" "The functions in this file are used internally by the C macros. " "Don't call them directly." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2889 +#: docs/internal-documentation.pod:2813 msgid "File F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2929 +#: docs/internal-documentation.pod:2853 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2931 +#: docs/internal-documentation.pod:2855 msgid "" "This header file is included in all \"frontend\" parts of libguestfs, namely " "the library, non-C language bindings, virt tools and tests." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2934 +#: docs/internal-documentation.pod:2858 msgid "" "The daemon does B use this header. If you need a place to put " "something shared with absolutely everything including the daemon, put it in " @@ -38933,33 +38754,33 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2938 +#: docs/internal-documentation.pod:2862 msgid "" "If a definition is only needed by a single component of libguestfs (eg. just " "the library, or just a single virt tool) then it should B be here!" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2942 +#: docs/internal-documentation.pod:2866 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2944 +#: docs/internal-documentation.pod:2868 msgid "" "These macros make it easier to write XML. To use them correctly you must be " "aware of these assumptions:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2951 +#: docs/internal-documentation.pod:2875 msgid "" "The C is called C. It is used implicitly by all the " "macros." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2956 +#: docs/internal-documentation.pod:2880 msgid "" "On failure, a function called C is called which you must define " "(usually as a macro). You must use C macros in your functions if " @@ -38967,17 +38788,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2963 +#: docs/internal-documentation.pod:2887 msgid "All the \"bad\" casting is hidden inside the macros." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2967 +#: docs/internal-documentation.pod:2891 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2969 +#: docs/internal-documentation.pod:2893 #, no-wrap msgid "" " #define start_element\n" @@ -38985,12 +38806,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2971 +#: docs/internal-documentation.pod:2895 msgid "To define an XML element use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2973 +#: docs/internal-documentation.pod:2897 #, no-wrap msgid "" " start_element (\"name\") {\n" @@ -39000,17 +38821,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2977 +#: docs/internal-documentation.pod:2901 msgid "which produces C<<< ... >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2979 +#: docs/internal-documentation.pod:2903 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2981 +#: docs/internal-documentation.pod:2905 #, no-wrap msgid "" " #define empty_element\n" @@ -39018,12 +38839,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2983 +#: docs/internal-documentation.pod:2907 msgid "To define an empty element:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2985 +#: docs/internal-documentation.pod:2909 #, no-wrap msgid "" " empty_element (\"name\");\n" @@ -39031,17 +38852,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2987 +#: docs/internal-documentation.pod:2911 msgid "which produces C<<< >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2989 +#: docs/internal-documentation.pod:2913 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2991 +#: docs/internal-documentation.pod:2915 #, no-wrap msgid "" " #define single_element\n" @@ -39049,12 +38870,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2993 +#: docs/internal-documentation.pod:2917 msgid "To define a single element with no attributes containing some text:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2995 +#: docs/internal-documentation.pod:2919 #, no-wrap msgid "" " single_element (\"name\", text);\n" @@ -39062,17 +38883,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2997 +#: docs/internal-documentation.pod:2921 msgid "which produces C<<< text >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2999 +#: docs/internal-documentation.pod:2923 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3001 +#: docs/internal-documentation.pod:2925 #, no-wrap msgid "" " #define single_element_format\n" @@ -39080,14 +38901,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3003 +#: docs/internal-documentation.pod:2927 msgid "" "To define a single element with no attributes containing some text using a " "format string:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3006 +#: docs/internal-documentation.pod:2930 #, no-wrap msgid "" " single_element_format (\"cores\", \"%d\", nr_cores);\n" @@ -39095,17 +38916,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3008 +#: docs/internal-documentation.pod:2932 msgid "which produces C<<< 4 >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3010 +#: docs/internal-documentation.pod:2934 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3012 +#: docs/internal-documentation.pod:2936 #, no-wrap msgid "" " #define attribute\n" @@ -39113,12 +38934,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3014 +#: docs/internal-documentation.pod:2938 msgid "To define an XML element with attributes, use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3016 +#: docs/internal-documentation.pod:2940 #, no-wrap msgid "" " start_element (\"name\") {\n" @@ -39130,17 +38951,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3022 +#: docs/internal-documentation.pod:2946 msgid "which produces C<<< ... >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3024 +#: docs/internal-documentation.pod:2948 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3026 +#: docs/internal-documentation.pod:2950 #, no-wrap msgid "" " #define attribute_ns\n" @@ -39148,19 +38969,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3028 +#: docs/internal-documentation.pod:2952 msgid "" "C defines a namespaced " "attribute." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3031 +#: docs/internal-documentation.pod:2955 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3033 +#: docs/internal-documentation.pod:2957 #, no-wrap msgid "" " #define string\n" @@ -39168,12 +38989,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3035 +#: docs/internal-documentation.pod:2959 msgid "To define a verbatim string, use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3037 +#: docs/internal-documentation.pod:2961 #, no-wrap msgid "" " string (\"hello\");\n" @@ -39181,12 +39002,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3039 +#: docs/internal-documentation.pod:2963 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3041 +#: docs/internal-documentation.pod:2965 #, no-wrap msgid "" " #define string_format\n" @@ -39194,12 +39015,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3043 +#: docs/internal-documentation.pod:2967 msgid "To define a verbatim string using a format string, use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3045 +#: docs/internal-documentation.pod:2969 #, no-wrap msgid "" " string (\"%s, world\", greeting);\n" @@ -39207,12 +39028,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3047 +#: docs/internal-documentation.pod:2971 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3049 +#: docs/internal-documentation.pod:2973 #, no-wrap msgid "" " #define base64\n" @@ -39220,12 +39041,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3051 +#: docs/internal-documentation.pod:2975 msgid "To write a string encoded as base64:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3053 +#: docs/internal-documentation.pod:2977 #, no-wrap msgid "" " base64 (data, size);\n" @@ -39233,12 +39054,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3055 +#: docs/internal-documentation.pod:2979 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3057 +#: docs/internal-documentation.pod:2981 #, no-wrap msgid "" " #define comment\n" @@ -39246,12 +39067,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3059 +#: docs/internal-documentation.pod:2983 msgid "To define a comment in the XML, use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3061 +#: docs/internal-documentation.pod:2985 #, no-wrap msgid "" " comment (\"number of items = %d\", nr_items);\n" @@ -39259,29 +39080,29 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3063 +#: docs/internal-documentation.pod:2987 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3065 docs/internal-documentation.pod:3102 +#: docs/internal-documentation.pod:2989 docs/internal-documentation.pod:3026 msgid "Utility functions used by the library, tools and language bindings." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3067 docs/internal-documentation.pod:3104 +#: docs/internal-documentation.pod:2991 docs/internal-documentation.pod:3028 msgid "" "These functions I call internal library functions such as " "C, C or C, or any C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3070 +#: docs/internal-documentation.pod:2994 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3072 +#: docs/internal-documentation.pod:2996 #, no-wrap msgid "" " char **\n" @@ -39290,69 +39111,69 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3075 +#: docs/internal-documentation.pod:2999 msgid "" "Split string at separator character C, returning the list of strings. " "Returns C on memory allocation failure." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3078 +#: docs/internal-documentation.pod:3002 msgid "Note (assuming C is C<:>):" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3082 +#: docs/internal-documentation.pod:3006 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3084 +#: docs/internal-documentation.pod:3008 msgid "aborts" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3086 +#: docs/internal-documentation.pod:3010 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3088 docs/internal-documentation.pod:3779 +#: docs/internal-documentation.pod:3012 docs/internal-documentation.pod:3703 msgid "returns C<[]>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3090 +#: docs/internal-documentation.pod:3014 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3092 +#: docs/internal-documentation.pod:3016 msgid "returns C<[\"abc\"]>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3094 +#: docs/internal-documentation.pod:3018 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3096 +#: docs/internal-documentation.pod:3020 msgid "returns C<[\"\", \"\"]>" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3100 +#: docs/internal-documentation.pod:3024 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3107 +#: docs/internal-documentation.pod:3031 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3109 +#: docs/internal-documentation.pod:3033 #, no-wrap msgid "" " char *\n" @@ -39362,7 +39183,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3112 +#: docs/internal-documentation.pod:3036 msgid "" "Replace every instance of C appearing in C with C. A newly " "allocated string is returned which must be freed by the caller. If " @@ -39370,7 +39191,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3118 +#: docs/internal-documentation.pod:3042 #, no-wrap msgid "" " replace_string (\"abcabb\", \"ab\", \"a\");\n" @@ -39378,17 +39199,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3120 +#: docs/internal-documentation.pod:3044 msgid "would return C<\"acab\">." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3122 +#: docs/internal-documentation.pod:3046 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3124 +#: docs/internal-documentation.pod:3048 #, no-wrap msgid "" " char *\n" @@ -39398,17 +39219,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3128 +#: docs/internal-documentation.pod:3052 msgid "Translate a wait/system exit status into a printable string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3130 +#: docs/internal-documentation.pod:3054 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3132 +#: docs/internal-documentation.pod:3056 #, no-wrap msgid "" " int\n" @@ -39417,31 +39238,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3135 +#: docs/internal-documentation.pod:3059 msgid "Return a random string of characters." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3143 +#: docs/internal-documentation.pod:3067 msgid "" "The C buffer must have length C in order to store the final " "C<\\0> character." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3148 +#: docs/internal-documentation.pod:3072 msgid "" "There is about 5 bits of randomness per output character (so about C<5*len> " "bits of randomness in the resulting string)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3153 +#: docs/internal-documentation.pod:3077 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3155 +#: docs/internal-documentation.pod:3079 #, no-wrap msgid "" " char *\n" @@ -39450,12 +39271,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3158 +#: docs/internal-documentation.pod:3082 msgid "This turns a drive index (eg. C<27>) into a drive name (eg. C<\"ab\">)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3161 +#: docs/internal-documentation.pod:3085 msgid "" "Drive indexes count from C<0>. The return buffer has to be large enough for " "the resulting string, and the returned pointer points to the *end* of the " @@ -39463,17 +39284,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3165 +#: docs/internal-documentation.pod:3089 msgid "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3167 +#: docs/internal-documentation.pod:3091 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3169 +#: docs/internal-documentation.pod:3093 #, no-wrap msgid "" " ssize_t\n" @@ -39482,26 +39303,26 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3172 +#: docs/internal-documentation.pod:3096 msgid "" "The opposite of C. Take a string like C<\"ab\"> and " "return the index (eg C<27>)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3175 +#: docs/internal-documentation.pod:3099 msgid "" "Note that you must remove any prefix such as C<\"hd\">, C<\"sd\"> etc, or " "any partition number before calling the function." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3178 +#: docs/internal-documentation.pod:3102 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3180 +#: docs/internal-documentation.pod:3104 #, no-wrap msgid "" " int\n" @@ -39510,17 +39331,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3183 +#: docs/internal-documentation.pod:3107 msgid "Similar to C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3185 +#: docs/internal-documentation.pod:3109 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3187 +#: docs/internal-documentation.pod:3111 #, no-wrap msgid "" " bool\n" @@ -39531,7 +39352,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3192 +#: docs/internal-documentation.pod:3116 msgid "" "Check a string for validity, that it contains only certain characters, and " "minimum and maximum length. This function is usually wrapped in a VALID_* " @@ -39539,63 +39360,63 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3197 +#: docs/internal-documentation.pod:3121 msgid "C is the string to check." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3199 +#: docs/internal-documentation.pod:3123 msgid "" "C and C are the minimum and maximum length checks. " "C<0> means no check." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3202 +#: docs/internal-documentation.pod:3126 msgid "The flags control:" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3206 +#: docs/internal-documentation.pod:3130 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3208 +#: docs/internal-documentation.pod:3132 msgid "7-bit ASCII-only alphabetic characters are permitted." msgstr "" #. type: =item -#: docs/internal-documentation.pod:3210 +#: docs/internal-documentation.pod:3134 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3212 +#: docs/internal-documentation.pod:3136 msgid "7-bit ASCII-only digits are permitted." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3216 +#: docs/internal-documentation.pod:3140 msgid "" "C is a set of extra characters permitted, in addition to alphabetic " "and/or digits. (C for no extra)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3219 +#: docs/internal-documentation.pod:3143 msgid "" "Returns boolean C if the string is valid (passes all the tests), or " "C if not." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3222 +#: docs/internal-documentation.pod:3146 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3224 +#: docs/internal-documentation.pod:3148 #, no-wrap msgid "" " void\n" @@ -39604,12 +39425,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3227 +#: docs/internal-documentation.pod:3151 msgid "Hint that we will read or write the file descriptor normally." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3229 +#: docs/internal-documentation.pod:3153 msgid "" "On Linux, this clears the C flag on the file [see below] and " "sets the per-file number of readahead pages to equal the block device " @@ -39617,21 +39438,21 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3233 docs/internal-documentation.pod:3247 -#: docs/internal-documentation.pod:3274 docs/internal-documentation.pod:3286 -#: docs/internal-documentation.pod:3303 docs/internal-documentation.pod:3317 +#: docs/internal-documentation.pod:3157 docs/internal-documentation.pod:3171 +#: docs/internal-documentation.pod:3198 docs/internal-documentation.pod:3210 +#: docs/internal-documentation.pod:3227 docs/internal-documentation.pod:3241 msgid "" "It's OK to call this on a non-file since we ignore failure as it is only a " "hint." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3236 +#: docs/internal-documentation.pod:3160 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3238 +#: docs/internal-documentation.pod:3162 #, no-wrap msgid "" " void\n" @@ -39640,12 +39461,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3241 +#: docs/internal-documentation.pod:3165 msgid "Hint that we will read or write the file descriptor sequentially." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3243 +#: docs/internal-documentation.pod:3167 msgid "" "On Linux, this clears the C flag on the file [see below] and " "sets the per-file number of readahead pages to twice the block device " @@ -39653,12 +39474,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3250 +#: docs/internal-documentation.pod:3174 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3252 +#: docs/internal-documentation.pod:3176 #, no-wrap msgid "" " void\n" @@ -39667,24 +39488,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3255 +#: docs/internal-documentation.pod:3179 msgid "Hint that we will read or write the file descriptor randomly." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3257 +#: docs/internal-documentation.pod:3181 msgid "" "On Linux, this sets the C flag on the file. The effect of " "this flag is to:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3264 +#: docs/internal-documentation.pod:3188 msgid "Disable normal sequential file readahead." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3268 +#: docs/internal-documentation.pod:3192 msgid "" "If any read of the file is done which misses in the page cache, 2MB are read " "into the page cache. [I think - I'm not sure I totally understand what this " @@ -39692,12 +39513,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3277 +#: docs/internal-documentation.pod:3201 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3279 +#: docs/internal-documentation.pod:3203 #, no-wrap msgid "" " void\n" @@ -39706,22 +39527,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3282 +#: docs/internal-documentation.pod:3206 msgid "Hint that we will access the data only once." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3284 +#: docs/internal-documentation.pod:3208 msgid "On Linux, this does nothing." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3289 +#: docs/internal-documentation.pod:3213 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3291 +#: docs/internal-documentation.pod:3215 #, no-wrap msgid "" " void\n" @@ -39730,12 +39551,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3294 +#: docs/internal-documentation.pod:3218 msgid "Hint that we will not access the data in the near future." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3296 +#: docs/internal-documentation.pod:3220 msgid "" "On Linux, this immediately writes out any dirty pages in the page cache and " "then invalidates (drops) all pages associated with this file from the page " @@ -39745,12 +39566,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3306 +#: docs/internal-documentation.pod:3230 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3308 +#: docs/internal-documentation.pod:3232 #, no-wrap msgid "" " void\n" @@ -39759,12 +39580,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3311 +#: docs/internal-documentation.pod:3235 msgid "Hint that we will access the data in the near future." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3313 +#: docs/internal-documentation.pod:3237 msgid "" "On Linux, this immediately reads the whole file into the page cache. This " "setting is not persistent; subsequently pages may be dropped from the page " @@ -39772,12 +39593,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3320 +#: docs/internal-documentation.pod:3244 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3322 +#: docs/internal-documentation.pod:3246 #, no-wrap msgid "" " char *\n" @@ -39786,12 +39607,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3325 +#: docs/internal-documentation.pod:3249 msgid "Unquote a shell-quoted string." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3327 +#: docs/internal-documentation.pod:3251 msgid "" "Augeas passes strings to us which may be quoted, eg. if they come from files " "in F. This function can do simple unquoting of these " @@ -39799,7 +39620,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3331 +#: docs/internal-documentation.pod:3255 msgid "" "Note this function does not do variable substitution, since that is " "impossible without knowing the file context and indeed the environment under " @@ -39808,7 +39629,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3336 +#: docs/internal-documentation.pod:3260 msgid "" "C is the input string from Augeas, a string that may be single- or " "double-quoted or may not be quoted. The returned string is unquoted, and " @@ -39817,19 +39638,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3341 +#: docs/internal-documentation.pod:3265 msgid "" "For information on double-quoting in bash, see " "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3344 +#: docs/internal-documentation.pod:3268 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3346 +#: docs/internal-documentation.pod:3270 #, no-wrap msgid "" " int\n" @@ -39838,19 +39659,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3349 +#: docs/internal-documentation.pod:3273 msgid "" "Return true if the C or C C field " "represents a regular file." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3352 +#: docs/internal-documentation.pod:3276 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3354 +#: docs/internal-documentation.pod:3278 #, no-wrap msgid "" " int\n" @@ -39859,19 +39680,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3357 +#: docs/internal-documentation.pod:3281 msgid "" "Return true if the C or C C field " "represents a directory." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3360 +#: docs/internal-documentation.pod:3284 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3362 +#: docs/internal-documentation.pod:3286 #, no-wrap msgid "" " int\n" @@ -39880,19 +39701,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3365 +#: docs/internal-documentation.pod:3289 msgid "" "Return true if the C or C C field " "represents a char device." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3368 +#: docs/internal-documentation.pod:3292 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3370 +#: docs/internal-documentation.pod:3294 #, no-wrap msgid "" " int\n" @@ -39901,19 +39722,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3373 +#: docs/internal-documentation.pod:3297 msgid "" "Return true if the C or C C field " "represents a block device." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3376 +#: docs/internal-documentation.pod:3300 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3378 +#: docs/internal-documentation.pod:3302 #, no-wrap msgid "" " int\n" @@ -39922,19 +39743,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3381 +#: docs/internal-documentation.pod:3305 msgid "" "Return true if the C or C C field " "represents a named pipe (FIFO)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3384 +#: docs/internal-documentation.pod:3308 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3386 +#: docs/internal-documentation.pod:3310 #, no-wrap msgid "" " int\n" @@ -39943,19 +39764,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3389 +#: docs/internal-documentation.pod:3313 msgid "" "Return true if the C or C C field " "represents a symbolic link." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3392 +#: docs/internal-documentation.pod:3316 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3394 +#: docs/internal-documentation.pod:3318 #, no-wrap msgid "" " int\n" @@ -39964,19 +39785,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3397 +#: docs/internal-documentation.pod:3321 msgid "" "Return true if the C or C C field " "represents a Unix domain socket." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3400 +#: docs/internal-documentation.pod:3324 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3402 +#: docs/internal-documentation.pod:3326 #, no-wrap msgid "" " char *\n" @@ -39985,7 +39806,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3405 +#: docs/internal-documentation.pod:3329 msgid "" "Concatenate C and C to create a path. This correctly handles the " "case of concatenating C<\"/\" + \"filename\"> as well as C<\"/dir\" + " @@ -39993,22 +39814,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3409 +#: docs/internal-documentation.pod:3333 msgid "The caller must free the returned path." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3411 +#: docs/internal-documentation.pod:3335 msgid "This function sets C and returns C on error." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3413 +#: docs/internal-documentation.pod:3337 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3415 +#: docs/internal-documentation.pod:3339 #, no-wrap msgid "" " void\n" @@ -40017,17 +39838,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3418 +#: docs/internal-documentation.pod:3342 msgid "Hexdump a block of memory to C, used for debugging." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3420 +#: docs/internal-documentation.pod:3344 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3422 +#: docs/internal-documentation.pod:3346 #, no-wrap msgid "" " const char *\n" @@ -40036,19 +39857,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3425 +#: docs/internal-documentation.pod:3349 msgid "Thread-safe strerror_r." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3427 +#: docs/internal-documentation.pod:3351 msgid "" "This is a wrapper around the two variants of L in glibc since " "it is hard to use correctly (RHBZ#2030396)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3430 +#: docs/internal-documentation.pod:3354 msgid "" "The buffer passed in should be large enough to store the error message (256 " "chars at least) and should be non-static. Note that the buffer might not be " @@ -40056,36 +39877,36 @@ msgid "" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:3434 +#: docs/internal-documentation.pod:3358 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3436 +#: docs/internal-documentation.pod:3360 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3438 +#: docs/internal-documentation.pod:3362 msgid "" "This file contains a recursive function for visiting all files and " "directories in a guestfs filesystem." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3441 +#: docs/internal-documentation.pod:3365 msgid "" "Adapted from " "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3444 +#: docs/internal-documentation.pod:3368 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3446 +#: docs/internal-documentation.pod:3370 #, no-wrap msgid "" " int\n" @@ -40094,19 +39915,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3449 +#: docs/internal-documentation.pod:3373 msgid "Visit every file and directory in a guestfs filesystem, starting at C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3452 +#: docs/internal-documentation.pod:3376 msgid "" "C may be C<\"/\"> to visit the entire filesystem, or may be some " "subdirectory. Symbolic links are not followed." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3455 +#: docs/internal-documentation.pod:3379 msgid "" "The visitor function C is called once for every directory and every " "file. The parameters passed to C include the current directory name, the " @@ -40117,14 +39938,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3463 +#: docs/internal-documentation.pod:3387 msgid "" "Also passed to this function is an C pointer which is passed through " "to the visitor function." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3466 +#: docs/internal-documentation.pod:3390 msgid "" "Returns C<0> if everything went OK, or C<-1> if there was an error. Error " "handling is not particularly well defined. It will either set an error in " @@ -40133,27 +39954,27 @@ msgid "" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:3471 +#: docs/internal-documentation.pod:3395 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3473 +#: docs/internal-documentation.pod:3397 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3475 +#: docs/internal-documentation.pod:3399 msgid "This file implements C Windows file path support in L." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3478 +#: docs/internal-documentation.pod:3402 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3480 +#: docs/internal-documentation.pod:3404 #, no-wrap msgid "" " int\n" @@ -40162,22 +39983,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3483 +#: docs/internal-documentation.pod:3407 msgid "Checks whether C is a Windows installation." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3485 +#: docs/internal-documentation.pod:3409 msgid "This relies on an already being done introspection." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3487 +#: docs/internal-documentation.pod:3411 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3489 +#: docs/internal-documentation.pod:3413 #, no-wrap msgid "" " char *\n" @@ -40187,58 +40008,58 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3492 +#: docs/internal-documentation.pod:3416 msgid "" "Resolves C as possible Windows path according to C, giving a new " "path that can be used in libguestfs API calls." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3501 +#: docs/internal-documentation.pod:3425 msgid "C must be a Windows installation" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3505 +#: docs/internal-documentation.pod:3429 msgid "relies on an already being done introspection" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3509 +#: docs/internal-documentation.pod:3433 msgid "" "will unmount all the existing mount points and mount the Windows root " "(according to C)" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3514 +#: docs/internal-documentation.pod:3438 msgid "calls L on memory allocation failures" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:3518 +#: docs/internal-documentation.pod:3442 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3520 +#: docs/internal-documentation.pod:3444 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3522 +#: docs/internal-documentation.pod:3446 msgid "" "This file contains a number of useful functions for running external " "commands and capturing their output." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3525 +#: docs/internal-documentation.pod:3449 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3527 +#: docs/internal-documentation.pod:3451 #, no-wrap msgid "" " int\n" @@ -40248,36 +40069,36 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3531 +#: docs/internal-documentation.pod:3455 msgid "Run a command. Optionally capture stdout and stderr as strings." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3533 +#: docs/internal-documentation.pod:3457 msgid "" "Returns C<0> if the command ran successfully, or C<-1> if there was any " "error." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3536 +#: docs/internal-documentation.pod:3460 msgid "For a description of the C see C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3538 +#: docs/internal-documentation.pod:3462 msgid "" "There is also a macro C which calls C " "with C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3541 +#: docs/internal-documentation.pod:3465 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3543 +#: docs/internal-documentation.pod:3467 #, no-wrap msgid "" " int\n" @@ -40287,31 +40108,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3547 +#: docs/internal-documentation.pod:3471 msgid "" "Same as C, but we allow the status code from the subcommand to be " "non-zero, and return that status code." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3550 +#: docs/internal-documentation.pod:3474 msgid "We still return C<-1> if there was some other error." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3552 +#: docs/internal-documentation.pod:3476 msgid "" "There is also a macro C which calls C " "with C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3555 +#: docs/internal-documentation.pod:3479 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3557 +#: docs/internal-documentation.pod:3481 #, no-wrap msgid "" " int\n" @@ -40321,24 +40142,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3561 +#: docs/internal-documentation.pod:3485 msgid "Same as C, but passing in an argv array." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3563 +#: docs/internal-documentation.pod:3487 msgid "" "There is also a macro C which calls C " "with C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3566 +#: docs/internal-documentation.pod:3490 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3568 +#: docs/internal-documentation.pod:3492 #, no-wrap msgid "" " int\n" @@ -40348,7 +40169,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3572 +#: docs/internal-documentation.pod:3496 msgid "" "This is a more sane version of L for running external commands. " "It uses fork/execvp, so we don't need to worry about quoting of parameters, " @@ -40356,14 +40177,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3577 +#: docs/internal-documentation.pod:3501 msgid "" "If C is not C, then C<*stdoutput> will return the stdout of " "the command as a string." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3580 +#: docs/internal-documentation.pod:3504 msgid "" "If C is not C, then C<*stderror> will return the stderr of " "the command. If there is a final \\n character, it is removed so you can " @@ -40371,17 +40192,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3585 +#: docs/internal-documentation.pod:3509 msgid "Flags are:" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3589 +#: docs/internal-documentation.pod:3513 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3591 +#: docs/internal-documentation.pod:3515 msgid "" "For broken external commands that send error messages to stdout (hello, " "parted) but that don't have any useful stdout information, use this flag to " @@ -40391,12 +40212,12 @@ msgid "" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3597 +#: docs/internal-documentation.pod:3521 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3599 +#: docs/internal-documentation.pod:3523 msgid "" "For running external commands on chrooted files correctly (see " "L) specifying this flag causes another " @@ -40407,24 +40228,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3609 +#: docs/internal-documentation.pod:3533 msgid "" "There is also a macro C which calls C " "with C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3612 +#: docs/internal-documentation.pod:3536 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3614 +#: docs/internal-documentation.pod:3538 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3616 +#: docs/internal-documentation.pod:3540 #, no-wrap msgid "" " void\n" @@ -40433,12 +40254,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3619 +#: docs/internal-documentation.pod:3543 msgid "Cache daemon disk mapping." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3621 +#: docs/internal-documentation.pod:3545 msgid "" "When the daemon starts up, populate a cache with the contents of " "/dev/disk/by-path. It's easiest to use C here since the names are " @@ -40446,12 +40267,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3625 +#: docs/internal-documentation.pod:3549 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3627 +#: docs/internal-documentation.pod:3551 #, no-wrap msgid "" " char *\n" @@ -40460,12 +40281,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3630 +#: docs/internal-documentation.pod:3554 msgid "Perform device name translation." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3632 +#: docs/internal-documentation.pod:3556 msgid "" "Libguestfs defines a few standard formats for device names. (see also " "L and " @@ -40473,22 +40294,22 @@ msgid "" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3638 +#: docs/internal-documentation.pod:3562 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3640 +#: docs/internal-documentation.pod:3564 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3642 +#: docs/internal-documentation.pod:3566 msgid "F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3644 +#: docs/internal-documentation.pod:3568 msgid "" "These mean the Nth partition on the Xth device. Because Linux no longer " "enumerates devices in the order they are passed to qemu, we must translate " @@ -40496,67 +40317,67 @@ msgid "" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3649 +#: docs/internal-documentation.pod:3573 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3651 +#: docs/internal-documentation.pod:3575 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3653 +#: docs/internal-documentation.pod:3577 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3655 fish/guestfish-actions.pod:1473 +#: docs/internal-documentation.pod:3579 fish/guestfish-actions.pod:1473 #: lib/guestfs-actions.pod:2489 msgid "F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3657 +#: docs/internal-documentation.pod:3581 msgid "These are not translated here." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3661 +#: docs/internal-documentation.pod:3585 msgid "It returns a newly allocated string which the caller must free." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3663 +#: docs/internal-documentation.pod:3587 msgid "It returns C on error. B it does I call C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3666 +#: docs/internal-documentation.pod:3590 msgid "" "We have to open the device and test for C, because the device nodes " "may exist in the appliance." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3669 +#: docs/internal-documentation.pod:3593 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3671 +#: docs/internal-documentation.pod:3595 msgid "" "This is the guestfs daemon which runs inside the guestfs appliance. This " "file handles start up and connecting back to the library." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3674 +#: docs/internal-documentation.pod:3598 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3676 +#: docs/internal-documentation.pod:3600 #, no-wrap msgid "" " void\n" @@ -40565,17 +40386,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3679 +#: docs/internal-documentation.pod:3603 msgid "Write C to the file C, ensuring it is shell quoted." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3681 +#: docs/internal-documentation.pod:3605 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3683 +#: docs/internal-documentation.pod:3607 #, no-wrap msgid "" " void\n" @@ -40584,56 +40405,56 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3686 +#: docs/internal-documentation.pod:3610 msgid "" "Write C + C to the file C, ensuring it is shell quoted. " "The path must be an absolute path." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3689 +#: docs/internal-documentation.pod:3613 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3691 +#: docs/internal-documentation.pod:3615 msgid "Internal functions that are not part of the public API." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3693 +#: docs/internal-documentation.pod:3617 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3695 +#: docs/internal-documentation.pod:3619 msgid "Bindings for utility functions." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3697 +#: docs/internal-documentation.pod:3621 msgid "" "Note that functions called from OCaml code B call any of the " "C functions." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3700 +#: docs/internal-documentation.pod:3624 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3702 +#: docs/internal-documentation.pod:3626 msgid "Miscellaneous utility functions used by the daemon." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3704 +#: docs/internal-documentation.pod:3628 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3706 +#: docs/internal-documentation.pod:3630 #, no-wrap msgid "" " static int\n" @@ -40642,19 +40463,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3709 +#: docs/internal-documentation.pod:3633 msgid "" "Return true iff device is the root device (and therefore should be ignored " "from the point of view of user calls)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3712 +#: docs/internal-documentation.pod:3636 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3714 +#: docs/internal-documentation.pod:3638 #, no-wrap msgid "" " int\n" @@ -40663,26 +40484,26 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3717 +#: docs/internal-documentation.pod:3641 msgid "" "Parameters marked as C, C, etc can be passed a block " "device name. This function tests if the parameter is a block device name." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3721 +#: docs/internal-documentation.pod:3645 msgid "" "It can also be used in daemon code to test if the string passed as a " "C parameter is a device or path." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3724 +#: docs/internal-documentation.pod:3648 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3726 +#: docs/internal-documentation.pod:3650 #, no-wrap msgid "" " char *\n" @@ -40691,12 +40512,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3729 +#: docs/internal-documentation.pod:3653 msgid "Turn C<\"/path\"> into C<\"/sysroot/path\">." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3731 docs/internal-documentation.pod:3745 +#: docs/internal-documentation.pod:3655 docs/internal-documentation.pod:3669 msgid "" "Returns C on failure. The caller I check for this and call " "S>. The caller must also free the " @@ -40704,17 +40525,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3735 docs/internal-documentation.pod:3749 +#: docs/internal-documentation.pod:3659 docs/internal-documentation.pod:3673 msgid "See also the custom C<%R> printf formatter which does shell quoting too." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3737 +#: docs/internal-documentation.pod:3661 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3739 +#: docs/internal-documentation.pod:3663 #, no-wrap msgid "" " char *\n" @@ -40723,17 +40544,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3742 +#: docs/internal-documentation.pod:3666 msgid "Resolve path within sysroot, calling C on the resolved path." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3751 +#: docs/internal-documentation.pod:3675 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3753 +#: docs/internal-documentation.pod:3677 #, no-wrap msgid "" " int\n" @@ -40742,24 +40563,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3756 +#: docs/internal-documentation.pod:3680 msgid "Returns true if C is a power of 2." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3758 +#: docs/internal-documentation.pod:3682 msgid "" "Uses the algorithm described at " "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3761 +#: docs/internal-documentation.pod:3685 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3763 +#: docs/internal-documentation.pod:3687 #, no-wrap msgid "" " struct stringsbuf\n" @@ -40768,66 +40589,66 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3766 +#: docs/internal-documentation.pod:3690 msgid "" "Split an output string into a NULL-terminated list of lines, wrapped into a " "stringsbuf." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3769 +#: docs/internal-documentation.pod:3693 msgid "" "Typically this is used where we have run an external command which has " "printed out a list of things, and we want to return an actual list." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3773 +#: docs/internal-documentation.pod:3697 msgid "The corner cases here are quite tricky. Note in particular:" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3777 +#: docs/internal-documentation.pod:3701 msgid "C<\"\">" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3781 +#: docs/internal-documentation.pod:3705 msgid "C<\"\\n\">" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3783 +#: docs/internal-documentation.pod:3707 msgid "returns C<[\"\"]>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3785 +#: docs/internal-documentation.pod:3709 msgid "C<\"a\\nb\">" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3787 docs/internal-documentation.pod:3791 +#: docs/internal-documentation.pod:3711 docs/internal-documentation.pod:3715 msgid "returns C<[\"a\"; \"b\"]>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3789 +#: docs/internal-documentation.pod:3713 msgid "C<\"a\\nb\\n\">" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3793 +#: docs/internal-documentation.pod:3717 msgid "C<\"a\\nb\\n\\n\">" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3795 +#: docs/internal-documentation.pod:3719 msgid "returns C<[\"a\"; \"b\"; \"\"]>" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3799 +#: docs/internal-documentation.pod:3723 msgid "" "The original string is written over and destroyed by this function (which is " "usually OK because it's the 'out' string from C). You can free " @@ -40835,17 +40656,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3804 +#: docs/internal-documentation.pod:3728 msgid "C in the C will be C in case of errors." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3806 +#: docs/internal-documentation.pod:3730 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3808 +#: docs/internal-documentation.pod:3732 #, no-wrap msgid "" " char **\n" @@ -40854,24 +40675,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3811 +#: docs/internal-documentation.pod:3735 msgid "" "Filter a list of strings. Returns a newly allocated list of only the " "strings where C

." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3814 +#: docs/internal-documentation.pod:3738 msgid "B it does not copy the strings, be careful not to double-free them." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3817 +#: docs/internal-documentation.pod:3741 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3819 +#: docs/internal-documentation.pod:3743 #, no-wrap msgid "" " void\n" @@ -40880,17 +40701,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3822 +#: docs/internal-documentation.pod:3746 msgid "Skip leading and trailing whitespace, updating the original string in-place." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3825 +#: docs/internal-documentation.pod:3749 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3827 +#: docs/internal-documentation.pod:3751 #, no-wrap msgid "" " int\n" @@ -40899,19 +40720,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3830 +#: docs/internal-documentation.pod:3754 msgid "" "Parse the mountable descriptor for a btrfs subvolume. Don't call this " "directly; it is only used from the stubs." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3833 +#: docs/internal-documentation.pod:3757 msgid "A btrfs subvolume is given as:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3835 +#: docs/internal-documentation.pod:3759 #, no-wrap msgid "" " btrfsvol:/dev/sda3/root\n" @@ -40919,7 +40740,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3837 +#: docs/internal-documentation.pod:3761 msgid "" "where F is a block device containing a btrfs filesystem, and root " "is the name of a subvolume on it. This function is passed the string " @@ -40927,19 +40748,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3841 +#: docs/internal-documentation.pod:3765 msgid "" "On success, Cdevice> and Cvolume> must be " "freed by the caller." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3844 +#: docs/internal-documentation.pod:3768 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3846 +#: docs/internal-documentation.pod:3770 #, no-wrap msgid "" " char *\n" @@ -40948,24 +40769,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3849 +#: docs/internal-documentation.pod:3773 msgid "Convert a C back to its string representation" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3851 +#: docs/internal-documentation.pod:3775 msgid "" "This function can be used in an error path, so must not call " "C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3854 +#: docs/internal-documentation.pod:3778 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3856 +#: docs/internal-documentation.pod:3780 #, no-wrap msgid "" " int\n" @@ -40974,17 +40795,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3859 +#: docs/internal-documentation.pod:3783 msgid "Check program exists and is executable on C<$PATH>." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3861 +#: docs/internal-documentation.pod:3785 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3863 +#: docs/internal-documentation.pod:3787 #, no-wrap msgid "" " int\n" @@ -40993,7 +40814,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3866 +#: docs/internal-documentation.pod:3790 msgid "" "Pass a template such as C<\"/sysroot/XXXXXXXX.XXX\">. This updates the " "template to contain a randomly named file. Any C<'X'> characters after the " @@ -41001,7 +40822,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3871 +#: docs/internal-documentation.pod:3795 msgid "" "Notes: You should probably use an 8.3 path, so it's compatible with all " "filesystems including basic FAT. Also this only substitutes lowercase ASCII " @@ -41010,24 +40831,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3876 +#: docs/internal-documentation.pod:3800 msgid "" "This doesn't create a file or check whether or not the file exists (it would " "be extremely unlikely to exist as long as the RNG is working)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3880 +#: docs/internal-documentation.pod:3804 msgid "If there is an error, C<-1> is returned." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3882 +#: docs/internal-documentation.pod:3806 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3884 +#: docs/internal-documentation.pod:3808 #, no-wrap msgid "" " void\n" @@ -41036,7 +40857,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3887 +#: docs/internal-documentation.pod:3811 msgid "" "LVM and other commands aren't synchronous, especially when udev is " "involved. eg. You can create or remove some device, but the C device " @@ -41045,19 +40866,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3892 +#: docs/internal-documentation.pod:3816 msgid "" "Use C after certain commands, but don't be too fussed if it " "fails." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3895 +#: docs/internal-documentation.pod:3819 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3897 +#: docs/internal-documentation.pod:3821 #, no-wrap msgid "" " char *\n" @@ -41066,26 +40887,26 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3900 +#: docs/internal-documentation.pod:3824 msgid "" "Turn list C into a temporary file, and return a string containing " "the temporary file name. Caller must unlink the file and free the string." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3904 +#: docs/internal-documentation.pod:3828 msgid "" "C is the function that invoked this helper, and it is used mainly " "for errors/debugging." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3907 +#: docs/internal-documentation.pod:3831 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3909 +#: docs/internal-documentation.pod:3833 #, no-wrap msgid "" " char *\n" @@ -41094,7 +40915,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3912 +#: docs/internal-documentation.pod:3836 msgid "" "Read whole file into dynamically allocated array. If there is an error, " "DON'T call reply_with_perror, just return NULL. Returns a C<\\0>-terminated " @@ -41102,17 +40923,17 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3917 +#: docs/internal-documentation.pod:3841 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3919 +#: docs/internal-documentation.pod:3843 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3921 +#: docs/internal-documentation.pod:3845 #, no-wrap msgid "" " static char **\n" @@ -41121,7 +40942,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3924 +#: docs/internal-documentation.pod:3848 msgid "" "L returns the string C<\"foo\\0bar\\0baz\"> of length C. " "(The last string in the list is \\0-terminated but the \\0 is not included " @@ -41129,39 +40950,39 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3928 +#: docs/internal-documentation.pod:3852 msgid "This function splits it into a regular list of strings." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3930 +#: docs/internal-documentation.pod:3854 msgid "" "B that the returned list contains pointers to the original strings in " "C so be careful that you do not double-free them." msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:3933 +#: docs/internal-documentation.pod:3857 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3935 +#: docs/internal-documentation.pod:3859 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3937 +#: docs/internal-documentation.pod:3861 msgid "This file implements the guestfish C and C commands." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3939 +#: docs/internal-documentation.pod:3863 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3941 +#: docs/internal-documentation.pod:3865 #, no-wrap msgid "" " int\n" @@ -41171,95 +40992,95 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3944 +#: docs/internal-documentation.pod:3868 msgid "" "This is the underlying allocation function. It's called from a few other " "places in guestfish." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3947 +#: docs/internal-documentation.pod:3871 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3949 +#: docs/internal-documentation.pod:3873 msgid "This file implements the guestfish commands C and C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3952 +#: docs/internal-documentation.pod:3876 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3954 +#: docs/internal-documentation.pod:3878 msgid "The file handles tab-completion of filesystem paths in guestfish." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3956 +#: docs/internal-documentation.pod:3880 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3958 +#: docs/internal-documentation.pod:3882 msgid "" "The file implements the guestfish C command, for displaying " "graphical files (icons, images) in disk images." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3961 +#: docs/internal-documentation.pod:3885 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3963 +#: docs/internal-documentation.pod:3887 msgid "The file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3965 +#: docs/internal-documentation.pod:3889 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3967 +#: docs/internal-documentation.pod:3891 msgid "guestfish C command, suggested by Ján Ondrej." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3969 +#: docs/internal-documentation.pod:3893 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3971 +#: docs/internal-documentation.pod:3895 msgid "" "This file implements the guestfish event-related commands, C, " "C and C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3974 +#: docs/internal-documentation.pod:3898 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3976 +#: docs/internal-documentation.pod:3900 msgid "" "guestfish, the guest filesystem shell. This file contains the main loop and " "utilities." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3979 +#: docs/internal-documentation.pod:3903 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3981 +#: docs/internal-documentation.pod:3905 #, no-wrap msgid "" " static struct parsed_command\n" @@ -41268,46 +41089,46 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3984 +#: docs/internal-documentation.pod:3908 msgid "" "Parse a command string, splitting at whitespace, handling C<'!'>, C<'#'> " "etc. This destructively updates C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3987 +#: docs/internal-documentation.pod:3911 msgid "" "C is used to pass in the global C setting " "and to return the local setting (eg. if the command begins with C<'-'>)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3991 +#: docs/internal-documentation.pod:3915 msgid "Returns in C:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3997 +#: docs/internal-documentation.pod:3921 msgid "got a guestfish command (returned in C/C/C)" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4001 +#: docs/internal-documentation.pod:3925 msgid "no guestfish command, but otherwise OK" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4005 +#: docs/internal-documentation.pod:3929 msgid "an error" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4009 +#: docs/internal-documentation.pod:3933 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4011 +#: docs/internal-documentation.pod:3935 #, no-wrap msgid "" " static ssize_t\n" @@ -41316,7 +41137,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4014 +#: docs/internal-documentation.pod:3938 msgid "" "Parse double-quoted strings, replacing backslash escape sequences with the " "true character. Since the string is returned in place, the escapes must " @@ -41324,12 +41145,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4018 +#: docs/internal-documentation.pod:3942 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4020 +#: docs/internal-documentation.pod:3944 #, no-wrap msgid "" " static int\n" @@ -41338,17 +41159,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4023 +#: docs/internal-documentation.pod:3947 msgid "Used to handle C!> (execute command and inline result)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4025 +#: docs/internal-documentation.pod:3949 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4027 +#: docs/internal-documentation.pod:3951 #, no-wrap msgid "" " int\n" @@ -41358,12 +41179,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4031 +#: docs/internal-documentation.pod:3955 msgid "Run a command." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4033 +#: docs/internal-documentation.pod:3957 msgid "" "C is the C flag that we pass to the " "remote server (when issuing I<--remote> commands). It does not cause " @@ -41371,12 +41192,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4037 +#: docs/internal-documentation.pod:3961 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4039 +#: docs/internal-documentation.pod:3963 #, no-wrap msgid "" " void\n" @@ -41385,14 +41206,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4042 +#: docs/internal-documentation.pod:3966 msgid "" "Print an extended help message when the user types in an unknown command for " "the first command issued. A common case is the user doing:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4046 +#: docs/internal-documentation.pod:3970 #, no-wrap msgid "" " guestfish disk.img\n" @@ -41400,19 +41221,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4048 +#: docs/internal-documentation.pod:3972 msgid "" "expecting guestfish to open F (in fact, this tried to run a " "non-existent command C)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4051 +#: docs/internal-documentation.pod:3975 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4053 +#: docs/internal-documentation.pod:3977 #, no-wrap msgid "" " static void\n" @@ -41421,17 +41242,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4056 +#: docs/internal-documentation.pod:3980 msgid "Error callback. This replaces the standard libguestfs error handler." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4058 +#: docs/internal-documentation.pod:3982 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4060 +#: docs/internal-documentation.pod:3984 #, no-wrap msgid "" " static void\n" @@ -41440,17 +41261,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4063 +#: docs/internal-documentation.pod:3987 msgid "Free strings from a non-NULL terminated C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4065 +#: docs/internal-documentation.pod:3989 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4067 +#: docs/internal-documentation.pod:3991 #, no-wrap msgid "" " static char *\n" @@ -41459,17 +41280,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4070 +#: docs/internal-documentation.pod:3994 msgid "Decode C into the final printable prompt string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4072 +#: docs/internal-documentation.pod:3996 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4074 +#: docs/internal-documentation.pod:3998 #, no-wrap msgid "" " char *\n" @@ -41478,26 +41299,26 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4077 +#: docs/internal-documentation.pod:4001 msgid "" "Resolve the special C form for Windows-specific paths. The " "generated code calls this for all device or path arguments." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4080 +#: docs/internal-documentation.pod:4004 msgid "" "The function returns a newly allocated string, and the caller must free this " "string; else display an error and return C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4083 +#: docs/internal-documentation.pod:4007 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4085 +#: docs/internal-documentation.pod:4009 #, no-wrap msgid "" " char *\n" @@ -41506,24 +41327,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4088 +#: docs/internal-documentation.pod:4012 msgid "Resolve the special C paths (C<-> or C<-< or filename)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4090 +#: docs/internal-documentation.pod:4014 msgid "" "The caller (F) will call C after the command has " "run which should clean up resources." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4093 +#: docs/internal-documentation.pod:4017 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4095 +#: docs/internal-documentation.pod:4019 #, no-wrap msgid "" " char *\n" @@ -41532,24 +41353,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4098 +#: docs/internal-documentation.pod:4022 msgid "Resolve the special C paths (C<-> or filename)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4100 +#: docs/internal-documentation.pod:4024 msgid "" "The caller (F) will call S> after the command has " "run." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4103 +#: docs/internal-documentation.pod:4027 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4105 +#: docs/internal-documentation.pod:4029 #, no-wrap msgid "" " void\n" @@ -41561,27 +41382,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4111 +#: docs/internal-documentation.pod:4035 msgid "Callback which displays a progress bar." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4113 +#: docs/internal-documentation.pod:4037 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4115 +#: docs/internal-documentation.pod:4039 msgid "This file implements the guestfish C command." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4117 +#: docs/internal-documentation.pod:4041 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4119 +#: docs/internal-documentation.pod:4043 #, no-wrap msgid "" " static char **\n" @@ -41590,21 +41411,21 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4122 +#: docs/internal-documentation.pod:4046 msgid "" "Glob-expand device patterns, such as C " "(L)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4125 +#: docs/internal-documentation.pod:4049 msgid "" "There is no C function because the equivalent " "can be implemented using functions like C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4129 +#: docs/internal-documentation.pod:4053 msgid "" "It's not immediately clear what it means to expand a pattern like " "C. Should that include device name translation? Should the result " @@ -41612,43 +41433,43 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4133 +#: docs/internal-documentation.pod:4057 msgid "" "Should C<\"/dev/\"> + C<\"*\"> return every possible device and filesystem? " "How about VGs? LVs?" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4136 +#: docs/internal-documentation.pod:4060 msgid "" "To solve this what we do is build up a list of every device, partition, " "etc., then glob against that list." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4139 +#: docs/internal-documentation.pod:4063 msgid "Notes for future work (XXX):" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4145 +#: docs/internal-documentation.pod:4069 msgid "" "This doesn't handle device name translation. It wouldn't be too hard to " "add." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4150 +#: docs/internal-documentation.pod:4074 msgid "Could have an API function for returning all device-like things." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4154 +#: docs/internal-documentation.pod:4078 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4156 +#: docs/internal-documentation.pod:4080 #, no-wrap msgid "" " static int\n" @@ -41658,7 +41479,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4160 +#: docs/internal-documentation.pod:4084 msgid "" "Using POSIX L, find strings in the list C which match " "pattern C. Add strings which match to the C array. C<*size_r> " @@ -41666,12 +41487,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4165 +#: docs/internal-documentation.pod:4089 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4167 +#: docs/internal-documentation.pod:4091 #, no-wrap msgid "" " static char **\n" @@ -41680,27 +41501,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4170 +#: docs/internal-documentation.pod:4094 msgid "Return a single element list containing C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4172 +#: docs/internal-documentation.pod:4096 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4174 +#: docs/internal-documentation.pod:4098 msgid "The file implements the guestfish C command." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4176 +#: docs/internal-documentation.pod:4100 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4178 +#: docs/internal-documentation.pod:4102 #, no-wrap msgid "" " int\n" @@ -41709,12 +41530,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4181 +#: docs/internal-documentation.pod:4105 msgid "The C command." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4183 +#: docs/internal-documentation.pod:4107 msgid "" "This used to just list all commands, but that's not very useful. Instead " "display some useful context-sensitive help. This could be improved if we " @@ -41723,27 +41544,27 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4188 +#: docs/internal-documentation.pod:4112 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4190 +#: docs/internal-documentation.pod:4114 msgid "This file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4192 +#: docs/internal-documentation.pod:4116 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4194 +#: docs/internal-documentation.pod:4118 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4196 +#: docs/internal-documentation.pod:4120 #, no-wrap msgid "" " int\n" @@ -41752,22 +41573,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4199 +#: docs/internal-documentation.pod:4123 msgid "guestfish C command (similar to the C command in BSD ftp)." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4201 +#: docs/internal-documentation.pod:4125 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4203 +#: docs/internal-documentation.pod:4127 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4205 +#: docs/internal-documentation.pod:4129 #, no-wrap msgid "" " int\n" @@ -41776,49 +41597,49 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4208 +#: docs/internal-documentation.pod:4132 msgid "guestfish C command" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4210 +#: docs/internal-documentation.pod:4134 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4212 +#: docs/internal-documentation.pod:4136 msgid "This file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4214 +#: docs/internal-documentation.pod:4138 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4216 +#: docs/internal-documentation.pod:4140 msgid "" "This file implements the guestfish I<-N> option for creating pre-prepared " "disk layouts." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4219 +#: docs/internal-documentation.pod:4143 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4221 +#: docs/internal-documentation.pod:4145 msgid "This file implements guestfish remote (command) support." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4223 +#: docs/internal-documentation.pod:4147 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4225 +#: docs/internal-documentation.pod:4149 #, no-wrap msgid "" " void\n" @@ -41827,17 +41648,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4228 +#: docs/internal-documentation.pod:4152 msgid "The remote control server (ie. C)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4230 +#: docs/internal-documentation.pod:4154 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4232 +#: docs/internal-documentation.pod:4156 #, no-wrap msgid "" " int\n" @@ -41847,59 +41668,59 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4236 +#: docs/internal-documentation.pod:4160 msgid "The remote control client (ie. C)." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4238 +#: docs/internal-documentation.pod:4162 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4240 +#: docs/internal-documentation.pod:4164 msgid "This file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4242 +#: docs/internal-documentation.pod:4166 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4244 +#: docs/internal-documentation.pod:4168 msgid "This file implements the guestfish C and C commands." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4247 +#: docs/internal-documentation.pod:4171 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4249 +#: docs/internal-documentation.pod:4173 msgid "This file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4251 +#: docs/internal-documentation.pod:4175 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4253 +#: docs/internal-documentation.pod:4177 msgid "" "This file implements tilde (C<~>) expansion of home directories in " "L." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4256 +#: docs/internal-documentation.pod:4180 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4258 +#: docs/internal-documentation.pod:4182 #, no-wrap msgid "" " char *\n" @@ -41908,19 +41729,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4261 +#: docs/internal-documentation.pod:4185 msgid "" "This is called from the script loop if we find a candidate for C<~username> " "(tilde-expansion)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4264 +#: docs/internal-documentation.pod:4188 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4266 +#: docs/internal-documentation.pod:4190 #, no-wrap msgid "" " static char *\n" @@ -41929,17 +41750,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4269 +#: docs/internal-documentation.pod:4193 msgid "Return C<$HOME> + append string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4271 +#: docs/internal-documentation.pod:4195 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4273 +#: docs/internal-documentation.pod:4197 #, no-wrap msgid "" " static const char *\n" @@ -41948,34 +41769,34 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4276 +#: docs/internal-documentation.pod:4200 msgid "" "Lookup C (of length C), return home directory if found, or " "C if not found." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4279 +#: docs/internal-documentation.pod:4203 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4281 +#: docs/internal-documentation.pod:4205 msgid "This file implements the guestfish C