X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=po-docs%2Fuk.po;h=6328ad4da3b371885fc963b8d0798df7b4737775;hb=3aa164d5283d13085a2adc9579b19068ef065648;hp=9ca68fc8e51bb792341ba37d6e04b4ae4f32a537;hpb=69abc787dddbf7855c2871f7f1432563a6af92a1;p=libguestfs.git diff --git a/po-docs/uk.po b/po-docs/uk.po index 9ca68fc..6328ad4 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-08-26 22:52+0200\n" -"PO-Revision-Date: 2011-07-17 20:50+0000\n" +"POT-Creation-Date: 2011-11-24 22:09+0000\n" +"PO-Revision-Date: 2011-10-27 09:15+0000\n" "Last-Translator: rjones \n" "Language-Team: Ukrainian \n" "Language: uk\n" @@ -19,9 +20,11 @@ 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 -#: ../examples/guestfs-examples.pod:3 ../examples/guestfs-recipes.pod:14 +#: ../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 ../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 @@ -29,7 +32,8 @@ msgstr "" #: ../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 ../test-tool/libguestfs-test-tool.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 #: ../tools/virt-win-reg.pl:35 @@ -37,21 +41,23 @@ 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 -#: ../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 ../fish/virt-tar-out.pod:7 -#: ../fuse/guestmount.pod:7 ../inspector/virt-inspector.pod:7 -#: ../java/examples/guestfs-java.pod:7 ../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 +#: ../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 +#: ../fish/virt-tar-out.pod:7 ../fuse/guestmount.pod:7 +#: ../inspector/virt-inspector.pod:7 ../java/examples/guestfs-java.pod:7 +#: ../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 +#: ../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 @@ -60,65 +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 +#: ../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:29 #: ../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 @@ -126,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 +#: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:92 #: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84 -#: ../resize/virt-resize.pod:241 ../test-tool/libguestfs-test-tool.pod:37 +#: ../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 @@ -255,58 +278,56 @@ 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 +#: ../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:88 -#: ../resize/virt-resize.pod:245 ../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 +#: ../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 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 +#: ../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:90 #: ../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 +#: ../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:92 -#, fuzzy -#| msgid "B<-f file>" 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 +#: ../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:94 -#, fuzzy -#| msgid "B<--add image>" 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 +#: ../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:100 msgid "" "The format of the disk image is auto-detected. To override this and force a " @@ -314,24 +335,25 @@ msgid "" 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:107 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:109 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 +#: ../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:111 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132 @@ -341,30 +363,35 @@ 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:114 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 +#: ../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:117 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 +#: ../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:119 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 +#: ../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:121 msgid "" "Add all the disks from the named libvirt guest. Domain UUIDs can be used " @@ -372,42 +399,30 @@ msgid "" 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:124 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:126 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:128 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 " @@ -416,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:335 ../rescue/virt-rescue.pod:133 -#: ../src/guestfs.pod:2668 +#: ../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:133 ../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:137 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:141 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:144 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 " @@ -477,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:491 +#: ../sparsify/virt-sparsify.pod:152 +msgid "B<-q>" +msgstr "B<-q>" + +#. type: =item +#: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:493 +#: ../sparsify/virt-sparsify.pod:154 +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:178 +#: ../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:182 ../sparsify/virt-sparsify.pod:158 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:180 +#: ../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:184 ../sparsify/virt-sparsify.pod:160 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:182 +#: ../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:186 ../sparsify/virt-sparsify.pod:162 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:184 -#: ../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:188 ../resize/virt-resize.pod:561 +#: ../sparsify/virt-sparsify.pod:164 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:186 -#: ../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:190 ../resize/virt-resize.pod:563 +#: ../sparsify/virt-sparsify.pod:166 ../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:188 -#: ../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:192 ../resize/virt-resize.pod:565 +#: ../sparsify/virt-sparsify.pod:168 ../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:199 +#: ../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:203 ../sparsify/virt-sparsify.pod:170 #: ../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:201 +#: ../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:205 ../sparsify/virt-sparsify.pod:172 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:205 -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 -#: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 -#: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:211 -#, fuzzy -#| msgid "or:" -msgid "or" -msgstr "або:" +#: ../align/virt-alignment-scan.pod:245 +msgid "For a new consumer hard drive with 4Kbyte sectors:" +msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:160 +#: ../align/virt-alignment-scan.pod:247 #, no-wrap msgid "" -" virt-cat guestname file\n" +" $ 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:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 -#: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:215 +#: ../align/virt-alignment-scan.pod:258 +msgid "For a NetApp LUN:" +msgstr "" + +#. type: verbatim +#: ../align/virt-alignment-scan.pod:260 +#, no-wrap 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." +" $ 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:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193 -#: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:219 -msgid "For compatibility the old style is still supported." +#: ../align/virt-alignment-scan.pod:269 +msgid "" +"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: =head1 -#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297 -msgid "USING GUESTFISH" +#. type: textblock +#: ../align/virt-alignment-scan.pod:273 +msgid "" +"For detailed information about what these numbers mean, see L" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:170 +#: ../align/virt-alignment-scan.pod:276 msgid "" -"L is a more powerful, lower level tool which you can use when " -"C doesn't work." +"[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:173 -msgid "Using C is approximately equivalent to doing:" +#: ../align/virt-alignment-scan.pod:281 +msgid "" +"Microsoft picked 1 MB as the default alignment for all partitions starting " +"with Windows 2008 Server, and Linux has followed this." 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:284 msgid "" -" guestfish --ro -i -d domname download file -\n" -"\n" +"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 "" -" guestfish --ro -d myguest -i\n" -"\n" #. type: textblock -#: ../cat/virt-cat.pod:177 +#: ../align/virt-alignment-scan.pod:288 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\")." +"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 "" #. type: textblock -#: ../cat/virt-cat.pod:181 +#: ../align/virt-alignment-scan.pod:293 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:" +"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: verbatim -#: ../cat/virt-cat.pod:186 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish [--ro] -i disk.img\n" -#| "\n" +#. type: textblock +#: ../align/virt-alignment-scan.pod:299 msgid "" -" guestfish --ro -a disk.img -m /dev/sda1 download file -\n" -"\n" +"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 "" -" guestfish [--ro] -i disk.img\n" -"\n" #. type: textblock -#: ../cat/virt-cat.pod:188 +#: ../align/virt-alignment-scan.pod:303 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." +"For older versions of Windows, the following NetApp document contains useful " +"information: L" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:306 +msgid "" +"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:192 ../cat/virt-filesystems.pod:365 -#: ../cat/virt-ls.pod:483 ../df/virt-df.pod:215 ../edit/virt-edit.pod:342 -#: ../inspector/virt-inspector.pod:349 ../rescue/virt-rescue.pod:262 -#: ../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:266 ../resize/virt-resize.pod:676 +#: ../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:194 ../cat/virt-filesystems.pod:367 -#: ../cat/virt-ls.pod:485 ../df/virt-df.pod:217 ../edit/virt-edit.pod:344 -#: ../inspector/virt-inspector.pod:351 ../rescue/virt-rescue.pod:264 -#: ../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:268 ../resize/virt-resize.pod:678 +#: ../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 " @@ -706,95 +887,242 @@ msgid "" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:199 ../cat/virt-filesystems.pod:372 -#: ../cat/virt-ls.pod:490 ../df/virt-df.pod:222 ../edit/virt-edit.pod:349 +#: ../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:683 ../sparsify/virt-sparsify.pod:226 +#: ../test-tool/libguestfs-test-tool.pod:90 +msgid "EXIT STATUS" +msgstr "" + +#. type: textblock +#: ../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:359 ../resize/virt-resize.pod:363 +#: ../resize/virt-resize.pod:372 ../resize/virt-resize.pod:378 +#: ../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 "" +"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 +#: ../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:303 -#: ../inspector/virt-inspector.pod:372 ../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:284 -#: ../resize/virt-resize.pod:608 ../ruby/examples/guestfs-ruby.pod:36 -#: ../src/guestfs.pod:3042 ../test-tool/libguestfs-test-tool.pod:87 +#: ../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:288 +#: ../resize/virt-resize.pod:688 ../ruby/examples/guestfs-ruby.pod:36 +#: ../sparsify/virt-sparsify.pod:250 ../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:201 -#, 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:208 ../cat/virt-filesystems.pod:383 -#: ../cat/virt-ls.pod:502 ../df/virt-df.pod:230 ../edit/virt-edit.pod:363 -#: ../rescue/virt-rescue.pod:292 ../resize/virt-resize.pod:629 +#: ../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:296 +#: ../resize/virt-resize.pod:711 ../sparsify/virt-sparsify.pod:263 #: ../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:210 ../cat/virt-filesystems.pod:385 -#: ../cat/virt-ls.pod:504 ../df/virt-df.pod:232 ../edit/virt-edit.pod:365 -#: ../inspector/virt-inspector.pod:386 ../rescue/virt-rescue.pod:294 -#: ../resize/virt-resize.pod:631 ../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:298 ../resize/virt-resize.pod:713 +#: ../sparsify/virt-sparsify.pod:265 ../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:212 ../cat/virt-filesystems.pod:387 -#: ../cat/virt-ls.pod:506 ../df/virt-df.pod:234 ../edit/virt-edit.pod:367 -#: ../examples/guestfs-examples.pod:48 ../examples/guestfs-recipes.pod:400 -#: ../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:318 -#: ../inspector/virt-inspector.pod:394 ../java/examples/guestfs-java.pod:61 -#: ../ocaml/examples/guestfs-ocaml.pod:94 ../perl/examples/guestfs-perl.pod:55 -#: ../python/examples/guestfs-python.pod:57 ../rescue/virt-rescue.pod:296 -#: ../resize/virt-resize.pod:633 ../ruby/examples/guestfs-ruby.pod:51 -#: ../src/guestfs.pod:3118 ../test-tool/libguestfs-test-tool.pod:97 +#: ../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 +#: ../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:300 +#: ../resize/virt-resize.pod:715 ../ruby/examples/guestfs-ruby.pod:52 +#: ../sparsify/virt-sparsify.pod:267 ../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:214 ../inspector/virt-inspector.pod:396 -#: ../resize/virt-resize.pod:635 -#, 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:269 +msgid "Copyright (C) 2011 Red Hat Inc." +msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:391 -#: ../cat/virt-ls.pod:510 ../df/virt-df.pod:238 ../edit/virt-edit.pod:371 -#: ../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:323 -#: ../inspector/virt-inspector.pod:398 ../rescue/virt-rescue.pod:300 -#: ../resize/virt-resize.pod:637 ../test-tool/libguestfs-test-tool.pod:102 +#: ../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:304 ../resize/virt-resize.pod:719 +#: ../sparsify/virt-sparsify.pod:271 ../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 " @@ -803,16 +1131,18 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:221 ../cat/virt-filesystems.pod:396 -#: ../cat/virt-ls.pod:515 ../df/virt-df.pod:243 ../edit/virt-edit.pod:376 -#: ../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:328 -#: ../inspector/virt-inspector.pod:403 ../rescue/virt-rescue.pod:305 -#: ../resize/virt-resize.pod:642 ../test-tool/libguestfs-test-tool.pod:107 +#: ../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:309 ../resize/virt-resize.pod:724 +#: ../sparsify/virt-sparsify.pod:276 ../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 " @@ -825,161 +1155,611 @@ msgstr "" "дізнатися з GNU General Public License." #. type: textblock -#: ../cat/virt-cat.pod:226 ../cat/virt-filesystems.pod:401 -#: ../cat/virt-ls.pod:520 ../df/virt-df.pod:248 ../edit/virt-edit.pod:381 -#: ../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:333 -#: ../inspector/virt-inspector.pod:408 ../rescue/virt-rescue.pod:310 -#: ../resize/virt-resize.pod:647 ../test-tool/libguestfs-test-tool.pod:112 +#: ../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:314 ../resize/virt-resize.pod:729 +#: ../sparsify/virt-sparsify.pod:281 ../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 +#: ../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: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." +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:209 +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:215 +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:219 +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:223 +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:685 ../sparsify/virt-sparsify.pod:228 +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:717 ../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." @@ -1032,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 @@ -1048,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 @@ -1100,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 @@ -1120,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 @@ -1139,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 @@ -1173,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 @@ -1187,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 @@ -1230,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 @@ -1258,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 @@ -1278,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 @@ -1299,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 @@ -1323,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 @@ -1342,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 @@ -1369,7 +2095,7 @@ msgstr "" #. type: =head1 #: ../cat/virt-filesystems.pod:287 msgid "COLUMNS" -msgstr "" +msgstr "СТОВПЧИКИ" #. type: textblock #: ../cat/virt-filesystems.pod:289 @@ -1405,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 @@ -1418,7 +2142,7 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:309 msgid "B" -msgstr "" +msgstr "B" #. type: textblock #: ../cat/virt-filesystems.pod:311 @@ -1441,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 " @@ -1468,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" @@ -1516,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" @@ -1534,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:374 -#, 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:389 ../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 @@ -1592,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 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 @@ -1670,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 "" @@ -1695,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 "" @@ -1708,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 "" @@ -1721,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 "" @@ -1747,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 "" @@ -1760,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 "" @@ -1807,7 +2521,7 @@ msgstr "" #. type: =head1 #: ../cat/virt-ls.pod:84 msgid "OUTPUT MODES" -msgstr "" +msgstr "РЕЖИМИ ВИВЕДЕННЯ ДАНИХ" #. type: textblock #: ../cat/virt-ls.pod:86 @@ -1819,7 +2533,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:89 msgid "SIMPLE LISTING" -msgstr "" +msgstr "ПРОСТИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:91 @@ -1836,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 @@ -1862,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 @@ -1874,7 +2597,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:113 msgid "RECURSIVE LISTING" -msgstr "" +msgstr "РЕКУРСИВНИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:115 @@ -1893,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 @@ -1904,7 +2632,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:126 msgid "RECURSIVE LONG LISTING" -msgstr "" +msgstr "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:128 @@ -1954,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 @@ -1962,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 @@ -1977,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 @@ -1989,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 @@ -2003,9 +2734,9 @@ msgid "" msgstr "" #. type: =head2 -#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4188 +#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4380 msgid "path" -msgstr "" +msgstr "шлях" #. type: textblock #: ../cat/virt-ls.pod:183 @@ -2014,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 @@ -2040,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 @@ -2066,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 @@ -2114,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 @@ -2129,7 +2846,7 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:238 msgid "inode" -msgstr "" +msgstr "inode" #. type: textblock #: ../cat/virt-ls.pod:240 @@ -2138,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 @@ -2161,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 @@ -2181,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 @@ -2219,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 @@ -2263,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 @@ -2303,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 @@ -2315,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 @@ -2334,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 @@ -2346,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 @@ -2358,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 @@ -2375,22206 +3062,25122 @@ 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:492 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." +#: ../cat/virt-ls.pod:497 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:508 ../df/virt-df.pod:236 ../edit/virt-edit.pod:369 -#: ../rescue/virt-rescue.pod:298 -#, 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:302 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:1104 ../fish/guestfish-actions.pod:1108 -#: ../fish/guestfish-actions.pod:1112 ../fish/guestfish-actions.pod:1116 -#: ../fish/guestfish-actions.pod:1124 ../fish/guestfish-actions.pod:1128 -#: ../fish/guestfish-actions.pod:1132 ../fish/guestfish-actions.pod:1142 -#: ../fish/guestfish-actions.pod:1146 ../fish/guestfish-actions.pod:1150 -#: ../fish/guestfish-actions.pod:1240 ../fish/guestfish-actions.pod:1244 -#: ../fish/guestfish-actions.pod:1249 ../fish/guestfish-actions.pod:1254 -#: ../fish/guestfish-actions.pod:1296 ../fish/guestfish-actions.pod:1300 -#: ../fish/guestfish-actions.pod:1305 ../fish/guestfish-actions.pod:1938 -#: ../fish/guestfish-actions.pod:1944 ../fish/guestfish-actions.pod:1952 -#: ../fish/guestfish-actions.pod:1959 ../fish/guestfish-actions.pod:1966 -#: ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 -#: ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 -#: ../inspector/virt-inspector.pod:384 ../inspector/virt-inspector.pod:388 -#: ../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:1667 ../src/guestfs-actions.pod:1671 -#: ../src/guestfs-actions.pod:1675 ../src/guestfs-actions.pod:1679 -#: ../src/guestfs-actions.pod:1687 ../src/guestfs-actions.pod:1691 -#: ../src/guestfs-actions.pod:1695 ../src/guestfs-actions.pod:1705 -#: ../src/guestfs-actions.pod:1709 ../src/guestfs-actions.pod:1713 -#: ../src/guestfs-actions.pod:1851 ../src/guestfs-actions.pod:1855 -#: ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1865 -#: ../src/guestfs-actions.pod:1926 ../src/guestfs-actions.pod:1930 -#: ../src/guestfs-actions.pod:1935 ../src/guestfs-actions.pod:2864 -#: ../src/guestfs-actions.pod:2870 ../src/guestfs-actions.pod:2878 -#: ../src/guestfs-actions.pod:2885 ../src/guestfs-actions.pod:2892 -#: ../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:1064 -#: ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077 -#: ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112 -#: ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142 -#: ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154 -#: ../src/guestfs.pod:1644 ../src/guestfs.pod:1649 ../src/guestfs.pod:1653 -#: ../src/guestfs.pod:1755 ../src/guestfs.pod:1760 ../src/guestfs.pod:1764 -#: ../src/guestfs.pod:1774 ../src/guestfs.pod:2063 ../src/guestfs.pod:2068 -#: ../src/guestfs.pod:2074 ../src/guestfs.pod:2082 ../src/guestfs.pod:2436 -#: ../src/guestfs.pod:2442 ../src/guestfs.pod:2447 ../src/guestfs.pod:2453 -#: ../src/guestfs.pod:2834 ../src/guestfs.pod:2839 ../src/guestfs.pod:2843 -#: ../src/guestfs.pod:2847 ../src/guestfs.pod:2851 ../src/guestfs.pod:2865 -#: ../src/guestfs.pod:2870 ../src/guestfs.pod:3095 ../src/guestfs.pod:3099 -#: ../src/guestfs.pod:3103 ../src/guestfs.pod:3107 -#: ../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:224 +#: ../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:257 ../src/guestfs.pod:2981 -#: ../test-tool/libguestfs-test-tool.pod:82 -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:351 -#, 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 -#: ../examples/guestfs-examples.pod:5 -msgid "guestfs-examples - Examples of using libguestfs from C" +#: ../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 -#: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9 +#: ../df/virt-df.pod:48 #, no-wrap msgid "" -" #include \n" -" \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 +#: ../df/virt-df.pod:53 +msgid "Show disk usage for a disk image file called C:" msgstr "" -" #include \n" -" \n" #. type: verbatim -#: ../examples/guestfs-examples.pod:11 +#: ../df/virt-df.pod:55 #, no-wrap msgid "" -" guestfs_h *g = guestfs_create ();\n" -" guestfs_add_drive_ro (g, \"disk.img\");\n" -" guestfs_launch (g);\n" +" $ 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 -#: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19 +#: ../df/virt-df.pod:112 #, no-wrap msgid "" -" cc prog.c -o prog -lguestfs\n" -"or:\n" -" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" +" virt-df --format=raw -a disk.img\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 +#. type: verbatim +#: ../df/virt-df.pod:116 +#, no-wrap 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." +" virt-df --format=raw -a disk.img --format -a another.img\n" +"\n" msgstr "" -#. type: =head1 -#: ../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" +#. type: textblock +#: ../df/virt-df.pod:129 +msgid "Print sizes in human-readable format." msgstr "" #. type: textblock -#: ../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 "ПРИКЛАД" - -#. type: =head1 -#: ../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" +#: ../df/virt-df.pod:131 +msgid "You are not allowed to use I<-h> and I<--csv> at the same time." msgstr "" -#. type: textblock -#: ../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 "ПРИКЛАД" +#. 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 -#: ../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." +#: ../df/virt-df.pod:137 +msgid "Print inodes instead of blocks." msgstr "" -"L, L, L, L, L, L, L, L, L." -#. type: =head1 -#: ../examples/guestfs-examples.pod:44 ../examples/guestfs-recipes.pod:396 -#: ../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:314 -#: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:57 -#: ../ocaml/examples/guestfs-ocaml.pod:90 ../perl/examples/guestfs-perl.pod:51 -#: ../python/examples/guestfs-python.pod:53 -#: ../ruby/examples/guestfs-ruby.pod:47 ../src/guestfs.pod:3114 -#: ../test-tool/libguestfs-test-tool.pod:93 -msgid "AUTHORS" -msgstr "АВТОРИ" +#. type: =item +#: ../df/virt-df.pod:139 +msgid "B<--one-per-guest>" +msgstr "B<--one-per-guest>" #. type: textblock -#: ../examples/guestfs-examples.pod:46 ../examples/guestfs-recipes.pod:398 -#: ../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:316 -#: ../java/examples/guestfs-java.pod:59 ../ocaml/examples/guestfs-ocaml.pod:92 -#: ../perl/examples/guestfs-perl.pod:53 -#: ../python/examples/guestfs-python.pod:55 -#: ../ruby/examples/guestfs-ruby.pod:49 ../src/guestfs.pod:3116 -#: ../test-tool/libguestfs-test-tool.pod:95 -msgid "Richard W.M. Jones (C)" +#: ../df/virt-df.pod:141 +msgid "" +"Run one libguestfs appliance per guest. Normally C will add the " +"disks from several guests to a single libguestfs appliance." msgstr "" #. type: textblock -#: ../examples/guestfs-examples.pod:50 ../ocaml/examples/guestfs-ocaml.pod:96 -#: ../python/examples/guestfs-python.pod:59 -#: ../ruby/examples/guestfs-ruby.pod:53 -#, fuzzy -#| msgid "Copyright (C) 2009 Red Hat Inc." -msgid "Copyright (C) 2010 Red Hat Inc. L" -msgstr "© Red Hat Inc., 2009" +#: ../df/virt-df.pod:144 +msgid "You might use this option in the following circumstances:" +msgstr "" #. type: textblock -#: ../examples/guestfs-examples.pod:52 ../examples/guestfs-recipes.pod:404 -#: ../java/examples/guestfs-java.pod:65 ../ocaml/examples/guestfs-ocaml.pod:98 -#: ../perl/examples/guestfs-perl.pod:59 -#: ../python/examples/guestfs-python.pod:61 -#: ../ruby/examples/guestfs-ruby.pod:55 +#: ../df/virt-df.pod:150 msgid "" -"The examples in this manual page may be freely copied, modified and " -"distributed without any restrictions." +"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: textblock -#: ../examples/guestfs-examples.pod:55 ../examples/guestfs-recipes.pod:407 -#: ../java/examples/guestfs-java.pod:68 -#: ../ocaml/examples/guestfs-ocaml.pod:101 -#: ../perl/examples/guestfs-perl.pod:62 -#: ../python/examples/guestfs-python.pod:64 -#: ../ruby/examples/guestfs-ruby.pod:58 ../src/guestfs.pod:3123 +#: ../df/virt-df.pod:156 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." +"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 "" #. type: textblock -#: ../examples/guestfs-examples.pod:60 ../examples/guestfs-recipes.pod:412 -#: ../java/examples/guestfs-java.pod:73 -#: ../ocaml/examples/guestfs-ocaml.pod:106 -#: ../perl/examples/guestfs-perl.pod:67 -#: ../python/examples/guestfs-python.pod:69 -#: ../ruby/examples/guestfs-ruby.pod:63 ../src/guestfs.pod:3128 +#: ../df/virt-df.pod:165 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." +"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 -#: ../examples/guestfs-examples.pod:65 ../examples/guestfs-recipes.pod:417 -#: ../java/examples/guestfs-java.pod:78 -#: ../ocaml/examples/guestfs-ocaml.pod:111 -#: ../perl/examples/guestfs-perl.pod:72 -#: ../python/examples/guestfs-python.pod:74 -#: ../ruby/examples/guestfs-ruby.pod:68 ../src/guestfs.pod:3133 +#: ../df/virt-df.pod:169 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" +"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: =end -#: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12 -msgid "comment" -msgstr "" +#. type: =head1 +#: ../df/virt-df.pod:191 +#, fuzzy +#| msgid "NUMBERS" +msgid "STATVFS NUMBERS" +msgstr "ЧИСЛА" #. type: textblock -#: ../examples/guestfs-recipes.pod:5 +#: ../df/virt-df.pod:193 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." +"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: 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: =item +#: ../df/virt-df.pod:199 +msgid "From the host" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:16 -msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes" +#: ../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 -#: ../examples/guestfs-recipes.pod:20 +#. type: verbatim +#: ../df/virt-df.pod:203 +#, fuzzy, no-wrap +#| msgid "" +#| " guestfish --ro -d myguest -i\n" +#| "\n" msgid "" -"This page contains recipes for and links to things you can do using " -"libguestfs, L and the virt tools." -msgstr "" - -#. type: =head1 -#: ../examples/guestfs-recipes.pod:23 -msgid "Audit a virtual machine for setuid files" +" guestfish --ro -d GuestName -i statvfs /\n" +"\n" msgstr "" +" guestfish --ro -d myguest -i\n" +"\n" #. type: textblock -#: ../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." +#: ../df/virt-df.pod:205 ../df/virt-df.pod:213 +msgid "(change C to see stats for other filesystems)." msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:28 -msgid "" -"https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-" -"files/#content" +#. type: =item +#: ../df/virt-df.pod:207 +msgid "From inside the guest" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:30 -msgid "Change the background image in a Windows XP VM" +#. type: verbatim +#: ../df/virt-df.pod:211 +#, no-wrap +msgid "" +" python -c 'import os; s = os.statvfs (\"/\"); print s'\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:32 +#: ../df/virt-df.pod:255 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." +"L, L, L, L, L." 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" +#: ../edit/virt-edit.pod:5 +msgid "virt-edit - Edit a file in a virtual machine" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:40 -msgid "Cloning a virtual machine (Linux)" +#. type: verbatim +#: ../edit/virt-edit.pod:9 +#, no-wrap +msgid "" +" virt-edit [--options] -d domname file [file ...]\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:42 +#. type: verbatim +#: ../edit/virt-edit.pod:11 +#, no-wrap 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." +" 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:19 +#: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51 +msgid "WARNING" +msgstr "ПОПЕРЕДЖЕННЯ" + #. type: textblock -#: ../examples/guestfs-recipes.pod:46 +#: ../edit/virt-edit.pod:23 msgid "" -"https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-" -"vm/#content" +"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 -#: ../examples/guestfs-recipes.pod:48 +#: ../edit/virt-edit.pod:29 msgid "" -"Avoid L. Currently what to do about virt-clone is under " -"discussion." +"C is a command line tool to edit C where each C " +"exists in the named virtual machine (or disk image)." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:51 -msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html" +#: ../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: =head1 -#: ../examples/guestfs-recipes.pod:53 -msgid "Cloning a virtual machine (Windows)" +#. type: textblock +#: ../edit/virt-edit.pod:36 +msgid "If you want to just view a file, use L." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:55 +#: ../edit/virt-edit.pod:38 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." +"For more complex cases you should look at the L tool (see L below)." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:60 +#: ../edit/virt-edit.pod:41 msgid "" -"https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-" -"list/2011-May/msg00019.html" +"C cannot be used to create a new file. L can do " +"that and much more." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:63 -msgid "Convert a CD-ROM / DVD / ISO to a tarball" +#. type: textblock +#: ../edit/virt-edit.pod:46 +msgid "Edit the named files interactively:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:65 -msgid "This converts input C to output C:" +#. type: verbatim +#: ../edit/virt-edit.pod:48 +#, no-wrap +msgid "" +" virt-edit -d mydomain /boot/grub/grub.conf\n" +"\n" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:67 +#: ../edit/virt-edit.pod:50 #, no-wrap msgid "" -" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" +" virt-edit -d mydomain /etc/passwd\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:69 -msgid "To export just a subdirectory, eg. C, do:" +#: ../edit/virt-edit.pod:52 +msgid "For Windows guests, some Windows paths are understood:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:71 +#: ../edit/virt-edit.pod:54 #, no-wrap msgid "" -" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" +" virt-edit -d mywindomain 'c:\\autoexec.bat'\n" "\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:73 -msgid "Create empty disk images" -msgstr "" - #. type: textblock -#: ../examples/guestfs-recipes.pod:75 +#: ../edit/virt-edit.pod:56 msgid "" -"You can use the L I<-N> option to create empty disk images. " -"The useful guide below explains the options available." +"If Perl is installed, you can also edit files non-interactively (see L below). To change the init default level to 5:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:78 +#. type: verbatim +#: ../edit/virt-edit.pod:60 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/" -"#content" +" virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n" +"\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:80 -msgid "Dump raw filesystem content from inside a disk image or VM" +#. 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 -#: ../examples/guestfs-recipes.pod:82 +#: ../edit/virt-edit.pod:85 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):" +"Create a backup of the original file I. The backup " +"has the original filename with C added." 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 +#: ../edit/virt-edit.pod:88 msgid "" -" guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n" -"\n" +"Usually the first character of C would be a dot C<.> so you would " +"write:" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" #. type: verbatim -#: ../examples/guestfs-recipes.pod:88 +#: ../edit/virt-edit.pod:91 #, no-wrap msgid "" -" guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n" +" virt-edit -b .orig [etc]\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:90 -msgid "To list the filesystems in a disk image, use L." +#: ../edit/virt-edit.pod:93 +msgid "By default, no backup file is made." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:92 -msgid "Edit grub configuration in a VM" -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 -#: ../examples/guestfs-recipes.pod:94 -msgid "You can use this to:" +#: ../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 -#: ../examples/guestfs-recipes.pod:100 -msgid "Fix a virtual machine that does not boot." +#: ../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 -#: ../examples/guestfs-recipes.pod:104 -msgid "Change which kernel is used to boot the VM." +#: ../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 -#: ../examples/guestfs-recipes.pod:108 -msgid "Change kernel command line options." +#: ../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 -#: ../examples/guestfs-recipes.pod:112 -msgid "Use L to edit the grub configuration:" +#: ../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 -#: ../examples/guestfs-recipes.pod:114 +#: ../edit/virt-edit.pod:143 #, no-wrap msgid "" -" virt-edit -d BrokenGuest /boot/grub/grub.conf\n" +" virt-edit --format=raw -a disk.img file\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 +#: ../edit/virt-edit.pod:147 #, no-wrap msgid "" -" virt-rescue -d BrokenGuest\n" +" virt-edit --format=raw -a disk.img --format -a another.img file\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:" +#: ../edit/virt-edit.pod:181 +msgid "Previous versions of virt-edit allowed you to write either:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:126 -#, fuzzy, no-wrap -#| msgid "" -#| " copy-out /home .\n" -#| "\n" +#: ../edit/virt-edit.pod:187 +#, no-wrap msgid "" -" virt-copy-out -d Guest /home .\n" +" virt-edit guestname file\n" "\n" msgstr "" -" copy-out /home .\n" -"\n" + +#. type: =head1 +#: ../edit/virt-edit.pod:195 +msgid "NON-INTERACTIVE EDITING" +msgstr "НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ" #. type: textblock -#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9 -#: ../fish/guestfish-actions.pod:1292 ../fish/guestfish-actions.pod:1934 -#: ../src/guestfs-actions.pod:18 ../src/guestfs-actions.pod:1922 -#: ../src/guestfs-actions.pod:2860 ../src/guestfs.pod:1640 -#: ../tools/virt-win-reg.pl:706 -msgid "Notes:" -msgstr "Нотатки:" +#: ../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 -#: ../examples/guestfs-recipes.pod:134 +#: ../edit/virt-edit.pod:200 msgid "" -"The final dot of the command is not a printing error. It means we want to " -"copy out to the current directory." +"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 -#: ../examples/guestfs-recipes.pod:139 -msgid "This creates a directory called C under the current directory." +#: ../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 -#: ../examples/guestfs-recipes.pod:143 +#: ../edit/virt-edit.pod:210 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:" +"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 -#: ../examples/guestfs-recipes.pod:147 +#: ../edit/virt-edit.pod:214 #, no-wrap msgid "" -" virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" +" virt-edit -d domname filename -e 's/foo/bar/'\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:149 -msgid "To get the output as a compressed tarball, do:" +#: ../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 -#: ../examples/guestfs-recipes.pod:151 +#: ../edit/virt-edit.pod:219 #, no-wrap msgid "" -" virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" +" 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 -#: ../examples/guestfs-recipes.pod:153 +#: ../edit/virt-edit.pod:221 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" +"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 -#: ../examples/guestfs-recipes.pod:159 +#: ../edit/virt-edit.pod:226 msgid "" -"This simple script examines a Linux guest to find out which user is using " -"the most space in their home directory:" +"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 -#: ../examples/guestfs-recipes.pod:162 -#, fuzzy, no-wrap -#| msgid "" -#| " #!/usr/bin/guestfish -f\n" -#| "\n" +#: ../edit/virt-edit.pod:229 +#, no-wrap msgid "" -" #!/bin/sh -\n" -" \n" +" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n" +"\n" msgstr "" -" #!/usr/bin/guestfish -f\n" +" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n" "\n" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:164 -#, fuzzy, no-wrap -#| msgid "" -#| " set-qemu qemu\n" -#| "\n" +#. type: textblock +#: ../edit/virt-edit.pod:231 msgid "" -" set -e\n" -" \n" +"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 "" -" set-qemu qemu\n" -"\n" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:166 -#, no-wrap +#. type: textblock +#: ../edit/virt-edit.pod:237 msgid "" -" vm=\"$1\"\n" -" dir=/home\n" -" \n" +"The variable C<$lineno> contains the current line number. As is " +"traditional, the first line in the file is number C<1>." msgstr "" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:169 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --ro -d myguest -i\n" -#| "\n" +#. type: textblock +#: ../edit/virt-edit.pod:240 msgid "" -" eval $(guestfish --ro -d \"$vm\" -i --listen)\n" -" \n" +"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 "" -" guestfish --ro -d myguest -i\n" -"\n" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:171 -#, no-wrap +#. type: textblock +#: ../edit/virt-edit.pod:244 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" +"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 -#: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941 +#: ../edit/virt-edit.pod:249 #, no-wrap msgid "" -" guestfish --remote exit\n" +" /some text(\\r?\\n)?$/\n" "\n" msgstr "" +" /якийсь текст(\\r?\\n)?$/\n" +"\n" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:179 -msgid "Get DHCP address from a VM" +#. 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: textblock -#: ../examples/guestfs-recipes.pod:181 +#. type: verbatim +#: ../edit/virt-edit.pod:255 +#, no-wrap msgid "" -"The link below explains the many different possible techniques for getting " -"the last assigned DHCP address of a virtual machine." +" my $m = $_; chomp $m; $m =~ /some text$/\n" +"\n" msgstr "" +" my $m = $_; chomp $m; $m =~ /якийсь текст$/\n" +"\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:184 +#: ../edit/virt-edit.pod:259 msgid "" -"https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-" -"a-virtual-machine-disk-image/#content" +"C has a limited ability to understand Windows drive letters and " +"paths (eg. C)." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:186 +#: ../edit/virt-edit.pod:278 msgid "" -"In the libguestfs source examples directory you will find the latest version " -"of the C program." +"The path is resolved case insensitively to locate the file that should be " +"edited." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:189 -msgid "Get the operating system product name string" +#. 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 -#: ../examples/guestfs-recipes.pod:191 -msgid "Save the following script into a file called C:" +#: ../edit/virt-edit.pod:302 +msgid "Using C is approximately equivalent to doing:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:193 -#, fuzzy, no-wrap -#| msgid "" -#| " eval \"`guestfish --listen`\"\n" -#| " guestfish --remote add-ro disk.img\n" -#| " guestfish --remote run\n" -#| " guestfish --remote lvs\n" -#| "\n" +#: ../edit/virt-edit.pod:304 +#, 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" +" guestfish --rw -i -d domname edit /file\n" "\n" msgstr "" -" eval \"`guestfish --listen`\"\n" -" guestfish --remote add-ro disk.img\n" -" guestfish --remote run\n" -" guestfish --remote lvs\n" -"\n" #. 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 +#: ../edit/virt-edit.pod:306 msgid "" -" # product-name.sh RHEL60x64\n" -" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" -"\n" +"where C is the name of the libvirt guest, and C is the full " +"path to the file." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:205 +#: ../edit/virt-edit.pod:309 msgid "" -"You can also use an XPath query on the L XML using the " -"C command line tool or from your favourite programming language:" +"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 -#: ../examples/guestfs-recipes.pod:209 +#: ../edit/virt-edit.pod:314 #, 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" +" guestfish --rw -a disk.img -m /dev/sda1 edit /file\n" "\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:215 -msgid "Get the default boot kernel for a Linux VM" +#. 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 -#: ../examples/guestfs-recipes.pod:217 +#: ../edit/virt-edit.pod:320 msgid "" -"The link below contains a program to print the default boot kernel for a " -"Linux VM." +"C cannot create new files. Use the guestfish commands C, " +"C or C instead:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:220 +#. type: verbatim +#: ../edit/virt-edit.pod:323 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-" -"kernel-for-a-vm/#content" +" guestfish --rw -i -d domname touch /newfile\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:222 +#. type: verbatim +#: ../edit/virt-edit.pod:325 +#, no-wrap msgid "" -"It uses Augeas, and the technique is generally applicable for many different " -"tasks, such as:" +" guestfish --rw -i -d domname write /newfile \"new content\"\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:229 -msgid "listing the user accounts in the guest" +#. type: verbatim +#: ../edit/virt-edit.pod:327 +#, no-wrap +msgid "" +" guestfish --rw -i -d domname upload localfile /newfile\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:233 -msgid "what repositories is it configured to use" -msgstr "" +#. type: =head1 +#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1119 +#: ../rescue/virt-rescue.pod:261 ../sparsify/virt-sparsify.pod:231 +#: ../src/guestfs.pod:3214 ../test-tool/libguestfs-test-tool.pod:95 +msgid "ENVIRONMENT VARIABLES" +msgstr "ЗМІННІ СЕРЕДОВИЩА" -#. type: textblock -#: ../examples/guestfs-recipes.pod:237 -msgid "what NTP servers does it connect to" -msgstr "" +#. type: =item +#: ../edit/virt-edit.pod:333 +msgid "C" +msgstr "C" #. type: textblock -#: ../examples/guestfs-recipes.pod:241 -msgid "what were the boot messages last time it booted" +#: ../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 -#: ../examples/guestfs-recipes.pod:245 -msgid "listing who was logged in recently" +#: ../edit/virt-edit.pod:338 +msgid "If not set, C is used." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:249 -msgid "http://augeas.net/" +#: ../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: =head1 -#: ../examples/guestfs-recipes.pod:251 -msgid "Install RPMs in a guest" +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:5 +msgid "guestfs-erlang - How to use libguestfs from Erlang" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:253 +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:9 +#, no-wrap 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." +" {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 -#: ../examples/guestfs-recipes.pod:259 +#: ../erlang/examples/guestfs-erlang.pod:18 msgid "" -"https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content" +"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: =head1 -#: ../examples/guestfs-recipes.pod:261 -msgid "List applications installed in a VM" +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:23 +msgid "OPENING AND CLOSING THE HANDLE" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:263 -msgid "Save the following to a file C:" +#: ../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 -#: ../examples/guestfs-recipes.pod:265 -#, fuzzy, no-wrap -#| msgid "" -#| " eval \"`guestfish --listen`\"\n" -#| " guestfish --remote add-ro disk.img\n" -#| " guestfish --remote run\n" -#| " guestfish --remote lvs\n" -#| "\n" +#: ../erlang/examples/guestfs-erlang.pod:29 +#, 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-list-applications \"$root\"\n" -" guestfish --remote exit\n" -"\n" -msgstr "" -" eval \"`guestfish --listen`\"\n" -" guestfish --remote add-ro disk.img\n" -" guestfish --remote run\n" -" guestfish --remote lvs\n" +" {ok, G} = guestfs:create().\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 +#: ../erlang/examples/guestfs-erlang.pod:31 #, 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" +" {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\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." -msgstr "" - -#. type: =head1 -#: ../examples/guestfs-recipes.pod:309 -msgid "List files and directories in a VM" +#: ../erlang/examples/guestfs-erlang.pod:33 +msgid "C is the libguestfs handle which you should pass to other functions." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:311 -msgid "This involves using the L C command like this:" +#: ../erlang/examples/guestfs-erlang.pod:36 +msgid "To close the handle:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:313 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --ro -d myguest -i\n" -#| "\n" +#: ../erlang/examples/guestfs-erlang.pod:38 +#, no-wrap msgid "" -" guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n" +" ok = guestfs:close(G).\n" "\n" msgstr "" -" guestfish --ro -d myguest -i\n" -"\n" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:315 -msgid "List services in a Windows VM" +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:40 +msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:317 +#: ../erlang/examples/guestfs-erlang.pod:42 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." +"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: textblock -#: ../examples/guestfs-recipes.pod:321 +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:46 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/" -"#content" -msgstr "" - -#. type: =head1 -#: ../examples/guestfs-recipes.pod:323 -msgid "Make a disk image sparse" +" ok = guestfs:add_drive_opts(G, Disk,\n" +" [{format, \"raw\"}, {readonly, true}]).\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:325 -msgid "" -"The link below contains some guides for making a disk image sparse (or " -"reintroducing sparseness)." +#: ../erlang/examples/guestfs-erlang.pod:49 +msgid "If the last argument would be an empty list, you can also omit it:" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:328 +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:51 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content" +" ok = guestfs:add_drive_opts(G, Disk).\n" +"\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:330 -msgid "Monitor disk usage over time" +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:53 +msgid "RETURN VALUES AND ERRORS" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:332 +#: ../erlang/examples/guestfs-erlang.pod:55 msgid "" -"You can use L to monitor disk usage of your guests over time. " -"The link below contains a guide." +"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 -#: ../examples/guestfs-recipes.pod:335 -msgid "http://virt-tools.org/learning/advanced-virt-df/" +#: ../erlang/examples/guestfs-erlang.pod:59 +msgid "On error, you would see one of the following tuples:" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:337 -msgid "Reading the Windows Event Log from Windows Vista (or later)" +#. type: =item +#: ../erlang/examples/guestfs-erlang.pod:63 +msgid "C<{error, Msg, Errno}>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:339 -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." +#: ../erlang/examples/guestfs-erlang.pod:65 +msgid "This indicates an ordinary error from the function." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:343 +#: ../erlang/examples/guestfs-erlang.pod:67 msgid "" -"https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-" -"guestfish/#content" +"C is the error message (string) and C is the Unix error " +"(integer)." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:345 -msgid "Remove root password (Linux)" +#. 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 -#: ../examples/guestfs-recipes.pod:347 +#: ../erlang/examples/guestfs-erlang.pod:74 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:" +"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: verbatim -#: ../examples/guestfs-recipes.pod:350 -#, no-wrap -msgid "" -" virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n" -"\n" +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:78 +msgid "C is the name of the unknown function." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:352 -msgid "Remove Administrator password (Windows)" +#. type: =item +#: ../erlang/examples/guestfs-erlang.pod:80 +msgid "C<{unknownarg, Arg}>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:354 +#: ../erlang/examples/guestfs-erlang.pod:82 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:" +"This indicates that you called a function with optional arguments, with an " +"unknown argument name." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:359 -msgid "" -"https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-" -"administrator-password-with-guestfish/" +#: ../erlang/examples/guestfs-erlang.pod:85 +msgid "C is the name of the unknown argument." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:361 -msgid "Unpack a live CD" -msgstr "" +#: ../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 -#: ../examples/guestfs-recipes.pod:363 -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." -msgstr "" +#: ../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 -#: ../examples/guestfs-recipes.pod:367 +#: ../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 "" -"https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-" -"cd/#content" +"L, L, L, L, L, L, L, " +"L, L. L." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:369 -msgid "Uploading and downloading files" -msgstr "" +#: ../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 -#: ../examples/guestfs-recipes.pod:371 -msgid "" -"The link below contains general tips on uploading (copying in) and " -"downloading (copying out) files from VMs." -msgstr "" +#: ../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 -#: ../examples/guestfs-recipes.pod:374 -msgid "" -"https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content" +#: ../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: =head1 -#: ../examples/guestfs-recipes.pod:376 -msgid "Use libguestfs tools on VMware ESX guests" +#. 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 -#: ../examples/guestfs-recipes.pod:378 +#: ../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 "" -"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." +"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 -#: ../examples/guestfs-recipes.pod:382 +#: ../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 "" -"https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-" -"guests/#content" +"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 -#: ../examples/guestfs-recipes.pod:386 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." +#: ../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 "" -"L, L, L, L, " -"L, L, L, L, L." +"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 "" -"L, L, L, L, L, L, L, L, L." #. type: textblock -#: ../examples/guestfs-recipes.pod:402 -#, fuzzy -#| msgid "Copyright (C) 2009-2010 Red Hat Inc." -msgid "Copyright (C) 2009-2011 Red Hat Inc. L" -msgstr "© Red Hat Inc., 2009–2010" +#: ../examples/guestfs-examples.pod:5 +msgid "guestfs-examples - Examples of using libguestfs from C" +msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1 -msgid "add-cdrom" +#. type: verbatim +#: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9 +#, no-wrap +msgid "" +" #include \n" +" \n" msgstr "" +" #include \n" +" \n" #. type: verbatim -#: ../fish/guestfish-actions.pod:3 +#: ../examples/guestfs-examples.pod:11 #, no-wrap msgid "" -" add-cdrom filename\n" +" 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: textblock -#: ../fish/guestfish-actions.pod:5 ../src/guestfs-actions.pod:14 -msgid "This function adds a virtual CD-ROM disk image to the guest." +#. 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 -#: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16 -msgid "This is equivalent to the qemu parameter I<-cdrom filename>." +#: ../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 -#: ../fish/guestfish-actions.pod:15 +#: ../examples/guestfs-examples.pod:35 msgid "" -"This call checks for the existence of C. This stops you from " -"specifying other types of drive which are supported by qemu such as C " -"and C URLs. To specify those, use the general L call " -"instead." +"L, L, L, L, L, L, L, " +"L, L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:22 -msgid "" -"If you just want to add an ISO file (often you use this as an efficient way " -"to transfer large files into the guest), then you should probably use L instead." +#: ../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 -#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163 -#: ../fish/guestfish-actions.pod:177 +#: ../examples/guestfs-recipes.pod:5 msgid "" -"I In new code, use the L call " -"instead." +"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 -#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166 -#: ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:991 -#: ../fish/guestfish-actions.pod:1351 ../fish/guestfish-actions.pod:1365 -#: ../fish/guestfish-actions.pod:3090 ../fish/guestfish-actions.pod:3297 -#: ../fish/guestfish-actions.pod:3411 ../fish/guestfish-actions.pod:3459 -#: ../fish/guestfish-actions.pod:4360 ../fish/guestfish-actions.pod:4383 -#: ../fish/guestfish-actions.pod:4405 ../fish/guestfish-actions.pod:4443 -#: ../fish/guestfish-actions.pod:5092 ../fish/guestfish-actions.pod:5198 -#: ../src/guestfs-actions.pod:10 ../src/guestfs-actions.pod:252 -#: ../src/guestfs-actions.pod:273 ../src/guestfs-actions.pod:1508 -#: ../src/guestfs-actions.pod:2007 ../src/guestfs-actions.pod:2028 -#: ../src/guestfs-actions.pod:4623 ../src/guestfs-actions.pod:4926 -#: ../src/guestfs-actions.pod:5155 ../src/guestfs-actions.pod:5255 -#: ../src/guestfs-actions.pod:6521 ../src/guestfs-actions.pod:6565 -#: ../src/guestfs-actions.pod:6599 ../src/guestfs-actions.pod:6662 -#: ../src/guestfs-actions.pod:7594 ../src/guestfs-actions.pod:7703 -#: ../src/guestfs-actions.pod:7886 +#: ../examples/guestfs-recipes.pod:9 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 " -"these functions." +"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: =head2 -#: ../fish/guestfish-actions.pod:35 -msgid "add-domain" -msgstr "add-domain" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:37 -msgid "domain" +#. type: textblock +#: ../examples/guestfs-recipes.pod:16 +msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes" msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:39 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-recipes.pod:20 msgid "" -" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n" -"\n" +"This page contains recipes for and links to things you can do using " +"libguestfs, L and the virt tools." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:41 -msgid "" -"This function adds the disk(s) attached to the named libvirt domain C. " -"It works by connecting to libvirt, requesting the domain and domain XML from " -"libvirt, parsing it for disks, and calling L on each one." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:23 +msgid "Audit a virtual machine for setuid files" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:64 +#: ../examples/guestfs-recipes.pod:25 msgid "" -"The number of disks added is returned. This operation is atomic: if an " -"error is returned, then no disks are added." +"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 -#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:67 +#: ../examples/guestfs-recipes.pod:28 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 " -"to acquire the libvirt lock on each disk." +"https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-" +"files/#content" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:30 +msgid "Change the background image in a Windows XP VM" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:71 +#: ../examples/guestfs-recipes.pod:32 msgid "" -"Disks must be accessible locally. This often means that adding disks from a " -"remote libvirt connection (see L) will fail " -"unless those disks are accessible via the same device path locally too." +"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 -#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:76 +#: ../examples/guestfs-recipes.pod:37 msgid "" -"The optional C parameter sets the libvirt URI (see L). If this is not set then we connect to the default " -"libvirt URI (or one set through an environment variable, see the libvirt " -"documentation for full details)." +"https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://" +"lists.fedoraproject.org/pipermail/virt/2011-May/002658.html" +msgstr "" + +#. type: =head1 +#: ../examples/guestfs-recipes.pod:40 +msgid "Cloning a virtual machine (Linux)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:82 +#: ../examples/guestfs-recipes.pod:42 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 " -"EchannelE element in the libvirt XML definition. The default (if " -"the flag is omitted) is never to try. See L for more information." +"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 -#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:89 +#: ../examples/guestfs-recipes.pod:46 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 " -"first and looked up, and if that lookup fails then we treat C as a name " -"as usual." +"https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-" +"vm/#content" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:76 +#: ../examples/guestfs-recipes.pod:48 msgid "" -"The other optional parameters are passed directly through to L." +"Avoid L. Currently what to do about virt-clone is under " +"discussion." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:143 -#: ../fish/guestfish-actions.pod:573 ../fish/guestfish-actions.pod:1973 -#: ../fish/guestfish-actions.pod:3139 ../fish/guestfish-actions.pod:3312 -#: ../fish/guestfish-actions.pod:3447 -msgid "" -"This command has one or more optional arguments. See L." +#: ../examples/guestfs-recipes.pod:51 +msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:81 -msgid "add-drive" -msgstr "add-drive" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:53 +msgid "Cloning a virtual machine (Windows)" +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:83 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-recipes.pod:55 msgid "" -" add-drive filename\n" -"\n" +"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 "" -" add-drive назва_файла\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:85 +#: ../examples/guestfs-recipes.pod:60 msgid "" -"This function is the equivalent of calling L with no " -"optional parameters, so the disk is added writable, with the format being " -"detected automatically." +"https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-" +"list/2011-May/msg00019.html" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:89 -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 " -"RHBZ#642934. Specifying the format closes this security hole. Therefore " -"you should think about replacing calls to this function with calls to L, and specifying the format." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:63 +msgid "Convert a CD-ROM / DVD / ISO to a tarball" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:96 -msgid "add-drive-opts" -msgstr "add-drive-opts" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:98 -msgid "add" -msgstr "add" +#. type: textblock +#: ../examples/guestfs-recipes.pod:65 +msgid "This converts input C to output C:" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:100 +#: ../examples/guestfs-recipes.pod:67 #, no-wrap msgid "" -" add-drive-opts filename [readonly:..] [format:..] [iface:..]\n" +" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:102 ../src/guestfs-actions.pod:160 -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 " -"second time as C, and so on." +#: ../examples/guestfs-recipes.pod:69 +msgid "To export just a subdirectory, eg. C, do:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:107 ../src/guestfs-actions.pod:165 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:71 +#, no-wrap 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 " -"operations you want to perform (ie. read access if you just want to read the " -"image or write access if you want to modify the image)." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:113 ../src/guestfs-actions.pod:171 -msgid "This call checks that C exists." +" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" +"\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3101 -#: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4660 -msgid "The optional arguments are:" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:73 +msgid "Create empty disk images" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:119 ../src/guestfs-actions.pod:177 -msgid "C" -msgstr "C" - #. type: textblock -#: ../fish/guestfish-actions.pod:121 ../src/guestfs-actions.pod:179 +#: ../examples/guestfs-recipes.pod:75 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 " -"the end. The disk that you add is not modified." +"You can use the L I<-N> option to create empty disk images. " +"The useful guide below explains the options available." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:125 ../src/guestfs-actions.pod:183 -msgid "C" -msgstr "C" - #. type: textblock -#: ../fish/guestfish-actions.pod:127 +#: ../examples/guestfs-recipes.pod:78 msgid "" -"This forces the image format. If you omit this (or use L or L) then the format is automatically detected. Possible formats " -"include C and C." +"https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/" +"#content" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:131 ../src/guestfs-actions.pod:189 -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 " -"RHBZ#642934. Specifying the format closes this security hole." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:80 +msgid "Dump raw filesystem content from inside a disk image or VM" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:136 ../src/guestfs-actions.pod:194 -msgid "C" -msgstr "C" - #. type: textblock -#: ../fish/guestfish-actions.pod:138 +#: ../examples/guestfs-recipes.pod:82 msgid "" -"This rarely-used option lets you emulate the behaviour of the deprecated L call (q.v.)" +"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: =head2 -#: ../fish/guestfish-actions.pod:145 -msgid "add-drive-ro" -msgstr "add-drive-ro" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:147 -msgid "add-ro" -msgstr "add-ro" - #. type: verbatim -#: ../fish/guestfish-actions.pod:149 +#: ../examples/guestfs-recipes.pod:86 #, no-wrap msgid "" -" add-drive-ro filename\n" +" guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:151 -msgid "" -"This function is the equivalent of calling L with the " -"optional parameter C set to 1, so the disk " -"is added read-only, with the format being detected automatically." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:156 -msgid "add-drive-ro-with-if" -msgstr "" - #. type: verbatim -#: ../fish/guestfish-actions.pod:158 +#: ../examples/guestfs-recipes.pod:88 #, no-wrap msgid "" -" add-drive-ro-with-if filename iface\n" +" guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:160 -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 -msgid "add-drive-with-if" +#: ../examples/guestfs-recipes.pod:90 +msgid "To list the filesystems in a disk image, use L." msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:172 -#, no-wrap -msgid "" -" add-drive-with-if filename iface\n" -"\n" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:92 +msgid "Edit grub configuration in a VM" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:174 -msgid "" -"This is the same as L but it allows you to specify the QEMU " -"interface emulation to use at run time." +#: ../examples/guestfs-recipes.pod:94 +msgid "You can use this to:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:184 -msgid "aug-clear" +#. type: textblock +#: ../examples/guestfs-recipes.pod:100 +msgid "Fix a virtual machine that does not boot." msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:186 -#, no-wrap -msgid "" -" aug-clear augpath\n" -"\n" +#. type: textblock +#: ../examples/guestfs-recipes.pod:104 +msgid "Change which kernel is used to boot the VM." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:188 ../src/guestfs-actions.pod:290 -msgid "" -"Set the value associated with C to C. This is the same as the " -"L C command." +#: ../examples/guestfs-recipes.pod:108 +msgid "Change kernel command line options." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:191 -msgid "aug-close" +#. type: textblock +#: ../examples/guestfs-recipes.pod:112 +msgid "Use L to edit the grub configuration:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:193 +#: ../examples/guestfs-recipes.pod:114 #, no-wrap msgid "" -" aug-close\n" +" virt-edit -d BrokenGuest /boot/grub/grub.conf\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:195 +#: ../examples/guestfs-recipes.pod:116 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 " -"other Augeas functions." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:200 -msgid "aug-defnode" +"or for general tinkering inside an unbootable VM use L like " +"this:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:202 +#: ../examples/guestfs-recipes.pod:119 #, no-wrap msgid "" -" aug-defnode name expr val\n" +" virt-rescue -d BrokenGuest\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:204 ../src/guestfs-actions.pod:319 -msgid "" -"Defines a variable C whose value is the result of evaluating C." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:207 -msgid "" -"If C evaluates to an empty nodeset, a node is created, equivalent to " -"calling L C, C. C will be the nodeset " -"containing that single node." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:121 +msgid "Export any directory from a VM" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:211 ../src/guestfs-actions.pod:326 +#: ../examples/guestfs-recipes.pod:123 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 -msgid "aug-defvar" +"To export C from a VM into a local directory use L:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:217 +#: ../examples/guestfs-recipes.pod:126 ../examples/guestfs-testing.pod:93 #, no-wrap msgid "" -" aug-defvar name expr\n" +" virt-copy-out -d Guest /home .\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:219 ../src/guestfs-actions.pod:343 +#: ../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 "" -"Defines an Augeas variable C whose value is the result of evaluating " -"C. If C is NULL, then C is undefined." +"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 -#: ../fish/guestfish-actions.pod:223 ../src/guestfs-actions.pod:347 -msgid "" -"On success this returns the number of nodes in C, or C<0> if C " -"evaluates to something which is not a nodeset." +#: ../examples/guestfs-recipes.pod:139 +msgid "This creates a directory called C under the current directory." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:226 -msgid "aug-get" +#. 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 -#: ../fish/guestfish-actions.pod:228 +#: ../examples/guestfs-recipes.pod:147 #, no-wrap msgid "" -" aug-get augpath\n" +" virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:230 ../src/guestfs-actions.pod:360 -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 -msgid "aug-init" +#: ../examples/guestfs-recipes.pod:149 +msgid "To get the output as a compressed tarball, do:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:235 +#: ../examples/guestfs-recipes.pod:151 #, no-wrap msgid "" -" aug-init root flags\n" +" virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:237 ../src/guestfs-actions.pod:375 +#: ../examples/guestfs-recipes.pod:153 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 " -"closed." +"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: textblock -#: ../fish/guestfish-actions.pod:241 -msgid "You must call this before using any other L commands." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:157 +msgid "Find out which user is using the most space" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:244 ../src/guestfs-actions.pod:382 +#: ../examples/guestfs-recipes.pod:159 msgid "" -"C is the filesystem root. C must not be NULL, use C instead." +"This simple script examines a Linux guest to find out which user is using " +"the most space in their home directory:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:247 ../src/guestfs-actions.pod:385 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:162 +#, no-wrap 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 -msgid "C = 1" -msgstr "C = 1" - -#. type: textblock -#: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:393 -msgid "Keep the original file with a C<.augsave> extension." +" #!/bin/sh -\n" +" \n" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:257 ../src/guestfs-actions.pod:395 -msgid "C = 2" -msgstr "C = 2" - -#. type: textblock -#: ../fish/guestfish-actions.pod:259 ../src/guestfs-actions.pod:397 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:164 ../fish/guestfish.pod:984 +#, no-wrap msgid "" -"Save changes into a file with extension C<.augnew>, and do not overwrite " -"original. Overrides C." +" set -e\n" +" \n" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:400 -msgid "C = 4" -msgstr "C = 4" - -#. type: textblock -#: ../fish/guestfish-actions.pod:264 ../src/guestfs-actions.pod:402 -msgid "Typecheck lenses." +#. type: verbatim +#: ../examples/guestfs-recipes.pod:166 +#, no-wrap +msgid "" +" vm=\"$1\"\n" +" dir=/home\n" +" \n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:266 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:169 +#, no-wrap 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 " -"set the C environment variable or call L." +" eval $(guestfish --ro -d \"$vm\" -i --listen)\n" +" \n" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:271 ../src/guestfs-actions.pod:409 -msgid "C = 8" -msgstr "C = 8" - -#. type: textblock -#: ../fish/guestfish-actions.pod:273 ../src/guestfs-actions.pod:411 -msgid "Do not use standard load path for modules." +#. 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: =item -#: ../fish/guestfish-actions.pod:275 ../src/guestfs-actions.pod:413 -msgid "C = 16" -msgstr "C = 16" - -#. type: textblock -#: ../fish/guestfish-actions.pod:277 ../src/guestfs-actions.pod:415 -msgid "Make save a no-op, just record what would have been changed." +#. type: verbatim +#: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941 +#, no-wrap +msgid "" +" guestfish --remote exit\n" +"\n" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:279 ../src/guestfs-actions.pod:417 -msgid "C = 32" -msgstr "C = 32" - -#. type: textblock -#: ../fish/guestfish-actions.pod:281 -msgid "Do not load the tree in L." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:179 +msgid "Get DHCP address from a VM" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:285 -msgid "To close the handle, you can call L." +#: ../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 -#: ../fish/guestfish-actions.pod:287 ../src/guestfs-actions.pod:425 -msgid "To find out more about Augeas, see L." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:289 -msgid "aug-insert" -msgstr "" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:291 -#, no-wrap +#: ../examples/guestfs-recipes.pod:184 msgid "" -" aug-insert augpath label true|false\n" -"\n" +"https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-" +"a-virtual-machine-disk-image/#content" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:293 ../src/guestfs-actions.pod:439 +#: ../examples/guestfs-recipes.pod:186 msgid "" -"Create a new sibling C from the guest into the current directory." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:571 ../src/guestfs-actions.pod:861 -msgid "See also L." +#. type: =head2 +#: ../examples/guestfs-testing.pod:99 +msgid "Run virt-df." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:575 -msgid "case-sensitive-path" +#. type: textblock +#: ../examples/guestfs-testing.pod:101 +msgid "L lists disk space. Run:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:577 -#, no-wrap +#: ../examples/guestfs-testing.pod:103 +#, fuzzy, no-wrap +#| msgid "" +#| " df\n" +#| "\n" msgid "" -" case-sensitive-path path\n" +" virt-df\n" "\n" msgstr "" +" df\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:579 ../src/guestfs-actions.pod:895 -msgid "" -"This can be used to resolve case insensitive paths on a filesystem which is " -"case sensitive. The use case is to resolve paths which you have read from " -"Windows configuration files or the Windows Registry, to the true path." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:584 ../src/guestfs-actions.pod:900 +#: ../examples/guestfs-testing.pod:105 msgid "" -"The command handles a peculiarity of the Linux ntfs-3g filesystem driver " -"(and probably others), which is that although the underlying filesystem is " -"case-insensitive, the driver exports the filesystem to Linux as case-" -"sensitive." +"You can try comparing this to the results from L inside the guest, " +"but there are some provisos:" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:589 ../src/guestfs-actions.pod:905 -msgid "" -"One consequence of this is that special directories such as C " -"may appear as C or C (or other things) depending on the " -"precise details of how they were created. In Windows itself this would not " -"be a problem." +#: ../examples/guestfs-testing.pod:112 +msgid "The guest must be idle." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:595 ../src/guestfs-actions.pod:911 -msgid "" -"Bug or feature? You decide: L" +#: ../examples/guestfs-testing.pod:116 +msgid "The guest disks must be synched using L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:598 ../src/guestfs-actions.pod:914 +#: ../examples/guestfs-testing.pod:120 msgid "" -"This function resolves the true case of each element in the path and returns " -"the case-sensitive path." +"Any action such as booting the guest will write log files causing the " +"numbers to change." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:601 +#: ../examples/guestfs-testing.pod:125 msgid "" -"Thus L (\"/Windows/System32\") might return C<\"/" -"WINDOWS/system32\"> (the exact return value would depend on details of how " -"the directories were originally created under Windows)." +"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: textblock -#: ../fish/guestfish-actions.pod:606 ../src/guestfs-actions.pod:922 -msgid "I: This function does not handle drive names, backslashes etc." +#. type: =head2 +#: ../examples/guestfs-testing.pod:129 +msgid "Try importing virt-df CSV output into a spreadsheet or database." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:609 -msgid "See also L." +#: ../examples/guestfs-testing.pod:131 ../src/guestfs.pod:3088 +msgid "Run:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:611 -msgid "cat" -msgstr "cat" - #. type: verbatim -#: ../fish/guestfish-actions.pod:613 +#: ../examples/guestfs-testing.pod:133 #, no-wrap msgid "" -" cat path\n" +" virt-df --csv > /tmp/report.csv\n" "\n" msgstr "" -" cat шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:615 ../fish/guestfish-actions.pod:3842 -#: ../src/guestfs-actions.pod:938 ../src/guestfs-actions.pod:5837 -msgid "Return the contents of the file named C." +#: ../examples/guestfs-testing.pod:135 +msgid "" +"Now try to load this into your favorite spreadsheet or database. Are the " +"results reproduced faithfully in the spreadsheet/database?" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:617 +#: ../examples/guestfs-testing.pod:138 msgid "" -"Note that this function cannot correctly handle binary files (specifically, " -"files containing C<\\0> character which is treated as end of string). For " -"those you need to use the L or L functions which have " -"a more complex interface." +"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 -#: ../fish/guestfish-actions.pod:622 ../fish/guestfish-actions.pod:757 -#: ../fish/guestfish-actions.pod:769 ../fish/guestfish-actions.pod:945 -#: ../fish/guestfish-actions.pod:955 ../fish/guestfish-actions.pod:1022 -#: ../fish/guestfish-actions.pod:1032 ../fish/guestfish-actions.pod:1224 -#: ../fish/guestfish-actions.pod:1531 ../fish/guestfish-actions.pod:1541 -#: ../fish/guestfish-actions.pod:1569 ../fish/guestfish-actions.pod:1584 -#: ../fish/guestfish-actions.pod:1594 ../fish/guestfish-actions.pod:1613 -#: ../fish/guestfish-actions.pod:3712 ../fish/guestfish-actions.pod:3727 -#: ../fish/guestfish-actions.pod:3803 ../fish/guestfish-actions.pod:3820 -#: ../fish/guestfish-actions.pod:3835 ../fish/guestfish-actions.pod:4504 -#: ../fish/guestfish-actions.pod:4550 ../fish/guestfish-actions.pod:4635 -#: ../fish/guestfish-actions.pod:4650 ../fish/guestfish-actions.pod:5056 -#: ../fish/guestfish-actions.pod:5068 ../fish/guestfish-actions.pod:5086 -#: ../fish/guestfish-actions.pod:5103 ../fish/guestfish-actions.pod:5113 -#: ../fish/guestfish-actions.pod:5170 ../fish/guestfish-actions.pod:5180 -#: ../fish/guestfish-actions.pod:5209 ../fish/guestfish-actions.pod:5219 -#: ../src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:1127 -#: ../src/guestfs-actions.pod:1147 ../src/guestfs-actions.pod:1443 -#: ../src/guestfs-actions.pod:1462 ../src/guestfs-actions.pod:1565 -#: ../src/guestfs-actions.pod:1584 ../src/guestfs-actions.pod:1830 -#: ../src/guestfs-actions.pod:2301 ../src/guestfs-actions.pod:2320 -#: ../src/guestfs-actions.pod:2363 ../src/guestfs-actions.pod:2387 -#: ../src/guestfs-actions.pod:2404 ../src/guestfs-actions.pod:2433 -#: ../src/guestfs-actions.pod:5619 ../src/guestfs-actions.pod:5645 -#: ../src/guestfs-actions.pod:5776 ../src/guestfs-actions.pod:5802 -#: ../src/guestfs-actions.pod:5826 ../src/guestfs-actions.pod:6777 -#: ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:6978 -#: ../src/guestfs-actions.pod:7002 ../src/guestfs-actions.pod:7667 -#: ../src/guestfs-actions.pod:7687 ../src/guestfs-actions.pod:7720 -#: ../src/guestfs-actions.pod:7739 ../src/guestfs-actions.pod:7758 -#: ../src/guestfs-actions.pod:7852 ../src/guestfs-actions.pod:7871 -#: ../src/guestfs-actions.pod:7917 ../src/guestfs-actions.pod:7936 +#: ../examples/guestfs-testing.pod:143 msgid "" -"Because of the message protocol, there is a transfer limit of somewhere " -"between 2MB and 4MB. See L." +"L can edit files in guests. Try this command on a RHEL or " +"Fedora guest:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:625 -msgid "checksum" -msgstr "checksum" - #. type: verbatim -#: ../fish/guestfish-actions.pod:627 +#: ../examples/guestfs-testing.pod:146 #, no-wrap msgid "" -" checksum csumtype path\n" +" virt-edit LinuxGuest /etc/sysconfig/network\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:629 ../src/guestfs-actions.pod:960 -msgid "" -"This call computes the MD5, SHAx or CRC checksum of the file named C." +#: ../examples/guestfs-testing.pod:148 +msgid "On other Linux guests try editing other files such as:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:632 ../src/guestfs-actions.pod:963 +#. type: verbatim +#: ../examples/guestfs-testing.pod:150 +#, no-wrap msgid "" -"The type of checksum to compute is given by the C parameter which " -"must have one of the following values:" +" virt-edit LinuxGuest /etc/motd\n" +"\n" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:637 ../src/guestfs-actions.pod:968 -msgid "C" -msgstr "C" - #. type: textblock -#: ../fish/guestfish-actions.pod:639 ../src/guestfs-actions.pod:970 -msgid "" -"Compute the cyclic redundancy check (CRC) specified by POSIX for the " -"C command." +#: ../examples/guestfs-testing.pod:152 +msgid "Are the changes seen inside the guest when it is booted?" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:642 ../src/guestfs-actions.pod:973 -msgid "C" -msgstr "C" - -#. type: textblock -#: ../fish/guestfish-actions.pod:644 ../src/guestfs-actions.pod:975 -msgid "Compute the MD5 hash (using the C program)." +#. type: =head2 +#: ../examples/guestfs-testing.pod:154 +msgid "Display the filesystems / partitions / LVs in a guest." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:646 ../src/guestfs-actions.pod:977 -msgid "C" -msgstr "C" - #. type: textblock -#: ../fish/guestfish-actions.pod:648 ../src/guestfs-actions.pod:979 -msgid "Compute the SHA1 hash (using the C program)." +#: ../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: =item -#: ../fish/guestfish-actions.pod:650 ../src/guestfs-actions.pod:981 -msgid "C" -msgstr "C" - -#. type: textblock -#: ../fish/guestfish-actions.pod:652 ../src/guestfs-actions.pod:983 -msgid "Compute the SHA224 hash (using the C program)." +#. 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: =item -#: ../fish/guestfish-actions.pod:654 ../src/guestfs-actions.pod:985 -msgid "C" -msgstr "C" +#. type: verbatim +#: ../examples/guestfs-testing.pod:163 +#, fuzzy, no-wrap +#| msgid "" +#| " virt-filesystems [--options] -d domname\n" +#| "\n" +msgid "" +" virt-filesystems -d Guest --all --long -h\n" +"\n" +msgstr "" +" virt-filesystems [--параметри] -d назва_домену\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:656 ../src/guestfs-actions.pod:987 -msgid "Compute the SHA256 hash (using the C program)." +#: ../examples/guestfs-testing.pod:165 +msgid "Do the results match what is seen in the guest?" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:658 ../src/guestfs-actions.pod:989 -msgid "C" -msgstr "C" +#. type: =head2 +#: ../examples/guestfs-testing.pod:167 +msgid "Run virt-inspector on all your guests." +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:660 ../src/guestfs-actions.pod:991 -msgid "Compute the SHA384 hash (using the C program)." +#: ../examples/guestfs-testing.pod:169 +msgid "" +"Use L to get a report on all of your guests or disk " +"images:" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:662 ../src/guestfs-actions.pod:993 -msgid "C" -msgstr "C" +#. type: verbatim +#: ../examples/guestfs-testing.pod:172 +#, fuzzy, no-wrap +#| msgid "" +#| " virt-cat disk.img file\n" +#| "\n" +msgid "" +" virt-inspector -a /path/to/disk.img | less\n" +"\n" +msgstr "" +" virt-cat диск.img файл\n" +"\n" -#. type: textblock -#: ../fish/guestfish-actions.pod:664 ../src/guestfs-actions.pod:995 -msgid "Compute the SHA512 hash (using the C program)." +#. type: verbatim +#: ../examples/guestfs-testing.pod:176 +#, no-wrap +msgid "" +" virt-inspector -d Guest | less\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:668 ../src/guestfs-actions.pod:999 -msgid "The checksum is returned as a printable string." +#: ../examples/guestfs-testing.pod:178 +msgid "Do the results match what is actually in the guest?" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:670 -msgid "To get the checksum for a device, use L." +#. type: =head2 +#: ../examples/guestfs-testing.pod:180 +msgid "Try the auditing features of virt-ls on all your guests." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:672 -msgid "To get the checksums for many files, use L." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:674 -msgid "checksum-device" -msgstr "checksum-device" - #. type: verbatim -#: ../fish/guestfish-actions.pod:676 -#, no-wrap +#: ../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 "" -" checksum-device csumtype device\n" +" 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: textblock -#: ../fish/guestfish-actions.pod:678 +#. type: verbatim +#: ../examples/guestfs-testing.pod:188 +#, fuzzy, no-wrap +#| msgid "" +#| " $ virt-ls -R -d guest /tmp\n" +#| " foo\n" +#| " foo/bar\n" +#| " [etc.]\n" +#| "\n" msgid "" -"This call computes the MD5, SHAx or CRC checksum of the contents of the " -"device named C. For the types of checksums supported see the L command." +" virt-ls -lR -d Guest / | grep '^d ...7'\n" +"\n" msgstr "" +" $ virt-ls -R -d guest /tmp\n" +" foo\n" +" foo/bar\n" +" [тощо]\n" +"\n" -#. type: =head2 -#: ../fish/guestfish-actions.pod:682 -msgid "checksums-out" +#. 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: verbatim -#: ../fish/guestfish-actions.pod:684 +#: ../examples/guestfs-testing.pod:196 #, no-wrap msgid "" -" checksums-out csumtype directory (sumsfile|-)\n" +" virt-ls -lR -d Guest / | grep -i '^-.*\\.png$'\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:686 ../src/guestfs-actions.pod:1034 -msgid "" -"This command computes the checksums of all regular files in C and " -"then emits a list of those checksums to the local output file C." +#: ../examples/guestfs-testing.pod:198 +msgid "Display files larger than 10MB in home directories:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:690 ../src/guestfs-actions.pod:1038 +#. type: verbatim +#: ../examples/guestfs-testing.pod:200 +#, no-wrap msgid "" -"This can be used for verifying the integrity of a virtual machine. However " -"to be properly secure you should pay attention to the output of the checksum " -"command (it uses the ones from GNU coreutils). In particular when the " -"filename is not printable, coreutils uses a special backslash syntax. For " -"more information, see the GNU coreutils info file." +" virt-ls -lR -d Guest /home | awk '$3 > 10*1024*1024'\n" +"\n" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:700 -msgid "chmod" -msgstr "chmod" - #. type: verbatim -#: ../fish/guestfish-actions.pod:702 +#: ../examples/guestfs-testing.pod:204 #, no-wrap msgid "" -" chmod mode path\n" +" virt-ls -lR -d Guest --time-days / | awk '$6 <= 7'\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:704 ../src/guestfs-actions.pod:1057 +#. type: verbatim +#: ../examples/guestfs-testing.pod:208 +#, no-wrap msgid "" -"Change the mode (permissions) of C to C. Only numeric modes are " -"supported." +" virt-ls -lR -d Guest --time-days / | grep '^-' | awk '$6 < 1'\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1060 -msgid "" -"I: When using this command from guestfish, C by default would be " -"decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not " -"C<700>." +#: ../examples/guestfs-testing.pod:210 +msgid "Do the results match what is in the guest?" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:711 ../fish/guestfish-actions.pod:3065 -#: ../fish/guestfish-actions.pod:3204 ../fish/guestfish-actions.pod:3214 -#: ../fish/guestfish-actions.pod:3224 ../src/guestfs-actions.pod:1064 -#: ../src/guestfs-actions.pod:4591 ../src/guestfs-actions.pod:4800 -#: ../src/guestfs-actions.pod:4819 ../src/guestfs-actions.pod:4838 -msgid "The mode actually set is affected by the umask." +#. type: =head2 +#: ../examples/guestfs-testing.pod:212 +msgid "Create a disk image from a tarball." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:713 -msgid "chown" -msgstr "chown" +#. type: textblock +#: ../examples/guestfs-testing.pod:214 +msgid "" +"Use L to create a disk image from any tarball that you " +"happen to have:" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:715 +#: ../examples/guestfs-testing.pod:217 #, no-wrap msgid "" -" chown owner group path\n" +" virt-make-fs --partition=mbr --type=vfat /any/tarball.tar.gz output.img\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:717 ../src/guestfs-actions.pod:1078 -msgid "Change the file owner to C and group to C." +#: ../examples/guestfs-testing.pod:219 +msgid "" +"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 -#: ../fish/guestfish-actions.pod:719 ../fish/guestfish-actions.pod:2500 -#: ../src/guestfs-actions.pod:1080 ../src/guestfs-actions.pod:3662 -msgid "" -"Only numeric uid and gid are supported. If you want to use names, you will " -"need to locate and parse the password file yourself (Augeas support makes " -"this relatively easy)." +#: ../examples/guestfs-testing.pod:223 +msgid "Try other partitioning schemes, eg. I<--partition=gpt>." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:225 +msgid "Try other filesystem formats, eg. I<--type=ntfs>, I<--type=ext2>." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:723 -msgid "command" +#: ../examples/guestfs-testing.pod:227 +msgid "B<*> Run virt-rescue on a B disk image or guest." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:229 +msgid "" +"Use L to examine, rescue or repair a B guest or " +"disk image:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:725 -#, no-wrap +#: ../examples/guestfs-testing.pod:232 +#, fuzzy, no-wrap +#| msgid "" +#| " virt-cat disk.img file\n" +#| "\n" msgid "" -" command 'arguments ...'\n" +" virt-rescue -a /path/to/disk.img\n" "\n" msgstr "" +" virt-cat диск.img файл\n" +"\n" -#. type: textblock -#: ../fish/guestfish-actions.pod:727 ../src/guestfs-actions.pod:1094 +#. type: verbatim +#: ../examples/guestfs-testing.pod:236 +#, no-wrap msgid "" -"This call runs a command from the guest filesystem. The filesystem must be " -"mounted, and must contain a compatible operating system (ie. something " -"Linux, with the same or compatible processor architecture)." +" virt-rescue -d Guest\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:732 -msgid "" -"The single parameter is an argv-style list of arguments. The first element " -"is the name of the program to run. Subsequent elements are parameters. The " -"list must be non-empty (ie. must contain a program name). Note that the " -"command runs directly, and is I invoked via the shell (see L)." +#: ../examples/guestfs-testing.pod:238 +msgid "Can you use ordinary shell commands to examine the guest?" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:739 ../src/guestfs-actions.pod:1106 -msgid "The return value is anything printed to I by the command." +#. type: =head2 +#: ../examples/guestfs-testing.pod:240 +msgid "B<*> Resize your guests." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:742 ../src/guestfs-actions.pod:1109 +#: ../examples/guestfs-testing.pod:242 msgid "" -"If the command returns a non-zero exit status, then this function returns an " -"error message. The error message string is the content of I from " -"the command." +"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: textblock -#: ../fish/guestfish-actions.pod:746 ../src/guestfs-actions.pod:1113 +#. type: verbatim +#: ../examples/guestfs-testing.pod:246 +#, no-wrap msgid "" -"The C<$PATH> environment variable will contain at least C and C. If you require a program from another location, you should provide " -"the full path in the first parameter." +" 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: textblock -#: ../fish/guestfish-actions.pod:751 ../src/guestfs-actions.pod:1118 -msgid "" -"Shared libraries and data files required by the program must be available on " -"filesystems which are mounted in the correct places. It is the caller's " -"responsibility to ensure all filesystems that are needed are mounted at the " -"right locations." +#: ../examples/guestfs-testing.pod:251 +msgid "Does the guest still boot? Try expanding other partitions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:760 -msgid "command-lines" +#: ../examples/guestfs-testing.pod:253 +msgid "B<*> Sparsify a guest disk." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-testing.pod:255 +msgid "Using L, make a disk image more sparse:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:762 -#, no-wrap +#: ../examples/guestfs-testing.pod:257 +#, fuzzy, no-wrap +#| msgid "" +#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" +#| "\n" msgid "" -" command-lines 'arguments ...'\n" +" virt-sparsify /path/to/olddisk.img newdisk.img\n" "\n" msgstr "" +" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:764 +#: ../examples/guestfs-testing.pod:259 msgid "" -"This is the same as L, but splits the result into a list of lines." +"Is C still bootable after sparsifying? Is the resulting disk " +"image smaller (use C to check)?" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:767 -msgid "See also: L" +#. type: =head2 +#: ../examples/guestfs-testing.pod:262 +msgid "B<*> \"sysprep\" a B Linux guest." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:772 -msgid "config" +#. type: textblock +#: ../examples/guestfs-testing.pod:264 +msgid "" +"Note that this really will mess up an existing guest, so it's better to " +"clone the guest before trying this." msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:774 +#: ../examples/guestfs-testing.pod:267 #, no-wrap msgid "" -" config qemuparam qemuvalue\n" +" virt-sysprep --hostname newhost.example.com -a /path/to/disk.img\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:776 ../src/guestfs-actions.pod:1159 +#: ../examples/guestfs-testing.pod:269 msgid "" -"This can be used to add arbitrary qemu command line parameters of the form " -"I<-param value>. Actually it's not quite arbitrary - we prevent you from " -"setting some parameters which would interfere with parameters that we use." +"Was the sysprep successful? After booting, what changes were made and were " +"they successful?" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:781 ../src/guestfs-actions.pod:1164 -msgid "The first character of C string must be a C<-> (dash)." +#. type: =head2 +#: ../examples/guestfs-testing.pod:272 +msgid "Dump the Windows Registry from your Windows guests." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:783 ../src/guestfs-actions.pod:1166 -msgid "C can be NULL." +#: ../examples/guestfs-testing.pod:274 +msgid "" +"Use L to dump out the Windows Registry from any Windows " +"guests that you have." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:785 -msgid "copy-size" +#. type: verbatim +#: ../examples/guestfs-testing.pod:277 +#, no-wrap +msgid "" +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\Software' |\n" +" less\n" +"\n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:787 +#: ../examples/guestfs-testing.pod:280 #, no-wrap msgid "" -" copy-size src dest size\n" +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKLM\\System' |\n" +" less\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:789 ../src/guestfs-actions.pod:1180 -msgid "" -"This command copies exactly C bytes from one source device or file " -"C to another destination device or file C." +#: ../examples/guestfs-testing.pod:283 +msgid "Does the output match running C inside the guest?" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:792 ../src/guestfs-actions.pod:1183 +#: ../examples/guestfs-testing.pod:285 msgid "" -"Note this will fail if the source is too short or if the destination is not " -"large enough." +"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: =head2 -#: ../fish/guestfish-actions.pod:795 -msgid "cp" -msgstr "cp" - #. type: verbatim -#: ../fish/guestfish-actions.pod:797 +#: ../examples/guestfs-testing.pod:288 #, no-wrap msgid "" -" cp src dest\n" +" virt-win-reg --unsafe-printable-strings WindowsGuest 'HKEY_USERS\\username' |\n" +" less\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:799 ../src/guestfs-actions.pod:1202 +#: ../examples/guestfs-testing.pod:293 +#, fuzzy +#| msgid "" +#| "L, L, L, L, " +#| "L, L." msgid "" -"This copies a file from C to C where C is either a " -"destination filename or destination directory." +"L, L, L, L." msgstr "" +"L, L, L, L, L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:802 -msgid "cp-a" -msgstr "cp-a" +#: ../fish/guestfish-actions.pod:1 +msgid "add-cdrom" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:804 +#: ../fish/guestfish-actions.pod:3 #, no-wrap msgid "" -" cp-a src dest\n" +" add-cdrom filename\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:806 ../src/guestfs-actions.pod:1216 -msgid "" -"This copies a file or directory from C to C recursively using the " -"C command." +#: ../fish/guestfish-actions.pod:5 ../src/guestfs-actions.pod:14 +msgid "This function adds a virtual CD-ROM disk image to the guest." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:809 -msgid "dd" -msgstr "dd" +#. type: textblock +#: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16 +msgid "This is equivalent to the qemu parameter I<-cdrom filename>." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:811 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:15 msgid "" -" dd src dest\n" -"\n" +"This call checks for the existence of C. This stops you from " +"specifying other types of drive which are supported by qemu such as C " +"and C URLs. To specify those, use the general L call " +"instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:813 ../src/guestfs-actions.pod:1230 +#: ../fish/guestfish-actions.pod:22 msgid "" -"This command copies from one source device or file C to another " -"destination device or file C. Normally you would use this to copy to " -"or from a device or partition, for example to duplicate a filesystem." +"If you just want to add an ISO file (often you use this as an efficient way " +"to transfer large files into the guest), then you should probably use L instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:818 +#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:214 +#: ../fish/guestfish-actions.pod:228 msgid "" -"If the destination is a device, it must be as large or larger than the " -"source file or device, otherwise the copy will fail. This command cannot do " -"partial copies (see L)." +"I In new code, use the L call " +"instead." +msgstr "" + +#. type: textblock +#: ../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:3284 ../fish/guestfish-actions.pod:3595 +#: ../fish/guestfish-actions.pod:3643 ../fish/guestfish-actions.pod:4561 +#: ../fish/guestfish-actions.pod:4581 ../fish/guestfish-actions.pod:4600 +#: ../fish/guestfish-actions.pod:4638 ../fish/guestfish-actions.pod:5287 +#: ../fish/guestfish-actions.pod:5390 ../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:5076 +#: ../src/guestfs-actions.pod:5598 ../src/guestfs-actions.pod:5698 +#: ../src/guestfs-actions.pod:6994 ../src/guestfs-actions.pod:7035 +#: ../src/guestfs-actions.pod:7066 ../src/guestfs-actions.pod:7126 +#: ../src/guestfs-actions.pod:8058 ../src/guestfs-actions.pod:8167 +#: ../src/guestfs-actions.pod:8347 +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 " +"these functions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:822 -msgid "df" -msgstr "df" +#: ../fish/guestfish-actions.pod:35 +msgid "add-domain" +msgstr "add-domain" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:37 +msgid "domain" +msgstr "домен" #. type: verbatim -#: ../fish/guestfish-actions.pod:824 +#: ../fish/guestfish-actions.pod:39 #, no-wrap msgid "" -" df\n" +" add-domain dom [libvirturi:..] [readonly:true|false] [iface:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..]\n" "\n" msgstr "" -" df\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:826 ../src/guestfs-actions.pod:1248 -msgid "This command runs the C command to report disk space used." +#: ../fish/guestfish-actions.pod:41 +msgid "" +"This function adds the disk(s) attached to the named libvirt domain C. " +"It works by connecting to libvirt, requesting the domain and domain XML from " +"libvirt, parsing it for disks, and calling L on each one." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:828 ../fish/guestfish-actions.pod:839 +#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65 msgid "" -"This command is mostly useful for interactive sessions. It is I " -"intended that you try to parse the output string. Use L from " -"programs." +"The number of disks added is returned. This operation is atomic: if an " +"error is returned, then no disks are added." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:832 -msgid "df-h" -msgstr "df-h" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:834 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:68 msgid "" -" df-h\n" -"\n" +"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 " +"to acquire the libvirt lock on each disk." msgstr "" -" df-h\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:836 ../src/guestfs-actions.pod:1264 +#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72 msgid "" -"This command runs the C command to report disk space used in human-" -"readable format." +"Disks must be accessible locally. This often means that adding disks from a " +"remote libvirt connection (see L) will fail " +"unless those disks are accessible via the same device path locally too." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:843 -msgid "dmesg" -msgstr "dmesg" +#. type: textblock +#: ../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 " +"libvirt URI (or one set through an environment variable, see the libvirt " +"documentation for full details)." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:845 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83 msgid "" -" dmesg\n" -"\n" +"The optional C flag controls whether this call will try to connect to " +"a running virtual machine C process if it sees a suitable " +"EchannelE element in the libvirt XML definition. The default (if " +"the flag is omitted) is never to try. See L for more information." msgstr "" -" dmesg\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:847 ../src/guestfs-actions.pod:1281 +#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:90 msgid "" -"This returns the kernel messages (C output) from the guest kernel. " -"This is sometimes useful for extended debugging of problems." +"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 " +"first and looked up, and if that lookup fails then we treat C as a name " +"as usual." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:851 +#: ../fish/guestfish-actions.pod:76 ../src/guestfs-actions.pod:95 msgid "" -"Another way to get the same information is to enable verbose messages with " -"L or by setting the environment variable C " -"before running the program." +"The optional C parameter controls what we do for disks which " +"are marked Ereadonly/E in the libvirt XML. Possible values are:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:856 -msgid "download" -msgstr "download" +#. type: =item +#: ../fish/guestfish-actions.pod:82 ../src/guestfs-actions.pod:101 +msgid "readonlydisk = \"error\"" +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:858 -#, no-wrap -msgid "" -" download remotefilename (filename|-)\n" -"\n" +#. 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:860 ../fish/guestfish-actions.pod:873 -#: ../src/guestfs-actions.pod:1302 ../src/guestfs-actions.pod:1327 +#: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105 msgid "" -"Download file C and save it as C on the local " -"machine." +"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:863 ../fish/guestfish-actions.pod:4808 -#: ../src/guestfs-actions.pod:1305 ../src/guestfs-actions.pod:7237 -msgid "C can also be a named pipe." +#: ../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:865 -msgid "See also L, L." +#: ../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: =head2 -#: ../fish/guestfish-actions.pod:869 -msgid "download-offset" -msgstr "download-offset" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:871 -#, no-wrap -msgid "" -" download-offset remotefilename (filename|-) offset size\n" -"\n" +#. type: =item +#: ../fish/guestfish-actions.pod:93 ../src/guestfs-actions.pod:112 +msgid "readonlydisk = \"read\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:876 ../src/guestfs-actions.pod:1330 +#: ../fish/guestfish-actions.pod:97 ../src/guestfs-actions.pod:116 msgid "" -"C is read for C bytes starting at C (this " -"region must be within the file or device)." +"Disks with the Ereadonly/E flag are added read-only. Other disks " +"are added read/write." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:879 -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 " -"amount unless an error occurs." +#. type: =item +#: ../fish/guestfish-actions.pod:104 ../src/guestfs-actions.pod:123 +msgid "readonlydisk = \"write\" (default)" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:884 -msgid "See also L, L." +#: ../fish/guestfish-actions.pod:108 ../src/guestfs-actions.pod:127 +msgid "Disks with the Ereadonly/E flag are added read/write." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:888 -msgid "drop-caches" +#. type: =item +#: ../fish/guestfish-actions.pod:114 ../src/guestfs-actions.pod:133 +msgid "readonlydisk = \"ignore\"" msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:890 -#, no-wrap -msgid "" -" drop-caches whattodrop\n" -"\n" +#. 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:892 ../src/guestfs-actions.pod:1355 -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 " -"to drop, see L" +#: ../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:897 ../src/guestfs-actions.pod:1360 -msgid "Setting C to 3 should drop everything." +#: ../fish/guestfish-actions.pod:122 +msgid "" +"The other optional parameters are passed directly through to L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:899 ../src/guestfs-actions.pod:1362 +#: ../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:3333 ../fish/guestfish-actions.pod:3496 +#: ../fish/guestfish-actions.pod:3631 msgid "" -"This automatically calls L before the operation, so that the " -"maximum guest memory is freed." +"This command has one or more optional arguments. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:902 -msgid "du" -msgstr "du" +#: ../fish/guestfish-actions.pod:127 +msgid "add-drive" +msgstr "add-drive" #. type: verbatim -#: ../fish/guestfish-actions.pod:904 +#: ../fish/guestfish-actions.pod:129 #, no-wrap msgid "" -" du path\n" +" add-drive filename\n" "\n" msgstr "" -" du шлях\n" +" add-drive назва_файла\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:906 ../src/guestfs-actions.pod:1375 +#: ../fish/guestfish-actions.pod:131 msgid "" -"This command runs the C command to estimate file space usage for " -"C." +"This function is the equivalent of calling L with no " +"optional parameters, so the disk is added writable, with the format being " +"detected automatically." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:909 ../src/guestfs-actions.pod:1378 +#: ../fish/guestfish-actions.pod:135 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 " -"(recursively)." +"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 " +"RHBZ#642934. Specifying the format closes this security hole. Therefore " +"you should think about replacing calls to this function with calls to L, and specifying the format." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:913 ../src/guestfs-actions.pod:1382 -msgid "" -"The result is the estimated size in I (ie. units of 1024 bytes)." -msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:142 +msgid "add-drive-opts" +msgstr "add-drive-opts" #. type: =head2 -#: ../fish/guestfish-actions.pod:916 -msgid "e2fsck-f" -msgstr "e2fsck-f" +#: ../fish/guestfish-actions.pod:144 +msgid "add" +msgstr "add" #. type: verbatim -#: ../fish/guestfish-actions.pod:918 +#: ../fish/guestfish-actions.pod:146 #, no-wrap msgid "" -" e2fsck-f device\n" +" add-drive-opts filename [readonly:true|false] [format:..] [iface:..] [name:..]\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:920 ../src/guestfs-actions.pod:1400 +#: ../fish/guestfish-actions.pod:148 ../src/guestfs-actions.pod:208 msgid "" -"This runs C, ie. runs the ext2/ext3 filesystem checker " -"on C, noninteractively (I<-p>), even if the filesystem appears to be " -"clean (I<-f>)." +"This function adds a virtual machine disk image C to libguestfs. " +"The first time you call this function, the disk appears as C, the " +"second time as C, and so on." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:924 +#: ../fish/guestfish-actions.pod:153 ../src/guestfs-actions.pod:213 msgid "" -"This command is only needed because of L (q.v.). Normally you " -"should use L." +"You don't necessarily need to be root when using libguestfs. However you " +"obviously do need sufficient permissions to access the filename for whatever " +"operations you want to perform (ie. read access if you just want to read the " +"image or write access if you want to modify the image)." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:927 -msgid "echo-daemon" +#. type: textblock +#: ../fish/guestfish-actions.pod:159 ../src/guestfs-actions.pod:219 +msgid "This call checks that C exists." msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:929 -#, no-wrap -msgid "" -" echo-daemon 'words ...'\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3295 +#: ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5113 +msgid "The optional arguments are:" msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:165 ../src/guestfs-actions.pod:225 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:931 ../src/guestfs-actions.pod:1417 +#: ../fish/guestfish-actions.pod:167 ../src/guestfs-actions.pod:227 msgid "" -"This command concatenates the list of C passed with single spaces " -"between them and returns the resulting string." +"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 " +"the end. The disk that you add is not modified." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:934 ../src/guestfs-actions.pod:1420 -msgid "You can use this command to test the connection through to the daemon." +#: ../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 " +"include C and C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:936 -msgid "See also L." +#: ../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 " +"RHBZ#642934. Specifying the format closes this security hole." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:938 -msgid "egrep" -msgstr "egrep" +#. type: =item +#: ../fish/guestfish-actions.pod:182 ../src/guestfs-actions.pod:242 +msgid "C" +msgstr "C" -#. type: verbatim -#: ../fish/guestfish-actions.pod:940 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:184 msgid "" -" egrep regex path\n" -"\n" +"This rarely-used option lets you emulate the behaviour of the deprecated L call (q.v.)" +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:187 ../src/guestfs-actions.pod:247 +msgid "C" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:942 ../src/guestfs-actions.pod:1436 +#: ../fish/guestfish-actions.pod:189 ../src/guestfs-actions.pod:249 msgid "" -"This calls the external C program and returns the matching lines." +"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:948 -msgid "egrepi" -msgstr "egrepi" +#: ../fish/guestfish-actions.pod:196 +msgid "add-drive-ro" +msgstr "add-drive-ro" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:198 +msgid "add-ro" +msgstr "add-ro" #. type: verbatim -#: ../fish/guestfish-actions.pod:950 +#: ../fish/guestfish-actions.pod:200 #, no-wrap msgid "" -" egrepi regex path\n" +" add-drive-ro filename\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:952 ../src/guestfs-actions.pod:1455 +#: ../fish/guestfish-actions.pod:202 msgid "" -"This calls the external C program and returns the matching lines." +"This function is the equivalent of calling L with the " +"optional parameter C set to 1, so the disk " +"is added read-only, with the format being detected automatically." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:958 -msgid "equal" -msgstr "equal" +#: ../fish/guestfish-actions.pod:207 +msgid "add-drive-ro-with-if" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:960 +#: ../fish/guestfish-actions.pod:209 #, no-wrap msgid "" -" equal file1 file2\n" +" add-drive-ro-with-if filename iface\n" "\n" msgstr "" -" equal файл1 файл2\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:962 ../src/guestfs-actions.pod:1474 +#: ../fish/guestfish-actions.pod:211 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:965 ../src/guestfs-actions.pod:1477 -msgid "The external L program is used for the comparison." +"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:967 -msgid "exists" -msgstr "exists" +#: ../fish/guestfish-actions.pod:221 +msgid "add-drive-with-if" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:969 +#: ../fish/guestfish-actions.pod:223 #, no-wrap msgid "" -" exists path\n" +" add-drive-with-if filename iface\n" "\n" msgstr "" -" exists шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:971 ../src/guestfs-actions.pod:1489 +#: ../fish/guestfish-actions.pod:225 msgid "" -"This returns C if and only if there is a file, directory (or anything) " -"with the given C name." +"This is the same as L but it allows you to specify the QEMU " +"interface emulation to use at run time." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:974 -msgid "See also L, L, L." -msgstr "Див. також L, L, L." - #. type: =head2 -#: ../fish/guestfish-actions.pod:976 -msgid "fallocate" -msgstr "fallocate" +#: ../fish/guestfish-actions.pod:235 +msgid "aug-clear" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:978 +#: ../fish/guestfish-actions.pod:237 #, no-wrap msgid "" -" fallocate path len\n" +" aug-clear augpath\n" "\n" msgstr "" -" fallocate шлях довжина\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:980 ../fish/guestfish-actions.pod:999 -#: ../src/guestfs-actions.pod:1512 ../src/guestfs-actions.pod:1531 +#: ../fish/guestfish-actions.pod:239 ../src/guestfs-actions.pod:343 msgid "" -"This command preallocates a file (containing zero bytes) named C of " -"size C bytes. If the file exists already, it is overwritten." +"Set the value associated with C to C. This is the same as the " +"L C command." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:984 ../src/guestfs-actions.pod:1516 +#. type: =head2 +#: ../fish/guestfish-actions.pod:242 +msgid "aug-close" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:244 +#, no-wrap msgid "" -"Do not confuse this with the guestfish-specific C command which " -"allocates a file in the host and attaches it as a device." +" aug-close\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:988 +#: ../fish/guestfish-actions.pod:246 msgid "" -"I In new code, use the L call " -"instead." +"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 " +"other Augeas functions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:995 -msgid "fallocate64" -msgstr "fallocate64" +#: ../fish/guestfish-actions.pod:251 +msgid "aug-defnode" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:997 +#: ../fish/guestfish-actions.pod:253 #, no-wrap msgid "" -" fallocate64 path len\n" +" aug-defnode name expr val\n" "\n" msgstr "" -" fallocate64 шлях довжина\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1003 +#: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:372 msgid "" -"Note that this call allocates disk blocks for the file. To create a sparse " -"file use L instead." +"Defines a variable C whose value is the result of evaluating C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1006 +#: ../fish/guestfish-actions.pod:258 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 " -"maximum size of files created through that call to 1GB." +"If C evaluates to an empty nodeset, a node is created, equivalent to " +"calling L C, C. C will be the nodeset " +"containing that single node." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1011 ../src/guestfs-actions.pod:1543 +#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:379 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." +"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:1015 -msgid "fgrep" -msgstr "fgrep" +#: ../fish/guestfish-actions.pod:266 +msgid "aug-defvar" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1017 +#: ../fish/guestfish-actions.pod:268 #, no-wrap msgid "" -" fgrep pattern path\n" +" aug-defvar name expr\n" "\n" msgstr "" -" fgrep шаблон шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1019 ../src/guestfs-actions.pod:1558 +#: ../fish/guestfish-actions.pod:270 ../src/guestfs-actions.pod:396 msgid "" -"This calls the external C program and returns the matching lines." +"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: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:1025 -msgid "fgrepi" -msgstr "fgrepi" +#: ../fish/guestfish-actions.pod:277 +msgid "aug-get" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1027 +#: ../fish/guestfish-actions.pod:279 #, no-wrap msgid "" -" fgrepi pattern path\n" +" aug-get augpath\n" "\n" msgstr "" -" fgrepi шаблон шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1029 ../src/guestfs-actions.pod:1577 +#: ../fish/guestfish-actions.pod:281 ../src/guestfs-actions.pod:413 msgid "" -"This calls the external C program and returns the matching lines." +"Look up the value associated with C. If C matches exactly one " +"node, the C is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1035 -msgid "file" -msgstr "file" +#: ../fish/guestfish-actions.pod:284 +msgid "aug-init" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1037 +#: ../fish/guestfish-actions.pod:286 #, no-wrap msgid "" -" file path\n" -"\n" -msgstr "" -" file шлях\n" +" aug-init root flags\n" "\n" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1039 ../src/guestfs-actions.pod:1595 -msgid "" -"This call uses the standard L command to determine the type or " -"contents of the file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1042 ../src/guestfs-actions.pod:1598 +#: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:428 msgid "" -"This call will also transparently look inside various types of compressed " -"file." +"Create a new Augeas handle for editing configuration files. If there was " +"any previous Augeas handle associated with this guestfs session, then it is " +"closed." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1045 ../src/guestfs-actions.pod:1601 -msgid "" -"The exact command which runs is C. Note in particular that " -"the filename is not prepended to the output (the I<-b> option)." +#: ../fish/guestfish-actions.pod:292 +msgid "You must call this before using any other L commands." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1049 ../src/guestfs-actions.pod:1605 +#: ../fish/guestfish-actions.pod:295 ../src/guestfs-actions.pod:435 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 " -"is not guaranteed by the ABI." +"C is the filesystem root. C must not be NULL, use C instead." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1053 -msgid "" -"See also: L, L, L, L, L " -"(etc), L." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:1056 -msgid "file-architecture" -msgstr "file-architecture" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:1058 -#, no-wrap +#: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:438 msgid "" -" file-architecture filename\n" -"\n" +"The flags are the same as the flags defined in Eaugeas.hE, the " +"logical I of the following integers:" msgstr "" -" file-architecture назва_файла\n" -"\n" -#. type: textblock -#: ../fish/guestfish-actions.pod:1060 ../src/guestfs-actions.pod:1623 -msgid "" -"This detects the architecture of the binary C, and returns it if " -"known." -msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:304 ../src/guestfs-actions.pod:444 +msgid "C = 1" +msgstr "C = 1" #. type: textblock -#: ../fish/guestfish-actions.pod:1063 ../src/guestfs-actions.pod:1626 -msgid "Currently defined architectures are:" +#: ../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:1067 ../src/guestfs-actions.pod:1630 -msgid "\"i386\"" -msgstr "\"i386\"" +#: ../fish/guestfish-actions.pod:308 ../src/guestfs-actions.pod:448 +msgid "C = 2" +msgstr "C = 2" #. type: textblock -#: ../fish/guestfish-actions.pod:1069 ../src/guestfs-actions.pod:1632 +#: ../fish/guestfish-actions.pod:310 ../src/guestfs-actions.pod:450 msgid "" -"This string is returned for all 32 bit i386, i486, i586, i686 binaries " -"irrespective of the precise processor requirements of the binary." +"Save changes into a file with extension C<.augnew>, and do not overwrite " +"original. Overrides C." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1072 ../src/guestfs-actions.pod:1635 -msgid "\"x86_64\"" -msgstr "\"x86_64\"" +#: ../fish/guestfish-actions.pod:313 ../src/guestfs-actions.pod:453 +msgid "C = 4" +msgstr "C = 4" #. type: textblock -#: ../fish/guestfish-actions.pod:1074 ../src/guestfs-actions.pod:1637 -msgid "64 bit x86-64." -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:1076 ../src/guestfs-actions.pod:1639 -msgid "\"sparc\"" +#: ../fish/guestfish-actions.pod:315 ../src/guestfs-actions.pod:455 +msgid "Typecheck lenses." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1641 -msgid "32 bit SPARC." +#: ../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 " +"set the C environment variable or call L." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:1080 ../src/guestfs-actions.pod:1643 -msgid "\"sparc64\"" -msgstr "" +#: ../fish/guestfish-actions.pod:322 ../src/guestfs-actions.pod:462 +msgid "C = 8" +msgstr "C = 8" #. type: textblock -#: ../fish/guestfish-actions.pod:1082 ../src/guestfs-actions.pod:1645 -msgid "64 bit SPARC V9 and above." +#: ../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:1084 ../src/guestfs-actions.pod:1647 -msgid "\"ia64\"" -msgstr "\"ia64\"" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1086 ../src/guestfs-actions.pod:1649 -msgid "Intel Itanium." -msgstr "Intel Itanium." - -#. type: =item -#: ../fish/guestfish-actions.pod:1088 ../src/guestfs-actions.pod:1651 -msgid "\"ppc\"" -msgstr "" +#: ../fish/guestfish-actions.pod:326 ../src/guestfs-actions.pod:466 +msgid "C = 16" +msgstr "C = 16" #. type: textblock -#: ../fish/guestfish-actions.pod:1090 ../src/guestfs-actions.pod:1653 -msgid "32 bit Power PC." +#: ../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:1092 ../src/guestfs-actions.pod:1655 -msgid "\"ppc64\"" -msgstr "" +#: ../fish/guestfish-actions.pod:330 ../src/guestfs-actions.pod:470 +msgid "C = 32" +msgstr "C = 32" #. type: textblock -#: ../fish/guestfish-actions.pod:1094 ../src/guestfs-actions.pod:1657 -msgid "64 bit Power PC." +#: ../fish/guestfish-actions.pod:332 +msgid "Do not load the tree in L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1098 ../src/guestfs-actions.pod:1661 -msgid "Libguestfs may return other architecture strings in future." +#: ../fish/guestfish-actions.pod:336 +msgid "To close the handle, you can call L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1663 -msgid "The function works on at least the following types of files:" +#: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:478 +msgid "To find out more about Augeas, see L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1106 ../src/guestfs-actions.pod:1669 -msgid "many types of Un*x and Linux binary" +#. type: =head2 +#: ../fish/guestfish-actions.pod:340 +msgid "aug-insert" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1673 -msgid "many types of Un*x and Linux shared library" +#. type: verbatim +#: ../fish/guestfish-actions.pod:342 +#, no-wrap +msgid "" +" aug-insert augpath label true|false\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1114 ../src/guestfs-actions.pod:1677 -msgid "Windows Win32 and Win64 binaries" +#: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:492 +msgid "" +"Create a new sibling C, L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1735 -msgid "inspect-get-distro" -msgstr "inspect-get-distro" +#: ../fish/guestfish-actions.pod:1027 +msgid "download-offset" +msgstr "download-offset" #. type: verbatim -#: ../fish/guestfish-actions.pod:1737 +#: ../fish/guestfish-actions.pod:1029 #, no-wrap msgid "" -" inspect-get-distro root\n" +" download-offset remotefilename (filename|-) offset size\n" "\n" msgstr "" -" inspect-get-distro корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1739 ../src/guestfs-actions.pod:2616 +#: ../fish/guestfish-actions.pod:1034 ../src/guestfs-actions.pod:1742 msgid "" -"This returns the distro (distribution) of the inspected operating system." +"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:1742 ../src/guestfs-actions.pod:2619 -msgid "Currently defined distros are:" +#: ../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 " +"amount unless an error occurs." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1746 ../src/guestfs-actions.pod:2623 -msgid "\"archlinux\"" -msgstr "\"archlinux\"" - #. type: textblock -#: ../fish/guestfish-actions.pod:1748 ../src/guestfs-actions.pod:2625 -msgid "Arch Linux." -msgstr "Arch Linux." - -#. type: =item -#: ../fish/guestfish-actions.pod:1750 ../src/guestfs-actions.pod:2627 -msgid "\"centos\"" +#: ../fish/guestfish-actions.pod:1042 +msgid "See also L, L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2629 -msgid "CentOS." +#. type: =head2 +#: ../fish/guestfish-actions.pod:1046 +msgid "drop-caches" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1754 ../src/guestfs-actions.pod:2631 -msgid "\"debian\"" -msgstr "\"debian\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:1048 +#, no-wrap +msgid "" +" drop-caches whattodrop\n" +"\n" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1756 ../src/guestfs-actions.pod:2633 -msgid "Debian." -msgstr "Debian." - -#. type: =item -#: ../fish/guestfish-actions.pod:1758 ../src/guestfs-actions.pod:2635 -msgid "\"fedora\"" -msgstr "\"fedora\"" +#: ../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 " +"to drop, see L" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1760 ../src/guestfs-actions.pod:2637 -msgid "Fedora." -msgstr "Fedora." - -#. type: =item -#: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2639 -msgid "\"gentoo\"" -msgstr "\"gentoo\"" +#: ../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:1764 ../src/guestfs-actions.pod:2641 -msgid "Gentoo." -msgstr "Gentoo." - -#. type: =item -#: ../fish/guestfish-actions.pod:1766 ../src/guestfs-actions.pod:2643 -msgid "\"linuxmint\"" -msgstr "\"linuxmint\"" +#: ../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: textblock -#: ../fish/guestfish-actions.pod:1768 ../src/guestfs-actions.pod:2645 -msgid "Linux Mint." -msgstr "Linux Mint." +#. type: =head2 +#: ../fish/guestfish-actions.pod:1060 +msgid "du" +msgstr "du" -#. type: =item -#: ../fish/guestfish-actions.pod:1770 ../src/guestfs-actions.pod:2647 -msgid "\"mandriva\"" -msgstr "\"mandriva\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:1062 +#, no-wrap +msgid "" +" du path\n" +"\n" +msgstr "" +" du шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1772 ../src/guestfs-actions.pod:2649 -msgid "Mandriva." -msgstr "Mandriva." - -#. type: =item -#: ../fish/guestfish-actions.pod:1774 ../src/guestfs-actions.pod:2651 -msgid "\"meego\"" -msgstr "\"meego\"" +#: ../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:1776 ../src/guestfs-actions.pod:2653 -msgid "MeeGo." -msgstr "MeeGo." - -#. type: =item -#: ../fish/guestfish-actions.pod:1778 ../src/guestfs-actions.pod:2655 -msgid "\"pardus\"" -msgstr "\"pardus\"" +#: ../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 " +"(recursively)." +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1780 ../src/guestfs-actions.pod:2657 -msgid "Pardus." -msgstr "Pardus." - -#. type: =item -#: ../fish/guestfish-actions.pod:1782 ../src/guestfs-actions.pod:2659 -msgid "\"redhat-based\"" -msgstr "\"redhat-based\"" +#: ../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: textblock -#: ../fish/guestfish-actions.pod:1784 ../src/guestfs-actions.pod:2661 -msgid "Some Red Hat-derived distro." -msgstr "Дистрибутив, що походить від Red Hat." +#. type: =head2 +#: ../fish/guestfish-actions.pod:1074 +msgid "e2fsck-f" +msgstr "e2fsck-f" -#. type: =item -#: ../fish/guestfish-actions.pod:1786 ../src/guestfs-actions.pod:2663 -msgid "\"rhel\"" -msgstr "\"rhel\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:1076 +#, no-wrap +msgid "" +" e2fsck-f device\n" +"\n" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1788 ../src/guestfs-actions.pod:2665 -msgid "Red Hat Enterprise Linux." +#: ../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 " +"clean (I<-f>)." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1790 ../src/guestfs-actions.pod:2667 -msgid "\"scientificlinux\"" +#. type: textblock +#: ../fish/guestfish-actions.pod:1082 +msgid "" +"This command is only needed because of L (q.v.). Normally you " +"should use L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1792 ../src/guestfs-actions.pod:2669 -msgid "Scientific Linux." +#. type: =head2 +#: ../fish/guestfish-actions.pod:1085 +msgid "echo-daemon" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1794 ../src/guestfs-actions.pod:2671 -msgid "\"slackware\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:1087 +#, no-wrap +msgid "" +" echo-daemon 'words ...'\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1796 ../src/guestfs-actions.pod:2673 -msgid "Slackware." +#: ../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: =item -#: ../fish/guestfish-actions.pod:1798 ../src/guestfs-actions.pod:2675 -msgid "\"ubuntu\"" -msgstr "\"ubuntu\"" - #. type: textblock -#: ../fish/guestfish-actions.pod:1800 ../src/guestfs-actions.pod:2677 -msgid "Ubuntu." -msgstr "Ubuntu." - -#. type: =item -#: ../fish/guestfish-actions.pod:1802 ../fish/guestfish-actions.pod:1886 -#: ../fish/guestfish-actions.pod:2150 ../src/guestfs-actions.pod:2679 -#: ../src/guestfs-actions.pod:2788 ../src/guestfs-actions.pod:3163 -msgid "\"unknown\"" -msgstr "\"unknown\"" +#: ../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:1804 ../src/guestfs-actions.pod:2681 -msgid "The distro could not be determined." -msgstr "Дистрибутив, тип якого не вдалося визначити." +#: ../fish/guestfish-actions.pod:1094 +msgid "See also L." +msgstr "Див. також L." -#. type: =item -#: ../fish/guestfish-actions.pod:1806 ../fish/guestfish-actions.pod:2142 -#: ../src/guestfs-actions.pod:2683 ../src/guestfs-actions.pod:3155 -msgid "\"windows\"" -msgstr "\"windows\"" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1096 +msgid "egrep" +msgstr "egrep" -#. type: textblock -#: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2685 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1098 +#, no-wrap msgid "" -"Windows does not have distributions. This string is returned if the OS type " -"is Windows." +" egrep regex path\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1813 ../fish/guestfish-actions.pod:1892 -#: ../fish/guestfish-actions.pod:2156 ../src/guestfs-actions.pod:2690 -#: ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:3169 +#: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1848 msgid "" -"Future versions of libguestfs may return other strings here. The caller " -"should be prepared to handle any string." +"This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1818 -msgid "inspect-get-drive-mappings" -msgstr "" +#: ../fish/guestfish-actions.pod:1106 +msgid "egrepi" +msgstr "egrepi" #. type: verbatim -#: ../fish/guestfish-actions.pod:1820 +#: ../fish/guestfish-actions.pod:1108 #, no-wrap msgid "" -" inspect-get-drive-mappings root\n" +" egrepi regex path\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2706 +#: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1867 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 " -"Windows Registry to find out how disks/partitions are mapped to drive " -"letters, and returns a hash table as in the example below:" +"This calls the external C program and returns the matching lines." msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1116 +msgid "equal" +msgstr "equal" + #. type: verbatim -#: ../fish/guestfish-actions.pod:1828 ../src/guestfs-actions.pod:2712 +#: ../fish/guestfish-actions.pod:1118 #, no-wrap msgid "" -" C => /dev/vda2\n" -" E => /dev/vdb1\n" -" F => /dev/vdc1\n" +" equal file1 file2\n" "\n" msgstr "" +" equal файл1 файл2\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1832 ../src/guestfs-actions.pod:2716 +#: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1886 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 " -"character." +"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:1836 ../src/guestfs-actions.pod:2720 -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 " -"longer than 1 character. For example in OS-9, hard drives were named C, " -"C

