# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Red Hat Inc.
# This file is distributed under the same license as the libguestfs package.
#
# Translators:
# rjones <rjones@redhat.com>, 2011.
# <www.carrotsoft@gmail.com>, 2011.
msgid ""
msgstr ""
"Project-Id-Version: libguestfs\n"
"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
"POT-Creation-Date: 2011-10-27 16:05+0200\n"
"PO-Revision-Date: 2011-10-27 09:15+0000\n"
"Last-Translator: rjones <rjones@redhat.com>\n"
"Language-Team: Japanese <trans-ja@lists.fedoraproject.org>\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0\n"
#. type: =head1
#: ../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
#: ../tools/virt-win-reg.pl:35
msgid "NAME"
msgstr "名前"
#. type: textblock
#: ../align/virt-alignment-scan.pod:5
msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
msgstr ""
#. type: =head1
#: ../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
#: ../tools/virt-win-reg.pl:39
msgid "SYNOPSIS"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:9
#, no-wrap
msgid ""
" virt-alignment-scan [--options] -d domname\n"
"\n"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:11
#, no-wrap
msgid ""
" virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""
#. type: =head1
#: ../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
#: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
#: ../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
msgid "DESCRIPTION"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:15
msgid ""
"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
#: ../align/virt-alignment-scan.pod:21
msgid ""
"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
#: ../align/virt-alignment-scan.pod:25
msgid ""
"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<http://media.netapp.com/"
"documents/tr-3747.pdf>"
msgstr ""
#. type: =head1
#: ../align/virt-alignment-scan.pod:30
msgid "OUTPUT"
msgstr ""
#. type: textblock
#: ../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 ""
" $ virt-alignment-scan -a winxp.img\n"
" /dev/sda1 32256 512 bad (alignment < 4K)\n"
"\n"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:37
#, no-wrap
msgid ""
" $ 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
#: ../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
#: ../align/virt-alignment-scan.pod:45
#, no-wrap
msgid ""
" # 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: verbatim
#: ../align/virt-alignment-scan.pod:49
#, no-wrap
msgid ""
" $ 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
#: ../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: =item
#: ../align/virt-alignment-scan.pod:60
msgid "col 1"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:62
msgid ""
"the device and partition name (eg. C</dev/sda1> meaning the first partition "
"on the first block device)"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:65
msgid "col 2"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:67
msgid "the start of the partition in bytes"
msgstr ""
#. 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 ""
"C<ok> if the alignment is best for performance, or C<bad> if the alignment "
"can cause performance problems"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:78
msgid "cols 5+"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:80
msgid "optional free-text explanation."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:84
msgid ""
"The exit code from the program changes depending on whether poorly aligned "
"partitions were found. See L</EXIT STATUS> 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
#: ../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:92
#: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84
#: ../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
msgid "OPTIONS"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66
#: ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265
#: ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66
#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:160
#: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88
#: ../resize/virt-resize.pod: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 ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:68
#: ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267
#: ../clone/virt-sysprep.pod:48 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68
#: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90
#: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64
#: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113
#: ../tools/virt-win-reg.pl:106
msgid "Display brief help."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:70
#: ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269
#: ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70
#: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92
msgid "B<-a> file"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72
#: ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271
#: ../clone/virt-sysprep.pod:52 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72
#: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94
msgid "B<--add> file"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:101 ../clone/virt-sysprep.pod:54
msgid "Add I<file> which should be a disk image from a virtual machine."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:103 ../cat/virt-cat.pod:78
#: ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277
#: ../clone/virt-sysprep.pod:56 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78
#: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:102
#: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100
msgid ""
"The format of the disk image is auto-detected. To override this and force a "
"particular format use the I<--format=..> option."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:106 ../cat/virt-cat.pod:81
#: ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291
#: ../clone/virt-sysprep.pod:59 ../df/virt-df.pod:78
#: ../rescue/virt-rescue.pod:107
msgid "B<-c> URI"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83
#: ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293
#: ../clone/virt-sysprep.pod:61 ../df/virt-df.pod:80
#: ../rescue/virt-rescue.pod:109
msgid "B<--connect> URI"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85
#: ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295
#: ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99
#: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111
#: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82
#: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
msgid ""
"If using libvirt, connect to the given I<URI>. If omitted, then we connect "
"to the default libvirt hypervisor."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:88
#: ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298
#: ../clone/virt-sysprep.pod:66 ../df/virt-df.pod:85
#: ../rescue/virt-rescue.pod:114
msgid ""
"If you specify guest block devices directly (I<-a>), then libvirt is not "
"used at all."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:116 ../cat/virt-cat.pod:91
#: ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307
#: ../clone/virt-sysprep.pod:69 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105
#: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117
msgid "B<-d> guest"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93
#: ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309
#: ../clone/virt-sysprep.pod:71 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107
#: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119
msgid "B<--domain> guest"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95
#: ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311
#: ../clone/virt-sysprep.pod:73 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109
#: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121
msgid ""
"Add all the disks from the named libvirt guest. Domain UUIDs can be used "
"instead of names."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:123 ../cat/virt-cat.pod:105
#: ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328
#: ../clone/virt-sysprep.pod:95 ../df/virt-df.pod:101
#: ../fish/guestfish.pod:233 ../fuse/guestmount.pod:142
#: ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:124
msgid "B<--format=raw|qcow2|..>"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:107
#: ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330
#: ../clone/virt-sysprep.pod:97 ../df/virt-df.pod:103
#: ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235
#: ../fuse/guestmount.pod:144 ../inspector/virt-inspector.pod:101
#: ../rescue/virt-rescue.pod:126
msgid "B<--format>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:109
#: ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332
#: ../clone/virt-sysprep.pod:99 ../df/virt-df.pod:105
#: ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237
#: ../fuse/guestmount.pod:146 ../rescue/virt-rescue.pod:128
msgid ""
"The default for the I<-a> option is to auto-detect the format of the disk "
"image. Using this forces the disk format for I<-a> options which follow on "
"the command line. Using I<--format> with no argument switches back to auto-"
"detection for subsequent I<-a> options."
msgstr ""
#. type: textblock
#: ../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:336
#: ../rescue/virt-rescue.pod:133 ../src/guestfs.pod:2877
msgid "For example:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:134
#, no-wrap
msgid ""
" virt-alignment-scan --format=raw -a disk.img\n"
"\n"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:136 ../cat/virt-cat.pod:118
#: ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341
#: ../clone/virt-sysprep.pod:108 ../df/virt-df.pod:114
#: ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246
#: ../rescue/virt-rescue.pod:137
msgid "forces raw format (no auto-detection) for C<disk.img>."
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:138
#, no-wrap
msgid ""
" virt-alignment-scan --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:140 ../cat/virt-cat.pod:122
#: ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345
#: ../clone/virt-sysprep.pod:112 ../df/virt-df.pod:118
#: ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250
#: ../rescue/virt-rescue.pod:141
msgid ""
"forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
"detection for C<another.img>."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125
#: ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348
#: ../clone/virt-sysprep.pod:115 ../df/virt-df.pod:121
#: ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:144
msgid ""
"If you have untrusted raw-format guest disk images, you should use this "
"option to specify the disk format. This avoids a possible security problem "
"with malicious guests (CVE-2010-3851)."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:491
#: ../sparsify/virt-sparsify.pod:153
msgid "B<-q>"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:493
#: ../sparsify/virt-sparsify.pod:155
msgid "B<--quiet>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:151
msgid ""
"Don't produce any output. Just set the exit code (see L</EXIT STATUS> "
"below)."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:154 ../cat/virt-cat.pod:134
#: ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425
#: ../clone/virt-sysprep.pod:138 ../df/virt-df.pod:173
#: ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390
#: ../fuse/guestmount.pod:266 ../inspector/virt-inspector.pod:119
#: ../rescue/virt-rescue.pod:182 ../sparsify/virt-sparsify.pod:159
msgid "B<-v>"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:156 ../cat/virt-cat.pod:136
#: ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427
#: ../clone/virt-sysprep.pod:140 ../df/virt-df.pod:175
#: ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392
#: ../fuse/guestmount.pod:268 ../inspector/virt-inspector.pod:121
#: ../rescue/virt-rescue.pod:184 ../sparsify/virt-sparsify.pod:161
msgid "B<--verbose>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:158 ../cat/virt-cat.pod:138
#: ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429
#: ../clone/virt-sysprep.pod:142 ../df/virt-df.pod:177
#: ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123
#: ../rescue/virt-rescue.pod:186 ../sparsify/virt-sparsify.pod:163
msgid "Enable verbose messages for debugging."
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140
#: ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431
#: ../clone/virt-sysprep.pod:144 ../df/virt-df.pod:179
#: ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397
#: ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:125
#: ../rescue/virt-rescue.pod:188 ../resize/virt-resize.pod:561
#: ../sparsify/virt-sparsify.pod:165
msgid "B<-V>"
msgstr ""
#. type: =item
#: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142
#: ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433
#: ../clone/virt-sysprep.pod:146 ../df/virt-df.pod:181
#: ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399
#: ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:127
#: ../rescue/virt-rescue.pod:190 ../resize/virt-resize.pod:563
#: ../sparsify/virt-sparsify.pod: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 ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:144
#: ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435
#: ../clone/virt-sysprep.pod:148 ../df/virt-df.pod:183
#: ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129
#: ../rescue/virt-rescue.pod:192 ../resize/virt-resize.pod:565
#: ../sparsify/virt-sparsify.pod: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
#: ../align/virt-alignment-scan.pod:166 ../cat/virt-cat.pod:146
#: ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437
#: ../clone/virt-sysprep.pod:150 ../df/virt-df.pod:185
#: ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412
#: ../fuse/guestmount.pod:287 ../inspector/virt-inspector.pod:131
#: ../rescue/virt-rescue.pod:203 ../sparsify/virt-sparsify.pod:171
#: ../tools/virt-tar.pl:158
msgid "B<-x>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:168 ../cat/virt-cat.pod:148
#: ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439
#: ../clone/virt-sysprep.pod:152 ../df/virt-df.pod:187
#: ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133
#: ../rescue/virt-rescue.pod:205 ../sparsify/virt-sparsify.pod:173
msgid "Enable tracing of libguestfs API calls."
msgstr ""
#. type: =head1
#: ../align/virt-alignment-scan.pod:172
msgid "RECOMMENDED ALIGNMENT"
msgstr ""
#. type: textblock
#: ../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</1 MB PARTITION ALIGNMENT> 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
#: ../align/virt-alignment-scan.pod:213
#, no-wrap
msgid ""
" sect#63\n"
" +--------------------------+------\n"
" | guest |\n"
" | filesystem block |\n"
" ---+------------------+------+-------------------+-----+---\n"
" | host block | host block |\n"
" | | |\n"
" ---+-------------------------+-------------------------+---\n"
"\n"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:222
msgid ""
"In this example, each time a 4K guest block is read, two blocks on the host "
"must be accessed (so twice as much I/O is done). When a 4K guest block is "
"written, two host blocks must first be read, the old and new data combined, "
"and the two blocks written back (4x I/O)."
msgstr ""
#. type: =head2
#: ../align/virt-alignment-scan.pod:227
msgid "LINUX HOST BLOCK AND I/O SIZE"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:229
msgid ""
"New versions of the Linux kernel expose the physical and logical block size, "
"and minimum and recommended I/O size."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:232
msgid "For a typical consumer hard drive with 512 byte sectors:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:234
#, no-wrap
msgid ""
" $ cat /sys/block/sda/queue/hw_sector_size\n"
" 512\n"
" $ cat /sys/block/sda/queue/physical_block_size\n"
" 512\n"
" $ cat /sys/block/sda/queue/logical_block_size\n"
" 512\n"
" $ cat /sys/block/sda/queue/minimum_io_size\n"
" 512\n"
" $ cat /sys/block/sda/queue/optimal_io_size\n"
" 0\n"
"\n"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:245
msgid "For a new consumer hard drive with 4Kbyte sectors:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:247
#, no-wrap
msgid ""
" $ cat /sys/block/sda/queue/hw_sector_size\n"
" 4096\n"
" $ cat /sys/block/sda/queue/physical_block_size\n"
" 4096\n"
" $ cat /sys/block/sda/queue/logical_block_size\n"
" 4096\n"
" $ cat /sys/block/sda/queue/minimum_io_size\n"
" 4096\n"
" $ cat /sys/block/sda/queue/optimal_io_size\n"
" 0\n"
"\n"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:258
msgid "For a NetApp LUN:"
msgstr ""
#. type: verbatim
#: ../align/virt-alignment-scan.pod:260
#, no-wrap
msgid ""
" $ 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
#: ../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: textblock
#: ../align/virt-alignment-scan.pod:273
msgid ""
"For detailed information about what these numbers mean, see L<http://docs."
"redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/"
"Storage_Administration_Guide/newstorage-iolimits.html>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:276
msgid ""
"[Thanks to Matt Booth for providing 4K drive data. Thanks to Mike Snitzer "
"for providing NetApp data and additional information.]"
msgstr ""
#. type: =head2
#: ../align/virt-alignment-scan.pod:279
msgid "1 MB PARTITION ALIGNMENT"
msgstr ""
#. type: textblock
#: ../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: textblock
#: ../align/virt-alignment-scan.pod:284
msgid ""
"Assuming 512 byte sectors in the guest, you will now see the first partition "
"starting at sector 2048, and subsequent partitions (if any) will start at a "
"multiple of 2048 sectors."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:288
msgid ""
"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
#: ../align/virt-alignment-scan.pod:293
msgid ""
"L<virt-resize(1)> can change the alignment of the partitions of some "
"guests. Currently it can fully align all the partitions of all Windows "
"guests, and it will fix the bootloader where necessary. For Linux guests, "
"it can align the second and subsequent partitions, so the majority of OS "
"accesses except at boot will be aligned."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:299
msgid ""
"Another way to correct partition alignment problems is to reinstall your "
"guest operating systems. If you install operating systems from templates, "
"ensure these have correct partition alignment too."
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:303
msgid ""
"For older versions of Windows, the following NetApp document contains useful "
"information: L<http://media.netapp.com/documents/tr-3747.pdf>"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:306
msgid ""
"For Red Hat Enterprise Linux E<le> 5, use a Kickstart script that contains "
"an explicit C<%pre> section that creates aligned partitions using L<parted(8)"
">. Do not use the Kickstart C<part> command. The NetApp document above "
"contains an example."
msgstr ""
#. type: =head1
#: ../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:352
#: ../rescue/virt-rescue.pod:266 ../resize/virt-resize.pod:676
#: ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258
#: ../tools/virt-make-fs.pl:550 ../tools/virt-tar.pl:289
#: ../tools/virt-win-reg.pl:744
msgid "SHELL QUOTING"
msgstr ""
#. type: textblock
#: ../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:354
#: ../rescue/virt-rescue.pod:268 ../resize/virt-resize.pod:678
#: ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260
#: ../tools/virt-make-fs.pl:552 ../tools/virt-tar.pl:291
#: ../tools/virt-win-reg.pl:752
msgid ""
"Libvirt guest names can contain arbitrary characters, some of which have "
"meaning to the shell such as C<#> and space. You may need to quote or "
"escape these characters on the command line. See the shell manual page L<sh"
"(1)> for details."
msgstr ""
#. type: =head1
#: ../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:375
#: ../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:393
#: ../inspector/virt-inspector.pod:397 ../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<ge> 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<lt> 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<lt> 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:1268 ../fish/virt-copy-in.pod:50
#: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
#: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:317
#: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45
#: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
#: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:288
#: ../resize/virt-resize.pod: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:557 ../tools/virt-tar.pl:296
#: ../tools/virt-win-reg.pl:757
msgid "SEE ALSO"
msgstr ""
#. type: textblock
#: ../align/virt-alignment-scan.pod:354
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-rescue(1)>, "
"L<virt-resize(1)>, L<http://libguestfs.org/>."
msgstr ""
#. type: =head1
#: ../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:296
#: ../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:582 ../tools/virt-tar.pl:311
#: ../tools/virt-win-reg.pl:783
msgid "AUTHOR"
msgstr ""
#. type: textblock
#: ../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:395
#: ../rescue/virt-rescue.pod:298 ../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<http://people.redhat.com/~rjones/>"
msgstr ""
#. type: =head1
#: ../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:332
#: ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:62
#: ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56
#: ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:300
#: ../resize/virt-resize.pod: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:586 ../tools/virt-tar.pl:315
#: ../tools/virt-win-reg.pl:787
msgid "COPYRIGHT"
msgstr ""
#. type: textblock
#: ../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
#: ../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:407
#: ../rescue/virt-rescue.pod:304 ../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: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 "
"Software Foundation; either version 2 of the License, or (at your option) "
"any later version."
msgstr ""
#. type: textblock
#: ../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:412
#: ../rescue/virt-rescue.pod:309 ../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: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 "
"FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for "
"more details."
msgstr ""
#. type: textblock
#: ../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:417
#: ../rescue/virt-rescue.pod:314 ../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: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 ""
#. type: textblock
#: ../cat/virt-cat.pod:5
msgid "virt-cat - Display files in a virtual machine"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:9
#, no-wrap
msgid ""
" virt-cat [--options] -d domname file [file ...]\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:11
#, no-wrap
msgid ""
" virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
"\n"
msgstr ""
#. 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
#, no-wrap
msgid ""
" virt-cat domname file\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:17
#, no-wrap
msgid ""
" virt-cat disk.img file\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:21
msgid ""
"C<virt-cat> is a command line tool to display the contents of C<file> where "
"C<file> exists in the named virtual machine (or disk image)."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:24
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 '/')."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:28
msgid ""
"C<virt-cat> can be used to quickly view a file. To edit a file, use C<virt-"
"edit>. For more complex cases you should look at the L<guestfish(1)> tool "
"(see L</USING GUESTFISH> below)."
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: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-cat.pod:34
msgid ""
"Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:37
#, no-wrap
msgid ""
" virt-cat -d mydomain /etc/fstab\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:39
msgid "List syslog messages from a VM disk image file:"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:41
#, no-wrap
msgid ""
" virt-cat -a disk.img /var/log/messages | tail\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
#, no-wrap
msgid ""
" virt-cat -d mydomain /var/log/messages | \\\n"
" grep 'dhclient: bound to' | tail\n"
"\n"
msgstr ""
#. type: textblock
#: ../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 ""
#. 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 ""
#. 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 ""
#. 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<file> 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 ""
#. 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 ""
#. 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 ""
#. 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 ""
#. 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</dev/tty>."
msgstr ""
#. type: =head1
#: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179
#: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:209
msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
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:143 ../rescue/virt-rescue.pod:215
msgid "or"
msgstr ""
#. type: verbatim
#: ../cat/virt-cat.pod:160
#, no-wrap
msgid ""
" virt-cat guestname file\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189
#: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:219
msgid ""
"whereas in this version you should use I<-a> or I<-d> respectively to avoid "
"the confusing case where a disk image might have the same name as a guest."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193
#: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:223
msgid "For compatibility the old style is still supported."
msgstr ""
#. type: =head1
#: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
msgid "WINDOWS PATHS"
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:170
msgid ""
"C<virt-cat> has a limited ability to understand Windows drive letters and "
"paths (eg. C<E:\\foo\\bar.txt>)."
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<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 ""
#. type: textblock
#: ../cat/virt-cat.pod:210
msgid ""
"L<guestfish(1)> is a more powerful, lower level tool which you can use when "
"C<virt-cat> doesn't work."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:213
msgid "Using C<virt-cat> 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<domname> is the name of the libvirt guest, and C<file> 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<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
"the disk image, and C<file> 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:377
#: ../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<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
"tar-out(1)>, L<http://libguestfs.org/>."
msgstr ""
#. type: textblock
#: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:405
#: ../resize/virt-resize.pod:717 ../tools/virt-make-fs.pl:588
msgid "Copyright (C) 2010-2011 Red Hat Inc."
msgstr ""
#. 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 ""
#. 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<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
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 ""
#. 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<virt-resize(1)>). If you are curious about what an "
"unknown disk image contains, use this tool along with L<virt-inspector(1)>."
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 ""
#. 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 ""
#. 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 ""
#. 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
msgid ""
"You can use these options in combination as well (if you want a combination "
"including filesystems, you have to add I<--filesystems>). Notice that some "
"items fall into several categories (eg. C</dev/sda1> might be both a "
"partition and a filesystem). These items are listed several times. To get "
"a list which includes absolutely everything that virt-filesystems knows "
"about, use the I<--all> option."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:74
msgid ""
"UUIDs (because they are quite long) are not shown by default. Add the I<--"
"uuid> option to display device and filesystem UUIDs in the long output."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:78
msgid ""
"I<--all --long --uuid> is a useful combination to display all possible "
"information about everything."
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:81
#, no-wrap
msgid ""
" $ virt-filesystems -a win.img --all --long --uuid -h\n"
" Name Type VFS Label Size Parent UUID\n"
" /dev/sda1 filesystem ntfs System Reserved 100M - F81C92571C92112C\n"
" /dev/sda2 filesystem ntfs - 20G - F2E8996AE8992E3B\n"
" /dev/sda1 partition - - 100M /dev/sda -\n"
" /dev/sda2 partition - - 20G /dev/sda -\n"
" /dev/sda device - - 20G - -\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:89
msgid ""
"For machine-readable output, use I<--csv> to get Comma-Separated Values."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
msgid "B<--all>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:112
msgid ""
"Display everything. This is currently the same as specifying these options: "
"I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, I<--"
"logical-volumes>, I<--volume-groups>, I<--physical-volumes>. (More may be "
"added to this list in future)."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:117
msgid "See also I<--long>."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:119
msgid "B<--blkdevs>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:121
msgid "B<--block-devices>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:123
msgid "Display block devices."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
msgid "B<--csv>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
msgid ""
"Write out the results in CSV format (comma-separated values). This format "
"can be imported easily into databases and spreadsheets, but read L</NOTE "
"ABOUT CSV FORMAT> below."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:150
msgid ""
"When prompting for keys and passphrases, virt-filesystems 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-filesystems.pod:155
msgid "B<--extra>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:157
msgid ""
"This causes filesystems that are not ordinary, mountable filesystems to be "
"displayed. This category includes swapspace, and filesystems that are empty "
"or contain unknown data."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:161
msgid "This option implies I<--filesystems>."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:163
msgid "B<--filesystems>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:165
msgid ""
"Display mountable filesystems. If no display option was selected then this "
"option is implied."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:168
msgid "With I<--extra>, non-mountable filesystems are shown too."
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:181
#, no-wrap
msgid ""
" virt-filesystems --format=raw -a disk.img\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:185
#, no-wrap
msgid ""
" virt-filesystems --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352
#: ../df/virt-df.pod:125 ../fish/guestfish.pod:156
#: ../tools/virt-list-partitions.pl:109
msgid "B<-h>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354
#: ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111
msgid "B<--human-readable>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:198
msgid "In I<--long> mode, display sizes in human-readable format."
msgstr ""
#. type: =item
#: ../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 ""
#. type: =item
#: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
#: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
msgid "B<--long>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:209
msgid "Display extra columns of data (\"long format\")."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:211
msgid "A title row is added unless you also specify I<--no-title>."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:213
msgid ""
"The extra columns displayed depend on what output you select, and the "
"ordering of columns may change in future versions. Use the title row, I<--"
"csv> output and/or L<csvtool(1)> to match columns to data in external "
"programs."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:218
msgid ""
"Use I<-h> if you want sizes to be displayed in human-readable format. The "
"default is to show raw numbers of I<bytes>."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:221
msgid "Use I<--uuid> to display UUIDs too."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:223
msgid "B<--lvs>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:225
msgid "B<--logvols>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:227
msgid "B<--logical-volumes>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:229
msgid ""
"Display LVM logical volumes. In this mode, these are displayed irrespective "
"of whether the LVs contain filesystems."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:232
msgid "B<--no-title>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:234
msgid "In I<--long> mode, don't add a title row."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:236
msgid ""
"Note that the order of the columns is not fixed, and may change in future "
"versions of virt-filesystems, so using this option may give you unexpected "
"surprises."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:240
msgid "B<--parts>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:242
msgid "B<--partitions>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:244
msgid ""
"Display partitions. In this mode, these are displayed irrespective of "
"whether the partitions contain filesystems."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:247
msgid "B<--pvs>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:249
msgid "B<--physvols>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:251
msgid "B<--physical-volumes>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:253
msgid "Display LVM physical volumes."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
msgid "B<--uuid>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:257
msgid "B<--uuids>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:259
msgid "In I<--long> mode, display UUIDs as well."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:273
msgid "B<--vgs>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:275
msgid "B<--volgroups>"
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:277
msgid "B<--volume-groups>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:279
msgid "Display LVM volume groups."
msgstr ""
#. type: =head1
#: ../cat/virt-filesystems.pod:287
msgid "COLUMNS"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:289
msgid ""
"Note that columns in the output are subject to reordering and change in "
"future versions of this tool."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:294
msgid "B<Name>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:296
msgid "The filesystem, partition, block device or LVM name."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:298
msgid ""
"For device and partition names these are displayed as canonical libguestfs "
"names, so that for example C</dev/sda2> is the second partition on the first "
"device."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:302
msgid ""
"If the I<--long> option is B<not> specified, then only the name column is "
"shown in the output."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:305
msgid "B<Type>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:307
msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:309
msgid "B<VFS>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:311
msgid ""
"If there is a filesystem, then this column displays the filesystem type if "
"one could be detected, eg. C<ext4>."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:314
msgid "B<Label>"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:316
msgid ""
"If the object has a label (used for identifying and mounting filesystems) "
"then this column contains the label."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:319
msgid "B<MBR>"
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<http://www.win."
"tue.nl/~aeb/partitions/partition_types-1.html>"
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<Size>"
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:332
msgid "B<Parent>"
msgstr ""
#. type: textblock
#: ../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 "
"the containing device. If the object is a logical volume, then this column "
"is the name of the volume group."
msgstr ""
#. type: =item
#: ../cat/virt-filesystems.pod:339
msgid "B<UUID>"
msgstr ""
#. type: textblock
#: ../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:345
msgid "The UUID is only displayed if the I<--uuid> option is given."
msgstr ""
#. type: =head1
#: ../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:351 ../cat/virt-ls.pod:461
#: ../df/virt-df.pod:193
msgid ""
"Comma-separated values (CSV) is a deceptive format. It I<seems> like it "
"should be easy to parse, but it is definitely not easy to parse."
msgstr ""
#. type: textblock
#: ../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<not> work "
"reliably. This example has two columns:"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467
#: ../df/virt-df.pod:199
#, no-wrap
msgid ""
" \"foo,bar\",baz\n"
"\n"
msgstr ""
#. type: textblock
#: ../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<not> work "
"reliably. This example has one row:"
msgstr ""
#. type: verbatim
#: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472
#: ../df/virt-df.pod:204
#, no-wrap
msgid ""
" \"foo\n"
" bar\",baz\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:475
#: ../df/virt-df.pod:207
msgid ""
"For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
"packaged in major Linux distributions)."
msgstr ""
#. type: textblock
#: ../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<Text::CSV> for Perl "
"or Python's built-in csv library)."
msgstr ""
#. type: textblock
#: ../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:387
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
"filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
"libguestfs.org/>."
msgstr ""
#. type: textblock
#: ../cat/virt-filesystems.pod:402 ../tools/virt-win-reg.pl:789
msgid "Copyright (C) 2010 Red Hat Inc."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:5
msgid "virt-ls - List files in a virtual machine"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:9
#, no-wrap
msgid ""
" virt-ls [--options] -d domname directory [directory ...]\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:11
#, no-wrap
msgid ""
" virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13
msgid "Old style:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:15
#, no-wrap
msgid ""
" virt-ls [--options] domname directory\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:17
#, no-wrap
msgid ""
" virt-ls [--options] disk.img [disk.img ...] directory\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:21
msgid ""
"C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
"more from a virtual machine or disk image."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:24
msgid ""
"Multiple directory names can be given, in which case the output from each is "
"concatenated."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:27
msgid ""
"To list directories from a libvirt guest use the I<-d> option to specify the "
"name of the guest. For a disk image, use the I<-a> option."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:31
msgid ""
"C<virt-ls> can do many simple file listings. For more complicated cases you "
"may need to use L<guestfish(1)>, or write a program directly to the L<guestfs"
"(3)> API."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:37
msgid "Get a list of all files and directories in a virtual machine:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:39
#, no-wrap
msgid ""
" virt-ls -R -d guest /\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:41
msgid "List all setuid or setgid programs in a Linux virtual machine:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:43
#, no-wrap
msgid ""
" virt-ls -lR -d guest / | grep '^- [42]'\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:45
msgid "List all public-writable directories in a Linux virtual machine:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:47
#, no-wrap
msgid ""
" virt-ls -lR -d guest / | grep '^d ...7'\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:49
msgid "List all Unix domain sockets in a Linux virtual machine:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:51
#, no-wrap
msgid ""
" virt-ls -lR -d guest / | grep '^s'\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:53
msgid "List all regular files with filenames ending in '.png':"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:55
#, no-wrap
msgid ""
" virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:57
msgid "To display files larger than 10MB in home directories:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:59
#, no-wrap
msgid ""
" virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:61
msgid "Find everything modified in the last 7 days:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:63
#, no-wrap
msgid ""
" virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:65
msgid "Find regular files modified in the last 24 hours:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:67
#, no-wrap
msgid ""
" virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
"\n"
msgstr ""
#. type: =head2
#: ../cat/virt-ls.pod:69
msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:71
msgid ""
"Find the differences between files in a guest and an earlier snapshot of the "
"same guest."
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:74
#, no-wrap
msgid ""
" virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
" virt-ls -lR -a current.img / --uids --time-t > new\n"
" diff -u old new | less\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:78
msgid ""
"The commands above won't find files where the content has changed but the "
"metadata (eg. file size and modification date) is the same. To do that, you "
"need to add the I<--checksum> parameter to both C<virt-ls> commands. I<--"
"checksum> can be quite slow since it has to read and compute a checksum of "
"every regular file in the virtual machine."
msgstr ""
#. type: =head1
#: ../cat/virt-ls.pod:84
msgid "OUTPUT MODES"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:86
msgid ""
"C<virt-ls> has four output modes, controlled by different combinations of "
"the I<-l> and I<-R> options."
msgstr ""
#. type: =head2
#: ../cat/virt-ls.pod:89
msgid "SIMPLE LISTING"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:91
msgid "A simple listing is like the ordinary L<ls(1)> command:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:93
#, no-wrap
msgid ""
" $ virt-ls -d guest /\n"
" bin\n"
" boot\n"
" [etc.]\n"
"\n"
msgstr ""
#. type: =head2
#: ../cat/virt-ls.pod:98
msgid "LONG LISTING"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:100
msgid ""
"With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
"(more specifically, like the C<guestfs_ll> function)."
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:103
#, no-wrap
msgid ""
" $ 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"
" [etc.]\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:109
msgid ""
"Note that while this is useful for displaying a directory, do not try "
"parsing this output in another program. Use L</RECURSIVE LONG LISTING> "
"instead."
msgstr ""
#. type: =head2
#: ../cat/virt-ls.pod:113
msgid "RECURSIVE LISTING"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:115
msgid ""
"With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
"and directories recursively:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:118
#, no-wrap
msgid ""
" $ virt-ls -R -d guest /tmp\n"
" foo\n"
" foo/bar\n"
" [etc.]\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:123
msgid ""
"To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
"converts C<\\0> characters to C<\\n>."
msgstr ""
#. type: =head2
#: ../cat/virt-ls.pod:126
msgid "RECURSIVE LONG LISTING"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:128
msgid ""
"Using I<-lR> options together changes the output to display directories "
"recursively, with file stats, and optionally other features such as "
"checksums and extended attributes."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:132
msgid ""
"Most of the interesting features of C<virt-ls> are only available when using "
"I<-lR> mode."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:135
msgid ""
"The fields are normally space-separated. Filenames are B<not> quoted, so "
"you cannot use the output in another program (because filenames can contain "
"spaces and other unsafe characters). If the guest was untrusted and someone "
"knew you were using C<virt-ls> to analyze the guest, they could play tricks "
"on you by creating filenames with embedded newline characters. To B<safely> "
"parse the output in another program, use the I<--csv> (Comma-Separated "
"Values) option."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:143
msgid ""
"Note that this output format is completely unrelated to the C<ls -lR> "
"command."
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:146
#, no-wrap
msgid ""
" $ 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"
" [etc.]\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:155
msgid "These basic fields are always shown:"
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:159
msgid "type"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:161
msgid ""
"The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
"(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
"link), C<s> (socket) or C<u> (unknown)."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:171
msgid "permissions"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:173
msgid "The Unix permissions, displayed as a 4 digit octal number."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:175
msgid "size"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:177
msgid ""
"The size of the file. This is shown in bytes unless I<-h> or I<--human-"
"readable> option is given, in which case this is shown as a human-readable "
"number."
msgstr ""
#. type: =head2
#: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4380
msgid "path"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:183
msgid "The full path of the file or directory."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:185
msgid "link"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:187
msgid "For symbolic links only, the link target."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:191
msgid ""
"In I<-lR> mode, additional command line options enable the display of more "
"fields."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:194
msgid ""
"With the I<--uids> flag, these additional fields are displayed before the "
"path:"
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:199
msgid "uid"
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:201
msgid "gid"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:203
msgid ""
"The UID and GID of the owner of the file (displayed numerically). Note "
"these only make sense in the context of a Unix-like guest."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:208
msgid "With the I<--times> flag, these additional fields are displayed:"
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:212
msgid "atime"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:214
msgid "The time of last access."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:216
msgid "mtime"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:218
msgid "The time of last modification."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:220
msgid "ctime"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:222
msgid "The time of last status change."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:226
msgid ""
"The time fields are displayed as string dates and times, unless one of the "
"I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:229
msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:233
msgid "device"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:235
msgid ""
"The device containing the file (displayed as major:minor). This may not "
"match devices as known to the guest."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:238
msgid "inode"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:240
msgid "The inode number."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:242
msgid "nlink"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:244
msgid "The number of hard links."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:246
msgid "rdev"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:248
msgid ""
"For block and char special files, the device (displayed as major:minor)."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:251
msgid "blocks"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:253
msgid "The number of 512 byte blocks allocated to the file."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:257
msgid ""
"With the I<--checksum> flag, the checksum of the file contents is shown "
"(only for regular files). Computing file checksums can take a considerable "
"amount of time."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:280
msgid "B<--checksum>"
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:282
msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:284
msgid ""
"Display checksum over file contents for regular files. With no argument, "
"this defaults to using I<md5>. Using an argument, you can select the "
"checksum type to use."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358
#: ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408
#: ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422
msgid ""
"This option only has effect in I<-lR> output mode. See L</RECURSIVE LONG "
"LISTING> above."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:316
msgid ""
"When prompting for keys and passphrases, virt-ls 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-ls.pod:321
msgid "B<--extra-stats>"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:323
msgid "Display extra stats."
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:339
#, no-wrap
msgid ""
" virt-ls --format=raw -a disk.img /dir\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:343
#, no-wrap
msgid ""
" virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:356
msgid "Display file sizes in human-readable format."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:370
msgid "B<-R>"
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:372
msgid "B<--recursive>"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:374
msgid ""
"Select the mode. With neither of these options, C<virt-ls> produces a "
"simple, flat list of the files in the named directory. See L</SIMPLE "
"LISTING>."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:378
msgid ""
"C<virt-ls -l> produces a \"long listing\", which shows more detail. See L</"
"LONG LISTING>."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:381
msgid ""
"C<virt-ls -R> produces a recursive list of files starting at the named "
"directory. See L</RECURSIVE LISTING>."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:384
msgid ""
"C<virt-ls -lR> produces a recursive long listing which can be more easily "
"parsed. See L</RECURSIVE LONG LISTING>."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:387
msgid "B<--times>"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:389
msgid "Display time fields."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:394
msgid "B<--time-days>"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:396
msgid "Display time fields as days before now (negative if in the future)."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:398
msgid ""
"Note that C<0> in output means \"up to 1 day before now\", or that the age "
"of the file is between 0 and 86399 seconds."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:404
msgid "B<--time-relative>"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:406
msgid "Display time fields as seconds before now (negative if in the future)."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:411
msgid "B<--time-t>"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:413
msgid "Display time fields as seconds since the Unix epoch."
msgstr ""
#. type: =item
#: ../cat/virt-ls.pod:418
msgid "B<--uids>"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:420
msgid "Display UID and GID fields."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:445
msgid "Previous versions of virt-ls allowed you to write either:"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:447
#, no-wrap
msgid ""
" virt-ls disk.img [disk.img ...] /dir\n"
"\n"
msgstr ""
#. type: verbatim
#: ../cat/virt-ls.pod:451
#, no-wrap
msgid ""
" virt-ls guestname /dir\n"
"\n"
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:497
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
"tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
"L<http://libguestfs.org/>."
msgstr ""
#. type: textblock
#: ../cat/virt-ls.pod:513 ../df/virt-df.pod:241 ../edit/virt-edit.pod:374
#: ../rescue/virt-rescue.pod:302
msgid "Copyright (C) 2009-2011 Red Hat Inc."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:5
msgid ""
"virt-sysprep - Reset or unconfigure a virtual machine so clones can be made"
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:9
#, no-wrap
msgid ""
" virt-sysprep [--options] -d domname\n"
"\n"
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:11
#, no-wrap
msgid ""
" virt-sysprep [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:15
msgid ""
"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 ""
#. type: textblock
#: ../clone/virt-sysprep.pod:21
msgid ""
"Virt-sysprep is a simple shell script, allowing easy inspection or "
"customization by the system administrator."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:24
msgid ""
"Virt-sysprep modifies the guest or disk image I<in place>. The guest must "
"be shut down. If you want to preserve the existing contents of the guest, "
"you I<must copy or clone the disk first>. See L</COPYING AND CLONING> below."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:29
msgid ""
"You do I<not> 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
#: ../clone/virt-sysprep.pod:35
msgid ""
"\"Sysprep\" stands for \"system preparation\" tool. The name comes from the "
"Microsoft program C<sysprep.exe> which is used to unconfigure Windows "
"machines in preparation for cloning them. Having said that, virt-sysprep "
"does I<not> 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: =item
#: ../clone/virt-sysprep.pod:76
msgid "B<--enable=...>"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:78
msgid ""
"Choose which sysprep operations to perform. Give a comma-separated list of "
"operations, for example:"
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:81
#, no-wrap
msgid ""
" --enable=ssh-hostkeys,udev-persistent-net\n"
"\n"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:83
msgid ""
"would enable ONLY C<ssh-hostkeys> and C<udev-persistent-net> operations."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:85
msgid ""
"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</OPERATIONS> below for a list and an explanation of each operation."
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:106
#, no-wrap
msgid ""
" virt-sysprep --format=raw -a disk.img\n"
"\n"
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:110
#, no-wrap
msgid ""
" virt-sysprep --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""
#. type: =item
#: ../clone/virt-sysprep.pod:119
msgid "B<--hostname> newhostname"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:121
msgid ""
"Change the hostname. See the L</hostname> operation below. If not given, "
"defaults to C<localhost.localdomain>."
msgstr ""
#. type: =item
#: ../clone/virt-sysprep.pod:124
msgid "B<--list-operations>"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:126
msgid "List the operations supported by the virt-sysprep program."
msgstr ""
#. type: =item
#: ../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
#: ../clone/virt-sysprep.pod:132
msgid ""
"I<--selinux-relabel> forces SELinux relabelling next time the guest boots. "
"I<--no-selinux-relabel> disables relabelling."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:135
msgid ""
"The default is to try to detect if SELinux relabelling is required. See L</"
"SELINUX RELABELLING> below for more details."
msgstr ""
#. type: =head1
#: ../clone/virt-sysprep.pod:156
msgid "OPERATIONS"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:158
msgid ""
"If the I<--enable> option is I<not> given, then I<all sysprep operations are "
"enabled>, although some are skipped depending on the type of guest."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:162
msgid ""
"Operations can be individually enabled using the I<--enable> option. Use a "
"comma-separated list, for example:"
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:165
#, no-wrap
msgid ""
" virt-sysprep --enable=ssh-hostkeys,udev-persistent-net [etc..]\n"
"\n"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:167
msgid ""
"To list the operations supported by the current version of virt-sysprep, use "
"I<--list-operations>."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:170
msgid ""
"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: =head2
#: ../clone/virt-sysprep.pod:174
msgid "cron-spool"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:176
msgid "Remove user at-jobs and cron-jobs."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:178
msgid "dhcp-client-state"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:180
msgid "Remove DHCP client leases."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:182
msgid "dhcp-server-state"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:184
msgid "Remove DHCP server leases."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:186
msgid "hostname"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:188
msgid ""
"Changes the hostname of the guest to the value given in the I<--hostname> "
"parameter."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:191
msgid ""
"If the I<--hostname> parameter is not given, then the hostname is changed to "
"C<localhost.localdomain>."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:194
msgid "logfiles"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:196
msgid "Remove many log files."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:198
msgid "mail-spool"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:200
msgid "Remove email from the local mail spool directory."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:202
msgid "net-hwaddr"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:204
msgid ""
"Remove HWADDR (hard-coded MAC address) configuration. For Fedora and Red "
"Hat Enterprise Linux, this is removed from C<ifcfg-*> files."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:207
msgid "random-seed"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:209
msgid ""
"Write some random bytes from the host into the random seed file of the guest."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:212
msgid "See L</RANDOM SEED> below."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:214
msgid "rhn-systemid"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:216
msgid "Remove the RHN system ID."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:218
msgid "smolt-uuid"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:220
msgid "Remove the Smolt hardware UUID."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:222
msgid "ssh-hostkeys"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:224
msgid "Remove the SSH host keys in the guest."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:226
msgid ""
"The SSH host keys are regenerated (differently) next time the guest is "
"booted."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:229
msgid ""
"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
#: ../clone/virt-sysprep.pod:232
#, no-wrap
msgid ""
" @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\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
#: ../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: 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: =head2
#: ../clone/virt-sysprep.pod:247
msgid "utmp"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:249
msgid "Remove the utmp file."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:251
msgid ""
"This records who is currently logged in on a machine. In modern Linux "
"distros it is stored in a ramdisk and hence not part of the virtual "
"machine's disk, but it was stored on disk in older distros."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:255
msgid "yum-uuid"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:257
msgid "Remove the yum UUID."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:259
msgid ""
"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
#: ../clone/virt-sysprep.pod:264
msgid ""
"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
#: ../clone/virt-sysprep.pod:269
msgid "A virtual machine (when switched off) consists of two parts:"
msgstr ""
#. type: =item
#: ../clone/virt-sysprep.pod:273
msgid "I<configuration>"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:275
msgid ""
"The configuration or description of the guest. eg. The libvirt XML (see "
"C<virsh dumpxml>), the running configuration of the guest, or another "
"external format like OVF."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:279
msgid "Some configuration items that might need to be changed:"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:285
msgid "name"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:289 ../clone/virt-sysprep.pod:316
msgid "UUID"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:293
msgid "path to block device(s)"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:297
msgid "network card MAC address"
msgstr ""
#. type: =item
#: ../clone/virt-sysprep.pod:301
msgid "I<block device(s)>"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:303
msgid ""
"One or more hard disk images, themselves containing files, directories, "
"applications, kernels, configuration, etc."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:306
msgid "Some things inside the block devices that might need to be changed:"
msgstr ""
#. type: textblock
#: ../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 ""
"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
#: ../clone/virt-sysprep.pod:341
#, no-wrap
msgid ""
" virt-sysprep\n"
" |\n"
" v\n"
" original guest --------> template ---------->\n"
" \\------> cloned\n"
" \\-----> guests\n"
" \\---->\n"
"\n"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:349
msgid ""
"You can, of course, just copy the block device on the host using L<cp(1)> or "
"L<dd(1)>."
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:352
#, no-wrap
msgid ""
" dd dd\n"
" original guest --------> template ---------->\n"
" \\------> cloned\n"
" \\-----> guests\n"
" \\---->\n"
"\n"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:358
msgid "There are some smarter (and faster) ways too:"
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:364
#, no-wrap
msgid ""
" snapshot\n"
" template ---------->\n"
" \\------> cloned\n"
" \\-----> guests\n"
" \\---->\n"
"\n"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:370
msgid ""
"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
#: ../clone/virt-sysprep.pod:375
msgid ""
"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
#: ../clone/virt-sysprep.pod:378
msgid ""
"Tools that can do this include: L<qemu-img(1)> (with the I<create -f qcow2 -"
"o backing_file> option), L<lvcreate(8)> (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
#: ../clone/virt-sysprep.pod:386
msgid "Get your NAS to snapshot and/or duplicate the LUN."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:390
msgid "Prepare your template using L<virt-sparsify(1)>. See below."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:394
msgid "VIRT-CLONE"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:396
msgid ""
"A separate tool, L<virt-clone(1)>, 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
#: ../clone/virt-sysprep.pod:401
msgid ""
"L<virt-clone(1)> 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
#: ../clone/virt-sysprep.pod:406
#, no-wrap
msgid ""
" virt-sparsify\n"
" original guest --------> template\n"
"\n"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:409
msgid ""
"L<virt-sparsify(1)> can be used to make the cloning template smaller, making "
"it easier to compress and/or faster to copy."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:412
msgid ""
"Notice that since virt-sparsify also copies the image, you can use it to "
"make the initial copy (instead of C<dd>)."
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:415
msgid "RESIZE"
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:417
#, no-wrap
msgid ""
" virt-resize\n"
" template ---------->\n"
" \\------> cloned\n"
" \\-----> guests\n"
" \\---->\n"
"\n"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:423
msgid ""
"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"
"(1)>. 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
#: ../clone/virt-sysprep.pod:431
msgid ""
"Although virt-sysprep removes some sensitive information from the guest, it "
"does not pretend to remove all of it. You should examine the L</OPERATIONS> "
"above, and the implementation of the operations in the shell script. You "
"should also examine the guest afterwards."
msgstr ""
#. type: textblock
#: ../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<virt-sparsify(1)> as one way to remove this content. See also the L<scrub"
"(1)> 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
#: ../clone/virt-sysprep.pod:444
msgid "I<(This section applies to Linux guests only)>"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:446
msgid ""
"The virt-sysprep C<random-seed> operation writes a few bytes of randomness "
"from the host into the guest's random seed file."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:449
msgid ""
"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
#: ../clone/virt-sysprep.pod:453
msgid ""
"Therefore you should arrange to add more randomness I<after> cloning from a "
"template too, which can be done by just enabling the C<random-seed> "
"operation:"
msgstr ""
#. type: verbatim
#: ../clone/virt-sysprep.pod:457
#, no-wrap
msgid ""
" cp template.img newguest.img\n"
" virt-sysprep --enable=random-seed -a newguest.img\n"
"\n"
msgstr ""
#. type: =head2
#: ../clone/virt-sysprep.pod:460
msgid "SELINUX RELABELLING"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:462
msgid "I<(This section applies to Linux guests using SELinux only)>"
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:464
msgid ""
"If any new files are created by virt-sysprep, then virt-sysprep touches C</."
"autorelabel> 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: textblock
#: ../clone/virt-sysprep.pod:469
msgid ""
"You can force relabelling for all guests by supplying the I<--selinux-"
"relabel> option."
msgstr ""
#. type: textblock
#: ../clone/virt-sysprep.pod:472
msgid ""
"You can disable relabelling entirely by supplying the I<--no-selinux-"
"relabel> option."
msgstr ""
#. type: textblock
#: ../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 ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-clone(1)>, L<virt-rescue(1)>, L<virt-"
"resize(1)>, L<virt-sparsify(1)>, L<virsh(1)>, L<lvcreate(8)>, L<qemu-img(1)"
">, L<scrub(1)>, L<http://libguestfs.org/>, L<http://libvirt.org/>."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:5
msgid "virt-df - Display free space on virtual filesystems"
msgstr ""
#. type: verbatim
#: ../df/virt-df.pod:9
#, no-wrap
msgid ""
" virt-df [--options]\n"
"\n"
msgstr ""
#. type: verbatim
#: ../df/virt-df.pod:11
#, no-wrap
msgid ""
" virt-df [--options] -d domname\n"
"\n"
msgstr ""
#. type: verbatim
#: ../df/virt-df.pod:13
#, no-wrap
msgid ""
" virt-df [--options] -a disk.img [-a disk.img ...]\n"
"\n"
msgstr ""
#. type: verbatim
#: ../df/virt-df.pod:17
#, no-wrap
msgid ""
" virt-df [--options] domname\n"
"\n"
msgstr ""
#. type: verbatim
#: ../df/virt-df.pod:19
#, no-wrap
msgid ""
" virt-df [--options] disk.img [disk.img ...]\n"
"\n"
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:23
msgid ""
"C<virt-df> 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
#: ../df/virt-df.pod:28
msgid ""
"If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
"to get a list of all active and inactive guests, and performs a C<df>-type "
"operation on each one in turn, printing out the results."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:32
msgid ""
"If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a C<df>-"
"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<virt-df> will I<only work for a single "
"guest>. If you want to run on multiple guests, then you have to invoke "
"C<virt-df> multiple times."
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<df(1)> command."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:45
msgid ""
"Show disk usage for a single libvirt guest called C<F14x64>. Make the "
"output human-readable:"
msgstr ""
#. type: verbatim
#: ../df/virt-df.pod:48
#, 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"
"\n"
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:53
msgid "Show disk usage for a disk image file called C<test.img>:"
msgstr ""
#. type: verbatim
#: ../df/virt-df.pod:55
#, no-wrap
msgid ""
" $ 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
#: ../df/virt-df.pod:112
#, no-wrap
msgid ""
" virt-df --format=raw -a disk.img\n"
"\n"
msgstr ""
#. type: verbatim
#: ../df/virt-df.pod:116
#, no-wrap
msgid ""
" virt-df --format=raw -a disk.img --format -a another.img\n"
"\n"
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:129
msgid "Print sizes in human-readable format."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:131
msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
msgstr ""
#. type: =item
#: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:164
msgid "B<-i>"
msgstr ""
#. type: =item
#: ../df/virt-df.pod:135
msgid "B<--inodes>"
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:137
msgid "Print inodes instead of blocks."
msgstr ""
#. type: =item
#: ../df/virt-df.pod:139
msgid "B<--one-per-guest>"
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:141
msgid ""
"Run one libguestfs appliance per guest. Normally C<virt-df> will add the "
"disks from several guests to a single libguestfs appliance."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:144
msgid "You might use this option in the following circumstances:"
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:150
msgid ""
"If you think an untrusted guest might actively try to exploit the libguestfs "
"appliance kernel, then this prevents one guest from interfering with the "
"stats printed for another guest."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:156
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."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:165
msgid ""
"Print UUIDs instead of names. This is useful for following a guest even "
"when the guest is migrated or renamed, or when two guests happen to have the "
"same name."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:169
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."
msgstr ""
#. type: textblock
#: ../df/virt-df.pod:229
msgid ""
"L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
"libguestfs.org/>."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:5
msgid "virt-edit - Edit a file in a virtual machine"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:9
#, no-wrap
msgid ""
" virt-edit [--options] -d domname file [file ...]\n"
"\n"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:11
#, no-wrap
msgid ""
" virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
"\n"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:13
#, no-wrap
msgid ""
" virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
"\n"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:17
#, no-wrap
msgid ""
" virt-edit domname file\n"
"\n"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
#, no-wrap
msgid ""
" virt-edit disk.img [disk.img ...] file\n"
"\n"
msgstr ""
#. type: =head1
#: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23
#: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15
#: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19
#: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
msgid "WARNING"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:23
msgid ""
"You must I<not> use C<virt-edit> on live virtual machines. If you do this, "
"you risk disk corruption in the VM. C<virt-edit> tries to stop you from "
"doing this, but doesn't catch all cases."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:29
msgid ""
"C<virt-edit> is a command line tool to edit C<file> where each C<file> "
"exists in the named virtual machine (or disk image)."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:32
msgid ""
"Multiple filenames can be given, in which case they are each edited in "
"turn. Each filename must be a full path, starting at the root directory "
"(starting with '/')."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:36
msgid "If you want to just view a file, use L<virt-cat(1)>."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:38
msgid ""
"For more complex cases you should look at the L<guestfish(1)> tool (see L</"
"USING GUESTFISH> below)."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:41
msgid ""
"C<virt-edit> cannot be used to create a new file. L<guestfish(1)> can do "
"that and much more."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:46
msgid "Edit the named files interactively:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:48
#, no-wrap
msgid ""
" virt-edit -d mydomain /boot/grub/grub.conf\n"
"\n"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:50
#, no-wrap
msgid ""
" virt-edit -d mydomain /etc/passwd\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:52
msgid "For Windows guests, some Windows paths are understood:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:54
#, no-wrap
msgid ""
" virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:56
msgid ""
"If Perl is installed, you can also edit files non-interactively (see L</NON-"
"INTERACTIVE EDITING> below). To change the init default level to 5:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:60
#, no-wrap
msgid ""
" virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
"\n"
msgstr ""
#. type: =item
#: ../edit/virt-edit.pod:81
msgid "B<-b> extension"
msgstr ""
#. type: =item
#: ../edit/virt-edit.pod:83
msgid "B<--backup> extension"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:85
msgid ""
"Create a backup of the original file I<in the guest disk image>. The backup "
"has the original filename with C<extension> added."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:88
msgid ""
"Usually the first character of C<extension> would be a dot C<.> so you would "
"write:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:91
#, no-wrap
msgid ""
" virt-edit -b .orig [etc]\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:93
msgid "By default, no backup file is made."
msgstr ""
#. type: =item
#: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181
#: ../fuse/guestmount.pod:105 ../inspector/virt-inspector.pod:74
#: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78
#: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128
msgid "B<-c URI>"
msgstr ""
#. 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 ""
#. type: textblock
#: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84
#: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134
#: ../tools/virt-win-reg.pl:135
msgid ""
"If you specify guest block devices directly, then libvirt is not used at all."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:114
msgid ""
"When prompting for keys and passphrases, virt-edit normally turns echoing "
"off so you cannot see what you are typing. If you are not worried about "
"Tempest attacks and there is no one else in the room you can specify this "
"flag to see what you are typing."
msgstr ""
#. type: =item
#: ../edit/virt-edit.pod:119
msgid "B<-e> EXPR"
msgstr ""
#. type: =item
#: ../edit/virt-edit.pod:121
msgid "B<--expr> EXPR"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:123
msgid ""
"Instead of launching the external editor, non-interactively apply the Perl "
"expression C<EXPR> to each line in the file. See L</NON-INTERACTIVE "
"EDITING> below."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:127
msgid ""
"Be careful to properly quote the expression to prevent it from being altered "
"by the shell."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:130
msgid "Note that this option is only available when Perl 5 is installed."
msgstr ""
#. type: =item
#: ../edit/virt-edit.pod:132
msgid "B<--format> raw|qcow2|..."
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:143
#, no-wrap
msgid ""
" virt-edit --format=raw -a disk.img file\n"
"\n"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:147
#, no-wrap
msgid ""
" virt-edit --format=raw -a disk.img --format -a another.img file\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:181
msgid "Previous versions of virt-edit allowed you to write either:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:187
#, no-wrap
msgid ""
" virt-edit guestname file\n"
"\n"
msgstr ""
#. type: =head1
#: ../edit/virt-edit.pod:195
msgid "NON-INTERACTIVE EDITING"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:197
msgid ""
"C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
"administrator can interactively edit the file."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:200
msgid ""
"There are two ways also to use C<virt-edit> from scripts in order to make "
"automated edits to files. (Note that although you I<can> use C<virt-edit> "
"like this, it's less error-prone to write scripts directly using the "
"libguestfs API and Augeas for configuration file editing.)"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:206
msgid ""
"The first method is to temporarily set C<$EDITOR> to any script or program "
"you want to run. The script is invoked as C<$EDITOR tmpfile> and it should "
"update C<tmpfile> in place however it likes."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:210
msgid ""
"The second method is to use the I<-e> parameter of C<virt-edit> to run a "
"short Perl snippet in the style of L<sed(1)>. For example to replace all "
"instances of C<foo> with C<bar> in a file:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:214
#, no-wrap
msgid ""
" virt-edit -d domname filename -e 's/foo/bar/'\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:216
msgid ""
"The full power of Perl regular expressions can be used (see L<perlre(1)>). "
"For example to delete root's password you could do:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:219
#, no-wrap
msgid ""
" virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
"\n"
msgstr ""
#. 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<apache> user account from the password file you can do:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:229
#, no-wrap
msgid ""
" virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:231
msgid ""
"To insert a line, prepend or append it to C<$_>. However appending lines to "
"the end of the file is rather difficult this way since there is no concept "
"of \"last line of the file\" - your expression just doesn't get called "
"again. You might want to use the first method (setting C<$EDITOR>) if you "
"want to do this."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:237
msgid ""
"The variable C<$lineno> contains the current line number. As is "
"traditional, the first line in the file is number C<1>."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:240
msgid ""
"The return value from the expression is ignored, but the expression may call "
"C<die> in order to abort the whole program, leaving the original file "
"untouched."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:244
msgid ""
"Remember when matching the end of a line that C<$_> may contain the final C<"
"\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
"newline then neither of these. Thus to match or substitute some text at the "
"end of a line, use this regular expression:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:249
#, no-wrap
msgid ""
" /some text(\\r?\\n)?$/\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:251
msgid ""
"Alternately, use the perl C<chomp> function, being careful not to chomp C<"
"$_> itself (since that would remove all newlines from the file):"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:255
#, no-wrap
msgid ""
" my $m = $_; chomp $m; $m =~ /some text$/\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:259
msgid ""
"C<virt-edit> has a limited ability to understand Windows drive letters and "
"paths (eg. C<E:\\foo\\bar.txt>)."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:278
msgid ""
"The path is resolved case insensitively to locate the file that should be "
"edited."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:299
msgid ""
"L<guestfish(1)> is a more powerful, lower level tool which you can use when "
"C<virt-edit> doesn't work."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:302
msgid "Using C<virt-edit> is approximately equivalent to doing:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:304
#, no-wrap
msgid ""
" guestfish --rw -i -d domname edit /file\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:306
msgid ""
"where C<domname> is the name of the libvirt guest, and C</file> is the full "
"path to the file."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:309
msgid ""
"The command above uses libguestfs's guest inspection feature and so does not "
"work on guests that libguestfs cannot inspect, or on things like arbitrary "
"disk images that don't contain guests. To edit a file on a disk image "
"directly, use:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:314
#, no-wrap
msgid ""
" guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
"\n"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:316
msgid ""
"where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
"the disk image to edit, and C</file> is the full path to the file."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:320
msgid ""
"C<virt-edit> cannot create new files. Use the guestfish commands C<touch>, "
"C<write> or C<upload> instead:"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:323
#, no-wrap
msgid ""
" guestfish --rw -i -d domname touch /newfile\n"
"\n"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:325
#, no-wrap
msgid ""
" guestfish --rw -i -d domname write /newfile \"new content\"\n"
"\n"
msgstr ""
#. type: verbatim
#: ../edit/virt-edit.pod:327
#, no-wrap
msgid ""
" guestfish --rw -i -d domname upload localfile /newfile\n"
"\n"
msgstr ""
#. type: =head1
#: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1119
#: ../rescue/virt-rescue.pod:261 ../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<EDITOR>"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:335
msgid ""
"If set, this string is used as the editor. It may contain arguments, eg. C<"
"\"emacs -nw\">"
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:338
msgid "If not set, C<vi> is used."
msgstr ""
#. type: textblock
#: ../edit/virt-edit.pod:356
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
"tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
"L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:5
msgid "guestfs-erlang - How to use libguestfs from Erlang"
msgstr ""
#. type: verbatim
#: ../erlang/examples/guestfs-erlang.pod:9
#, no-wrap
msgid ""
" {ok, G} = guestfs:create(),\n"
" ok = guestfs:add_drive_opts(G, Disk,\n"
" [{format, \"raw\"}, {readonly, true}]),\n"
" ok = guestfs:launch(G),\n"
" [Device] = guestfs:list_devices(G),\n"
" ok = guestfs:close(G).\n"
"\n"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:18
msgid ""
"This manual page documents how to call libguestfs from the Erlang "
"programming language. This page just documents the differences from the C "
"API and gives some examples. If you are not familiar with using libguestfs, "
"you also need to read L<guestfs(3)>."
msgstr ""
#. type: =head2
#: ../erlang/examples/guestfs-erlang.pod:23
msgid "OPENING AND CLOSING THE HANDLE"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:25
msgid ""
"The Erlang bindings are implemented using an external program called C<erl-"
"guestfs>. This program must be on the current PATH, or else you should "
"specify the full path to the program:"
msgstr ""
#. type: verbatim
#: ../erlang/examples/guestfs-erlang.pod:29
#, no-wrap
msgid ""
" {ok, G} = guestfs:create().\n"
"\n"
msgstr ""
#. type: verbatim
#: ../erlang/examples/guestfs-erlang.pod:31
#, no-wrap
msgid ""
" {ok, G} = guestfs:create(\"/path/to/erl-guestfs\").\n"
"\n"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:33
msgid "C<G> is the libguestfs handle which you should pass to other functions."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:36
msgid "To close the handle:"
msgstr ""
#. type: verbatim
#: ../erlang/examples/guestfs-erlang.pod:38
#, no-wrap
msgid ""
" ok = guestfs:close(G).\n"
"\n"
msgstr ""
#. type: =head2
#: ../erlang/examples/guestfs-erlang.pod:40
msgid "FUNCTIONS WITH OPTIONAL ARGUMENTS"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:42
msgid ""
"For functions that take optional arguments, the first arguments are the non-"
"optional ones. The last argument is a list of tuples supplying the "
"remaining optional arguments."
msgstr ""
#. type: verbatim
#: ../erlang/examples/guestfs-erlang.pod:46
#, no-wrap
msgid ""
" ok = guestfs:add_drive_opts(G, Disk,\n"
" [{format, \"raw\"}, {readonly, true}]).\n"
"\n"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:49
msgid "If the last argument would be an empty list, you can also omit it:"
msgstr ""
#. type: verbatim
#: ../erlang/examples/guestfs-erlang.pod:51
#, no-wrap
msgid ""
" ok = guestfs:add_drive_opts(G, Disk).\n"
"\n"
msgstr ""
#. type: =head2
#: ../erlang/examples/guestfs-erlang.pod:53
msgid "RETURN VALUES AND ERRORS"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:55
msgid ""
"On success, most functions return a C<Result> term (which could be a list, "
"string, tuple etc.). If there is nothing for the function to return, then "
"the atom C<ok> is returned."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:59
msgid "On error, you would see one of the following tuples:"
msgstr ""
#. type: =item
#: ../erlang/examples/guestfs-erlang.pod:63
msgid "C<{error, Msg, Errno}>"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:65
msgid "This indicates an ordinary error from the function."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:67
msgid ""
"C<Msg> is the error message (string) and C<Errno> is the Unix error "
"(integer)."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:70
msgid "C<Errno> can be zero. See L<guestfs(3)/guestfs_last_errno>."
msgstr ""
#. type: =item
#: ../erlang/examples/guestfs-erlang.pod:72
msgid "C<{unknown, Function}>"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:74
msgid ""
"This indicates that the function you called is not known. Generally this "
"means you are mixing C<erl-guestfs> from another version of libguestfs, "
"which you should not do."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:78
msgid "C<Function> is the name of the unknown function."
msgstr ""
#. type: =item
#: ../erlang/examples/guestfs-erlang.pod:80
msgid "C<{unknownarg, Arg}>"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:82
msgid ""
"This indicates that you called a function with optional arguments, with an "
"unknown argument name."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:85
msgid "C<Arg> is the name of the unknown argument."
msgstr ""
#. type: =head1
#: ../erlang/examples/guestfs-erlang.pod:89
#: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37
#: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31
#: ../python/examples/guestfs-python.pod:34
#: ../ruby/examples/guestfs-ruby.pod:28
msgid "EXAMPLE 1: CREATE A DISK IMAGE"
msgstr ""
#. 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 ""
#. 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 ""
#. 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 ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:99
msgid ""
"L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
">, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
"L<guestfs-ruby(3)>, L<http://www.erlang.org/>. L<http://libguestfs.org/>."
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:389 ../java/examples/guestfs-java.pod:58
#: ../ocaml/examples/guestfs-ocaml.pod:91 ../perl/examples/guestfs-perl.pod:52
#: ../python/examples/guestfs-python.pod:54
#: ../ruby/examples/guestfs-ruby.pod:48 ../src/guestfs.pod:3348
#: ../test-tool/libguestfs-test-tool.pod:106
msgid "AUTHORS"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:112
#: ../examples/guestfs-examples.pod:47 ../examples/guestfs-recipes.pod:399
#: ../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<rjones at redhat dot com>)"
msgstr ""
#. 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<http://libguestfs.org/>"
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:118
#: ../examples/guestfs-examples.pod:53 ../examples/guestfs-recipes.pod:405
#: ../java/examples/guestfs-java.pod:66 ../ocaml/examples/guestfs-ocaml.pod:99
#: ../perl/examples/guestfs-perl.pod:60
#: ../python/examples/guestfs-python.pod:62
#: ../ruby/examples/guestfs-ruby.pod:56
msgid ""
"The examples in this manual page may be freely copied, modified and "
"distributed without any restrictions."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:121
#: ../examples/guestfs-examples.pod:56 ../examples/guestfs-recipes.pod:408
#: ../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 ""
"This library is free software; you can redistribute it and/or modify it "
"under the terms of the GNU Lesser General Public License as published by the "
"Free Software Foundation; either version 2 of the License, or (at your "
"option) any later version."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:126
#: ../examples/guestfs-examples.pod:61 ../examples/guestfs-recipes.pod:413
#: ../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 ""
"This library is distributed in the hope that it will be useful, but WITHOUT "
"ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
"FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License "
"for more details."
msgstr ""
#. type: textblock
#: ../erlang/examples/guestfs-erlang.pod:131
#: ../examples/guestfs-examples.pod:66 ../examples/guestfs-recipes.pod:418
#: ../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 ""
"You should have received a copy of the GNU Lesser General Public License "
"along with this library; if not, write to the Free Software Foundation, "
"Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
msgstr ""
#. type: textblock
#: ../examples/guestfs-examples.pod:5
msgid "guestfs-examples - Examples of using libguestfs from C"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9
#, no-wrap
msgid ""
" #include <guestfs.h>\n"
" \n"
msgstr "#include <guestfs.h>\n"
#. type: verbatim
#: ../examples/guestfs-examples.pod:11
#, no-wrap
msgid ""
" guestfs_h *g = guestfs_create ();\n"
" guestfs_add_drive_ro (g, \"disk.img\");\n"
" guestfs_launch (g);\n"
"\n"
msgstr ""
#. 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"
"or:\n"
" cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
"\n"
#. type: textblock
#: ../examples/guestfs-examples.pod:21
msgid ""
"This manual page contains examples of calling libguestfs from the C "
"programming language. If you are not familiar with using libguestfs, you "
"also need to read L<guestfs(3)>."
msgstr ""
#. type: textblock
#: ../examples/guestfs-examples.pod:35
msgid ""
"L<guestfs(3)>, L<guestfs-erlang(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
">, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
"L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
msgstr ""
#. type: textblock
#: ../examples/guestfs-examples.pod:51 ../ocaml/examples/guestfs-ocaml.pod:97
#: ../python/examples/guestfs-python.pod:60
#: ../ruby/examples/guestfs-ruby.pod:54
msgid "Copyright (C) 2010 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
#. type: =end
#: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12
msgid "comment"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:5
msgid ""
"pod2man and pod2html have differing bugs which makes it hard to write URLs "
"here. The only way which works for both sorts of output is to just write "
"the URL directly. Do NOT use L<...> for URLs."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:9
msgid ""
"We break with tradition here and don't use ALL CAPS for the section "
"headings, as this makes them much easier to read."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:16
msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:20
msgid ""
"This page contains recipes for and links to things you can do using "
"libguestfs, L<guestfish(1)> and the virt tools."
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:23
msgid "Audit a virtual machine for setuid files"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:25
msgid ""
"The link below contains a small program which can be used to audit a Linux "
"virtual machine to see what setuid and setgid files it contains."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:28
msgid ""
"https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-"
"files/#content"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:30
msgid "Change the background image in a Windows XP VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:32
msgid ""
"The links below explain how to use L<guestfish(1)> to change the background "
"image for a user of a Windows XP VM. Unfortunately the technique appears to "
"be substantially different for each version of Windows."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:37
msgid ""
"https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://"
"lists.fedoraproject.org/pipermail/virt/2011-May/002658.html"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:40
msgid "Cloning a virtual machine (Linux)"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:42
msgid ""
"The guestfish technique described in the link below works well for most "
"Linux VMs. Depending on the Linux distro you may need to change the paths "
"slightly."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:46
msgid ""
"https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-"
"vm/#content"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:48
msgid ""
"Avoid L<virt-clone(1)>. Currently what to do about virt-clone is under "
"discussion."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:51
msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:53
msgid "Cloning a virtual machine (Windows)"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:55
msgid ""
"It is possible to do a \"sysprep\" using libguestfs alone, although not "
"straightforward. Currently there is code in the Aeolus Oz project which "
"does this (using libguestfs). As part of our review of the virt-clone tool, "
"we may add sysprepping ability."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:60
msgid ""
"https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-"
"list/2011-May/msg00019.html"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:63
msgid "Convert a CD-ROM / DVD / ISO to a tarball"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:65
msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:67
#, no-wrap
msgid ""
" guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:69
msgid "To export just a subdirectory, eg. C</files>, do:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:71
#, no-wrap
msgid ""
" guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n"
"\n"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:73
msgid "Create empty disk images"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:75
msgid ""
"You can use the L<guestfish(1)> I<-N> option to create empty disk images. "
"The useful guide below explains the options available."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:78
msgid ""
"https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/"
"#content"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:80
msgid "Dump raw filesystem content from inside a disk image or VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:82
msgid ""
"You can use the L<guestfish(1)> C<download> command to extract the raw "
"filesystem content from any filesystem in a disk image or a VM (even one "
"which is encrypted or buried inside an LV):"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:86
#, no-wrap
msgid ""
" guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n"
"\n"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:88
#, no-wrap
msgid ""
" guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:90
msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>."
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:92
msgid "Edit grub configuration in a VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:94
msgid "You can use this to:"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:100
msgid "Fix a virtual machine that does not boot."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:104
msgid "Change which kernel is used to boot the VM."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:108
msgid "Change kernel command line options."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:112
msgid "Use L<virt-edit(1)> to edit the grub configuration:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:114
#, no-wrap
msgid ""
" virt-edit -d BrokenGuest /boot/grub/grub.conf\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:116
msgid ""
"or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like "
"this:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:119
#, no-wrap
msgid ""
" virt-rescue -d BrokenGuest\n"
"\n"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:121
msgid "Export any directory from a VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:123
msgid ""
"To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:126
#, no-wrap
msgid ""
" virt-copy-out -d Guest /home .\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9
#: ../fish/guestfish-actions.pod:1450 ../fish/guestfish-actions.pod:1715
#: ../fish/guestfish-actions.pod:2132 ../src/guestfs-actions.pod:18
#: ../src/guestfs-actions.pod:2334 ../src/guestfs-actions.pod:2758
#: ../src/guestfs-actions.pod:3317 ../src/guestfs.pod:1685
#: ../tools/virt-win-reg.pl:717
msgid "Notes:"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:134
msgid ""
"The final dot of the command is not a printing error. It means we want to "
"copy out to the current directory."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:139
msgid "This creates a directory called C<home> under the current directory."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:143
msgid ""
"If the guest is a Windows guest then you can use drive letters and "
"backslashes, but you must prefix the path with C<win:> and quote it to "
"protect it from the shell, like this:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:147
#, no-wrap
msgid ""
" virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:149
msgid "To get the output as a compressed tarball, do:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:151
#, no-wrap
msgid ""
" virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:153
msgid ""
"Although it sounds tempting, this is usually not a reliable way to get a "
"backup from a running guest. See the entry in the FAQ: http://libguestfs."
"org/FAQ.html#backup"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:157
msgid "Find out which user is using the most space"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:159
msgid ""
"This simple script examines a Linux guest to find out which user is using "
"the most space in their home directory:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:162
#, no-wrap
msgid ""
" #!/bin/sh -\n"
" \n"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:164 ../fish/guestfish.pod:984
#, no-wrap
msgid ""
" set -e\n"
" \n"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:166
#, no-wrap
msgid ""
" vm=\"$1\"\n"
" dir=/home\n"
" \n"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:169
#, no-wrap
msgid ""
" eval $(guestfish --ro -d \"$vm\" -i --listen)\n"
" \n"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:171
#, no-wrap
msgid ""
" for d in $(guestfish --remote ls \"$dir\"); do\n"
" echo -n \"$dir/$d\"\n"
" echo -ne '\\t'\n"
" guestfish --remote du \"$dir/$d\";\n"
" done | sort -nr -k 2\n"
" \n"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941
#, no-wrap
msgid ""
" guestfish --remote exit\n"
"\n"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:179
msgid "Get DHCP address from a VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:181
msgid ""
"The link below explains the many different possible techniques for getting "
"the last assigned DHCP address of a virtual machine."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:184
msgid ""
"https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-"
"a-virtual-machine-disk-image/#content"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:186
msgid ""
"In the libguestfs source examples directory you will find the latest version "
"of the C<virt-dhcp-address.c> program."
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:189
msgid "Get the operating system product name string"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:191
msgid "Save the following script into a file called C<product-name.sh>:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:193
#, no-wrap
msgid ""
" #!/bin/sh -\n"
" set -e\n"
" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
" root=\"$(guestfish --remote inspect-get-roots)\"\n"
" guestfish --remote inspect-get-product-name \"$root\"\n"
" guestfish --remote exit\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:200
msgid "Make the script executable and run it on a named guest:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:202
#, no-wrap
msgid ""
" # product-name.sh RHEL60x64\n"
" Red Hat Enterprise Linux Server release 6.0 (Santiago)\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:205
msgid ""
"You can also use an XPath query on the L<virt-inspector(1)> XML using the "
"C<xpath> command line tool or from your favourite programming language:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:209
#, no-wrap
msgid ""
" # virt-inspector RHEL60x64 > xml\n"
" # xpath '//product_name' < xml\n"
" Found 1 nodes:\n"
" -- NODE --\n"
" <product_name>Red Hat Enterprise Linux Server release 6.0 (Santiago)</product_name>\n"
"\n"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:215
msgid "Get the default boot kernel for a Linux VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:217
msgid ""
"The link below contains a program to print the default boot kernel for a "
"Linux VM."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:220
msgid ""
"https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-"
"kernel-for-a-vm/#content"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:222
msgid ""
"It uses Augeas, and the technique is generally applicable for many different "
"tasks, such as:"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:229
msgid "listing the user accounts in the guest"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:233
msgid "what repositories is it configured to use"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:237
msgid "what NTP servers does it connect to"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:241
msgid "what were the boot messages last time it booted"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:245
msgid "listing who was logged in recently"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:249
msgid "http://augeas.net/"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:251
msgid "Install RPMs in a guest"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:253
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."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:259
msgid ""
"https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:261
msgid "List applications installed in a VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:263
msgid "Save the following to a file C<list-apps.sh>:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:265
#, no-wrap
msgid ""
" #!/bin/sh -\n"
" set -e\n"
" eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
" root=\"$(guestfish --remote inspect-get-roots)\"\n"
" guestfish --remote inspect-list-applications \"$root\"\n"
" guestfish --remote exit\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:272
msgid ""
"Make the file executable and then you can run it on any named virtual "
"machine:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:275
#, no-wrap
msgid ""
" # list-apps.sh WinGuest\n"
" [0] = {\n"
" app_name: Mozilla Firefox (3.6.12)\n"
" app_display_name: Mozilla Firefox (3.6.12)\n"
" app_epoch: 0\n"
" app_version: 3.6.12 (en-GB)\n"
" app_release:\n"
" app_install_path: C:\\Program Files\\Mozilla Firefox\n"
" app_trans_path:\n"
" app_publisher: Mozilla\n"
" app_url: http://www.mozilla.com/en-GB/\n"
" app_source_package:\n"
" app_summary:\n"
" app_description: Mozilla Firefox\n"
" }\n"
" [1] = {\n"
" app_name: VLC media player\n"
" app_display_name: VLC media player 1.1.5\n"
" app_epoch: 0\n"
" app_version: 1.1.5\n"
" app_release:\n"
" app_install_path: C:\\Program Files\\VideoLAN\\VLC\n"
" app_trans_path:\n"
" app_publisher: VideoLAN\n"
" app_url: http://www.videolan.org/\n"
" app_source_package:\n"
" app_summary:\n"
" app_description:\n"
" }\n"
"\n"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:305
msgid ""
"If you want to run the script on disk images (instead of libvirt virtual "
"machines), change C<-d \"$1\"> to C<-a \"$1\">. See also L<virt-inspector(1)"
">."
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:309
msgid "List files and directories in a VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:311
msgid "This involves using the L<guestfish(1)> C<find0> command like this:"
msgstr ""
#. type: verbatim
#: ../examples/guestfs-recipes.pod:313
#, no-wrap
msgid ""
" guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n"
"\n"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:315
msgid "List services in a Windows VM"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:317
msgid ""
"The link below contains a script that can be used to list out the services "
"from a Windows VM, and whether those services run at boot time or are loaded "
"on demand."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:321
msgid ""
"https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/"
"#content"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:323
msgid "Make a disk image sparse"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:325
msgid ""
"The link below contains some guides for making a disk image sparse (or "
"reintroducing sparseness)."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:328
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"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:332
msgid ""
"You can use L<virt-df(1)> to monitor disk usage of your guests over time. "
"The link below contains a guide."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:335
msgid "http://virt-tools.org/learning/advanced-virt-df/"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:337
msgid "Reading the Windows Event Log from Windows Vista (or later)"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:339
msgid ""
"L<guestfish(1)> plus the tools described in the link below can be used to "
"read out the Windows Event Log from any virtual machine running Windows "
"Vista or a later version."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:343
msgid ""
"https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-"
"guestfish/#content"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:345
msgid "Remove root password (Linux)"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:347
msgid ""
"Using the L<virt-edit(1)> 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
#: ../examples/guestfs-recipes.pod:350
#, no-wrap
msgid ""
" virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
"\n"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:352
msgid "Remove Administrator password (Windows)"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:354
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:"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:359
msgid ""
"https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-"
"administrator-password-with-guestfish/"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:361
msgid "Unpack a live CD"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:363
msgid ""
"Linux live CDs often contain multiple layers of disk images wrapped like a "
"Russian doll. You can use L<guestfish(1)> to look inside these multiple "
"layers, as outlined in the guide below."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:367
msgid ""
"https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-"
"cd/#content"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:369
msgid "Uploading and downloading files"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:371
msgid ""
"The link below contains general tips on uploading (copying in) and "
"downloading (copying out) files from VMs."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:374
msgid ""
"https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content"
msgstr ""
#. type: =head1
#: ../examples/guestfs-recipes.pod:376
msgid "Use libguestfs tools on VMware ESX guests"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:378
msgid ""
"The link below explains how to use libguestfs, L<guestfish(1)> and the virt "
"tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:382
msgid ""
"https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-"
"guests/#content"
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:386
msgid ""
"L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<guestfs-erlang(3)"
">, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-"
"python(3)>, L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
msgstr ""
#. type: textblock
#: ../examples/guestfs-recipes.pod:403
msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1
msgid "add-cdrom"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:3
#, no-wrap
msgid ""
" add-cdrom filename\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."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:16
msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:15
msgid ""
"This call checks for the existence of C<filename>. This stops you from "
"specifying other types of drive which are supported by qemu such as C<nbd:> "
"and C<http:> URLs. To specify those, use the general L</config> call "
"instead."
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</add-"
"drive-ro> instead."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:214
#: ../fish/guestfish-actions.pod:228
msgid ""
"I<This function is deprecated.> In new code, use the L</add_drive_opts> call "
"instead."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:217
#: ../fish/guestfish-actions.pod:231 ../fish/guestfish-actions.pod:941
#: ../fish/guestfish-actions.pod:976 ../fish/guestfish-actions.pod:1149
#: ../fish/guestfish-actions.pod:1509 ../fish/guestfish-actions.pod:1523
#: ../fish/guestfish-actions.pod:3284 ../fish/guestfish-actions.pod:3595
#: ../fish/guestfish-actions.pod:3643 ../fish/guestfish-actions.pod:4561
#: ../fish/guestfish-actions.pod:4581 ../fish/guestfish-actions.pod:4600
#: ../fish/guestfish-actions.pod:4638 ../fish/guestfish-actions.pod:5287
#: ../fish/guestfish-actions.pod:5390 ../src/guestfs-actions.pod:10
#: ../src/guestfs-actions.pod:305 ../src/guestfs-actions.pod:326
#: ../src/guestfs-actions.pod:1580 ../src/guestfs-actions.pod:1637
#: ../src/guestfs-actions.pod:1920 ../src/guestfs-actions.pod:2419
#: ../src/guestfs-actions.pod:2440 ../src/guestfs-actions.pod:5076
#: ../src/guestfs-actions.pod:5598 ../src/guestfs-actions.pod:5698
#: ../src/guestfs-actions.pod:6994 ../src/guestfs-actions.pod:7035
#: ../src/guestfs-actions.pod:7066 ../src/guestfs-actions.pod:7126
#: ../src/guestfs-actions.pod:8058 ../src/guestfs-actions.pod:8167
#: ../src/guestfs-actions.pod:8347
msgid ""
"Deprecated functions will not be removed from the API, but the fact that "
"they are deprecated indicates that there are problems with correct use of "
"these functions."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:35
msgid "add-domain"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:37
msgid "domain"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:39
#, no-wrap
msgid ""
" add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..] [readonlydisk:..]\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:41
msgid ""
"This function adds the disk(s) attached to the named libvirt domain C<dom>. "
"It works by connecting to libvirt, requesting the domain and domain XML from "
"libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:65
msgid ""
"The number of disks added is returned. This operation is atomic: if an "
"error is returned, then no disks are added."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:68
msgid ""
"This function does some minimal checks to make sure the libvirt domain is "
"not running (unless C<readonly> is true). In a future version we will try "
"to acquire the libvirt lock on each disk."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:72
msgid ""
"Disks must be accessible locally. This often means that adding disks from a "
"remote libvirt connection (see L<http://libvirt.org/remote.html>) will fail "
"unless those disks are accessible via the same device path locally too."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:77
msgid ""
"The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
"libvirt.org/uri.html>). If this is not set then we connect to the default "
"libvirt URI (or one set through an environment variable, see the libvirt "
"documentation for full details)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:83
msgid ""
"The optional C<live> flag controls whether this call will try to connect to "
"a running virtual machine C<guestfsd> process if it sees a suitable "
"E<lt>channelE<gt> element in the libvirt XML definition. The default (if "
"the flag is omitted) is never to try. See L<guestfs(3)/ATTACHING TO RUNNING "
"DAEMONS> for more information."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:90
msgid ""
"If the C<allowuuid> flag is true (default is false) then a UUID I<may> be "
"passed instead of the domain name. The C<dom> string is treated as a UUID "
"first and looked up, and if that lookup fails then we treat C<dom> as a name "
"as usual."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:76 ../src/guestfs-actions.pod:95
msgid ""
"The optional C<readonlydisk> parameter controls what we do for disks which "
"are marked E<lt>readonly/E<gt> in the libvirt XML. Possible values are:"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:82 ../src/guestfs-actions.pod:101
msgid "readonlydisk = \"error\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:84 ../fish/guestfish-actions.pod:95
#: ../fish/guestfish-actions.pod:106 ../src/guestfs-actions.pod:103
#: ../src/guestfs-actions.pod:114 ../src/guestfs-actions.pod:125
msgid "If C<readonly> is false:"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:86 ../src/guestfs-actions.pod:105
msgid ""
"The whole call is aborted with an error if any disk with the E<lt>readonly/"
"E<gt> flag is found."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:89 ../fish/guestfish-actions.pod:100
#: ../fish/guestfish-actions.pod:110 ../src/guestfs-actions.pod:108
#: ../src/guestfs-actions.pod:119 ../src/guestfs-actions.pod:129
msgid "If C<readonly> is true:"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:91 ../fish/guestfish-actions.pod:102
#: ../fish/guestfish-actions.pod:112 ../src/guestfs-actions.pod:110
#: ../src/guestfs-actions.pod:121 ../src/guestfs-actions.pod:131
msgid "Disks with the E<lt>readonly/E<gt> flag are added read-only."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:93 ../src/guestfs-actions.pod:112
msgid "readonlydisk = \"read\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:97 ../src/guestfs-actions.pod:116
msgid ""
"Disks with the E<lt>readonly/E<gt> flag are added read-only. Other disks "
"are added read/write."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:104 ../src/guestfs-actions.pod:123
msgid "readonlydisk = \"write\" (default)"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:108 ../src/guestfs-actions.pod:127
msgid "Disks with the E<lt>readonly/E<gt> flag are added read/write."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:114 ../src/guestfs-actions.pod:133
msgid "readonlydisk = \"ignore\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:116 ../src/guestfs-actions.pod:135
msgid "If C<readonly> is true or false:"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:118 ../src/guestfs-actions.pod:137
msgid "Disks with the E<lt>readonly/E<gt> flag are skipped."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:122
msgid ""
"The other optional parameters are passed directly through to L</add-drive-"
"opts>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:125 ../fish/guestfish-actions.pod:194
#: ../fish/guestfish-actions.pod:624 ../fish/guestfish-actions.pod:835
#: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:894
#: ../fish/guestfish-actions.pod:903 ../fish/guestfish-actions.pod:912
#: ../fish/guestfish-actions.pod:926 ../fish/guestfish-actions.pod:2171
#: ../fish/guestfish-actions.pod:3333 ../fish/guestfish-actions.pod:3496
#: ../fish/guestfish-actions.pod:3631
msgid ""
"This command has one or more optional arguments. See L</OPTIONAL ARGUMENTS>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:127
msgid "add-drive"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:129
#, no-wrap
msgid ""
" add-drive filename\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:131
msgid ""
"This function is the equivalent of calling L</add-drive-opts> with no "
"optional parameters, so the disk is added writable, with the format being "
"detected automatically."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:135
msgid ""
"Automatic detection of the format opens you up to a potential security hole "
"when dealing with untrusted raw-format images. See CVE-2010-3851 and "
"RHBZ#642934. Specifying the format closes this security hole. Therefore "
"you should think about replacing calls to this function with calls to L</add-"
"drive-opts>, and specifying the format."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:142
msgid "add-drive-opts"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:144
msgid "add"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:146
#, no-wrap
msgid ""
" add-drive-opts filename [readonly:..] [format:..] [iface:..] [name:..]\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:148 ../src/guestfs-actions.pod:208
msgid ""
"This function adds a virtual machine disk image C<filename> to libguestfs. "
"The first time you call this function, the disk appears as C</dev/sda>, the "
"second time as C</dev/sdb>, and so on."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:153 ../src/guestfs-actions.pod:213
msgid ""
"You don't necessarily need to be root when using libguestfs. However you "
"obviously do need sufficient permissions to access the filename for whatever "
"operations you want to perform (ie. read access if you just want to read the "
"image or write access if you want to modify the image)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:159 ../src/guestfs-actions.pod:219
msgid "This call checks that C<filename> exists."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:3295
#: ../src/guestfs-actions.pod:221 ../src/guestfs-actions.pod:5113
msgid "The optional arguments are:"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:165 ../src/guestfs-actions.pod:225
msgid "C<readonly>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:167 ../src/guestfs-actions.pod:227
msgid ""
"If true then the image is treated as read-only. Writes are still allowed, "
"but they are stored in a temporary snapshot overlay which is discarded at "
"the end. The disk that you add is not modified."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:171 ../src/guestfs-actions.pod:231
msgid "C<format>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:173
msgid ""
"This forces the image format. If you omit this (or use L</add-drive> or L</"
"add-drive-ro>) then the format is automatically detected. Possible formats "
"include C<raw> and C<qcow2>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:177 ../src/guestfs-actions.pod:237
msgid ""
"Automatic detection of the format opens you up to a potential security hole "
"when dealing with untrusted raw-format images. See CVE-2010-3851 and "
"RHBZ#642934. Specifying the format closes this security hole."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:182 ../src/guestfs-actions.pod:242
msgid "C<iface>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:184
msgid ""
"This rarely-used option lets you emulate the behaviour of the deprecated L</"
"add-drive-with-if> call (q.v.)"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:187 ../src/guestfs-actions.pod:247
msgid "C<name>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:189 ../src/guestfs-actions.pod:249
msgid ""
"The name the drive had in the original guest, e.g. /dev/sdb. This is used as "
"a hint to the guest inspection process if it is available."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:196
msgid "add-drive-ro"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:198
msgid "add-ro"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:200
#, no-wrap
msgid ""
" add-drive-ro filename\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:202
msgid ""
"This function is the equivalent of calling L</add-drive-opts> with the "
"optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
"is added read-only, with the format being detected automatically."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:207
msgid "add-drive-ro-with-if"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:209
#, no-wrap
msgid ""
" add-drive-ro-with-if filename iface\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:211
msgid ""
"This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
"interface emulation to use at run time."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:221
msgid "add-drive-with-if"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:223
#, no-wrap
msgid ""
" add-drive-with-if filename iface\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:225
msgid ""
"This is the same as L</add-drive> but it allows you to specify the QEMU "
"interface emulation to use at run time."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:235
msgid "aug-clear"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:237
#, no-wrap
msgid ""
" aug-clear augpath\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:239 ../src/guestfs-actions.pod:343
msgid ""
"Set the value associated with C<path> to C<NULL>. This is the same as the "
"L<augtool(1)> C<clear> command."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:242
msgid "aug-close"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:244
#, no-wrap
msgid ""
" aug-close\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:246
msgid ""
"Close the current Augeas handle and free up any resources used by it. After "
"calling this, you have to call L</aug-init> again before you can use any "
"other Augeas functions."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:251
msgid "aug-defnode"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:253
#, no-wrap
msgid ""
" aug-defnode name expr val\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:372
msgid ""
"Defines a variable C<name> whose value is the result of evaluating C<expr>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:258
msgid ""
"If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
"calling L</aug-set> C<expr>, C<value>. C<name> will be the nodeset "
"containing that single node."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:379
msgid ""
"On success this returns a pair containing the number of nodes in the "
"nodeset, and a boolean flag if a node was created."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:266
msgid "aug-defvar"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:268
#, no-wrap
msgid ""
" aug-defvar name expr\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:270 ../src/guestfs-actions.pod:396
msgid ""
"Defines an Augeas variable C<name> whose value is the result of evaluating "
"C<expr>. If C<expr> is NULL, then C<name> is undefined."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:274 ../src/guestfs-actions.pod:400
msgid ""
"On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
"evaluates to something which is not a nodeset."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:277
msgid "aug-get"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:279
#, no-wrap
msgid ""
" aug-get augpath\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:281 ../src/guestfs-actions.pod:413
msgid ""
"Look up the value associated with C<path>. If C<path> matches exactly one "
"node, the C<value> is returned."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:284
msgid "aug-init"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:286
#, no-wrap
msgid ""
" aug-init root flags\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:428
msgid ""
"Create a new Augeas handle for editing configuration files. If there was "
"any previous Augeas handle associated with this guestfs session, then it is "
"closed."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:292
msgid "You must call this before using any other L</aug-*> commands."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:295 ../src/guestfs-actions.pod:435
msgid ""
"C<root> is the filesystem root. C<root> must not be NULL, use C</> instead."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:298 ../src/guestfs-actions.pod:438
msgid ""
"The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
"logical I<or> of the following integers:"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:304 ../src/guestfs-actions.pod:444
msgid "C<AUG_SAVE_BACKUP> = 1"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:306 ../src/guestfs-actions.pod:446
msgid "Keep the original file with a C<.augsave> extension."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:308 ../src/guestfs-actions.pod:448
msgid "C<AUG_SAVE_NEWFILE> = 2"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:310 ../src/guestfs-actions.pod:450
msgid ""
"Save changes into a file with extension C<.augnew>, and do not overwrite "
"original. Overrides C<AUG_SAVE_BACKUP>."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:313 ../src/guestfs-actions.pod:453
msgid "C<AUG_TYPE_CHECK> = 4"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:315 ../src/guestfs-actions.pod:455
msgid "Typecheck lenses."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:317
msgid ""
"This option is only useful when debugging Augeas lenses. Use of this option "
"may require additional memory for the libguestfs appliance. You may need to "
"set the C<LIBGUESTFS_MEMSIZE> environment variable or call L</set-memsize>."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:322 ../src/guestfs-actions.pod:462
msgid "C<AUG_NO_STDINC> = 8"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:324 ../src/guestfs-actions.pod:464
msgid "Do not use standard load path for modules."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:326 ../src/guestfs-actions.pod:466
msgid "C<AUG_SAVE_NOOP> = 16"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:328 ../src/guestfs-actions.pod:468
msgid "Make save a no-op, just record what would have been changed."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:330 ../src/guestfs-actions.pod:470
msgid "C<AUG_NO_LOAD> = 32"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:332
msgid "Do not load the tree in L</aug-init>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:336
msgid "To close the handle, you can call L</aug-close>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:478
msgid "To find out more about Augeas, see L<http://augeas.net/>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:340
msgid "aug-insert"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:342
#, no-wrap
msgid ""
" aug-insert augpath label true|false\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:492
msgid ""
"Create a new sibling C<label> for C<path>, inserting it into the tree before "
"or after C<path> (depending on the boolean flag C<before>)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:348 ../src/guestfs-actions.pod:496
msgid ""
"C<path> must match exactly one existing node in the tree, and C<label> must "
"be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:352
msgid "aug-load"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:354
#, no-wrap
msgid ""
" aug-load\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:356 ../src/guestfs-actions.pod:509
msgid "Load files into the tree."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:358 ../src/guestfs-actions.pod:511
msgid "See C<aug_load> in the Augeas documentation for the full gory details."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:361
msgid "aug-ls"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:363
#, no-wrap
msgid ""
" aug-ls augpath\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:365
msgid ""
"This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
"resulting nodes into alphabetical order."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:368
msgid "aug-match"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:370
#, no-wrap
msgid ""
" aug-match augpath\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:372 ../src/guestfs-actions.pod:539
msgid ""
"Returns a list of paths which match the path expression C<path>. The "
"returned paths are sufficiently qualified so that they match exactly one "
"node in the current tree."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:376
msgid "aug-mv"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:378
#, no-wrap
msgid ""
" aug-mv src dest\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:380 ../src/guestfs-actions.pod:556
msgid ""
"Move the node C<src> to C<dest>. C<src> must match exactly one node. "
"C<dest> is overwritten if it exists."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:383
msgid "aug-rm"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:385
#, no-wrap
msgid ""
" aug-rm augpath\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:387 ../src/guestfs-actions.pod:569
msgid "Remove C<path> and all of its children."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:389 ../src/guestfs-actions.pod:571
msgid "On success this returns the number of entries which were removed."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:391
msgid "aug-save"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:393
#, no-wrap
msgid ""
" aug-save\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:395 ../src/guestfs-actions.pod:582
msgid "This writes all pending changes to disk."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:397
msgid ""
"The flags which were passed to L</aug-init> affect exactly how files are "
"saved."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:400
msgid "aug-set"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:402
#, no-wrap
msgid ""
" aug-set augpath val\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:404 ../src/guestfs-actions.pod:598
msgid "Set the value associated with C<path> to C<val>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:406
msgid ""
"In the Augeas API, it is possible to clear a node by setting the value to "
"NULL. Due to an oversight in the libguestfs API you cannot do that with "
"this call. Instead you must use the L</aug-clear> call."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:411
msgid "available"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:413
#, no-wrap
msgid ""
" available 'groups ...'\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:415 ../src/guestfs-actions.pod:615
msgid ""
"This command is used to check the availability of some groups of "
"functionality in the appliance, which not all builds of the libguestfs "
"appliance will be able to provide."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:419
msgid ""
"The libguestfs groups, and the functions that those groups correspond to, "
"are listed in L<guestfs(3)/AVAILABILITY>. You can also fetch this list at "
"runtime by calling L</available-all-groups>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:424 ../src/guestfs-actions.pod:624
msgid ""
"The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
"\"]> would check for the availability of the Linux inotify functions and "
"Augeas (configuration file editing) functions."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:429 ../src/guestfs-actions.pod:629
msgid "The command returns no error if I<all> requested groups are available."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:431 ../src/guestfs-actions.pod:631
msgid ""
"It fails with an error if one or more of the requested groups is unavailable "
"in the appliance."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:434 ../src/guestfs-actions.pod:634
msgid ""
"If an unknown group name is included in the list of groups then an error is "
"always returned."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:437 ../src/guestfs-actions.pod:637
msgid "I<Notes:>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:443
msgid "You must call L</launch> before calling this function."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:445 ../src/guestfs-actions.pod:645
msgid ""
"The reason is because we don't know what groups are supported by the "
"appliance/daemon until it is running and can be queried."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:451 ../src/guestfs-actions.pod:651
msgid ""
"If a group of functions is available, this does not necessarily mean that "
"they will work. You still have to check for errors when calling individual "
"API functions even if they are available."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:458 ../src/guestfs-actions.pod:658
msgid ""
"It is usually the job of distro packagers to build complete functionality "
"into the libguestfs appliance. Upstream libguestfs, if built from source "
"with all requirements satisfied, will support everything."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:465
msgid ""
"This call was added in version C<1.0.80>. In previous versions of "
"libguestfs all you could do would be to speculatively execute a command to "
"find out if the daemon implemented it. See also L</version>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:472
msgid "available-all-groups"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:474
#, no-wrap
msgid ""
" available-all-groups\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:476
msgid ""
"This command returns a list of all optional groups that this daemon knows "
"about. Note this returns both supported and unsupported groups. To find "
"out which ones the daemon can actually support you have to call L</"
"available> on each member of the returned list."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:482
msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:484
msgid "base64-in"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:486
#, no-wrap
msgid ""
" base64-in (base64file|-) filename\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:488 ../src/guestfs-actions.pod:702
msgid ""
"This command uploads base64-encoded data from C<base64file> to C<filename>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:491 ../fish/guestfish-actions.pod:500
#: ../fish/guestfish-actions.pod:749 ../fish/guestfish-actions.pod:833
#: ../fish/guestfish-actions.pod:854 ../fish/guestfish-actions.pod:1025
#: ../fish/guestfish-actions.pod:1044 ../fish/guestfish-actions.pod:1418
#: ../fish/guestfish-actions.pod:4858 ../fish/guestfish-actions.pod:4870
#: ../fish/guestfish-actions.pod:4881 ../fish/guestfish-actions.pod:4892
#: ../fish/guestfish-actions.pod:4944 ../fish/guestfish-actions.pod:4953
#: ../fish/guestfish-actions.pod:5007 ../fish/guestfish-actions.pod:5030
msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:493
msgid "base64-out"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:495
#, no-wrap
msgid ""
" base64-out filename (base64file|-)\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:497 ../src/guestfs-actions.pod:716
msgid ""
"This command downloads the contents of C<filename>, writing it out to local "
"file C<base64file> encoded as base64."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:502
msgid "blockdev-flushbufs"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:504
#, no-wrap
msgid ""
" blockdev-flushbufs device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:506 ../src/guestfs-actions.pod:729
msgid ""
"This tells the kernel to flush internal buffers associated with C<device>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:509 ../fish/guestfish-actions.pod:520
#: ../fish/guestfish-actions.pod:529 ../fish/guestfish-actions.pod:539
#: ../fish/guestfish-actions.pod:551 ../fish/guestfish-actions.pod:564
#: ../fish/guestfish-actions.pod:572 ../fish/guestfish-actions.pod:583
#: ../fish/guestfish-actions.pod:591 ../fish/guestfish-actions.pod:599
#: ../src/guestfs-actions.pod:732 ../src/guestfs-actions.pod:749
#: ../src/guestfs-actions.pod:764 ../src/guestfs-actions.pod:780
#: ../src/guestfs-actions.pod:798 ../src/guestfs-actions.pod:817
#: ../src/guestfs-actions.pod:831 ../src/guestfs-actions.pod:849
#: ../src/guestfs-actions.pod:863 ../src/guestfs-actions.pod:877
msgid "This uses the L<blockdev(8)> command."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:511
msgid "blockdev-getbsz"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:513
#, no-wrap
msgid ""
" blockdev-getbsz device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:515 ../src/guestfs-actions.pod:744
msgid "This returns the block size of a device."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:517 ../fish/guestfish-actions.pod:580
#: ../src/guestfs-actions.pod:746 ../src/guestfs-actions.pod:846
msgid ""
"(Note this is different from both I<size in blocks> and I<filesystem block "
"size>)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:522
msgid "blockdev-getro"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:524
#, no-wrap
msgid ""
" blockdev-getro device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:526 ../src/guestfs-actions.pod:761
msgid ""
"Returns a boolean indicating if the block device is read-only (true if read-"
"only, false if not)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:531
msgid "blockdev-getsize64"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:533
#, no-wrap
msgid ""
" blockdev-getsize64 device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:535 ../src/guestfs-actions.pod:776
msgid "This returns the size of the device in bytes."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:537
msgid "See also L</blockdev-getsz>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:541
msgid "blockdev-getss"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:543
#, no-wrap
msgid ""
" blockdev-getss device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:545 ../src/guestfs-actions.pod:792
msgid ""
"This returns the size of sectors on a block device. Usually 512, but can be "
"larger for modern devices."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:548
msgid ""
"(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:553
msgid "blockdev-getsz"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:555
#, no-wrap
msgid ""
" blockdev-getsz device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:557 ../src/guestfs-actions.pod:810
msgid ""
"This returns the size of the device in units of 512-byte sectors (even if "
"the sectorsize isn't 512 bytes ... weird)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:560
msgid ""
"See also L</blockdev-getss> for the real sector size of the device, and L</"
"blockdev-getsize64> for the more useful I<size in bytes>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:566
msgid "blockdev-rereadpt"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:568
#, no-wrap
msgid ""
" blockdev-rereadpt device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:570 ../src/guestfs-actions.pod:829
msgid "Reread the partition table on C<device>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:574
msgid "blockdev-setbsz"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:576
#, no-wrap
msgid ""
" blockdev-setbsz device blocksize\n"
"\n"
msgstr ""
#. type: textblock
#: ../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:585
msgid "blockdev-setro"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:587
#, no-wrap
msgid ""
" blockdev-setro device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:589 ../src/guestfs-actions.pod:861
msgid "Sets the block device named C<device> to read-only."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:593
msgid "blockdev-setrw"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:595
#, no-wrap
msgid ""
" 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<device> to read-write."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:601
msgid "btrfs-filesystem-resize"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:603
#, no-wrap
msgid ""
" btrfs-filesystem-resize mountpoint [size:..]\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:605 ../src/guestfs-actions.pod:897
msgid "This command resizes a btrfs filesystem."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:607 ../src/guestfs-actions.pod:899
msgid ""
"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:611 ../fish/guestfish-actions.pod:3606
#: ../src/guestfs-actions.pod:903 ../src/guestfs-actions.pod:5637
msgid "The optional parameters are:"
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<size>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:617 ../src/guestfs-actions.pod:909
msgid ""
"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:622 ../src/guestfs-actions.pod:914
msgid "See also L<btrfs(8)>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:626
msgid "case-sensitive-path"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:628
#, no-wrap
msgid ""
" case-sensitive-path path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:630 ../src/guestfs-actions.pod:948
msgid ""
"This can be used to resolve case insensitive paths on a filesystem which is "
"case sensitive. The use case is to resolve paths which you have read from "
"Windows configuration files or the Windows Registry, to the true path."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod: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:640 ../src/guestfs-actions.pod:958
msgid ""
"One consequence of this is that special directories such as C<c:\\windows> "
"may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
"precise details of how they were created. In Windows itself this would not "
"be a problem."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:646 ../src/guestfs-actions.pod:964
msgid ""
"Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
"#posixfilenames1>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:649 ../src/guestfs-actions.pod:967
msgid ""
"This function resolves the true case of each element in the path and returns "
"the case-sensitive path."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:652
msgid ""
"Thus L</case-sensitive-path> (\"/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:657 ../src/guestfs-actions.pod:975
msgid "I<Note>: This function does not handle drive names, backslashes etc."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:660
msgid "See also L</realpath>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:662
msgid "cat"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:664
#, no-wrap
msgid ""
" cat path\n"
"\n"
msgstr ""
#. type: textblock
#: ../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<path>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:668
msgid ""
"Note that this function cannot correctly handle binary files (specifically, "
"files containing C<\\0> character which is treated as end of string). For "
"those you need to use the L</read-file> or L</download> functions which have "
"a more complex interface."
msgstr ""
#. type: textblock
#: ../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<guestfs(3)/PROTOCOL LIMITS>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:676
msgid "checksum"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:678
#, no-wrap
msgid ""
" checksum csumtype path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:680 ../src/guestfs-actions.pod:1013
msgid ""
"This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:683 ../src/guestfs-actions.pod:1016
msgid ""
"The type of checksum to compute is given by the C<csumtype> parameter which "
"must have one of the following values:"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:688 ../src/guestfs-actions.pod:1021
msgid "C<crc>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:690 ../src/guestfs-actions.pod:1023
msgid ""
"Compute the cyclic redundancy check (CRC) specified by POSIX for the "
"C<cksum> command."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:693 ../src/guestfs-actions.pod:1026
msgid "C<md5>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:695 ../src/guestfs-actions.pod:1028
msgid "Compute the MD5 hash (using the C<md5sum> program)."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:697 ../src/guestfs-actions.pod:1030
msgid "C<sha1>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:699 ../src/guestfs-actions.pod:1032
msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:701 ../src/guestfs-actions.pod:1034
msgid "C<sha224>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:703 ../src/guestfs-actions.pod:1036
msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:705 ../src/guestfs-actions.pod:1038
msgid "C<sha256>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1040
msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:709 ../src/guestfs-actions.pod:1042
msgid "C<sha384>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:711 ../src/guestfs-actions.pod:1044
msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:713 ../src/guestfs-actions.pod:1046
msgid "C<sha512>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:715 ../src/guestfs-actions.pod:1048
msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
msgstr ""
#. type: textblock
#: ../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</checksum-device>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:723
msgid "To get the checksums for many files, use L</checksums-out>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:725
msgid "checksum-device"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:727
#, no-wrap
msgid ""
" checksum-device csumtype device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:729
msgid ""
"This call computes the MD5, SHAx or CRC checksum of the contents of the "
"device named C<device>. For the types of checksums supported see the L</"
"checksum> command."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:733
msgid "checksums-out"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:735
#, no-wrap
msgid ""
" checksums-out csumtype directory (sumsfile|-)\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:737 ../src/guestfs-actions.pod:1087
msgid ""
"This command computes the checksums of all regular files in C<directory> and "
"then emits a list of those checksums to the local output file C<sumsfile>."
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:751
msgid "chmod"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:753
#, no-wrap
msgid ""
" chmod mode path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:755 ../src/guestfs-actions.pod:1110
msgid ""
"Change the mode (permissions) of C<path> to C<mode>. Only numeric modes are "
"supported."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:758 ../src/guestfs-actions.pod:1113
msgid ""
"I<Note>: When using this command from guestfish, C<mode> 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: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 ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:766
#, no-wrap
msgid ""
" chown owner group path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:768 ../src/guestfs-actions.pod:1131
msgid "Change the file owner to C<owner> and group to C<group>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:770 ../fish/guestfish-actions.pod:2703
#: ../src/guestfs-actions.pod:1133 ../src/guestfs-actions.pod:4124
msgid ""
"Only numeric uid and gid are supported. If you want to use names, you will "
"need to locate and parse the password file yourself (Augeas support makes "
"this relatively easy)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:774
msgid "command"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:776
#, no-wrap
msgid ""
" command 'arguments ...'\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:778 ../src/guestfs-actions.pod:1147
msgid ""
"This call runs a command from the guest filesystem. The filesystem must be "
"mounted, and must contain a compatible operating system (ie. something "
"Linux, with the same or compatible processor architecture)."
msgstr ""
#. type: textblock
#: ../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<not> invoked via the shell (see L</sh>)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:790 ../src/guestfs-actions.pod:1159
msgid "The return value is anything printed to I<stdout> by the command."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:793 ../src/guestfs-actions.pod:1162
msgid ""
"If the command returns a non-zero exit status, then this function returns an "
"error message. The error message string is the content of I<stderr> from "
"the command."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:797 ../src/guestfs-actions.pod:1166
msgid ""
"The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
"bin>. If you require a program from another location, you should provide "
"the full path in the first parameter."
msgstr ""
#. 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: =head2
#: ../fish/guestfish-actions.pod:811
msgid "command-lines"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:813
#, no-wrap
msgid ""
" command-lines 'arguments ...'\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:815
msgid ""
"This is the same as L</command>, but splits the result into a list of lines."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:818
msgid "See also: L</sh-lines>"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:823
msgid "compress-device-out"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:825
#, no-wrap
msgid ""
" compress-device-out ctype device (zdevice|-) [level:..]\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:827 ../src/guestfs-actions.pod:1221
msgid ""
"This command compresses C<device> and writes it out to the local file "
"C<zdevice>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:830
msgid ""
"The C<ctype> and optional C<level> parameters have the same meaning as in L</"
"compress-out>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:837
msgid "compress-out"
msgstr ""
#. 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:841 ../src/guestfs-actions.pod:1273
msgid ""
"This command compresses C<file> and writes it out to the local file C<zfile>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:844 ../src/guestfs-actions.pod:1276
msgid ""
"The compression program used is controlled by the C<ctype> parameter. "
"Currently this includes: C<compress>, C<gzip>, C<bzip2>, C<xz> or C<lzop>. "
"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:850 ../src/guestfs-actions.pod:1282
msgid ""
"The optional C<level> parameter controls compression level. The meaning and "
"default for this parameter depends on the compression program being used."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:858
msgid "config"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:860
#, no-wrap
msgid ""
" config qemuparam qemuvalue\n"
"\n"
msgstr ""
#. type: textblock
#: ../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:867 ../src/guestfs-actions.pod:1328
msgid "The first character of C<param> string must be a C<-> (dash)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:869 ../src/guestfs-actions.pod:1330
msgid "C<value> can be NULL."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:871
msgid "copy-device-to-device"
msgstr ""
#. 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:875
msgid ""
"The four calls L</copy-device-to-device>, L</copy-device-to-file>, L</copy-"
"file-to-device>, and L</copy-file-to-file> let you copy from a source "
"(device|file) to a destination (device|file)."
msgstr ""
#. type: textblock
#: ../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: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:891 ../src/guestfs-actions.pod:1369
msgid ""
"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:896
msgid "copy-device-to-file"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:898
#, no-wrap
msgid ""
" copy-device-to-file src dest [srcoffset:..] [destoffset:..] [size:..]\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:900 ../fish/guestfish-actions.pod:909
#: ../fish/guestfish-actions.pod:918
msgid "See L</copy-device-to-device> for a general overview of this call."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:905
msgid "copy-file-to-device"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:907
#, no-wrap
msgid ""
" copy-file-to-device src dest [srcoffset:..] [destoffset:..] [size:..]\n"
"\n"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:914
msgid "copy-file-to-file"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:916
#, no-wrap
msgid ""
" copy-file-to-file src dest [srcoffset:..] [destoffset:..] [size:..]\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:921
msgid ""
"This is B<not> the function you want for copying files. This is for copying "
"blocks within existing files. See L</cp>, L</cp-a> and L</mv> for general "
"file copying and moving functions."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:928
msgid "copy-size"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:930
#, no-wrap
msgid ""
" copy-size src dest size\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:932 ../src/guestfs-actions.pod:1584
msgid ""
"This command copies exactly C<size> bytes from one source device or file "
"C<src> to another destination device or file C<dest>."
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<This function is deprecated.> In new code, use the L</"
"copy_device_to_device> call instead."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:945
msgid "cp"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:947
#, no-wrap
msgid ""
" cp src dest\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:949 ../src/guestfs-actions.pod:1606
msgid ""
"This copies a file from C<src> to C<dest> where C<dest> is either a "
"destination filename or destination directory."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:952
msgid "cp-a"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:954
#, no-wrap
msgid ""
" cp-a src dest\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:956 ../src/guestfs-actions.pod:1620
msgid ""
"This copies a file or directory from C<src> to C<dest> recursively using the "
"C<cp -a> command."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:959
msgid "dd"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:961
#, no-wrap
msgid ""
" dd src dest\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:963 ../src/guestfs-actions.pod:1641
msgid ""
"This command copies from one source device or file C<src> to another "
"destination device or file C<dest>. 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: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</copy-device-to-device>)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:980
msgid "df"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:982
#, no-wrap
msgid ""
" df\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:984 ../src/guestfs-actions.pod:1660
msgid "This command runs the C<df> command to report disk space used."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:986 ../fish/guestfish-actions.pod:997
msgid ""
"This command is mostly useful for interactive sessions. It is I<not> "
"intended that you try to parse the output string. Use L</statvfs> from "
"programs."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:990
msgid "df-h"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:992
#, no-wrap
msgid ""
" df-h\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:994 ../src/guestfs-actions.pod:1676
msgid ""
"This command runs the C<df -h> command to report disk space used in human-"
"readable format."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1001
msgid "dmesg"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1003
#, no-wrap
msgid ""
" dmesg\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1005 ../src/guestfs-actions.pod:1693
msgid ""
"This returns the kernel messages (C<dmesg> output) from the guest kernel. "
"This is sometimes useful for extended debugging of problems."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1009
msgid ""
"Another way to get the same information is to enable verbose messages with "
"L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
"before running the program."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1014
msgid "download"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1016
#, no-wrap
msgid ""
" download remotefilename (filename|-)\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1018 ../fish/guestfish-actions.pod:1031
#: ../src/guestfs-actions.pod:1714 ../src/guestfs-actions.pod:1739
msgid ""
"Download file C<remotefilename> and save it as C<filename> on the local "
"machine."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1021 ../fish/guestfish-actions.pod:5003
#: ../src/guestfs-actions.pod:1717 ../src/guestfs-actions.pod:7701
msgid "C<filename> can also be a named pipe."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1023
msgid "See also L</upload>, L</cat>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1027
msgid "download-offset"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1029
#, no-wrap
msgid ""
" download-offset remotefilename (filename|-) offset size\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1034 ../src/guestfs-actions.pod:1742
msgid ""
"C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
"region must be within the file or device)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1037
msgid ""
"Note that there is no limit on the amount of data that can be downloaded "
"with this call, unlike with L</pread>, and this call always reads the full "
"amount unless an error occurs."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1042
msgid "See also L</download>, L</pread>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1046
msgid "drop-caches"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1048
#, no-wrap
msgid ""
" drop-caches whattodrop\n"
"\n"
msgstr ""
#. type: textblock
#: ../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<whattodrop> tells the kernel what precisely "
"to drop, see L<http://linux-mm.org/Drop_Caches>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1055 ../src/guestfs-actions.pod:1772
msgid "Setting C<whattodrop> to 3 should drop everything."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1057 ../src/guestfs-actions.pod:1774
msgid ""
"This automatically calls L<sync(2)> before the operation, so that the "
"maximum guest memory is freed."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1060
msgid "du"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1062
#, no-wrap
msgid ""
" du path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1064 ../src/guestfs-actions.pod:1787
msgid ""
"This command runs the C<du -s> command to estimate file space usage for "
"C<path>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1067 ../src/guestfs-actions.pod:1790
msgid ""
"C<path> can be a file or a directory. If C<path> 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<kilobytes> (ie. units of 1024 bytes)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1074
msgid "e2fsck-f"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1076
#, no-wrap
msgid ""
" e2fsck-f device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1812
msgid ""
"This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
"on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
"clean (I<-f>)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1082
msgid ""
"This command is only needed because of L</resize2fs> (q.v.). Normally you "
"should use L</fsck>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1085
msgid "echo-daemon"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1087
#, no-wrap
msgid ""
" echo-daemon 'words ...'\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1089 ../src/guestfs-actions.pod:1829
msgid ""
"This command concatenates the list of C<words> passed with single spaces "
"between them and returns the resulting string."
msgstr ""
#. type: textblock
#: ../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:1094
msgid "See also L</ping-daemon>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1096
msgid "egrep"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1098
#, no-wrap
msgid ""
" egrep regex path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1848
msgid ""
"This calls the external C<egrep> program and returns the matching lines."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1106
msgid "egrepi"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1108
#, no-wrap
msgid ""
" egrepi regex path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1867
msgid ""
"This calls the external C<egrep -i> program and returns the matching lines."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1116
msgid "equal"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1118
#, no-wrap
msgid ""
" equal file1 file2\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1886
msgid ""
"This compares the two files C<file1> and C<file2> and returns true if their "
"content is exactly equal, or false otherwise."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1123 ../src/guestfs-actions.pod:1889
msgid "The external L<cmp(1)> program is used for the comparison."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1125
msgid "exists"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1127
#, no-wrap
msgid ""
" exists path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1129 ../src/guestfs-actions.pod:1901
msgid ""
"This returns C<true> if and only if there is a file, directory (or anything) "
"with the given C<path> name."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1132
msgid "See also L</is-file>, L</is-dir>, L</stat>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1134
msgid "fallocate"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1136
#, no-wrap
msgid ""
" fallocate path len\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1138 ../fish/guestfish-actions.pod:1157
#: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:1943
msgid ""
"This command preallocates a file (containing zero bytes) named C<path> of "
"size C<len> bytes. If the file exists already, it is overwritten."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1142 ../src/guestfs-actions.pod:1928
msgid ""
"Do not confuse this with the guestfish-specific C<alloc> command which "
"allocates a file in the host and attaches it as a device."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1146
msgid ""
"I<This function is deprecated.> In new code, use the L</fallocate64> call "
"instead."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1153
msgid "fallocate64"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1155
#, no-wrap
msgid ""
" fallocate64 path len\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1161
msgid ""
"Note that this call allocates disk blocks for the file. To create a sparse "
"file use L</truncate-size> instead."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1164
msgid ""
"The deprecated call L</fallocate> 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:1169 ../src/guestfs-actions.pod:1955
msgid ""
"Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
"commands which create a file in the host and attach it as a device."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1173
msgid "fgrep"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1175
#, no-wrap
msgid ""
" fgrep pattern path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1177 ../src/guestfs-actions.pod:1970
msgid ""
"This calls the external C<fgrep> program and returns the matching lines."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1183
msgid "fgrepi"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1185
#, no-wrap
msgid ""
" fgrepi pattern path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1187 ../src/guestfs-actions.pod:1989
msgid ""
"This calls the external C<fgrep -i> program and returns the matching lines."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1193
msgid "file"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1195
#, no-wrap
msgid ""
" file path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:2007
msgid ""
"This call uses the standard L<file(1)> command to determine the type or "
"contents of the file."
msgstr ""
#. 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: textblock
#: ../fish/guestfish-actions.pod:1203 ../src/guestfs-actions.pod:2013
msgid ""
"The exact command which runs is C<file -zb path>. Note in particular that "
"the filename is not prepended to the output (the I<-b> option)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1207 ../src/guestfs-actions.pod:2017
msgid ""
"The output depends on the output of the underlying L<file(1)> 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:1211
msgid ""
"See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
"(etc), L</is-zero>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1214
msgid "file-architecture"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1216
#, no-wrap
msgid ""
" file-architecture filename\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1218 ../src/guestfs-actions.pod:2035
msgid ""
"This detects the architecture of the binary C<filename>, and returns it if "
"known."
msgstr ""
#. type: textblock
#: ../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 ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1227 ../src/guestfs-actions.pod:2044
msgid ""
"This string is returned for all 32 bit i386, i486, i586, i686 binaries "
"irrespective of the precise processor requirements of the binary."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1230 ../src/guestfs-actions.pod:2047
msgid "\"x86_64\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1232 ../src/guestfs-actions.pod:2049
msgid "64 bit x86-64."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1234 ../src/guestfs-actions.pod:2051
msgid "\"sparc\""
msgstr ""
#. 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 ""
#. type: textblock
#: ../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 ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1244 ../src/guestfs-actions.pod:2061
msgid "Intel Itanium."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:2063
msgid "\"ppc\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1248 ../src/guestfs-actions.pod:2065
msgid "32 bit Power PC."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1250 ../src/guestfs-actions.pod:2067
msgid "\"ppc64\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1252 ../src/guestfs-actions.pod:2069
msgid "64 bit Power PC."
msgstr ""
#. type: textblock
#: ../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: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:1264 ../src/guestfs-actions.pod:2081
msgid "many types of Un*x and Linux binary"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1268 ../src/guestfs-actions.pod:2085
msgid "many types of Un*x and Linux shared library"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1272 ../src/guestfs-actions.pod:2089
msgid "Windows Win32 and Win64 binaries"
msgstr ""
#. type: textblock
#: ../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<i386>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1280 ../src/guestfs-actions.pod:2097
msgid "Win64 binaries and DLLs return C<x86_64>."
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:1319
msgid "filesize"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1321
#, no-wrap
msgid ""
" filesize file\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1323 ../src/guestfs-actions.pod:2147
msgid "This command returns the size of C<file> in bytes."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1325
msgid ""
"To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
"file> etc. To get the size of block devices, use L</blockdev-getsize64>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1329
msgid "fill"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1331
#, no-wrap
msgid ""
" fill c len path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:2165
msgid ""
"This command creates a new file called C<path>. The initial content of the "
"file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
"[0..255]>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1337
msgid ""
"To fill a file with zero bytes (sparsely), it is much more efficient to use "
"L</truncate-size>. To create a file with a pattern of repeating bytes use "
"L</fill-pattern>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1342
msgid "fill-pattern"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1344
#, no-wrap
msgid ""
" fill-pattern pattern len path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1346
msgid ""
"This function is like L</fill> except that it creates a new file of length "
"C<len> containing the repeating pattern of bytes in C<pattern>. The pattern "
"is truncated if necessary to ensure the length of the file is exactly C<len> "
"bytes."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1351
msgid "find"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1353
#, no-wrap
msgid ""
" find directory\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1355 ../src/guestfs-actions.pod:2211
msgid ""
"This command lists out all files and directories, recursively, starting at "
"C<directory>. It is essentially equivalent to running the shell command "
"C<find directory -print> but some post-processing happens on the output, "
"described below."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1360 ../src/guestfs-actions.pod:2216
msgid ""
"This returns a list of strings I<without any prefix>. Thus if the directory "
"structure was:"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1363 ../src/guestfs-actions.pod:2219
#, no-wrap
msgid ""
" /tmp/a\n"
" /tmp/b\n"
" /tmp/c/d\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1367
msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1370 ../src/guestfs-actions.pod:2226
#, no-wrap
msgid ""
" a\n"
" b\n"
" c\n"
" c/d\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1375 ../src/guestfs-actions.pod:2231
msgid "If C<directory> is not a directory, then this command returns an error."
msgstr ""
#. type: textblock
#: ../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</find0>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1385
msgid "find0"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1387
#, no-wrap
msgid ""
" find0 directory (files|-)\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1389 ../src/guestfs-actions.pod:2254
msgid ""
"This command lists out all files and directories, recursively, starting at "
"C<directory>, placing the resulting list in the external file called "
"C<files>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1393
msgid ""
"This command works the same way as L</find> 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<find(1)> 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:1420
msgid "findfs-label"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1422
#, no-wrap
msgid ""
" findfs-label label\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1424 ../src/guestfs-actions.pod:2293
msgid ""
"This command searches the filesystems and returns the one which has the "
"given label. An error is returned if no such filesystem can be found."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1428
msgid "To find the label of a filesystem, use L</vfs-label>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1430
msgid "findfs-uuid"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1432
#, no-wrap
msgid ""
" findfs-uuid uuid\n"
"\n"
msgstr ""
#. type: textblock
#: ../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</vfs-uuid>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1440
msgid "fsck"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1442
#, no-wrap
msgid ""
" fsck fstype device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2328
msgid ""
"This runs the filesystem checker (fsck) on C<device> which should have "
"filesystem type C<fstype>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1447 ../src/guestfs-actions.pod:2331
msgid ""
"The returned integer is the status. See L<fsck(8)> for the list of status "
"codes from C<fsck>."
msgstr ""
#. type: textblock
#: ../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 ""
"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<fsck -a -t fstype device>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1472
msgid "get-append"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1474
#, no-wrap
msgid ""
" get-append\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1476 ../src/guestfs-actions.pod:2365
msgid ""
"Return the additional kernel options which are added to the guest kernel "
"command line."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1479 ../src/guestfs-actions.pod:2368
msgid "If C<NULL> then no options are added."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1481
msgid "get-attach-method"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1483
#, no-wrap
msgid ""
" get-attach-method\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1485
msgid "Return the current attach method. See L</set-attach-method>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1487
msgid "get-autosync"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1489
#, no-wrap
msgid ""
" get-autosync\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1491 ../src/guestfs-actions.pod:2393
msgid "Get the autosync flag."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1493
msgid "get-direct"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1495
#, no-wrap
msgid ""
" get-direct\n"
"\n"
msgstr ""
#. type: textblock
#: ../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 ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1501
#, no-wrap
msgid ""
" get-e2label device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1503 ../src/guestfs-actions.pod:2423
msgid ""
"This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1506
msgid ""
"I<This function is deprecated.> In new code, use the L</vfs_label> call "
"instead."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1513
msgid "get-e2uuid"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1515
#, no-wrap
msgid ""
" get-e2uuid device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2444
msgid ""
"This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1520
msgid ""
"I<This function is deprecated.> In new code, use the L</vfs_uuid> call "
"instead."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1527
msgid "get-memsize"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1529
#, no-wrap
msgid ""
" get-memsize\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1531 ../src/guestfs-actions.pod:2457
msgid ""
"This gets the memory size in megabytes allocated to the qemu subprocess."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1534
msgid ""
"If L</set-memsize> was not called on this handle, and if "
"C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
"value for memsize."
msgstr ""
#. type: textblock
#: ../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 ""
"For more information on the architecture of libguestfs, see L<guestfs(3)>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1541
msgid "get-network"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1543
#, no-wrap
msgid ""
" get-network\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1545 ../src/guestfs-actions.pod:2476
msgid "This returns the enable network flag."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1547
msgid "get-path"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1549
#, no-wrap
msgid ""
" get-path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2487
msgid "Return the current search path."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1553 ../src/guestfs-actions.pod:2489
msgid ""
"This 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:1560 ../src/guestfs-actions.pod:2502
msgid "This returns the process group flag."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1562
msgid "get-pid"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1564
msgid "pid"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1566
#, no-wrap
msgid ""
" get-pid\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1568 ../src/guestfs-actions.pod:2513
msgid ""
"Return the process ID of the qemu subprocess. If there is no qemu "
"subprocess, then this will return an error."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1571 ../src/guestfs-actions.pod:2516
msgid "This is an internal call used for debugging and testing."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1573
msgid "get-qemu"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1575
#, no-wrap
msgid ""
" get-qemu\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1577 ../src/guestfs-actions.pod:2527
msgid "Return the current qemu binary."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2529
msgid ""
"This is always non-NULL. If it wasn't set already, then this will return "
"the default qemu binary name."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1582
msgid "get-recovery-proc"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1584
#, no-wrap
msgid ""
" get-recovery-proc\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1586 ../src/guestfs-actions.pod:2542
msgid "Return the recovery process enabled flag."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1588
msgid "get-selinux"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1590
#, no-wrap
msgid ""
" get-selinux\n"
"\n"
msgstr ""
#. type: textblock
#: ../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</set-selinux>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1598
msgid "get-smp"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1600
#, no-wrap
msgid ""
" get-smp\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1602 ../src/guestfs-actions.pod:2568
msgid "This returns the number of virtual CPUs assigned to the appliance."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1604
msgid "get-state"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1606
#, no-wrap
msgid ""
" get-state\n"
"\n"
msgstr ""
#. type: textblock
#: ../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: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<guestfs(3)>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1613
msgid "get-trace"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1615
#, no-wrap
msgid ""
" get-trace\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1617 ../src/guestfs-actions.pod:2593
msgid "Return the command trace flag."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1619
msgid "get-umask"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1621
#, no-wrap
msgid ""
" get-umask\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1623
msgid ""
"Return the current umask. By default the umask is C<022> unless it has been "
"set by calling L</umask>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1626
msgid "get-verbose"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1628
#, no-wrap
msgid ""
" get-verbose\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1630 ../src/guestfs-actions.pod:2616
msgid "This returns the verbose messages flag."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1632
msgid "getcon"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1634
#, no-wrap
msgid ""
" getcon\n"
"\n"
msgstr ""
#. type: textblock
#: ../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:1638
msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1641
msgid "getxattr"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1643
#, no-wrap
msgid ""
" getxattr path name\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1645
msgid ""
"Get a single extended attribute from file C<path> named C<name>. This call "
"follows symlinks. If you want to lookup an extended attribute for the "
"symlink itself, use L</lgetxattr>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1649 ../fish/guestfish-actions.pod:2715
msgid ""
"Normally it is better to get all extended attributes from a file in one go "
"by calling L</getxattrs>. However some Linux filesystem implementations are "
"buggy and do not provide a way to list out attributes. For these "
"filesystems (notably ntfs-3g) you have to know the names of the extended "
"attributes you want in advance and call this function."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1656 ../fish/guestfish-actions.pod:2722
#: ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:4151
msgid ""
"Extended attribute values are blobs of binary data. If there is no extended "
"attribute named C<name>, this returns an error."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1659
msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1661
msgid "getxattrs"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1663
#, no-wrap
msgid ""
" getxattrs path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1665 ../src/guestfs-actions.pod:2673
msgid ""
"This call lists the extended attributes of the file or directory C<path>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1668 ../src/guestfs-actions.pod:2676
msgid ""
"At the system call level, this is a combination of the L<listxattr(2)> and "
"L<getxattr(2)> calls."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1671
msgid "See also: L</lgetxattrs>, L<attr(5)>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1673
msgid "glob-expand"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1675
#, no-wrap
msgid ""
" glob-expand pattern\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1677 ../src/guestfs-actions.pod:2693
msgid ""
"This command searches for all the pathnames matching C<pattern> according to "
"the wildcard expansion rules used by the shell."
msgstr ""
#. type: textblock
#: ../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<glob(3)> function with flags C<GLOB_MARK|"
"GLOB_BRACE>. See that manual page for more details."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1688
msgid "grep"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1690
#, no-wrap
msgid ""
" grep regex path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1692 ../src/guestfs-actions.pod:2717
msgid "This calls the external C<grep> program and returns the matching lines."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1698
msgid "grepi"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1700
#, no-wrap
msgid ""
" grepi regex path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1702 ../src/guestfs-actions.pod:2736
msgid ""
"This calls the external C<grep -i> program and returns the matching lines."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1708
msgid "grub-install"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1710
#, no-wrap
msgid ""
" grub-install root device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1712 ../src/guestfs-actions.pod:2755
msgid ""
"This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, "
"with the root directory being C<root>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1721 ../src/guestfs-actions.pod:2764
msgid ""
"There is currently no way in the API to install grub2, which is used by most "
"modern Linux guests. It is possible to run the grub2 command from the "
"guest, although see the caveats in L<guestfs(3)/RUNNING COMMANDS>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1728 ../src/guestfs-actions.pod:2771
msgid ""
"This uses C<grub-install> from the host. Unfortunately grub is not always "
"compatible with itself, so this only works in rather narrow circumstances. "
"Careful testing with each guest version is advisable."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1735 ../src/guestfs-actions.pod:2778
msgid ""
"If grub-install reports the error \"No suitable drive was found in the "
"generated device map.\" it may be that you need to create a C</boot/grub/"
"device.map> file first that contains the mapping between grub device names "
"and Linux device names. It is usually sufficient to create a file "
"containing:"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1742 ../src/guestfs-actions.pod:2785
#, no-wrap
msgid ""
" (hd0) /dev/vda\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1744 ../src/guestfs-actions.pod:2787
msgid "replacing C</dev/vda> with the name of the installation device."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1748
msgid "head"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1750
#, no-wrap
msgid ""
" head path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2801
msgid ""
"This command returns up to the first 10 lines of a file as a list of strings."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1758
msgid "head-n"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1760
#, no-wrap
msgid ""
" head-n nrlines path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2820
msgid ""
"If the parameter C<nrlines> is a positive number, this returns the first "
"C<nrlines> lines of the file C<path>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1765 ../src/guestfs-actions.pod:2823
msgid ""
"If the parameter C<nrlines> is a negative number, this returns lines from "
"the file C<path>, excluding the last C<nrlines> lines."
msgstr ""
#. type: textblock
#: ../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<nrlines> is zero, this returns an empty list."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1773
msgid "hexdump"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1775
#, no-wrap
msgid ""
" hexdump path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1777 ../src/guestfs-actions.pod:2843
msgid ""
"This runs C<hexdump -C> on the given C<path>. The result is the human-"
"readable, canonical hex dump of the file."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1783
msgid "initrd-cat"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1785
#, no-wrap
msgid ""
" initrd-cat initrdpath filename\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1787 ../src/guestfs-actions.pod:2862
msgid ""
"This command unpacks the file C<filename> from the initrd file called "
"C<initrdpath>. The filename must be given I<without> the initial C</> "
"character."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1791 ../src/guestfs-actions.pod:2866
msgid ""
"For example, in guestfish you could use the following command to examine the "
"boot script (usually called C</init>) contained in a Linux initrd or "
"initramfs image:"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1795 ../src/guestfs-actions.pod:2870
#, no-wrap
msgid ""
" initrd-cat /boot/initrd-<version>.img init\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1797
msgid "See also L</initrd-list>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1802
msgid "initrd-list"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1804
#, no-wrap
msgid ""
" initrd-list path\n"
"\n"
msgstr ""
#. type: textblock
#: ../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:1808 ../src/guestfs-actions.pod:2891
msgid ""
"The files are listed without any initial C</> character. The files are "
"listed in the order they appear (not necessarily alphabetical). Directory "
"names are listed as separate items."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1812 ../src/guestfs-actions.pod:2895
msgid ""
"Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
"initrd. We I<only> support the newer initramfs format (compressed cpio "
"files)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1816
msgid "inotify-add-watch"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1818
#, no-wrap
msgid ""
" inotify-add-watch path mask\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1820 ../src/guestfs-actions.pod:2912
msgid "Watch C<path> for the events listed in C<mask>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2914
msgid ""
"Note that if C<path> is a directory then events within that directory are "
"watched, but this does I<not> happen recursively (in subdirectories)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1826 ../src/guestfs-actions.pod:2918
msgid ""
"Note for non-C or non-Linux callers: the inotify events are defined by the "
"Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1830
msgid "inotify-close"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1832
#, no-wrap
msgid ""
" inotify-close\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1834 ../src/guestfs-actions.pod:2931
msgid ""
"This closes the inotify handle which was previously opened by inotify_init. "
"It removes all watches, throws away any pending events, and deallocates all "
"resources."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1838
msgid "inotify-files"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1840
#, no-wrap
msgid ""
" inotify-files\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1842
msgid ""
"This function is a helpful wrapper around L</inotify-read> which just "
"returns a list of pathnames of objects that were touched. The returned "
"pathnames are sorted and deduplicated."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1846
msgid "inotify-init"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1848
#, no-wrap
msgid ""
" inotify-init maxevents\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1850 ../src/guestfs-actions.pod:2960
msgid ""
"This command creates a new inotify handle. The inotify subsystem can be "
"used to notify events which happen to objects in the guest filesystem."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1854
msgid ""
"C<maxevents> is the maximum number of events which will be queued up between "
"calls to L</inotify-read> or L</inotify-files>. 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_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1864
msgid ""
"Before any events are generated, you have to add some watches to the "
"internal watch list. See: L</inotify-add-watch>, L</inotify-rm-watch> and "
"L</inotify-watch-all>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1870
msgid ""
"Queued up events should be read periodically by calling L</inotify-read> (or "
"L</inotify-files> which is just a helpful wrapper around L</inotify-read>). "
"If you don't read the events out often enough then you risk the internal "
"queue overflowing."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1877
msgid ""
"The handle should be closed after use by calling L</inotify-close>. This "
"also removes any watches automatically."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2991
msgid ""
"See also L<inotify(7)> 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:1886
msgid "inotify-read"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1888
#, no-wrap
msgid ""
" inotify-read\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1890 ../src/guestfs-actions.pod:3005
msgid ""
"Return the complete queue of events that have happened since the previous "
"read call."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1893 ../src/guestfs-actions.pod:3008
msgid "If no events have happened, this returns an empty list."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1895 ../src/guestfs-actions.pod:3010
msgid ""
"I<Note>: 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:1901
msgid "inotify-rm-watch"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1903
#, no-wrap
msgid ""
" inotify-rm-watch wd\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1905
msgid "Remove a previously defined inotify watch. See L</inotify-add-watch>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1908
msgid "inspect-get-arch"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1910
#, no-wrap
msgid ""
" inspect-get-arch root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1912
msgid ""
"This returns the architecture of the inspected operating system. The "
"possible return values are listed under L</file-architecture>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1916 ../src/guestfs-actions.pod:3045
msgid ""
"If the architecture could not be determined, then the string C<unknown> is "
"returned."
msgstr ""
#. type: textblock
#: ../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<guestfs(3)/INSPECTION> for more details."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:1921
msgid "inspect-get-distro"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:1923
#, no-wrap
msgid ""
" inspect-get-distro root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1925 ../src/guestfs-actions.pod:3061
msgid ""
"This returns the distro (distribution) of the inspected operating system."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1928 ../src/guestfs-actions.pod:3064
msgid "Currently defined distros are:"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1932 ../src/guestfs-actions.pod:3068
msgid "\"archlinux\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1934 ../src/guestfs-actions.pod:3070
msgid "Arch Linux."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1936 ../src/guestfs-actions.pod:3072
msgid "\"centos\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1938 ../src/guestfs-actions.pod:3074
msgid "CentOS."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:3076
msgid "\"debian\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1942 ../src/guestfs-actions.pod:3078
msgid "Debian."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1944 ../src/guestfs-actions.pod:3080
msgid "\"fedora\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:3082
msgid "Fedora."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1948 ../src/guestfs-actions.pod:3084
msgid "\"gentoo\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1950 ../src/guestfs-actions.pod:3086
msgid "Gentoo."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1952 ../src/guestfs-actions.pod:3088
msgid "\"linuxmint\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:3090
msgid "Linux Mint."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1956 ../src/guestfs-actions.pod:3092
msgid "\"mageia\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1958 ../src/guestfs-actions.pod:3094
msgid "Mageia."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1960 ../src/guestfs-actions.pod:3096
msgid "\"mandriva\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1962 ../src/guestfs-actions.pod:3098
msgid "Mandriva."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1964 ../src/guestfs-actions.pod:3100
msgid "\"meego\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1966 ../src/guestfs-actions.pod:3102
msgid "MeeGo."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:3104
msgid "\"opensuse\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1970 ../src/guestfs-actions.pod:3106
msgid "OpenSUSE."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1972 ../src/guestfs-actions.pod:3108
msgid "\"pardus\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1974 ../src/guestfs-actions.pod:3110
msgid "Pardus."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1976 ../src/guestfs-actions.pod:3112
msgid "\"redhat-based\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1978 ../src/guestfs-actions.pod:3114
msgid "Some Red Hat-derived distro."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1980 ../src/guestfs-actions.pod:3116
msgid "\"rhel\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:3118
msgid "Red Hat Enterprise Linux."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1984 ../src/guestfs-actions.pod:3120
msgid "\"scientificlinux\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1986 ../src/guestfs-actions.pod:3122
msgid "Scientific Linux."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1988 ../src/guestfs-actions.pod:3124
msgid "\"slackware\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1990 ../src/guestfs-actions.pod:3126
msgid "Slackware."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1992 ../src/guestfs-actions.pod:3128
msgid "\"ttylinux\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1994 ../src/guestfs-actions.pod:3130
msgid "ttylinux."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:1996 ../src/guestfs-actions.pod:3132
msgid "\"ubuntu\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:1998 ../src/guestfs-actions.pod:3134
msgid "Ubuntu."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2000 ../fish/guestfish-actions.pod:2084
#: ../fish/guestfish-actions.pod:2353 ../src/guestfs-actions.pod:3136
#: ../src/guestfs-actions.pod:3245 ../src/guestfs-actions.pod:3625
msgid "\"unknown\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2002 ../src/guestfs-actions.pod:3138
msgid "The distro could not be determined."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2004 ../fish/guestfish-actions.pod:2341
#: ../src/guestfs-actions.pod:3140 ../src/guestfs-actions.pod:3613
msgid "\"windows\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2006 ../src/guestfs-actions.pod:3142
msgid ""
"Windows does not have distributions. This string is returned if the OS type "
"is Windows."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod: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 ""
"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:2016
msgid "inspect-get-drive-mappings"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2018
#, no-wrap
msgid ""
" inspect-get-drive-mappings root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2020 ../src/guestfs-actions.pod:3163
msgid ""
"This call is useful for Windows which uses a primitive system of assigning "
"drive letters (like \"C:\") to partitions. This inspection API examines the "
"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: 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:2030 ../src/guestfs-actions.pod:3173
msgid ""
"Note that keys are drive letters. For Windows, the key is case insensitive "
"and just contains the drive letter, without the customary colon separator "
"character."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2034 ../src/guestfs-actions.pod:3177
msgid ""
"In future we may support other operating systems that also used drive "
"letters, but the keys for those might not be case insensitive and might be "
"longer than 1 character. For example in OS-9, hard drives were named C<h0>, "
"C<h1> etc."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2039 ../src/guestfs-actions.pod:3182
msgid ""
"For Windows guests, currently only hard drive mappings are returned. "
"Removable disks (eg. DVD-ROMs) are ignored."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2042 ../src/guestfs-actions.pod:3185
msgid ""
"For guests that do not use drive mappings, or if the drive mappings could "
"not be determined, this returns an empty hash table."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2045
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-mountpoints>, L</inspect-get-filesystems>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2049
msgid "inspect-get-filesystems"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2051
#, no-wrap
msgid ""
" inspect-get-filesystems root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2053 ../src/guestfs-actions.pod:3206
msgid ""
"This returns a list of all the filesystems that we think are associated with "
"this operating system. This includes the root filesystem, other ordinary "
"filesystems, and non-mounted devices like swap partitions."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2058 ../src/guestfs-actions.pod:3211
msgid ""
"In the case of a multi-boot virtual machine, it is possible for a filesystem "
"to be shared between operating systems."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2061
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-mountpoints>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2064
msgid "inspect-get-format"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2066
#, no-wrap
msgid ""
" inspect-get-format root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3229
msgid ""
"This returns the format of the inspected operating system. You can use it "
"to detect install images, live CDs and similar."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2071 ../src/guestfs-actions.pod:3232
msgid "Currently defined formats are:"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2075 ../src/guestfs-actions.pod:3236
msgid "\"installed\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2077 ../src/guestfs-actions.pod:3238
msgid "This is an installed operating system."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3240
msgid "\"installer\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2081 ../src/guestfs-actions.pod:3242
msgid ""
"The disk image being inspected is not an installed operating system, but a "
"I<bootable> 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:2095
msgid "inspect-get-hostname"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2097
#, no-wrap
msgid ""
" inspect-get-hostname root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2099 ../src/guestfs-actions.pod:3267
msgid ""
"This function returns the hostname of the operating system as found by "
"inspection of the guest's configuration files."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2102 ../src/guestfs-actions.pod:3270
msgid ""
"If the hostname could not be determined, then the string C<unknown> is "
"returned."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2107
msgid "inspect-get-icon"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2109
#, no-wrap
msgid ""
" inspect-get-icon root [favicon:..] [highquality:..]\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2111 ../src/guestfs-actions.pod:3296
msgid ""
"This function returns an icon corresponding to the inspected operating "
"system. The icon is returned as a buffer containing a PNG image (re-encoded "
"to PNG if necessary)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2115 ../src/guestfs-actions.pod:3300
msgid ""
"If it was not possible to get an icon this function returns a zero-length "
"(non-NULL) buffer. I<Callers must check for this case>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2118 ../src/guestfs-actions.pod:3303
msgid ""
"Libguestfs will start by looking for a file called C</etc/favicon.png> or "
"C<C:\\etc\\favicon.png> and if it has the correct format, the contents of "
"this file will be returned. You can disable favicons by passing the "
"optional C<favicon> boolean as false (default is true)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2124 ../src/guestfs-actions.pod:3309
msgid ""
"If finding the favicon fails, then we look in other places in the guest for "
"a suitable icon."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2127 ../src/guestfs-actions.pod:3312
msgid ""
"If the optional C<highquality> boolean is true then only high quality icons "
"are returned, which means only icons of high resolution with an alpha "
"channel. The default (false) is to return any icon we can, even if it is of "
"substandard quality."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3323
msgid ""
"Unlike most other inspection API calls, the guest's disks must be mounted up "
"before you call this, since it needs to read information from the guest "
"filesystem during the call."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3329
msgid ""
"B<Security:> The icon data comes from the untrusted guest, and should be "
"treated with caution. PNG files have been known to contain exploits. "
"Ensure that libpng (or other relevant libraries) are fully up to date before "
"trying to process or display the icon."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3337
msgid ""
"The PNG image returned can be any size. It might not be square. Libguestfs "
"tries to return the largest, highest quality icon available. The "
"application must scale the icon to the required size."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2159 ../src/guestfs-actions.pod:3344
msgid ""
"Extracting icons from Windows guests requires the external C<wrestool> "
"program from the C<icoutils> package, and several programs (C<bmptopnm>, "
"C<pnmtopng>, C<pamcut>) from the C<netpbm> package. These must be "
"installed separately."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2166 ../src/guestfs-actions.pod:3351
msgid ""
"Operating system icons are usually trademarks. Seek legal advice before "
"using trademarks in applications."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2173
msgid "inspect-get-major-version"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2175
#, no-wrap
msgid ""
" inspect-get-major-version root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2177 ../src/guestfs-actions.pod:3392
msgid ""
"This returns the major version number of the inspected operating system."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2180 ../src/guestfs-actions.pod:3395
msgid ""
"Windows uses a consistent versioning scheme which is I<not> 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: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:2191
msgid "inspect-get-minor-version"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2193
#, no-wrap
msgid ""
" inspect-get-minor-version root\n"
"\n"
msgstr ""
#. type: textblock
#: ../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:2200
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-major-version>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2203
msgid "inspect-get-mountpoints"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2205
#, no-wrap
msgid ""
" inspect-get-mountpoints root\n"
"\n"
msgstr ""
#. type: textblock
#: ../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</etc/"
"fstab>. I<In particular note> 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: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</boot>) and a value which is the filesystem that would be "
"mounted there (eg. C</dev/sda1>)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2221 ../src/guestfs-actions.pod:3448
msgid ""
"Non-mounted devices such as swap devices are I<not> returned in this list."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2224
msgid ""
"For operating systems like Windows which still use drive letters, this call "
"will only return an entry for the first drive \"mounted on\" C</>. For "
"information about the mapping of drive letters to partitions, see L</inspect-"
"get-drive-mappings>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2230
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-filesystems>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2233
msgid "inspect-get-package-format"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2235
#, no-wrap
msgid ""
" inspect-get-package-format root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2237
msgid ""
"This function and L</inspect-get-package-management> return the package "
"format and package management tool used by the inspected operating system. "
"For example for Fedora these functions would return C<rpm> (package format) "
"and C<yum> (package management)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2243 ../src/guestfs-actions.pod:3480
msgid ""
"This returns the string C<unknown> if we could not determine the package "
"format I<or> if the operating system does not have a real packaging system "
"(eg. Windows)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3484
msgid ""
"Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>, "
"C<pkgsrc>. Future versions of libguestfs may return other strings."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2253
msgid "inspect-get-package-management"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2255
#, no-wrap
msgid ""
" inspect-get-package-management root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2257
msgid ""
"L</inspect-get-package-format> 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<rpm> (package format) and "
"C<yum> (package management)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2263 ../src/guestfs-actions.pod:3507
msgid ""
"This returns the string C<unknown> if we could not determine the package "
"management tool I<or> if the operating system does not have a real packaging "
"system (eg. Windows)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3511
msgid ""
"Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
"derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>, C<zypper>. Future "
"versions of libguestfs may return other strings."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2274
msgid "inspect-get-product-name"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2276
#, no-wrap
msgid ""
" inspect-get-product-name root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3529
msgid ""
"This returns the product name of the inspected operating system. The "
"product name is generally some freeform string which can be displayed to the "
"user, but should not be parsed by programs."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2283 ../src/guestfs-actions.pod:3534
msgid ""
"If the product name could not be determined, then the string C<unknown> is "
"returned."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2288
msgid "inspect-get-product-variant"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2290
#, no-wrap
msgid ""
" inspect-get-product-variant root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2292 ../src/guestfs-actions.pod:3550
msgid "This returns the product variant of the inspected operating system."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2295 ../src/guestfs-actions.pod:3553
msgid ""
"For Windows guests, this returns the contents of the Registry key C<HKLM"
"\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
"is usually a string such as C<Client> or C<Server> (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<Client> and "
"the latter is C<Server>)."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2304 ../src/guestfs-actions.pod:3562
msgid ""
"For enterprise Linux guests, in future we intend this to return the product "
"variant such as C<Desktop>, C<Server> 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<unknown> "
"is returned."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2311
msgid ""
"Please read L<guestfs(3)/INSPECTION> for more details. See also L</inspect-"
"get-product-name>, L</inspect-get-major-version>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2315
msgid "inspect-get-roots"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2317
#, no-wrap
msgid ""
" inspect-get-roots\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2319
msgid ""
"This function is a convenient way to get the list of root devices, as "
"returned from a previous call to L</inspect-os>, but without redoing the "
"whole inspection process."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2323
msgid ""
"This returns an empty list if either no root devices were found or the "
"caller has not called L</inspect-os>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2328
msgid "inspect-get-type"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2330
#, no-wrap
msgid ""
" inspect-get-type root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2332 ../src/guestfs-actions.pod:3604
msgid ""
"This returns the type of the inspected operating system. Currently defined "
"types are:"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2337 ../src/guestfs-actions.pod:3609
msgid "\"linux\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2339 ../src/guestfs-actions.pod:3611
msgid "Any Linux-based operating system."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3615
msgid "Any Microsoft Windows operating system."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2345 ../src/guestfs-actions.pod:3617
msgid "\"freebsd\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:3619
msgid "FreeBSD."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2349 ../src/guestfs-actions.pod:3621
msgid "\"netbsd\""
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2351 ../src/guestfs-actions.pod:3623
msgid "NetBSD."
msgstr ""
#. type: textblock
#: ../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:2364
msgid "inspect-get-windows-current-control-set"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2366
#, no-wrap
msgid ""
" inspect-get-windows-current-control-set root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2368 ../src/guestfs-actions.pod:3647
msgid ""
"This returns the Windows CurrentControlSet of the inspected guest. The "
"CurrentControlSet is a registry key name such as C<ControlSet001>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2371 ../src/guestfs-actions.pod:3650
msgid ""
"This call assumes that the guest is Windows and that the Registry could be "
"examined by inspection. If this is not the case then an error is returned."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2377
msgid "inspect-get-windows-systemroot"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2379
#, no-wrap
msgid ""
" inspect-get-windows-systemroot root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2381 ../src/guestfs-actions.pod:3667
msgid ""
"This returns the Windows systemroot of the inspected guest. The systemroot "
"is a directory path such as C</WINDOWS>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2384 ../src/guestfs-actions.pod:3670
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:2390
msgid "inspect-is-live"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2392
#, no-wrap
msgid ""
" inspect-is-live root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2394
msgid ""
"If L</inspect-get-format> returns C<installer> (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:2400
msgid "inspect-is-multipart"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2402
#, no-wrap
msgid ""
" inspect-is-multipart root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2404
msgid ""
"If L</inspect-get-format> returns C<installer> (this is an install disk), "
"then this returns true if the disk is part of a set."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2410
msgid "inspect-is-netinst"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2412
#, no-wrap
msgid ""
" inspect-is-netinst root\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2414
msgid ""
"If L</inspect-get-format> returns C<installer> (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:2422
msgid "inspect-list-applications"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2424
#, no-wrap
msgid ""
" inspect-list-applications root\n"
"\n"
msgstr ""
#. type: textblock
#: ../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:2428
msgid ""
"I<Note:> This call works differently from other parts of the inspection "
"API. You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
"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</inspect-get-*> 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: textblock
#: ../fish/guestfish-actions.pod:2438 ../src/guestfs-actions.pod:3749
msgid ""
"This returns an empty list if the inspection code was not able to determine "
"the list of applications."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2441 ../src/guestfs-actions.pod:3752
msgid "The application structure contains the following fields:"
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3756
msgid "C<app_name>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2447 ../src/guestfs-actions.pod:3758
msgid ""
"The name of the application. For Red Hat-derived and Debian-derived Linux "
"guests, this is the package name."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2450 ../src/guestfs-actions.pod:3761
msgid "C<app_display_name>"
msgstr ""
#. type: textblock
#: ../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:2455 ../src/guestfs-actions.pod:3766
msgid ""
"If unavailable this is returned as an empty string C<\"\">. Callers needing "
"to display something can use C<app_name> instead."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2458 ../src/guestfs-actions.pod:3769
msgid "C<app_epoch>"
msgstr ""
#. type: textblock
#: ../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: =item
#: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3774
msgid "C<app_version>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2465 ../src/guestfs-actions.pod:3776
msgid ""
"The version string of the application or package. If unavailable this is "
"returned as an empty string C<\"\">."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2468 ../src/guestfs-actions.pod:3779
msgid "C<app_release>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2470 ../src/guestfs-actions.pod:3781
msgid ""
"The release string of the application or package, for package managers that "
"use this. If unavailable this is returned as an empty string C<\"\">."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2474 ../src/guestfs-actions.pod:3785
msgid "C<app_install_path>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2476 ../src/guestfs-actions.pod:3787
msgid ""
"The installation path of the application (on operating systems such as "
"Windows which use installation paths). This path is in the format used by "
"the guest operating system, it is not a libguestfs path."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod: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<app_trans_path>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2485 ../src/guestfs-actions.pod:3796
msgid ""
"The install path translated into a libguestfs path. If unavailable this is "
"returned as an empty string C<\"\">."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2488 ../src/guestfs-actions.pod:3799
msgid "C<app_publisher>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2490 ../src/guestfs-actions.pod:3801
msgid ""
"The name of the publisher of the application, for package managers that use "
"this. If unavailable this is returned as an empty string C<\"\">."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2494 ../src/guestfs-actions.pod:3805
msgid "C<app_url>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2496 ../src/guestfs-actions.pod:3807
msgid ""
"The URL (eg. upstream URL) of the application. If unavailable this is "
"returned as an empty string C<\"\">."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2499 ../src/guestfs-actions.pod:3810
msgid "C<app_source_package>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2501 ../src/guestfs-actions.pod:3812
msgid ""
"For packaging systems which support this, the name of the source package. "
"If unavailable this is returned as an empty string C<\"\">."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2504 ../src/guestfs-actions.pod:3815
msgid "C<app_summary>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2506 ../src/guestfs-actions.pod:3817
msgid ""
"A short (usually one line) description of the application or package. If "
"unavailable this is returned as an empty string C<\"\">."
msgstr ""
#. type: =item
#: ../fish/guestfish-actions.pod:2509 ../src/guestfs-actions.pod:3820
msgid "C<app_description>"
msgstr ""
#. 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:2518
msgid "inspect-os"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2520
#, no-wrap
msgid ""
" inspect-os\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2522 ../src/guestfs-actions.pod:3840
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."
msgstr ""
#. 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: textblock
#: ../fish/guestfish-actions.pod:2528 ../src/guestfs-actions.pod:3846
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."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2535
msgid ""
"You can pass the root string(s) returned to other L</inspect-get-*> "
"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</mount-ro> and L</"
"umount-all> 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:2546 ../src/guestfs-actions.pod:3864
msgid ""
"This function cannot decrypt encrypted disks. The caller must do that first "
"(supplying the necessary keys) if the disk is encrypted."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2552 ../fish/guestfish-actions.pod:2750
#: ../fish/guestfish-actions.pod:2809
msgid "See also L</list-filesystems>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2554
msgid "is-blockdev"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2556
#, no-wrap
msgid ""
" is-blockdev path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2558 ../src/guestfs-actions.pod:3884
msgid ""
"This returns C<true> if and only if there is a block device with the given "
"C<path> 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</stat>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2563
msgid "is-busy"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2565
#, no-wrap
msgid ""
" is-busy\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2567 ../src/guestfs-actions.pod:3898
msgid ""
"This returns true iff this handle is busy processing a command (in the "
"C<BUSY> state)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2572
msgid "is-chardev"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2574
#, no-wrap
msgid ""
" is-chardev path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2576 ../src/guestfs-actions.pod:3913
msgid ""
"This returns C<true> if and only if there is a character device with the "
"given C<path> name."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2581
msgid "is-config"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2583
#, no-wrap
msgid ""
" is-config\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2585 ../src/guestfs-actions.pod:3927
msgid ""
"This returns true iff this handle is being configured (in the C<CONFIG> "
"state)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2590
msgid "is-dir"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2592
#, no-wrap
msgid ""
" is-dir path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2594 ../src/guestfs-actions.pod:3942
msgid ""
"This returns C<true> if and only if there is a directory with the given "
"C<path> name. Note that it returns false for other objects like files."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2600
msgid "is-fifo"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2602
#, no-wrap
msgid ""
" is-fifo path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2604 ../src/guestfs-actions.pod:3958
msgid ""
"This returns C<true> if and only if there is a FIFO (named pipe) with the "
"given C<path> name."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2609
msgid "is-file"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2611
#, no-wrap
msgid ""
" is-file path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2613 ../src/guestfs-actions.pod:3973
msgid ""
"This returns C<true> if and only if there is a regular file with the given "
"C<path> name. Note that it returns false for other objects like directories."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2619
msgid "is-launching"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2621
#, no-wrap
msgid ""
" is-launching\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2623 ../src/guestfs-actions.pod:3988
msgid ""
"This returns true iff this handle is launching the subprocess (in the "
"C<LAUNCHING> state)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2628
msgid "is-lv"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2630
#, no-wrap
msgid ""
" is-lv device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2632 ../src/guestfs-actions.pod:4003
msgid ""
"This command tests whether C<device> is a logical volume, and returns true "
"iff this is the case."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2635
msgid "is-ready"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2637
#, no-wrap
msgid ""
" is-ready\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2639 ../src/guestfs-actions.pod:4015
msgid ""
"This returns true iff this handle is ready to accept commands (in the "
"C<READY> state)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2644
msgid "is-socket"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2646
#, no-wrap
msgid ""
" is-socket path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2648 ../src/guestfs-actions.pod:4030
msgid ""
"This returns C<true> if and only if there is a Unix domain socket with the "
"given C<path> name."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2653
msgid "is-symlink"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2655
#, no-wrap
msgid ""
" is-symlink path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2657 ../src/guestfs-actions.pod:4045
msgid ""
"This returns C<true> if and only if there is a symbolic link with the given "
"C<path> name."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2662
msgid "is-zero"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2664
#, no-wrap
msgid ""
" is-zero path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2666 ../src/guestfs-actions.pod:4060
msgid ""
"This returns true iff the file exists and the file is empty or it contains "
"all zero bytes."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2669
msgid "is-zero-device"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2671
#, no-wrap
msgid ""
" is-zero-device device\n"
"\n"
msgstr ""
#. type: textblock
#: ../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: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:2677
msgid "kill-subprocess"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2679
#, no-wrap
msgid ""
" kill-subprocess\n"
"\n"
msgstr ""
#. type: textblock
#: ../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:2683
msgid "launch"
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2685
msgid "run"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2687
#, no-wrap
msgid ""
" launch\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2689 ../src/guestfs-actions.pod:4097
msgid ""
"Internally libguestfs is implemented by running a virtual machine using "
"L<qemu(1)>."
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:2695
msgid "lchown"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2697
#, no-wrap
msgid ""
" lchown owner group path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2699
msgid ""
"Change the file owner to C<owner> and group to C<group>. This is like L</"
"chown> but if C<path> is a symlink then the link itself is changed, not the "
"target."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2707
msgid "lgetxattr"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2709
#, no-wrap
msgid ""
" lgetxattr path name\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2711 ../src/guestfs-actions.pod:4140
msgid ""
"Get a single extended attribute from file C<path> named C<name>. If C<path> "
"is a symlink, then this call returns an extended attribute from the symlink."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2725
msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2727
msgid "lgetxattrs"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2729
#, no-wrap
msgid ""
" lgetxattrs path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2731
msgid ""
"This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
"it returns the extended attributes of the link itself."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2735
msgid "list-9p"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2737
#, no-wrap
msgid ""
" list-9p\n"
"\n"
msgstr ""
#. type: textblock
#: ../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:2742
msgid "list-devices"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2744
#, no-wrap
msgid ""
" list-devices\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2746 ../src/guestfs-actions.pod:4197
msgid "List all the block devices."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2748 ../src/guestfs-actions.pod:4199
msgid "The full block device names are returned, eg. C</dev/sda>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2752
msgid "list-dm-devices"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2754
#, no-wrap
msgid ""
" list-dm-devices\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2756 ../src/guestfs-actions.pod:4214
msgid "List all device mapper devices."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2758
msgid ""
"The returned list contains C</dev/mapper/*> devices, eg. ones created by a "
"previous call to L</luks-open>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2761
msgid ""
"Device mapper devices which correspond to logical volumes are I<not> "
"returned in this list. Call L</lvs> if you want to list logical volumes."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2765
msgid "list-filesystems"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2767
#, no-wrap
msgid ""
" list-filesystems\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2769 ../src/guestfs-actions.pod:4234
msgid ""
"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: 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:2777 ../src/guestfs-actions.pod:4242
#, 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"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2782 ../src/guestfs-actions.pod:4247
msgid ""
"The value can have the special value \"unknown\", meaning the content of the "
"device is undetermined or empty. \"swap\" means a Linux swap partition."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2786
msgid ""
"This command runs other libguestfs commands, which might include L</mount> "
"and L</umount>, and therefore you should use this soon after launch and only "
"when nothing is mounted."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2790
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</inspect-os> to look for OSes)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2798
msgid "list-partitions"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2800
#, no-wrap
msgid ""
" list-partitions\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2802 ../src/guestfs-actions.pod:4276
msgid "List all the partitions detected on all block devices."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2804 ../src/guestfs-actions.pod:4278
msgid "The full partition device names are returned, eg. C</dev/sda1>"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2806
msgid ""
"This does not return logical volumes. For that you will need to call L</"
"lvs>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2811
msgid "ll"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2813
#, no-wrap
msgid ""
" ll directory\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2815 ../src/guestfs-actions.pod:4297
msgid ""
"List the files in C<directory> (relative to the root directory, there is no "
"cwd) in the format of 'ls -la'."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2818 ../src/guestfs-actions.pod:4300
msgid ""
"This command is mostly useful for interactive sessions. It is I<not> "
"intended that you try to parse the output string."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2821
msgid "ln"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2823
#, no-wrap
msgid ""
" ln target linkname\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2825 ../src/guestfs-actions.pod:4315
msgid "This command creates a hard link using the C<ln> command."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2827
msgid "ln-f"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2829
#, no-wrap
msgid ""
" ln-f target linkname\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2831 ../src/guestfs-actions.pod:4328
msgid ""
"This command creates a hard link using the C<ln -f> command. The I<-f> "
"option removes the link (C<linkname>) if it exists already."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2834
msgid "ln-s"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2836
#, no-wrap
msgid ""
" ln-s target linkname\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2838 ../src/guestfs-actions.pod:4342
msgid "This command creates a symbolic link using the C<ln -s> command."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2840
msgid "ln-sf"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2842
#, no-wrap
msgid ""
" ln-sf target linkname\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2844 ../src/guestfs-actions.pod:4355
msgid ""
"This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
"option removes the link (C<linkname>) if it exists already."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2847
msgid "lremovexattr"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2849
#, no-wrap
msgid ""
" lremovexattr xattr path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2851
msgid ""
"This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
"it removes an extended attribute of the link itself."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2855
msgid "ls"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2857
#, no-wrap
msgid ""
" ls directory\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2859 ../src/guestfs-actions.pod:4383
msgid ""
"List the files in C<directory> (relative to the root directory, there is no "
"cwd). The '.' and '..' entries are not returned, but hidden files are shown."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2863
msgid ""
"This command is mostly useful for interactive sessions. Programs should "
"probably use L</readdir> instead."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2866
msgid "lsetxattr"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2868
#, no-wrap
msgid ""
" lsetxattr xattr val vallen path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2870
msgid ""
"This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
"sets an extended attribute of the link itself."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2874
msgid "lstat"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2876
#, no-wrap
msgid ""
" lstat path\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2878 ../fish/guestfish-actions.pod:4678
#: ../src/guestfs-actions.pod:4419 ../src/guestfs-actions.pod:7200
msgid "Returns file information for the given C<path>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2880
msgid ""
"This is the same as L</stat> except that if C<path> is a symbolic link, then "
"the link is stat-ed, not the file it refers to."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2884 ../src/guestfs-actions.pod:4425
msgid "This is the same as the C<lstat(2)> system call."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2886
msgid "lstatlist"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2888
#, no-wrap
msgid ""
" lstatlist path 'names ...'\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2890
msgid ""
"This call allows you to perform the L</lstat> operation on multiple files, "
"where all files are in the directory C<path>. C<names> is the list of files "
"from this directory."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2894 ../src/guestfs-actions.pod:4444
msgid ""
"On return you get a list of stat structs, with a one-to-one correspondence "
"to the C<names> list. If any name did not exist or could not be lstat'd, "
"then the C<ino> field of that structure is set to C<-1>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2899
msgid ""
"This call is intended for programs that want to efficiently list a directory "
"contents without making many round-trips. See also L</lxattrlist> for a "
"similarly efficient call for getting extended attributes. Very long "
"directory listings might cause the protocol message size to be exceeded, "
"causing this call to fail. The caller must split up such requests into "
"smaller groups of names."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2907
msgid "luks-add-key"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2909
#, no-wrap
msgid ""
" luks-add-key device keyslot\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2911 ../src/guestfs-actions.pod:4472
msgid ""
"This command adds a new key on LUKS device C<device>. C<key> is any "
"existing key, and is used to access the device. C<newkey> is the new key to "
"add. C<keyslot> is the key slot that will be replaced."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2916
msgid ""
"Note that if C<keyslot> already contains a key, then this command will "
"fail. You have to use L</luks-kill-slot> first to remove that key."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2920 ../fish/guestfish-actions.pod:2942
#: ../fish/guestfish-actions.pod:2952 ../fish/guestfish-actions.pod:2963
#: ../fish/guestfish-actions.pod:2989 ../fish/guestfish-actions.pod:2999
msgid ""
"This command has one or more key or passphrase parameters. Guestfish will "
"prompt for these separately."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2923
msgid "luks-close"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2925
#, no-wrap
msgid ""
" luks-close device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2927
msgid ""
"This closes a LUKS device that was created earlier by L</luks-open> or L</"
"luks-open-ro>. The C<device> parameter must be the name of the LUKS mapping "
"device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
"block device."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2933
msgid "luks-format"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2935
#, no-wrap
msgid ""
" luks-format device keyslot\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2937 ../src/guestfs-actions.pod:4513
msgid ""
"This command erases existing data on C<device> and formats the device as a "
"LUKS encrypted device. C<key> is the initial key, which is added to key "
"slot C<slot>. (LUKS supports 8 key slots, numbered 0-7)."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2945
msgid "luks-format-cipher"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2947
#, no-wrap
msgid ""
" luks-format-cipher device keyslot cipher\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2949
msgid ""
"This command is the same as L</luks-format> but it also allows you to set "
"the C<cipher> used."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2955
msgid "luks-kill-slot"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2957
#, no-wrap
msgid ""
" luks-kill-slot device keyslot\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2959 ../src/guestfs-actions.pod:4554
msgid ""
"This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
"device C<device>. C<key> must be one of the I<other> keys."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2966
msgid "luks-open"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2968
#, no-wrap
msgid ""
" luks-open device mapname\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2970 ../src/guestfs-actions.pod:4574
msgid ""
"This command opens a block device which has been encrypted according to the "
"Linux Unified Key Setup (LUKS) standard."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2973 ../src/guestfs-actions.pod:4577
msgid "C<device> is the encrypted block device or partition."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2975 ../src/guestfs-actions.pod:4579
msgid ""
"The caller must supply one of the keys associated with the LUKS block "
"device, in the C<key> parameter."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2978 ../src/guestfs-actions.pod:4582
msgid ""
"This creates a new block device called C</dev/mapper/mapname>. Reads and "
"writes to this block device are decrypted from and encrypted to the "
"underlying C<device> respectively."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2982
msgid ""
"If this block device contains LVM volume groups, then calling L</vgscan> "
"followed by L</vg-activate-all> will make them visible."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2986
msgid "Use L</list-dm-devices> to list all device mapper devices."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:2992
msgid "luks-open-ro"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:2994
#, no-wrap
msgid ""
" luks-open-ro device mapname\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:2996
msgid ""
"This is the same as L</luks-open> except that a read-only mapping is created."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:3002
msgid "lvcreate"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:3004
#, no-wrap
msgid ""
" lvcreate logvol volgroup mbytes\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3006 ../src/guestfs-actions.pod:4628
msgid ""
"This creates an LVM logical volume called C<logvol> on the volume group "
"C<volgroup>, with C<size> megabytes."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:3009
msgid "lvm-canonical-lv-name"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:3011
#, no-wrap
msgid ""
" lvm-canonical-lv-name lvname\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3013 ../src/guestfs-actions.pod:4641
msgid ""
"This converts alternative naming schemes for LVs that you might find to the "
"canonical name. For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
"LV>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3017 ../src/guestfs-actions.pod:4645
msgid ""
"This command returns an error if the C<lvname> parameter does not refer to a "
"logical volume."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3020
msgid "See also L</is-lv>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:3022
msgid "lvm-clear-filter"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:3024
#, no-wrap
msgid ""
" lvm-clear-filter\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3026
msgid ""
"This undoes the effect of L</lvm-set-filter>. LVM will be able to see every "
"block device."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3029 ../fish/guestfish-actions.pod:3057
#: ../src/guestfs-actions.pod:4663 ../src/guestfs-actions.pod:4702
msgid ""
"This command also clears the LVM cache and performs a volume group scan."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:3032
msgid "lvm-remove-all"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:3034
#, no-wrap
msgid ""
" lvm-remove-all\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3036 ../src/guestfs-actions.pod:4675
msgid ""
"This command removes all LVM logical volumes, volume groups and physical "
"volumes."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:3039
msgid "lvm-set-filter"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:3041
#, no-wrap
msgid ""
" lvm-set-filter 'devices ...'\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3043 ../src/guestfs-actions.pod:4688
msgid ""
"This sets the LVM device filter so that LVM will only be able to \"see\" the "
"block devices in the list C<devices>, and will ignore all other attached "
"block devices."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3047 ../src/guestfs-actions.pod:4692
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."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3060 ../src/guestfs-actions.pod:4705
msgid "You can filter whole block devices or individual partitions."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3062 ../src/guestfs-actions.pod:4707
msgid ""
"You cannot use this if any VG is currently in use (eg. contains a mounted "
"filesystem), even if you are not filtering out that VG."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:3066
msgid "lvremove"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:3068
#, no-wrap
msgid ""
" lvremove device\n"
"\n"
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3070 ../src/guestfs-actions.pod:4721
msgid ""
"Remove an LVM logical volume C<device>, where C<device> is the path to the "
"LV, such as C</dev/VG/LV>."
msgstr ""
#. type: textblock
#: ../fish/guestfish-actions.pod:3073 ../src/guestfs-actions.pod:4724
msgid ""
"You can also remove all LVs in a volume group by specifying the VG name, C</"
"dev/VG>."
msgstr ""
#. type: =head2
#: ../fish/guestfish-actions.pod:3076
msgid "lvrename"
msgstr ""
#. type: verbatim
#: ../fish/guestfish-actions.pod:3078
#, no-wrap
msgid ""
" lvrename logvol newlogvol\n"
"\n"
|