diff --git a/configure.ac b/configure.ac index 0eb204b82..8e1b0b7b4 100644 --- a/configure.ac +++ b/configure.ac @@ -1,5 +1,5 @@ # libguestfs -# Copyright (C) 2009-2025 Red Hat Inc. +# Copyright (C) 2009-2026 Red Hat Inc. # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -20,8 +20,8 @@ # freeform string. m4_define([libguestfs_major], [1]) m4_define([libguestfs_minor], [59]) -m4_define([libguestfs_release], [3]) -m4_define([release_date], [2026-02-11]) +m4_define([libguestfs_release], [4]) +m4_define([release_date], [2026-03-17]) 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 ce1e91bf8..3e1acbe1f 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.59.3\n" +"Project-Id-Version: libguestfs 1.59.4\n" "Report-Msgid-Bugs-To: guestfs@lists.libguestfs.org\n" -"POT-Creation-Date: 2026-02-11 14:19+0000\n" +"POT-Creation-Date: 2026-03-17 19:27+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -230,20 +230,20 @@ msgstr "" #: docs/guestfs-testing.pod:86 docs/guestfs-testing.pod:194 #: docs/guestfs-testing.pod:198 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: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 +#: docs/internal-documentation.pod:1431 docs/internal-documentation.pod:1435 +#: docs/internal-documentation.pod:1664 docs/internal-documentation.pod:1668 +#: docs/internal-documentation.pod:2518 docs/internal-documentation.pod:2526 +#: docs/internal-documentation.pod:2532 docs/internal-documentation.pod:2539 +#: docs/internal-documentation.pod:2797 docs/internal-documentation.pod:2804 +#: docs/internal-documentation.pod:2808 docs/internal-documentation.pod:2837 +#: docs/internal-documentation.pod:2844 docs/internal-documentation.pod:2848 +#: docs/internal-documentation.pod:2879 docs/internal-documentation.pod:2884 +#: docs/internal-documentation.pod:2891 docs/internal-documentation.pod:3071 +#: docs/internal-documentation.pod:3076 docs/internal-documentation.pod:3192 +#: docs/internal-documentation.pod:3196 docs/internal-documentation.pod:3429 +#: docs/internal-documentation.pod:3433 docs/internal-documentation.pod:3437 +#: docs/internal-documentation.pod:3442 docs/internal-documentation.pod:4073 +#: docs/internal-documentation.pod:4078 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 fish/guestfish-actions.pod:2692 @@ -254,10 +254,10 @@ msgstr "" #: fish/guestfish-actions.pod:2996 fish/guestfish-actions.pod:3000 #: fish/guestfish-actions.pod:3005 fish/guestfish-actions.pod:3079 #: fish/guestfish-actions.pod:3083 fish/guestfish-actions.pod:3088 -#: fish/guestfish-actions.pod:3716 fish/guestfish-actions.pod:3723 -#: fish/guestfish-actions.pod:3730 fish/guestfish-actions.pod:4499 -#: fish/guestfish-actions.pod:4505 fish/guestfish-actions.pod:4513 -#: fish/guestfish-actions.pod:4520 fish/guestfish-actions.pod:4527 +#: fish/guestfish-actions.pod:3720 fish/guestfish-actions.pod:3727 +#: fish/guestfish-actions.pod:3734 fish/guestfish-actions.pod:4503 +#: fish/guestfish-actions.pod:4509 fish/guestfish-actions.pod:4517 +#: fish/guestfish-actions.pod:4524 fish/guestfish-actions.pod:4531 #: fish/guestfish.pod:472 fish/guestfish.pod:476 fish/guestfish.pod:480 #: fish/guestfish.pod:484 fish/guestfish.pod:1320 fish/guestfish.pod:1326 #: fish/libguestfs-tools.conf.pod:22 fish/libguestfs-tools.conf.pod:26 @@ -275,10 +275,10 @@ msgstr "" #: lib/guestfs-actions.pod:4993 lib/guestfs-actions.pod:4997 #: lib/guestfs-actions.pod:5002 lib/guestfs-actions.pod:5123 #: lib/guestfs-actions.pod:5127 lib/guestfs-actions.pod:5132 -#: lib/guestfs-actions.pod:6145 lib/guestfs-actions.pod:6152 -#: lib/guestfs-actions.pod:6159 lib/guestfs-actions.pod:7232 -#: lib/guestfs-actions.pod:7238 lib/guestfs-actions.pod:7246 -#: lib/guestfs-actions.pod:7253 lib/guestfs-actions.pod:7260 +#: lib/guestfs-actions.pod:6149 lib/guestfs-actions.pod:6156 +#: lib/guestfs-actions.pod:6163 lib/guestfs-actions.pod:7236 +#: lib/guestfs-actions.pod:7242 lib/guestfs-actions.pod:7250 +#: lib/guestfs-actions.pod:7257 lib/guestfs-actions.pod:7264 #: lib/guestfs.pod:433 lib/guestfs.pod:438 lib/guestfs.pod:443 #: lib/guestfs.pod:447 lib/guestfs.pod:452 lib/guestfs.pod:456 #: lib/guestfs.pod:461 lib/guestfs.pod:466 lib/guestfs.pod:699 @@ -1000,7 +1000,7 @@ msgstr "" #: common/mlcustomize/customize-options.pod:84 #: common/mlcustomize/v2v-customize-options.pod:84 #: docs/guestfs-building.pod:408 docs/guestfs-recipes.pod:508 -#: docs/internal-documentation.pod:3040 fish/guestfish.pod:238 +#: docs/internal-documentation.pod:3046 fish/guestfish.pod:238 #: fish/guestfish.pod:699 rescue/virt-rescue.pod:166 msgid "For example:" msgstr "" @@ -2601,7 +2601,7 @@ msgid "gperf" msgstr "" #. type: =head2 -#: docs/guestfs-building.pod:140 fish/guestfish-actions.pod:7976 +#: docs/guestfs-building.pod:140 fish/guestfish-actions.pod:7980 msgid "realpath" msgstr "" @@ -4910,8 +4910,8 @@ msgstr "" #: docs/guestfs-hacking.pod:381 docs/guestfs-performance.pod:165 #: docs/guestfs-performance.pod:207 docs/guestfs-recipes.pod:457 #: docs/guestfs-security.pod:177 docs/internal-documentation.pod:195 -#: docs/internal-documentation.pod:306 docs/internal-documentation.pod:1357 -#: docs/internal-documentation.pod:1483 lib/guestfs.pod:1580 +#: docs/internal-documentation.pod:306 docs/internal-documentation.pod:1362 +#: docs/internal-documentation.pod:1488 lib/guestfs.pod:1580 #: lib/guestfs.pod:1920 rescue/virt-rescue.pod:410 msgid "1." msgstr "" @@ -4928,8 +4928,8 @@ msgstr "" #: docs/guestfs-hacking.pod:407 docs/guestfs-performance.pod:171 #: docs/guestfs-performance.pod:214 docs/guestfs-recipes.pod:463 #: docs/guestfs-security.pod:181 docs/internal-documentation.pod:200 -#: docs/internal-documentation.pod:313 docs/internal-documentation.pod:1362 -#: docs/internal-documentation.pod:1489 lib/guestfs.pod:1584 +#: docs/internal-documentation.pod:313 docs/internal-documentation.pod:1367 +#: docs/internal-documentation.pod:1494 lib/guestfs.pod:1584 #: lib/guestfs.pod:1924 rescue/virt-rescue.pod:418 msgid "2." msgstr "" @@ -4945,8 +4945,8 @@ msgstr "" #: docs/guestfs-faq.pod:504 docs/guestfs-faq.pod:735 docs/guestfs-faq.pod:934 #: docs/guestfs-hacking.pod:419 docs/guestfs-performance.pod:220 #: docs/guestfs-recipes.pod:469 docs/internal-documentation.pod:205 -#: docs/internal-documentation.pod:323 docs/internal-documentation.pod:1367 -#: docs/internal-documentation.pod:1497 lib/guestfs.pod:1588 +#: docs/internal-documentation.pod:323 docs/internal-documentation.pod:1372 +#: docs/internal-documentation.pod:1502 lib/guestfs.pod:1588 #: lib/guestfs.pod:1930 rescue/virt-rescue.pod:427 msgid "3." msgstr "" @@ -5794,7 +5794,7 @@ msgstr "" #. type: =item #: docs/guestfs-faq.pod:938 docs/internal-documentation.pod:209 -#: docs/internal-documentation.pod:333 docs/internal-documentation.pod:1507 +#: docs/internal-documentation.pod:333 docs/internal-documentation.pod:1512 #: rescue/virt-rescue.pod:436 msgid "4." msgstr "" @@ -5817,7 +5817,7 @@ msgstr "" #. type: =item #: docs/guestfs-faq.pod:946 docs/internal-documentation.pod:338 -#: docs/internal-documentation.pod:1517 rescue/virt-rescue.pod:444 +#: docs/internal-documentation.pod:1522 rescue/virt-rescue.pod:444 msgid "5." msgstr "" @@ -7058,7 +7058,7 @@ msgid "F" msgstr "" #. type: textblock -#: docs/guestfs-hacking.pod:158 docs/internal-documentation.pod:2499 +#: docs/guestfs-hacking.pod:158 docs/internal-documentation.pod:2505 msgid "Mini-library for writing qemu command lines and qemu config files." msgstr "" @@ -11144,11 +11144,11 @@ msgid "" msgstr "" #. type: textblock -#: docs/guestfs-recipes.pod:310 docs/internal-documentation.pod:1353 -#: 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 +#: docs/guestfs-recipes.pod:310 docs/internal-documentation.pod:1358 +#: docs/internal-documentation.pod:3067 docs/internal-documentation.pod:3425 +#: fish/guestfish-actions.pod:3075 fish/guestfish-actions.pod:3716 +#: fish/guestfish-actions.pod:4499 lib/guestfs-actions.pod:5119 +#: lib/guestfs-actions.pod:6145 lib/guestfs-actions.pod:7232 #: lib/guestfs.pod:785 lib/guestfs.pod:2200 msgid "Notes:" msgstr "" @@ -34055,7 +34055,7 @@ msgid "Returns:" msgstr "" #. type: =item -#: docs/internal-documentation.pod:563 docs/internal-documentation.pod:3919 +#: docs/internal-documentation.pod:563 docs/internal-documentation.pod:3925 #: fuse/guestunmount.pod:131 msgid "C<1>" msgstr "" @@ -34066,7 +34066,7 @@ msgid "log message(s) were handled successfully" msgstr "" #. type: =item -#: docs/internal-documentation.pod:567 docs/internal-documentation.pod:3923 +#: docs/internal-documentation.pod:567 docs/internal-documentation.pod:3929 msgid "C<0>" msgstr "" @@ -34076,12 +34076,12 @@ msgid "connection to appliance closed" msgstr "" #. type: =item -#: docs/internal-documentation.pod:571 docs/internal-documentation.pod:3927 +#: docs/internal-documentation.pod:571 docs/internal-documentation.pod:3933 msgid "C<-1>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:573 docs/internal-documentation.pod:1562 +#: docs/internal-documentation.pod:573 docs/internal-documentation.pod:1567 msgid "error" msgstr "" @@ -34988,6 +34988,17 @@ msgstr "" #: docs/internal-documentation.pod:964 #, no-wrap msgid "" +" /* Get the default hypervisor (qemu), if the user does not override\n" +" * this by calling guestfs_set_hv or setting LIBGUESTFS_HV.\n" +" */\n" +" const char *(*get_default_hv) (guestfs_h *g, void *data);\n" +" \n" +msgstr "" + +#. type: verbatim +#: docs/internal-documentation.pod:969 +#, no-wrap +msgid "" " /* Launch and shut down. */\n" " int (*launch) (guestfs_h *g, void *data, const char *arg);\n" " int (*shutdown) (guestfs_h *g, void *data, int check_for_errors);\n" @@ -34995,7 +35006,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:968 +#: docs/internal-documentation.pod:973 #, no-wrap msgid "" " /* Miscellaneous. */\n" @@ -35006,12 +35017,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:973 +#: docs/internal-documentation.pod:978 msgid "Backend operations." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:975 +#: docs/internal-documentation.pod:980 msgid "" "Each backend (eg. libvirt, direct) defines some functions which get run at " "various places in the handle lifecycle (eg. at launch, shutdown). The " @@ -35019,12 +35030,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:980 +#: docs/internal-documentation.pod:985 msgid "Structure C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:982 +#: docs/internal-documentation.pod:987 #, no-wrap msgid "" " struct connection {\n" @@ -35033,7 +35044,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:985 +#: docs/internal-documentation.pod:990 #, no-wrap msgid "" " /* In the real struct, private data used by each connection module\n" @@ -35044,12 +35055,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:990 +#: docs/internal-documentation.pod:995 msgid "Connection module." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:992 +#: docs/internal-documentation.pod:997 msgid "" "A C represents the appliance console connection plus the daemon " "connection. It hides the underlying representation (POSIX sockets, " @@ -35057,12 +35068,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:996 +#: docs/internal-documentation.pod:1001 msgid "Structure C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:998 +#: docs/internal-documentation.pod:1003 #, no-wrap msgid "" " struct cached_feature {\n" @@ -35073,22 +35084,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1003 +#: docs/internal-documentation.pod:1008 msgid "Cache of queried features." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1005 +#: docs/internal-documentation.pod:1010 msgid "Used to cache the appliance features (see F)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1007 +#: docs/internal-documentation.pod:1012 msgid "Structure C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1009 +#: docs/internal-documentation.pod:1014 #, no-wrap msgid "" " struct guestfs_h {\n" @@ -35099,7 +35110,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1013 +#: docs/internal-documentation.pod:1018 #, no-wrap msgid "" " /* Lock acquired when entering any public guestfs_* function to\n" @@ -35110,7 +35121,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1018 +#: docs/internal-documentation.pod:1023 #, no-wrap msgid "" " /**** Configuration of the handle. ****/\n" @@ -35127,7 +35138,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1029 +#: docs/internal-documentation.pod:1034 #, no-wrap msgid "" " int smp; /* If > 1, -smp flag passed to hv. */\n" @@ -35136,7 +35147,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1032 +#: docs/internal-documentation.pod:1037 #, no-wrap msgid "" " char *path;\t\t\t/* Path to the appliance. */\n" @@ -35146,7 +35157,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1036 +#: docs/internal-documentation.pod:1041 #, no-wrap msgid "" " struct hv_param *hv_params; /* Extra hv parameters. */\n" @@ -35154,7 +35165,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1038 +#: docs/internal-documentation.pod:1043 #, no-wrap msgid "" " char *program; /* Program name. */\n" @@ -35163,7 +35174,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1041 +#: docs/internal-documentation.pod:1046 #, no-wrap msgid "" " /* Array of drives added by add-drive* APIs.\n" @@ -35185,7 +35196,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1057 +#: docs/internal-documentation.pod:1062 #, no-wrap msgid "" " #define ITER_DRIVES(g,i,drv) \\\n" @@ -35195,7 +35206,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1061 +#: docs/internal-documentation.pod:1066 #, no-wrap msgid "" " /* Backend. NB: Use guestfs_int_set_backend to change the backend. */\n" @@ -35208,7 +35219,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1068 +#: docs/internal-documentation.pod:1073 #, no-wrap msgid "" " /**** Runtime information. ****/\n" @@ -35230,7 +35241,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1081 +#: docs/internal-documentation.pod:1086 #, no-wrap msgid "" " /* Error handler, plus stack of old error handlers. */\n" @@ -35239,7 +35250,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1084 +#: docs/internal-documentation.pod:1089 #, no-wrap msgid "" " /* Linked list of error_data structures allocated for this handle,\n" @@ -35251,7 +35262,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1090 +#: docs/internal-documentation.pod:1095 #, no-wrap msgid "" " /* Out of memory error handler. */\n" @@ -35260,7 +35271,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1093 +#: docs/internal-documentation.pod:1098 #, no-wrap msgid "" " /* Events. */\n" @@ -35270,7 +35281,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1097 +#: docs/internal-documentation.pod:1102 #, no-wrap msgid "" " /* Private data area. */\n" @@ -35280,7 +35291,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1101 +#: docs/internal-documentation.pod:1106 #, no-wrap msgid "" " /* User cancelled transfer. Not signal-atomic, but it doesn't\n" @@ -35291,7 +35302,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1106 +#: docs/internal-documentation.pod:1111 #, no-wrap msgid "" " struct timeval launch_t; /* The time that we called " @@ -35300,7 +35311,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1108 +#: docs/internal-documentation.pod:1113 #, no-wrap msgid "" " /* Used by bindtests. */\n" @@ -35309,7 +35320,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1111 +#: docs/internal-documentation.pod:1116 #, no-wrap msgid "" " /* Used to generate unique numbers, eg for temp files. To use this,\n" @@ -35321,7 +35332,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1117 +#: docs/internal-documentation.pod:1122 #, no-wrap msgid "" " /*** Protocol. ***/\n" @@ -35331,7 +35342,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1121 +#: docs/internal-documentation.pod:1126 #, no-wrap msgid "" " #if HAVE_FUSE\n" @@ -35347,7 +35358,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1131 +#: docs/internal-documentation.pod:1136 #, no-wrap msgid "" " #ifdef HAVE_LIBVIRT\n" @@ -35364,7 +35375,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1142 +#: docs/internal-documentation.pod:1147 #, no-wrap msgid "" " /* Cached features. */\n" @@ -35374,7 +35385,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1146 +#: docs/internal-documentation.pod:1151 #, no-wrap msgid "" " /* Used by lib/info.c. -1 = not tested or error; else 0 or 1. */\n" @@ -35384,17 +35395,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1150 +#: docs/internal-documentation.pod:1155 msgid "The libguestfs handle." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1152 +#: docs/internal-documentation.pod:1157 msgid "Structure C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1154 +#: docs/internal-documentation.pod:1159 #, no-wrap msgid "" " struct version {\n" @@ -35406,24 +35417,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1160 +#: docs/internal-documentation.pod:1165 msgid "" "Used for storing major.minor.micro version numbers. See F " "for more information." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1163 +#: docs/internal-documentation.pod:1168 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1165 +#: docs/internal-documentation.pod:1170 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1167 +#: docs/internal-documentation.pod:1172 #, no-wrap msgid "" " int\n" @@ -35432,7 +35443,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1170 +#: docs/internal-documentation.pod:1175 msgid "" "Check whether a string supposed to contain a GUID actually contains it. It " "can recognize strings either as C<{21EC2020-3AEA-1069-A2DD-08002B30309D}> or " @@ -35440,24 +35451,24 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1175 +#: docs/internal-documentation.pod:1180 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1177 +#: docs/internal-documentation.pod:1182 msgid "" "This file deals with the C handle, creating it, closing it, and " "initializing/setting/getting fields." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1180 +#: docs/internal-documentation.pod:1185 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1182 +#: docs/internal-documentation.pod:1187 #, no-wrap msgid "" " static void\n" @@ -35466,7 +35477,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1185 +#: docs/internal-documentation.pod:1190 msgid "" "No initialization is required by libguestfs, but libvirt and libxml2 require " "initialization if they might be called from multiple threads. Hence this " @@ -35474,12 +35485,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1190 +#: docs/internal-documentation.pod:1195 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1192 +#: docs/internal-documentation.pod:1197 #, no-wrap msgid "" " static int\n" @@ -35488,19 +35499,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1195 +#: docs/internal-documentation.pod:1200 msgid "This function is the common path for shutting down the backend qemu process." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1198 +#: docs/internal-documentation.pod:1203 msgid "" "C calls C with C. " "C calls C with C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1202 +#: docs/internal-documentation.pod:1207 msgid "" "C is a hint to the backend about whether we care about " "errors or not. In the libvirt case it can be used to optimize the shutdown " @@ -35508,12 +35519,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1206 +#: docs/internal-documentation.pod:1211 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1208 +#: docs/internal-documentation.pod:1213 #, no-wrap msgid "" " static void\n" @@ -35522,17 +35533,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1211 +#: docs/internal-documentation.pod:1216 msgid "Close all open handles (called from L)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1213 +#: docs/internal-documentation.pod:1218 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1215 +#: docs/internal-documentation.pod:1220 #, no-wrap msgid "" " int\n" @@ -35541,24 +35552,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1218 +#: docs/internal-documentation.pod:1223 msgid "" "This is a convenience function, but we might consider exporting it as an API " "in future." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1221 +#: docs/internal-documentation.pod:1226 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1223 +#: docs/internal-documentation.pod:1228 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1225 +#: docs/internal-documentation.pod:1230 #, no-wrap msgid "" " static int\n" @@ -35567,31 +35578,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1228 +#: docs/internal-documentation.pod:1233 msgid "" "Test if the qemu-img info command supports the C<-U> option to disable " "locking. The result is memoized in the handle." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1231 +#: docs/internal-documentation.pod:1236 msgid "" "Note this option was added in qemu 2.11. We can remove this test when we " "can assume everyone is using qemu >= 2.11." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1234 +#: docs/internal-documentation.pod:1239 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1236 +#: docs/internal-documentation.pod:1241 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1238 +#: docs/internal-documentation.pod:1243 #, no-wrap msgid "" " char *\n" @@ -35602,12 +35613,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1243 +#: docs/internal-documentation.pod:1248 msgid "Download a guest file to a local temporary file." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1245 +#: docs/internal-documentation.pod:1250 msgid "" "The name of the temporary (downloaded) file is returned. The caller must " "free the pointer, but does I need to delete the temporary file. It " @@ -35615,41 +35626,41 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1249 +#: docs/internal-documentation.pod:1254 msgid "" "The name of the temporary file is randomly generated, but an extension can " "be specified using C (or pass C for none)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1252 +#: docs/internal-documentation.pod:1257 msgid "" "Refuse to download the guest file if it is larger than C. On this " "and other errors, C is returned." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1255 +#: docs/internal-documentation.pod:1260 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1257 +#: docs/internal-documentation.pod:1262 msgid "Implementation of the C backend." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1259 +#: docs/internal-documentation.pod:1264 msgid "For more details see L." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1261 +#: docs/internal-documentation.pod:1266 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1263 +#: docs/internal-documentation.pod:1268 #, no-wrap msgid "" " static int\n" @@ -35661,17 +35672,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1268 +#: docs/internal-documentation.pod:1273 msgid "Add the standard elements of the C<-drive> parameter." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1270 +#: docs/internal-documentation.pod:1275 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1272 +#: docs/internal-documentation.pod:1277 #, no-wrap msgid "" " static int\n" @@ -35681,19 +35692,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1276 +#: docs/internal-documentation.pod:1281 msgid "" "Add the physical_block_size and logical_block_size elements of the " "C<-device> parameter." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1279 +#: docs/internal-documentation.pod:1284 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1281 +#: docs/internal-documentation.pod:1286 #, no-wrap msgid "" " static int\n" @@ -35703,17 +35714,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1284 +#: docs/internal-documentation.pod:1289 msgid "Launch passt such that it daemonizes." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1286 +#: docs/internal-documentation.pod:1291 msgid "On error, C<-1> is returned; C and C are not modified." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1288 +#: docs/internal-documentation.pod:1293 msgid "" "On success, C<0> is returned. C contains the PID of the passt " "background process. C contains the pathname of the unix domain " @@ -35721,17 +35732,17 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1292 +#: docs/internal-documentation.pod:1297 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1294 +#: docs/internal-documentation.pod:1299 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1296 +#: docs/internal-documentation.pod:1301 #, no-wrap msgid "" " static char *\n" @@ -35740,12 +35751,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1299 +#: docs/internal-documentation.pod:1304 msgid "Return Csrc.format>, but if it is C, autodetect the format." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1302 +#: docs/internal-documentation.pod:1307 msgid "" "libvirt has disabled the feature of detecting the disk format, unless the " "administrator sets C in " @@ -35755,7 +35766,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1308 +#: docs/internal-documentation.pod:1313 msgid "" "This can still be a security issue, so in most cases it is recommended the " "users pass the format to libguestfs which will faithfully pass that straight " @@ -35763,19 +35774,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1313 +#: docs/internal-documentation.pod:1318 msgid "" "Caller must free the returned string. On error this function sets the error " "in the handle and returns C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1316 +#: docs/internal-documentation.pod:1321 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1318 +#: docs/internal-documentation.pod:1323 #, no-wrap msgid "" " static char *\n" @@ -35785,7 +35796,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1322 +#: docs/internal-documentation.pod:1327 msgid "" "Create a qcow2 format overlay, with the given C (file). The " "C parameter is the backing file format. The C parameter can " @@ -35794,17 +35805,17 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1328 +#: docs/internal-documentation.pod:1333 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1330 +#: docs/internal-documentation.pod:1335 msgid "This file implements L." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1332 +#: docs/internal-documentation.pod:1337 msgid "" "Most of the work is done by the backends (see L), which " "are implemented in F, F etc, so " @@ -35812,12 +35823,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1337 +#: docs/internal-documentation.pod:1342 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1339 +#: docs/internal-documentation.pod:1344 #, no-wrap msgid "" " void\n" @@ -35826,19 +35837,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1342 +#: docs/internal-documentation.pod:1347 msgid "This function sends a launch progress message." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1344 +#: docs/internal-documentation.pod:1349 msgid "" "Launching the appliance generates approximate progress messages. Currently " "these are defined as follows:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1347 +#: docs/internal-documentation.pod:1352 #, no-wrap msgid "" " 0 / 12: launch clock starts\n" @@ -35850,31 +35861,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1359 +#: docs/internal-documentation.pod:1364 msgid "" "This is not a documented ABI and the behaviour may be changed or removed in " "future." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1364 +#: docs/internal-documentation.pod:1369 msgid "" "Messages are only sent if more than 5 seconds has elapsed since the launch " "clock started." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1369 +#: docs/internal-documentation.pod:1374 msgid "There is a hack in F to make this work." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1373 +#: docs/internal-documentation.pod:1378 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1375 +#: docs/internal-documentation.pod:1380 #, no-wrap msgid "" " int64_t\n" @@ -35884,24 +35895,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1378 +#: docs/internal-documentation.pod:1383 msgid "Compute C and return the result in milliseconds." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1380 +#: docs/internal-documentation.pod:1385 msgid "" "Approximately the same as this code: " "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1383 +#: docs/internal-documentation.pod:1388 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1385 +#: docs/internal-documentation.pod:1390 #, no-wrap msgid "" " void\n" @@ -35910,7 +35921,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1388 +#: docs/internal-documentation.pod:1393 msgid "" "Unblock the C signal. Call this after L so that the " "parent process can send C to the child process in case C " @@ -35918,12 +35929,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1392 +#: docs/internal-documentation.pod:1397 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1394 +#: docs/internal-documentation.pod:1399 #, no-wrap msgid "" " int\n" @@ -35932,19 +35943,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1397 +#: docs/internal-documentation.pod:1402 msgid "" "Returns the maximum number of disks allowed to be added to the backend " "(backend dependent)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1400 +#: docs/internal-documentation.pod:1405 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1402 +#: docs/internal-documentation.pod:1407 #, no-wrap msgid "" " int\n" @@ -35953,7 +35964,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1405 +#: docs/internal-documentation.pod:1410 msgid "" "Implementation of L. You had to call this " "function after launch in versions E 1.0.70, but it is now an (almost) " @@ -35961,12 +35972,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1409 +#: docs/internal-documentation.pod:1414 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1411 +#: docs/internal-documentation.pod:1416 #, no-wrap msgid "" " void\n" @@ -35976,19 +35987,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1414 +#: docs/internal-documentation.pod:1419 msgid "" "When the library is loaded, each backend calls this function to register " "itself in a global list." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1417 +#: docs/internal-documentation.pod:1422 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1419 +#: docs/internal-documentation.pod:1424 #, no-wrap msgid "" " int\n" @@ -35997,29 +36008,29 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1422 +#: docs/internal-documentation.pod:1427 msgid "Implementation of L." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1428 +#: docs/internal-documentation.pod:1433 msgid "Callers must ensure this is only called in the config state." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1432 +#: docs/internal-documentation.pod:1437 msgid "" "This shouldn't call C since it may be called early in handle " "initialization. It can return an error code however." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1437 +#: docs/internal-documentation.pod:1442 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1439 +#: docs/internal-documentation.pod:1444 #, no-wrap msgid "" " bool\n" @@ -36028,14 +36039,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1442 +#: docs/internal-documentation.pod:1447 msgid "" "Return C if we can call S>, and it exits with status " "C<0> or C<1>." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1445 +#: docs/internal-documentation.pod:1450 msgid "" "(At least C terminates with status " "C<1> in response to \"--help\", which is arguably wrong, and potentially " @@ -36043,24 +36054,24 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1449 +#: docs/internal-documentation.pod:1454 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1451 +#: docs/internal-documentation.pod:1456 msgid "" "Implement a private data area where libguestfs C API users can attach " "arbitrary pieces of data to a C handle." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1454 +#: docs/internal-documentation.pod:1459 msgid "For more information see L." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1456 +#: docs/internal-documentation.pod:1461 msgid "" "Language bindings do not generally expose this, largely because in non-C " "languages it is easy to associate data with handles in other ways (using " @@ -36068,12 +36079,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1460 +#: docs/internal-documentation.pod:1465 msgid "Structure C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1462 +#: docs/internal-documentation.pod:1467 #, no-wrap msgid "" " struct pda_entry {\n" @@ -36084,14 +36095,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1467 +#: docs/internal-documentation.pod:1472 msgid "" "The private data area is internally stored as a gnulib hash table containing " "C structures." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1470 +#: docs/internal-documentation.pod:1475 msgid "" "Note the private data area is allocated lazily, since the vast majority of " "callers will never use it. This means Cpda> is likely to be " @@ -36099,12 +36110,12 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1474 +#: docs/internal-documentation.pod:1479 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1476 +#: docs/internal-documentation.pod:1481 msgid "" "This is the code used to send and receive RPC messages and (for certain " "types of message) to perform file transfers. This code is driven from the " @@ -36113,21 +36124,21 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1485 +#: docs/internal-documentation.pod:1490 msgid "" "A non-daemon function (eg. L). There is no " "RPC involved at all, it's all handled inside the library." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1491 +#: docs/internal-documentation.pod:1496 msgid "" "A simple RPC (eg. L). We write the request, then " "read the reply. The sequence of calls is:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1494 +#: docs/internal-documentation.pod:1499 #, no-wrap msgid "" " guestfs_int_send\n" @@ -36136,7 +36147,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1499 +#: docs/internal-documentation.pod:1504 msgid "" "An RPC with C parameters (eg. L). We " "write the request, then write the file(s), then read the reply. The " @@ -36144,7 +36155,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1503 +#: docs/internal-documentation.pod:1508 #, no-wrap msgid "" " guestfs_int_send\n" @@ -36154,7 +36165,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1509 +#: docs/internal-documentation.pod:1514 msgid "" "An RPC with C parameters (eg. L). We " "write the request, then read the reply, then read the file(s). The sequence " @@ -36162,7 +36173,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1513 +#: docs/internal-documentation.pod:1518 #, no-wrap msgid "" " guestfs_int_send\n" @@ -36172,7 +36183,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1519 +#: docs/internal-documentation.pod:1524 msgid "" "Both C and C parameters. There are no calls like this in " "the current API, but they would be implemented as a combination of cases 3 " @@ -36180,7 +36191,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1525 +#: docs/internal-documentation.pod:1530 msgid "" "All read/write/etc operations are performed using the current connection " "module (Cconn>). During operations the connection module " @@ -36188,12 +36199,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1530 +#: docs/internal-documentation.pod:1535 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1532 +#: docs/internal-documentation.pod:1537 #, no-wrap msgid "" " static void\n" @@ -36202,17 +36213,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1535 +#: docs/internal-documentation.pod:1540 msgid "This is called if we detect EOF, ie. qemu died." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1537 +#: docs/internal-documentation.pod:1542 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1539 +#: docs/internal-documentation.pod:1544 #, no-wrap msgid "" " void\n" @@ -36222,17 +36233,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1543 +#: docs/internal-documentation.pod:1548 msgid "Convenient wrapper to generate a progress message callback." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1545 +#: docs/internal-documentation.pod:1550 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1547 +#: docs/internal-documentation.pod:1552 #, no-wrap msgid "" " void\n" @@ -36242,17 +36253,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1550 +#: docs/internal-documentation.pod:1555 msgid "Connection modules call us back here when they get a log message." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1552 +#: docs/internal-documentation.pod:1557 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1554 +#: docs/internal-documentation.pod:1559 #, no-wrap msgid "" " static ssize_t\n" @@ -36261,64 +36272,64 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1557 +#: docs/internal-documentation.pod:1562 msgid "" "Before writing to the daemon socket, check the read side of the daemon " "socket for any of these conditions:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1564 +#: docs/internal-documentation.pod:1569 msgid "return -1" msgstr "" #. type: =item -#: docs/internal-documentation.pod:1566 +#: docs/internal-documentation.pod:1571 msgid "daemon cancellation message" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1568 +#: docs/internal-documentation.pod:1573 msgid "return -2" msgstr "" #. type: =item -#: docs/internal-documentation.pod:1570 +#: docs/internal-documentation.pod:1575 msgid "progress message" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1572 +#: docs/internal-documentation.pod:1577 msgid "handle it here" msgstr "" #. type: =item -#: docs/internal-documentation.pod:1574 +#: docs/internal-documentation.pod:1579 msgid "end of input or appliance exited unexpectedly" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1576 +#: docs/internal-documentation.pod:1581 msgid "return 0" msgstr "" #. type: =item -#: docs/internal-documentation.pod:1578 +#: docs/internal-documentation.pod:1583 msgid "anything else" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1580 +#: docs/internal-documentation.pod:1585 msgid "return 1" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1584 +#: docs/internal-documentation.pod:1589 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1586 +#: docs/internal-documentation.pod:1591 #, no-wrap msgid "" " int\n" @@ -36327,24 +36338,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1589 +#: docs/internal-documentation.pod:1594 msgid "Send a file." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1591 +#: docs/internal-documentation.pod:1596 msgid "" "Returns C<0> on success, C<-1> for error, C<-2> if the daemon cancelled (we " "must read the error message)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1594 +#: docs/internal-documentation.pod:1599 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1596 +#: docs/internal-documentation.pod:1601 #, no-wrap msgid "" " static int\n" @@ -36353,17 +36364,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1599 +#: docs/internal-documentation.pod:1604 msgid "Send a chunk of file data." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1601 +#: docs/internal-documentation.pod:1606 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1603 +#: docs/internal-documentation.pod:1608 #, no-wrap msgid "" " static int\n" @@ -36372,17 +36383,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1606 +#: docs/internal-documentation.pod:1611 msgid "Send a cancellation message." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1608 +#: docs/internal-documentation.pod:1613 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1610 +#: docs/internal-documentation.pod:1615 #, no-wrap msgid "" " static int\n" @@ -36391,17 +36402,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1613 +#: docs/internal-documentation.pod:1618 msgid "Send a file complete chunk." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1615 +#: docs/internal-documentation.pod:1620 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1617 +#: docs/internal-documentation.pod:1622 #, no-wrap msgid "" " static int\n" @@ -36410,7 +36421,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1620 +#: docs/internal-documentation.pod:1625 msgid "" "This function reads a single message, file chunk, launch flag or " "cancellation flag from the daemon. If something was read, it returns C<0>, " @@ -36418,43 +36429,43 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1624 +#: docs/internal-documentation.pod:1629 msgid "Both C and C must be passed by the caller as non-NULL." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1627 +#: docs/internal-documentation.pod:1632 msgid "" "C<*size_rtn> returns the size of the returned message or it may be " "C or C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1630 +#: docs/internal-documentation.pod:1635 msgid "" "C<*buf_rtn> is returned containing the message (if any) or will be set to " "C. C<*buf_rtn> must be freed by the caller." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1633 +#: docs/internal-documentation.pod:1638 msgid "" "This checks for EOF (appliance died) and passes that up through the " "child_cleanup function above." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1636 +#: docs/internal-documentation.pod:1641 msgid "Log message, progress messages are handled transparently here." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1638 +#: docs/internal-documentation.pod:1643 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1640 +#: docs/internal-documentation.pod:1645 #, no-wrap msgid "" " int\n" @@ -36466,17 +36477,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1646 +#: docs/internal-documentation.pod:1651 msgid "Receive a reply." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1648 +#: docs/internal-documentation.pod:1653 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1650 +#: docs/internal-documentation.pod:1655 #, no-wrap msgid "" " int\n" @@ -36485,32 +36496,32 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1653 +#: docs/internal-documentation.pod:1658 msgid "Same as C, but it discards the reply message." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1655 +#: docs/internal-documentation.pod:1660 msgid "Notes (XXX):" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1661 +#: docs/internal-documentation.pod:1666 msgid "This returns an int, but all current callers ignore it." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1665 +#: docs/internal-documentation.pod:1670 msgid "The error string may end up being set twice on error paths." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1669 +#: docs/internal-documentation.pod:1674 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1671 +#: docs/internal-documentation.pod:1676 #, no-wrap msgid "" " int\n" @@ -36519,17 +36530,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1674 docs/internal-documentation.pod:1683 +#: docs/internal-documentation.pod:1679 docs/internal-documentation.pod:1688 msgid "Returns C<-1> = error, C<0> = EOF, C0> = more data" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1676 +#: docs/internal-documentation.pod:1681 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1678 +#: docs/internal-documentation.pod:1683 #, no-wrap msgid "" " static ssize_t\n" @@ -36538,46 +36549,47 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1681 +#: docs/internal-documentation.pod:1686 msgid "Receive a chunk of file data." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1685 +#: docs/internal-documentation.pod:1690 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1687 +#: docs/internal-documentation.pod:1692 msgid "Functions to handle qemu versions and features." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1689 +#: docs/internal-documentation.pod:1694 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1691 +#: docs/internal-documentation.pod:1696 #, no-wrap msgid "" " static int\n" -" generic_qmp_test (guestfs_h *g, const char *qmp_command, char **outp)\n" +" generic_qmp_test (guestfs_h *g,\n" +" const char *qemu, const char *qmp_command, char **outp)\n" "\n" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1694 +#: docs/internal-documentation.pod:1700 msgid "Run a generic QMP test on the QEMU binary." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1696 +#: docs/internal-documentation.pod:1702 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1698 +#: docs/internal-documentation.pod:1704 #, no-wrap msgid "" " static int\n" @@ -36586,52 +36598,52 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1701 +#: docs/internal-documentation.pod:1707 msgid "" "Parse the json output from QMP query-kvm to find out if KVM is enabled on " "this machine." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1704 +#: docs/internal-documentation.pod:1710 msgid "" "The JSON output looks like: {\"return\": {\"enabled\": true, \"present\": " "true}}" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1707 +#: docs/internal-documentation.pod:1713 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1709 +#: docs/internal-documentation.pod:1715 #, no-wrap msgid "" " int\n" -" guestfs_int_platform_has_kvm (guestfs_h *g)\n" +" guestfs_int_platform_has_kvm (guestfs_h *g, const char *qemu)\n" "\n" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1712 +#: docs/internal-documentation.pod:1718 msgid "Test if the platform supports KVM." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1714 +#: docs/internal-documentation.pod:1720 msgid "" "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:1718 +#: docs/internal-documentation.pod:1724 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1720 +#: docs/internal-documentation.pod:1726 #, no-wrap msgid "" " char *\n" @@ -36640,17 +36652,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1723 +#: docs/internal-documentation.pod:1729 msgid "Escape a qemu parameter." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1725 +#: docs/internal-documentation.pod:1731 msgid "Every C<,> becomes C<,,>. The caller must free the returned string." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1727 +#: docs/internal-documentation.pod:1733 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 " @@ -36658,12 +36670,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1731 +#: docs/internal-documentation.pod:1737 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1733 +#: docs/internal-documentation.pod:1739 #, no-wrap msgid "" " char *\n" @@ -36673,12 +36685,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1737 +#: docs/internal-documentation.pod:1743 msgid "Useful function to format a drive + protocol for qemu." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1739 +#: docs/internal-documentation.pod:1745 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 " @@ -36686,12 +36698,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1743 +#: docs/internal-documentation.pod:1749 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1745 +#: docs/internal-documentation.pod:1751 #, no-wrap msgid "" " bool\n" @@ -36700,7 +36712,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1748 +#: docs/internal-documentation.pod:1754 msgid "" "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 " @@ -36708,49 +36720,49 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1752 +#: docs/internal-documentation.pod:1758 msgid "This function is called when the user set C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1754 +#: docs/internal-documentation.pod:1760 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1756 +#: docs/internal-documentation.pod:1762 msgid "Support for virt-rescue(1)." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1758 +#: docs/internal-documentation.pod:1764 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1760 +#: docs/internal-documentation.pod:1766 msgid "An expandable NULL-terminated vector of strings (like C)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1762 +#: docs/internal-documentation.pod:1768 msgid "Use the C macro to declare the stringsbuf." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1764 +#: docs/internal-documentation.pod:1770 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:1767 +#: docs/internal-documentation.pod:1773 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1769 +#: docs/internal-documentation.pod:1775 #, no-wrap msgid "" " void\n" @@ -36760,25 +36772,25 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1772 docs/internal-documentation.pod:1782 -#: docs/internal-documentation.pod:1792 +#: docs/internal-documentation.pod:1778 docs/internal-documentation.pod:1788 +#: docs/internal-documentation.pod:1798 msgid "Add a string to the end of the list." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1774 +#: docs/internal-documentation.pod:1780 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:1777 +#: docs/internal-documentation.pod:1783 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1779 +#: docs/internal-documentation.pod:1785 #, no-wrap msgid "" " void\n" @@ -36788,17 +36800,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1784 +#: docs/internal-documentation.pod:1790 msgid "This makes a copy of the string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1786 +#: docs/internal-documentation.pod:1792 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1788 +#: docs/internal-documentation.pod:1794 #, no-wrap msgid "" " void\n" @@ -36808,17 +36820,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1794 +#: docs/internal-documentation.pod:1800 msgid "Uses an sprintf-like format string when creating the string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1796 +#: docs/internal-documentation.pod:1802 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1798 +#: docs/internal-documentation.pod:1804 #, no-wrap msgid "" " void\n" @@ -36827,22 +36839,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1801 +#: docs/internal-documentation.pod:1807 msgid "Finish the string buffer." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1803 +#: docs/internal-documentation.pod:1809 msgid "This adds the terminating NULL to the end of the vector." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1805 +#: docs/internal-documentation.pod:1811 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1807 +#: docs/internal-documentation.pod:1813 #, no-wrap msgid "" " void\n" @@ -36851,27 +36863,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1810 +#: docs/internal-documentation.pod:1816 msgid "Free the string buffer and the strings." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1812 +#: docs/internal-documentation.pod:1818 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1814 +#: docs/internal-documentation.pod:1820 msgid "Handle temporary directories." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1816 +#: docs/internal-documentation.pod:1822 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1818 +#: docs/internal-documentation.pod:1824 #, no-wrap msgid "" " static int\n" @@ -36881,7 +36893,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1822 +#: docs/internal-documentation.pod:1828 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 " @@ -36889,7 +36901,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1826 +#: docs/internal-documentation.pod:1832 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 " @@ -36897,12 +36909,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1830 +#: docs/internal-documentation.pod:1836 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1832 +#: docs/internal-documentation.pod:1838 #, no-wrap msgid "" " char *\n" @@ -36911,22 +36923,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1835 +#: docs/internal-documentation.pod:1841 msgid "Implements the C API." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1837 +#: docs/internal-documentation.pod:1843 msgid "Note this actually calculates the tmpdir, so it never returns C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1840 +#: docs/internal-documentation.pod:1846 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1842 +#: docs/internal-documentation.pod:1848 #, no-wrap msgid "" " char *\n" @@ -36935,22 +36947,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1845 +#: docs/internal-documentation.pod:1851 msgid "Implements the C API." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1847 +#: docs/internal-documentation.pod:1853 msgid "Note this actually calculates the cachedir, so it never returns C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1849 +#: docs/internal-documentation.pod:1855 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1851 +#: docs/internal-documentation.pod:1857 #, no-wrap msgid "" " char *\n" @@ -36959,22 +36971,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1854 +#: docs/internal-documentation.pod:1860 msgid "Implements the C API." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1856 +#: docs/internal-documentation.pod:1862 msgid "Note this actually calculates the sockdir, so it never returns C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1859 +#: docs/internal-documentation.pod:1865 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1861 +#: docs/internal-documentation.pod:1867 #, no-wrap msgid "" " int\n" @@ -36983,7 +36995,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1864 +#: docs/internal-documentation.pod:1870 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 " @@ -36991,12 +37003,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1868 +#: docs/internal-documentation.pod:1874 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1870 +#: docs/internal-documentation.pod:1876 #, no-wrap msgid "" " char *\n" @@ -37006,22 +37018,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1874 +#: docs/internal-documentation.pod:1880 msgid "Generate unique temporary paths for temporary files." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1876 +#: docs/internal-documentation.pod:1882 msgid "Returns a unique path or NULL on error." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1878 +#: docs/internal-documentation.pod:1884 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1880 +#: docs/internal-documentation.pod:1886 #, no-wrap msgid "" " int\n" @@ -37031,17 +37043,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1884 +#: docs/internal-documentation.pod:1890 msgid "Create the path for a socket with the selected filename in the sockdir." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1887 +#: docs/internal-documentation.pod:1893 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1889 +#: docs/internal-documentation.pod:1895 #, no-wrap msgid "" " char *\n" @@ -37050,12 +37062,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1892 +#: docs/internal-documentation.pod:1898 msgid "Generate unique paths for PID files." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1894 +#: docs/internal-documentation.pod:1900 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 " @@ -37063,12 +37075,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1898 +#: docs/internal-documentation.pod:1904 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1900 +#: docs/internal-documentation.pod:1906 #, no-wrap msgid "" " char *\n" @@ -37077,31 +37089,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1903 +#: docs/internal-documentation.pod:1909 msgid "" "Create the supermin appliance directory under cachedir, if it does not " "exist." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1906 +#: docs/internal-documentation.pod:1912 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:1909 +#: docs/internal-documentation.pod:1915 msgid "Returns the directory name which the caller must free." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1911 +#: docs/internal-documentation.pod:1917 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1913 +#: docs/internal-documentation.pod:1919 #, no-wrap msgid "" " void\n" @@ -37110,7 +37122,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1916 +#: docs/internal-documentation.pod:1922 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 " @@ -37118,27 +37130,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1920 +#: docs/internal-documentation.pod:1926 msgid "This is implemented using C because that's simpler and safer." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1923 +#: docs/internal-documentation.pod:1929 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1925 +#: docs/internal-documentation.pod:1931 msgid "Return current umask in a thread-safe way." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1927 +#: docs/internal-documentation.pod:1933 msgid "glibc documents, but does not actually implement, a \"getumask(3)\" call." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1930 +#: docs/internal-documentation.pod:1936 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 " @@ -37146,17 +37158,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1934 +#: docs/internal-documentation.pod:1940 msgid "Thanks to: Josh Stone, Jiri Jaburek, Eric Blake." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1936 +#: docs/internal-documentation.pod:1942 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1938 +#: docs/internal-documentation.pod:1944 #, no-wrap msgid "" " int\n" @@ -37165,19 +37177,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1941 +#: docs/internal-documentation.pod:1947 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:1944 +#: docs/internal-documentation.pod:1950 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1946 +#: docs/internal-documentation.pod:1952 #, no-wrap msgid "" " static int\n" @@ -37186,12 +37198,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1949 +#: docs/internal-documentation.pod:1955 msgid "For Linux E 4.7 get the umask from F." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1951 +#: docs/internal-documentation.pod:1957 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 " @@ -37199,12 +37211,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1955 +#: docs/internal-documentation.pod:1961 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1957 +#: docs/internal-documentation.pod:1963 #, no-wrap msgid "" " static int\n" @@ -37213,34 +37225,34 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1960 +#: docs/internal-documentation.pod:1966 msgid "Fallback method of getting the umask using fork." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:1962 +#: docs/internal-documentation.pod:1968 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1964 docs/internal-documentation.pod:2492 +#: docs/internal-documentation.pod:1970 docs/internal-documentation.pod:2498 msgid "Unit tests of internal functions." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1966 docs/internal-documentation.pod:2494 +#: docs/internal-documentation.pod:1972 docs/internal-documentation.pod:2500 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:1969 +#: docs/internal-documentation.pod:1975 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1971 +#: docs/internal-documentation.pod:1977 #, no-wrap msgid "" " static void\n" @@ -37249,17 +37261,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1974 +#: docs/internal-documentation.pod:1980 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1976 +#: docs/internal-documentation.pod:1982 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1978 +#: docs/internal-documentation.pod:1984 #, no-wrap msgid "" " static void\n" @@ -37268,17 +37280,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1981 +#: docs/internal-documentation.pod:1987 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1983 +#: docs/internal-documentation.pod:1989 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1985 +#: docs/internal-documentation.pod:1991 #, no-wrap msgid "" " static void\n" @@ -37287,17 +37299,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1988 +#: docs/internal-documentation.pod:1994 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1990 +#: docs/internal-documentation.pod:1996 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1992 +#: docs/internal-documentation.pod:1998 #, no-wrap msgid "" " static void\n" @@ -37306,17 +37318,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:1995 +#: docs/internal-documentation.pod:2001 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:1997 +#: docs/internal-documentation.pod:2003 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:1999 +#: docs/internal-documentation.pod:2005 #, no-wrap msgid "" " static void\n" @@ -37325,17 +37337,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2002 +#: docs/internal-documentation.pod:2008 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2004 +#: docs/internal-documentation.pod:2010 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2006 +#: docs/internal-documentation.pod:2012 #, no-wrap msgid "" " static void\n" @@ -37344,17 +37356,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2009 +#: docs/internal-documentation.pod:2015 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2011 +#: docs/internal-documentation.pod:2017 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2013 +#: docs/internal-documentation.pod:2019 #, no-wrap msgid "" " static void\n" @@ -37363,17 +37375,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2016 +#: docs/internal-documentation.pod:2022 msgid "Test C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2018 +#: docs/internal-documentation.pod:2024 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2020 +#: docs/internal-documentation.pod:2026 #, no-wrap msgid "" " static void\n" @@ -37382,24 +37394,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2023 +#: docs/internal-documentation.pod:2029 msgid "Test C etc." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2025 +#: docs/internal-documentation.pod:2031 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:2028 +#: docs/internal-documentation.pod:2034 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2030 +#: docs/internal-documentation.pod:2036 #, no-wrap msgid "" " static void\n" @@ -37408,12 +37420,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2033 +#: docs/internal-documentation.pod:2039 msgid "Test C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2035 +#: docs/internal-documentation.pod:2041 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 " @@ -37421,12 +37433,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2039 +#: docs/internal-documentation.pod:2045 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2041 +#: docs/internal-documentation.pod:2047 #, no-wrap msgid "" " static void\n" @@ -37435,27 +37447,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2044 +#: docs/internal-documentation.pod:2050 msgid "Test C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2046 +#: docs/internal-documentation.pod:2052 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2048 +#: docs/internal-documentation.pod:2054 msgid "This file provides simple version number management." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2050 +#: docs/internal-documentation.pod:2056 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2052 +#: docs/internal-documentation.pod:2058 #, no-wrap msgid "" " int\n" @@ -37465,13 +37477,13 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2055 +#: docs/internal-documentation.pod:2061 msgid "Parses a version from a string, looking for a C pattern." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2057 docs/internal-documentation.pod:2070 -#: docs/internal-documentation.pod:2083 +#: docs/internal-documentation.pod:2063 docs/internal-documentation.pod:2076 +#: docs/internal-documentation.pod:2089 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 " @@ -37479,12 +37491,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2061 +#: docs/internal-documentation.pod:2067 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2063 +#: docs/internal-documentation.pod:2069 #, no-wrap msgid "" " int\n" @@ -37494,19 +37506,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2067 +#: docs/internal-documentation.pod:2073 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:2074 +#: docs/internal-documentation.pod:2080 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2076 +#: docs/internal-documentation.pod:2082 #, no-wrap msgid "" " int\n" @@ -37516,19 +37528,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2080 +#: docs/internal-documentation.pod:2086 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:2087 +#: docs/internal-documentation.pod:2093 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2089 +#: docs/internal-documentation.pod:2095 #, no-wrap msgid "" " int\n" @@ -37537,34 +37549,34 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2092 +#: docs/internal-documentation.pod:2098 msgid "Parse small, unsigned ints, as used in version numbers." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2094 +#: docs/internal-documentation.pod:2100 msgid "" "This will fail with an error if trailing characters are found after the " "integer." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2097 +#: docs/internal-documentation.pod:2103 msgid "Returns E C<0> on success, or C<-1> on failure." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2099 +#: docs/internal-documentation.pod:2105 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2101 +#: docs/internal-documentation.pod:2107 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2103 +#: docs/internal-documentation.pod:2109 #, no-wrap msgid "" " int\n" @@ -37574,12 +37586,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2106 +#: docs/internal-documentation.pod:2112 msgid "A safe version of L which retries if C is returned." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2109 +#: docs/internal-documentation.pod:2115 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 " @@ -37587,7 +37599,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2113 +#: docs/internal-documentation.pod:2119 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 " @@ -37598,12 +37610,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2120 +#: docs/internal-documentation.pod:2126 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2122 +#: docs/internal-documentation.pod:2128 #, no-wrap msgid "" " void\n" @@ -37612,17 +37624,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2125 +#: docs/internal-documentation.pod:2131 msgid "Like C, but ignore errors." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2127 +#: docs/internal-documentation.pod:2133 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2129 +#: docs/internal-documentation.pod:2135 #, no-wrap msgid "" " int\n" @@ -37632,22 +37644,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2133 +#: docs/internal-documentation.pod:2139 msgid "A safe version of L which retries if C is returned." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2136 +#: docs/internal-documentation.pod:2142 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2138 +#: docs/internal-documentation.pod:2144 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2140 +#: docs/internal-documentation.pod:2146 #, no-wrap msgid "" " int\n" @@ -37657,12 +37669,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2144 +#: docs/internal-documentation.pod:2150 msgid "Read the whole file C into a memory buffer." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2146 +#: docs/internal-documentation.pod:2152 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 " @@ -37670,19 +37682,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2150 +#: docs/internal-documentation.pod:2156 msgid "On error this sets the error in the handle and returns C<-1>." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2152 +#: docs/internal-documentation.pod:2158 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:2155 +#: docs/internal-documentation.pod:2161 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 " @@ -37690,17 +37702,17 @@ msgid "" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2160 +#: docs/internal-documentation.pod:2166 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2162 +#: docs/internal-documentation.pod:2168 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2164 +#: docs/internal-documentation.pod:2170 msgid "" "This file implements common file editing in a range of utilities including " "L, L, L and " @@ -37708,19 +37720,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2168 +#: docs/internal-documentation.pod:2174 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:2171 +#: docs/internal-documentation.pod:2177 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2173 +#: docs/internal-documentation.pod:2179 #, no-wrap msgid "" " int\n" @@ -37730,38 +37742,38 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2177 +#: docs/internal-documentation.pod:2183 msgid "Edit C using the specified C application." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2179 docs/internal-documentation.pod:2198 +#: docs/internal-documentation.pod:2185 docs/internal-documentation.pod:2204 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:2182 +#: docs/internal-documentation.pod:2188 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:2186 +#: docs/internal-documentation.pod:2192 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:2190 +#: docs/internal-documentation.pod:2196 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2192 +#: docs/internal-documentation.pod:2198 #, no-wrap msgid "" " int\n" @@ -37772,34 +37784,34 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2196 +#: docs/internal-documentation.pod:2202 msgid "Edit C running the specified C using Perl." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2201 +#: docs/internal-documentation.pod:2207 msgid "Returns C<-1> for failure, C<0> on success." msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2203 +#: docs/internal-documentation.pod:2209 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2205 +#: docs/internal-documentation.pod:2211 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2207 +#: docs/internal-documentation.pod:2213 msgid "" "This file parses the guestfish configuration file, usually " "F<~/.libguestfs-tools.rc> or F." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2210 +#: docs/internal-documentation.pod:2216 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 " @@ -37807,24 +37819,24 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2214 +#: docs/internal-documentation.pod:2220 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2216 +#: docs/internal-documentation.pod:2222 msgid "" "This file implements the decryption of disk images, usually done before " "mounting their partitions." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2219 +#: docs/internal-documentation.pod:2225 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2221 +#: docs/internal-documentation.pod:2227 #, no-wrap msgid "" " static char *\n" @@ -37833,7 +37845,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2224 +#: docs/internal-documentation.pod:2230 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 " @@ -37843,12 +37855,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2230 +#: docs/internal-documentation.pod:2236 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2232 +#: docs/internal-documentation.pod:2238 #, no-wrap msgid "" " void\n" @@ -37857,19 +37869,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2235 +#: docs/internal-documentation.pod:2241 msgid "" "Simple implementation of decryption: look for any encrypted partitions and " "decrypt them, then rescan for VGs." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2238 +#: docs/internal-documentation.pod:2244 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2240 +#: docs/internal-documentation.pod:2246 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 " @@ -37877,17 +37889,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2244 +#: docs/internal-documentation.pod:2250 msgid "These \"hidden\" options are used to implement bash tab completion." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2246 +#: docs/internal-documentation.pod:2252 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2248 +#: docs/internal-documentation.pod:2254 #, no-wrap msgid "" " void\n" @@ -37896,19 +37908,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2251 +#: docs/internal-documentation.pod:2257 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:2254 +#: docs/internal-documentation.pod:2260 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2256 +#: docs/internal-documentation.pod:2262 #, no-wrap msgid "" " void\n" @@ -37917,29 +37929,29 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2259 +#: docs/internal-documentation.pod:2265 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:2262 +#: docs/internal-documentation.pod:2268 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2264 +#: docs/internal-documentation.pod:2270 msgid "Implements the guestfish (and other tools) I<-d> option." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2266 +#: docs/internal-documentation.pod:2272 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2268 +#: docs/internal-documentation.pod:2274 #, no-wrap msgid "" " int\n" @@ -37948,22 +37960,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2271 +#: docs/internal-documentation.pod:2277 msgid "This function is called when a user invokes S>." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2273 +#: docs/internal-documentation.pod:2279 msgid "Returns the number of drives added (S 0>>), or C<-1> for failure." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2275 +#: docs/internal-documentation.pod:2281 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2277 +#: docs/internal-documentation.pod:2283 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 " @@ -37971,12 +37983,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2282 +#: docs/internal-documentation.pod:2288 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2284 +#: docs/internal-documentation.pod:2290 #, no-wrap msgid "" " void\n" @@ -37985,17 +37997,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2287 +#: docs/internal-documentation.pod:2293 msgid "This function implements the I<-i> option." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2289 +#: docs/internal-documentation.pod:2295 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2291 +#: docs/internal-documentation.pod:2297 #, no-wrap msgid "" " void\n" @@ -38004,24 +38016,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2294 +#: docs/internal-documentation.pod:2300 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:2297 +#: docs/internal-documentation.pod:2303 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2299 +#: docs/internal-documentation.pod:2305 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2301 +#: docs/internal-documentation.pod:2307 #, no-wrap msgid "" " char *\n" @@ -38030,31 +38042,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2304 +#: docs/internal-documentation.pod:2310 msgid "Read a passphrase ('Key') from F with echo off." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2306 +#: docs/internal-documentation.pod:2312 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:2309 +#: docs/internal-documentation.pod:2315 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2311 +#: docs/internal-documentation.pod:2317 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:2314 +#: docs/internal-documentation.pod:2320 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 " @@ -38062,19 +38074,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2318 +#: docs/internal-documentation.pod:2324 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:2322 +#: docs/internal-documentation.pod:2328 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2324 +#: docs/internal-documentation.pod:2330 #, no-wrap msgid "" " void\n" @@ -38084,17 +38096,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2328 +#: docs/internal-documentation.pod:2334 msgid "Handle the guestfish I<-a> option on the command line." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2330 +#: docs/internal-documentation.pod:2336 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2332 +#: docs/internal-documentation.pod:2338 #, no-wrap msgid "" " void\n" @@ -38103,17 +38115,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2335 +#: docs/internal-documentation.pod:2341 msgid "Handle the I<-d> option when passed on the command line." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2337 +#: docs/internal-documentation.pod:2343 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2339 +#: docs/internal-documentation.pod:2345 #, no-wrap msgid "" " static void\n" @@ -38123,19 +38135,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2343 +#: docs/internal-documentation.pod:2349 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:2346 +#: docs/internal-documentation.pod:2352 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2348 +#: docs/internal-documentation.pod:2354 msgid "" "This file implements URI parsing for the I<-a> option, in many utilities " "including L, L, L, " @@ -38143,17 +38155,17 @@ msgid "" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2352 +#: docs/internal-documentation.pod:2358 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2354 +#: docs/internal-documentation.pod:2360 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2356 +#: docs/internal-documentation.pod:2362 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 " @@ -38161,17 +38173,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2361 +#: docs/internal-documentation.pod:2367 msgid "It hides the complexity of querying the list of domains from libvirt." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2364 +#: docs/internal-documentation.pod:2370 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2366 +#: docs/internal-documentation.pod:2372 #, no-wrap msgid "" " void\n" @@ -38180,17 +38192,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2369 +#: docs/internal-documentation.pod:2375 msgid "Frees up everything allocated by C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2371 +#: docs/internal-documentation.pod:2377 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2373 +#: docs/internal-documentation.pod:2379 #, no-wrap msgid "" " void\n" @@ -38199,24 +38211,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2376 +#: docs/internal-documentation.pod:2382 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:2380 +#: docs/internal-documentation.pod:2386 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2382 +#: docs/internal-documentation.pod:2388 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2384 +#: docs/internal-documentation.pod:2390 #, no-wrap msgid "" " size_t\n" @@ -38225,7 +38237,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2387 +#: docs/internal-documentation.pod:2393 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 " @@ -38233,12 +38245,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2391 +#: docs/internal-documentation.pod:2397 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2393 +#: docs/internal-documentation.pod:2399 #, no-wrap msgid "" " static char *\n" @@ -38247,17 +38259,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2396 +#: docs/internal-documentation.pod:2402 msgid "Run external command and read the first line of output." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2398 +#: docs/internal-documentation.pod:2404 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2400 +#: docs/internal-documentation.pod:2406 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 " @@ -38265,7 +38277,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2404 +#: docs/internal-documentation.pod:2410 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 " @@ -38273,12 +38285,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2408 +#: docs/internal-documentation.pod:2414 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2410 +#: docs/internal-documentation.pod:2416 #, no-wrap msgid "" " int\n" @@ -38287,12 +38299,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2413 +#: docs/internal-documentation.pod:2419 msgid "Run the threads and work through the global list of libvirt domains." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2416 +#: docs/internal-documentation.pod:2422 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 " @@ -38300,14 +38312,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2420 +#: docs/internal-documentation.pod:2426 msgid "" "C (which may be C) is the global guestfs handle " "created by the options mini-library." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2423 +#: docs/internal-documentation.pod:2429 msgid "" "The work function (C) should do the work (inspecting the domain, etc.) " "on domain index C. However it I print out any result " @@ -38316,36 +38328,36 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2429 +#: docs/internal-documentation.pod:2435 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:2432 +#: docs/internal-documentation.pod:2438 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2434 +#: docs/internal-documentation.pod:2440 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2436 +#: docs/internal-documentation.pod:2442 msgid "" "This file implements the progress bar in L, L " "and L." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2439 +#: docs/internal-documentation.pod:2445 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2441 +#: docs/internal-documentation.pod:2447 #, no-wrap msgid "" " struct progress_bar *\n" @@ -38354,12 +38366,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2444 +#: docs/internal-documentation.pod:2450 msgid "Initialize a progress bar struct." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2446 +#: docs/internal-documentation.pod:2452 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 " @@ -38367,12 +38379,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2450 +#: docs/internal-documentation.pod:2456 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2452 +#: docs/internal-documentation.pod:2458 #, no-wrap msgid "" " void\n" @@ -38381,17 +38393,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2455 +#: docs/internal-documentation.pod:2461 msgid "Free a progress bar struct." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2457 +#: docs/internal-documentation.pod:2463 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2459 +#: docs/internal-documentation.pod:2465 #, no-wrap msgid "" " void\n" @@ -38400,17 +38412,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2462 +#: docs/internal-documentation.pod:2468 msgid "This function should be called just before you issue any command." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2464 +#: docs/internal-documentation.pod:2470 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2466 +#: docs/internal-documentation.pod:2472 #, no-wrap msgid "" " static double\n" @@ -38419,12 +38431,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2469 +#: docs/internal-documentation.pod:2475 msgid "Return remaining time estimate (in seconds) for current call." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2471 +#: docs/internal-documentation.pod:2477 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 " @@ -38433,12 +38445,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2477 +#: docs/internal-documentation.pod:2483 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2479 +#: docs/internal-documentation.pod:2485 #, no-wrap msgid "" " void\n" @@ -38448,32 +38460,32 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2483 +#: docs/internal-documentation.pod:2489 msgid "Set the position of the progress bar." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2485 +#: docs/internal-documentation.pod:2491 msgid "This should be called from a C event callback." msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2488 +#: docs/internal-documentation.pod:2494 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2490 +#: docs/internal-documentation.pod:2496 msgid "File F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2497 +#: docs/internal-documentation.pod:2503 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2501 +#: docs/internal-documentation.pod:2507 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. " @@ -38483,19 +38495,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2508 +#: docs/internal-documentation.pod:2514 msgid "For reference here are the problems:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2514 +#: docs/internal-documentation.pod:2520 msgid "" "There's inconsistency in qemu between options and config file, eg. C<-smp " "4> becomes:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2517 +#: docs/internal-documentation.pod:2523 #, no-wrap msgid "" " [smp-opts]\n" @@ -38504,7 +38516,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2522 +#: docs/internal-documentation.pod:2528 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 " @@ -38512,7 +38524,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2528 +#: docs/internal-documentation.pod:2534 msgid "" "In C<-opt key=value,...> the C is really a tree/array specifier. The " "way this works is complicated but hinted at here: " @@ -38520,19 +38532,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2535 +#: docs/internal-documentation.pod:2541 msgid "" "Some options are syntactic sugar. eg. C<-kernel foo> is sugar for " "C<-machine kernel=foo>." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2540 +#: docs/internal-documentation.pod:2546 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2542 +#: docs/internal-documentation.pod:2548 #, no-wrap msgid "" " struct qemuopts *\n" @@ -38541,27 +38553,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2545 +#: docs/internal-documentation.pod:2551 msgid "Create an empty list of qemu options." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2547 +#: docs/internal-documentation.pod:2553 msgid "The caller must eventually free the list by calling C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2550 docs/internal-documentation.pod:2736 +#: docs/internal-documentation.pod:2556 docs/internal-documentation.pod:2742 msgid "Returns C on error, setting C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2552 +#: docs/internal-documentation.pod:2558 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2554 +#: docs/internal-documentation.pod:2560 #, no-wrap msgid "" " void\n" @@ -38570,17 +38582,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2557 +#: docs/internal-documentation.pod:2563 msgid "Free the list of qemu options." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2559 +#: docs/internal-documentation.pod:2565 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2561 +#: docs/internal-documentation.pod:2567 #, no-wrap msgid "" " int\n" @@ -38589,12 +38601,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2564 +#: docs/internal-documentation.pod:2570 msgid "Add a command line flag which has no argument. eg:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2566 +#: docs/internal-documentation.pod:2572 #, no-wrap msgid "" " qemuopts_add_flag (qopts, \"-no-user-config\");\n" @@ -38602,21 +38614,21 @@ msgid "" msgstr "" #. type: textblock -#: 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 +#: docs/internal-documentation.pod:2574 docs/internal-documentation.pod:2588 +#: docs/internal-documentation.pod:2603 docs/internal-documentation.pod:2644 +#: docs/internal-documentation.pod:2661 docs/internal-documentation.pod:2670 +#: docs/internal-documentation.pod:2684 docs/internal-documentation.pod:2698 +#: docs/internal-documentation.pod:2726 docs/internal-documentation.pod:2768 msgid "Returns C<0> on success. Returns C<-1> on error, setting C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2570 +#: docs/internal-documentation.pod:2576 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2572 +#: docs/internal-documentation.pod:2578 #, no-wrap msgid "" " int\n" @@ -38626,12 +38638,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2575 +#: docs/internal-documentation.pod:2581 msgid "Add a command line flag which has a single argument. eg:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2577 +#: docs/internal-documentation.pod:2583 #, no-wrap msgid "" " qemuopts_add_arg (qopts, \"-m\", \"1024\");\n" @@ -38639,19 +38651,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2579 docs/internal-documentation.pod:2594 +#: docs/internal-documentation.pod:2585 docs/internal-documentation.pod:2600 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:2584 +#: docs/internal-documentation.pod:2590 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2586 +#: docs/internal-documentation.pod:2592 #, no-wrap msgid "" " int\n" @@ -38661,12 +38673,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2590 +#: docs/internal-documentation.pod:2596 msgid "Add a command line flag which has a single formatted argument. eg:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2592 +#: docs/internal-documentation.pod:2598 #, no-wrap msgid "" " qemuopts_add_arg_format (qopts, \"-m\", \"%d\", 1024);\n" @@ -38674,12 +38686,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2599 +#: docs/internal-documentation.pod:2605 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2601 +#: docs/internal-documentation.pod:2607 #, no-wrap msgid "" " int\n" @@ -38689,41 +38701,41 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2605 +#: docs/internal-documentation.pod:2611 msgid "" "This is like C except that no quoting is done on the " "value." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2608 +#: docs/internal-documentation.pod:2614 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:2612 +#: docs/internal-documentation.pod:2618 msgid "For C this means that qemu comma quoting is not done." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2615 +#: docs/internal-documentation.pod:2621 msgid "C will fail." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2617 +#: docs/internal-documentation.pod:2623 msgid "You should use this with great care." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2619 +#: docs/internal-documentation.pod:2625 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2621 +#: docs/internal-documentation.pod:2627 #, no-wrap msgid "" " int\n" @@ -38732,17 +38744,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2624 +#: docs/internal-documentation.pod:2630 msgid "Start an argument that takes a comma-separated list of fields." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2626 +#: docs/internal-documentation.pod:2632 msgid "Typical usage is like this (with error handling omitted):" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2628 +#: docs/internal-documentation.pod:2634 #, no-wrap msgid "" " qemuopts_start_arg_list (qopts, \"-drive\");\n" @@ -38753,22 +38765,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2633 +#: docs/internal-documentation.pod:2639 msgid "which would construct C<-drive file=foo,if=ide>" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2635 +#: docs/internal-documentation.pod:2641 msgid "See also C for a way to do simple cases in one call." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2640 +#: docs/internal-documentation.pod:2646 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2642 +#: docs/internal-documentation.pod:2648 #, no-wrap msgid "" " int\n" @@ -38778,12 +38790,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2646 +#: docs/internal-documentation.pod:2652 msgid "Add a command line flag which has a list of arguments. eg:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2648 +#: docs/internal-documentation.pod:2654 #, no-wrap msgid "" " qemuopts_add_arg_list (qopts, \"-drive\", \"file=foo\", \"if=ide\", " @@ -38792,7 +38804,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2650 +#: docs/internal-documentation.pod:2656 msgid "" "This is turned into a comma-separated list, like: C<-drive " "file=foo,if=ide>. Note that this handles qemu quoting properly, so " @@ -38800,12 +38812,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2657 +#: docs/internal-documentation.pod:2663 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2659 +#: docs/internal-documentation.pod:2665 #, no-wrap msgid "" " int\n" @@ -38814,17 +38826,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2662 +#: docs/internal-documentation.pod:2668 msgid "Set the qemu binary name." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2666 +#: docs/internal-documentation.pod:2672 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2668 +#: docs/internal-documentation.pod:2674 #, no-wrap msgid "" " int\n" @@ -38833,19 +38845,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2671 +#: docs/internal-documentation.pod:2677 msgid "Set the qemu binary name to C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2673 +#: docs/internal-documentation.pod:2679 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:2676 +#: docs/internal-documentation.pod:2682 #, no-wrap msgid "" " qemuopts_set_binary_by_arch (qopts, NULL);\n" @@ -38853,12 +38865,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2680 +#: docs/internal-documentation.pod:2686 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2682 +#: docs/internal-documentation.pod:2688 #, no-wrap msgid "" " int\n" @@ -38867,29 +38879,29 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2685 +#: docs/internal-documentation.pod:2691 msgid "Write the qemu options to a script." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2687 docs/internal-documentation.pod:2715 +#: docs/internal-documentation.pod:2693 docs/internal-documentation.pod:2721 msgid "C must be called first." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2689 +#: docs/internal-documentation.pod:2695 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:2694 +#: docs/internal-documentation.pod:2700 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2696 +#: docs/internal-documentation.pod:2702 #, no-wrap msgid "" " static void\n" @@ -38898,17 +38910,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2699 +#: docs/internal-documentation.pod:2705 msgid "Print C to C, shell-quoting it if necessary." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2701 +#: docs/internal-documentation.pod:2707 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2703 +#: docs/internal-documentation.pod:2709 #, no-wrap msgid "" " static void\n" @@ -38917,17 +38929,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2706 +#: docs/internal-documentation.pod:2712 msgid "Print C to C doing both shell and qemu comma quoting." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2708 +#: docs/internal-documentation.pod:2714 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2710 +#: docs/internal-documentation.pod:2716 #, no-wrap msgid "" " int\n" @@ -38936,24 +38948,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2713 +#: docs/internal-documentation.pod:2719 msgid "Write the qemu options to a C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2717 +#: docs/internal-documentation.pod:2723 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:2722 +#: docs/internal-documentation.pod:2728 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2724 +#: docs/internal-documentation.pod:2730 #, no-wrap msgid "" " char **\n" @@ -38962,31 +38974,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2727 +#: docs/internal-documentation.pod:2733 msgid "" "Return a NULL-terminated argument list, of the kind that can be passed " "directly to L." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2730 +#: docs/internal-documentation.pod:2736 msgid "" "C must be called first. It will be returned as " "C in the returned list." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2733 +#: docs/internal-documentation.pod:2739 msgid "The list of strings and the strings themselves must be freed by the caller." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2738 +#: docs/internal-documentation.pod:2744 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2740 +#: docs/internal-documentation.pod:2746 #, no-wrap msgid "" " int\n" @@ -38995,14 +39007,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2743 +#: docs/internal-documentation.pod:2749 msgid "" "Write the qemu options to a qemu config file, suitable for reading in using " "C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2746 +#: docs/internal-documentation.pod:2752 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 " @@ -39012,14 +39024,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2752 +#: docs/internal-documentation.pod:2758 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:2756 +#: docs/internal-documentation.pod:2762 #, no-wrap msgid "" " [memory]\n" @@ -39028,19 +39040,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2759 +#: docs/internal-documentation.pod:2765 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:2764 +#: docs/internal-documentation.pod:2770 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2766 +#: docs/internal-documentation.pod:2772 #, no-wrap msgid "" " int\n" @@ -39049,22 +39061,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2769 +#: docs/internal-documentation.pod:2775 msgid "Same as C, but this writes to a C." msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:2771 +#: docs/internal-documentation.pod:2777 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2773 +#: docs/internal-documentation.pod:2779 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2775 docs/internal-documentation.pod:2815 +#: docs/internal-documentation.pod:2781 docs/internal-documentation.pod:2821 msgid "" "Libguestfs uses C macros to simplify temporary allocations. They " "are implemented using the C<__attribute__((cleanup))> feature of gcc and " @@ -39072,7 +39084,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2780 docs/internal-documentation.pod:2820 +#: docs/internal-documentation.pod:2786 docs/internal-documentation.pod:2826 #, no-wrap msgid "" " fn ()\n" @@ -39085,12 +39097,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2787 docs/internal-documentation.pod:2827 +#: docs/internal-documentation.pod:2793 docs/internal-documentation.pod:2833 msgid "There are a few catches to be aware of with the cleanup mechanism:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2793 docs/internal-documentation.pod:2833 +#: docs/internal-documentation.pod:2799 docs/internal-documentation.pod:2839 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 " @@ -39099,43 +39111,43 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2800 docs/internal-documentation.pod:2840 +#: docs/internal-documentation.pod:2806 docs/internal-documentation.pod:2846 msgid "Don't mark variables holding return values as cleanup variables." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2804 docs/internal-documentation.pod:2844 +#: docs/internal-documentation.pod:2810 docs/internal-documentation.pod:2850 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:2810 docs/internal-documentation.pod:2850 +#: docs/internal-documentation.pod:2816 docs/internal-documentation.pod:2856 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:2813 +#: docs/internal-documentation.pod:2819 msgid "File F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2853 +#: docs/internal-documentation.pod:2859 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2855 +#: docs/internal-documentation.pod:2861 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:2858 +#: docs/internal-documentation.pod:2864 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 " @@ -39143,33 +39155,33 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2862 +#: docs/internal-documentation.pod:2868 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:2866 +#: docs/internal-documentation.pod:2872 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2868 +#: docs/internal-documentation.pod:2874 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:2875 +#: docs/internal-documentation.pod:2881 msgid "" "The C is called C. It is used implicitly by all the " "macros." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2880 +#: docs/internal-documentation.pod:2886 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 " @@ -39177,17 +39189,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2887 +#: docs/internal-documentation.pod:2893 msgid "All the \"bad\" casting is hidden inside the macros." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2891 +#: docs/internal-documentation.pod:2897 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2893 +#: docs/internal-documentation.pod:2899 #, no-wrap msgid "" " #define start_element\n" @@ -39195,12 +39207,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2895 +#: docs/internal-documentation.pod:2901 msgid "To define an XML element use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2897 +#: docs/internal-documentation.pod:2903 #, no-wrap msgid "" " start_element (\"name\") {\n" @@ -39210,17 +39222,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2901 +#: docs/internal-documentation.pod:2907 msgid "which produces C<<< ... >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2903 +#: docs/internal-documentation.pod:2909 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2905 +#: docs/internal-documentation.pod:2911 #, no-wrap msgid "" " #define empty_element\n" @@ -39228,12 +39240,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2907 +#: docs/internal-documentation.pod:2913 msgid "To define an empty element:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2909 +#: docs/internal-documentation.pod:2915 #, no-wrap msgid "" " empty_element (\"name\");\n" @@ -39241,17 +39253,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2911 +#: docs/internal-documentation.pod:2917 msgid "which produces C<<< >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2913 +#: docs/internal-documentation.pod:2919 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2915 +#: docs/internal-documentation.pod:2921 #, no-wrap msgid "" " #define single_element\n" @@ -39259,12 +39271,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2917 +#: docs/internal-documentation.pod:2923 msgid "To define a single element with no attributes containing some text:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2919 +#: docs/internal-documentation.pod:2925 #, no-wrap msgid "" " single_element (\"name\", text);\n" @@ -39272,17 +39284,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2921 +#: docs/internal-documentation.pod:2927 msgid "which produces C<<< text >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2923 +#: docs/internal-documentation.pod:2929 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2925 +#: docs/internal-documentation.pod:2931 #, no-wrap msgid "" " #define single_element_format\n" @@ -39290,14 +39302,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2927 +#: docs/internal-documentation.pod:2933 msgid "" "To define a single element with no attributes containing some text using a " "format string:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2930 +#: docs/internal-documentation.pod:2936 #, no-wrap msgid "" " single_element_format (\"cores\", \"%d\", nr_cores);\n" @@ -39305,17 +39317,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2932 +#: docs/internal-documentation.pod:2938 msgid "which produces C<<< 4 >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2934 +#: docs/internal-documentation.pod:2940 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2936 +#: docs/internal-documentation.pod:2942 #, no-wrap msgid "" " #define attribute\n" @@ -39323,12 +39335,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2938 +#: docs/internal-documentation.pod:2944 msgid "To define an XML element with attributes, use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2940 +#: docs/internal-documentation.pod:2946 #, no-wrap msgid "" " start_element (\"name\") {\n" @@ -39340,17 +39352,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2946 +#: docs/internal-documentation.pod:2952 msgid "which produces C<<< ... >>>" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2948 +#: docs/internal-documentation.pod:2954 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2950 +#: docs/internal-documentation.pod:2956 #, no-wrap msgid "" " #define attribute_ns\n" @@ -39358,19 +39370,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2952 +#: docs/internal-documentation.pod:2958 msgid "" "C defines a namespaced " "attribute." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2955 +#: docs/internal-documentation.pod:2961 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2957 +#: docs/internal-documentation.pod:2963 #, no-wrap msgid "" " #define string\n" @@ -39378,12 +39390,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2959 +#: docs/internal-documentation.pod:2965 msgid "To define a verbatim string, use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2961 +#: docs/internal-documentation.pod:2967 #, no-wrap msgid "" " string (\"hello\");\n" @@ -39391,12 +39403,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2963 +#: docs/internal-documentation.pod:2969 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2965 +#: docs/internal-documentation.pod:2971 #, no-wrap msgid "" " #define string_format\n" @@ -39404,12 +39416,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2967 +#: docs/internal-documentation.pod:2973 msgid "To define a verbatim string using a format string, use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2969 +#: docs/internal-documentation.pod:2975 #, no-wrap msgid "" " string (\"%s, world\", greeting);\n" @@ -39417,12 +39429,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2971 +#: docs/internal-documentation.pod:2977 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2973 +#: docs/internal-documentation.pod:2979 #, no-wrap msgid "" " #define base64\n" @@ -39430,12 +39442,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2975 +#: docs/internal-documentation.pod:2981 msgid "To write a string encoded as base64:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2977 +#: docs/internal-documentation.pod:2983 #, no-wrap msgid "" " base64 (data, size);\n" @@ -39443,12 +39455,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2979 +#: docs/internal-documentation.pod:2985 msgid "Definition C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2981 +#: docs/internal-documentation.pod:2987 #, no-wrap msgid "" " #define comment\n" @@ -39456,12 +39468,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2983 +#: docs/internal-documentation.pod:2989 msgid "To define a comment in the XML, use:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2985 +#: docs/internal-documentation.pod:2991 #, no-wrap msgid "" " comment (\"number of items = %d\", nr_items);\n" @@ -39469,29 +39481,29 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:2987 +#: docs/internal-documentation.pod:2993 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2989 docs/internal-documentation.pod:3026 +#: docs/internal-documentation.pod:2995 docs/internal-documentation.pod:3032 msgid "Utility functions used by the library, tools and language bindings." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2991 docs/internal-documentation.pod:3028 +#: docs/internal-documentation.pod:2997 docs/internal-documentation.pod:3034 msgid "" "These functions I call internal library functions such as " "C, C or C, or any C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:2994 +#: docs/internal-documentation.pod:3000 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:2996 +#: docs/internal-documentation.pod:3002 #, no-wrap msgid "" " char **\n" @@ -39500,69 +39512,69 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:2999 +#: docs/internal-documentation.pod:3005 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:3002 +#: docs/internal-documentation.pod:3008 msgid "Note (assuming C is C<:>):" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3006 +#: docs/internal-documentation.pod:3012 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3008 +#: docs/internal-documentation.pod:3014 msgid "aborts" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3010 +#: docs/internal-documentation.pod:3016 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3012 docs/internal-documentation.pod:3703 +#: docs/internal-documentation.pod:3018 docs/internal-documentation.pod:3709 msgid "returns C<[]>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3014 +#: docs/internal-documentation.pod:3020 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3016 +#: docs/internal-documentation.pod:3022 msgid "returns C<[\"abc\"]>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3018 +#: docs/internal-documentation.pod:3024 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3020 +#: docs/internal-documentation.pod:3026 msgid "returns C<[\"\", \"\"]>" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3024 +#: docs/internal-documentation.pod:3030 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3031 +#: docs/internal-documentation.pod:3037 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3033 +#: docs/internal-documentation.pod:3039 #, no-wrap msgid "" " char *\n" @@ -39572,7 +39584,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3036 +#: docs/internal-documentation.pod:3042 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 " @@ -39580,7 +39592,7 @@ msgid "" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3042 +#: docs/internal-documentation.pod:3048 #, no-wrap msgid "" " replace_string (\"abcabb\", \"ab\", \"a\");\n" @@ -39588,17 +39600,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3044 +#: docs/internal-documentation.pod:3050 msgid "would return C<\"acab\">." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3046 +#: docs/internal-documentation.pod:3052 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3048 +#: docs/internal-documentation.pod:3054 #, no-wrap msgid "" " char *\n" @@ -39608,17 +39620,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3052 +#: docs/internal-documentation.pod:3058 msgid "Translate a wait/system exit status into a printable string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3054 +#: docs/internal-documentation.pod:3060 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3056 +#: docs/internal-documentation.pod:3062 #, no-wrap msgid "" " int\n" @@ -39627,31 +39639,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3059 +#: docs/internal-documentation.pod:3065 msgid "Return a random string of characters." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3067 +#: docs/internal-documentation.pod:3073 msgid "" "The C buffer must have length C in order to store the final " "C<\\0> character." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3072 +#: docs/internal-documentation.pod:3078 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:3077 +#: docs/internal-documentation.pod:3083 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3079 +#: docs/internal-documentation.pod:3085 #, no-wrap msgid "" " char *\n" @@ -39660,12 +39672,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3082 +#: docs/internal-documentation.pod:3088 msgid "This turns a drive index (eg. C<27>) into a drive name (eg. C<\"ab\">)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3085 +#: docs/internal-documentation.pod:3091 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 " @@ -39673,17 +39685,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3089 +#: docs/internal-documentation.pod:3095 msgid "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3091 +#: docs/internal-documentation.pod:3097 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3093 +#: docs/internal-documentation.pod:3099 #, no-wrap msgid "" " ssize_t\n" @@ -39692,26 +39704,26 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3096 +#: docs/internal-documentation.pod:3102 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:3099 +#: docs/internal-documentation.pod:3105 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:3102 +#: docs/internal-documentation.pod:3108 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3104 +#: docs/internal-documentation.pod:3110 #, no-wrap msgid "" " int\n" @@ -39720,17 +39732,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3107 +#: docs/internal-documentation.pod:3113 msgid "Similar to C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3109 +#: docs/internal-documentation.pod:3115 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3111 +#: docs/internal-documentation.pod:3117 #, no-wrap msgid "" " bool\n" @@ -39741,7 +39753,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3116 +#: docs/internal-documentation.pod:3122 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_* " @@ -39749,63 +39761,63 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3121 +#: docs/internal-documentation.pod:3127 msgid "C is the string to check." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3123 +#: docs/internal-documentation.pod:3129 msgid "" "C and C are the minimum and maximum length checks. " "C<0> means no check." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3126 +#: docs/internal-documentation.pod:3132 msgid "The flags control:" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3130 +#: docs/internal-documentation.pod:3136 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3132 +#: docs/internal-documentation.pod:3138 msgid "7-bit ASCII-only alphabetic characters are permitted." msgstr "" #. type: =item -#: docs/internal-documentation.pod:3134 +#: docs/internal-documentation.pod:3140 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3136 +#: docs/internal-documentation.pod:3142 msgid "7-bit ASCII-only digits are permitted." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3140 +#: docs/internal-documentation.pod:3146 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:3143 +#: docs/internal-documentation.pod:3149 msgid "" "Returns boolean C if the string is valid (passes all the tests), or " "C if not." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3146 +#: docs/internal-documentation.pod:3152 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3148 +#: docs/internal-documentation.pod:3154 #, no-wrap msgid "" " void\n" @@ -39814,12 +39826,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3151 +#: docs/internal-documentation.pod:3157 msgid "Hint that we will read or write the file descriptor normally." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3153 +#: docs/internal-documentation.pod:3159 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 " @@ -39827,21 +39839,21 @@ msgid "" msgstr "" #. type: textblock -#: 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 +#: docs/internal-documentation.pod:3163 docs/internal-documentation.pod:3177 +#: docs/internal-documentation.pod:3204 docs/internal-documentation.pod:3216 +#: docs/internal-documentation.pod:3233 docs/internal-documentation.pod:3247 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:3160 +#: docs/internal-documentation.pod:3166 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3162 +#: docs/internal-documentation.pod:3168 #, no-wrap msgid "" " void\n" @@ -39850,12 +39862,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3165 +#: docs/internal-documentation.pod:3171 msgid "Hint that we will read or write the file descriptor sequentially." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3167 +#: docs/internal-documentation.pod:3173 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 " @@ -39863,12 +39875,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3174 +#: docs/internal-documentation.pod:3180 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3176 +#: docs/internal-documentation.pod:3182 #, no-wrap msgid "" " void\n" @@ -39877,24 +39889,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3179 +#: docs/internal-documentation.pod:3185 msgid "Hint that we will read or write the file descriptor randomly." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3181 +#: docs/internal-documentation.pod:3187 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:3188 +#: docs/internal-documentation.pod:3194 msgid "Disable normal sequential file readahead." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3192 +#: docs/internal-documentation.pod:3198 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 " @@ -39902,12 +39914,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3201 +#: docs/internal-documentation.pod:3207 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3203 +#: docs/internal-documentation.pod:3209 #, no-wrap msgid "" " void\n" @@ -39916,22 +39928,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3206 +#: docs/internal-documentation.pod:3212 msgid "Hint that we will access the data only once." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3208 +#: docs/internal-documentation.pod:3214 msgid "On Linux, this does nothing." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3213 +#: docs/internal-documentation.pod:3219 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3215 +#: docs/internal-documentation.pod:3221 #, no-wrap msgid "" " void\n" @@ -39940,12 +39952,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3218 +#: docs/internal-documentation.pod:3224 msgid "Hint that we will not access the data in the near future." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3220 +#: docs/internal-documentation.pod:3226 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 " @@ -39955,12 +39967,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3230 +#: docs/internal-documentation.pod:3236 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3232 +#: docs/internal-documentation.pod:3238 #, no-wrap msgid "" " void\n" @@ -39969,12 +39981,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3235 +#: docs/internal-documentation.pod:3241 msgid "Hint that we will access the data in the near future." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3237 +#: docs/internal-documentation.pod:3243 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 " @@ -39982,12 +39994,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3244 +#: docs/internal-documentation.pod:3250 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3246 +#: docs/internal-documentation.pod:3252 #, no-wrap msgid "" " char *\n" @@ -39996,12 +40008,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3249 +#: docs/internal-documentation.pod:3255 msgid "Unquote a shell-quoted string." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3251 +#: docs/internal-documentation.pod:3257 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 " @@ -40009,7 +40021,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3255 +#: docs/internal-documentation.pod:3261 msgid "" "Note this function does not do variable substitution, since that is " "impossible without knowing the file context and indeed the environment under " @@ -40018,7 +40030,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3260 +#: docs/internal-documentation.pod:3266 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 " @@ -40027,19 +40039,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3265 +#: docs/internal-documentation.pod:3271 msgid "" "For information on double-quoting in bash, see " "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3268 +#: docs/internal-documentation.pod:3274 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3270 +#: docs/internal-documentation.pod:3276 #, no-wrap msgid "" " int\n" @@ -40048,19 +40060,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3273 +#: docs/internal-documentation.pod:3279 msgid "" "Return true if the C or C C field " "represents a regular file." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3276 +#: docs/internal-documentation.pod:3282 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3278 +#: docs/internal-documentation.pod:3284 #, no-wrap msgid "" " int\n" @@ -40069,19 +40081,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3281 +#: docs/internal-documentation.pod:3287 msgid "" "Return true if the C or C C field " "represents a directory." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3284 +#: docs/internal-documentation.pod:3290 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3286 +#: docs/internal-documentation.pod:3292 #, no-wrap msgid "" " int\n" @@ -40090,19 +40102,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3289 +#: docs/internal-documentation.pod:3295 msgid "" "Return true if the C or C C field " "represents a char device." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3292 +#: docs/internal-documentation.pod:3298 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3294 +#: docs/internal-documentation.pod:3300 #, no-wrap msgid "" " int\n" @@ -40111,19 +40123,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3297 +#: docs/internal-documentation.pod:3303 msgid "" "Return true if the C or C C field " "represents a block device." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3300 +#: docs/internal-documentation.pod:3306 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3302 +#: docs/internal-documentation.pod:3308 #, no-wrap msgid "" " int\n" @@ -40132,19 +40144,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3305 +#: docs/internal-documentation.pod:3311 msgid "" "Return true if the C or C C field " "represents a named pipe (FIFO)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3308 +#: docs/internal-documentation.pod:3314 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3310 +#: docs/internal-documentation.pod:3316 #, no-wrap msgid "" " int\n" @@ -40153,19 +40165,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3313 +#: docs/internal-documentation.pod:3319 msgid "" "Return true if the C or C C field " "represents a symbolic link." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3316 +#: docs/internal-documentation.pod:3322 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3318 +#: docs/internal-documentation.pod:3324 #, no-wrap msgid "" " int\n" @@ -40174,19 +40186,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3321 +#: docs/internal-documentation.pod:3327 msgid "" "Return true if the C or C C field " "represents a Unix domain socket." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3324 +#: docs/internal-documentation.pod:3330 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3326 +#: docs/internal-documentation.pod:3332 #, no-wrap msgid "" " char *\n" @@ -40195,7 +40207,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3329 +#: docs/internal-documentation.pod:3335 msgid "" "Concatenate C and C to create a path. This correctly handles the " "case of concatenating C<\"/\" + \"filename\"> as well as C<\"/dir\" + " @@ -40203,22 +40215,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3333 +#: docs/internal-documentation.pod:3339 msgid "The caller must free the returned path." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3335 +#: docs/internal-documentation.pod:3341 msgid "This function sets C and returns C on error." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3337 +#: docs/internal-documentation.pod:3343 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3339 +#: docs/internal-documentation.pod:3345 #, no-wrap msgid "" " void\n" @@ -40227,17 +40239,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3342 +#: docs/internal-documentation.pod:3348 msgid "Hexdump a block of memory to C, used for debugging." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3344 +#: docs/internal-documentation.pod:3350 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3346 +#: docs/internal-documentation.pod:3352 #, no-wrap msgid "" " const char *\n" @@ -40246,19 +40258,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3349 +#: docs/internal-documentation.pod:3355 msgid "Thread-safe strerror_r." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3351 +#: docs/internal-documentation.pod:3357 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:3354 +#: docs/internal-documentation.pod:3360 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 " @@ -40266,36 +40278,36 @@ msgid "" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:3358 +#: docs/internal-documentation.pod:3364 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3360 +#: docs/internal-documentation.pod:3366 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3362 +#: docs/internal-documentation.pod:3368 msgid "" "This file contains a recursive function for visiting all files and " "directories in a guestfs filesystem." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3365 +#: docs/internal-documentation.pod:3371 msgid "" "Adapted from " "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3368 +#: docs/internal-documentation.pod:3374 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3370 +#: docs/internal-documentation.pod:3376 #, no-wrap msgid "" " int\n" @@ -40304,19 +40316,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3373 +#: docs/internal-documentation.pod:3379 msgid "Visit every file and directory in a guestfs filesystem, starting at C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3376 +#: docs/internal-documentation.pod:3382 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:3379 +#: docs/internal-documentation.pod:3385 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 " @@ -40327,14 +40339,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3387 +#: docs/internal-documentation.pod:3393 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:3390 +#: docs/internal-documentation.pod:3396 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 " @@ -40343,27 +40355,27 @@ msgid "" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:3395 +#: docs/internal-documentation.pod:3401 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3397 +#: docs/internal-documentation.pod:3403 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3399 +#: docs/internal-documentation.pod:3405 msgid "This file implements C Windows file path support in L." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3402 +#: docs/internal-documentation.pod:3408 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3404 +#: docs/internal-documentation.pod:3410 #, no-wrap msgid "" " int\n" @@ -40372,22 +40384,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3407 +#: docs/internal-documentation.pod:3413 msgid "Checks whether C is a Windows installation." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3409 +#: docs/internal-documentation.pod:3415 msgid "This relies on an already being done introspection." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3411 +#: docs/internal-documentation.pod:3417 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3413 +#: docs/internal-documentation.pod:3419 #, no-wrap msgid "" " char *\n" @@ -40397,58 +40409,58 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3416 +#: docs/internal-documentation.pod:3422 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:3425 +#: docs/internal-documentation.pod:3431 msgid "C must be a Windows installation" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3429 +#: docs/internal-documentation.pod:3435 msgid "relies on an already being done introspection" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3433 +#: docs/internal-documentation.pod:3439 msgid "" "will unmount all the existing mount points and mount the Windows root " "(according to C)" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3438 +#: docs/internal-documentation.pod:3444 msgid "calls L on memory allocation failures" msgstr "" #. type: =head2 -#: docs/internal-documentation.pod:3442 +#: docs/internal-documentation.pod:3448 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3444 +#: docs/internal-documentation.pod:3450 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3446 +#: docs/internal-documentation.pod:3452 msgid "" "This file contains a number of useful functions for running external " "commands and capturing their output." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3449 +#: docs/internal-documentation.pod:3455 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3451 +#: docs/internal-documentation.pod:3457 #, no-wrap msgid "" " int\n" @@ -40458,36 +40470,36 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3455 +#: docs/internal-documentation.pod:3461 msgid "Run a command. Optionally capture stdout and stderr as strings." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3457 +#: docs/internal-documentation.pod:3463 msgid "" "Returns C<0> if the command ran successfully, or C<-1> if there was any " "error." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3460 +#: docs/internal-documentation.pod:3466 msgid "For a description of the C see C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3462 +#: docs/internal-documentation.pod:3468 msgid "" "There is also a macro C which calls C " "with C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3465 +#: docs/internal-documentation.pod:3471 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3467 +#: docs/internal-documentation.pod:3473 #, no-wrap msgid "" " int\n" @@ -40497,31 +40509,31 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3471 +#: docs/internal-documentation.pod:3477 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:3474 +#: docs/internal-documentation.pod:3480 msgid "We still return C<-1> if there was some other error." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3476 +#: docs/internal-documentation.pod:3482 msgid "" "There is also a macro C which calls C " "with C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3479 +#: docs/internal-documentation.pod:3485 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3481 +#: docs/internal-documentation.pod:3487 #, no-wrap msgid "" " int\n" @@ -40531,24 +40543,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3485 +#: docs/internal-documentation.pod:3491 msgid "Same as C, but passing in an argv array." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3487 +#: docs/internal-documentation.pod:3493 msgid "" "There is also a macro C which calls C " "with C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3490 +#: docs/internal-documentation.pod:3496 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3492 +#: docs/internal-documentation.pod:3498 #, no-wrap msgid "" " int\n" @@ -40558,7 +40570,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3496 +#: docs/internal-documentation.pod:3502 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, " @@ -40566,14 +40578,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3501 +#: docs/internal-documentation.pod:3507 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:3504 +#: docs/internal-documentation.pod:3510 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 " @@ -40581,17 +40593,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3509 +#: docs/internal-documentation.pod:3515 msgid "Flags are:" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3513 +#: docs/internal-documentation.pod:3519 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3515 +#: docs/internal-documentation.pod:3521 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 " @@ -40601,12 +40613,12 @@ msgid "" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3521 +#: docs/internal-documentation.pod:3527 msgid "C" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3523 +#: docs/internal-documentation.pod:3529 msgid "" "For running external commands on chrooted files correctly (see " "L) specifying this flag causes another " @@ -40617,24 +40629,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3533 +#: docs/internal-documentation.pod:3539 msgid "" "There is also a macro C which calls C " "with C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3536 +#: docs/internal-documentation.pod:3542 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3538 +#: docs/internal-documentation.pod:3544 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3540 +#: docs/internal-documentation.pod:3546 #, no-wrap msgid "" " void\n" @@ -40643,12 +40655,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3543 +#: docs/internal-documentation.pod:3549 msgid "Cache daemon disk mapping." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3545 +#: docs/internal-documentation.pod:3551 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 " @@ -40656,12 +40668,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3549 +#: docs/internal-documentation.pod:3555 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3551 +#: docs/internal-documentation.pod:3557 #, no-wrap msgid "" " char *\n" @@ -40670,12 +40682,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3554 +#: docs/internal-documentation.pod:3560 msgid "Perform device name translation." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3556 +#: docs/internal-documentation.pod:3562 msgid "" "Libguestfs defines a few standard formats for device names. (see also " "L and " @@ -40683,22 +40695,22 @@ msgid "" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3562 +#: docs/internal-documentation.pod:3568 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3564 +#: docs/internal-documentation.pod:3570 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3566 +#: docs/internal-documentation.pod:3572 msgid "F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3568 +#: docs/internal-documentation.pod:3574 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 " @@ -40706,67 +40718,67 @@ msgid "" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3573 +#: docs/internal-documentation.pod:3579 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3575 +#: docs/internal-documentation.pod:3581 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3577 +#: docs/internal-documentation.pod:3583 msgid "F" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3579 fish/guestfish-actions.pod:1473 +#: docs/internal-documentation.pod:3585 fish/guestfish-actions.pod:1473 #: lib/guestfs-actions.pod:2489 msgid "F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3581 +#: docs/internal-documentation.pod:3587 msgid "These are not translated here." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3585 +#: docs/internal-documentation.pod:3591 msgid "It returns a newly allocated string which the caller must free." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3587 +#: docs/internal-documentation.pod:3593 msgid "It returns C on error. B it does I call C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3590 +#: docs/internal-documentation.pod:3596 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:3593 +#: docs/internal-documentation.pod:3599 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3595 +#: docs/internal-documentation.pod:3601 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:3598 +#: docs/internal-documentation.pod:3604 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3600 +#: docs/internal-documentation.pod:3606 #, no-wrap msgid "" " void\n" @@ -40775,17 +40787,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3603 +#: docs/internal-documentation.pod:3609 msgid "Write C to the file C, ensuring it is shell quoted." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3605 +#: docs/internal-documentation.pod:3611 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3607 +#: docs/internal-documentation.pod:3613 #, no-wrap msgid "" " void\n" @@ -40794,56 +40806,56 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3610 +#: docs/internal-documentation.pod:3616 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:3613 +#: docs/internal-documentation.pod:3619 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3615 +#: docs/internal-documentation.pod:3621 msgid "Internal functions that are not part of the public API." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3617 +#: docs/internal-documentation.pod:3623 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3619 +#: docs/internal-documentation.pod:3625 msgid "Bindings for utility functions." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3621 +#: docs/internal-documentation.pod:3627 msgid "" "Note that functions called from OCaml code B call any of the " "C functions." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3624 +#: docs/internal-documentation.pod:3630 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3626 +#: docs/internal-documentation.pod:3632 msgid "Miscellaneous utility functions used by the daemon." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3628 +#: docs/internal-documentation.pod:3634 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3630 +#: docs/internal-documentation.pod:3636 #, no-wrap msgid "" " static int\n" @@ -40852,19 +40864,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3633 +#: docs/internal-documentation.pod:3639 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:3636 +#: docs/internal-documentation.pod:3642 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3638 +#: docs/internal-documentation.pod:3644 #, no-wrap msgid "" " int\n" @@ -40873,26 +40885,26 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3641 +#: docs/internal-documentation.pod:3647 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:3645 +#: docs/internal-documentation.pod:3651 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:3648 +#: docs/internal-documentation.pod:3654 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3650 +#: docs/internal-documentation.pod:3656 #, no-wrap msgid "" " char *\n" @@ -40901,12 +40913,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3653 +#: docs/internal-documentation.pod:3659 msgid "Turn C<\"/path\"> into C<\"/sysroot/path\">." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3655 docs/internal-documentation.pod:3669 +#: docs/internal-documentation.pod:3661 docs/internal-documentation.pod:3675 msgid "" "Returns C on failure. The caller I check for this and call " "S>. The caller must also free the " @@ -40914,17 +40926,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3659 docs/internal-documentation.pod:3673 +#: docs/internal-documentation.pod:3665 docs/internal-documentation.pod:3679 msgid "See also the custom C<%R> printf formatter which does shell quoting too." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3661 +#: docs/internal-documentation.pod:3667 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3663 +#: docs/internal-documentation.pod:3669 #, no-wrap msgid "" " char *\n" @@ -40933,17 +40945,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3666 +#: docs/internal-documentation.pod:3672 msgid "Resolve path within sysroot, calling C on the resolved path." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3675 +#: docs/internal-documentation.pod:3681 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3677 +#: docs/internal-documentation.pod:3683 #, no-wrap msgid "" " int\n" @@ -40952,24 +40964,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3680 +#: docs/internal-documentation.pod:3686 msgid "Returns true if C is a power of 2." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3682 +#: docs/internal-documentation.pod:3688 msgid "" "Uses the algorithm described at " "L" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3685 +#: docs/internal-documentation.pod:3691 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3687 +#: docs/internal-documentation.pod:3693 #, no-wrap msgid "" " struct stringsbuf\n" @@ -40978,66 +40990,66 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3690 +#: docs/internal-documentation.pod:3696 msgid "" "Split an output string into a NULL-terminated list of lines, wrapped into a " "stringsbuf." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3693 +#: docs/internal-documentation.pod:3699 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:3697 +#: docs/internal-documentation.pod:3703 msgid "The corner cases here are quite tricky. Note in particular:" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3701 +#: docs/internal-documentation.pod:3707 msgid "C<\"\">" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3705 +#: docs/internal-documentation.pod:3711 msgid "C<\"\\n\">" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3707 +#: docs/internal-documentation.pod:3713 msgid "returns C<[\"\"]>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3709 +#: docs/internal-documentation.pod:3715 msgid "C<\"a\\nb\">" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3711 docs/internal-documentation.pod:3715 +#: docs/internal-documentation.pod:3717 docs/internal-documentation.pod:3721 msgid "returns C<[\"a\"; \"b\"]>" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3713 +#: docs/internal-documentation.pod:3719 msgid "C<\"a\\nb\\n\">" msgstr "" #. type: =item -#: docs/internal-documentation.pod:3717 +#: docs/internal-documentation.pod:3723 msgid "C<\"a\\nb\\n\\n\">" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3719 +#: docs/internal-documentation.pod:3725 msgid "returns C<[\"a\"; \"b\"; \"\"]>" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3723 +#: docs/internal-documentation.pod:3729 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 " @@ -41045,17 +41057,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3728 +#: docs/internal-documentation.pod:3734 msgid "C in the C will be C in case of errors." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3730 +#: docs/internal-documentation.pod:3736 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3732 +#: docs/internal-documentation.pod:3738 #, no-wrap msgid "" " char **\n" @@ -41064,24 +41076,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3735 +#: docs/internal-documentation.pod:3741 msgid "" "Filter a list of strings. Returns a newly allocated list of only the " "strings where C

." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3738 +#: docs/internal-documentation.pod:3744 msgid "B it does not copy the strings, be careful not to double-free them." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3741 +#: docs/internal-documentation.pod:3747 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3743 +#: docs/internal-documentation.pod:3749 #, no-wrap msgid "" " void\n" @@ -41090,17 +41102,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3746 +#: docs/internal-documentation.pod:3752 msgid "Skip leading and trailing whitespace, updating the original string in-place." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3749 +#: docs/internal-documentation.pod:3755 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3751 +#: docs/internal-documentation.pod:3757 #, no-wrap msgid "" " int\n" @@ -41109,19 +41121,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3754 +#: docs/internal-documentation.pod:3760 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:3757 +#: docs/internal-documentation.pod:3763 msgid "A btrfs subvolume is given as:" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3759 +#: docs/internal-documentation.pod:3765 #, no-wrap msgid "" " btrfsvol:/dev/sda3/root\n" @@ -41129,7 +41141,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3761 +#: docs/internal-documentation.pod:3767 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 " @@ -41137,19 +41149,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3765 +#: docs/internal-documentation.pod:3771 msgid "" "On success, Cdevice> and Cvolume> must be " "freed by the caller." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3768 +#: docs/internal-documentation.pod:3774 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3770 +#: docs/internal-documentation.pod:3776 #, no-wrap msgid "" " char *\n" @@ -41158,24 +41170,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3773 +#: docs/internal-documentation.pod:3779 msgid "Convert a C back to its string representation" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3775 +#: docs/internal-documentation.pod:3781 msgid "" "This function can be used in an error path, so must not call " "C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3778 +#: docs/internal-documentation.pod:3784 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3780 +#: docs/internal-documentation.pod:3786 #, no-wrap msgid "" " int\n" @@ -41184,17 +41196,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3783 +#: docs/internal-documentation.pod:3789 msgid "Check program exists and is executable on C<$PATH>." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3785 +#: docs/internal-documentation.pod:3791 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3787 +#: docs/internal-documentation.pod:3793 #, no-wrap msgid "" " int\n" @@ -41203,7 +41215,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3790 +#: docs/internal-documentation.pod:3796 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 " @@ -41211,7 +41223,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3795 +#: docs/internal-documentation.pod:3801 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 " @@ -41220,24 +41232,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3800 +#: docs/internal-documentation.pod:3806 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:3804 +#: docs/internal-documentation.pod:3810 msgid "If there is an error, C<-1> is returned." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3806 +#: docs/internal-documentation.pod:3812 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3808 +#: docs/internal-documentation.pod:3814 #, no-wrap msgid "" " void\n" @@ -41246,7 +41258,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3811 +#: docs/internal-documentation.pod:3817 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 " @@ -41255,19 +41267,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3816 +#: docs/internal-documentation.pod:3822 msgid "" "Use C after certain commands, but don't be too fussed if it " "fails." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3819 +#: docs/internal-documentation.pod:3825 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3821 +#: docs/internal-documentation.pod:3827 #, no-wrap msgid "" " char *\n" @@ -41276,26 +41288,26 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3824 +#: docs/internal-documentation.pod:3830 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:3828 +#: docs/internal-documentation.pod:3834 msgid "" "C is the function that invoked this helper, and it is used mainly " "for errors/debugging." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3831 +#: docs/internal-documentation.pod:3837 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3833 +#: docs/internal-documentation.pod:3839 #, no-wrap msgid "" " char *\n" @@ -41304,7 +41316,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3836 +#: docs/internal-documentation.pod:3842 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 " @@ -41312,17 +41324,17 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3841 +#: docs/internal-documentation.pod:3847 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3843 +#: docs/internal-documentation.pod:3849 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3845 +#: docs/internal-documentation.pod:3851 #, no-wrap msgid "" " static char **\n" @@ -41331,7 +41343,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3848 +#: docs/internal-documentation.pod:3854 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 " @@ -41339,39 +41351,39 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3852 +#: docs/internal-documentation.pod:3858 msgid "This function splits it into a regular list of strings." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3854 +#: docs/internal-documentation.pod:3860 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:3857 +#: docs/internal-documentation.pod:3863 msgid "Subdirectory F" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3859 +#: docs/internal-documentation.pod:3865 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3861 +#: docs/internal-documentation.pod:3867 msgid "This file implements the guestfish C and C commands." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3863 +#: docs/internal-documentation.pod:3869 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3865 +#: docs/internal-documentation.pod:3871 #, no-wrap msgid "" " int\n" @@ -41381,95 +41393,95 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3868 +#: docs/internal-documentation.pod:3874 msgid "" "This is the underlying allocation function. It's called from a few other " "places in guestfish." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3871 +#: docs/internal-documentation.pod:3877 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3873 +#: docs/internal-documentation.pod:3879 msgid "This file implements the guestfish commands C and C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3876 +#: docs/internal-documentation.pod:3882 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3878 +#: docs/internal-documentation.pod:3884 msgid "The file handles tab-completion of filesystem paths in guestfish." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3880 +#: docs/internal-documentation.pod:3886 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3882 +#: docs/internal-documentation.pod:3888 msgid "" "The file implements the guestfish C command, for displaying " "graphical files (icons, images) in disk images." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3885 +#: docs/internal-documentation.pod:3891 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3887 +#: docs/internal-documentation.pod:3893 msgid "The file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3889 +#: docs/internal-documentation.pod:3895 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3891 +#: docs/internal-documentation.pod:3897 msgid "guestfish C command, suggested by Ján Ondrej." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3893 +#: docs/internal-documentation.pod:3899 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3895 +#: docs/internal-documentation.pod:3901 msgid "" "This file implements the guestfish event-related commands, C, " "C and C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:3898 +#: docs/internal-documentation.pod:3904 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3900 +#: docs/internal-documentation.pod:3906 msgid "" "guestfish, the guest filesystem shell. This file contains the main loop and " "utilities." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3903 +#: docs/internal-documentation.pod:3909 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3905 +#: docs/internal-documentation.pod:3911 #, no-wrap msgid "" " static struct parsed_command\n" @@ -41478,46 +41490,46 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3908 +#: docs/internal-documentation.pod:3914 msgid "" "Parse a command string, splitting at whitespace, handling C<'!'>, C<'#'> " "etc. This destructively updates C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3911 +#: docs/internal-documentation.pod:3917 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:3915 +#: docs/internal-documentation.pod:3921 msgid "Returns in C:" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3921 +#: docs/internal-documentation.pod:3927 msgid "got a guestfish command (returned in C/C/C)" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3925 +#: docs/internal-documentation.pod:3931 msgid "no guestfish command, but otherwise OK" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3929 +#: docs/internal-documentation.pod:3935 msgid "an error" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3933 +#: docs/internal-documentation.pod:3939 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3935 +#: docs/internal-documentation.pod:3941 #, no-wrap msgid "" " static ssize_t\n" @@ -41526,7 +41538,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3938 +#: docs/internal-documentation.pod:3944 msgid "" "Parse double-quoted strings, replacing backslash escape sequences with the " "true character. Since the string is returned in place, the escapes must " @@ -41534,12 +41546,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3942 +#: docs/internal-documentation.pod:3948 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3944 +#: docs/internal-documentation.pod:3950 #, no-wrap msgid "" " static int\n" @@ -41548,17 +41560,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3947 +#: docs/internal-documentation.pod:3953 msgid "Used to handle C!> (execute command and inline result)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3949 +#: docs/internal-documentation.pod:3955 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3951 +#: docs/internal-documentation.pod:3957 #, no-wrap msgid "" " int\n" @@ -41568,12 +41580,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3955 +#: docs/internal-documentation.pod:3961 msgid "Run a command." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3957 +#: docs/internal-documentation.pod:3963 msgid "" "C is the C flag that we pass to the " "remote server (when issuing I<--remote> commands). It does not cause " @@ -41581,12 +41593,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3961 +#: docs/internal-documentation.pod:3967 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3963 +#: docs/internal-documentation.pod:3969 #, no-wrap msgid "" " void\n" @@ -41595,14 +41607,14 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3966 +#: docs/internal-documentation.pod:3972 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:3970 +#: docs/internal-documentation.pod:3976 #, no-wrap msgid "" " guestfish disk.img\n" @@ -41610,19 +41622,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3972 +#: docs/internal-documentation.pod:3978 msgid "" "expecting guestfish to open F (in fact, this tried to run a " "non-existent command C)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3975 +#: docs/internal-documentation.pod:3981 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3977 +#: docs/internal-documentation.pod:3983 #, no-wrap msgid "" " static void\n" @@ -41631,17 +41643,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3980 +#: docs/internal-documentation.pod:3986 msgid "Error callback. This replaces the standard libguestfs error handler." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3982 +#: docs/internal-documentation.pod:3988 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3984 +#: docs/internal-documentation.pod:3990 #, no-wrap msgid "" " static void\n" @@ -41650,17 +41662,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3987 +#: docs/internal-documentation.pod:3993 msgid "Free strings from a non-NULL terminated C." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3989 +#: docs/internal-documentation.pod:3995 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3991 +#: docs/internal-documentation.pod:3997 #, no-wrap msgid "" " static char *\n" @@ -41669,17 +41681,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:3994 +#: docs/internal-documentation.pod:4000 msgid "Decode C into the final printable prompt string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:3996 +#: docs/internal-documentation.pod:4002 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:3998 +#: docs/internal-documentation.pod:4004 #, no-wrap msgid "" " char *\n" @@ -41688,26 +41700,26 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4001 +#: docs/internal-documentation.pod:4007 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:4004 +#: docs/internal-documentation.pod:4010 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:4007 +#: docs/internal-documentation.pod:4013 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4009 +#: docs/internal-documentation.pod:4015 #, no-wrap msgid "" " char *\n" @@ -41716,24 +41728,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4012 +#: docs/internal-documentation.pod:4018 msgid "Resolve the special C paths (C<-> or C<-< or filename)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4014 +#: docs/internal-documentation.pod:4020 msgid "" "The caller (F) will call C after the command has " "run which should clean up resources." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4017 +#: docs/internal-documentation.pod:4023 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4019 +#: docs/internal-documentation.pod:4025 #, no-wrap msgid "" " char *\n" @@ -41742,24 +41754,24 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4022 +#: docs/internal-documentation.pod:4028 msgid "Resolve the special C paths (C<-> or filename)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4024 +#: docs/internal-documentation.pod:4030 msgid "" "The caller (F) will call S> after the command has " "run." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4027 +#: docs/internal-documentation.pod:4033 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4029 +#: docs/internal-documentation.pod:4035 #, no-wrap msgid "" " void\n" @@ -41771,27 +41783,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4035 +#: docs/internal-documentation.pod:4041 msgid "Callback which displays a progress bar." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4037 +#: docs/internal-documentation.pod:4043 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4039 +#: docs/internal-documentation.pod:4045 msgid "This file implements the guestfish C command." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4041 +#: docs/internal-documentation.pod:4047 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4043 +#: docs/internal-documentation.pod:4049 #, no-wrap msgid "" " static char **\n" @@ -41800,21 +41812,21 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4046 +#: docs/internal-documentation.pod:4052 msgid "" "Glob-expand device patterns, such as C " "(L)." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4049 +#: docs/internal-documentation.pod:4055 msgid "" "There is no C function because the equivalent " "can be implemented using functions like C." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4053 +#: docs/internal-documentation.pod:4059 msgid "" "It's not immediately clear what it means to expand a pattern like " "C. Should that include device name translation? Should the result " @@ -41822,43 +41834,43 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4057 +#: docs/internal-documentation.pod:4063 msgid "" "Should C<\"/dev/\"> + C<\"*\"> return every possible device and filesystem? " "How about VGs? LVs?" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4060 +#: docs/internal-documentation.pod:4066 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:4063 +#: docs/internal-documentation.pod:4069 msgid "Notes for future work (XXX):" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4069 +#: docs/internal-documentation.pod:4075 msgid "" "This doesn't handle device name translation. It wouldn't be too hard to " "add." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4074 +#: docs/internal-documentation.pod:4080 msgid "Could have an API function for returning all device-like things." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4078 +#: docs/internal-documentation.pod:4084 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4080 +#: docs/internal-documentation.pod:4086 #, no-wrap msgid "" " static int\n" @@ -41868,7 +41880,7 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4084 +#: docs/internal-documentation.pod:4090 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> " @@ -41876,12 +41888,12 @@ msgid "" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4089 +#: docs/internal-documentation.pod:4095 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4091 +#: docs/internal-documentation.pod:4097 #, no-wrap msgid "" " static char **\n" @@ -41890,27 +41902,27 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4094 +#: docs/internal-documentation.pod:4100 msgid "Return a single element list containing C." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4096 +#: docs/internal-documentation.pod:4102 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4098 +#: docs/internal-documentation.pod:4104 msgid "The file implements the guestfish C command." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4100 +#: docs/internal-documentation.pod:4106 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4102 +#: docs/internal-documentation.pod:4108 #, no-wrap msgid "" " int\n" @@ -41919,12 +41931,12 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4105 +#: docs/internal-documentation.pod:4111 msgid "The C command." msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4107 +#: docs/internal-documentation.pod:4113 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 " @@ -41933,27 +41945,27 @@ msgid "" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4112 +#: docs/internal-documentation.pod:4118 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4114 +#: docs/internal-documentation.pod:4120 msgid "This file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4116 +#: docs/internal-documentation.pod:4122 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4118 +#: docs/internal-documentation.pod:4124 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4120 +#: docs/internal-documentation.pod:4126 #, no-wrap msgid "" " int\n" @@ -41962,22 +41974,22 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4123 +#: docs/internal-documentation.pod:4129 msgid "guestfish C command (similar to the C command in BSD ftp)." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4125 +#: docs/internal-documentation.pod:4131 msgid "File F" msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4127 +#: docs/internal-documentation.pod:4133 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4129 +#: docs/internal-documentation.pod:4135 #, no-wrap msgid "" " int\n" @@ -41986,49 +41998,49 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4132 +#: docs/internal-documentation.pod:4138 msgid "guestfish C command" msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4134 +#: docs/internal-documentation.pod:4140 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4136 +#: docs/internal-documentation.pod:4142 msgid "This file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4138 +#: docs/internal-documentation.pod:4144 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4140 +#: docs/internal-documentation.pod:4146 msgid "" "This file implements the guestfish I<-N> option for creating pre-prepared " "disk layouts." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4143 +#: docs/internal-documentation.pod:4149 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4145 +#: docs/internal-documentation.pod:4151 msgid "This file implements guestfish remote (command) support." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4147 +#: docs/internal-documentation.pod:4153 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4149 +#: docs/internal-documentation.pod:4155 #, no-wrap msgid "" " void\n" @@ -42037,17 +42049,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4152 +#: docs/internal-documentation.pod:4158 msgid "The remote control server (ie. C)." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4154 +#: docs/internal-documentation.pod:4160 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4156 +#: docs/internal-documentation.pod:4162 #, no-wrap msgid "" " int\n" @@ -42057,59 +42069,59 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4160 +#: docs/internal-documentation.pod:4166 msgid "The remote control client (ie. C)." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4162 +#: docs/internal-documentation.pod:4168 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4164 +#: docs/internal-documentation.pod:4170 msgid "This file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4166 +#: docs/internal-documentation.pod:4172 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4168 +#: docs/internal-documentation.pod:4174 msgid "This file implements the guestfish C and C commands." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4171 +#: docs/internal-documentation.pod:4177 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4173 +#: docs/internal-documentation.pod:4179 msgid "This file implements the guestfish C command." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4175 +#: docs/internal-documentation.pod:4181 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4177 +#: docs/internal-documentation.pod:4183 msgid "" "This file implements tilde (C<~>) expansion of home directories in " "L." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4180 +#: docs/internal-documentation.pod:4186 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4182 +#: docs/internal-documentation.pod:4188 #, no-wrap msgid "" " char *\n" @@ -42118,19 +42130,19 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4185 +#: docs/internal-documentation.pod:4191 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:4188 +#: docs/internal-documentation.pod:4194 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4190 +#: docs/internal-documentation.pod:4196 #, no-wrap msgid "" " static char *\n" @@ -42139,17 +42151,17 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4193 +#: docs/internal-documentation.pod:4199 msgid "Return C<$HOME> + append string." msgstr "" #. type: =head4 -#: docs/internal-documentation.pod:4195 +#: docs/internal-documentation.pod:4201 msgid "Function C" msgstr "" #. type: verbatim -#: docs/internal-documentation.pod:4197 +#: docs/internal-documentation.pod:4203 #, no-wrap msgid "" " static const char *\n" @@ -42158,34 +42170,34 @@ msgid "" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4200 +#: docs/internal-documentation.pod:4206 msgid "" "Lookup C (of length C), return home directory if found, or " "C if not found." msgstr "" #. type: =head3 -#: docs/internal-documentation.pod:4203 +#: docs/internal-documentation.pod:4209 msgid "File F" msgstr "" #. type: textblock -#: docs/internal-documentation.pod:4205 +#: docs/internal-documentation.pod:4211 msgid "This file implements the guestfish C