etc." +#: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1889 +msgid "The external L program is used for the comparison." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1841 ../src/guestfs-actions.pod:2725 +#. type: =head2 +#: ../fish/guestfish-actions.pod:1125 +msgid "exists" +msgstr "exists" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1127 +#, no-wrap msgid "" -"For Windows guests, currently only hard drive mappings are returned. " -"Removable disks (eg. DVD-ROMs) are ignored." +" exists path\n" +"\n" msgstr "" +" exists шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1844 ../src/guestfs-actions.pod:2728 +#: ../fish/guestfish-actions.pod:1129 ../src/guestfs-actions.pod:1901 msgid "" -"For guests that do not use drive mappings, or if the drive mappings could " -"not be determined, this returns an empty hash table." +"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:1847 -msgid "" -"Please read L for more details. See also L, L." -msgstr "" +#: ../fish/guestfish-actions.pod:1132 +msgid "See also L, L, L." +msgstr "Див. також L, L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1851 -msgid "inspect-get-filesystems" -msgstr "inspect-get-filesystems" +#: ../fish/guestfish-actions.pod:1134 +msgid "fallocate" +msgstr "fallocate" #. type: verbatim -#: ../fish/guestfish-actions.pod:1853 +#: ../fish/guestfish-actions.pod:1136 #, no-wrap msgid "" -" inspect-get-filesystems root\n" +" fallocate path len\n" "\n" msgstr "" -" inspect-get-filesystems корінь\n" +" fallocate шлях довжина\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1855 ../src/guestfs-actions.pod:2749 +#: ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1157 +#: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1943 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 " -"filesystems, and non-mounted devices like swap partitions." +"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:1860 ../src/guestfs-actions.pod:2754 +#: ../fish/guestfish-actions.pod:1142 ../src/guestfs-actions.pod:1928 msgid "" -"In the case of a multi-boot virtual machine, it is possible for a filesystem " -"to be shared between operating systems." +"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:1863 +#: ../fish/guestfish-actions.pod:1146 msgid "" -"Please read L for more details. See also L." +"I In new code, use the L call " +"instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1866 -msgid "inspect-get-format" -msgstr "inspect-get-format" +#: ../fish/guestfish-actions.pod:1153 +msgid "fallocate64" +msgstr "fallocate64" #. type: verbatim -#: ../fish/guestfish-actions.pod:1868 +#: ../fish/guestfish-actions.pod:1155 #, no-wrap msgid "" -" inspect-get-format root\n" +" fallocate64 path len\n" "\n" msgstr "" -" inspect-get-format корінь\n" +" fallocate64 шлях довжина\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1870 ../src/guestfs-actions.pod:2772 +#: ../fish/guestfish-actions.pod:1161 msgid "" -"This returns the format of the inspected operating system. You can use it " -"to detect install images, live CDs and similar." +"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:1873 ../src/guestfs-actions.pod:2775 -msgid "Currently defined formats are:" -msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:1877 ../src/guestfs-actions.pod:2779 -msgid "\"installed\"" -msgstr "\"installed\"" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1879 ../src/guestfs-actions.pod:2781 -msgid "This is an installed operating system." -msgstr "Це встановлена операційна система." - -#. type: =item -#: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2783 -msgid "\"installer\"" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1883 ../src/guestfs-actions.pod:2785 +#: ../fish/guestfish-actions.pod:1164 msgid "" -"The disk image being inspected is not an installed operating system, but a " -"I install disk, live CD, or similar." +"The deprecated call L does the same, but owing to an oversight " +"it only allowed 30 bit lengths to be specified, effectively limiting the " +"maximum size of files created through that call to 1GB." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1888 ../src/guestfs-actions.pod:2790 -msgid "The format of this disk image is not known." +#: ../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:1897 -msgid "inspect-get-hostname" -msgstr "inspect-get-hostname" +#: ../fish/guestfish-actions.pod:1173 +msgid "fgrep" +msgstr "fgrep" #. type: verbatim -#: ../fish/guestfish-actions.pod:1899 +#: ../fish/guestfish-actions.pod:1175 #, no-wrap msgid "" -" inspect-get-hostname root\n" +" fgrep pattern path\n" "\n" msgstr "" -" inspect-get-hostname корінь\n" +" fgrep шаблон шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1901 ../src/guestfs-actions.pod:2810 +#: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:1970 msgid "" -"This function returns the hostname of the operating system as found by " -"inspection of the guest's configuration files." +"This calls the external C program and returns the matching lines." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:1183 +msgid "fgrepi" +msgstr "fgrepi" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1185 +#, no-wrap +msgid "" +" fgrepi pattern path\n" +"\n" msgstr "" +" fgrepi шаблон шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1904 ../src/guestfs-actions.pod:2813 +#: ../fish/guestfish-actions.pod:1187 ../src/guestfs-actions.pod:1989 msgid "" -"If the hostname could not be determined, then the string C is " -"returned." +"This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1909 -msgid "inspect-get-icon" -msgstr "" +#: ../fish/guestfish-actions.pod:1193 +msgid "file" +msgstr "file" #. type: verbatim -#: ../fish/guestfish-actions.pod:1911 +#: ../fish/guestfish-actions.pod:1195 #, no-wrap msgid "" -" inspect-get-icon root [favicon:..] [highquality:..]\n" +" file path\n" "\n" msgstr "" +" file шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1913 ../src/guestfs-actions.pod:2839 +#: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:2007 msgid "" -"This function returns an icon corresponding to the inspected operating " -"system. The icon is returned as a buffer containing a PNG image (re-encoded " -"to PNG if necessary)." +"This call uses the standard L command to determine the type or " +"contents of the file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1917 ../src/guestfs-actions.pod:2843 +#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2010 msgid "" -"If it was not possible to get an icon this function returns a zero-length " -"(non-NULL) buffer. I." +"This call will also transparently look inside various types of compressed " +"file." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1920 ../src/guestfs-actions.pod:2846 +#: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2013 msgid "" -"Libguestfs will start by looking for a file called C or " -"C and if it has the correct format, the contents of " -"this file will be returned. You can disable favicons by passing the " -"optional C boolean as false (default is true)." +"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:1926 ../src/guestfs-actions.pod:2852 +#: ../fish/guestfish-actions.pod:1207 ../src/guestfs-actions.pod:2017 msgid "" -"If finding the favicon fails, then we look in other places in the guest for " -"a suitable icon." +"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 " +"is not guaranteed by the ABI." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1929 ../src/guestfs-actions.pod:2855 +#: ../fish/guestfish-actions.pod:1211 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 " -"channel. The default (false) is to return any icon we can, even if it is of " -"substandard quality." +"See also: L, L, L, L, L " +"(etc), L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:2866 +#. type: =head2 +#: ../fish/guestfish-actions.pod:1214 +msgid "file-architecture" +msgstr "file-architecture" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1216 +#, no-wrap msgid "" -"Unlike most other inspection API calls, the guest's disks must be mounted up " -"before you call this, since it needs to read information from the guest " -"filesystem during the call." +" file-architecture filename\n" +"\n" msgstr "" +" file-architecture назва_файла\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:2872 +#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2035 msgid "" -"B The icon data comes from the untrusted guest, and should be " -"treated with caution. PNG files have been known to contain exploits. " -"Ensure that libpng (or other relevant libraries) are fully up to date before " -"trying to process or display the icon." +"This detects the architecture of the binary C, and returns it if " +"known." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:2880 -msgid "" -"The PNG image returned can be any size. It might not be square. Libguestfs " -"tries to return the largest, highest quality icon available. The " -"application must scale the icon to the required size." +#: ../fish/guestfish-actions.pod:1221 ../src/guestfs-actions.pod:2038 +msgid "Currently defined architectures are:" msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:1225 ../src/guestfs-actions.pod:2042 +msgid "\"i386\"" +msgstr "\"i386\"" + #. type: textblock -#: ../fish/guestfish-actions.pod:1961 ../src/guestfs-actions.pod:2887 +#: ../fish/guestfish-actions.pod:1227 ../src/guestfs-actions.pod:2044 msgid "" -"Extracting icons from Windows guests requires the external C " -"program from the C package, and several programs (C, " -"C, C) from the C package. These must be " -"installed separately." +"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:1230 ../src/guestfs-actions.pod:2047 +msgid "\"x86_64\"" +msgstr "\"x86_64\"" + #. type: textblock -#: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:2894 -msgid "" -"Operating system icons are usually trademarks. Seek legal advice before " -"using trademarks in applications." +#: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2049 +msgid "64 bit x86-64." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1975 -msgid "inspect-get-major-version" -msgstr "inspect-get-major-version" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:1977 -#, no-wrap -msgid "" -" inspect-get-major-version root\n" -"\n" +#. type: =item +#: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2051 +msgid "\"sparc\"" msgstr "" -" inspect-get-major-version корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1979 ../src/guestfs-actions.pod:2935 -msgid "" -"This returns the major version number of the inspected operating system." +#: ../fish/guestfish-actions.pod:1236 ../src/guestfs-actions.pod:2053 +msgid "32 bit SPARC." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:2938 -msgid "" -"Windows uses a consistent versioning scheme which is I reflected in the " -"popular public names used by the operating system. Notably the operating " -"system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = " -"1). You can find out the real versions corresponding to releases of Windows " -"by consulting Wikipedia or MSDN." +#. type: =item +#: ../fish/guestfish-actions.pod:1238 ../src/guestfs-actions.pod:2055 +msgid "\"sparc64\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1989 ../fish/guestfish-actions.pod:2000 -#: ../src/guestfs-actions.pod:2945 ../src/guestfs-actions.pod:2962 -msgid "If the version could not be determined, then C<0> is returned." +#: ../fish/guestfish-actions.pod:1240 ../src/guestfs-actions.pod:2057 +msgid "64 bit SPARC V9 and above." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1993 -msgid "inspect-get-minor-version" -msgstr "inspect-get-minor-version" +#. type: =item +#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2059 +msgid "\"ia64\"" +msgstr "\"ia64\"" -#. type: verbatim -#: ../fish/guestfish-actions.pod:1995 -#, no-wrap -msgid "" -" inspect-get-minor-version root\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1244 ../src/guestfs-actions.pod:2061 +msgid "Intel Itanium." +msgstr "Intel Itanium." + +#. type: =item +#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2063 +msgid "\"ppc\"" msgstr "" -" inspect-get-minor-version корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1997 ../src/guestfs-actions.pod:2959 -msgid "" -"This returns the minor version number of the inspected operating system." +#: ../fish/guestfish-actions.pod:1248 ../src/guestfs-actions.pod:2065 +msgid "32 bit Power PC." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2002 -msgid "" -"Please read L for more details. See also L." +#. type: =item +#: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2067 +msgid "\"ppc64\"" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2005 -msgid "inspect-get-mountpoints" -msgstr "inspect-get-mountpoints" +#. type: textblock +#: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:2069 +msgid "64 bit Power PC." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2007 -#, no-wrap -msgid "" -" inspect-get-mountpoints root\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2073 +msgid "Libguestfs may return other architecture strings in future." msgstr "" -" inspect-get-mountpoints корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2009 ../src/guestfs-actions.pod:2977 -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 " -"best an educated guess made by reading configuration files such as C. I that this may return filesystems which are " -"non-existent or not mountable and callers should be prepared to handle or " -"ignore failures if they try to mount them." +#: ../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:2018 ../src/guestfs-actions.pod:2986 -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 " -"mounted there (eg. C)." +#: ../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:2023 ../src/guestfs-actions.pod:2991 -msgid "" -"Non-mounted devices such as swap devices are I returned in this list." +#: ../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:2026 -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 " -"information about the mapping of drive letters to partitions, see L." +#: ../fish/guestfish-actions.pod:1272 ../src/guestfs-actions.pod:2089 +msgid "Windows Win32 and Win64 binaries" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2032 -msgid "" -"Please read L for more details. See also L." +#: ../fish/guestfish-actions.pod:1276 ../src/guestfs-actions.pod:2093 +msgid "Windows Win32 and Win64 DLLs" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2035 -msgid "inspect-get-package-format" -msgstr "inspect-get-package-format" +#. type: textblock +#: ../fish/guestfish-actions.pod:1278 ../src/guestfs-actions.pod:2095 +msgid "Win32 binaries and DLLs return C." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2037 -#, no-wrap -msgid "" -" inspect-get-package-format root\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2097 +msgid "Win64 binaries and DLLs return C." msgstr "" -" inspect-get-package-format корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2039 -msgid "" -"This function and L return the package " -"format and package management tool used by the inspected operating system. " -"For example for Fedora these functions would return C (package format) " -"and C (package management)." +#: ../fish/guestfish-actions.pod:1284 ../src/guestfs-actions.pod:2101 +msgid "Linux kernel modules" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2045 ../src/guestfs-actions.pod:3023 -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 " -"(eg. Windows)." +#: ../fish/guestfish-actions.pod:1288 ../src/guestfs-actions.pod:2105 +msgid "Linux new-style initrd images" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2049 ../src/guestfs-actions.pod:3027 -msgid "" -"Possible strings include: C, C, C, C, C. " -"Future versions of libguestfs may return other strings." +#: ../fish/guestfish-actions.pod:1292 ../src/guestfs-actions.pod:2109 +msgid "some non-x86 Linux vmlinuz kernels" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2054 -msgid "inspect-get-package-management" -msgstr "inspect-get-package-management" +#. type: textblock +#: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:2113 +msgid "What it can't do currently:" +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2056 -#, no-wrap -msgid "" -" inspect-get-package-management root\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1302 ../src/guestfs-actions.pod:2119 +msgid "static libraries (libfoo.a)" msgstr "" -" inspect-get-package-management корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2058 -msgid "" -"L and this function return the package format " -"and package management tool used by the inspected operating system. For " -"example for Fedora these functions would return C (package format) and " -"C (package management)." +#: ../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:2064 ../src/guestfs-actions.pod:3049 -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 " -"system (eg. Windows)." +#: ../fish/guestfish-actions.pod:1310 ../src/guestfs-actions.pod:2127 +msgid "x86 Linux vmlinuz kernels" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3053 +#: ../fish/guestfish-actions.pod:1312 ../src/guestfs-actions.pod:2129 msgid "" -"Possible strings include: C, C, C (for all Debian " -"derivatives), C, C, C, C. Future versions of " -"libguestfs may return other strings." +"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 " +"architecture of a kernel, use the architecture of the associated initrd or " +"kernel module(s) instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2075 -msgid "inspect-get-product-name" -msgstr "inspect-get-product-name" +#: ../fish/guestfish-actions.pod:1319 +msgid "filesize" +msgstr "filesize" #. type: verbatim -#: ../fish/guestfish-actions.pod:2077 +#: ../fish/guestfish-actions.pod:1321 #, no-wrap msgid "" -" inspect-get-product-name root\n" +" filesize file\n" "\n" msgstr "" -" inspect-get-product-name корінь\n" +" filesize файл\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3071 -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 " -"user, but should not be parsed by programs." +#: ../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:2084 ../src/guestfs-actions.pod:3076 +#: ../fish/guestfish-actions.pod:1325 msgid "" -"If the product name could not be determined, then the string C is " -"returned." +"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:2089 -msgid "inspect-get-product-variant" -msgstr "" +#: ../fish/guestfish-actions.pod:1329 +msgid "fill" +msgstr "fill" #. type: verbatim -#: ../fish/guestfish-actions.pod:2091 +#: ../fish/guestfish-actions.pod:1331 #, no-wrap msgid "" -" inspect-get-product-variant root\n" +" fill c len path\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2093 ../src/guestfs-actions.pod:3092 -msgid "This returns the product variant of the inspected operating system." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2096 ../src/guestfs-actions.pod:3095 +#: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:2165 msgid "" -"For Windows guests, this returns the contents of the Registry key C C which " -"is usually a string such as C or C (other values are " -"possible). This can be used to distinguish consumer and enterprise versions " -"of Windows that have the same version number (for example, Windows 7 and " -"Windows 2008 Server are both version 6.1, but the former is C and " -"the latter is C)." +"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<" +"[0..255]>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2105 ../src/guestfs-actions.pod:3104 +#: ../fish/guestfish-actions.pod:1337 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 " -"implemented at present." +"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 " +"L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2109 ../src/guestfs-actions.pod:3108 +#. type: =head2 +#: ../fish/guestfish-actions.pod:1342 +msgid "fill-pattern" +msgstr "fill-pattern" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1344 +#, no-wrap msgid "" -"If the product variant could not be determined, then the string C " -"is returned." +" fill-pattern pattern len path\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2112 +#: ../fish/guestfish-actions.pod:1346 msgid "" -"Please read L for more details. See also L, L." +"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 " +"is truncated if necessary to ensure the length of the file is exactly C " +"bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2116 -msgid "inspect-get-roots" -msgstr "inspect-get-roots" +#: ../fish/guestfish-actions.pod:1351 +msgid "find" +msgstr "find" #. type: verbatim -#: ../fish/guestfish-actions.pod:2118 +#: ../fish/guestfish-actions.pod:1353 #, no-wrap msgid "" -" inspect-get-roots\n" +" find directory\n" "\n" msgstr "" -" inspect-get-roots\n" +" find каталог\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2120 +#: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2211 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 " -"whole inspection process." +"This command lists out all files and directories, recursively, starting at " +"C. It is essentially equivalent to running the shell command " +"C but some post-processing happens on the output, " +"described below." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2124 +#: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2216 msgid "" -"This returns an empty list if either no root devices were found or the " -"caller has not called L." +"This returns a list of strings I. Thus if the directory " +"structure was:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2129 -msgid "inspect-get-type" -msgstr "inspect-get-type" - #. type: verbatim -#: ../fish/guestfish-actions.pod:2131 +#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2219 #, no-wrap msgid "" -" inspect-get-type root\n" +" /tmp/a\n" +" /tmp/b\n" +" /tmp/c/d\n" "\n" msgstr "" -" inspect-get-type корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2133 ../src/guestfs-actions.pod:3146 -msgid "" -"This returns the type of the inspected operating system. Currently defined " -"types are:" +#: ../fish/guestfish-actions.pod:1367 +msgid "then the returned list from L C would be 4 elements:" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3151 -msgid "\"linux\"" -msgstr "\"linux\"" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2140 ../src/guestfs-actions.pod:3153 -msgid "Any Linux-based operating system." +#. type: verbatim +#: ../fish/guestfish-actions.pod:1370 ../src/guestfs-actions.pod:2226 +#, no-wrap +msgid "" +" a\n" +" b\n" +" c\n" +" c/d\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3157 -msgid "Any Microsoft Windows operating system." +#: ../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: =item -#: ../fish/guestfish-actions.pod:2146 ../src/guestfs-actions.pod:3159 -msgid "\"freebsd\"" -msgstr "\"freebsd\"" - #. type: textblock -#: ../fish/guestfish-actions.pod:2148 ../src/guestfs-actions.pod:3161 -msgid "FreeBSD." -msgstr "FreeBSD." +#: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2234 +msgid "The returned list is sorted." +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3165 -msgid "The operating system type could not be determined." -msgstr "" +#: ../fish/guestfish-actions.pod:1380 +msgid "See also L." +msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2161 -msgid "inspect-get-windows-current-control-set" -msgstr "" +#: ../fish/guestfish-actions.pod:1385 +msgid "find0" +msgstr "find0" #. type: verbatim -#: ../fish/guestfish-actions.pod:2163 +#: ../fish/guestfish-actions.pod:1387 #, no-wrap msgid "" -" inspect-get-windows-current-control-set root\n" +" find0 directory (files|-)\n" "\n" msgstr "" +" find0 каталог (файли|-)\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2165 ../src/guestfs-actions.pod:3185 +#: ../fish/guestfish-actions.pod:1389 ../src/guestfs-actions.pod:2254 msgid "" -"This returns the Windows CurrentControlSet of the inspected guest. The " -"CurrentControlSet is a registry key name such as C." +"This command lists out all files and directories, recursively, starting at " +"C, placing the resulting list in the external file called " +"C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2168 ../src/guestfs-actions.pod:3188 +#: ../fish/guestfish-actions.pod:1393 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." +"This command works the same way as L with the following exceptions:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2174 -msgid "inspect-get-windows-systemroot" -msgstr "inspect-get-windows-systemroot" +#. type: textblock +#: ../fish/guestfish-actions.pod:1400 ../src/guestfs-actions.pod:2265 +msgid "The resulting list is written to an external file." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2176 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:1404 ../src/guestfs-actions.pod:2269 msgid "" -" inspect-get-windows-systemroot root\n" -"\n" +"Items (filenames) in the result are separated by C<\\0> characters. See " +"L option I<-print0>." msgstr "" -" inspect-get-windows-systemroot корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2178 ../src/guestfs-actions.pod:3205 -msgid "" -"This returns the Windows systemroot of the inspected guest. The systemroot " -"is a directory path such as C." +#: ../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:2181 ../src/guestfs-actions.pod:3208 -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." +#: ../fish/guestfish-actions.pod:1414 ../src/guestfs-actions.pod:2279 +msgid "The result list is not sorted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2187 -msgid "inspect-is-live" -msgstr "inspect-is-live" +#: ../fish/guestfish-actions.pod:1420 +msgid "findfs-label" +msgstr "findfs-label" #. type: verbatim -#: ../fish/guestfish-actions.pod:2189 +#: ../fish/guestfish-actions.pod:1422 #, no-wrap msgid "" -" inspect-is-live root\n" +" findfs-label label\n" "\n" msgstr "" -" inspect-is-live корінь\n" +" findfs-label мітка\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2191 +#: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2293 msgid "" -"If L returns C (this is an install disk), " -"then this returns true if a live image was detected on the disk." +"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:1428 +msgid "To find the label of a filesystem, use L." +msgstr "Для визначення мітки файлової системи скористайтеся L." + #. type: =head2 -#: ../fish/guestfish-actions.pod:2197 -msgid "inspect-is-multipart" -msgstr "inspect-is-multipart" +#: ../fish/guestfish-actions.pod:1430 +msgid "findfs-uuid" +msgstr "findfs-uuid" #. type: verbatim -#: ../fish/guestfish-actions.pod:2199 +#: ../fish/guestfish-actions.pod:1432 #, no-wrap msgid "" -" inspect-is-multipart root\n" +" findfs-uuid uuid\n" "\n" msgstr "" -" inspect-is-multipart корінь\n" +" findfs-uuid uuid\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2201 +#: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2310 msgid "" -"If L returns C (this is an install disk), " -"then this returns true if the disk is part of a set." +"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:1438 +msgid "To find the UUID of a filesystem, use L." +msgstr "Для визначення UUID файлової системи скористайтеся L." + #. type: =head2 -#: ../fish/guestfish-actions.pod:2207 -msgid "inspect-is-netinst" -msgstr "inspect-is-netinst" +#: ../fish/guestfish-actions.pod:1440 +msgid "fsck" +msgstr "fsck" #. type: verbatim -#: ../fish/guestfish-actions.pod:2209 +#: ../fish/guestfish-actions.pod:1442 #, no-wrap msgid "" -" inspect-is-netinst root\n" +" fsck fstype device\n" "\n" msgstr "" -" inspect-is-netinst корінь\n" +" fsck тип_файлової_системи пристрій\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2211 +#: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2328 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-" -"contained install CD but one which is likely to require network access to " -"complete the install." +"This runs the filesystem checker (fsck) on C which should have " +"filesystem type C." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2219 -msgid "inspect-list-applications" -msgstr "inspect-list-applications" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2221 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:1447 ../src/guestfs-actions.pod:2331 msgid "" -" inspect-list-applications root\n" -"\n" +"The returned integer is the status. See L for the list of status " +"codes from C." msgstr "" -" inspect-list-applications кореневий_каталог\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2223 ../src/guestfs-actions.pod:3275 -msgid "Return the list of applications installed in the operating system." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2225 -msgid "" -"I This call works differently from other parts of the inspection " -"API. You have to call L, then L, " -"then mount up the disks, before calling this. Listing applications is a " -"significantly more difficult operation which requires access to the full " -"filesystem. Also note that unlike the other L calls which " -"are just returning data cached in the libguestfs handle, this call actually " -"reads parts of the mounted filesystems during the call." +#: ../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:2235 ../src/guestfs-actions.pod:3287 +#: ../fish/guestfish-actions.pod:1460 ../src/guestfs-actions.pod:2344 msgid "" -"This returns an empty list if the inspection code was not able to determine " -"the list of applications." +"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:2238 ../src/guestfs-actions.pod:3290 -msgid "The application structure contains the following fields:" +#: ../fish/guestfish-actions.pod:1465 ../src/guestfs-actions.pod:2349 +msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2242 ../src/guestfs-actions.pod:3294 -msgid "C" -msgstr "C" - #. type: textblock -#: ../fish/guestfish-actions.pod:2244 ../src/guestfs-actions.pod:3296 +#: ../fish/guestfish-actions.pod:1470 ../src/guestfs-actions.pod:2354 msgid "" -"The name of the application. For Red Hat-derived and Debian-derived Linux " -"guests, this is the package name." +"This command is entirely equivalent to running C." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3299 -msgid "C" -msgstr "C" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1472 +msgid "get-append" +msgstr "get-append" -#. type: textblock -#: ../fish/guestfish-actions.pod:2249 ../src/guestfs-actions.pod:3301 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1474 +#, no-wrap msgid "" -"The display name of the application, sometimes localized to the install " -"language of the guest operating system." +" get-append\n" +"\n" msgstr "" +" get-append\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2252 ../src/guestfs-actions.pod:3304 +#: ../fish/guestfish-actions.pod:1476 ../src/guestfs-actions.pod:2365 msgid "" -"If unavailable this is returned as an empty string C<\"\">. Callers needing " -"to display something can use C instead." +"Return the additional kernel options which are added to the guest kernel " +"command line." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2255 ../src/guestfs-actions.pod:3307 -msgid "C" -msgstr "C" - #. type: textblock -#: ../fish/guestfish-actions.pod:2257 ../src/guestfs-actions.pod:3309 -msgid "" -"For package managers which use epochs, this contains the epoch of the " -"package (an integer). If unavailable, this is returned as C<0>." +#: ../fish/guestfish-actions.pod:1479 ../src/guestfs-actions.pod:2368 +msgid "If C then no options are added." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2260 ../src/guestfs-actions.pod:3312 -msgid "C" -msgstr "C" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1481 +msgid "get-attach-method" +msgstr "get-attach-method" -#. type: textblock -#: ../fish/guestfish-actions.pod:2262 ../src/guestfs-actions.pod:3314 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1483 +#, no-wrap msgid "" -"The version string of the application or package. If unavailable this is " -"returned as an empty string C<\"\">." +" get-attach-method\n" +"\n" msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:2265 ../src/guestfs-actions.pod:3317 -msgid "C" -msgstr "C" +" get-attach-method\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3319 -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<\"\">." +#: ../fish/guestfish-actions.pod:1485 +msgid "Return the current attach method. See L." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2271 ../src/guestfs-actions.pod:3323 -msgid "C" -msgstr "C" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1487 +msgid "get-autosync" +msgstr "get-autosync" -#. type: textblock -#: ../fish/guestfish-actions.pod:2273 ../src/guestfs-actions.pod:3325 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1489 +#, no-wrap 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 " -"the guest operating system, it is not a libguestfs path." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3330 -msgid "If unavailable this is returned as an empty string C<\"\">." +" get-autosync\n" +"\n" msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:2280 ../src/guestfs-actions.pod:3332 -msgid "C" -msgstr "C" +" get-autosync\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2282 ../src/guestfs-actions.pod:3334 -msgid "" -"The install path translated into a libguestfs path. If unavailable this is " -"returned as an empty string C<\"\">." +#: ../fish/guestfish-actions.pod:1491 ../src/guestfs-actions.pod:2393 +msgid "Get the autosync flag." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2285 ../src/guestfs-actions.pod:3337 -msgid "C" -msgstr "C" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1493 +msgid "get-direct" +msgstr "get-direct" -#. type: textblock -#: ../fish/guestfish-actions.pod:2287 ../src/guestfs-actions.pod:3339 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1495 +#, no-wrap 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<\"\">." +" get-direct\n" +"\n" msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:2291 ../src/guestfs-actions.pod:3343 -msgid "C" -msgstr "C" +" get-direct\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2293 ../src/guestfs-actions.pod:3345 -msgid "" -"The URL (eg. upstream URL) of the application. If unavailable this is " -"returned as an empty string C<\"\">." +#: ../fish/guestfish-actions.pod:1497 ../src/guestfs-actions.pod:2404 +msgid "Return the direct appliance mode flag." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2296 ../src/guestfs-actions.pod:3348 -msgid "C" -msgstr "C" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1499 +msgid "get-e2label" +msgstr "get-e2label" -#. type: textblock -#: ../fish/guestfish-actions.pod:2298 ../src/guestfs-actions.pod:3350 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1501 +#, no-wrap msgid "" -"For packaging systems which support this, the name of the source package. " -"If unavailable this is returned as an empty string C<\"\">." +" get-e2label device\n" +"\n" msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:2301 ../src/guestfs-actions.pod:3353 -msgid "C" -msgstr "C" +" get-e2label пристрій\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2303 ../src/guestfs-actions.pod:3355 +#: ../fish/guestfish-actions.pod:1503 ../src/guestfs-actions.pod:2423 msgid "" -"A short (usually one line) description of the application or package. If " -"unavailable this is returned as an empty string C<\"\">." +"This returns the ext2/3/4 filesystem label of the filesystem on C." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:2306 ../src/guestfs-actions.pod:3358 -msgid "C" -msgstr "C" - #. type: textblock -#: ../fish/guestfish-actions.pod:2308 ../src/guestfs-actions.pod:3360 +#: ../fish/guestfish-actions.pod:1506 msgid "" -"A longer description of the application or package. If unavailable this is " -"returned as an empty string C<\"\">." +"I In new code, use the L call " +"instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2315 -msgid "inspect-os" -msgstr "inspect-os" +#: ../fish/guestfish-actions.pod:1513 +msgid "get-e2uuid" +msgstr "get-e2uuid" #. type: verbatim -#: ../fish/guestfish-actions.pod:2317 +#: ../fish/guestfish-actions.pod:1515 #, no-wrap msgid "" -" inspect-os\n" +" get-e2uuid device\n" "\n" msgstr "" -" inspect-os\n" +" get-e2uuid пристрій\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2319 ../src/guestfs-actions.pod:3378 +#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2444 msgid "" -"This function uses other libguestfs functions and certain heuristics to " -"inspect the disk(s) (usually disks belonging to a virtual machine), looking " -"for operating systems." +"This returns the ext2/3/4 filesystem UUID of the filesystem on C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2323 ../src/guestfs-actions.pod:3382 -msgid "The list returned is empty if no operating systems were found." +#: ../fish/guestfish-actions.pod:1520 +msgid "" +"I In new code, use the L call " +"instead." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2325 ../src/guestfs-actions.pod:3384 +#. type: =head2 +#: ../fish/guestfish-actions.pod:1527 +msgid "get-memsize" +msgstr "get-memsize" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1529 +#, no-wrap 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. " -"It is also possible for this function to return a list containing more than " -"one element, indicating a dual-boot or multi-boot virtual machine, with each " -"element being the root filesystem of one of the operating systems." +" get-memsize\n" +"\n" msgstr "" +" get-memsize\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2332 +#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2457 msgid "" -"You can pass the root string(s) returned to other L " -"functions in order to query further information about each operating system, " -"such as the name and version." +"This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2337 +#: ../fish/guestfish-actions.pod:1534 msgid "" -"This function uses other libguestfs features such as L and L in order to mount and unmount filesystems and look at the " -"contents. This should be called with no disks currently mounted. The " -"function may also use Augeas, so any existing Augeas handle will be closed." +"If L was not called on this handle, and if " +"C was not set, then this returns the compiled-in default " +"value for memsize." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3402 +#: ../fish/guestfish-actions.pod:1538 ../fish/guestfish-actions.pod:1595 +#: ../fish/guestfish-actions.pod:4360 ../fish/guestfish-actions.pod:4462 +#: ../src/guestfs-actions.pod:2464 ../src/guestfs-actions.pod:2556 +#: ../src/guestfs-actions.pod:6755 ../src/guestfs-actions.pod:6881 msgid "" -"This function cannot decrypt encrypted disks. The caller must do that first " -"(supplying the necessary keys) if the disk is encrypted." +"For more information on the architecture of libguestfs, see L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2349 ../fish/guestfish-actions.pod:2547 -#: ../fish/guestfish-actions.pod:2606 -msgid "See also L." -msgstr "Див. також L." - #. type: =head2 -#: ../fish/guestfish-actions.pod:2351 -msgid "is-blockdev" -msgstr "is-blockdev" +#: ../fish/guestfish-actions.pod:1541 +msgid "get-network" +msgstr "get-network" #. type: verbatim -#: ../fish/guestfish-actions.pod:2353 +#: ../fish/guestfish-actions.pod:1543 #, no-wrap msgid "" -" is-blockdev path\n" +" get-network\n" "\n" msgstr "" -" is-blockdev шлях\n" +" get-network\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3422 -msgid "" -"This returns C if and only if there is a block device with the given " -"C name." +#: ../fish/guestfish-actions.pod:1545 ../src/guestfs-actions.pod:2476 +msgid "This returns the enable network flag." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2358 ../fish/guestfish-actions.pod:2376 -#: ../fish/guestfish-actions.pod:2395 ../fish/guestfish-actions.pod:2404 -#: ../fish/guestfish-actions.pod:2414 ../fish/guestfish-actions.pod:2448 -#: ../fish/guestfish-actions.pod:2457 -msgid "See also L." -msgstr "Див. також L." - #. type: =head2 -#: ../fish/guestfish-actions.pod:2360 -msgid "is-busy" -msgstr "is-busy" +#: ../fish/guestfish-actions.pod:1547 +msgid "get-path" +msgstr "get-path" #. type: verbatim -#: ../fish/guestfish-actions.pod:2362 +#: ../fish/guestfish-actions.pod:1549 #, no-wrap msgid "" -" is-busy\n" +" get-path\n" "\n" msgstr "" -" is-busy\n" +" get-path\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2364 ../src/guestfs-actions.pod:3436 +#: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2487 +msgid "Return the current search path." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1553 ../src/guestfs-actions.pod:2489 msgid "" -"This returns true iff this handle is busy processing a command (in the " -"C state)." +"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:2369 -msgid "is-chardev" -msgstr "is-chardev" +#: ../fish/guestfish-actions.pod:1556 +msgid "get-pgroup" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2371 +#: ../fish/guestfish-actions.pod:1558 #, no-wrap msgid "" -" is-chardev path\n" +" get-pgroup\n" "\n" msgstr "" -" is-chardev шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2373 ../src/guestfs-actions.pod:3451 -msgid "" -"This returns C if and only if there is a character device with the " -"given C name." +#: ../fish/guestfish-actions.pod:1560 ../src/guestfs-actions.pod:2502 +msgid "This returns the process group flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2378 -msgid "is-config" -msgstr "is-config" +#: ../fish/guestfish-actions.pod:1562 +msgid "get-pid" +msgstr "get-pid" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:1564 +msgid "pid" +msgstr "PID" #. type: verbatim -#: ../fish/guestfish-actions.pod:2380 +#: ../fish/guestfish-actions.pod:1566 #, no-wrap msgid "" -" is-config\n" +" get-pid\n" "\n" msgstr "" -" is-config\n" +" get-pid\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2382 ../src/guestfs-actions.pod:3465 +#: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2513 msgid "" -"This returns true iff this handle is being configured (in the C " -"state)." +"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:1571 ../src/guestfs-actions.pod:2516 +msgid "This is an internal call used for debugging and testing." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2387 -msgid "is-dir" -msgstr "is-dir" +#: ../fish/guestfish-actions.pod:1573 +msgid "get-qemu" +msgstr "get-qemu" #. type: verbatim -#: ../fish/guestfish-actions.pod:2389 +#: ../fish/guestfish-actions.pod:1575 #, no-wrap msgid "" -" is-dir path\n" +" get-qemu\n" "\n" msgstr "" -" is-dir шлях\n" +" get-qemu\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2391 ../src/guestfs-actions.pod:3480 +#: ../fish/guestfish-actions.pod:1577 ../src/guestfs-actions.pod:2527 +msgid "Return the current qemu binary." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2529 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." +"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:2397 -msgid "is-fifo" -msgstr "is-fifo" +#: ../fish/guestfish-actions.pod:1582 +msgid "get-recovery-proc" +msgstr "get-recovery-proc" #. type: verbatim -#: ../fish/guestfish-actions.pod:2399 +#: ../fish/guestfish-actions.pod:1584 #, no-wrap msgid "" -" is-fifo path\n" +" get-recovery-proc\n" "\n" msgstr "" -" is-fifo шлях\n" +" get-recovery-proc\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2401 ../src/guestfs-actions.pod:3496 -msgid "" -"This returns C if and only if there is a FIFO (named pipe) with the " -"given C name." +#: ../fish/guestfish-actions.pod:1586 ../src/guestfs-actions.pod:2542 +msgid "Return the recovery process enabled flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2406 -msgid "is-file" -msgstr "is-file" +#: ../fish/guestfish-actions.pod:1588 +msgid "get-selinux" +msgstr "get-selinux" #. type: verbatim -#: ../fish/guestfish-actions.pod:2408 +#: ../fish/guestfish-actions.pod:1590 #, no-wrap msgid "" -" is-file path\n" +" get-selinux\n" "\n" msgstr "" -" is-file шлях\n" +" get-selinux\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2410 ../src/guestfs-actions.pod:3511 +#: ../fish/guestfish-actions.pod:1592 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." +"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:2416 -msgid "is-launching" -msgstr "is-launching" +#: ../fish/guestfish-actions.pod:1598 +msgid "get-smp" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2418 +#: ../fish/guestfish-actions.pod:1600 #, no-wrap msgid "" -" is-launching\n" +" get-smp\n" "\n" msgstr "" -" is-launching\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2420 ../src/guestfs-actions.pod:3526 -msgid "" -"This returns true iff this handle is launching the subprocess (in the " -"C state)." +#: ../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:2425 -msgid "is-lv" -msgstr "is-lv" +#: ../fish/guestfish-actions.pod:1604 +msgid "get-state" +msgstr "get-state" #. type: verbatim -#: ../fish/guestfish-actions.pod:2427 +#: ../fish/guestfish-actions.pod:1606 #, no-wrap msgid "" -" is-lv device\n" +" get-state\n" "\n" msgstr "" -" is-lv пристрій\n" +" get-state\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2429 ../src/guestfs-actions.pod:3541 +#: ../fish/guestfish-actions.pod:1608 ../src/guestfs-actions.pod:2579 msgid "" -"This command tests whether C is a logical volume, and returns true " -"iff this is the case." +"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:1611 ../fish/guestfish-actions.pod:2570 +#: ../fish/guestfish-actions.pod:2588 ../fish/guestfish-actions.pod:2626 +#: ../fish/guestfish-actions.pod:2642 ../src/guestfs-actions.pod:2582 +#: ../src/guestfs-actions.pod:3901 ../src/guestfs-actions.pod:3930 +#: ../src/guestfs-actions.pod:3991 ../src/guestfs-actions.pod:4018 +msgid "For more information on states, see L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2432 -msgid "is-ready" -msgstr "is-ready" +#: ../fish/guestfish-actions.pod:1613 +msgid "get-trace" +msgstr "get-trace" #. type: verbatim -#: ../fish/guestfish-actions.pod:2434 +#: ../fish/guestfish-actions.pod:1615 #, no-wrap msgid "" -" is-ready\n" +" get-trace\n" "\n" msgstr "" -" is-ready\n" +" get-trace\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2436 ../src/guestfs-actions.pod:3553 -msgid "" -"This returns true iff this handle is ready to accept commands (in the " -"C state)." +#: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2593 +msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2441 -msgid "is-socket" -msgstr "is-socket" +#: ../fish/guestfish-actions.pod:1619 +msgid "get-umask" +msgstr "get-umask" #. type: verbatim -#: ../fish/guestfish-actions.pod:2443 +#: ../fish/guestfish-actions.pod:1621 #, no-wrap msgid "" -" is-socket path\n" +" get-umask\n" "\n" msgstr "" -" is-socket шлях\n" +" get-umask\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3568 +#: ../fish/guestfish-actions.pod:1623 msgid "" -"This returns C if and only if there is a Unix domain socket with the " -"given C name." +"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:2450 -msgid "is-symlink" -msgstr "is-symlink" +#: ../fish/guestfish-actions.pod:1626 +msgid "get-verbose" +msgstr "get-verbose" #. type: verbatim -#: ../fish/guestfish-actions.pod:2452 +#: ../fish/guestfish-actions.pod:1628 #, no-wrap msgid "" -" is-symlink path\n" +" get-verbose\n" "\n" msgstr "" -" is-symlink шлях\n" +" get-verbose\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2454 ../src/guestfs-actions.pod:3583 -msgid "" -"This returns C if and only if there is a symbolic link with the given " -"C name." +#: ../fish/guestfish-actions.pod:1630 ../src/guestfs-actions.pod:2616 +msgid "This returns the verbose messages flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2459 -msgid "is-zero" -msgstr "" +#: ../fish/guestfish-actions.pod:1632 +msgid "getcon" +msgstr "getcon" #. type: verbatim -#: ../fish/guestfish-actions.pod:2461 +#: ../fish/guestfish-actions.pod:1634 #, no-wrap msgid "" -" is-zero path\n" +" getcon\n" "\n" msgstr "" +" getcon\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3598 -msgid "" -"This returns true iff the file exists and the file is empty or it contains " -"all zero bytes." +#: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2627 +msgid "This gets the SELinux security context of the daemon." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2466 -msgid "is-zero-device" +#. type: textblock +#: ../fish/guestfish-actions.pod:1638 +msgid "See the documentation about SELINUX in L, and L" msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1641 +msgid "getxattr" +msgstr "getxattr" + #. type: verbatim -#: ../fish/guestfish-actions.pod:2468 +#: ../fish/guestfish-actions.pod:1643 #, no-wrap msgid "" -" is-zero-device device\n" +" getxattr path name\n" "\n" msgstr "" +" getxattr шлях назва\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2470 ../src/guestfs-actions.pod:3611 -msgid "This returns true iff the device exists and contains all zero bytes." +#: ../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 " +"symlink itself, use L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2472 ../src/guestfs-actions.pod:3613 -msgid "Note that for large devices this can take a long time to run." +#: ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:2715 +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 " +"buggy and do not provide a way to list out attributes. For these " +"filesystems (notably ntfs-3g) you have to know the names of the extended " +"attributes you want in advance and call this function." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:2722 +#: ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:4151 +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:1659 +msgid "See also: L, L, L." +msgstr "Див. також L, L, L." + #. type: =head2 -#: ../fish/guestfish-actions.pod:2474 -msgid "kill-subprocess" -msgstr "kill-subprocess" +#: ../fish/guestfish-actions.pod:1661 +msgid "getxattrs" +msgstr "getxattrs" #. type: verbatim -#: ../fish/guestfish-actions.pod:2476 +#: ../fish/guestfish-actions.pod:1663 #, no-wrap msgid "" -" kill-subprocess\n" +" getxattrs path\n" "\n" msgstr "" -" kill-subprocess\n" +" getxattrs шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2478 ../src/guestfs-actions.pod:3624 -msgid "This kills the qemu subprocess. You should never need to call this." +#: ../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: =head2 -#: ../fish/guestfish-actions.pod:2480 -msgid "launch" -msgstr "launch" +#. type: textblock +#: ../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:1671 +msgid "See also: L, L." +msgstr "Див. також L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2482 -msgid "run" -msgstr "" +#: ../fish/guestfish-actions.pod:1673 +msgid "glob-expand" +msgstr "glob-expand" #. type: verbatim -#: ../fish/guestfish-actions.pod:2484 +#: ../fish/guestfish-actions.pod:1675 #, no-wrap msgid "" -" launch\n" +" glob-expand pattern\n" "\n" msgstr "" -" launch\n" +" glob-expand шаблон\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2486 ../src/guestfs-actions.pod:3635 +#: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2693 msgid "" -"Internally libguestfs is implemented by running a virtual machine using " -"L." +"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:2489 ../src/guestfs-actions.pod:3638 +#: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2697 msgid "" -"You should call this after configuring the handle (eg. adding drives) but " -"before performing any actions." +"If no paths match, then this returns an empty list (note: not an error)." +msgstr "" + +#. type: textblock +#: ../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:2492 -msgid "lchown" -msgstr "lchown" +#: ../fish/guestfish-actions.pod:1688 +msgid "grep" +msgstr "grep" #. type: verbatim -#: ../fish/guestfish-actions.pod:2494 +#: ../fish/guestfish-actions.pod:1690 #, no-wrap msgid "" -" lchown owner group path\n" +" grep regex path\n" "\n" msgstr "" -" lchown власник група шлях\n" +" grepi формальний_вираз шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2496 -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 " -"target." +#: ../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:2504 -msgid "lgetxattr" -msgstr "lgetxattr" +#: ../fish/guestfish-actions.pod:1698 +msgid "grepi" +msgstr "grepi" #. type: verbatim -#: ../fish/guestfish-actions.pod:2506 +#: ../fish/guestfish-actions.pod:1700 #, no-wrap msgid "" -" lgetxattr path name\n" +" grepi regex path\n" "\n" msgstr "" -" lgetxattr шлях назва\n" +" grepi формальний_вираз шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2508 ../src/guestfs-actions.pod:3678 +#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2736 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." +"This calls the external C program and returns the matching lines." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2522 -msgid "See also: L, L, L." -msgstr "Див. також L, L, L." - #. type: =head2 -#: ../fish/guestfish-actions.pod:2524 -msgid "lgetxattrs" -msgstr "lgetxattrs" +#: ../fish/guestfish-actions.pod:1708 +msgid "grub-install" +msgstr "grub-install" #. type: verbatim -#: ../fish/guestfish-actions.pod:2526 +#: ../fish/guestfish-actions.pod:1710 #, no-wrap msgid "" -" lgetxattrs path\n" +" grub-install root device\n" "\n" msgstr "" -" lgetxattrs шлях\n" +" grub-install кореневий пристрій\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2528 +#: ../fish/guestfish-actions.pod:1712 ../src/guestfs-actions.pod:2755 msgid "" -"This is the same as L, but if C is a symbolic link, then " -"it returns the extended attributes of the link itself." +"This command installs GRUB 1 (the Grand Unified Bootloader) on C, " +"with the root directory being C." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2532 -msgid "list-9p" +#. type: textblock +#: ../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 " +"guest, although see the caveats in L." +msgstr "" + +#. type: textblock +#: ../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. " +"Careful testing with each guest version is advisable." +msgstr "" + +#. type: textblock +#: ../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 file first that contains the mapping between grub device names " +"and Linux device names. It is usually sufficient to create a file " +"containing:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2534 +#: ../fish/guestfish-actions.pod:1742 ../src/guestfs-actions.pod:2785 #, no-wrap msgid "" -" list-9p\n" +" (hd0) /dev/vda\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2536 ../src/guestfs-actions.pod:3721 -msgid "" -"List all 9p filesystems attached to the guest. A list of mount tags is " -"returned." +#: ../fish/guestfish-actions.pod:1744 ../src/guestfs-actions.pod:2787 +msgid "replacing C with the name of the installation device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2539 -msgid "list-devices" -msgstr "list-devices" +#: ../fish/guestfish-actions.pod:1748 +msgid "head" +msgstr "head" #. type: verbatim -#: ../fish/guestfish-actions.pod:2541 +#: ../fish/guestfish-actions.pod:1750 #, no-wrap msgid "" -" list-devices\n" +" head path\n" "\n" msgstr "" -" list-devices\n" +" head шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2543 ../src/guestfs-actions.pod:3735 -msgid "List all the block devices." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2545 ../src/guestfs-actions.pod:3737 -msgid "The full block device names are returned, eg. C." +#: ../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:2549 -msgid "list-dm-devices" -msgstr "" +#: ../fish/guestfish-actions.pod:1758 +msgid "head-n" +msgstr "head-n" #. type: verbatim -#: ../fish/guestfish-actions.pod:2551 +#: ../fish/guestfish-actions.pod:1760 #, no-wrap msgid "" -" list-dm-devices\n" +" head-n nrlines path\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2553 ../src/guestfs-actions.pod:3752 -msgid "List all device mapper devices." +#: ../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:2555 +#: ../fish/guestfish-actions.pod:1765 ../src/guestfs-actions.pod:2823 msgid "" -"The returned list contains C devices, eg. ones created by a " -"previous call to L." +"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:2558 -msgid "" -"Device mapper devices which correspond to logical volumes are I " -"returned in this list. Call L if you want to list logical volumes." +#: ../fish/guestfish-actions.pod:1768 ../fish/guestfish-actions.pod:4843 +#: ../src/guestfs-actions.pod:2826 ../src/guestfs-actions.pod:7460 +msgid "If the parameter C is zero, this returns an empty list." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2562 -msgid "list-filesystems" -msgstr "list-filesystems" +#: ../fish/guestfish-actions.pod:1773 +msgid "hexdump" +msgstr "hexdump" #. type: verbatim -#: ../fish/guestfish-actions.pod:2564 +#: ../fish/guestfish-actions.pod:1775 #, no-wrap msgid "" -" list-filesystems\n" +" hexdump path\n" "\n" msgstr "" -" list-filesystems\n" +" hexdump шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2566 ../src/guestfs-actions.pod:3772 +#: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2843 msgid "" -"This inspection command looks for filesystems on partitions, block devices " -"and logical volumes, returning a list of devices containing filesystems and " -"their type." +"This runs C on the given C. The result is the human-" +"readable, canonical hex dump of the file." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2570 ../src/guestfs-actions.pod:3776 -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: =head2 +#: ../fish/guestfish-actions.pod:1783 +msgid "initrd-cat" +msgstr "initrd-cat" #. type: verbatim -#: ../fish/guestfish-actions.pod:2574 ../src/guestfs-actions.pod:3780 +#: ../fish/guestfish-actions.pod:1785 #, no-wrap msgid "" -" \"/dev/sda1\" => \"ntfs\"\n" -" \"/dev/sda2\" => \"ext2\"\n" -" \"/dev/vg_guest/lv_root\" => \"ext4\"\n" -" \"/dev/vg_guest/lv_swap\" => \"swap\"\n" +" initrd-cat initrdpath filename\n" "\n" msgstr "" +" initrd-cat шлях_initrd назва_файла\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2579 ../src/guestfs-actions.pod:3785 +#: ../fish/guestfish-actions.pod:1787 ../src/guestfs-actions.pod:2862 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." +"This command unpacks the file C from the initrd file called " +"C. The filename must be given I the initial C " +"character." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2583 +#: ../fish/guestfish-actions.pod:1791 ../src/guestfs-actions.pod:2866 msgid "" -"This command runs other libguestfs commands, which might include L " -"and L, and therefore you should use this soon after launch and only " -"when nothing is mounted." +"For example, in guestfish you could use the following command to examine the " +"boot script (usually called C) contained in a Linux initrd or " +"initramfs image:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2587 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1795 ../src/guestfs-actions.pod:2870 +#, no-wrap 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 " -"each filesystem found is valid and mountable, and some filesystems might be " -"mountable but require special options. Filesystems may not all belong to a " -"single logical operating system (use L to look for OSes)." +" initrd-cat /boot/initrd-.img init\n" +"\n" msgstr "" +#. type: textblock +#: ../fish/guestfish-actions.pod:1797 +msgid "See also L." +msgstr "Див. також L." + #. type: =head2 -#: ../fish/guestfish-actions.pod:2595 -msgid "list-partitions" -msgstr "list-partitions" +#: ../fish/guestfish-actions.pod:1802 +msgid "initrd-list" +msgstr "initrd-list" #. type: verbatim -#: ../fish/guestfish-actions.pod:2597 +#: ../fish/guestfish-actions.pod:1804 #, no-wrap msgid "" -" list-partitions\n" +" initrd-list path\n" "\n" msgstr "" -" list-partitions\n" +" initrd-list шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2599 ../src/guestfs-actions.pod:3814 -msgid "List all the partitions detected on all block devices." +#: ../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:2601 ../src/guestfs-actions.pod:3816 -msgid "The full partition device names are returned, eg. C" +#: ../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 " +"names are listed as separate items." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2603 +#: ../fish/guestfish-actions.pod:1812 ../src/guestfs-actions.pod:2895 msgid "" -"This does not return logical volumes. For that you will need to call L." +"Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as " +"initrd. We I support the newer initramfs format (compressed cpio " +"files)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2608 -msgid "ll" -msgstr "ll" +#: ../fish/guestfish-actions.pod:1816 +msgid "inotify-add-watch" +msgstr "inotify-add-watch" #. type: verbatim -#: ../fish/guestfish-actions.pod:2610 +#: ../fish/guestfish-actions.pod:1818 #, no-wrap msgid "" -" ll directory\n" +" inotify-add-watch path mask\n" "\n" msgstr "" -" ll каталог\n" +" inotify-add-watch шлях маска\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2612 ../src/guestfs-actions.pod:3835 +#: ../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:1822 ../src/guestfs-actions.pod:2914 msgid "" -"List the files in C (relative to the root directory, there is no " -"cwd) in the format of 'ls -la'." +"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:2615 ../src/guestfs-actions.pod:3838 +#: ../fish/guestfish-actions.pod:1826 ../src/guestfs-actions.pod:2918 msgid "" -"This command is mostly useful for interactive sessions. It is I " -"intended that you try to parse the output string." +"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:2618 -msgid "ln" -msgstr "ln" +#: ../fish/guestfish-actions.pod:1830 +msgid "inotify-close" +msgstr "inotify-close" #. type: verbatim -#: ../fish/guestfish-actions.pod:2620 +#: ../fish/guestfish-actions.pod:1832 #, no-wrap msgid "" -" ln target linkname\n" +" inotify-close\n" "\n" msgstr "" -" ln призначення назва_посилання\n" +" inotify-close\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2622 ../src/guestfs-actions.pod:3853 -msgid "This command creates a hard link using the C command." +#: ../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 " +"resources." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2624 -msgid "ln-f" -msgstr "ln-f" +#: ../fish/guestfish-actions.pod:1838 +msgid "inotify-files" +msgstr "inotify-files" #. type: verbatim -#: ../fish/guestfish-actions.pod:2626 +#: ../fish/guestfish-actions.pod:1840 #, no-wrap msgid "" -" ln-f target linkname\n" +" inotify-files\n" "\n" msgstr "" -" ln-f призначення назва_посилання\n" +" inotify-files\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2628 ../src/guestfs-actions.pod:3866 +#: ../fish/guestfish-actions.pod:1842 msgid "" -"This command creates a hard link using the C command. The I<-f> " -"option removes the link (C) if it exists already." +"This function is a helpful wrapper around L which just " +"returns a list of pathnames of objects that were touched. The returned " +"pathnames are sorted and deduplicated." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2631 -msgid "ln-s" -msgstr "ln-s" +#: ../fish/guestfish-actions.pod:1846 +msgid "inotify-init" +msgstr "inotify-init" #. type: verbatim -#: ../fish/guestfish-actions.pod:2633 +#: ../fish/guestfish-actions.pod:1848 #, no-wrap msgid "" -" ln-s target linkname\n" +" inotify-init maxevents\n" "\n" msgstr "" -" ln-s призначення назва_посилання\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2635 ../src/guestfs-actions.pod:3880 -msgid "This command creates a symbolic link using the C command." +#: ../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: =head2 -#: ../fish/guestfish-actions.pod:2637 -msgid "ln-sf" -msgstr "ln-sf" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2639 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:1854 msgid "" -" ln-sf target linkname\n" -"\n" +"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>, " +"then the kernel (or previously set) default is used. For Linux 2.6.29 the " +"default was 16384 events. Beyond this limit, the kernel throws away events, " +"but records the fact that it threw them away by setting a flag " +"C in the returned structure list (see L)." msgstr "" -" ln-sf призначення назва_посилання\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2641 ../src/guestfs-actions.pod:3893 +#: ../fish/guestfish-actions.pod:1864 msgid "" -"This command creates a symbolic link using the C command, The I<-f> " -"option removes the link (C) if it exists already." +"Before any events are generated, you have to add some watches to the " +"internal watch list. See: L, L and " +"L." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2644 -msgid "lremovexattr" -msgstr "lremovexattr" +#. type: textblock +#: ../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). " +"If you don't read the events out often enough then you risk the internal " +"queue overflowing." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2646 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:1877 msgid "" -" lremovexattr xattr path\n" -"\n" +"The handle should be closed after use by calling L. This " +"also removes any watches automatically." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2648 +#: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2991 msgid "" -"This is the same as L, but if C is a symbolic link, then " -"it removes an extended attribute of the link itself." +"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 " +"that there is one global inotify handle per libguestfs instance." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2652 -msgid "ls" -msgstr "ls" +#: ../fish/guestfish-actions.pod:1886 +msgid "inotify-read" +msgstr "inotify-read" #. type: verbatim -#: ../fish/guestfish-actions.pod:2654 +#: ../fish/guestfish-actions.pod:1888 #, no-wrap msgid "" -" ls directory\n" +" inotify-read\n" "\n" msgstr "" -" ls каталог\n" +" inotify-read\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2656 ../src/guestfs-actions.pod:3921 +#: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:3005 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." +"Return the complete queue of events that have happened since the previous " +"read call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2660 +#: ../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:1895 ../src/guestfs-actions.pod:3010 msgid "" -"This command is mostly useful for interactive sessions. Programs should " -"probably use L instead." +"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 " +"the call will read events up to the maximum appliance-to-host message size " +"and leave remaining events in the queue." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2663 -msgid "lsetxattr" -msgstr "lsetxattr" +#: ../fish/guestfish-actions.pod:1901 +msgid "inotify-rm-watch" +msgstr "inotify-rm-watch" #. type: verbatim -#: ../fish/guestfish-actions.pod:2665 +#: ../fish/guestfish-actions.pod:1903 #, no-wrap msgid "" -" lsetxattr xattr val vallen path\n" +" inotify-rm-watch wd\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2667 -msgid "" -"This is the same as L, but if C is a symbolic link, then it " -"sets an extended attribute of the link itself." +#: ../fish/guestfish-actions.pod:1905 +msgid "Remove a previously defined inotify watch. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2671 -msgid "lstat" -msgstr "lstat" +#: ../fish/guestfish-actions.pod:1908 +msgid "inspect-get-arch" +msgstr "inspect-get-arch" #. type: verbatim -#: ../fish/guestfish-actions.pod:2673 +#: ../fish/guestfish-actions.pod:1910 #, no-wrap msgid "" -" lstat path\n" +" inspect-get-arch root\n" "\n" msgstr "" -" lstat шлях\n" +" inspect-get-arch корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2675 ../fish/guestfish-actions.pod:4483 -#: ../src/guestfs-actions.pod:3957 ../src/guestfs-actions.pod:6736 -msgid "Returns file information for the given C." +#: ../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:2677 +#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3045 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." +"If the architecture could not be determined, then the string C is " +"returned." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2681 ../src/guestfs-actions.pod:3963 -msgid "This is the same as the C system call." +#: ../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:2362 +#: ../fish/guestfish-actions.pod:2375 ../fish/guestfish-actions.pod:2388 +#: ../fish/guestfish-actions.pod:2398 ../fish/guestfish-actions.pod:2408 +#: ../fish/guestfish-actions.pod:2420 ../fish/guestfish-actions.pod:2516 +#: ../fish/guestfish-actions.pod:2550 ../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:3634 ../src/guestfs-actions.pod:3654 +#: ../src/guestfs-actions.pod:3674 ../src/guestfs-actions.pod:3691 +#: ../src/guestfs-actions.pod:3707 ../src/guestfs-actions.pod:3725 +#: ../src/guestfs-actions.pod:3827 ../src/guestfs-actions.pod:3868 +msgid "Please read L for more details." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2683 -msgid "lstatlist" -msgstr "lstatlist" +#: ../fish/guestfish-actions.pod:1921 +msgid "inspect-get-distro" +msgstr "inspect-get-distro" #. type: verbatim -#: ../fish/guestfish-actions.pod:2685 +#: ../fish/guestfish-actions.pod:1923 #, no-wrap msgid "" -" lstatlist path 'names ...'\n" +" inspect-get-distro root\n" "\n" msgstr "" +" inspect-get-distro корінь\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2687 +#: ../fish/guestfish-actions.pod:1925 ../src/guestfs-actions.pod:3061 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 " -"from this directory." +"This returns the distro (distribution) of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2691 ../src/guestfs-actions.pod:3982 -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, " -"then the C field of that structure is set to C<-1>." +#: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3064 +msgid "Currently defined distros are:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2696 -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 " -"similarly efficient call for getting extended attributes. Very long " -"directory listings might cause the protocol message size to be exceeded, " -"causing this call to fail. The caller must split up such requests into " -"smaller groups of names." -msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3068 +msgid "\"archlinux\"" +msgstr "\"archlinux\"" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2704 -msgid "luks-add-key" -msgstr "luks-add-key" +#. type: textblock +#: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3070 +msgid "Arch Linux." +msgstr "Arch Linux." -#. type: verbatim -#: ../fish/guestfish-actions.pod:2706 -#, no-wrap -msgid "" -" luks-add-key device keyslot\n" -"\n" +#. type: =item +#: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3072 +msgid "\"centos\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2708 ../src/guestfs-actions.pod:4010 -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 " -"add. C is the key slot that will be replaced." +#: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3074 +msgid "CentOS." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3076 +msgid "\"debian\"" +msgstr "\"debian\"" + #. type: textblock -#: ../fish/guestfish-actions.pod:2713 -msgid "" -"Note that if C already contains a key, then this command will " -"fail. You have to use L first to remove that key." +#: ../fish/guestfish-actions.pod:1942 ../src/guestfs-actions.pod:3078 +msgid "Debian." +msgstr "Debian." + +#. type: =item +#: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:3080 +msgid "\"fedora\"" +msgstr "\"fedora\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:3082 +msgid "Fedora." +msgstr "Fedora." + +#. type: =item +#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3084 +msgid "\"gentoo\"" +msgstr "\"gentoo\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3086 +msgid "Gentoo." +msgstr "Gentoo." + +#. type: =item +#: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3088 +msgid "\"linuxmint\"" +msgstr "\"linuxmint\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:3090 +msgid "Linux Mint." +msgstr "Linux Mint." + +#. type: =item +#: ../fish/guestfish-actions.pod:1956 ../src/guestfs-actions.pod:3092 +msgid "\"mageia\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2717 ../fish/guestfish-actions.pod:2739 -#: ../fish/guestfish-actions.pod:2752 ../fish/guestfish-actions.pod:2766 -#: ../fish/guestfish-actions.pod:2792 ../fish/guestfish-actions.pod:2802 -msgid "" -"This command has one or more key or passphrase parameters. Guestfish will " -"prompt for these separately." +#: ../fish/guestfish-actions.pod:1958 ../src/guestfs-actions.pod:3094 +msgid "Mageia." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2720 -msgid "luks-close" -msgstr "luks-close" +#. type: =item +#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3096 +msgid "\"mandriva\"" +msgstr "\"mandriva\"" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2722 -#, no-wrap -msgid "" -" luks-close device\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1962 ../src/guestfs-actions.pod:3098 +msgid "Mandriva." +msgstr "Mandriva." + +#. type: =item +#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3100 +msgid "\"meego\"" +msgstr "\"meego\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1966 ../src/guestfs-actions.pod:3102 +msgid "MeeGo." +msgstr "MeeGo." + +#. type: =item +#: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:3104 +msgid "\"opensuse\"" msgstr "" -" luks-close пристрій\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2724 -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 " -"device (ie. C) and I the name of the underlying " -"block device." +#: ../fish/guestfish-actions.pod:1970 ../src/guestfs-actions.pod:3106 +msgid "OpenSUSE." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2730 -msgid "luks-format" -msgstr "luks-format" +#. type: =item +#: ../fish/guestfish-actions.pod:1972 ../src/guestfs-actions.pod:3108 +msgid "\"pardus\"" +msgstr "\"pardus\"" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2732 -#, no-wrap -msgid "" -" luks-format device keyslot\n" -"\n" -msgstr "" +#. type: textblock +#: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3110 +msgid "Pardus." +msgstr "Pardus." + +#. type: =item +#: ../fish/guestfish-actions.pod:1976 ../src/guestfs-actions.pod:3112 +msgid "\"redhat-based\"" +msgstr "\"redhat-based\"" #. type: textblock -#: ../fish/guestfish-actions.pod:2734 ../src/guestfs-actions.pod:4051 -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)." +#: ../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:1980 ../src/guestfs-actions.pod:3116 +msgid "\"rhel\"" +msgstr "\"rhel\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:3118 +msgid "Red Hat Enterprise Linux." +msgstr "Red Hat Enterprise Linux." + +#. type: =item +#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3120 +msgid "\"scientificlinux\"" +msgstr "\"scientificlinux\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1986 ../src/guestfs-actions.pod:3122 +msgid "Scientific Linux." +msgstr "Scientific Linux." + +#. type: =item +#: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3124 +msgid "\"slackware\"" +msgstr "\"slackware\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1990 ../src/guestfs-actions.pod:3126 +msgid "Slackware." +msgstr "Slackware." + +#. type: =item +#: ../fish/guestfish-actions.pod:1992 ../src/guestfs-actions.pod:3128 +msgid "\"ttylinux\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2742 ../fish/guestfish-actions.pod:2755 -#: ../fish/guestfish-actions.pod:2842 ../fish/guestfish-actions.pod:3503 -#: ../fish/guestfish-actions.pod:4029 ../fish/guestfish-actions.pod:4354 -#: ../fish/guestfish-actions.pod:4377 ../fish/guestfish-actions.pod:4399 -#: ../fish/guestfish-actions.pod:5145 ../src/guestfs-actions.pod:4058 -#: ../src/guestfs-actions.pod:4081 ../src/guestfs-actions.pod:4224 -#: ../src/guestfs-actions.pod:5327 ../src/guestfs-actions.pod:6115 -#: ../src/guestfs-actions.pod:6550 ../src/guestfs-actions.pod:6580 -#: ../src/guestfs-actions.pod:6613 ../src/guestfs-actions.pod:7812 -msgid "" -"B." +#: ../fish/guestfish-actions.pod:1994 ../src/guestfs-actions.pod:3130 +msgid "ttylinux." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2745 -msgid "luks-format-cipher" -msgstr "luks-format-cipher" +#. type: =item +#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3132 +msgid "\"ubuntu\"" +msgstr "\"ubuntu\"" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2747 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:1998 ../src/guestfs-actions.pod:3134 +msgid "Ubuntu." +msgstr "Ubuntu." + +#. type: =item +#: ../fish/guestfish-actions.pod:2000 ../fish/guestfish-actions.pod:2084 +#: ../fish/guestfish-actions.pod:2353 ../src/guestfs-actions.pod:3136 +#: ../src/guestfs-actions.pod:3245 ../src/guestfs-actions.pod:3625 +msgid "\"unknown\"" +msgstr "\"unknown\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2002 ../src/guestfs-actions.pod:3138 +msgid "The distro could not be determined." +msgstr "Дистрибутив, тип якого не вдалося визначити." + +#. type: =item +#: ../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:2006 ../src/guestfs-actions.pod:3142 msgid "" -" luks-format-cipher device keyslot cipher\n" -"\n" +"Windows does not have distributions. This string is returned if the OS type " +"is Windows." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2749 +#: ../fish/guestfish-actions.pod:2011 ../fish/guestfish-actions.pod:2090 +#: ../fish/guestfish-actions.pod:2359 ../src/guestfs-actions.pod:3147 +#: ../src/guestfs-actions.pod:3251 ../src/guestfs-actions.pod:3631 msgid "" -"This command is the same as L but it also allows you to set " -"the C used." +"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:2758 -msgid "luks-kill-slot" -msgstr "luks-kill-slot" +#: ../fish/guestfish-actions.pod:2016 +msgid "inspect-get-drive-mappings" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2760 +#: ../fish/guestfish-actions.pod:2018 #, no-wrap msgid "" -" luks-kill-slot device keyslot\n" +" inspect-get-drive-mappings root\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2762 ../src/guestfs-actions.pod:4098 +#: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3163 msgid "" -"This command deletes the key in key slot C from the encrypted LUKS " -"device C. C must be one of the I keys." +"This call is useful for Windows which uses a primitive system of assigning " +"drive letters (like \"C:\") to partitions. This inspection API examines the " +"Windows Registry to find out how disks/partitions are mapped to drive " +"letters, and returns a hash table as in the example below:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2769 -msgid "luks-open" -msgstr "luks-open" - #. type: verbatim -#: ../fish/guestfish-actions.pod:2771 +#: ../fish/guestfish-actions.pod:2026 ../src/guestfs-actions.pod:3169 #, no-wrap msgid "" -" luks-open device mapname\n" +" C => /dev/vda2\n" +" E => /dev/vdb1\n" +" F => /dev/vdc1\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4118 +#: ../fish/guestfish-actions.pod:2030 ../src/guestfs-actions.pod:3173 msgid "" -"This command opens a block device which has been encrypted according to the " -"Linux Unified Key Setup (LUKS) standard." +"Note that keys are drive letters. For Windows, the key is case insensitive " +"and just contains the drive letter, without the customary colon separator " +"character." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2776 ../src/guestfs-actions.pod:4121 -msgid "C is the encrypted block device or partition." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2778 ../src/guestfs-actions.pod:4123 +#: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3177 msgid "" -"The caller must supply one of the keys associated with the LUKS block " -"device, in the C parameter." +"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 " +"longer than 1 character. For example in OS-9, hard drives were named C, " +"C

