X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=po-docs%2Fuk.po;h=9ccbfb1d84d06345b168063a4a036b6042470b63;hp=1642c0dfd26f7b8624f973493cb444f0e01f06b0;hb=ece902712bcd54e0cd28b57352c6a4efcf26c4f6;hpb=d020350c3131f5d0e422f502b4810025a6fc0f11 diff --git a/po-docs/uk.po b/po-docs/uk.po index 1642c0d..9ccbfb1 100644 --- a/po-docs/uk.po +++ b/po-docs/uk.po @@ -2,13 +2,14 @@ # Copyright (C) YEAR Red Hat Inc. # This file is distributed under the same license as the libguestfs package. # +# Translators: # Yuri Chornoivan , 2011. msgid "" msgstr "" "Project-Id-Version: libguestfs\n" "Report-Msgid-Bugs-To: libguestfs@redhat.com\n" -"POT-Creation-Date: 2011-09-28 21:49+0200\n" -"PO-Revision-Date: 2011-07-17 20:50+0000\n" +"POT-Creation-Date: 2011-11-29 21:47+0000\n" +"PO-Revision-Date: 2011-10-27 09:15+0000\n" "Last-Translator: rjones \n" "Language-Team: Ukrainian \n" "Language: uk\n" @@ -19,17 +20,19 @@ msgstr "" "%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\n" #. type: =head1 -#: ../cat/virt-cat.pod:3 ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 -#: ../df/virt-df.pod:3 ../edit/virt-edit.pod:3 +#: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3 +#: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 +#: ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3 #: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3 -#: ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3 -#: ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3 -#: ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3 -#: ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3 -#: ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3 -#: ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3 -#: ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3 -#: ../ruby/examples/guestfs-ruby.pod:3 ../src/guestfs.pod:3 +#: ../examples/guestfs-recipes.pod:14 ../examples/guestfs-testing.pod:3 +#: ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3 +#: ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3 +#: ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3 +#: ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3 +#: ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3 +#: ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3 +#: ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3 +#: ../sparsify/virt-sparsify.pod:3 ../src/guestfs.pod:3 #: ../test-tool/libguestfs-test-tool.pod:3 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30 #: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31 @@ -38,13 +41,14 @@ msgid "NAME" msgstr "НАЗВА" #. type: textblock -#: ../cat/virt-cat.pod:5 -msgid "virt-cat - Display files in a virtual machine" +#: ../align/virt-alignment-scan.pod:5 +msgid "virt-alignment-scan - Check alignment of virtual machine partitions" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:7 ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7 -#: ../df/virt-df.pod:7 ../edit/virt-edit.pod:7 +#: ../align/virt-alignment-scan.pod:7 ../cat/virt-cat.pod:7 +#: ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7 +#: ../clone/virt-sysprep.pod:7 ../df/virt-df.pod:7 ../edit/virt-edit.pod:7 #: ../erlang/examples/guestfs-erlang.pod:7 ../examples/guestfs-examples.pod:7 #: ../fish/guestfish.pod:7 ../fish/virt-copy-in.pod:7 #: ../fish/virt-copy-out.pod:7 ../fish/virt-tar-in.pod:7 @@ -53,7 +57,8 @@ msgstr "" #: ../ocaml/examples/guestfs-ocaml.pod:7 ../perl/examples/guestfs-perl.pod:7 #: ../python/examples/guestfs-python.pod:7 ../rescue/virt-rescue.pod:7 #: ../resize/virt-resize.pod:7 ../ruby/examples/guestfs-ruby.pod:7 -#: ../src/guestfs.pod:7 ../test-tool/libguestfs-test-tool.pod:7 +#: ../sparsify/virt-sparsify.pod:7 ../src/guestfs.pod:7 +#: ../test-tool/libguestfs-test-tool.pod:7 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34 #: ../tools/virt-make-fs.pl:39 ../tools/virt-tar.pl:35 #: ../tools/virt-win-reg.pl:39 @@ -61,66 +66,37 @@ msgid "SYNOPSIS" msgstr "КОРОТКИЙ ОПИС" #. type: verbatim -#: ../cat/virt-cat.pod:9 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" -msgid "" -" virt-cat [--options] -d domname file [file ...]\n" -"\n" -msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" - -#. type: verbatim -#: ../cat/virt-cat.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" -msgid "" -" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n" -"\n" -msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" - -#. type: textblock -#: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 -#: ../inspector/virt-inspector.pod:13 -msgid "Old-style:" -msgstr "" - -#. type: verbatim -#: ../cat/virt-cat.pod:15 +#: ../align/virt-alignment-scan.pod:9 #, no-wrap msgid "" -" virt-cat domname file\n" +" virt-alignment-scan [--options] -d domname\n" "\n" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:17 +#: ../align/virt-alignment-scan.pod:11 #, no-wrap msgid "" -" virt-cat disk.img file\n" +" virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n" "\n" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 -#: ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 +#: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19 +#: ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 +#: ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 #: ../erlang/examples/guestfs-erlang.pod:16 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18 -#: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 -#: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 -#: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20 -#: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 -#: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 -#: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29 +#: ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 +#: ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 +#: ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 +#: ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 +#: ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25 +#: ../perl/examples/guestfs-perl.pod:18 +#: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 -#: ../src/guestfs.pod:23 ../test-tool/libguestfs-test-tool.pod:11 +#: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23 +#: ../test-tool/libguestfs-test-tool.pod:11 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77 #: ../tools/virt-win-reg.pl:63 @@ -128,128 +104,173 @@ msgid "DESCRIPTION" msgstr "ОПИС" #. type: textblock -#: ../cat/virt-cat.pod:21 +#: ../align/virt-alignment-scan.pod:15 msgid "" -"C is a command line tool to display the contents of C where " -"C exists in the named virtual machine (or disk image)." +"When older operating systems install themselves, the partitioning tools " +"place partitions at a sector misaligned with the underlying storage " +"(commonly the first partition starts on sector C<63>). Misaligned " +"partitions can result in an operating system issuing more I/O than should be " +"necessary." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:24 +#: ../align/virt-alignment-scan.pod:21 msgid "" -"Multiple filenames can be given, in which case they are concatenated " -"together. Each filename must be a full path, starting at the root directory " -"(starting with '/')." +"The virt-alignment-scan tool checks the alignment of partitions in virtual " +"machines and disk images and warns you if there are alignment problems." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:28 +#: ../align/virt-alignment-scan.pod:25 msgid "" -"C can be used to quickly view a file. To edit a file, use C. For more complex cases you should look at the L tool " -"(see L below)." +"Currently there is no virt tool for fixing alignment problems. You can only " +"reinstall the guest operating system. The following NetApp document " +"summarises the problem and possible solutions: L" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43 -#: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41 -#: ../fish/guestfish.pod:1018 ../fish/virt-copy-in.pod:29 -#: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30 -#: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39 -#: ../resize/virt-resize.pod:27 ../tools/virt-tar.pl:50 -msgid "EXAMPLES" -msgstr "ПРИКЛАДИ" +#: ../align/virt-alignment-scan.pod:30 +msgid "OUTPUT" +msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:34 +#: ../align/virt-alignment-scan.pod:32 +msgid "To run this tool on a disk image directly, use the I<-a> option:" +msgstr "" + +#. type: verbatim +#: ../align/virt-alignment-scan.pod:34 +#, no-wrap msgid "" -"Display C file from inside the libvirt VM called C:" +" $ virt-alignment-scan -a winxp.img\n" +" /dev/sda1 32256 512 bad (alignment < 4K)\n" +"\n" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:37 +#: ../align/virt-alignment-scan.pod:37 #, no-wrap msgid "" -" virt-cat -d mydomain /etc/fstab\n" +" $ virt-alignment-scan -a fedora16.img\n" +" /dev/sda1 1048576 1024K ok\n" +" /dev/sda2 2097152 2048K ok\n" +" /dev/sda3 526385152 2048K ok\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:39 -msgid "List syslog messages from a VM disk image file:" +#: ../align/virt-alignment-scan.pod:42 +msgid "" +"To run the tool on a guest known to libvirt, use the I<-d> option and " +"possibly the I<-c> option:" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:41 +#: ../align/virt-alignment-scan.pod:45 #, no-wrap msgid "" -" virt-cat -a disk.img /var/log/messages | tail\n" +" # virt-alignment-scan -d RHEL5\n" +" /dev/sda1 32256 512 bad (alignment < 4K)\n" +" /dev/sda2 106928640 512 bad (alignment < 4K)\n" "\n" msgstr "" -#. type: textblock -#: ../cat/virt-cat.pod:43 -msgid "Find out what DHCP IP address a VM acquired:" -msgstr "" - #. type: verbatim -#: ../cat/virt-cat.pod:45 +#: ../align/virt-alignment-scan.pod:49 #, no-wrap msgid "" -" virt-cat -d mydomain /var/log/messages | \\\n" -" grep 'dhclient: bound to' | tail\n" +" $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n" +" /dev/sda1 1048576 1024K ok\n" +" /dev/sda2 105906176 1024K ok\n" +" /dev/sdb1 65536 64K ok\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:48 -msgid "Find out what packages were recently installed:" +#: ../align/virt-alignment-scan.pod:54 +msgid "" +"The output consists of 4 or more whitespace-separated columns. Only the " +"first 4 columns are signficant if you want to parse this from a program. " +"The columns are:" msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:50 -#, no-wrap +#. type: =item +#: ../align/virt-alignment-scan.pod:60 +msgid "col 1" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:62 msgid "" -" virt-cat -d mydomain /var/log/yum.log | tail\n" -"\n" +"the device and partition name (eg. C meaning the first partition " +"on the first block device)" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:65 +msgid "col 2" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:52 -msgid "Find out who is logged on inside a virtual machine:" +#: ../align/virt-alignment-scan.pod:67 +msgid "the start of the partition in bytes" msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:54 -#, no-wrap +#. type: =item +#: ../align/virt-alignment-scan.pod:69 +msgid "col 3" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:71 +msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:73 +msgid "col 4" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:75 msgid "" -" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" -" who /tmp/utmp\n" -"\n" +"C if the alignment is best for performance, or C if the alignment " +"can cause performance problems" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:78 +msgid "cols 5+" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:57 -msgid "or who was logged on:" +#: ../align/virt-alignment-scan.pod:80 +msgid "optional free-text explanation." msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:59 -#, no-wrap +#. type: textblock +#: ../align/virt-alignment-scan.pod:84 msgid "" -" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" -" last -f /tmp/wtmp\n" -"\n" +"The exit code from the program changes depending on whether poorly aligned " +"partitions were found. See L below." +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:87 +msgid "If you just want the exit code with no output, use the I<-q> option." msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91 -#: ../cat/virt-ls.pod:261 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62 +#: ../align/virt-alignment-scan.pod:89 ../cat/virt-cat.pod:62 +#: ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 +#: ../clone/virt-sysprep.pod:42 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62 #: ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45 #: ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42 -#: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:83 -#: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84 -#: ../resize/virt-resize.pod:241 ../test-tool/libguestfs-test-tool.pod:36 +#: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:92 +#: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:112 +#: ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:99 +#: ../test-tool/libguestfs-test-tool.pod:36 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103 #: ../tools/virt-win-reg.pl:96 @@ -257,11 +278,13 @@ msgid "OPTIONS" msgstr "ПАРАМЕТРИ" #. type: =item -#: ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 -#: ../cat/virt-ls.pod:265 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 -#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:151 -#: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88 -#: ../resize/virt-resize.pod:245 ../test-tool/libguestfs-test-tool.pod:40 +#: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66 +#: ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 +#: ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 +#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:160 +#: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:116 +#: ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:103 +#: ../test-tool/libguestfs-test-tool.pod:40 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62 #: ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111 #: ../tools/virt-win-reg.pl:104 @@ -269,73 +292,69 @@ msgid "B<--help>" msgstr "B<--help>" #. type: textblock -#: ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97 -#: ../cat/virt-ls.pod:267 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 -#: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90 +#: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:68 +#: ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 +#: ../clone/virt-sysprep.pod:48 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 +#: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:118 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113 #: ../tools/virt-win-reg.pl:106 msgid "Display brief help." -msgstr "" +msgstr "Показати коротку довідку." #. type: =item -#: ../cat/virt-cat.pod:70 ../cat/virt-filesystems.pod:99 -#: ../cat/virt-ls.pod:269 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70 -#: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92 -#, fuzzy -#| msgid "B<-f file>" +#: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:70 +#: ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269 +#: ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70 +#: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:120 msgid "B<-a> file" -msgstr "B<-f файл>" +msgstr "B<-a> файл" #. type: =item -#: ../cat/virt-cat.pod:72 ../cat/virt-filesystems.pod:101 -#: ../cat/virt-ls.pod:271 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72 -#: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94 -#, fuzzy -#| msgid "B<--add image>" +#: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72 +#: ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271 +#: ../clone/virt-sysprep.pod:52 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72 +#: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:122 msgid "B<--add> file" -msgstr "B<--add образ>" +msgstr "B<--add> файл" #. type: textblock -#: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103 -#: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74 -#: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96 -msgid "" -"Add I which should be a disk image from a virtual machine. If the " -"virtual machine has multiple block devices, you must supply all of them with " -"separate I<-a> options." +#: ../align/virt-alignment-scan.pod:101 ../clone/virt-sysprep.pod:54 +msgid "Add I which should be a disk image from a virtual machine." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:78 ../cat/virt-filesystems.pod:107 -#: ../cat/virt-ls.pod:277 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78 -#: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:93 -#: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100 +#: ../align/virt-alignment-scan.pod:103 ../cat/virt-cat.pod:78 +#: ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277 +#: ../clone/virt-sysprep.pod:56 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78 +#: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:102 +#: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:128 msgid "" "The format of the disk image is auto-detected. To override this and force a " "particular format use the I<--format=..> option." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125 -#: ../cat/virt-ls.pod:291 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:107 -#, fuzzy -#| msgid "B<-c URI>" +#: ../align/virt-alignment-scan.pod:106 ../cat/virt-cat.pod:81 +#: ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 +#: ../clone/virt-sysprep.pod:59 ../df/virt-df.pod:78 +#: ../rescue/virt-rescue.pod:135 msgid "B<-c> URI" -msgstr "B<-c адреса>" +msgstr "B<-c> адреса" #. type: =item -#: ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127 -#: ../cat/virt-ls.pod:293 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:109 -#, fuzzy -#| msgid "B<--connect URI>" +#: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83 +#: ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 +#: ../clone/virt-sysprep.pod:61 ../df/virt-df.pod:80 +#: ../rescue/virt-rescue.pod:137 msgid "B<--connect> URI" -msgstr "B<--connect адреса>" +msgstr "B<--connect> адреса" #. type: textblock -#: ../cat/virt-cat.pod:85 ../cat/virt-filesystems.pod:129 -#: ../cat/virt-ls.pod:295 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99 -#: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111 +#: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85 +#: ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295 +#: ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99 +#: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:139 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132 msgid "" @@ -344,73 +363,66 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132 -#: ../cat/virt-ls.pod:298 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:114 +#: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:88 +#: ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 +#: ../clone/virt-sysprep.pod:66 ../df/virt-df.pod:85 +#: ../rescue/virt-rescue.pod:142 msgid "" "If you specify guest block devices directly (I<-a>), then libvirt is not " "used at all." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141 -#: ../cat/virt-ls.pod:307 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 -#: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117 +#: ../align/virt-alignment-scan.pod:116 ../cat/virt-cat.pod:91 +#: ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 +#: ../clone/virt-sysprep.pod:69 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 +#: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:145 msgid "B<-d> guest" -msgstr "" +msgstr "B<-d> гість" #. type: =item -#: ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143 -#: ../cat/virt-ls.pod:309 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 -#: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119 +#: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93 +#: ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 +#: ../clone/virt-sysprep.pod:71 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 +#: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:147 msgid "B<--domain> guest" -msgstr "" +msgstr "B<--domain> гість" #. type: textblock -#: ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145 -#: ../cat/virt-ls.pod:311 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 -#: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121 +#: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95 +#: ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 +#: ../clone/virt-sysprep.pod:73 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 +#: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:149 msgid "" "Add all the disks from the named libvirt guest. Domain UUIDs can be used " "instead of names." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148 -#: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217 -#: ../fuse/guestmount.pod:126 ../inspector/virt-inspector.pod:92 -msgid "B<--echo-keys>" -msgstr "B<--echo-keys>" - -#. type: textblock -#: ../cat/virt-cat.pod:100 -msgid "" -"When prompting for keys and passphrases, virt-cat normally turns echoing off " -"so you cannot see what you are typing. If you are not worried about Tempest " -"attacks and there is no one else in the room you can specify this flag to " -"see what you are typing." -msgstr "" - -#. type: =item -#: ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 -#: ../cat/virt-ls.pod:328 ../df/virt-df.pod:101 ../fish/guestfish.pod:233 -#: ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99 -#: ../rescue/virt-rescue.pod:124 +#: ../align/virt-alignment-scan.pod:123 ../cat/virt-cat.pod:105 +#: ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 +#: ../clone/virt-sysprep.pod:95 ../df/virt-df.pod:101 +#: ../fish/guestfish.pod:233 ../fuse/guestmount.pod:142 +#: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:152 msgid "B<--format=raw|qcow2|..>" msgstr "B<--format=raw|qcow2|..>" #. type: =item -#: ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172 -#: ../cat/virt-ls.pod:330 ../df/virt-df.pod:103 ../edit/virt-edit.pod:134 -#: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:135 -#: ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:126 +#: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:107 +#: ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330 +#: ../clone/virt-sysprep.pod:97 ../df/virt-df.pod:103 +#: ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235 +#: ../fuse/guestmount.pod:144 ../inspector/virt-inspector.pod:101 +#: ../rescue/virt-rescue.pod:154 msgid "B<--format>" msgstr "B<--format>" #. type: textblock -#: ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174 -#: ../cat/virt-ls.pod:332 ../df/virt-df.pod:105 ../edit/virt-edit.pod:136 -#: ../fish/guestfish.pod:237 ../fuse/guestmount.pod:137 -#: ../rescue/virt-rescue.pod:128 +#: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:109 +#: ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 +#: ../clone/virt-sysprep.pod:99 ../df/virt-df.pod:105 +#: ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237 +#: ../fuse/guestmount.pod:146 ../rescue/virt-rescue.pod:156 msgid "" "The default for the I<-a> option is to auto-detect the format of the disk " "image. Using this forces the disk format for I<-a> options which follow on " @@ -419,60 +431,56 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 -#: ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 -#: ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 -#: ../inspector/virt-inspector.pod:336 ../rescue/virt-rescue.pod:133 -#: ../src/guestfs.pod:2788 +#: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114 +#: ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 +#: ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110 +#: ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 +#: ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:351 +#: ../rescue/virt-rescue.pod:161 ../src/guestfs.pod:2877 msgid "For example:" msgstr "Приклад:" #. type: verbatim -#: ../cat/virt-cat.pod:116 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img\n" -#| "\n" +#: ../align/virt-alignment-scan.pod:134 +#, no-wrap msgid "" -" virt-cat --format=raw -a disk.img file\n" +" virt-alignment-scan --format=raw -a disk.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img\n" -"\n" #. type: textblock -#: ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183 -#: ../cat/virt-ls.pod:341 ../df/virt-df.pod:114 ../edit/virt-edit.pod:145 -#: ../fish/guestfish.pod:246 ../rescue/virt-rescue.pod:137 +#: ../align/virt-alignment-scan.pod:136 ../cat/virt-cat.pod:118 +#: ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 +#: ../clone/virt-sysprep.pod:108 ../df/virt-df.pod:114 +#: ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 +#: ../rescue/virt-rescue.pod:165 msgid "forces raw format (no auto-detection) for C." msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:120 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#: ../align/virt-alignment-scan.pod:138 +#, no-wrap msgid "" -" virt-cat --format=raw -a disk.img --format -a another.img file\n" +" virt-alignment-scan --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" #. type: textblock -#: ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187 -#: ../cat/virt-ls.pod:345 ../df/virt-df.pod:118 ../edit/virt-edit.pod:149 -#: ../fish/guestfish.pod:250 ../rescue/virt-rescue.pod:141 +#: ../align/virt-alignment-scan.pod:140 ../cat/virt-cat.pod:122 +#: ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 +#: ../clone/virt-sysprep.pod:112 ../df/virt-df.pod:118 +#: ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 +#: ../rescue/virt-rescue.pod:169 msgid "" "forces raw format (no auto-detection) for C and reverts to auto-" "detection for C." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190 -#: ../cat/virt-ls.pod:348 ../df/virt-df.pod:121 ../edit/virt-edit.pod:152 -#: ../rescue/virt-rescue.pod:144 +#: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125 +#: ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 +#: ../clone/virt-sysprep.pod:115 ../df/virt-df.pod:121 +#: ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:172 msgid "" "If you have untrusted raw-format guest disk images, you should use this " "option to specify the disk format. This avoids a possible security problem " @@ -480,227 +488,397 @@ msgid "" msgstr "" #. type: =item -#: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200 -#: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289 -#: ../fuse/guestmount.pod:163 ../inspector/virt-inspector.pod:114 -msgid "B<--keys-from-stdin>" -msgstr "B<--keys-from-stdin>" +#: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:497 +#: ../sparsify/virt-sparsify.pod:177 +msgid "B<-q>" +msgstr "B<-q>" + +#. type: =item +#: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:499 +#: ../sparsify/virt-sparsify.pod:179 +msgid "B<--quiet>" +msgstr "B<--quiet>" #. type: textblock -#: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202 -#: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291 -#: ../fuse/guestmount.pod:165 ../inspector/virt-inspector.pod:116 +#: ../align/virt-alignment-scan.pod:151 msgid "" -"Read key or passphrase parameters from stdin. The default is to try to read " -"passphrases from the user by opening C." +"Don't produce any output. Just set the exit code (see L " +"below)." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261 -#: ../cat/virt-ls.pod:425 ../df/virt-df.pod:173 ../edit/virt-edit.pod:161 -#: ../fish/guestfish.pod:390 ../fuse/guestmount.pod:257 -#: ../inspector/virt-inspector.pod:119 ../rescue/virt-rescue.pod:182 +#: ../align/virt-alignment-scan.pod:154 ../cat/virt-cat.pod:134 +#: ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425 +#: ../clone/virt-sysprep.pod:138 ../df/virt-df.pod:173 +#: ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390 +#: ../fuse/guestmount.pod:266 ../inspector/virt-inspector.pod:119 +#: ../rescue/virt-rescue.pod:219 ../sparsify/virt-sparsify.pod:183 msgid "B<-v>" msgstr "B<-v>" #. type: =item -#: ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263 -#: ../cat/virt-ls.pod:427 ../df/virt-df.pod:175 ../edit/virt-edit.pod:163 -#: ../fish/guestfish.pod:392 ../fuse/guestmount.pod:259 -#: ../inspector/virt-inspector.pod:121 ../rescue/virt-rescue.pod:184 +#: ../align/virt-alignment-scan.pod:156 ../cat/virt-cat.pod:136 +#: ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427 +#: ../clone/virt-sysprep.pod:140 ../df/virt-df.pod:175 +#: ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392 +#: ../fuse/guestmount.pod:268 ../inspector/virt-inspector.pod:121 +#: ../rescue/virt-rescue.pod:221 ../sparsify/virt-sparsify.pod:185 msgid "B<--verbose>" msgstr "B<--verbose>" #. type: textblock -#: ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265 -#: ../cat/virt-ls.pod:429 ../df/virt-df.pod:177 ../edit/virt-edit.pod:165 -#: ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:186 +#: ../align/virt-alignment-scan.pod:158 ../cat/virt-cat.pod:138 +#: ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429 +#: ../clone/virt-sysprep.pod:142 ../df/virt-df.pod:177 +#: ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123 +#: ../rescue/virt-rescue.pod:223 ../sparsify/virt-sparsify.pod:187 msgid "Enable verbose messages for debugging." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 -#: ../cat/virt-ls.pod:431 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167 -#: ../fish/guestfish.pod:397 ../fuse/guestmount.pod:263 -#: ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:188 -#: ../resize/virt-resize.pod:484 +#: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140 +#: ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 +#: ../clone/virt-sysprep.pod:144 ../df/virt-df.pod:179 +#: ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397 +#: ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:125 +#: ../rescue/virt-rescue.pod:225 ../resize/virt-resize.pod:567 +#: ../sparsify/virt-sparsify.pod:189 msgid "B<-V>" msgstr "B<-V>" #. type: =item -#: ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 -#: ../cat/virt-ls.pod:433 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169 -#: ../fish/guestfish.pod:399 ../fuse/guestmount.pod:265 -#: ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:190 -#: ../resize/virt-resize.pod:486 ../tools/virt-list-filesystems.pl:69 +#: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142 +#: ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 +#: ../clone/virt-sysprep.pod:146 ../df/virt-df.pod:181 +#: ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399 +#: ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:127 +#: ../rescue/virt-rescue.pod:227 ../resize/virt-resize.pod:569 +#: ../sparsify/virt-sparsify.pod:191 ../tools/virt-list-filesystems.pl:69 #: ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169 #: ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112 msgid "B<--version>" msgstr "B<--version>" #. type: textblock -#: ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 -#: ../cat/virt-ls.pod:435 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171 -#: ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:192 -#: ../resize/virt-resize.pod:488 ../tools/virt-list-filesystems.pl:71 +#: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:144 +#: ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 +#: ../clone/virt-sysprep.pod:148 ../df/virt-df.pod:183 +#: ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129 +#: ../rescue/virt-rescue.pod:229 ../resize/virt-resize.pod:571 +#: ../sparsify/virt-sparsify.pod:193 ../tools/virt-list-filesystems.pl:71 #: ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 #: ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114 msgid "Display version number and exit." msgstr "Показати дані щодо версії і завершити роботу." #. type: =item -#: ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281 -#: ../cat/virt-ls.pod:437 ../df/virt-df.pod:185 ../edit/virt-edit.pod:173 -#: ../fish/guestfish.pod:412 ../fuse/guestmount.pod:278 -#: ../inspector/virt-inspector.pod:131 ../rescue/virt-rescue.pod:203 +#: ../align/virt-alignment-scan.pod:166 ../cat/virt-cat.pod:146 +#: ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437 +#: ../clone/virt-sysprep.pod:150 ../df/virt-df.pod:185 +#: ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412 +#: ../fuse/guestmount.pod:287 ../inspector/virt-inspector.pod:131 +#: ../rescue/virt-rescue.pod:240 ../sparsify/virt-sparsify.pod:195 #: ../tools/virt-tar.pl:158 msgid "B<-x>" msgstr "B<-x>" #. type: textblock -#: ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283 -#: ../cat/virt-ls.pod:439 ../df/virt-df.pod:187 ../edit/virt-edit.pod:175 -#: ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:205 +#: ../align/virt-alignment-scan.pod:168 ../cat/virt-cat.pod:148 +#: ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439 +#: ../clone/virt-sysprep.pod:152 ../df/virt-df.pod:187 +#: ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133 +#: ../rescue/virt-rescue.pod:242 ../sparsify/virt-sparsify.pod:197 msgid "Enable tracing of libguestfs API calls." msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179 -#: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:209 -msgid "OLD-STYLE COMMAND LINE ARGUMENTS" +#: ../align/virt-alignment-scan.pod:172 +msgid "RECOMMENDED ALIGNMENT" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:154 -msgid "Previous versions of virt-cat allowed you to write either:" +#: ../align/virt-alignment-scan.pod:174 +msgid "" +"Operating systems older than Windows 2008 and Linux before ca.2010 place the " +"first sector of the first partition at sector 63, with a 512 byte sector " +"size. This happens because of a historical accident. Drives have to report " +"a cylinder / head / sector (CHS) geometry to the BIOS. The geometry is " +"completely meaningless on modern drives, but it happens that the geometry " +"reported always has 63 sectors per track. The operating system therefore " +"places the first partition at the start of the second \"track\", at sector " +"63." +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:183 +msgid "" +"When the guest OS is virtualized, the host operating system and hypervisor " +"may prefer accesses aligned to one of:" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:188 +msgid "* 512 bytes" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:190 +msgid "" +"if the host OS uses local storage directly on hard drive partitions, and the " +"hard drive has 512 byte physical sectors." +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:193 +msgid "* 4 Kbytes" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:195 +msgid "" +"for local storage on new hard drives with 4Kbyte physical sectors; for file-" +"backed storage on filesystems with 4Kbyte block size; or for some types of " +"network-attached storage." +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:199 +msgid "* 64 Kbytes" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:201 +msgid "" +"for high-end network-attached storage. This is the optimal block size for " +"some NetApp hardware." +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:204 +msgid "* 1 Mbyte" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:206 +msgid "see L below." +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:210 +msgid "" +"Partitions which are not aligned correctly to the underlying storage cause " +"extra I/O. For example:" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:156 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#: ../align/virt-alignment-scan.pod:213 +#, no-wrap msgid "" -" virt-cat disk.img [disk.img ...] file\n" +" sect#63\n" +" +--------------------------+------\n" +" | guest |\n" +" | filesystem block |\n" +" ---+------------------+------+-------------------+-----+---\n" +" | host block | host block |\n" +" | | |\n" +" ---+-------------------------+-------------------------+---\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:222 +msgid "" +"In this example, each time a 4K guest block is read, two blocks on the host " +"must be accessed (so twice as much I/O is done). When a 4K guest block is " +"written, two host blocks must first be read, the old and new data combined, " +"and the two blocks written back (4x I/O)." +msgstr "" + +#. type: =head2 +#: ../align/virt-alignment-scan.pod:227 +msgid "LINUX HOST BLOCK AND I/O SIZE" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:229 +msgid "" +"New versions of the Linux kernel expose the physical and logical block size, " +"and minimum and recommended I/O size." +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:232 +msgid "For a typical consumer hard drive with 512 byte sectors:" +msgstr "" + +#. type: verbatim +#: ../align/virt-alignment-scan.pod:234 +#, no-wrap +msgid "" +" $ cat /sys/block/sda/queue/hw_sector_size\n" +" 512\n" +" $ cat /sys/block/sda/queue/physical_block_size\n" +" 512\n" +" $ cat /sys/block/sda/queue/logical_block_size\n" +" 512\n" +" $ cat /sys/block/sda/queue/minimum_io_size\n" +" 512\n" +" $ cat /sys/block/sda/queue/optimal_io_size\n" +" 0\n" +"\n" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:245 +msgid "For a new consumer hard drive with 4Kbyte sectors:" +msgstr "" + +#. type: verbatim +#: ../align/virt-alignment-scan.pod:247 +#, no-wrap +msgid "" +" $ cat /sys/block/sda/queue/hw_sector_size\n" +" 4096\n" +" $ cat /sys/block/sda/queue/physical_block_size\n" +" 4096\n" +" $ cat /sys/block/sda/queue/logical_block_size\n" +" 4096\n" +" $ cat /sys/block/sda/queue/minimum_io_size\n" +" 4096\n" +" $ cat /sys/block/sda/queue/optimal_io_size\n" +" 0\n" "\n" +msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 -#: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:215 -#, fuzzy -#| msgid "or:" -msgid "or" -msgstr "або:" +#: ../align/virt-alignment-scan.pod:258 +msgid "For a NetApp LUN:" +msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:160 +#: ../align/virt-alignment-scan.pod:260 #, no-wrap msgid "" -" virt-cat guestname file\n" +" $ cat /sys/block/sdc/queue/logical_block_size\n" +" 512\n" +" $ cat /sys/block/sdc/queue/physical_block_size\n" +" 512\n" +" $ cat /sys/block/sdc/queue/minimum_io_size\n" +" 4096\n" +" $ cat /sys/block/sdc/queue/optimal_io_size\n" +" 65536\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 -#: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:219 +#: ../align/virt-alignment-scan.pod:269 msgid "" -"whereas in this version you should use I<-a> or I<-d> respectively to avoid " -"the confusing case where a disk image might have the same name as a guest." +"The NetApp allows 512 byte accesses (but they will be very inefficient), " +"prefers a minimum 4K I/O size, but the optimal I/O size is 64K." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193 -#: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:223 -msgid "For compatibility the old style is still supported." +#: ../align/virt-alignment-scan.pod:273 +msgid "" +"For detailed information about what these numbers mean, see L" msgstr "" -#. type: =head1 -#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297 -msgid "USING GUESTFISH" +#. type: textblock +#: ../align/virt-alignment-scan.pod:276 +msgid "" +"[Thanks to Matt Booth for providing 4K drive data. Thanks to Mike Snitzer " +"for providing NetApp data and additional information.]" +msgstr "" + +#. type: =head2 +#: ../align/virt-alignment-scan.pod:279 +msgid "1 MB PARTITION ALIGNMENT" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:170 +#: ../align/virt-alignment-scan.pod:281 msgid "" -"L is a more powerful, lower level tool which you can use when " -"C doesn't work." +"Microsoft picked 1 MB as the default alignment for all partitions starting " +"with Windows 2008 Server, and Linux has followed this." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:173 -msgid "Using C is approximately equivalent to doing:" +#: ../align/virt-alignment-scan.pod:284 +msgid "" +"Assuming 512 byte sectors in the guest, you will now see the first partition " +"starting at sector 2048, and subsequent partitions (if any) will start at a " +"multiple of 2048 sectors." msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:175 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --ro -d myguest -i\n" -#| "\n" +#. type: textblock +#: ../align/virt-alignment-scan.pod:288 msgid "" -" guestfish --ro -i -d domname download file -\n" -"\n" +"1 MB alignment is compatible with all current alignment requirements (4K, " +"64K) and provides room for future growth in physical block sizes." +msgstr "" + +#. type: =head2 +#: ../align/virt-alignment-scan.pod:291 +msgid "SETTING ALIGNMENT" msgstr "" -" guestfish --ro -d myguest -i\n" -"\n" #. type: textblock -#: ../cat/virt-cat.pod:177 +#: ../align/virt-alignment-scan.pod:293 msgid "" -"where C is the name of the libvirt guest, and C is the full " -"path to the file. Note the final C<-> (meaning \"output to stdout\")." +"L can change the alignment of the partitions of some " +"guests. Currently it can fully align all the partitions of all Windows " +"guests, and it will fix the bootloader where necessary. For Linux guests, " +"it can align the second and subsequent partitions, so the majority of OS " +"accesses except at boot will be aligned." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:181 +#: ../align/virt-alignment-scan.pod:299 msgid "" -"The command above uses libguestfs's guest inspection feature and so does not " -"work on guests that libguestfs cannot inspect, or on things like arbitrary " -"disk images that don't contain guests. To display a file from a disk image " -"directly, use:" +"Another way to correct partition alignment problems is to reinstall your " +"guest operating systems. If you install operating systems from templates, " +"ensure these have correct partition alignment too." msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:186 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish [--ro] -i disk.img\n" -#| "\n" +#. type: textblock +#: ../align/virt-alignment-scan.pod:303 msgid "" -" guestfish --ro -a disk.img -m /dev/sda1 download file -\n" -"\n" +"For older versions of Windows, the following NetApp document contains useful " +"information: L" msgstr "" -" guestfish [--ro] -i disk.img\n" -"\n" #. type: textblock -#: ../cat/virt-cat.pod:188 +#: ../align/virt-alignment-scan.pod:306 msgid "" -"where C is the disk image, C is the filesystem within " -"the disk image, and C is the full path to the file." +"For Red Hat Enterprise Linux E 5, use a Kickstart script that contains " +"an explicit C<%pre> section that creates aligned partitions using L. Do not use the Kickstart C command. The NetApp document above " +"contains an example." msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:191 ../cat/virt-filesystems.pod:365 -#: ../cat/virt-ls.pod:483 ../df/virt-df.pod:215 ../edit/virt-edit.pod:342 -#: ../inspector/virt-inspector.pod:352 ../rescue/virt-rescue.pod:266 -#: ../resize/virt-resize.pod:601 ../tools/virt-list-filesystems.pl:188 -#: ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532 -#: ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733 +#: ../align/virt-alignment-scan.pod:311 ../cat/virt-cat.pod:231 +#: ../cat/virt-filesystems.pod:373 ../cat/virt-ls.pod:483 +#: ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:241 +#: ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:367 +#: ../rescue/virt-rescue.pod:303 ../resize/virt-resize.pod:682 +#: ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258 +#: ../tools/virt-make-fs.pl:550 ../tools/virt-tar.pl:289 +#: ../tools/virt-win-reg.pl:744 msgid "SHELL QUOTING" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:193 ../cat/virt-filesystems.pod:367 -#: ../cat/virt-ls.pod:485 ../df/virt-df.pod:217 ../edit/virt-edit.pod:344 -#: ../inspector/virt-inspector.pod:354 ../rescue/virt-rescue.pod:268 -#: ../resize/virt-resize.pod:603 ../tools/virt-list-filesystems.pl:190 -#: ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534 -#: ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741 +#: ../align/virt-alignment-scan.pod:313 ../cat/virt-cat.pod:233 +#: ../cat/virt-filesystems.pod:375 ../cat/virt-ls.pod:485 +#: ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:243 +#: ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:369 +#: ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:684 +#: ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 +#: ../tools/virt-make-fs.pl:552 ../tools/virt-tar.pl:291 +#: ../tools/virt-win-reg.pl:752 msgid "" "Libvirt guest names can contain arbitrary characters, some of which have " "meaning to the shell such as C<#> and space. You may need to quote or " @@ -709,115 +887,242 @@ msgid "" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:198 ../cat/virt-filesystems.pod:372 -#: ../cat/virt-ls.pod:490 ../df/virt-df.pod:222 ../edit/virt-edit.pod:349 -#: ../fish/guestfish.pod:1081 ../fuse/guestmount.pod:303 -#: ../inspector/virt-inspector.pod:375 ../resize/virt-resize.pod:608 +#: ../align/virt-alignment-scan.pod:318 ../cat/virt-cat.pod:238 +#: ../cat/virt-filesystems.pod:380 ../cat/virt-ls.pod:490 +#: ../clone/virt-sysprep.pod:482 ../df/virt-df.pod:248 +#: ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1114 +#: ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:390 +#: ../resize/virt-resize.pod:689 ../sparsify/virt-sparsify.pod:251 #: ../test-tool/libguestfs-test-tool.pod:90 msgid "EXIT STATUS" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:200 ../cat/virt-filesystems.pod:374 -#: ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351 -#: ../fuse/guestmount.pod:305 ../inspector/virt-inspector.pod:377 -#: ../resize/virt-resize.pod:610 +#: ../align/virt-alignment-scan.pod:320 +msgid "This program returns:" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:324 ../align/virt-alignment-scan.pod:330 +#: ../align/virt-alignment-scan.pod:336 ../align/virt-alignment-scan.pod:343 +#: ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 +#: ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 +#: ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 +#: ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 +#: ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 +#: ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322 +#: ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362 +#: ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388 +#: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 +#: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 +#: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 +#: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 +#: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 +#: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 +#: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 +#: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 +#: ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 +#: ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:13 +#: ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:441 +#: ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:456 +#: ../fish/guestfish-actions.pod:463 ../fish/guestfish-actions.pod:1262 +#: ../fish/guestfish-actions.pod:1266 ../fish/guestfish-actions.pod:1270 +#: ../fish/guestfish-actions.pod:1274 ../fish/guestfish-actions.pod:1282 +#: ../fish/guestfish-actions.pod:1286 ../fish/guestfish-actions.pod:1290 +#: ../fish/guestfish-actions.pod:1300 ../fish/guestfish-actions.pod:1304 +#: ../fish/guestfish-actions.pod:1308 ../fish/guestfish-actions.pod:1398 +#: ../fish/guestfish-actions.pod:1402 ../fish/guestfish-actions.pod:1407 +#: ../fish/guestfish-actions.pod:1412 ../fish/guestfish-actions.pod:1454 +#: ../fish/guestfish-actions.pod:1458 ../fish/guestfish-actions.pod:1463 +#: ../fish/guestfish-actions.pod:1719 ../fish/guestfish-actions.pod:1726 +#: ../fish/guestfish-actions.pod:1733 ../fish/guestfish-actions.pod:2136 +#: ../fish/guestfish-actions.pod:2142 ../fish/guestfish-actions.pod:2150 +#: ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2164 +#: ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 +#: ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 +#: ../inspector/virt-inspector.pod:408 ../inspector/virt-inspector.pod:412 +#: ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 +#: ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 +#: ../sparsify/virt-sparsify.pod:32 ../sparsify/virt-sparsify.pod:39 +#: ../sparsify/virt-sparsify.pod:43 ../sparsify/virt-sparsify.pod:49 +#: ../sparsify/virt-sparsify.pod:54 ../sparsify/virt-sparsify.pod:58 +#: ../sparsify/virt-sparsify.pod:64 ../src/guestfs-actions.pod:22 +#: ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:641 +#: ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:656 +#: ../src/guestfs-actions.pod:663 ../src/guestfs-actions.pod:2079 +#: ../src/guestfs-actions.pod:2083 ../src/guestfs-actions.pod:2087 +#: ../src/guestfs-actions.pod:2091 ../src/guestfs-actions.pod:2099 +#: ../src/guestfs-actions.pod:2103 ../src/guestfs-actions.pod:2107 +#: ../src/guestfs-actions.pod:2117 ../src/guestfs-actions.pod:2121 +#: ../src/guestfs-actions.pod:2125 ../src/guestfs-actions.pod:2263 +#: ../src/guestfs-actions.pod:2267 ../src/guestfs-actions.pod:2272 +#: ../src/guestfs-actions.pod:2277 ../src/guestfs-actions.pod:2338 +#: ../src/guestfs-actions.pod:2342 ../src/guestfs-actions.pod:2347 +#: ../src/guestfs-actions.pod:2762 ../src/guestfs-actions.pod:2769 +#: ../src/guestfs-actions.pod:2776 ../src/guestfs-actions.pod:3321 +#: ../src/guestfs-actions.pod:3327 ../src/guestfs-actions.pod:3335 +#: ../src/guestfs-actions.pod:3342 ../src/guestfs-actions.pod:3349 +#: ../src/guestfs.pod:403 ../src/guestfs.pod:408 ../src/guestfs.pod:413 +#: ../src/guestfs.pod:417 ../src/guestfs.pod:422 ../src/guestfs.pod:426 +#: ../src/guestfs.pod:431 ../src/guestfs.pod:436 ../src/guestfs.pod:1109 +#: ../src/guestfs.pod:1113 ../src/guestfs.pod:1117 ../src/guestfs.pod:1122 +#: ../src/guestfs.pod:1130 ../src/guestfs.pod:1149 ../src/guestfs.pod:1157 +#: ../src/guestfs.pod:1179 ../src/guestfs.pod:1183 ../src/guestfs.pod:1187 +#: ../src/guestfs.pod:1191 ../src/guestfs.pod:1195 ../src/guestfs.pod:1199 +#: ../src/guestfs.pod:1689 ../src/guestfs.pod:1694 ../src/guestfs.pod:1698 +#: ../src/guestfs.pod:1800 ../src/guestfs.pod:1805 ../src/guestfs.pod:1809 +#: ../src/guestfs.pod:1819 ../src/guestfs.pod:2108 ../src/guestfs.pod:2113 +#: ../src/guestfs.pod:2119 ../src/guestfs.pod:2127 ../src/guestfs.pod:2645 +#: ../src/guestfs.pod:2651 ../src/guestfs.pod:2656 ../src/guestfs.pod:2662 +#: ../src/guestfs.pod:3067 ../src/guestfs.pod:3072 ../src/guestfs.pod:3076 +#: ../src/guestfs.pod:3080 ../src/guestfs.pod:3084 ../src/guestfs.pod:3098 +#: ../src/guestfs.pod:3103 ../src/guestfs.pod:3335 ../src/guestfs.pod:3339 +#: ../src/guestfs.pod:3343 ../src/guestfs.pod:3347 +#: ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 +#: ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:721 +#: ../tools/virt-win-reg.pl:727 ../tools/virt-win-reg.pl:733 +msgid "*" +msgstr "*" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:326 +msgid "0" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:328 msgid "" -"This program returns 0 if successful, or non-zero if there was an error." +"successful exit, all partitions are aligned E 64K for best performance" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:332 +msgid "1" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:334 +msgid "an error scanning the disk image or guest" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:338 +msgid "2" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:340 +msgid "" +"successful exit, some partitions have alignment E 64K which can result " +"in poor performance on high end network storage" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:345 +msgid "3" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:347 +msgid "" +"successful exit, some partitions have alignment E 4K which can result in " +"poor performance on most hypervisors" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:203 ../cat/virt-filesystems.pod:377 -#: ../cat/virt-ls.pod:495 ../df/virt-df.pod:227 ../edit/virt-edit.pod:354 -#: ../erlang/examples/guestfs-erlang.pod:97 +#: ../align/virt-alignment-scan.pod:352 ../cat/virt-cat.pod:243 +#: ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 +#: ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:253 +#: ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97 #: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 -#: ../fish/guestfish.pod:1235 ../fish/virt-copy-in.pod:50 -#: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 -#: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:308 -#: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45 -#: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 -#: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:288 -#: ../resize/virt-resize.pod:613 ../ruby/examples/guestfs-ruby.pod:36 -#: ../src/guestfs.pod:3164 ../test-tool/libguestfs-test-tool.pod:100 +#: ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1268 +#: ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 +#: ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 +#: ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:395 +#: ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 +#: ../perl/examples/guestfs-perl.pod:39 +#: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:325 +#: ../resize/virt-resize.pod:694 ../ruby/examples/guestfs-ruby.pod:36 +#: ../sparsify/virt-sparsify.pod:275 ../src/guestfs.pod:3275 +#: ../test-tool/libguestfs-test-tool.pod:100 #: ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265 -#: ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296 -#: ../tools/virt-win-reg.pl:746 +#: ../tools/virt-make-fs.pl:557 ../tools/virt-tar.pl:296 +#: ../tools/virt-win-reg.pl:757 msgid "SEE ALSO" msgstr "ТАКОЖ ПЕРЕГЛЯНЬТЕ" #. type: textblock -#: ../cat/virt-cat.pod:205 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." +#: ../align/virt-alignment-scan.pod:354 msgid "" -"L, L, L, L, L, L." +"L, L, L, L, " +"L, L." msgstr "" -"L, L, L, L, L, L, L, L, L." #. type: =head1 -#: ../cat/virt-cat.pod:212 ../cat/virt-filesystems.pod:388 -#: ../cat/virt-ls.pod:507 ../df/virt-df.pod:235 ../edit/virt-edit.pod:368 -#: ../rescue/virt-rescue.pod:296 ../resize/virt-resize.pod:634 +#: ../align/virt-alignment-scan.pod:361 ../cat/virt-cat.pod:252 +#: ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507 +#: ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:261 +#: ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:334 +#: ../resize/virt-resize.pod:717 ../sparsify/virt-sparsify.pod:288 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277 -#: ../tools/virt-make-fs.pl:564 ../tools/virt-tar.pl:311 -#: ../tools/virt-win-reg.pl:772 +#: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:311 +#: ../tools/virt-win-reg.pl:783 msgid "AUTHOR" msgstr "АВТОР" #. type: textblock -#: ../cat/virt-cat.pod:214 ../cat/virt-filesystems.pod:390 -#: ../cat/virt-ls.pod:509 ../df/virt-df.pod:237 ../edit/virt-edit.pod:370 -#: ../inspector/virt-inspector.pod:395 ../rescue/virt-rescue.pod:298 -#: ../resize/virt-resize.pod:636 ../tools/virt-list-filesystems.pl:210 -#: ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:566 -#: ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:774 +#: ../align/virt-alignment-scan.pod:363 ../cat/virt-cat.pod:254 +#: ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509 +#: ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:263 +#: ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:410 +#: ../rescue/virt-rescue.pod:336 ../resize/virt-resize.pod:719 +#: ../sparsify/virt-sparsify.pod:290 ../tools/virt-list-filesystems.pl:210 +#: ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:584 +#: ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785 msgid "Richard W.M. Jones L" msgstr "Richard W.M. Jones L" #. type: =head1 -#: ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:392 -#: ../cat/virt-ls.pod:511 ../df/virt-df.pod:239 ../edit/virt-edit.pod:372 -#: ../erlang/examples/guestfs-erlang.pod:114 +#: ../align/virt-alignment-scan.pod:365 ../cat/virt-cat.pod:256 +#: ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 +#: ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:265 +#: ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 #: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 -#: ../fish/guestfish.pod:1264 ../fish/virt-copy-in.pod:64 -#: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 -#: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:323 -#: ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:62 -#: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 -#: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:300 -#: ../resize/virt-resize.pod:638 ../ruby/examples/guestfs-ruby.pod:52 -#: ../src/guestfs.pod:3241 ../test-tool/libguestfs-test-tool.pod:110 +#: ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1300 +#: ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 +#: ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 +#: ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:418 +#: ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 +#: ../perl/examples/guestfs-perl.pod:56 +#: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:338 +#: ../resize/virt-resize.pod:721 ../ruby/examples/guestfs-ruby.pod:52 +#: ../sparsify/virt-sparsify.pod:292 ../src/guestfs.pod:3358 +#: ../test-tool/libguestfs-test-tool.pod:110 #: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 -#: ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315 -#: ../tools/virt-win-reg.pl:776 +#: ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:315 +#: ../tools/virt-win-reg.pl:787 msgid "COPYRIGHT" msgstr "АВТОРСЬКІ ПРАВА" #. type: textblock -#: ../cat/virt-cat.pod:218 ../inspector/virt-inspector.pod:405 -#: ../resize/virt-resize.pod:640 -#, fuzzy -#| msgid "Copyright (C) 2009-2010 Red Hat Inc." -msgid "Copyright (C) 2010-2011 Red Hat Inc." -msgstr "© Red Hat Inc., 2009–2010" +#: ../align/virt-alignment-scan.pod:367 ../clone/virt-sysprep.pod:507 +#: ../sparsify/virt-sparsify.pod:294 +msgid "Copyright (C) 2011 Red Hat Inc." +msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:220 ../cat/virt-filesystems.pod:396 -#: ../cat/virt-ls.pod:515 ../df/virt-df.pod:243 ../edit/virt-edit.pod:376 -#: ../fish/guestfish.pod:1269 ../fish/virt-copy-in.pod:69 -#: ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 -#: ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:328 -#: ../inspector/virt-inspector.pod:407 ../rescue/virt-rescue.pod:304 -#: ../resize/virt-resize.pod:642 ../test-tool/libguestfs-test-tool.pod:115 +#: ../align/virt-alignment-scan.pod:369 ../cat/virt-cat.pod:260 +#: ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515 +#: ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:269 +#: ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1305 +#: ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 +#: ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 +#: ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:422 +#: ../rescue/virt-rescue.pod:342 ../resize/virt-resize.pod:725 +#: ../sparsify/virt-sparsify.pod:296 ../test-tool/libguestfs-test-tool.pod:115 #: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285 -#: ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319 -#: ../tools/virt-win-reg.pl:780 +#: ../tools/virt-make-fs.pl:590 ../tools/virt-tar.pl:319 +#: ../tools/virt-win-reg.pl:791 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 " @@ -826,16 +1131,18 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:225 ../cat/virt-filesystems.pod:401 -#: ../cat/virt-ls.pod:520 ../df/virt-df.pod:248 ../edit/virt-edit.pod:381 -#: ../fish/guestfish.pod:1274 ../fish/virt-copy-in.pod:74 -#: ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 -#: ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:333 -#: ../inspector/virt-inspector.pod:412 ../rescue/virt-rescue.pod:309 -#: ../resize/virt-resize.pod:647 ../test-tool/libguestfs-test-tool.pod:120 +#: ../align/virt-alignment-scan.pod:374 ../cat/virt-cat.pod:265 +#: ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520 +#: ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:274 +#: ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1310 +#: ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 +#: ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 +#: ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:427 +#: ../rescue/virt-rescue.pod:347 ../resize/virt-resize.pod:730 +#: ../sparsify/virt-sparsify.pod:301 ../test-tool/libguestfs-test-tool.pod:120 #: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290 -#: ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324 -#: ../tools/virt-win-reg.pl:785 +#: ../tools/virt-make-fs.pl:595 ../tools/virt-tar.pl:324 +#: ../tools/virt-win-reg.pl:796 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 " @@ -848,164 +1155,614 @@ msgstr "" "дізнатися з GNU General Public License." #. type: textblock -#: ../cat/virt-cat.pod:230 ../cat/virt-filesystems.pod:406 -#: ../cat/virt-ls.pod:525 ../df/virt-df.pod:253 ../edit/virt-edit.pod:386 -#: ../fish/guestfish.pod:1279 ../fish/virt-copy-in.pod:79 -#: ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 -#: ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:338 -#: ../inspector/virt-inspector.pod:417 ../rescue/virt-rescue.pod:314 -#: ../resize/virt-resize.pod:652 ../test-tool/libguestfs-test-tool.pod:125 +#: ../align/virt-alignment-scan.pod:379 ../cat/virt-cat.pod:270 +#: ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525 +#: ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:279 +#: ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1315 +#: ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 +#: ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 +#: ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:432 +#: ../rescue/virt-rescue.pod:352 ../resize/virt-resize.pod:735 +#: ../sparsify/virt-sparsify.pod:306 ../test-tool/libguestfs-test-tool.pod:125 #: ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295 -#: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329 -#: ../tools/virt-win-reg.pl:790 +#: ../tools/virt-make-fs.pl:600 ../tools/virt-tar.pl:329 +#: ../tools/virt-win-reg.pl:801 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 " -"Ave, Cambridge, MA 02139, USA." +"this program; if not, write to the Free Software Foundation, Inc., 51 " +"Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA." msgstr "" +"Ви маєте отримати копію GNU General Public License разом з цією програмою; " +"якщо це не так, повідомте про факт за адресою Free Software Foundation, " +"Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA." #. type: textblock -#: ../cat/virt-filesystems.pod:5 -msgid "" -"virt-filesystems - List filesystems, partitions, block devices, LVM in a " -"virtual machine or disk image" -msgstr "" +#: ../cat/virt-cat.pod:5 +msgid "virt-cat - Display files in a virtual machine" +msgstr "virt-cat — показ файлів у віртуальній машині" #. type: verbatim -#: ../cat/virt-filesystems.pod:9 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#: ../cat/virt-cat.pod:9 +#, no-wrap msgid "" -" virt-filesystems [--options] -d domname\n" +" virt-cat [--options] -d domname file [file ...]\n" "\n" msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" +" virt-cat [--параметри] -d назва_домену файл [файл...]\n" "\n" #. type: verbatim -#: ../cat/virt-filesystems.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#: ../cat/virt-cat.pod:11 +#, no-wrap msgid "" -" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n" +" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" +" virt-cat [--параметри] -a диск.img [-a диск.img ...] файл [файл...]\n" "\n" #. type: textblock -#: ../cat/virt-filesystems.pod:15 -msgid "" -"This tool allows you to discover filesystems, partitions, logical volumes, " -"and their sizes in a disk image or virtual machine. It is a replacement for " -"L and L." -msgstr "" +#: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 +#: ../inspector/virt-inspector.pod:13 +msgid "Old-style:" +msgstr "Застарілий стиль:" -#. type: textblock -#: ../cat/virt-filesystems.pod:20 +#. type: verbatim +#: ../cat/virt-cat.pod:15 +#, no-wrap msgid "" -"One use for this tool is from shell scripts to iterate over all filesystems " -"from a disk image:" +" virt-cat domname file\n" +"\n" msgstr "" +" virt-cat назва_домену файл\n" +"\n" #. type: verbatim -#: ../cat/virt-filesystems.pod:23 +#: ../cat/virt-cat.pod:17 #, no-wrap msgid "" -" for fs in $(virt-filesystems -a disk.img); do\n" -" # ...\n" -" done\n" +" virt-cat disk.img file\n" "\n" msgstr "" +" virt-cat диск.img файл\n" +"\n" #. type: textblock -#: ../cat/virt-filesystems.pod:27 +#: ../cat/virt-cat.pod:21 msgid "" -"Another use is to list partitions before using another tool to modify those " -"partitions (such as L). If you are curious about what an " -"unknown disk image contains, use this tool along with L." +"C is a command line tool to display the contents of C where " +"C exists in the named virtual machine (or disk image)." msgstr "" +"C — інструмент командного рядка для показу вмісту C<файла>, який " +"зберігається у вказаній віртуальній машині (або образі диска)." #. type: textblock -#: ../cat/virt-filesystems.pod:32 +#: ../cat/virt-cat.pod:24 msgid "" -"Various command line options control what this program displays. You need " -"to give either I<-a> or I<-d> options to specify the disk image or libvirt " -"guest respectively. If you just specify that then the program shows " -"filesystems found, one per line, like this:" +"Multiple filenames can be given, in which case they are concatenated " +"together. Each filename must be a full path, starting at the root directory " +"(starting with '/')." msgstr "" +"Ви можете вказати декілька назв файлів. Вміст таких файлів буде об’єднано. " +"Назви файлів слід вказувати повністю (разом зі шляхом), починаючи з " +"кореневого каталогу (тобто назва має починатися з «/»)." -#. type: verbatim -#: ../cat/virt-filesystems.pod:37 -#, no-wrap +#. type: textblock +#: ../cat/virt-cat.pod:28 msgid "" -" $ virt-filesystems -a disk.img\n" -" /dev/sda1\n" -" /dev/vg_guest/lv_root\n" -"\n" +"C can be used to quickly view a file. To edit a file, use C. For more complex cases you should look at the L tool " +"(see L below)." msgstr "" +"C можна скористатися для пришвидшення перегляду файла. Для " +"редагування даних слід користуватися C. Для виконання складніших " +"дій можна скористатися програмою L (див. L " +"нижче)." + +#. type: =head1 +#: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43 +#: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41 +#: ../fish/guestfish.pod:1051 ../fish/virt-copy-in.pod:29 +#: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30 +#: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39 +#: ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:75 +#: ../tools/virt-tar.pl:50 +msgid "EXAMPLES" +msgstr "ПРИКЛАДИ" #. type: textblock -#: ../cat/virt-filesystems.pod:41 +#: ../cat/virt-cat.pod:34 msgid "" -"If you add I<-l> or I<--long> then the output includes extra information:" +"Display C file from inside the libvirt VM called C:" msgstr "" +"Показ файла C з віртуальної машини libvirt з назвою C:" #. type: verbatim -#: ../cat/virt-filesystems.pod:44 +#: ../cat/virt-cat.pod:37 #, no-wrap msgid "" -" $ virt-filesystems -a disk.img -l\n" -" Name Type VFS Label Size\n" -" /dev/sda1 filesystem ext4 boot 524288000\n" -" /dev/vg_guest/lv_root filesystem ext4 root 10212081664\n" +" virt-cat -d mydomain /etc/fstab\n" "\n" msgstr "" +" virt-cat -d mydomain /etc/fstab\n" +"\n" #. type: textblock -#: ../cat/virt-filesystems.pod:49 -msgid "" -"If you add I<--extra> then non-mountable (swap, unknown) filesystems are " -"shown as well:" +#: ../cat/virt-cat.pod:39 +msgid "List syslog messages from a VM disk image file:" msgstr "" +"Показ списку повідомлень syslog з файла образу диска віртуальної машини:" #. type: verbatim -#: ../cat/virt-filesystems.pod:52 +#: ../cat/virt-cat.pod:41 #, no-wrap msgid "" -" $ virt-filesystems -a disk.img --extra\n" -" /dev/sda1\n" -" /dev/vg_guest/lv_root\n" -" /dev/vg_guest/lv_swap\n" -" /dev/vg_guest/lv_data\n" +" virt-cat -a disk.img /var/log/messages | tail\n" "\n" msgstr "" +" virt-cat -a disk.img /var/log/messages | tail\n" +"\n" #. type: textblock -#: ../cat/virt-filesystems.pod:58 -msgid "" -"If you add I<--partitions> then partitions are shown instead of filesystems:" -msgstr "" +#: ../cat/virt-cat.pod:43 +msgid "Find out what DHCP IP address a VM acquired:" +msgstr "Визначення IP-адреси DHCP, використаної віртуальною машиною:" #. type: verbatim -#: ../cat/virt-filesystems.pod:60 +#: ../cat/virt-cat.pod:45 #, no-wrap msgid "" -" $ virt-filesystems -a disk.img --partitions\n" -" /dev/sda1\n" -" /dev/sda2\n" +" virt-cat -d mydomain /var/log/messages | \\\n" +" grep 'dhclient: bound to' | tail\n" "\n" msgstr "" +" virt-cat -d mydomain /var/log/messages | \\\n" +" grep 'dhclient: bound to' | tail\n" +"\n" #. type: textblock -#: ../cat/virt-filesystems.pod:64 -msgid "" -"Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-" -"volumes>, I<--block-devices> to list those items." +#: ../cat/virt-cat.pod:48 +msgid "Find out what packages were recently installed:" +msgstr "Пошук нещодавно встановлених пакунків:" + +#. type: verbatim +#: ../cat/virt-cat.pod:50 +#, no-wrap +msgid "" +" virt-cat -d mydomain /var/log/yum.log | tail\n" +"\n" +msgstr "" +" virt-cat -d mydomain /var/log/yum.log | tail\n" +"\n" + +#. type: textblock +#: ../cat/virt-cat.pod:52 +msgid "Find out who is logged on inside a virtual machine:" +msgstr "Визначення користувачів, які працюють у віртуальній машині:" + +#. type: verbatim +#: ../cat/virt-cat.pod:54 +#, no-wrap +msgid "" +" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" +"\n" +msgstr "" +" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" +"\n" + +#. type: textblock +#: ../cat/virt-cat.pod:57 +msgid "or who was logged on:" +msgstr "або тих, які у ній працювали:" + +#. type: verbatim +#: ../cat/virt-cat.pod:59 +#, no-wrap +msgid "" +" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" +"\n" +msgstr "" +" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" +"\n" + +#. type: textblock +#: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103 +#: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74 +#: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:124 +msgid "" +"Add I which should be a disk image from a virtual machine. If the " +"virtual machine has multiple block devices, you must supply all of them with " +"separate I<-a> options." +msgstr "" + +#. type: =item +#: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148 +#: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217 +#: ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:92 +msgid "B<--echo-keys>" +msgstr "B<--echo-keys>" + +#. type: textblock +#: ../cat/virt-cat.pod:100 +msgid "" +"When prompting for keys and passphrases, virt-cat normally turns echoing off " +"so you cannot see what you are typing. If you are not worried about Tempest " +"attacks and there is no one else in the room you can specify this flag to " +"see what you are typing." +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:116 +#, no-wrap +msgid "" +" virt-cat --format=raw -a disk.img file\n" +"\n" +msgstr "" +" virt-cat --format=raw -a disk.img file\n" +"\n" + +#. type: verbatim +#: ../cat/virt-cat.pod:120 +#, no-wrap +msgid "" +" virt-cat --format=raw -a disk.img --format -a another.img file\n" +"\n" +msgstr "" +" virt-cat --format=raw -a disk.img --format -a another.img file\n" +"\n" + +#. type: =item +#: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200 +#: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289 +#: ../fuse/guestmount.pod:172 ../inspector/virt-inspector.pod:114 +msgid "B<--keys-from-stdin>" +msgstr "B<--keys-from-stdin>" + +#. type: textblock +#: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202 +#: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291 +#: ../fuse/guestmount.pod:174 ../inspector/virt-inspector.pod:116 +msgid "" +"Read key or passphrase parameters from stdin. The default is to try to read " +"passphrases from the user by opening C." +msgstr "" + +#. type: =head1 +#: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179 +#: ../inspector/virt-inspector.pod:144 ../rescue/virt-rescue.pod:246 +msgid "OLD-STYLE COMMAND LINE ARGUMENTS" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:154 +msgid "Previous versions of virt-cat allowed you to write either:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:156 +#, no-wrap +msgid "" +" virt-cat disk.img [disk.img ...] file\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 +#: ../inspector/virt-inspector.pod:150 ../rescue/virt-rescue.pod:252 +msgid "or" +msgstr "або" + +#. type: verbatim +#: ../cat/virt-cat.pod:160 +#, no-wrap +msgid "" +" virt-cat guestname file\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 +#: ../inspector/virt-inspector.pod:154 ../rescue/virt-rescue.pod:256 +msgid "" +"whereas in this version you should use I<-a> or I<-d> respectively to avoid " +"the confusing case where a disk image might have the same name as a guest." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193 +#: ../inspector/virt-inspector.pod:158 ../rescue/virt-rescue.pod:260 +msgid "For compatibility the old style is still supported." +msgstr "" + +#. type: =head1 +#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858 +msgid "WINDOWS PATHS" +msgstr "ШЛЯХИ У WINDOWS" + +#. type: textblock +#: ../cat/virt-cat.pod:170 +msgid "" +"C has a limited ability to understand Windows drive letters and " +"paths (eg. C)." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:173 ../edit/virt-edit.pod:262 +msgid "If and only if the guest is running Windows then:" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:179 ../edit/virt-edit.pod:268 +msgid "" +"Drive letter prefixes like C are resolved against the Windows Registry " +"to the correct filesystem." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:184 ../edit/virt-edit.pod:273 +msgid "" +"Any backslash (C<\\>) characters in the path are replaced with forward " +"slashes so that libguestfs can process it." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:189 +msgid "" +"The path is resolved case insensitively to locate the file that should be " +"displayed." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:194 ../edit/virt-edit.pod:283 +msgid "There are some known shortcomings:" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:200 ../edit/virt-edit.pod:289 +msgid "Some NTFS symbolic links may not be followed correctly." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:204 ../edit/virt-edit.pod:293 +msgid "NTFS junction points that cross filesystems are not followed." +msgstr "" + +#. type: =head1 +#: ../cat/virt-cat.pod:208 ../edit/virt-edit.pod:297 +msgid "USING GUESTFISH" +msgstr "ВИКОРИСТАННЯ GUESTFISH" + +#. type: textblock +#: ../cat/virt-cat.pod:210 +msgid "" +"L is a more powerful, lower level tool which you can use when " +"C doesn't work." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:213 +msgid "Using C is approximately equivalent to doing:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:215 +#, no-wrap +msgid "" +" guestfish --ro -i -d domname download file -\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:217 +msgid "" +"where C is the name of the libvirt guest, and C is the full " +"path to the file. Note the final C<-> (meaning \"output to stdout\")." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:221 +msgid "" +"The command above uses libguestfs's guest inspection feature and so does not " +"work on guests that libguestfs cannot inspect, or on things like arbitrary " +"disk images that don't contain guests. To display a file from a disk image " +"directly, use:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:226 +#, no-wrap +msgid "" +" guestfish --ro -a disk.img -m /dev/sda1 download file -\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:228 +msgid "" +"where C is the disk image, C is the filesystem within " +"the disk image, and C is the full path to the file." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:382 +#: ../cat/virt-ls.pod:492 ../df/virt-df.pod:250 ../edit/virt-edit.pod:351 +#: ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:392 +#: ../resize/virt-resize.pod:691 ../sparsify/virt-sparsify.pod:253 +msgid "" +"This program returns 0 if successful, or non-zero if there was an error." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:245 +msgid "" +"L, L, L, L, L, L." +msgstr "" +"L, L, L, L, L, L." + +#. type: textblock +#: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:420 +#: ../resize/virt-resize.pod:723 ../tools/virt-make-fs.pl:588 +msgid "Copyright (C) 2010-2011 Red Hat Inc." +msgstr "©Red Hat Inc., 2010–2011" + +#. type: textblock +#: ../cat/virt-filesystems.pod:5 +msgid "" +"virt-filesystems - List filesystems, partitions, block devices, LVM in a " +"virtual machine or disk image" +msgstr "" + +#. type: verbatim +#: ../cat/virt-filesystems.pod:9 +#, no-wrap +msgid "" +" virt-filesystems [--options] -d domname\n" +"\n" +msgstr "" +" virt-filesystems [--параметри] -d назва_домену\n" +"\n" + +#. type: verbatim +#: ../cat/virt-filesystems.pod:11 +#, no-wrap +msgid "" +" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:15 +msgid "" +"This tool allows you to discover filesystems, partitions, logical volumes, " +"and their sizes in a disk image or virtual machine. It is a replacement for " +"L and L." +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:20 +msgid "" +"One use for this tool is from shell scripts to iterate over all filesystems " +"from a disk image:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-filesystems.pod:23 +#, no-wrap +msgid "" +" for fs in $(virt-filesystems -a disk.img); do\n" +" # ...\n" +" done\n" +"\n" +msgstr "" +" for fs in $(virt-filesystems -a disk.img); do\n" +" # ...\n" +" done\n" +"\n" + +#. type: textblock +#: ../cat/virt-filesystems.pod:27 +msgid "" +"Another use is to list partitions before using another tool to modify those " +"partitions (such as L). If you are curious about what an " +"unknown disk image contains, use this tool along with L." +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:32 +msgid "" +"Various command line options control what this program displays. You need " +"to give either I<-a> or I<-d> options to specify the disk image or libvirt " +"guest respectively. If you just specify that then the program shows " +"filesystems found, one per line, like this:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-filesystems.pod:37 +#, no-wrap +msgid "" +" $ virt-filesystems -a disk.img\n" +" /dev/sda1\n" +" /dev/vg_guest/lv_root\n" +"\n" +msgstr "" +" $ virt-filesystems -a disk.img\n" +" /dev/sda1\n" +" /dev/vg_guest/lv_root\n" +"\n" + +#. type: textblock +#: ../cat/virt-filesystems.pod:41 +msgid "" +"If you add I<-l> or I<--long> then the output includes extra information:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-filesystems.pod:44 +#, no-wrap +msgid "" +" $ virt-filesystems -a disk.img -l\n" +" Name Type VFS Label Size\n" +" /dev/sda1 filesystem ext4 boot 524288000\n" +" /dev/vg_guest/lv_root filesystem ext4 root 10212081664\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:49 +msgid "" +"If you add I<--extra> then non-mountable (swap, unknown) filesystems are " +"shown as well:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-filesystems.pod:52 +#, no-wrap +msgid "" +" $ virt-filesystems -a disk.img --extra\n" +" /dev/sda1\n" +" /dev/vg_guest/lv_root\n" +" /dev/vg_guest/lv_swap\n" +" /dev/vg_guest/lv_data\n" +"\n" +msgstr "" +" $ virt-filesystems -a disk.img --extra\n" +" /dev/sda1\n" +" /dev/vg_guest/lv_root\n" +" /dev/vg_guest/lv_swap\n" +" /dev/vg_guest/lv_data\n" +"\n" + +#. type: textblock +#: ../cat/virt-filesystems.pod:58 +msgid "" +"If you add I<--partitions> then partitions are shown instead of filesystems:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-filesystems.pod:60 +#, no-wrap +msgid "" +" $ virt-filesystems -a disk.img --partitions\n" +" /dev/sda1\n" +" /dev/sda2\n" +"\n" +msgstr "" +" $ virt-filesystems -a disk.img --partitions\n" +" /dev/sda1\n" +" /dev/sda2\n" +"\n" + +#. type: textblock +#: ../cat/virt-filesystems.pod:64 +msgid "" +"Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-" +"volumes>, I<--block-devices> to list those items." msgstr "" #. type: textblock @@ -1055,10 +1812,8 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121 -#, fuzzy -#| msgid "B<--help>" msgid "B<--all>" -msgstr "B<--help>" +msgstr "B<--all>" #. type: textblock #: ../cat/virt-filesystems.pod:112 @@ -1071,38 +1826,28 @@ msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:117 -#, fuzzy -#| msgid "See also L." msgid "See also I<--long>." -msgstr "Див. також L." +msgstr "Див. також I<--long>." #. type: =item #: ../cat/virt-filesystems.pod:119 -#, fuzzy -#| msgid "B<--live>" msgid "B<--blkdevs>" -msgstr "B<--live>" +msgstr "B<--blkdevs>" #. type: =item #: ../cat/virt-filesystems.pod:121 -#, fuzzy -#| msgid "is-blockdev" msgid "B<--block-devices>" -msgstr "is-blockdev" +msgstr "B<--block-devices>" #. type: textblock #: ../cat/virt-filesystems.pod:123 -#, fuzzy -#| msgid "is-blockdev" msgid "Display block devices." -msgstr "is-blockdev" +msgstr "Показати список блокових пристроїв." #. type: =item #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88 -#, fuzzy -#| msgid "B<--csh>" msgid "B<--csv>" -msgstr "B<--csh>" +msgstr "B<--csv>" #. type: textblock #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90 @@ -1123,10 +1868,8 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:155 -#, fuzzy -#| msgid "B<--ro>" msgid "B<--extra>" -msgstr "B<--ro>" +msgstr "B<--extra>" #. type: textblock #: ../cat/virt-filesystems.pod:157 @@ -1143,10 +1886,8 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:163 -#, fuzzy -#| msgid "list-filesystems" msgid "B<--filesystems>" -msgstr "list-filesystems" +msgstr "B<--filesystems>" #. type: textblock #: ../cat/virt-filesystems.pod:165 @@ -1162,29 +1903,21 @@ msgstr "" #. type: verbatim #: ../cat/virt-filesystems.pod:181 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img\n" -#| "\n" +#, no-wrap msgid "" " virt-filesystems --format=raw -a disk.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img\n" +" virt-filesystems --format=raw -a диск.img\n" "\n" #. type: verbatim #: ../cat/virt-filesystems.pod:185 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#, no-wrap msgid "" " virt-filesystems --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" #. type: =item #: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352 @@ -1196,10 +1929,8 @@ msgstr "B<-h>" #. type: =item #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354 #: ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111 -#, fuzzy -#| msgid "B<-h> | B<--human-readable>" msgid "B<--human-readable>" -msgstr "B<-h> | B<--human-readable>" +msgstr "B<--human-readable>" #. type: textblock #: ../cat/virt-filesystems.pod:198 @@ -1210,15 +1941,13 @@ msgstr "" #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119 msgid "B<-l>" -msgstr "" +msgstr "B<-l>" #. type: =item #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121 -#, fuzzy -#| msgid "B<--ro>" msgid "B<--long>" -msgstr "B<--ro>" +msgstr "B<--long>" #. type: textblock #: ../cat/virt-filesystems.pod:209 @@ -1253,24 +1982,18 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:223 -#, fuzzy -#| msgid "B<--live>" msgid "B<--lvs>" -msgstr "B<--live>" +msgstr "B<--lvs>" #. type: =item #: ../cat/virt-filesystems.pod:225 -#, fuzzy -#| msgid "B<--live>" msgid "B<--logvols>" -msgstr "B<--live>" +msgstr "B<--logvols>" #. type: =item #: ../cat/virt-filesystems.pod:227 -#, fuzzy -#| msgid "B<--live>" msgid "B<--logical-volumes>" -msgstr "B<--live>" +msgstr "B<--logical-volumes>" #. type: textblock #: ../cat/virt-filesystems.pod:229 @@ -1281,10 +2004,8 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:232 -#, fuzzy -#| msgid "B<--listen>" msgid "B<--no-title>" -msgstr "B<--listen>" +msgstr "B<--no-title>" #. type: textblock #: ../cat/virt-filesystems.pod:234 @@ -1301,17 +2022,13 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:240 -#, fuzzy -#| msgid "B<--partition>" msgid "B<--parts>" -msgstr "B<--partition>" +msgstr "B<--parts>" #. type: =item #: ../cat/virt-filesystems.pod:242 -#, fuzzy -#| msgid "B<--partition>" msgid "B<--partitions>" -msgstr "B<--partition>" +msgstr "B<--partitions>" #. type: textblock #: ../cat/virt-filesystems.pod:244 @@ -1322,22 +2039,18 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:247 -#, fuzzy -#| msgid "B<--csh>" msgid "B<--pvs>" -msgstr "B<--csh>" +msgstr "B<--pvs>" #. type: =item #: ../cat/virt-filesystems.pod:249 -#, fuzzy -#| msgid "B<--verbose>" msgid "B<--physvols>" -msgstr "B<--verbose>" +msgstr "B<--physvols>" #. type: =item #: ../cat/virt-filesystems.pod:251 msgid "B<--physical-volumes>" -msgstr "" +msgstr "B<--physical-volumes>" #. type: textblock #: ../cat/virt-filesystems.pod:253 @@ -1346,17 +2059,13 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163 -#, fuzzy -#| msgid "B<--live>" msgid "B<--uuid>" -msgstr "B<--live>" +msgstr "B<--uuid>" #. type: =item #: ../cat/virt-filesystems.pod:257 -#, fuzzy -#| msgid "B<--csh>" msgid "B<--uuids>" -msgstr "B<--csh>" +msgstr "B<--uuids>" #. type: textblock #: ../cat/virt-filesystems.pod:259 @@ -1365,24 +2074,18 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:273 -#, fuzzy -#| msgid "B<--csh>" msgid "B<--vgs>" -msgstr "B<--csh>" +msgstr "B<--vgs>" #. type: =item #: ../cat/virt-filesystems.pod:275 -#, fuzzy -#| msgid "B<--verbose>" msgid "B<--volgroups>" -msgstr "B<--verbose>" +msgstr "B<--volgroups>" #. type: =item #: ../cat/virt-filesystems.pod:277 -#, fuzzy -#| msgid "B<--verbose>" msgid "B<--volume-groups>" -msgstr "B<--verbose>" +msgstr "B<--volume-groups>" #. type: textblock #: ../cat/virt-filesystems.pod:279 @@ -1392,7 +2095,7 @@ msgstr "" #. type: =head1 #: ../cat/virt-filesystems.pod:287 msgid "COLUMNS" -msgstr "" +msgstr "СТОВПЧИКИ" #. type: textblock #: ../cat/virt-filesystems.pod:289 @@ -1428,10 +2131,8 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:305 -#, fuzzy -#| msgid "B<-N type>" msgid "B" -msgstr "B<-N тип>" +msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:307 @@ -1441,7 +2142,7 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:309 msgid "B" -msgstr "" +msgstr "B" #. type: textblock #: ../cat/virt-filesystems.pod:311 @@ -1464,25 +2165,41 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:319 -#, fuzzy -#| msgid "B" -msgid "B" -msgstr "B" +msgid "B" +msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:321 msgid "" +"The partition type byte, displayed as a two digit hexadecimal number. A " +"comprehensive list of partition types can be found here: L" +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:325 +msgid "This is only applicable for DOS (MBR) partitions." +msgstr "" + +#. type: =item +#: ../cat/virt-filesystems.pod:327 +msgid "B" +msgstr "" + +#. type: textblock +#: ../cat/virt-filesystems.pod:329 +msgid "" "The size of the object in bytes. If the I<--human> option is used then the " "size is displayed in a human-readable form." msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:324 +#: ../cat/virt-filesystems.pod:332 msgid "B" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:326 +#: ../cat/virt-filesystems.pod:334 msgid "" "The parent column records the parent relationship between objects. For " "example, if the object is a partition, then this column contains the name of " @@ -1491,47 +2208,47 @@ msgid "" msgstr "" #. type: =item -#: ../cat/virt-filesystems.pod:331 +#: ../cat/virt-filesystems.pod:339 msgid "B" -msgstr "" +msgstr "B" #. type: textblock -#: ../cat/virt-filesystems.pod:333 +#: ../cat/virt-filesystems.pod:341 msgid "" "If the object has a UUID (used for identifying and mounting filesystems and " "block devices) then this column contains the UUID as a string." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:337 +#: ../cat/virt-filesystems.pod:345 msgid "The UUID is only displayed if the I<--uuid> option is given." msgstr "" #. type: =head1 -#: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459 -#: ../df/virt-df.pod:191 +#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:459 +#: ../df/virt-df.pod:217 msgid "NOTE ABOUT CSV FORMAT" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461 -#: ../df/virt-df.pod:193 +#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:461 +#: ../df/virt-df.pod:219 msgid "" "Comma-separated values (CSV) is a deceptive format. It I like it " "should be easy to parse, but it is definitely not easy to parse." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464 -#: ../df/virt-df.pod:196 +#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:464 +#: ../df/virt-df.pod:222 msgid "" "Myth: Just split fields at commas. Reality: This does I work " "reliably. This example has two columns:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467 -#: ../df/virt-df.pod:199 +#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467 +#: ../df/virt-df.pod:225 #, no-wrap msgid "" " \"foo,bar\",baz\n" @@ -1539,16 +2256,16 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469 -#: ../df/virt-df.pod:201 +#: ../cat/virt-filesystems.pod:359 ../cat/virt-ls.pod:469 +#: ../df/virt-df.pod:227 msgid "" "Myth: Read the file one line at a time. Reality: This does I work " "reliably. This example has one row:" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472 -#: ../df/virt-df.pod:204 +#: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472 +#: ../df/virt-df.pod:230 #, no-wrap msgid "" " \"foo\n" @@ -1557,48 +2274,42 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475 -#: ../df/virt-df.pod:207 +#: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:475 +#: ../df/virt-df.pod:233 msgid "" "For shell scripts, use C (L also " "packaged in major Linux distributions)." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478 -#: ../df/virt-df.pod:210 +#: ../cat/virt-filesystems.pod:368 ../cat/virt-ls.pod:478 +#: ../df/virt-df.pod:236 msgid "" "For other languages, use a CSV processing library (eg. C for Perl " "or Python's built-in csv library)." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481 -#: ../df/virt-df.pod:213 +#: ../cat/virt-filesystems.pod:371 ../cat/virt-ls.pod:481 +#: ../df/virt-df.pod:239 msgid "Most spreadsheets and databases can import CSV directly." msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:379 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L, L." +#: ../cat/virt-filesystems.pod:387 msgid "" "L, L, L, L, L, L, L, L." msgstr "" -"L, L, L, L, L, L, L, L, L, L." +"L, L, L, L, L, L, L, L." #. type: textblock -#: ../cat/virt-filesystems.pod:394 ../tools/virt-make-fs.pl:570 -#: ../tools/virt-win-reg.pl:778 +#: ../cat/virt-filesystems.pod:402 ../tools/virt-win-reg.pl:789 msgid "Copyright (C) 2010 Red Hat Inc." -msgstr "" +msgstr "©Red Hat Inc., 2010" #. type: textblock #: ../cat/virt-ls.pod:5 @@ -1615,47 +2326,32 @@ msgstr "" #. type: verbatim #: ../cat/virt-ls.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#, no-wrap msgid "" " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" #. type: textblock -#: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13 +#: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:15 msgid "Old style:" -msgstr "" +msgstr "Старий стиль:" #. type: verbatim #: ../cat/virt-ls.pod:15 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#, no-wrap msgid "" " virt-ls [--options] domname directory\n" "\n" msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" #. type: verbatim #: ../cat/virt-ls.pod:17 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#, no-wrap msgid "" " virt-ls [--options] disk.img [disk.img ...] directory\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" #. type: textblock #: ../cat/virt-ls.pod:21 @@ -1693,19 +2389,14 @@ msgstr "" #. type: verbatim #: ../cat/virt-ls.pod:39 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --ro -d myguest -i\n" -#| "\n" +#, no-wrap msgid "" " virt-ls -R -d guest /\n" "\n" msgstr "" -" guestfish --ro -d myguest -i\n" -"\n" #. type: textblock -#: ../cat/virt-ls.pod:41 +#: ../cat/virt-ls.pod:41 ../examples/guestfs-testing.pod:182 msgid "List all setuid or setgid programs in a Linux virtual machine:" msgstr "" @@ -1718,7 +2409,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-ls.pod:45 +#: ../cat/virt-ls.pod:45 ../examples/guestfs-testing.pod:186 msgid "List all public-writable directories in a Linux virtual machine:" msgstr "" @@ -1731,7 +2422,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-ls.pod:49 +#: ../cat/virt-ls.pod:49 ../examples/guestfs-testing.pod:190 msgid "List all Unix domain sockets in a Linux virtual machine:" msgstr "" @@ -1744,7 +2435,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-ls.pod:53 +#: ../cat/virt-ls.pod:53 ../examples/guestfs-testing.pod:194 msgid "List all regular files with filenames ending in '.png':" msgstr "" @@ -1770,7 +2461,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-ls.pod:61 +#: ../cat/virt-ls.pod:61 ../examples/guestfs-testing.pod:202 msgid "Find everything modified in the last 7 days:" msgstr "" @@ -1783,7 +2474,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-ls.pod:65 +#: ../cat/virt-ls.pod:65 ../examples/guestfs-testing.pod:206 msgid "Find regular files modified in the last 24 hours:" msgstr "" @@ -1830,7 +2521,7 @@ msgstr "" #. type: =head1 #: ../cat/virt-ls.pod:84 msgid "OUTPUT MODES" -msgstr "" +msgstr "РЕЖИМИ ВИВЕДЕННЯ ДАНИХ" #. type: textblock #: ../cat/virt-ls.pod:86 @@ -1842,7 +2533,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:89 msgid "SIMPLE LISTING" -msgstr "" +msgstr "ПРОСТИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:91 @@ -1859,13 +2550,16 @@ msgid "" " [etc.]\n" "\n" msgstr "" +" $ virt-ls -d guest /\n" +" bin\n" +" boot\n" +" [тощо]\n" +"\n" #. type: =head2 #: ../cat/virt-ls.pod:98 -#, fuzzy -#| msgid "MOUNTING" msgid "LONG LISTING" -msgstr "МОНТУВАННЯ" +msgstr "ДОВГИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:100 @@ -1885,6 +2579,12 @@ msgid "" " [etc.]\n" "\n" msgstr "" +" $ virt-ls -l -d guest /\n" +" total 204\n" +" dr-xr-xr-x. 2 root root 4096 2009-08-25 19:06 bin\n" +" dr-xr-xr-x. 5 root root 3072 2009-08-25 19:06 boot\n" +" [тощо]\n" +"\n" #. type: textblock #: ../cat/virt-ls.pod:109 @@ -1897,7 +2597,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:113 msgid "RECURSIVE LISTING" -msgstr "" +msgstr "РЕКУРСИВНИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:115 @@ -1916,6 +2616,11 @@ msgid "" " [etc.]\n" "\n" msgstr "" +" $ virt-ls -R -d guest /tmp\n" +" foo\n" +" foo/bar\n" +" [тощо]\n" +"\n" #. type: textblock #: ../cat/virt-ls.pod:123 @@ -1927,7 +2632,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:126 msgid "RECURSIVE LONG LISTING" -msgstr "" +msgstr "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:128 @@ -1977,6 +2682,15 @@ msgid "" " [etc.]\n" "\n" msgstr "" +" $ virt-ls -lR -d guest /bin\n" +" d 0555 4096 /bin\n" +" - 0755 123 /bin/alsaunmute\n" +" - 0755 28328 /bin/arch\n" +" l 0777 4 /bin/awk -> gawk\n" +" - 0755 27216 /bin/basename\n" +" - 0755 943360 /bin/bash\n" +" [тощо]\n" +"\n" #. type: textblock #: ../cat/virt-ls.pod:155 @@ -1985,10 +2699,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:159 -#, fuzzy -#| msgid "vfs-type" msgid "type" -msgstr "vfs-type" +msgstr "тип" #. type: textblock #: ../cat/virt-ls.pod:161 @@ -2000,10 +2712,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:171 -#, fuzzy -#| msgid "version" msgid "permissions" -msgstr "version" +msgstr "права доступу" #. type: textblock #: ../cat/virt-ls.pod:173 @@ -2012,10 +2722,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:175 -#, fuzzy -#| msgid "filesize" msgid "size" -msgstr "filesize" +msgstr "розмір" #. type: textblock #: ../cat/virt-ls.pod:177 @@ -2026,9 +2734,9 @@ msgid "" msgstr "" #. type: =head2 -#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4255 +#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4488 msgid "path" -msgstr "" +msgstr "шлях" #. type: textblock #: ../cat/virt-ls.pod:183 @@ -2037,10 +2745,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:185 -#, fuzzy -#| msgid "readlink" msgid "link" -msgstr "readlink" +msgstr "посилання" #. type: textblock #: ../cat/virt-ls.pod:187 @@ -2063,17 +2769,13 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:199 -#, fuzzy -#| msgid "lvuuid" msgid "uid" -msgstr "lvuuid" +msgstr "uid" #. type: =item #: ../cat/virt-ls.pod:201 -#, fuzzy -#| msgid "vguuid" msgid "gid" -msgstr "vguuid" +msgstr "gid" #. type: textblock #: ../cat/virt-ls.pod:203 @@ -2089,39 +2791,33 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:212 -#, fuzzy -#| msgid "time" msgid "atime" -msgstr "time" +msgstr "atime" #. type: textblock #: ../cat/virt-ls.pod:214 msgid "The time of last access." -msgstr "" +msgstr "Час останнього доступу." #. type: =item #: ../cat/virt-ls.pod:216 -#, fuzzy -#| msgid "time" msgid "mtime" -msgstr "time" +msgstr "mtime" #. type: textblock #: ../cat/virt-ls.pod:218 msgid "The time of last modification." -msgstr "" +msgstr "Час останнього внесення змін." #. type: =item #: ../cat/virt-ls.pod:220 -#, fuzzy -#| msgid "time" msgid "ctime" -msgstr "time" +msgstr "ctime" #. type: textblock #: ../cat/virt-ls.pod:222 msgid "The time of last status change." -msgstr "" +msgstr "Час останньої зміни стану." #. type: textblock #: ../cat/virt-ls.pod:226 @@ -2137,10 +2833,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:233 -#, fuzzy -#| msgid "zero-device" msgid "device" -msgstr "zero-device" +msgstr "пристрій" #. type: textblock #: ../cat/virt-ls.pod:235 @@ -2152,7 +2846,7 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:238 msgid "inode" -msgstr "" +msgstr "inode" #. type: textblock #: ../cat/virt-ls.pod:240 @@ -2161,20 +2855,18 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:242 -#, fuzzy -#| msgid "readlink" msgid "nlink" -msgstr "readlink" +msgstr "nlink" #. type: textblock #: ../cat/virt-ls.pod:244 msgid "The number of hard links." -msgstr "" +msgstr "Кількість жорстких посилань." #. type: =item #: ../cat/virt-ls.pod:246 msgid "rdev" -msgstr "" +msgstr "rdev" #. type: textblock #: ../cat/virt-ls.pod:248 @@ -2184,10 +2876,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:251 -#, fuzzy -#| msgid "C" msgid "blocks" -msgstr "C" +msgstr "блоки" #. type: textblock #: ../cat/virt-ls.pod:253 @@ -2204,15 +2894,13 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:280 -#, fuzzy -#| msgid "checksum" msgid "B<--checksum>" -msgstr "checksum" +msgstr "B<--checksum>" #. type: =item #: ../cat/virt-ls.pod:282 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>" -msgstr "" +msgstr "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>" #. type: textblock #: ../cat/virt-ls.pod:284 @@ -2242,41 +2930,29 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:321 -#, fuzzy -#| msgid "B<--no-dest-paths>" msgid "B<--extra-stats>" -msgstr "B<--no-dest-paths>" +msgstr "B<--extra-stats>" #. type: textblock #: ../cat/virt-ls.pod:323 msgid "Display extra stats." -msgstr "" +msgstr "Показати додаткові дані." #. type: verbatim #: ../cat/virt-ls.pod:339 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img\n" -#| "\n" +#, no-wrap msgid "" " virt-ls --format=raw -a disk.img /dir\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img\n" -"\n" #. type: verbatim #: ../cat/virt-ls.pod:343 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#, no-wrap msgid "" " virt-ls --format=raw -a disk.img --format -a another.img /dir\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" #. type: textblock #: ../cat/virt-ls.pod:356 @@ -2286,14 +2962,12 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:370 msgid "B<-R>" -msgstr "" +msgstr "B<-R>" #. type: =item #: ../cat/virt-ls.pod:372 -#, fuzzy -#| msgid "B<--live>" msgid "B<--recursive>" -msgstr "B<--live>" +msgstr "B<--recursive>" #. type: textblock #: ../cat/virt-ls.pod:374 @@ -2326,10 +3000,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:387 -#, fuzzy -#| msgid "B<--live>" msgid "B<--times>" -msgstr "B<--live>" +msgstr "B<--times>" #. type: textblock #: ../cat/virt-ls.pod:389 @@ -2338,10 +3010,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:394 -#, fuzzy -#| msgid "B<--echo-keys>" msgid "B<--time-days>" -msgstr "B<--echo-keys>" +msgstr "B<--time-days>" #. type: textblock #: ../cat/virt-ls.pod:396 @@ -2357,10 +3027,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:404 -#, fuzzy -#| msgid "B<--live>" msgid "B<--time-relative>" -msgstr "B<--live>" +msgstr "B<--time-relative>" #. type: textblock #: ../cat/virt-ls.pod:406 @@ -2369,10 +3037,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:411 -#, fuzzy -#| msgid "I<--timeout N>" msgid "B<--time-t>" -msgstr "I<--timeout N>" +msgstr "B<--time-t>" #. type: textblock #: ../cat/virt-ls.pod:413 @@ -2381,10 +3047,8 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:418 -#, fuzzy -#| msgid "B<--csh>" msgid "B<--uids>" -msgstr "B<--csh>" +msgstr "B<--uids>" #. type: textblock #: ../cat/virt-ls.pod:420 @@ -2398,2342 +3062,3684 @@ msgstr "" #. type: verbatim #: ../cat/virt-ls.pod:447 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#, no-wrap msgid "" " virt-ls disk.img [disk.img ...] /dir\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" #. type: verbatim #: ../cat/virt-ls.pod:451 -#, fuzzy, no-wrap -#| msgid "" -#| " inspect-get-hostname root\n" -#| "\n" +#, no-wrap msgid "" " virt-ls guestname /dir\n" "\n" msgstr "" -" inspect-get-hostname корінь\n" -"\n" #. type: textblock #: ../cat/virt-ls.pod:497 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." msgid "" "L, L, L, L, L, L, L, L, " "L." msgstr "" -"L, L, L, L, L, L, L, L, L." +"L, L, L, L, L, L, L, L, " +"L." #. type: textblock -#: ../cat/virt-ls.pod:513 ../df/virt-df.pod:241 ../edit/virt-edit.pod:374 -#: ../rescue/virt-rescue.pod:302 -#, fuzzy -#| msgid "Copyright (C) 2009-2010 Red Hat Inc." +#: ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:374 +#: ../rescue/virt-rescue.pod:340 msgid "Copyright (C) 2009-2011 Red Hat Inc." -msgstr "© Red Hat Inc., 2009–2010" +msgstr "©Red Hat Inc., 2009–2011" #. type: textblock -#: ../df/virt-df.pod:5 -msgid "virt-df - Display free space on virtual filesystems" -msgstr "" - -#. type: verbatim -#: ../df/virt-df.pod:9 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#: ../clone/virt-sysprep.pod:5 msgid "" -" virt-df [--options]\n" -"\n" +"virt-sysprep - Reset or unconfigure a virtual machine so clones can be made" msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" #. type: verbatim -#: ../df/virt-df.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#: ../clone/virt-sysprep.pod:9 +#, no-wrap msgid "" -" virt-df [--options] -d domname\n" +" virt-sysprep [--options] -d domname\n" "\n" msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" #. type: verbatim -#: ../df/virt-df.pod:13 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#: ../clone/virt-sysprep.pod:11 +#, no-wrap msgid "" -" virt-df [--options] -a disk.img [-a disk.img ...]\n" +" virt-sysprep [--options] -a disk.img [-a disk.img ...]\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" -#. type: verbatim -#: ../df/virt-df.pod:17 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:15 msgid "" -" virt-df [--options] domname\n" -"\n" +"Virt-sysprep \"resets\" or \"unconfigures\" a virtual machine so that clones " +"can be made from it. Steps in this process include removing SSH host keys, " +"removing persistent network MAC configuration, and removing user accounts. " +"Each step can be enabled or disabled as required." msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" -#. type: verbatim -#: ../df/virt-df.pod:19 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:21 msgid "" -" virt-df [--options] disk.img [disk.img ...]\n" -"\n" +"Virt-sysprep is a simple shell script, allowing easy inspection or " +"customization by the system administrator." msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" #. type: textblock -#: ../df/virt-df.pod:23 +#: ../clone/virt-sysprep.pod:24 msgid "" -"C is a command line tool to display free space on virtual machine " -"filesystems. Unlike other tools, it doesn't just display the size of disk " -"allocated to a virtual machine, but can look inside disk images to see how " -"much space is really being used." +"Virt-sysprep modifies the guest or disk image I. The guest must " +"be shut down. If you want to preserve the existing contents of the guest, " +"you I. See L below." msgstr "" #. type: textblock -#: ../df/virt-df.pod:28 +#: ../clone/virt-sysprep.pod:29 msgid "" -"If used without any I<-a> or I<-d> arguments, C checks with libvirt " -"to get a list of all active and inactive guests, and performs a C-type " -"operation on each one in turn, printing out the results." +"You do I need to run virt-sysprep as root. In fact we'd generally " +"recommend that you don't. The time you might want to run it as root is when " +"you need root in order to access the disk image, but even in this case it " +"would be better to change the permissions on the disk image to be writable " +"as the non-root user running virt-sysprep." msgstr "" #. type: textblock -#: ../df/virt-df.pod:32 +#: ../clone/virt-sysprep.pod:35 msgid "" -"If any I<-a> or I<-d> arguments are specified, C performs a C-" -"type operation on either the single named libvirt domain, or on the disk " -"image(s) listed on the command line (which must all belong to a single VM). " -"In this mode (with arguments), C will I. If you want to run on multiple guests, then you have to invoke " -"C multiple times." +"\"Sysprep\" stands for \"system preparation\" tool. The name comes from the " +"Microsoft program C which is used to unconfigure Windows " +"machines in preparation for cloning them. Having said that, virt-sysprep " +"does I currently work on Microsoft Windows guests. We plan to support " +"Windows sysprepping in a future version, and we already have code to do it." msgstr "" -#. type: textblock -#: ../df/virt-df.pod:39 -msgid "" -"Use the I<--csv> option to get a format which can be easily parsed by other " -"programs. Other options are similar to the standard L command." +#. type: =item +#: ../clone/virt-sysprep.pod:76 +msgid "B<--enable=...>" msgstr "" #. type: textblock -#: ../df/virt-df.pod:45 +#: ../clone/virt-sysprep.pod:78 msgid "" -"Show disk usage for a single libvirt guest called C. Make the " -"output human-readable:" +"Choose which sysprep operations to perform. Give a comma-separated list of " +"operations, for example:" msgstr "" #. type: verbatim -#: ../df/virt-df.pod:48 +#: ../clone/virt-sysprep.pod:81 #, no-wrap msgid "" -" # virt-df -d F14x64 -h\n" -" Filesystem Size Used Available Use%\n" -" F14x64:/dev/sda1 484M 66M 393M 14%\n" -" F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46%\n" +" --enable=ssh-hostkeys,udev-persistent-net\n" "\n" msgstr "" #. type: textblock -#: ../df/virt-df.pod:53 -msgid "Show disk usage for a disk image file called C:" +#: ../clone/virt-sysprep.pod:83 +msgid "" +"would enable ONLY C and C operations." msgstr "" -#. type: verbatim -#: ../df/virt-df.pod:55 -#, no-wrap +#. type: textblock +#: ../clone/virt-sysprep.pod:85 msgid "" -" $ virt-df -a test1.img\n" -" Filesystem 1K-blocks Used Available Use%\n" -" test1.img:/dev/sda1 99099 1551 92432 2%\n" -"\n" +"If the I<--enable> option is not given, then we default to trying all " +"possible sysprep operations. But some sysprep operations are skipped for " +"some guest types." +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:89 +msgid "" +"Use I<--list-operations> to list operations supported by a particular " +"version of virt-sysprep." +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:92 +msgid "" +"See L below for a list and an explanation of each operation." msgstr "" #. type: verbatim -#: ../df/virt-df.pod:112 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img\n" -#| "\n" +#: ../clone/virt-sysprep.pod:106 +#, no-wrap msgid "" -" virt-df --format=raw -a disk.img\n" +" virt-sysprep --format=raw -a disk.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img\n" -"\n" #. type: verbatim -#: ../df/virt-df.pod:116 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#: ../clone/virt-sysprep.pod:110 +#, no-wrap msgid "" -" virt-df --format=raw -a disk.img --format -a another.img\n" +" virt-sysprep --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" -#. type: textblock -#: ../df/virt-df.pod:129 -msgid "Print sizes in human-readable format." +#. type: =item +#: ../clone/virt-sysprep.pod:119 +msgid "B<--hostname> newhostname" msgstr "" #. type: textblock -#: ../df/virt-df.pod:131 -msgid "You are not allowed to use I<-h> and I<--csv> at the same time." +#: ../clone/virt-sysprep.pod:121 +msgid "" +"Change the hostname. See the L operation below. If not given, " +"defaults to C." msgstr "" #. type: =item -#: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155 -msgid "B<-i>" -msgstr "B<-i>" - -#. type: =item -#: ../df/virt-df.pod:135 -#, fuzzy -#| msgid "B<--live>" -msgid "B<--inodes>" -msgstr "B<--live>" +#: ../clone/virt-sysprep.pod:124 +msgid "B<--list-operations>" +msgstr "" #. type: textblock -#: ../df/virt-df.pod:137 -msgid "Print inodes instead of blocks." +#: ../clone/virt-sysprep.pod:126 +msgid "List the operations supported by the virt-sysprep program." msgstr "" #. type: =item -#: ../df/virt-df.pod:139 -#, fuzzy -#| msgid "B<--merge>" -msgid "B<--one-per-guest>" -msgstr "B<--merge>" +#: ../clone/virt-sysprep.pod:128 +msgid "B<--selinux-relabel>" +msgstr "" + +#. type: =item +#: ../clone/virt-sysprep.pod:130 +msgid "B<--no-selinux-relabel>" +msgstr "" #. type: textblock -#: ../df/virt-df.pod:141 +#: ../clone/virt-sysprep.pod:132 msgid "" -"Run one libguestfs appliance per guest. Normally C will add the " -"disks from several guests to a single libguestfs appliance." +"I<--selinux-relabel> forces SELinux relabelling next time the guest boots. " +"I<--no-selinux-relabel> disables relabelling." msgstr "" #. type: textblock -#: ../df/virt-df.pod:144 -msgid "You might use this option in the following circumstances:" +#: ../clone/virt-sysprep.pod:135 +msgid "" +"The default is to try to detect if SELinux relabelling is required. See L below for more details." msgstr "" -#. type: =item -#: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 -#: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 -#: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 -#: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 -#: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 -#: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 -#: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 -#: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 -#: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 -#: ../fish/guestfish-actions.pod:390 ../fish/guestfish-actions.pod:398 -#: ../fish/guestfish-actions.pod:405 ../fish/guestfish-actions.pod:412 -#: ../fish/guestfish-actions.pod:1139 ../fish/guestfish-actions.pod:1143 -#: ../fish/guestfish-actions.pod:1147 ../fish/guestfish-actions.pod:1151 -#: ../fish/guestfish-actions.pod:1159 ../fish/guestfish-actions.pod:1163 -#: ../fish/guestfish-actions.pod:1167 ../fish/guestfish-actions.pod:1177 -#: ../fish/guestfish-actions.pod:1181 ../fish/guestfish-actions.pod:1185 -#: ../fish/guestfish-actions.pod:1275 ../fish/guestfish-actions.pod:1279 -#: ../fish/guestfish-actions.pod:1284 ../fish/guestfish-actions.pod:1289 -#: ../fish/guestfish-actions.pod:1331 ../fish/guestfish-actions.pod:1335 -#: ../fish/guestfish-actions.pod:1340 ../fish/guestfish-actions.pod:1596 -#: ../fish/guestfish-actions.pod:1603 ../fish/guestfish-actions.pod:1610 -#: ../fish/guestfish-actions.pod:2005 ../fish/guestfish-actions.pod:2011 -#: ../fish/guestfish-actions.pod:2019 ../fish/guestfish-actions.pod:2026 -#: ../fish/guestfish-actions.pod:2033 ../fish/guestfish.pod:445 -#: ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 -#: ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:393 -#: ../inspector/virt-inspector.pod:397 ../resize/virt-resize.pod:282 -#: ../resize/virt-resize.pod:286 ../resize/virt-resize.pod:295 -#: ../resize/virt-resize.pod:301 ../src/guestfs-actions.pod:22 -#: ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:588 -#: ../src/guestfs-actions.pod:596 ../src/guestfs-actions.pod:603 -#: ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:1774 -#: ../src/guestfs-actions.pod:1778 ../src/guestfs-actions.pod:1782 -#: ../src/guestfs-actions.pod:1786 ../src/guestfs-actions.pod:1794 -#: ../src/guestfs-actions.pod:1798 ../src/guestfs-actions.pod:1802 -#: ../src/guestfs-actions.pod:1812 ../src/guestfs-actions.pod:1816 -#: ../src/guestfs-actions.pod:1820 ../src/guestfs-actions.pod:1958 -#: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:1967 -#: ../src/guestfs-actions.pod:1972 ../src/guestfs-actions.pod:2033 -#: ../src/guestfs-actions.pod:2037 ../src/guestfs-actions.pod:2042 -#: ../src/guestfs-actions.pod:2455 ../src/guestfs-actions.pod:2462 -#: ../src/guestfs-actions.pod:2469 ../src/guestfs-actions.pod:3006 -#: ../src/guestfs-actions.pod:3012 ../src/guestfs-actions.pod:3020 -#: ../src/guestfs-actions.pod:3027 ../src/guestfs-actions.pod:3034 -#: ../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:1091 -#: ../src/guestfs.pod:1095 ../src/guestfs.pod:1099 ../src/guestfs.pod:1104 -#: ../src/guestfs.pod:1112 ../src/guestfs.pod:1131 ../src/guestfs.pod:1139 -#: ../src/guestfs.pod:1161 ../src/guestfs.pod:1165 ../src/guestfs.pod:1169 -#: ../src/guestfs.pod:1173 ../src/guestfs.pod:1177 ../src/guestfs.pod:1181 -#: ../src/guestfs.pod:1671 ../src/guestfs.pod:1676 ../src/guestfs.pod:1680 -#: ../src/guestfs.pod:1782 ../src/guestfs.pod:1787 ../src/guestfs.pod:1791 -#: ../src/guestfs.pod:1801 ../src/guestfs.pod:2090 ../src/guestfs.pod:2095 -#: ../src/guestfs.pod:2101 ../src/guestfs.pod:2109 ../src/guestfs.pod:2556 -#: ../src/guestfs.pod:2562 ../src/guestfs.pod:2567 ../src/guestfs.pod:2573 -#: ../src/guestfs.pod:2956 ../src/guestfs.pod:2961 ../src/guestfs.pod:2965 -#: ../src/guestfs.pod:2969 ../src/guestfs.pod:2973 ../src/guestfs.pod:2987 -#: ../src/guestfs.pod:2992 ../src/guestfs.pod:3218 ../src/guestfs.pod:3222 -#: ../src/guestfs.pod:3226 ../src/guestfs.pod:3230 -#: ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 -#: ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:710 -#: ../tools/virt-win-reg.pl:716 ../tools/virt-win-reg.pl:722 -msgid "*" -msgstr "*" +#. type: =head1 +#: ../clone/virt-sysprep.pod:156 +msgid "OPERATIONS" +msgstr "" #. type: textblock -#: ../df/virt-df.pod:150 +#: ../clone/virt-sysprep.pod:158 msgid "" -"If you think an untrusted guest might actively try to exploit the libguestfs " -"appliance kernel, then this prevents one guest from interfering with the " -"stats printed for another guest." +"If the I<--enable> option is I given, then I, although some are skipped depending on the type of guest." msgstr "" #. type: textblock -#: ../df/virt-df.pod:156 +#: ../clone/virt-sysprep.pod:162 msgid "" -"If the kernel has a bug which stops it from accessing a filesystem in one " -"guest (see for example RHBZ#635373) then this allows libguestfs to continue " -"and report stats for further guests." +"Operations can be individually enabled using the I<--enable> option. Use a " +"comma-separated list, for example:" msgstr "" -#. type: textblock -#: ../df/virt-df.pod:165 +#. type: verbatim +#: ../clone/virt-sysprep.pod:165 +#, no-wrap msgid "" -"Print UUIDs instead of names. This is useful for following a guest even " -"when the guest is migrated or renamed, or when two guests happen to have the " -"same name." +" virt-sysprep --enable=ssh-hostkeys,udev-persistent-net [etc..]\n" +"\n" msgstr "" #. type: textblock -#: ../df/virt-df.pod:169 +#: ../clone/virt-sysprep.pod:167 msgid "" -"Note that only domains that we fetch from libvirt come with UUIDs. For disk " -"images, we still print the disk image name even when this option is " -"specified." +"To list the operations supported by the current version of virt-sysprep, use " +"I<--list-operations>." msgstr "" #. type: textblock -#: ../df/virt-df.pod:229 +#: ../clone/virt-sysprep.pod:170 msgid "" -"L, L, L, L, L." +"Future versions of virt-sysprep may add more operations. If you are using " +"virt-sysprep and want predictable behaviour, specify only the operations " +"that you want to have enabled." msgstr "" -#. type: textblock -#: ../edit/virt-edit.pod:5 -msgid "virt-edit - Edit a file in a virtual machine" +#. type: =head2 +#: ../clone/virt-sysprep.pod:174 +msgid "cron-spool" msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:9 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" -msgid "" -" virt-edit [--options] -d domname file [file ...]\n" -"\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:176 +msgid "Remove user at-jobs and cron-jobs." msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" -#. type: verbatim -#: ../edit/virt-edit.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" -msgid "" -" virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n" -"\n" +#. type: =head2 +#: ../clone/virt-sysprep.pod:178 +msgid "dhcp-client-state" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" -#. type: verbatim -#: ../edit/virt-edit.pod:13 -#, no-wrap -msgid "" -" virt-edit [-d domname|-a disk.img] file -e 'expr'\n" -"\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:180 +msgid "Remove DHCP client leases." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:17 -#, no-wrap -msgid "" -" virt-edit domname file\n" -"\n" +#. type: =head2 +#: ../clone/virt-sysprep.pod:182 +msgid "dhcp-server-state" msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" -msgid "" -" virt-edit disk.img [disk.img ...] file\n" -"\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:184 +msgid "Remove DHCP server leases." msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" -#. type: =head1 -#: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23 -#: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15 -#: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19 -#: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51 -msgid "WARNING" -msgstr "ПОПЕРЕДЖЕННЯ" +#. type: =head2 +#: ../clone/virt-sysprep.pod:186 +msgid "hostname" +msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:23 +#: ../clone/virt-sysprep.pod:188 msgid "" -"You must I use C on live virtual machines. If you do this, " -"you risk disk corruption in the VM. C tries to stop you from " -"doing this, but doesn't catch all cases." +"Changes the hostname of the guest to the value given in the I<--hostname> " +"parameter." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:29 +#: ../clone/virt-sysprep.pod:191 msgid "" -"C is a command line tool to edit C where each C " -"exists in the named virtual machine (or disk image)." +"If the I<--hostname> parameter is not given, then the hostname is changed to " +"C." +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:194 +msgid "logfiles" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:32 -msgid "" -"Multiple filenames can be given, in which case they are each edited in " -"turn. Each filename must be a full path, starting at the root directory " -"(starting with '/')." +#: ../clone/virt-sysprep.pod:196 +msgid "Remove many log files." +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:198 +msgid "mail-spool" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:36 -msgid "If you want to just view a file, use L." +#: ../clone/virt-sysprep.pod:200 +msgid "Remove email from the local mail spool directory." +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:202 +msgid "net-hwaddr" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:38 +#: ../clone/virt-sysprep.pod:204 msgid "" -"For more complex cases you should look at the L tool (see L below)." +"Remove HWADDR (hard-coded MAC address) configuration. For Fedora and Red " +"Hat Enterprise Linux, this is removed from C files." +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:207 +msgid "random-seed" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:41 +#: ../clone/virt-sysprep.pod:209 msgid "" -"C cannot be used to create a new file. L can do " -"that and much more." +"Write some random bytes from the host into the random seed file of the guest." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:46 -msgid "Edit the named files interactively:" +#: ../clone/virt-sysprep.pod:212 +msgid "See L below." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:48 -#, no-wrap -msgid "" -" virt-edit -d mydomain /boot/grub/grub.conf\n" -"\n" +#. type: =head2 +#: ../clone/virt-sysprep.pod:214 +msgid "rhn-systemid" msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:50 -#, no-wrap -msgid "" -" virt-edit -d mydomain /etc/passwd\n" -"\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:216 +msgid "Remove the RHN system ID." +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:218 +msgid "smolt-uuid" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:52 -msgid "For Windows guests, some Windows paths are understood:" +#: ../clone/virt-sysprep.pod:220 +msgid "Remove the Smolt hardware UUID." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:54 -#, no-wrap +#. type: =head2 +#: ../clone/virt-sysprep.pod:222 +msgid "ssh-hostkeys" +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:224 +msgid "Remove the SSH host keys in the guest." +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:226 msgid "" -" virt-edit -d mywindomain 'c:\\autoexec.bat'\n" -"\n" +"The SSH host keys are regenerated (differently) next time the guest is " +"booted." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:56 +#: ../clone/virt-sysprep.pod:229 msgid "" -"If Perl is installed, you can also edit files non-interactively (see L below). To change the init default level to 5:" +"If, after cloning, the guest gets the same IP address, ssh will give you a " +"stark warning about the host key changing:" msgstr "" #. type: verbatim -#: ../edit/virt-edit.pod:60 +#: ../clone/virt-sysprep.pod:232 #, no-wrap msgid "" -" virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n" +" @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n" +" @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @\n" +" @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n" +" IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n" "\n" msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:81 -msgid "B<-b> extension" -msgstr "" - -#. type: =item -#: ../edit/virt-edit.pod:83 -msgid "B<--backup> extension" +#. type: =head2 +#: ../clone/virt-sysprep.pod:237 +msgid "udev-persistent-net" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:85 +#: ../clone/virt-sysprep.pod:239 msgid "" -"Create a backup of the original file I. The backup " -"has the original filename with C added." +"Remove udev persistent net rules which map the guest's existing MAC address " +"to a fixed ethernet device (eg. eth0)." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:88 +#: ../clone/virt-sysprep.pod:242 msgid "" -"Usually the first character of C would be a dot C<.> so you would " -"write:" +"After a guest is cloned, the MAC address usually changes. Since the old MAC " +"address occupies the old name (eg. eth0), this means the fresh MAC address " +"is assigned to a new name (eg. eth1) and this is usually undesirable. " +"Erasing the udev persistent net rules avoids this." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:91 -#, no-wrap -msgid "" -" virt-edit -b .orig [etc]\n" -"\n" +#. type: =head2 +#: ../clone/virt-sysprep.pod:247 +msgid "utmp" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:93 -msgid "By default, no backup file is made." +#: ../clone/virt-sysprep.pod:249 +msgid "Remove the utmp file." msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181 -#: ../fuse/guestmount.pod:96 ../inspector/virt-inspector.pod:74 -#: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78 -#: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128 -msgid "B<-c URI>" -msgstr "B<-c адреса>" +#. type: textblock +#: ../clone/virt-sysprep.pod:251 +msgid "" +"This records who is currently logged in on a machine. In modern Linux " +"distros it is stored in a ramdisk and hence not part of the virtual " +"machine's disk, but it was stored on disk in older distros." +msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183 -#: ../fuse/guestmount.pod:98 ../inspector/virt-inspector.pod:76 -#: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80 -#: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130 -msgid "B<--connect URI>" -msgstr "B<--connect адреса>" +#. type: =head2 +#: ../clone/virt-sysprep.pod:255 +msgid "yum-uuid" +msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84 -#: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134 -#: ../tools/virt-win-reg.pl:135 +#: ../clone/virt-sysprep.pod:257 +msgid "Remove the yum UUID." +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:259 msgid "" -"If you specify guest block devices directly, then libvirt is not used at all." +"Yum creates a fresh UUID the next time it runs when it notices that the " +"original UUID has been erased." +msgstr "" + +#. type: =head1 +#: ../clone/virt-sysprep.pod:262 +msgid "COPYING AND CLONING" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:114 +#: ../clone/virt-sysprep.pod:264 msgid "" -"When prompting for keys and passphrases, virt-edit normally turns echoing " -"off so you cannot see what you are typing. If you are not worried about " -"Tempest attacks and there is no one else in the room you can specify this " -"flag to see what you are typing." +"Virt-sysprep can be used as part of a process of cloning guests, or to " +"prepare a template from which guests can be cloned. There are many " +"different ways to achieve this using the virt tools, and this section is " +"just an introduction." msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:119 -msgid "B<-e> EXPR" +#. type: textblock +#: ../clone/virt-sysprep.pod:269 +msgid "A virtual machine (when switched off) consists of two parts:" msgstr "" #. type: =item -#: ../edit/virt-edit.pod:121 -#, fuzzy -#| msgid "B<--help>" -msgid "B<--expr> EXPR" -msgstr "B<--help>" +#: ../clone/virt-sysprep.pod:273 +msgid "I" +msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:123 +#: ../clone/virt-sysprep.pod:275 msgid "" -"Instead of launching the external editor, non-interactively apply the Perl " -"expression C to each line in the file. See L below." +"The configuration or description of the guest. eg. The libvirt XML (see " +"C), the running configuration of the guest, or another " +"external format like OVF." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:127 -msgid "" -"Be careful to properly quote the expression to prevent it from being altered " -"by the shell." +#: ../clone/virt-sysprep.pod:279 +msgid "Some configuration items that might need to be changed:" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:130 -msgid "Note that this option is only available when Perl 5 is installed." +#: ../clone/virt-sysprep.pod:285 +msgid "name" msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:132 -#, fuzzy -#| msgid "B<--format=raw|qcow2|..>" -msgid "B<--format> raw|qcow2|..." -msgstr "B<--format=raw|qcow2|..>" - -#. type: verbatim -#: ../edit/virt-edit.pod:143 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img\n" -#| "\n" -msgid "" -" virt-edit --format=raw -a disk.img file\n" -"\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:289 ../clone/virt-sysprep.pod:316 +msgid "UUID" msgstr "" -" guestfish --format=raw -a disk.img\n" -"\n" -#. type: verbatim -#: ../edit/virt-edit.pod:147 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" -msgid "" -" virt-edit --format=raw -a disk.img --format -a another.img file\n" -"\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:293 +msgid "path to block device(s)" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" #. type: textblock -#: ../edit/virt-edit.pod:181 -msgid "Previous versions of virt-edit allowed you to write either:" +#: ../clone/virt-sysprep.pod:297 +msgid "network card MAC address" msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:187 -#, fuzzy, no-wrap -#| msgid "" -#| " edit filename\n" -#| "\n" +#. type: =item +#: ../clone/virt-sysprep.pod:301 +msgid "I" +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:303 msgid "" -" virt-edit guestname file\n" -"\n" +"One or more hard disk images, themselves containing files, directories, " +"applications, kernels, configuration, etc." msgstr "" -" edit назва_файла\n" -"\n" -#. type: =head1 -#: ../edit/virt-edit.pod:195 -msgid "NON-INTERACTIVE EDITING" +#. type: textblock +#: ../clone/virt-sysprep.pod:306 +msgid "Some things inside the block devices that might need to be changed:" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:197 -msgid "" -"C normally calls out to C<$EDITOR> (or vi) so the system " -"administrator can interactively edit the file." +#: ../clone/virt-sysprep.pod:312 +msgid "hostname and other net configuration" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:200 -msgid "" -"There are two ways also to use C from scripts in order to make " -"automated edits to files. (Note that although you I use C " -"like this, it's less error-prone to write scripts directly using the " -"libguestfs API and Augeas for configuration file editing.)" +#: ../clone/virt-sysprep.pod:320 +msgid "SSH host keys" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:206 -msgid "" -"The first method is to temporarily set C<$EDITOR> to any script or program " -"you want to run. The script is invoked as C<$EDITOR tmpfile> and it should " -"update C in place however it likes." +#: ../clone/virt-sysprep.pod:324 +msgid "Windows unique security ID (SID)" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:210 +#: ../clone/virt-sysprep.pod:328 +msgid "Puppet registration" +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:334 +msgid "COPYING THE BLOCK DEVICE" +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:336 msgid "" -"The second method is to use the I<-e> parameter of C to run a " -"short Perl snippet in the style of L. For example to replace all " -"instances of C with C in a file:" +"Starting with an original guest, you probably wish to copy the guest block " +"device and its configuration to make a template. Then once you are happy " +"with the template, you will want to make many clones from it." msgstr "" #. type: verbatim -#: ../edit/virt-edit.pod:214 +#: ../clone/virt-sysprep.pod:341 #, no-wrap msgid "" -" virt-edit -d domname filename -e 's/foo/bar/'\n" +" virt-sysprep\n" +" |\n" +" v\n" +" original guest --------> template ---------->\n" +" \\------> cloned\n" +" \\-----> guests\n" +" \\---->\n" "\n" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:216 +#: ../clone/virt-sysprep.pod:349 msgid "" -"The full power of Perl regular expressions can be used (see L). " -"For example to delete root's password you could do:" +"You can, of course, just copy the block device on the host using L or " +"L." msgstr "" #. type: verbatim -#: ../edit/virt-edit.pod:219 +#: ../clone/virt-sysprep.pod:352 #, no-wrap msgid "" -" virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n" +" dd dd\n" +" original guest --------> template ---------->\n" +" \\------> cloned\n" +" \\-----> guests\n" +" \\---->\n" "\n" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:221 -msgid "" -"What really happens is that the snippet is evaluated as a Perl expression " -"for each line of the file. The line, including the final C<\\n>, is passed " -"in C<$_> and the expression should update C<$_> or leave it unchanged." -msgstr "" - -#. type: textblock -#: ../edit/virt-edit.pod:226 -msgid "" -"To delete a line, set C<$_> to the empty string. For example, to delete the " -"C user account from the password file you can do:" +#: ../clone/virt-sysprep.pod:358 +msgid "There are some smarter (and faster) ways too:" msgstr "" #. type: verbatim -#: ../edit/virt-edit.pod:229 +#: ../clone/virt-sysprep.pod:364 #, no-wrap msgid "" -" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n" +" snapshot\n" +" template ---------->\n" +" \\------> cloned\n" +" \\-----> guests\n" +" \\---->\n" "\n" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:231 +#: ../clone/virt-sysprep.pod:370 msgid "" -"To insert a line, prepend or append it to C<$_>. However appending lines to " -"the end of the file is rather difficult this way since there is no concept " -"of \"last line of the file\" - your expression just doesn't get called " -"again. You might want to use the first method (setting C<$EDITOR>) if you " -"want to do this." +"Use the block device as a backing file and create a snapshot on top for each " +"guest. The advantage is that you don't need to copy the block device (very " +"fast) and only changes are stored (less storage required)." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:237 +#: ../clone/virt-sysprep.pod:375 msgid "" -"The variable C<$lineno> contains the current line number. As is " -"traditional, the first line in the file is number C<1>." +"Note that writing to the backing file once you have created guests on top of " +"it is not possible: you will corrupt the guests." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:240 +#: ../clone/virt-sysprep.pod:378 msgid "" -"The return value from the expression is ignored, but the expression may call " -"C in order to abort the whole program, leaving the original file " -"untouched." +"Tools that can do this include: L (with the I option), L (I<--snapshot> option). Some " +"filesystems (such as btrfs) and most Network Attached Storage devices can " +"also create cheap snapshots from files or LUNs." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:244 -msgid "" -"Remember when matching the end of a line that C<$_> may contain the final C<" -"\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a " -"newline then neither of these. Thus to match or substitute some text at the " -"end of a line, use this regular expression:" +#: ../clone/virt-sysprep.pod:386 +msgid "Get your NAS to snapshot and/or duplicate the LUN." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:249 -#, no-wrap +#. type: textblock +#: ../clone/virt-sysprep.pod:390 +msgid "Prepare your template using L. See below." +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:394 +msgid "VIRT-CLONE" +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:396 msgid "" -" /some text(\\r?\\n)?$/\n" -"\n" +"A separate tool, L, can be used to duplicate the block device " +"and/or modify the external libvirt configuration of a guest. It will reset " +"the name, UUID and MAC address of the guest in the libvirt XML." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:251 +#: ../clone/virt-sysprep.pod:401 msgid "" -"Alternately, use the perl C function, being careful not to chomp C<" -"$_> itself (since that would remove all newlines from the file):" +"L does not use libguestfs and cannot look inside the disk " +"image. This was the original motivation to write virt-sysprep." +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:404 +msgid "SPARSIFY" msgstr "" #. type: verbatim -#: ../edit/virt-edit.pod:255 +#: ../clone/virt-sysprep.pod:406 #, no-wrap msgid "" -" my $m = $_; chomp $m; $m =~ /some text$/\n" +" virt-sparsify\n" +" original guest --------> template\n" "\n" msgstr "" -#. type: =head1 -#: ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858 -msgid "WINDOWS PATHS" +#. type: textblock +#: ../clone/virt-sysprep.pod:409 +msgid "" +"L can be used to make the cloning template smaller, making " +"it easier to compress and/or faster to copy." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:259 +#: ../clone/virt-sysprep.pod:412 msgid "" -"C has a limited ability to understand Windows drive letters and " -"paths (eg. C)." +"Notice that since virt-sparsify also copies the image, you can use it to " +"make the initial copy (instead of C
)." msgstr "" -#. type: textblock -#: ../edit/virt-edit.pod:262 -msgid "If and only if the guest is running Windows then:" +#. type: =head2 +#: ../clone/virt-sysprep.pod:415 +msgid "RESIZE" msgstr "" -#. type: textblock -#: ../edit/virt-edit.pod:268 +#. type: verbatim +#: ../clone/virt-sysprep.pod:417 +#, no-wrap msgid "" -"Drive letter prefixes like C are resolved against the Windows Registry " -"to the correct filesystem." +" virt-resize\n" +" template ---------->\n" +" \\------> cloned\n" +" \\-----> guests\n" +" \\---->\n" +"\n" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:273 +#: ../clone/virt-sysprep.pod:423 msgid "" -"Any backslash (C<\\>) characters in the path are replaced with forward " -"slashes so that libguestfs can process it." +"If you want to give people cloned guests, but let them pick the size of the " +"guest themselves (eg. depending on how much they are prepared to pay for " +"disk space), then instead of copying the template, you can run L. Virt-resize performs a copy and resize, and thus is ideal for cloning " +"guests from a template." msgstr "" +#. type: =head1 +#: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1164 +msgid "SECURITY" +msgstr "БЕЗПЕКА" + #. type: textblock -#: ../edit/virt-edit.pod:278 +#: ../clone/virt-sysprep.pod:431 msgid "" -"The path is resolved case insensitively to locate the file that should be " -"edited." +"Although virt-sysprep removes some sensitive information from the guest, it " +"does not pretend to remove all of it. You should examine the L " +"above, and the implementation of the operations in the shell script. You " +"should also examine the guest afterwards." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:283 -msgid "There are some known shortcomings:" +#: ../clone/virt-sysprep.pod:436 +msgid "" +"Sensitive files are simply removed. The data they contained may still exist " +"on the disk, easily recovered with a hex editor or undelete tool. Use " +"L as one way to remove this content. See also the L command to get rid of deleted content in directory entries and inodes." +msgstr "" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:442 +msgid "RANDOM SEED" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:289 -msgid "Some NTFS symbolic links may not be followed correctly." +#: ../clone/virt-sysprep.pod:444 +msgid "I<(This section applies to Linux guests only)>" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:293 -msgid "NTFS junction points that cross filesystems are not followed." +#: ../clone/virt-sysprep.pod:446 +msgid "" +"The virt-sysprep C operation writes a few bytes of randomness " +"from the host into the guest's random seed file." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:299 +#: ../clone/virt-sysprep.pod:449 msgid "" -"L is a more powerful, lower level tool which you can use when " -"C doesn't work." +"If this is just done once and the guest is cloned from the same template, " +"then each guest will start with the same entropy, and things like SSH host " +"keys and TCP sequence numbers may be predictable." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:302 -msgid "Using C is approximately equivalent to doing:" +#: ../clone/virt-sysprep.pod:453 +msgid "" +"Therefore you should arrange to add more randomness I cloning from a " +"template too, which can be done by just enabling the C " +"operation:" msgstr "" #. type: verbatim -#: ../edit/virt-edit.pod:304 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --ro -d myguest -i\n" -#| "\n" +#: ../clone/virt-sysprep.pod:457 +#, no-wrap msgid "" -" guestfish --rw -i -d domname edit /file\n" +" cp template.img newguest.img\n" +" virt-sysprep --enable=random-seed -a newguest.img\n" "\n" msgstr "" -" guestfish --ro -d myguest -i\n" -"\n" + +#. type: =head2 +#: ../clone/virt-sysprep.pod:460 +msgid "SELINUX RELABELLING" +msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:306 -msgid "" -"where C is the name of the libvirt guest, and C is the full " -"path to the file." +#: ../clone/virt-sysprep.pod:462 +msgid "I<(This section applies to Linux guests using SELinux only)>" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:309 +#: ../clone/virt-sysprep.pod:464 msgid "" -"The command above uses libguestfs's guest inspection feature and so does not " -"work on guests that libguestfs cannot inspect, or on things like arbitrary " -"disk images that don't contain guests. To edit a file on a disk image " -"directly, use:" +"If any new files are created by virt-sysprep, then virt-sysprep touches C so that these will be correctly labelled by SELinux the next " +"time the guest is booted. This process interrupts boot and can take some " +"time." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:314 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:469 msgid "" -" guestfish --rw -a disk.img -m /dev/sda1 edit /file\n" -"\n" +"You can force relabelling for all guests by supplying the I<--selinux-" +"relabel> option." msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" #. type: textblock -#: ../edit/virt-edit.pod:316 +#: ../clone/virt-sysprep.pod:472 msgid "" -"where C is the disk image, C is the filesystem within " -"the disk image to edit, and C is the full path to the file." +"You can disable relabelling entirely by supplying the I<--no-selinux-" +"relabel> option." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:320 +#: ../clone/virt-sysprep.pod:484 +msgid "This program returns 0 on success, or 1 if there was an error." +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:488 msgid "" -"C cannot create new files. Use the guestfish commands C, " -"C or C instead:" +"L, L, L, L, L, L, L, L, L, L, L, L." +msgstr "" + +#. type: textblock +#: ../df/virt-df.pod:5 +msgid "virt-df - Display free space on virtual filesystems" msgstr "" #. type: verbatim -#: ../edit/virt-edit.pod:323 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --ro -d myguest -i\n" -#| "\n" +#: ../df/virt-df.pod:9 +#, no-wrap msgid "" -" guestfish --rw -i -d domname touch /newfile\n" +" virt-df [--options]\n" "\n" msgstr "" -" guestfish --ro -d myguest -i\n" +" virt-df [--параметри]\n" "\n" #. type: verbatim -#: ../edit/virt-edit.pod:325 +#: ../df/virt-df.pod:11 #, no-wrap msgid "" -" guestfish --rw -i -d domname write /newfile \"new content\"\n" +" virt-df [--options] -d domname\n" "\n" msgstr "" #. type: verbatim -#: ../edit/virt-edit.pod:327 +#: ../df/virt-df.pod:13 #, no-wrap msgid "" -" guestfish --rw -i -d domname upload localfile /newfile\n" +" virt-df [--options] -a disk.img [-a disk.img ...]\n" "\n" msgstr "" -#. type: =head1 -#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1086 -#: ../rescue/virt-rescue.pod:261 ../src/guestfs.pod:3103 -#: ../test-tool/libguestfs-test-tool.pod:95 -msgid "ENVIRONMENT VARIABLES" -msgstr "ЗМІННІ СЕРЕДОВИЩА" +#. type: verbatim +#: ../df/virt-df.pod:17 +#, no-wrap +msgid "" +" virt-df [--options] domname\n" +"\n" +msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:333 -#, fuzzy -#| msgid "EDITOR" -msgid "C" -msgstr "РЕДАКТОР" +#. type: verbatim +#: ../df/virt-df.pod:19 +#, no-wrap +msgid "" +" virt-df [--options] disk.img [disk.img ...]\n" +"\n" +msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:335 +#: ../df/virt-df.pod:23 msgid "" -"If set, this string is used as the editor. It may contain arguments, eg. C<" -"\"emacs -nw\">" +"C is a command line tool to display free space on virtual machine " +"filesystems. Unlike other tools, it doesn't just display the size of disk " +"allocated to a virtual machine, but can look inside disk images to see how " +"much space is really being used." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:338 -msgid "If not set, C is used." +#: ../df/virt-df.pod:28 +msgid "" +"If used without any I<-a> or I<-d> arguments, C checks with libvirt " +"to get a list of all active and inactive guests, and performs a C-type " +"operation on each one in turn, printing out the results." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:356 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." +#: ../df/virt-df.pod:32 msgid "" -"L, L, L, L, L, L, L, L, " -"L, L, L." +"If any I<-a> or I<-d> arguments are specified, C performs a C-" +"type operation on either the single named libvirt domain, or on the disk " +"image(s) listed on the command line (which must all belong to a single VM). " +"In this mode (with arguments), C will I. If you want to run on multiple guests, then you have to invoke " +"C multiple times." msgstr "" -"L, L, L, L, L, L, L, L, L." #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:5 -msgid "guestfs-erlang - How to use libguestfs from Erlang" +#: ../df/virt-df.pod:39 +msgid "" +"Use the I<--csv> option to get a format which can be easily parsed by other " +"programs. Other options are similar to the standard L command." +msgstr "" + +#. type: textblock +#: ../df/virt-df.pod:45 +msgid "" +"Show disk usage for a single libvirt guest called C. Make the " +"output human-readable:" msgstr "" #. type: verbatim -#: ../erlang/examples/guestfs-erlang.pod:9 +#: ../df/virt-df.pod:48 #, no-wrap msgid "" -" {ok, G} = guestfs:create(),\n" -" ok = guestfs:add_drive_opts(G, Disk,\n" -" [{format, \"raw\"}, {readonly, true}]),\n" -" ok = guestfs:launch(G),\n" -" [Device] = guestfs:list_devices(G),\n" -" ok = guestfs:close(G).\n" +" # virt-df -d F14x64 -h\n" +" Filesystem Size Used Available Use%\n" +" F14x64:/dev/sda1 484M 66M 393M 14%\n" +" F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46%\n" "\n" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:18 -msgid "" -"This manual page documents how to call libguestfs from the Erlang " -"programming language. This page just documents the differences from the C " -"API and gives some examples. If you are not familiar with using libguestfs, " -"you also need to read L." -msgstr "" - -#. type: =head2 -#: ../erlang/examples/guestfs-erlang.pod:23 -msgid "OPENING AND CLOSING THE HANDLE" +#: ../df/virt-df.pod:53 +msgid "Show disk usage for a disk image file called C:" msgstr "" -#. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:25 +#. type: verbatim +#: ../df/virt-df.pod:55 +#, no-wrap msgid "" -"The Erlang bindings are implemented using an external program called C. This program must be on the current PATH, or else you should " -"specify the full path to the program:" +" $ virt-df -a test1.img\n" +" Filesystem 1K-blocks Used Available Use%\n" +" test1.img:/dev/sda1 99099 1551 92432 2%\n" +"\n" msgstr "" #. type: verbatim -#: ../erlang/examples/guestfs-erlang.pod:29 -#, fuzzy, no-wrap -#| msgid "" -#| " g = guestfs_create ();\n" -#| " \n" +#: ../df/virt-df.pod:112 +#, no-wrap msgid "" -" {ok, G} = guestfs:create().\n" +" virt-df --format=raw -a disk.img\n" "\n" msgstr "" -" g = guestfs_create ();\n" -" \n" #. type: verbatim -#: ../erlang/examples/guestfs-erlang.pod:31 +#: ../df/virt-df.pod:116 #, no-wrap msgid "" -" {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\n" +" virt-df --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:33 -msgid "C is the libguestfs handle which you should pass to other functions." +#: ../df/virt-df.pod:129 +msgid "Print sizes in human-readable format." msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:36 -msgid "To close the handle:" +#: ../df/virt-df.pod:131 +msgid "You are not allowed to use I<-h> and I<--csv> at the same time." msgstr "" -#. type: verbatim -#: ../erlang/examples/guestfs-erlang.pod:38 -#, fuzzy, no-wrap -#| msgid "" -#| " g = guestfs_create ();\n" -#| " \n" -msgid "" -" ok = guestfs:close(G).\n" -"\n" +#. type: =item +#: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:164 +msgid "B<-i>" +msgstr "B<-i>" + +#. type: =item +#: ../df/virt-df.pod:135 +msgid "B<--inodes>" +msgstr "B<--inodes>" + +#. type: textblock +#: ../df/virt-df.pod:137 +msgid "Print inodes instead of blocks." msgstr "" -" g = guestfs_create ();\n" -" \n" -#. type: =head2 -#: ../erlang/examples/guestfs-erlang.pod:40 -#, fuzzy -#| msgid "See L." -msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS" -msgstr "Див. L." +#. type: =item +#: ../df/virt-df.pod:139 +msgid "B<--one-per-guest>" +msgstr "B<--one-per-guest>" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:42 +#: ../df/virt-df.pod:141 msgid "" -"For functions that take optional arguments, the first arguments are the non-" -"optional ones. The last argument is a list of tuples supplying the " -"remaining optional arguments." +"Run one libguestfs appliance per guest. Normally C will add the " +"disks from several guests to a single libguestfs appliance." msgstr "" -#. type: verbatim -#: ../erlang/examples/guestfs-erlang.pod:46 -#, fuzzy, no-wrap -#| msgid "" -#| " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" -#| " va_list args);\n" -#| "\n" -msgid "" -" ok = guestfs:add_drive_opts(G, Disk,\n" -" [{format, \"raw\"}, {readonly, true}]).\n" -"\n" +#. type: textblock +#: ../df/virt-df.pod:144 +msgid "You might use this option in the following circumstances:" msgstr "" -" int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n" -" va_list args);\n" -"\n" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:49 -msgid "If the last argument would be an empty list, you can also omit it:" +#: ../df/virt-df.pod:150 +msgid "" +"If you think an untrusted guest might actively try to exploit the libguestfs " +"appliance kernel, then this prevents one guest from interfering with the " +"stats printed for another guest." msgstr "" -#. type: verbatim -#: ../erlang/examples/guestfs-erlang.pod:51 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfs_add_drive_opts (g, filename, -1);\n" -#| "\n" +#. type: textblock +#: ../df/virt-df.pod:156 msgid "" -" ok = guestfs:add_drive_opts(G, Disk).\n" -"\n" +"If the kernel has a bug which stops it from accessing a filesystem in one " +"guest (see for example RHBZ#635373) then this allows libguestfs to continue " +"and report stats for further guests." msgstr "" -" guestfs_add_drive_opts (g, filename, -1);\n" -"\n" -#. type: =head2 -#: ../erlang/examples/guestfs-erlang.pod:53 -msgid "RETURN VALUES AND ERRORS" +#. type: textblock +#: ../df/virt-df.pod:165 +msgid "" +"Print UUIDs instead of names. This is useful for following a guest even " +"when the guest is migrated or renamed, or when two guests happen to have the " +"same name." msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:55 +#: ../df/virt-df.pod:169 msgid "" -"On success, most functions return a C term (which could be a list, " -"string, tuple etc.). If there is nothing for the function to return, then " -"the atom C is returned." +"Note that only domains that we fetch from libvirt come with UUIDs. For disk " +"images, we still print the disk image name even when this option is " +"specified." msgstr "" +#. type: =head1 +#: ../df/virt-df.pod:191 +#, fuzzy +#| msgid "NUMBERS" +msgid "STATVFS NUMBERS" +msgstr "ЧИСЛА" + #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:59 -msgid "On error, you would see one of the following tuples:" +#: ../df/virt-df.pod:193 +msgid "" +"C (and L) get information by issuing a L system " +"call. You can get the same information directly, either from the host " +"(using libguestfs) or inside the guest:" msgstr "" #. type: =item -#: ../erlang/examples/guestfs-erlang.pod:63 -msgid "C<{error, Msg, Errno}>" +#: ../df/virt-df.pod:199 +msgid "From the host" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:65 -msgid "This indicates an ordinary error from the function." +#: ../df/virt-df.pod:201 ../df/virt-df.pod:209 +#, fuzzy +#| msgid "" +#| " sh-lines command\n" +#| "\n" +msgid "Run this command:" msgstr "" +" sh-lines команда\n" +"\n" -#. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:67 +#. type: verbatim +#: ../df/virt-df.pod:203 +#, fuzzy, no-wrap +#| msgid "" +#| " guestfish --ro -d myguest -i\n" +#| "\n" msgid "" -"C is the error message (string) and C is the Unix error " -"(integer)." +" guestfish --ro -d GuestName -i statvfs /\n" +"\n" msgstr "" +" guestfish --ro -d myguest -i\n" +"\n" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:70 -msgid "C can be zero. See L." +#: ../df/virt-df.pod:205 ../df/virt-df.pod:213 +msgid "(change C to see stats for other filesystems)." msgstr "" #. type: =item -#: ../erlang/examples/guestfs-erlang.pod:72 -msgid "C<{unknown, Function}>" +#: ../df/virt-df.pod:207 +msgid "From inside the guest" msgstr "" -#. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:74 +#. type: verbatim +#: ../df/virt-df.pod:211 +#, no-wrap msgid "" -"This indicates that the function you called is not known. Generally this " -"means you are mixing C from another version of libguestfs, " -"which you should not do." +" python -c 'import os; s = os.statvfs (\"/\"); print s'\n" +"\n" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:78 -msgid "C is the name of the unknown function." -msgstr "" - -#. type: =item -#: ../erlang/examples/guestfs-erlang.pod:80 -msgid "C<{unknownarg, Arg}>" +#: ../df/virt-df.pod:255 +msgid "" +"L, L, L, L, L." msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:82 -msgid "" -"This indicates that you called a function with optional arguments, with an " -"unknown argument name." +#: ../edit/virt-edit.pod:5 +msgid "virt-edit - Edit a file in a virtual machine" msgstr "" -#. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:85 -msgid "C is the name of the unknown argument." +#. type: verbatim +#: ../edit/virt-edit.pod:9 +#, no-wrap +msgid "" +" virt-edit [--options] -d domname file [file ...]\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:11 +#, no-wrap +msgid "" +" virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:13 +#, no-wrap +msgid "" +" virt-edit [-d domname|-a disk.img] file -e 'expr'\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:17 +#, no-wrap +msgid "" +" virt-edit domname file\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183 +#, no-wrap +msgid "" +" virt-edit disk.img [disk.img ...] file\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23 +#: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15 +#: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:21 +#: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51 +msgid "WARNING" +msgstr "ПОПЕРЕДЖЕННЯ" + +#. type: textblock +#: ../edit/virt-edit.pod:23 +msgid "" +"You must I use C on live virtual machines. If you do this, " +"you risk disk corruption in the VM. C tries to stop you from " +"doing this, but doesn't catch all cases." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:29 +msgid "" +"C is a command line tool to edit C where each C " +"exists in the named virtual machine (or disk image)." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:32 +msgid "" +"Multiple filenames can be given, in which case they are each edited in " +"turn. Each filename must be a full path, starting at the root directory " +"(starting with '/')." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:36 +msgid "If you want to just view a file, use L." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:38 +msgid "" +"For more complex cases you should look at the L tool (see L below)." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:41 +msgid "" +"C cannot be used to create a new file. L can do " +"that and much more." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:46 +msgid "Edit the named files interactively:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:48 +#, no-wrap +msgid "" +" virt-edit -d mydomain /boot/grub/grub.conf\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:50 +#, no-wrap +msgid "" +" virt-edit -d mydomain /etc/passwd\n" +"\n" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:52 +msgid "For Windows guests, some Windows paths are understood:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:54 +#, no-wrap +msgid "" +" virt-edit -d mywindomain 'c:\\autoexec.bat'\n" +"\n" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:56 +msgid "" +"If Perl is installed, you can also edit files non-interactively (see L below). To change the init default level to 5:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:60 +#, no-wrap +msgid "" +" virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n" +"\n" +msgstr "" + +#. type: =item +#: ../edit/virt-edit.pod:81 +msgid "B<-b> extension" +msgstr "" + +#. type: =item +#: ../edit/virt-edit.pod:83 +msgid "B<--backup> extension" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:85 +msgid "" +"Create a backup of the original file I. The backup " +"has the original filename with C added." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:88 +msgid "" +"Usually the first character of C would be a dot C<.> so you would " +"write:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:91 +#, no-wrap +msgid "" +" virt-edit -b .orig [etc]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:93 +msgid "By default, no backup file is made." +msgstr "" + +#. type: =item +#: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181 +#: ../fuse/guestmount.pod:105 ../inspector/virt-inspector.pod:74 +#: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78 +#: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128 +msgid "B<-c URI>" +msgstr "B<-c адреса>" + +#. type: =item +#: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183 +#: ../fuse/guestmount.pod:107 ../inspector/virt-inspector.pod:76 +#: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80 +#: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130 +msgid "B<--connect URI>" +msgstr "B<--connect адреса>" + +#. type: textblock +#: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84 +#: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134 +#: ../tools/virt-win-reg.pl:135 +msgid "" +"If you specify guest block devices directly, then libvirt is not used at all." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:114 +msgid "" +"When prompting for keys and passphrases, virt-edit normally turns echoing " +"off so you cannot see what you are typing. If you are not worried about " +"Tempest attacks and there is no one else in the room you can specify this " +"flag to see what you are typing." +msgstr "" + +#. type: =item +#: ../edit/virt-edit.pod:119 +msgid "B<-e> EXPR" +msgstr "B<-e> вираз" + +#. type: =item +#: ../edit/virt-edit.pod:121 +msgid "B<--expr> EXPR" +msgstr "B<--expr> вираз" + +#. type: textblock +#: ../edit/virt-edit.pod:123 +msgid "" +"Instead of launching the external editor, non-interactively apply the Perl " +"expression C to each line in the file. See L below." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:127 +msgid "" +"Be careful to properly quote the expression to prevent it from being altered " +"by the shell." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:130 +msgid "Note that this option is only available when Perl 5 is installed." +msgstr "" + +#. type: =item +#: ../edit/virt-edit.pod:132 +msgid "B<--format> raw|qcow2|..." +msgstr "B<--format> raw|qcow2|..." + +#. type: verbatim +#: ../edit/virt-edit.pod:143 +#, no-wrap +msgid "" +" virt-edit --format=raw -a disk.img file\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:147 +#, no-wrap +msgid "" +" virt-edit --format=raw -a disk.img --format -a another.img file\n" +"\n" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:181 +msgid "Previous versions of virt-edit allowed you to write either:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:187 +#, no-wrap +msgid "" +" virt-edit guestname file\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../edit/virt-edit.pod:195 +msgid "NON-INTERACTIVE EDITING" +msgstr "НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ" + +#. type: textblock +#: ../edit/virt-edit.pod:197 +msgid "" +"C normally calls out to C<$EDITOR> (or vi) so the system " +"administrator can interactively edit the file." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:200 +msgid "" +"There are two ways also to use C from scripts in order to make " +"automated edits to files. (Note that although you I use C " +"like this, it's less error-prone to write scripts directly using the " +"libguestfs API and Augeas for configuration file editing.)" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:206 +msgid "" +"The first method is to temporarily set C<$EDITOR> to any script or program " +"you want to run. The script is invoked as C<$EDITOR tmpfile> and it should " +"update C in place however it likes." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:210 +msgid "" +"The second method is to use the I<-e> parameter of C to run a " +"short Perl snippet in the style of L. For example to replace all " +"instances of C with C in a file:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:214 +#, no-wrap +msgid "" +" virt-edit -d domname filename -e 's/foo/bar/'\n" +"\n" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:216 +msgid "" +"The full power of Perl regular expressions can be used (see L). " +"For example to delete root's password you could do:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:219 +#, no-wrap +msgid "" +" virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n" +"\n" +msgstr "" +" virt-edit -d назва_домену /etc/passwd -e 's/^root:.*?:/root::/'\n" +"\n" + +#. type: textblock +#: ../edit/virt-edit.pod:221 +msgid "" +"What really happens is that the snippet is evaluated as a Perl expression " +"for each line of the file. The line, including the final C<\\n>, is passed " +"in C<$_> and the expression should update C<$_> or leave it unchanged." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:226 +msgid "" +"To delete a line, set C<$_> to the empty string. For example, to delete the " +"C user account from the password file you can do:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:229 +#, no-wrap +msgid "" +" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n" +"\n" +msgstr "" +" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n" +"\n" + +#. type: textblock +#: ../edit/virt-edit.pod:231 +msgid "" +"To insert a line, prepend or append it to C<$_>. However appending lines to " +"the end of the file is rather difficult this way since there is no concept " +"of \"last line of the file\" - your expression just doesn't get called " +"again. You might want to use the first method (setting C<$EDITOR>) if you " +"want to do this." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:237 +msgid "" +"The variable C<$lineno> contains the current line number. As is " +"traditional, the first line in the file is number C<1>." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:240 +msgid "" +"The return value from the expression is ignored, but the expression may call " +"C in order to abort the whole program, leaving the original file " +"untouched." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:244 +msgid "" +"Remember when matching the end of a line that C<$_> may contain the final C<" +"\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a " +"newline then neither of these. Thus to match or substitute some text at the " +"end of a line, use this regular expression:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:249 +#, no-wrap +msgid "" +" /some text(\\r?\\n)?$/\n" +"\n" +msgstr "" +" /якийсь текст(\\r?\\n)?$/\n" +"\n" + +#. type: textblock +#: ../edit/virt-edit.pod:251 +msgid "" +"Alternately, use the perl C function, being careful not to chomp C<" +"$_> itself (since that would remove all newlines from the file):" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:255 +#, no-wrap +msgid "" +" my $m = $_; chomp $m; $m =~ /some text$/\n" +"\n" +msgstr "" +" my $m = $_; chomp $m; $m =~ /якийсь текст$/\n" +"\n" + +#. type: textblock +#: ../edit/virt-edit.pod:259 +msgid "" +"C has a limited ability to understand Windows drive letters and " +"paths (eg. C)." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:278 +msgid "" +"The path is resolved case insensitively to locate the file that should be " +"edited." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:299 +msgid "" +"L is a more powerful, lower level tool which you can use when " +"C doesn't work." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:302 +msgid "Using C is approximately equivalent to doing:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:304 +#, no-wrap +msgid "" +" guestfish --rw -i -d domname edit /file\n" +"\n" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:306 +msgid "" +"where C is the name of the libvirt guest, and C is the full " +"path to the file." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:309 +msgid "" +"The command above uses libguestfs's guest inspection feature and so does not " +"work on guests that libguestfs cannot inspect, or on things like arbitrary " +"disk images that don't contain guests. To edit a file on a disk image " +"directly, use:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:314 +#, no-wrap +msgid "" +" guestfish --rw -a disk.img -m /dev/sda1 edit /file\n" +"\n" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:316 +msgid "" +"where C is the disk image, C is the filesystem within " +"the disk image to edit, and C is the full path to the file." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:320 +msgid "" +"C cannot create new files. Use the guestfish commands C, " +"C or C instead:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:323 +#, no-wrap +msgid "" +" guestfish --rw -i -d domname touch /newfile\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:325 +#, no-wrap +msgid "" +" guestfish --rw -i -d domname write /newfile \"new content\"\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:327 +#, no-wrap +msgid "" +" guestfish --rw -i -d domname upload localfile /newfile\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1119 +#: ../rescue/virt-rescue.pod:298 ../sparsify/virt-sparsify.pod:256 +#: ../src/guestfs.pod:3214 ../test-tool/libguestfs-test-tool.pod:95 +msgid "ENVIRONMENT VARIABLES" +msgstr "ЗМІННІ СЕРЕДОВИЩА" + +#. type: =item +#: ../edit/virt-edit.pod:333 +msgid "C" +msgstr "C" + +#. type: textblock +#: ../edit/virt-edit.pod:335 +msgid "" +"If set, this string is used as the editor. It may contain arguments, eg. C<" +"\"emacs -nw\">" +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:338 +msgid "If not set, C is used." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:356 +msgid "" +"L, L, L, L, L, L, L, L, " +"L, L, L." +msgstr "" +"L, L, L, L, L, L, L, L, " +"L, L, L." + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:5 +msgid "guestfs-erlang - How to use libguestfs from Erlang" +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:9 +#, no-wrap +msgid "" +" {ok, G} = guestfs:create(),\n" +" ok = guestfs:add_drive_opts(G, Disk,\n" +" [{format, \"raw\"}, {readonly, true}]),\n" +" ok = guestfs:launch(G),\n" +" [Device] = guestfs:list_devices(G),\n" +" ok = guestfs:close(G).\n" +"\n" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:18 +msgid "" +"This manual page documents how to call libguestfs from the Erlang " +"programming language. This page just documents the differences from the C " +"API and gives some examples. If you are not familiar with using libguestfs, " +"you also need to read L." +msgstr "" + +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:23 +msgid "OPENING AND CLOSING THE HANDLE" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:25 +msgid "" +"The Erlang bindings are implemented using an external program called C. This program must be on the current PATH, or else you should " +"specify the full path to the program:" +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:29 +#, no-wrap +msgid "" +" {ok, G} = guestfs:create().\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:31 +#, no-wrap +msgid "" +" {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\n" +"\n" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:33 +msgid "C is the libguestfs handle which you should pass to other functions." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:36 +msgid "To close the handle:" +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:38 +#, no-wrap +msgid "" +" ok = guestfs:close(G).\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:40 +msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:42 +msgid "" +"For functions that take optional arguments, the first arguments are the non-" +"optional ones. The last argument is a list of tuples supplying the " +"remaining optional arguments." +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:46 +#, no-wrap +msgid "" +" ok = guestfs:add_drive_opts(G, Disk,\n" +" [{format, \"raw\"}, {readonly, true}]).\n" +"\n" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:49 +msgid "If the last argument would be an empty list, you can also omit it:" +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:51 +#, no-wrap +msgid "" +" ok = guestfs:add_drive_opts(G, Disk).\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:53 +msgid "RETURN VALUES AND ERRORS" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:55 +msgid "" +"On success, most functions return a C term (which could be a list, " +"string, tuple etc.). If there is nothing for the function to return, then " +"the atom C is returned." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:59 +msgid "On error, you would see one of the following tuples:" +msgstr "" + +#. type: =item +#: ../erlang/examples/guestfs-erlang.pod:63 +msgid "C<{error, Msg, Errno}>" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:65 +msgid "This indicates an ordinary error from the function." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:67 +msgid "" +"C is the error message (string) and C is the Unix error " +"(integer)." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:70 +msgid "C can be zero. See L." +msgstr "" + +#. type: =item +#: ../erlang/examples/guestfs-erlang.pod:72 +msgid "C<{unknown, Function}>" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:74 +msgid "" +"This indicates that the function you called is not known. Generally this " +"means you are mixing C from another version of libguestfs, " +"which you should not do." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:78 +msgid "C is the name of the unknown function." +msgstr "" + +#. type: =item +#: ../erlang/examples/guestfs-erlang.pod:80 +msgid "C<{unknownarg, Arg}>" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:82 +msgid "" +"This indicates that you called a function with optional arguments, with an " +"unknown argument name." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:85 +msgid "C is the name of the unknown argument." +msgstr "" + +#. type: =head1 +#: ../erlang/examples/guestfs-erlang.pod:89 +#: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37 +#: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31 +#: ../python/examples/guestfs-python.pod:34 +#: ../ruby/examples/guestfs-ruby.pod:28 +msgid "EXAMPLE 1: CREATE A DISK IMAGE" +msgstr "ПРИКЛАД 1. СТВОРЕННЯ ОБРАЗУ ДИСКА" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:91 +#: ../examples/guestfs-examples.pod:27 ../java/examples/guestfs-java.pod:39 +#: ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33 +#: ../python/examples/guestfs-python.pod:36 +#: ../ruby/examples/guestfs-ruby.pod:30 +msgid "@EXAMPLE1@" +msgstr "@EXAMPLE1@" + +#. type: =head1 +#: ../erlang/examples/guestfs-erlang.pod:93 +#: ../examples/guestfs-examples.pod:29 ../java/examples/guestfs-java.pod:41 +#: ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35 +#: ../python/examples/guestfs-python.pod:38 +#: ../ruby/examples/guestfs-ruby.pod:32 +msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE" +msgstr "ПРИКЛАД 2. ПЕРЕВІРКА ОБРАЗУ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:95 +#: ../examples/guestfs-examples.pod:31 ../java/examples/guestfs-java.pod:43 +#: ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37 +#: ../python/examples/guestfs-python.pod:40 +#: ../ruby/examples/guestfs-ruby.pod:34 +msgid "@EXAMPLE2@" +msgstr "@EXAMPLE2@" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:99 +msgid "" +"L, L, L, L, L, L, L, " +"L, L. L." +msgstr "" + +#. type: =head1 +#: ../erlang/examples/guestfs-erlang.pod:110 +#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 +#: ../examples/guestfs-testing.pod:298 ../fish/guestfish.pod:1296 +#: ../fish/virt-copy-in.pod:60 ../fish/virt-copy-out.pod:49 +#: ../fish/virt-tar-in.pod:58 ../fish/virt-tar-out.pod:51 +#: ../fuse/guestmount.pod:328 ../inspector/virt-inspector.pod:404 +#: ../java/examples/guestfs-java.pod:58 ../ocaml/examples/guestfs-ocaml.pod:91 +#: ../perl/examples/guestfs-perl.pod:52 +#: ../python/examples/guestfs-python.pod:54 +#: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3354 +#: ../test-tool/libguestfs-test-tool.pod:106 +msgid "AUTHORS" +msgstr "АВТОРИ" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:112 +#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 +#: ../examples/guestfs-testing.pod:300 ../fish/guestfish.pod:1298 +#: ../fish/virt-copy-in.pod:62 ../fish/virt-copy-out.pod:51 +#: ../fish/virt-tar-in.pod:60 ../fish/virt-tar-out.pod:53 +#: ../fuse/guestmount.pod:330 ../java/examples/guestfs-java.pod:60 +#: ../ocaml/examples/guestfs-ocaml.pod:93 ../perl/examples/guestfs-perl.pod:54 +#: ../python/examples/guestfs-python.pod:56 +#: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3356 +#: ../test-tool/libguestfs-test-tool.pod:108 +msgid "Richard W.M. Jones (C)" +msgstr "Richard W.M. Jones (C)" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:116 +#: ../examples/guestfs-testing.pod:304 ../java/examples/guestfs-java.pod:64 +#: ../perl/examples/guestfs-perl.pod:58 +msgid "Copyright (C) 2011 Red Hat Inc. L" +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:118 +#: ../examples/guestfs-examples.pod:53 ../examples/guestfs-recipes.pod:405 +#: ../java/examples/guestfs-java.pod:66 ../ocaml/examples/guestfs-ocaml.pod:99 +#: ../perl/examples/guestfs-perl.pod:60 +#: ../python/examples/guestfs-python.pod:62 +#: ../ruby/examples/guestfs-ruby.pod:56 +msgid "" +"The examples in this manual page may be freely copied, modified and " +"distributed without any restrictions." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:121 +#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 +#: ../examples/guestfs-testing.pod:306 ../java/examples/guestfs-java.pod:69 +#: ../ocaml/examples/guestfs-ocaml.pod:102 +#: ../perl/examples/guestfs-perl.pod:63 +#: ../python/examples/guestfs-python.pod:65 +#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3363 +msgid "" +"This library is free software; you can redistribute it and/or modify it " +"under the terms of the GNU Lesser General Public License as published by the " +"Free Software Foundation; either version 2 of the License, or (at your " +"option) any later version." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:126 +#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 +#: ../examples/guestfs-testing.pod:311 ../java/examples/guestfs-java.pod:74 +#: ../ocaml/examples/guestfs-ocaml.pod:107 +#: ../perl/examples/guestfs-perl.pod:68 +#: ../python/examples/guestfs-python.pod:70 +#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3368 +msgid "" +"This library is distributed in the hope that it will be useful, but WITHOUT " +"ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " +"FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License " +"for more details." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:131 +#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 +#: ../examples/guestfs-testing.pod:316 ../java/examples/guestfs-java.pod:79 +#: ../ocaml/examples/guestfs-ocaml.pod:112 +#: ../perl/examples/guestfs-perl.pod:73 +#: ../python/examples/guestfs-python.pod:75 +#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3373 +msgid "" +"You should have received a copy of the GNU Lesser General Public License " +"along with this library; if not, write to the Free Software Foundation, " +"Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-examples.pod:5 +msgid "guestfs-examples - Examples of using libguestfs from C" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9 +#, no-wrap +msgid "" +" #include \n" +" \n" +msgstr "" +" #include \n" +" \n" + +#. type: verbatim +#: ../examples/guestfs-examples.pod:11 +#, no-wrap +msgid "" +" guestfs_h *g = guestfs_create ();\n" +" guestfs_add_drive_ro (g, \"disk.img\");\n" +" guestfs_launch (g);\n" +"\n" +msgstr "" +" guestfs_h *g = guestfs_create ();\n" +" guestfs_add_drive_ro (g, \"disk.img\");\n" +" guestfs_launch (g);\n" +"\n" + +#. type: verbatim +#: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19 +#, no-wrap +msgid "" +" cc prog.c -o prog -lguestfs\n" +"or:\n" +" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" +"\n" +msgstr "" +" cc prog.c -o prog -lguestfs\n" +"або:\n" +" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" +"\n" + +#. type: textblock +#: ../examples/guestfs-examples.pod:21 +msgid "" +"This manual page contains examples of calling libguestfs from the C " +"programming language. If you are not familiar with using libguestfs, you " +"also need to read L." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-examples.pod:35 +msgid "" +"L, L, L, L, L, L, L, " +"L, L." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-examples.pod:51 ../ocaml/examples/guestfs-ocaml.pod:97 +#: ../python/examples/guestfs-python.pod:60 +#: ../ruby/examples/guestfs-ruby.pod:54 +msgid "Copyright (C) 2010 Red Hat Inc. L" +msgstr "" + +#. type: =end +#: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12 +msgid "comment" +msgstr "коментар" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:5 +msgid "" +"pod2man and pod2html have differing bugs which makes it hard to write URLs " +"here. The only way which works for both sorts of output is to just write " +"the URL directly. Do NOT use L<...> for URLs." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:9 +msgid "" +"We break with tradition here and don't use ALL CAPS for the section " +"headings, as this makes them much easier to read." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:16 +msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:20 +msgid "" +"This page contains recipes for and links to things you can do using " +"libguestfs, L and the virt tools." msgstr "" #. type: =head1 -#: ../erlang/examples/guestfs-erlang.pod:89 -#: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37 -#: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31 -#: ../python/examples/guestfs-python.pod:34 -#: ../ruby/examples/guestfs-ruby.pod:28 -msgid "EXAMPLE 1: CREATE A DISK IMAGE" +#: ../examples/guestfs-recipes.pod:23 +msgid "Audit a virtual machine for setuid files" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:91 -#: ../examples/guestfs-examples.pod:27 ../java/examples/guestfs-java.pod:39 -#: ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33 -#: ../python/examples/guestfs-python.pod:36 -#: ../ruby/examples/guestfs-ruby.pod:30 -#, fuzzy -#| msgid "EXAMPLE" -msgid "@EXAMPLE1@" -msgstr "ПРИКЛАД" +#: ../examples/guestfs-recipes.pod:25 +msgid "" +"The link below contains a small program which can be used to audit a Linux " +"virtual machine to see what setuid and setgid files it contains." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:28 +msgid "" +"https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-" +"files/#content" +msgstr "" #. type: =head1 -#: ../erlang/examples/guestfs-erlang.pod:93 -#: ../examples/guestfs-examples.pod:29 ../java/examples/guestfs-java.pod:41 -#: ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35 -#: ../python/examples/guestfs-python.pod:38 -#: ../ruby/examples/guestfs-ruby.pod:32 -msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE" +#: ../examples/guestfs-recipes.pod:30 +msgid "Change the background image in a Windows XP VM" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:95 -#: ../examples/guestfs-examples.pod:31 ../java/examples/guestfs-java.pod:43 -#: ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37 -#: ../python/examples/guestfs-python.pod:40 -#: ../ruby/examples/guestfs-ruby.pod:34 -#, fuzzy -#| msgid "EXAMPLE" -msgid "@EXAMPLE2@" -msgstr "ПРИКЛАД" +#: ../examples/guestfs-recipes.pod:32 +msgid "" +"The links below explain how to use L to change the background " +"image for a user of a Windows XP VM. Unfortunately the technique appears to " +"be substantially different for each version of Windows." +msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:99 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." +#: ../examples/guestfs-recipes.pod:37 msgid "" -"L, L, L, L, L, L, L, " -"L, L. L." +"https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://" +"lists.fedoraproject.org/pipermail/virt/2011-May/002658.html" msgstr "" -"L, L, L, L, L, L, L, L, L." #. type: =head1 -#: ../erlang/examples/guestfs-erlang.pod:110 -#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 -#: ../fish/guestfish.pod:1260 ../fish/virt-copy-in.pod:60 -#: ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58 -#: ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:319 -#: ../inspector/virt-inspector.pod:389 ../java/examples/guestfs-java.pod:58 -#: ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52 -#: ../python/examples/guestfs-python.pod:54 -#: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3237 -#: ../test-tool/libguestfs-test-tool.pod:106 -msgid "AUTHORS" -msgstr "АВТОРИ" +#: ../examples/guestfs-recipes.pod:40 +msgid "Cloning a virtual machine (Linux)" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:42 +msgid "" +"The guestfish technique described in the link below works well for most " +"Linux VMs. Depending on the Linux distro you may need to change the paths " +"slightly." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:46 +msgid "" +"https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-" +"vm/#content" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:48 +msgid "" +"Avoid L. Currently what to do about virt-clone is under " +"discussion." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:51 +msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:53 +msgid "Cloning a virtual machine (Windows)" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:55 +msgid "" +"It is possible to do a \"sysprep\" using libguestfs alone, although not " +"straightforward. Currently there is code in the Aeolus Oz project which " +"does this (using libguestfs). As part of our review of the virt-clone tool, " +"we may add sysprepping ability." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:60 +msgid "" +"https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-" +"list/2011-May/msg00019.html" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:63 +msgid "Convert a CD-ROM / DVD / ISO to a tarball" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:65 +msgid "This converts input C to output C:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:67 +#, no-wrap +msgid "" +" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:69 +msgid "To export just a subdirectory, eg. C, do:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:71 +#, no-wrap +msgid "" +" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:73 +msgid "Create empty disk images" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:75 +msgid "" +"You can use the L I<-N> option to create empty disk images. " +"The useful guide below explains the options available." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:78 +msgid "" +"https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/" +"#content" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:80 +msgid "Dump raw filesystem content from inside a disk image or VM" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:82 +msgid "" +"You can use the L C command to extract the raw " +"filesystem content from any filesystem in a disk image or a VM (even one " +"which is encrypted or buried inside an LV):" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:86 +#, no-wrap +msgid "" +" guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n" +"\n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:88 +#, no-wrap +msgid "" +" guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:90 +msgid "To list the filesystems in a disk image, use L." +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:92 +msgid "Edit grub configuration in a VM" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:94 +msgid "You can use this to:" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:100 +msgid "Fix a virtual machine that does not boot." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:104 +msgid "Change which kernel is used to boot the VM." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:108 +msgid "Change kernel command line options." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:112 +msgid "Use L to edit the grub configuration:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:114 +#, no-wrap +msgid "" +" virt-edit -d BrokenGuest /boot/grub/grub.conf\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:116 +msgid "" +"or for general tinkering inside an unbootable VM use L like " +"this:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:119 +#, no-wrap +msgid "" +" virt-rescue -d BrokenGuest\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:121 +msgid "Export any directory from a VM" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:123 +msgid "" +"To export C from a VM into a local directory use L:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:126 ../examples/guestfs-testing.pod:93 +#, no-wrap +msgid "" +" virt-copy-out -d Guest /home .\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 +#: ../fish/guestfish-actions.pod:1450 ../fish/guestfish-actions.pod:1715 +#: ../fish/guestfish-actions.pod:2132 ../src/guestfs-actions.pod:18 +#: ../src/guestfs-actions.pod:2334 ../src/guestfs-actions.pod:2758 +#: ../src/guestfs-actions.pod:3317 ../src/guestfs.pod:1685 +#: ../tools/virt-win-reg.pl:717 +msgid "Notes:" +msgstr "Нотатки:" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:134 +msgid "" +"The final dot of the command is not a printing error. It means we want to " +"copy out to the current directory." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:139 +msgid "This creates a directory called C under the current directory." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:143 +msgid "" +"If the guest is a Windows guest then you can use drive letters and " +"backslashes, but you must prefix the path with C and quote it to " +"protect it from the shell, like this:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:147 +#, no-wrap +msgid "" +" virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:149 +msgid "To get the output as a compressed tarball, do:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:151 +#, no-wrap +msgid "" +" virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:153 +msgid "" +"Although it sounds tempting, this is usually not a reliable way to get a " +"backup from a running guest. See the entry in the FAQ: http://libguestfs." +"org/FAQ.html#backup" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:157 +msgid "Find out which user is using the most space" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:159 +msgid "" +"This simple script examines a Linux guest to find out which user is using " +"the most space in their home directory:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:162 +#, no-wrap +msgid "" +" #!/bin/sh -\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:164 ../fish/guestfish.pod:984 +#, no-wrap +msgid "" +" set -e\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:166 +#, no-wrap +msgid "" +" vm=\"$1\"\n" +" dir=/home\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:169 +#, no-wrap +msgid "" +" eval $(guestfish --ro -d \"$vm\" -i --listen)\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:171 +#, no-wrap +msgid "" +" for d in $(guestfish --remote ls \"$dir\"); do\n" +" echo -n \"$dir/$d\"\n" +" echo -ne '\\t'\n" +" guestfish --remote du \"$dir/$d\";\n" +" done | sort -nr -k 2\n" +" \n" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941 +#, no-wrap +msgid "" +" guestfish --remote exit\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:179 +msgid "Get DHCP address from a VM" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:181 +msgid "" +"The link below explains the many different possible techniques for getting " +"the last assigned DHCP address of a virtual machine." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:184 +msgid "" +"https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-" +"a-virtual-machine-disk-image/#content" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:186 +msgid "" +"In the libguestfs source examples directory you will find the latest version " +"of the C program." +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:189 +msgid "Get the operating system product name string" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:191 +msgid "Save the following script into a file called C:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:193 +#, no-wrap +msgid "" +" #!/bin/sh -\n" +" set -e\n" +" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n" +" root=\"$(guestfish --remote inspect-get-roots)\"\n" +" guestfish --remote inspect-get-product-name \"$root\"\n" +" guestfish --remote exit\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:200 +msgid "Make the script executable and run it on a named guest:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:202 +#, no-wrap +msgid "" +" # product-name.sh RHEL60x64\n" +" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:205 +msgid "" +"You can also use an XPath query on the L XML using the " +"C command line tool or from your favourite programming language:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:209 +#, no-wrap +msgid "" +" # virt-inspector RHEL60x64 > xml\n" +" # xpath '//product_name' < xml\n" +" Found 1 nodes:\n" +" -- NODE --\n" +" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" +"\n" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:215 +msgid "Get the default boot kernel for a Linux VM" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:217 +msgid "" +"The link below contains a program to print the default boot kernel for a " +"Linux VM." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:220 +msgid "" +"https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-" +"kernel-for-a-vm/#content" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:222 +msgid "" +"It uses Augeas, and the technique is generally applicable for many different " +"tasks, such as:" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:229 +msgid "listing the user accounts in the guest" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:233 +msgid "what repositories is it configured to use" +msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:112 -#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 -#: ../fish/guestfish.pod:1262 ../fish/virt-copy-in.pod:62 -#: ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60 -#: ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:321 -#: ../java/examples/guestfs-java.pod:60 ../ocaml/examples/guestfs-ocaml.pod:93 -#: ../perl/examples/guestfs-perl.pod:54 -#: ../python/examples/guestfs-python.pod:56 -#: ../ruby/examples/guestfs-ruby.pod:50 ../src/guestfs.pod:3239 -#: ../test-tool/libguestfs-test-tool.pod:108 -msgid "Richard W.M. Jones (C)" +#: ../examples/guestfs-recipes.pod:237 +msgid "what NTP servers does it connect to" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:116 -#: ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58 -#, fuzzy -#| msgid "Copyright (C) 2009 Red Hat Inc." -msgid "Copyright (C) 2011 Red Hat Inc. L" -msgstr "© Red Hat Inc., 2009" +#: ../examples/guestfs-recipes.pod:241 +msgid "what were the boot messages last time it booted" +msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:118 -#: ../examples/guestfs-examples.pod:53 ../examples/guestfs-recipes.pod:405 -#: ../java/examples/guestfs-java.pod:66 ../ocaml/examples/guestfs-ocaml.pod:99 -#: ../perl/examples/guestfs-perl.pod:60 -#: ../python/examples/guestfs-python.pod:62 -#: ../ruby/examples/guestfs-ruby.pod:56 -msgid "" -"The examples in this manual page may be freely copied, modified and " -"distributed without any restrictions." +#: ../examples/guestfs-recipes.pod:245 +msgid "listing who was logged in recently" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:121 -#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 -#: ../java/examples/guestfs-java.pod:69 -#: ../ocaml/examples/guestfs-ocaml.pod:102 -#: ../perl/examples/guestfs-perl.pod:63 -#: ../python/examples/guestfs-python.pod:65 -#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3246 -msgid "" -"This library is free software; you can redistribute it and/or modify it " -"under the terms of the GNU Lesser General Public License as published by the " -"Free Software Foundation; either version 2 of the License, or (at your " -"option) any later version." +#: ../examples/guestfs-recipes.pod:249 +msgid "http://augeas.net/" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:251 +msgid "Install RPMs in a guest" msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:126 -#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 -#: ../java/examples/guestfs-java.pod:74 -#: ../ocaml/examples/guestfs-ocaml.pod:107 -#: ../perl/examples/guestfs-perl.pod:68 -#: ../python/examples/guestfs-python.pod:70 -#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3251 +#: ../examples/guestfs-recipes.pod:253 msgid "" -"This library is distributed in the hope that it will be useful, but WITHOUT " -"ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " -"FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License " -"for more details." +"The link below contains a method to install RPMs in a guest. In fact the " +"RPMs are just uploaded to the guest along with a \"firstboot\" script that " +"installs them next time the guest is booted. You could use this technique " +"to install vital security updates in an offline guest." msgstr "" #. type: textblock -#: ../erlang/examples/guestfs-erlang.pod:131 -#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 -#: ../java/examples/guestfs-java.pod:79 -#: ../ocaml/examples/guestfs-ocaml.pod:112 -#: ../perl/examples/guestfs-perl.pod:73 -#: ../python/examples/guestfs-python.pod:75 -#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3256 +#: ../examples/guestfs-recipes.pod:259 msgid "" -"You should have received a copy of the GNU Lesser General Public License " -"along with this library; if not, write to the Free Software Foundation, " -"Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA" +"https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:261 +msgid "List applications installed in a VM" msgstr "" #. type: textblock -#: ../examples/guestfs-examples.pod:5 -msgid "guestfs-examples - Examples of using libguestfs from C" +#: ../examples/guestfs-recipes.pod:263 +msgid "Save the following to a file C:" msgstr "" #. type: verbatim -#: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9 +#: ../examples/guestfs-recipes.pod:265 #, no-wrap msgid "" -" #include \n" -" \n" +" #!/bin/sh -\n" +" set -e\n" +" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n" +" root=\"$(guestfish --remote inspect-get-roots)\"\n" +" guestfish --remote inspect-list-applications \"$root\"\n" +" guestfish --remote exit\n" +"\n" msgstr "" -" #include \n" -" \n" -#. type: verbatim -#: ../examples/guestfs-examples.pod:11 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-recipes.pod:272 msgid "" -" guestfs_h *g = guestfs_create ();\n" -" guestfs_add_drive_ro (g, \"disk.img\");\n" -" guestfs_launch (g);\n" -"\n" +"Make the file executable and then you can run it on any named virtual " +"machine:" msgstr "" #. type: verbatim -#: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19 +#: ../examples/guestfs-recipes.pod:275 #, no-wrap msgid "" -" cc prog.c -o prog -lguestfs\n" -"or:\n" -" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" +" # list-apps.sh WinGuest\n" +" [0] = {\n" +" app_name: Mozilla Firefox (3.6.12)\n" +" app_display_name: Mozilla Firefox (3.6.12)\n" +" app_epoch: 0\n" +" app_version: 3.6.12 (en-GB)\n" +" app_release:\n" +" app_install_path: C:\\Program Files\\Mozilla Firefox\n" +" app_trans_path:\n" +" app_publisher: Mozilla\n" +" app_url: http://www.mozilla.com/en-GB/\n" +" app_source_package:\n" +" app_summary:\n" +" app_description: Mozilla Firefox\n" +" }\n" +" [1] = {\n" +" app_name: VLC media player\n" +" app_display_name: VLC media player 1.1.5\n" +" app_epoch: 0\n" +" app_version: 1.1.5\n" +" app_release:\n" +" app_install_path: C:\\Program Files\\VideoLAN\\VLC\n" +" app_trans_path:\n" +" app_publisher: VideoLAN\n" +" app_url: http://www.videolan.org/\n" +" app_source_package:\n" +" app_summary:\n" +" app_description:\n" +" }\n" "\n" msgstr "" -" cc prog.c -o prog -lguestfs\n" -"або:\n" -" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" -"\n" #. type: textblock -#: ../examples/guestfs-examples.pod:21 +#: ../examples/guestfs-recipes.pod:305 msgid "" -"This manual page contains examples of calling libguestfs from the C " -"programming language. If you are not familiar with using libguestfs, you " -"also need to read L." +"If you want to run the script on disk images (instead of libvirt virtual " +"machines), change C<-d \"$1\"> to C<-a \"$1\">. See also L." msgstr "" -#. type: textblock -#: ../examples/guestfs-examples.pod:35 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." -msgid "" -"L, L, L, L, L, L, L, " -"L, L." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:309 +msgid "List files and directories in a VM" msgstr "" -"L, L, L, L, L, L, L, L, L." #. type: textblock -#: ../examples/guestfs-examples.pod:51 ../ocaml/examples/guestfs-ocaml.pod:97 -#: ../python/examples/guestfs-python.pod:60 -#: ../ruby/examples/guestfs-ruby.pod:54 -#, fuzzy -#| msgid "Copyright (C) 2009 Red Hat Inc." -msgid "Copyright (C) 2010 Red Hat Inc. L" -msgstr "© Red Hat Inc., 2009" - -#. type: =end -#: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12 -msgid "comment" +#: ../examples/guestfs-recipes.pod:311 +msgid "This involves using the L C command like this:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:5 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:313 +#, no-wrap msgid "" -"pod2man and pod2html have differing bugs which makes it hard to write URLs " -"here. The only way which works for both sorts of output is to just write " -"the URL directly. Do NOT use L<...> for URLs." +" guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:9 -msgid "" -"We break with tradition here and don't use ALL CAPS for the section " -"headings, as this makes them much easier to read." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:315 +msgid "List services in a Windows VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:16 -msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes" +#: ../examples/guestfs-recipes.pod:317 +msgid "" +"The link below contains a script that can be used to list out the services " +"from a Windows VM, and whether those services run at boot time or are loaded " +"on demand." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:20 +#: ../examples/guestfs-recipes.pod:321 msgid "" -"This page contains recipes for and links to things you can do using " -"libguestfs, L and the virt tools." +"https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/" +"#content" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:23 -msgid "Audit a virtual machine for setuid files" +#: ../examples/guestfs-recipes.pod:323 +msgid "Make a disk image sparse" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:25 +#: ../examples/guestfs-recipes.pod:325 msgid "" -"The link below contains a small program which can be used to audit a Linux " -"virtual machine to see what setuid and setgid files it contains." +"The link below contains some guides for making a disk image sparse (or " +"reintroducing sparseness)." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:28 +#: ../examples/guestfs-recipes.pod:328 msgid "" -"https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-" -"files/#content" +"https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:30 -msgid "Change the background image in a Windows XP VM" +#: ../examples/guestfs-recipes.pod:330 +msgid "Monitor disk usage over time" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:32 +#: ../examples/guestfs-recipes.pod:332 msgid "" -"The links below explain how to use L to change the background " -"image for a user of a Windows XP VM. Unfortunately the technique appears to " -"be substantially different for each version of Windows." +"You can use L to monitor disk usage of your guests over time. " +"The link below contains a guide." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:37 -msgid "" -"https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://" -"lists.fedoraproject.org/pipermail/virt/2011-May/002658.html" +#: ../examples/guestfs-recipes.pod:335 +msgid "http://virt-tools.org/learning/advanced-virt-df/" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:40 -msgid "Cloning a virtual machine (Linux)" +#: ../examples/guestfs-recipes.pod:337 +msgid "Reading the Windows Event Log from Windows Vista (or later)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:42 +#: ../examples/guestfs-recipes.pod:339 msgid "" -"The guestfish technique described in the link below works well for most " -"Linux VMs. Depending on the Linux distro you may need to change the paths " -"slightly." +"L plus the tools described in the link below can be used to " +"read out the Windows Event Log from any virtual machine running Windows " +"Vista or a later version." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:46 +#: ../examples/guestfs-recipes.pod:343 msgid "" -"https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-" -"vm/#content" +"https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-" +"guestfish/#content" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:345 +msgid "Remove root password (Linux)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:48 +#: ../examples/guestfs-recipes.pod:347 msgid "" -"Avoid L. Currently what to do about virt-clone is under " -"discussion." +"Using the L I<-e> option you can do simple replacements on " +"files. One use is to remove the root password from a Linux guest:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:51 -msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html" +#. type: verbatim +#: ../examples/guestfs-recipes.pod:350 +#, no-wrap +msgid "" +" virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n" +"\n" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:53 -msgid "Cloning a virtual machine (Windows)" +#: ../examples/guestfs-recipes.pod:352 +msgid "Remove Administrator password (Windows)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:55 +#: ../examples/guestfs-recipes.pod:354 msgid "" -"It is possible to do a \"sysprep\" using libguestfs alone, although not " -"straightforward. Currently there is code in the Aeolus Oz project which " -"does this (using libguestfs). As part of our review of the virt-clone tool, " -"we may add sysprepping ability." +"The link below contains one technique for removing the Administrator " +"password from a Windows VM, or to be more precise, it gives you a command " +"prompt the next time you log in which you can use to bypass any security:" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:60 +#: ../examples/guestfs-recipes.pod:359 msgid "" -"https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-" -"list/2011-May/msg00019.html" +"https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-" +"administrator-password-with-guestfish/" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:63 -msgid "Convert a CD-ROM / DVD / ISO to a tarball" +#: ../examples/guestfs-recipes.pod:361 +msgid "Unpack a live CD" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:65 -msgid "This converts input C to output C:" -msgstr "" - -#. type: verbatim -#: ../examples/guestfs-recipes.pod:67 -#, no-wrap +#: ../examples/guestfs-recipes.pod:363 msgid "" -" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" -"\n" +"Linux live CDs often contain multiple layers of disk images wrapped like a " +"Russian doll. You can use L to look inside these multiple " +"layers, as outlined in the guide below." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:69 -msgid "To export just a subdirectory, eg. C, do:" -msgstr "" - -#. type: verbatim -#: ../examples/guestfs-recipes.pod:71 -#, no-wrap +#: ../examples/guestfs-recipes.pod:367 msgid "" -" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" -"\n" +"https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-" +"cd/#content" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:73 -msgid "Create empty disk images" +#: ../examples/guestfs-recipes.pod:369 +msgid "Uploading and downloading files" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:75 +#: ../examples/guestfs-recipes.pod:371 msgid "" -"You can use the L I<-N> option to create empty disk images. " -"The useful guide below explains the options available." +"The link below contains general tips on uploading (copying in) and " +"downloading (copying out) files from VMs." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:78 +#: ../examples/guestfs-recipes.pod:374 msgid "" -"https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/" -"#content" +"https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:80 -msgid "Dump raw filesystem content from inside a disk image or VM" +#: ../examples/guestfs-recipes.pod:376 +msgid "Use libguestfs tools on VMware ESX guests" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:82 +#: ../examples/guestfs-recipes.pod:378 msgid "" -"You can use the L C command to extract the raw " -"filesystem content from any filesystem in a disk image or a VM (even one " -"which is encrypted or buried inside an LV):" +"The link below explains how to use libguestfs, L and the virt " +"tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs." msgstr "" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:86 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#. type: textblock +#: ../examples/guestfs-recipes.pod:382 msgid "" -" guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n" -"\n" +"https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-" +"guests/#content" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:88 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-recipes.pod:386 msgid "" -" guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n" -"\n" +"L, L, L, L, L, L, L, L, L, L." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:90 -msgid "To list the filesystems in a disk image, use L." -msgstr "" - -#. type: =head1 -#: ../examples/guestfs-recipes.pod:92 -msgid "Edit grub configuration in a VM" +#: ../examples/guestfs-recipes.pod:403 +msgid "Copyright (C) 2009-2011 Red Hat Inc. L" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:94 -msgid "You can use this to:" +#: ../examples/guestfs-testing.pod:5 +msgid "guestfs-testing - manual testing of libguestfs, you can help!" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:100 -msgid "Fix a virtual machine that does not boot." +#: ../examples/guestfs-testing.pod:9 +msgid "" +"This page has manual tests you can try on libguestfs. Everyone has a " +"slightly different combination of platform, hardware and guests, so this " +"testing is very valuable. Thanks for helping out!" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:104 -msgid "Change which kernel is used to boot the VM." +#: ../examples/guestfs-testing.pod:13 +msgid "These tests require libguestfs E 1.14." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:108 -msgid "Change kernel command line options." +#: ../examples/guestfs-testing.pod:15 +msgid "" +"Tests marked with a B<*> (asterisk) can B if you're not " +"careful. The others are safe and won't modify anything." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:112 -msgid "Use L to edit the grub configuration:" +#: ../examples/guestfs-testing.pod:18 +msgid "You can report bugs you find through this link:" msgstr "" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:114 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-testing.pod:20 +#, fuzzy +#| msgid "" +#| "L" msgid "" -" virt-edit -d BrokenGuest /boot/grub/grub.conf\n" -"\n" +"https://bugzilla.redhat.com/enter_bug.cgi?" +"component=libguestfs&product=Virtualization+Tools" msgstr "" +"L" #. type: textblock -#: ../examples/guestfs-recipes.pod:116 +#: ../examples/guestfs-testing.pod:22 msgid "" -"or for general tinkering inside an unbootable VM use L like " -"this:" +"or post on the mailing list (registration is B required, but if you're " +"not registered then you'll have to wait for a moderator to manually approve " +"your message):" msgstr "" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:119 -#, no-wrap -msgid "" -" virt-rescue -d BrokenGuest\n" -"\n" +#. type: textblock +#: ../examples/guestfs-testing.pod:26 +msgid "https://www.redhat.com/mailman/listinfo/libguestfs" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:121 -msgid "Export any directory from a VM" +#: ../examples/guestfs-testing.pod:28 +msgid "TESTS" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:30 +msgid "Check KVM acceleration is being used." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:123 +#: ../examples/guestfs-testing.pod:32 msgid "" -"To export C from a VM into a local directory use L:" +"If your host has hardware virt acceleration, then with a hot cache " +"libguestfs should be able to start up in a few seconds. Run the following " +"command a few times:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:126 -#, fuzzy, no-wrap -#| msgid "" -#| " copy-out /home .\n" -#| "\n" +#: ../examples/guestfs-testing.pod:36 +#, no-wrap msgid "" -" virt-copy-out -d Guest /home .\n" +" time guestfish -a /dev/null run\n" "\n" msgstr "" -" copy-out /home .\n" -"\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 -#: ../fish/guestfish-actions.pod:1327 ../fish/guestfish-actions.pod:1592 -#: ../fish/guestfish-actions.pod:2001 ../src/guestfs-actions.pod:18 -#: ../src/guestfs-actions.pod:2029 ../src/guestfs-actions.pod:2451 -#: ../src/guestfs-actions.pod:3002 ../src/guestfs.pod:1667 -#: ../tools/virt-win-reg.pl:706 -msgid "Notes:" -msgstr "Нотатки:" +#: ../examples/guestfs-testing.pod:38 +msgid "" +"After a few runs, the time should settle down to a few seconds (under 5 " +"seconds on fast 64 bit hardware)." +msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:134 -msgid "" -"The final dot of the command is not a printing error. It means we want to " -"copy out to the current directory." +#: ../examples/guestfs-testing.pod:41 +msgid "How to check for hardware virt:" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:139 -msgid "This creates a directory called C under the current directory." +#: ../examples/guestfs-testing.pod:43 +msgid "http://virt-tools.org/learning/check-hardware-virt/" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:143 +#: ../examples/guestfs-testing.pod:45 msgid "" -"If the guest is a Windows guest then you can use drive letters and " -"backslashes, but you must prefix the path with C and quote it to " -"protect it from the shell, like this:" +"If the command above does not work at all, use L." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:48 +msgid "Run virt-alignment-scan on all your guests." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:50 +msgid "Run L on guests or disk images:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:147 +#: ../examples/guestfs-testing.pod:52 #, no-wrap msgid "" -" virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" +" virt-alignment-scan -a /path/to/disk.img\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:149 -msgid "To get the output as a compressed tarball, do:" -msgstr "" +#: ../examples/guestfs-testing.pod:54 ../examples/guestfs-testing.pod:161 +#: ../examples/guestfs-testing.pod:174 ../examples/guestfs-testing.pod:234 +#: ../src/guestfs.pod:2792 +msgid "or:" +msgstr "або:" #. type: verbatim -#: ../examples/guestfs-recipes.pod:151 +#: ../examples/guestfs-testing.pod:56 #, no-wrap msgid "" -" virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" +" virt-alignment-scan -d Guest\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:153 -msgid "" -"Although it sounds tempting, this is usually not a reliable way to get a " -"backup from a running guest. See the entry in the FAQ: http://libguestfs." -"org/FAQ.html#backup" +#: ../examples/guestfs-testing.pod:58 +msgid "Does the alignment report match how the guest partitions are aligned?" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:157 -msgid "Find out which user is using the most space" +#. type: =head2 +#: ../examples/guestfs-testing.pod:60 +#, fuzzy +#| msgid "" +#| " virt-cat domname file\n" +#| "\n" +msgid "Run virt-cat on some files in guests." msgstr "" +" virt-cat назва_домену файл\n" +"\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:159 -msgid "" -"This simple script examines a Linux guest to find out which user is using " -"the most space in their home directory:" +#: ../examples/guestfs-testing.pod:62 +msgid "L can display files from guests. For a Linux guest, try:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:162 +#: ../examples/guestfs-testing.pod:64 #, fuzzy, no-wrap #| msgid "" -#| " #!/usr/bin/guestfish -f\n" +#| " virt-cat -d mydomain /etc/fstab\n" #| "\n" msgid "" -" #!/bin/sh -\n" -" \n" +" virt-cat LinuxGuest /etc/passwd\n" +"\n" msgstr "" -" #!/usr/bin/guestfish -f\n" +" virt-cat -d mydomain /etc/fstab\n" "\n" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:164 -#, fuzzy, no-wrap -#| msgid "" -#| " set-qemu qemu\n" -#| "\n" -msgid "" -" set -e\n" -" \n" +#. type: textblock +#: ../examples/guestfs-testing.pod:66 +msgid "A recent feature is support for Windows paths, for example:" msgstr "" -" set-qemu qemu\n" -"\n" #. type: verbatim -#: ../examples/guestfs-recipes.pod:166 +#: ../examples/guestfs-testing.pod:68 #, no-wrap msgid "" -" vm=\"$1\"\n" -" dir=/home\n" -" \n" +" virt-cat WindowsGuest 'c:\\windows\\win.ini'\n" +"\n" msgstr "" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:169 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --ro -d myguest -i\n" -#| "\n" +#. type: textblock +#: ../examples/guestfs-testing.pod:70 msgid "" -" eval $(guestfish --ro -d \"$vm\" -i --listen)\n" -" \n" +"An even better test is if you have a Windows guest with multiple drives. Do " +"C, C etc paths work correctly?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:73 +msgid "B<*> Copy some files into a B guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:75 +msgid "" +"L can recursively copy files and directories into a guest " +"or disk image." msgstr "" -" guestfish --ro -d myguest -i\n" -"\n" #. type: verbatim -#: ../examples/guestfs-recipes.pod:171 +#: ../examples/guestfs-testing.pod:78 #, no-wrap msgid "" -" for d in $(guestfish --remote ls \"$dir\"); do\n" -" echo -n \"$dir/$d\"\n" -" echo -ne '\\t'\n" -" guestfish --remote du \"$dir/$d\";\n" -" done | sort -nr -k 2\n" -" \n" +" virt-copy-in -d Guest /etc /tmp\n" +"\n" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:80 +msgid "" +"This should copy local directory C to C in the guest " +"(recursively). If you boot the guest, can you see all of the copied files " +"and directories?" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:84 +msgid "Shut the guest down and try copying multiple files and directories:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941 +#: ../examples/guestfs-testing.pod:86 #, no-wrap msgid "" -" guestfish --remote exit\n" +" virt-copy-in -d Guest /home /etc/issue /tmp\n" "\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:179 -msgid "Get DHCP address from a VM" +#. type: =head2 +#: ../examples/guestfs-testing.pod:88 +msgid "Copy some files out of a guest." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:181 +#: ../examples/guestfs-testing.pod:90 msgid "" -"The link below explains the many different possible techniques for getting " -"the last assigned DHCP address of a virtual machine." +"L can recursively copy files and directories out of a " +"guest or disk image." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:184 -msgid "" -"https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-" -"a-virtual-machine-disk-image/#content" +#: ../examples/guestfs-testing.pod:95 +msgid "Note the final space and period in the command is not a typo." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:186 -msgid "" -"In the libguestfs source examples directory you will find the latest version " -"of the C program." +#: ../examples/guestfs-testing.pod:97 +msgid "This should copy C from the guest into the current directory." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:189 -msgid "Get the operating system product name string" +#. type: =head2 +#: ../examples/guestfs-testing.pod:99 +msgid "Run virt-df." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:191 -msgid "Save the following script into a file called C:" +#: ../examples/guestfs-testing.pod:101 +msgid "L lists disk space. Run:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:193 +#: ../examples/guestfs-testing.pod:103 #, fuzzy, no-wrap #| msgid "" -#| " eval \"`guestfish --listen`\"\n" -#| " guestfish --remote add-ro disk.img\n" -#| " guestfish --remote run\n" -#| " guestfish --remote lvs\n" +#| " df\n" #| "\n" msgid "" -" #!/bin/sh -\n" -" set -e\n" -" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n" -" root=\"$(guestfish --remote inspect-get-roots)\"\n" -" guestfish --remote inspect-get-product-name \"$root\"\n" -" guestfish --remote exit\n" +" virt-df\n" "\n" msgstr "" -" eval \"`guestfish --listen`\"\n" -" guestfish --remote add-ro disk.img\n" -" guestfish --remote run\n" -" guestfish --remote lvs\n" +" df\n" "\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:200 -msgid "Make the script executable and run it on a named guest:" +#: ../examples/guestfs-testing.pod:105 +msgid "" +"You can try comparing this to the results from L inside the guest, " +"but there are some provisos:" msgstr "" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:202 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-testing.pod:112 +msgid "The guest must be idle." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:116 +msgid "The guest disks must be synched using L." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:120 msgid "" -" # product-name.sh RHEL60x64\n" -" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" -"\n" +"Any action such as booting the guest will write log files causing the " +"numbers to change." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:205 +#: ../examples/guestfs-testing.pod:125 msgid "" -"You can also use an XPath query on the L XML using the " -"C command line tool or from your favourite programming language:" +"We don't guarantee that the numbers will be identical even under these " +"circumstances. They should be similar. It would indicate a bug if you saw " +"greatly differing numbers." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:129 +msgid "Try importing virt-df CSV output into a spreadsheet or database." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3088 +msgid "Run:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:209 +#: ../examples/guestfs-testing.pod:133 #, no-wrap msgid "" -" # virt-inspector RHEL60x64 > xml\n" -" # xpath '//product_name' < xml\n" -" Found 1 nodes:\n" -" -- NODE --\n" -" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" +" virt-df --csv > /tmp/report.csv\n" "\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:215 -msgid "Get the default boot kernel for a Linux VM" -msgstr "" - #. type: textblock -#: ../examples/guestfs-recipes.pod:217 +#: ../examples/guestfs-testing.pod:135 msgid "" -"The link below contains a program to print the default boot kernel for a " -"Linux VM." +"Now try to load this into your favorite spreadsheet or database. Are the " +"results reproduced faithfully in the spreadsheet/database?" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:220 +#: ../examples/guestfs-testing.pod:138 msgid "" -"https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-" -"kernel-for-a-vm/#content" +"http://www.postgresql.org/docs/8.1/static/sql-copy.html http://dev.mysql.com/" +"doc/refman/5.1/en/load-data.html" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:141 +msgid "B<*> Edit a file in a B guest." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:222 +#: ../examples/guestfs-testing.pod:143 msgid "" -"It uses Augeas, and the technique is generally applicable for many different " -"tasks, such as:" +"L can edit files in guests. Try this command on a RHEL or " +"Fedora guest:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:229 -msgid "listing the user accounts in the guest" +#. type: verbatim +#: ../examples/guestfs-testing.pod:146 +#, no-wrap +msgid "" +" virt-edit LinuxGuest /etc/sysconfig/network\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:233 -msgid "what repositories is it configured to use" +#: ../examples/guestfs-testing.pod:148 +msgid "On other Linux guests try editing other files such as:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:237 -msgid "what NTP servers does it connect to" +#. type: verbatim +#: ../examples/guestfs-testing.pod:150 +#, no-wrap +msgid "" +" virt-edit LinuxGuest /etc/motd\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:241 -msgid "what were the boot messages last time it booted" +#: ../examples/guestfs-testing.pod:152 +msgid "Are the changes seen inside the guest when it is booted?" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:245 -msgid "listing who was logged in recently" +#. type: =head2 +#: ../examples/guestfs-testing.pod:154 +msgid "Display the filesystems / partitions / LVs in a guest." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:249 -msgid "http://augeas.net/" +#: ../examples/guestfs-testing.pod:156 +msgid "" +"L can be used to display filesystems in a guest. Try " +"this command on any disk image or guest:" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:251 -msgid "Install RPMs in a guest" +#. type: verbatim +#: ../examples/guestfs-testing.pod:159 +#, fuzzy, no-wrap +#| msgid "" +#| " virt-filesystems --format=raw -a disk.img\n" +#| "\n" +msgid "" +" virt-filesystems -a /path/to/disk.img --all --long -h\n" +"\n" msgstr "" +" virt-filesystems --format=raw -a диск.img\n" +"\n" -#. type: textblock -#: ../examples/guestfs-recipes.pod:253 +#. type: verbatim +#: ../examples/guestfs-testing.pod:163 +#, fuzzy, no-wrap +#| msgid "" +#| " virt-filesystems [--options] -d domname\n" +#| "\n" msgid "" -"The link below contains a method to install RPMs in a guest. In fact the " -"RPMs are just uploaded to the guest along with a \"firstboot\" script that " -"installs them next time the guest is booted. You could use this technique " -"to install vital security updates in an offline guest." +" virt-filesystems -d Guest --all --long -h\n" +"\n" msgstr "" +" virt-filesystems [--параметри] -d назва_домену\n" +"\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:259 -msgid "" -"https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content" +#: ../examples/guestfs-testing.pod:165 +msgid "Do the results match what is seen in the guest?" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:261 -msgid "List applications installed in a VM" +#. type: =head2 +#: ../examples/guestfs-testing.pod:167 +msgid "Run virt-inspector on all your guests." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:263 -msgid "Save the following to a file C:" +#: ../examples/guestfs-testing.pod:169 +msgid "" +"Use L to get a report on all of your guests or disk " +"images:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:265 +#: ../examples/guestfs-testing.pod:172 #, fuzzy, no-wrap #| msgid "" -#| " eval \"`guestfish --listen`\"\n" -#| " guestfish --remote add-ro disk.img\n" -#| " guestfish --remote run\n" -#| " guestfish --remote lvs\n" +#| " virt-cat disk.img file\n" #| "\n" msgid "" -" #!/bin/sh -\n" -" set -e\n" -" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n" -" root=\"$(guestfish --remote inspect-get-roots)\"\n" -" guestfish --remote inspect-list-applications \"$root\"\n" -" guestfish --remote exit\n" +" virt-inspector -a /path/to/disk.img | less\n" "\n" msgstr "" -" eval \"`guestfish --listen`\"\n" -" guestfish --remote add-ro disk.img\n" -" guestfish --remote run\n" -" guestfish --remote lvs\n" +" virt-cat диск.img файл\n" "\n" -#. type: textblock -#: ../examples/guestfs-recipes.pod:272 -msgid "" -"Make the file executable and then you can run it on any named virtual " -"machine:" -msgstr "" - #. type: verbatim -#: ../examples/guestfs-recipes.pod:275 +#: ../examples/guestfs-testing.pod:176 #, no-wrap msgid "" -" # list-apps.sh WinGuest\n" -" [0] = {\n" -" app_name: Mozilla Firefox (3.6.12)\n" -" app_display_name: Mozilla Firefox (3.6.12)\n" -" app_epoch: 0\n" -" app_version: 3.6.12 (en-GB)\n" -" app_release:\n" -" app_install_path: C:\\Program Files\\Mozilla Firefox\n" -" app_trans_path:\n" -" app_publisher: Mozilla\n" -" app_url: http://www.mozilla.com/en-GB/\n" -" app_source_package:\n" -" app_summary:\n" -" app_description: Mozilla Firefox\n" -" }\n" -" [1] = {\n" -" app_name: VLC media player\n" -" app_display_name: VLC media player 1.1.5\n" -" app_epoch: 0\n" -" app_version: 1.1.5\n" -" app_release:\n" -" app_install_path: C:\\Program Files\\VideoLAN\\VLC\n" -" app_trans_path:\n" -" app_publisher: VideoLAN\n" -" app_url: http://www.videolan.org/\n" -" app_source_package:\n" -" app_summary:\n" -" app_description:\n" -" }\n" +" virt-inspector -d Guest | less\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:305 -msgid "" -"If you want to run the script on disk images (instead of libvirt virtual " -"machines), change C<-d \"$1\"> to C<-a \"$1\">. See also L." +#: ../examples/guestfs-testing.pod:178 +msgid "Do the results match what is actually in the guest?" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:309 -msgid "List files and directories in a VM" +#. type: =head2 +#: ../examples/guestfs-testing.pod:180 +msgid "Try the auditing features of virt-ls on all your guests." msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:311 -msgid "This involves using the L C command like this:" +#. type: verbatim +#: ../examples/guestfs-testing.pod:184 +#, fuzzy, no-wrap +#| msgid "" +#| " $ virt-ls -R -d guest /tmp\n" +#| " foo\n" +#| " foo/bar\n" +#| " [etc.]\n" +#| "\n" +msgid "" +" virt-ls -lR -d Guest / | grep '^- [42]'\n" +"\n" msgstr "" +" $ virt-ls -R -d guest /tmp\n" +" foo\n" +" foo/bar\n" +" [тощо]\n" +"\n" #. type: verbatim -#: ../examples/guestfs-recipes.pod:313 +#: ../examples/guestfs-testing.pod:188 #, fuzzy, no-wrap #| msgid "" -#| " guestfish --ro -d myguest -i\n" +#| " $ virt-ls -R -d guest /tmp\n" +#| " foo\n" +#| " foo/bar\n" +#| " [etc.]\n" #| "\n" msgid "" -" guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n" +" virt-ls -lR -d Guest / | grep '^d ...7'\n" "\n" msgstr "" -" guestfish --ro -d myguest -i\n" +" $ virt-ls -R -d guest /tmp\n" +" foo\n" +" foo/bar\n" +" [тощо]\n" "\n" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:315 -msgid "List services in a Windows VM" +#. type: verbatim +#: ../examples/guestfs-testing.pod:192 +#, fuzzy, no-wrap +#| msgid "" +#| " $ virt-ls -R -d guest /tmp\n" +#| " foo\n" +#| " foo/bar\n" +#| " [etc.]\n" +#| "\n" +msgid "" +" virt-ls -lR -d Guest / | grep '^s'\n" +"\n" msgstr "" +" $ virt-ls -R -d guest /tmp\n" +" foo\n" +" foo/bar\n" +" [тощо]\n" +"\n" -#. type: textblock -#: ../examples/guestfs-recipes.pod:317 +#. type: verbatim +#: ../examples/guestfs-testing.pod:196 +#, no-wrap msgid "" -"The link below contains a script that can be used to list out the services " -"from a Windows VM, and whether those services run at boot time or are loaded " -"on demand." +" virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:321 +#: ../examples/guestfs-testing.pod:198 +msgid "Display files larger than 10MB in home directories:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:200 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/" -"#content" +" virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n" +"\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:323 -msgid "Make a disk image sparse" +#. type: verbatim +#: ../examples/guestfs-testing.pod:204 +#, no-wrap +msgid "" +" virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:325 +#. type: verbatim +#: ../examples/guestfs-testing.pod:208 +#, no-wrap msgid "" -"The link below contains some guides for making a disk image sparse (or " -"reintroducing sparseness)." +" virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:328 +#: ../examples/guestfs-testing.pod:210 +msgid "Do the results match what is in the guest?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:212 +msgid "Create a disk image from a tarball." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:214 msgid "" -"https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content" +"Use L to create a disk image from any tarball that you " +"happen to have:" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:330 -msgid "Monitor disk usage over time" +#. type: verbatim +#: ../examples/guestfs-testing.pod:217 +#, no-wrap +msgid "" +" virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:332 +#: ../examples/guestfs-testing.pod:219 msgid "" -"You can use L to monitor disk usage of your guests over time. " -"The link below contains a guide." +"Add 'output.img' as a raw disk to an existing guest. Check the guest can " +"see the files. This test is particularly useful if you try it with a " +"Windows guest." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:335 -msgid "http://virt-tools.org/learning/advanced-virt-df/" +#: ../examples/guestfs-testing.pod:223 +msgid "Try other partitioning schemes, eg. I<--partition=gpt>." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:337 -msgid "Reading the Windows Event Log from Windows Vista (or later)" +#. type: textblock +#: ../examples/guestfs-testing.pod:225 +msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:227 +msgid "B<*> Run virt-rescue on a B disk image or guest." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:339 +#: ../examples/guestfs-testing.pod:229 msgid "" -"L plus the tools described in the link below can be used to " -"read out the Windows Event Log from any virtual machine running Windows " -"Vista or a later version." +"Use L to examine, rescue or repair a B guest or " +"disk image:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:343 +#. type: verbatim +#: ../examples/guestfs-testing.pod:232 +#, fuzzy, no-wrap +#| msgid "" +#| " virt-cat disk.img file\n" +#| "\n" msgid "" -"https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-" -"guestfish/#content" +" virt-rescue -a /path/to/disk.img\n" +"\n" msgstr "" +" virt-cat диск.img файл\n" +"\n" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:345 -msgid "Remove root password (Linux)" +#. type: verbatim +#: ../examples/guestfs-testing.pod:236 +#, no-wrap +msgid "" +" virt-rescue -d Guest\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:347 +#: ../examples/guestfs-testing.pod:238 +msgid "Can you use ordinary shell commands to examine the guest?" +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:240 +msgid "B<*> Resize your guests." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:242 msgid "" -"Using the L I<-e> option you can do simple replacements on " -"files. One use is to remove the root password from a Linux guest:" +"Use L to give a guest some more disk space. For example, if " +"you have a disk image that is smaller than 30G, increase it to 30G by doing:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:350 +#: ../examples/guestfs-testing.pod:246 #, no-wrap msgid "" -" virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n" +" truncate -s 30G newdisk.img\n" +" virt-filesystems -a /path/to/olddisk.img --all --long -h\n" +" virt-resize /path/to/olddisk.img newdisk.img --expand /dev/sda1\n" +" qemu-kvm -m 1024 -hda newdisk.img\n" "\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:352 -msgid "Remove Administrator password (Windows)" +#. type: textblock +#: ../examples/guestfs-testing.pod:251 +msgid "Does the guest still boot? Try expanding other partitions." +msgstr "" + +#. type: =head2 +#: ../examples/guestfs-testing.pod:253 +msgid "B<*> Sparsify a guest disk." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:354 +#: ../examples/guestfs-testing.pod:255 +msgid "Using L, make a disk image more sparse:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:257 +#, fuzzy, no-wrap +#| msgid "" +#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" +#| "\n" msgid "" -"The link below contains one technique for removing the Administrator " -"password from a Windows VM, or to be more precise, it gives you a command " -"prompt the next time you log in which you can use to bypass any security:" +" virt-sparsify /path/to/olddisk.img newdisk.img\n" +"\n" msgstr "" +" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" +"\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:359 +#: ../examples/guestfs-testing.pod:259 msgid "" -"https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-" -"administrator-password-with-guestfish/" +"Is C still bootable after sparsifying? Is the resulting disk " +"image smaller (use C to check)?" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:361 -msgid "Unpack a live CD" +#. type: =head2 +#: ../examples/guestfs-testing.pod:262 +msgid "B<*> \"sysprep\" a B Linux guest." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:363 +#: ../examples/guestfs-testing.pod:264 msgid "" -"Linux live CDs often contain multiple layers of disk images wrapped like a " -"Russian doll. You can use L to look inside these multiple " -"layers, as outlined in the guide below." +"Note that this really will mess up an existing guest, so it's better to " +"clone the guest before trying this." +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-testing.pod:267 +#, no-wrap +msgid "" +" virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:367 +#: ../examples/guestfs-testing.pod:269 msgid "" -"https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-" -"cd/#content" +"Was the sysprep successful? After booting, what changes were made and were " +"they successful?" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:369 -msgid "Uploading and downloading files" +#. type: =head2 +#: ../examples/guestfs-testing.pod:272 +msgid "Dump the Windows Registry from your Windows guests." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:371 +#: ../examples/guestfs-testing.pod:274 msgid "" -"The link below contains general tips on uploading (copying in) and " -"downloading (copying out) files from VMs." +"Use L to dump out the Windows Registry from any Windows " +"guests that you have." msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:374 +#. type: verbatim +#: ../examples/guestfs-testing.pod:277 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content" +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n" +" less\n" +"\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:376 -msgid "Use libguestfs tools on VMware ESX guests" +#. type: verbatim +#: ../examples/guestfs-testing.pod:280 +#, no-wrap +msgid "" +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n" +" less\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:378 -msgid "" -"The link below explains how to use libguestfs, L and the virt " -"tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs." +#: ../examples/guestfs-testing.pod:283 +msgid "Does the output match running C inside the guest?" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:382 +#: ../examples/guestfs-testing.pod:285 msgid "" -"https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-" -"guests/#content" +"A recent feature is the ability to dump user registries, so try this, " +"replacing I with the name of a local user in the guest:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:386 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." +#. type: verbatim +#: ../examples/guestfs-testing.pod:288 +#, no-wrap msgid "" -"L, L, L, L, L, L, L, L, L, L." +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' |\n" +" less\n" +"\n" msgstr "" -"L, L, L, L, L, L, L, L, L." #. type: textblock -#: ../examples/guestfs-recipes.pod:403 +#: ../examples/guestfs-testing.pod:293 #, fuzzy -#| msgid "Copyright (C) 2009-2010 Red Hat Inc." -msgid "Copyright (C) 2009-2011 Red Hat Inc. L" -msgstr "© Red Hat Inc., 2009–2010" +#| msgid "" +#| "L, L, L, L, " +#| "L, L." +msgid "" +"L, L, L, L." +msgstr "" +"L, L, L, L, L, L." #. type: =head2 #: ../fish/guestfish-actions.pod:1 @@ -4776,31 +6782,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163 -#: ../fish/guestfish-actions.pod:177 +#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:214 +#: ../fish/guestfish-actions.pod:228 msgid "" "I In new code, use the L call " "instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166 -#: ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:1026 -#: ../fish/guestfish-actions.pod:1386 ../fish/guestfish-actions.pod:1400 -#: ../fish/guestfish-actions.pod:3157 ../fish/guestfish-actions.pod:3364 -#: ../fish/guestfish-actions.pod:3478 ../fish/guestfish-actions.pod:3526 -#: ../fish/guestfish-actions.pod:4439 ../fish/guestfish-actions.pod:4462 -#: ../fish/guestfish-actions.pod:4484 ../fish/guestfish-actions.pod:4522 -#: ../fish/guestfish-actions.pod:5171 ../fish/guestfish-actions.pod:5277 -#: ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:252 -#: ../src/guestfs-actions.pod:273 ../src/guestfs-actions.pod:1615 -#: ../src/guestfs-actions.pod:2114 ../src/guestfs-actions.pod:2135 -#: ../src/guestfs-actions.pod:4765 ../src/guestfs-actions.pod:5068 -#: ../src/guestfs-actions.pod:5297 ../src/guestfs-actions.pod:5397 -#: ../src/guestfs-actions.pod:6677 ../src/guestfs-actions.pod:6721 -#: ../src/guestfs-actions.pod:6755 ../src/guestfs-actions.pod:6818 -#: ../src/guestfs-actions.pod:7750 ../src/guestfs-actions.pod:7859 -#: ../src/guestfs-actions.pod:8042 +#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:217 +#: ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:941 +#: ../fish/guestfish-actions.pod:976 ../fish/guestfish-actions.pod:1149 +#: ../fish/guestfish-actions.pod:1509 ../fish/guestfish-actions.pod:1523 +#: ../fish/guestfish-actions.pod:3392 ../fish/guestfish-actions.pod:3703 +#: ../fish/guestfish-actions.pod:3751 ../fish/guestfish-actions.pod:4669 +#: ../fish/guestfish-actions.pod:4689 ../fish/guestfish-actions.pod:4708 +#: ../fish/guestfish-actions.pod:4746 ../fish/guestfish-actions.pod:5474 +#: ../fish/guestfish-actions.pod:5577 ../src/guestfs-actions.pod:10 +#: ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326 +#: ../src/guestfs-actions.pod:1580 ../src/guestfs-actions.pod:1637 +#: ../src/guestfs-actions.pod:1920 ../src/guestfs-actions.pod:2419 +#: ../src/guestfs-actions.pod:2440 ../src/guestfs-actions.pod:5242 +#: ../src/guestfs-actions.pod:5764 ../src/guestfs-actions.pod:5864 +#: ../src/guestfs-actions.pod:7160 ../src/guestfs-actions.pod:7201 +#: ../src/guestfs-actions.pod:7232 ../src/guestfs-actions.pod:7292 +#: ../src/guestfs-actions.pod:8346 ../src/guestfs-actions.pod:8455 +#: ../src/guestfs-actions.pod:8635 msgid "" "Deprecated functions will not be removed from the API, but the fact that " "they are deprecated indicates that there are problems with correct use of " @@ -4815,13 +6822,13 @@ msgstr "add-domain" #. type: =head2 #: ../fish/guestfish-actions.pod:37 msgid "domain" -msgstr "" +msgstr "домен" #. type: verbatim #: ../fish/guestfish-actions.pod:39 #, no-wrap msgid "" -" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n" +" add-domain dom [libvirturi:..] [readonly:true|false] [iface:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..]\n" "\n" msgstr "" @@ -4834,14 +6841,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:64 +#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65 msgid "" "The number of disks added is returned. This operation is atomic: if an " "error is returned, then no disks are added." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:67 +#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:68 msgid "" "This function does some minimal checks to make sure the libvirt domain is " "not running (unless C is true). In a future version we will try " @@ -4849,7 +6856,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:71 +#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72 msgid "" "Disks must be accessible locally. This often means that adding disks from a " "remote libvirt connection (see L) will fail " @@ -4857,7 +6864,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:76 +#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:77 msgid "" "The optional C parameter sets the libvirt URI (see L). If this is not set then we connect to the default " @@ -4866,7 +6873,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:82 +#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83 msgid "" "The optional C flag controls whether this call will try to connect to " "a running virtual machine C process if it sees a suitable " @@ -4876,7 +6883,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:89 +#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:90 msgid "" "If the C flag is true (default is false) then a UUID I be " "passed instead of the domain name. The C string is treated as a UUID " @@ -4885,29 +6892,109 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:76 +#: ../fish/guestfish-actions.pod:76 ../src/guestfs-actions.pod:95 +msgid "" +"The optional C parameter controls what we do for disks which " +"are marked Ereadonly/E in the libvirt XML. Possible values are:" +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:82 ../src/guestfs-actions.pod:101 +msgid "readonlydisk = \"error\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:84 ../fish/guestfish-actions.pod:95 +#: ../fish/guestfish-actions.pod:106 ../src/guestfs-actions.pod:103 +#: ../src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:125 +msgid "If C is false:" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105 +msgid "" +"The whole call is aborted with an error if any disk with the Ereadonly/" +"E flag is found." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:89 ../fish/guestfish-actions.pod:100 +#: ../fish/guestfish-actions.pod:110 ../src/guestfs-actions.pod:108 +#: ../src/guestfs-actions.pod:119 ../src/guestfs-actions.pod:129 +msgid "If C is true:" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:91 ../fish/guestfish-actions.pod:102 +#: ../fish/guestfish-actions.pod:112 ../src/guestfs-actions.pod:110 +#: ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:131 +msgid "Disks with the Ereadonly/E flag are added read-only." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:93 ../src/guestfs-actions.pod:112 +msgid "readonlydisk = \"read\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:97 ../src/guestfs-actions.pod:116 +msgid "" +"Disks with the Ereadonly/E flag are added read-only. Other disks " +"are added read/write." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:104 ../src/guestfs-actions.pod:123 +msgid "readonlydisk = \"write\" (default)" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:108 ../src/guestfs-actions.pod:127 +msgid "Disks with the Ereadonly/E flag are added read/write." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:114 ../src/guestfs-actions.pod:133 +msgid "readonlydisk = \"ignore\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:116 ../src/guestfs-actions.pod:135 +msgid "If C is true or false:" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:118 ../src/guestfs-actions.pod:137 +msgid "Disks with the Ereadonly/E flag are skipped." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:122 msgid "" "The other optional parameters are passed directly through to L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:143 -#: ../fish/guestfish-actions.pod:573 ../fish/guestfish-actions.pod:784 -#: ../fish/guestfish-actions.pod:805 ../fish/guestfish-actions.pod:2040 -#: ../fish/guestfish-actions.pod:3206 ../fish/guestfish-actions.pod:3379 -#: ../fish/guestfish-actions.pod:3514 +#: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:194 +#: ../fish/guestfish-actions.pod:624 ../fish/guestfish-actions.pod:835 +#: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:894 +#: ../fish/guestfish-actions.pod:903 ../fish/guestfish-actions.pod:912 +#: ../fish/guestfish-actions.pod:926 ../fish/guestfish-actions.pod:2171 +#: ../fish/guestfish-actions.pod:3219 ../fish/guestfish-actions.pod:3441 +#: ../fish/guestfish-actions.pod:3604 ../fish/guestfish-actions.pod:3739 +#: ../fish/guestfish-actions.pod:5110 msgid "" "This command has one or more optional arguments. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:81 +#: ../fish/guestfish-actions.pod:127 msgid "add-drive" msgstr "add-drive" #. type: verbatim -#: ../fish/guestfish-actions.pod:83 +#: ../fish/guestfish-actions.pod:129 #, no-wrap msgid "" " add-drive filename\n" @@ -4917,7 +7004,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:85 +#: ../fish/guestfish-actions.pod:131 msgid "" "This function is the equivalent of calling L with no " "optional parameters, so the disk is added writable, with the format being " @@ -4925,7 +7012,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:89 +#: ../fish/guestfish-actions.pod:135 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -4935,25 +7022,25 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:96 +#: ../fish/guestfish-actions.pod:142 msgid "add-drive-opts" msgstr "add-drive-opts" #. type: =head2 -#: ../fish/guestfish-actions.pod:98 +#: ../fish/guestfish-actions.pod:144 msgid "add" msgstr "add" #. type: verbatim -#: ../fish/guestfish-actions.pod:100 +#: ../fish/guestfish-actions.pod:146 #, no-wrap msgid "" -" add-drive-opts filename [readonly:..] [format:..] [iface:..]\n" +" add-drive-opts filename [readonly:true|false] [format:..] [iface:..] [name:..]\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:102 ../src/guestfs-actions.pod:160 +#: ../fish/guestfish-actions.pod:148 ../src/guestfs-actions.pod:208 msgid "" "This function adds a virtual machine disk image C to libguestfs. " "The first time you call this function, the disk appears as C, the " @@ -4961,7 +7048,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:107 ../src/guestfs-actions.pod:165 +#: ../fish/guestfish-actions.pod:153 ../src/guestfs-actions.pod:213 msgid "" "You don't necessarily need to be root when using libguestfs. However you " "obviously do need sufficient permissions to access the filename for whatever " @@ -4970,23 +7057,23 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:113 ../src/guestfs-actions.pod:171 +#: ../fish/guestfish-actions.pod:159 ../src/guestfs-actions.pod:219 msgid "This call checks that C exists." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3168 -#: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4802 +#: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3403 +#: ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5279 msgid "The optional arguments are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:119 ../src/guestfs-actions.pod:177 +#: ../fish/guestfish-actions.pod:165 ../src/guestfs-actions.pod:225 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:121 ../src/guestfs-actions.pod:179 +#: ../fish/guestfish-actions.pod:167 ../src/guestfs-actions.pod:227 msgid "" "If true then the image is treated as read-only. Writes are still allowed, " "but they are stored in a temporary snapshot overlay which is discarded at " @@ -4994,12 +7081,12 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:125 ../src/guestfs-actions.pod:183 +#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:127 +#: ../fish/guestfish-actions.pod:173 msgid "" "This forces the image format. If you omit this (or use L or L) then the format is automatically detected. Possible formats " @@ -5007,7 +7094,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:131 ../src/guestfs-actions.pod:189 +#: ../fish/guestfish-actions.pod:177 ../src/guestfs-actions.pod:237 msgid "" "Automatic detection of the format opens you up to a potential security hole " "when dealing with untrusted raw-format images. See CVE-2010-3851 and " @@ -5015,29 +7102,42 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:136 ../src/guestfs-actions.pod:194 +#: ../fish/guestfish-actions.pod:182 ../src/guestfs-actions.pod:242 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:138 +#: ../fish/guestfish-actions.pod:184 msgid "" "This rarely-used option lets you emulate the behaviour of the deprecated L call (q.v.)" msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:187 ../fish/guestfish-actions.pod:3246 +#: ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:5000 +msgid "C" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:189 ../src/guestfs-actions.pod:249 +msgid "" +"The name the drive had in the original guest, e.g. /dev/sdb. This is used as " +"a hint to the guest inspection process if it is available." +msgstr "" + #. type: =head2 -#: ../fish/guestfish-actions.pod:145 +#: ../fish/guestfish-actions.pod:196 msgid "add-drive-ro" msgstr "add-drive-ro" #. type: =head2 -#: ../fish/guestfish-actions.pod:147 +#: ../fish/guestfish-actions.pod:198 msgid "add-ro" msgstr "add-ro" #. type: verbatim -#: ../fish/guestfish-actions.pod:149 +#: ../fish/guestfish-actions.pod:200 #, no-wrap msgid "" " add-drive-ro filename\n" @@ -5045,7 +7145,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:151 +#: ../fish/guestfish-actions.pod:202 msgid "" "This function is the equivalent of calling L with the " "optional parameter C set to 1, so the disk " @@ -5053,12 +7153,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:156 +#: ../fish/guestfish-actions.pod:207 msgid "add-drive-ro-with-if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:158 +#: ../fish/guestfish-actions.pod:209 #, no-wrap msgid "" " add-drive-ro-with-if filename iface\n" @@ -5066,19 +7166,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:160 +#: ../fish/guestfish-actions.pod:211 msgid "" "This is the same as L but it allows you to specify the QEMU " "interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:170 +#: ../fish/guestfish-actions.pod:221 msgid "add-drive-with-if" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:172 +#: ../fish/guestfish-actions.pod:223 #, no-wrap msgid "" " add-drive-with-if filename iface\n" @@ -5086,19 +7186,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:174 +#: ../fish/guestfish-actions.pod:225 msgid "" "This is the same as L but it allows you to specify the QEMU " "interface emulation to use at run time." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:184 +#: ../fish/guestfish-actions.pod:235 msgid "aug-clear" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:186 +#: ../fish/guestfish-actions.pod:237 #, no-wrap msgid "" " aug-clear augpath\n" @@ -5106,19 +7206,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:188 ../src/guestfs-actions.pod:290 +#: ../fish/guestfish-actions.pod:239 ../src/guestfs-actions.pod:343 msgid "" "Set the value associated with C to C. This is the same as the " "L C command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:191 +#: ../fish/guestfish-actions.pod:242 msgid "aug-close" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:193 +#: ../fish/guestfish-actions.pod:244 #, no-wrap msgid "" " aug-close\n" @@ -5126,7 +7226,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:195 +#: ../fish/guestfish-actions.pod:246 msgid "" "Close the current Augeas handle and free up any resources used by it. After " "calling this, you have to call L again before you can use any " @@ -5134,12 +7234,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:200 +#: ../fish/guestfish-actions.pod:251 msgid "aug-defnode" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:202 +#: ../fish/guestfish-actions.pod:253 #, no-wrap msgid "" " aug-defnode name expr val\n" @@ -5147,13 +7247,13 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:204 ../src/guestfs-actions.pod:319 +#: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:372 msgid "" "Defines a variable C whose value is the result of evaluating C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:207 +#: ../fish/guestfish-actions.pod:258 msgid "" "If C evaluates to an empty nodeset, a node is created, equivalent to " "calling L C, C. C will be the nodeset " @@ -5161,19 +7261,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:211 ../src/guestfs-actions.pod:326 +#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:379 msgid "" "On success this returns a pair containing the number of nodes in the " "nodeset, and a boolean flag if a node was created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:215 +#: ../fish/guestfish-actions.pod:266 msgid "aug-defvar" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:217 +#: ../fish/guestfish-actions.pod:268 #, no-wrap msgid "" " aug-defvar name expr\n" @@ -5181,26 +7281,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:219 ../src/guestfs-actions.pod:343 +#: ../fish/guestfish-actions.pod:270 ../src/guestfs-actions.pod:396 msgid "" "Defines an Augeas variable C whose value is the result of evaluating " "C. If C is NULL, then C is undefined." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:223 ../src/guestfs-actions.pod:347 +#: ../fish/guestfish-actions.pod:274 ../src/guestfs-actions.pod:400 msgid "" "On success this returns the number of nodes in C, or C<0> if C " "evaluates to something which is not a nodeset." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:226 +#: ../fish/guestfish-actions.pod:277 msgid "aug-get" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:228 +#: ../fish/guestfish-actions.pod:279 #, no-wrap msgid "" " aug-get augpath\n" @@ -5208,19 +7308,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:230 ../src/guestfs-actions.pod:360 +#: ../fish/guestfish-actions.pod:281 ../src/guestfs-actions.pod:413 msgid "" "Look up the value associated with C. If C matches exactly one " "node, the C is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:233 +#: ../fish/guestfish-actions.pod:284 msgid "aug-init" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:235 +#: ../fish/guestfish-actions.pod:286 #, no-wrap msgid "" " aug-init root flags\n" @@ -5228,7 +7328,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:237 ../src/guestfs-actions.pod:375 +#: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:428 msgid "" "Create a new Augeas handle for editing configuration files. If there was " "any previous Augeas handle associated with this guestfs session, then it is " @@ -5236,57 +7336,57 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:241 +#: ../fish/guestfish-actions.pod:292 msgid "You must call this before using any other L commands." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:244 ../src/guestfs-actions.pod:382 +#: ../fish/guestfish-actions.pod:295 ../src/guestfs-actions.pod:435 msgid "" "C is the filesystem root. C must not be NULL, use C instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:247 ../src/guestfs-actions.pod:385 +#: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:438 msgid "" "The flags are the same as the flags defined in Eaugeas.hE, the " "logical I of the following integers:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:253 ../src/guestfs-actions.pod:391 +#: ../fish/guestfish-actions.pod:304 ../src/guestfs-actions.pod:444 msgid "C = 1" msgstr "C = 1" #. type: textblock -#: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:393 +#: ../fish/guestfish-actions.pod:306 ../src/guestfs-actions.pod:446 msgid "Keep the original file with a C<.augsave> extension." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:257 ../src/guestfs-actions.pod:395 +#: ../fish/guestfish-actions.pod:308 ../src/guestfs-actions.pod:448 msgid "C = 2" msgstr "C = 2" #. type: textblock -#: ../fish/guestfish-actions.pod:259 ../src/guestfs-actions.pod:397 +#: ../fish/guestfish-actions.pod:310 ../src/guestfs-actions.pod:450 msgid "" "Save changes into a file with extension C<.augnew>, and do not overwrite " "original. Overrides C." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:400 +#: ../fish/guestfish-actions.pod:313 ../src/guestfs-actions.pod:453 msgid "C = 4" msgstr "C = 4" #. type: textblock -#: ../fish/guestfish-actions.pod:264 ../src/guestfs-actions.pod:402 +#: ../fish/guestfish-actions.pod:315 ../src/guestfs-actions.pod:455 msgid "Typecheck lenses." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:266 +#: ../fish/guestfish-actions.pod:317 msgid "" "This option is only useful when debugging Augeas lenses. Use of this option " "may require additional memory for the libguestfs appliance. You may need to " @@ -5294,52 +7394,52 @@ msgid "" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:271 ../src/guestfs-actions.pod:409 +#: ../fish/guestfish-actions.pod:322 ../src/guestfs-actions.pod:462 msgid "C = 8" msgstr "C = 8" #. type: textblock -#: ../fish/guestfish-actions.pod:273 ../src/guestfs-actions.pod:411 +#: ../fish/guestfish-actions.pod:324 ../src/guestfs-actions.pod:464 msgid "Do not use standard load path for modules." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:275 ../src/guestfs-actions.pod:413 +#: ../fish/guestfish-actions.pod:326 ../src/guestfs-actions.pod:466 msgid "C = 16" msgstr "C = 16" #. type: textblock -#: ../fish/guestfish-actions.pod:277 ../src/guestfs-actions.pod:415 +#: ../fish/guestfish-actions.pod:328 ../src/guestfs-actions.pod:468 msgid "Make save a no-op, just record what would have been changed." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:279 ../src/guestfs-actions.pod:417 +#: ../fish/guestfish-actions.pod:330 ../src/guestfs-actions.pod:470 msgid "C = 32" msgstr "C = 32" #. type: textblock -#: ../fish/guestfish-actions.pod:281 +#: ../fish/guestfish-actions.pod:332 msgid "Do not load the tree in L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:285 +#: ../fish/guestfish-actions.pod:336 msgid "To close the handle, you can call L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:287 ../src/guestfs-actions.pod:425 +#: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:478 msgid "To find out more about Augeas, see L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:289 +#: ../fish/guestfish-actions.pod:340 msgid "aug-insert" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:291 +#: ../fish/guestfish-actions.pod:342 #, no-wrap msgid "" " aug-insert augpath label true|false\n" @@ -5347,26 +7447,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:293 ../src/guestfs-actions.pod:439 +#: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:492 msgid "" "Create a new sibling C, L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:904 +#: ../fish/guestfish-actions.pod:1027 msgid "download-offset" msgstr "download-offset" #. type: verbatim -#: ../fish/guestfish-actions.pod:906 +#: ../fish/guestfish-actions.pod:1029 #, no-wrap msgid "" " download-offset remotefilename (filename|-) offset size\n" @@ -6741,14 +8945,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:911 ../src/guestfs-actions.pod:1437 +#: ../fish/guestfish-actions.pod:1034 ../src/guestfs-actions.pod:1742 msgid "" "C is read for C bytes starting at C (this " "region must be within the file or device)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:914 +#: ../fish/guestfish-actions.pod:1037 msgid "" "Note that there is no limit on the amount of data that can be downloaded " "with this call, unlike with L, and this call always reads the full " @@ -6756,17 +8960,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:919 +#: ../fish/guestfish-actions.pod:1042 msgid "See also L, L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:923 +#: ../fish/guestfish-actions.pod:1046 msgid "drop-caches" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:925 +#: ../fish/guestfish-actions.pod:1048 #, no-wrap msgid "" " drop-caches whattodrop\n" @@ -6774,7 +8978,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:927 ../src/guestfs-actions.pod:1462 +#: ../fish/guestfish-actions.pod:1050 ../src/guestfs-actions.pod:1767 msgid "" "This instructs the guest kernel to drop its page cache, and/or dentries and " "inode caches. The parameter C tells the kernel what precisely " @@ -6782,24 +8986,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:932 ../src/guestfs-actions.pod:1467 +#: ../fish/guestfish-actions.pod:1055 ../src/guestfs-actions.pod:1772 msgid "Setting C to 3 should drop everything." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:934 ../src/guestfs-actions.pod:1469 +#: ../fish/guestfish-actions.pod:1057 ../src/guestfs-actions.pod:1774 msgid "" "This automatically calls L before the operation, so that the " "maximum guest memory is freed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:937 +#: ../fish/guestfish-actions.pod:1060 msgid "du" msgstr "du" #. type: verbatim -#: ../fish/guestfish-actions.pod:939 +#: ../fish/guestfish-actions.pod:1062 #, no-wrap msgid "" " du path\n" @@ -6809,14 +9013,14 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:941 ../src/guestfs-actions.pod:1482 +#: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1787 msgid "" "This command runs the C command to estimate file space usage for " "C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:944 ../src/guestfs-actions.pod:1485 +#: ../fish/guestfish-actions.pod:1067 ../src/guestfs-actions.pod:1790 msgid "" "C can be a file or a directory. If C is a directory then the " "estimate includes the contents of the directory and all subdirectories " @@ -6824,18 +9028,18 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:948 ../src/guestfs-actions.pod:1489 +#: ../fish/guestfish-actions.pod:1071 ../src/guestfs-actions.pod:1794 msgid "" "The result is the estimated size in I (ie. units of 1024 bytes)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:951 +#: ../fish/guestfish-actions.pod:1074 msgid "e2fsck-f" msgstr "e2fsck-f" #. type: verbatim -#: ../fish/guestfish-actions.pod:953 +#: ../fish/guestfish-actions.pod:1076 #, no-wrap msgid "" " e2fsck-f device\n" @@ -6843,7 +9047,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:955 ../src/guestfs-actions.pod:1507 +#: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1812 msgid "" "This runs C, ie. runs the ext2/ext3 filesystem checker " "on C, noninteractively (I<-p>), even if the filesystem appears to be " @@ -6851,19 +9055,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:959 +#: ../fish/guestfish-actions.pod:1082 msgid "" "This command is only needed because of L (q.v.). Normally you " "should use L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:962 +#: ../fish/guestfish-actions.pod:1085 msgid "echo-daemon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:964 +#: ../fish/guestfish-actions.pod:1087 #, no-wrap msgid "" " echo-daemon 'words ...'\n" @@ -6871,29 +9075,29 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:966 ../src/guestfs-actions.pod:1524 +#: ../fish/guestfish-actions.pod:1089 ../src/guestfs-actions.pod:1829 msgid "" "This command concatenates the list of C passed with single spaces " "between them and returns the resulting string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:969 ../src/guestfs-actions.pod:1527 +#: ../fish/guestfish-actions.pod:1092 ../src/guestfs-actions.pod:1832 msgid "You can use this command to test the connection through to the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:971 +#: ../fish/guestfish-actions.pod:1094 msgid "See also L." -msgstr "" +msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:973 +#: ../fish/guestfish-actions.pod:1096 msgid "egrep" msgstr "egrep" #. type: verbatim -#: ../fish/guestfish-actions.pod:975 +#: ../fish/guestfish-actions.pod:1098 #, no-wrap msgid "" " egrep regex path\n" @@ -6901,18 +9105,18 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:977 ../src/guestfs-actions.pod:1543 +#: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1848 msgid "" "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:983 +#: ../fish/guestfish-actions.pod:1106 msgid "egrepi" msgstr "egrepi" #. type: verbatim -#: ../fish/guestfish-actions.pod:985 +#: ../fish/guestfish-actions.pod:1108 #, no-wrap msgid "" " egrepi regex path\n" @@ -6920,18 +9124,18 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:987 ../src/guestfs-actions.pod:1562 +#: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1867 msgid "" "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:993 +#: ../fish/guestfish-actions.pod:1116 msgid "equal" msgstr "equal" #. type: verbatim -#: ../fish/guestfish-actions.pod:995 +#: ../fish/guestfish-actions.pod:1118 #, no-wrap msgid "" " equal file1 file2\n" @@ -6941,24 +9145,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:997 ../src/guestfs-actions.pod:1581 +#: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1886 msgid "" "This compares the two files C and C and returns true if their " "content is exactly equal, or false otherwise." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1000 ../src/guestfs-actions.pod:1584 +#: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1889 msgid "The external L program is used for the comparison." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1002 +#: ../fish/guestfish-actions.pod:1125 msgid "exists" msgstr "exists" #. type: verbatim -#: ../fish/guestfish-actions.pod:1004 +#: ../fish/guestfish-actions.pod:1127 #, no-wrap msgid "" " exists path\n" @@ -6968,24 +9172,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1006 ../src/guestfs-actions.pod:1596 +#: ../fish/guestfish-actions.pod:1129 ../src/guestfs-actions.pod:1901 msgid "" "This returns C if and only if there is a file, directory (or anything) " "with the given C name." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1009 +#: ../fish/guestfish-actions.pod:1132 msgid "See also L, L, L." msgstr "Див. також L, L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1011 +#: ../fish/guestfish-actions.pod:1134 msgid "fallocate" msgstr "fallocate" #. type: verbatim -#: ../fish/guestfish-actions.pod:1013 +#: ../fish/guestfish-actions.pod:1136 #, no-wrap msgid "" " fallocate path len\n" @@ -6995,34 +9199,34 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1015 ../fish/guestfish-actions.pod:1034 -#: ../src/guestfs-actions.pod:1619 ../src/guestfs-actions.pod:1638 +#: ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1157 +#: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1943 msgid "" "This command preallocates a file (containing zero bytes) named C of " "size C bytes. If the file exists already, it is overwritten." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1019 ../src/guestfs-actions.pod:1623 +#: ../fish/guestfish-actions.pod:1142 ../src/guestfs-actions.pod:1928 msgid "" "Do not confuse this with the guestfish-specific C command which " "allocates a file in the host and attaches it as a device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1023 +#: ../fish/guestfish-actions.pod:1146 msgid "" "I In new code, use the L call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1030 +#: ../fish/guestfish-actions.pod:1153 msgid "fallocate64" msgstr "fallocate64" #. type: verbatim -#: ../fish/guestfish-actions.pod:1032 +#: ../fish/guestfish-actions.pod:1155 #, no-wrap msgid "" " fallocate64 path len\n" @@ -7032,14 +9236,14 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1038 +#: ../fish/guestfish-actions.pod:1161 msgid "" "Note that this call allocates disk blocks for the file. To create a sparse " "file use L instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1041 +#: ../fish/guestfish-actions.pod:1164 msgid "" "The deprecated call L does the same, but owing to an oversight " "it only allowed 30 bit lengths to be specified, effectively limiting the " @@ -7047,19 +9251,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1046 ../src/guestfs-actions.pod:1650 +#: ../fish/guestfish-actions.pod:1169 ../src/guestfs-actions.pod:1955 msgid "" "Do not confuse this with the guestfish-specific C and C " "commands which create a file in the host and attach it as a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1050 +#: ../fish/guestfish-actions.pod:1173 msgid "fgrep" msgstr "fgrep" #. type: verbatim -#: ../fish/guestfish-actions.pod:1052 +#: ../fish/guestfish-actions.pod:1175 #, no-wrap msgid "" " fgrep pattern path\n" @@ -7069,18 +9273,18 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1054 ../src/guestfs-actions.pod:1665 +#: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:1970 msgid "" "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1060 +#: ../fish/guestfish-actions.pod:1183 msgid "fgrepi" msgstr "fgrepi" #. type: verbatim -#: ../fish/guestfish-actions.pod:1062 +#: ../fish/guestfish-actions.pod:1185 #, no-wrap msgid "" " fgrepi pattern path\n" @@ -7090,18 +9294,18 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1684 +#: ../fish/guestfish-actions.pod:1187 ../src/guestfs-actions.pod:1989 msgid "" "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1070 +#: ../fish/guestfish-actions.pod:1193 msgid "file" msgstr "file" #. type: verbatim -#: ../fish/guestfish-actions.pod:1072 +#: ../fish/guestfish-actions.pod:1195 #, no-wrap msgid "" " file path\n" @@ -7111,28 +9315,28 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1074 ../src/guestfs-actions.pod:1702 +#: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:2007 msgid "" "This call uses the standard L command to determine the type or " "contents of the file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1077 ../src/guestfs-actions.pod:1705 +#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2010 msgid "" "This call will also transparently look inside various types of compressed " "file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1080 ../src/guestfs-actions.pod:1708 +#: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2013 msgid "" "The exact command which runs is C. Note in particular that " "the filename is not prepended to the output (the I<-b> option)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1084 ../src/guestfs-actions.pod:1712 +#: ../fish/guestfish-actions.pod:1207 ../src/guestfs-actions.pod:2017 msgid "" "The output depends on the output of the underlying L command and it " "can change in future in ways beyond our control. In other words, the output " @@ -7140,19 +9344,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1088 +#: ../fish/guestfish-actions.pod:1211 msgid "" "See also: L, L, L, L, L " "(etc), L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1091 +#: ../fish/guestfish-actions.pod:1214 msgid "file-architecture" msgstr "file-architecture" #. type: verbatim -#: ../fish/guestfish-actions.pod:1093 +#: ../fish/guestfish-actions.pod:1216 #, no-wrap msgid "" " file-architecture filename\n" @@ -7162,166 +9366,166 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1095 ../src/guestfs-actions.pod:1730 +#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2035 msgid "" "This detects the architecture of the binary C, and returns it if " "known." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1098 ../src/guestfs-actions.pod:1733 +#: ../fish/guestfish-actions.pod:1221 ../src/guestfs-actions.pod:2038 msgid "Currently defined architectures are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1102 ../src/guestfs-actions.pod:1737 +#: ../fish/guestfish-actions.pod:1225 ../src/guestfs-actions.pod:2042 msgid "\"i386\"" msgstr "\"i386\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1104 ../src/guestfs-actions.pod:1739 +#: ../fish/guestfish-actions.pod:1227 ../src/guestfs-actions.pod:2044 msgid "" "This string is returned for all 32 bit i386, i486, i586, i686 binaries " "irrespective of the precise processor requirements of the binary." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1107 ../src/guestfs-actions.pod:1742 +#: ../fish/guestfish-actions.pod:1230 ../src/guestfs-actions.pod:2047 msgid "\"x86_64\"" msgstr "\"x86_64\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1109 ../src/guestfs-actions.pod:1744 +#: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2049 msgid "64 bit x86-64." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1111 ../src/guestfs-actions.pod:1746 +#: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2051 msgid "\"sparc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1113 ../src/guestfs-actions.pod:1748 +#: ../fish/guestfish-actions.pod:1236 ../src/guestfs-actions.pod:2053 msgid "32 bit SPARC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1115 ../src/guestfs-actions.pod:1750 +#: ../fish/guestfish-actions.pod:1238 ../src/guestfs-actions.pod:2055 msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1117 ../src/guestfs-actions.pod:1752 +#: ../fish/guestfish-actions.pod:1240 ../src/guestfs-actions.pod:2057 msgid "64 bit SPARC V9 and above." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1119 ../src/guestfs-actions.pod:1754 +#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2059 msgid "\"ia64\"" msgstr "\"ia64\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1121 ../src/guestfs-actions.pod:1756 +#: ../fish/guestfish-actions.pod:1244 ../src/guestfs-actions.pod:2061 msgid "Intel Itanium." msgstr "Intel Itanium." #. type: =item -#: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1758 +#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2063 msgid "\"ppc\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1125 ../src/guestfs-actions.pod:1760 +#: ../fish/guestfish-actions.pod:1248 ../src/guestfs-actions.pod:2065 msgid "32 bit Power PC." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1127 ../src/guestfs-actions.pod:1762 +#: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2067 msgid "\"ppc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1129 ../src/guestfs-actions.pod:1764 +#: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:2069 msgid "64 bit Power PC." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1133 ../src/guestfs-actions.pod:1768 +#: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2073 msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1135 ../src/guestfs-actions.pod:1770 +#: ../fish/guestfish-actions.pod:1258 ../src/guestfs-actions.pod:2075 msgid "The function works on at least the following types of files:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1141 ../src/guestfs-actions.pod:1776 +#: ../fish/guestfish-actions.pod:1264 ../src/guestfs-actions.pod:2081 msgid "many types of Un*x and Linux binary" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1145 ../src/guestfs-actions.pod:1780 +#: ../fish/guestfish-actions.pod:1268 ../src/guestfs-actions.pod:2085 msgid "many types of Un*x and Linux shared library" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1149 ../src/guestfs-actions.pod:1784 +#: ../fish/guestfish-actions.pod:1272 ../src/guestfs-actions.pod:2089 msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1153 ../src/guestfs-actions.pod:1788 +#: ../fish/guestfish-actions.pod:1276 ../src/guestfs-actions.pod:2093 msgid "Windows Win32 and Win64 DLLs" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1155 ../src/guestfs-actions.pod:1790 +#: ../fish/guestfish-actions.pod:1278 ../src/guestfs-actions.pod:2095 msgid "Win32 binaries and DLLs return C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1157 ../src/guestfs-actions.pod:1792 +#: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2097 msgid "Win64 binaries and DLLs return C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1161 ../src/guestfs-actions.pod:1796 +#: ../fish/guestfish-actions.pod:1284 ../src/guestfs-actions.pod:2101 msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1165 ../src/guestfs-actions.pod:1800 +#: ../fish/guestfish-actions.pod:1288 ../src/guestfs-actions.pod:2105 msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1169 ../src/guestfs-actions.pod:1804 +#: ../fish/guestfish-actions.pod:1292 ../src/guestfs-actions.pod:2109 msgid "some non-x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1173 ../src/guestfs-actions.pod:1808 +#: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:2113 msgid "What it can't do currently:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1179 ../src/guestfs-actions.pod:1814 +#: ../fish/guestfish-actions.pod:1302 ../src/guestfs-actions.pod:2119 msgid "static libraries (libfoo.a)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1183 ../src/guestfs-actions.pod:1818 +#: ../fish/guestfish-actions.pod:1306 ../src/guestfs-actions.pod:2123 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1187 ../src/guestfs-actions.pod:1822 +#: ../fish/guestfish-actions.pod:1310 ../src/guestfs-actions.pod:2127 msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1189 ../src/guestfs-actions.pod:1824 +#: ../fish/guestfish-actions.pod:1312 ../src/guestfs-actions.pod:2129 msgid "" "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and " "compressed code, and are horribly hard to unpack. If you want to find the " @@ -7330,12 +9534,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1196 +#: ../fish/guestfish-actions.pod:1319 msgid "filesize" msgstr "filesize" #. type: verbatim -#: ../fish/guestfish-actions.pod:1198 +#: ../fish/guestfish-actions.pod:1321 #, no-wrap msgid "" " filesize file\n" @@ -7345,24 +9549,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:1842 +#: ../fish/guestfish-actions.pod:1323 ../src/guestfs-actions.pod:2147 msgid "This command returns the size of C in bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1202 +#: ../fish/guestfish-actions.pod:1325 msgid "" "To get other stats about a file, use L, L, L, L etc. To get the size of block devices, use L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1206 +#: ../fish/guestfish-actions.pod:1329 msgid "fill" msgstr "fill" #. type: verbatim -#: ../fish/guestfish-actions.pod:1208 +#: ../fish/guestfish-actions.pod:1331 #, no-wrap msgid "" " fill c len path\n" @@ -7370,7 +9574,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1210 ../src/guestfs-actions.pod:1860 +#: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:2165 msgid "" "This command creates a new file called C. The initial content of the " "file is C octets of C, where C must be a number in the range C<" @@ -7378,7 +9582,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1214 +#: ../fish/guestfish-actions.pod:1337 msgid "" "To fill a file with zero bytes (sparsely), it is much more efficient to use " "L. To create a file with a pattern of repeating bytes use " @@ -7386,12 +9590,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1219 +#: ../fish/guestfish-actions.pod:1342 msgid "fill-pattern" msgstr "fill-pattern" #. type: verbatim -#: ../fish/guestfish-actions.pod:1221 +#: ../fish/guestfish-actions.pod:1344 #, no-wrap msgid "" " fill-pattern pattern len path\n" @@ -7399,7 +9603,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1223 +#: ../fish/guestfish-actions.pod:1346 msgid "" "This function is like L except that it creates a new file of length " "C containing the repeating pattern of bytes in C. The pattern " @@ -7408,12 +9612,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1228 +#: ../fish/guestfish-actions.pod:1351 msgid "find" msgstr "find" #. type: verbatim -#: ../fish/guestfish-actions.pod:1230 +#: ../fish/guestfish-actions.pod:1353 #, no-wrap msgid "" " find directory\n" @@ -7423,7 +9627,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:1906 +#: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2211 msgid "" "This command lists out all files and directories, recursively, starting at " "C. It is essentially equivalent to running the shell command " @@ -7432,14 +9636,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1237 ../src/guestfs-actions.pod:1911 +#: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2216 msgid "" "This returns a list of strings I. Thus if the directory " "structure was:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1240 ../src/guestfs-actions.pod:1914 +#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2219 #, no-wrap msgid "" " /tmp/a\n" @@ -7449,12 +9653,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1244 +#: ../fish/guestfish-actions.pod:1367 msgid "then the returned list from L C would be 4 elements:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1247 ../src/guestfs-actions.pod:1921 +#: ../fish/guestfish-actions.pod:1370 ../src/guestfs-actions.pod:2226 #, no-wrap msgid "" " a\n" @@ -7465,27 +9669,27 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:1926 +#: ../fish/guestfish-actions.pod:1375 ../src/guestfs-actions.pod:2231 msgid "If C is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1255 ../src/guestfs-actions.pod:1929 +#: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2234 msgid "The returned list is sorted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1257 +#: ../fish/guestfish-actions.pod:1380 msgid "See also L." msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1262 +#: ../fish/guestfish-actions.pod:1385 msgid "find0" msgstr "find0" #. type: verbatim -#: ../fish/guestfish-actions.pod:1264 +#: ../fish/guestfish-actions.pod:1387 #, no-wrap msgid "" " find0 directory (files|-)\n" @@ -7495,7 +9699,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1266 ../src/guestfs-actions.pod:1949 +#: ../fish/guestfish-actions.pod:1389 ../src/guestfs-actions.pod:2254 msgid "" "This command lists out all files and directories, recursively, starting at " "C, placing the resulting list in the external file called " @@ -7503,40 +9707,40 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1270 +#: ../fish/guestfish-actions.pod:1393 msgid "" "This command works the same way as L with the following exceptions:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1277 ../src/guestfs-actions.pod:1960 +#: ../fish/guestfish-actions.pod:1400 ../src/guestfs-actions.pod:2265 msgid "The resulting list is written to an external file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1281 ../src/guestfs-actions.pod:1964 +#: ../fish/guestfish-actions.pod:1404 ../src/guestfs-actions.pod:2269 msgid "" "Items (filenames) in the result are separated by C<\\0> characters. See " "L option I<-print0>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1286 ../src/guestfs-actions.pod:1969 +#: ../fish/guestfish-actions.pod:1409 ../src/guestfs-actions.pod:2274 msgid "This command is not limited in the number of names that it can return." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1291 ../src/guestfs-actions.pod:1974 +#: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2279 msgid "The result list is not sorted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1297 +#: ../fish/guestfish-actions.pod:1420 msgid "findfs-label" msgstr "findfs-label" #. type: verbatim -#: ../fish/guestfish-actions.pod:1299 +#: ../fish/guestfish-actions.pod:1422 #, no-wrap msgid "" " findfs-label label\n" @@ -7546,24 +9750,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1301 ../src/guestfs-actions.pod:1988 +#: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2293 msgid "" "This command searches the filesystems and returns the one which has the " "given label. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1305 +#: ../fish/guestfish-actions.pod:1428 msgid "To find the label of a filesystem, use L." msgstr "Для визначення мітки файлової системи скористайтеся L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1307 +#: ../fish/guestfish-actions.pod:1430 msgid "findfs-uuid" msgstr "findfs-uuid" #. type: verbatim -#: ../fish/guestfish-actions.pod:1309 +#: ../fish/guestfish-actions.pod:1432 #, no-wrap msgid "" " findfs-uuid uuid\n" @@ -7573,24 +9777,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1311 ../src/guestfs-actions.pod:2005 +#: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2310 msgid "" "This command searches the filesystems and returns the one which has the " "given UUID. An error is returned if no such filesystem can be found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1315 +#: ../fish/guestfish-actions.pod:1438 msgid "To find the UUID of a filesystem, use L." msgstr "Для визначення UUID файлової системи скористайтеся L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1317 +#: ../fish/guestfish-actions.pod:1440 msgid "fsck" msgstr "fsck" #. type: verbatim -#: ../fish/guestfish-actions.pod:1319 +#: ../fish/guestfish-actions.pod:1442 #, no-wrap msgid "" " fsck fstype device\n" @@ -7600,49 +9804,49 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1321 ../src/guestfs-actions.pod:2023 +#: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2328 msgid "" "This runs the filesystem checker (fsck) on C which should have " "filesystem type C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1324 ../src/guestfs-actions.pod:2026 +#: ../fish/guestfish-actions.pod:1447 ../src/guestfs-actions.pod:2331 msgid "" "The returned integer is the status. See L for the list of status " "codes from C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:2035 +#: ../fish/guestfish-actions.pod:1456 ../src/guestfs-actions.pod:2340 msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1337 ../src/guestfs-actions.pod:2039 +#: ../fish/guestfish-actions.pod:1460 ../src/guestfs-actions.pod:2344 msgid "" "A non-zero return code can mean \"success\", for example if errors have been " "corrected on the filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1342 ../src/guestfs-actions.pod:2044 +#: ../fish/guestfish-actions.pod:1465 ../src/guestfs-actions.pod:2349 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1347 ../src/guestfs-actions.pod:2049 +#: ../fish/guestfish-actions.pod:1470 ../src/guestfs-actions.pod:2354 msgid "" "This command is entirely equivalent to running C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1349 +#: ../fish/guestfish-actions.pod:1472 msgid "get-append" msgstr "get-append" #. type: verbatim -#: ../fish/guestfish-actions.pod:1351 +#: ../fish/guestfish-actions.pod:1474 #, no-wrap msgid "" " get-append\n" @@ -7652,24 +9856,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1353 ../src/guestfs-actions.pod:2060 +#: ../fish/guestfish-actions.pod:1476 ../src/guestfs-actions.pod:2365 msgid "" "Return the additional kernel options which are added to the guest kernel " "command line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1356 ../src/guestfs-actions.pod:2063 +#: ../fish/guestfish-actions.pod:1479 ../src/guestfs-actions.pod:2368 msgid "If C then no options are added." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1358 +#: ../fish/guestfish-actions.pod:1481 msgid "get-attach-method" msgstr "get-attach-method" #. type: verbatim -#: ../fish/guestfish-actions.pod:1360 +#: ../fish/guestfish-actions.pod:1483 #, no-wrap msgid "" " get-attach-method\n" @@ -7679,17 +9883,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1362 +#: ../fish/guestfish-actions.pod:1485 msgid "Return the current attach method. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1364 +#: ../fish/guestfish-actions.pod:1487 msgid "get-autosync" msgstr "get-autosync" #. type: verbatim -#: ../fish/guestfish-actions.pod:1366 +#: ../fish/guestfish-actions.pod:1489 #, no-wrap msgid "" " get-autosync\n" @@ -7699,17 +9903,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1368 ../src/guestfs-actions.pod:2088 +#: ../fish/guestfish-actions.pod:1491 ../src/guestfs-actions.pod:2393 msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1370 +#: ../fish/guestfish-actions.pod:1493 msgid "get-direct" msgstr "get-direct" #. type: verbatim -#: ../fish/guestfish-actions.pod:1372 +#: ../fish/guestfish-actions.pod:1495 #, no-wrap msgid "" " get-direct\n" @@ -7719,17 +9923,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1374 ../src/guestfs-actions.pod:2099 +#: ../fish/guestfish-actions.pod:1497 ../src/guestfs-actions.pod:2404 msgid "Return the direct appliance mode flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1376 +#: ../fish/guestfish-actions.pod:1499 msgid "get-e2label" msgstr "get-e2label" #. type: verbatim -#: ../fish/guestfish-actions.pod:1378 +#: ../fish/guestfish-actions.pod:1501 #, no-wrap msgid "" " get-e2label device\n" @@ -7739,25 +9943,25 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1380 ../src/guestfs-actions.pod:2118 +#: ../fish/guestfish-actions.pod:1503 ../src/guestfs-actions.pod:2423 msgid "" "This returns the ext2/3/4 filesystem label of the filesystem on C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1383 +#: ../fish/guestfish-actions.pod:1506 msgid "" "I In new code, use the L call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1390 +#: ../fish/guestfish-actions.pod:1513 msgid "get-e2uuid" msgstr "get-e2uuid" #. type: verbatim -#: ../fish/guestfish-actions.pod:1392 +#: ../fish/guestfish-actions.pod:1515 #, no-wrap msgid "" " get-e2uuid device\n" @@ -7767,25 +9971,25 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1394 ../src/guestfs-actions.pod:2139 +#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2444 msgid "" "This returns the ext2/3/4 filesystem UUID of the filesystem on C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1397 +#: ../fish/guestfish-actions.pod:1520 msgid "" "I In new code, use the L call " "instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1404 +#: ../fish/guestfish-actions.pod:1527 msgid "get-memsize" msgstr "get-memsize" #. type: verbatim -#: ../fish/guestfish-actions.pod:1406 +#: ../fish/guestfish-actions.pod:1529 #, no-wrap msgid "" " get-memsize\n" @@ -7795,13 +9999,13 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1408 ../src/guestfs-actions.pod:2152 +#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2457 msgid "" "This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1411 +#: ../fish/guestfish-actions.pod:1534 msgid "" "If L was not called on this handle, and if " "C was not set, then this returns the compiled-in default " @@ -7809,21 +10013,21 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1415 ../fish/guestfish-actions.pod:1472 -#: ../fish/guestfish-actions.pod:4235 ../fish/guestfish-actions.pod:4337 -#: ../src/guestfs-actions.pod:2159 ../src/guestfs-actions.pod:2251 -#: ../src/guestfs-actions.pod:6440 ../src/guestfs-actions.pod:6566 +#: ../fish/guestfish-actions.pod:1538 ../fish/guestfish-actions.pod:1595 +#: ../fish/guestfish-actions.pod:4468 ../fish/guestfish-actions.pod:4570 +#: ../src/guestfs-actions.pod:2464 ../src/guestfs-actions.pod:2556 +#: ../src/guestfs-actions.pod:6921 ../src/guestfs-actions.pod:7047 msgid "" "For more information on the architecture of libguestfs, see L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1418 +#: ../fish/guestfish-actions.pod:1541 msgid "get-network" msgstr "get-network" #. type: verbatim -#: ../fish/guestfish-actions.pod:1420 +#: ../fish/guestfish-actions.pod:1543 #, no-wrap msgid "" " get-network\n" @@ -7833,17 +10037,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1422 ../src/guestfs-actions.pod:2171 +#: ../fish/guestfish-actions.pod:1545 ../src/guestfs-actions.pod:2476 msgid "This returns the enable network flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1424 +#: ../fish/guestfish-actions.pod:1547 msgid "get-path" msgstr "get-path" #. type: verbatim -#: ../fish/guestfish-actions.pod:1426 +#: ../fish/guestfish-actions.pod:1549 #, no-wrap msgid "" " get-path\n" @@ -7853,24 +10057,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1428 ../src/guestfs-actions.pod:2182 +#: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2487 msgid "Return the current search path." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1430 ../src/guestfs-actions.pod:2184 +#: ../fish/guestfish-actions.pod:1553 ../src/guestfs-actions.pod:2489 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default path." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1433 +#: ../fish/guestfish-actions.pod:1556 msgid "get-pgroup" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1435 +#: ../fish/guestfish-actions.pod:1558 #, no-wrap msgid "" " get-pgroup\n" @@ -7878,22 +10082,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1437 ../src/guestfs-actions.pod:2197 +#: ../fish/guestfish-actions.pod:1560 ../src/guestfs-actions.pod:2502 msgid "This returns the process group flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1439 +#: ../fish/guestfish-actions.pod:1562 msgid "get-pid" msgstr "get-pid" #. type: =head2 -#: ../fish/guestfish-actions.pod:1441 +#: ../fish/guestfish-actions.pod:1564 msgid "pid" -msgstr "" +msgstr "PID" #. type: verbatim -#: ../fish/guestfish-actions.pod:1443 +#: ../fish/guestfish-actions.pod:1566 #, no-wrap msgid "" " get-pid\n" @@ -7903,24 +10107,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1445 ../src/guestfs-actions.pod:2208 +#: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2513 msgid "" "Return the process ID of the qemu subprocess. If there is no qemu " "subprocess, then this will return an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1448 ../src/guestfs-actions.pod:2211 +#: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2516 msgid "This is an internal call used for debugging and testing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1450 +#: ../fish/guestfish-actions.pod:1573 msgid "get-qemu" msgstr "get-qemu" #. type: verbatim -#: ../fish/guestfish-actions.pod:1452 +#: ../fish/guestfish-actions.pod:1575 #, no-wrap msgid "" " get-qemu\n" @@ -7930,24 +10134,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1454 ../src/guestfs-actions.pod:2222 +#: ../fish/guestfish-actions.pod:1577 ../src/guestfs-actions.pod:2527 msgid "Return the current qemu binary." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1456 ../src/guestfs-actions.pod:2224 +#: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2529 msgid "" "This is always non-NULL. If it wasn't set already, then this will return " "the default qemu binary name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1459 +#: ../fish/guestfish-actions.pod:1582 msgid "get-recovery-proc" msgstr "get-recovery-proc" #. type: verbatim -#: ../fish/guestfish-actions.pod:1461 +#: ../fish/guestfish-actions.pod:1584 #, no-wrap msgid "" " get-recovery-proc\n" @@ -7957,17 +10161,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1463 ../src/guestfs-actions.pod:2237 +#: ../fish/guestfish-actions.pod:1586 ../src/guestfs-actions.pod:2542 msgid "Return the recovery process enabled flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1465 +#: ../fish/guestfish-actions.pod:1588 msgid "get-selinux" msgstr "get-selinux" #. type: verbatim -#: ../fish/guestfish-actions.pod:1467 +#: ../fish/guestfish-actions.pod:1590 #, no-wrap msgid "" " get-selinux\n" @@ -7977,44 +10181,37 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1469 +#: ../fish/guestfish-actions.pod:1592 msgid "" "This returns the current setting of the selinux flag which is passed to the " "appliance at boot time. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1475 -#, fuzzy -#| msgid "get-pid" +#: ../fish/guestfish-actions.pod:1598 msgid "get-smp" -msgstr "get-pid" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1477 -#, fuzzy, no-wrap -#| msgid "" -#| " get-pid\n" -#| "\n" +#: ../fish/guestfish-actions.pod:1600 +#, no-wrap msgid "" " get-smp\n" "\n" msgstr "" -" get-pid\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1479 ../src/guestfs-actions.pod:2263 +#: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2568 msgid "This returns the number of virtual CPUs assigned to the appliance." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1481 +#: ../fish/guestfish-actions.pod:1604 msgid "get-state" msgstr "get-state" #. type: verbatim -#: ../fish/guestfish-actions.pod:1483 +#: ../fish/guestfish-actions.pod:1606 #, no-wrap msgid "" " get-state\n" @@ -8024,28 +10221,28 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1485 ../src/guestfs-actions.pod:2272 +#: ../fish/guestfish-actions.pod:1608 ../src/guestfs-actions.pod:2579 msgid "" "This returns the current state as an opaque integer. This is only useful " "for printing debug and internal error messages." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1488 ../fish/guestfish-actions.pod:2434 -#: ../fish/guestfish-actions.pod:2452 ../fish/guestfish-actions.pod:2490 -#: ../fish/guestfish-actions.pod:2506 ../src/guestfs-actions.pod:2275 -#: ../src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:3610 -#: ../src/guestfs-actions.pod:3671 ../src/guestfs-actions.pod:3698 +#: ../fish/guestfish-actions.pod:1611 ../fish/guestfish-actions.pod:2574 +#: ../fish/guestfish-actions.pod:2592 ../fish/guestfish-actions.pod:2630 +#: ../fish/guestfish-actions.pod:2646 ../src/guestfs-actions.pod:2582 +#: ../src/guestfs-actions.pod:3905 ../src/guestfs-actions.pod:3934 +#: ../src/guestfs-actions.pod:3995 ../src/guestfs-actions.pod:4022 msgid "For more information on states, see L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1490 +#: ../fish/guestfish-actions.pod:1613 msgid "get-trace" msgstr "get-trace" #. type: verbatim -#: ../fish/guestfish-actions.pod:1492 +#: ../fish/guestfish-actions.pod:1615 #, no-wrap msgid "" " get-trace\n" @@ -8055,17 +10252,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1494 ../src/guestfs-actions.pod:2286 +#: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2593 msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1496 +#: ../fish/guestfish-actions.pod:1619 msgid "get-umask" msgstr "get-umask" #. type: verbatim -#: ../fish/guestfish-actions.pod:1498 +#: ../fish/guestfish-actions.pod:1621 #, no-wrap msgid "" " get-umask\n" @@ -8075,19 +10272,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1500 +#: ../fish/guestfish-actions.pod:1623 msgid "" "Return the current umask. By default the umask is C<022> unless it has been " "set by calling L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1503 +#: ../fish/guestfish-actions.pod:1626 msgid "get-verbose" msgstr "get-verbose" #. type: verbatim -#: ../fish/guestfish-actions.pod:1505 +#: ../fish/guestfish-actions.pod:1628 #, no-wrap msgid "" " get-verbose\n" @@ -8097,17 +10294,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1507 ../src/guestfs-actions.pod:2309 +#: ../fish/guestfish-actions.pod:1630 ../src/guestfs-actions.pod:2616 msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1509 +#: ../fish/guestfish-actions.pod:1632 msgid "getcon" msgstr "getcon" #. type: verbatim -#: ../fish/guestfish-actions.pod:1511 +#: ../fish/guestfish-actions.pod:1634 #, no-wrap msgid "" " getcon\n" @@ -8117,22 +10314,22 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1513 ../src/guestfs-actions.pod:2320 +#: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2627 msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1515 +#: ../fish/guestfish-actions.pod:1638 msgid "See the documentation about SELINUX in L, and L" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1518 +#: ../fish/guestfish-actions.pod:1641 msgid "getxattr" msgstr "getxattr" #. type: verbatim -#: ../fish/guestfish-actions.pod:1520 +#: ../fish/guestfish-actions.pod:1643 #, no-wrap msgid "" " getxattr path name\n" @@ -8142,7 +10339,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1522 +#: ../fish/guestfish-actions.pod:1645 msgid "" "Get a single extended attribute from file C named C. This call " "follows symlinks. If you want to lookup an extended attribute for the " @@ -8150,7 +10347,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1526 ../fish/guestfish-actions.pod:2579 +#: ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:2719 msgid "" "Normally it is better to get all extended attributes from a file in one go " "by calling L. However some Linux filesystem implementations are " @@ -8160,25 +10357,25 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1533 ../fish/guestfish-actions.pod:2586 -#: ../src/guestfs-actions.pod:2349 ../src/guestfs-actions.pod:3831 +#: ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:2726 +#: ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:4155 msgid "" "Extended attribute values are blobs of binary data. If there is no extended " "attribute named C, this returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1536 +#: ../fish/guestfish-actions.pod:1659 msgid "See also: L, L, L." msgstr "Див. також L, L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1538 +#: ../fish/guestfish-actions.pod:1661 msgid "getxattrs" msgstr "getxattrs" #. type: verbatim -#: ../fish/guestfish-actions.pod:1540 +#: ../fish/guestfish-actions.pod:1663 #, no-wrap msgid "" " getxattrs path\n" @@ -8188,30 +10385,30 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1542 ../src/guestfs-actions.pod:2366 +#: ../fish/guestfish-actions.pod:1665 ../src/guestfs-actions.pod:2673 msgid "" "This call lists the extended attributes of the file or directory C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1545 ../src/guestfs-actions.pod:2369 +#: ../fish/guestfish-actions.pod:1668 ../src/guestfs-actions.pod:2676 msgid "" "At the system call level, this is a combination of the L and " "L calls." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1548 +#: ../fish/guestfish-actions.pod:1671 msgid "See also: L, L." msgstr "Див. також L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1550 +#: ../fish/guestfish-actions.pod:1673 msgid "glob-expand" msgstr "glob-expand" #. type: verbatim -#: ../fish/guestfish-actions.pod:1552 +#: ../fish/guestfish-actions.pod:1675 #, no-wrap msgid "" " glob-expand pattern\n" @@ -8221,32 +10418,32 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1554 ../src/guestfs-actions.pod:2386 +#: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2693 msgid "" "This command searches for all the pathnames matching C according to " "the wildcard expansion rules used by the shell." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1558 ../src/guestfs-actions.pod:2390 +#: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2697 msgid "" "If no paths match, then this returns an empty list (note: not an error)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1561 ../src/guestfs-actions.pod:2393 +#: ../fish/guestfish-actions.pod:1684 ../src/guestfs-actions.pod:2700 msgid "" "It is just a wrapper around the C L function with flags C. See that manual page for more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1565 +#: ../fish/guestfish-actions.pod:1688 msgid "grep" msgstr "grep" #. type: verbatim -#: ../fish/guestfish-actions.pod:1567 +#: ../fish/guestfish-actions.pod:1690 #, no-wrap msgid "" " grep regex path\n" @@ -8256,17 +10453,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1569 ../src/guestfs-actions.pod:2410 +#: ../fish/guestfish-actions.pod:1692 ../src/guestfs-actions.pod:2717 msgid "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1575 +#: ../fish/guestfish-actions.pod:1698 msgid "grepi" msgstr "grepi" #. type: verbatim -#: ../fish/guestfish-actions.pod:1577 +#: ../fish/guestfish-actions.pod:1700 #, no-wrap msgid "" " grepi regex path\n" @@ -8276,18 +10473,18 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2429 +#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2736 msgid "" "This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1585 +#: ../fish/guestfish-actions.pod:1708 msgid "grub-install" msgstr "grub-install" #. type: verbatim -#: ../fish/guestfish-actions.pod:1587 +#: ../fish/guestfish-actions.pod:1710 #, no-wrap msgid "" " grub-install root device\n" @@ -8297,14 +10494,14 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1589 ../src/guestfs-actions.pod:2448 +#: ../fish/guestfish-actions.pod:1712 ../src/guestfs-actions.pod:2755 msgid "" "This command installs GRUB 1 (the Grand Unified Bootloader) on C, " "with the root directory being C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1598 ../src/guestfs-actions.pod:2457 +#: ../fish/guestfish-actions.pod:1721 ../src/guestfs-actions.pod:2764 msgid "" "There is currently no way in the API to install grub2, which is used by most " "modern Linux guests. It is possible to run the grub2 command from the " @@ -8312,7 +10509,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1605 ../src/guestfs-actions.pod:2464 +#: ../fish/guestfish-actions.pod:1728 ../src/guestfs-actions.pod:2771 msgid "" "This uses C from the host. Unfortunately grub is not always " "compatible with itself, so this only works in rather narrow circumstances. " @@ -8320,7 +10517,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1612 ../src/guestfs-actions.pod:2471 +#: ../fish/guestfish-actions.pod:1735 ../src/guestfs-actions.pod:2778 msgid "" "If grub-install reports the error \"No suitable drive was found in the " "generated device map.\" it may be that you need to create a C with the name of the installation device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1625 +#: ../fish/guestfish-actions.pod:1748 msgid "head" msgstr "head" #. type: verbatim -#: ../fish/guestfish-actions.pod:1627 +#: ../fish/guestfish-actions.pod:1750 #, no-wrap msgid "" " head path\n" @@ -8358,18 +10555,18 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1629 ../src/guestfs-actions.pod:2494 +#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2801 msgid "" "This command returns up to the first 10 lines of a file as a list of strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1635 +#: ../fish/guestfish-actions.pod:1758 msgid "head-n" msgstr "head-n" #. type: verbatim -#: ../fish/guestfish-actions.pod:1637 +#: ../fish/guestfish-actions.pod:1760 #, no-wrap msgid "" " head-n nrlines path\n" @@ -8377,32 +10574,32 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1639 ../src/guestfs-actions.pod:2513 +#: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2820 msgid "" "If the parameter C is a positive number, this returns the first " "C lines of the file C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1642 ../src/guestfs-actions.pod:2516 +#: ../fish/guestfish-actions.pod:1765 ../src/guestfs-actions.pod:2823 msgid "" "If the parameter C is a negative number, this returns lines from " "the file C, excluding the last C lines." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1645 ../fish/guestfish-actions.pod:4727 -#: ../src/guestfs-actions.pod:2519 ../src/guestfs-actions.pod:7152 +#: ../fish/guestfish-actions.pod:1768 ../fish/guestfish-actions.pod:4951 +#: ../src/guestfs-actions.pod:2826 ../src/guestfs-actions.pod:7626 msgid "If the parameter C is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1650 +#: ../fish/guestfish-actions.pod:1773 msgid "hexdump" msgstr "hexdump" #. type: verbatim -#: ../fish/guestfish-actions.pod:1652 +#: ../fish/guestfish-actions.pod:1775 #, no-wrap msgid "" " hexdump path\n" @@ -8412,19 +10609,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1654 ../src/guestfs-actions.pod:2536 +#: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2843 msgid "" "This runs C on the given C. The result is the human-" "readable, canonical hex dump of the file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1660 +#: ../fish/guestfish-actions.pod:1783 msgid "initrd-cat" msgstr "initrd-cat" #. type: verbatim -#: ../fish/guestfish-actions.pod:1662 +#: ../fish/guestfish-actions.pod:1785 #, no-wrap msgid "" " initrd-cat initrdpath filename\n" @@ -8434,7 +10631,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1664 ../src/guestfs-actions.pod:2555 +#: ../fish/guestfish-actions.pod:1787 ../src/guestfs-actions.pod:2862 msgid "" "This command unpacks the file C from the initrd file called " "C. The filename must be given I the initial C " @@ -8442,7 +10639,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1668 ../src/guestfs-actions.pod:2559 +#: ../fish/guestfish-actions.pod:1791 ../src/guestfs-actions.pod:2866 msgid "" "For example, in guestfish you could use the following command to examine the " "boot script (usually called C) contained in a Linux initrd or " @@ -8450,7 +10647,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1672 ../src/guestfs-actions.pod:2563 +#: ../fish/guestfish-actions.pod:1795 ../src/guestfs-actions.pod:2870 #, no-wrap msgid "" " initrd-cat /boot/initrd-.img init\n" @@ -8458,17 +10655,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1674 +#: ../fish/guestfish-actions.pod:1797 msgid "See also L." msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1679 +#: ../fish/guestfish-actions.pod:1802 msgid "initrd-list" msgstr "initrd-list" #. type: verbatim -#: ../fish/guestfish-actions.pod:1681 +#: ../fish/guestfish-actions.pod:1804 #, no-wrap msgid "" " initrd-list path\n" @@ -8478,12 +10675,12 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1683 ../src/guestfs-actions.pod:2582 +#: ../fish/guestfish-actions.pod:1806 ../src/guestfs-actions.pod:2889 msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1685 ../src/guestfs-actions.pod:2584 +#: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2891 msgid "" "The files are listed without any initial C character. The files are " "listed in the order they appear (not necessarily alphabetical). Directory " @@ -8491,7 +10688,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1689 ../src/guestfs-actions.pod:2588 +#: ../fish/guestfish-actions.pod:1812 ../src/guestfs-actions.pod:2895 msgid "" "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as " "initrd. We I support the newer initramfs format (compressed cpio " @@ -8499,12 +10696,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1693 +#: ../fish/guestfish-actions.pod:1816 msgid "inotify-add-watch" msgstr "inotify-add-watch" #. type: verbatim -#: ../fish/guestfish-actions.pod:1695 +#: ../fish/guestfish-actions.pod:1818 #, no-wrap msgid "" " inotify-add-watch path mask\n" @@ -8514,31 +10711,31 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1697 ../src/guestfs-actions.pod:2605 +#: ../fish/guestfish-actions.pod:1820 ../src/guestfs-actions.pod:2912 msgid "Watch C for the events listed in C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1699 ../src/guestfs-actions.pod:2607 +#: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2914 msgid "" "Note that if C is a directory then events within that directory are " "watched, but this does I happen recursively (in subdirectories)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1703 ../src/guestfs-actions.pod:2611 +#: ../fish/guestfish-actions.pod:1826 ../src/guestfs-actions.pod:2918 msgid "" "Note for non-C or non-Linux callers: the inotify events are defined by the " "Linux kernel ABI and are listed in C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1707 +#: ../fish/guestfish-actions.pod:1830 msgid "inotify-close" msgstr "inotify-close" #. type: verbatim -#: ../fish/guestfish-actions.pod:1709 +#: ../fish/guestfish-actions.pod:1832 #, no-wrap msgid "" " inotify-close\n" @@ -8548,7 +10745,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1711 ../src/guestfs-actions.pod:2624 +#: ../fish/guestfish-actions.pod:1834 ../src/guestfs-actions.pod:2931 msgid "" "This closes the inotify handle which was previously opened by inotify_init. " "It removes all watches, throws away any pending events, and deallocates all " @@ -8556,12 +10753,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1715 +#: ../fish/guestfish-actions.pod:1838 msgid "inotify-files" msgstr "inotify-files" #. type: verbatim -#: ../fish/guestfish-actions.pod:1717 +#: ../fish/guestfish-actions.pod:1840 #, no-wrap msgid "" " inotify-files\n" @@ -8571,7 +10768,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1719 +#: ../fish/guestfish-actions.pod:1842 msgid "" "This function is a helpful wrapper around L which just " "returns a list of pathnames of objects that were touched. The returned " @@ -8579,12 +10776,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1723 +#: ../fish/guestfish-actions.pod:1846 msgid "inotify-init" msgstr "inotify-init" #. type: verbatim -#: ../fish/guestfish-actions.pod:1725 +#: ../fish/guestfish-actions.pod:1848 #, no-wrap msgid "" " inotify-init maxevents\n" @@ -8592,14 +10789,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1727 ../src/guestfs-actions.pod:2653 +#: ../fish/guestfish-actions.pod:1850 ../src/guestfs-actions.pod:2960 msgid "" "This command creates a new inotify handle. The inotify subsystem can be " "used to notify events which happen to objects in the guest filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1731 +#: ../fish/guestfish-actions.pod:1854 msgid "" "C is the maximum number of events which will be queued up between " "calls to L or L. If this is passed as C<0>, " @@ -8610,7 +10807,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1741 +#: ../fish/guestfish-actions.pod:1864 msgid "" "Before any events are generated, you have to add some watches to the " "internal watch list. See: L, L and " @@ -8618,7 +10815,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1747 +#: ../fish/guestfish-actions.pod:1870 msgid "" "Queued up events should be read periodically by calling L (or " "L which is just a helpful wrapper around L). " @@ -8627,14 +10824,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1754 +#: ../fish/guestfish-actions.pod:1877 msgid "" "The handle should be closed after use by calling L. This " "also removes any watches automatically." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1758 ../src/guestfs-actions.pod:2684 +#: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2991 msgid "" "See also L for an overview of the inotify interface as exposed " "by the Linux kernel, which is roughly what we expose via libguestfs. Note " @@ -8642,12 +10839,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1763 +#: ../fish/guestfish-actions.pod:1886 msgid "inotify-read" msgstr "inotify-read" #. type: verbatim -#: ../fish/guestfish-actions.pod:1765 +#: ../fish/guestfish-actions.pod:1888 #, no-wrap msgid "" " inotify-read\n" @@ -8657,19 +10854,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1767 ../src/guestfs-actions.pod:2698 +#: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:3005 msgid "" "Return the complete queue of events that have happened since the previous " "read call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1770 ../src/guestfs-actions.pod:2701 +#: ../fish/guestfish-actions.pod:1893 ../src/guestfs-actions.pod:3008 msgid "If no events have happened, this returns an empty list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1772 ../src/guestfs-actions.pod:2703 +#: ../fish/guestfish-actions.pod:1895 ../src/guestfs-actions.pod:3010 msgid "" "I: In order to make sure that all events have been read, you must call " "this function repeatedly until it returns an empty list. The reason is that " @@ -8678,12 +10875,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1778 +#: ../fish/guestfish-actions.pod:1901 msgid "inotify-rm-watch" msgstr "inotify-rm-watch" #. type: verbatim -#: ../fish/guestfish-actions.pod:1780 +#: ../fish/guestfish-actions.pod:1903 #, no-wrap msgid "" " inotify-rm-watch wd\n" @@ -8691,17 +10888,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1782 +#: ../fish/guestfish-actions.pod:1905 msgid "Remove a previously defined inotify watch. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1785 +#: ../fish/guestfish-actions.pod:1908 msgid "inspect-get-arch" msgstr "inspect-get-arch" #. type: verbatim -#: ../fish/guestfish-actions.pod:1787 +#: ../fish/guestfish-actions.pod:1910 #, no-wrap msgid "" " inspect-get-arch root\n" @@ -8711,47 +10908,47 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1789 +#: ../fish/guestfish-actions.pod:1912 msgid "" "This returns the architecture of the inspected operating system. The " "possible return values are listed under L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1793 ../src/guestfs-actions.pod:2738 +#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3045 msgid "" "If the architecture could not be determined, then the string C is " "returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1796 ../fish/guestfish-actions.pod:1883 -#: ../fish/guestfish-actions.pod:1962 ../fish/guestfish-actions.pod:1974 -#: ../fish/guestfish-actions.pod:2058 ../fish/guestfish-actions.pod:2119 -#: ../fish/guestfish-actions.pod:2140 ../fish/guestfish-actions.pod:2154 -#: ../fish/guestfish-actions.pod:2194 ../fish/guestfish-actions.pod:2226 -#: ../fish/guestfish-actions.pod:2239 ../fish/guestfish-actions.pod:2252 -#: ../fish/guestfish-actions.pod:2262 ../fish/guestfish-actions.pod:2272 -#: ../fish/guestfish-actions.pod:2284 ../fish/guestfish-actions.pod:2380 -#: ../fish/guestfish-actions.pod:2414 ../src/guestfs-actions.pod:2741 -#: ../src/guestfs-actions.pod:2835 ../src/guestfs-actions.pod:2939 -#: ../src/guestfs-actions.pod:2958 ../src/guestfs-actions.pod:3089 -#: ../src/guestfs-actions.pod:3172 ../src/guestfs-actions.pod:3200 -#: ../src/guestfs-actions.pod:3221 ../src/guestfs-actions.pod:3274 -#: ../src/guestfs-actions.pod:3314 ../src/guestfs-actions.pod:3334 -#: ../src/guestfs-actions.pod:3354 ../src/guestfs-actions.pod:3371 -#: ../src/guestfs-actions.pod:3387 ../src/guestfs-actions.pod:3405 -#: ../src/guestfs-actions.pod:3507 ../src/guestfs-actions.pod:3548 +#: ../fish/guestfish-actions.pod:1919 ../fish/guestfish-actions.pod:2014 +#: ../fish/guestfish-actions.pod:2093 ../fish/guestfish-actions.pod:2105 +#: ../fish/guestfish-actions.pod:2189 ../fish/guestfish-actions.pod:2251 +#: ../fish/guestfish-actions.pod:2272 ../fish/guestfish-actions.pod:2286 +#: ../fish/guestfish-actions.pod:2326 ../fish/guestfish-actions.pod:2366 +#: ../fish/guestfish-actions.pod:2379 ../fish/guestfish-actions.pod:2392 +#: ../fish/guestfish-actions.pod:2402 ../fish/guestfish-actions.pod:2412 +#: ../fish/guestfish-actions.pod:2424 ../fish/guestfish-actions.pod:2520 +#: ../fish/guestfish-actions.pod:2554 ../src/guestfs-actions.pod:3048 +#: ../src/guestfs-actions.pod:3150 ../src/guestfs-actions.pod:3254 +#: ../src/guestfs-actions.pod:3273 ../src/guestfs-actions.pod:3404 +#: ../src/guestfs-actions.pod:3488 ../src/guestfs-actions.pod:3516 +#: ../src/guestfs-actions.pod:3537 ../src/guestfs-actions.pod:3590 +#: ../src/guestfs-actions.pod:3638 ../src/guestfs-actions.pod:3658 +#: ../src/guestfs-actions.pod:3678 ../src/guestfs-actions.pod:3695 +#: ../src/guestfs-actions.pod:3711 ../src/guestfs-actions.pod:3729 +#: ../src/guestfs-actions.pod:3831 ../src/guestfs-actions.pod:3872 msgid "Please read L for more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1798 +#: ../fish/guestfish-actions.pod:1921 msgid "inspect-get-distro" msgstr "inspect-get-distro" #. type: verbatim -#: ../fish/guestfish-actions.pod:1800 +#: ../fish/guestfish-actions.pod:1923 #, no-wrap msgid "" " inspect-get-distro root\n" @@ -8761,211 +10958,227 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1802 ../src/guestfs-actions.pod:2754 +#: ../fish/guestfish-actions.pod:1925 ../src/guestfs-actions.pod:3061 msgid "" "This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1805 ../src/guestfs-actions.pod:2757 +#: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3064 msgid "Currently defined distros are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1809 ../src/guestfs-actions.pod:2761 +#: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3068 msgid "\"archlinux\"" msgstr "\"archlinux\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1811 ../src/guestfs-actions.pod:2763 +#: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3070 msgid "Arch Linux." msgstr "Arch Linux." #. type: =item -#: ../fish/guestfish-actions.pod:1813 ../src/guestfs-actions.pod:2765 +#: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3072 msgid "\"centos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1815 ../src/guestfs-actions.pod:2767 +#: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3074 msgid "CentOS." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1817 ../src/guestfs-actions.pod:2769 +#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3076 msgid "\"debian\"" msgstr "\"debian\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1819 ../src/guestfs-actions.pod:2771 +#: ../fish/guestfish-actions.pod:1942 ../src/guestfs-actions.pod:3078 msgid "Debian." msgstr "Debian." #. type: =item -#: ../fish/guestfish-actions.pod:1821 ../src/guestfs-actions.pod:2773 +#: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:3080 msgid "\"fedora\"" msgstr "\"fedora\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1823 ../src/guestfs-actions.pod:2775 +#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:3082 msgid "Fedora." msgstr "Fedora." #. type: =item -#: ../fish/guestfish-actions.pod:1825 ../src/guestfs-actions.pod:2777 +#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3084 msgid "\"gentoo\"" msgstr "\"gentoo\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1827 ../src/guestfs-actions.pod:2779 +#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3086 msgid "Gentoo." msgstr "Gentoo." #. type: =item -#: ../fish/guestfish-actions.pod:1829 ../src/guestfs-actions.pod:2781 +#: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3088 msgid "\"linuxmint\"" msgstr "\"linuxmint\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1831 ../src/guestfs-actions.pod:2783 +#: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:3090 msgid "Linux Mint." msgstr "Linux Mint." #. type: =item -#: ../fish/guestfish-actions.pod:1833 ../src/guestfs-actions.pod:2785 +#: ../fish/guestfish-actions.pod:1956 ../src/guestfs-actions.pod:3092 +msgid "\"mageia\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1958 ../src/guestfs-actions.pod:3094 +msgid "Mageia." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3096 msgid "\"mandriva\"" msgstr "\"mandriva\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1835 ../src/guestfs-actions.pod:2787 +#: ../fish/guestfish-actions.pod:1962 ../src/guestfs-actions.pod:3098 msgid "Mandriva." msgstr "Mandriva." #. type: =item -#: ../fish/guestfish-actions.pod:1837 ../src/guestfs-actions.pod:2789 +#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3100 msgid "\"meego\"" msgstr "\"meego\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1839 ../src/guestfs-actions.pod:2791 +#: ../fish/guestfish-actions.pod:1966 ../src/guestfs-actions.pod:3102 msgid "MeeGo." msgstr "MeeGo." #. type: =item -#: ../fish/guestfish-actions.pod:1841 ../src/guestfs-actions.pod:2793 +#: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:3104 +msgid "\"opensuse\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1970 ../src/guestfs-actions.pod:3106 +msgid "OpenSUSE." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:1972 ../src/guestfs-actions.pod:3108 msgid "\"pardus\"" msgstr "\"pardus\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1843 ../src/guestfs-actions.pod:2795 +#: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3110 msgid "Pardus." msgstr "Pardus." #. type: =item -#: ../fish/guestfish-actions.pod:1845 ../src/guestfs-actions.pod:2797 +#: ../fish/guestfish-actions.pod:1976 ../src/guestfs-actions.pod:3112 msgid "\"redhat-based\"" msgstr "\"redhat-based\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1847 ../src/guestfs-actions.pod:2799 +#: ../fish/guestfish-actions.pod:1978 ../src/guestfs-actions.pod:3114 msgid "Some Red Hat-derived distro." msgstr "Дистрибутив, що походить від Red Hat." #. type: =item -#: ../fish/guestfish-actions.pod:1849 ../src/guestfs-actions.pod:2801 +#: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:3116 msgid "\"rhel\"" msgstr "\"rhel\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1851 ../src/guestfs-actions.pod:2803 +#: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:3118 msgid "Red Hat Enterprise Linux." -msgstr "" +msgstr "Red Hat Enterprise Linux." #. type: =item -#: ../fish/guestfish-actions.pod:1853 ../src/guestfs-actions.pod:2805 +#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3120 msgid "\"scientificlinux\"" -msgstr "" +msgstr "\"scientificlinux\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1855 ../src/guestfs-actions.pod:2807 +#: ../fish/guestfish-actions.pod:1986 ../src/guestfs-actions.pod:3122 msgid "Scientific Linux." -msgstr "" +msgstr "Scientific Linux." #. type: =item -#: ../fish/guestfish-actions.pod:1857 ../src/guestfs-actions.pod:2809 +#: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3124 msgid "\"slackware\"" -msgstr "" +msgstr "\"slackware\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1859 ../src/guestfs-actions.pod:2811 +#: ../fish/guestfish-actions.pod:1990 ../src/guestfs-actions.pod:3126 msgid "Slackware." -msgstr "" +msgstr "Slackware." #. type: =item -#: ../fish/guestfish-actions.pod:1861 ../src/guestfs-actions.pod:2813 -#, fuzzy -#| msgid "\"linux\"" +#: ../fish/guestfish-actions.pod:1992 ../src/guestfs-actions.pod:3128 msgid "\"ttylinux\"" -msgstr "\"linux\"" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1863 ../src/guestfs-actions.pod:2815 -#, fuzzy -#| msgid "\"linux\"" +#: ../fish/guestfish-actions.pod:1994 ../src/guestfs-actions.pod:3130 msgid "ttylinux." -msgstr "\"linux\"" +msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1865 ../src/guestfs-actions.pod:2817 +#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3132 msgid "\"ubuntu\"" msgstr "\"ubuntu\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1867 ../src/guestfs-actions.pod:2819 +#: ../fish/guestfish-actions.pod:1998 ../src/guestfs-actions.pod:3134 msgid "Ubuntu." msgstr "Ubuntu." #. type: =item -#: ../fish/guestfish-actions.pod:1869 ../fish/guestfish-actions.pod:1953 -#: ../fish/guestfish-actions.pod:2217 ../src/guestfs-actions.pod:2821 -#: ../src/guestfs-actions.pod:2930 ../src/guestfs-actions.pod:3305 +#: ../fish/guestfish-actions.pod:2000 ../fish/guestfish-actions.pod:2084 +#: ../fish/guestfish-actions.pod:2357 ../src/guestfs-actions.pod:3136 +#: ../src/guestfs-actions.pod:3245 ../src/guestfs-actions.pod:3629 msgid "\"unknown\"" msgstr "\"unknown\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1871 ../src/guestfs-actions.pod:2823 +#: ../fish/guestfish-actions.pod:2002 ../src/guestfs-actions.pod:3138 msgid "The distro could not be determined." msgstr "Дистрибутив, тип якого не вдалося визначити." #. type: =item -#: ../fish/guestfish-actions.pod:1873 ../fish/guestfish-actions.pod:2209 -#: ../src/guestfs-actions.pod:2825 ../src/guestfs-actions.pod:3297 +#: ../fish/guestfish-actions.pod:2004 ../fish/guestfish-actions.pod:2341 +#: ../src/guestfs-actions.pod:3140 ../src/guestfs-actions.pod:3613 msgid "\"windows\"" msgstr "\"windows\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1875 ../src/guestfs-actions.pod:2827 +#: ../fish/guestfish-actions.pod:2006 ../src/guestfs-actions.pod:3142 msgid "" "Windows does not have distributions. This string is returned if the OS type " "is Windows." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1880 ../fish/guestfish-actions.pod:1959 -#: ../fish/guestfish-actions.pod:2223 ../src/guestfs-actions.pod:2832 -#: ../src/guestfs-actions.pod:2936 ../src/guestfs-actions.pod:3311 +#: ../fish/guestfish-actions.pod:2011 ../fish/guestfish-actions.pod:2090 +#: ../fish/guestfish-actions.pod:2363 ../src/guestfs-actions.pod:3147 +#: ../src/guestfs-actions.pod:3251 ../src/guestfs-actions.pod:3635 msgid "" "Future versions of libguestfs may return other strings here. The caller " "should be prepared to handle any string." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1885 +#: ../fish/guestfish-actions.pod:2016 msgid "inspect-get-drive-mappings" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1887 +#: ../fish/guestfish-actions.pod:2018 #, no-wrap msgid "" " inspect-get-drive-mappings root\n" @@ -8973,7 +11186,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1889 ../src/guestfs-actions.pod:2848 +#: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3163 msgid "" "This call is useful for Windows which uses a primitive system of assigning " "drive letters (like \"C:\") to partitions. This inspection API examines the " @@ -8982,7 +11195,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1895 ../src/guestfs-actions.pod:2854 +#: ../fish/guestfish-actions.pod:2026 ../src/guestfs-actions.pod:3169 #, no-wrap msgid "" " C => /dev/vda2\n" @@ -8992,7 +11205,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1899 ../src/guestfs-actions.pod:2858 +#: ../fish/guestfish-actions.pod:2030 ../src/guestfs-actions.pod:3173 msgid "" "Note that keys are drive letters. For Windows, the key is case insensitive " "and just contains the drive letter, without the customary colon separator " @@ -9000,7 +11213,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1903 ../src/guestfs-actions.pod:2862 +#: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3177 msgid "" "In future we may support other operating systems that also used drive " "letters, but the keys for those might not be case insensitive and might be " @@ -9009,33 +11222,33 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1908 ../src/guestfs-actions.pod:2867 +#: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3182 msgid "" "For Windows guests, currently only hard drive mappings are returned. " "Removable disks (eg. DVD-ROMs) are ignored." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1911 ../src/guestfs-actions.pod:2870 +#: ../fish/guestfish-actions.pod:2042 ../src/guestfs-actions.pod:3185 msgid "" "For guests that do not use drive mappings, or if the drive mappings could " "not be determined, this returns an empty hash table." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1914 +#: ../fish/guestfish-actions.pod:2045 msgid "" "Please read L for more details. See also L, L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1918 +#: ../fish/guestfish-actions.pod:2049 msgid "inspect-get-filesystems" msgstr "inspect-get-filesystems" #. type: verbatim -#: ../fish/guestfish-actions.pod:1920 +#: ../fish/guestfish-actions.pod:2051 #, no-wrap msgid "" " inspect-get-filesystems root\n" @@ -9045,7 +11258,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1922 ../src/guestfs-actions.pod:2891 +#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3206 msgid "" "This returns a list of all the filesystems that we think are associated with " "this operating system. This includes the root filesystem, other ordinary " @@ -9053,26 +11266,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1927 ../src/guestfs-actions.pod:2896 +#: ../fish/guestfish-actions.pod:2058 ../src/guestfs-actions.pod:3211 msgid "" "In the case of a multi-boot virtual machine, it is possible for a filesystem " "to be shared between operating systems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1930 +#: ../fish/guestfish-actions.pod:2061 msgid "" "Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1933 +#: ../fish/guestfish-actions.pod:2064 msgid "inspect-get-format" msgstr "inspect-get-format" #. type: verbatim -#: ../fish/guestfish-actions.pod:1935 +#: ../fish/guestfish-actions.pod:2066 #, no-wrap msgid "" " inspect-get-format root\n" @@ -9082,51 +11295,51 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1937 ../src/guestfs-actions.pod:2914 +#: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3229 msgid "" "This returns the format of the inspected operating system. You can use it " "to detect install images, live CDs and similar." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:2917 +#: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3232 msgid "Currently defined formats are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:2921 +#: ../fish/guestfish-actions.pod:2075 ../src/guestfs-actions.pod:3236 msgid "\"installed\"" msgstr "\"installed\"" #. type: textblock -#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:2923 +#: ../fish/guestfish-actions.pod:2077 ../src/guestfs-actions.pod:3238 msgid "This is an installed operating system." msgstr "Це встановлена операційна система." #. type: =item -#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:2925 +#: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3240 msgid "\"installer\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:2927 +#: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3242 msgid "" "The disk image being inspected is not an installed operating system, but a " "I install disk, live CD, or similar." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1955 ../src/guestfs-actions.pod:2932 +#: ../fish/guestfish-actions.pod:2086 ../src/guestfs-actions.pod:3247 msgid "The format of this disk image is not known." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1964 +#: ../fish/guestfish-actions.pod:2095 msgid "inspect-get-hostname" msgstr "inspect-get-hostname" #. type: verbatim -#: ../fish/guestfish-actions.pod:1966 +#: ../fish/guestfish-actions.pod:2097 #, no-wrap msgid "" " inspect-get-hostname root\n" @@ -9136,34 +11349,34 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:2952 +#: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3267 msgid "" "This function returns the hostname of the operating system as found by " "inspection of the guest's configuration files." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1971 ../src/guestfs-actions.pod:2955 +#: ../fish/guestfish-actions.pod:2102 ../src/guestfs-actions.pod:3270 msgid "" "If the hostname could not be determined, then the string C is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1976 +#: ../fish/guestfish-actions.pod:2107 msgid "inspect-get-icon" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1978 +#: ../fish/guestfish-actions.pod:2109 #, no-wrap msgid "" -" inspect-get-icon root [favicon:..] [highquality:..]\n" +" inspect-get-icon root [favicon:true|false] [highquality:true|false]\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:2981 +#: ../fish/guestfish-actions.pod:2111 ../src/guestfs-actions.pod:3296 msgid "" "This function returns an icon corresponding to the inspected operating " "system. The icon is returned as a buffer containing a PNG image (re-encoded " @@ -9171,14 +11384,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:2985 +#: ../fish/guestfish-actions.pod:2115 ../src/guestfs-actions.pod:3300 msgid "" "If it was not possible to get an icon this function returns a zero-length " "(non-NULL) buffer. I." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1987 ../src/guestfs-actions.pod:2988 +#: ../fish/guestfish-actions.pod:2118 ../src/guestfs-actions.pod:3303 msgid "" "Libguestfs will start by looking for a file called C or " "C and if it has the correct format, the contents of " @@ -9187,14 +11400,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1993 ../src/guestfs-actions.pod:2994 +#: ../fish/guestfish-actions.pod:2124 ../src/guestfs-actions.pod:3309 msgid "" "If finding the favicon fails, then we look in other places in the guest for " "a suitable icon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:2997 +#: ../fish/guestfish-actions.pod:2127 ../src/guestfs-actions.pod:3312 msgid "" "If the optional C boolean is true then only high quality icons " "are returned, which means only icons of high resolution with an alpha " @@ -9203,7 +11416,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2007 ../src/guestfs-actions.pod:3008 +#: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3323 msgid "" "Unlike most other inspection API calls, the guest's disks must be mounted up " "before you call this, since it needs to read information from the guest " @@ -9211,7 +11424,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2013 ../src/guestfs-actions.pod:3014 +#: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3329 msgid "" "B The icon data comes from the untrusted guest, and should be " "treated with caution. PNG files have been known to contain exploits. " @@ -9220,7 +11433,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2021 ../src/guestfs-actions.pod:3022 +#: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3337 msgid "" "The PNG image returned can be any size. It might not be square. Libguestfs " "tries to return the largest, highest quality icon available. The " @@ -9228,7 +11441,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2028 ../src/guestfs-actions.pod:3029 +#: ../fish/guestfish-actions.pod:2159 ../src/guestfs-actions.pod:3344 msgid "" "Extracting icons from Windows guests requires the external C " "program from the C package, and several programs (C, " @@ -9237,19 +11450,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2035 ../src/guestfs-actions.pod:3036 +#: ../fish/guestfish-actions.pod:2166 ../src/guestfs-actions.pod:3351 msgid "" "Operating system icons are usually trademarks. Seek legal advice before " "using trademarks in applications." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2042 +#: ../fish/guestfish-actions.pod:2173 msgid "inspect-get-major-version" msgstr "inspect-get-major-version" #. type: verbatim -#: ../fish/guestfish-actions.pod:2044 +#: ../fish/guestfish-actions.pod:2175 #, no-wrap msgid "" " inspect-get-major-version root\n" @@ -9259,13 +11472,13 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2046 ../src/guestfs-actions.pod:3077 +#: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3392 msgid "" "This returns the major version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2049 ../src/guestfs-actions.pod:3080 +#: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3395 msgid "" "Windows uses a consistent versioning scheme which is I reflected in the " "popular public names used by the operating system. Notably the operating " @@ -9275,18 +11488,18 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2056 ../fish/guestfish-actions.pod:2067 -#: ../src/guestfs-actions.pod:3087 ../src/guestfs-actions.pod:3104 +#: ../fish/guestfish-actions.pod:2187 ../fish/guestfish-actions.pod:2198 +#: ../src/guestfs-actions.pod:3402 ../src/guestfs-actions.pod:3419 msgid "If the version could not be determined, then C<0> is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2060 +#: ../fish/guestfish-actions.pod:2191 msgid "inspect-get-minor-version" msgstr "inspect-get-minor-version" #. type: verbatim -#: ../fish/guestfish-actions.pod:2062 +#: ../fish/guestfish-actions.pod:2193 #, no-wrap msgid "" " inspect-get-minor-version root\n" @@ -9296,25 +11509,25 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2064 ../src/guestfs-actions.pod:3101 +#: ../fish/guestfish-actions.pod:2195 ../src/guestfs-actions.pod:3416 msgid "" "This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2069 +#: ../fish/guestfish-actions.pod:2200 msgid "" "Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2072 +#: ../fish/guestfish-actions.pod:2203 msgid "inspect-get-mountpoints" msgstr "inspect-get-mountpoints" #. type: verbatim -#: ../fish/guestfish-actions.pod:2074 +#: ../fish/guestfish-actions.pod:2205 #, no-wrap msgid "" " inspect-get-mountpoints root\n" @@ -9324,7 +11537,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2076 ../src/guestfs-actions.pod:3119 +#: ../fish/guestfish-actions.pod:2207 ../src/guestfs-actions.pod:3434 msgid "" "This returns a hash of where we think the filesystems associated with this " "operating system should be mounted. Callers should note that this is at " @@ -9335,7 +11548,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2085 ../src/guestfs-actions.pod:3128 +#: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3443 msgid "" "Each element in the returned hashtable has a key which is the path of the " "mountpoint (eg. C) and a value which is the filesystem that would be " @@ -9343,13 +11556,13 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2090 ../src/guestfs-actions.pod:3133 +#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3448 msgid "" "Non-mounted devices such as swap devices are I returned in this list." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2093 +#: ../fish/guestfish-actions.pod:2224 msgid "" "For operating systems like Windows which still use drive letters, this call " "will only return an entry for the first drive \"mounted on\" C. For " @@ -9358,19 +11571,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2099 +#: ../fish/guestfish-actions.pod:2230 msgid "" "Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2102 +#: ../fish/guestfish-actions.pod:2233 msgid "inspect-get-package-format" msgstr "inspect-get-package-format" #. type: verbatim -#: ../fish/guestfish-actions.pod:2104 +#: ../fish/guestfish-actions.pod:2235 #, no-wrap msgid "" " inspect-get-package-format root\n" @@ -9380,7 +11593,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2106 +#: ../fish/guestfish-actions.pod:2237 msgid "" "This function and L return the package " "format and package management tool used by the inspected operating system. " @@ -9389,7 +11602,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2112 ../src/guestfs-actions.pod:3165 +#: ../fish/guestfish-actions.pod:2243 ../src/guestfs-actions.pod:3480 msgid "" "This returns the string C if we could not determine the package " "format I if the operating system does not have a real packaging system " @@ -9397,19 +11610,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2116 ../src/guestfs-actions.pod:3169 +#: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3484 msgid "" -"Possible strings include: C, C, C, C, C. " -"Future versions of libguestfs may return other strings." +"Possible strings include: C, C, C, C, C, " +"C. Future versions of libguestfs may return other strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2121 +#: ../fish/guestfish-actions.pod:2253 msgid "inspect-get-package-management" msgstr "inspect-get-package-management" #. type: verbatim -#: ../fish/guestfish-actions.pod:2123 +#: ../fish/guestfish-actions.pod:2255 #, no-wrap msgid "" " inspect-get-package-management root\n" @@ -9419,7 +11632,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2125 +#: ../fish/guestfish-actions.pod:2257 msgid "" "L and this function return the package format " "and package management tool used by the inspected operating system. For " @@ -9428,7 +11641,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2131 ../src/guestfs-actions.pod:3191 +#: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3507 msgid "" "This returns the string C if we could not determine the package " "management tool I if the operating system does not have a real packaging " @@ -9436,20 +11649,20 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2135 ../src/guestfs-actions.pod:3195 +#: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3511 msgid "" "Possible strings include: C, C, C (for all Debian " -"derivatives), C, C, C, C. Future versions of " -"libguestfs may return other strings." +"derivatives), C, C, C, C, C. Future " +"versions of libguestfs may return other strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2142 +#: ../fish/guestfish-actions.pod:2274 msgid "inspect-get-product-name" msgstr "inspect-get-product-name" #. type: verbatim -#: ../fish/guestfish-actions.pod:2144 +#: ../fish/guestfish-actions.pod:2276 #, no-wrap msgid "" " inspect-get-product-name root\n" @@ -9459,7 +11672,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2146 ../src/guestfs-actions.pod:3213 +#: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3529 msgid "" "This returns the product name of the inspected operating system. The " "product name is generally some freeform string which can be displayed to the " @@ -9467,19 +11680,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2151 ../src/guestfs-actions.pod:3218 +#: ../fish/guestfish-actions.pod:2283 ../src/guestfs-actions.pod:3534 msgid "" "If the product name could not be determined, then the string C is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2156 +#: ../fish/guestfish-actions.pod:2288 msgid "inspect-get-product-variant" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2158 +#: ../fish/guestfish-actions.pod:2290 #, no-wrap msgid "" " inspect-get-product-variant root\n" @@ -9487,12 +11700,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2160 ../src/guestfs-actions.pod:3234 +#: ../fish/guestfish-actions.pod:2292 ../src/guestfs-actions.pod:3550 msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2163 ../src/guestfs-actions.pod:3237 +#: ../fish/guestfish-actions.pod:2295 ../src/guestfs-actions.pod:3553 msgid "" "For Windows guests, this returns the contents of the Registry key C C which " @@ -9504,7 +11717,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2172 ../src/guestfs-actions.pod:3246 +#: ../fish/guestfish-actions.pod:2304 ../src/guestfs-actions.pod:3562 msgid "" "For enterprise Linux guests, in future we intend this to return the product " "variant such as C, C and so on. But this is not " @@ -9512,26 +11725,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2176 ../src/guestfs-actions.pod:3250 +#: ../fish/guestfish-actions.pod:2308 ../src/guestfs-actions.pod:3566 msgid "" "If the product variant could not be determined, then the string C " "is returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2179 +#: ../fish/guestfish-actions.pod:2311 msgid "" "Please read L for more details. See also L, L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2183 +#: ../fish/guestfish-actions.pod:2315 msgid "inspect-get-roots" msgstr "inspect-get-roots" #. type: verbatim -#: ../fish/guestfish-actions.pod:2185 +#: ../fish/guestfish-actions.pod:2317 #, no-wrap msgid "" " inspect-get-roots\n" @@ -9541,7 +11754,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2187 +#: ../fish/guestfish-actions.pod:2319 msgid "" "This function is a convenient way to get the list of root devices, as " "returned from a previous call to L, but without redoing the " @@ -9549,19 +11762,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2191 +#: ../fish/guestfish-actions.pod:2323 msgid "" "This returns an empty list if either no root devices were found or the " "caller has not called L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2196 +#: ../fish/guestfish-actions.pod:2328 msgid "inspect-get-type" msgstr "inspect-get-type" #. type: verbatim -#: ../fish/guestfish-actions.pod:2198 +#: ../fish/guestfish-actions.pod:2330 #, no-wrap msgid "" " inspect-get-type root\n" @@ -9571,49 +11784,69 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2200 ../src/guestfs-actions.pod:3288 +#: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3604 msgid "" "This returns the type of the inspected operating system. Currently defined " "types are:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2205 ../src/guestfs-actions.pod:3293 +#: ../fish/guestfish-actions.pod:2337 ../src/guestfs-actions.pod:3609 msgid "\"linux\"" msgstr "\"linux\"" #. type: textblock -#: ../fish/guestfish-actions.pod:2207 ../src/guestfs-actions.pod:3295 +#: ../fish/guestfish-actions.pod:2339 ../src/guestfs-actions.pod:3611 msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2211 ../src/guestfs-actions.pod:3299 +#: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3615 msgid "Any Microsoft Windows operating system." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2213 ../src/guestfs-actions.pod:3301 +#: ../fish/guestfish-actions.pod:2345 ../src/guestfs-actions.pod:3617 msgid "\"freebsd\"" msgstr "\"freebsd\"" #. type: textblock -#: ../fish/guestfish-actions.pod:2215 ../src/guestfs-actions.pod:3303 +#: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3619 msgid "FreeBSD." msgstr "FreeBSD." +#. type: =item +#: ../fish/guestfish-actions.pod:2349 ../src/guestfs-actions.pod:3621 +msgid "\"netbsd\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2351 ../src/guestfs-actions.pod:3623 +msgid "NetBSD." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:2353 ../src/guestfs-actions.pod:3625 +msgid "\"hurd\"" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3627 +msgid "GNU/Hurd." +msgstr "" + #. type: textblock -#: ../fish/guestfish-actions.pod:2219 ../src/guestfs-actions.pod:3307 +#: ../fish/guestfish-actions.pod:2359 ../src/guestfs-actions.pod:3631 msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2228 +#: ../fish/guestfish-actions.pod:2368 msgid "inspect-get-windows-current-control-set" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2230 +#: ../fish/guestfish-actions.pod:2370 #, no-wrap msgid "" " inspect-get-windows-current-control-set root\n" @@ -9621,26 +11854,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2232 ../src/guestfs-actions.pod:3327 +#: ../fish/guestfish-actions.pod:2372 ../src/guestfs-actions.pod:3651 msgid "" "This returns the Windows CurrentControlSet of the inspected guest. The " "CurrentControlSet is a registry key name such as C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2235 ../src/guestfs-actions.pod:3330 +#: ../fish/guestfish-actions.pod:2375 ../src/guestfs-actions.pod:3654 msgid "" "This call assumes that the guest is Windows and that the Registry could be " "examined by inspection. If this is not the case then an error is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2241 +#: ../fish/guestfish-actions.pod:2381 msgid "inspect-get-windows-systemroot" msgstr "inspect-get-windows-systemroot" #. type: verbatim -#: ../fish/guestfish-actions.pod:2243 +#: ../fish/guestfish-actions.pod:2383 #, no-wrap msgid "" " inspect-get-windows-systemroot root\n" @@ -9650,26 +11883,26 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2245 ../src/guestfs-actions.pod:3347 +#: ../fish/guestfish-actions.pod:2385 ../src/guestfs-actions.pod:3671 msgid "" "This returns the Windows systemroot of the inspected guest. The systemroot " "is a directory path such as C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2248 ../src/guestfs-actions.pod:3350 +#: ../fish/guestfish-actions.pod:2388 ../src/guestfs-actions.pod:3674 msgid "" "This call assumes that the guest is Windows and that the systemroot could be " "determined by inspection. If this is not the case then an error is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2254 +#: ../fish/guestfish-actions.pod:2394 msgid "inspect-is-live" msgstr "inspect-is-live" #. type: verbatim -#: ../fish/guestfish-actions.pod:2256 +#: ../fish/guestfish-actions.pod:2396 #, no-wrap msgid "" " inspect-is-live root\n" @@ -9679,19 +11912,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2258 +#: ../fish/guestfish-actions.pod:2398 msgid "" "If L returns C (this is an install disk), " "then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2264 +#: ../fish/guestfish-actions.pod:2404 msgid "inspect-is-multipart" msgstr "inspect-is-multipart" #. type: verbatim -#: ../fish/guestfish-actions.pod:2266 +#: ../fish/guestfish-actions.pod:2406 #, no-wrap msgid "" " inspect-is-multipart root\n" @@ -9701,19 +11934,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2268 +#: ../fish/guestfish-actions.pod:2408 msgid "" "If L returns C (this is an install disk), " "then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2274 +#: ../fish/guestfish-actions.pod:2414 msgid "inspect-is-netinst" msgstr "inspect-is-netinst" #. type: verbatim -#: ../fish/guestfish-actions.pod:2276 +#: ../fish/guestfish-actions.pod:2416 #, no-wrap msgid "" " inspect-is-netinst root\n" @@ -9723,7 +11956,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2278 +#: ../fish/guestfish-actions.pod:2418 msgid "" "If L returns C (this is an install disk), " "then this returns true if the disk is a network installer, ie. not a self-" @@ -9732,12 +11965,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2286 +#: ../fish/guestfish-actions.pod:2426 msgid "inspect-list-applications" msgstr "inspect-list-applications" #. type: verbatim -#: ../fish/guestfish-actions.pod:2288 +#: ../fish/guestfish-actions.pod:2428 #, no-wrap msgid "" " inspect-list-applications root\n" @@ -9747,12 +11980,12 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2290 ../src/guestfs-actions.pod:3417 +#: ../fish/guestfish-actions.pod:2430 ../src/guestfs-actions.pod:3741 msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2292 +#: ../fish/guestfish-actions.pod:2432 msgid "" "I This call works differently from other parts of the inspection " "API. You have to call L, then L, " @@ -9764,91 +11997,91 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2302 ../src/guestfs-actions.pod:3429 +#: ../fish/guestfish-actions.pod:2442 ../src/guestfs-actions.pod:3753 msgid "" "This returns an empty list if the inspection code was not able to determine " "the list of applications." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2305 ../src/guestfs-actions.pod:3432 +#: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3756 msgid "The application structure contains the following fields:" msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2309 ../src/guestfs-actions.pod:3436 +#: ../fish/guestfish-actions.pod:2449 ../src/guestfs-actions.pod:3760 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2311 ../src/guestfs-actions.pod:3438 +#: ../fish/guestfish-actions.pod:2451 ../src/guestfs-actions.pod:3762 msgid "" "The name of the application. For Red Hat-derived and Debian-derived Linux " "guests, this is the package name." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2314 ../src/guestfs-actions.pod:3441 +#: ../fish/guestfish-actions.pod:2454 ../src/guestfs-actions.pod:3765 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2316 ../src/guestfs-actions.pod:3443 +#: ../fish/guestfish-actions.pod:2456 ../src/guestfs-actions.pod:3767 msgid "" "The display name of the application, sometimes localized to the install " "language of the guest operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2319 ../src/guestfs-actions.pod:3446 +#: ../fish/guestfish-actions.pod:2459 ../src/guestfs-actions.pod:3770 msgid "" "If unavailable this is returned as an empty string C<\"\">. Callers needing " "to display something can use C instead." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2322 ../src/guestfs-actions.pod:3449 +#: ../fish/guestfish-actions.pod:2462 ../src/guestfs-actions.pod:3773 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2324 ../src/guestfs-actions.pod:3451 +#: ../fish/guestfish-actions.pod:2464 ../src/guestfs-actions.pod:3775 msgid "" "For package managers which use epochs, this contains the epoch of the " "package (an integer). If unavailable, this is returned as C<0>." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2327 ../src/guestfs-actions.pod:3454 +#: ../fish/guestfish-actions.pod:2467 ../src/guestfs-actions.pod:3778 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2329 ../src/guestfs-actions.pod:3456 +#: ../fish/guestfish-actions.pod:2469 ../src/guestfs-actions.pod:3780 msgid "" "The version string of the application or package. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3459 +#: ../fish/guestfish-actions.pod:2472 ../src/guestfs-actions.pod:3783 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2334 ../src/guestfs-actions.pod:3461 +#: ../fish/guestfish-actions.pod:2474 ../src/guestfs-actions.pod:3785 msgid "" "The release string of the application or package, for package managers that " "use this. If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2338 ../src/guestfs-actions.pod:3465 +#: ../fish/guestfish-actions.pod:2478 ../src/guestfs-actions.pod:3789 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2340 ../src/guestfs-actions.pod:3467 +#: ../fish/guestfish-actions.pod:2480 ../src/guestfs-actions.pod:3791 msgid "" "The installation path of the application (on operating systems such as " "Windows which use installation paths). This path is in the format used by " @@ -9856,89 +12089,89 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2345 ../src/guestfs-actions.pod:3472 +#: ../fish/guestfish-actions.pod:2485 ../src/guestfs-actions.pod:3796 msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3474 +#: ../fish/guestfish-actions.pod:2487 ../src/guestfs-actions.pod:3798 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2349 ../src/guestfs-actions.pod:3476 +#: ../fish/guestfish-actions.pod:2489 ../src/guestfs-actions.pod:3800 msgid "" "The install path translated into a libguestfs path. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2352 ../src/guestfs-actions.pod:3479 +#: ../fish/guestfish-actions.pod:2492 ../src/guestfs-actions.pod:3803 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2354 ../src/guestfs-actions.pod:3481 +#: ../fish/guestfish-actions.pod:2494 ../src/guestfs-actions.pod:3805 msgid "" "The name of the publisher of the application, for package managers that use " "this. If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2358 ../src/guestfs-actions.pod:3485 +#: ../fish/guestfish-actions.pod:2498 ../src/guestfs-actions.pod:3809 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2360 ../src/guestfs-actions.pod:3487 +#: ../fish/guestfish-actions.pod:2500 ../src/guestfs-actions.pod:3811 msgid "" "The URL (eg. upstream URL) of the application. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2363 ../src/guestfs-actions.pod:3490 +#: ../fish/guestfish-actions.pod:2503 ../src/guestfs-actions.pod:3814 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2365 ../src/guestfs-actions.pod:3492 +#: ../fish/guestfish-actions.pod:2505 ../src/guestfs-actions.pod:3816 msgid "" "For packaging systems which support this, the name of the source package. " "If unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2368 ../src/guestfs-actions.pod:3495 +#: ../fish/guestfish-actions.pod:2508 ../src/guestfs-actions.pod:3819 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2370 ../src/guestfs-actions.pod:3497 +#: ../fish/guestfish-actions.pod:2510 ../src/guestfs-actions.pod:3821 msgid "" "A short (usually one line) description of the application or package. If " "unavailable this is returned as an empty string C<\"\">." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2373 ../src/guestfs-actions.pod:3500 +#: ../fish/guestfish-actions.pod:2513 ../src/guestfs-actions.pod:3824 msgid "C" msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:2375 ../src/guestfs-actions.pod:3502 +#: ../fish/guestfish-actions.pod:2515 ../src/guestfs-actions.pod:3826 msgid "" "A longer description of the application or package. If unavailable this is " "returned as an empty string C<\"\">." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2382 +#: ../fish/guestfish-actions.pod:2522 msgid "inspect-os" msgstr "inspect-os" #. type: verbatim -#: ../fish/guestfish-actions.pod:2384 +#: ../fish/guestfish-actions.pod:2524 #, no-wrap msgid "" " inspect-os\n" @@ -9948,7 +12181,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2386 ../src/guestfs-actions.pod:3520 +#: ../fish/guestfish-actions.pod:2526 ../src/guestfs-actions.pod:3844 msgid "" "This function uses other libguestfs functions and certain heuristics to " "inspect the disk(s) (usually disks belonging to a virtual machine), looking " @@ -9956,12 +12189,12 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2390 ../src/guestfs-actions.pod:3524 +#: ../fish/guestfish-actions.pod:2530 ../src/guestfs-actions.pod:3848 msgid "The list returned is empty if no operating systems were found." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2392 ../src/guestfs-actions.pod:3526 +#: ../fish/guestfish-actions.pod:2532 ../src/guestfs-actions.pod:3850 msgid "" "If one operating system was found, then this returns a list with a single " "element, which is the name of the root filesystem of this operating system. " @@ -9971,7 +12204,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2399 +#: ../fish/guestfish-actions.pod:2539 msgid "" "You can pass the root string(s) returned to other L " "functions in order to query further information about each operating system, " @@ -9979,7 +12212,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2404 +#: ../fish/guestfish-actions.pod:2544 msgid "" "This function uses other libguestfs features such as L and L in order to mount and unmount filesystems and look at the " @@ -9988,25 +12221,25 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2410 ../src/guestfs-actions.pod:3544 +#: ../fish/guestfish-actions.pod:2550 ../src/guestfs-actions.pod:3868 msgid "" "This function cannot decrypt encrypted disks. The caller must do that first " "(supplying the necessary keys) if the disk is encrypted." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2416 ../fish/guestfish-actions.pod:2614 -#: ../fish/guestfish-actions.pod:2673 +#: ../fish/guestfish-actions.pod:2556 ../fish/guestfish-actions.pod:2754 +#: ../fish/guestfish-actions.pod:2819 msgid "See also L." msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2418 +#: ../fish/guestfish-actions.pod:2558 msgid "is-blockdev" msgstr "is-blockdev" #. type: verbatim -#: ../fish/guestfish-actions.pod:2420 +#: ../fish/guestfish-actions.pod:2560 #, no-wrap msgid "" " is-blockdev path\n" @@ -10016,27 +12249,27 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2422 ../src/guestfs-actions.pod:3564 +#: ../fish/guestfish-actions.pod:2562 ../src/guestfs-actions.pod:3888 msgid "" "This returns C if and only if there is a block device with the given " "C name." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2425 ../fish/guestfish-actions.pod:2443 -#: ../fish/guestfish-actions.pod:2462 ../fish/guestfish-actions.pod:2471 -#: ../fish/guestfish-actions.pod:2481 ../fish/guestfish-actions.pod:2515 -#: ../fish/guestfish-actions.pod:2524 +#: ../fish/guestfish-actions.pod:2565 ../fish/guestfish-actions.pod:2583 +#: ../fish/guestfish-actions.pod:2602 ../fish/guestfish-actions.pod:2611 +#: ../fish/guestfish-actions.pod:2621 ../fish/guestfish-actions.pod:2655 +#: ../fish/guestfish-actions.pod:2664 msgid "See also L." msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2427 +#: ../fish/guestfish-actions.pod:2567 msgid "is-busy" msgstr "is-busy" #. type: verbatim -#: ../fish/guestfish-actions.pod:2429 +#: ../fish/guestfish-actions.pod:2569 #, no-wrap msgid "" " is-busy\n" @@ -10046,19 +12279,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2431 ../src/guestfs-actions.pod:3578 +#: ../fish/guestfish-actions.pod:2571 ../src/guestfs-actions.pod:3902 msgid "" "This returns true iff this handle is busy processing a command (in the " "C state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2436 +#: ../fish/guestfish-actions.pod:2576 msgid "is-chardev" msgstr "is-chardev" #. type: verbatim -#: ../fish/guestfish-actions.pod:2438 +#: ../fish/guestfish-actions.pod:2578 #, no-wrap msgid "" " is-chardev path\n" @@ -10068,19 +12301,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2440 ../src/guestfs-actions.pod:3593 +#: ../fish/guestfish-actions.pod:2580 ../src/guestfs-actions.pod:3917 msgid "" "This returns C if and only if there is a character device with the " "given C name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2445 +#: ../fish/guestfish-actions.pod:2585 msgid "is-config" msgstr "is-config" #. type: verbatim -#: ../fish/guestfish-actions.pod:2447 +#: ../fish/guestfish-actions.pod:2587 #, no-wrap msgid "" " is-config\n" @@ -10090,19 +12323,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2449 ../src/guestfs-actions.pod:3607 +#: ../fish/guestfish-actions.pod:2589 ../src/guestfs-actions.pod:3931 msgid "" "This returns true iff this handle is being configured (in the C " "state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2454 +#: ../fish/guestfish-actions.pod:2594 msgid "is-dir" msgstr "is-dir" #. type: verbatim -#: ../fish/guestfish-actions.pod:2456 +#: ../fish/guestfish-actions.pod:2596 #, no-wrap msgid "" " is-dir path\n" @@ -10112,19 +12345,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3622 +#: ../fish/guestfish-actions.pod:2598 ../src/guestfs-actions.pod:3946 msgid "" "This returns C if and only if there is a directory with the given " "C name. Note that it returns false for other objects like files." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2464 +#: ../fish/guestfish-actions.pod:2604 msgid "is-fifo" msgstr "is-fifo" #. type: verbatim -#: ../fish/guestfish-actions.pod:2466 +#: ../fish/guestfish-actions.pod:2606 #, no-wrap msgid "" " is-fifo path\n" @@ -10134,19 +12367,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2468 ../src/guestfs-actions.pod:3638 +#: ../fish/guestfish-actions.pod:2608 ../src/guestfs-actions.pod:3962 msgid "" "This returns C if and only if there is a FIFO (named pipe) with the " "given C name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2473 +#: ../fish/guestfish-actions.pod:2613 msgid "is-file" msgstr "is-file" #. type: verbatim -#: ../fish/guestfish-actions.pod:2475 +#: ../fish/guestfish-actions.pod:2615 #, no-wrap msgid "" " is-file path\n" @@ -10156,19 +12389,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2477 ../src/guestfs-actions.pod:3653 +#: ../fish/guestfish-actions.pod:2617 ../src/guestfs-actions.pod:3977 msgid "" "This returns C if and only if there is a regular file with the given " "C name. Note that it returns false for other objects like directories." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2483 +#: ../fish/guestfish-actions.pod:2623 msgid "is-launching" msgstr "is-launching" #. type: verbatim -#: ../fish/guestfish-actions.pod:2485 +#: ../fish/guestfish-actions.pod:2625 #, no-wrap msgid "" " is-launching\n" @@ -10178,19 +12411,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2487 ../src/guestfs-actions.pod:3668 +#: ../fish/guestfish-actions.pod:2627 ../src/guestfs-actions.pod:3992 msgid "" "This returns true iff this handle is launching the subprocess (in the " "C state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2492 +#: ../fish/guestfish-actions.pod:2632 msgid "is-lv" msgstr "is-lv" #. type: verbatim -#: ../fish/guestfish-actions.pod:2494 +#: ../fish/guestfish-actions.pod:2634 #, no-wrap msgid "" " is-lv device\n" @@ -10200,19 +12433,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2496 ../src/guestfs-actions.pod:3683 +#: ../fish/guestfish-actions.pod:2636 ../src/guestfs-actions.pod:4007 msgid "" "This command tests whether C is a logical volume, and returns true " "iff this is the case." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2499 +#: ../fish/guestfish-actions.pod:2639 msgid "is-ready" msgstr "is-ready" #. type: verbatim -#: ../fish/guestfish-actions.pod:2501 +#: ../fish/guestfish-actions.pod:2641 #, no-wrap msgid "" " is-ready\n" @@ -10222,19 +12455,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2503 ../src/guestfs-actions.pod:3695 +#: ../fish/guestfish-actions.pod:2643 ../src/guestfs-actions.pod:4019 msgid "" "This returns true iff this handle is ready to accept commands (in the " "C state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2508 +#: ../fish/guestfish-actions.pod:2648 msgid "is-socket" msgstr "is-socket" #. type: verbatim -#: ../fish/guestfish-actions.pod:2510 +#: ../fish/guestfish-actions.pod:2650 #, no-wrap msgid "" " is-socket path\n" @@ -10244,19 +12477,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2512 ../src/guestfs-actions.pod:3710 +#: ../fish/guestfish-actions.pod:2652 ../src/guestfs-actions.pod:4034 msgid "" "This returns C if and only if there is a Unix domain socket with the " "given C name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2517 +#: ../fish/guestfish-actions.pod:2657 msgid "is-symlink" msgstr "is-symlink" #. type: verbatim -#: ../fish/guestfish-actions.pod:2519 +#: ../fish/guestfish-actions.pod:2659 #, no-wrap msgid "" " is-symlink path\n" @@ -10266,19 +12499,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2521 ../src/guestfs-actions.pod:3725 +#: ../fish/guestfish-actions.pod:2661 ../src/guestfs-actions.pod:4049 msgid "" "This returns C if and only if there is a symbolic link with the given " "C name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2526 +#: ../fish/guestfish-actions.pod:2666 msgid "is-zero" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2528 +#: ../fish/guestfish-actions.pod:2668 #, no-wrap msgid "" " is-zero path\n" @@ -10286,19 +12519,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2530 ../src/guestfs-actions.pod:3740 +#: ../fish/guestfish-actions.pod:2670 ../src/guestfs-actions.pod:4064 msgid "" "This returns true iff the file exists and the file is empty or it contains " "all zero bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2533 +#: ../fish/guestfish-actions.pod:2673 msgid "is-zero-device" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2535 +#: ../fish/guestfish-actions.pod:2675 #, no-wrap msgid "" " is-zero-device device\n" @@ -10306,22 +12539,22 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2537 ../src/guestfs-actions.pod:3753 +#: ../fish/guestfish-actions.pod:2677 ../src/guestfs-actions.pod:4077 msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2539 ../src/guestfs-actions.pod:3755 +#: ../fish/guestfish-actions.pod:2679 ../src/guestfs-actions.pod:4079 msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2541 +#: ../fish/guestfish-actions.pod:2681 msgid "kill-subprocess" msgstr "kill-subprocess" #. type: verbatim -#: ../fish/guestfish-actions.pod:2543 +#: ../fish/guestfish-actions.pod:2683 #, no-wrap msgid "" " kill-subprocess\n" @@ -10331,22 +12564,22 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2545 ../src/guestfs-actions.pod:3766 +#: ../fish/guestfish-actions.pod:2685 ../src/guestfs-actions.pod:4090 msgid "This kills the qemu subprocess. You should never need to call this." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2547 +#: ../fish/guestfish-actions.pod:2687 msgid "launch" msgstr "launch" #. type: =head2 -#: ../fish/guestfish-actions.pod:2549 +#: ../fish/guestfish-actions.pod:2689 msgid "run" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2551 +#: ../fish/guestfish-actions.pod:2691 #, no-wrap msgid "" " launch\n" @@ -10356,26 +12589,26 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2553 ../src/guestfs-actions.pod:3777 +#: ../fish/guestfish-actions.pod:2693 ../src/guestfs-actions.pod:4101 msgid "" "Internally libguestfs is implemented by running a virtual machine using " "L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2556 ../src/guestfs-actions.pod:3780 +#: ../fish/guestfish-actions.pod:2696 ../src/guestfs-actions.pod:4104 msgid "" "You should call this after configuring the handle (eg. adding drives) but " "before performing any actions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2559 +#: ../fish/guestfish-actions.pod:2699 msgid "lchown" msgstr "lchown" #. type: verbatim -#: ../fish/guestfish-actions.pod:2561 +#: ../fish/guestfish-actions.pod:2701 #, no-wrap msgid "" " lchown owner group path\n" @@ -10385,7 +12618,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2563 +#: ../fish/guestfish-actions.pod:2703 msgid "" "Change the file owner to C and group to C. This is like L but if C is a symlink then the link itself is changed, not the " @@ -10393,12 +12626,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2571 +#: ../fish/guestfish-actions.pod:2711 msgid "lgetxattr" msgstr "lgetxattr" #. type: verbatim -#: ../fish/guestfish-actions.pod:2573 +#: ../fish/guestfish-actions.pod:2713 #, no-wrap msgid "" " lgetxattr path name\n" @@ -10408,24 +12641,24 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2575 ../src/guestfs-actions.pod:3820 +#: ../fish/guestfish-actions.pod:2715 ../src/guestfs-actions.pod:4144 msgid "" "Get a single extended attribute from file C named C. If C " "is a symlink, then this call returns an extended attribute from the symlink." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2589 +#: ../fish/guestfish-actions.pod:2729 msgid "See also: L, L, L." msgstr "Див. також L, L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2591 +#: ../fish/guestfish-actions.pod:2731 msgid "lgetxattrs" msgstr "lgetxattrs" #. type: verbatim -#: ../fish/guestfish-actions.pod:2593 +#: ../fish/guestfish-actions.pod:2733 #, no-wrap msgid "" " lgetxattrs path\n" @@ -10435,19 +12668,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2595 +#: ../fish/guestfish-actions.pod:2735 msgid "" "This is the same as L, but if C is a symbolic link, then " "it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2599 +#: ../fish/guestfish-actions.pod:2739 msgid "list-9p" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2601 +#: ../fish/guestfish-actions.pod:2741 #, no-wrap msgid "" " list-9p\n" @@ -10455,19 +12688,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2603 ../src/guestfs-actions.pod:3863 +#: ../fish/guestfish-actions.pod:2743 ../src/guestfs-actions.pod:4187 msgid "" "List all 9p filesystems attached to the guest. A list of mount tags is " "returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2606 +#: ../fish/guestfish-actions.pod:2746 msgid "list-devices" msgstr "list-devices" #. type: verbatim -#: ../fish/guestfish-actions.pod:2608 +#: ../fish/guestfish-actions.pod:2748 #, no-wrap msgid "" " list-devices\n" @@ -10477,22 +12710,22 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2610 ../src/guestfs-actions.pod:3877 +#: ../fish/guestfish-actions.pod:2750 ../src/guestfs-actions.pod:4201 msgid "List all the block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2612 ../src/guestfs-actions.pod:3879 +#: ../fish/guestfish-actions.pod:2752 ../src/guestfs-actions.pod:4203 msgid "The full block device names are returned, eg. C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2616 +#: ../fish/guestfish-actions.pod:2756 msgid "list-dm-devices" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2618 +#: ../fish/guestfish-actions.pod:2758 #, no-wrap msgid "" " list-dm-devices\n" @@ -10500,31 +12733,31 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2620 ../src/guestfs-actions.pod:3894 +#: ../fish/guestfish-actions.pod:2760 ../src/guestfs-actions.pod:4218 msgid "List all device mapper devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2622 +#: ../fish/guestfish-actions.pod:2762 msgid "" "The returned list contains C devices, eg. ones created by a " "previous call to L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2625 +#: ../fish/guestfish-actions.pod:2765 msgid "" "Device mapper devices which correspond to logical volumes are I " "returned in this list. Call L if you want to list logical volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2629 +#: ../fish/guestfish-actions.pod:2769 msgid "list-filesystems" msgstr "list-filesystems" #. type: verbatim -#: ../fish/guestfish-actions.pod:2631 +#: ../fish/guestfish-actions.pod:2771 #, no-wrap msgid "" " list-filesystems\n" @@ -10534,7 +12767,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2633 ../src/guestfs-actions.pod:3914 +#: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4238 msgid "" "This inspection command looks for filesystems on partitions, block devices " "and logical volumes, returning a list of devices containing filesystems and " @@ -10542,14 +12775,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2637 ../src/guestfs-actions.pod:3918 +#: ../fish/guestfish-actions.pod:2777 ../src/guestfs-actions.pod:4242 msgid "" "The return value is a hash, where the keys are the devices containing " "filesystems, and the values are the filesystem types. For example:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2641 ../src/guestfs-actions.pod:3922 +#: ../fish/guestfish-actions.pod:2781 ../src/guestfs-actions.pod:4246 #, no-wrap msgid "" " \"/dev/sda1\" => \"ntfs\"\n" @@ -10560,14 +12793,14 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2646 ../src/guestfs-actions.pod:3927 +#: ../fish/guestfish-actions.pod:2786 ../src/guestfs-actions.pod:4251 msgid "" "The value can have the special value \"unknown\", meaning the content of the " "device is undetermined or empty. \"swap\" means a Linux swap partition." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2650 +#: ../fish/guestfish-actions.pod:2790 msgid "" "This command runs other libguestfs commands, which might include L " "and L, and therefore you should use this soon after launch and only " @@ -10575,7 +12808,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2654 +#: ../fish/guestfish-actions.pod:2794 msgid "" "Not all of the filesystems returned will be mountable. In particular, swap " "partitions are returned in the list. Also this command does not check that " @@ -10585,12 +12818,37 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2662 +#: ../fish/guestfish-actions.pod:2802 +#, fuzzy +#| msgid "list-devices" +msgid "list-md-devices" +msgstr "list-devices" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:2804 +#, fuzzy, no-wrap +#| msgid "" +#| " list-devices\n" +#| "\n" +msgid "" +" list-md-devices\n" +"\n" +msgstr "" +" list-devices\n" +"\n" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2806 ../src/guestfs-actions.pod:4280 +msgid "List all Linux md devices." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:2808 msgid "list-partitions" msgstr "list-partitions" #. type: verbatim -#: ../fish/guestfish-actions.pod:2664 +#: ../fish/guestfish-actions.pod:2810 #, no-wrap msgid "" " list-partitions\n" @@ -10600,29 +12858,29 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2666 ../src/guestfs-actions.pod:3956 +#: ../fish/guestfish-actions.pod:2812 ../src/guestfs-actions.pod:4293 msgid "List all the partitions detected on all block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2668 ../src/guestfs-actions.pod:3958 +#: ../fish/guestfish-actions.pod:2814 ../src/guestfs-actions.pod:4295 msgid "The full partition device names are returned, eg. C" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2670 +#: ../fish/guestfish-actions.pod:2816 msgid "" "This does not return logical volumes. For that you will need to call L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2675 +#: ../fish/guestfish-actions.pod:2821 msgid "ll" msgstr "ll" #. type: verbatim -#: ../fish/guestfish-actions.pod:2677 +#: ../fish/guestfish-actions.pod:2823 #, no-wrap msgid "" " ll directory\n" @@ -10632,26 +12890,26 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2679 ../src/guestfs-actions.pod:3977 +#: ../fish/guestfish-actions.pod:2825 ../src/guestfs-actions.pod:4314 msgid "" "List the files in C (relative to the root directory, there is no " "cwd) in the format of 'ls -la'." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2682 ../src/guestfs-actions.pod:3980 +#: ../fish/guestfish-actions.pod:2828 ../src/guestfs-actions.pod:4317 msgid "" "This command is mostly useful for interactive sessions. It is I " "intended that you try to parse the output string." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2685 +#: ../fish/guestfish-actions.pod:2831 msgid "ln" msgstr "ln" #. type: verbatim -#: ../fish/guestfish-actions.pod:2687 +#: ../fish/guestfish-actions.pod:2833 #, no-wrap msgid "" " ln target linkname\n" @@ -10661,17 +12919,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2689 ../src/guestfs-actions.pod:3995 +#: ../fish/guestfish-actions.pod:2835 ../src/guestfs-actions.pod:4332 msgid "This command creates a hard link using the C command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2691 +#: ../fish/guestfish-actions.pod:2837 msgid "ln-f" msgstr "ln-f" #. type: verbatim -#: ../fish/guestfish-actions.pod:2693 +#: ../fish/guestfish-actions.pod:2839 #, no-wrap msgid "" " ln-f target linkname\n" @@ -10681,19 +12939,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2695 ../src/guestfs-actions.pod:4008 +#: ../fish/guestfish-actions.pod:2841 ../src/guestfs-actions.pod:4345 msgid "" "This command creates a hard link using the C command. The I<-f> " "option removes the link (C) if it exists already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2698 +#: ../fish/guestfish-actions.pod:2844 msgid "ln-s" msgstr "ln-s" #. type: verbatim -#: ../fish/guestfish-actions.pod:2700 +#: ../fish/guestfish-actions.pod:2846 #, no-wrap msgid "" " ln-s target linkname\n" @@ -10703,17 +12961,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2702 ../src/guestfs-actions.pod:4022 +#: ../fish/guestfish-actions.pod:2848 ../src/guestfs-actions.pod:4359 msgid "This command creates a symbolic link using the C command." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2704 +#: ../fish/guestfish-actions.pod:2850 msgid "ln-sf" msgstr "ln-sf" #. type: verbatim -#: ../fish/guestfish-actions.pod:2706 +#: ../fish/guestfish-actions.pod:2852 #, no-wrap msgid "" " ln-sf target linkname\n" @@ -10723,19 +12981,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2708 ../src/guestfs-actions.pod:4035 +#: ../fish/guestfish-actions.pod:2854 ../src/guestfs-actions.pod:4372 msgid "" "This command creates a symbolic link using the C command, The I<-f> " "option removes the link (C) if it exists already." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2711 +#: ../fish/guestfish-actions.pod:2857 msgid "lremovexattr" msgstr "lremovexattr" #. type: verbatim -#: ../fish/guestfish-actions.pod:2713 +#: ../fish/guestfish-actions.pod:2859 #, no-wrap msgid "" " lremovexattr xattr path\n" @@ -10743,19 +13001,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2715 +#: ../fish/guestfish-actions.pod:2861 msgid "" "This is the same as L, but if C is a symbolic link, then " "it removes an extended attribute of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2719 +#: ../fish/guestfish-actions.pod:2865 msgid "ls" msgstr "ls" #. type: verbatim -#: ../fish/guestfish-actions.pod:2721 +#: ../fish/guestfish-actions.pod:2867 #, no-wrap msgid "" " ls directory\n" @@ -10765,26 +13023,26 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2723 ../src/guestfs-actions.pod:4063 +#: ../fish/guestfish-actions.pod:2869 ../src/guestfs-actions.pod:4400 msgid "" "List the files in C (relative to the root directory, there is no " "cwd). The '.' and '..' entries are not returned, but hidden files are shown." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2727 +#: ../fish/guestfish-actions.pod:2873 msgid "" "This command is mostly useful for interactive sessions. Programs should " "probably use L instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2730 +#: ../fish/guestfish-actions.pod:2876 msgid "lsetxattr" msgstr "lsetxattr" #. type: verbatim -#: ../fish/guestfish-actions.pod:2732 +#: ../fish/guestfish-actions.pod:2878 #, no-wrap msgid "" " lsetxattr xattr val vallen path\n" @@ -10792,19 +13050,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2734 +#: ../fish/guestfish-actions.pod:2880 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:2738 +#: ../fish/guestfish-actions.pod:2884 msgid "lstat" msgstr "lstat" #. type: verbatim -#: ../fish/guestfish-actions.pod:2740 +#: ../fish/guestfish-actions.pod:2886 #, no-wrap msgid "" " lstat path\n" @@ -10814,30 +13072,30 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2742 ../fish/guestfish-actions.pod:4562 -#: ../src/guestfs-actions.pod:4099 ../src/guestfs-actions.pod:6892 +#: ../fish/guestfish-actions.pod:2888 ../fish/guestfish-actions.pod:4786 +#: ../src/guestfs-actions.pod:4436 ../src/guestfs-actions.pod:7366 msgid "Returns file information for the given C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2744 +#: ../fish/guestfish-actions.pod:2890 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:2748 ../src/guestfs-actions.pod:4105 +#: ../fish/guestfish-actions.pod:2894 ../src/guestfs-actions.pod:4442 msgid "This is the same as the C system call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2750 +#: ../fish/guestfish-actions.pod:2896 msgid "lstatlist" msgstr "lstatlist" #. type: verbatim -#: ../fish/guestfish-actions.pod:2752 +#: ../fish/guestfish-actions.pod:2898 #, no-wrap msgid "" " lstatlist path 'names ...'\n" @@ -10845,7 +13103,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2754 +#: ../fish/guestfish-actions.pod:2900 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 " @@ -10853,7 +13111,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2758 ../src/guestfs-actions.pod:4124 +#: ../fish/guestfish-actions.pod:2904 ../src/guestfs-actions.pod:4461 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, " @@ -10861,7 +13119,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2763 +#: ../fish/guestfish-actions.pod:2909 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 " @@ -10872,12 +13130,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2771 +#: ../fish/guestfish-actions.pod:2917 msgid "luks-add-key" msgstr "luks-add-key" #. type: verbatim -#: ../fish/guestfish-actions.pod:2773 +#: ../fish/guestfish-actions.pod:2919 #, no-wrap msgid "" " luks-add-key device keyslot\n" @@ -10885,7 +13143,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2775 ../src/guestfs-actions.pod:4152 +#: ../fish/guestfish-actions.pod:2921 ../src/guestfs-actions.pod:4489 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 " @@ -10893,28 +13151,28 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2780 +#: ../fish/guestfish-actions.pod:2926 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: textblock -#: ../fish/guestfish-actions.pod:2784 ../fish/guestfish-actions.pod:2806 -#: ../fish/guestfish-actions.pod:2819 ../fish/guestfish-actions.pod:2833 -#: ../fish/guestfish-actions.pod:2859 ../fish/guestfish-actions.pod:2869 +#: ../fish/guestfish-actions.pod:2930 ../fish/guestfish-actions.pod:2952 +#: ../fish/guestfish-actions.pod:2962 ../fish/guestfish-actions.pod:2973 +#: ../fish/guestfish-actions.pod:2999 ../fish/guestfish-actions.pod:3009 msgid "" "This command has one or more key or passphrase parameters. Guestfish will " "prompt for these separately." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2787 +#: ../fish/guestfish-actions.pod:2933 msgid "luks-close" msgstr "luks-close" #. type: verbatim -#: ../fish/guestfish-actions.pod:2789 +#: ../fish/guestfish-actions.pod:2935 #, no-wrap msgid "" " luks-close device\n" @@ -10924,7 +13182,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2791 +#: ../fish/guestfish-actions.pod:2937 msgid "" "This closes a LUKS device that was created earlier by L or L. The C parameter must be the name of the LUKS mapping " @@ -10933,12 +13191,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2797 +#: ../fish/guestfish-actions.pod:2943 msgid "luks-format" msgstr "luks-format" #. type: verbatim -#: ../fish/guestfish-actions.pod:2799 +#: ../fish/guestfish-actions.pod:2945 #, no-wrap msgid "" " luks-format device keyslot\n" @@ -10946,35 +13204,20 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2801 ../src/guestfs-actions.pod:4193 +#: ../fish/guestfish-actions.pod:2947 ../src/guestfs-actions.pod:4530 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 " "slot C. (LUKS supports 8 key slots, numbered 0-7)." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2809 ../fish/guestfish-actions.pod:2822 -#: ../fish/guestfish-actions.pod:2909 ../fish/guestfish-actions.pod:3570 -#: ../fish/guestfish-actions.pod:4096 ../fish/guestfish-actions.pod:4433 -#: ../fish/guestfish-actions.pod:4456 ../fish/guestfish-actions.pod:4478 -#: ../fish/guestfish-actions.pod:5224 ../src/guestfs-actions.pod:4200 -#: ../src/guestfs-actions.pod:4223 ../src/guestfs-actions.pod:4366 -#: ../src/guestfs-actions.pod:5469 ../src/guestfs-actions.pod:6257 -#: ../src/guestfs-actions.pod:6706 ../src/guestfs-actions.pod:6736 -#: ../src/guestfs-actions.pod:6769 ../src/guestfs-actions.pod:7968 -msgid "" -"B." -msgstr "" - #. type: =head2 -#: ../fish/guestfish-actions.pod:2812 +#: ../fish/guestfish-actions.pod:2955 msgid "luks-format-cipher" msgstr "luks-format-cipher" #. type: verbatim -#: ../fish/guestfish-actions.pod:2814 +#: ../fish/guestfish-actions.pod:2957 #, no-wrap msgid "" " luks-format-cipher device keyslot cipher\n" @@ -10982,19 +13225,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2816 +#: ../fish/guestfish-actions.pod:2959 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:2825 +#: ../fish/guestfish-actions.pod:2965 msgid "luks-kill-slot" msgstr "luks-kill-slot" #. type: verbatim -#: ../fish/guestfish-actions.pod:2827 +#: ../fish/guestfish-actions.pod:2967 #, no-wrap msgid "" " luks-kill-slot device keyslot\n" @@ -11002,19 +13245,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2829 ../src/guestfs-actions.pod:4240 +#: ../fish/guestfish-actions.pod:2969 ../src/guestfs-actions.pod:4571 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:2836 +#: ../fish/guestfish-actions.pod:2976 msgid "luks-open" msgstr "luks-open" #. type: verbatim -#: ../fish/guestfish-actions.pod:2838 +#: ../fish/guestfish-actions.pod:2978 #, no-wrap msgid "" " luks-open device mapname\n" @@ -11022,26 +13265,26 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2840 ../src/guestfs-actions.pod:4260 +#: ../fish/guestfish-actions.pod:2980 ../src/guestfs-actions.pod:4591 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:2843 ../src/guestfs-actions.pod:4263 +#: ../fish/guestfish-actions.pod:2983 ../src/guestfs-actions.pod:4594 msgid "C is the encrypted block device or partition." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2845 ../src/guestfs-actions.pod:4265 +#: ../fish/guestfish-actions.pod:2985 ../src/guestfs-actions.pod:4596 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:2848 ../src/guestfs-actions.pod:4268 +#: ../fish/guestfish-actions.pod:2988 ../src/guestfs-actions.pod:4599 msgid "" "This creates a new block device called C. Reads and " "writes to this block device are decrypted from and encrypted to the " @@ -11049,24 +13292,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2852 +#: ../fish/guestfish-actions.pod:2992 msgid "" "If this block device contains LVM volume groups, then calling L " "followed by L will make them visible." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2856 +#: ../fish/guestfish-actions.pod:2996 msgid "Use L to list all device mapper devices." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2862 +#: ../fish/guestfish-actions.pod:3002 msgid "luks-open-ro" msgstr "luks-open-ro" #. type: verbatim -#: ../fish/guestfish-actions.pod:2864 +#: ../fish/guestfish-actions.pod:3004 #, no-wrap msgid "" " luks-open-ro device mapname\n" @@ -11074,18 +13317,18 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2866 +#: ../fish/guestfish-actions.pod:3006 msgid "" "This is the same as L except that a read-only mapping is created." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2872 +#: ../fish/guestfish-actions.pod:3012 msgid "lvcreate" msgstr "lvcreate" #. type: verbatim -#: ../fish/guestfish-actions.pod:2874 +#: ../fish/guestfish-actions.pod:3014 #, no-wrap msgid "" " lvcreate logvol volgroup mbytes\n" @@ -11093,19 +13336,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2876 ../src/guestfs-actions.pod:4314 +#: ../fish/guestfish-actions.pod:3016 ../src/guestfs-actions.pod:4645 msgid "" "This creates an LVM logical volume called C on the volume group " "C, with C megabytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2879 +#: ../fish/guestfish-actions.pod:3019 msgid "lvm-canonical-lv-name" msgstr "lvm-canonical-lv-name" #. type: verbatim -#: ../fish/guestfish-actions.pod:2881 +#: ../fish/guestfish-actions.pod:3021 #, no-wrap msgid "" " lvm-canonical-lv-name lvname\n" @@ -11113,7 +13356,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2883 ../src/guestfs-actions.pod:4327 +#: ../fish/guestfish-actions.pod:3023 ../src/guestfs-actions.pod:4658 msgid "" "This converts alternative naming schemes for LVs that you might find to the " "canonical name. For example, C is converted to C parameter does not refer to a " "logical volume." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2890 +#: ../fish/guestfish-actions.pod:3030 msgid "See also L." msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2892 +#: ../fish/guestfish-actions.pod:3032 msgid "lvm-clear-filter" msgstr "lvm-clear-filter" #. type: verbatim -#: ../fish/guestfish-actions.pod:2894 +#: ../fish/guestfish-actions.pod:3034 #, no-wrap msgid "" " lvm-clear-filter\n" @@ -11148,26 +13391,26 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2896 +#: ../fish/guestfish-actions.pod:3036 msgid "" "This undoes the effect of L. LVM will be able to see every " "block device." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2899 ../fish/guestfish-actions.pod:2930 -#: ../src/guestfs-actions.pod:4349 ../src/guestfs-actions.pod:4391 +#: ../fish/guestfish-actions.pod:3039 ../fish/guestfish-actions.pod:3067 +#: ../src/guestfs-actions.pod:4680 ../src/guestfs-actions.pod:4719 msgid "" "This command also clears the LVM cache and performs a volume group scan." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2902 +#: ../fish/guestfish-actions.pod:3042 msgid "lvm-remove-all" msgstr "lvm-remove-all" #. type: verbatim -#: ../fish/guestfish-actions.pod:2904 +#: ../fish/guestfish-actions.pod:3044 #, no-wrap msgid "" " lvm-remove-all\n" @@ -11177,19 +13420,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2906 ../src/guestfs-actions.pod:4361 +#: ../fish/guestfish-actions.pod:3046 ../src/guestfs-actions.pod:4692 msgid "" "This command removes all LVM logical volumes, volume groups and physical " "volumes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2912 +#: ../fish/guestfish-actions.pod:3049 msgid "lvm-set-filter" msgstr "lvm-set-filter" #. type: verbatim -#: ../fish/guestfish-actions.pod:2914 +#: ../fish/guestfish-actions.pod:3051 #, no-wrap msgid "" " lvm-set-filter 'devices ...'\n" @@ -11199,7 +13442,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2916 ../src/guestfs-actions.pod:4377 +#: ../fish/guestfish-actions.pod:3053 ../src/guestfs-actions.pod:4705 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 " @@ -11207,7 +13450,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2920 ../src/guestfs-actions.pod:4381 +#: ../fish/guestfish-actions.pod:3057 ../src/guestfs-actions.pod:4709 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 " @@ -11219,24 +13462,24 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2933 ../src/guestfs-actions.pod:4394 +#: ../fish/guestfish-actions.pod:3070 ../src/guestfs-actions.pod:4722 msgid "You can filter whole block devices or individual partitions." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2935 ../src/guestfs-actions.pod:4396 +#: ../fish/guestfish-actions.pod:3072 ../src/guestfs-actions.pod:4724 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:2939 +#: ../fish/guestfish-actions.pod:3076 msgid "lvremove" msgstr "lvremove" #. type: verbatim -#: ../fish/guestfish-actions.pod:2941 +#: ../fish/guestfish-actions.pod:3078 #, no-wrap msgid "" " lvremove device\n" @@ -11246,26 +13489,26 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2943 ../src/guestfs-actions.pod:4410 +#: ../fish/guestfish-actions.pod:3080 ../src/guestfs-actions.pod:4738 msgid "" "Remove an LVM logical volume C, where C is the path to the " "LV, such as C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2946 ../src/guestfs-actions.pod:4413 +#: ../fish/guestfish-actions.pod:3083 ../src/guestfs-actions.pod:4741 msgid "" "You can also remove all LVs in a volume group by specifying the VG name, C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2949 +#: ../fish/guestfish-actions.pod:3086 msgid "lvrename" msgstr "lvrename" #. type: verbatim -#: ../fish/guestfish-actions.pod:2951 +#: ../fish/guestfish-actions.pod:3088 #, no-wrap msgid "" " lvrename logvol newlogvol\n" @@ -11273,17 +13516,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2953 ../src/guestfs-actions.pod:4427 +#: ../fish/guestfish-actions.pod:3090 ../src/guestfs-actions.pod:4755 msgid "Rename a logical volume C with the new name C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2955 +#: ../fish/guestfish-actions.pod:3092 msgid "lvresize" msgstr "lvresize" #. type: verbatim -#: ../fish/guestfish-actions.pod:2957 +#: ../fish/guestfish-actions.pod:3094 #, no-wrap msgid "" " lvresize device mbytes\n" @@ -11291,19 +13534,19 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2959 ../src/guestfs-actions.pod:4440 +#: ../fish/guestfish-actions.pod:3096 ../src/guestfs-actions.pod:4768 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:2963 +#: ../fish/guestfish-actions.pod:3100 msgid "lvresize-free" msgstr "lvresize-free" #. type: verbatim -#: ../fish/guestfish-actions.pod:2965 +#: ../fish/guestfish-actions.pod:3102 #, no-wrap msgid "" " lvresize-free lv percent\n" @@ -11311,7 +13554,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2967 ../src/guestfs-actions.pod:4455 +#: ../fish/guestfish-actions.pod:3104 ../src/guestfs-actions.pod:4783 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 with " @@ -11320,12 +13563,12 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2973 +#: ../fish/guestfish-actions.pod:3110 msgid "lvs" msgstr "lvs" #. type: verbatim -#: ../fish/guestfish-actions.pod:2975 +#: ../fish/guestfish-actions.pod:3112 #, no-wrap msgid "" " lvs\n" @@ -11335,31 +13578,31 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2977 ../src/guestfs-actions.pod:4470 +#: ../fish/guestfish-actions.pod:3114 ../src/guestfs-actions.pod:4798 msgid "" "List all the logical volumes detected. This is the equivalent of the L command." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2980 ../src/guestfs-actions.pod:4473 +#: ../fish/guestfish-actions.pod:3117 ../src/guestfs-actions.pod:4801 msgid "" "This returns a list of the logical volume device names (eg. C)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2983 +#: ../fish/guestfish-actions.pod:3120 msgid "See also L, L." msgstr "Див. також L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2985 +#: ../fish/guestfish-actions.pod:3122 msgid "lvs-full" msgstr "lvs-full" #. type: verbatim -#: ../fish/guestfish-actions.pod:2987 +#: ../fish/guestfish-actions.pod:3124 #, no-wrap msgid "" " lvs-full\n" @@ -11369,19 +13612,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2989 ../src/guestfs-actions.pod:4489 +#: ../fish/guestfish-actions.pod:3126 ../src/guestfs-actions.pod:4817 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:2992 +#: ../fish/guestfish-actions.pod:3129 msgid "lvuuid" msgstr "lvuuid" #. type: verbatim -#: ../fish/guestfish-actions.pod:2994 +#: ../fish/guestfish-actions.pod:3131 #, no-wrap msgid "" " lvuuid device\n" @@ -11391,17 +13634,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2996 ../src/guestfs-actions.pod:4504 +#: ../fish/guestfish-actions.pod:3133 ../src/guestfs-actions.pod:4832 msgid "This command returns the UUID of the LVM LV C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2998 +#: ../fish/guestfish-actions.pod:3135 msgid "lxattrlist" msgstr "lxattrlist" #. type: verbatim -#: ../fish/guestfish-actions.pod:3000 +#: ../fish/guestfish-actions.pod:3137 #, no-wrap msgid "" " lxattrlist path 'names ...'\n" @@ -11409,7 +13652,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3002 ../src/guestfs-actions.pod:4518 +#: ../fish/guestfish-actions.pod:3139 ../src/guestfs-actions.pod:4846 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 " @@ -11417,7 +13660,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3006 ../src/guestfs-actions.pod:4522 +#: ../fish/guestfish-actions.pod:3143 ../src/guestfs-actions.pod:4850 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. " @@ -11429,7 +13672,7 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3016 +#: ../fish/guestfish-actions.pod:3153 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 " @@ -11440,12 +13683,240 @@ msgid "" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3024 +#: ../fish/guestfish-actions.pod:3161 +#, fuzzy +#| msgid "lvcreate" +msgid "md-create" +msgstr "lvcreate" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:3163 +#, no-wrap +msgid "" +" md-create name 'devices ...' [missingbitmap:N] [nrdevices:N] [spare:N] [chunk:N] [level:..]\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3165 ../src/guestfs-actions.pod:4893 +msgid "" +"Create a Linux md (RAID) device named C on the devices in the list " +"C." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3172 ../src/guestfs-actions.pod:4900 +msgid "C" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3174 ../src/guestfs-actions.pod:4902 +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 " +"device in the array." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3178 ../src/guestfs-actions.pod:4906 +#, fuzzy +#| msgid "For example:" +msgid "As examples:" +msgstr "Приклад:" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3180 ../src/guestfs-actions.pod:4908 +msgid "" +"If C and C then the resulting " +"array would be C<[EmissingE, \"/dev/sda\"]>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3183 ../src/guestfs-actions.pod:4911 +msgid "" +"If C and C then the resulting " +"array would be C<[\"/dev/sda\", EmissingE]>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3186 ../src/guestfs-actions.pod:4914 +msgid "This defaults to C<0> (no missing devices)." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3188 ../src/guestfs-actions.pod:4916 +msgid "" +"The length of C + the number of bits set in C must " +"equal C + C." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3191 ../src/guestfs-actions.pod:4919 +#, fuzzy +#| msgid "device" +msgid "C" +msgstr "пристрій" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3193 ../src/guestfs-actions.pod:4921 +#, fuzzy +#| msgid "The number of hard links." +msgid "The number of active RAID devices." +msgstr "Кількість жорстких посилань." + +#. type: textblock +#: ../fish/guestfish-actions.pod:3195 ../src/guestfs-actions.pod:4923 +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:3198 ../src/guestfs-actions.pod:4926 +#, fuzzy +#| msgid "sparse" +msgid "C" +msgstr "sparse" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3200 ../src/guestfs-actions.pod:4928 +#, fuzzy +#| msgid "The number of hard links." +msgid "The number of spare devices." +msgstr "Кількість жорстких посилань." + +#. type: textblock +#: ../fish/guestfish-actions.pod:3202 ../src/guestfs-actions.pod:4930 +msgid "If not set, this defaults to C<0>." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3204 ../src/guestfs-actions.pod:4932 +msgid "C" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3206 ../src/guestfs-actions.pod:4934 +#, fuzzy +#| msgid "The size in SI 1000 byte units." +msgid "The chunk size in bytes." +msgstr "Розмір у одиницях СІ: 1000 байтів." + +#. type: =item +#: ../fish/guestfish-actions.pod:3208 ../fish/guestfish-actions.pod:3230 +#: ../src/guestfs-actions.pod:4936 ../src/guestfs-actions.pod:4984 +msgid "C" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3210 ../src/guestfs-actions.pod:4938 +msgid "" +"The RAID level, which can be one of: I, I, I<0>, I, " +"I, I<1>, I, I, I<4>, I, I<5>, I, I<6>, " +"I, I<10>. Some of these are synonymous, and more levels may be " +"added in future." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3215 ../src/guestfs-actions.pod:4943 +msgid "If not set, this defaults to C." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:3221 +#, fuzzy +#| msgid "tail" +msgid "md-detail" +msgstr "tail" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:3223 +#, no-wrap +msgid "" +" md-detail md\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3225 ../src/guestfs-actions.pod:4979 +msgid "" +"This command exposes the output of 'mdadm -DY '. The following fields " +"are usually present in the returned hash. Other fields may also be present." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3232 ../src/guestfs-actions.pod:4986 +msgid "The raid level of the MD device." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3234 ../src/guestfs-actions.pod:4988 +#, fuzzy +#| msgid "device" +msgid "C" +msgstr "пристрій" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3236 ../src/guestfs-actions.pod:4990 +msgid "The number of underlying devices in the MD device." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3238 ../src/guestfs-actions.pod:4992 +msgid "C" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3240 ../src/guestfs-actions.pod:4994 +msgid "The metadata version used." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:3242 ../src/guestfs-actions.pod:4996 +#, fuzzy +#| msgid "B<--uuid>" +msgid "C" +msgstr "B<--uuid>" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3244 ../src/guestfs-actions.pod:4998 +msgid "The UUID of the MD device." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3248 ../src/guestfs-actions.pod:5002 +#, fuzzy +#| msgid "The time of last access." +msgid "The name of the MD device." +msgstr "Час останнього доступу." + +#. type: =head2 +#: ../fish/guestfish-actions.pod:3252 +msgid "md-stop" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:3254 +#, no-wrap +msgid "" +" md-stop md\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:3256 ../src/guestfs-actions.pod:5018 +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:3259 msgid "mkdir" msgstr "mkdir" #. type: verbatim -#: ../fish/guestfish-actions.pod:3026 +#: ../fish/guestfish-actions.pod:3261 #, no-wrap msgid "" " mkdir path\n" @@ -11455,17 +13926,17 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:3028 ../src/guestfs-actions.pod:4552 +#: ../fish/guestfish-actions.pod:3263 ../src/guestfs-actions.pod:5029 msgid "Create a directory named C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:3030 +#: ../fish/guestfish-actions.pod:3265 msgid "mkdir-mode" msgstr "mkdir-mode" #. type: verbatim -#: ../fish/guestfish-actions.pod:3032 +#: ../fish/guestfish-actions.pod:3267 #, no-wrap msgid "" " mkdir-mode path mode\n" @@ -11475,14 +13946,14 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:3034 ../src/guestfs-actions.pod:4565 +#: ../fish/guestfish-actions.pod:3269 ../src/guestfs-actions.pod:5042 msgid "" "This command creates a directory, setting the initial permissions of the " "directory to C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3037 ../src/guestfs-actions.pod:4568 +#: ../fish/guestfish-actions.pod:3272 ../src/guestfs-actions.pod:5045 msgid "" "For common Linux filesystems, the actual mode which is set will be C. Non-native-Linux filesystems may interpret the mode in " @@ -11490,17 +13961,17 @@ msgid "" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:3041 +#: ../fish/guestfish-actions.pod:3276 msgid "See also L, L" msgstr "Див. також L, L" #. type: =head2 -#: ../fish/guestfish-actions.pod:3043 +#: ../fish/guestfish-actions.pod:3278 msgid "mkdir-p" msgstr "mkdir-p" #. type: verbatim -#: ../fish/guestfish-actions.pod:3045 +#: ../fish/guestfish-actions.pod:3280 #, no-wrap msgid "" " mkdir-p path\n" @@ -11510,19 +13981,19 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:3047 ../src/guestfs-actions.pod:4584 +#: ../fish/guestfish-actions.pod:3282 ../src/guestfs-actions.pod:5061 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:3050 +#: ../fish/guestfish-actions.pod:3285 msgid "mkdtemp" msgstr "mkdtemp" #. type: verbatim -#: ../fish/guestfish-actions.pod:3052 +#: ../fish/guestfish-actions.pod:3287 #, no-wrap msgid "" " mkdtemp template\n" @@ -11532,7 +14003,7 @@ msgstr "" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:3054 ../src/guestfs-actions.pod:4597 +#: ../fish/guestfish-actions.pod:3289 ../src/guestfs-actions.pod:5074 msgid "" "This command creates a temporary directory. The C