. The list of filenames is written to the local file " @@ -54425,22 +54451,22 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5837 lib/guestfs-actions.pod:9391 +#: fish/guestfish-actions.pod:5841 lib/guestfs-actions.pod:9395 msgid "In the output file, the filenames are separated by C<\\0> characters." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5839 lib/guestfs-actions.pod:9393 +#: fish/guestfish-actions.pod:5843 lib/guestfs-actions.pod:9397 msgid "C<.> and C<..> are not returned. The filenames are not sorted." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5843 +#: fish/guestfish-actions.pod:5847 msgid "lsetxattr" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5845 +#: fish/guestfish-actions.pod:5849 #, no-wrap msgid "" " lsetxattr xattr val vallen path\n" @@ -54448,19 +54474,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5847 +#: fish/guestfish-actions.pod:5851 msgid "" "This is the same as L, but if C is a symbolic link, then it " "sets an extended attribute of the link itself." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5854 +#: fish/guestfish-actions.pod:5858 msgid "lstat" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5856 +#: fish/guestfish-actions.pod:5860 #, no-wrap msgid "" " lstat path\n" @@ -54468,40 +54494,40 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5858 fish/guestfish-actions.pod:5902 -#: fish/guestfish-actions.pod:9095 fish/guestfish-actions.pod:9110 -#: lib/guestfs-actions.pod:9432 lib/guestfs-actions.pod:9486 -#: lib/guestfs-actions.pod:14678 lib/guestfs-actions.pod:14694 +#: fish/guestfish-actions.pod:5862 fish/guestfish-actions.pod:5906 +#: fish/guestfish-actions.pod:9093 fish/guestfish-actions.pod:9108 +#: lib/guestfs-actions.pod:9436 lib/guestfs-actions.pod:9490 +#: lib/guestfs-actions.pod:14676 lib/guestfs-actions.pod:14692 msgid "Returns file information for the given C." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5860 +#: fish/guestfish-actions.pod:5864 msgid "" "This is the same as L except that if C is a symbolic link, then " "the link is stat-ed, not the file it refers to." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5864 fish/guestfish-actions.pod:5908 -#: lib/guestfs-actions.pod:9438 lib/guestfs-actions.pod:9492 +#: fish/guestfish-actions.pod:5868 fish/guestfish-actions.pod:5912 +#: lib/guestfs-actions.pod:9442 lib/guestfs-actions.pod:9496 msgid "This is the same as the L system call." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5866 +#: fish/guestfish-actions.pod:5870 msgid "" "I In new code, use the L call " "instead." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5873 +#: fish/guestfish-actions.pod:5877 msgid "lstatlist" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5875 +#: fish/guestfish-actions.pod:5879 #, no-wrap msgid "" " lstatlist path 'names ...'\n" @@ -54509,7 +54535,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5877 +#: fish/guestfish-actions.pod:5881 msgid "" "This call allows you to perform the L operation on multiple files, " "where all files are in the directory C. C is the list of files " @@ -54517,8 +54543,8 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5881 fish/guestfish-actions.pod:5918 -#: lib/guestfs-actions.pod:9464 lib/guestfs-actions.pod:9511 +#: fish/guestfish-actions.pod:5885 fish/guestfish-actions.pod:5922 +#: lib/guestfs-actions.pod:9468 lib/guestfs-actions.pod:9515 msgid "" "On return you get a list of stat structs, with a one-to-one correspondence " "to the C list. If any name did not exist or could not be lstat'd, " @@ -54526,7 +54552,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5886 fish/guestfish-actions.pod:5923 +#: fish/guestfish-actions.pod:5890 fish/guestfish-actions.pod:5927 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also L for a " @@ -54534,19 +54560,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5891 +#: fish/guestfish-actions.pod:5895 msgid "" "I In new code, use the L call " "instead." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5898 +#: fish/guestfish-actions.pod:5902 msgid "lstatns" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5900 +#: fish/guestfish-actions.pod:5904 #, no-wrap msgid "" " lstatns path\n" @@ -54554,19 +54580,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5904 +#: fish/guestfish-actions.pod:5908 msgid "" "This is the same as L except that if C is a symbolic link, " "then the link is stat-ed, not the file it refers to." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5910 +#: fish/guestfish-actions.pod:5914 msgid "lstatnslist" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5912 +#: fish/guestfish-actions.pod:5916 #, no-wrap msgid "" " lstatnslist path 'names ...'\n" @@ -54574,7 +54600,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5914 +#: fish/guestfish-actions.pod:5918 msgid "" "This call allows you to perform the L operation on multiple files, " "where all files are in the directory C. C is the list of files " @@ -54582,12 +54608,12 @@ msgid "" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5928 +#: fish/guestfish-actions.pod:5932 msgid "luks-add-key" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5930 +#: fish/guestfish-actions.pod:5934 #, no-wrap msgid "" " luks-add-key device keyslot\n" @@ -54595,7 +54621,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5932 lib/guestfs-actions.pod:9536 +#: fish/guestfish-actions.pod:5936 lib/guestfs-actions.pod:9540 msgid "" "This command adds a new key on LUKS device C. C is any " "existing key, and is used to access the device. C is the new key to " @@ -54603,19 +54629,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5937 +#: fish/guestfish-actions.pod:5941 msgid "" "Note that if C already contains a key, then this command will " "fail. You have to use L first to remove that key." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5947 +#: fish/guestfish-actions.pod:5951 msgid "luks-close" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5949 +#: fish/guestfish-actions.pod:5953 #, no-wrap msgid "" " luks-close device\n" @@ -54623,7 +54649,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5951 +#: fish/guestfish-actions.pod:5955 msgid "" "This closes a LUKS device that was created earlier by L or " "L. The C parameter must be the name of the LUKS " @@ -54632,19 +54658,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5957 +#: fish/guestfish-actions.pod:5961 msgid "" "I In new code, use the L " "call instead." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5967 +#: fish/guestfish-actions.pod:5971 msgid "luks-format" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5969 +#: fish/guestfish-actions.pod:5973 #, no-wrap msgid "" " luks-format device keyslot\n" @@ -54652,7 +54678,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5971 lib/guestfs-actions.pod:9590 +#: fish/guestfish-actions.pod:5975 lib/guestfs-actions.pod:9594 msgid "" "This command erases existing data on C and formats the device as a " "LUKS encrypted device. C is the initial key, which is added to key " @@ -54660,12 +54686,12 @@ msgid "" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5982 +#: fish/guestfish-actions.pod:5986 msgid "luks-format-cipher" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5984 +#: fish/guestfish-actions.pod:5988 #, no-wrap msgid "" " luks-format-cipher device keyslot cipher\n" @@ -54673,19 +54699,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5986 +#: fish/guestfish-actions.pod:5990 msgid "" "This command is the same as L but it also allows you to set " "the C used." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:5995 +#: fish/guestfish-actions.pod:5999 msgid "luks-kill-slot" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:5997 +#: fish/guestfish-actions.pod:6001 #, no-wrap msgid "" " luks-kill-slot device keyslot\n" @@ -54693,19 +54719,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:5999 lib/guestfs-actions.pod:9637 +#: fish/guestfish-actions.pod:6003 lib/guestfs-actions.pod:9641 msgid "" "This command deletes the key in key slot C from the encrypted LUKS " "device C. C must be one of the I keys." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6009 +#: fish/guestfish-actions.pod:6013 msgid "luks-open" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6011 +#: fish/guestfish-actions.pod:6015 #, no-wrap msgid "" " luks-open device mapname\n" @@ -54713,33 +54739,33 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6013 lib/guestfs-actions.pod:9667 +#: fish/guestfish-actions.pod:6017 lib/guestfs-actions.pod:9671 msgid "" "This command opens a block device which has been encrypted according to the " "Linux Unified Key Setup (LUKS) standard." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6018 lib/guestfs-actions.pod:9672 +#: fish/guestfish-actions.pod:6022 lib/guestfs-actions.pod:9676 msgid "" "The caller must supply one of the keys associated with the LUKS block " "device, in the C parameter." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6035 fish/guestfish-actions.pod:6055 +#: fish/guestfish-actions.pod:6039 fish/guestfish-actions.pod:6059 msgid "" "I In new code, use the L " "call instead." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6045 +#: fish/guestfish-actions.pod:6049 msgid "luks-open-ro" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6047 +#: fish/guestfish-actions.pod:6051 #, no-wrap msgid "" " luks-open-ro device mapname\n" @@ -54747,19 +54773,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6049 +#: fish/guestfish-actions.pod:6053 msgid "" "This is the same as L except that a read-only mapping is " "created." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6065 +#: fish/guestfish-actions.pod:6069 msgid "luks-uuid" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6067 +#: fish/guestfish-actions.pod:6071 #, no-wrap msgid "" " luks-uuid device\n" @@ -54767,17 +54793,17 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6069 lib/guestfs-actions.pod:9732 +#: fish/guestfish-actions.pod:6073 lib/guestfs-actions.pod:9736 msgid "This returns the UUID of the LUKS device C." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6074 +#: fish/guestfish-actions.pod:6078 msgid "lvcreate" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6076 +#: fish/guestfish-actions.pod:6080 #, no-wrap msgid "" " lvcreate logvol volgroup mbytes\n" @@ -54785,38 +54811,38 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6078 lib/guestfs-actions.pod:9750 +#: fish/guestfish-actions.pod:6082 lib/guestfs-actions.pod:9754 msgid "" "This creates an LVM logical volume called C on the volume group " "C, with C megabytes." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6081 fish/guestfish-actions.pod:6093 -#: fish/guestfish-actions.pod:6127 fish/guestfish-actions.pod:6174 -#: fish/guestfish-actions.pod:6187 fish/guestfish-actions.pod:6204 -#: fish/guestfish-actions.pod:6217 fish/guestfish-actions.pod:6232 -#: fish/guestfish-actions.pod:6242 fish/guestfish-actions.pod:7743 -#: fish/guestfish-actions.pod:7752 fish/guestfish-actions.pod:7763 -#: fish/guestfish-actions.pod:7777 fish/guestfish-actions.pod:7787 -#: fish/guestfish-actions.pod:7797 fish/guestfish-actions.pod:7812 -#: fish/guestfish-actions.pod:7822 fish/guestfish-actions.pod:9861 -#: fish/guestfish-actions.pod:9873 fish/guestfish-actions.pod:9882 -#: fish/guestfish-actions.pod:9891 fish/guestfish-actions.pod:9901 -#: fish/guestfish-actions.pod:9926 fish/guestfish-actions.pod:9950 -#: fish/guestfish-actions.pod:9971 fish/guestfish-actions.pod:9981 +#: fish/guestfish-actions.pod:6085 fish/guestfish-actions.pod:6097 +#: fish/guestfish-actions.pod:6131 fish/guestfish-actions.pod:6178 +#: fish/guestfish-actions.pod:6191 fish/guestfish-actions.pod:6208 +#: fish/guestfish-actions.pod:6221 fish/guestfish-actions.pod:6236 +#: fish/guestfish-actions.pod:6246 fish/guestfish-actions.pod:7747 +#: fish/guestfish-actions.pod:7756 fish/guestfish-actions.pod:7767 +#: fish/guestfish-actions.pod:7781 fish/guestfish-actions.pod:7791 +#: fish/guestfish-actions.pod:7801 fish/guestfish-actions.pod:7816 +#: fish/guestfish-actions.pod:7826 fish/guestfish-actions.pod:9859 +#: fish/guestfish-actions.pod:9871 fish/guestfish-actions.pod:9880 +#: fish/guestfish-actions.pod:9889 fish/guestfish-actions.pod:9899 +#: fish/guestfish-actions.pod:9924 fish/guestfish-actions.pod:9948 +#: fish/guestfish-actions.pod:9969 fish/guestfish-actions.pod:9979 msgid "" "This command depends on the feature C. See also " "L." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6084 +#: fish/guestfish-actions.pod:6088 msgid "lvcreate-free" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6086 +#: fish/guestfish-actions.pod:6090 #, no-wrap msgid "" " lvcreate-free logvol volgroup percent\n" @@ -54824,7 +54850,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6088 lib/guestfs-actions.pod:9768 +#: fish/guestfish-actions.pod:6092 lib/guestfs-actions.pod:9772 msgid "" "Create an LVM logical volume called F, using " "approximately C % of the free space remaining in the volume group. " @@ -54833,12 +54859,12 @@ msgid "" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6096 +#: fish/guestfish-actions.pod:6100 msgid "lvm-canonical-lv-name" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6098 +#: fish/guestfish-actions.pod:6102 #, no-wrap msgid "" " lvm-canonical-lv-name lvname\n" @@ -54846,7 +54872,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6100 lib/guestfs-actions.pod:9786 +#: fish/guestfish-actions.pod:6104 lib/guestfs-actions.pod:9790 msgid "" "This converts alternative naming schemes for LVs that you might find to the " "canonical name. For example, F is converted to " @@ -54854,24 +54880,24 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6104 lib/guestfs-actions.pod:9790 +#: fish/guestfish-actions.pod:6108 lib/guestfs-actions.pod:9794 msgid "" "This command returns an error if the C parameter does not refer to a " "logical volume. In this case errno will be set to C." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6108 +#: fish/guestfish-actions.pod:6112 msgid "See also L, L." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6110 +#: fish/guestfish-actions.pod:6114 msgid "lvm-clear-filter" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6112 +#: fish/guestfish-actions.pod:6116 #, no-wrap msgid "" " lvm-clear-filter\n" @@ -54879,25 +54905,25 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6114 +#: fish/guestfish-actions.pod:6118 msgid "" "This undoes the effect of L. LVM will be able to see every " "block device." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6117 fish/guestfish-actions.pod:6165 -#: lib/guestfs-actions.pod:9809 lib/guestfs-actions.pod:9874 +#: fish/guestfish-actions.pod:6121 fish/guestfish-actions.pod:6169 +#: lib/guestfs-actions.pod:9813 lib/guestfs-actions.pod:9878 msgid "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6120 +#: fish/guestfish-actions.pod:6124 msgid "lvm-remove-all" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6122 +#: fish/guestfish-actions.pod:6126 #, no-wrap msgid "" " lvm-remove-all\n" @@ -54905,19 +54931,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6124 lib/guestfs-actions.pod:9821 +#: fish/guestfish-actions.pod:6128 lib/guestfs-actions.pod:9825 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6130 +#: fish/guestfish-actions.pod:6134 msgid "lvm-scan" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6132 +#: fish/guestfish-actions.pod:6136 #, no-wrap msgid "" " lvm-scan true|false\n" @@ -54925,14 +54951,14 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6134 lib/guestfs-actions.pod:9837 +#: fish/guestfish-actions.pod:6138 lib/guestfs-actions.pod:9841 msgid "" "This scans all block devices and rebuilds the list of LVM physical volumes, " "volume groups and logical volumes." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6137 lib/guestfs-actions.pod:9840 +#: fish/guestfish-actions.pod:6141 lib/guestfs-actions.pod:9844 msgid "" "If the C parameter is C then newly found volume groups and " "logical volumes are activated, meaning the LV F devices become " @@ -54940,7 +54966,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6141 +#: fish/guestfish-actions.pod:6145 msgid "" "When a libguestfs handle is launched it scans for existing devices, so you " "do not normally need to use this API. However it is useful when you have " @@ -54949,12 +54975,12 @@ msgid "" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6147 +#: fish/guestfish-actions.pod:6151 msgid "lvm-set-filter" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6149 +#: fish/guestfish-actions.pod:6153 #, no-wrap msgid "" " lvm-set-filter 'devices ...'\n" @@ -54962,7 +54988,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6151 lib/guestfs-actions.pod:9860 +#: fish/guestfish-actions.pod:6155 lib/guestfs-actions.pod:9864 msgid "" "This sets the LVM device filter so that LVM will only be able to \"see\" the " "block devices in the list C, and will ignore all other attached " @@ -54970,7 +54996,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6155 lib/guestfs-actions.pod:9864 +#: fish/guestfish-actions.pod:6159 lib/guestfs-actions.pod:9868 msgid "" "Where disk image(s) contain duplicate PVs or VGs, this command is useful to " "get LVM to ignore the duplicates, otherwise LVM can get confused. Note also " @@ -54982,24 +55008,24 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6168 lib/guestfs-actions.pod:9877 +#: fish/guestfish-actions.pod:6172 lib/guestfs-actions.pod:9881 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6170 lib/guestfs-actions.pod:9879 +#: fish/guestfish-actions.pod:6174 lib/guestfs-actions.pod:9883 msgid "" "You cannot use this if any VG is currently in use (eg. contains a mounted " "filesystem), even if you are not filtering out that VG." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6177 +#: fish/guestfish-actions.pod:6181 msgid "lvremove" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6179 +#: fish/guestfish-actions.pod:6183 #, no-wrap msgid "" " lvremove device\n" @@ -55007,26 +55033,26 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6181 lib/guestfs-actions.pod:9896 +#: fish/guestfish-actions.pod:6185 lib/guestfs-actions.pod:9900 msgid "" "Remove an LVM logical volume C, where C is the path to the " "LV, such as F." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6184 lib/guestfs-actions.pod:9899 +#: fish/guestfish-actions.pod:6188 lib/guestfs-actions.pod:9903 msgid "" "You can also remove all LVs in a volume group by specifying the VG name, " "F." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6190 +#: fish/guestfish-actions.pod:6194 msgid "lvrename" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6192 +#: fish/guestfish-actions.pod:6196 #, no-wrap msgid "" " lvrename logvol newlogvol\n" @@ -55034,17 +55060,17 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6194 lib/guestfs-actions.pod:9916 +#: fish/guestfish-actions.pod:6198 lib/guestfs-actions.pod:9920 msgid "Rename a logical volume C with the new name C." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6196 +#: fish/guestfish-actions.pod:6200 msgid "lvresize" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6198 +#: fish/guestfish-actions.pod:6202 #, no-wrap msgid "" " lvresize device mbytes\n" @@ -55052,19 +55078,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6200 lib/guestfs-actions.pod:9929 +#: fish/guestfish-actions.pod:6204 lib/guestfs-actions.pod:9933 msgid "" "This resizes (expands or shrinks) an existing LVM logical volume to " "C. When reducing, data in the reduced part is lost." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6207 +#: fish/guestfish-actions.pod:6211 msgid "lvresize-free" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6209 +#: fish/guestfish-actions.pod:6213 #, no-wrap msgid "" " lvresize-free lv percent\n" @@ -55072,7 +55098,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6211 lib/guestfs-actions.pod:9947 +#: fish/guestfish-actions.pod:6215 lib/guestfs-actions.pod:9951 msgid "" "This expands an existing logical volume C so that it fills C % of " "the remaining free space in the volume group. Commonly you would call this " @@ -55081,12 +55107,12 @@ msgid "" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6220 +#: fish/guestfish-actions.pod:6224 msgid "lvs" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6222 +#: fish/guestfish-actions.pod:6226 #, no-wrap msgid "" " lvs\n" @@ -55094,31 +55120,31 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6224 lib/guestfs-actions.pod:9965 +#: fish/guestfish-actions.pod:6228 lib/guestfs-actions.pod:9969 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L command." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6227 lib/guestfs-actions.pod:9968 +#: fish/guestfish-actions.pod:6231 lib/guestfs-actions.pod:9972 msgid "" "This returns a list of the logical volume device names " "(eg. F)." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6230 +#: fish/guestfish-actions.pod:6234 msgid "See also L, L." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6235 +#: fish/guestfish-actions.pod:6239 msgid "lvs-full" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6237 +#: fish/guestfish-actions.pod:6241 #, no-wrap msgid "" " lvs-full\n" @@ -55126,19 +55152,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6239 lib/guestfs-actions.pod:9987 +#: fish/guestfish-actions.pod:6243 lib/guestfs-actions.pod:9991 msgid "" "List all the logical volumes detected. This is the equivalent of the " "L command. The \"full\" version includes all fields." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6245 +#: fish/guestfish-actions.pod:6249 msgid "lvuuid" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6247 +#: fish/guestfish-actions.pod:6251 #, no-wrap msgid "" " lvuuid device\n" @@ -55146,17 +55172,17 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6249 lib/guestfs-actions.pod:10005 +#: fish/guestfish-actions.pod:6253 lib/guestfs-actions.pod:10009 msgid "This command returns the UUID of the LVM LV C." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6251 +#: fish/guestfish-actions.pod:6255 msgid "lxattrlist" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6253 +#: fish/guestfish-actions.pod:6257 #, no-wrap msgid "" " lxattrlist path 'names ...'\n" @@ -55164,7 +55190,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6255 lib/guestfs-actions.pod:10019 +#: fish/guestfish-actions.pod:6259 lib/guestfs-actions.pod:10023 msgid "" "This call allows you to get the extended attributes of multiple files, where " "all files are in the directory C. C is the list of files from " @@ -55172,7 +55198,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6259 +#: fish/guestfish-actions.pod:6263 msgid "" "On return you get a flat list of xattr structs which must be interpreted " "sequentially. The first xattr struct always has a zero-length C. " @@ -55185,7 +55211,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6269 +#: fish/guestfish-actions.pod:6273 msgid "" "This call is intended for programs that want to efficiently list a directory " "contents without making many round-trips. See also L for a " @@ -55193,12 +55219,12 @@ msgid "" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6277 +#: fish/guestfish-actions.pod:6281 msgid "max-disks" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6279 +#: fish/guestfish-actions.pod:6283 #, no-wrap msgid "" " max-disks\n" @@ -55206,33 +55232,33 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6281 +#: fish/guestfish-actions.pod:6285 msgid "" "Return the maximum number of disks that may be added to a handle (eg. by " "L and similar calls)." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6284 lib/guestfs-actions.pod:10055 +#: fish/guestfish-actions.pod:6288 lib/guestfs-actions.pod:10059 msgid "" "This function was added in libguestfs 1.19.7. In previous versions of " "libguestfs the limit was 25." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6287 lib/guestfs-actions.pod:10058 +#: fish/guestfish-actions.pod:6291 lib/guestfs-actions.pod:10062 msgid "" "See L for additional information on this " "topic." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6290 +#: fish/guestfish-actions.pod:6294 msgid "md-create" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6292 +#: fish/guestfish-actions.pod:6296 #, no-wrap msgid "" " md-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] " @@ -55241,19 +55267,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6294 lib/guestfs-actions.pod:10084 +#: fish/guestfish-actions.pod:6298 lib/guestfs-actions.pod:10088 msgid "" "Create a Linux md (RAID) device named C on the devices in the list " "C." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6301 lib/guestfs-actions.pod:10091 +#: fish/guestfish-actions.pod:6305 lib/guestfs-actions.pod:10095 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6303 lib/guestfs-actions.pod:10093 +#: fish/guestfish-actions.pod:6307 lib/guestfs-actions.pod:10097 msgid "" "A bitmap of missing devices. If a bit is set it means that a missing device " "is added to the array. The least significant bit corresponds to the first " @@ -55261,93 +55287,93 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6307 lib/guestfs-actions.pod:10097 +#: fish/guestfish-actions.pod:6311 lib/guestfs-actions.pod:10101 msgid "As examples:" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6309 lib/guestfs-actions.pod:10099 +#: fish/guestfish-actions.pod:6313 lib/guestfs-actions.pod:10103 msgid "" "If C and C then the resulting " "array would be C<[EmissingE, \"/dev/sda\"]>." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6312 lib/guestfs-actions.pod:10102 +#: fish/guestfish-actions.pod:6316 lib/guestfs-actions.pod:10106 msgid "" "If C and C then the resulting " "array would be C<[\"/dev/sda\", EmissingE]>." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6315 lib/guestfs-actions.pod:10105 +#: fish/guestfish-actions.pod:6319 lib/guestfs-actions.pod:10109 msgid "This defaults to C<0> (no missing devices)." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6317 lib/guestfs-actions.pod:10107 +#: fish/guestfish-actions.pod:6321 lib/guestfs-actions.pod:10111 msgid "" "The length of C + the number of bits set in C must " "equal C + C." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6320 lib/guestfs-actions.pod:10110 +#: fish/guestfish-actions.pod:6324 lib/guestfs-actions.pod:10114 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6322 lib/guestfs-actions.pod:10112 +#: fish/guestfish-actions.pod:6326 lib/guestfs-actions.pod:10116 msgid "The number of active RAID devices." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6324 lib/guestfs-actions.pod:10114 +#: fish/guestfish-actions.pod:6328 lib/guestfs-actions.pod:10118 msgid "" "If not set, this defaults to the length of C plus the number of " "bits set in C." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6327 lib/guestfs-actions.pod:10117 +#: fish/guestfish-actions.pod:6331 lib/guestfs-actions.pod:10121 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6329 lib/guestfs-actions.pod:10119 +#: fish/guestfish-actions.pod:6333 lib/guestfs-actions.pod:10123 msgid "The number of spare devices." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6331 lib/guestfs-actions.pod:10121 +#: fish/guestfish-actions.pod:6335 lib/guestfs-actions.pod:10125 msgid "If not set, this defaults to C<0>." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6333 lib/guestfs-actions.pod:10123 +#: fish/guestfish-actions.pod:6337 lib/guestfs-actions.pod:10127 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6335 lib/guestfs-actions.pod:10125 +#: fish/guestfish-actions.pod:6339 lib/guestfs-actions.pod:10129 msgid "The chunk size in bytes." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6337 lib/guestfs-actions.pod:10127 +#: fish/guestfish-actions.pod:6341 lib/guestfs-actions.pod:10131 msgid "" "The C parameter does not make sense, and should not be specified, " "when C is C (which is the default; see below)." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6340 fish/guestfish-actions.pod:6366 -#: lib/guestfs-actions.pod:10130 lib/guestfs-actions.pod:10184 +#: fish/guestfish-actions.pod:6344 fish/guestfish-actions.pod:6370 +#: lib/guestfs-actions.pod:10134 lib/guestfs-actions.pod:10188 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6342 lib/guestfs-actions.pod:10132 +#: fish/guestfish-actions.pod:6346 lib/guestfs-actions.pod:10136 msgid "" "The RAID level, which can be one of: C, C, C<0>, C, " "C, C<1>, C, C, C<4>, C, C<5>, C, C<6>, " @@ -55356,25 +55382,25 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6347 lib/guestfs-actions.pod:10137 +#: fish/guestfish-actions.pod:6351 lib/guestfs-actions.pod:10141 msgid "If not set, this defaults to C." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6353 fish/guestfish-actions.pod:6388 -#: fish/guestfish-actions.pod:6440 fish/guestfish-actions.pod:6450 +#: fish/guestfish-actions.pod:6357 fish/guestfish-actions.pod:6392 +#: fish/guestfish-actions.pod:6444 fish/guestfish-actions.pod:6454 msgid "" "This command depends on the feature C. See also " "L." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6356 +#: fish/guestfish-actions.pod:6360 msgid "md-detail" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6358 +#: fish/guestfish-actions.pod:6362 #, no-wrap msgid "" " md-detail md\n" @@ -55382,7 +55408,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6360 lib/guestfs-actions.pod:10178 +#: fish/guestfish-actions.pod:6364 lib/guestfs-actions.pod:10182 msgid "" "This command exposes the output of CmdE>. The following " "fields are usually present in the returned hash. Other fields may also be " @@ -55390,52 +55416,52 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6368 lib/guestfs-actions.pod:10186 +#: fish/guestfish-actions.pod:6372 lib/guestfs-actions.pod:10190 msgid "The raid level of the MD device." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6370 lib/guestfs-actions.pod:10188 +#: fish/guestfish-actions.pod:6374 lib/guestfs-actions.pod:10192 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6372 lib/guestfs-actions.pod:10190 +#: fish/guestfish-actions.pod:6376 lib/guestfs-actions.pod:10194 msgid "The number of underlying devices in the MD device." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6374 lib/guestfs-actions.pod:10192 +#: fish/guestfish-actions.pod:6378 lib/guestfs-actions.pod:10196 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6376 lib/guestfs-actions.pod:10194 +#: fish/guestfish-actions.pod:6380 lib/guestfs-actions.pod:10198 msgid "The metadata version used." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6378 lib/guestfs-actions.pod:10196 +#: fish/guestfish-actions.pod:6382 lib/guestfs-actions.pod:10200 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6380 lib/guestfs-actions.pod:10198 +#: fish/guestfish-actions.pod:6384 lib/guestfs-actions.pod:10202 msgid "The UUID of the MD device." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6384 lib/guestfs-actions.pod:10202 +#: fish/guestfish-actions.pod:6388 lib/guestfs-actions.pod:10206 msgid "The name of the MD device." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6391 +#: fish/guestfish-actions.pod:6395 msgid "md-stat" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6393 +#: fish/guestfish-actions.pod:6397 #, no-wrap msgid "" " md-stat md\n" @@ -55443,103 +55469,103 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6395 lib/guestfs-actions.pod:10223 +#: fish/guestfish-actions.pod:6399 lib/guestfs-actions.pod:10227 msgid "" "This call returns a list of the underlying devices which make up the single " "software RAID array device C." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6398 +#: fish/guestfish-actions.pod:6402 msgid "To get a list of software RAID devices, call L." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6400 lib/guestfs-actions.pod:10228 +#: fish/guestfish-actions.pod:6404 lib/guestfs-actions.pod:10232 msgid "" "Each structure returned corresponds to one device along with additional " "status information:" msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6405 lib/guestfs-actions.pod:10233 +#: fish/guestfish-actions.pod:6409 lib/guestfs-actions.pod:10237 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6407 lib/guestfs-actions.pod:10235 +#: fish/guestfish-actions.pod:6411 lib/guestfs-actions.pod:10239 msgid "The name of the underlying device." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6409 lib/guestfs-actions.pod:10237 +#: fish/guestfish-actions.pod:6413 lib/guestfs-actions.pod:10241 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6411 lib/guestfs-actions.pod:10239 +#: fish/guestfish-actions.pod:6415 lib/guestfs-actions.pod:10243 msgid "The index of this device within the array." msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6413 lib/guestfs-actions.pod:10241 +#: fish/guestfish-actions.pod:6417 lib/guestfs-actions.pod:10245 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6415 lib/guestfs-actions.pod:10243 +#: fish/guestfish-actions.pod:6419 lib/guestfs-actions.pod:10247 msgid "" "Flags associated with this device. This is a string containing (in no " "specific order) zero or more of the following flags:" msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6420 lib/guestfs-actions.pod:10248 +#: fish/guestfish-actions.pod:6424 lib/guestfs-actions.pod:10252 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6422 lib/guestfs-actions.pod:10250 +#: fish/guestfish-actions.pod:6426 lib/guestfs-actions.pod:10254 msgid "write-mostly" msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6424 lib/guestfs-actions.pod:10252 +#: fish/guestfish-actions.pod:6428 lib/guestfs-actions.pod:10256 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6426 lib/guestfs-actions.pod:10254 +#: fish/guestfish-actions.pod:6430 lib/guestfs-actions.pod:10258 msgid "device is faulty" msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6428 lib/guestfs-actions.pod:10256 +#: fish/guestfish-actions.pod:6432 lib/guestfs-actions.pod:10260 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6430 lib/guestfs-actions.pod:10258 +#: fish/guestfish-actions.pod:6434 lib/guestfs-actions.pod:10262 msgid "device is a RAID spare" msgstr "" #. type: =item -#: fish/guestfish-actions.pod:6432 lib/guestfs-actions.pod:10260 +#: fish/guestfish-actions.pod:6436 lib/guestfs-actions.pod:10264 msgid "C" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6434 lib/guestfs-actions.pod:10262 +#: fish/guestfish-actions.pod:6438 lib/guestfs-actions.pod:10266 msgid "replacement" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6443 +#: fish/guestfish-actions.pod:6447 msgid "md-stop" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6445 +#: fish/guestfish-actions.pod:6449 #, no-wrap msgid "" " md-stop md\n" @@ -55547,19 +55573,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6447 lib/guestfs-actions.pod:10283 +#: fish/guestfish-actions.pod:6451 lib/guestfs-actions.pod:10287 msgid "" "This command deactivates the MD array named C. The device is stopped, " "but it is not destroyed or zeroed." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6453 +#: fish/guestfish-actions.pod:6457 msgid "mkdir" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6455 +#: fish/guestfish-actions.pod:6459 #, no-wrap msgid "" " mkdir path\n" @@ -55567,17 +55593,17 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6457 lib/guestfs-actions.pod:10299 +#: fish/guestfish-actions.pod:6461 lib/guestfs-actions.pod:10303 msgid "Create a directory named C." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6459 +#: fish/guestfish-actions.pod:6463 msgid "mkdir-mode" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6461 +#: fish/guestfish-actions.pod:6465 #, no-wrap msgid "" " mkdir-mode path mode\n" @@ -55585,14 +55611,14 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6463 lib/guestfs-actions.pod:10312 +#: fish/guestfish-actions.pod:6467 lib/guestfs-actions.pod:10316 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6466 lib/guestfs-actions.pod:10315 +#: fish/guestfish-actions.pod:6470 lib/guestfs-actions.pod:10319 msgid "" "For common Linux filesystems, the actual mode which is set will be C. Non-native-Linux filesystems may interpret the mode in " @@ -55600,17 +55626,17 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6470 +#: fish/guestfish-actions.pod:6474 msgid "See also L, L" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6472 +#: fish/guestfish-actions.pod:6476 msgid "mkdir-p" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6474 +#: fish/guestfish-actions.pod:6478 #, no-wrap msgid "" " mkdir-p path\n" @@ -55618,19 +55644,19 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6476 lib/guestfs-actions.pod:10331 +#: fish/guestfish-actions.pod:6480 lib/guestfs-actions.pod:10335 msgid "" "Create a directory named C, creating any parent directories as " "necessary. This is like the C shell command." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6479 +#: fish/guestfish-actions.pod:6483 msgid "mkdtemp" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6481 +#: fish/guestfish-actions.pod:6485 #, no-wrap msgid "" " mkdtemp tmpl\n" @@ -55638,7 +55664,7 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6483 lib/guestfs-actions.pod:10344 +#: fish/guestfish-actions.pod:6487 lib/guestfs-actions.pod:10348 msgid "" "This command creates a temporary directory. The C parameter should be " "a full pathname for the temporary directory name with the final six " @@ -55646,42 +55672,42 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6488 fish/guestfish-actions.pod:6920 -#: lib/guestfs-actions.pod:10349 lib/guestfs-actions.pod:11167 +#: fish/guestfish-actions.pod:6492 fish/guestfish-actions.pod:6924 +#: lib/guestfs-actions.pod:10353 lib/guestfs-actions.pod:11171 msgid "" "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one " "being suitable for Windows filesystems." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6491 lib/guestfs-actions.pod:10352 +#: fish/guestfish-actions.pod:6495 lib/guestfs-actions.pod:10356 msgid "The name of the temporary directory that was created is returned." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6494 lib/guestfs-actions.pod:10355 +#: fish/guestfish-actions.pod:6498 lib/guestfs-actions.pod:10359 msgid "The temporary directory is created with mode 0700 and is owned by root." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6497 lib/guestfs-actions.pod:10358 +#: fish/guestfish-actions.pod:6501 lib/guestfs-actions.pod:10362 msgid "" "The caller is responsible for deleting the temporary directory and its " "contents after use." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6500 lib/guestfs-actions.pod:10361 +#: fish/guestfish-actions.pod:6504 lib/guestfs-actions.pod:10365 msgid "See also: L" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6502 +#: fish/guestfish-actions.pod:6506 msgid "mke2fs" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6504 +#: fish/guestfish-actions.pod:6508 #, no-wrap msgid "" " mke2fs device [blockscount:N] [blocksize:N] [fragsize:N] [blockspergroup:N] " @@ -55699,12 +55725,12 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6506 lib/guestfs-actions.pod:10419 +#: fish/guestfish-actions.pod:6510 lib/guestfs-actions.pod:10423 msgid "C is used to create an ext2, ext3, or ext4 filesystem on C." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6509 lib/guestfs-actions.pod:10422 +#: fish/guestfish-actions.pod:6513 lib/guestfs-actions.pod:10426 msgid "" "The optional C is the size of the filesystem in blocks. If " "omitted it defaults to the size of C. Note if the filesystem is too " @@ -55713,12 +55739,12 @@ msgid "" msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6516 +#: fish/guestfish-actions.pod:6520 msgid "mke2fs-J" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6518 +#: fish/guestfish-actions.pod:6522 #, no-wrap msgid "" " mke2fs-J fstype blocksize device journal\n" @@ -55726,14 +55752,14 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6520 lib/guestfs-actions.pod:10469 +#: fish/guestfish-actions.pod:6524 lib/guestfs-actions.pod:10473 msgid "" "This creates an ext2/3/4 filesystem on C with an external journal on " "C. It is equivalent to the command:" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6524 lib/guestfs-actions.pod:10473 +#: fish/guestfish-actions.pod:6528 lib/guestfs-actions.pod:10477 #, no-wrap msgid "" " mke2fs -t fstype -b blocksize -J device= \n" @@ -55741,26 +55767,26 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6526 +#: fish/guestfish-actions.pod:6530 msgid "See also L." msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6528 fish/guestfish-actions.pod:6544 -#: fish/guestfish-actions.pod:6560 fish/guestfish-actions.pod:6579 -#: fish/guestfish-actions.pod:6592 fish/guestfish-actions.pod:6605 +#: fish/guestfish-actions.pod:6532 fish/guestfish-actions.pod:6548 +#: fish/guestfish-actions.pod:6564 fish/guestfish-actions.pod:6583 +#: fish/guestfish-actions.pod:6596 fish/guestfish-actions.pod:6609 msgid "" "I In new code, use the L call " "instead." msgstr "" #. type: =head2 -#: fish/guestfish-actions.pod:6535 +#: fish/guestfish-actions.pod:6539 msgid "mke2fs-JL" msgstr "" #. type: verbatim -#: fish/guestfish-actions.pod:6537 +#: fish/guestfish-actions.pod:6541 #, no-wrap msgid "" " mke2fs-JL fstype blocksize device label\n" @@ -55768,24 +55794,24 @@ msgid "" msgstr "" #. type: textblock -#: fish/guestfish-actions.pod:6539 lib/guestfs-actions.pod:10497 +#: fish/guestfish-actions.pod:6543 lib/guestfs-actions.pod:10501 msgid "" "This creates an ext2/3/4 filesystem on C with an external journal on " "the journal labeled C