etc." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2781 ../src/guestfs-actions.pod:4126 +#: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3182 msgid "" -"This creates a new block device called C. Reads and " -"writes to this block device are decrypted from and encrypted to the " -"underlying C respectively." +"For Windows guests, currently only hard drive mappings are returned. " +"Removable disks (eg. DVD-ROMs) are ignored." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2785 +#: ../fish/guestfish-actions.pod:2042 ../src/guestfs-actions.pod:3185 msgid "" -"If this block device contains LVM volume groups, then calling L " -"followed by L will make them visible." +"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:2789 -msgid "Use L to list all device mapper devices." +#: ../fish/guestfish-actions.pod:2045 +msgid "" +"Please read L for more details. See also L, L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2795 -msgid "luks-open-ro" -msgstr "luks-open-ro" +#: ../fish/guestfish-actions.pod:2049 +msgid "inspect-get-filesystems" +msgstr "inspect-get-filesystems" #. type: verbatim -#: ../fish/guestfish-actions.pod:2797 +#: ../fish/guestfish-actions.pod:2051 #, no-wrap msgid "" -" luks-open-ro device mapname\n" +" inspect-get-filesystems root\n" "\n" msgstr "" +" inspect-get-filesystems корінь\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2799 +#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3206 msgid "" -"This is the same as L except that a read-only mapping is created." +"This returns a list of all the filesystems that we think are associated with " +"this operating system. This includes the root filesystem, other ordinary " +"filesystems, and non-mounted devices like swap partitions." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2805 -msgid "lvcreate" -msgstr "lvcreate" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2807 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2058 ../src/guestfs-actions.pod:3211 msgid "" -" lvcreate logvol volgroup mbytes\n" -"\n" +"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:2809 ../src/guestfs-actions.pod:4172 +#: ../fish/guestfish-actions.pod:2061 msgid "" -"This creates an LVM logical volume called C on the volume group " -"C, with C megabytes." +"Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2812 -msgid "lvm-canonical-lv-name" -msgstr "lvm-canonical-lv-name" +#: ../fish/guestfish-actions.pod:2064 +msgid "inspect-get-format" +msgstr "inspect-get-format" #. type: verbatim -#: ../fish/guestfish-actions.pod:2814 +#: ../fish/guestfish-actions.pod:2066 #, no-wrap msgid "" -" lvm-canonical-lv-name lvname\n" +" inspect-get-format root\n" "\n" msgstr "" +" inspect-get-format корінь\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2816 ../src/guestfs-actions.pod:4185 +#: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3229 msgid "" -"This converts alternative naming schemes for LVs that you might find to the " -"canonical name. For example, C is converted to C." +"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:2071 ../src/guestfs-actions.pod:3232 +msgid "Currently defined formats are:" +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:2075 ../src/guestfs-actions.pod:3236 +msgid "\"installed\"" +msgstr "\"installed\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2077 ../src/guestfs-actions.pod:3238 +msgid "This is an installed operating system." +msgstr "Це встановлена операційна система." + +#. type: =item +#: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3240 +msgid "\"installer\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2820 ../src/guestfs-actions.pod:4189 +#: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3242 msgid "" -"This command returns an error if the C parameter does not refer to a " -"logical volume." +"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:2823 -msgid "See also L." -msgstr "Див. також L." +#: ../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:2825 -msgid "lvm-clear-filter" -msgstr "lvm-clear-filter" +#: ../fish/guestfish-actions.pod:2095 +msgid "inspect-get-hostname" +msgstr "inspect-get-hostname" #. type: verbatim -#: ../fish/guestfish-actions.pod:2827 +#: ../fish/guestfish-actions.pod:2097 #, no-wrap msgid "" -" lvm-clear-filter\n" +" inspect-get-hostname root\n" "\n" msgstr "" -" lvm-clear-filter\n" +" inspect-get-hostname корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2829 +#: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3267 msgid "" -"This undoes the effect of L. LVM will be able to see every " -"block device." +"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:2832 ../fish/guestfish-actions.pod:2863 -#: ../src/guestfs-actions.pod:4207 ../src/guestfs-actions.pod:4249 +#: ../fish/guestfish-actions.pod:2102 ../src/guestfs-actions.pod:3270 msgid "" -"This command also clears the LVM cache and performs a volume group scan." +"If the hostname could not be determined, then the string C is " +"returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2835 -msgid "lvm-remove-all" -msgstr "lvm-remove-all" +#: ../fish/guestfish-actions.pod:2107 +msgid "inspect-get-icon" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2837 +#: ../fish/guestfish-actions.pod:2109 #, no-wrap msgid "" -" lvm-remove-all\n" +" inspect-get-icon root [favicon:true|false] [highquality:true|false]\n" "\n" msgstr "" -" lvm-remove-all\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2839 ../src/guestfs-actions.pod:4219 +#: ../fish/guestfish-actions.pod:2111 ../src/guestfs-actions.pod:3296 msgid "" -"This command removes all LVM logical volumes, volume groups and physical " -"volumes." +"This function returns an icon corresponding to the inspected operating " +"system. The icon is returned as a buffer containing a PNG image (re-encoded " +"to PNG if necessary)." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2845 -msgid "lvm-set-filter" -msgstr "lvm-set-filter" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2847 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2115 ../src/guestfs-actions.pod:3300 msgid "" -" lvm-set-filter 'devices ...'\n" -"\n" +"If it was not possible to get an icon this function returns a zero-length " +"(non-NULL) buffer. I." msgstr "" -" lvm-set-filter 'пристрої...'\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2849 ../src/guestfs-actions.pod:4235 +#: ../fish/guestfish-actions.pod:2118 ../src/guestfs-actions.pod:3303 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 " -"block devices." +"Libguestfs will start by looking for a file called C or " +"C and if it has the correct format, the contents of " +"this file will be returned. You can disable favicons by passing the " +"optional C boolean as false (default is true)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2853 ../src/guestfs-actions.pod:4239 +#: ../fish/guestfish-actions.pod:2124 ../src/guestfs-actions.pod:3309 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 " -"there are two types of duplication possible: either cloned PVs/VGs which " -"have identical UUIDs; or VGs that are not cloned but just happen to have the " -"same name. In normal operation you cannot create this situation, but you " -"can do it outside LVM, eg. by cloning disk images or by bit twiddling " -"inside the LVM metadata." +"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:2866 ../src/guestfs-actions.pod:4252 -msgid "You can filter whole block devices or individual partitions." +#: ../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 " +"channel. The default (false) is to return any icon we can, even if it is of " +"substandard quality." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2868 ../src/guestfs-actions.pod:4254 +#: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3323 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." +"Unlike most other inspection API calls, the guest's disks must be mounted up " +"before you call this, since it needs to read information from the guest " +"filesystem during the call." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2872 -msgid "lvremove" -msgstr "lvremove" +#. type: textblock +#: ../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. " +"Ensure that libpng (or other relevant libraries) are fully up to date before " +"trying to process or display the icon." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2874 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3337 msgid "" -" lvremove device\n" -"\n" +"The PNG image returned can be any size. It might not be square. Libguestfs " +"tries to return the largest, highest quality icon available. The " +"application must scale the icon to the required size." msgstr "" -" lvremove пристрій\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2876 ../src/guestfs-actions.pod:4268 +#: ../fish/guestfish-actions.pod:2159 ../src/guestfs-actions.pod:3344 msgid "" -"Remove an LVM logical volume C, where C is the path to the " -"LV, such as C." +"Extracting icons from Windows guests requires the external C " +"program from the C package, and several programs (C, " +"C, C) from the C package. These must be " +"installed separately." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2879 ../src/guestfs-actions.pod:4271 +#: ../fish/guestfish-actions.pod:2166 ../src/guestfs-actions.pod:3351 msgid "" -"You can also remove all LVs in a volume group by specifying the VG name, C." +"Operating system icons are usually trademarks. Seek legal advice before " +"using trademarks in applications." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2882 -msgid "lvrename" -msgstr "lvrename" +#: ../fish/guestfish-actions.pod:2173 +msgid "inspect-get-major-version" +msgstr "inspect-get-major-version" #. type: verbatim -#: ../fish/guestfish-actions.pod:2884 +#: ../fish/guestfish-actions.pod:2175 #, no-wrap msgid "" -" lvrename logvol newlogvol\n" +" inspect-get-major-version root\n" "\n" msgstr "" +" inspect-get-major-version корінь\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2886 ../src/guestfs-actions.pod:4285 -msgid "Rename a logical volume C with the new name C." +#: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3392 +msgid "" +"This returns the major version number of the inspected operating system." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2888 -msgid "lvresize" -msgstr "lvresize" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2890 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3395 msgid "" -" lvresize device mbytes\n" -"\n" +"Windows uses a consistent versioning scheme which is I reflected in the " +"popular public names used by the operating system. Notably the operating " +"system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = " +"1). You can find out the real versions corresponding to releases of Windows " +"by consulting Wikipedia or MSDN." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2892 ../src/guestfs-actions.pod:4298 -msgid "" -"This resizes (expands or shrinks) an existing LVM logical volume to " -"C. When reducing, data in the reduced part is lost." +#: ../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:2896 -msgid "lvresize-free" -msgstr "lvresize-free" +#: ../fish/guestfish-actions.pod:2191 +msgid "inspect-get-minor-version" +msgstr "inspect-get-minor-version" #. type: verbatim -#: ../fish/guestfish-actions.pod:2898 +#: ../fish/guestfish-actions.pod:2193 #, no-wrap msgid "" -" lvresize-free lv percent\n" +" inspect-get-minor-version root\n" "\n" msgstr "" +" inspect-get-minor-version корінь\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2900 ../src/guestfs-actions.pod:4313 +#: ../fish/guestfish-actions.pod:2195 ../src/guestfs-actions.pod:3416 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 " -"pc = 100 which expands the logical volume as much as possible, using all " -"remaining free space in the volume group." +"This returns the minor version number of the inspected operating system." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2200 +msgid "" +"Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2906 -msgid "lvs" -msgstr "lvs" +#: ../fish/guestfish-actions.pod:2203 +msgid "inspect-get-mountpoints" +msgstr "inspect-get-mountpoints" #. type: verbatim -#: ../fish/guestfish-actions.pod:2908 +#: ../fish/guestfish-actions.pod:2205 #, no-wrap msgid "" -" lvs\n" +" inspect-get-mountpoints root\n" "\n" msgstr "" -" lvs\n" +" inspect-get-mountpoints корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2910 ../src/guestfs-actions.pod:4328 +#: ../fish/guestfish-actions.pod:2207 ../src/guestfs-actions.pod:3434 msgid "" -"List all the logical volumes detected. This is the equivalent of the L command." +"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 " +"best an educated guess made by reading configuration files such as C. I that this may return filesystems which are " +"non-existent or not mountable and callers should be prepared to handle or " +"ignore failures if they try to mount them." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2913 ../src/guestfs-actions.pod:4331 +#: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3443 msgid "" -"This returns a list of the logical volume device names (eg. C)." +"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 " +"mounted there (eg. C)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2916 -msgid "See also L, L." -msgstr "Див. також L, L." - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2918 -msgid "lvs-full" -msgstr "lvs-full" +#: ../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: verbatim -#: ../fish/guestfish-actions.pod:2920 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2224 msgid "" -" lvs-full\n" -"\n" +"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 " +"information about the mapping of drive letters to partitions, see L." msgstr "" -" lvs-full\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2922 ../src/guestfs-actions.pod:4347 +#: ../fish/guestfish-actions.pod:2230 msgid "" -"List all the logical volumes detected. This is the equivalent of the L command. The \"full\" version includes all fields." +"Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2925 -msgid "lvuuid" -msgstr "lvuuid" +#: ../fish/guestfish-actions.pod:2233 +msgid "inspect-get-package-format" +msgstr "inspect-get-package-format" #. type: verbatim -#: ../fish/guestfish-actions.pod:2927 +#: ../fish/guestfish-actions.pod:2235 #, no-wrap msgid "" -" lvuuid device\n" +" inspect-get-package-format root\n" "\n" msgstr "" -" lvuuid пристрій\n" +" inspect-get-package-format корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2929 ../src/guestfs-actions.pod:4362 -msgid "This command returns the UUID of the LVM LV C." +#: ../fish/guestfish-actions.pod:2237 +msgid "" +"This function and L return the package " +"format and package management tool used by the inspected operating system. " +"For example for Fedora these functions would return C (package format) " +"and C (package management)." +msgstr "" + +#. type: textblock +#: ../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 " +"(eg. Windows)." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3484 +msgid "" +"Possible strings include: C, C, C, C, C, " +"C. Future versions of libguestfs may return other strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2931 -msgid "lxattrlist" -msgstr "lxattrlist" +#: ../fish/guestfish-actions.pod:2253 +msgid "inspect-get-package-management" +msgstr "inspect-get-package-management" #. type: verbatim -#: ../fish/guestfish-actions.pod:2933 +#: ../fish/guestfish-actions.pod:2255 #, no-wrap msgid "" -" lxattrlist path 'names ...'\n" +" inspect-get-package-management root\n" "\n" msgstr "" +" inspect-get-package-management корінь\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2935 ../src/guestfs-actions.pod:4376 +#: ../fish/guestfish-actions.pod:2257 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 " -"this directory." +"L and this function return the package format " +"and package management tool used by the inspected operating system. For " +"example for Fedora these functions would return C (package format) and " +"C (package management)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2939 ../src/guestfs-actions.pod:4380 +#: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3507 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. " -"C in this struct is zero-length to indicate there was an error " -"doing C for this file, I is a C string which is a decimal " -"number (the number of following attributes for this file, which could be C<" -"\"0\">). Then after the first xattr struct are the zero or more attributes " -"for the first named file. This repeats for the second and subsequent files." +"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 " +"system (eg. Windows)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2949 +#: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3511 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 " -"similarly efficient call for getting standard stats. Very long directory " -"listings might cause the protocol message size to be exceeded, causing this " -"call to fail. The caller must split up such requests into smaller groups of " -"names." +"Possible strings include: C, C, C (for all Debian " +"derivatives), C, C, C, C, C. Future " +"versions of libguestfs may return other strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2957 -msgid "mkdir" -msgstr "mkdir" +#: ../fish/guestfish-actions.pod:2274 +msgid "inspect-get-product-name" +msgstr "inspect-get-product-name" #. type: verbatim -#: ../fish/guestfish-actions.pod:2959 +#: ../fish/guestfish-actions.pod:2276 #, no-wrap msgid "" -" mkdir path\n" +" inspect-get-product-name root\n" "\n" msgstr "" -" mkdir шлях\n" +" inspect-get-product-name корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2961 ../src/guestfs-actions.pod:4410 -msgid "Create a directory named C." +#: ../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 " +"user, but should not be parsed by programs." +msgstr "" + +#. type: textblock +#: ../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:2963 -msgid "mkdir-mode" -msgstr "mkdir-mode" +#: ../fish/guestfish-actions.pod:2288 +msgid "inspect-get-product-variant" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2965 +#: ../fish/guestfish-actions.pod:2290 #, no-wrap msgid "" -" mkdir-mode path mode\n" +" inspect-get-product-variant root\n" "\n" msgstr "" -" mkdir-mode шлях режим\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2967 ../src/guestfs-actions.pod:4423 +#: ../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:2295 ../src/guestfs-actions.pod:3553 msgid "" -"This command creates a directory, setting the initial permissions of the " -"directory to C." +"For Windows guests, this returns the contents of the Registry key C C which " +"is usually a string such as C or C (other values are " +"possible). This can be used to distinguish consumer and enterprise versions " +"of Windows that have the same version number (for example, Windows 7 and " +"Windows 2008 Server are both version 6.1, but the former is C and " +"the latter is C)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2970 ../src/guestfs-actions.pod:4426 +#: ../fish/guestfish-actions.pod:2304 ../src/guestfs-actions.pod:3562 msgid "" -"For common Linux filesystems, the actual mode which is set will be C. Non-native-Linux filesystems may interpret the mode in " -"other ways." +"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 " +"implemented at present." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2974 -msgid "See also L, L" -msgstr "Див. також L, L" +#: ../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:2311 +msgid "" +"Please read L for more details. See also L, L." +msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2976 -msgid "mkdir-p" -msgstr "mkdir-p" +#: ../fish/guestfish-actions.pod:2315 +msgid "inspect-get-roots" +msgstr "inspect-get-roots" #. type: verbatim -#: ../fish/guestfish-actions.pod:2978 +#: ../fish/guestfish-actions.pod:2317 #, no-wrap msgid "" -" mkdir-p path\n" +" inspect-get-roots\n" "\n" msgstr "" -" mkdir-p шлях\n" +" inspect-get-roots\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2980 ../src/guestfs-actions.pod:4442 +#: ../fish/guestfish-actions.pod:2319 msgid "" -"Create a directory named C, creating any parent directories as " -"necessary. This is like the C shell command." +"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 " +"whole inspection process." +msgstr "" + +#. type: textblock +#: ../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:2983 -msgid "mkdtemp" -msgstr "mkdtemp" +#: ../fish/guestfish-actions.pod:2328 +msgid "inspect-get-type" +msgstr "inspect-get-type" #. type: verbatim -#: ../fish/guestfish-actions.pod:2985 +#: ../fish/guestfish-actions.pod:2330 #, no-wrap msgid "" -" mkdtemp template\n" +" inspect-get-type root\n" "\n" msgstr "" -" mkdtemp шаблон\n" +" inspect-get-type корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2987 ../src/guestfs-actions.pod:4455 +#: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3604 msgid "" -"This command creates a temporary directory. The C