X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=po-docs%2Fuk.po;h=dfb612cdc0acab688bfaa7313ee6df894a83dc60;hp=9ca68fc8e51bb792341ba37d6e04b4ae4f32a537;hb=f93e8dbb78794029dcc51e8b0d77b5ed4eadac5e;hpb=69abc787dddbf7855c2871f7f1432563a6af92a1 diff --git a/po-docs/uk.po b/po-docs/uk.po index 9ca68fc..dfb612c 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-03 14:10+0000\n" +"PO-Revision-Date: 2011-10-27 09:15+0000\n" "Last-Translator: rjones \n" "Language-Team: Ukrainian \n" "Language: uk\n" @@ -19,16 +20,18 @@ 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 -#: ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3 -#: ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3 -#: ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3 -#: ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3 -#: ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3 -#: ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3 -#: ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3 +#: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3 +#: ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 +#: ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3 +#: ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3 +#: ../examples/guestfs-recipes.pod:14 ../fish/guestfish.pod:3 +#: ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3 +#: ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3 +#: ../fuse/guestmount.pod:3 ../inspector/virt-inspector.pod:3 +#: ../java/examples/guestfs-java.pod:3 ../ocaml/examples/guestfs-ocaml.pod:3 +#: ../perl/examples/guestfs-perl.pod:3 ../python/examples/guestfs-python.pod:3 +#: ../rescue/virt-rescue.pod:3 ../resize/virt-resize.pod:3 +#: ../ruby/examples/guestfs-ruby.pod:3 ../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 @@ -37,21 +40,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 +65,36 @@ msgid "SYNOPSIS" msgstr "КОРОТКИЙ ОПИС" #. type: verbatim -#: ../cat/virt-cat.pod:9 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" -msgid "" -" virt-cat [--options] -d domname file [file ...]\n" -"\n" -msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" - -#. type: verbatim -#: ../cat/virt-cat.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" -msgid "" -" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n" -"\n" -msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" - -#. type: textblock -#: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 -#: ../inspector/virt-inspector.pod:13 -msgid "Old-style:" -msgstr "" - -#. type: verbatim -#: ../cat/virt-cat.pod:15 +#: ../align/virt-alignment-scan.pod:9 #, no-wrap msgid "" -" virt-cat domname file\n" +" virt-alignment-scan [--options] -d domname\n" "\n" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:17 +#: ../align/virt-alignment-scan.pod:11 #, no-wrap msgid "" -" virt-cat disk.img file\n" +" virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n" "\n" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 -#: ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 +#: ../align/virt-alignment-scan.pod:13 ../cat/virt-cat.pod:19 +#: ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19 +#: ../clone/virt-sysprep.pod:13 ../df/virt-df.pod:21 ../edit/virt-edit.pod:27 +#: ../erlang/examples/guestfs-erlang.pod:16 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18 #: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 #: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 #: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20 #: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 #: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 -#: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29 +#: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 -#: ../src/guestfs.pod:23 ../test-tool/libguestfs-test-tool.pod:11 +#: ../sparsify/virt-sparsify.pod:11 ../src/guestfs.pod:23 +#: ../test-tool/libguestfs-test-tool.pod:11 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77 #: ../tools/virt-win-reg.pl:63 @@ -126,128 +102,173 @@ msgid "DESCRIPTION" msgstr "ОПИС" #. type: textblock -#: ../cat/virt-cat.pod:21 +#: ../align/virt-alignment-scan.pod:15 msgid "" -"C is a command line tool to display the contents of C where " -"C exists in the named virtual machine (or disk image)." +"When older operating systems install themselves, the partitioning tools " +"place partitions at a sector misaligned with the underlying storage " +"(commonly the first partition starts on sector C<63>). Misaligned " +"partitions can result in an operating system issuing more I/O than should be " +"necessary." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:24 +#: ../align/virt-alignment-scan.pod:21 msgid "" -"Multiple filenames can be given, in which case they are concatenated " -"together. Each filename must be a full path, starting at the root directory " -"(starting with '/')." +"The virt-alignment-scan tool checks the alignment of partitions in virtual " +"machines and disk images and warns you if there are alignment problems." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:28 +#: ../align/virt-alignment-scan.pod:25 msgid "" -"C can be used to quickly view a file. To edit a file, use C. For more complex cases you should look at the L tool " -"(see L below)." +"Currently there is no virt tool for fixing alignment problems. You can only " +"reinstall the guest operating system. The following NetApp document " +"summarises the problem and possible solutions: L" msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43 -#: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41 -#: ../fish/guestfish.pod:1018 ../fish/virt-copy-in.pod:29 -#: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30 -#: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39 -#: ../resize/virt-resize.pod:27 ../tools/virt-tar.pl:50 -msgid "EXAMPLES" -msgstr "ПРИКЛАДИ" +#: ../align/virt-alignment-scan.pod:30 +msgid "OUTPUT" +msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:34 +#: ../align/virt-alignment-scan.pod:32 +msgid "To run this tool on a disk image directly, use the I<-a> option:" +msgstr "" + +#. type: verbatim +#: ../align/virt-alignment-scan.pod:34 +#, no-wrap msgid "" -"Display C file from inside the libvirt VM called C:" +" $ virt-alignment-scan -a winxp.img\n" +" /dev/sda1 32256 512 bad (alignment < 4K)\n" +"\n" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:37 +#: ../align/virt-alignment-scan.pod:37 #, no-wrap msgid "" -" virt-cat -d mydomain /etc/fstab\n" +" $ virt-alignment-scan -a fedora16.img\n" +" /dev/sda1 1048576 1024K ok\n" +" /dev/sda2 2097152 2048K ok\n" +" /dev/sda3 526385152 2048K ok\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:39 -msgid "List syslog messages from a VM disk image file:" +#: ../align/virt-alignment-scan.pod:42 +msgid "" +"To run the tool on a guest known to libvirt, use the I<-d> option and " +"possibly the I<-c> option:" msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:41 +#: ../align/virt-alignment-scan.pod:45 #, no-wrap msgid "" -" virt-cat -a disk.img /var/log/messages | tail\n" +" # virt-alignment-scan -d RHEL5\n" +" /dev/sda1 32256 512 bad (alignment < 4K)\n" +" /dev/sda2 106928640 512 bad (alignment < 4K)\n" "\n" msgstr "" -#. type: textblock -#: ../cat/virt-cat.pod:43 -msgid "Find out what DHCP IP address a VM acquired:" -msgstr "" - #. type: verbatim -#: ../cat/virt-cat.pod:45 +#: ../align/virt-alignment-scan.pod:49 #, no-wrap msgid "" -" virt-cat -d mydomain /var/log/messages | \\\n" -" grep 'dhclient: bound to' | tail\n" +" $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n" +" /dev/sda1 1048576 1024K ok\n" +" /dev/sda2 105906176 1024K ok\n" +" /dev/sdb1 65536 64K ok\n" "\n" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:48 -msgid "Find out what packages were recently installed:" +#: ../align/virt-alignment-scan.pod:54 +msgid "" +"The output consists of 4 or more whitespace-separated columns. Only the " +"first 4 columns are signficant if you want to parse this from a program. " +"The columns are:" msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:50 -#, no-wrap +#. type: =item +#: ../align/virt-alignment-scan.pod:60 +msgid "col 1" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:62 msgid "" -" virt-cat -d mydomain /var/log/yum.log | tail\n" -"\n" +"the device and partition name (eg. C meaning the first partition " +"on the first block device)" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:65 +msgid "col 2" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:52 -msgid "Find out who is logged on inside a virtual machine:" +#: ../align/virt-alignment-scan.pod:67 +msgid "the start of the partition in bytes" msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:54 -#, no-wrap +#. type: =item +#: ../align/virt-alignment-scan.pod:69 +msgid "col 3" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:71 +msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:73 +msgid "col 4" +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:75 msgid "" -" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" -" who /tmp/utmp\n" -"\n" +"C if the alignment is best for performance, or C if the alignment " +"can cause performance problems" +msgstr "" + +#. type: =item +#: ../align/virt-alignment-scan.pod:78 +msgid "cols 5+" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:57 -msgid "or who was logged on:" +#: ../align/virt-alignment-scan.pod:80 +msgid "optional free-text explanation." msgstr "" -#. type: verbatim -#: ../cat/virt-cat.pod:59 -#, no-wrap +#. type: textblock +#: ../align/virt-alignment-scan.pod:84 msgid "" -" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" -" last -f /tmp/wtmp\n" -"\n" +"The exit code from the program changes depending on whether poorly aligned " +"partitions were found. See L below." +msgstr "" + +#. type: textblock +#: ../align/virt-alignment-scan.pod:87 +msgid "If you just want the exit code with no output, use the I<-q> option." msgstr "" #. type: =head1 -#: ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91 -#: ../cat/virt-ls.pod:261 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62 +#: ../align/virt-alignment-scan.pod:89 ../cat/virt-cat.pod:62 +#: ../cat/virt-filesystems.pod:91 ../cat/virt-ls.pod:261 +#: ../clone/virt-sysprep.pod:42 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62 #: ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45 #: ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42 -#: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:83 -#: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84 -#: ../resize/virt-resize.pod:241 ../test-tool/libguestfs-test-tool.pod:37 +#: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:92 +#: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:112 +#: ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:99 +#: ../test-tool/libguestfs-test-tool.pod:36 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103 #: ../tools/virt-win-reg.pl:96 @@ -255,84 +276,83 @@ msgid "OPTIONS" msgstr "ПАРАМЕТРИ" #. type: =item -#: ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 -#: ../cat/virt-ls.pod:265 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 -#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:151 -#: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88 -#: ../resize/virt-resize.pod:245 ../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 +#: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66 +#: ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 +#: ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 +#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:160 +#: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:116 +#: ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:103 +#: ../test-tool/libguestfs-test-tool.pod:40 +#: ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62 +#: ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111 +#: ../tools/virt-win-reg.pl:104 msgid "B<--help>" msgstr "B<--help>" #. type: textblock -#: ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97 -#: ../cat/virt-ls.pod:267 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 -#: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90 +#: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:68 +#: ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 +#: ../clone/virt-sysprep.pod:48 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 +#: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:118 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113 #: ../tools/virt-win-reg.pl:106 msgid "Display brief help." -msgstr "" +msgstr "Показати коротку довідку." #. type: =item -#: ../cat/virt-cat.pod:70 ../cat/virt-filesystems.pod:99 -#: ../cat/virt-ls.pod:269 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70 -#: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92 -#, fuzzy -#| msgid "B<-f file>" +#: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:70 +#: ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269 +#: ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70 +#: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:120 msgid "B<-a> file" -msgstr "B<-f файл>" +msgstr "B<-a> файл" #. type: =item -#: ../cat/virt-cat.pod:72 ../cat/virt-filesystems.pod:101 -#: ../cat/virt-ls.pod:271 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72 -#: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94 -#, fuzzy -#| msgid "B<--add image>" +#: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72 +#: ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271 +#: ../clone/virt-sysprep.pod:52 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72 +#: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:122 msgid "B<--add> file" -msgstr "B<--add образ>" +msgstr "B<--add> файл" #. type: textblock -#: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103 -#: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74 -#: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96 -msgid "" -"Add I which should be a disk image from a virtual machine. If the " -"virtual machine has multiple block devices, you must supply all of them with " -"separate I<-a> options." +#: ../align/virt-alignment-scan.pod:101 ../clone/virt-sysprep.pod:54 +msgid "Add I which should be a disk image from a virtual machine." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:78 ../cat/virt-filesystems.pod:107 -#: ../cat/virt-ls.pod:277 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78 -#: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:93 -#: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100 +#: ../align/virt-alignment-scan.pod:103 ../cat/virt-cat.pod:78 +#: ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277 +#: ../clone/virt-sysprep.pod:56 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78 +#: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:102 +#: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:128 msgid "" "The format of the disk image is auto-detected. To override this and force a " "particular format use the I<--format=..> option." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125 -#: ../cat/virt-ls.pod:291 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:107 -#, fuzzy -#| msgid "B<-c URI>" +#: ../align/virt-alignment-scan.pod:106 ../cat/virt-cat.pod:81 +#: ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 +#: ../clone/virt-sysprep.pod:59 ../df/virt-df.pod:78 +#: ../rescue/virt-rescue.pod:135 msgid "B<-c> URI" -msgstr "B<-c адреса>" +msgstr "B<-c> адреса" #. type: =item -#: ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127 -#: ../cat/virt-ls.pod:293 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:109 -#, fuzzy -#| msgid "B<--connect URI>" +#: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83 +#: ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 +#: ../clone/virt-sysprep.pod:61 ../df/virt-df.pod:80 +#: ../rescue/virt-rescue.pod:137 msgid "B<--connect> URI" -msgstr "B<--connect адреса>" +msgstr "B<--connect> адреса" #. type: textblock -#: ../cat/virt-cat.pod:85 ../cat/virt-filesystems.pod:129 -#: ../cat/virt-ls.pod:295 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99 -#: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111 +#: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85 +#: ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295 +#: ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99 +#: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:139 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132 msgid "" @@ -341,73 +361,66 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132 -#: ../cat/virt-ls.pod:298 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:114 +#: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:88 +#: ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 +#: ../clone/virt-sysprep.pod:66 ../df/virt-df.pod:85 +#: ../rescue/virt-rescue.pod:142 msgid "" "If you specify guest block devices directly (I<-a>), then libvirt is not " "used at all." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141 -#: ../cat/virt-ls.pod:307 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 -#: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117 +#: ../align/virt-alignment-scan.pod:116 ../cat/virt-cat.pod:91 +#: ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 +#: ../clone/virt-sysprep.pod:69 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 +#: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:145 msgid "B<-d> guest" -msgstr "" +msgstr "B<-d> гість" #. type: =item -#: ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143 -#: ../cat/virt-ls.pod:309 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 -#: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119 +#: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93 +#: ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 +#: ../clone/virt-sysprep.pod:71 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 +#: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:147 msgid "B<--domain> guest" -msgstr "" +msgstr "B<--domain> гість" #. type: textblock -#: ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145 -#: ../cat/virt-ls.pod:311 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 -#: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121 +#: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95 +#: ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 +#: ../clone/virt-sysprep.pod:73 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 +#: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:149 msgid "" "Add all the disks from the named libvirt guest. Domain UUIDs can be used " "instead of names." msgstr "" #. type: =item -#: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148 -#: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217 -#: ../fuse/guestmount.pod:126 ../inspector/virt-inspector.pod:92 -msgid "B<--echo-keys>" -msgstr "B<--echo-keys>" - -#. type: textblock -#: ../cat/virt-cat.pod:100 -msgid "" -"When prompting for keys and passphrases, virt-cat normally turns echoing off " -"so you cannot see what you are typing. If you are not worried about Tempest " -"attacks and there is no one else in the room you can specify this flag to " -"see what you are typing." -msgstr "" - -#. type: =item -#: ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 -#: ../cat/virt-ls.pod:328 ../df/virt-df.pod:101 ../fish/guestfish.pod:233 -#: ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99 -#: ../rescue/virt-rescue.pod:124 +#: ../align/virt-alignment-scan.pod:123 ../cat/virt-cat.pod:105 +#: ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 +#: ../clone/virt-sysprep.pod:95 ../df/virt-df.pod:101 +#: ../fish/guestfish.pod:233 ../fuse/guestmount.pod:142 +#: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:152 msgid "B<--format=raw|qcow2|..>" msgstr "B<--format=raw|qcow2|..>" #. type: =item -#: ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172 -#: ../cat/virt-ls.pod:330 ../df/virt-df.pod:103 ../edit/virt-edit.pod:134 -#: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:135 -#: ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:126 +#: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:107 +#: ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330 +#: ../clone/virt-sysprep.pod:97 ../df/virt-df.pod:103 +#: ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235 +#: ../fuse/guestmount.pod:144 ../inspector/virt-inspector.pod:101 +#: ../rescue/virt-rescue.pod:154 msgid "B<--format>" msgstr "B<--format>" #. type: textblock -#: ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174 -#: ../cat/virt-ls.pod:332 ../df/virt-df.pod:105 ../edit/virt-edit.pod:136 -#: ../fish/guestfish.pod:237 ../fuse/guestmount.pod:137 -#: ../rescue/virt-rescue.pod:128 +#: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:109 +#: ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 +#: ../clone/virt-sysprep.pod:99 ../df/virt-df.pod:105 +#: ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237 +#: ../fuse/guestmount.pod:146 ../rescue/virt-rescue.pod:156 msgid "" "The default for the I<-a> option is to auto-detect the format of the disk " "image. Using this forces the disk format for I<-a> options which follow on " @@ -416,60 +429,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:161 ../src/guestfs.pod:2877 msgid "For example:" msgstr "Приклад:" #. type: verbatim -#: ../cat/virt-cat.pod:116 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img\n" -#| "\n" +#: ../align/virt-alignment-scan.pod:134 +#, no-wrap msgid "" -" virt-cat --format=raw -a disk.img file\n" +" virt-alignment-scan --format=raw -a disk.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img\n" -"\n" #. type: textblock -#: ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183 -#: ../cat/virt-ls.pod:341 ../df/virt-df.pod:114 ../edit/virt-edit.pod:145 -#: ../fish/guestfish.pod:246 ../rescue/virt-rescue.pod:137 +#: ../align/virt-alignment-scan.pod:136 ../cat/virt-cat.pod:118 +#: ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 +#: ../clone/virt-sysprep.pod:108 ../df/virt-df.pod:114 +#: ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 +#: ../rescue/virt-rescue.pod:165 msgid "forces raw format (no auto-detection) for C." msgstr "" #. type: verbatim -#: ../cat/virt-cat.pod:120 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#: ../align/virt-alignment-scan.pod:138 +#, no-wrap msgid "" -" virt-cat --format=raw -a disk.img --format -a another.img file\n" +" virt-alignment-scan --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" #. type: textblock -#: ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187 -#: ../cat/virt-ls.pod:345 ../df/virt-df.pod:118 ../edit/virt-edit.pod:149 -#: ../fish/guestfish.pod:250 ../rescue/virt-rescue.pod:141 +#: ../align/virt-alignment-scan.pod:140 ../cat/virt-cat.pod:122 +#: ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 +#: ../clone/virt-sysprep.pod:112 ../df/virt-df.pod:118 +#: ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 +#: ../rescue/virt-rescue.pod:169 msgid "" "forces raw format (no auto-detection) for C and reverts to auto-" "detection for C." msgstr "" #. type: textblock -#: ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190 -#: ../cat/virt-ls.pod:348 ../df/virt-df.pod:121 ../edit/virt-edit.pod:152 -#: ../rescue/virt-rescue.pod:144 +#: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125 +#: ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 +#: ../clone/virt-sysprep.pod:115 ../df/virt-df.pod:121 +#: ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:172 msgid "" "If you have untrusted raw-format guest disk images, you should use this " "option to specify the disk format. This avoids a possible security problem " @@ -477,227 +486,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:153 +msgid "B<-q>" +msgstr "B<-q>" + +#. type: =item +#: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:493 +#: ../sparsify/virt-sparsify.pod:155 +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:219 ../sparsify/virt-sparsify.pod:159 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:221 ../sparsify/virt-sparsify.pod:161 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:223 ../sparsify/virt-sparsify.pod:163 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:225 ../resize/virt-resize.pod:561 +#: ../sparsify/virt-sparsify.pod:165 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:227 ../resize/virt-resize.pod:563 +#: ../sparsify/virt-sparsify.pod:167 ../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:229 ../resize/virt-resize.pod:565 +#: ../sparsify/virt-sparsify.pod:169 ../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:240 ../sparsify/virt-sparsify.pod:171 #: ../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:242 ../sparsify/virt-sparsify.pod:173 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:215 +#: ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:367 +#: ../rescue/virt-rescue.pod:303 ../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:217 +#: ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:369 +#: ../rescue/virt-rescue.pod:305 ../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 +885,239 @@ 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:222 +#: ../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:227 +#: ../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 +#: ../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:3062 +#: ../src/guestfs.pod:3067 ../src/guestfs.pod:3071 ../src/guestfs.pod:3075 +#: ../src/guestfs.pod:3079 ../src/guestfs.pod:3093 ../src/guestfs.pod:3098 +#: ../src/guestfs.pod:3329 ../src/guestfs.pod:3333 ../src/guestfs.pod:3337 +#: ../src/guestfs.pod:3341 ../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:227 +#: ../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/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:303 -#: ../inspector/virt-inspector.pod:372 ../java/examples/guestfs-java.pod:45 +#: ../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:284 -#: ../resize/virt-resize.pod:608 ../ruby/examples/guestfs-ruby.pod:36 -#: ../src/guestfs.pod:3042 ../test-tool/libguestfs-test-tool.pod:87 +#: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:325 +#: ../resize/virt-resize.pod:688 ../ruby/examples/guestfs-ruby.pod:36 +#: ../sparsify/virt-sparsify.pod:251 ../src/guestfs.pod:3270 +#: ../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:235 +#: ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:334 +#: ../resize/virt-resize.pod:711 ../sparsify/virt-sparsify.pod:264 #: ../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:237 +#: ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:410 +#: ../rescue/virt-rescue.pod:336 ../resize/virt-resize.pod:713 +#: ../sparsify/virt-sparsify.pod:266 ../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 +#: ../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:239 +#: ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 +#: ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 +#: ../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: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 +#: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:332 +#: ../inspector/virt-inspector.pod:418 ../java/examples/guestfs-java.pod:62 +#: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 +#: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:338 +#: ../resize/virt-resize.pod:715 ../ruby/examples/guestfs-ruby.pod:52 +#: ../sparsify/virt-sparsify.pod:268 ../src/guestfs.pod:3352 +#: ../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:270 +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:243 +#: ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1305 +#: ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 +#: ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 +#: ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:422 +#: ../rescue/virt-rescue.pod:342 ../resize/virt-resize.pod:719 +#: ../sparsify/virt-sparsify.pod:272 ../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 +1126,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:248 +#: ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1310 +#: ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 +#: ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 +#: ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:427 +#: ../rescue/virt-rescue.pod:347 ../resize/virt-resize.pod:724 +#: ../sparsify/virt-sparsify.pod:277 ../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,165 +1150,615 @@ 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:253 +#: ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1315 +#: ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 +#: ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 +#: ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:432 +#: ../rescue/virt-rescue.pod:352 ../resize/virt-resize.pod:729 +#: ../sparsify/virt-sparsify.pod:282 ../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." msgstr "" +"Ви маєте отримати копію GNU General Public License разом з цією програмою; " +"якщо це не так, повідомте про факт за адресою Free Software Foundation, " +"Inc., 675 Mass Ave, Cambridge, MA 02139, USA." #. type: textblock -#: ../cat/virt-filesystems.pod:5 -msgid "" -"virt-filesystems - List filesystems, partitions, block devices, LVM in a " -"virtual machine or disk image" -msgstr "" +#: ../cat/virt-cat.pod:5 +msgid "virt-cat - Display files in a virtual machine" +msgstr "virt-cat — показ файлів у віртуальній машині" #. type: verbatim -#: ../cat/virt-filesystems.pod:9 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#: ../cat/virt-cat.pod:9 +#, no-wrap msgid "" -" virt-filesystems [--options] -d domname\n" +" virt-cat [--options] -d domname file [file ...]\n" "\n" msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" +" virt-cat [--параметри] -d назва_домену файл [файл...]\n" "\n" #. type: verbatim -#: ../cat/virt-filesystems.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#: ../cat/virt-cat.pod:11 +#, no-wrap msgid "" -" virt-filesystems [--options] -a disk.img [-a disk.img ...]\n" +" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" +" virt-cat [--параметри] -a диск.img [-a диск.img ...] файл [файл...]\n" "\n" #. type: textblock -#: ../cat/virt-filesystems.pod:15 -msgid "" -"This tool allows you to discover filesystems, partitions, logical volumes, " -"and their sizes in a disk image or virtual machine. It is a replacement for " -"L and L." -msgstr "" +#: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 +#: ../inspector/virt-inspector.pod:13 +msgid "Old-style:" +msgstr "Застарілий стиль:" -#. type: textblock -#: ../cat/virt-filesystems.pod:20 +#. type: verbatim +#: ../cat/virt-cat.pod:15 +#, no-wrap msgid "" -"One use for this tool is from shell scripts to iterate over all filesystems " -"from a disk image:" +" virt-cat domname file\n" +"\n" msgstr "" +" virt-cat назва_домену файл\n" +"\n" #. type: verbatim -#: ../cat/virt-filesystems.pod:23 +#: ../cat/virt-cat.pod:17 #, no-wrap msgid "" -" for fs in $(virt-filesystems -a disk.img); do\n" -" # ...\n" -" done\n" +" virt-cat disk.img file\n" "\n" msgstr "" +" virt-cat диск.img файл\n" +"\n" #. type: textblock -#: ../cat/virt-filesystems.pod:27 +#: ../cat/virt-cat.pod:21 msgid "" -"Another use is to list partitions before using another tool to modify those " -"partitions (such as L). If you are curious about what an " -"unknown disk image contains, use this tool along with L." +"C is a command line tool to display the contents of C where " +"C exists in the named virtual machine (or disk image)." msgstr "" +"C — інструмент командного рядка для показу вмісту C<файла>, який " +"зберігається у вказаній віртуальній машині (або образі диска)." #. type: textblock -#: ../cat/virt-filesystems.pod:32 +#: ../cat/virt-cat.pod:24 msgid "" -"Various command line options control what this program displays. You need " -"to give either I<-a> or I<-d> options to specify the disk image or libvirt " -"guest respectively. If you just specify that then the program shows " -"filesystems found, one per line, like this:" +"Multiple filenames can be given, in which case they are concatenated " +"together. Each filename must be a full path, starting at the root directory " +"(starting with '/')." msgstr "" +"Ви можете вказати декілька назв файлів. Вміст таких файлів буде об’єднано. " +"Назви файлів слід вказувати повністю (разом зі шляхом), починаючи з " +"кореневого каталогу (тобто назва має починатися з «/»)." -#. type: verbatim -#: ../cat/virt-filesystems.pod:37 -#, no-wrap +#. type: textblock +#: ../cat/virt-cat.pod:28 msgid "" -" $ virt-filesystems -a disk.img\n" -" /dev/sda1\n" -" /dev/vg_guest/lv_root\n" -"\n" +"C can be used to quickly view a file. To edit a file, use C. For more complex cases you should look at the L tool " +"(see L below)." msgstr "" +"C можна скористатися для пришвидшення перегляду файла. Для " +"редагування даних слід користуватися C. Для виконання складніших " +"дій можна скористатися програмою L (див. L " +"нижче)." + +#. type: =head1 +#: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43 +#: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41 +#: ../fish/guestfish.pod:1051 ../fish/virt-copy-in.pod:29 +#: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30 +#: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39 +#: ../resize/virt-resize.pod:27 ../sparsify/virt-sparsify.pod:75 +#: ../tools/virt-tar.pl:50 +msgid "EXAMPLES" +msgstr "ПРИКЛАДИ" #. type: textblock -#: ../cat/virt-filesystems.pod:41 +#: ../cat/virt-cat.pod:34 msgid "" -"If you add I<-l> or I<--long> then the output includes extra information:" +"Display C file from inside the libvirt VM called C:" msgstr "" +"Показ файла C з віртуальної машини libvirt з назвою C:" #. type: verbatim -#: ../cat/virt-filesystems.pod:44 +#: ../cat/virt-cat.pod:37 #, no-wrap msgid "" -" $ virt-filesystems -a disk.img -l\n" -" Name Type VFS Label Size\n" -" /dev/sda1 filesystem ext4 boot 524288000\n" -" /dev/vg_guest/lv_root filesystem ext4 root 10212081664\n" +" virt-cat -d mydomain /etc/fstab\n" "\n" msgstr "" +" virt-cat -d mydomain /etc/fstab\n" +"\n" #. type: textblock -#: ../cat/virt-filesystems.pod:49 -msgid "" -"If you add I<--extra> then non-mountable (swap, unknown) filesystems are " -"shown as well:" +#: ../cat/virt-cat.pod:39 +msgid "List syslog messages from a VM disk image file:" msgstr "" +"Показ списку повідомлень syslog з файла образу диска віртуальної машини:" #. type: verbatim -#: ../cat/virt-filesystems.pod:52 +#: ../cat/virt-cat.pod:41 #, no-wrap msgid "" -" $ virt-filesystems -a disk.img --extra\n" -" /dev/sda1\n" -" /dev/vg_guest/lv_root\n" -" /dev/vg_guest/lv_swap\n" -" /dev/vg_guest/lv_data\n" +" virt-cat -a disk.img /var/log/messages | tail\n" "\n" msgstr "" +" virt-cat -a disk.img /var/log/messages | tail\n" +"\n" #. type: textblock -#: ../cat/virt-filesystems.pod:58 -msgid "" -"If you add I<--partitions> then partitions are shown instead of filesystems:" -msgstr "" +#: ../cat/virt-cat.pod:43 +msgid "Find out what DHCP IP address a VM acquired:" +msgstr "Визначення IP-адреси DHCP, використаної віртуальною машиною:" #. type: verbatim -#: ../cat/virt-filesystems.pod:60 +#: ../cat/virt-cat.pod:45 #, no-wrap msgid "" -" $ virt-filesystems -a disk.img --partitions\n" -" /dev/sda1\n" -" /dev/sda2\n" +" virt-cat -d mydomain /var/log/messages | \\\n" +" grep 'dhclient: bound to' | tail\n" "\n" msgstr "" +" virt-cat -d mydomain /var/log/messages | \\\n" +" grep 'dhclient: bound to' | tail\n" +"\n" #. type: textblock -#: ../cat/virt-filesystems.pod:64 -msgid "" -"Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-" -"volumes>, I<--block-devices> to list those items." -msgstr "" +#: ../cat/virt-cat.pod:48 +msgid "Find out what packages were recently installed:" +msgstr "Пошук нещодавно встановлених пакунків:" + +#. type: verbatim +#: ../cat/virt-cat.pod:50 +#, no-wrap +msgid "" +" virt-cat -d mydomain /var/log/yum.log | tail\n" +"\n" +msgstr "" +" virt-cat -d mydomain /var/log/yum.log | tail\n" +"\n" + +#. type: textblock +#: ../cat/virt-cat.pod:52 +msgid "Find out who is logged on inside a virtual machine:" +msgstr "Визначення користувачів, які працюють у віртуальній машині:" + +#. type: verbatim +#: ../cat/virt-cat.pod:54 +#, no-wrap +msgid "" +" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" +"\n" +msgstr "" +" virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n" +" who /tmp/utmp\n" +"\n" + +#. type: textblock +#: ../cat/virt-cat.pod:57 +msgid "or who was logged on:" +msgstr "або тих, які у ній працювали:" + +#. type: verbatim +#: ../cat/virt-cat.pod:59 +#, no-wrap +msgid "" +" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" +"\n" +msgstr "" +" virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n" +" last -f /tmp/wtmp\n" +"\n" + +#. type: textblock +#: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103 +#: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74 +#: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:124 +msgid "" +"Add I which should be a disk image from a virtual machine. If the " +"virtual machine has multiple block devices, you must supply all of them with " +"separate I<-a> options." +msgstr "" + +#. type: =item +#: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148 +#: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217 +#: ../fuse/guestmount.pod:135 ../inspector/virt-inspector.pod:92 +msgid "B<--echo-keys>" +msgstr "B<--echo-keys>" + +#. type: textblock +#: ../cat/virt-cat.pod:100 +msgid "" +"When prompting for keys and passphrases, virt-cat normally turns echoing off " +"so you cannot see what you are typing. If you are not worried about Tempest " +"attacks and there is no one else in the room you can specify this flag to " +"see what you are typing." +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:116 +#, no-wrap +msgid "" +" virt-cat --format=raw -a disk.img file\n" +"\n" +msgstr "" +" virt-cat --format=raw -a disk.img file\n" +"\n" + +#. type: verbatim +#: ../cat/virt-cat.pod:120 +#, no-wrap +msgid "" +" virt-cat --format=raw -a disk.img --format -a another.img file\n" +"\n" +msgstr "" +" virt-cat --format=raw -a disk.img --format -a another.img file\n" +"\n" + +#. type: =item +#: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200 +#: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289 +#: ../fuse/guestmount.pod:172 ../inspector/virt-inspector.pod:114 +msgid "B<--keys-from-stdin>" +msgstr "B<--keys-from-stdin>" + +#. type: textblock +#: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202 +#: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291 +#: ../fuse/guestmount.pod:174 ../inspector/virt-inspector.pod:116 +msgid "" +"Read key or passphrase parameters from stdin. The default is to try to read " +"passphrases from the user by opening C." +msgstr "" + +#. type: =head1 +#: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179 +#: ../inspector/virt-inspector.pod:144 ../rescue/virt-rescue.pod:246 +msgid "OLD-STYLE COMMAND LINE ARGUMENTS" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:154 +msgid "Previous versions of virt-cat allowed you to write either:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:156 +#, no-wrap +msgid "" +" virt-cat disk.img [disk.img ...] file\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 +#: ../inspector/virt-inspector.pod:150 ../rescue/virt-rescue.pod:252 +msgid "or" +msgstr "або" + +#. type: verbatim +#: ../cat/virt-cat.pod:160 +#, no-wrap +msgid "" +" virt-cat guestname file\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 +#: ../inspector/virt-inspector.pod:154 ../rescue/virt-rescue.pod:256 +msgid "" +"whereas in this version you should use I<-a> or I<-d> respectively to avoid " +"the confusing case where a disk image might have the same name as a guest." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193 +#: ../inspector/virt-inspector.pod:158 ../rescue/virt-rescue.pod:260 +msgid "For compatibility the old style is still supported." +msgstr "" + +#. type: =head1 +#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858 +msgid "WINDOWS PATHS" +msgstr "ШЛЯХИ У WINDOWS" + +#. type: textblock +#: ../cat/virt-cat.pod:170 +msgid "" +"C has a limited ability to understand Windows drive letters and " +"paths (eg. C)." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:173 ../edit/virt-edit.pod:262 +msgid "If and only if the guest is running Windows then:" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:179 ../edit/virt-edit.pod:268 +msgid "" +"Drive letter prefixes like C are resolved against the Windows Registry " +"to the correct filesystem." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:184 ../edit/virt-edit.pod:273 +msgid "" +"Any backslash (C<\\>) characters in the path are replaced with forward " +"slashes so that libguestfs can process it." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:189 +msgid "" +"The path is resolved case insensitively to locate the file that should be " +"displayed." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:194 ../edit/virt-edit.pod:283 +msgid "There are some known shortcomings:" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:200 ../edit/virt-edit.pod:289 +msgid "Some NTFS symbolic links may not be followed correctly." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:204 ../edit/virt-edit.pod:293 +msgid "NTFS junction points that cross filesystems are not followed." +msgstr "" + +#. type: =head1 +#: ../cat/virt-cat.pod:208 ../edit/virt-edit.pod:297 +msgid "USING GUESTFISH" +msgstr "ВИКОРИСТАННЯ GUESTFISH" + +#. type: textblock +#: ../cat/virt-cat.pod:210 +msgid "" +"L is a more powerful, lower level tool which you can use when " +"C doesn't work." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:213 +msgid "Using C is approximately equivalent to doing:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:215 +#, no-wrap +msgid "" +" guestfish --ro -i -d domname download file -\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:217 +msgid "" +"where C is the name of the libvirt guest, and C is the full " +"path to the file. Note the final C<-> (meaning \"output to stdout\")." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:221 +msgid "" +"The command above uses libguestfs's guest inspection feature and so does not " +"work on guests that libguestfs cannot inspect, or on things like arbitrary " +"disk images that don't contain guests. To display a file from a disk image " +"directly, use:" +msgstr "" + +#. type: verbatim +#: ../cat/virt-cat.pod:226 +#, no-wrap +msgid "" +" guestfish --ro -a disk.img -m /dev/sda1 download file -\n" +"\n" +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:228 +msgid "" +"where C is the disk image, C is the filesystem within " +"the disk image, and C is the full path to the file." +msgstr "" + +#. type: textblock +#: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:382 +#: ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351 +#: ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:392 +#: ../resize/virt-resize.pod:685 ../sparsify/virt-sparsify.pod:229 +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." +msgstr "" #. type: textblock #: ../cat/virt-filesystems.pod:67 @@ -1032,10 +1807,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 +1821,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 +1863,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 +1881,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 +1898,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 +1924,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 +1936,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 +1977,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 +1999,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 +2017,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 +2034,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 +2054,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 +2069,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 +2090,7 @@ msgstr "" #. type: =head1 #: ../cat/virt-filesystems.pod:287 msgid "COLUMNS" -msgstr "" +msgstr "СТОВПЧИКИ" #. type: textblock #: ../cat/virt-filesystems.pod:289 @@ -1405,10 +2126,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 +2137,7 @@ msgstr "" #. type: =item #: ../cat/virt-filesystems.pod:309 msgid "B" -msgstr "" +msgstr "B" #. type: textblock #: ../cat/virt-filesystems.pod:311 @@ -1441,25 +2160,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,30 +2203,30 @@ 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 +#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:459 #: ../df/virt-df.pod:191 msgid "NOTE ABOUT CSV FORMAT" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461 +#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:461 #: ../df/virt-df.pod:193 msgid "" "Comma-separated values (CSV) is a deceptive format. It I like it " @@ -1499,7 +2234,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464 +#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:464 #: ../df/virt-df.pod:196 msgid "" "Myth: Just split fields at commas. Reality: This does I work " @@ -1507,7 +2242,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467 +#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467 #: ../df/virt-df.pod:199 #, no-wrap msgid "" @@ -1516,7 +2251,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469 +#: ../cat/virt-filesystems.pod:359 ../cat/virt-ls.pod:469 #: ../df/virt-df.pod:201 msgid "" "Myth: Read the file one line at a time. Reality: This does I work " @@ -1524,7 +2259,7 @@ msgid "" msgstr "" #. type: verbatim -#: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472 +#: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472 #: ../df/virt-df.pod:204 #, no-wrap msgid "" @@ -1534,7 +2269,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475 +#: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:475 #: ../df/virt-df.pod:207 msgid "" "For shell scripts, use C (L also " @@ -1542,7 +2277,7 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478 +#: ../cat/virt-filesystems.pod:368 ../cat/virt-ls.pod:478 #: ../df/virt-df.pod:210 msgid "" "For other languages, use a CSV processing library (eg. C for Perl " @@ -1550,32 +2285,26 @@ msgid "" msgstr "" #. type: textblock -#: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481 +#: ../cat/virt-filesystems.pod:371 ../cat/virt-ls.pod:481 #: ../df/virt-df.pod:213 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 +2321,32 @@ msgstr "" #. type: verbatim #: ../cat/virt-ls.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#, no-wrap msgid "" " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" #. type: textblock -#: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13 +#: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:15 msgid "Old style:" -msgstr "" +msgstr "Старий стиль:" #. type: verbatim #: ../cat/virt-ls.pod:15 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#, no-wrap msgid "" " virt-ls [--options] domname directory\n" "\n" msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" #. type: verbatim #: ../cat/virt-ls.pod:17 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#, no-wrap msgid "" " virt-ls [--options] disk.img [disk.img ...] directory\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" #. type: textblock #: ../cat/virt-ls.pod:21 @@ -1670,16 +2384,11 @@ 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 @@ -1807,7 +2516,7 @@ msgstr "" #. type: =head1 #: ../cat/virt-ls.pod:84 msgid "OUTPUT MODES" -msgstr "" +msgstr "РЕЖИМИ ВИВЕДЕННЯ ДАНИХ" #. type: textblock #: ../cat/virt-ls.pod:86 @@ -1819,7 +2528,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:89 msgid "SIMPLE LISTING" -msgstr "" +msgstr "ПРОСТИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:91 @@ -1836,13 +2545,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 +2574,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 +2592,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:113 msgid "RECURSIVE LISTING" -msgstr "" +msgstr "РЕКУРСИВНИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:115 @@ -1893,6 +2611,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 +2627,7 @@ msgstr "" #. type: =head2 #: ../cat/virt-ls.pod:126 msgid "RECURSIVE LONG LISTING" -msgstr "" +msgstr "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК" #. type: textblock #: ../cat/virt-ls.pod:128 @@ -1954,6 +2677,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 +2694,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 +2707,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 +2717,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 +2729,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 +2740,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 +2764,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 +2786,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 +2828,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 +2841,7 @@ msgstr "" #. type: =item #: ../cat/virt-ls.pod:238 msgid "inode" -msgstr "" +msgstr "inode" #. type: textblock #: ../cat/virt-ls.pod:240 @@ -2138,20 +2850,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 +2871,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 +2889,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 +2925,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 +2957,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 +2995,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 +3005,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 +3022,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 +3032,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 +3042,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 +3057,24372 @@ 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:241 ../edit/virt-edit.pod:374 +#: ../rescue/virt-rescue.pod:340 msgid "Copyright (C) 2009-2011 Red Hat Inc." -msgstr "© Red Hat Inc., 2009–2010" +msgstr "©Red Hat Inc., 2009–2011" #. type: textblock -#: ../df/virt-df.pod:5 -msgid "virt-df - Display free space on virtual filesystems" -msgstr "" - -#. type: verbatim -#: ../df/virt-df.pod:9 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#: ../clone/virt-sysprep.pod:5 msgid "" -" virt-df [--options]\n" -"\n" +"virt-sysprep - Reset or unconfigure a virtual machine so clones can be made" msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" #. type: verbatim -#: ../df/virt-df.pod:11 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#: ../clone/virt-sysprep.pod:9 +#, no-wrap msgid "" -" virt-df [--options] -d domname\n" +" virt-sysprep [--options] -d domname\n" "\n" msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" #. type: verbatim -#: ../df/virt-df.pod:13 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#: ../clone/virt-sysprep.pod:11 +#, no-wrap msgid "" -" virt-df [--options] -a disk.img [-a disk.img ...]\n" +" virt-sysprep [--options] -a disk.img [-a disk.img ...]\n" "\n" msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" -#. type: verbatim -#: ../df/virt-df.pod:17 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] domname\n" -#| "\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:15 msgid "" -" virt-df [--options] domname\n" -"\n" +"Virt-sysprep \"resets\" or \"unconfigures\" a virtual machine so that clones " +"can be made from it. Steps in this process include removing SSH host keys, " +"removing persistent network MAC configuration, and removing user accounts. " +"Each step can be enabled or disabled as required." msgstr "" -" virt-list-partitions [--параметри] назва_домену\n" -"\n" -#. type: verbatim -#: ../df/virt-df.pod:19 -#, fuzzy, no-wrap -#| msgid "" -#| " virt-list-partitions [--options] disk.img [disk.img ...]\n" -#| "\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:21 msgid "" -" virt-df [--options] disk.img [disk.img ...]\n" -"\n" +"Virt-sysprep is a simple shell script, allowing easy inspection or " +"customization by the system administrator." msgstr "" -" virt-list-partitions [--параметри] диск.img [диск.img ...]\n" -"\n" #. type: textblock -#: ../df/virt-df.pod:23 +#: ../clone/virt-sysprep.pod:24 msgid "" -"C is a command line tool to display free space on virtual machine " -"filesystems. Unlike other tools, it doesn't just display the size of disk " -"allocated to a virtual machine, but can look inside disk images to see how " -"much space is really being used." +"Virt-sysprep modifies the guest or disk image I. The guest must " +"be shut down. If you want to preserve the existing contents of the guest, " +"you I. See L below." msgstr "" #. type: textblock -#: ../df/virt-df.pod:28 +#: ../clone/virt-sysprep.pod:29 msgid "" -"If used without any I<-a> or I<-d> arguments, C checks with libvirt " -"to get a list of all active and inactive guests, and performs a C-type " -"operation on each one in turn, printing out the results." +"You do I need to run virt-sysprep as root. In fact we'd generally " +"recommend that you don't. The time you might want to run it as root is when " +"you need root in order to access the disk image, but even in this case it " +"would be better to change the permissions on the disk image to be writable " +"as the non-root user running virt-sysprep." msgstr "" #. type: textblock -#: ../df/virt-df.pod:32 +#: ../clone/virt-sysprep.pod:35 msgid "" -"If any I<-a> or I<-d> arguments are specified, C performs a C-" -"type operation on either the single named libvirt domain, or on the disk " -"image(s) listed on the command line (which must all belong to a single VM). " -"In this mode (with arguments), C will I. If you want to run on multiple guests, then you have to invoke " -"C multiple times." +"\"Sysprep\" stands for \"system preparation\" tool. The name comes from the " +"Microsoft program C which is used to unconfigure Windows " +"machines in preparation for cloning them. Having said that, virt-sysprep " +"does I currently work on Microsoft Windows guests. We plan to support " +"Windows sysprepping in a future version, and we already have code to do it." msgstr "" -#. type: textblock -#: ../df/virt-df.pod:39 -msgid "" -"Use the I<--csv> option to get a format which can be easily parsed by other " -"programs. Other options are similar to the standard L command." +#. type: =item +#: ../clone/virt-sysprep.pod:76 +msgid "B<--enable=...>" msgstr "" #. type: textblock -#: ../df/virt-df.pod:45 +#: ../clone/virt-sysprep.pod:78 msgid "" -"Show disk usage for a single libvirt guest called C. Make the " -"output human-readable:" +"Choose which sysprep operations to perform. Give a comma-separated list of " +"operations, for example:" msgstr "" #. type: verbatim -#: ../df/virt-df.pod:48 +#: ../clone/virt-sysprep.pod:81 #, no-wrap msgid "" -" # virt-df -d F14x64 -h\n" -" Filesystem Size Used Available Use%\n" -" F14x64:/dev/sda1 484M 66M 393M 14%\n" -" F14x64:/dev/vg_f13x64/lv_root 7.4G 3.4G 4.0G 46%\n" +" --enable=ssh-hostkeys,udev-persistent-net\n" "\n" msgstr "" #. type: textblock -#: ../df/virt-df.pod:53 -msgid "Show disk usage for a disk image file called C:" +#: ../clone/virt-sysprep.pod:83 +msgid "" +"would enable ONLY C and C operations." msgstr "" -#. type: verbatim -#: ../df/virt-df.pod:55 -#, no-wrap +#. type: textblock +#: ../clone/virt-sysprep.pod:85 msgid "" -" $ virt-df -a test1.img\n" -" Filesystem 1K-blocks Used Available Use%\n" -" test1.img:/dev/sda1 99099 1551 92432 2%\n" -"\n" +"If the I<--enable> option is not given, then we default to trying all " +"possible sysprep operations. But some sysprep operations are skipped for " +"some guest types." +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:89 +msgid "" +"Use I<--list-operations> to list operations supported by a particular " +"version of virt-sysprep." +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:92 +msgid "" +"See L below for a list and an explanation of each operation." msgstr "" #. type: verbatim -#: ../df/virt-df.pod:112 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img\n" -#| "\n" +#: ../clone/virt-sysprep.pod:106 +#, no-wrap msgid "" -" virt-df --format=raw -a disk.img\n" +" virt-sysprep --format=raw -a disk.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img\n" -"\n" #. type: verbatim -#: ../df/virt-df.pod:116 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#: ../clone/virt-sysprep.pod:110 +#, no-wrap msgid "" -" virt-df --format=raw -a disk.img --format -a another.img\n" +" virt-sysprep --format=raw -a disk.img --format -a another.img\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" -#. type: textblock -#: ../df/virt-df.pod:129 -msgid "Print sizes in human-readable format." +#. type: =item +#: ../clone/virt-sysprep.pod:119 +msgid "B<--hostname> newhostname" msgstr "" #. type: textblock -#: ../df/virt-df.pod:131 -msgid "You are not allowed to use I<-h> and I<--csv> at the same time." +#: ../clone/virt-sysprep.pod:121 +msgid "" +"Change the hostname. See the L operation below. If not given, " +"defaults to C." msgstr "" #. type: =item -#: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155 -msgid "B<-i>" -msgstr "B<-i>" - -#. type: =item -#: ../df/virt-df.pod:135 -#, fuzzy -#| msgid "B<--live>" -msgid "B<--inodes>" -msgstr "B<--live>" +#: ../clone/virt-sysprep.pod:124 +msgid "B<--list-operations>" +msgstr "" #. type: textblock -#: ../df/virt-df.pod:137 -msgid "Print inodes instead of blocks." +#: ../clone/virt-sysprep.pod:126 +msgid "List the operations supported by the virt-sysprep program." msgstr "" #. type: =item -#: ../df/virt-df.pod:139 -#, fuzzy -#| msgid "B<--merge>" -msgid "B<--one-per-guest>" -msgstr "B<--merge>" +#: ../clone/virt-sysprep.pod:128 +msgid "B<--selinux-relabel>" +msgstr "" + +#. type: =item +#: ../clone/virt-sysprep.pod:130 +msgid "B<--no-selinux-relabel>" +msgstr "" #. type: textblock -#: ../df/virt-df.pod:141 +#: ../clone/virt-sysprep.pod:132 msgid "" -"Run one libguestfs appliance per guest. Normally C will add the " -"disks from several guests to a single libguestfs appliance." +"I<--selinux-relabel> forces SELinux relabelling next time the guest boots. " +"I<--no-selinux-relabel> disables relabelling." msgstr "" #. type: textblock -#: ../df/virt-df.pod:144 -msgid "You might use this option in the following circumstances:" +#: ../clone/virt-sysprep.pod:135 +msgid "" +"The default is to try to detect if SELinux relabelling is required. See L below for more details." msgstr "" -#. type: =item -#: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 -#: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 -#: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 -#: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 -#: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 -#: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 -#: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 -#: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 -#: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 -#: ../fish/guestfish-actions.pod:390 ../fish/guestfish-actions.pod:398 -#: ../fish/guestfish-actions.pod:405 ../fish/guestfish-actions.pod:412 -#: ../fish/guestfish-actions.pod: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: 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 '/')." +#. type: =head2 +#: ../clone/virt-sysprep.pod:194 +msgid "logfiles" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:36 -msgid "If you want to just view a file, use L." +#: ../clone/virt-sysprep.pod:196 +msgid "Remove many log files." msgstr "" -#. type: textblock -#: ../edit/virt-edit.pod:38 -msgid "" -"For more complex cases you should look at the L tool (see L below)." +#. type: =head2 +#: ../clone/virt-sysprep.pod:198 +msgid "mail-spool" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:41 -msgid "" -"C cannot be used to create a new file. L can do " -"that and much more." +#: ../clone/virt-sysprep.pod:200 +msgid "Remove email from the local mail spool directory." msgstr "" -#. type: textblock -#: ../edit/virt-edit.pod:46 -msgid "Edit the named files interactively:" +#. type: =head2 +#: ../clone/virt-sysprep.pod:202 +msgid "net-hwaddr" msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:48 -#, no-wrap +#. type: textblock +#: ../clone/virt-sysprep.pod:204 msgid "" -" virt-edit -d mydomain /boot/grub/grub.conf\n" -"\n" +"Remove HWADDR (hard-coded MAC address) configuration. For Fedora and Red " +"Hat Enterprise Linux, this is removed from C files." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:50 -#, no-wrap +#. type: =head2 +#: ../clone/virt-sysprep.pod:207 +msgid "random-seed" +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:209 msgid "" -" virt-edit -d mydomain /etc/passwd\n" -"\n" +"Write some random bytes from the host into the random seed file of the guest." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:52 -msgid "For Windows guests, some Windows paths are understood:" +#: ../clone/virt-sysprep.pod:212 +msgid "See L below." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:54 -#, no-wrap -msgid "" -" virt-edit -d mywindomain 'c:\\autoexec.bat'\n" -"\n" +#. type: =head2 +#: ../clone/virt-sysprep.pod:214 +msgid "rhn-systemid" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:56 -msgid "" -"If Perl is installed, you can also edit files non-interactively (see L below). To change the init default level to 5:" +#: ../clone/virt-sysprep.pod:216 +msgid "Remove the RHN system ID." msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:60 -#, no-wrap -msgid "" -" virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n" -"\n" +#. type: =head2 +#: ../clone/virt-sysprep.pod:218 +msgid "smolt-uuid" msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:81 -msgid "B<-b> extension" +#. type: textblock +#: ../clone/virt-sysprep.pod:220 +msgid "Remove the Smolt hardware UUID." msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:83 -msgid "B<--backup> extension" +#. type: =head2 +#: ../clone/virt-sysprep.pod:222 +msgid "ssh-hostkeys" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:85 +#: ../clone/virt-sysprep.pod:224 +msgid "Remove the SSH host keys in the guest." +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:226 msgid "" -"Create a backup of the original file I. The backup " -"has the original filename with C added." +"The SSH host keys are regenerated (differently) next time the guest is " +"booted." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:88 +#: ../clone/virt-sysprep.pod:229 msgid "" -"Usually the first character of C would be a dot C<.> so you would " -"write:" +"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:91 +#: ../clone/virt-sysprep.pod:232 #, no-wrap msgid "" -" virt-edit -b .orig [etc]\n" +" @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n" +" @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @\n" +" @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n" +" IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n" "\n" msgstr "" +#. type: =head2 +#: ../clone/virt-sysprep.pod:237 +msgid "udev-persistent-net" +msgstr "" + #. type: textblock -#: ../edit/virt-edit.pod:93 -msgid "By default, no backup file is made." +#: ../clone/virt-sysprep.pod:239 +msgid "" +"Remove udev persistent net rules which map the guest's existing MAC address " +"to a fixed ethernet device (eg. eth0)." 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:242 +msgid "" +"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: =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:247 +msgid "utmp" +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 -msgid "" -"If you specify guest block devices directly, then libvirt is not used at all." +#: ../clone/virt-sysprep.pod:249 +msgid "Remove the utmp file." msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:114 +#: ../clone/virt-sysprep.pod:251 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." +"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:119 -msgid "B<-e> EXPR" +#. type: =head2 +#: ../clone/virt-sysprep.pod:255 +msgid "yum-uuid" msgstr "" -#. type: =item -#: ../edit/virt-edit.pod:121 -#, fuzzy -#| msgid "B<--help>" -msgid "B<--expr> EXPR" -msgstr "B<--help>" +#. type: textblock +#: ../clone/virt-sysprep.pod:257 +msgid "Remove the yum UUID." +msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:123 +#: ../clone/virt-sysprep.pod:259 msgid "" -"Instead of launching the external editor, non-interactively apply the Perl " -"expression C to each line in the file. See L below." +"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:127 +#: ../clone/virt-sysprep.pod:264 msgid "" -"Be careful to properly quote the expression to prevent it from being altered " -"by the shell." +"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: textblock -#: ../edit/virt-edit.pod:130 -msgid "Note that this option is only available when Perl 5 is installed." +#: ../clone/virt-sysprep.pod:269 +msgid "A virtual machine (when switched off) consists of two parts:" msgstr "" #. type: =item -#: ../edit/virt-edit.pod:132 -#, fuzzy -#| msgid "B<--format=raw|qcow2|..>" -msgid "B<--format> raw|qcow2|..." -msgstr "B<--format=raw|qcow2|..>" +#: ../clone/virt-sysprep.pod:273 +msgid "I" +msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:143 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img\n" -#| "\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:275 msgid "" -" virt-edit --format=raw -a disk.img file\n" -"\n" +"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 "" -" 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:279 +msgid "Some configuration items that might need to be changed:" 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:285 +msgid "name" msgstr "" -#. type: verbatim -#: ../edit/virt-edit.pod:187 -#, fuzzy, no-wrap -#| msgid "" -#| " edit filename\n" -#| "\n" -msgid "" -" virt-edit guestname file\n" -"\n" +#. type: textblock +#: ../clone/virt-sysprep.pod:289 ../clone/virt-sysprep.pod:316 +msgid "UUID" msgstr "" -" edit назва_файла\n" -"\n" -#. type: =head1 -#: ../edit/virt-edit.pod:195 -msgid "NON-INTERACTIVE EDITING" +#. type: textblock +#: ../clone/virt-sysprep.pod:293 +msgid "path to block device(s)" 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:297 +msgid "network card MAC address" +msgstr "" + +#. type: =item +#: ../clone/virt-sysprep.pod:301 +msgid "I" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:200 +#: ../clone/virt-sysprep.pod:303 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.)" +"One or more hard disk images, themselves containing files, directories, " +"applications, kernels, configuration, etc." 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:306 +msgid "Some things inside the block devices that might need to be changed:" msgstr "" #. type: textblock -#: ../edit/virt-edit.pod:210 +#: ../clone/virt-sysprep.pod:312 +msgid "hostname and other net configuration" +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:320 +msgid "SSH host keys" +msgstr "" + +#. type: textblock +#: ../clone/virt-sysprep.pod:324 +msgid "Windows unique security ID (SID)" +msgstr "" + +#. type: textblock +#: ../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" -msgstr "" - -#. type: =end -#: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12 -msgid "comment" +"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: textblock -#: ../examples/guestfs-recipes.pod:5 +#: ../df/virt-df.pod:229 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." +"L, L, L, L, L." 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." +#: ../edit/virt-edit.pod:5 +msgid "virt-edit - Edit a file in a virtual machine" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:16 -msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes" +#. 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:20 +#. type: verbatim +#: ../edit/virt-edit.pod:11 +#, no-wrap msgid "" -"This page contains recipes for and links to things you can do using " -"libguestfs, L and the virt tools." +" virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n" +"\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:23 -msgid "Audit a virtual machine for setuid files" +#. type: verbatim +#: ../edit/virt-edit.pod:13 +#, no-wrap +msgid "" +" virt-edit [-d domname|-a disk.img] file -e 'expr'\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:25 +#. type: verbatim +#: ../edit/virt-edit.pod:17 +#, no-wrap 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." +" virt-edit domname file\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:28 +#. type: verbatim +#: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-" -"files/#content" +" virt-edit disk.img [disk.img ...] file\n" +"\n" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:30 -msgid "Change the background image in a Windows XP VM" -msgstr "" +#: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23 +#: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15 +#: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:21 +#: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51 +msgid "WARNING" +msgstr "ПОПЕРЕДЖЕННЯ" #. type: textblock -#: ../examples/guestfs-recipes.pod:32 +#: ../edit/virt-edit.pod:23 msgid "" -"The links below explain how to use L to change the background " -"image for a user of a Windows XP VM. Unfortunately the technique appears to " -"be substantially different for each version of Windows." +"You 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:37 +#: ../edit/virt-edit.pod:29 msgid "" -"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)" +"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:42 +#: ../edit/virt-edit.pod:32 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." +"Multiple filenames can be given, in which case they are each edited in " +"turn. Each filename must be a full path, starting at the root directory " +"(starting with '/')." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:46 +#: ../edit/virt-edit.pod:36 +msgid "If you want to just view a file, use L." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:38 msgid "" -"https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-" -"vm/#content" +"For more complex cases you should look at the L tool (see L below)." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:48 +#: ../edit/virt-edit.pod:41 msgid "" -"Avoid L. Currently what to do about virt-clone is under " -"discussion." +"C cannot be used to create a new file. L can do " +"that and much more." 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:46 +msgid "Edit the named files interactively:" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:53 -msgid "Cloning a virtual machine (Windows)" +#. type: verbatim +#: ../edit/virt-edit.pod:48 +#, no-wrap +msgid "" +" virt-edit -d mydomain /boot/grub/grub.conf\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:55 +#. type: verbatim +#: ../edit/virt-edit.pod:50 +#, no-wrap 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." +" virt-edit -d mydomain /etc/passwd\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:60 -msgid "" -"https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-" -"list/2011-May/msg00019.html" +#: ../edit/virt-edit.pod:52 +msgid "For Windows guests, some Windows paths are understood:" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:63 -msgid "Convert a CD-ROM / DVD / ISO to a tarball" +#. type: verbatim +#: ../edit/virt-edit.pod:54 +#, no-wrap +msgid "" +" virt-edit -d mywindomain 'c:\\autoexec.bat'\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:65 -msgid "This converts input C to output C:" +#: ../edit/virt-edit.pod:56 +msgid "" +"If Perl is installed, you can also edit files non-interactively (see L below). To change the init default level to 5:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:67 +#: ../edit/virt-edit.pod:60 #, no-wrap msgid "" -" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" +" virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n" "\n" msgstr "" +#. type: =item +#: ../edit/virt-edit.pod:81 +msgid "B<-b> extension" +msgstr "" + +#. type: =item +#: ../edit/virt-edit.pod:83 +msgid "B<--backup> extension" +msgstr "" + #. type: textblock -#: ../examples/guestfs-recipes.pod:69 -msgid "To export just a subdirectory, eg. C, do:" +#: ../edit/virt-edit.pod:85 +msgid "" +"Create a backup of the original file I. The backup " +"has the original filename with C added." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:88 +msgid "" +"Usually the first character of C would be a dot C<.> so you would " +"write:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:71 +#: ../edit/virt-edit.pod:91 #, no-wrap msgid "" -" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" +" virt-edit -b .orig [etc]\n" "\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:73 -msgid "Create empty disk images" +#. type: textblock +#: ../edit/virt-edit.pod:93 +msgid "By default, no backup file is made." msgstr "" +#. type: =item +#: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181 +#: ../fuse/guestmount.pod:105 ../inspector/virt-inspector.pod:74 +#: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78 +#: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128 +msgid "B<-c URI>" +msgstr "B<-c адреса>" + +#. type: =item +#: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183 +#: ../fuse/guestmount.pod:107 ../inspector/virt-inspector.pod:76 +#: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80 +#: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130 +msgid "B<--connect URI>" +msgstr "B<--connect адреса>" + #. type: textblock -#: ../examples/guestfs-recipes.pod:75 +#: ../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 "" -"You can use the L I<-N> option to create empty disk images. " -"The useful guide below explains the options available." +"If you specify guest block devices directly, then libvirt is not used at all." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:78 +#: ../edit/virt-edit.pod:114 msgid "" -"https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/" -"#content" +"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: =head1 -#: ../examples/guestfs-recipes.pod:80 -msgid "Dump raw filesystem content from inside a disk image or VM" +#. type: =item +#: ../edit/virt-edit.pod:119 +msgid "B<-e> EXPR" +msgstr "B<-e> вираз" + +#. type: =item +#: ../edit/virt-edit.pod:121 +msgid "B<--expr> EXPR" +msgstr "B<--expr> вираз" + +#. type: textblock +#: ../edit/virt-edit.pod:123 +msgid "" +"Instead of launching the external editor, non-interactively apply the Perl " +"expression C to each line in the file. See L below." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:82 +#: ../edit/virt-edit.pod:127 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):" +"Be careful to properly quote the expression to prevent it from being altered " +"by the shell." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:130 +msgid "Note that this option is only available when Perl 5 is installed." msgstr "" +#. type: =item +#: ../edit/virt-edit.pod:132 +msgid "B<--format> raw|qcow2|..." +msgstr "B<--format> raw|qcow2|..." + #. type: verbatim -#: ../examples/guestfs-recipes.pod:86 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --format=raw -a disk.img --format -a another.img\n" -#| "\n" +#: ../edit/virt-edit.pod:143 +#, no-wrap msgid "" -" guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n" +" virt-edit --format=raw -a disk.img file\n" "\n" msgstr "" -" guestfish --format=raw -a disk.img --format -a another.img\n" -"\n" #. type: verbatim -#: ../examples/guestfs-recipes.pod:88 +#: ../edit/virt-edit.pod:147 #, no-wrap msgid "" -" guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n" +" virt-edit --format=raw -a disk.img --format -a another.img file\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:181 +msgid "Previous versions of virt-edit allowed you to write either:" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:92 -msgid "Edit grub configuration in a VM" +#. type: verbatim +#: ../edit/virt-edit.pod:187 +#, no-wrap +msgid "" +" virt-edit guestname file\n" +"\n" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:94 -msgid "You can use this to:" -msgstr "" +#. type: =head1 +#: ../edit/virt-edit.pod:195 +msgid "NON-INTERACTIVE EDITING" +msgstr "НЕІНТЕРАКТИВНЕ РЕДАГУВАННЯ" #. type: textblock -#: ../examples/guestfs-recipes.pod:100 -msgid "Fix a virtual machine that does not boot." +#: ../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:104 -msgid "Change which kernel is used to boot the VM." +#: ../edit/virt-edit.pod:200 +msgid "" +"There are two ways also to use C from scripts in order to make " +"automated edits to files. (Note that although you I use C " +"like this, it's less error-prone to write scripts directly using the " +"libguestfs API and Augeas for configuration file editing.)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:108 -msgid "Change kernel command line options." +#: ../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:112 -msgid "Use L to edit the grub configuration:" +#: ../edit/virt-edit.pod:210 +msgid "" +"The second method is to use the I<-e> parameter of C to run a " +"short Perl snippet in the style of L. For example to replace all " +"instances of C with C in a file:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:114 +#: ../edit/virt-edit.pod:214 #, no-wrap msgid "" -" virt-edit -d BrokenGuest /boot/grub/grub.conf\n" +" virt-edit -d domname filename -e 's/foo/bar/'\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:116 +#: ../edit/virt-edit.pod:216 msgid "" -"or for general tinkering inside an unbootable VM use L like " -"this:" +"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:119 +#: ../edit/virt-edit.pod:219 #, no-wrap msgid "" -" virt-rescue -d BrokenGuest\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: =head1 -#: ../examples/guestfs-recipes.pod:121 -msgid "Export any directory from a VM" +#. 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 -#: ../examples/guestfs-recipes.pod:123 +#: ../edit/virt-edit.pod:226 msgid "" -"To export C from a VM into a local directory use L:" +"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:126 -#, fuzzy, no-wrap -#| msgid "" -#| " copy-out /home .\n" -#| "\n" +#: ../edit/virt-edit.pod:229 +#, no-wrap msgid "" -" virt-copy-out -d Guest /home .\n" +" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n" "\n" msgstr "" -" copy-out /home .\n" +" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n" "\n" #. 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:231 +msgid "" +"To insert a line, prepend or append it to C<$_>. However appending lines to " +"the end of the file is rather difficult this way since there is no concept " +"of \"last line of the file\" - your expression just doesn't get called " +"again. You might want to use the first method (setting C<$EDITOR>) if you " +"want to do this." +msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:134 +#: ../edit/virt-edit.pod:237 msgid "" -"The final dot of the command is not a printing error. It means we want to " -"copy out to the current directory." +"The variable C<$lineno> contains the current line number. As is " +"traditional, the first line in the file is number C<1>." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:139 -msgid "This creates a directory called C under the current directory." +#: ../edit/virt-edit.pod:240 +msgid "" +"The return value from the expression is ignored, but the expression may call " +"C in order to abort the whole program, leaving the original file " +"untouched." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:143 +#: ../edit/virt-edit.pod:244 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:" +"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:147 +#: ../edit/virt-edit.pod:249 #, no-wrap msgid "" -" virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" +" /some text(\\r?\\n)?$/\n" "\n" msgstr "" +" /якийсь текст(\\r?\\n)?$/\n" +"\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:149 -msgid "To get the output as a compressed tarball, do:" +#: ../edit/virt-edit.pod:251 +msgid "" +"Alternately, use the perl C function, being careful not to chomp C<" +"$_> itself (since that would remove all newlines from the file):" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:151 +#: ../edit/virt-edit.pod:255 #, no-wrap msgid "" -" virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" +" my $m = $_; chomp $m; $m =~ /some text$/\n" "\n" msgstr "" +" my $m = $_; chomp $m; $m =~ /якийсь текст$/\n" +"\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:153 +#: ../edit/virt-edit.pod:259 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" +"C has a limited ability to understand Windows drive letters and " +"paths (eg. C)." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:157 -msgid "Find out which user is using the most space" +#. type: textblock +#: ../edit/virt-edit.pod:278 +msgid "" +"The path is resolved case insensitively to locate the file that should be " +"edited." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:159 +#: ../edit/virt-edit.pod:299 msgid "" -"This simple script examines a Linux guest to find out which user is using " -"the most space in their home directory:" +"L is a more powerful, lower level tool which you can use when " +"C doesn't work." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:302 +msgid "Using C is approximately equivalent to doing:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:162 -#, fuzzy, no-wrap -#| msgid "" -#| " #!/usr/bin/guestfish -f\n" -#| "\n" +#: ../edit/virt-edit.pod:304 +#, no-wrap msgid "" -" #!/bin/sh -\n" -" \n" -msgstr "" -" #!/usr/bin/guestfish -f\n" +" guestfish --rw -i -d domname edit /file\n" "\n" +msgstr "" -#. type: verbatim -#: ../examples/guestfs-recipes.pod:164 -#, fuzzy, no-wrap -#| msgid "" -#| " set-qemu qemu\n" -#| "\n" +#. type: textblock +#: ../edit/virt-edit.pod:306 msgid "" -" set -e\n" -" \n" +"where C is the name of the libvirt guest, and C is the full " +"path to the file." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:309 +msgid "" +"The command above uses libguestfs's guest inspection feature and so does not " +"work on guests that libguestfs cannot inspect, or on things like arbitrary " +"disk images that don't contain guests. To edit a file on a disk image " +"directly, use:" msgstr "" -" set-qemu qemu\n" -"\n" #. type: verbatim -#: ../examples/guestfs-recipes.pod:166 +#: ../edit/virt-edit.pod:314 #, no-wrap msgid "" -" vm=\"$1\"\n" -" dir=/home\n" -" \n" +" guestfish --rw -a disk.img -m /dev/sda1 edit /file\n" +"\n" 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:316 msgid "" -" eval $(guestfish --ro -d \"$vm\" -i --listen)\n" -" \n" +"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 "" -" guestfish --ro -d myguest -i\n" + +#. type: textblock +#: ../edit/virt-edit.pod:320 +msgid "" +"C cannot create new files. Use the guestfish commands C, " +"C or C instead:" +msgstr "" + +#. type: verbatim +#: ../edit/virt-edit.pod:323 +#, no-wrap +msgid "" +" guestfish --rw -i -d domname touch /newfile\n" "\n" +msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:171 +#: ../edit/virt-edit.pod:325 #, 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" +" guestfish --rw -i -d domname write /newfile \"new content\"\n" +"\n" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941 +#: ../edit/virt-edit.pod:327 #, no-wrap msgid "" -" guestfish --remote exit\n" +" guestfish --rw -i -d domname upload localfile /newfile\n" "\n" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:179 -msgid "Get DHCP address from a VM" +#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1119 +#: ../rescue/virt-rescue.pod:298 ../sparsify/virt-sparsify.pod:232 +#: ../src/guestfs.pod:3209 ../test-tool/libguestfs-test-tool.pod:95 +msgid "ENVIRONMENT VARIABLES" +msgstr "ЗМІННІ СЕРЕДОВИЩА" + +#. type: =item +#: ../edit/virt-edit.pod:333 +msgid "C" +msgstr "C" + +#. type: textblock +#: ../edit/virt-edit.pod:335 +msgid "" +"If set, this string is used as the editor. It may contain arguments, eg. C<" +"\"emacs -nw\">" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:181 +#: ../edit/virt-edit.pod:338 +msgid "If not set, C is used." +msgstr "" + +#. type: textblock +#: ../edit/virt-edit.pod:356 msgid "" -"The link below explains the many different possible techniques for getting " -"the last assigned DHCP address of a virtual machine." +"L, L, L, L, L, L, L, L, " +"L, L, L." msgstr "" +"L, L, L, L, L, L, L, L, " +"L, L, L." #. type: textblock -#: ../examples/guestfs-recipes.pod:184 +#: ../erlang/examples/guestfs-erlang.pod:5 +msgid "guestfs-erlang - How to use libguestfs from Erlang" +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:9 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-" -"a-virtual-machine-disk-image/#content" +" {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:186 +#: ../erlang/examples/guestfs-erlang.pod:18 msgid "" -"In the libguestfs source examples directory you will find the latest version " -"of the C program." +"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:189 -msgid "Get the operating system product name string" +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:23 +msgid "OPENING AND CLOSING THE HANDLE" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:191 -msgid "Save the following script into a file called 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: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" +#: ../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-get-product-name \"$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:200 -msgid "Make the script executable and run it on a named guest:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:202 +#: ../erlang/examples/guestfs-erlang.pod:31 #, no-wrap msgid "" -" # product-name.sh RHEL60x64\n" -" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" +" {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\n" "\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:205 -msgid "" -"You can also use an XPath query on the L XML using the " -"C command line tool or from your favourite programming language:" +#: ../erlang/examples/guestfs-erlang.pod:33 +msgid "C is the libguestfs handle which you should pass to other functions." +msgstr "" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:36 +msgid "To close the handle:" msgstr "" #. type: verbatim -#: ../examples/guestfs-recipes.pod:209 +#: ../erlang/examples/guestfs-erlang.pod:38 #, 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" +" ok = guestfs:close(G).\n" "\n" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:215 -msgid "Get the default boot kernel for a Linux VM" +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:40 +msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:217 +#: ../erlang/examples/guestfs-erlang.pod:42 msgid "" -"The link below contains a program to print the default boot kernel for a " -"Linux VM." +"For functions that take optional arguments, the first arguments are the non-" +"optional ones. The last argument is a list of tuples supplying the " +"remaining optional arguments." +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:46 +#, no-wrap +msgid "" +" ok = guestfs:add_drive_opts(G, Disk,\n" +" [{format, \"raw\"}, {readonly, true}]).\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:220 +#: ../erlang/examples/guestfs-erlang.pod:49 +msgid "If the last argument would be an empty list, you can also omit it:" +msgstr "" + +#. type: verbatim +#: ../erlang/examples/guestfs-erlang.pod:51 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-" -"kernel-for-a-vm/#content" +" ok = guestfs:add_drive_opts(G, Disk).\n" +"\n" +msgstr "" + +#. type: =head2 +#: ../erlang/examples/guestfs-erlang.pod:53 +msgid "RETURN VALUES AND ERRORS" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:222 +#: ../erlang/examples/guestfs-erlang.pod:55 msgid "" -"It uses Augeas, and the technique is generally applicable for many different " -"tasks, such as:" +"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:229 -msgid "listing the user accounts in the guest" +#: ../erlang/examples/guestfs-erlang.pod:59 +msgid "On error, you would see one of the following tuples:" +msgstr "" + +#. type: =item +#: ../erlang/examples/guestfs-erlang.pod:63 +msgid "C<{error, Msg, Errno}>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:233 -msgid "what repositories is it configured to use" +#: ../erlang/examples/guestfs-erlang.pod:65 +msgid "This indicates an ordinary error from the function." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:237 -msgid "what NTP servers does it connect to" +#: ../erlang/examples/guestfs-erlang.pod:67 +msgid "" +"C is the error message (string) and C is the Unix error " +"(integer)." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:241 -msgid "what were the boot messages last time it booted" +#: ../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:245 -msgid "listing who was logged in recently" +#: ../erlang/examples/guestfs-erlang.pod:74 +msgid "" +"This indicates that the function you called is not known. Generally this " +"means you are mixing C from another version of libguestfs, " +"which you should not do." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:249 -msgid "http://augeas.net/" +#: ../erlang/examples/guestfs-erlang.pod:78 +msgid "C is the name of the unknown function." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:251 -msgid "Install RPMs in a guest" +#. type: =item +#: ../erlang/examples/guestfs-erlang.pod:80 +msgid "C<{unknownarg, Arg}>" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:253 +#: ../erlang/examples/guestfs-erlang.pod:82 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." +"This indicates that you called a function with optional arguments, with an " +"unknown argument name." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:259 -msgid "" -"https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content" +#: ../erlang/examples/guestfs-erlang.pod:85 +msgid "C is the name of the unknown argument." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:261 -msgid "List applications installed in a VM" +#: ../erlang/examples/guestfs-erlang.pod:89 +#: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37 +#: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31 +#: ../python/examples/guestfs-python.pod:34 +#: ../ruby/examples/guestfs-ruby.pod:28 +msgid "EXAMPLE 1: CREATE A DISK IMAGE" +msgstr "ПРИКЛАД 1. СТВОРЕННЯ ОБРАЗУ ДИСКА" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:91 +#: ../examples/guestfs-examples.pod:27 ../java/examples/guestfs-java.pod:39 +#: ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33 +#: ../python/examples/guestfs-python.pod:36 +#: ../ruby/examples/guestfs-ruby.pod:30 +msgid "@EXAMPLE1@" +msgstr "@EXAMPLE1@" + +#. type: =head1 +#: ../erlang/examples/guestfs-erlang.pod:93 +#: ../examples/guestfs-examples.pod:29 ../java/examples/guestfs-java.pod:41 +#: ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35 +#: ../python/examples/guestfs-python.pod:38 +#: ../ruby/examples/guestfs-ruby.pod:32 +msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE" +msgstr "ПРИКЛАД 2. ПЕРЕВІРКА ОБРАЗУ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:95 +#: ../examples/guestfs-examples.pod:31 ../java/examples/guestfs-java.pod:43 +#: ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37 +#: ../python/examples/guestfs-python.pod:40 +#: ../ruby/examples/guestfs-ruby.pod:34 +msgid "@EXAMPLE2@" +msgstr "@EXAMPLE2@" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:99 +msgid "" +"L, L, L, L, L, L, L, " +"L, L. L." msgstr "" +#. type: =head1 +#: ../erlang/examples/guestfs-erlang.pod:110 +#: ../examples/guestfs-examples.pod:45 ../examples/guestfs-recipes.pod:397 +#: ../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:3348 +#: ../test-tool/libguestfs-test-tool.pod:106 +msgid "AUTHORS" +msgstr "АВТОРИ" + #. type: textblock -#: ../examples/guestfs-recipes.pod:263 -msgid "Save the following to a file C:" +#: ../erlang/examples/guestfs-erlang.pod:112 +#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399 +#: ../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:3350 +#: ../test-tool/libguestfs-test-tool.pod:108 +msgid "Richard W.M. Jones (C)" +msgstr "Richard W.M. Jones (C)" + +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:116 +#: ../java/examples/guestfs-java.pod:64 ../perl/examples/guestfs-perl.pod:58 +msgid "Copyright (C) 2011 Red Hat Inc. L" 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" +#. 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 "" -" #!/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" +"The examples in this manual page may be freely copied, modified and " +"distributed without any restrictions." 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:272 +#: ../erlang/examples/guestfs-erlang.pod:121 +#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408 +#: ../java/examples/guestfs-java.pod:69 +#: ../ocaml/examples/guestfs-ocaml.pod:102 +#: ../perl/examples/guestfs-perl.pod:63 +#: ../python/examples/guestfs-python.pod:65 +#: ../ruby/examples/guestfs-ruby.pod:59 ../src/guestfs.pod:3357 msgid "" -"Make the file executable and then you can run it on any named virtual " -"machine:" +"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: verbatim -#: ../examples/guestfs-recipes.pod:275 -#, no-wrap +#. type: textblock +#: ../erlang/examples/guestfs-erlang.pod:126 +#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413 +#: ../java/examples/guestfs-java.pod:74 +#: ../ocaml/examples/guestfs-ocaml.pod:107 +#: ../perl/examples/guestfs-perl.pod:68 +#: ../python/examples/guestfs-python.pod:70 +#: ../ruby/examples/guestfs-ruby.pod:64 ../src/guestfs.pod:3362 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" -"\n" +"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:305 +#: ../erlang/examples/guestfs-erlang.pod:131 +#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418 +#: ../java/examples/guestfs-java.pod:79 +#: ../ocaml/examples/guestfs-ocaml.pod:112 +#: ../perl/examples/guestfs-perl.pod:73 +#: ../python/examples/guestfs-python.pod:75 +#: ../ruby/examples/guestfs-ruby.pod:69 ../src/guestfs.pod:3367 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." +"You should have received a copy of the GNU Lesser General Public License " +"along with this library; if not, write to the Free Software Foundation, " +"Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA" msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:309 -msgid "List files and directories in a VM" +#. type: textblock +#: ../examples/guestfs-examples.pod:5 +msgid "guestfs-examples - Examples of using libguestfs from C" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:311 -msgid "This involves using the L C command like this:" +#. type: verbatim +#: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9 +#, no-wrap +msgid "" +" #include \n" +" \n" msgstr "" +" #include \n" +" \n" #. type: verbatim -#: ../examples/guestfs-recipes.pod:313 -#, fuzzy, no-wrap -#| msgid "" -#| " guestfish --ro -d myguest -i\n" -#| "\n" +#: ../examples/guestfs-examples.pod:11 +#, no-wrap msgid "" -" guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n" +" guestfs_h *g = guestfs_create ();\n" +" guestfs_add_drive_ro (g, \"disk.img\");\n" +" guestfs_launch (g);\n" "\n" msgstr "" -" guestfish --ro -d myguest -i\n" +" guestfs_h *g = guestfs_create ();\n" +" guestfs_add_drive_ro (g, \"disk.img\");\n" +" guestfs_launch (g);\n" "\n" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:315 -msgid "List services in a Windows VM" +#. type: verbatim +#: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19 +#, no-wrap +msgid "" +" cc prog.c -o prog -lguestfs\n" +"or:\n" +" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" +"\n" msgstr "" +" cc prog.c -o prog -lguestfs\n" +"або:\n" +" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n" +"\n" #. type: textblock -#: ../examples/guestfs-recipes.pod:317 +#: ../examples/guestfs-examples.pod:21 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." +"This manual page contains examples of calling libguestfs from the C " +"programming language. If you are not familiar with using libguestfs, you " +"also need to read L." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:321 +#: ../examples/guestfs-examples.pod:35 msgid "" -"https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/" -"#content" +"L, L, L, L, L, L, L, " +"L, L." msgstr "" -#. type: =head1 -#: ../examples/guestfs-recipes.pod:323 -msgid "Make a disk image sparse" +#. type: textblock +#: ../examples/guestfs-examples.pod:51 ../ocaml/examples/guestfs-ocaml.pod:97 +#: ../python/examples/guestfs-python.pod:60 +#: ../ruby/examples/guestfs-ruby.pod:54 +msgid "Copyright (C) 2010 Red Hat Inc. L" msgstr "" +#. type: =end +#: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12 +msgid "comment" +msgstr "коментар" + #. type: textblock -#: ../examples/guestfs-recipes.pod:325 +#: ../examples/guestfs-recipes.pod:5 msgid "" -"The link below contains some guides for making a disk image sparse (or " -"reintroducing sparseness)." +"pod2man and pod2html have differing bugs which makes it hard to write URLs " +"here. The only way which works for both sorts of output is to just write " +"the URL directly. Do NOT use L<...> for URLs." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:328 +#: ../examples/guestfs-recipes.pod:9 msgid "" -"https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content" -msgstr "" - -#. type: =head1 -#: ../examples/guestfs-recipes.pod:330 -msgid "Monitor disk usage over time" +"We break with tradition here and don't use ALL CAPS for the section " +"headings, as this makes them much easier to read." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:332 -msgid "" -"You can use L to monitor disk usage of your guests over time. " -"The link below contains a guide." +#: ../examples/guestfs-recipes.pod:16 +msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:335 -msgid "http://virt-tools.org/learning/advanced-virt-df/" +#: ../examples/guestfs-recipes.pod:20 +msgid "" +"This page contains recipes for and links to things you can do using " +"libguestfs, L and the virt tools." msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:337 -msgid "Reading the Windows Event Log from Windows Vista (or later)" +#: ../examples/guestfs-recipes.pod:23 +msgid "Audit a virtual machine for setuid files" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:339 +#: ../examples/guestfs-recipes.pod:25 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." +"The link below contains a small program which can be used to audit a Linux " +"virtual machine to see what setuid and setgid files it contains." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:343 +#: ../examples/guestfs-recipes.pod:28 msgid "" -"https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-" -"guestfish/#content" +"https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-" +"files/#content" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:345 -msgid "Remove root password (Linux)" +#: ../examples/guestfs-recipes.pod:30 +msgid "Change the background image in a Windows XP VM" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:347 +#: ../examples/guestfs-recipes.pod:32 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:" +"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: verbatim -#: ../examples/guestfs-recipes.pod:350 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-recipes.pod:37 msgid "" -" virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n" -"\n" +"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:352 -msgid "Remove Administrator password (Windows)" +#: ../examples/guestfs-recipes.pod:40 +msgid "Cloning a virtual machine (Linux)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:354 +#: ../examples/guestfs-recipes.pod:42 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:" +"The guestfish technique described in the link below works well for most " +"Linux VMs. Depending on the Linux distro you may need to change the paths " +"slightly." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:359 +#: ../examples/guestfs-recipes.pod:46 msgid "" -"https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-" -"administrator-password-with-guestfish/" +"https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-" +"vm/#content" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:48 +msgid "" +"Avoid L. Currently what to do about virt-clone is under " +"discussion." +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:51 +msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:361 -msgid "Unpack a live CD" +#: ../examples/guestfs-recipes.pod:53 +msgid "Cloning a virtual machine (Windows)" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:363 +#: ../examples/guestfs-recipes.pod:55 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." +"It is possible to do a \"sysprep\" using libguestfs alone, although not " +"straightforward. Currently there is code in the Aeolus Oz project which " +"does this (using libguestfs). As part of our review of the virt-clone tool, " +"we may add sysprepping ability." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:367 +#: ../examples/guestfs-recipes.pod:60 msgid "" -"https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-" -"cd/#content" +"https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-" +"list/2011-May/msg00019.html" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:369 -msgid "Uploading and downloading files" +#: ../examples/guestfs-recipes.pod:63 +msgid "Convert a CD-ROM / DVD / ISO to a tarball" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:371 +#: ../examples/guestfs-recipes.pod:65 +msgid "This converts input C to output C:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:67 +#, no-wrap msgid "" -"The link below contains general tips on uploading (copying in) and " -"downloading (copying out) files from VMs." +" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n" +"\n" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:374 +#: ../examples/guestfs-recipes.pod:69 +msgid "To export just a subdirectory, eg. C, do:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:71 +#, no-wrap msgid "" -"https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content" +" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n" +"\n" msgstr "" #. type: =head1 -#: ../examples/guestfs-recipes.pod:376 -msgid "Use libguestfs tools on VMware ESX guests" +#: ../examples/guestfs-recipes.pod:73 +msgid "Create empty disk images" msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:378 +#: ../examples/guestfs-recipes.pod:75 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." +"You can use the L I<-N> option to create empty disk images. " +"The useful guide below explains the options available." msgstr "" #. type: textblock -#: ../examples/guestfs-recipes.pod:382 +#: ../examples/guestfs-recipes.pod:78 msgid "" -"https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-" -"guests/#content" +"https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/" +"#content" msgstr "" -#. type: textblock -#: ../examples/guestfs-recipes.pod:386 -#, fuzzy -#| msgid "" -#| "L, L, L, L, L, L, L, L, L." -msgid "" -"L, L, L, L, " -"L, L, L, L, L." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:80 +msgid "Dump raw filesystem content from inside a disk image or VM" 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-recipes.pod:82 +msgid "" +"You can use the L C command to extract the raw " +"filesystem content from any filesystem in a disk image or a VM (even one " +"which is encrypted or buried inside an LV):" +msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1 -msgid "add-cdrom" +#. type: verbatim +#: ../examples/guestfs-recipes.pod:86 +#, no-wrap +msgid "" +" guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n" +"\n" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:3 +#: ../examples/guestfs-recipes.pod:88 #, no-wrap msgid "" -" add-cdrom filename\n" +" guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n" "\n" msgstr "" #. 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." +#: ../examples/guestfs-recipes.pod:90 +msgid "To list the filesystems in a disk image, use L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16 -msgid "This is equivalent to the qemu parameter I<-cdrom filename>." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:92 +msgid "Edit grub configuration in a VM" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:15 -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." +#: ../examples/guestfs-recipes.pod:94 +msgid "You can use this to:" 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-recipes.pod:100 +msgid "Fix a virtual machine that does not boot." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163 -#: ../fish/guestfish-actions.pod:177 -msgid "" -"I In new code, use the L call " -"instead." +#: ../examples/guestfs-recipes.pod:104 +msgid "Change which kernel is used to boot the VM." 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 -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." +#: ../examples/guestfs-recipes.pod:108 +msgid "Change kernel command line options." 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:112 +msgid "Use L to edit the grub configuration:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:39 +#: ../examples/guestfs-recipes.pod:114 #, no-wrap msgid "" -" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n" +" virt-edit -d BrokenGuest /boot/grub/grub.conf\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:41 +#: ../examples/guestfs-recipes.pod:116 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." +"or for general tinkering inside an unbootable VM use L like " +"this:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:64 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:119 +#, no-wrap msgid "" -"The number of disks added is returned. This operation is atomic: if an " -"error is returned, then no disks are added." +" virt-rescue -d BrokenGuest\n" +"\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:67 -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." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:121 +msgid "Export any directory from a VM" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:71 +#: ../examples/guestfs-recipes.pod:123 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." +"To export C from a VM into a local directory use L:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:76 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:126 +#, no-wrap 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)." +" virt-copy-out -d Guest /home .\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:82 -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." -msgstr "" +#: ../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 -#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:89 +#: ../examples/guestfs-recipes.pod:134 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." +"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:76 -msgid "" -"The other optional parameters are passed directly through to L." +#: ../examples/guestfs-recipes.pod:139 +msgid "This creates a directory called C under the current directory." 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 +#: ../examples/guestfs-recipes.pod:143 msgid "" -"This command has one or more optional arguments. See L." +"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: =head2 -#: ../fish/guestfish-actions.pod:81 -msgid "add-drive" -msgstr "add-drive" - #. type: verbatim -#: ../fish/guestfish-actions.pod:83 +#: ../examples/guestfs-recipes.pod:147 #, no-wrap msgid "" -" add-drive filename\n" +" virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n" "\n" msgstr "" -" add-drive назва_файла\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:85 +#: ../examples/guestfs-recipes.pod:149 +msgid "To get the output as a compressed tarball, do:" +msgstr "" + +#. type: verbatim +#: ../examples/guestfs-recipes.pod:151 +#, no-wrap msgid "" -"This function is the equivalent of calling L with no " -"optional parameters, so the disk is added writable, with the format being " -"detected automatically." +" virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:89 +#: ../examples/guestfs-recipes.pod:153 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." +"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: =head2 -#: ../fish/guestfish-actions.pod:96 -msgid "add-drive-opts" -msgstr "add-drive-opts" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:157 +msgid "Find out which user is using the most space" +msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:98 -msgid "add" -msgstr "add" +#. type: textblock +#: ../examples/guestfs-recipes.pod:159 +msgid "" +"This simple script examines a Linux guest to find out which user is using " +"the most space in their home directory:" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:100 +#: ../examples/guestfs-recipes.pod:162 #, no-wrap msgid "" -" add-drive-opts filename [readonly:..] [format:..] [iface:..]\n" -"\n" +" #!/bin/sh -\n" +" \n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:102 ../src/guestfs-actions.pod:160 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:164 ../fish/guestfish.pod:984 +#, no-wrap 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." +" set -e\n" +" \n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:107 ../src/guestfs-actions.pod:165 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:166 +#, 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)." +" vm=\"$1\"\n" +" dir=/home\n" +" \n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:113 ../src/guestfs-actions.pod:171 -msgid "This call checks that C exists." +#. type: verbatim +#: ../examples/guestfs-recipes.pod:169 +#, no-wrap +msgid "" +" eval $(guestfish --ro -d \"$vm\" -i --listen)\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: 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:119 ../src/guestfs-actions.pod:177 -msgid "C" -msgstr "C" - -#. type: textblock -#: ../fish/guestfish-actions.pod:121 ../src/guestfs-actions.pod:179 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941 +#, no-wrap 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." +" guestfish --remote exit\n" +"\n" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:125 ../src/guestfs-actions.pod:183 -msgid "C" -msgstr "C" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:179 +msgid "Get DHCP address from a VM" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:127 +#: ../examples/guestfs-recipes.pod:181 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." +"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:131 ../src/guestfs-actions.pod:189 +#: ../examples/guestfs-recipes.pod:184 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." +"https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-" +"a-virtual-machine-disk-image/#content" 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:186 msgid "" -"This rarely-used option lets you emulate the behaviour of the deprecated L call (q.v.)" +"In the libguestfs source examples directory you will find the latest version " +"of the C program." 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 -#, no-wrap -msgid "" -" add-drive-ro filename\n" -"\n" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:189 +msgid "Get the operating system product name string" 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" +#: ../examples/guestfs-recipes.pod:191 +msgid "Save the following script into a file called C:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:158 +#: ../examples/guestfs-recipes.pod:193 #, no-wrap msgid "" -" add-drive-ro-with-if filename iface\n" +" #!/bin/sh -\n" +" set -e\n" +" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n" +" root=\"$(guestfish --remote inspect-get-roots)\"\n" +" guestfish --remote inspect-get-product-name \"$root\"\n" +" guestfish --remote exit\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:200 +msgid "Make the script executable and run it on a named guest:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:172 +#: ../examples/guestfs-recipes.pod:202 #, no-wrap msgid "" -" add-drive-with-if filename iface\n" +" # product-name.sh RHEL60x64\n" +" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:174 +#: ../examples/guestfs-recipes.pod:205 msgid "" -"This is the same as L but it allows you to specify the QEMU " -"interface emulation to use at run time." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:184 -msgid "aug-clear" +"You can also use an XPath query on the L XML using the " +"C command line tool or from your favourite programming language:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:186 +#: ../examples/guestfs-recipes.pod:209 #, no-wrap msgid "" -" aug-clear augpath\n" +" # virt-inspector RHEL60x64 > xml\n" +" # xpath '//product_name' < xml\n" +" Found 1 nodes:\n" +" -- NODE --\n" +" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n" "\n" msgstr "" -#. type: 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." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:215 +msgid "Get the default boot kernel for a Linux VM" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:191 -msgid "aug-close" +#. type: textblock +#: ../examples/guestfs-recipes.pod:217 +msgid "" +"The link below contains a program to print the default boot kernel for a " +"Linux VM." msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:193 -#, no-wrap +#. type: textblock +#: ../examples/guestfs-recipes.pod:220 msgid "" -" aug-close\n" -"\n" +"https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-" +"kernel-for-a-vm/#content" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:195 +#: ../examples/guestfs-recipes.pod:222 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." +"It uses Augeas, and the technique is generally applicable for many different " +"tasks, such as:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:200 -msgid "aug-defnode" +#. type: textblock +#: ../examples/guestfs-recipes.pod:229 +msgid "listing the user accounts in the guest" msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:202 -#, no-wrap -msgid "" -" aug-defnode name expr val\n" -"\n" +#. type: textblock +#: ../examples/guestfs-recipes.pod:233 +msgid "what repositories is it configured to use" 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." +#: ../examples/guestfs-recipes.pod:237 +msgid "what NTP servers does it connect to" 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." +#: ../examples/guestfs-recipes.pod:241 +msgid "what were the boot messages last time it booted" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:211 ../src/guestfs-actions.pod:326 -msgid "" -"On success this returns a pair containing the number of nodes in the " -"nodeset, and a boolean flag if a node was created." +#: ../examples/guestfs-recipes.pod:245 +msgid "listing who was logged in recently" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:215 -msgid "aug-defvar" +#. type: textblock +#: ../examples/guestfs-recipes.pod:249 +msgid "http://augeas.net/" msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:217 -#, no-wrap -msgid "" -" aug-defvar name expr\n" -"\n" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:251 +msgid "Install RPMs in a guest" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:219 ../src/guestfs-actions.pod:343 +#: ../examples/guestfs-recipes.pod:253 msgid "" -"Defines an Augeas variable C whose value is the result of evaluating " -"C. If C is NULL, then C is undefined." +"The link below contains a method to install RPMs in a guest. In fact the " +"RPMs are just uploaded to the guest along with a \"firstboot\" script that " +"installs them next time the guest is booted. You could use this technique " +"to install vital security updates in an offline guest." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:223 ../src/guestfs-actions.pod:347 +#: ../examples/guestfs-recipes.pod:259 msgid "" -"On success this returns the number of nodes in C, or C<0> if C " -"evaluates to something which is not a nodeset." +"https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:226 -msgid "aug-get" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:261 +msgid "List applications installed in a VM" +msgstr "" + +#. type: textblock +#: ../examples/guestfs-recipes.pod:263 +msgid "Save the following to a file C:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:228 +#: ../examples/guestfs-recipes.pod:265 #, no-wrap msgid "" -" aug-get augpath\n" +" #!/bin/sh -\n" +" set -e\n" +" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n" +" root=\"$(guestfish --remote inspect-get-roots)\"\n" +" guestfish --remote inspect-list-applications \"$root\"\n" +" guestfish --remote exit\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:230 ../src/guestfs-actions.pod:360 +#: ../examples/guestfs-recipes.pod:272 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" +"Make the file executable and then you can run it on any named virtual " +"machine:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:235 +#: ../examples/guestfs-recipes.pod:275 #, no-wrap msgid "" -" aug-init root flags\n" +" # list-apps.sh WinGuest\n" +" [0] = {\n" +" app_name: Mozilla Firefox (3.6.12)\n" +" app_display_name: Mozilla Firefox (3.6.12)\n" +" app_epoch: 0\n" +" app_version: 3.6.12 (en-GB)\n" +" app_release:\n" +" app_install_path: C:\\Program Files\\Mozilla Firefox\n" +" app_trans_path:\n" +" app_publisher: Mozilla\n" +" app_url: http://www.mozilla.com/en-GB/\n" +" app_source_package:\n" +" app_summary:\n" +" app_description: Mozilla Firefox\n" +" }\n" +" [1] = {\n" +" app_name: VLC media player\n" +" app_display_name: VLC media player 1.1.5\n" +" app_epoch: 0\n" +" app_version: 1.1.5\n" +" app_release:\n" +" app_install_path: C:\\Program Files\\VideoLAN\\VLC\n" +" app_trans_path:\n" +" app_publisher: VideoLAN\n" +" app_url: http://www.videolan.org/\n" +" app_source_package:\n" +" app_summary:\n" +" app_description:\n" +" }\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:237 ../src/guestfs-actions.pod:375 +#: ../examples/guestfs-recipes.pod:305 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." +"If you want to run the script on disk images (instead of libvirt virtual " +"machines), change C<-d \"$1\"> to C<-a \"$1\">. See also L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:241 -msgid "You must call this before using any other L commands." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:309 +msgid "List files and directories in a VM" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:244 ../src/guestfs-actions.pod:382 -msgid "" -"C is the filesystem root. C must not be NULL, use C instead." +#: ../examples/guestfs-recipes.pod:311 +msgid "This involves using the L C command like this:" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:247 ../src/guestfs-actions.pod:385 +#. type: verbatim +#: ../examples/guestfs-recipes.pod:313 +#, no-wrap msgid "" -"The flags are the same as the flags defined in Eaugeas.hE, the " -"logical I of the following integers:" +" guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n" +"\n" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:253 ../src/guestfs-actions.pod:391 -msgid "C = 1" -msgstr "C = 1" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:315 +msgid "List services in a Windows VM" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:393 -msgid "Keep the original file with a C<.augsave> extension." +#: ../examples/guestfs-recipes.pod:317 +msgid "" +"The link below contains a script that can be used to list out the services " +"from a Windows VM, and whether those services run at boot time or are loaded " +"on demand." msgstr "" -#. type: =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 +#: ../examples/guestfs-recipes.pod:321 msgid "" -"Save changes into a file with extension C<.augnew>, and do not overwrite " -"original. Overrides C." +"https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/" +"#content" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:400 -msgid "C = 4" -msgstr "C = 4" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:323 +msgid "Make a disk image sparse" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:264 ../src/guestfs-actions.pod:402 -msgid "Typecheck lenses." +#: ../examples/guestfs-recipes.pod:325 +msgid "" +"The link below contains some guides for making a disk image sparse (or " +"reintroducing sparseness)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:266 +#: ../examples/guestfs-recipes.pod:328 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." +"https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:271 ../src/guestfs-actions.pod:409 -msgid "C = 8" -msgstr "C = 8" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:330 +msgid "Monitor disk usage over time" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:273 ../src/guestfs-actions.pod:411 -msgid "Do not use standard load path for modules." +#: ../examples/guestfs-recipes.pod:332 +msgid "" +"You can use L to monitor disk usage of your guests over time. " +"The link below contains a guide." 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." +#: ../examples/guestfs-recipes.pod:335 +msgid "http://virt-tools.org/learning/advanced-virt-df/" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:279 ../src/guestfs-actions.pod:417 -msgid "C = 32" -msgstr "C = 32" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:337 +msgid "Reading the Windows Event Log from Windows Vista (or later)" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:281 -msgid "Do not load the tree in L." +#: ../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." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:285 -msgid "To close the handle, you can call L." +#: ../examples/guestfs-recipes.pod:343 +msgid "" +"https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-" +"guestfish/#content" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:287 ../src/guestfs-actions.pod:425 -msgid "To find out more about Augeas, see L." +#. type: =head1 +#: ../examples/guestfs-recipes.pod:345 +msgid "Remove root password (Linux)" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:289 -msgid "aug-insert" +#. type: textblock +#: ../examples/guestfs-recipes.pod:347 +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:" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:291 +#: ../examples/guestfs-recipes.pod:350 #, no-wrap msgid "" -" aug-insert augpath label true|false\n" +" virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n" "\n" msgstr "" +#. type: =head1 +#: ../examples/guestfs-recipes.pod:352 +msgid "Remove Administrator password (Windows)" +msgstr "" + #. type: textblock -#: ../fish/guestfish-actions.pod:293 ../src/guestfs-actions.pod:439 +#: ../examples/guestfs-recipes.pod:354 msgid "" -"Create a new sibling C functions which have " -"a more complex interface." +#: ../fish/guestfish-actions.pod:332 +msgid "Do not load the tree in L." 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 -msgid "" -"Because of the message protocol, there is a transfer limit of somewhere " -"between 2MB and 4MB. See L." +#: ../fish/guestfish-actions.pod:336 +msgid "To close the handle, you can call L." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:478 +msgid "To find out more about Augeas, see L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:625 -msgid "checksum" -msgstr "checksum" +#: ../fish/guestfish-actions.pod:340 +msgid "aug-insert" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:627 +#: ../fish/guestfish-actions.pod:342 #, no-wrap msgid "" -" checksum csumtype path\n" +" aug-insert augpath label true|false\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:629 ../src/guestfs-actions.pod:960 +#: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:492 msgid "" -"This call computes the MD5, SHAx or CRC checksum of the file named C." +"Create a new sibling C, L." +#: ../fish/guestfish-actions.pod:560 +msgid "" +"See also L for the real sector size of the device, and L for the more useful I." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:869 -msgid "download-offset" -msgstr "download-offset" +#: ../fish/guestfish-actions.pod:566 +msgid "blockdev-rereadpt" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:871 +#: ../fish/guestfish-actions.pod:568 #, no-wrap msgid "" -" download-offset remotefilename (filename|-) offset size\n" +" blockdev-rereadpt device\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:876 ../src/guestfs-actions.pod:1330 -msgid "" -"C is read for C bytes starting at C (this " -"region must be within the file or device)." +#: ../fish/guestfish-actions.pod:570 ../src/guestfs-actions.pod:829 +msgid "Reread the partition table on C." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:879 +#. type: =head2 +#: ../fish/guestfish-actions.pod:574 +msgid "blockdev-setbsz" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:576 +#, no-wrap 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." +" blockdev-setbsz device blocksize\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:884 -msgid "See also L, L." +#: ../fish/guestfish-actions.pod:578 ../src/guestfs-actions.pod:844 +msgid "This sets the block size of a device." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:888 -msgid "drop-caches" +#: ../fish/guestfish-actions.pod:585 +msgid "blockdev-setro" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:890 +#: ../fish/guestfish-actions.pod:587 #, no-wrap msgid "" -" drop-caches whattodrop\n" +" blockdev-setro device\n" "\n" 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:589 ../src/guestfs-actions.pod:861 +msgid "Sets the block device named C to read-only." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:897 ../src/guestfs-actions.pod:1360 -msgid "Setting C to 3 should drop everything." +#. type: =head2 +#: ../fish/guestfish-actions.pod:593 +msgid "blockdev-setrw" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:899 ../src/guestfs-actions.pod:1362 +#. type: verbatim +#: ../fish/guestfish-actions.pod:595 +#, no-wrap msgid "" -"This automatically calls L before the operation, so that the " -"maximum guest memory is freed." +" blockdev-setrw device\n" +"\n" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:597 ../src/guestfs-actions.pod:875 +msgid "Sets the block device named C to read-write." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:902 -msgid "du" -msgstr "du" +#: ../fish/guestfish-actions.pod:601 +msgid "btrfs-filesystem-resize" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:904 +#: ../fish/guestfish-actions.pod:603 #, no-wrap msgid "" -" du path\n" +" btrfs-filesystem-resize mountpoint [size:..]\n" "\n" msgstr "" -" du шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:906 ../src/guestfs-actions.pod:1375 -msgid "" -"This command runs the C command to estimate file space usage for " -"C." +#: ../fish/guestfish-actions.pod:605 ../src/guestfs-actions.pod:897 +msgid "This command resizes a btrfs filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:909 ../src/guestfs-actions.pod:1378 +#: ../fish/guestfish-actions.pod:607 ../src/guestfs-actions.pod:899 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)." +"Note that unlike other resize calls, the filesystem has to be mounted and " +"the parameter is the mountpoint not the device (this is a requirement of " +"btrfs itself)." 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)." +#: ../fish/guestfish-actions.pod:611 ../fish/guestfish-actions.pod:3606 +#: ../src/guestfs-actions.pod:903 ../src/guestfs-actions.pod:5637 +msgid "The optional parameters are:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:916 -msgid "e2fsck-f" -msgstr "e2fsck-f" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:918 -#, no-wrap -msgid "" -" e2fsck-f device\n" -"\n" -msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:615 ../fish/guestfish-actions.pod:3610 +#: ../src/guestfs-actions.pod:907 ../src/guestfs-actions.pod:5641 +msgid "C" +msgstr "C<розмір>" #. type: textblock -#: ../fish/guestfish-actions.pod:920 ../src/guestfs-actions.pod:1400 +#: ../fish/guestfish-actions.pod:617 ../src/guestfs-actions.pod:909 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>)." +"The new size (in bytes) of the filesystem. If omitted, the filesystem is " +"resized to the maximum size." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:924 -msgid "" -"This command is only needed because of L (q.v.). Normally you " -"should use L." -msgstr "" +#: ../fish/guestfish-actions.pod:622 ../src/guestfs-actions.pod:914 +msgid "See also L." +msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:927 -msgid "echo-daemon" +#: ../fish/guestfish-actions.pod:626 +msgid "case-sensitive-path" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:929 +#: ../fish/guestfish-actions.pod:628 #, no-wrap msgid "" -" echo-daemon 'words ...'\n" +" case-sensitive-path path\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:931 ../src/guestfs-actions.pod:1417 +#: ../fish/guestfish-actions.pod:630 ../src/guestfs-actions.pod:948 msgid "" -"This command concatenates the list of C passed with single spaces " -"between them and returns the resulting string." +"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:934 ../src/guestfs-actions.pod:1420 -msgid "You can use this command to test the connection through to the daemon." -msgstr "" +#: ../fish/guestfish-actions.pod:635 ../src/guestfs-actions.pod:953 +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." +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:936 -msgid "See also L." +#: ../fish/guestfish-actions.pod:640 ../src/guestfs-actions.pod:958 +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." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:938 -msgid "egrep" -msgstr "egrep" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:940 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:646 ../src/guestfs-actions.pod:964 msgid "" -" egrep regex path\n" -"\n" +"Bug or feature? You decide: L" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:942 ../src/guestfs-actions.pod:1436 +#: ../fish/guestfish-actions.pod:649 ../src/guestfs-actions.pod:967 msgid "" -"This calls the external C program and returns the matching lines." +"This function resolves the true case of each element in the path and returns " +"the case-sensitive path." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:948 -msgid "egrepi" -msgstr "egrepi" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:950 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:652 msgid "" -" egrepi regex path\n" -"\n" +"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)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:952 ../src/guestfs-actions.pod:1455 -msgid "" -"This calls the external C program and returns the matching lines." +#: ../fish/guestfish-actions.pod:657 ../src/guestfs-actions.pod:975 +msgid "I: This function does not handle drive names, backslashes etc." msgstr "" +#. type: textblock +#: ../fish/guestfish-actions.pod:660 +msgid "See also L." +msgstr "Див. також L." + #. type: =head2 -#: ../fish/guestfish-actions.pod:958 -msgid "equal" -msgstr "equal" +#: ../fish/guestfish-actions.pod:662 +msgid "cat" +msgstr "cat" #. type: verbatim -#: ../fish/guestfish-actions.pod:960 +#: ../fish/guestfish-actions.pod:664 #, no-wrap msgid "" -" equal file1 file2\n" +" cat path\n" "\n" msgstr "" -" equal файл1 файл2\n" +" cat шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:962 ../src/guestfs-actions.pod:1474 +#: ../fish/guestfish-actions.pod:666 ../fish/guestfish-actions.pod:4037 +#: ../src/guestfs-actions.pod:991 ../src/guestfs-actions.pod:6297 +msgid "Return the contents of the file named C." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:668 msgid "" -"This compares the two files C and C and returns true if their " -"content is exactly equal, or false otherwise." +"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." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:965 ../src/guestfs-actions.pod:1477 -msgid "The external L program is used for the comparison." +#: ../fish/guestfish-actions.pod:673 ../fish/guestfish-actions.pod:808 +#: ../fish/guestfish-actions.pod:820 ../fish/guestfish-actions.pod:1103 +#: ../fish/guestfish-actions.pod:1113 ../fish/guestfish-actions.pod:1180 +#: ../fish/guestfish-actions.pod:1190 ../fish/guestfish-actions.pod:1382 +#: ../fish/guestfish-actions.pod:1695 ../fish/guestfish-actions.pod:1705 +#: ../fish/guestfish-actions.pod:1755 ../fish/guestfish-actions.pod:1770 +#: ../fish/guestfish-actions.pod:1780 ../fish/guestfish-actions.pod:1799 +#: ../fish/guestfish-actions.pod:3907 ../fish/guestfish-actions.pod:3922 +#: ../fish/guestfish-actions.pod:3998 ../fish/guestfish-actions.pod:4015 +#: ../fish/guestfish-actions.pod:4030 ../fish/guestfish-actions.pod:4699 +#: ../fish/guestfish-actions.pod:4745 ../fish/guestfish-actions.pod:4830 +#: ../fish/guestfish-actions.pod:4845 ../fish/guestfish-actions.pod:5251 +#: ../fish/guestfish-actions.pod:5263 ../fish/guestfish-actions.pod:5281 +#: ../fish/guestfish-actions.pod:5298 ../fish/guestfish-actions.pod:5308 +#: ../fish/guestfish-actions.pod:5362 ../fish/guestfish-actions.pod:5372 +#: ../fish/guestfish-actions.pod:5401 ../fish/guestfish-actions.pod:5411 +#: ../src/guestfs-actions.pod:1001 ../src/guestfs-actions.pod:1180 +#: ../src/guestfs-actions.pod:1200 ../src/guestfs-actions.pod:1855 +#: ../src/guestfs-actions.pod:1874 ../src/guestfs-actions.pod:1977 +#: ../src/guestfs-actions.pod:1996 ../src/guestfs-actions.pod:2242 +#: ../src/guestfs-actions.pod:2724 ../src/guestfs-actions.pod:2743 +#: ../src/guestfs-actions.pod:2808 ../src/guestfs-actions.pod:2832 +#: ../src/guestfs-actions.pod:2849 ../src/guestfs-actions.pod:2878 +#: ../src/guestfs-actions.pod:6079 ../src/guestfs-actions.pod:6105 +#: ../src/guestfs-actions.pod:6236 ../src/guestfs-actions.pod:6262 +#: ../src/guestfs-actions.pod:6286 ../src/guestfs-actions.pod:7241 +#: ../src/guestfs-actions.pod:7296 ../src/guestfs-actions.pod:7442 +#: ../src/guestfs-actions.pod:7466 ../src/guestfs-actions.pod:8131 +#: ../src/guestfs-actions.pod:8151 ../src/guestfs-actions.pod:8184 +#: ../src/guestfs-actions.pod:8203 ../src/guestfs-actions.pod:8222 +#: ../src/guestfs-actions.pod:8313 ../src/guestfs-actions.pod:8332 +#: ../src/guestfs-actions.pod:8378 ../src/guestfs-actions.pod:8397 +msgid "" +"Because of the message protocol, there is a transfer limit of somewhere " +"between 2MB and 4MB. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:967 -msgid "exists" -msgstr "exists" +#: ../fish/guestfish-actions.pod:676 +msgid "checksum" +msgstr "checksum" #. type: verbatim -#: ../fish/guestfish-actions.pod:969 +#: ../fish/guestfish-actions.pod:678 #, no-wrap msgid "" -" exists path\n" +" checksum csumtype path\n" "\n" msgstr "" -" exists шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:971 ../src/guestfs-actions.pod:1489 +#: ../fish/guestfish-actions.pod:680 ../src/guestfs-actions.pod:1013 msgid "" -"This returns C if and only if there is a file, directory (or anything) " -"with the given C name." +"This call computes the MD5, SHAx or CRC checksum of the file named C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:974 -msgid "See also L, L, L." -msgstr "Див. також L, L, L." +#: ../fish/guestfish-actions.pod:683 ../src/guestfs-actions.pod:1016 +msgid "" +"The type of checksum to compute is given by the C parameter which " +"must have one of the following values:" +msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:976 -msgid "fallocate" -msgstr "fallocate" +#. type: =item +#: ../fish/guestfish-actions.pod:688 ../src/guestfs-actions.pod:1021 +msgid "C" +msgstr "C" -#. type: verbatim -#: ../fish/guestfish-actions.pod:978 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:690 ../src/guestfs-actions.pod:1023 msgid "" -" fallocate path len\n" -"\n" +"Compute the cyclic redundancy check (CRC) specified by POSIX for the " +"C command." msgstr "" -" fallocate шлях довжина\n" -"\n" + +#. type: =item +#: ../fish/guestfish-actions.pod:693 ../src/guestfs-actions.pod:1026 +msgid "C" +msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:980 ../fish/guestfish-actions.pod:999 -#: ../src/guestfs-actions.pod:1512 ../src/guestfs-actions.pod:1531 -msgid "" -"This command preallocates a file (containing zero bytes) named C of " -"size C bytes. If the file exists already, it is overwritten." +#: ../fish/guestfish-actions.pod:695 ../src/guestfs-actions.pod:1028 +msgid "Compute the MD5 hash (using the C program)." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:697 ../src/guestfs-actions.pod:1030 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:984 ../src/guestfs-actions.pod:1516 -msgid "" -"Do not confuse this with the guestfish-specific C command which " -"allocates a file in the host and attaches it as a device." +#: ../fish/guestfish-actions.pod:699 ../src/guestfs-actions.pod:1032 +msgid "Compute the SHA1 hash (using the C program)." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:701 ../src/guestfs-actions.pod:1034 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:988 -msgid "" -"I In new code, use the L call " -"instead." +#: ../fish/guestfish-actions.pod:703 ../src/guestfs-actions.pod:1036 +msgid "Compute the SHA224 hash (using the C program)." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:995 -msgid "fallocate64" -msgstr "fallocate64" +#. type: =item +#: ../fish/guestfish-actions.pod:705 ../src/guestfs-actions.pod:1038 +msgid "C" +msgstr "C" -#. type: verbatim -#: ../fish/guestfish-actions.pod:997 -#, no-wrap -msgid "" -" fallocate64 path len\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1040 +msgid "Compute the SHA256 hash (using the C program)." msgstr "" -" fallocate64 шлях довжина\n" -"\n" + +#. type: =item +#: ../fish/guestfish-actions.pod:709 ../src/guestfs-actions.pod:1042 +msgid "C" +msgstr "C" #. type: textblock -#: ../fish/guestfish-actions.pod:1003 -msgid "" -"Note that this call allocates disk blocks for the file. To create a sparse " -"file use L instead." +#: ../fish/guestfish-actions.pod:711 ../src/guestfs-actions.pod:1044 +msgid "Compute the SHA384 hash (using the C program)." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:713 ../src/guestfs-actions.pod:1046 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:1006 -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." +#: ../fish/guestfish-actions.pod:715 ../src/guestfs-actions.pod:1048 +msgid "Compute the SHA512 hash (using the C program)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1011 ../src/guestfs-actions.pod:1543 -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." +#: ../fish/guestfish-actions.pod:719 ../src/guestfs-actions.pod:1052 +msgid "The checksum is returned as a printable string." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:721 +msgid "To get the checksum for a device, use L." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:723 +msgid "To get the checksums for many files, use L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1015 -msgid "fgrep" -msgstr "fgrep" +#: ../fish/guestfish-actions.pod:725 +msgid "checksum-device" +msgstr "checksum-device" #. type: verbatim -#: ../fish/guestfish-actions.pod:1017 +#: ../fish/guestfish-actions.pod:727 #, no-wrap msgid "" -" fgrep pattern path\n" +" checksum-device csumtype device\n" "\n" msgstr "" -" fgrep шаблон шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1019 ../src/guestfs-actions.pod:1558 +#: ../fish/guestfish-actions.pod:729 msgid "" -"This calls the external C program and returns the matching lines." +"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." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1025 -msgid "fgrepi" -msgstr "fgrepi" +#: ../fish/guestfish-actions.pod:733 +msgid "checksums-out" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1027 +#: ../fish/guestfish-actions.pod:735 #, no-wrap msgid "" -" fgrepi pattern path\n" +" checksums-out csumtype directory (sumsfile|-)\n" "\n" msgstr "" -" fgrepi шаблон шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1029 ../src/guestfs-actions.pod:1577 +#: ../fish/guestfish-actions.pod:737 ../src/guestfs-actions.pod:1087 msgid "" -"This calls the external C program and returns the matching lines." +"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." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:741 ../src/guestfs-actions.pod:1091 +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." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1035 -msgid "file" -msgstr "file" +#: ../fish/guestfish-actions.pod:751 +msgid "chmod" +msgstr "chmod" #. type: verbatim -#: ../fish/guestfish-actions.pod:1037 +#: ../fish/guestfish-actions.pod:753 #, no-wrap msgid "" -" file path\n" +" chmod mode path\n" "\n" msgstr "" -" file шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1039 ../src/guestfs-actions.pod:1595 +#: ../fish/guestfish-actions.pod:755 ../src/guestfs-actions.pod:1110 msgid "" -"This call uses the standard L command to determine the type or " -"contents of the file." +"Change the mode (permissions) of C to C. Only numeric modes are " +"supported." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1042 ../src/guestfs-actions.pod:1598 +#: ../fish/guestfish-actions.pod:758 ../src/guestfs-actions.pod:1113 msgid "" -"This call will also transparently look inside various types of compressed " -"file." +"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>." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1045 ../src/guestfs-actions.pod:1601 +#: ../fish/guestfish-actions.pod:762 ../fish/guestfish-actions.pod:3259 +#: ../fish/guestfish-actions.pod:3398 ../fish/guestfish-actions.pod:3408 +#: ../fish/guestfish-actions.pod:3418 ../src/guestfs-actions.pod:1117 +#: ../src/guestfs-actions.pod:5044 ../src/guestfs-actions.pod:5253 +#: ../src/guestfs-actions.pod:5272 ../src/guestfs-actions.pod:5291 +msgid "The mode actually set is affected by the umask." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:764 +msgid "chown" +msgstr "chown" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:766 +#, no-wrap msgid "" -"The exact command which runs is C. Note in particular that " -"the filename is not prepended to the output (the I<-b> option)." +" chown owner group path\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1049 ../src/guestfs-actions.pod:1605 -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." +#: ../fish/guestfish-actions.pod:768 ../src/guestfs-actions.pod:1131 +msgid "Change the file owner to C and group to C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1053 +#: ../fish/guestfish-actions.pod:770 ../fish/guestfish-actions.pod:2703 +#: ../src/guestfs-actions.pod:1133 ../src/guestfs-actions.pod:4124 msgid "" -"See also: L, L, L, L, L " -"(etc), L." +"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)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1056 -msgid "file-architecture" -msgstr "file-architecture" +#: ../fish/guestfish-actions.pod:774 +msgid "command" +msgstr "command" #. type: verbatim -#: ../fish/guestfish-actions.pod:1058 +#: ../fish/guestfish-actions.pod:776 #, no-wrap msgid "" -" file-architecture filename\n" +" command 'arguments ...'\n" "\n" msgstr "" -" file-architecture назва_файла\n" +" command 'параметри...'\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1060 ../src/guestfs-actions.pod:1623 +#: ../fish/guestfish-actions.pod:778 ../src/guestfs-actions.pod:1147 msgid "" -"This detects the architecture of the binary C, and returns it if " -"known." +"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)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1063 ../src/guestfs-actions.pod:1626 -msgid "Currently defined architectures are:" +#: ../fish/guestfish-actions.pod:783 +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)." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1067 ../src/guestfs-actions.pod:1630 -msgid "\"i386\"" -msgstr "\"i386\"" +#. type: textblock +#: ../fish/guestfish-actions.pod:790 ../src/guestfs-actions.pod:1159 +msgid "The return value is anything printed to I by the command." +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1069 ../src/guestfs-actions.pod:1632 +#: ../fish/guestfish-actions.pod:793 ../src/guestfs-actions.pod:1162 msgid "" -"This string is returned for all 32 bit i386, i486, i586, i686 binaries " -"irrespective of the precise processor requirements of the binary." +"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." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1072 ../src/guestfs-actions.pod:1635 -msgid "\"x86_64\"" -msgstr "\"x86_64\"" - #. type: textblock -#: ../fish/guestfish-actions.pod:1074 ../src/guestfs-actions.pod:1637 -msgid "64 bit x86-64." +#: ../fish/guestfish-actions.pod:797 ../src/guestfs-actions.pod:1166 +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." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1076 ../src/guestfs-actions.pod:1639 -msgid "\"sparc\"" +#. type: textblock +#: ../fish/guestfish-actions.pod:802 ../src/guestfs-actions.pod:1171 +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." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1641 -msgid "32 bit SPARC." +#. type: =head2 +#: ../fish/guestfish-actions.pod:811 +msgid "command-lines" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1080 ../src/guestfs-actions.pod:1643 -msgid "\"sparc64\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:813 +#, no-wrap +msgid "" +" command-lines 'arguments ...'\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1082 ../src/guestfs-actions.pod:1645 -msgid "64 bit SPARC V9 and above." +#: ../fish/guestfish-actions.pod:815 +msgid "" +"This is the same as L, but splits the result into a list of lines." 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." +#: ../fish/guestfish-actions.pod:818 +msgid "See also: L" +msgstr "Див. також L" -#. type: =item -#: ../fish/guestfish-actions.pod:1088 ../src/guestfs-actions.pod:1651 -msgid "\"ppc\"" +#. type: =head2 +#: ../fish/guestfish-actions.pod:823 +msgid "compress-device-out" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1090 ../src/guestfs-actions.pod:1653 -msgid "32 bit Power PC." +#. type: verbatim +#: ../fish/guestfish-actions.pod:825 +#, no-wrap +msgid "" +" compress-device-out ctype device (zdevice|-) [level:..]\n" +"\n" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1092 ../src/guestfs-actions.pod:1655 -msgid "\"ppc64\"" +#. type: textblock +#: ../fish/guestfish-actions.pod:827 ../src/guestfs-actions.pod:1221 +msgid "" +"This command compresses C and writes it out to the local file " +"C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1094 ../src/guestfs-actions.pod:1657 -msgid "64 bit Power PC." +#: ../fish/guestfish-actions.pod:830 +msgid "" +"The C and optional C parameters have the same meaning as in L." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1098 ../src/guestfs-actions.pod:1661 -msgid "Libguestfs may return other architecture strings in future." +#. type: =head2 +#: ../fish/guestfish-actions.pod:837 +msgid "compress-out" 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:" +#. type: verbatim +#: ../fish/guestfish-actions.pod:839 +#, no-wrap +msgid "" +" compress-out ctype file (zfile|-) [level:..]\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1106 ../src/guestfs-actions.pod:1669 -msgid "many types of Un*x and Linux binary" +#: ../fish/guestfish-actions.pod:841 ../src/guestfs-actions.pod:1273 +msgid "" +"This command compresses C and writes it out to the local file C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1673 -msgid "many types of Un*x and Linux shared library" +#: ../fish/guestfish-actions.pod:844 ../src/guestfs-actions.pod:1276 +msgid "" +"The compression program used is controlled by the C parameter. " +"Currently this includes: C, C, C, C or C. " +"Some compression types may not be supported by particular builds of " +"libguestfs, in which case you will get an error containing the substring " +"\"not supported\"." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1114 ../src/guestfs-actions.pod:1677 -msgid "Windows Win32 and Win64 binaries" +#: ../fish/guestfish-actions.pod:850 ../src/guestfs-actions.pod:1282 +msgid "" +"The optional C parameter controls compression level. The meaning and " +"default for this parameter depends on the compression program being used." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1118 ../src/guestfs-actions.pod:1681 -msgid "Windows Win32 and Win64 DLLs" +#. type: =head2 +#: ../fish/guestfish-actions.pod:858 +msgid "config" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1683 -msgid "Win32 binaries and DLLs return C." +#. type: verbatim +#: ../fish/guestfish-actions.pod:860 +#, no-wrap +msgid "" +" config qemuparam qemuvalue\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1122 ../src/guestfs-actions.pod:1685 -msgid "Win64 binaries and DLLs return C." +#: ../fish/guestfish-actions.pod:862 ../src/guestfs-actions.pod:1323 +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." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1126 ../src/guestfs-actions.pod:1689 -msgid "Linux kernel modules" +#: ../fish/guestfish-actions.pod:867 ../src/guestfs-actions.pod:1328 +msgid "The first character of C string must be a C<-> (dash)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1130 ../src/guestfs-actions.pod:1693 -msgid "Linux new-style initrd images" +#: ../fish/guestfish-actions.pod:869 ../src/guestfs-actions.pod:1330 +msgid "C can be NULL." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1134 ../src/guestfs-actions.pod:1697 -msgid "some non-x86 Linux vmlinuz kernels" +#. type: =head2 +#: ../fish/guestfish-actions.pod:871 +msgid "copy-device-to-device" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1138 ../src/guestfs-actions.pod:1701 -msgid "What it can't do currently:" +#. type: verbatim +#: ../fish/guestfish-actions.pod:873 +#, no-wrap +msgid "" +" copy-device-to-device src dest [srcoffset:..] [destoffset:..] [size:..]\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1144 ../src/guestfs-actions.pod:1707 -msgid "static libraries (libfoo.a)" +#: ../fish/guestfish-actions.pod:875 +msgid "" +"The four calls L, L, L, and L let you copy from a source " +"(device|file) to a destination (device|file)." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1148 ../src/guestfs-actions.pod:1711 -msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)" +#: ../fish/guestfish-actions.pod:882 ../src/guestfs-actions.pod:1360 +msgid "" +"Partial copies can be made since you can specify optionally the source " +"offset, destination offset and size to copy. These values are all specified " +"in bytes. If not given, the offsets both default to zero, and the size " +"defaults to copying as much as possible until we hit the end of the source." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1152 ../src/guestfs-actions.pod:1715 -msgid "x86 Linux vmlinuz kernels" +#: ../fish/guestfish-actions.pod:888 ../src/guestfs-actions.pod:1366 +msgid "" +"The source and destination may be the same object. However overlapping " +"regions may not be copied correctly." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1154 ../src/guestfs-actions.pod:1717 +#: ../fish/guestfish-actions.pod:891 ../src/guestfs-actions.pod:1369 msgid "" -"x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and " -"compressed code, and are horribly hard to unpack. If you want to find the " -"architecture of a kernel, use the architecture of the associated initrd or " -"kernel module(s) instead." +"If the destination is a file, it is created if required. If the destination " +"file is not large enough, it is extended." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1161 -msgid "filesize" -msgstr "filesize" +#: ../fish/guestfish-actions.pod:896 +msgid "copy-device-to-file" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1163 +#: ../fish/guestfish-actions.pod:898 #, no-wrap msgid "" -" filesize file\n" -"\n" -msgstr "" -" filesize файл\n" +" copy-device-to-file src dest [srcoffset:..] [destoffset:..] [size:..]\n" "\n" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1165 ../src/guestfs-actions.pod:1735 -msgid "This command returns the size of C in bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1167 -msgid "" -"To get other stats about a file, use L, L, L, L etc. To get the size of block devices, use L." +#: ../fish/guestfish-actions.pod:900 ../fish/guestfish-actions.pod:909 +#: ../fish/guestfish-actions.pod:918 +msgid "See L for a general overview of this call." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1171 -msgid "fill" -msgstr "fill" +#: ../fish/guestfish-actions.pod:905 +msgid "copy-file-to-device" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1173 +#: ../fish/guestfish-actions.pod:907 #, no-wrap msgid "" -" fill c len path\n" +" copy-file-to-device src dest [srcoffset:..] [destoffset:..] [size:..]\n" "\n" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1175 ../src/guestfs-actions.pod:1753 +#. type: =head2 +#: ../fish/guestfish-actions.pod:914 +msgid "copy-file-to-file" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:916 +#, no-wrap msgid "" -"This command creates a new file called C. The initial content of the " -"file is C octets of C, where C must be a number in the range C<" -"[0..255]>." +" copy-file-to-file src dest [srcoffset:..] [destoffset:..] [size:..]\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1179 +#: ../fish/guestfish-actions.pod:921 msgid "" -"To fill a file with zero bytes (sparsely), it is much more efficient to use " -"L. To create a file with a pattern of repeating bytes use " -"L." +"This is B the function you want for copying files. This is for copying " +"blocks within existing files. See L, L and L for general " +"file copying and moving functions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1184 -msgid "fill-pattern" -msgstr "fill-pattern" +#: ../fish/guestfish-actions.pod:928 +msgid "copy-size" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1186 +#: ../fish/guestfish-actions.pod:930 #, no-wrap msgid "" -" fill-pattern pattern len path\n" +" copy-size src dest size\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1188 +#: ../fish/guestfish-actions.pod:932 ../src/guestfs-actions.pod:1584 msgid "" -"This function is like L except that it creates a new file of length " -"C containing the repeating pattern of bytes in C. The pattern " -"is truncated if necessary to ensure the length of the file is exactly C " -"bytes." +"This command copies exactly C bytes from one source device or file " +"C to another destination device or file C." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:935 ../src/guestfs-actions.pod:1587 +msgid "" +"Note this will fail if the source is too short or if the destination is not " +"large enough." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:973 +msgid "" +"I In new code, use the L call instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1193 -msgid "find" -msgstr "find" +#: ../fish/guestfish-actions.pod:945 +msgid "cp" +msgstr "cp" #. type: verbatim -#: ../fish/guestfish-actions.pod:1195 +#: ../fish/guestfish-actions.pod:947 #, no-wrap msgid "" -" find directory\n" +" cp src dest\n" "\n" msgstr "" -" find каталог\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:1799 +#: ../fish/guestfish-actions.pod:949 ../src/guestfs-actions.pod:1606 msgid "" -"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." +"This copies a file from C to C where C is either a " +"destination filename or destination directory." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1202 ../src/guestfs-actions.pod:1804 -msgid "" -"This returns a list of strings I. Thus if the directory " -"structure was:" -msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:952 +msgid "cp-a" +msgstr "cp-a" #. type: verbatim -#: ../fish/guestfish-actions.pod:1205 ../src/guestfs-actions.pod:1807 +#: ../fish/guestfish-actions.pod:954 #, no-wrap msgid "" -" /tmp/a\n" -" /tmp/b\n" -" /tmp/c/d\n" +" cp-a src dest\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1209 -msgid "then the returned list from L C would be 4 elements:" +#: ../fish/guestfish-actions.pod:956 ../src/guestfs-actions.pod:1620 +msgid "" +"This copies a file or directory from C to C recursively using the " +"C command." msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:959 +msgid "dd" +msgstr "dd" + #. type: verbatim -#: ../fish/guestfish-actions.pod:1212 ../src/guestfs-actions.pod:1814 +#: ../fish/guestfish-actions.pod:961 #, no-wrap msgid "" -" a\n" -" b\n" -" c\n" -" c/d\n" +" dd src dest\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1217 ../src/guestfs-actions.pod:1819 -msgid "If C is not a directory, then this command returns an error." +#: ../fish/guestfish-actions.pod:963 ../src/guestfs-actions.pod:1641 +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." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1220 ../src/guestfs-actions.pod:1822 -msgid "The returned list is sorted." +#: ../fish/guestfish-actions.pod:968 +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)." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1222 -msgid "See also L." -msgstr "Див. також L." - #. type: =head2 -#: ../fish/guestfish-actions.pod:1227 -msgid "find0" -msgstr "find0" +#: ../fish/guestfish-actions.pod:980 +msgid "df" +msgstr "df" #. type: verbatim -#: ../fish/guestfish-actions.pod:1229 +#: ../fish/guestfish-actions.pod:982 #, no-wrap msgid "" -" find0 directory (files|-)\n" +" df\n" "\n" msgstr "" -" find0 каталог (файли|-)\n" +" df\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1231 ../src/guestfs-actions.pod:1842 -msgid "" -"This command lists out all files and directories, recursively, starting at " -"C, placing the resulting list in the external file called " -"C." +#: ../fish/guestfish-actions.pod:984 ../src/guestfs-actions.pod:1660 +msgid "This command runs the C command to report disk space used." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1235 +#: ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:997 msgid "" -"This command works the same way as L with the following exceptions:" -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:1853 -msgid "The resulting list is written to an external file." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:1857 -msgid "" -"Items (filenames) in the result are separated by C<\\0> characters. See " -"L option I<-print0>." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1251 ../src/guestfs-actions.pod:1862 -msgid "This command is not limited in the number of names that it can return." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:1867 -msgid "The result list is not sorted." +"This command is mostly useful for interactive sessions. It is I " +"intended that you try to parse the output string. Use L from " +"programs." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1262 -msgid "findfs-label" -msgstr "findfs-label" +#: ../fish/guestfish-actions.pod:990 +msgid "df-h" +msgstr "df-h" #. type: verbatim -#: ../fish/guestfish-actions.pod:1264 +#: ../fish/guestfish-actions.pod:992 #, no-wrap msgid "" -" findfs-label label\n" +" df-h\n" "\n" msgstr "" -" findfs-label мітка\n" +" df-h\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1266 ../src/guestfs-actions.pod:1881 +#: ../fish/guestfish-actions.pod:994 ../src/guestfs-actions.pod:1676 msgid "" -"This command searches the filesystems and returns the one which has the " -"given label. An error is returned if no such filesystem can be found." +"This command runs the C command to report disk space used in human-" +"readable format." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1270 -msgid "To find the label of a filesystem, use L." -msgstr "Для визначення мітки файлової системи скористайтеся L." - #. type: =head2 -#: ../fish/guestfish-actions.pod:1272 -msgid "findfs-uuid" -msgstr "findfs-uuid" +#: ../fish/guestfish-actions.pod:1001 +msgid "dmesg" +msgstr "dmesg" #. type: verbatim -#: ../fish/guestfish-actions.pod:1274 +#: ../fish/guestfish-actions.pod:1003 #, no-wrap msgid "" -" findfs-uuid uuid\n" +" dmesg\n" "\n" msgstr "" -" findfs-uuid uuid\n" +" dmesg\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1276 ../src/guestfs-actions.pod:1898 +#: ../fish/guestfish-actions.pod:1005 ../src/guestfs-actions.pod:1693 msgid "" -"This command searches the filesystems and returns the one which has the " -"given UUID. An error is returned if no such filesystem can be found." +"This returns the kernel messages (C output) from the guest kernel. " +"This is sometimes useful for extended debugging of problems." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1280 -msgid "To find the UUID of a filesystem, use L." -msgstr "Для визначення UUID файлової системи скористайтеся L." +#: ../fish/guestfish-actions.pod:1009 +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." +msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1282 -msgid "fsck" -msgstr "fsck" +#: ../fish/guestfish-actions.pod:1014 +msgid "download" +msgstr "download" #. type: verbatim -#: ../fish/guestfish-actions.pod:1284 +#: ../fish/guestfish-actions.pod:1016 #, no-wrap msgid "" -" fsck fstype device\n" -"\n" -msgstr "" -" fsck тип_файлової_системи пристрій\n" +" download remotefilename (filename|-)\n" "\n" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1286 ../src/guestfs-actions.pod:1916 -msgid "" -"This runs the filesystem checker (fsck) on C which should have " -"filesystem type C." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1289 ../src/guestfs-actions.pod:1919 -msgid "" -"The returned integer is the status. See L for the list of status " -"codes from C." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1298 ../src/guestfs-actions.pod:1928 -msgid "Multiple status codes can be summed together." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1302 ../src/guestfs-actions.pod:1932 +#: ../fish/guestfish-actions.pod:1018 ../fish/guestfish-actions.pod:1031 +#: ../src/guestfs-actions.pod:1714 ../src/guestfs-actions.pod:1739 msgid "" -"A non-zero return code can mean \"success\", for example if errors have been " -"corrected on the filesystem." +"Download file C and save it as C on the local " +"machine." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1307 ../src/guestfs-actions.pod:1937 -msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." +#: ../fish/guestfish-actions.pod:1021 ../fish/guestfish-actions.pod:5003 +#: ../src/guestfs-actions.pod:1717 ../src/guestfs-actions.pod:7701 +msgid "C can also be a named pipe." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1312 ../src/guestfs-actions.pod:1942 -msgid "" -"This command is entirely equivalent to running C." +#: ../fish/guestfish-actions.pod:1023 +msgid "See also L, L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1314 -msgid "get-append" -msgstr "get-append" +#: ../fish/guestfish-actions.pod:1027 +msgid "download-offset" +msgstr "download-offset" #. type: verbatim -#: ../fish/guestfish-actions.pod:1316 +#: ../fish/guestfish-actions.pod:1029 #, no-wrap msgid "" -" get-append\n" +" download-offset remotefilename (filename|-) offset size\n" "\n" msgstr "" -" get-append\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1318 ../src/guestfs-actions.pod:1953 +#: ../fish/guestfish-actions.pod:1034 ../src/guestfs-actions.pod:1742 msgid "" -"Return the additional kernel options which are added to the guest kernel " -"command line." +"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:1321 ../src/guestfs-actions.pod:1956 -msgid "If C then no options are added." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:1323 -msgid "get-attach-method" -msgstr "get-attach-method" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:1325 -#, no-wrap +#: ../fish/guestfish-actions.pod:1037 msgid "" -" get-attach-method\n" -"\n" +"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 "" -" get-attach-method\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1327 -msgid "Return the current attach method. See L." +#: ../fish/guestfish-actions.pod:1042 +msgid "See also L, L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1329 -msgid "get-autosync" -msgstr "get-autosync" +#: ../fish/guestfish-actions.pod:1046 +msgid "drop-caches" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1331 +#: ../fish/guestfish-actions.pod:1048 #, no-wrap msgid "" -" get-autosync\n" +" drop-caches whattodrop\n" "\n" msgstr "" -" get-autosync\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:1981 -msgid "Get the autosync flag." +#: ../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: =head2 -#: ../fish/guestfish-actions.pod:1335 -msgid "get-direct" -msgstr "get-direct" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:1337 -#, no-wrap -msgid "" -" get-direct\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1055 ../src/guestfs-actions.pod:1772 +msgid "Setting C to 3 should drop everything." msgstr "" -" get-direct\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1339 ../src/guestfs-actions.pod:1992 -msgid "Return the direct appliance mode flag." +#: ../fish/guestfish-actions.pod:1057 ../src/guestfs-actions.pod:1774 +msgid "" +"This automatically calls L before the operation, so that the " +"maximum guest memory is freed." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1341 -msgid "get-e2label" -msgstr "get-e2label" +#: ../fish/guestfish-actions.pod:1060 +msgid "du" +msgstr "du" #. type: verbatim -#: ../fish/guestfish-actions.pod:1343 +#: ../fish/guestfish-actions.pod:1062 #, no-wrap msgid "" -" get-e2label device\n" +" du path\n" "\n" msgstr "" -" get-e2label пристрій\n" +" du шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1345 ../src/guestfs-actions.pod:2011 +#: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1787 msgid "" -"This returns the ext2/3/4 filesystem label of the filesystem on C." +"This command runs the C command to estimate file space usage for " +"C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1348 +#: ../fish/guestfish-actions.pod:1067 ../src/guestfs-actions.pod:1790 msgid "" -"I In new code, use the L call " -"instead." +"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:1071 ../src/guestfs-actions.pod:1794 +msgid "" +"The result is the estimated size in I (ie. units of 1024 bytes)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1355 -msgid "get-e2uuid" -msgstr "get-e2uuid" +#: ../fish/guestfish-actions.pod:1074 +msgid "e2fsck-f" +msgstr "e2fsck-f" #. type: verbatim -#: ../fish/guestfish-actions.pod:1357 +#: ../fish/guestfish-actions.pod:1076 #, no-wrap msgid "" -" get-e2uuid device\n" +" e2fsck-f device\n" "\n" msgstr "" -" get-e2uuid пристрій\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1359 ../src/guestfs-actions.pod:2032 +#: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1812 msgid "" -"This returns the ext2/3/4 filesystem UUID of the filesystem on C." +"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: textblock -#: ../fish/guestfish-actions.pod:1362 +#: ../fish/guestfish-actions.pod:1082 msgid "" -"I In new code, use the L call " -"instead." +"This command is only needed because of L (q.v.). Normally you " +"should use L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1369 -msgid "get-memsize" -msgstr "get-memsize" +#: ../fish/guestfish-actions.pod:1085 +msgid "echo-daemon" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1371 +#: ../fish/guestfish-actions.pod:1087 #, no-wrap msgid "" -" get-memsize\n" +" echo-daemon 'words ...'\n" "\n" msgstr "" -" get-memsize\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1373 ../src/guestfs-actions.pod:2045 +#: ../fish/guestfish-actions.pod:1089 ../src/guestfs-actions.pod:1829 msgid "" -"This gets the memory size in megabytes allocated to the qemu subprocess." +"This command concatenates the list of C passed with single spaces " +"between them and returns the resulting string." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1376 -msgid "" -"If L was not called on this handle, and if " -"C was not set, then this returns the compiled-in default " -"value for memsize." +#: ../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:1380 ../fish/guestfish-actions.pod:1437 -#: ../fish/guestfish-actions.pod:4168 ../fish/guestfish-actions.pod:4270 -#: ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2144 -#: ../src/guestfs-actions.pod:6298 ../src/guestfs-actions.pod:6424 -msgid "" -"For more information on the architecture of libguestfs, see L." -msgstr "" +#: ../fish/guestfish-actions.pod:1094 +msgid "See also L." +msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1383 -msgid "get-network" -msgstr "get-network" +#: ../fish/guestfish-actions.pod:1096 +msgid "egrep" +msgstr "egrep" #. type: verbatim -#: ../fish/guestfish-actions.pod:1385 +#: ../fish/guestfish-actions.pod:1098 #, no-wrap msgid "" -" get-network\n" +" egrep regex path\n" "\n" msgstr "" -" get-network\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1387 ../src/guestfs-actions.pod:2064 -msgid "This returns the enable network flag." +#: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1848 +msgid "" +"This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1389 -msgid "get-path" -msgstr "get-path" +#: ../fish/guestfish-actions.pod:1106 +msgid "egrepi" +msgstr "egrepi" #. type: verbatim -#: ../fish/guestfish-actions.pod:1391 +#: ../fish/guestfish-actions.pod:1108 #, no-wrap msgid "" -" get-path\n" -"\n" -msgstr "" -" get-path\n" +" egrepi regex path\n" "\n" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1393 ../src/guestfs-actions.pod:2075 -msgid "Return the current search path." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1395 ../src/guestfs-actions.pod:2077 +#: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1867 msgid "" -"This is always non-NULL. If it wasn't set already, then this will return " -"the default path." +"This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1398 -msgid "get-pgroup" -msgstr "" +#: ../fish/guestfish-actions.pod:1116 +msgid "equal" +msgstr "equal" #. type: verbatim -#: ../fish/guestfish-actions.pod:1400 +#: ../fish/guestfish-actions.pod:1118 #, no-wrap msgid "" -" get-pgroup\n" +" equal file1 file2\n" "\n" msgstr "" +" equal файл1 файл2\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1402 ../src/guestfs-actions.pod:2090 -msgid "This returns the process group flag." +#: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1886 +msgid "" +"This compares the two files C and C and returns true if their " +"content is exactly equal, or false otherwise." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1404 -msgid "get-pid" -msgstr "get-pid" +#. type: textblock +#: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1889 +msgid "The external L program is used for the comparison." +msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1406 -msgid "pid" -msgstr "" +#: ../fish/guestfish-actions.pod:1125 +msgid "exists" +msgstr "exists" #. type: verbatim -#: ../fish/guestfish-actions.pod:1408 +#: ../fish/guestfish-actions.pod:1127 #, no-wrap msgid "" -" get-pid\n" +" exists path\n" "\n" msgstr "" -" get-pid\n" +" exists шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1410 ../src/guestfs-actions.pod:2101 +#: ../fish/guestfish-actions.pod:1129 ../src/guestfs-actions.pod:1901 msgid "" -"Return the process ID of the qemu subprocess. If there is no qemu " -"subprocess, then this will return an error." +"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:1413 ../src/guestfs-actions.pod:2104 -msgid "This is an internal call used for debugging and testing." -msgstr "" +#: ../fish/guestfish-actions.pod:1132 +msgid "See also L, L, L." +msgstr "Див. також L, L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1415 -msgid "get-qemu" -msgstr "get-qemu" +#: ../fish/guestfish-actions.pod:1134 +msgid "fallocate" +msgstr "fallocate" #. type: verbatim -#: ../fish/guestfish-actions.pod:1417 +#: ../fish/guestfish-actions.pod:1136 #, no-wrap msgid "" -" get-qemu\n" +" fallocate path len\n" "\n" msgstr "" -" get-qemu\n" +" fallocate шлях довжина\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1419 ../src/guestfs-actions.pod:2115 -msgid "Return the current qemu binary." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1421 ../src/guestfs-actions.pod:2117 +#: ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1157 +#: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1943 msgid "" -"This is always non-NULL. If it wasn't set already, then this will return " -"the default qemu binary name." +"This command preallocates a file (containing zero bytes) named C of " +"size C bytes. If the file exists already, it is overwritten." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1424 -msgid "get-recovery-proc" -msgstr "get-recovery-proc" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:1426 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:1142 ../src/guestfs-actions.pod:1928 msgid "" -" get-recovery-proc\n" -"\n" +"Do not confuse this with the guestfish-specific C command which " +"allocates a file in the host and attaches it as a device." msgstr "" -" get-recovery-proc\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1428 ../src/guestfs-actions.pod:2130 -msgid "Return the recovery process enabled flag." +#: ../fish/guestfish-actions.pod:1146 +msgid "" +"I In new code, use the L call " +"instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1430 -msgid "get-selinux" -msgstr "get-selinux" +#: ../fish/guestfish-actions.pod:1153 +msgid "fallocate64" +msgstr "fallocate64" #. type: verbatim -#: ../fish/guestfish-actions.pod:1432 +#: ../fish/guestfish-actions.pod:1155 #, no-wrap msgid "" -" get-selinux\n" +" fallocate64 path len\n" "\n" msgstr "" -" get-selinux\n" +" fallocate64 шлях довжина\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1434 -msgid "" -"This returns the current setting of the selinux flag which is passed to the " -"appliance at boot time. See L." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:1440 -msgid "get-state" -msgstr "get-state" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:1442 -#, no-wrap +#: ../fish/guestfish-actions.pod:1161 msgid "" -" get-state\n" -"\n" +"Note that this call allocates disk blocks for the file. To create a sparse " +"file use L instead." msgstr "" -" get-state\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2156 +#: ../fish/guestfish-actions.pod:1164 msgid "" -"This returns the current state as an opaque integer. This is only useful " -"for printing debug and internal error messages." +"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:1447 ../fish/guestfish-actions.pod:2367 -#: ../fish/guestfish-actions.pod:2385 ../fish/guestfish-actions.pod:2423 -#: ../fish/guestfish-actions.pod:2439 ../src/guestfs-actions.pod:2159 -#: ../src/guestfs-actions.pod:3439 ../src/guestfs-actions.pod:3468 -#: ../src/guestfs-actions.pod:3529 ../src/guestfs-actions.pod:3556 -msgid "For more information on states, see L." +#: ../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:1449 -msgid "get-trace" -msgstr "get-trace" +#: ../fish/guestfish-actions.pod:1173 +msgid "fgrep" +msgstr "fgrep" #. type: verbatim -#: ../fish/guestfish-actions.pod:1451 +#: ../fish/guestfish-actions.pod:1175 #, no-wrap msgid "" -" get-trace\n" +" fgrep pattern path\n" "\n" msgstr "" -" get-trace\n" +" fgrep шаблон шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1453 ../src/guestfs-actions.pod:2170 -msgid "Return the command trace flag." +#: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:1970 +msgid "" +"This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1455 -msgid "get-umask" -msgstr "get-umask" +#: ../fish/guestfish-actions.pod:1183 +msgid "fgrepi" +msgstr "fgrepi" #. type: verbatim -#: ../fish/guestfish-actions.pod:1457 +#: ../fish/guestfish-actions.pod:1185 #, no-wrap msgid "" -" get-umask\n" +" fgrepi pattern path\n" "\n" msgstr "" -" get-umask\n" +" fgrepi шаблон шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1459 +#: ../fish/guestfish-actions.pod:1187 ../src/guestfs-actions.pod:1989 msgid "" -"Return the current umask. By default the umask is C<022> unless it has been " -"set by calling L." +"This calls the external C program and returns the matching lines." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1462 -msgid "get-verbose" -msgstr "get-verbose" +#: ../fish/guestfish-actions.pod:1193 +msgid "file" +msgstr "file" #. type: verbatim -#: ../fish/guestfish-actions.pod:1464 +#: ../fish/guestfish-actions.pod:1195 #, no-wrap msgid "" -" get-verbose\n" +" file path\n" "\n" msgstr "" -" get-verbose\n" +" file шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1466 ../src/guestfs-actions.pod:2193 -msgid "This returns the verbose messages flag." +#: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:2007 +msgid "" +"This call uses the standard L command to determine the type or " +"contents of the file." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1468 -msgid "getcon" -msgstr "getcon" +#. type: textblock +#: ../fish/guestfish-actions.pod:1200 ../src/guestfs-actions.pod:2010 +msgid "" +"This call will also transparently look inside various types of compressed " +"file." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:1470 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2013 msgid "" -" getcon\n" -"\n" +"The exact command which runs is C. Note in particular that " +"the filename is not prepended to the output (the I<-b> option)." msgstr "" -" getcon\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1472 ../src/guestfs-actions.pod:2204 -msgid "This gets the SELinux security context of the daemon." +#: ../fish/guestfish-actions.pod:1207 ../src/guestfs-actions.pod:2017 +msgid "" +"The output depends on the output of the underlying L command and it " +"can change in future in ways beyond our control. In other words, the output " +"is not guaranteed by the ABI." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1474 -msgid "See the documentation about SELINUX in L, and L" +#: ../fish/guestfish-actions.pod:1211 +msgid "" +"See also: L, L, L, L, L " +"(etc), L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1477 -msgid "getxattr" -msgstr "getxattr" +#: ../fish/guestfish-actions.pod:1214 +msgid "file-architecture" +msgstr "file-architecture" #. type: verbatim -#: ../fish/guestfish-actions.pod:1479 +#: ../fish/guestfish-actions.pod:1216 #, no-wrap msgid "" -" getxattr path name\n" +" file-architecture filename\n" "\n" msgstr "" -" getxattr шлях назва\n" +" file-architecture назва_файла\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1481 +#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2035 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." +"This detects the architecture of the binary C, and returns it if " +"known." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1485 ../fish/guestfish-actions.pod:2512 -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." +#: ../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:1492 ../fish/guestfish-actions.pod:2519 -#: ../src/guestfs-actions.pod:2233 ../src/guestfs-actions.pod:3689 +#: ../fish/guestfish-actions.pod:1227 ../src/guestfs-actions.pod:2044 msgid "" -"Extended attribute values are blobs of binary data. If there is no extended " -"attribute named C, this returns an error." +"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:1495 -msgid "See also: L, L, L." -msgstr "Див. також L, L, L." +#: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2049 +msgid "64 bit x86-64." +msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1497 -msgid "getxattrs" -msgstr "getxattrs" +#. type: =item +#: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2051 +msgid "\"sparc\"" +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:1499 -#, no-wrap -msgid "" -" getxattrs path\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1236 ../src/guestfs-actions.pod:2053 +msgid "32 bit SPARC." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:1238 ../src/guestfs-actions.pod:2055 +msgid "\"sparc64\"" msgstr "" -" getxattrs шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1501 ../src/guestfs-actions.pod:2250 -msgid "" -"This call lists the extended attributes of the file or directory C." +#: ../fish/guestfish-actions.pod:1240 ../src/guestfs-actions.pod:2057 +msgid "64 bit SPARC V9 and above." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:2059 +msgid "\"ia64\"" +msgstr "\"ia64\"" + #. type: textblock -#: ../fish/guestfish-actions.pod:1504 ../src/guestfs-actions.pod:2253 -msgid "" -"At the system call level, this is a combination of the L and " -"L calls." +#: ../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 "" #. type: textblock -#: ../fish/guestfish-actions.pod:1507 -msgid "See also: L, L." -msgstr "Див. також L, L." +#: ../fish/guestfish-actions.pod:1248 ../src/guestfs-actions.pod:2065 +msgid "32 bit Power PC." +msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1509 -msgid "glob-expand" -msgstr "glob-expand" +#. type: =item +#: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2067 +msgid "\"ppc64\"" +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:1511 -#, no-wrap -msgid "" -" glob-expand pattern\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:2069 +msgid "64 bit Power PC." msgstr "" -" glob-expand шаблон\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1513 ../src/guestfs-actions.pod:2270 -msgid "" -"This command searches for all the pathnames matching C according to " -"the wildcard expansion rules used by the shell." +#: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:2073 +msgid "Libguestfs may return other architecture strings in future." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2274 -msgid "" -"If no paths match, then this returns an empty list (note: not an error)." +#: ../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:1520 ../src/guestfs-actions.pod:2277 -msgid "" -"It is just a wrapper around the C L function with flags C. See that manual page for more details." +#: ../fish/guestfish-actions.pod:1264 ../src/guestfs-actions.pod:2081 +msgid "many types of Un*x and Linux binary" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:1524 -msgid "grep" -msgstr "grep" +#. type: textblock +#: ../fish/guestfish-actions.pod:1268 ../src/guestfs-actions.pod:2085 +msgid "many types of Un*x and Linux shared library" +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:1526 -#, no-wrap -msgid "" -" grep regex path\n" -"\n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1272 ../src/guestfs-actions.pod:2089 +msgid "Windows Win32 and Win64 binaries" msgstr "" -" grepi формальний_вираз шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1528 ../src/guestfs-actions.pod:2294 -msgid "This calls the external C program and returns the matching lines." +#: ../fish/guestfish-actions.pod:1276 ../src/guestfs-actions.pod:2093 +msgid "Windows Win32 and Win64 DLLs" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1278 ../src/guestfs-actions.pod:2095 +msgid "Win32 binaries and DLLs return C." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2097 +msgid "Win64 binaries and DLLs return C." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1284 ../src/guestfs-actions.pod:2101 +msgid "Linux kernel modules" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1288 ../src/guestfs-actions.pod:2105 +msgid "Linux new-style initrd images" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1292 ../src/guestfs-actions.pod:2109 +msgid "some non-x86 Linux vmlinuz kernels" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1296 ../src/guestfs-actions.pod:2113 +msgid "What it can't do currently:" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1302 ../src/guestfs-actions.pod:2119 +msgid "static libraries (libfoo.a)" +msgstr "" + +#. type: textblock +#: ../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:1310 ../src/guestfs-actions.pod:2127 +msgid "x86 Linux vmlinuz kernels" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1312 ../src/guestfs-actions.pod:2129 +msgid "" +"x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and " +"compressed code, and are horribly hard to unpack. If you want to find the " +"architecture of a kernel, use the architecture of the associated initrd or " +"kernel module(s) instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1534 -msgid "grepi" -msgstr "grepi" +#: ../fish/guestfish-actions.pod:1319 +msgid "filesize" +msgstr "filesize" #. type: verbatim -#: ../fish/guestfish-actions.pod:1536 +#: ../fish/guestfish-actions.pod:1321 #, no-wrap msgid "" -" grepi regex path\n" +" filesize file\n" "\n" msgstr "" -" grepi формальний_вираз шлях\n" +" filesize файл\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1538 ../src/guestfs-actions.pod:2313 +#: ../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:1325 msgid "" -"This calls the external C program and returns the matching lines." +"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:1544 -msgid "grub-install" -msgstr "grub-install" +#: ../fish/guestfish-actions.pod:1329 +msgid "fill" +msgstr "fill" #. type: verbatim -#: ../fish/guestfish-actions.pod:1546 +#: ../fish/guestfish-actions.pod:1331 #, no-wrap msgid "" -" grub-install root device\n" +" fill c len path\n" "\n" msgstr "" -" grub-install кореневий пристрій\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1548 ../src/guestfs-actions.pod:2332 +#: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:2165 msgid "" -"This command installs GRUB (the Grand Unified Bootloader) on C, with " -"the root directory being 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:1551 ../src/guestfs-actions.pod:2335 +#: ../fish/guestfish-actions.pod:1337 msgid "" -"Note: 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:" +"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: =head2 +#: ../fish/guestfish-actions.pod:1342 +msgid "fill-pattern" +msgstr "fill-pattern" + #. type: verbatim -#: ../fish/guestfish-actions.pod:1558 ../src/guestfs-actions.pod:2342 +#: ../fish/guestfish-actions.pod:1344 #, no-wrap msgid "" -" (hd0) /dev/vda\n" +" fill-pattern pattern len path\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1560 ../src/guestfs-actions.pod:2344 -msgid "replacing C with the name of the installation device." +#: ../fish/guestfish-actions.pod:1346 +msgid "" +"This function is like L except that it creates a new file of length " +"C containing the repeating pattern of bytes in C. The pattern " +"is truncated if necessary to ensure the length of the file is exactly C " +"bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1562 -msgid "head" -msgstr "head" +#: ../fish/guestfish-actions.pod:1351 +msgid "find" +msgstr "find" #. type: verbatim -#: ../fish/guestfish-actions.pod:1564 +#: ../fish/guestfish-actions.pod:1353 #, no-wrap msgid "" -" head path\n" +" find directory\n" "\n" msgstr "" -" head шлях\n" +" find каталог\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1566 ../src/guestfs-actions.pod:2356 +#: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2211 msgid "" -"This command returns up to the first 10 lines of a file as a list of strings." +"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: =head2 -#: ../fish/guestfish-actions.pod:1572 -msgid "head-n" -msgstr "head-n" +#. type: textblock +#: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2216 +msgid "" +"This returns a list of strings I. Thus if the directory " +"structure was:" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:1574 +#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2219 #, no-wrap msgid "" -" head-n nrlines path\n" +" /tmp/a\n" +" /tmp/b\n" +" /tmp/c/d\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1576 ../src/guestfs-actions.pod:2375 +#: ../fish/guestfish-actions.pod:1367 +msgid "then the returned list from L C would be 4 elements:" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1370 ../src/guestfs-actions.pod:2226 +#, no-wrap msgid "" -"If the parameter C is a positive number, this returns the first " -"C lines of the file C." +" a\n" +" b\n" +" c\n" +" c/d\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2378 -msgid "" -"If the parameter C is a negative number, this returns lines from " -"the file C, excluding the last C lines." +#: ../fish/guestfish-actions.pod:1375 ../src/guestfs-actions.pod:2231 +msgid "If C is not a directory, then this command returns an error." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1582 ../fish/guestfish-actions.pod:4648 -#: ../src/guestfs-actions.pod:2381 ../src/guestfs-actions.pod:6996 -msgid "If the parameter C is zero, this returns an empty list." +#: ../fish/guestfish-actions.pod:1378 ../src/guestfs-actions.pod:2234 +msgid "The returned list is sorted." msgstr "" +#. type: textblock +#: ../fish/guestfish-actions.pod:1380 +msgid "See also L." +msgstr "Див. також L." + #. type: =head2 -#: ../fish/guestfish-actions.pod:1587 -msgid "hexdump" -msgstr "hexdump" +#: ../fish/guestfish-actions.pod:1385 +msgid "find0" +msgstr "find0" #. type: verbatim -#: ../fish/guestfish-actions.pod:1589 +#: ../fish/guestfish-actions.pod:1387 #, no-wrap msgid "" -" hexdump path\n" +" find0 directory (files|-)\n" "\n" msgstr "" -" hexdump шлях\n" +" find0 каталог (файли|-)\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1591 ../src/guestfs-actions.pod:2398 +#: ../fish/guestfish-actions.pod:1389 ../src/guestfs-actions.pod:2254 msgid "" -"This runs C on the given C. The result is the human-" -"readable, canonical hex dump of the file." +"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:1393 +msgid "" +"This command works the same way as L with the following exceptions:" +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1400 ../src/guestfs-actions.pod:2265 +msgid "The resulting list is written to an external file." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1404 ../src/guestfs-actions.pod:2269 +msgid "" +"Items (filenames) in the result are separated by C<\\0> characters. See " +"L option I<-print0>." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod: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:1414 ../src/guestfs-actions.pod:2279 +msgid "The result list is not sorted." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1597 -msgid "initrd-cat" -msgstr "initrd-cat" +#: ../fish/guestfish-actions.pod:1420 +msgid "findfs-label" +msgstr "findfs-label" #. type: verbatim -#: ../fish/guestfish-actions.pod:1599 +#: ../fish/guestfish-actions.pod:1422 #, no-wrap msgid "" -" initrd-cat initrdpath filename\n" +" findfs-label label\n" "\n" msgstr "" -" initrd-cat шлях_initrd назва_файла\n" +" findfs-label мітка\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1601 ../src/guestfs-actions.pod:2417 +#: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2293 msgid "" -"This command unpacks the file C from the initrd file called " -"C. The filename must be given I the initial C " -"character." +"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:1605 ../src/guestfs-actions.pod:2421 -msgid "" -"For example, in guestfish you could use the following command to examine the " -"boot script (usually called C) contained in a Linux initrd or " -"initramfs image:" -msgstr "" +#: ../fish/guestfish-actions.pod:1428 +msgid "To find the label of a filesystem, use L." +msgstr "Для визначення мітки файлової системи скористайтеся L." + +#. type: =head2 +#: ../fish/guestfish-actions.pod:1430 +msgid "findfs-uuid" +msgstr "findfs-uuid" #. type: verbatim -#: ../fish/guestfish-actions.pod:1609 ../src/guestfs-actions.pod:2425 +#: ../fish/guestfish-actions.pod:1432 #, no-wrap msgid "" -" initrd-cat /boot/initrd-.img init\n" +" findfs-uuid uuid\n" "\n" msgstr "" +" findfs-uuid uuid\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1611 -msgid "See also L." -msgstr "Див. також L." +#: ../fish/guestfish-actions.pod:1434 ../src/guestfs-actions.pod:2310 +msgid "" +"This command searches the filesystems and returns the one which has the " +"given UUID. An error is returned if no such filesystem can be found." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1438 +msgid "To find the UUID of a filesystem, use L." +msgstr "Для визначення UUID файлової системи скористайтеся L." #. type: =head2 -#: ../fish/guestfish-actions.pod:1616 -msgid "initrd-list" -msgstr "initrd-list" +#: ../fish/guestfish-actions.pod:1440 +msgid "fsck" +msgstr "fsck" #. type: verbatim -#: ../fish/guestfish-actions.pod:1618 +#: ../fish/guestfish-actions.pod:1442 #, no-wrap msgid "" -" initrd-list path\n" +" fsck fstype device\n" "\n" msgstr "" -" initrd-list шлях\n" +" fsck тип_файлової_системи пристрій\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1620 ../src/guestfs-actions.pod:2444 -msgid "This command lists out files contained in an initrd." +#: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2328 +msgid "" +"This runs the filesystem checker (fsck) on C which should have " +"filesystem type C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1622 ../src/guestfs-actions.pod:2446 +#: ../fish/guestfish-actions.pod:1447 ../src/guestfs-actions.pod:2331 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." +"The returned integer is the status. See L for the list of status " +"codes from C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1626 ../src/guestfs-actions.pod:2450 +#: ../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:1460 ../src/guestfs-actions.pod:2344 msgid "" -"Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as " -"initrd. We I support the newer initramfs format (compressed cpio " -"files)." +"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:1465 ../src/guestfs-actions.pod:2349 +msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1470 ../src/guestfs-actions.pod:2354 +msgid "" +"This command is entirely equivalent to running C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1630 -msgid "inotify-add-watch" -msgstr "inotify-add-watch" +#: ../fish/guestfish-actions.pod:1472 +msgid "get-append" +msgstr "get-append" #. type: verbatim -#: ../fish/guestfish-actions.pod:1632 +#: ../fish/guestfish-actions.pod:1474 #, no-wrap msgid "" -" inotify-add-watch path mask\n" +" get-append\n" "\n" msgstr "" -" inotify-add-watch шлях маска\n" +" get-append\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1634 ../src/guestfs-actions.pod:2467 -msgid "Watch C for the events listed in C." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2469 +#: ../fish/guestfish-actions.pod:1476 ../src/guestfs-actions.pod:2365 msgid "" -"Note that if C is a directory then events within that directory are " -"watched, but this does I happen recursively (in subdirectories)." +"Return the additional kernel options which are added to the guest kernel " +"command line." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1640 ../src/guestfs-actions.pod:2473 -msgid "" -"Note for non-C or non-Linux callers: the inotify events are defined by the " -"Linux kernel ABI and are listed in C." +#: ../fish/guestfish-actions.pod:1479 ../src/guestfs-actions.pod:2368 +msgid "If C then no options are added." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1644 -msgid "inotify-close" -msgstr "inotify-close" +#: ../fish/guestfish-actions.pod:1481 +msgid "get-attach-method" +msgstr "get-attach-method" #. type: verbatim -#: ../fish/guestfish-actions.pod:1646 +#: ../fish/guestfish-actions.pod:1483 #, no-wrap msgid "" -" inotify-close\n" +" get-attach-method\n" "\n" msgstr "" -" inotify-close\n" +" get-attach-method\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1648 ../src/guestfs-actions.pod:2486 -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." +#: ../fish/guestfish-actions.pod:1485 +msgid "Return the current attach method. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1652 -msgid "inotify-files" -msgstr "inotify-files" +#: ../fish/guestfish-actions.pod:1487 +msgid "get-autosync" +msgstr "get-autosync" #. type: verbatim -#: ../fish/guestfish-actions.pod:1654 +#: ../fish/guestfish-actions.pod:1489 #, no-wrap msgid "" -" inotify-files\n" +" get-autosync\n" "\n" msgstr "" -" inotify-files\n" +" get-autosync\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1656 -msgid "" -"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." +#: ../fish/guestfish-actions.pod:1491 ../src/guestfs-actions.pod:2393 +msgid "Get the autosync flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1660 -msgid "inotify-init" -msgstr "inotify-init" +#: ../fish/guestfish-actions.pod:1493 +msgid "get-direct" +msgstr "get-direct" #. type: verbatim -#: ../fish/guestfish-actions.pod:1662 +#: ../fish/guestfish-actions.pod:1495 #, no-wrap msgid "" -" inotify-init maxevents\n" +" get-direct\n" "\n" msgstr "" +" get-direct\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1664 ../src/guestfs-actions.pod:2515 +#: ../fish/guestfish-actions.pod:1497 ../src/guestfs-actions.pod:2404 +msgid "Return the direct appliance mode flag." +msgstr "" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:1499 +msgid "get-e2label" +msgstr "get-e2label" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1501 +#, no-wrap 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." +" get-e2label device\n" +"\n" msgstr "" +" get-e2label пристрій\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1668 +#: ../fish/guestfish-actions.pod:1503 ../src/guestfs-actions.pod:2423 msgid "" -"C is the maximum number of events which will be queued up between " -"calls to L or L. If this is passed as C<0>, " -"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)." +"This returns the ext2/3/4 filesystem label of the filesystem on C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1678 +#: ../fish/guestfish-actions.pod:1506 msgid "" -"Before any events are generated, you have to add some watches to the " -"internal watch list. See: L, L and " -"L." +"I In new code, use the L call " +"instead." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1684 +#. type: =head2 +#: ../fish/guestfish-actions.pod:1513 +msgid "get-e2uuid" +msgstr "get-e2uuid" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1515 +#, no-wrap 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." +" get-e2uuid device\n" +"\n" msgstr "" +" get-e2uuid пристрій\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1691 +#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2444 msgid "" -"The handle should be closed after use by calling L. This " -"also removes any watches automatically." +"This returns the ext2/3/4 filesystem UUID of the filesystem on C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1695 ../src/guestfs-actions.pod:2546 +#: ../fish/guestfish-actions.pod:1520 msgid "" -"See also L for an overview of the inotify interface as exposed " -"by the Linux kernel, which is roughly what we expose via libguestfs. Note " -"that there is one global inotify handle per libguestfs instance." +"I In new code, use the L call " +"instead." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1700 -msgid "inotify-read" -msgstr "inotify-read" +#: ../fish/guestfish-actions.pod:1527 +msgid "get-memsize" +msgstr "get-memsize" #. type: verbatim -#: ../fish/guestfish-actions.pod:1702 +#: ../fish/guestfish-actions.pod:1529 #, no-wrap msgid "" -" inotify-read\n" +" get-memsize\n" "\n" msgstr "" -" inotify-read\n" +" get-memsize\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1704 ../src/guestfs-actions.pod:2560 +#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2457 msgid "" -"Return the complete queue of events that have happened since the previous " -"read call." +"This gets the memory size in megabytes allocated to the qemu subprocess." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1707 ../src/guestfs-actions.pod:2563 -msgid "If no events have happened, this returns an empty list." +#: ../fish/guestfish-actions.pod:1534 +msgid "" +"If L was not called on this handle, and if " +"C was not set, then this returns the compiled-in default " +"value for memsize." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1709 ../src/guestfs-actions.pod:2565 +#: ../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 "" -"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." +"For more information on the architecture of libguestfs, see L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1715 -msgid "inotify-rm-watch" -msgstr "inotify-rm-watch" +#: ../fish/guestfish-actions.pod:1541 +msgid "get-network" +msgstr "get-network" #. type: verbatim -#: ../fish/guestfish-actions.pod:1717 +#: ../fish/guestfish-actions.pod:1543 #, no-wrap msgid "" -" inotify-rm-watch wd\n" +" get-network\n" "\n" msgstr "" +" get-network\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1719 -msgid "Remove a previously defined inotify watch. See L." +#: ../fish/guestfish-actions.pod:1545 ../src/guestfs-actions.pod:2476 +msgid "This returns the enable network flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1722 -msgid "inspect-get-arch" -msgstr "inspect-get-arch" +#: ../fish/guestfish-actions.pod:1547 +msgid "get-path" +msgstr "get-path" #. type: verbatim -#: ../fish/guestfish-actions.pod:1724 +#: ../fish/guestfish-actions.pod:1549 #, no-wrap msgid "" -" inspect-get-arch root\n" +" get-path\n" "\n" msgstr "" -" inspect-get-arch корінь\n" +" get-path\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1726 -msgid "" -"This returns the architecture of the inspected operating system. The " -"possible return values are listed under L." +#: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2487 +msgid "Return the current search path." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1730 ../src/guestfs-actions.pod:2600 +#: ../fish/guestfish-actions.pod:1553 ../src/guestfs-actions.pod:2489 msgid "" -"If the architecture could not be determined, then the string C is " -"returned." +"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:1556 +msgid "get-pgroup" +msgstr "" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1558 +#, no-wrap +msgid "" +" get-pgroup\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1733 ../fish/guestfish-actions.pod:1816 -#: ../fish/guestfish-actions.pod:1895 ../fish/guestfish-actions.pod:1907 -#: ../fish/guestfish-actions.pod:1991 ../fish/guestfish-actions.pod:2052 -#: ../fish/guestfish-actions.pod:2073 ../fish/guestfish-actions.pod:2087 -#: ../fish/guestfish-actions.pod:2127 ../fish/guestfish-actions.pod:2159 -#: ../fish/guestfish-actions.pod:2172 ../fish/guestfish-actions.pod:2185 -#: ../fish/guestfish-actions.pod:2195 ../fish/guestfish-actions.pod:2205 -#: ../fish/guestfish-actions.pod:2217 ../fish/guestfish-actions.pod:2313 -#: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:2603 -#: ../src/guestfs-actions.pod:2693 ../src/guestfs-actions.pod:2797 -#: ../src/guestfs-actions.pod:2816 ../src/guestfs-actions.pod:2947 -#: ../src/guestfs-actions.pod:3030 ../src/guestfs-actions.pod:3058 -#: ../src/guestfs-actions.pod:3079 ../src/guestfs-actions.pod:3132 -#: ../src/guestfs-actions.pod:3172 ../src/guestfs-actions.pod:3192 -#: ../src/guestfs-actions.pod:3212 ../src/guestfs-actions.pod:3229 -#: ../src/guestfs-actions.pod:3245 ../src/guestfs-actions.pod:3263 -#: ../src/guestfs-actions.pod:3365 ../src/guestfs-actions.pod:3406 -msgid "Please read L for more details." +#: ../fish/guestfish-actions.pod:1560 ../src/guestfs-actions.pod:2502 +msgid "This returns the process group flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1735 -msgid "inspect-get-distro" -msgstr "inspect-get-distro" +#: ../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:1737 +#: ../fish/guestfish-actions.pod:1566 #, no-wrap msgid "" -" inspect-get-distro root\n" +" get-pid\n" "\n" msgstr "" -" inspect-get-distro корінь\n" +" get-pid\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1739 ../src/guestfs-actions.pod:2616 +#: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2513 msgid "" -"This returns the distro (distribution) of the inspected operating system." +"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:1742 ../src/guestfs-actions.pod:2619 -msgid "Currently defined distros are:" +#: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2516 +msgid "This is an internal call used for debugging and testing." 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: =head2 +#: ../fish/guestfish-actions.pod:1573 +msgid "get-qemu" +msgstr "get-qemu" -#. type: =item -#: ../fish/guestfish-actions.pod:1750 ../src/guestfs-actions.pod:2627 -msgid "\"centos\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:1575 +#, no-wrap +msgid "" +" get-qemu\n" +"\n" msgstr "" +" get-qemu\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2629 -msgid "CentOS." +#: ../fish/guestfish-actions.pod:1577 ../src/guestfs-actions.pod:2527 +msgid "Return the current qemu binary." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1754 ../src/guestfs-actions.pod:2631 -msgid "\"debian\"" -msgstr "\"debian\"" - #. type: textblock -#: ../fish/guestfish-actions.pod:1756 ../src/guestfs-actions.pod:2633 -msgid "Debian." -msgstr "Debian." +#: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2529 +msgid "" +"This is always non-NULL. If it wasn't set already, then this will return " +"the default qemu binary name." +msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1758 ../src/guestfs-actions.pod:2635 -msgid "\"fedora\"" -msgstr "\"fedora\"" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1582 +msgid "get-recovery-proc" +msgstr "get-recovery-proc" -#. 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\"" - -#. 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\"" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1768 ../src/guestfs-actions.pod:2645 -msgid "Linux Mint." -msgstr "Linux Mint." - -#. type: =item -#: ../fish/guestfish-actions.pod:1770 ../src/guestfs-actions.pod:2647 -msgid "\"mandriva\"" -msgstr "\"mandriva\"" - -#. 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\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:1584 +#, no-wrap +msgid "" +" get-recovery-proc\n" +"\n" +msgstr "" +" get-recovery-proc\n" +"\n" #. 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:1586 ../src/guestfs-actions.pod:2542 +msgid "Return the recovery process enabled flag." +msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1780 ../src/guestfs-actions.pod:2657 -msgid "Pardus." -msgstr "Pardus." +#. type: =head2 +#: ../fish/guestfish-actions.pod:1588 +msgid "get-selinux" +msgstr "get-selinux" -#. type: =item -#: ../fish/guestfish-actions.pod:1782 ../src/guestfs-actions.pod:2659 -msgid "\"redhat-based\"" -msgstr "\"redhat-based\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:1590 +#, no-wrap +msgid "" +" get-selinux\n" +"\n" +msgstr "" +" get-selinux\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1784 ../src/guestfs-actions.pod:2661 -msgid "Some Red Hat-derived distro." -msgstr "Дистрибутив, що походить від Red Hat." - -#. type: =item -#: ../fish/guestfish-actions.pod:1786 ../src/guestfs-actions.pod:2663 -msgid "\"rhel\"" -msgstr "\"rhel\"" +#: ../fish/guestfish-actions.pod:1592 +msgid "" +"This returns the current setting of the selinux flag which is passed to the " +"appliance at boot time. See L." +msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1788 ../src/guestfs-actions.pod:2665 -msgid "Red Hat Enterprise Linux." +#. type: =head2 +#: ../fish/guestfish-actions.pod:1598 +msgid "get-smp" msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1790 ../src/guestfs-actions.pod:2667 -msgid "\"scientificlinux\"" +#. type: verbatim +#: ../fish/guestfish-actions.pod:1600 +#, no-wrap +msgid "" +" get-smp\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1792 ../src/guestfs-actions.pod:2669 -msgid "Scientific Linux." +#: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2568 +msgid "This returns the number of virtual CPUs assigned to the appliance." msgstr "" -#. type: =item -#: ../fish/guestfish-actions.pod:1794 ../src/guestfs-actions.pod:2671 -msgid "\"slackware\"" -msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1604 +msgid "get-state" +msgstr "get-state" -#. type: textblock -#: ../fish/guestfish-actions.pod:1796 ../src/guestfs-actions.pod:2673 -msgid "Slackware." +#. type: verbatim +#: ../fish/guestfish-actions.pod:1606 +#, no-wrap +msgid "" +" get-state\n" +"\n" msgstr "" - -#. type: =item -#: ../fish/guestfish-actions.pod:1798 ../src/guestfs-actions.pod:2675 -msgid "\"ubuntu\"" -msgstr "\"ubuntu\"" +" get-state\n" +"\n" #. 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:1608 ../src/guestfs-actions.pod:2579 +msgid "" +"This returns the current state as an opaque integer. This is only useful " +"for printing debug and internal error messages." +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1804 ../src/guestfs-actions.pod:2681 -msgid "The distro could not be determined." -msgstr "Дистрибутив, тип якого не вдалося визначити." +#: ../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: =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:1613 +msgid "get-trace" +msgstr "get-trace" -#. type: textblock -#: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2685 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1615 +#, no-wrap msgid "" -"Windows does not have distributions. This string is returned if the OS type " -"is Windows." +" get-trace\n" +"\n" msgstr "" +" get-trace\n" +"\n" #. 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 -msgid "" -"Future versions of libguestfs may return other strings here. The caller " -"should be prepared to handle any string." +#: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2593 +msgid "Return the command trace flag." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1818 -msgid "inspect-get-drive-mappings" -msgstr "" +#: ../fish/guestfish-actions.pod:1619 +msgid "get-umask" +msgstr "get-umask" #. type: verbatim -#: ../fish/guestfish-actions.pod:1820 +#: ../fish/guestfish-actions.pod:1621 #, no-wrap msgid "" -" inspect-get-drive-mappings root\n" +" get-umask\n" "\n" msgstr "" +" get-umask\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2706 +#: ../fish/guestfish-actions.pod:1623 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:" +"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:1626 +msgid "get-verbose" +msgstr "get-verbose" + #. type: verbatim -#: ../fish/guestfish-actions.pod:1828 ../src/guestfs-actions.pod:2712 +#: ../fish/guestfish-actions.pod:1628 #, no-wrap msgid "" -" C => /dev/vda2\n" -" E => /dev/vdb1\n" -" F => /dev/vdc1\n" +" get-verbose\n" "\n" msgstr "" +" get-verbose\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1832 ../src/guestfs-actions.pod:2716 -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." +#: ../fish/guestfish-actions.pod:1630 ../src/guestfs-actions.pod:2616 +msgid "This returns the verbose messages flag." 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." -msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1632 +msgid "getcon" +msgstr "getcon" -#. type: textblock -#: ../fish/guestfish-actions.pod:1841 ../src/guestfs-actions.pod:2725 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1634 +#, no-wrap msgid "" -"For Windows guests, currently only hard drive mappings are returned. " -"Removable disks (eg. DVD-ROMs) are ignored." +" getcon\n" +"\n" msgstr "" +" getcon\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1844 ../src/guestfs-actions.pod:2728 -msgid "" -"For guests that do not use drive mappings, or if the drive mappings could " -"not be determined, this returns an empty hash table." +#: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2627 +msgid "This gets the SELinux security context of the daemon." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1847 -msgid "" -"Please read L for more details. See also L, L." +#: ../fish/guestfish-actions.pod:1638 +msgid "See the documentation about SELINUX in L, and L" msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1851 -msgid "inspect-get-filesystems" -msgstr "inspect-get-filesystems" +#: ../fish/guestfish-actions.pod:1641 +msgid "getxattr" +msgstr "getxattr" #. type: verbatim -#: ../fish/guestfish-actions.pod:1853 +#: ../fish/guestfish-actions.pod:1643 #, no-wrap msgid "" -" inspect-get-filesystems root\n" +" getxattr path name\n" "\n" msgstr "" -" inspect-get-filesystems корінь\n" +" getxattr шлях назва\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1855 ../src/guestfs-actions.pod:2749 +#: ../fish/guestfish-actions.pod:1645 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." +"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:1860 ../src/guestfs-actions.pod:2754 +#: ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:2715 msgid "" -"In the case of a multi-boot virtual machine, it is possible for a filesystem " -"to be shared between operating systems." +"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:1863 +#: ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:2722 +#: ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:4151 msgid "" -"Please read L for more details. See also L." +"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:1866 -msgid "inspect-get-format" -msgstr "inspect-get-format" +#: ../fish/guestfish-actions.pod:1661 +msgid "getxattrs" +msgstr "getxattrs" #. type: verbatim -#: ../fish/guestfish-actions.pod:1868 +#: ../fish/guestfish-actions.pod:1663 #, no-wrap msgid "" -" inspect-get-format root\n" +" getxattrs path\n" "\n" msgstr "" -" inspect-get-format корінь\n" +" getxattrs шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1870 ../src/guestfs-actions.pod:2772 +#: ../fish/guestfish-actions.pod:1665 ../src/guestfs-actions.pod:2673 msgid "" -"This returns the format of the inspected operating system. You can use it " -"to detect install images, live CDs and similar." +"This call lists the extended attributes of the file or directory C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1873 ../src/guestfs-actions.pod:2775 -msgid "Currently defined formats are:" +#: ../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: =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 "Це встановлена операційна система." +#: ../fish/guestfish-actions.pod:1671 +msgid "See also: L, L." +msgstr "Див. також L, L." -#. type: =item -#: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2783 -msgid "\"installer\"" +#. type: =head2 +#: ../fish/guestfish-actions.pod:1673 +msgid "glob-expand" +msgstr "glob-expand" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1675 +#, no-wrap +msgid "" +" glob-expand pattern\n" +"\n" msgstr "" +" glob-expand шаблон\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1883 ../src/guestfs-actions.pod:2785 +#: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2693 msgid "" -"The disk image being inspected is not an installed operating system, but a " -"I install disk, live CD, or similar." +"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:1888 ../src/guestfs-actions.pod:2790 -msgid "The format of this disk image is not known." +#: ../fish/guestfish-actions.pod:1681 ../src/guestfs-actions.pod:2697 +msgid "" +"If no paths match, then this returns an empty list (note: not an error)." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod: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:1897 -msgid "inspect-get-hostname" -msgstr "inspect-get-hostname" +#: ../fish/guestfish-actions.pod:1688 +msgid "grep" +msgstr "grep" #. type: verbatim -#: ../fish/guestfish-actions.pod:1899 +#: ../fish/guestfish-actions.pod:1690 #, no-wrap msgid "" -" inspect-get-hostname root\n" +" grep regex path\n" "\n" msgstr "" -" inspect-get-hostname корінь\n" +" grepi формальний_вираз шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1901 ../src/guestfs-actions.pod:2810 -msgid "" -"This function returns the hostname of the operating system as found by " -"inspection of the guest's configuration files." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:1904 ../src/guestfs-actions.pod:2813 -msgid "" -"If the hostname could not be determined, then the string C is " -"returned." +#: ../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:1909 -msgid "inspect-get-icon" -msgstr "" +#: ../fish/guestfish-actions.pod:1698 +msgid "grepi" +msgstr "grepi" #. type: verbatim -#: ../fish/guestfish-actions.pod:1911 +#: ../fish/guestfish-actions.pod:1700 #, no-wrap msgid "" -" inspect-get-icon root [favicon:..] [highquality:..]\n" +" grepi regex path\n" "\n" msgstr "" +" grepi формальний_вираз шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1913 ../src/guestfs-actions.pod:2839 +#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2736 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 calls the external C program and returns the matching lines." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1917 ../src/guestfs-actions.pod:2843 +#. type: =head2 +#: ../fish/guestfish-actions.pod:1708 +msgid "grub-install" +msgstr "grub-install" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1710 +#, no-wrap msgid "" -"If it was not possible to get an icon this function returns a zero-length " -"(non-NULL) buffer. I." +" grub-install root device\n" +"\n" msgstr "" +" grub-install кореневий пристрій\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1920 ../src/guestfs-actions.pod:2846 +#: ../fish/guestfish-actions.pod:1712 ../src/guestfs-actions.pod:2755 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)." +"This command installs GRUB 1 (the Grand Unified Bootloader) on C, " +"with the root directory being C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:1926 ../src/guestfs-actions.pod:2852 +#: ../fish/guestfish-actions.pod:1721 ../src/guestfs-actions.pod:2764 msgid "" -"If finding the favicon fails, then we look in other places in the guest for " -"a suitable icon." +"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:1929 ../src/guestfs-actions.pod:2855 +#: ../fish/guestfish-actions.pod:1728 ../src/guestfs-actions.pod:2771 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." +"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:1940 ../src/guestfs-actions.pod:2866 +#: ../fish/guestfish-actions.pod:1735 ../src/guestfs-actions.pod:2778 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." +"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: textblock -#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:2872 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1742 ../src/guestfs-actions.pod:2785 +#, no-wrap 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." +" (hd0) /dev/vda\n" +"\n" 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:1744 ../src/guestfs-actions.pod:2787 +msgid "replacing C with the name of the installation device." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:1961 ../src/guestfs-actions.pod:2887 +#. type: =head2 +#: ../fish/guestfish-actions.pod:1748 +msgid "head" +msgstr "head" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1750 +#, no-wrap 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." +" head path\n" +"\n" msgstr "" +" head шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:2894 +#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2801 msgid "" -"Operating system icons are usually trademarks. Seek legal advice before " -"using trademarks in applications." +"This command returns up to the first 10 lines of a file as a list of strings." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:1975 -msgid "inspect-get-major-version" -msgstr "inspect-get-major-version" +#: ../fish/guestfish-actions.pod:1758 +msgid "head-n" +msgstr "head-n" #. type: verbatim -#: ../fish/guestfish-actions.pod:1977 +#: ../fish/guestfish-actions.pod:1760 #, no-wrap msgid "" -" inspect-get-major-version root\n" +" head-n nrlines path\n" "\n" msgstr "" -" inspect-get-major-version корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:1979 ../src/guestfs-actions.pod:2935 +#: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2820 msgid "" -"This returns the major version number of the inspected operating system." +"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:1982 ../src/guestfs-actions.pod:2938 +#: ../fish/guestfish-actions.pod:1765 ../src/guestfs-actions.pod:2823 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." +"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: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: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:1993 -msgid "inspect-get-minor-version" -msgstr "inspect-get-minor-version" +#: ../fish/guestfish-actions.pod:1773 +msgid "hexdump" +msgstr "hexdump" #. type: verbatim -#: ../fish/guestfish-actions.pod:1995 +#: ../fish/guestfish-actions.pod:1775 #, no-wrap msgid "" -" inspect-get-minor-version root\n" +" hexdump path\n" "\n" msgstr "" -" inspect-get-minor-version корінь\n" +" hexdump шлях\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." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2002 +#: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2843 msgid "" -"Please read L for more details. See also L." +"This runs C on the given C. The result is the human-" +"readable, canonical hex dump of the file." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2005 -msgid "inspect-get-mountpoints" -msgstr "inspect-get-mountpoints" +#: ../fish/guestfish-actions.pod:1783 +msgid "initrd-cat" +msgstr "initrd-cat" #. type: verbatim -#: ../fish/guestfish-actions.pod:2007 +#: ../fish/guestfish-actions.pod:1785 #, no-wrap msgid "" -" inspect-get-mountpoints root\n" +" initrd-cat initrdpath filename\n" "\n" msgstr "" -" inspect-get-mountpoints корінь\n" +" initrd-cat шлях_initrd назва_файла\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." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2018 ../src/guestfs-actions.pod:2986 +#: ../fish/guestfish-actions.pod:1787 ../src/guestfs-actions.pod:2862 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)." +"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:2023 ../src/guestfs-actions.pod:2991 +#: ../fish/guestfish-actions.pod:1791 ../src/guestfs-actions.pod:2866 msgid "" -"Non-mounted devices such as swap devices are I returned in this list." +"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:2026 +#. type: verbatim +#: ../fish/guestfish-actions.pod:1795 ../src/guestfs-actions.pod:2870 +#, no-wrap 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." +" initrd-cat /boot/initrd-.img init\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2032 -msgid "" -"Please read L for more details. See also L." -msgstr "" +#: ../fish/guestfish-actions.pod:1797 +msgid "See also L." +msgstr "Див. також L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2035 -msgid "inspect-get-package-format" -msgstr "inspect-get-package-format" +#: ../fish/guestfish-actions.pod:1802 +msgid "initrd-list" +msgstr "initrd-list" #. type: verbatim -#: ../fish/guestfish-actions.pod:2037 +#: ../fish/guestfish-actions.pod:1804 #, no-wrap msgid "" -" inspect-get-package-format root\n" +" initrd-list path\n" "\n" msgstr "" -" inspect-get-package-format корінь\n" +" initrd-list шлях\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:1806 ../src/guestfs-actions.pod:2889 +msgid "This command lists out files contained in an initrd." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2045 ../src/guestfs-actions.pod:3023 +#: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2891 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)." +"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:2049 ../src/guestfs-actions.pod:3027 +#: ../fish/guestfish-actions.pod:1812 ../src/guestfs-actions.pod:2895 msgid "" -"Possible strings include: C, C, C, C, C. " -"Future versions of libguestfs may return other strings." +"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:2054 -msgid "inspect-get-package-management" -msgstr "inspect-get-package-management" +#: ../fish/guestfish-actions.pod:1816 +msgid "inotify-add-watch" +msgstr "inotify-add-watch" #. type: verbatim -#: ../fish/guestfish-actions.pod:2056 +#: ../fish/guestfish-actions.pod:1818 #, no-wrap msgid "" -" inspect-get-package-management root\n" +" inotify-add-watch path mask\n" "\n" msgstr "" -" inspect-get-package-management корінь\n" +" inotify-add-watch шлях маска\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:1820 ../src/guestfs-actions.pod:2912 +msgid "Watch C for the events listed in C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2064 ../src/guestfs-actions.pod:3049 +#: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2914 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)." +"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:2068 ../src/guestfs-actions.pod:3053 +#: ../fish/guestfish-actions.pod:1826 ../src/guestfs-actions.pod:2918 msgid "" -"Possible strings include: C, C, C (for all Debian " -"derivatives), C, C, C, C. Future versions of " -"libguestfs may return other strings." +"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:2075 -msgid "inspect-get-product-name" -msgstr "inspect-get-product-name" +#: ../fish/guestfish-actions.pod:1830 +msgid "inotify-close" +msgstr "inotify-close" #. type: verbatim -#: ../fish/guestfish-actions.pod:2077 +#: ../fish/guestfish-actions.pod:1832 #, no-wrap msgid "" -" inspect-get-product-name root\n" +" inotify-close\n" "\n" msgstr "" -" inspect-get-product-name корінь\n" +" inotify-close\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." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2084 ../src/guestfs-actions.pod:3076 +#: ../fish/guestfish-actions.pod:1834 ../src/guestfs-actions.pod:2931 msgid "" -"If the product name could not be determined, then the string C is " -"returned." +"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:2089 -msgid "inspect-get-product-variant" -msgstr "" +#: ../fish/guestfish-actions.pod:1838 +msgid "inotify-files" +msgstr "inotify-files" #. type: verbatim -#: ../fish/guestfish-actions.pod:2091 +#: ../fish/guestfish-actions.pod:1840 #, no-wrap msgid "" -" inspect-get-product-variant root\n" +" inotify-files\n" "\n" msgstr "" +" inotify-files\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2093 ../src/guestfs-actions.pod:3092 -msgid "This returns the product variant of the inspected operating system." +#: ../fish/guestfish-actions.pod:1842 +msgid "" +"This function is a helpful wrapper around L which just " +"returns a list of pathnames of objects that were touched. The returned " +"pathnames are sorted and deduplicated." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2096 ../src/guestfs-actions.pod:3095 +#. type: =head2 +#: ../fish/guestfish-actions.pod:1846 +msgid "inotify-init" +msgstr "inotify-init" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:1848 +#, no-wrap 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)." +" inotify-init maxevents\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2105 ../src/guestfs-actions.pod:3104 +#: ../fish/guestfish-actions.pod:1850 ../src/guestfs-actions.pod:2960 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." +"This command creates a new inotify handle. The inotify subsystem can be " +"used to notify events which happen to objects in the guest filesystem." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2109 ../src/guestfs-actions.pod:3108 +#: ../fish/guestfish-actions.pod:1854 msgid "" -"If the product variant could not be determined, then the string C " -"is returned." +"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 "" #. type: textblock -#: ../fish/guestfish-actions.pod:2112 +#: ../fish/guestfish-actions.pod:1864 msgid "" -"Please read L for more details. See also L, L." +"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:2116 -msgid "inspect-get-roots" -msgstr "inspect-get-roots" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2118 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:1870 msgid "" -" inspect-get-roots\n" -"\n" +"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 "" -" inspect-get-roots\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2120 +#: ../fish/guestfish-actions.pod:1877 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." +"The handle should be closed after use by calling L. This " +"also removes any watches automatically." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2124 +#: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2991 msgid "" -"This returns an empty list if either no root devices were found or the " -"caller has not called L." +"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:2129 -msgid "inspect-get-type" -msgstr "inspect-get-type" +#: ../fish/guestfish-actions.pod:1886 +msgid "inotify-read" +msgstr "inotify-read" #. type: verbatim -#: ../fish/guestfish-actions.pod:2131 +#: ../fish/guestfish-actions.pod:1888 #, no-wrap msgid "" -" inspect-get-type root\n" +" inotify-read\n" "\n" msgstr "" -" inspect-get-type корінь\n" +" inotify-read\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2133 ../src/guestfs-actions.pod:3146 +#: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:3005 msgid "" -"This returns the type of the inspected operating system. Currently defined " -"types are:" -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." +"Return the complete queue of events that have happened since the previous " +"read call." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3157 -msgid "Any Microsoft Windows operating system." +#: ../fish/guestfish-actions.pod:1893 ../src/guestfs-actions.pod:3008 +msgid "If no events have happened, this returns an empty list." 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." - #. type: textblock -#: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3165 -msgid "The operating system type could not be determined." +#: ../fish/guestfish-actions.pod:1895 ../src/guestfs-actions.pod:3010 +msgid "" +"I: In order to make sure that all events have been read, you must call " +"this function repeatedly until it returns an empty list. The reason is that " +"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:2161 -msgid "inspect-get-windows-current-control-set" -msgstr "" +#: ../fish/guestfish-actions.pod:1901 +msgid "inotify-rm-watch" +msgstr "inotify-rm-watch" #. type: verbatim -#: ../fish/guestfish-actions.pod:2163 +#: ../fish/guestfish-actions.pod:1903 #, no-wrap msgid "" -" inspect-get-windows-current-control-set root\n" +" inotify-rm-watch wd\n" "\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2165 ../src/guestfs-actions.pod:3185 -msgid "" -"This returns the Windows CurrentControlSet of the inspected guest. The " -"CurrentControlSet is a registry key name such as C." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2168 ../src/guestfs-actions.pod:3188 -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." +#: ../fish/guestfish-actions.pod:1905 +msgid "Remove a previously defined inotify watch. See L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2174 -msgid "inspect-get-windows-systemroot" -msgstr "inspect-get-windows-systemroot" +#: ../fish/guestfish-actions.pod:1908 +msgid "inspect-get-arch" +msgstr "inspect-get-arch" #. type: verbatim -#: ../fish/guestfish-actions.pod:2176 +#: ../fish/guestfish-actions.pod:1910 #, no-wrap msgid "" -" inspect-get-windows-systemroot root\n" +" inspect-get-arch root\n" "\n" msgstr "" -" inspect-get-windows-systemroot корінь\n" +" inspect-get-arch корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2178 ../src/guestfs-actions.pod:3205 +#: ../fish/guestfish-actions.pod:1912 msgid "" -"This returns the Windows systemroot of the inspected guest. The systemroot " -"is a directory path such as C." +"This returns the architecture of the inspected operating system. The " +"possible return values are listed under L." 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." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2187 -msgid "inspect-is-live" -msgstr "inspect-is-live" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2189 -#, no-wrap +#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3045 msgid "" -" inspect-is-live root\n" -"\n" +"If the architecture could not be determined, then the string C is " +"returned." msgstr "" -" inspect-is-live корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2191 -msgid "" -"If L returns C (this is an install disk), " -"then this returns true if a live image was detected on the disk." +#: ../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:2197 -msgid "inspect-is-multipart" -msgstr "inspect-is-multipart" +#: ../fish/guestfish-actions.pod:1921 +msgid "inspect-get-distro" +msgstr "inspect-get-distro" #. type: verbatim -#: ../fish/guestfish-actions.pod:2199 +#: ../fish/guestfish-actions.pod:1923 #, no-wrap msgid "" -" inspect-is-multipart root\n" +" inspect-get-distro root\n" "\n" msgstr "" -" inspect-is-multipart корінь\n" +" inspect-get-distro корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2201 +#: ../fish/guestfish-actions.pod:1925 ../src/guestfs-actions.pod:3061 msgid "" -"If L returns C (this is an install disk), " -"then this returns true if the disk is part of a set." +"This returns the distro (distribution) of the inspected operating system." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2207 -msgid "inspect-is-netinst" -msgstr "inspect-is-netinst" +#. type: textblock +#: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3064 +msgid "Currently defined distros are:" +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2209 -#, no-wrap -msgid "" -" inspect-is-netinst root\n" -"\n" +#. type: =item +#: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3068 +msgid "\"archlinux\"" +msgstr "\"archlinux\"" + +#. type: textblock +#: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3070 +msgid "Arch Linux." +msgstr "Arch Linux." + +#. type: =item +#: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3072 +msgid "\"centos\"" msgstr "" -" inspect-is-netinst корінь\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2211 -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." +#: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3074 +msgid "CentOS." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2219 -msgid "inspect-list-applications" -msgstr "inspect-list-applications" +#. type: =item +#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3076 +msgid "\"debian\"" +msgstr "\"debian\"" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2221 -#, no-wrap -msgid "" -" inspect-list-applications root\n" -"\n" -msgstr "" -" inspect-list-applications кореневий_каталог\n" -"\n" +#. type: textblock +#: ../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:2223 ../src/guestfs-actions.pod:3275 -msgid "Return the list of applications installed in the operating system." -msgstr "" +#: ../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: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." -msgstr "" +#: ../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:2235 ../src/guestfs-actions.pod:3287 -msgid "" -"This returns an empty list if the inspection code was not able to determine " -"the list of applications." +#: ../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:2238 ../src/guestfs-actions.pod:3290 -msgid "The application structure contains the following fields:" +#: ../fish/guestfish-actions.pod:1958 ../src/guestfs-actions.pod:3094 +msgid "Mageia." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2242 ../src/guestfs-actions.pod:3294 -msgid "C" -msgstr "C" +#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3096 +msgid "\"mandriva\"" +msgstr "\"mandriva\"" #. type: textblock -#: ../fish/guestfish-actions.pod:2244 ../src/guestfs-actions.pod:3296 -msgid "" -"The name of the application. For Red Hat-derived and Debian-derived Linux " -"guests, this is the package name." -msgstr "" +#: ../fish/guestfish-actions.pod:1962 ../src/guestfs-actions.pod:3098 +msgid "Mandriva." +msgstr "Mandriva." #. type: =item -#: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3299 -msgid "C" -msgstr "C" +#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3100 +msgid "\"meego\"" +msgstr "\"meego\"" #. type: textblock -#: ../fish/guestfish-actions.pod:2249 ../src/guestfs-actions.pod:3301 -msgid "" -"The display name of the application, sometimes localized to the install " -"language of the guest operating system." +#: ../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 "" #. type: textblock -#: ../fish/guestfish-actions.pod:2252 ../src/guestfs-actions.pod:3304 -msgid "" -"If unavailable this is returned as an empty string C<\"\">. Callers needing " -"to display something can use C instead." +#: ../fish/guestfish-actions.pod:1970 ../src/guestfs-actions.pod:3106 +msgid "OpenSUSE." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2255 ../src/guestfs-actions.pod:3307 -msgid "C" -msgstr "C" +#: ../fish/guestfish-actions.pod:1972 ../src/guestfs-actions.pod:3108 +msgid "\"pardus\"" +msgstr "\"pardus\"" #. 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>." -msgstr "" +#: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3110 +msgid "Pardus." +msgstr "Pardus." #. type: =item -#: ../fish/guestfish-actions.pod:2260 ../src/guestfs-actions.pod:3312 -msgid "C" -msgstr "C" +#: ../fish/guestfish-actions.pod:1976 ../src/guestfs-actions.pod:3112 +msgid "\"redhat-based\"" +msgstr "\"redhat-based\"" #. type: textblock -#: ../fish/guestfish-actions.pod:2262 ../src/guestfs-actions.pod:3314 -msgid "" -"The version string of the application or package. If unavailable this is " -"returned as an empty string C<\"\">." -msgstr "" +#: ../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:2265 ../src/guestfs-actions.pod:3317 -msgid "C" -msgstr "C" +#: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:3116 +msgid "\"rhel\"" +msgstr "\"rhel\"" #. 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<\"\">." -msgstr "" +#: ../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:2271 ../src/guestfs-actions.pod:3323 -msgid "C" -msgstr "C" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2273 ../src/guestfs-actions.pod:3325 -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 "" +#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3120 +msgid "\"scientificlinux\"" +msgstr "\"scientificlinux\"" #. type: textblock -#: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3330 -msgid "If unavailable this is returned as an empty string C<\"\">." -msgstr "" +#: ../fish/guestfish-actions.pod:1986 ../src/guestfs-actions.pod:3122 +msgid "Scientific Linux." +msgstr "Scientific Linux." #. type: =item -#: ../fish/guestfish-actions.pod:2280 ../src/guestfs-actions.pod:3332 -msgid "C" -msgstr "C" +#: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3124 +msgid "\"slackware\"" +msgstr "\"slackware\"" #. 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<\"\">." -msgstr "" +#: ../fish/guestfish-actions.pod:1990 ../src/guestfs-actions.pod:3126 +msgid "Slackware." +msgstr "Slackware." #. type: =item -#: ../fish/guestfish-actions.pod:2285 ../src/guestfs-actions.pod:3337 -msgid "C" -msgstr "C" +#: ../fish/guestfish-actions.pod:1992 ../src/guestfs-actions.pod:3128 +msgid "\"ttylinux\"" +msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2287 ../src/guestfs-actions.pod:3339 -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<\"\">." +#: ../fish/guestfish-actions.pod:1994 ../src/guestfs-actions.pod:3130 +msgid "ttylinux." msgstr "" #. type: =item -#: ../fish/guestfish-actions.pod:2291 ../src/guestfs-actions.pod:3343 -msgid "C" -msgstr "C" +#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3132 +msgid "\"ubuntu\"" +msgstr "\"ubuntu\"" #. 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<\"\">." -msgstr "" +#: ../fish/guestfish-actions.pod:1998 ../src/guestfs-actions.pod:3134 +msgid "Ubuntu." +msgstr "Ubuntu." #. type: =item -#: ../fish/guestfish-actions.pod:2296 ../src/guestfs-actions.pod:3348 -msgid "C" -msgstr "C" +#: ../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:2298 ../src/guestfs-actions.pod:3350 -msgid "" -"For packaging systems which support this, the name of the source package. " -"If unavailable this is returned as an empty string C<\"\">." -msgstr "" +#: ../fish/guestfish-actions.pod:2002 ../src/guestfs-actions.pod:3138 +msgid "The distro could not be determined." +msgstr "Дистрибутив, тип якого не вдалося визначити." #. type: =item -#: ../fish/guestfish-actions.pod:2301 ../src/guestfs-actions.pod:3353 -msgid "C" -msgstr "C" +#: ../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:2303 ../src/guestfs-actions.pod:3355 +#: ../fish/guestfish-actions.pod:2006 ../src/guestfs-actions.pod:3142 msgid "" -"A short (usually one line) description of the application or package. If " -"unavailable this is returned as an empty string C<\"\">." +"Windows does not have distributions. This string is returned if the OS type " +"is Windows." 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: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 "" -"A longer description of the application or package. If unavailable this is " -"returned as an empty string C<\"\">." +"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:2315 -msgid "inspect-os" -msgstr "inspect-os" +#: ../fish/guestfish-actions.pod:2016 +msgid "inspect-get-drive-mappings" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2317 +#: ../fish/guestfish-actions.pod:2018 #, no-wrap msgid "" -" inspect-os\n" +" inspect-get-drive-mappings root\n" "\n" msgstr "" -" inspect-os\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2319 ../src/guestfs-actions.pod:3378 +#: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3163 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 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: textblock -#: ../fish/guestfish-actions.pod:2323 ../src/guestfs-actions.pod:3382 -msgid "The list returned is empty if no operating systems were found." +#. type: verbatim +#: ../fish/guestfish-actions.pod:2026 ../src/guestfs-actions.pod:3169 +#, no-wrap +msgid "" +" C => /dev/vda2\n" +" E => /dev/vdb1\n" +" F => /dev/vdc1\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2325 ../src/guestfs-actions.pod:3384 +#: ../fish/guestfish-actions.pod:2030 ../src/guestfs-actions.pod:3173 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." +"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:2332 +#: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3177 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." +"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:2337 +#: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3182 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." +"For Windows guests, currently only hard drive mappings are returned. " +"Removable disks (eg. DVD-ROMs) are ignored." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3402 +#: ../fish/guestfish-actions.pod:2042 ../src/guestfs-actions.pod:3185 msgid "" -"This function cannot decrypt encrypted disks. The caller must do that first " -"(supplying the necessary keys) if the disk is encrypted." +"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:2349 ../fish/guestfish-actions.pod:2547 -#: ../fish/guestfish-actions.pod:2606 -msgid "See also L." -msgstr "Див. також L." +#: ../fish/guestfish-actions.pod:2045 +msgid "" +"Please read L for more details. See also L, L." +msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2351 -msgid "is-blockdev" -msgstr "is-blockdev" +#: ../fish/guestfish-actions.pod:2049 +msgid "inspect-get-filesystems" +msgstr "inspect-get-filesystems" #. type: verbatim -#: ../fish/guestfish-actions.pod:2353 +#: ../fish/guestfish-actions.pod:2051 #, no-wrap msgid "" -" is-blockdev path\n" +" inspect-get-filesystems root\n" "\n" msgstr "" -" is-blockdev шлях\n" +" inspect-get-filesystems корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3422 +#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3206 msgid "" -"This returns C if and only if there is a block device with the given " -"C name." +"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: 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" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2362 -#, no-wrap +#: ../fish/guestfish-actions.pod:2058 ../src/guestfs-actions.pod:3211 msgid "" -" is-busy\n" -"\n" +"In the case of a multi-boot virtual machine, it is possible for a filesystem " +"to be shared between operating systems." msgstr "" -" is-busy\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2364 ../src/guestfs-actions.pod:3436 +#: ../fish/guestfish-actions.pod:2061 msgid "" -"This returns true iff this handle is busy processing a command (in the " -"C state)." +"Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2369 -msgid "is-chardev" -msgstr "is-chardev" +#: ../fish/guestfish-actions.pod:2064 +msgid "inspect-get-format" +msgstr "inspect-get-format" #. type: verbatim -#: ../fish/guestfish-actions.pod:2371 +#: ../fish/guestfish-actions.pod:2066 #, no-wrap msgid "" -" is-chardev path\n" +" inspect-get-format root\n" "\n" msgstr "" -" is-chardev шлях\n" +" inspect-get-format корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2373 ../src/guestfs-actions.pod:3451 +#: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3229 msgid "" -"This returns C if and only if there is a character device with the " -"given C name." +"This returns the format of the inspected operating system. You can use it " +"to detect install images, live CDs and similar." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2378 -msgid "is-config" -msgstr "is-config" +#. type: textblock +#: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3232 +msgid "Currently defined formats are:" +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2380 -#, no-wrap -msgid "" -" is-config\n" -"\n" +#. 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 "" -" is-config\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2382 ../src/guestfs-actions.pod:3465 +#: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3242 msgid "" -"This returns true iff this handle is being configured (in the C " -"state)." +"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:2086 ../src/guestfs-actions.pod:3247 +msgid "The format of this disk image is not known." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2387 -msgid "is-dir" -msgstr "is-dir" +#: ../fish/guestfish-actions.pod:2095 +msgid "inspect-get-hostname" +msgstr "inspect-get-hostname" #. type: verbatim -#: ../fish/guestfish-actions.pod:2389 +#: ../fish/guestfish-actions.pod:2097 #, no-wrap msgid "" -" is-dir path\n" +" inspect-get-hostname root\n" "\n" msgstr "" -" is-dir шлях\n" +" inspect-get-hostname корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2391 ../src/guestfs-actions.pod:3480 +#: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3267 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 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:2102 ../src/guestfs-actions.pod:3270 +msgid "" +"If the hostname could not be determined, then the string C is " +"returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2397 -msgid "is-fifo" -msgstr "is-fifo" +#: ../fish/guestfish-actions.pod:2107 +msgid "inspect-get-icon" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2399 +#: ../fish/guestfish-actions.pod:2109 #, no-wrap msgid "" -" is-fifo path\n" +" inspect-get-icon root [favicon:..] [highquality:..]\n" "\n" msgstr "" -" is-fifo шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2401 ../src/guestfs-actions.pod:3496 +#: ../fish/guestfish-actions.pod:2111 ../src/guestfs-actions.pod:3296 msgid "" -"This returns C if and only if there is a FIFO (named pipe) with the " -"given C name." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2406 -msgid "is-file" -msgstr "is-file" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2408 -#, no-wrap -msgid "" -" is-file path\n" -"\n" +"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 "" -" is-file шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2410 ../src/guestfs-actions.pod:3511 +#: ../fish/guestfish-actions.pod:2115 ../src/guestfs-actions.pod:3300 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." +"If it was not possible to get an icon this function returns a zero-length " +"(non-NULL) buffer. I." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2416 -msgid "is-launching" -msgstr "is-launching" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2418 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2118 ../src/guestfs-actions.pod:3303 msgid "" -" is-launching\n" -"\n" +"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 "" -" is-launching\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2420 ../src/guestfs-actions.pod:3526 +#: ../fish/guestfish-actions.pod:2124 ../src/guestfs-actions.pod:3309 msgid "" -"This returns true iff this handle is launching the subprocess (in the " -"C state)." +"If finding the favicon fails, then we look in other places in the guest for " +"a suitable icon." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2425 -msgid "is-lv" -msgstr "is-lv" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2427 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2127 ../src/guestfs-actions.pod:3312 msgid "" -" is-lv device\n" -"\n" +"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 "" -" is-lv пристрій\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2429 ../src/guestfs-actions.pod:3541 +#: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3323 msgid "" -"This command tests whether C is a logical volume, and returns true " -"iff this is the case." +"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:2432 -msgid "is-ready" -msgstr "is-ready" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2434 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3329 msgid "" -" is-ready\n" -"\n" +"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 "" -" is-ready\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2436 ../src/guestfs-actions.pod:3553 +#: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3337 msgid "" -"This returns true iff this handle is ready to accept commands (in the " -"C state)." +"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 "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2441 -msgid "is-socket" -msgstr "is-socket" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2443 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2159 ../src/guestfs-actions.pod:3344 msgid "" -" is-socket path\n" -"\n" +"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 "" -" is-socket шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3568 +#: ../fish/guestfish-actions.pod:2166 ../src/guestfs-actions.pod:3351 msgid "" -"This returns C if and only if there is a Unix domain socket with the " -"given C name." +"Operating system icons are usually trademarks. Seek legal advice before " +"using trademarks in applications." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2450 -msgid "is-symlink" -msgstr "is-symlink" +#: ../fish/guestfish-actions.pod:2173 +msgid "inspect-get-major-version" +msgstr "inspect-get-major-version" #. type: verbatim -#: ../fish/guestfish-actions.pod:2452 +#: ../fish/guestfish-actions.pod:2175 #, no-wrap msgid "" -" is-symlink path\n" +" inspect-get-major-version root\n" "\n" msgstr "" -" is-symlink шлях\n" +" inspect-get-major-version корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2454 ../src/guestfs-actions.pod:3583 +#: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3392 msgid "" -"This returns C if and only if there is a symbolic link with the given " -"C name." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2459 -msgid "is-zero" +"This returns the major version number of the inspected operating system." msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2461 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3395 msgid "" -" is-zero path\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: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: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:2466 -msgid "is-zero-device" -msgstr "" +#: ../fish/guestfish-actions.pod:2191 +msgid "inspect-get-minor-version" +msgstr "inspect-get-minor-version" #. type: verbatim -#: ../fish/guestfish-actions.pod:2468 +#: ../fish/guestfish-actions.pod:2193 #, no-wrap msgid "" -" is-zero-device device\n" +" inspect-get-minor-version root\n" "\n" msgstr "" +" inspect-get-minor-version корінь\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:2195 ../src/guestfs-actions.pod:3416 +msgid "" +"This returns the minor version number of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2472 ../src/guestfs-actions.pod:3613 -msgid "Note that for large devices this can take a long time to run." +#: ../fish/guestfish-actions.pod:2200 +msgid "" +"Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2474 -msgid "kill-subprocess" -msgstr "kill-subprocess" +#: ../fish/guestfish-actions.pod:2203 +msgid "inspect-get-mountpoints" +msgstr "inspect-get-mountpoints" #. type: verbatim -#: ../fish/guestfish-actions.pod:2476 +#: ../fish/guestfish-actions.pod:2205 #, no-wrap msgid "" -" kill-subprocess\n" +" inspect-get-mountpoints root\n" "\n" msgstr "" -" kill-subprocess\n" +" inspect-get-mountpoints корінь\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:2207 ../src/guestfs-actions.pod:3434 +msgid "" +"This returns a hash of where we think the filesystems associated with this " +"operating system should be mounted. Callers should note that this is at " +"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: =head2 -#: ../fish/guestfish-actions.pod:2480 -msgid "launch" -msgstr "launch" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2482 -msgid "run" +#. type: textblock +#: ../fish/guestfish-actions.pod:2216 ../src/guestfs-actions.pod:3443 +msgid "" +"Each element in the returned hashtable has a key which is the path of the " +"mountpoint (eg. C) and a value which is the filesystem that would be " +"mounted there (eg. C)." msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2484 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3448 msgid "" -" launch\n" -"\n" +"Non-mounted devices such as swap devices are I returned in this list." msgstr "" -" launch\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2486 ../src/guestfs-actions.pod:3635 +#: ../fish/guestfish-actions.pod:2224 msgid "" -"Internally libguestfs is implemented by running a virtual machine using " -"L." +"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 "" #. type: textblock -#: ../fish/guestfish-actions.pod:2489 ../src/guestfs-actions.pod:3638 +#: ../fish/guestfish-actions.pod:2230 msgid "" -"You should call this after configuring the handle (eg. adding drives) but " -"before performing any actions." +"Please read L for more details. See also L." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2492 -msgid "lchown" -msgstr "lchown" +#: ../fish/guestfish-actions.pod:2233 +msgid "inspect-get-package-format" +msgstr "inspect-get-package-format" #. type: verbatim -#: ../fish/guestfish-actions.pod:2494 +#: ../fish/guestfish-actions.pod:2235 #, no-wrap msgid "" -" lchown owner group path\n" +" inspect-get-package-format root\n" "\n" msgstr "" -" lchown власник група шлях\n" +" inspect-get-package-format корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2496 +#: ../fish/guestfish-actions.pod:2237 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." +"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: =head2 -#: ../fish/guestfish-actions.pod:2504 -msgid "lgetxattr" -msgstr "lgetxattr" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2506 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2243 ../src/guestfs-actions.pod:3480 msgid "" -" lgetxattr path name\n" -"\n" +"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 "" -" lgetxattr шлях назва\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2508 ../src/guestfs-actions.pod:3678 +#: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3484 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." +"Possible strings include: C, C, C, C, C, " +"C. Future versions of libguestfs may return other strings." 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:2253 +msgid "inspect-get-package-management" +msgstr "inspect-get-package-management" #. type: verbatim -#: ../fish/guestfish-actions.pod:2526 +#: ../fish/guestfish-actions.pod:2255 #, no-wrap msgid "" -" lgetxattrs path\n" +" inspect-get-package-management root\n" "\n" msgstr "" -" lgetxattrs шлях\n" +" inspect-get-package-management корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2528 +#: ../fish/guestfish-actions.pod:2257 msgid "" -"This is the same as L, but if C is a symbolic link, then " -"it returns the extended attributes of the link itself." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2532 -msgid "list-9p" +"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: verbatim -#: ../fish/guestfish-actions.pod:2534 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3507 msgid "" -" list-9p\n" -"\n" +"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:2536 ../src/guestfs-actions.pod:3721 +#: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3511 msgid "" -"List all 9p filesystems attached to the guest. A list of mount tags is " -"returned." +"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:2539 -msgid "list-devices" -msgstr "list-devices" +#: ../fish/guestfish-actions.pod:2274 +msgid "inspect-get-product-name" +msgstr "inspect-get-product-name" #. type: verbatim -#: ../fish/guestfish-actions.pod:2541 +#: ../fish/guestfish-actions.pod:2276 #, no-wrap msgid "" -" list-devices\n" +" inspect-get-product-name root\n" "\n" msgstr "" -" list-devices\n" +" inspect-get-product-name корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2543 ../src/guestfs-actions.pod:3735 -msgid "List all the block devices." +#: ../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:2545 ../src/guestfs-actions.pod:3737 -msgid "The full block device names are returned, eg. C." +#: ../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:2549 -msgid "list-dm-devices" +#: ../fish/guestfish-actions.pod:2288 +msgid "inspect-get-product-variant" msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2551 +#: ../fish/guestfish-actions.pod:2290 #, no-wrap msgid "" -" list-dm-devices\n" +" inspect-get-product-variant root\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:2292 ../src/guestfs-actions.pod:3550 +msgid "This returns the product variant of the inspected operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2555 +#: ../fish/guestfish-actions.pod:2295 ../src/guestfs-actions.pod:3553 msgid "" -"The returned list contains C devices, eg. ones created by a " -"previous call to L." +"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:2558 +#: ../fish/guestfish-actions.pod:2304 ../src/guestfs-actions.pod:3562 msgid "" -"Device mapper devices which correspond to logical volumes are I " -"returned in this list. Call L if you want to list logical volumes." +"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: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:2562 -msgid "list-filesystems" -msgstr "list-filesystems" +#: ../fish/guestfish-actions.pod:2315 +msgid "inspect-get-roots" +msgstr "inspect-get-roots" #. type: verbatim -#: ../fish/guestfish-actions.pod:2564 +#: ../fish/guestfish-actions.pod:2317 #, no-wrap msgid "" -" list-filesystems\n" +" inspect-get-roots\n" "\n" msgstr "" -" list-filesystems\n" +" inspect-get-roots\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2566 ../src/guestfs-actions.pod:3772 +#: ../fish/guestfish-actions.pod:2319 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 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:2570 ../src/guestfs-actions.pod:3776 +#: ../fish/guestfish-actions.pod:2323 msgid "" -"The return value is a hash, where the keys are the devices containing " -"filesystems, and the values are the filesystem types. For example:" +"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:2328 +msgid "inspect-get-type" +msgstr "inspect-get-type" + #. type: verbatim -#: ../fish/guestfish-actions.pod:2574 ../src/guestfs-actions.pod:3780 +#: ../fish/guestfish-actions.pod:2330 #, 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" +" inspect-get-type root\n" "\n" msgstr "" +" inspect-get-type корінь\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2579 ../src/guestfs-actions.pod:3785 +#: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3604 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 returns the type of the inspected operating system. Currently defined " +"types are:" msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:2337 ../src/guestfs-actions.pod:3609 +msgid "\"linux\"" +msgstr "\"linux\"" + #. type: textblock -#: ../fish/guestfish-actions.pod:2583 -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." +#: ../fish/guestfish-actions.pod:2339 ../src/guestfs-actions.pod:3611 +msgid "Any Linux-based operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2587 -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)." +#: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3615 +msgid "Any Microsoft Windows operating system." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2595 -msgid "list-partitions" -msgstr "list-partitions" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2597 -#, no-wrap -msgid "" -" list-partitions\n" -"\n" -msgstr "" -" list-partitions\n" -"\n" +#. type: =item +#: ../fish/guestfish-actions.pod:2345 ../src/guestfs-actions.pod:3617 +msgid "\"freebsd\"" +msgstr "\"freebsd\"" #. 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:2347 ../src/guestfs-actions.pod:3619 +msgid "FreeBSD." +msgstr "FreeBSD." + +#. type: =item +#: ../fish/guestfish-actions.pod:2349 ../src/guestfs-actions.pod:3621 +msgid "\"netbsd\"" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2601 ../src/guestfs-actions.pod:3816 -msgid "The full partition device names are returned, eg. C" +#: ../fish/guestfish-actions.pod:2351 ../src/guestfs-actions.pod:3623 +msgid "NetBSD." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2603 -msgid "" -"This does not return logical volumes. For that you will need to call L." +#: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3627 +msgid "The operating system type could not be determined." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2608 -msgid "ll" -msgstr "ll" +#: ../fish/guestfish-actions.pod:2364 +msgid "inspect-get-windows-current-control-set" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2610 +#: ../fish/guestfish-actions.pod:2366 #, no-wrap msgid "" -" ll directory\n" +" inspect-get-windows-current-control-set root\n" "\n" msgstr "" -" ll каталог\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2612 ../src/guestfs-actions.pod:3835 +#: ../fish/guestfish-actions.pod:2368 ../src/guestfs-actions.pod:3647 msgid "" -"List the files in C (relative to the root directory, there is no " -"cwd) in the format of 'ls -la'." +"This returns the Windows CurrentControlSet of the inspected guest. The " +"CurrentControlSet is a registry key name such as C." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2615 ../src/guestfs-actions.pod:3838 +#: ../fish/guestfish-actions.pod:2371 ../src/guestfs-actions.pod:3650 msgid "" -"This command is mostly useful for interactive sessions. It is I " -"intended that you try to parse the output string." +"This call assumes that the guest is Windows and that the Registry could be " +"examined by inspection. If this is not the case then an error is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2618 -msgid "ln" -msgstr "ln" +#: ../fish/guestfish-actions.pod:2377 +msgid "inspect-get-windows-systemroot" +msgstr "inspect-get-windows-systemroot" #. type: verbatim -#: ../fish/guestfish-actions.pod:2620 +#: ../fish/guestfish-actions.pod:2379 #, no-wrap msgid "" -" ln target linkname\n" +" inspect-get-windows-systemroot root\n" "\n" msgstr "" -" ln призначення назва_посилання\n" +" inspect-get-windows-systemroot корінь\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." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2624 -msgid "ln-f" -msgstr "ln-f" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2626 -#, no-wrap +#: ../fish/guestfish-actions.pod:2381 ../src/guestfs-actions.pod:3667 msgid "" -" ln-f target linkname\n" -"\n" +"This returns the Windows systemroot of the inspected guest. The systemroot " +"is a directory path such as C." msgstr "" -" ln-f призначення назва_посилання\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2628 ../src/guestfs-actions.pod:3866 +#: ../fish/guestfish-actions.pod:2384 ../src/guestfs-actions.pod:3670 msgid "" -"This command creates a hard link using the C command. The I<-f> " -"option removes the link (C) if it exists already." +"This call assumes that the guest is Windows and that the systemroot could be " +"determined by inspection. If this is not the case then an error is returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2631 -msgid "ln-s" -msgstr "ln-s" +#: ../fish/guestfish-actions.pod:2390 +msgid "inspect-is-live" +msgstr "inspect-is-live" #. type: verbatim -#: ../fish/guestfish-actions.pod:2633 +#: ../fish/guestfish-actions.pod:2392 #, no-wrap msgid "" -" ln-s target linkname\n" +" inspect-is-live root\n" "\n" msgstr "" -" ln-s призначення назва_посилання\n" +" inspect-is-live корінь\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:2394 +msgid "" +"If L returns C (this is an install disk), " +"then this returns true if a live image was detected on the disk." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2637 -msgid "ln-sf" -msgstr "ln-sf" +#: ../fish/guestfish-actions.pod:2400 +msgid "inspect-is-multipart" +msgstr "inspect-is-multipart" #. type: verbatim -#: ../fish/guestfish-actions.pod:2639 +#: ../fish/guestfish-actions.pod:2402 #, no-wrap msgid "" -" ln-sf target linkname\n" +" inspect-is-multipart root\n" "\n" msgstr "" -" ln-sf призначення назва_посилання\n" +" inspect-is-multipart корінь\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2641 ../src/guestfs-actions.pod:3893 +#: ../fish/guestfish-actions.pod:2404 msgid "" -"This command creates a symbolic link using the C command, The I<-f> " -"option removes the link (C) if it exists already." +"If L returns C (this is an install disk), " +"then this returns true if the disk is part of a set." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2644 -msgid "lremovexattr" -msgstr "lremovexattr" +#: ../fish/guestfish-actions.pod:2410 +msgid "inspect-is-netinst" +msgstr "inspect-is-netinst" #. type: verbatim -#: ../fish/guestfish-actions.pod:2646 +#: ../fish/guestfish-actions.pod:2412 #, no-wrap msgid "" -" lremovexattr xattr path\n" +" inspect-is-netinst root\n" "\n" msgstr "" +" inspect-is-netinst корінь\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2648 +#: ../fish/guestfish-actions.pod:2414 msgid "" -"This is the same as L, but if C is a symbolic link, then " -"it removes an extended attribute of the link itself." +"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." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2652 -msgid "ls" -msgstr "ls" +#: ../fish/guestfish-actions.pod:2422 +msgid "inspect-list-applications" +msgstr "inspect-list-applications" #. type: verbatim -#: ../fish/guestfish-actions.pod:2654 +#: ../fish/guestfish-actions.pod:2424 #, no-wrap msgid "" -" ls directory\n" +" inspect-list-applications root\n" "\n" msgstr "" -" ls каталог\n" +" inspect-list-applications кореневий_каталог\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2656 ../src/guestfs-actions.pod:3921 -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." +#: ../fish/guestfish-actions.pod:2426 ../src/guestfs-actions.pod:3737 +msgid "Return the list of applications installed in the operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2660 +#: ../fish/guestfish-actions.pod:2428 msgid "" -"This command is mostly useful for interactive sessions. Programs should " -"probably use L instead." +"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." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2663 -msgid "lsetxattr" -msgstr "lsetxattr" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2665 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2438 ../src/guestfs-actions.pod:3749 msgid "" -" lsetxattr xattr val vallen path\n" -"\n" +"This returns an empty list if the inspection code was not able to determine " +"the list of applications." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod: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:2441 ../src/guestfs-actions.pod:3752 +msgid "The application structure contains the following fields:" msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2671 -msgid "lstat" -msgstr "lstat" +#. type: =item +#: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3756 +msgid "C" +msgstr "C" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2673 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2447 ../src/guestfs-actions.pod:3758 msgid "" -" lstat path\n" -"\n" +"The name of the application. For Red Hat-derived and Debian-derived Linux " +"guests, this is the package name." msgstr "" -" lstat шлях\n" -"\n" + +#. type: =item +#: ../fish/guestfish-actions.pod:2450 ../src/guestfs-actions.pod:3761 +msgid "C" +msgstr "C" #. 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:2452 ../src/guestfs-actions.pod:3763 +msgid "" +"The display name of the application, sometimes localized to the install " +"language of the guest operating system." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2677 +#: ../fish/guestfish-actions.pod:2455 ../src/guestfs-actions.pod:3766 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 unavailable this is returned as an empty string C<\"\">. Callers needing " +"to display something can use C instead." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3769 +msgid "C" +msgstr "C" + #. 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:2460 ../src/guestfs-actions.pod:3771 +msgid "" +"For package managers which use epochs, this contains the epoch of the " +"package (an integer). If unavailable, this is returned as C<0>." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2683 -msgid "lstatlist" -msgstr "lstatlist" +#. type: =item +#: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3774 +msgid "C" +msgstr "C" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2685 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2465 ../src/guestfs-actions.pod:3776 msgid "" -" lstatlist path 'names ...'\n" -"\n" +"The version string of the application or package. If unavailable this is " +"returned as an empty string C<\"\">." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:2468 ../src/guestfs-actions.pod:3779 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:2687 +#: ../fish/guestfish-actions.pod:2470 ../src/guestfs-actions.pod:3781 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." +"The release string of the application or package, for package managers that " +"use this. If unavailable this is returned as an empty string C<\"\">." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:2474 ../src/guestfs-actions.pod:3785 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:2691 ../src/guestfs-actions.pod:3982 +#: ../fish/guestfish-actions.pod:2476 ../src/guestfs-actions.pod:3787 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>." +"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:2481 ../src/guestfs-actions.pod:3792 +msgid "If unavailable this is returned as an empty string C<\"\">." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:2483 ../src/guestfs-actions.pod:3794 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:2696 +#: ../fish/guestfish-actions.pod:2485 ../src/guestfs-actions.pod:3796 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." +"The install path translated into a libguestfs path. If unavailable this is " +"returned as an empty string C<\"\">." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2704 -msgid "luks-add-key" -msgstr "luks-add-key" +#. type: =item +#: ../fish/guestfish-actions.pod:2488 ../src/guestfs-actions.pod:3799 +msgid "C" +msgstr "C" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2706 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2490 ../src/guestfs-actions.pod:3801 msgid "" -" luks-add-key device keyslot\n" -"\n" +"The name of the publisher of the application, for package managers that use " +"this. If unavailable this is returned as an empty string C<\"\">." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:2494 ../src/guestfs-actions.pod:3805 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:2708 ../src/guestfs-actions.pod:4010 +#: ../fish/guestfish-actions.pod:2496 ../src/guestfs-actions.pod:3807 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." +"The URL (eg. upstream URL) of the application. If unavailable this is " +"returned as an empty string C<\"\">." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:2499 ../src/guestfs-actions.pod:3810 +msgid "C" +msgstr "C" + #. type: textblock -#: ../fish/guestfish-actions.pod:2713 +#: ../fish/guestfish-actions.pod:2501 ../src/guestfs-actions.pod:3812 msgid "" -"Note that if C already contains a key, then this command will " -"fail. You have to use L first to remove that key." +"For packaging systems which support this, the name of the source package. " +"If unavailable this is returned as an empty string C<\"\">." msgstr "" +#. type: =item +#: ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:3815 +msgid "C" +msgstr "C" + #. 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 +#: ../fish/guestfish-actions.pod:2506 ../src/guestfs-actions.pod:3817 msgid "" -"This command has one or more key or passphrase parameters. Guestfish will " -"prompt for these separately." +"A short (usually one line) description of the application or package. If " +"unavailable this is returned as an empty string C<\"\">." +msgstr "" + +#. type: =item +#: ../fish/guestfish-actions.pod:2509 ../src/guestfs-actions.pod:3820 +msgid "C" +msgstr "C" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2511 ../src/guestfs-actions.pod:3822 +msgid "" +"A longer description of the application or package. If unavailable this is " +"returned as an empty string C<\"\">." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2720 -msgid "luks-close" -msgstr "luks-close" +#: ../fish/guestfish-actions.pod:2518 +msgid "inspect-os" +msgstr "inspect-os" #. type: verbatim -#: ../fish/guestfish-actions.pod:2722 +#: ../fish/guestfish-actions.pod:2520 #, no-wrap msgid "" -" luks-close device\n" +" inspect-os\n" "\n" msgstr "" -" luks-close пристрій\n" +" inspect-os\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2724 +#: ../fish/guestfish-actions.pod:2522 ../src/guestfs-actions.pod:3840 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." +"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." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2730 -msgid "luks-format" -msgstr "luks-format" +#. type: textblock +#: ../fish/guestfish-actions.pod:2526 ../src/guestfs-actions.pod:3844 +msgid "The list returned is empty if no operating systems were found." +msgstr "" -#. type: verbatim -#: ../fish/guestfish-actions.pod:2732 -#, no-wrap +#. type: textblock +#: ../fish/guestfish-actions.pod:2528 ../src/guestfs-actions.pod:3846 msgid "" -" luks-format device keyslot\n" -"\n" +"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." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2734 ../src/guestfs-actions.pod:4051 +#: ../fish/guestfish-actions.pod:2535 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)." +"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." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2540 +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." 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 +#: ../fish/guestfish-actions.pod:2546 ../src/guestfs-actions.pod:3864 msgid "" -"B." +"This function cannot decrypt encrypted disks. The caller must do that first " +"(supplying the necessary keys) if the disk is encrypted." msgstr "" +#. type: textblock +#: ../fish/guestfish-actions.pod:2552 ../fish/guestfish-actions.pod:2750 +#: ../fish/guestfish-actions.pod:2809 +msgid "See also L." +msgstr "Див. також L." + #. type: =head2 -#: ../fish/guestfish-actions.pod:2745 -msgid "luks-format-cipher" -msgstr "luks-format-cipher" +#: ../fish/guestfish-actions.pod:2554 +msgid "is-blockdev" +msgstr "is-blockdev" #. type: verbatim -#: ../fish/guestfish-actions.pod:2747 +#: ../fish/guestfish-actions.pod:2556 #, no-wrap msgid "" -" luks-format-cipher device keyslot cipher\n" +" is-blockdev path\n" "\n" msgstr "" +" is-blockdev шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2749 +#: ../fish/guestfish-actions.pod:2558 ../src/guestfs-actions.pod:3884 msgid "" -"This command is the same as L but it also allows you to set " -"the C used." +"This returns C if and only if there is a block device with the given " +"C name." msgstr "" +#. type: textblock +#: ../fish/guestfish-actions.pod:2561 ../fish/guestfish-actions.pod:2579 +#: ../fish/guestfish-actions.pod:2598 ../fish/guestfish-actions.pod:2607 +#: ../fish/guestfish-actions.pod:2617 ../fish/guestfish-actions.pod:2651 +#: ../fish/guestfish-actions.pod:2660 +msgid "See also L." +msgstr "Див. також L." + #. type: =head2 -#: ../fish/guestfish-actions.pod:2758 -msgid "luks-kill-slot" -msgstr "luks-kill-slot" +#: ../fish/guestfish-actions.pod:2563 +msgid "is-busy" +msgstr "is-busy" #. type: verbatim -#: ../fish/guestfish-actions.pod:2760 +#: ../fish/guestfish-actions.pod:2565 #, no-wrap msgid "" -" luks-kill-slot device keyslot\n" +" is-busy\n" "\n" msgstr "" +" is-busy\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2762 ../src/guestfs-actions.pod:4098 +#: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3898 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 returns true iff this handle is busy processing a command (in the " +"C state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2769 -msgid "luks-open" -msgstr "luks-open" +#: ../fish/guestfish-actions.pod:2572 +msgid "is-chardev" +msgstr "is-chardev" #. type: verbatim -#: ../fish/guestfish-actions.pod:2771 +#: ../fish/guestfish-actions.pod:2574 #, no-wrap msgid "" -" luks-open device mapname\n" +" is-chardev path\n" "\n" msgstr "" +" is-chardev шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4118 +#: ../fish/guestfish-actions.pod:2576 ../src/guestfs-actions.pod:3913 msgid "" -"This command opens a block device which has been encrypted according to the " -"Linux Unified Key Setup (LUKS) standard." +"This returns C if and only if there is a character device with the " +"given C name." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2776 ../src/guestfs-actions.pod:4121 -msgid "C is the encrypted block device or partition." -msgstr "" +#. type: =head2 +#: ../fish/guestfish-actions.pod:2581 +msgid "is-config" +msgstr "is-config" -#. type: textblock -#: ../fish/guestfish-actions.pod:2778 ../src/guestfs-actions.pod:4123 +#. type: verbatim +#: ../fish/guestfish-actions.pod:2583 +#, no-wrap msgid "" -"The caller must supply one of the keys associated with the LUKS block " -"device, in the C parameter." +" is-config\n" +"\n" msgstr "" +" is-config\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2781 ../src/guestfs-actions.pod:4126 +#: ../fish/guestfish-actions.pod:2585 ../src/guestfs-actions.pod:3927 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." +"This returns true iff this handle is being configured (in the C " +"state)." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2785 +#. type: =head2 +#: ../fish/guestfish-actions.pod:2590 +msgid "is-dir" +msgstr "is-dir" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:2592 +#, no-wrap msgid "" -"If this block device contains LVM volume groups, then calling L " -"followed by L will make them visible." +" is-dir path\n" +"\n" msgstr "" +" is-dir шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2789 -msgid "Use L to list all device mapper devices." +#: ../fish/guestfish-actions.pod:2594 ../src/guestfs-actions.pod:3942 +msgid "" +"This returns C if and only if there is a directory with the given " +"C name. Note that it returns false for other objects like files." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2795 -msgid "luks-open-ro" -msgstr "luks-open-ro" +#: ../fish/guestfish-actions.pod:2600 +msgid "is-fifo" +msgstr "is-fifo" #. type: verbatim -#: ../fish/guestfish-actions.pod:2797 +#: ../fish/guestfish-actions.pod:2602 #, no-wrap msgid "" -" luks-open-ro device mapname\n" +" is-fifo path\n" "\n" msgstr "" +" is-fifo шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2799 +#: ../fish/guestfish-actions.pod:2604 ../src/guestfs-actions.pod:3958 msgid "" -"This is the same as L except that a read-only mapping is created." +"This returns C if and only if there is a FIFO (named pipe) with the " +"given C name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2805 -msgid "lvcreate" -msgstr "lvcreate" +#: ../fish/guestfish-actions.pod:2609 +msgid "is-file" +msgstr "is-file" #. type: verbatim -#: ../fish/guestfish-actions.pod:2807 +#: ../fish/guestfish-actions.pod:2611 #, no-wrap msgid "" -" lvcreate logvol volgroup mbytes\n" +" is-file path\n" "\n" msgstr "" +" is-file шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2809 ../src/guestfs-actions.pod:4172 +#: ../fish/guestfish-actions.pod:2613 ../src/guestfs-actions.pod:3973 msgid "" -"This creates an LVM logical volume called C on the volume group " -"C, with C megabytes." +"This returns C if and only if there is a regular file with the given " +"C name. Note that it returns false for other objects like directories." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2812 -msgid "lvm-canonical-lv-name" -msgstr "lvm-canonical-lv-name" +#: ../fish/guestfish-actions.pod:2619 +msgid "is-launching" +msgstr "is-launching" #. type: verbatim -#: ../fish/guestfish-actions.pod:2814 +#: ../fish/guestfish-actions.pod:2621 #, no-wrap msgid "" -" lvm-canonical-lv-name lvname\n" +" is-launching\n" "\n" msgstr "" +" is-launching\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2816 ../src/guestfs-actions.pod:4185 +#: ../fish/guestfish-actions.pod:2623 ../src/guestfs-actions.pod:3988 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 true iff this handle is launching the subprocess (in the " +"C state)." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2820 ../src/guestfs-actions.pod:4189 +#. type: =head2 +#: ../fish/guestfish-actions.pod:2628 +msgid "is-lv" +msgstr "is-lv" + +#. type: verbatim +#: ../fish/guestfish-actions.pod:2630 +#, no-wrap msgid "" -"This command returns an error if the C parameter does not refer to a " -"logical volume." +" is-lv device\n" +"\n" msgstr "" +" is-lv пристрій\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2823 -msgid "See also L." -msgstr "Див. також L." +#: ../fish/guestfish-actions.pod:2632 ../src/guestfs-actions.pod:4003 +msgid "" +"This command tests whether C is a logical volume, and returns true " +"iff this is the case." +msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2825 -msgid "lvm-clear-filter" -msgstr "lvm-clear-filter" +#: ../fish/guestfish-actions.pod:2635 +msgid "is-ready" +msgstr "is-ready" #. type: verbatim -#: ../fish/guestfish-actions.pod:2827 +#: ../fish/guestfish-actions.pod:2637 #, no-wrap msgid "" -" lvm-clear-filter\n" +" is-ready\n" "\n" msgstr "" -" lvm-clear-filter\n" +" is-ready\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2829 -msgid "" -"This undoes the effect of L. LVM will be able to see every " -"block device." -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:2639 ../src/guestfs-actions.pod:4015 msgid "" -"This command also clears the LVM cache and performs a volume group scan." +"This returns true iff this handle is ready to accept commands (in the " +"C state)." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2835 -msgid "lvm-remove-all" -msgstr "lvm-remove-all" +#: ../fish/guestfish-actions.pod:2644 +msgid "is-socket" +msgstr "is-socket" #. type: verbatim -#: ../fish/guestfish-actions.pod:2837 +#: ../fish/guestfish-actions.pod:2646 #, no-wrap msgid "" -" lvm-remove-all\n" +" is-socket path\n" "\n" msgstr "" -" lvm-remove-all\n" +" is-socket шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2839 ../src/guestfs-actions.pod:4219 +#: ../fish/guestfish-actions.pod:2648 ../src/guestfs-actions.pod:4030 msgid "" -"This command removes all LVM logical volumes, volume groups and physical " -"volumes." +"This returns C if and only if there is a Unix domain socket with the " +"given C name." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2845 -msgid "lvm-set-filter" -msgstr "lvm-set-filter" +#: ../fish/guestfish-actions.pod:2653 +msgid "is-symlink" +msgstr "is-symlink" #. type: verbatim -#: ../fish/guestfish-actions.pod:2847 +#: ../fish/guestfish-actions.pod:2655 #, no-wrap msgid "" -" lvm-set-filter 'devices ...'\n" +" is-symlink path\n" "\n" msgstr "" -" lvm-set-filter 'пристрої...'\n" +" is-symlink шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2849 ../src/guestfs-actions.pod:4235 +#: ../fish/guestfish-actions.pod:2657 ../src/guestfs-actions.pod:4045 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." +"This returns C if and only if there is a symbolic link with the given " +"C name." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2853 ../src/guestfs-actions.pod:4239 -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." +#. type: =head2 +#: ../fish/guestfish-actions.pod:2662 +msgid "is-zero" msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2866 ../src/guestfs-actions.pod:4252 -msgid "You can filter whole block devices or individual partitions." +#. type: verbatim +#: ../fish/guestfish-actions.pod:2664 +#, no-wrap +msgid "" +" is-zero path\n" +"\n" msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2868 ../src/guestfs-actions.pod:4254 +#: ../fish/guestfish-actions.pod:2666 ../src/guestfs-actions.pod:4060 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." +"This returns true iff the file exists and the file is empty or it contains " +"all zero bytes." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2872 -msgid "lvremove" -msgstr "lvremove" +#: ../fish/guestfish-actions.pod:2669 +msgid "is-zero-device" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2874 +#: ../fish/guestfish-actions.pod:2671 #, no-wrap msgid "" -" lvremove device\n" +" is-zero-device device\n" "\n" msgstr "" -" lvremove пристрій\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2876 ../src/guestfs-actions.pod:4268 -msgid "" -"Remove an LVM logical volume C, where C is the path to the " -"LV, such as C." +#: ../fish/guestfish-actions.pod:2673 ../src/guestfs-actions.pod:4073 +msgid "This returns true iff the device exists and contains all zero bytes." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2879 ../src/guestfs-actions.pod:4271 -msgid "" -"You can also remove all LVs in a volume group by specifying the VG name, C." +#: ../fish/guestfish-actions.pod:2675 ../src/guestfs-actions.pod:4075 +msgid "Note that for large devices this can take a long time to run." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2882 -msgid "lvrename" -msgstr "lvrename" +#: ../fish/guestfish-actions.pod:2677 +msgid "kill-subprocess" +msgstr "kill-subprocess" #. type: verbatim -#: ../fish/guestfish-actions.pod:2884 +#: ../fish/guestfish-actions.pod:2679 #, no-wrap msgid "" -" lvrename logvol newlogvol\n" +" kill-subprocess\n" "\n" msgstr "" +" kill-subprocess\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:2681 ../src/guestfs-actions.pod:4086 +msgid "This kills the qemu subprocess. You should never need to call this." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2888 -msgid "lvresize" -msgstr "lvresize" +#: ../fish/guestfish-actions.pod:2683 +msgid "launch" +msgstr "launch" + +#. type: =head2 +#: ../fish/guestfish-actions.pod:2685 +msgid "run" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2890 +#: ../fish/guestfish-actions.pod:2687 #, no-wrap msgid "" -" lvresize device mbytes\n" +" launch\n" "\n" msgstr "" +" launch\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2892 ../src/guestfs-actions.pod:4298 +#: ../fish/guestfish-actions.pod:2689 ../src/guestfs-actions.pod:4097 msgid "" -"This resizes (expands or shrinks) an existing LVM logical volume to " -"C. When reducing, data in the reduced part is lost." +"Internally libguestfs is implemented by running a virtual machine using " +"L." +msgstr "" + +#. type: textblock +#: ../fish/guestfish-actions.pod:2692 ../src/guestfs-actions.pod:4100 +msgid "" +"You should call this after configuring the handle (eg. adding drives) but " +"before performing any actions." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2896 -msgid "lvresize-free" -msgstr "lvresize-free" +#: ../fish/guestfish-actions.pod:2695 +msgid "lchown" +msgstr "lchown" #. type: verbatim -#: ../fish/guestfish-actions.pod:2898 +#: ../fish/guestfish-actions.pod:2697 #, no-wrap msgid "" -" lvresize-free lv percent\n" +" lchown owner group path\n" "\n" msgstr "" +" lchown власник група шлях\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2900 ../src/guestfs-actions.pod:4313 +#: ../fish/guestfish-actions.pod:2699 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." +"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." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2906 -msgid "lvs" -msgstr "lvs" +#: ../fish/guestfish-actions.pod:2707 +msgid "lgetxattr" +msgstr "lgetxattr" #. type: verbatim -#: ../fish/guestfish-actions.pod:2908 +#: ../fish/guestfish-actions.pod:2709 #, no-wrap msgid "" -" lvs\n" +" lgetxattr path name\n" "\n" msgstr "" -" lvs\n" +" lgetxattr шлях назва\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2910 ../src/guestfs-actions.pod:4328 -msgid "" -"List all the logical volumes detected. This is the equivalent of the L command." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2913 ../src/guestfs-actions.pod:4331 +#: ../fish/guestfish-actions.pod:2711 ../src/guestfs-actions.pod:4140 msgid "" -"This returns a list of the logical volume device names (eg. C)." +"Get a single extended attribute from file C named C. If C " +"is a symlink, then this call returns an extended attribute from the symlink." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2916 -msgid "See also L, L." -msgstr "Див. також L, L." +#: ../fish/guestfish-actions.pod:2725 +msgid "See also: L, L, L." +msgstr "Див. також L, L, L." #. type: =head2 -#: ../fish/guestfish-actions.pod:2918 -msgid "lvs-full" -msgstr "lvs-full" +#: ../fish/guestfish-actions.pod:2727 +msgid "lgetxattrs" +msgstr "lgetxattrs" #. type: verbatim -#: ../fish/guestfish-actions.pod:2920 +#: ../fish/guestfish-actions.pod:2729 #, no-wrap msgid "" -" lvs-full\n" +" lgetxattrs path\n" "\n" msgstr "" -" lvs-full\n" +" lgetxattrs шлях\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2922 ../src/guestfs-actions.pod:4347 +#: ../fish/guestfish-actions.pod:2731 msgid "" -"List all the logical volumes detected. This is the equivalent of the L command. The \"full\" version includes all fields." +"This is the same as L, but if C is a symbolic link, then " +"it returns the extended attributes of the link itself." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2925 -msgid "lvuuid" -msgstr "lvuuid" +#: ../fish/guestfish-actions.pod:2735 +msgid "list-9p" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2927 +#: ../fish/guestfish-actions.pod:2737 #, no-wrap msgid "" -" lvuuid device\n" +" list-9p\n" "\n" msgstr "" -" lvuuid пристрій\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:2739 ../src/guestfs-actions.pod:4183 +msgid "" +"List all 9p filesystems attached to the guest. A list of mount tags is " +"returned." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2931 -msgid "lxattrlist" -msgstr "lxattrlist" +#: ../fish/guestfish-actions.pod:2742 +msgid "list-devices" +msgstr "list-devices" #. type: verbatim -#: ../fish/guestfish-actions.pod:2933 +#: ../fish/guestfish-actions.pod:2744 #, no-wrap msgid "" -" lxattrlist path 'names ...'\n" +" list-devices\n" "\n" msgstr "" +" list-devices\n" +"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2935 ../src/guestfs-actions.pod:4376 -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." -msgstr "" - -#. type: textblock -#: ../fish/guestfish-actions.pod:2939 ../src/guestfs-actions.pod:4380 -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." +#: ../fish/guestfish-actions.pod:2746 ../src/guestfs-actions.pod:4197 +msgid "List all the block devices." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2949 -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." +#: ../fish/guestfish-actions.pod:2748 ../src/guestfs-actions.pod:4199 +msgid "The full block device names are returned, eg. C." msgstr "" #. type: =head2 -#: ../fish/guestfish-actions.pod:2957 -msgid "mkdir" -msgstr "mkdir" +#: ../fish/guestfish-actions.pod:2752 +msgid "list-dm-devices" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2959 +#: ../fish/guestfish-actions.pod:2754 #, no-wrap msgid "" -" mkdir path\n" +" list-dm-devices\n" "\n" msgstr "" -" mkdir шлях\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2961 ../src/guestfs-actions.pod:4410 -msgid "Create a directory named C." -msgstr "" - -#. type: =head2 -#: ../fish/guestfish-actions.pod:2963 -msgid "mkdir-mode" -msgstr "mkdir-mode" - -#. type: verbatim -#: ../fish/guestfish-actions.pod:2965 -#, no-wrap -msgid "" -" mkdir-mode path mode\n" -"\n" +#: ../fish/guestfish-actions.pod:2756 ../src/guestfs-actions.pod:4214 +msgid "List all device mapper devices." msgstr "" -" mkdir-mode шлях режим\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2967 ../src/guestfs-actions.pod:4423 +#: ../fish/guestfish-actions.pod:2758 msgid "" -"This command creates a directory, setting the initial permissions of the " -"directory to C." +"The returned list contains C devices, eg. ones created by a " +"previous call to L." msgstr "" #. type: textblock -#: ../fish/guestfish-actions.pod:2970 ../src/guestfs-actions.pod:4426 +#: ../fish/guestfish-actions.pod:2761 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." +"Device mapper devices which correspond to logical volumes are I " +"returned in this list. Call L if you want to list logical volumes." msgstr "" -#. type: textblock -#: ../fish/guestfish-actions.pod:2974 -msgid "See also L, L" -msgstr "Див. також L, L" - #. type: =head2 -#: ../fish/guestfish-actions.pod:2976 -msgid "mkdir-p" -msgstr "mkdir-p" +#: ../fish/guestfish-actions.pod:2765 +msgid "list-filesystems" +msgstr "list-filesystems" #. type: verbatim -#: ../fish/guestfish-actions.pod:2978 +#: ../fish/guestfish-actions.pod:2767 #, no-wrap msgid "" -" mkdir-p path\n" +" list-filesystems\n" "\n" msgstr "" -" mkdir-p шлях\n" +" list-filesystems\n" "\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2980 ../src/guestfs-actions.pod:4442 +#: ../fish/guestfish-actions.pod:2769 ../src/guestfs-actions.pod:4234 msgid "" -"Create a directory named C, creating any parent directories as " -"necessary. This is like the C shell command." +"This inspection command looks for filesystems on partitions, block devices " +"and logical volumes, returning a list of devices containing filesystems and " +"their type." msgstr "" -#. type: =head2 -#: ../fish/guestfish-actions.pod:2983 -msgid "mkdtemp" -msgstr "mkdtemp" +#. type: textblock +#: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4238 +msgid "" +"The return value is a hash, where the keys are the devices containing " +"filesystems, and the values are the filesystem types. For example:" +msgstr "" #. type: verbatim -#: ../fish/guestfish-actions.pod:2985 +#: ../fish/guestfish-actions.pod:2777 ../src/guestfs-actions.pod:4242 #, no-wrap msgid "" -" mkdtemp template\n" +" \"/dev/sda1\" => \"ntfs\"\n" +" \"/dev/sda2\" => \"ext2\"\n" +" \"/dev/vg_guest/lv_root\" => \"ext4\"\n" +" \"/dev/vg_guest/lv_swap\" => \"swap\"\n" "\n" msgstr "" -" mkdtemp шаблон\n" -"\n" #. type: textblock -#: ../fish/guestfish-actions.pod:2987 ../src/guestfs-actions.pod:4455 +#: ../fish/guestfish-actions.pod:2782 ../src/guestfs-actions.pod:4247 msgid "" -"This command creates a temporary directory. The C