X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=po-docs%2Flibguestfs-docs.pot;h=34ee739c3b4fb7a3d6b20ce0ceae069cf19d245e;hb=50e59c237081b2bda36e5a04ecdf446a7fc3ec4c;hp=7a28bdd2302027d533ad9c70eb3902ecbb2014ae;hpb=c3fc40d0c5b5b4667137d07aaecefe8554b90f1b;p=libguestfs.git diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot index 7a28bdd..34ee739 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.9.14\n" +"Project-Id-Version: libguestfs 1.9.15\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-03-28 17:11+0200\n" +"POT-Creation-Date: 2011-04-01 09:14+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -807,7 +807,7 @@ msgid "There are many limitations to this:" msgstr "" #. type: =item -#: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1088 ../src/guestfs.pod:1092 ../src/guestfs.pod:1096 ../src/guestfs.pod:1101 ../src/guestfs.pod:1109 ../src/guestfs.pod:1128 ../src/guestfs.pod:1136 ../src/guestfs.pod:1158 ../src/guestfs.pod:1162 ../src/guestfs.pod:1166 ../src/guestfs.pod:1170 ../src/guestfs.pod:1174 ../src/guestfs.pod:1178 ../src/guestfs.pod:1660 ../src/guestfs.pod:1665 ../src/guestfs.pod:1669 ../src/guestfs.pod:1770 ../src/guestfs.pod:1775 ../src/guestfs.pod:1779 ../src/guestfs.pod:2008 ../src/guestfs.pod:2013 ../src/guestfs.pod:2019 ../src/guestfs.pod:2027 ../src/guestfs.pod:2381 ../src/guestfs.pod:2387 ../src/guestfs.pod:2392 ../src/guestfs.pod:2398 ../src/guestfs.pod:2863 ../src/guestfs.pod:2867 ../src/guestfs.pod:2871 ../src/guestfs.pod:2875 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:577 ../src/guestfs-actions.pod:585 ../src/guestfs-actions.pod:592 ../src/guestfs-actions.pod:599 ../src/guestfs-actions.pod:1595 ../src/guestfs-actions.pod:1599 ../src/guestfs-actions.pod:1603 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1615 ../src/guestfs-actions.pod:1619 ../src/guestfs-actions.pod:1623 ../src/guestfs-actions.pod:1633 ../src/guestfs-actions.pod:1637 ../src/guestfs-actions.pod:1641 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1783 ../src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:1793 ../src/guestfs-actions.pod:1854 ../src/guestfs-actions.pod:1858 ../src/guestfs-actions.pod:1863 ../fish/guestfish.pod:441 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:380 ../fish/guestfish-actions.pod:388 ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:402 ../fish/guestfish-actions.pod:1072 ../fish/guestfish-actions.pod:1076 ../fish/guestfish-actions.pod:1080 ../fish/guestfish-actions.pod:1084 ../fish/guestfish-actions.pod:1092 ../fish/guestfish-actions.pod:1096 ../fish/guestfish-actions.pod:1100 ../fish/guestfish-actions.pod:1110 ../fish/guestfish-actions.pod:1114 ../fish/guestfish-actions.pod:1118 ../fish/guestfish-actions.pod:1208 ../fish/guestfish-actions.pod:1212 ../fish/guestfish-actions.pod:1217 ../fish/guestfish-actions.pod:1222 ../fish/guestfish-actions.pod:1264 ../fish/guestfish-actions.pod:1268 ../fish/guestfish-actions.pod:1273 ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542 ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345 ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360 +#: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1088 ../src/guestfs.pod:1092 ../src/guestfs.pod:1096 ../src/guestfs.pod:1101 ../src/guestfs.pod:1109 ../src/guestfs.pod:1128 ../src/guestfs.pod:1136 ../src/guestfs.pod:1158 ../src/guestfs.pod:1162 ../src/guestfs.pod:1166 ../src/guestfs.pod:1170 ../src/guestfs.pod:1174 ../src/guestfs.pod:1178 ../src/guestfs.pod:1660 ../src/guestfs.pod:1665 ../src/guestfs.pod:1669 ../src/guestfs.pod:1770 ../src/guestfs.pod:1775 ../src/guestfs.pod:1779 ../src/guestfs.pod:2008 ../src/guestfs.pod:2013 ../src/guestfs.pod:2019 ../src/guestfs.pod:2027 ../src/guestfs.pod:2381 ../src/guestfs.pod:2387 ../src/guestfs.pod:2392 ../src/guestfs.pod:2398 ../src/guestfs.pod:2863 ../src/guestfs.pod:2867 ../src/guestfs.pod:2871 ../src/guestfs.pod:2875 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:577 ../src/guestfs-actions.pod:585 ../src/guestfs-actions.pod:592 ../src/guestfs-actions.pod:599 ../src/guestfs-actions.pod:1595 ../src/guestfs-actions.pod:1599 ../src/guestfs-actions.pod:1603 ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1615 ../src/guestfs-actions.pod:1619 ../src/guestfs-actions.pod:1623 ../src/guestfs-actions.pod:1633 ../src/guestfs-actions.pod:1637 ../src/guestfs-actions.pod:1641 ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1783 ../src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:1793 ../src/guestfs-actions.pod:1854 ../src/guestfs-actions.pod:1858 ../src/guestfs-actions.pod:1863 ../fish/guestfish.pod:443 ../fish/guestfish.pod:447 ../fish/guestfish.pod:451 ../fish/guestfish.pod:455 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:380 ../fish/guestfish-actions.pod:388 ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:402 ../fish/guestfish-actions.pod:1072 ../fish/guestfish-actions.pod:1076 ../fish/guestfish-actions.pod:1080 ../fish/guestfish-actions.pod:1084 ../fish/guestfish-actions.pod:1092 ../fish/guestfish-actions.pod:1096 ../fish/guestfish-actions.pod:1100 ../fish/guestfish-actions.pod:1110 ../fish/guestfish-actions.pod:1114 ../fish/guestfish-actions.pod:1118 ../fish/guestfish-actions.pod:1208 ../fish/guestfish-actions.pod:1212 ../fish/guestfish-actions.pod:1217 ../fish/guestfish-actions.pod:1222 ../fish/guestfish-actions.pod:1264 ../fish/guestfish-actions.pod:1268 ../fish/guestfish-actions.pod:1273 ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542 ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345 ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360 msgid "*" msgstr "" @@ -1045,7 +1045,7 @@ msgid "For more information about umask, see L." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:519 ../fish/guestfish.pod:760 +#: ../src/guestfs.pod:519 ../fish/guestfish.pod:765 msgid "ENCRYPTED DISKS" msgstr "" @@ -2889,7 +2889,7 @@ msgid "API CALLS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:1491 ../fish/guestfish.pod:998 +#: ../src/guestfs.pod:1491 ../fish/guestfish.pod:1003 msgid "@ACTIONS@" msgstr "" @@ -4963,7 +4963,7 @@ msgid "" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2613 ../fish/guestfish.pod:240 ../fish/guestfish.pod:608 +#: ../src/guestfs.pod:2613 ../fish/guestfish.pod:240 ../fish/guestfish.pod:613 msgid "For example:" msgstr "" @@ -5308,22 +5308,22 @@ msgid "Language bindings." msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2762 ../fish/guestfish.pod:1005 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:330 +#: ../src/guestfs.pod:2762 ../fish/guestfish.pod:1010 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:330 msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: =item -#: ../src/guestfs.pod:2766 ../fish/guestfish.pod:1031 +#: ../src/guestfs.pod:2766 ../fish/guestfish.pod:1036 msgid "LIBGUESTFS_APPEND" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2768 ../fish/guestfish.pod:1033 +#: ../src/guestfs.pod:2768 ../fish/guestfish.pod:1038 msgid "Pass additional options to the guest kernel." msgstr "" #. type: =item -#: ../src/guestfs.pod:2770 ../fish/guestfish.pod:1035 +#: ../src/guestfs.pod:2770 ../fish/guestfish.pod:1040 msgid "LIBGUESTFS_DEBUG" msgstr "" @@ -5335,17 +5335,17 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2775 ../fish/guestfish.pod:1040 +#: ../src/guestfs.pod:2775 ../fish/guestfish.pod:1045 msgid "LIBGUESTFS_MEMSIZE" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2777 ../fish/guestfish.pod:1042 +#: ../src/guestfs.pod:2777 ../fish/guestfish.pod:1047 msgid "Set the memory allocated to the qemu process, in megabytes. For example:" msgstr "" #. type: verbatim -#: ../src/guestfs.pod:2780 ../fish/guestfish.pod:1045 +#: ../src/guestfs.pod:2780 ../fish/guestfish.pod:1050 #, no-wrap msgid "" " LIBGUESTFS_MEMSIZE=700\n" @@ -5353,7 +5353,7 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2782 ../fish/guestfish.pod:1047 +#: ../src/guestfs.pod:2782 ../fish/guestfish.pod:1052 msgid "LIBGUESTFS_PATH" msgstr "" @@ -5365,12 +5365,12 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2787 ../fish/guestfish.pod:1052 +#: ../src/guestfs.pod:2787 ../fish/guestfish.pod:1057 msgid "LIBGUESTFS_QEMU" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2789 ../fish/guestfish.pod:1054 +#: ../src/guestfs.pod:2789 ../fish/guestfish.pod:1059 msgid "" "Set the default qemu binary that libguestfs uses. If not set, then the qemu " "which was found at compile time by the configure script is used." @@ -5382,7 +5382,7 @@ msgid "See also L above." msgstr "" #. type: =item -#: ../src/guestfs.pod:2795 ../fish/guestfish.pod:1058 +#: ../src/guestfs.pod:2795 ../fish/guestfish.pod:1063 msgid "LIBGUESTFS_TRACE" msgstr "" @@ -5394,19 +5394,19 @@ msgid "" msgstr "" #. type: =item -#: ../src/guestfs.pod:2800 ../fish/guestfish.pod:1067 +#: ../src/guestfs.pod:2800 ../fish/guestfish.pod:1072 msgid "TMPDIR" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2802 ../fish/guestfish.pod:1069 +#: ../src/guestfs.pod:2802 ../fish/guestfish.pod:1074 msgid "" "Location of temporary directory, defaults to C except for the cached " "supermin appliance which defaults to C." msgstr "" #. type: textblock -#: ../src/guestfs.pod:2805 ../fish/guestfish.pod:1072 +#: ../src/guestfs.pod:2805 ../fish/guestfish.pod:1077 msgid "" "If libguestfs was compiled to use the supermin appliance then the real " "appliance is cached in this directory, shared between all handles belonging " @@ -5415,7 +5415,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2813 ../fish/guestfish.pod:1130 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:250 ../tools/virt-edit.pl:350 ../tools/virt-win-reg.pl:572 ../tools/virt-resize.pl:1489 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257 +#: ../src/guestfs.pod:2813 ../fish/guestfish.pod:1144 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:267 ../tools/virt-edit.pl:350 ../tools/virt-win-reg.pl:572 ../tools/virt-resize.pl:1489 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257 msgid "SEE ALSO" msgstr "" @@ -5492,22 +5492,22 @@ msgid "" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2882 ../fish/guestfish.pod:1153 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:261 +#: ../src/guestfs.pod:2882 ../fish/guestfish.pod:1167 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:278 msgid "AUTHORS" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1155 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:263 +#: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1169 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:280 msgid "Richard W.M. Jones (C)" msgstr "" #. type: =head1 -#: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1157 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:265 ../tools/virt-edit.pl:368 ../tools/virt-win-reg.pl:602 ../tools/virt-resize.pl:1514 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273 +#: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1171 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:282 ../tools/virt-edit.pl:368 ../tools/virt-win-reg.pl:602 ../tools/virt-resize.pl:1514 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273 msgid "COPYRIGHT" msgstr "" #. type: textblock -#: ../src/guestfs.pod:2888 ../fish/guestfish.pod:1159 ../fuse/guestmount.pod:267 +#: ../src/guestfs.pod:2888 ../fuse/guestmount.pod:284 msgid "Copyright (C) 2009-2010 Red Hat Inc. L" msgstr "" @@ -18431,7 +18431,7 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:41 ../fish/guestfish.pod:937 ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:58 ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:50 +#: ../fish/guestfish.pod:41 ../fish/guestfish.pod:942 ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:58 ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:50 msgid "EXAMPLES" msgstr "" @@ -18666,7 +18666,7 @@ msgid "To list what is available do:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:928 +#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:933 #, no-wrap msgid "" " guestfish -N help | less\n" @@ -19289,41 +19289,46 @@ msgid "B<--rw>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:405 +#: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:239 msgid "" -"This option does nothing at the moment. See L below." +"This changes the I<-a>, I<-d> and I<-m> options so that disks are added and " +"mounts are done read-write." msgstr "" -#. type: =item +#. type: textblock #: ../fish/guestfish.pod:408 +msgid "See L below." +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:410 msgid "B<-x>" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:410 +#: ../fish/guestfish.pod:412 msgid "Echo each command before executing it." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:414 +#: ../fish/guestfish.pod:416 msgid "COMMANDS ON COMMAND LINE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:416 +#: ../fish/guestfish.pod:418 msgid "Any additional (non-option) arguments are treated as commands to execute." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:419 +#: ../fish/guestfish.pod:421 msgid "" "Commands to execute should be separated by a colon (C<:>), where the colon " "is a separate parameter. Thus:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:422 +#: ../fish/guestfish.pod:424 #, no-wrap msgid "" " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n" @@ -19331,7 +19336,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:424 +#: ../fish/guestfish.pod:426 msgid "" "If there are no additional arguments, then we enter a shell, either an " "interactive shell with a prompt (if the input is a terminal) or a " @@ -19339,7 +19344,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:428 +#: ../fish/guestfish.pod:430 msgid "" "In either command line mode or non-interactive shell, the first command that " "gives an error causes the whole shell to exit. In interactive mode (with a " @@ -19347,12 +19352,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:433 +#: ../fish/guestfish.pod:435 msgid "USING launch (OR run)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:435 +#: ../fish/guestfish.pod:437 msgid "" "As with L, you must first configure your guest by adding disks, " "then launch it, then mount any disks you need, and finally issue " @@ -19360,34 +19365,34 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:443 +#: ../fish/guestfish.pod:445 msgid "add or -a/--add" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:447 +#: ../fish/guestfish.pod:449 msgid "launch (aka run)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:451 +#: ../fish/guestfish.pod:453 msgid "mount or -m/--mount" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:455 +#: ../fish/guestfish.pod:457 msgid "any other commands" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:459 +#: ../fish/guestfish.pod:461 msgid "" "C is a synonym for C. You must C (or C) your " "guest before mounting or performing any other commands." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:462 +#: ../fish/guestfish.pod:464 msgid "" "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or " "I<--new> options were given then C is done automatically, simply " @@ -19395,72 +19400,74 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:467 +#: ../fish/guestfish.pod:469 msgid "OPENING DISKS FOR READ AND WRITE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:469 +#: ../fish/guestfish.pod:471 msgid "" -"The guestfish (and L) options I<--ro> and I<--rw> affect " -"whether the other command line options I<-a>, I<-c>, I<-d>, I<-i> and I<-m> " -"open disk images read-only or for writing." +"The guestfish, L and L options I<--ro> and " +"I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, " +"I<-i> and I<-m> open disk images read-only or for writing." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:473 +#: ../fish/guestfish.pod:476 msgid "" -"In libguestfs E 1.6.2, guestfish and guestmount defaulted to opening " -"disk images supplied on the command line for write. To open a disk image " -"read-only you have to do I<-a image --ro>." +"In libguestfs E 1.8, guestfish, guestmount and virt-rescue defaulted to " +"opening disk images supplied on the command line for write. To open a disk " +"image read-only you have to do I<-a image --ro>." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:477 +#: ../fish/guestfish.pod:480 msgid "" "This matters: If you accidentally open a live VM disk image writable then " "you will cause irreversible disk corruption." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:480 +#: ../fish/guestfish.pod:483 msgid "" "By libguestfs 1.10 we intend to change the default the other way. Disk " "images will be opened read-only. You will have to either specify " -"I or change a configuration file in order to get write " +"I, I, I, or change the " +"configuration file C in order to get write " "access for disk images specified by those other command line options." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:485 +#: ../fish/guestfish.pod:490 msgid "" -"This version of guestfish has a I<--rw> option which does nothing (it is " -"already the default). However it is highly recommended that you use this " -"option to indicate that guestfish needs write access, and to prepare your " -"scripts for the day when this option will be required for write access." +"This version of guestfish, guestmount and virt-rescue has a I<--rw> option " +"which does nothing (it is already the default). However it is highly " +"recommended that you use this option to indicate that you need write access, " +"and prepare your scripts for the day when this option will be required for " +"write access." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:491 +#: ../fish/guestfish.pod:496 msgid "" "B This does I affect commands like L and L, or any " "other libguestfs program apart from guestfish and guestmount." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:494 +#: ../fish/guestfish.pod:499 msgid "QUOTING" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:496 +#: ../fish/guestfish.pod:501 msgid "" "You can quote ordinary parameters using either single or double quotes. For " "example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:499 +#: ../fish/guestfish.pod:504 #, no-wrap msgid "" " add \"file with a space.img\"\n" @@ -19468,7 +19475,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:501 +#: ../fish/guestfish.pod:506 #, no-wrap msgid "" " rm '/file name'\n" @@ -19476,7 +19483,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:503 +#: ../fish/guestfish.pod:508 #, no-wrap msgid "" " rm '/\"'\n" @@ -19484,7 +19491,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:505 +#: ../fish/guestfish.pod:510 msgid "" "A few commands require a list of strings to be passed. For these, use a " "whitespace-separated list, enclosed in quotes. Strings containing " @@ -19493,7 +19500,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:510 +#: ../fish/guestfish.pod:515 #, no-wrap msgid "" " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n" @@ -19503,19 +19510,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:514 +#: ../fish/guestfish.pod:519 msgid "OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:516 +#: ../fish/guestfish.pod:521 msgid "" "Some commands take optional arguments. These arguments appear in this " "documentation as C<[argname:..]>. You can use them as in these examples:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:520 +#: ../fish/guestfish.pod:525 #, no-wrap msgid "" " add-drive-opts filename\n" @@ -19523,7 +19530,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:522 +#: ../fish/guestfish.pod:527 #, no-wrap msgid "" " add-drive-opts filename readonly:true\n" @@ -19531,7 +19538,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:524 +#: ../fish/guestfish.pod:529 #, no-wrap msgid "" " add-drive-opts filename format:qcow2 readonly:false\n" @@ -19539,196 +19546,196 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:526 +#: ../fish/guestfish.pod:531 msgid "" "Each optional argument can appear at most once. All optional arguments must " "appear after the required ones." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:529 +#: ../fish/guestfish.pod:534 msgid "NUMBERS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:531 +#: ../fish/guestfish.pod:536 msgid "This section applies to all commands which can take integers as parameters." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:534 +#: ../fish/guestfish.pod:539 msgid "SIZE SUFFIX" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:536 +#: ../fish/guestfish.pod:541 msgid "" "When the command takes a parameter measured in bytes, you can use one of the " "following suffixes to specify kilobytes, megabytes and larger sizes:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:542 +#: ../fish/guestfish.pod:547 msgid "B or B or B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:544 +#: ../fish/guestfish.pod:549 msgid "The size in kilobytes (multiplied by 1024)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:546 +#: ../fish/guestfish.pod:551 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:548 +#: ../fish/guestfish.pod:553 msgid "The size in SI 1000 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:550 +#: ../fish/guestfish.pod:555 msgid "B or B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:552 +#: ../fish/guestfish.pod:557 msgid "The size in megabytes (multiplied by 1048576)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:554 +#: ../fish/guestfish.pod:559 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:556 +#: ../fish/guestfish.pod:561 msgid "The size in SI 1000000 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:558 +#: ../fish/guestfish.pod:563 msgid "B or B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:560 +#: ../fish/guestfish.pod:565 msgid "The size in gigabytes (multiplied by 2**30)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:562 +#: ../fish/guestfish.pod:567 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:564 +#: ../fish/guestfish.pod:569 msgid "The size in SI 10**9 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:566 +#: ../fish/guestfish.pod:571 msgid "B or B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:568 +#: ../fish/guestfish.pod:573 msgid "The size in terabytes (multiplied by 2**40)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:570 +#: ../fish/guestfish.pod:575 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:572 +#: ../fish/guestfish.pod:577 msgid "The size in SI 10**12 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:574 +#: ../fish/guestfish.pod:579 msgid "B

or B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:576 +#: ../fish/guestfish.pod:581 msgid "The size in petabytes (multiplied by 2**50)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:578 +#: ../fish/guestfish.pod:583 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:580 +#: ../fish/guestfish.pod:585 msgid "The size in SI 10**15 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:582 +#: ../fish/guestfish.pod:587 msgid "B or B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:584 +#: ../fish/guestfish.pod:589 msgid "The size in exabytes (multiplied by 2**60)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:586 +#: ../fish/guestfish.pod:591 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:588 +#: ../fish/guestfish.pod:593 msgid "The size in SI 10**18 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:590 +#: ../fish/guestfish.pod:595 msgid "B or B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:592 +#: ../fish/guestfish.pod:597 msgid "The size in zettabytes (multiplied by 2**70)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:594 +#: ../fish/guestfish.pod:599 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:596 +#: ../fish/guestfish.pod:601 msgid "The size in SI 10**21 byte units." msgstr "" #. type: =item -#: ../fish/guestfish.pod:598 +#: ../fish/guestfish.pod:603 msgid "B or B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:600 +#: ../fish/guestfish.pod:605 msgid "The size in yottabytes (multiplied by 2**80)." msgstr "" #. type: =item -#: ../fish/guestfish.pod:602 +#: ../fish/guestfish.pod:607 msgid "B" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:604 +#: ../fish/guestfish.pod:609 msgid "The size in SI 10**24 byte units." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:610 +#: ../fish/guestfish.pod:615 #, no-wrap msgid "" " truncate-size /file 1G\n" @@ -19736,12 +19743,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:612 +#: ../fish/guestfish.pod:617 msgid "would truncate the file to 1 gigabyte." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:614 +#: ../fish/guestfish.pod:619 msgid "" "Be careful because a few commands take sizes in kilobytes or megabytes " "(eg. the parameter to L is specified in megabytes already). " @@ -19749,19 +19756,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:618 +#: ../fish/guestfish.pod:623 msgid "OCTAL AND HEXADECIMAL NUMBERS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:620 +#: ../fish/guestfish.pod:625 msgid "" "For specifying the radix (base) use the C convention: C<0> to prefix an " "octal number or C<0x> to prefix a hexadecimal number. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:623 +#: ../fish/guestfish.pod:628 #, no-wrap msgid "" " 1234 decimal number 1234\n" @@ -19771,7 +19778,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:627 +#: ../fish/guestfish.pod:632 msgid "" "When using the C command, you almost always want to specify an octal " "number for the mode, and you must prefix it with C<0> (unlike the Unix " @@ -19779,7 +19786,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:631 +#: ../fish/guestfish.pod:636 #, no-wrap msgid "" " chmod 0777 /public # OK\n" @@ -19788,7 +19795,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:634 +#: ../fish/guestfish.pod:639 msgid "" "Commands that return numbers usually print them in decimal, but some " "commands print numbers in other radices (eg. C prints the mode in " @@ -19796,12 +19803,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:638 +#: ../fish/guestfish.pod:643 msgid "WILDCARDS AND GLOBBING" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:640 +#: ../fish/guestfish.pod:645 msgid "" "Neither guestfish nor the underlying guestfs API performs wildcard expansion " "(globbing) by default. So for example the following will not do what you " @@ -19809,7 +19816,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:644 +#: ../fish/guestfish.pod:649 #, no-wrap msgid "" " rm-rf /home/*\n" @@ -19817,19 +19824,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:646 +#: ../fish/guestfish.pod:651 msgid "" "Assuming you don't have a directory called literally C then the " "above command will return an error." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:649 +#: ../fish/guestfish.pod:654 msgid "To perform wildcard expansion, use the C command." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:651 +#: ../fish/guestfish.pod:656 #, no-wrap msgid "" " glob rm-rf /home/*\n" @@ -19837,14 +19844,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:653 +#: ../fish/guestfish.pod:658 msgid "" "runs C on each path that matches (ie. potentially running the command " "many times), equivalent to:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:656 +#: ../fish/guestfish.pod:661 #, no-wrap msgid "" " rm-rf /home/jim\n" @@ -19854,24 +19861,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:660 +#: ../fish/guestfish.pod:665 msgid "C only works on simple guest paths and not on device names." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:662 +#: ../fish/guestfish.pod:667 msgid "" "If you have several parameters, each containing a wildcard, then glob will " "perform a Cartesian product." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:665 +#: ../fish/guestfish.pod:670 msgid "COMMENTS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:667 +#: ../fish/guestfish.pod:672 msgid "" "Any line which starts with a I<#> character is treated as a comment and " "ignored. The I<#> can optionally be preceeded by whitespace, but B by " @@ -19879,7 +19886,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:671 +#: ../fish/guestfish.pod:676 #, no-wrap msgid "" " # this is a comment\n" @@ -19889,24 +19896,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:675 +#: ../fish/guestfish.pod:680 msgid "Blank lines are also ignored." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:677 +#: ../fish/guestfish.pod:682 msgid "RUNNING COMMANDS LOCALLY" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:679 +#: ../fish/guestfish.pod:684 msgid "" "Any line which starts with a I character is treated as a command sent to " "the local shell (C or whatever L uses). For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:683 +#: ../fish/guestfish.pod:688 #, no-wrap msgid "" " !mkdir local\n" @@ -19915,7 +19922,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:686 +#: ../fish/guestfish.pod:691 msgid "" "will create a directory C on the host, and then export the contents " "of C on the mounted filesystem to C. " @@ -19923,19 +19930,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:690 +#: ../fish/guestfish.pod:695 msgid "" "To change the local directory, use the C command. C will have no " "effect, due to the way that subprocesses work in Unix." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:693 +#: ../fish/guestfish.pod:698 msgid "LOCAL COMMANDS WITH INLINE EXECUTION" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:695 +#: ../fish/guestfish.pod:700 msgid "" "If a line starts with I!> then the shell command is executed (as for " "I), but subsequently any output (stdout) of the shell command is parsed " @@ -19943,14 +19950,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:699 +#: ../fish/guestfish.pod:704 msgid "" "Thus you can use shell script to construct arbitrary guestfish commands " "which are then parsed by guestfish." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:702 +#: ../fish/guestfish.pod:707 msgid "" "For example it is tedious to create a sequence of files (eg. C " "through C) using guestfish commands alone. However this is simple " @@ -19958,7 +19965,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:707 +#: ../fish/guestfish.pod:712 #, no-wrap msgid "" " :" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:711 +#: ../fish/guestfish.pod:716 #, no-wrap msgid "" " > character so it is just an " @@ -19989,12 +19996,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:719 +#: ../fish/guestfish.pod:724 msgid "PIPES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:721 +#: ../fish/guestfish.pod:726 msgid "" "Use CspaceE | command> to pipe the output of the first " "command (a guestfish command) to the second command (any host command). For " @@ -20002,7 +20009,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:725 +#: ../fish/guestfish.pod:730 #, no-wrap msgid "" " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n" @@ -20010,7 +20017,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:727 +#: ../fish/guestfish.pod:732 msgid "" "(where C is the guestfish cat command, but C is the host awk " "program). The above command would list all accounts in the guest filesystem " @@ -20018,7 +20025,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:732 +#: ../fish/guestfish.pod:737 #, no-wrap msgid "" " hexdump /bin/ls | head\n" @@ -20028,7 +20035,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:736 +#: ../fish/guestfish.pod:741 msgid "" "The space before the pipe symbol is required, any space after the pipe " "symbol is optional. Everything after the pipe symbol is just passed " @@ -20037,14 +20044,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:741 +#: ../fish/guestfish.pod:746 msgid "" "To use a literal argument which begins with a pipe symbol, you have to quote " "it, eg:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:744 +#: ../fish/guestfish.pod:749 #, no-wrap msgid "" " echo \"|\"\n" @@ -20052,12 +20059,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:746 +#: ../fish/guestfish.pod:751 msgid "HOME DIRECTORIES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:748 +#: ../fish/guestfish.pod:753 msgid "" "If a parameter starts with the character C<~> then the tilde may be expanded " "as a home directory path (either C<~> for the current user's home directory, " @@ -20065,21 +20072,21 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:752 +#: ../fish/guestfish.pod:757 msgid "" "Note that home directory expansion happens for users known I, " "not in the guest filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:755 +#: ../fish/guestfish.pod:760 msgid "" "To use a literal argument which begins with a tilde, you have to quote it, " "eg:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:758 +#: ../fish/guestfish.pod:763 #, no-wrap msgid "" " echo \"~\"\n" @@ -20087,7 +20094,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:762 +#: ../fish/guestfish.pod:767 msgid "" "Libguestfs has some support for Linux guests encrypted according to the " "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole " @@ -20096,12 +20103,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:767 +#: ../fish/guestfish.pod:772 msgid "Identify encrypted block devices and partitions using L:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:769 +#: ../fish/guestfish.pod:774 #, no-wrap msgid "" " > vfs-type /dev/sda2\n" @@ -20110,14 +20117,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:772 +#: ../fish/guestfish.pod:777 msgid "" "Then open those devices using L. This creates a device-mapper " "device called C." msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:775 +#: ../fish/guestfish.pod:780 #, no-wrap msgid "" " > luks-open /dev/sda2 luksdev\n" @@ -20126,14 +20133,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:778 +#: ../fish/guestfish.pod:783 msgid "" "Finally you have to tell LVM to scan for volume groups on the newly created " "mapper device:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:781 +#: ../fish/guestfish.pod:786 #, no-wrap msgid "" " vgscan\n" @@ -20142,12 +20149,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:784 +#: ../fish/guestfish.pod:789 msgid "The logical volume(s) can now be mounted in the usual way." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:786 +#: ../fish/guestfish.pod:791 msgid "" "Before closing a LUKS device you must unmount any logical volumes on it and " "deactivate the volume groups by calling C on each " @@ -20155,7 +20162,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:790 +#: ../fish/guestfish.pod:795 #, no-wrap msgid "" " vg-activate false /dev/VG\n" @@ -20164,19 +20171,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:793 +#: ../fish/guestfish.pod:798 msgid "WINDOWS PATHS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:795 +#: ../fish/guestfish.pod:800 msgid "" "If a path is prefixed with C then you can use Windows-style paths " "(with some limitations). The following commands are equivalent:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:798 +#: ../fish/guestfish.pod:803 #, no-wrap msgid "" " file /WINDOWS/system32/config/system.LOG\n" @@ -20184,7 +20191,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:800 +#: ../fish/guestfish.pod:805 #, no-wrap msgid "" " file win:/windows/system32/config/system.log\n" @@ -20192,7 +20199,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:802 +#: ../fish/guestfish.pod:807 #, no-wrap msgid "" " file win:\\windows\\system32\\config\\system.log\n" @@ -20200,7 +20207,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:804 +#: ../fish/guestfish.pod:809 #, no-wrap msgid "" " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n" @@ -20208,7 +20215,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:806 +#: ../fish/guestfish.pod:811 msgid "" "This syntax implicitly calls C (q.v.) so it also " "handles case insensitivity like Windows would. This only works in argument " @@ -20216,12 +20223,12 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:810 +#: ../fish/guestfish.pod:815 msgid "UPLOADING AND DOWNLOADING FILES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:812 +#: ../fish/guestfish.pod:817 msgid "" "For commands such as C, C, C, C and " "others which upload from or download to a local file, you can use the " @@ -20229,7 +20236,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:816 +#: ../fish/guestfish.pod:821 #, no-wrap msgid "" " upload - /foo\n" @@ -20237,12 +20244,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:818 +#: ../fish/guestfish.pod:823 msgid "reads stdin and creates from that a file C in the disk image, and:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:821 +#: ../fish/guestfish.pod:826 #, no-wrap msgid "" " tar-out /etc - | tar tf -\n" @@ -20250,14 +20257,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:823 +#: ../fish/guestfish.pod:828 msgid "" "writes the tarball to stdout and then pipes that into the external \"tar\" " "command (see L)." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:826 +#: ../fish/guestfish.pod:831 msgid "" "When using C<-> to read from stdin, the input is read up to the end of " "stdin. You can also use a special \"heredoc\"-like syntax to read up to " @@ -20265,7 +20272,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:830 +#: ../fish/guestfish.pod:835 #, no-wrap msgid "" " upload -<. The end marker must " "appear on a line of its own, without any preceeding or following characters " @@ -20285,19 +20292,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:840 +#: ../fish/guestfish.pod:845 msgid "" "Note that the C<-EE> syntax only applies to parameters used to " "upload local files (so-called \"FileIn\" parameters in the generator)." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:843 +#: ../fish/guestfish.pod:848 msgid "EXIT ON ERROR BEHAVIOUR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:845 +#: ../fish/guestfish.pod:850 msgid "" "By default, guestfish will ignore any errors when in interactive mode " "(ie. taking commands from a human over a tty), and will exit on the first " @@ -20305,19 +20312,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:850 +#: ../fish/guestfish.pod:855 msgid "" "If you prefix a command with a I<-> character, then that command will not " "cause guestfish to exit, even if that (one) command returns an error." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:854 +#: ../fish/guestfish.pod:859 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:856 +#: ../fish/guestfish.pod:861 msgid "" "Guestfish can be remote-controlled over a socket. This is useful " "particularly in shell scripts where you want to make several different " @@ -20326,12 +20333,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:861 +#: ../fish/guestfish.pod:866 msgid "Start a guestfish server process using:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:863 +#: ../fish/guestfish.pod:868 #, no-wrap msgid "" " eval \"`guestfish --listen`\"\n" @@ -20339,12 +20346,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:865 +#: ../fish/guestfish.pod:870 msgid "and then send it commands by doing:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:867 +#: ../fish/guestfish.pod:872 #, no-wrap msgid "" " guestfish --remote cmd [...]\n" @@ -20352,12 +20359,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:869 +#: ../fish/guestfish.pod:874 msgid "To cause the server to exit, send it the exit command:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:871 +#: ../fish/guestfish.pod:876 #, no-wrap msgid "" " guestfish --remote exit\n" @@ -20365,7 +20372,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:873 +#: ../fish/guestfish.pod:878 msgid "" "Note that the server will normally exit if there is an error in a command. " "You can change this in the usual way. See section L statement sets the environment variable C<$GUESTFISH_PID>, which " "is how the I<--remote> option knows where to send the commands. You can " @@ -20386,7 +20393,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:883 +#: ../fish/guestfish.pod:888 #, no-wrap msgid "" " eval \"`guestfish --listen`\"\n" @@ -20400,19 +20407,19 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:891 +#: ../fish/guestfish.pod:896 msgid "REMOTE CONTROL AND CSH" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:893 +#: ../fish/guestfish.pod:898 msgid "" "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> " "option:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:896 +#: ../fish/guestfish.pod:901 #, no-wrap msgid "" " eval \"`guestfish --listen --csh`\"\n" @@ -20420,12 +20427,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:898 +#: ../fish/guestfish.pod:903 msgid "REMOTE CONTROL DETAILS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:900 +#: ../fish/guestfish.pod:905 msgid "" "Remote control happens over a Unix domain socket called " "C, where C<$UID> is the effective user ID " @@ -20433,17 +20440,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:904 +#: ../fish/guestfish.pod:909 msgid "Guestfish client and server versions must match exactly." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:906 +#: ../fish/guestfish.pod:911 msgid "PREPARED DISK IMAGES" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:908 +#: ../fish/guestfish.pod:913 msgid "" "Use the I<-N type> or I<--new type> parameter to select one of a set of " "preformatted disk images that guestfish can make for you to save typing. " @@ -20453,7 +20460,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:914 +#: ../fish/guestfish.pod:919 msgid "" "The new disk is called C for the first I<-N>, C for " "the second and so on. Existing files in the current directory are " @@ -20461,7 +20468,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:918 +#: ../fish/guestfish.pod:923 msgid "" "The type briefly describes how the disk should be sized, partitioned, how " "filesystem(s) should be created, and how content should be added. " @@ -20473,31 +20480,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:926 +#: ../fish/guestfish.pod:931 msgid "To list the available types and any extra parameters they take, run:" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:930 +#: ../fish/guestfish.pod:935 msgid "" "Note that the prepared filesystem is not mounted. You would usually have to " "use the C command or add the I<-m /dev/sda1> option." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:934 +#: ../fish/guestfish.pod:939 msgid "" "If any I<-N> or I<--new> options are given, the guest is automatically " "launched." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:939 +#: ../fish/guestfish.pod:944 msgid "Create a 100MB disk with an ext4-formatted partition:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:941 +#: ../fish/guestfish.pod:946 #, no-wrap msgid "" " guestfish -N fs:ext4\n" @@ -20505,12 +20512,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:943 +#: ../fish/guestfish.pod:948 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:945 +#: ../fish/guestfish.pod:950 #, no-wrap msgid "" " guestfish -N fs:vfat:32M -m /dev/sda1\n" @@ -20518,12 +20525,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:947 +#: ../fish/guestfish.pod:952 msgid "Create a blank 200MB disk:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:949 +#: ../fish/guestfish.pod:954 #, no-wrap msgid "" " guestfish -N disk:200M\n" @@ -20531,19 +20538,19 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:951 +#: ../fish/guestfish.pod:956 msgid "PROGRESS BARS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:953 +#: ../fish/guestfish.pod:958 msgid "" "Some (not all) long-running commands send progress notification messages as " "they are running. Guestfish turns these messages into progress bars." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:957 +#: ../fish/guestfish.pod:962 msgid "" "When a command that supports progress bars takes longer than two seconds to " "run, and if progress bars are enabled, then you will see one appearing below " @@ -20551,7 +20558,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:961 +#: ../fish/guestfish.pod:966 #, no-wrap msgid "" " > copy-size /large-file /another-file 2048M\n" @@ -20560,7 +20567,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:964 +#: ../fish/guestfish.pod:969 msgid "" "The spinner on the left hand side moves round once for every progress " "notification received from the backend. This is a (reasonably) golden " @@ -20571,7 +20578,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:971 +#: ../fish/guestfish.pod:976 msgid "" "Progress bars are enabled by default when guestfish is used interactively. " "You can enable them even for non-interactive modes using I<--progress-bars>, " @@ -20579,24 +20586,24 @@ msgid "" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:976 +#: ../fish/guestfish.pod:981 msgid "GUESTFISH COMMANDS" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:978 +#: ../fish/guestfish.pod:983 msgid "" "The commands in this section are guestfish convenience commands, in other " "words, they are not part of the L API." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:981 +#: ../fish/guestfish.pod:986 msgid "help" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:983 +#: ../fish/guestfish.pod:988 #, no-wrap msgid "" " help\n" @@ -20605,155 +20612,177 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:986 +#: ../fish/guestfish.pod:991 msgid "Without any parameter, this provides general help." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:988 +#: ../fish/guestfish.pod:993 msgid "With a C parameter, this displays detailed help for that command." msgstr "" #. type: =head2 -#: ../fish/guestfish.pod:990 +#: ../fish/guestfish.pod:995 msgid "quit | exit" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:992 +#: ../fish/guestfish.pod:997 msgid "This exits guestfish. You can also use C<^D> key." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:994 +#: ../fish/guestfish.pod:999 msgid "@FISH_COMMANDS@" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:996 +#: ../fish/guestfish.pod:1001 msgid "COMMANDS" msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:1000 ../test-tool/libguestfs-test-tool.pod:83 +#: ../fish/guestfish.pod:1005 ../test-tool/libguestfs-test-tool.pod:83 msgid "EXIT CODE" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1002 +#: ../fish/guestfish.pod:1007 msgid "" "guestfish returns 0 if the commands completed without error, or 1 if there " "was an error." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1009 +#: ../fish/guestfish.pod:1014 msgid "EDITOR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1011 +#: ../fish/guestfish.pod:1016 msgid "" "The C command uses C<$EDITOR> as the editor. If not set, it uses " "C." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1014 +#: ../fish/guestfish.pod:1019 msgid "GUESTFISH_PID" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1016 +#: ../fish/guestfish.pod:1021 msgid "" "Used with the I<--remote> option to specify the remote guestfish process to " "control. See section L." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1020 +#: ../fish/guestfish.pod:1025 msgid "HEXEDITOR" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1022 +#: ../fish/guestfish.pod:1027 msgid "" "The L command uses C<$HEXEDITOR> as the external hex editor. If " "not specified, the external L program is used." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1026 +#: ../fish/guestfish.pod:1031 msgid "HOME" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1028 +#: ../fish/guestfish.pod:1033 msgid "" "If compiled with GNU readline support, various files in the home directory " "can be used. See L." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1037 +#: ../fish/guestfish.pod:1042 msgid "" "Set C to enable verbose messages. This has the same " "effect as using the B<-v> option." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1049 +#: ../fish/guestfish.pod:1054 msgid "" "Set the path that guestfish uses to search for kernel and initrd.img. See " "the discussion of paths in L." msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1060 +#: ../fish/guestfish.pod:1065 msgid "Set C to enable command traces." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1062 +#: ../fish/guestfish.pod:1067 msgid "PAGER" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1064 +#: ../fish/guestfish.pod:1069 msgid "" "The C command uses C<$PAGER> as the pager. If not set, it uses " "C." msgstr "" #. type: =head1 -#: ../fish/guestfish.pod:1080 ../test-tool/libguestfs-test-tool.pod:88 +#: ../fish/guestfish.pod:1085 ../test-tool/libguestfs-test-tool.pod:88 ../fuse/guestmount.pod:252 msgid "FILES" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1084 +#: ../fish/guestfish.pod:1089 ../fuse/guestmount.pod:256 +msgid "$HOME/.libguestfs-tools.rc" +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:1091 ../fuse/guestmount.pod:258 +msgid "/etc/libguestfs-tools.conf" +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1093 ../fuse/guestmount.pod:260 +msgid "" +"This configuration file controls the default read-only or read-write mode " +"(I<--ro> or I<--rw>)." +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1096 +msgid "See L." +msgstr "" + +#. type: =item +#: ../fish/guestfish.pod:1098 msgid "$HOME/.guestfish" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1086 +#: ../fish/guestfish.pod:1100 msgid "" "If compiled with GNU readline support, then the command history is saved in " "this file." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1089 +#: ../fish/guestfish.pod:1103 msgid "$HOME/.inputrc" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1091 +#: ../fish/guestfish.pod:1105 msgid "/etc/inputrc" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1093 +#: ../fish/guestfish.pod:1107 msgid "" "If compiled with GNU readline support, then these files can be used to " "configure readline. For further information, please see " @@ -20761,12 +20790,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1097 +#: ../fish/guestfish.pod:1111 msgid "To write rules which only apply to guestfish, use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1099 +#: ../fish/guestfish.pod:1113 #, no-wrap msgid "" " $if guestfish\n" @@ -20776,26 +20805,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1103 +#: ../fish/guestfish.pod:1117 msgid "" "Variables that you can set in inputrc that change the behaviour of guestfish " "in useful ways include:" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1108 +#: ../fish/guestfish.pod:1122 msgid "completion-ignore-case (default: on)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1110 +#: ../fish/guestfish.pod:1124 msgid "" "By default, guestfish will ignore case when tab-completing paths on the " "disk. Use:" msgstr "" #. type: verbatim -#: ../fish/guestfish.pod:1113 +#: ../fish/guestfish.pod:1127 #, no-wrap msgid "" " set completion-ignore-case off\n" @@ -20803,22 +20832,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1115 +#: ../fish/guestfish.pod:1129 msgid "to make guestfish case sensitive." msgstr "" #. type: =item -#: ../fish/guestfish.pod:1119 +#: ../fish/guestfish.pod:1133 msgid "test1.img" msgstr "" #. type: =item -#: ../fish/guestfish.pod:1121 +#: ../fish/guestfish.pod:1135 msgid "test2.img (etc)" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1123 +#: ../fish/guestfish.pod:1137 msgid "" "When using the C<-N> or C<--new> option, the prepared disk or filesystem " "will be created in the file C in the current directory. The " @@ -20827,7 +20856,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1132 +#: ../fish/guestfish.pod:1146 msgid "" "L, L, L, " "L, L, L, L, " @@ -20838,7 +20867,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1162 ../test-tool/libguestfs-test-tool.pod:124 ../fuse/guestmount.pod:270 ../tools/virt-edit.pl:372 ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1518 ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277 +#: ../fish/guestfish.pod:1173 +msgid "Copyright (C) 2009-2011 Red Hat Inc. L" +msgstr "" + +#. type: textblock +#: ../fish/guestfish.pod:1176 ../test-tool/libguestfs-test-tool.pod:124 ../fuse/guestmount.pod:287 ../tools/virt-edit.pl:372 ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1518 ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277 msgid "" "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 the Free " @@ -20847,7 +20881,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1167 ../test-tool/libguestfs-test-tool.pod:129 ../fuse/guestmount.pod:275 ../tools/virt-edit.pl:377 ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1523 ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282 +#: ../fish/guestfish.pod:1181 ../test-tool/libguestfs-test-tool.pod:129 ../fuse/guestmount.pod:292 ../tools/virt-edit.pl:377 ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1523 ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282 msgid "" "This program is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " @@ -20856,7 +20890,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish.pod:1172 ../test-tool/libguestfs-test-tool.pod:134 ../fuse/guestmount.pod:280 ../tools/virt-edit.pl:382 ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1528 ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287 +#: ../fish/guestfish.pod:1186 ../test-tool/libguestfs-test-tool.pod:134 ../fuse/guestmount.pod:297 ../tools/virt-edit.pl:382 ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1528 ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287 msgid "" "You should have received a copy of the GNU General Public License along with " "this program; if not, write to the Free Software Foundation, Inc., 675 Mass " @@ -27915,29 +27949,27 @@ msgid "B<-w> | B<--rw>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:239 -msgid "" -"This option does nothing at the moment. See L." +#: ../fuse/guestmount.pod:242 ../fuse/guestmount.pod:263 +msgid "See L." msgstr "" #. type: =item -#: ../fuse/guestmount.pod:242 +#: ../fuse/guestmount.pod:244 msgid "B<-x> | B<--trace>" msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:244 +#: ../fuse/guestmount.pod:246 msgid "Trace libguestfs calls and entry into each FUSE function." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:246 +#: ../fuse/guestmount.pod:248 msgid "This also stops the daemon from forking into the background." msgstr "" #. type: textblock -#: ../fuse/guestmount.pod:252 +#: ../fuse/guestmount.pod:269 msgid "" "L, L, L, L, " "L, L, L, "