po-docs/libguestfs-docs.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Red Hat Inc.
   3 # This file is distributed under the same license as the libguestfs package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: libguestfs 1.15.8\n"
  10 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
  11 "POT-Creation-Date: 2011-11-29 21:47+0000\n"
  12 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  13 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  14 "Language-Team: LANGUAGE <LL@li.org>\n"
  15 "Language: \n"
  16 "MIME-Version: 1.0\n"
  17 "Content-Type: text/plain; charset=UTF-8\n"
  18 "Content-Transfer-Encoding: 8bit\n"
  19
  20 #. type: =head1
  21 #: ../align/virt-alignment-scan.pod:3 ../cat/virt-cat.pod:3 ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3 ../clone/virt-sysprep.pod:3 ../df/virt-df.pod:3 ../edit/virt-edit.pod:3 ../erlang/examples/guestfs-erlang.pod:3 ../examples/guestfs-examples.pod:3 ../examples/guestfs-recipes.pod:14 ../examples/guestfs-testing.pod:3 ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3 ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3 ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3 ../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
  22 msgid "NAME"
  23 msgstr ""
  24
  25 #. type: textblock
  26 #: ../align/virt-alignment-scan.pod:5
  27 msgid "virt-alignment-scan - Check alignment of virtual machine partitions"
  28 msgstr ""
  29
  30 #. type: =head1
  31 #: ../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
  32 msgid "SYNOPSIS"
  33 msgstr ""
  34
  35 #. type: verbatim
  36 #: ../align/virt-alignment-scan.pod:9
  37 #, no-wrap
  38 msgid ""
  39 " virt-alignment-scan [--options] -d domname\n"
  40 "\n"
  41 msgstr ""
  42
  43 #. type: verbatim
  44 #: ../align/virt-alignment-scan.pod:11
  45 #, no-wrap
  46 msgid ""
  47 " virt-alignment-scan [--options] -a disk.img [-a disk.img ...]\n"
  48 "\n"
  49 msgstr ""
  50
  51 #. type: =head1
  52 #: ../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 ../examples/guestfs-testing.pod:7 ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19 ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21 ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20 ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15 ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18 ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:31 ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15 ../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
  53 msgid "DESCRIPTION"
  54 msgstr ""
  55
  56 #. type: textblock
  57 #: ../align/virt-alignment-scan.pod:15
  58 msgid ""
  59 "When older operating systems install themselves, the partitioning tools "
  60 "place partitions at a sector misaligned with the underlying storage "
  61 "(commonly the first partition starts on sector C<63>).  Misaligned "
  62 "partitions can result in an operating system issuing more I/O than should be "
  63 "necessary."
  64 msgstr ""
  65
  66 #. type: textblock
  67 #: ../align/virt-alignment-scan.pod:21
  68 msgid ""
  69 "The virt-alignment-scan tool checks the alignment of partitions in virtual "
  70 "machines and disk images and warns you if there are alignment problems."
  71 msgstr ""
  72
  73 #. type: textblock
  74 #: ../align/virt-alignment-scan.pod:25
  75 msgid ""
  76 "Currently there is no virt tool for fixing alignment problems.  You can only "
  77 "reinstall the guest operating system.  The following NetApp document "
  78 "summarises the problem and possible solutions: "
  79 "L<http://media.netapp.com/documents/tr-3747.pdf>"
  80 msgstr ""
  81
  82 #. type: =head1
  83 #: ../align/virt-alignment-scan.pod:30
  84 msgid "OUTPUT"
  85 msgstr ""
  86
  87 #. type: textblock
  88 #: ../align/virt-alignment-scan.pod:32
  89 msgid "To run this tool on a disk image directly, use the I<-a> option:"
  90 msgstr ""
  91
  92 #. type: verbatim
  93 #: ../align/virt-alignment-scan.pod:34
  94 #, no-wrap
  95 msgid ""
  96 " $ virt-alignment-scan -a winxp.img\n"
  97 " /dev/sda1        32256          512    bad (alignment < 4K)\n"
  98 "\n"
  99 msgstr ""
 100
 101 #. type: verbatim
 102 #: ../align/virt-alignment-scan.pod:37
 103 #, no-wrap
 104 msgid ""
 105 " $ virt-alignment-scan -a fedora16.img\n"
 106 " /dev/sda1      1048576         1024K   ok\n"
 107 " /dev/sda2      2097152         2048K   ok\n"
 108 " /dev/sda3    526385152         2048K   ok\n"
 109 "\n"
 110 msgstr ""
 111
 112 #. type: textblock
 113 #: ../align/virt-alignment-scan.pod:42
 114 msgid ""
 115 "To run the tool on a guest known to libvirt, use the I<-d> option and "
 116 "possibly the I<-c> option:"
 117 msgstr ""
 118
 119 #. type: verbatim
 120 #: ../align/virt-alignment-scan.pod:45
 121 #, no-wrap
 122 msgid ""
 123 " # virt-alignment-scan -d RHEL5\n"
 124 " /dev/sda1        32256          512    bad (alignment < 4K)\n"
 125 " /dev/sda2    106928640          512    bad (alignment < 4K)\n"
 126 "\n"
 127 msgstr ""
 128
 129 #. type: verbatim
 130 #: ../align/virt-alignment-scan.pod:49
 131 #, no-wrap
 132 msgid ""
 133 " $ virt-alignment-scan -c qemu:///system -d Win7TwoDisks\n"
 134 " /dev/sda1      1048576         1024K   ok\n"
 135 " /dev/sda2    105906176         1024K   ok\n"
 136 " /dev/sdb1        65536           64K   ok\n"
 137 "\n"
 138 msgstr ""
 139
 140 #. type: textblock
 141 #: ../align/virt-alignment-scan.pod:54
 142 msgid ""
 143 "The output consists of 4 or more whitespace-separated columns.  Only the "
 144 "first 4 columns are signficant if you want to parse this from a program.  "
 145 "The columns are:"
 146 msgstr ""
 147
 148 #. type: =item
 149 #: ../align/virt-alignment-scan.pod:60
 150 msgid "col 1"
 151 msgstr ""
 152
 153 #. type: textblock
 154 #: ../align/virt-alignment-scan.pod:62
 155 msgid ""
 156 "the device and partition name (eg. C</dev/sda1> meaning the first partition "
 157 "on the first block device)"
 158 msgstr ""
 159
 160 #. type: =item
 161 #: ../align/virt-alignment-scan.pod:65
 162 msgid "col 2"
 163 msgstr ""
 164
 165 #. type: textblock
 166 #: ../align/virt-alignment-scan.pod:67
 167 msgid "the start of the partition in bytes"
 168 msgstr ""
 169
 170 #. type: =item
 171 #: ../align/virt-alignment-scan.pod:69
 172 msgid "col 3"
 173 msgstr ""
 174
 175 #. type: textblock
 176 #: ../align/virt-alignment-scan.pod:71
 177 msgid "the alignment in bytes or Kbytes (eg. C<512> or C<4K>)"
 178 msgstr ""
 179
 180 #. type: =item
 181 #: ../align/virt-alignment-scan.pod:73
 182 msgid "col 4"
 183 msgstr ""
 184
 185 #. type: textblock
 186 #: ../align/virt-alignment-scan.pod:75
 187 msgid ""
 188 "C<ok> if the alignment is best for performance, or C<bad> if the alignment "
 189 "can cause performance problems"
 190 msgstr ""
 191
 192 #. type: =item
 193 #: ../align/virt-alignment-scan.pod:78
 194 msgid "cols 5+"
 195 msgstr ""
 196
 197 #. type: textblock
 198 #: ../align/virt-alignment-scan.pod:80
 199 msgid "optional free-text explanation."
 200 msgstr ""
 201
 202 #. type: textblock
 203 #: ../align/virt-alignment-scan.pod:84
 204 msgid ""
 205 "The exit code from the program changes depending on whether poorly aligned "
 206 "partitions were found.  See L</EXIT STATUS> below."
 207 msgstr ""
 208
 209 #. type: textblock
 210 #: ../align/virt-alignment-scan.pod:87
 211 msgid "If you just want the exit code with no output, use the I<-q> option."
 212 msgstr ""
 213
 214 #. type: =head1
 215 #: ../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:112 ../resize/virt-resize.pod:262 ../sparsify/virt-sparsify.pod:99 ../test-tool/libguestfs-test-tool.pod:36 ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54 ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103 ../tools/virt-win-reg.pl:96
 216 msgid "OPTIONS"
 217 msgstr ""
 218
 219 #. type: =item
 220 #: ../align/virt-alignment-scan.pod:93 ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95 ../cat/virt-ls.pod:265 ../clone/virt-sysprep.pod:46 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66 ../fish/guestfish.pod:152 ../fuse/guestmount.pod:160 ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:116 ../resize/virt-resize.pod:266 ../sparsify/virt-sparsify.pod:103 ../test-tool/libguestfs-test-tool.pod:40 ../tools/virt-list-filesystems.pl:61 ../tools/virt-list-partitions.pl:62 ../tools/virt-make-fs.pl:161 ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104
 221 msgid "B<--help>"
 222 msgstr ""
 223
 224 #. type: textblock
 225 #: ../align/virt-alignment-scan.pod:95 ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97 ../cat/virt-ls.pod:267 ../clone/virt-sysprep.pod:48 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68 ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:118 ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64 ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113 ../tools/virt-win-reg.pl:106
 226 msgid "Display brief help."
 227 msgstr ""
 228
 229 #. type: =item
 230 #: ../align/virt-alignment-scan.pod:97 ../cat/virt-cat.pod:70 ../cat/virt-filesystems.pod:99 ../cat/virt-ls.pod:269 ../clone/virt-sysprep.pod:50 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70 ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:120
 231 msgid "B<-a> file"
 232 msgstr ""
 233
 234 #. type: =item
 235 #: ../align/virt-alignment-scan.pod:99 ../cat/virt-cat.pod:72 ../cat/virt-filesystems.pod:101 ../cat/virt-ls.pod:271 ../clone/virt-sysprep.pod:52 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72 ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:122
 236 msgid "B<--add> file"
 237 msgstr ""
 238
 239 #. type: textblock
 240 #: ../align/virt-alignment-scan.pod:101 ../clone/virt-sysprep.pod:54
 241 msgid "Add I<file> which should be a disk image from a virtual machine."
 242 msgstr ""
 243
 244 #. type: textblock
 245 #: ../align/virt-alignment-scan.pod:103 ../cat/virt-cat.pod:78 ../cat/virt-filesystems.pod:107 ../cat/virt-ls.pod:277 ../clone/virt-sysprep.pod:56 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78 ../fish/guestfish.pod:174 ../fuse/guestmount.pod:102 ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:128
 246 msgid ""
 247 "The format of the disk image is auto-detected.  To override this and force a "
 248 "particular format use the I<--format=..> option."
 249 msgstr ""
 250
 251 #. type: =item
 252 #: ../align/virt-alignment-scan.pod:106 ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125 ../cat/virt-ls.pod:291 ../clone/virt-sysprep.pod:59 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:135
 253 msgid "B<-c> URI"
 254 msgstr ""
 255
 256 #. type: =item
 257 #: ../align/virt-alignment-scan.pod:108 ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127 ../cat/virt-ls.pod:293 ../clone/virt-sysprep.pod:61 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:137
 258 msgid "B<--connect> URI"
 259 msgstr ""
 260
 261 #. type: textblock
 262 #: ../align/virt-alignment-scan.pod:110 ../cat/virt-cat.pod:85 ../cat/virt-filesystems.pod:129 ../cat/virt-ls.pod:295 ../clone/virt-sysprep.pod:63 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99 ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:139 ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82 ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
 263 msgid ""
 264 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
 265 "to the default libvirt hypervisor."
 266 msgstr ""
 267
 268 #. type: textblock
 269 #: ../align/virt-alignment-scan.pod:113 ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132 ../cat/virt-ls.pod:298 ../clone/virt-sysprep.pod:66 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:142
 270 msgid ""
 271 "If you specify guest block devices directly (I<-a>), then libvirt is not "
 272 "used at all."
 273 msgstr ""
 274
 275 #. type: =item
 276 #: ../align/virt-alignment-scan.pod:116 ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141 ../cat/virt-ls.pod:307 ../clone/virt-sysprep.pod:69 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105 ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:145
 277 msgid "B<-d> guest"
 278 msgstr ""
 279
 280 #. type: =item
 281 #: ../align/virt-alignment-scan.pod:118 ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143 ../cat/virt-ls.pod:309 ../clone/virt-sysprep.pod:71 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107 ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:147
 282 msgid "B<--domain> guest"
 283 msgstr ""
 284
 285 #. type: textblock
 286 #: ../align/virt-alignment-scan.pod:120 ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145 ../cat/virt-ls.pod:311 ../clone/virt-sysprep.pod:73 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109 ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:149
 287 msgid ""
 288 "Add all the disks from the named libvirt guest.  Domain UUIDs can be used "
 289 "instead of names."
 290 msgstr ""
 291
 292 #. type: =item
 293 #: ../align/virt-alignment-scan.pod:123 ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170 ../cat/virt-ls.pod:328 ../clone/virt-sysprep.pod:95 ../df/virt-df.pod:101 ../fish/guestfish.pod:233 ../fuse/guestmount.pod:142 ../inspector/virt-inspector.pod:99 ../rescue/virt-rescue.pod:152
 294 msgid "B<--format=raw|qcow2|..>"
 295 msgstr ""
 296
 297 #. type: =item
 298 #: ../align/virt-alignment-scan.pod:125 ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172 ../cat/virt-ls.pod:330 ../clone/virt-sysprep.pod:97 ../df/virt-df.pod:103 ../edit/virt-edit.pod:134 ../fish/guestfish.pod:235 ../fuse/guestmount.pod:144 ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:154
 299 msgid "B<--format>"
 300 msgstr ""
 301
 302 #. type: textblock
 303 #: ../align/virt-alignment-scan.pod:127 ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174 ../cat/virt-ls.pod:332 ../clone/virt-sysprep.pod:99 ../df/virt-df.pod:105 ../edit/virt-edit.pod:136 ../fish/guestfish.pod:237 ../fuse/guestmount.pod:146 ../rescue/virt-rescue.pod:156
 304 msgid ""
 305 "The default for the I<-a> option is to auto-detect the format of the disk "
 306 "image.  Using this forces the disk format for I<-a> options which follow on "
 307 "the command line.  Using I<--format> with no argument switches back to "
 308 "auto-detection for subsequent I<-a> options."
 309 msgstr ""
 310
 311 #. type: textblock
 312 #: ../align/virt-alignment-scan.pod:132 ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179 ../cat/virt-ls.pod:337 ../clone/virt-sysprep.pod:104 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141 ../fish/guestfish.pod:242 ../fish/guestfish.pod:673 ../inspector/virt-inspector.pod:351 ../rescue/virt-rescue.pod:161 ../src/guestfs.pod:2877
 313 msgid "For example:"
 314 msgstr ""
 315
 316 #. type: verbatim
 317 #: ../align/virt-alignment-scan.pod:134
 318 #, no-wrap
 319 msgid ""
 320 " virt-alignment-scan --format=raw -a disk.img\n"
 321 "\n"
 322 msgstr ""
 323
 324 #. type: textblock
 325 #: ../align/virt-alignment-scan.pod:136 ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183 ../cat/virt-ls.pod:341 ../clone/virt-sysprep.pod:108 ../df/virt-df.pod:114 ../edit/virt-edit.pod:145 ../fish/guestfish.pod:246 ../rescue/virt-rescue.pod:165
 326 msgid "forces raw format (no auto-detection) for C<disk.img>."
 327 msgstr ""
 328
 329 #. type: verbatim
 330 #: ../align/virt-alignment-scan.pod:138
 331 #, no-wrap
 332 msgid ""
 333 " virt-alignment-scan --format=raw -a disk.img --format -a another.img\n"
 334 "\n"
 335 msgstr ""
 336
 337 #. type: textblock
 338 #: ../align/virt-alignment-scan.pod:140 ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187 ../cat/virt-ls.pod:345 ../clone/virt-sysprep.pod:112 ../df/virt-df.pod:118 ../edit/virt-edit.pod:149 ../fish/guestfish.pod:250 ../rescue/virt-rescue.pod:169
 339 msgid ""
 340 "forces raw format (no auto-detection) for C<disk.img> and reverts to "
 341 "auto-detection for C<another.img>."
 342 msgstr ""
 343
 344 #. type: textblock
 345 #: ../align/virt-alignment-scan.pod:143 ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190 ../cat/virt-ls.pod:348 ../clone/virt-sysprep.pod:115 ../df/virt-df.pod:121 ../edit/virt-edit.pod:152 ../rescue/virt-rescue.pod:172
 346 msgid ""
 347 "If you have untrusted raw-format guest disk images, you should use this "
 348 "option to specify the disk format.  This avoids a possible security problem "
 349 "with malicious guests (CVE-2010-3851)."
 350 msgstr ""
 351
 352 #. type: =item
 353 #: ../align/virt-alignment-scan.pod:147 ../resize/virt-resize.pod:497 ../sparsify/virt-sparsify.pod:177
 354 msgid "B<-q>"
 355 msgstr ""
 356
 357 #. type: =item
 358 #: ../align/virt-alignment-scan.pod:149 ../resize/virt-resize.pod:499 ../sparsify/virt-sparsify.pod:179
 359 msgid "B<--quiet>"
 360 msgstr ""
 361
 362 #. type: textblock
 363 #: ../align/virt-alignment-scan.pod:151
 364 msgid ""
 365 "Don't produce any output.  Just set the exit code (see L</EXIT STATUS> "
 366 "below)."
 367 msgstr ""
 368
 369 #. type: =item
 370 #: ../align/virt-alignment-scan.pod:154 ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261 ../cat/virt-ls.pod:425 ../clone/virt-sysprep.pod:138 ../df/virt-df.pod:173 ../edit/virt-edit.pod:161 ../fish/guestfish.pod:390 ../fuse/guestmount.pod:266 ../inspector/virt-inspector.pod:119 ../rescue/virt-rescue.pod:219 ../sparsify/virt-sparsify.pod:183
 371 msgid "B<-v>"
 372 msgstr ""
 373
 374 #. type: =item
 375 #: ../align/virt-alignment-scan.pod:156 ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263 ../cat/virt-ls.pod:427 ../clone/virt-sysprep.pod:140 ../df/virt-df.pod:175 ../edit/virt-edit.pod:163 ../fish/guestfish.pod:392 ../fuse/guestmount.pod:268 ../inspector/virt-inspector.pod:121 ../rescue/virt-rescue.pod:221 ../sparsify/virt-sparsify.pod:185
 376 msgid "B<--verbose>"
 377 msgstr ""
 378
 379 #. type: textblock
 380 #: ../align/virt-alignment-scan.pod:158 ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265 ../cat/virt-ls.pod:429 ../clone/virt-sysprep.pod:142 ../df/virt-df.pod:177 ../edit/virt-edit.pod:165 ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:223 ../sparsify/virt-sparsify.pod:187
 381 msgid "Enable verbose messages for debugging."
 382 msgstr ""
 383
 384 #. type: =item
 385 #: ../align/virt-alignment-scan.pod:160 ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267 ../cat/virt-ls.pod:431 ../clone/virt-sysprep.pod:144 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167 ../fish/guestfish.pod:397 ../fuse/guestmount.pod:272 ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:225 ../resize/virt-resize.pod:567 ../sparsify/virt-sparsify.pod:189
 386 msgid "B<-V>"
 387 msgstr ""
 388
 389 #. type: =item
 390 #: ../align/virt-alignment-scan.pod:162 ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269 ../cat/virt-ls.pod:433 ../clone/virt-sysprep.pod:146 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169 ../fish/guestfish.pod:399 ../fuse/guestmount.pod:274 ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:227 ../resize/virt-resize.pod:569 ../sparsify/virt-sparsify.pod:191 ../tools/virt-list-filesystems.pl:69 ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169 ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112
 391 msgid "B<--version>"
 392 msgstr ""
 393
 394 #. type: textblock
 395 #: ../align/virt-alignment-scan.pod:164 ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271 ../cat/virt-ls.pod:435 ../clone/virt-sysprep.pod:148 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171 ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:229 ../resize/virt-resize.pod:571 ../sparsify/virt-sparsify.pod:193 ../tools/virt-list-filesystems.pl:71 ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171 ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114
 396 msgid "Display version number and exit."
 397 msgstr ""
 398
 399 #. type: =item
 400 #: ../align/virt-alignment-scan.pod:166 ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281 ../cat/virt-ls.pod:437 ../clone/virt-sysprep.pod:150 ../df/virt-df.pod:185 ../edit/virt-edit.pod:173 ../fish/guestfish.pod:412 ../fuse/guestmount.pod:287 ../inspector/virt-inspector.pod:131 ../rescue/virt-rescue.pod:240 ../sparsify/virt-sparsify.pod:195 ../tools/virt-tar.pl:158
 401 msgid "B<-x>"
 402 msgstr ""
 403
 404 #. type: textblock
 405 #: ../align/virt-alignment-scan.pod:168 ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283 ../cat/virt-ls.pod:439 ../clone/virt-sysprep.pod:152 ../df/virt-df.pod:187 ../edit/virt-edit.pod:175 ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:242 ../sparsify/virt-sparsify.pod:197
 406 msgid "Enable tracing of libguestfs API calls."
 407 msgstr ""
 408
 409 #. type: =head1
 410 #: ../align/virt-alignment-scan.pod:172
 411 msgid "RECOMMENDED ALIGNMENT"
 412 msgstr ""
 413
 414 #. type: textblock
 415 #: ../align/virt-alignment-scan.pod:174
 416 msgid ""
 417 "Operating systems older than Windows 2008 and Linux before ca.2010 place the "
 418 "first sector of the first partition at sector 63, with a 512 byte sector "
 419 "size.  This happens because of a historical accident.  Drives have to report "
 420 "a cylinder / head / sector (CHS) geometry to the BIOS.  The geometry is "
 421 "completely meaningless on modern drives, but it happens that the geometry "
 422 "reported always has 63 sectors per track.  The operating system therefore "
 423 "places the first partition at the start of the second \"track\", at sector "
 424 "63."
 425 msgstr ""
 426
 427 #. type: textblock
 428 #: ../align/virt-alignment-scan.pod:183
 429 msgid ""
 430 "When the guest OS is virtualized, the host operating system and hypervisor "
 431 "may prefer accesses aligned to one of:"
 432 msgstr ""
 433
 434 #. type: =item
 435 #: ../align/virt-alignment-scan.pod:188
 436 msgid "* 512 bytes"
 437 msgstr ""
 438
 439 #. type: textblock
 440 #: ../align/virt-alignment-scan.pod:190
 441 msgid ""
 442 "if the host OS uses local storage directly on hard drive partitions, and the "
 443 "hard drive has 512 byte physical sectors."
 444 msgstr ""
 445
 446 #. type: =item
 447 #: ../align/virt-alignment-scan.pod:193
 448 msgid "* 4 Kbytes"
 449 msgstr ""
 450
 451 #. type: textblock
 452 #: ../align/virt-alignment-scan.pod:195
 453 msgid ""
 454 "for local storage on new hard drives with 4Kbyte physical sectors; for "
 455 "file-backed storage on filesystems with 4Kbyte block size; or for some types "
 456 "of network-attached storage."
 457 msgstr ""
 458
 459 #. type: =item
 460 #: ../align/virt-alignment-scan.pod:199
 461 msgid "* 64 Kbytes"
 462 msgstr ""
 463
 464 #. type: textblock
 465 #: ../align/virt-alignment-scan.pod:201
 466 msgid ""
 467 "for high-end network-attached storage.  This is the optimal block size for "
 468 "some NetApp hardware."
 469 msgstr ""
 470
 471 #. type: =item
 472 #: ../align/virt-alignment-scan.pod:204
 473 msgid "* 1 Mbyte"
 474 msgstr ""
 475
 476 #. type: textblock
 477 #: ../align/virt-alignment-scan.pod:206
 478 msgid "see L</1 MB PARTITION ALIGNMENT> below."
 479 msgstr ""
 480
 481 #. type: textblock
 482 #: ../align/virt-alignment-scan.pod:210
 483 msgid ""
 484 "Partitions which are not aligned correctly to the underlying storage cause "
 485 "extra I/O.  For example:"
 486 msgstr ""
 487
 488 #. type: verbatim
 489 #: ../align/virt-alignment-scan.pod:213
 490 #, no-wrap
 491 msgid ""
 492 "                       sect#63\n"
 493 "                       +--------------------------+------\n"
 494 "                       |         guest            |\n"
 495 "                       |    filesystem block      |\n"
 496 " ---+------------------+------+-------------------+-----+---\n"
 497 "    |  host block             |  host block             |\n"
 498 "    |                         |                         |\n"
 499 " ---+-------------------------+-------------------------+---\n"
 500 "\n"
 501 msgstr ""
 502
 503 #. type: textblock
 504 #: ../align/virt-alignment-scan.pod:222
 505 msgid ""
 506 "In this example, each time a 4K guest block is read, two blocks on the host "
 507 "must be accessed (so twice as much I/O is done).  When a 4K guest block is "
 508 "written, two host blocks must first be read, the old and new data combined, "
 509 "and the two blocks written back (4x I/O)."
 510 msgstr ""
 511
 512 #. type: =head2
 513 #: ../align/virt-alignment-scan.pod:227
 514 msgid "LINUX HOST BLOCK AND I/O SIZE"
 515 msgstr ""
 516
 517 #. type: textblock
 518 #: ../align/virt-alignment-scan.pod:229
 519 msgid ""
 520 "New versions of the Linux kernel expose the physical and logical block size, "
 521 "and minimum and recommended I/O size."
 522 msgstr ""
 523
 524 #. type: textblock
 525 #: ../align/virt-alignment-scan.pod:232
 526 msgid "For a typical consumer hard drive with 512 byte sectors:"
 527 msgstr ""
 528
 529 #. type: verbatim
 530 #: ../align/virt-alignment-scan.pod:234
 531 #, no-wrap
 532 msgid ""
 533 " $ cat /sys/block/sda/queue/hw_sector_size\n"
 534 " 512\n"
 535 " $ cat /sys/block/sda/queue/physical_block_size\n"
 536 " 512\n"
 537 " $ cat /sys/block/sda/queue/logical_block_size\n"
 538 " 512\n"
 539 " $ cat /sys/block/sda/queue/minimum_io_size\n"
 540 " 512\n"
 541 " $ cat /sys/block/sda/queue/optimal_io_size\n"
 542 " 0\n"
 543 "\n"
 544 msgstr ""
 545
 546 #. type: textblock
 547 #: ../align/virt-alignment-scan.pod:245
 548 msgid "For a new consumer hard drive with 4Kbyte sectors:"
 549 msgstr ""
 550
 551 #. type: verbatim
 552 #: ../align/virt-alignment-scan.pod:247
 553 #, no-wrap
 554 msgid ""
 555 " $ cat /sys/block/sda/queue/hw_sector_size\n"
 556 " 4096\n"
 557 " $ cat /sys/block/sda/queue/physical_block_size\n"
 558 " 4096\n"
 559 " $ cat /sys/block/sda/queue/logical_block_size\n"
 560 " 4096\n"
 561 " $ cat /sys/block/sda/queue/minimum_io_size\n"
 562 " 4096\n"
 563 " $ cat /sys/block/sda/queue/optimal_io_size\n"
 564 " 0\n"
 565 "\n"
 566 msgstr ""
 567
 568 #. type: textblock
 569 #: ../align/virt-alignment-scan.pod:258
 570 msgid "For a NetApp LUN:"
 571 msgstr ""
 572
 573 #. type: verbatim
 574 #: ../align/virt-alignment-scan.pod:260
 575 #, no-wrap
 576 msgid ""
 577 " $ cat /sys/block/sdc/queue/logical_block_size\n"
 578 " 512\n"
 579 " $ cat /sys/block/sdc/queue/physical_block_size\n"
 580 " 512\n"
 581 " $ cat /sys/block/sdc/queue/minimum_io_size\n"
 582 " 4096\n"
 583 " $ cat /sys/block/sdc/queue/optimal_io_size\n"
 584 " 65536\n"
 585 "\n"
 586 msgstr ""
 587
 588 #. type: textblock
 589 #: ../align/virt-alignment-scan.pod:269
 590 msgid ""
 591 "The NetApp allows 512 byte accesses (but they will be very inefficient), "
 592 "prefers a minimum 4K I/O size, but the optimal I/O size is 64K."
 593 msgstr ""
 594
 595 #. type: textblock
 596 #: ../align/virt-alignment-scan.pod:273
 597 msgid ""
 598 "For detailed information about what these numbers mean, see "
 599 "L<http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Storage_Administration_Guide/newstorage-iolimits.html>"
 600 msgstr ""
 601
 602 #. type: textblock
 603 #: ../align/virt-alignment-scan.pod:276
 604 msgid ""
 605 "[Thanks to Matt Booth for providing 4K drive data.  Thanks to Mike Snitzer "
 606 "for providing NetApp data and additional information.]"
 607 msgstr ""
 608
 609 #. type: =head2
 610 #: ../align/virt-alignment-scan.pod:279
 611 msgid "1 MB PARTITION ALIGNMENT"
 612 msgstr ""
 613
 614 #. type: textblock
 615 #: ../align/virt-alignment-scan.pod:281
 616 msgid ""
 617 "Microsoft picked 1 MB as the default alignment for all partitions starting "
 618 "with Windows 2008 Server, and Linux has followed this."
 619 msgstr ""
 620
 621 #. type: textblock
 622 #: ../align/virt-alignment-scan.pod:284
 623 msgid ""
 624 "Assuming 512 byte sectors in the guest, you will now see the first partition "
 625 "starting at sector 2048, and subsequent partitions (if any)  will start at a "
 626 "multiple of 2048 sectors."
 627 msgstr ""
 628
 629 #. type: textblock
 630 #: ../align/virt-alignment-scan.pod:288
 631 msgid ""
 632 "1 MB alignment is compatible with all current alignment requirements (4K, "
 633 "64K) and provides room for future growth in physical block sizes."
 634 msgstr ""
 635
 636 #. type: =head2
 637 #: ../align/virt-alignment-scan.pod:291
 638 msgid "SETTING ALIGNMENT"
 639 msgstr ""
 640
 641 #. type: textblock
 642 #: ../align/virt-alignment-scan.pod:293
 643 msgid ""
 644 "L<virt-resize(1)> can change the alignment of the partitions of some "
 645 "guests.  Currently it can fully align all the partitions of all Windows "
 646 "guests, and it will fix the bootloader where necessary.  For Linux guests, "
 647 "it can align the second and subsequent partitions, so the majority of OS "
 648 "accesses except at boot will be aligned."
 649 msgstr ""
 650
 651 #. type: textblock
 652 #: ../align/virt-alignment-scan.pod:299
 653 msgid ""
 654 "Another way to correct partition alignment problems is to reinstall your "
 655 "guest operating systems.  If you install operating systems from templates, "
 656 "ensure these have correct partition alignment too."
 657 msgstr ""
 658
 659 #. type: textblock
 660 #: ../align/virt-alignment-scan.pod:303
 661 msgid ""
 662 "For older versions of Windows, the following NetApp document contains useful "
 663 "information: L<http://media.netapp.com/documents/tr-3747.pdf>"
 664 msgstr ""
 665
 666 #. type: textblock
 667 #: ../align/virt-alignment-scan.pod:306
 668 msgid ""
 669 "For Red Hat Enterprise Linux E<le> 5, use a Kickstart script that contains "
 670 "an explicit C<%pre> section that creates aligned partitions using "
 671 "L<parted(8)>.  Do not use the Kickstart C<part> command.  The NetApp "
 672 "document above contains an example."
 673 msgstr ""
 674
 675 #. type: =head1
 676 #: ../align/virt-alignment-scan.pod:311 ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:373 ../cat/virt-ls.pod:483 ../clone/virt-sysprep.pod:475 ../df/virt-df.pod:241 ../edit/virt-edit.pod:342 ../inspector/virt-inspector.pod:367 ../rescue/virt-rescue.pod:303 ../resize/virt-resize.pod:682 ../tools/virt-list-filesystems.pl:188 ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:550 ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:744
 677 msgid "SHELL QUOTING"
 678 msgstr ""
 679
 680 #. type: textblock
 681 #: ../align/virt-alignment-scan.pod:313 ../cat/virt-cat.pod:233 ../cat/virt-filesystems.pod:375 ../cat/virt-ls.pod:485 ../clone/virt-sysprep.pod:477 ../df/virt-df.pod:243 ../edit/virt-edit.pod:344 ../inspector/virt-inspector.pod:369 ../rescue/virt-rescue.pod:305 ../resize/virt-resize.pod:684 ../tools/virt-list-filesystems.pl:190 ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:552 ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:752
 682 msgid ""
 683 "Libvirt guest names can contain arbitrary characters, some of which have "
 684 "meaning to the shell such as C<#> and space.  You may need to quote or "
 685 "escape these characters on the command line.  See the shell manual page "
 686 "L<sh(1)> for details."
 687 msgstr ""
 688
 689 #. type: =head1
 690 #: ../align/virt-alignment-scan.pod:318 ../cat/virt-cat.pod:238 ../cat/virt-filesystems.pod:380 ../cat/virt-ls.pod:490 ../clone/virt-sysprep.pod:482 ../df/virt-df.pod:248 ../edit/virt-edit.pod:349 ../fish/guestfish.pod:1114 ../fuse/guestmount.pod:312 ../inspector/virt-inspector.pod:390 ../resize/virt-resize.pod:689 ../sparsify/virt-sparsify.pod:251 ../test-tool/libguestfs-test-tool.pod:90
 691 msgid "EXIT STATUS"
 692 msgstr ""
 693
 694 #. type: textblock
 695 #: ../align/virt-alignment-scan.pod:320
 696 msgid "This program returns:"
 697 msgstr ""
 698
 699 #. type: =item
 700 #: ../align/virt-alignment-scan.pod:324 ../align/virt-alignment-scan.pod:330 ../align/virt-alignment-scan.pod:336 ../align/virt-alignment-scan.pod:343 ../cat/virt-cat.pod:177 ../cat/virt-cat.pod:182 ../cat/virt-cat.pod:187 ../cat/virt-cat.pod:198 ../cat/virt-cat.pod:202 ../clone/virt-sysprep.pod:283 ../clone/virt-sysprep.pod:287 ../clone/virt-sysprep.pod:291 ../clone/virt-sysprep.pod:295 ../clone/virt-sysprep.pod:310 ../clone/virt-sysprep.pod:314 ../clone/virt-sysprep.pod:318 ../clone/virt-sysprep.pod:322 ../clone/virt-sysprep.pod:326 ../clone/virt-sysprep.pod:362 ../clone/virt-sysprep.pod:384 ../clone/virt-sysprep.pod:388 ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266 ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276 ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291 ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102 ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132 ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227 ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235 ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243 ../examples/guestfs-testing.pod:110 ../examples/guestfs-testing.pod:114 ../examples/guestfs-testing.pod:118 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:463 ../fish/guestfish-actions.pod:1262 ../fish/guestfish-actions.pod:1266 ../fish/guestfish-actions.pod:1270 ../fish/guestfish-actions.pod:1274 ../fish/guestfish-actions.pod:1282 ../fish/guestfish-actions.pod:1286 ../fish/guestfish-actions.pod:1290 ../fish/guestfish-actions.pod:1300 ../fish/guestfish-actions.pod:1304 ../fish/guestfish-actions.pod:1308 ../fish/guestfish-actions.pod:1398 ../fish/guestfish-actions.pod:1402 ../fish/guestfish-actions.pod:1407 ../fish/guestfish-actions.pod:1412 ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:1458 ../fish/guestfish-actions.pod:1463 ../fish/guestfish-actions.pod:1719 ../fish/guestfish-actions.pod:1726 ../fish/guestfish-actions.pod:1733 ../fish/guestfish-actions.pod:2136 ../fish/guestfish-actions.pod:2142 ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2164 ../fish/guestfish.pod:445 ../fish/guestfish.pod:449 ../fish/guestfish.pod:453 ../fish/guestfish.pod:457 ../inspector/virt-inspector.pod:408 ../inspector/virt-inspector.pod:412 ../resize/virt-resize.pod:365 ../resize/virt-resize.pod:369 ../resize/virt-resize.pod:378 ../resize/virt-resize.pod:384 ../sparsify/virt-sparsify.pod:32 ../sparsify/virt-sparsify.pod:39 ../sparsify/virt-sparsify.pod:43 ../sparsify/virt-sparsify.pod:49 ../sparsify/virt-sparsify.pod:54 ../sparsify/virt-sparsify.pod:58 ../sparsify/virt-sparsify.pod:64 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:29 ../src/guestfs-actions.pod:641 ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:656 ../src/guestfs-actions.pod:663 ../src/guestfs-actions.pod:2079 ../src/guestfs-actions.pod:2083 ../src/guestfs-actions.pod:2087 ../src/guestfs-actions.pod:2091 ../src/guestfs-actions.pod:2099 ../src/guestfs-actions.pod:2103 ../src/guestfs-actions.pod:2107 ../src/guestfs-actions.pod:2117 ../src/guestfs-actions.pod:2121 ../src/guestfs-actions.pod:2125 ../src/guestfs-actions.pod:2263 ../src/guestfs-actions.pod:2267 ../src/guestfs-actions.pod:2272 ../src/guestfs-actions.pod:2277 ../src/guestfs-actions.pod:2338 ../src/guestfs-actions.pod:2342 ../src/guestfs-actions.pod:2347 ../src/guestfs-actions.pod:2762 ../src/guestfs-actions.pod:2769 ../src/guestfs-actions.pod:2776 ../src/guestfs-actions.pod:3321 ../src/guestfs-actions.pod:3327 ../src/guestfs-actions.pod:3335 ../src/guestfs-actions.pod:3342 ../src/guestfs-actions.pod:3349 ../src/guestfs.pod:403 ../src/guestfs.pod:408 ../src/guestfs.pod:413 ../src/guestfs.pod:417 ../src/guestfs.pod:422 ../src/guestfs.pod:426 ../src/guestfs.pod:431 ../src/guestfs.pod:436 ../src/guestfs.pod:1109 ../src/guestfs.pod:1113 ../src/guestfs.pod:1117 ../src/guestfs.pod:1122 ../src/guestfs.pod:1130 ../src/guestfs.pod:1149 ../src/guestfs.pod:1157 ../src/guestfs.pod:1179 ../src/guestfs.pod:1183 ../src/guestfs.pod:1187 ../src/guestfs.pod:1191 ../src/guestfs.pod:1195 ../src/guestfs.pod:1199 ../src/guestfs.pod:1689 ../src/guestfs.pod:1694 ../src/guestfs.pod:1698 ../src/guestfs.pod:1800 ../src/guestfs.pod:1805 ../src/guestfs.pod:1809 ../src/guestfs.pod:1819 ../src/guestfs.pod:2108 ../src/guestfs.pod:2113 ../src/guestfs.pod:2119 ../src/guestfs.pod:2127 ../src/guestfs.pod:2645 ../src/guestfs.pod:2651 ../src/guestfs.pod:2656 ../src/guestfs.pod:2662 ../src/guestfs.pod:3067 ../src/guestfs.pod:3072 ../src/guestfs.pod:3076 ../src/guestfs.pod:3080 ../src/guestfs.pod:3084 ../src/guestfs.pod:3098 ../src/guestfs.pod:3103 ../src/guestfs.pod:3335 ../src/guestfs.pod:3339 ../src/guestfs.pod:3343 ../src/guestfs.pod:3347 ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202 ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:721 ../tools/virt-win-reg.pl:727 ../tools/virt-win-reg.pl:733
 701 msgid "*"
 702 msgstr ""
 703
 704 #. type: textblock
 705 #: ../align/virt-alignment-scan.pod:326
 706 msgid "0"
 707 msgstr ""
 708
 709 #. type: textblock
 710 #: ../align/virt-alignment-scan.pod:328
 711 msgid "successful exit, all partitions are aligned E<ge> 64K for best performance"
 712 msgstr ""
 713
 714 #. type: textblock
 715 #: ../align/virt-alignment-scan.pod:332
 716 msgid "1"
 717 msgstr ""
 718
 719 #. type: textblock
 720 #: ../align/virt-alignment-scan.pod:334
 721 msgid "an error scanning the disk image or guest"
 722 msgstr ""
 723
 724 #. type: textblock
 725 #: ../align/virt-alignment-scan.pod:338
 726 msgid "2"
 727 msgstr ""
 728
 729 #. type: textblock
 730 #: ../align/virt-alignment-scan.pod:340
 731 msgid ""
 732 "successful exit, some partitions have alignment E<lt> 64K which can result "
 733 "in poor performance on high end network storage"
 734 msgstr ""
 735
 736 #. type: textblock
 737 #: ../align/virt-alignment-scan.pod:345
 738 msgid "3"
 739 msgstr ""
 740
 741 #. type: textblock
 742 #: ../align/virt-alignment-scan.pod:347
 743 msgid ""
 744 "successful exit, some partitions have alignment E<lt> 4K which can result in "
 745 "poor performance on most hypervisors"
 746 msgstr ""
 747
 748 #. type: =head1
 749 #: ../align/virt-alignment-scan.pod:352 ../cat/virt-cat.pod:243 ../cat/virt-filesystems.pod:385 ../cat/virt-ls.pod:495 ../clone/virt-sysprep.pod:486 ../df/virt-df.pod:253 ../edit/virt-edit.pod:354 ../erlang/examples/guestfs-erlang.pod:97 ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384 ../examples/guestfs-testing.pod:291 ../fish/guestfish.pod:1268 ../fish/virt-copy-in.pod:50 ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47 ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:317 ../inspector/virt-inspector.pod:395 ../java/examples/guestfs-java.pod:45 ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39 ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:325 ../resize/virt-resize.pod:694 ../ruby/examples/guestfs-ruby.pod:36 ../sparsify/virt-sparsify.pod:275 ../src/guestfs.pod:3275 ../test-tool/libguestfs-test-tool.pod:100 ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265 ../tools/virt-make-fs.pl:557 ../tools/virt-tar.pl:296 ../tools/virt-win-reg.pl:757
 750 msgid "SEE ALSO"
 751 msgstr ""
 752
 753 #. type: textblock
 754 #: ../align/virt-alignment-scan.pod:354
 755 msgid ""
 756 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-rescue(1)>, "
 757 "L<virt-resize(1)>, L<http://libguestfs.org/>."
 758 msgstr ""
 759
 760 #. type: =head1
 761 #: ../align/virt-alignment-scan.pod:361 ../cat/virt-cat.pod:252 ../cat/virt-filesystems.pod:396 ../cat/virt-ls.pod:507 ../clone/virt-sysprep.pod:501 ../df/virt-df.pod:261 ../edit/virt-edit.pod:368 ../rescue/virt-rescue.pod:334 ../resize/virt-resize.pod:717 ../sparsify/virt-sparsify.pod:288 ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277 ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:311 ../tools/virt-win-reg.pl:783
 762 msgid "AUTHOR"
 763 msgstr ""
 764
 765 #. type: textblock
 766 #: ../align/virt-alignment-scan.pod:363 ../cat/virt-cat.pod:254 ../cat/virt-filesystems.pod:398 ../cat/virt-ls.pod:509 ../clone/virt-sysprep.pod:503 ../df/virt-df.pod:263 ../edit/virt-edit.pod:370 ../inspector/virt-inspector.pod:410 ../rescue/virt-rescue.pod:336 ../resize/virt-resize.pod:719 ../sparsify/virt-sparsify.pod:290 ../tools/virt-list-filesystems.pl:210 ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:584 ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:785
 767 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
 768 msgstr ""
 769
 770 #. type: =head1
 771 #: ../align/virt-alignment-scan.pod:365 ../cat/virt-cat.pod:256 ../cat/virt-filesystems.pod:400 ../cat/virt-ls.pod:511 ../clone/virt-sysprep.pod:505 ../df/virt-df.pod:265 ../edit/virt-edit.pod:372 ../erlang/examples/guestfs-erlang.pod:114 ../examples/guestfs-examples.pod:49 ../examples/guestfs-recipes.pod:401 ../examples/guestfs-testing.pod:302 ../fish/guestfish.pod:1300 ../fish/virt-copy-in.pod:64 ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62 ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:332 ../inspector/virt-inspector.pod:418 ../java/examples/guestfs-java.pod:62 ../ocaml/examples/guestfs-ocaml.pod:95 ../perl/examples/guestfs-perl.pod:56 ../python/examples/guestfs-python.pod:58 ../rescue/virt-rescue.pod:338 ../resize/virt-resize.pod:721 ../ruby/examples/guestfs-ruby.pod:52 ../sparsify/virt-sparsify.pod:292 ../src/guestfs.pod:3358 ../test-tool/libguestfs-test-tool.pod:110 ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281 ../tools/virt-make-fs.pl:586 ../tools/virt-tar.pl:315 ../tools/virt-win-reg.pl:787
 772 msgid "COPYRIGHT"
 773 msgstr ""
 774
 775 #. type: textblock
 776 #: ../align/virt-alignment-scan.pod:367 ../clone/virt-sysprep.pod:507 ../sparsify/virt-sparsify.pod:294
 777 msgid "Copyright (C) 2011 Red Hat Inc."
 778 msgstr ""
 779
 780 #. type: textblock
 781 #: ../align/virt-alignment-scan.pod:369 ../cat/virt-cat.pod:260 ../cat/virt-filesystems.pod:404 ../cat/virt-ls.pod:515 ../clone/virt-sysprep.pod:509 ../df/virt-df.pod:269 ../edit/virt-edit.pod:376 ../fish/guestfish.pod:1305 ../fish/virt-copy-in.pod:69 ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67 ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:337 ../inspector/virt-inspector.pod:422 ../rescue/virt-rescue.pod:342 ../resize/virt-resize.pod:725 ../sparsify/virt-sparsify.pod:296 ../test-tool/libguestfs-test-tool.pod:115 ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285 ../tools/virt-make-fs.pl:590 ../tools/virt-tar.pl:319 ../tools/virt-win-reg.pl:791
 782 msgid ""
 783 "This program is free software; you can redistribute it and/or modify it "
 784 "under the terms of the GNU General Public License as published by the Free "
 785 "Software Foundation; either version 2 of the License, or (at your option) "
 786 "any later version."
 787 msgstr ""
 788
 789 #. type: textblock
 790 #: ../align/virt-alignment-scan.pod:374 ../cat/virt-cat.pod:265 ../cat/virt-filesystems.pod:409 ../cat/virt-ls.pod:520 ../clone/virt-sysprep.pod:514 ../df/virt-df.pod:274 ../edit/virt-edit.pod:381 ../fish/guestfish.pod:1310 ../fish/virt-copy-in.pod:74 ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72 ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:342 ../inspector/virt-inspector.pod:427 ../rescue/virt-rescue.pod:347 ../resize/virt-resize.pod:730 ../sparsify/virt-sparsify.pod:301 ../test-tool/libguestfs-test-tool.pod:120 ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290 ../tools/virt-make-fs.pl:595 ../tools/virt-tar.pl:324 ../tools/virt-win-reg.pl:796
 791 msgid ""
 792 "This program is distributed in the hope that it will be useful, but WITHOUT "
 793 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
 794 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
 795 "more details."
 796 msgstr ""
 797
 798 #. type: textblock
 799 #: ../align/virt-alignment-scan.pod:379 ../cat/virt-cat.pod:270 ../cat/virt-filesystems.pod:414 ../cat/virt-ls.pod:525 ../clone/virt-sysprep.pod:519 ../df/virt-df.pod:279 ../edit/virt-edit.pod:386 ../fish/guestfish.pod:1315 ../fish/virt-copy-in.pod:79 ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77 ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:347 ../inspector/virt-inspector.pod:432 ../rescue/virt-rescue.pod:352 ../resize/virt-resize.pod:735 ../sparsify/virt-sparsify.pod:306 ../test-tool/libguestfs-test-tool.pod:125 ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295 ../tools/virt-make-fs.pl:600 ../tools/virt-tar.pl:329 ../tools/virt-win-reg.pl:801
 800 msgid ""
 801 "You should have received a copy of the GNU General Public License along with "
 802 "this program; if not, write to the Free Software Foundation, Inc., 51 "
 803 "Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA."
 804 msgstr ""
 805
 806 #. type: textblock
 807 #: ../cat/virt-cat.pod:5
 808 msgid "virt-cat - Display files in a virtual machine"
 809 msgstr ""
 810
 811 #. type: verbatim
 812 #: ../cat/virt-cat.pod:9
 813 #, no-wrap
 814 msgid ""
 815 " virt-cat [--options] -d domname file [file ...]\n"
 816 "\n"
 817 msgstr ""
 818
 819 #. type: verbatim
 820 #: ../cat/virt-cat.pod:11
 821 #, no-wrap
 822 msgid ""
 823 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
 824 "\n"
 825 msgstr ""
 826
 827 #. type: textblock
 828 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15 ../inspector/virt-inspector.pod:13
 829 msgid "Old-style:"
 830 msgstr ""
 831
 832 #. type: verbatim
 833 #: ../cat/virt-cat.pod:15
 834 #, no-wrap
 835 msgid ""
 836 " virt-cat domname file\n"
 837 "\n"
 838 msgstr ""
 839
 840 #. type: verbatim
 841 #: ../cat/virt-cat.pod:17
 842 #, no-wrap
 843 msgid ""
 844 " virt-cat disk.img file\n"
 845 "\n"
 846 msgstr ""
 847
 848 #. type: textblock
 849 #: ../cat/virt-cat.pod:21
 850 msgid ""
 851 "C<virt-cat> is a command line tool to display the contents of C<file> where "
 852 "C<file> exists in the named virtual machine (or disk image)."
 853 msgstr ""
 854
 855 #. type: textblock
 856 #: ../cat/virt-cat.pod:24
 857 msgid ""
 858 "Multiple filenames can be given, in which case they are concatenated "
 859 "together.  Each filename must be a full path, starting at the root directory "
 860 "(starting with '/')."
 861 msgstr ""
 862
 863 #. type: textblock
 864 #: ../cat/virt-cat.pod:28
 865 msgid ""
 866 "C<virt-cat> can be used to quickly view a file.  To edit a file, use "
 867 "C<virt-edit>.  For more complex cases you should look at the L<guestfish(1)> "
 868 "tool (see L</USING GUESTFISH> below)."
 869 msgstr ""
 870
 871 #. type: =head1
 872 #: ../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
 873 msgid "EXAMPLES"
 874 msgstr ""
 875
 876 #. type: textblock
 877 #: ../cat/virt-cat.pod:34
 878 msgid "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
 879 msgstr ""
 880
 881 #. type: verbatim
 882 #: ../cat/virt-cat.pod:37
 883 #, no-wrap
 884 msgid ""
 885 " virt-cat -d mydomain /etc/fstab\n"
 886 "\n"
 887 msgstr ""
 888
 889 #. type: textblock
 890 #: ../cat/virt-cat.pod:39
 891 msgid "List syslog messages from a VM disk image file:"
 892 msgstr ""
 893
 894 #. type: verbatim
 895 #: ../cat/virt-cat.pod:41
 896 #, no-wrap
 897 msgid ""
 898 " virt-cat -a disk.img /var/log/messages | tail\n"
 899 "\n"
 900 msgstr ""
 901
 902 #. type: textblock
 903 #: ../cat/virt-cat.pod:43
 904 msgid "Find out what DHCP IP address a VM acquired:"
 905 msgstr ""
 906
 907 #. type: verbatim
 908 #: ../cat/virt-cat.pod:45
 909 #, no-wrap
 910 msgid ""
 911 " virt-cat -d mydomain /var/log/messages | \\\n"
 912 "   grep 'dhclient: bound to' | tail\n"
 913 "\n"
 914 msgstr ""
 915
 916 #. type: textblock
 917 #: ../cat/virt-cat.pod:48
 918 msgid "Find out what packages were recently installed:"
 919 msgstr ""
 920
 921 #. type: verbatim
 922 #: ../cat/virt-cat.pod:50
 923 #, no-wrap
 924 msgid ""
 925 " virt-cat -d mydomain /var/log/yum.log | tail\n"
 926 "\n"
 927 msgstr ""
 928
 929 #. type: textblock
 930 #: ../cat/virt-cat.pod:52
 931 msgid "Find out who is logged on inside a virtual machine:"
 932 msgstr ""
 933
 934 #. type: verbatim
 935 #: ../cat/virt-cat.pod:54
 936 #, no-wrap
 937 msgid ""
 938 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
 939 " who /tmp/utmp\n"
 940 "\n"
 941 msgstr ""
 942
 943 #. type: textblock
 944 #: ../cat/virt-cat.pod:57
 945 msgid "or who was logged on:"
 946 msgstr ""
 947
 948 #. type: verbatim
 949 #: ../cat/virt-cat.pod:59
 950 #, no-wrap
 951 msgid ""
 952 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
 953 " last -f /tmp/wtmp\n"
 954 "\n"
 955 msgstr ""
 956
 957 #. type: textblock
 958 #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103 ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74 ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:124
 959 msgid ""
 960 "Add I<file> which should be a disk image from a virtual machine.  If the "
 961 "virtual machine has multiple block devices, you must supply all of them with "
 962 "separate I<-a> options."
 963 msgstr ""
 964
 965 #. type: =item
 966 #: ../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
 967 msgid "B<--echo-keys>"
 968 msgstr ""
 969
 970 #. type: textblock
 971 #: ../cat/virt-cat.pod:100
 972 msgid ""
 973 "When prompting for keys and passphrases, virt-cat normally turns echoing off "
 974 "so you cannot see what you are typing.  If you are not worried about Tempest "
 975 "attacks and there is no one else in the room you can specify this flag to "
 976 "see what you are typing."
 977 msgstr ""
 978
 979 #. type: verbatim
 980 #: ../cat/virt-cat.pod:116
 981 #, no-wrap
 982 msgid ""
 983 " virt-cat --format=raw -a disk.img file\n"
 984 "\n"
 985 msgstr ""
 986
 987 #. type: verbatim
 988 #: ../cat/virt-cat.pod:120
 989 #, no-wrap
 990 msgid ""
 991 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
 992 "\n"
 993 msgstr ""
 994
 995 #. type: =item
 996 #: ../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
 997 msgid "B<--keys-from-stdin>"
 998 msgstr ""
 999
1000 #. type: textblock
1001 #: ../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
1002 msgid ""
1003 "Read key or passphrase parameters from stdin.  The default is to try to read "
1004 "passphrases from the user by opening C</dev/tty>."
1005 msgstr ""
1006
1007 #. type: =head1
1008 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179 ../inspector/virt-inspector.pod:144 ../rescue/virt-rescue.pod:246
1009 msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
1010 msgstr ""
1011
1012 #. type: textblock
1013 #: ../cat/virt-cat.pod:154
1014 msgid "Previous versions of virt-cat allowed you to write either:"
1015 msgstr ""
1016
1017 #. type: verbatim
1018 #: ../cat/virt-cat.pod:156
1019 #, no-wrap
1020 msgid ""
1021 " virt-cat disk.img [disk.img ...] file\n"
1022 "\n"
1023 msgstr ""
1024
1025 #. type: textblock
1026 #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185 ../inspector/virt-inspector.pod:150 ../rescue/virt-rescue.pod:252
1027 msgid "or"
1028 msgstr ""
1029
1030 #. type: verbatim
1031 #: ../cat/virt-cat.pod:160
1032 #, no-wrap
1033 msgid ""
1034 " virt-cat guestname file\n"
1035 "\n"
1036 msgstr ""
1037
1038 #. type: textblock
1039 #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189 ../inspector/virt-inspector.pod:154 ../rescue/virt-rescue.pod:256
1040 msgid ""
1041 "whereas in this version you should use I<-a> or I<-d> respectively to avoid "
1042 "the confusing case where a disk image might have the same name as a guest."
1043 msgstr ""
1044
1045 #. type: textblock
1046 #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193 ../inspector/virt-inspector.pod:158 ../rescue/virt-rescue.pod:260
1047 msgid "For compatibility the old style is still supported."
1048 msgstr ""
1049
1050 #. type: =head1
1051 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
1052 msgid "WINDOWS PATHS"
1053 msgstr ""
1054
1055 #. type: textblock
1056 #: ../cat/virt-cat.pod:170
1057 msgid ""
1058 "C<virt-cat> has a limited ability to understand Windows drive letters and "
1059 "paths (eg. C<E:\\foo\\bar.txt>)."
1060 msgstr ""
1061
1062 #. type: textblock
1063 #: ../cat/virt-cat.pod:173 ../edit/virt-edit.pod:262
1064 msgid "If and only if the guest is running Windows then:"
1065 msgstr ""
1066
1067 #. type: textblock
1068 #: ../cat/virt-cat.pod:179 ../edit/virt-edit.pod:268
1069 msgid ""
1070 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
1071 "to the correct filesystem."
1072 msgstr ""
1073
1074 #. type: textblock
1075 #: ../cat/virt-cat.pod:184 ../edit/virt-edit.pod:273
1076 msgid ""
1077 "Any backslash (C<\\>) characters in the path are replaced with forward "
1078 "slashes so that libguestfs can process it."
1079 msgstr ""
1080
1081 #. type: textblock
1082 #: ../cat/virt-cat.pod:189
1083 msgid ""
1084 "The path is resolved case insensitively to locate the file that should be "
1085 "displayed."
1086 msgstr ""
1087
1088 #. type: textblock
1089 #: ../cat/virt-cat.pod:194 ../edit/virt-edit.pod:283
1090 msgid "There are some known shortcomings:"
1091 msgstr ""
1092
1093 #. type: textblock
1094 #: ../cat/virt-cat.pod:200 ../edit/virt-edit.pod:289
1095 msgid "Some NTFS symbolic links may not be followed correctly."
1096 msgstr ""
1097
1098 #. type: textblock
1099 #: ../cat/virt-cat.pod:204 ../edit/virt-edit.pod:293
1100 msgid "NTFS junction points that cross filesystems are not followed."
1101 msgstr ""
1102
1103 #. type: =head1
1104 #: ../cat/virt-cat.pod:208 ../edit/virt-edit.pod:297
1105 msgid "USING GUESTFISH"
1106 msgstr ""
1107
1108 #. type: textblock
1109 #: ../cat/virt-cat.pod:210
1110 msgid ""
1111 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
1112 "C<virt-cat> doesn't work."
1113 msgstr ""
1114
1115 #. type: textblock
1116 #: ../cat/virt-cat.pod:213
1117 msgid "Using C<virt-cat> is approximately equivalent to doing:"
1118 msgstr ""
1119
1120 #. type: verbatim
1121 #: ../cat/virt-cat.pod:215
1122 #, no-wrap
1123 msgid ""
1124 " guestfish --ro -i -d domname download file -\n"
1125 "\n"
1126 msgstr ""
1127
1128 #. type: textblock
1129 #: ../cat/virt-cat.pod:217
1130 msgid ""
1131 "where C<domname> is the name of the libvirt guest, and C<file> is the full "
1132 "path to the file.  Note the final C<-> (meaning \"output to stdout\")."
1133 msgstr ""
1134
1135 #. type: textblock
1136 #: ../cat/virt-cat.pod:221
1137 msgid ""
1138 "The command above uses libguestfs's guest inspection feature and so does not "
1139 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
1140 "disk images that don't contain guests.  To display a file from a disk image "
1141 "directly, use:"
1142 msgstr ""
1143
1144 #. type: verbatim
1145 #: ../cat/virt-cat.pod:226
1146 #, no-wrap
1147 msgid ""
1148 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
1149 "\n"
1150 msgstr ""
1151
1152 #. type: textblock
1153 #: ../cat/virt-cat.pod:228
1154 msgid ""
1155 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
1156 "the disk image, and C<file> is the full path to the file."
1157 msgstr ""
1158
1159 #. type: textblock
1160 #: ../cat/virt-cat.pod:240 ../cat/virt-filesystems.pod:382 ../cat/virt-ls.pod:492 ../df/virt-df.pod:250 ../edit/virt-edit.pod:351 ../fuse/guestmount.pod:314 ../inspector/virt-inspector.pod:392 ../resize/virt-resize.pod:691 ../sparsify/virt-sparsify.pod:253
1161 msgid "This program returns 0 if successful, or non-zero if there was an error."
1162 msgstr ""
1163
1164 #. type: textblock
1165 #: ../cat/virt-cat.pod:245
1166 msgid ""
1167 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, "
1168 "L<virt-tar-out(1)>, L<http://libguestfs.org/>."
1169 msgstr ""
1170
1171 #. type: textblock
1172 #: ../cat/virt-cat.pod:258 ../inspector/virt-inspector.pod:420 ../resize/virt-resize.pod:723 ../tools/virt-make-fs.pl:588
1173 msgid "Copyright (C) 2010-2011 Red Hat Inc."
1174 msgstr ""
1175
1176 #. type: textblock
1177 #: ../cat/virt-filesystems.pod:5
1178 msgid ""
1179 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
1180 "virtual machine or disk image"
1181 msgstr ""
1182
1183 #. type: verbatim
1184 #: ../cat/virt-filesystems.pod:9
1185 #, no-wrap
1186 msgid ""
1187 " virt-filesystems [--options] -d domname\n"
1188 "\n"
1189 msgstr ""
1190
1191 #. type: verbatim
1192 #: ../cat/virt-filesystems.pod:11
1193 #, no-wrap
1194 msgid ""
1195 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
1196 "\n"
1197 msgstr ""
1198
1199 #. type: textblock
1200 #: ../cat/virt-filesystems.pod:15
1201 msgid ""
1202 "This tool allows you to discover filesystems, partitions, logical volumes, "
1203 "and their sizes in a disk image or virtual machine.  It is a replacement for "
1204 "L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
1205 msgstr ""
1206
1207 #. type: textblock
1208 #: ../cat/virt-filesystems.pod:20
1209 msgid ""
1210 "One use for this tool is from shell scripts to iterate over all filesystems "
1211 "from a disk image:"
1212 msgstr ""
1213
1214 #. type: verbatim
1215 #: ../cat/virt-filesystems.pod:23
1216 #, no-wrap
1217 msgid ""
1218 " for fs in $(virt-filesystems -a disk.img); do\n"
1219 "   # ...\n"
1220 " done\n"
1221 "\n"
1222 msgstr ""
1223
1224 #. type: textblock
1225 #: ../cat/virt-filesystems.pod:27
1226 msgid ""
1227 "Another use is to list partitions before using another tool to modify those "
1228 "partitions (such as L<virt-resize(1)>).  If you are curious about what an "
1229 "unknown disk image contains, use this tool along with L<virt-inspector(1)>."
1230 msgstr ""
1231
1232 #. type: textblock
1233 #: ../cat/virt-filesystems.pod:32
1234 msgid ""
1235 "Various command line options control what this program displays.  You need "
1236 "to give either I<-a> or I<-d> options to specify the disk image or libvirt "
1237 "guest respectively.  If you just specify that then the program shows "
1238 "filesystems found, one per line, like this:"
1239 msgstr ""
1240
1241 #. type: verbatim
1242 #: ../cat/virt-filesystems.pod:37
1243 #, no-wrap
1244 msgid ""
1245 " $ virt-filesystems -a disk.img\n"
1246 " /dev/sda1\n"
1247 " /dev/vg_guest/lv_root\n"
1248 "\n"
1249 msgstr ""
1250
1251 #. type: textblock
1252 #: ../cat/virt-filesystems.pod:41
1253 msgid "If you add I<-l> or I<--long> then the output includes extra information:"
1254 msgstr ""
1255
1256 #. type: verbatim
1257 #: ../cat/virt-filesystems.pod:44
1258 #, no-wrap
1259 msgid ""
1260 " $ virt-filesystems -a disk.img -l\n"
1261 " Name                   Type         VFS   Label  Size\n"
1262 " /dev/sda1              filesystem   ext4  boot   524288000\n"
1263 " /dev/vg_guest/lv_root  filesystem   ext4  root   10212081664\n"
1264 "\n"
1265 msgstr ""
1266
1267 #. type: textblock
1268 #: ../cat/virt-filesystems.pod:49
1269 msgid ""
1270 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
1271 "shown as well:"
1272 msgstr ""
1273
1274 #. type: verbatim
1275 #: ../cat/virt-filesystems.pod:52
1276 #, no-wrap
1277 msgid ""
1278 " $ virt-filesystems -a disk.img --extra\n"
1279 " /dev/sda1\n"
1280 " /dev/vg_guest/lv_root\n"
1281 " /dev/vg_guest/lv_swap\n"
1282 " /dev/vg_guest/lv_data\n"
1283 "\n"
1284 msgstr ""
1285
1286 #. type: textblock
1287 #: ../cat/virt-filesystems.pod:58
1288 msgid "If you add I<--partitions> then partitions are shown instead of filesystems:"
1289 msgstr ""
1290
1291 #. type: verbatim
1292 #: ../cat/virt-filesystems.pod:60
1293 #, no-wrap
1294 msgid ""
1295 " $ virt-filesystems -a disk.img --partitions\n"
1296 " /dev/sda1\n"
1297 " /dev/sda2\n"
1298 "\n"
1299 msgstr ""
1300
1301 #. type: textblock
1302 #: ../cat/virt-filesystems.pod:64
1303 msgid ""
1304 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, "
1305 "I<--physical-volumes>, I<--block-devices> to list those items."
1306 msgstr ""
1307
1308 #. type: textblock
1309 #: ../cat/virt-filesystems.pod:67
1310 msgid ""
1311 "You can use these options in combination as well (if you want a combination "
1312 "including filesystems, you have to add I<--filesystems>).  Notice that some "
1313 "items fall into several categories (eg. C</dev/sda1> might be both a "
1314 "partition and a filesystem).  These items are listed several times.  To get "
1315 "a list which includes absolutely everything that virt-filesystems knows "
1316 "about, use the I<--all> option."
1317 msgstr ""
1318
1319 #. type: textblock
1320 #: ../cat/virt-filesystems.pod:74
1321 msgid ""
1322 "UUIDs (because they are quite long) are not shown by default.  Add the "
1323 "I<--uuid> option to display device and filesystem UUIDs in the long output."
1324 msgstr ""
1325
1326 #. type: textblock
1327 #: ../cat/virt-filesystems.pod:78
1328 msgid ""
1329 "I<--all --long --uuid> is a useful combination to display all possible "
1330 "information about everything."
1331 msgstr ""
1332
1333 #. type: verbatim
1334 #: ../cat/virt-filesystems.pod:81
1335 #, no-wrap
1336 msgid ""
1337 " $ virt-filesystems -a win.img --all --long --uuid -h\n"
1338 " Name      Type       VFS  Label           Size Parent   UUID\n"
1339 " /dev/sda1 filesystem ntfs System Reserved 100M -        F81C92571C92112C\n"
1340 " /dev/sda2 filesystem ntfs -               20G  -        F2E8996AE8992E3B\n"
1341 " /dev/sda1 partition  -    -               100M /dev/sda -\n"
1342 " /dev/sda2 partition  -    -               20G  /dev/sda -\n"
1343 " /dev/sda  device     -    -               20G  -        -\n"
1344 "\n"
1345 msgstr ""
1346
1347 #. type: textblock
1348 #: ../cat/virt-filesystems.pod:89
1349 msgid "For machine-readable output, use I<--csv> to get Comma-Separated Values."
1350 msgstr ""
1351
1352 #. type: =item
1353 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
1354 msgid "B<--all>"
1355 msgstr ""
1356
1357 #. type: textblock
1358 #: ../cat/virt-filesystems.pod:112
1359 msgid ""
1360 "Display everything.  This is currently the same as specifying these options: "
1361 "I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, "
1362 "I<--logical-volumes>, I<--volume-groups>, I<--physical-volumes>.  (More may "
1363 "be added to this list in future)."
1364 msgstr ""
1365
1366 #. type: textblock
1367 #: ../cat/virt-filesystems.pod:117
1368 msgid "See also I<--long>."
1369 msgstr ""
1370
1371 #. type: =item
1372 #: ../cat/virt-filesystems.pod:119
1373 msgid "B<--blkdevs>"
1374 msgstr ""
1375
1376 #. type: =item
1377 #: ../cat/virt-filesystems.pod:121
1378 msgid "B<--block-devices>"
1379 msgstr ""
1380
1381 #. type: textblock
1382 #: ../cat/virt-filesystems.pod:123
1383 msgid "Display block devices."
1384 msgstr ""
1385
1386 #. type: =item
1387 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
1388 msgid "B<--csv>"
1389 msgstr ""
1390
1391 #. type: textblock
1392 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
1393 msgid ""
1394 "Write out the results in CSV format (comma-separated values).  This format "
1395 "can be imported easily into databases and spreadsheets, but read L</NOTE "
1396 "ABOUT CSV FORMAT> below."
1397 msgstr ""
1398
1399 #. type: textblock
1400 #: ../cat/virt-filesystems.pod:150
1401 msgid ""
1402 "When prompting for keys and passphrases, virt-filesystems normally turns "
1403 "echoing off so you cannot see what you are typing.  If you are not worried "
1404 "about Tempest attacks and there is no one else in the room you can specify "
1405 "this flag to see what you are typing."
1406 msgstr ""
1407
1408 #. type: =item
1409 #: ../cat/virt-filesystems.pod:155
1410 msgid "B<--extra>"
1411 msgstr ""
1412
1413 #. type: textblock
1414 #: ../cat/virt-filesystems.pod:157
1415 msgid ""
1416 "This causes filesystems that are not ordinary, mountable filesystems to be "
1417 "displayed.  This category includes swapspace, and filesystems that are empty "
1418 "or contain unknown data."
1419 msgstr ""
1420
1421 #. type: textblock
1422 #: ../cat/virt-filesystems.pod:161
1423 msgid "This option implies I<--filesystems>."
1424 msgstr ""
1425
1426 #. type: =item
1427 #: ../cat/virt-filesystems.pod:163
1428 msgid "B<--filesystems>"
1429 msgstr ""
1430
1431 #. type: textblock
1432 #: ../cat/virt-filesystems.pod:165
1433 msgid ""
1434 "Display mountable filesystems.  If no display option was selected then this "
1435 "option is implied."
1436 msgstr ""
1437
1438 #. type: textblock
1439 #: ../cat/virt-filesystems.pod:168
1440 msgid "With I<--extra>, non-mountable filesystems are shown too."
1441 msgstr ""
1442
1443 #. type: verbatim
1444 #: ../cat/virt-filesystems.pod:181
1445 #, no-wrap
1446 msgid ""
1447 " virt-filesystems --format=raw -a disk.img\n"
1448 "\n"
1449 msgstr ""
1450
1451 #. type: verbatim
1452 #: ../cat/virt-filesystems.pod:185
1453 #, no-wrap
1454 msgid ""
1455 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1456 "\n"
1457 msgstr ""
1458
1459 #. type: =item
1460 #: ../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
1461 msgid "B<-h>"
1462 msgstr ""
1463
1464 #. type: =item
1465 #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354 ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111
1466 msgid "B<--human-readable>"
1467 msgstr ""
1468
1469 #. type: textblock
1470 #: ../cat/virt-filesystems.pod:198
1471 msgid "In I<--long> mode, display sizes in human-readable format."
1472 msgstr ""
1473
1474 #. type: =item
1475 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366 ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1476 msgid "B<-l>"
1477 msgstr ""
1478
1479 #. type: =item
1480 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368 ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1481 msgid "B<--long>"
1482 msgstr ""
1483
1484 #. type: textblock
1485 #: ../cat/virt-filesystems.pod:209
1486 msgid "Display extra columns of data (\"long format\")."
1487 msgstr ""
1488
1489 #. type: textblock
1490 #: ../cat/virt-filesystems.pod:211
1491 msgid "A title row is added unless you also specify I<--no-title>."
1492 msgstr ""
1493
1494 #. type: textblock
1495 #: ../cat/virt-filesystems.pod:213
1496 msgid ""
1497 "The extra columns displayed depend on what output you select, and the "
1498 "ordering of columns may change in future versions.  Use the title row, "
1499 "I<--csv> output and/or L<csvtool(1)> to match columns to data in external "
1500 "programs."
1501 msgstr ""
1502
1503 #. type: textblock
1504 #: ../cat/virt-filesystems.pod:218
1505 msgid ""
1506 "Use I<-h> if you want sizes to be displayed in human-readable format.  The "
1507 "default is to show raw numbers of I<bytes>."
1508 msgstr ""
1509
1510 #. type: textblock
1511 #: ../cat/virt-filesystems.pod:221
1512 msgid "Use I<--uuid> to display UUIDs too."
1513 msgstr ""
1514
1515 #. type: =item
1516 #: ../cat/virt-filesystems.pod:223
1517 msgid "B<--lvs>"
1518 msgstr ""
1519
1520 #. type: =item
1521 #: ../cat/virt-filesystems.pod:225
1522 msgid "B<--logvols>"
1523 msgstr ""
1524
1525 #. type: =item
1526 #: ../cat/virt-filesystems.pod:227
1527 msgid "B<--logical-volumes>"
1528 msgstr ""
1529
1530 #. type: textblock
1531 #: ../cat/virt-filesystems.pod:229
1532 msgid ""
1533 "Display LVM logical volumes.  In this mode, these are displayed irrespective "
1534 "of whether the LVs contain filesystems."
1535 msgstr ""
1536
1537 #. type: =item
1538 #: ../cat/virt-filesystems.pod:232
1539 msgid "B<--no-title>"
1540 msgstr ""
1541
1542 #. type: textblock
1543 #: ../cat/virt-filesystems.pod:234
1544 msgid "In I<--long> mode, don't add a title row."
1545 msgstr ""
1546
1547 #. type: textblock
1548 #: ../cat/virt-filesystems.pod:236
1549 msgid ""
1550 "Note that the order of the columns is not fixed, and may change in future "
1551 "versions of virt-filesystems, so using this option may give you unexpected "
1552 "surprises."
1553 msgstr ""
1554
1555 #. type: =item
1556 #: ../cat/virt-filesystems.pod:240
1557 msgid "B<--parts>"
1558 msgstr ""
1559
1560 #. type: =item
1561 #: ../cat/virt-filesystems.pod:242
1562 msgid "B<--partitions>"
1563 msgstr ""
1564
1565 #. type: textblock
1566 #: ../cat/virt-filesystems.pod:244
1567 msgid ""
1568 "Display partitions.  In this mode, these are displayed irrespective of "
1569 "whether the partitions contain filesystems."
1570 msgstr ""
1571
1572 #. type: =item
1573 #: ../cat/virt-filesystems.pod:247
1574 msgid "B<--pvs>"
1575 msgstr ""
1576
1577 #. type: =item
1578 #: ../cat/virt-filesystems.pod:249
1579 msgid "B<--physvols>"
1580 msgstr ""
1581
1582 #. type: =item
1583 #: ../cat/virt-filesystems.pod:251
1584 msgid "B<--physical-volumes>"
1585 msgstr ""
1586
1587 #. type: textblock
1588 #: ../cat/virt-filesystems.pod:253
1589 msgid "Display LVM physical volumes."
1590 msgstr ""
1591
1592 #. type: =item
1593 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
1594 msgid "B<--uuid>"
1595 msgstr ""
1596
1597 #. type: =item
1598 #: ../cat/virt-filesystems.pod:257
1599 msgid "B<--uuids>"
1600 msgstr ""
1601
1602 #. type: textblock
1603 #: ../cat/virt-filesystems.pod:259
1604 msgid "In I<--long> mode, display UUIDs as well."
1605 msgstr ""
1606
1607 #. type: =item
1608 #: ../cat/virt-filesystems.pod:273
1609 msgid "B<--vgs>"
1610 msgstr ""
1611
1612 #. type: =item
1613 #: ../cat/virt-filesystems.pod:275
1614 msgid "B<--volgroups>"
1615 msgstr ""
1616
1617 #. type: =item
1618 #: ../cat/virt-filesystems.pod:277
1619 msgid "B<--volume-groups>"
1620 msgstr ""
1621
1622 #. type: textblock
1623 #: ../cat/virt-filesystems.pod:279
1624 msgid "Display LVM volume groups."
1625 msgstr ""
1626
1627 #. type: =head1
1628 #: ../cat/virt-filesystems.pod:287
1629 msgid "COLUMNS"
1630 msgstr ""
1631
1632 #. type: textblock
1633 #: ../cat/virt-filesystems.pod:289
1634 msgid ""
1635 "Note that columns in the output are subject to reordering and change in "
1636 "future versions of this tool."
1637 msgstr ""
1638
1639 #. type: =item
1640 #: ../cat/virt-filesystems.pod:294
1641 msgid "B<Name>"
1642 msgstr ""
1643
1644 #. type: textblock
1645 #: ../cat/virt-filesystems.pod:296
1646 msgid "The filesystem, partition, block device or LVM name."
1647 msgstr ""
1648
1649 #. type: textblock
1650 #: ../cat/virt-filesystems.pod:298
1651 msgid ""
1652 "For device and partition names these are displayed as canonical libguestfs "
1653 "names, so that for example C</dev/sda2> is the second partition on the first "
1654 "device."
1655 msgstr ""
1656
1657 #. type: textblock
1658 #: ../cat/virt-filesystems.pod:302
1659 msgid ""
1660 "If the I<--long> option is B<not> specified, then only the name column is "
1661 "shown in the output."
1662 msgstr ""
1663
1664 #. type: =item
1665 #: ../cat/virt-filesystems.pod:305
1666 msgid "B<Type>"
1667 msgstr ""
1668
1669 #. type: textblock
1670 #: ../cat/virt-filesystems.pod:307
1671 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
1672 msgstr ""
1673
1674 #. type: =item
1675 #: ../cat/virt-filesystems.pod:309
1676 msgid "B<VFS>"
1677 msgstr ""
1678
1679 #. type: textblock
1680 #: ../cat/virt-filesystems.pod:311
1681 msgid ""
1682 "If there is a filesystem, then this column displays the filesystem type if "
1683 "one could be detected, eg. C<ext4>."
1684 msgstr ""
1685
1686 #. type: =item
1687 #: ../cat/virt-filesystems.pod:314
1688 msgid "B<Label>"
1689 msgstr ""
1690
1691 #. type: textblock
1692 #: ../cat/virt-filesystems.pod:316
1693 msgid ""
1694 "If the object has a label (used for identifying and mounting filesystems) "
1695 "then this column contains the label."
1696 msgstr ""
1697
1698 #. type: =item
1699 #: ../cat/virt-filesystems.pod:319
1700 msgid "B<MBR>"
1701 msgstr ""
1702
1703 #. type: textblock
1704 #: ../cat/virt-filesystems.pod:321
1705 msgid ""
1706 "The partition type byte, displayed as a two digit hexadecimal number.  A "
1707 "comprehensive list of partition types can be found here: "
1708 "L<http://www.win.tue.nl/~aeb/partitions/partition_types-1.html>"
1709 msgstr ""
1710
1711 #. type: textblock
1712 #: ../cat/virt-filesystems.pod:325
1713 msgid "This is only applicable for DOS (MBR) partitions."
1714 msgstr ""
1715
1716 #. type: =item
1717 #: ../cat/virt-filesystems.pod:327
1718 msgid "B<Size>"
1719 msgstr ""
1720
1721 #. type: textblock
1722 #: ../cat/virt-filesystems.pod:329
1723 msgid ""
1724 "The size of the object in bytes.  If the I<--human> option is used then the "
1725 "size is displayed in a human-readable form."
1726 msgstr ""
1727
1728 #. type: =item
1729 #: ../cat/virt-filesystems.pod:332
1730 msgid "B<Parent>"
1731 msgstr ""
1732
1733 #. type: textblock
1734 #: ../cat/virt-filesystems.pod:334
1735 msgid ""
1736 "The parent column records the parent relationship between objects.  For "
1737 "example, if the object is a partition, then this column contains the name of "
1738 "the containing device.  If the object is a logical volume, then this column "
1739 "is the name of the volume group."
1740 msgstr ""
1741
1742 #. type: =item
1743 #: ../cat/virt-filesystems.pod:339
1744 msgid "B<UUID>"
1745 msgstr ""
1746
1747 #. type: textblock
1748 #: ../cat/virt-filesystems.pod:341
1749 msgid ""
1750 "If the object has a UUID (used for identifying and mounting filesystems and "
1751 "block devices) then this column contains the UUID as a string."
1752 msgstr ""
1753
1754 #. type: textblock
1755 #: ../cat/virt-filesystems.pod:345
1756 msgid "The UUID is only displayed if the I<--uuid> option is given."
1757 msgstr ""
1758
1759 #. type: =head1
1760 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:459 ../df/virt-df.pod:217
1761 msgid "NOTE ABOUT CSV FORMAT"
1762 msgstr ""
1763
1764 #. type: textblock
1765 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:461 ../df/virt-df.pod:219
1766 msgid ""
1767 "Comma-separated values (CSV) is a deceptive format.  It I<seems> like it "
1768 "should be easy to parse, but it is definitely not easy to parse."
1769 msgstr ""
1770
1771 #. type: textblock
1772 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:464 ../df/virt-df.pod:222
1773 msgid ""
1774 "Myth: Just split fields at commas.  Reality: This does I<not> work "
1775 "reliably.  This example has two columns:"
1776 msgstr ""
1777
1778 #. type: verbatim
1779 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:467 ../df/virt-df.pod:225
1780 #, no-wrap
1781 msgid ""
1782 " \"foo,bar\",baz\n"
1783 "\n"
1784 msgstr ""
1785
1786 #. type: textblock
1787 #: ../cat/virt-filesystems.pod:359 ../cat/virt-ls.pod:469 ../df/virt-df.pod:227
1788 msgid ""
1789 "Myth: Read the file one line at a time.  Reality: This does I<not> work "
1790 "reliably.  This example has one row:"
1791 msgstr ""
1792
1793 #. type: verbatim
1794 #: ../cat/virt-filesystems.pod:362 ../cat/virt-ls.pod:472 ../df/virt-df.pod:230
1795 #, no-wrap
1796 msgid ""
1797 " \"foo\n"
1798 " bar\",baz\n"
1799 "\n"
1800 msgstr ""
1801
1802 #. type: textblock
1803 #: ../cat/virt-filesystems.pod:365 ../cat/virt-ls.pod:475 ../df/virt-df.pod:233
1804 msgid ""
1805 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
1806 "packaged in major Linux distributions)."
1807 msgstr ""
1808
1809 #. type: textblock
1810 #: ../cat/virt-filesystems.pod:368 ../cat/virt-ls.pod:478 ../df/virt-df.pod:236
1811 msgid ""
1812 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
1813 "or Python's built-in csv library)."
1814 msgstr ""
1815
1816 #. type: textblock
1817 #: ../cat/virt-filesystems.pod:371 ../cat/virt-ls.pod:481 ../df/virt-df.pod:239
1818 msgid "Most spreadsheets and databases can import CSV directly."
1819 msgstr ""
1820
1821 #. type: textblock
1822 #: ../cat/virt-filesystems.pod:387
1823 msgid ""
1824 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, "
1825 "L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, "
1826 "L<http://libguestfs.org/>."
1827 msgstr ""
1828
1829 #. type: textblock
1830 #: ../cat/virt-filesystems.pod:402 ../tools/virt-win-reg.pl:789
1831 msgid "Copyright (C) 2010 Red Hat Inc."
1832 msgstr ""
1833
1834 #. type: textblock
1835 #: ../cat/virt-ls.pod:5
1836 msgid "virt-ls - List files in a virtual machine"
1837 msgstr ""
1838
1839 #. type: verbatim
1840 #: ../cat/virt-ls.pod:9
1841 #, no-wrap
1842 msgid ""
1843 " virt-ls [--options] -d domname directory [directory ...]\n"
1844 "\n"
1845 msgstr ""
1846
1847 #. type: verbatim
1848 #: ../cat/virt-ls.pod:11
1849 #, no-wrap
1850 msgid ""
1851 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory "
1852 "...]\n"
1853 "\n"
1854 msgstr ""
1855
1856 #. type: textblock
1857 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:15
1858 msgid "Old style:"
1859 msgstr ""
1860
1861 #. type: verbatim
1862 #: ../cat/virt-ls.pod:15
1863 #, no-wrap
1864 msgid ""
1865 " virt-ls [--options] domname directory\n"
1866 "\n"
1867 msgstr ""
1868
1869 #. type: verbatim
1870 #: ../cat/virt-ls.pod:17
1871 #, no-wrap
1872 msgid ""
1873 " virt-ls [--options] disk.img [disk.img ...] directory\n"
1874 "\n"
1875 msgstr ""
1876
1877 #. type: textblock
1878 #: ../cat/virt-ls.pod:21
1879 msgid ""
1880 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
1881 "more from a virtual machine or disk image."
1882 msgstr ""
1883
1884 #. type: textblock
1885 #: ../cat/virt-ls.pod:24
1886 msgid ""
1887 "Multiple directory names can be given, in which case the output from each is "
1888 "concatenated."
1889 msgstr ""
1890
1891 #. type: textblock
1892 #: ../cat/virt-ls.pod:27
1893 msgid ""
1894 "To list directories from a libvirt guest use the I<-d> option to specify the "
1895 "name of the guest.  For a disk image, use the I<-a> option."
1896 msgstr ""
1897
1898 #. type: textblock
1899 #: ../cat/virt-ls.pod:31
1900 msgid ""
1901 "C<virt-ls> can do many simple file listings.  For more complicated cases you "
1902 "may need to use L<guestfish(1)>, or write a program directly to the "
1903 "L<guestfs(3)> API."
1904 msgstr ""
1905
1906 #. type: textblock
1907 #: ../cat/virt-ls.pod:37
1908 msgid "Get a list of all files and directories in a virtual machine:"
1909 msgstr ""
1910
1911 #. type: verbatim
1912 #: ../cat/virt-ls.pod:39
1913 #, no-wrap
1914 msgid ""
1915 " virt-ls -R -d guest /\n"
1916 "\n"
1917 msgstr ""
1918
1919 #. type: textblock
1920 #: ../cat/virt-ls.pod:41 ../examples/guestfs-testing.pod:182
1921 msgid "List all setuid or setgid programs in a Linux virtual machine:"
1922 msgstr ""
1923
1924 #. type: verbatim
1925 #: ../cat/virt-ls.pod:43
1926 #, no-wrap
1927 msgid ""
1928 " virt-ls -lR -d guest / | grep '^- [42]'\n"
1929 "\n"
1930 msgstr ""
1931
1932 #. type: textblock
1933 #: ../cat/virt-ls.pod:45 ../examples/guestfs-testing.pod:186
1934 msgid "List all public-writable directories in a Linux virtual machine:"
1935 msgstr ""
1936
1937 #. type: verbatim
1938 #: ../cat/virt-ls.pod:47
1939 #, no-wrap
1940 msgid ""
1941 " virt-ls -lR -d guest / | grep '^d ...7'\n"
1942 "\n"
1943 msgstr ""
1944
1945 #. type: textblock
1946 #: ../cat/virt-ls.pod:49 ../examples/guestfs-testing.pod:190
1947 msgid "List all Unix domain sockets in a Linux virtual machine:"
1948 msgstr ""
1949
1950 #. type: verbatim
1951 #: ../cat/virt-ls.pod:51
1952 #, no-wrap
1953 msgid ""
1954 " virt-ls -lR -d guest / | grep '^s'\n"
1955 "\n"
1956 msgstr ""
1957
1958 #. type: textblock
1959 #: ../cat/virt-ls.pod:53 ../examples/guestfs-testing.pod:194
1960 msgid "List all regular files with filenames ending in '.png':"
1961 msgstr ""
1962
1963 #. type: verbatim
1964 #: ../cat/virt-ls.pod:55
1965 #, no-wrap
1966 msgid ""
1967 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
1968 "\n"
1969 msgstr ""
1970
1971 #. type: textblock
1972 #: ../cat/virt-ls.pod:57
1973 msgid "To display files larger than 10MB in home directories:"
1974 msgstr ""
1975
1976 #. type: verbatim
1977 #: ../cat/virt-ls.pod:59
1978 #, no-wrap
1979 msgid ""
1980 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
1981 "\n"
1982 msgstr ""
1983
1984 #. type: textblock
1985 #: ../cat/virt-ls.pod:61 ../examples/guestfs-testing.pod:202
1986 msgid "Find everything modified in the last 7 days:"
1987 msgstr ""
1988
1989 #. type: verbatim
1990 #: ../cat/virt-ls.pod:63
1991 #, no-wrap
1992 msgid ""
1993 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
1994 "\n"
1995 msgstr ""
1996
1997 #. type: textblock
1998 #: ../cat/virt-ls.pod:65 ../examples/guestfs-testing.pod:206
1999 msgid "Find regular files modified in the last 24 hours:"
2000 msgstr ""
2001
2002 #. type: verbatim
2003 #: ../cat/virt-ls.pod:67
2004 #, no-wrap
2005 msgid ""
2006 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
2007 "\n"
2008 msgstr ""
2009
2010 #. type: =head2
2011 #: ../cat/virt-ls.pod:69
2012 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
2013 msgstr ""
2014
2015 #. type: textblock
2016 #: ../cat/virt-ls.pod:71
2017 msgid ""
2018 "Find the differences between files in a guest and an earlier snapshot of the "
2019 "same guest."
2020 msgstr ""
2021
2022 #. type: verbatim
2023 #: ../cat/virt-ls.pod:74
2024 #, no-wrap
2025 msgid ""
2026 " virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
2027 " virt-ls -lR -a current.img / --uids --time-t > new\n"
2028 " diff -u old new | less\n"
2029 "\n"
2030 msgstr ""
2031
2032 #. type: textblock
2033 #: ../cat/virt-ls.pod:78
2034 msgid ""
2035 "The commands above won't find files where the content has changed but the "
2036 "metadata (eg. file size and modification date) is the same.  To do that, you "
2037 "need to add the I<--checksum> parameter to both C<virt-ls> commands.  "
2038 "I<--checksum> can be quite slow since it has to read and compute a checksum "
2039 "of every regular file in the virtual machine."
2040 msgstr ""
2041
2042 #. type: =head1
2043 #: ../cat/virt-ls.pod:84
2044 msgid "OUTPUT MODES"
2045 msgstr ""
2046
2047 #. type: textblock
2048 #: ../cat/virt-ls.pod:86
2049 msgid ""
2050 "C<virt-ls> has four output modes, controlled by different combinations of "
2051 "the I<-l> and I<-R> options."
2052 msgstr ""
2053
2054 #. type: =head2
2055 #: ../cat/virt-ls.pod:89
2056 msgid "SIMPLE LISTING"
2057 msgstr ""
2058
2059 #. type: textblock
2060 #: ../cat/virt-ls.pod:91
2061 msgid "A simple listing is like the ordinary L<ls(1)> command:"
2062 msgstr ""
2063
2064 #. type: verbatim
2065 #: ../cat/virt-ls.pod:93
2066 #, no-wrap
2067 msgid ""
2068 " $ virt-ls -d guest /\n"
2069 " bin\n"
2070 " boot\n"
2071 " [etc.]\n"
2072 "\n"
2073 msgstr ""
2074
2075 #. type: =head2
2076 #: ../cat/virt-ls.pod:98
2077 msgid "LONG LISTING"
2078 msgstr ""
2079
2080 #. type: textblock
2081 #: ../cat/virt-ls.pod:100
2082 msgid ""
2083 "With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
2084 "(more specifically, like the C<guestfs_ll> function)."
2085 msgstr ""
2086
2087 #. type: verbatim
2088 #: ../cat/virt-ls.pod:103
2089 #, no-wrap
2090 msgid ""
2091 " $ virt-ls -l -d guest /\n"
2092 " total 204\n"
2093 " dr-xr-xr-x.   2 root root   4096 2009-08-25 19:06 bin\n"
2094 " dr-xr-xr-x.   5 root root   3072 2009-08-25 19:06 boot\n"
2095 " [etc.]\n"
2096 "\n"
2097 msgstr ""
2098
2099 #. type: textblock
2100 #: ../cat/virt-ls.pod:109
2101 msgid ""
2102 "Note that while this is useful for displaying a directory, do not try "
2103 "parsing this output in another program.  Use L</RECURSIVE LONG LISTING> "
2104 "instead."
2105 msgstr ""
2106
2107 #. type: =head2
2108 #: ../cat/virt-ls.pod:113
2109 msgid "RECURSIVE LISTING"
2110 msgstr ""
2111
2112 #. type: textblock
2113 #: ../cat/virt-ls.pod:115
2114 msgid ""
2115 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
2116 "and directories recursively:"
2117 msgstr ""
2118
2119 #. type: verbatim
2120 #: ../cat/virt-ls.pod:118
2121 #, no-wrap
2122 msgid ""
2123 " $ virt-ls -R -d guest /tmp\n"
2124 " foo\n"
2125 " foo/bar\n"
2126 " [etc.]\n"
2127 "\n"
2128 msgstr ""
2129
2130 #. type: textblock
2131 #: ../cat/virt-ls.pod:123
2132 msgid ""
2133 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
2134 "converts C<\\0> characters to C<\\n>."
2135 msgstr ""
2136
2137 #. type: =head2
2138 #: ../cat/virt-ls.pod:126
2139 msgid "RECURSIVE LONG LISTING"
2140 msgstr ""
2141
2142 #. type: textblock
2143 #: ../cat/virt-ls.pod:128
2144 msgid ""
2145 "Using I<-lR> options together changes the output to display directories "
2146 "recursively, with file stats, and optionally other features such as "
2147 "checksums and extended attributes."
2148 msgstr ""
2149
2150 #. type: textblock
2151 #: ../cat/virt-ls.pod:132
2152 msgid ""
2153 "Most of the interesting features of C<virt-ls> are only available when using "
2154 "I<-lR> mode."
2155 msgstr ""
2156
2157 #. type: textblock
2158 #: ../cat/virt-ls.pod:135
2159 msgid ""
2160 "The fields are normally space-separated.  Filenames are B<not> quoted, so "
2161 "you cannot use the output in another program (because filenames can contain "
2162 "spaces and other unsafe characters).  If the guest was untrusted and someone "
2163 "knew you were using C<virt-ls> to analyze the guest, they could play tricks "
2164 "on you by creating filenames with embedded newline characters.  To B<safely> "
2165 "parse the output in another program, use the I<--csv> (Comma-Separated "
2166 "Values) option."
2167 msgstr ""
2168
2169 #. type: textblock
2170 #: ../cat/virt-ls.pod:143
2171 msgid ""
2172 "Note that this output format is completely unrelated to the C<ls -lR> "
2173 "command."
2174 msgstr ""
2175
2176 #. type: verbatim
2177 #: ../cat/virt-ls.pod:146
2178 #, no-wrap
2179 msgid ""
2180 " $ virt-ls -lR -d guest /bin\n"
2181 " d 0555       4096 /bin\n"
2182 " - 0755        123 /bin/alsaunmute\n"
2183 " - 0755      28328 /bin/arch\n"
2184 " l 0777          4 /bin/awk -> gawk\n"
2185 " - 0755      27216 /bin/basename\n"
2186 " - 0755     943360 /bin/bash\n"
2187 " [etc.]\n"
2188 "\n"
2189 msgstr ""
2190
2191 #. type: textblock
2192 #: ../cat/virt-ls.pod:155
2193 msgid "These basic fields are always shown:"
2194 msgstr ""
2195
2196 #. type: =item
2197 #: ../cat/virt-ls.pod:159
2198 msgid "type"
2199 msgstr ""
2200
2201 #. type: textblock
2202 #: ../cat/virt-ls.pod:161
2203 msgid ""
2204 "The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
2205 "(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
2206 "link), C<s> (socket) or C<u> (unknown)."
2207 msgstr ""
2208
2209 #. type: =item
2210 #: ../cat/virt-ls.pod:171
2211 msgid "permissions"
2212 msgstr ""
2213
2214 #. type: textblock
2215 #: ../cat/virt-ls.pod:173
2216 msgid "The Unix permissions, displayed as a 4 digit octal number."
2217 msgstr ""
2218
2219 #. type: =item
2220 #: ../cat/virt-ls.pod:175
2221 msgid "size"
2222 msgstr ""
2223
2224 #. type: textblock
2225 #: ../cat/virt-ls.pod:177
2226 msgid ""
2227 "The size of the file.  This is shown in bytes unless I<-h> or "
2228 "I<--human-readable> option is given, in which case this is shown as a "
2229 "human-readable number."
2230 msgstr ""
2231
2232 #. type: =head2
2233 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4488
2234 msgid "path"
2235 msgstr ""
2236
2237 #. type: textblock
2238 #: ../cat/virt-ls.pod:183
2239 msgid "The full path of the file or directory."
2240 msgstr ""
2241
2242 #. type: =item
2243 #: ../cat/virt-ls.pod:185
2244 msgid "link"
2245 msgstr ""
2246
2247 #. type: textblock
2248 #: ../cat/virt-ls.pod:187
2249 msgid "For symbolic links only, the link target."
2250 msgstr ""
2251
2252 #. type: textblock
2253 #: ../cat/virt-ls.pod:191
2254 msgid ""
2255 "In I<-lR> mode, additional command line options enable the display of more "
2256 "fields."
2257 msgstr ""
2258
2259 #. type: textblock
2260 #: ../cat/virt-ls.pod:194
2261 msgid ""
2262 "With the I<--uids> flag, these additional fields are displayed before the "
2263 "path:"
2264 msgstr ""
2265
2266 #. type: =item
2267 #: ../cat/virt-ls.pod:199
2268 msgid "uid"
2269 msgstr ""
2270
2271 #. type: =item
2272 #: ../cat/virt-ls.pod:201
2273 msgid "gid"
2274 msgstr ""
2275
2276 #. type: textblock
2277 #: ../cat/virt-ls.pod:203
2278 msgid ""
2279 "The UID and GID of the owner of the file (displayed numerically).  Note "
2280 "these only make sense in the context of a Unix-like guest."
2281 msgstr ""
2282
2283 #. type: textblock
2284 #: ../cat/virt-ls.pod:208
2285 msgid "With the I<--times> flag, these additional fields are displayed:"
2286 msgstr ""
2287
2288 #. type: =item
2289 #: ../cat/virt-ls.pod:212
2290 msgid "atime"
2291 msgstr ""
2292
2293 #. type: textblock
2294 #: ../cat/virt-ls.pod:214
2295 msgid "The time of last access."
2296 msgstr ""
2297
2298 #. type: =item
2299 #: ../cat/virt-ls.pod:216
2300 msgid "mtime"
2301 msgstr ""
2302
2303 #. type: textblock
2304 #: ../cat/virt-ls.pod:218
2305 msgid "The time of last modification."
2306 msgstr ""
2307
2308 #. type: =item
2309 #: ../cat/virt-ls.pod:220
2310 msgid "ctime"
2311 msgstr ""
2312
2313 #. type: textblock
2314 #: ../cat/virt-ls.pod:222
2315 msgid "The time of last status change."
2316 msgstr ""
2317
2318 #. type: textblock
2319 #: ../cat/virt-ls.pod:226
2320 msgid ""
2321 "The time fields are displayed as string dates and times, unless one of the "
2322 "I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
2323 msgstr ""
2324
2325 #. type: textblock
2326 #: ../cat/virt-ls.pod:229
2327 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
2328 msgstr ""
2329
2330 #. type: =item
2331 #: ../cat/virt-ls.pod:233
2332 msgid "device"
2333 msgstr ""
2334
2335 #. type: textblock
2336 #: ../cat/virt-ls.pod:235
2337 msgid ""
2338 "The device containing the file (displayed as major:minor).  This may not "
2339 "match devices as known to the guest."
2340 msgstr ""
2341
2342 #. type: =item
2343 #: ../cat/virt-ls.pod:238
2344 msgid "inode"
2345 msgstr ""
2346
2347 #. type: textblock
2348 #: ../cat/virt-ls.pod:240
2349 msgid "The inode number."
2350 msgstr ""
2351
2352 #. type: =item
2353 #: ../cat/virt-ls.pod:242
2354 msgid "nlink"
2355 msgstr ""
2356
2357 #. type: textblock
2358 #: ../cat/virt-ls.pod:244
2359 msgid "The number of hard links."
2360 msgstr ""
2361
2362 #. type: =item
2363 #: ../cat/virt-ls.pod:246
2364 msgid "rdev"
2365 msgstr ""
2366
2367 #. type: textblock
2368 #: ../cat/virt-ls.pod:248
2369 msgid "For block and char special files, the device (displayed as major:minor)."
2370 msgstr ""
2371
2372 #. type: =item
2373 #: ../cat/virt-ls.pod:251
2374 msgid "blocks"
2375 msgstr ""
2376
2377 #. type: textblock
2378 #: ../cat/virt-ls.pod:253
2379 msgid "The number of 512 byte blocks allocated to the file."
2380 msgstr ""
2381
2382 #. type: textblock
2383 #: ../cat/virt-ls.pod:257
2384 msgid ""
2385 "With the I<--checksum> flag, the checksum of the file contents is shown "
2386 "(only for regular files).  Computing file checksums can take a considerable "
2387 "amount of time."
2388 msgstr ""
2389
2390 #. type: =item
2391 #: ../cat/virt-ls.pod:280
2392 msgid "B<--checksum>"
2393 msgstr ""
2394
2395 #. type: =item
2396 #: ../cat/virt-ls.pod:282
2397 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2398 msgstr ""
2399
2400 #. type: textblock
2401 #: ../cat/virt-ls.pod:284
2402 msgid ""
2403 "Display checksum over file contents for regular files.  With no argument, "
2404 "this defaults to using I<md5>.  Using an argument, you can select the "
2405 "checksum type to use."
2406 msgstr ""
2407
2408 #. type: textblock
2409 #: ../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
2410 msgid ""
2411 "This option only has effect in I<-lR> output mode.  See L</RECURSIVE LONG "
2412 "LISTING> above."
2413 msgstr ""
2414
2415 #. type: textblock
2416 #: ../cat/virt-ls.pod:316
2417 msgid ""
2418 "When prompting for keys and passphrases, virt-ls normally turns echoing off "
2419 "so you cannot see what you are typing.  If you are not worried about Tempest "
2420 "attacks and there is no one else in the room you can specify this flag to "
2421 "see what you are typing."
2422 msgstr ""
2423
2424 #. type: =item
2425 #: ../cat/virt-ls.pod:321
2426 msgid "B<--extra-stats>"
2427 msgstr ""
2428
2429 #. type: textblock
2430 #: ../cat/virt-ls.pod:323
2431 msgid "Display extra stats."
2432 msgstr ""
2433
2434 #. type: verbatim
2435 #: ../cat/virt-ls.pod:339
2436 #, no-wrap
2437 msgid ""
2438 " virt-ls --format=raw -a disk.img /dir\n"
2439 "\n"
2440 msgstr ""
2441
2442 #. type: verbatim
2443 #: ../cat/virt-ls.pod:343
2444 #, no-wrap
2445 msgid ""
2446 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2447 "\n"
2448 msgstr ""
2449
2450 #. type: textblock
2451 #: ../cat/virt-ls.pod:356
2452 msgid "Display file sizes in human-readable format."
2453 msgstr ""
2454
2455 #. type: =item
2456 #: ../cat/virt-ls.pod:370
2457 msgid "B<-R>"
2458 msgstr ""
2459
2460 #. type: =item
2461 #: ../cat/virt-ls.pod:372
2462 msgid "B<--recursive>"
2463 msgstr ""
2464
2465 #. type: textblock
2466 #: ../cat/virt-ls.pod:374
2467 msgid ""
2468 "Select the mode.  With neither of these options, C<virt-ls> produces a "
2469 "simple, flat list of the files in the named directory.  See L</SIMPLE "
2470 "LISTING>."
2471 msgstr ""
2472
2473 #. type: textblock
2474 #: ../cat/virt-ls.pod:378
2475 msgid ""
2476 "C<virt-ls -l> produces a \"long listing\", which shows more detail.  See "
2477 "L</LONG LISTING>."
2478 msgstr ""
2479
2480 #. type: textblock
2481 #: ../cat/virt-ls.pod:381
2482 msgid ""
2483 "C<virt-ls -R> produces a recursive list of files starting at the named "
2484 "directory.  See L</RECURSIVE LISTING>."
2485 msgstr ""
2486
2487 #. type: textblock
2488 #: ../cat/virt-ls.pod:384
2489 msgid ""
2490 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2491 "parsed.  See L</RECURSIVE LONG LISTING>."
2492 msgstr ""
2493
2494 #. type: =item
2495 #: ../cat/virt-ls.pod:387
2496 msgid "B<--times>"
2497 msgstr ""
2498
2499 #. type: textblock
2500 #: ../cat/virt-ls.pod:389
2501 msgid "Display time fields."
2502 msgstr ""
2503
2504 #. type: =item
2505 #: ../cat/virt-ls.pod:394
2506 msgid "B<--time-days>"
2507 msgstr ""
2508
2509 #. type: textblock
2510 #: ../cat/virt-ls.pod:396
2511 msgid "Display time fields as days before now (negative if in the future)."
2512 msgstr ""
2513
2514 #. type: textblock
2515 #: ../cat/virt-ls.pod:398
2516 msgid ""
2517 "Note that C<0> in output means \"up to 1 day before now\", or that the age "
2518 "of the file is between 0 and 86399 seconds."
2519 msgstr ""
2520
2521 #. type: =item
2522 #: ../cat/virt-ls.pod:404
2523 msgid "B<--time-relative>"
2524 msgstr ""
2525
2526 #. type: textblock
2527 #: ../cat/virt-ls.pod:406
2528 msgid "Display time fields as seconds before now (negative if in the future)."
2529 msgstr ""
2530
2531 #. type: =item
2532 #: ../cat/virt-ls.pod:411
2533 msgid "B<--time-t>"
2534 msgstr ""
2535
2536 #. type: textblock
2537 #: ../cat/virt-ls.pod:413
2538 msgid "Display time fields as seconds since the Unix epoch."
2539 msgstr ""
2540
2541 #. type: =item
2542 #: ../cat/virt-ls.pod:418
2543 msgid "B<--uids>"
2544 msgstr ""
2545
2546 #. type: textblock
2547 #: ../cat/virt-ls.pod:420
2548 msgid "Display UID and GID fields."
2549 msgstr ""
2550
2551 #. type: textblock
2552 #: ../cat/virt-ls.pod:445
2553 msgid "Previous versions of virt-ls allowed you to write either:"
2554 msgstr ""
2555
2556 #. type: verbatim
2557 #: ../cat/virt-ls.pod:447
2558 #, no-wrap
2559 msgid ""
2560 " virt-ls disk.img [disk.img ...] /dir\n"
2561 "\n"
2562 msgstr ""
2563
2564 #. type: verbatim
2565 #: ../cat/virt-ls.pod:451
2566 #, no-wrap
2567 msgid ""
2568 " virt-ls guestname /dir\n"
2569 "\n"
2570 msgstr ""
2571
2572 #. type: textblock
2573 #: ../cat/virt-ls.pod:497
2574 msgid ""
2575 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, "
2576 "L<virt-tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, "
2577 "L<Sys::Virt(3)>, L<http://libguestfs.org/>."
2578 msgstr ""
2579
2580 #. type: textblock
2581 #: ../cat/virt-ls.pod:513 ../df/virt-df.pod:267 ../edit/virt-edit.pod:374 ../rescue/virt-rescue.pod:340
2582 msgid "Copyright (C) 2009-2011 Red Hat Inc."
2583 msgstr ""
2584
2585 #. type: textblock
2586 #: ../clone/virt-sysprep.pod:5
2587 msgid "virt-sysprep - Reset or unconfigure a virtual machine so clones can be made"
2588 msgstr ""
2589
2590 #. type: verbatim
2591 #: ../clone/virt-sysprep.pod:9
2592 #, no-wrap
2593 msgid ""
2594 " virt-sysprep [--options] -d domname\n"
2595 "\n"
2596 msgstr ""
2597
2598 #. type: verbatim
2599 #: ../clone/virt-sysprep.pod:11
2600 #, no-wrap
2601 msgid ""
2602 " virt-sysprep [--options] -a disk.img [-a disk.img ...]\n"
2603 "\n"
2604 msgstr ""
2605
2606 #. type: textblock
2607 #: ../clone/virt-sysprep.pod:15
2608 msgid ""
2609 "Virt-sysprep \"resets\" or \"unconfigures\" a virtual machine so that clones "
2610 "can be made from it.  Steps in this process include removing SSH host keys, "
2611 "removing persistent network MAC configuration, and removing user accounts.  "
2612 "Each step can be enabled or disabled as required."
2613 msgstr ""
2614
2615 #. type: textblock
2616 #: ../clone/virt-sysprep.pod:21
2617 msgid ""
2618 "Virt-sysprep is a simple shell script, allowing easy inspection or "
2619 "customization by the system administrator."
2620 msgstr ""
2621
2622 #. type: textblock
2623 #: ../clone/virt-sysprep.pod:24
2624 msgid ""
2625 "Virt-sysprep modifies the guest or disk image I<in place>.  The guest must "
2626 "be shut down.  If you want to preserve the existing contents of the guest, "
2627 "you I<must copy or clone the disk first>.  See L</COPYING AND CLONING> "
2628 "below."
2629 msgstr ""
2630
2631 #. type: textblock
2632 #: ../clone/virt-sysprep.pod:29
2633 msgid ""
2634 "You do I<not> need to run virt-sysprep as root.  In fact we'd generally "
2635 "recommend that you don't.  The time you might want to run it as root is when "
2636 "you need root in order to access the disk image, but even in this case it "
2637 "would be better to change the permissions on the disk image to be writable "
2638 "as the non-root user running virt-sysprep."
2639 msgstr ""
2640
2641 #. type: textblock
2642 #: ../clone/virt-sysprep.pod:35
2643 msgid ""
2644 "\"Sysprep\" stands for \"system preparation\" tool.  The name comes from the "
2645 "Microsoft program C<sysprep.exe> which is used to unconfigure Windows "
2646 "machines in preparation for cloning them.  Having said that, virt-sysprep "
2647 "does I<not> currently work on Microsoft Windows guests.  We plan to support "
2648 "Windows sysprepping in a future version, and we already have code to do it."
2649 msgstr ""
2650
2651 #. type: =item
2652 #: ../clone/virt-sysprep.pod:76
2653 msgid "B<--enable=...>"
2654 msgstr ""
2655
2656 #. type: textblock
2657 #: ../clone/virt-sysprep.pod:78
2658 msgid ""
2659 "Choose which sysprep operations to perform.  Give a comma-separated list of "
2660 "operations, for example:"
2661 msgstr ""
2662
2663 #. type: verbatim
2664 #: ../clone/virt-sysprep.pod:81
2665 #, no-wrap
2666 msgid ""
2667 " --enable=ssh-hostkeys,udev-persistent-net\n"
2668 "\n"
2669 msgstr ""
2670
2671 #. type: textblock
2672 #: ../clone/virt-sysprep.pod:83
2673 msgid "would enable ONLY C<ssh-hostkeys> and C<udev-persistent-net> operations."
2674 msgstr ""
2675
2676 #. type: textblock
2677 #: ../clone/virt-sysprep.pod:85
2678 msgid ""
2679 "If the I<--enable> option is not given, then we default to trying all "
2680 "possible sysprep operations.  But some sysprep operations are skipped for "
2681 "some guest types."
2682 msgstr ""
2683
2684 #. type: textblock
2685 #: ../clone/virt-sysprep.pod:89
2686 msgid ""
2687 "Use I<--list-operations> to list operations supported by a particular "
2688 "version of virt-sysprep."
2689 msgstr ""
2690
2691 #. type: textblock
2692 #: ../clone/virt-sysprep.pod:92
2693 msgid "See L</OPERATIONS> below for a list and an explanation of each operation."
2694 msgstr ""
2695
2696 #. type: verbatim
2697 #: ../clone/virt-sysprep.pod:106
2698 #, no-wrap
2699 msgid ""
2700 " virt-sysprep --format=raw -a disk.img\n"
2701 "\n"
2702 msgstr ""
2703
2704 #. type: verbatim
2705 #: ../clone/virt-sysprep.pod:110
2706 #, no-wrap
2707 msgid ""
2708 " virt-sysprep --format=raw -a disk.img --format -a another.img\n"
2709 "\n"
2710 msgstr ""
2711
2712 #. type: =item
2713 #: ../clone/virt-sysprep.pod:119
2714 msgid "B<--hostname> newhostname"
2715 msgstr ""
2716
2717 #. type: textblock
2718 #: ../clone/virt-sysprep.pod:121
2719 msgid ""
2720 "Change the hostname.  See the L</hostname> operation below.  If not given, "
2721 "defaults to C<localhost.localdomain>."
2722 msgstr ""
2723
2724 #. type: =item
2725 #: ../clone/virt-sysprep.pod:124
2726 msgid "B<--list-operations>"
2727 msgstr ""
2728
2729 #. type: textblock
2730 #: ../clone/virt-sysprep.pod:126
2731 msgid "List the operations supported by the virt-sysprep program."
2732 msgstr ""
2733
2734 #. type: =item
2735 #: ../clone/virt-sysprep.pod:128
2736 msgid "B<--selinux-relabel>"
2737 msgstr ""
2738
2739 #. type: =item
2740 #: ../clone/virt-sysprep.pod:130
2741 msgid "B<--no-selinux-relabel>"
2742 msgstr ""
2743
2744 #. type: textblock
2745 #: ../clone/virt-sysprep.pod:132
2746 msgid ""
2747 "I<--selinux-relabel> forces SELinux relabelling next time the guest boots.  "
2748 "I<--no-selinux-relabel> disables relabelling."
2749 msgstr ""
2750
2751 #. type: textblock
2752 #: ../clone/virt-sysprep.pod:135
2753 msgid ""
2754 "The default is to try to detect if SELinux relabelling is required.  See "
2755 "L</SELINUX RELABELLING> below for more details."
2756 msgstr ""
2757
2758 #. type: =head1
2759 #: ../clone/virt-sysprep.pod:156
2760 msgid "OPERATIONS"
2761 msgstr ""
2762
2763 #. type: textblock
2764 #: ../clone/virt-sysprep.pod:158
2765 msgid ""
2766 "If the I<--enable> option is I<not> given, then I<all sysprep operations are "
2767 "enabled>, although some are skipped depending on the type of guest."
2768 msgstr ""
2769
2770 #. type: textblock
2771 #: ../clone/virt-sysprep.pod:162
2772 msgid ""
2773 "Operations can be individually enabled using the I<--enable> option.  Use a "
2774 "comma-separated list, for example:"
2775 msgstr ""
2776
2777 #. type: verbatim
2778 #: ../clone/virt-sysprep.pod:165
2779 #, no-wrap
2780 msgid ""
2781 " virt-sysprep --enable=ssh-hostkeys,udev-persistent-net [etc..]\n"
2782 "\n"
2783 msgstr ""
2784
2785 #. type: textblock
2786 #: ../clone/virt-sysprep.pod:167
2787 msgid ""
2788 "To list the operations supported by the current version of virt-sysprep, use "
2789 "I<--list-operations>."
2790 msgstr ""
2791
2792 #. type: textblock
2793 #: ../clone/virt-sysprep.pod:170
2794 msgid ""
2795 "Future versions of virt-sysprep may add more operations.  If you are using "
2796 "virt-sysprep and want predictable behaviour, specify only the operations "
2797 "that you want to have enabled."
2798 msgstr ""
2799
2800 #. type: =head2
2801 #: ../clone/virt-sysprep.pod:174
2802 msgid "cron-spool"
2803 msgstr ""
2804
2805 #. type: textblock
2806 #: ../clone/virt-sysprep.pod:176
2807 msgid "Remove user at-jobs and cron-jobs."
2808 msgstr ""
2809
2810 #. type: =head2
2811 #: ../clone/virt-sysprep.pod:178
2812 msgid "dhcp-client-state"
2813 msgstr ""
2814
2815 #. type: textblock
2816 #: ../clone/virt-sysprep.pod:180
2817 msgid "Remove DHCP client leases."
2818 msgstr ""
2819
2820 #. type: =head2
2821 #: ../clone/virt-sysprep.pod:182
2822 msgid "dhcp-server-state"
2823 msgstr ""
2824
2825 #. type: textblock
2826 #: ../clone/virt-sysprep.pod:184
2827 msgid "Remove DHCP server leases."
2828 msgstr ""
2829
2830 #. type: =head2
2831 #: ../clone/virt-sysprep.pod:186
2832 msgid "hostname"
2833 msgstr ""
2834
2835 #. type: textblock
2836 #: ../clone/virt-sysprep.pod:188
2837 msgid ""
2838 "Changes the hostname of the guest to the value given in the I<--hostname> "
2839 "parameter."
2840 msgstr ""
2841
2842 #. type: textblock
2843 #: ../clone/virt-sysprep.pod:191
2844 msgid ""
2845 "If the I<--hostname> parameter is not given, then the hostname is changed to "
2846 "C<localhost.localdomain>."
2847 msgstr ""
2848
2849 #. type: =head2
2850 #: ../clone/virt-sysprep.pod:194
2851 msgid "logfiles"
2852 msgstr ""
2853
2854 #. type: textblock
2855 #: ../clone/virt-sysprep.pod:196
2856 msgid "Remove many log files."
2857 msgstr ""
2858
2859 #. type: =head2
2860 #: ../clone/virt-sysprep.pod:198
2861 msgid "mail-spool"
2862 msgstr ""
2863
2864 #. type: textblock
2865 #: ../clone/virt-sysprep.pod:200
2866 msgid "Remove email from the local mail spool directory."
2867 msgstr ""
2868
2869 #. type: =head2
2870 #: ../clone/virt-sysprep.pod:202
2871 msgid "net-hwaddr"
2872 msgstr ""
2873
2874 #. type: textblock
2875 #: ../clone/virt-sysprep.pod:204
2876 msgid ""
2877 "Remove HWADDR (hard-coded MAC address) configuration.  For Fedora and Red "
2878 "Hat Enterprise Linux, this is removed from C<ifcfg-*> files."
2879 msgstr ""
2880
2881 #. type: =head2
2882 #: ../clone/virt-sysprep.pod:207
2883 msgid "random-seed"
2884 msgstr ""
2885
2886 #. type: textblock
2887 #: ../clone/virt-sysprep.pod:209
2888 msgid ""
2889 "Write some random bytes from the host into the random seed file of the "
2890 "guest."
2891 msgstr ""
2892
2893 #. type: textblock
2894 #: ../clone/virt-sysprep.pod:212
2895 msgid "See L</RANDOM SEED> below."
2896 msgstr ""
2897
2898 #. type: =head2
2899 #: ../clone/virt-sysprep.pod:214
2900 msgid "rhn-systemid"
2901 msgstr ""
2902
2903 #. type: textblock
2904 #: ../clone/virt-sysprep.pod:216
2905 msgid "Remove the RHN system ID."
2906 msgstr ""
2907
2908 #. type: =head2
2909 #: ../clone/virt-sysprep.pod:218
2910 msgid "smolt-uuid"
2911 msgstr ""
2912
2913 #. type: textblock
2914 #: ../clone/virt-sysprep.pod:220
2915 msgid "Remove the Smolt hardware UUID."
2916 msgstr ""
2917
2918 #. type: =head2
2919 #: ../clone/virt-sysprep.pod:222
2920 msgid "ssh-hostkeys"
2921 msgstr ""
2922
2923 #. type: textblock
2924 #: ../clone/virt-sysprep.pod:224
2925 msgid "Remove the SSH host keys in the guest."
2926 msgstr ""
2927
2928 #. type: textblock
2929 #: ../clone/virt-sysprep.pod:226
2930 msgid ""
2931 "The SSH host keys are regenerated (differently) next time the guest is "
2932 "booted."
2933 msgstr ""
2934
2935 #. type: textblock
2936 #: ../clone/virt-sysprep.pod:229
2937 msgid ""
2938 "If, after cloning, the guest gets the same IP address, ssh will give you a "
2939 "stark warning about the host key changing:"
2940 msgstr ""
2941
2942 #. type: verbatim
2943 #: ../clone/virt-sysprep.pod:232
2944 #, no-wrap
2945 msgid ""
2946 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
2947 " @    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @\n"
2948 " @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n"
2949 " IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!\n"
2950 "\n"
2951 msgstr ""
2952
2953 #. type: =head2
2954 #: ../clone/virt-sysprep.pod:237
2955 msgid "udev-persistent-net"
2956 msgstr ""
2957
2958 #. type: textblock
2959 #: ../clone/virt-sysprep.pod:239
2960 msgid ""
2961 "Remove udev persistent net rules which map the guest's existing MAC address "
2962 "to a fixed ethernet device (eg. eth0)."
2963 msgstr ""
2964
2965 #. type: textblock
2966 #: ../clone/virt-sysprep.pod:242
2967 msgid ""
2968 "After a guest is cloned, the MAC address usually changes.  Since the old MAC "
2969 "address occupies the old name (eg. eth0), this means the fresh MAC address "
2970 "is assigned to a new name (eg. eth1) and this is usually undesirable.  "
2971 "Erasing the udev persistent net rules avoids this."
2972 msgstr ""
2973
2974 #. type: =head2
2975 #: ../clone/virt-sysprep.pod:247
2976 msgid "utmp"
2977 msgstr ""
2978
2979 #. type: textblock
2980 #: ../clone/virt-sysprep.pod:249
2981 msgid "Remove the utmp file."
2982 msgstr ""
2983
2984 #. type: textblock
2985 #: ../clone/virt-sysprep.pod:251
2986 msgid ""
2987 "This records who is currently logged in on a machine.  In modern Linux "
2988 "distros it is stored in a ramdisk and hence not part of the virtual "
2989 "machine's disk, but it was stored on disk in older distros."
2990 msgstr ""
2991
2992 #. type: =head2
2993 #: ../clone/virt-sysprep.pod:255
2994 msgid "yum-uuid"
2995 msgstr ""
2996
2997 #. type: textblock
2998 #: ../clone/virt-sysprep.pod:257
2999 msgid "Remove the yum UUID."
3000 msgstr ""
3001
3002 #. type: textblock
3003 #: ../clone/virt-sysprep.pod:259
3004 msgid ""
3005 "Yum creates a fresh UUID the next time it runs when it notices that the "
3006 "original UUID has been erased."
3007 msgstr ""
3008
3009 #. type: =head1
3010 #: ../clone/virt-sysprep.pod:262
3011 msgid "COPYING AND CLONING"
3012 msgstr ""
3013
3014 #. type: textblock
3015 #: ../clone/virt-sysprep.pod:264
3016 msgid ""
3017 "Virt-sysprep can be used as part of a process of cloning guests, or to "
3018 "prepare a template from which guests can be cloned.  There are many "
3019 "different ways to achieve this using the virt tools, and this section is "
3020 "just an introduction."
3021 msgstr ""
3022
3023 #. type: textblock
3024 #: ../clone/virt-sysprep.pod:269
3025 msgid "A virtual machine (when switched off) consists of two parts:"
3026 msgstr ""
3027
3028 #. type: =item
3029 #: ../clone/virt-sysprep.pod:273
3030 msgid "I<configuration>"
3031 msgstr ""
3032
3033 #. type: textblock
3034 #: ../clone/virt-sysprep.pod:275
3035 msgid ""
3036 "The configuration or description of the guest.  eg. The libvirt XML (see "
3037 "C<virsh dumpxml>), the running configuration of the guest, or another "
3038 "external format like OVF."
3039 msgstr ""
3040
3041 #. type: textblock
3042 #: ../clone/virt-sysprep.pod:279
3043 msgid "Some configuration items that might need to be changed:"
3044 msgstr ""
3045
3046 #. type: textblock
3047 #: ../clone/virt-sysprep.pod:285
3048 msgid "name"
3049 msgstr ""
3050
3051 #. type: textblock
3052 #: ../clone/virt-sysprep.pod:289 ../clone/virt-sysprep.pod:316
3053 msgid "UUID"
3054 msgstr ""
3055
3056 #. type: textblock
3057 #: ../clone/virt-sysprep.pod:293
3058 msgid "path to block device(s)"
3059 msgstr ""
3060
3061 #. type: textblock
3062 #: ../clone/virt-sysprep.pod:297
3063 msgid "network card MAC address"
3064 msgstr ""
3065
3066 #. type: =item
3067 #: ../clone/virt-sysprep.pod:301
3068 msgid "I<block device(s)>"
3069 msgstr ""
3070
3071 #. type: textblock
3072 #: ../clone/virt-sysprep.pod:303
3073 msgid ""
3074 "One or more hard disk images, themselves containing files, directories, "
3075 "applications, kernels, configuration, etc."
3076 msgstr ""
3077
3078 #. type: textblock
3079 #: ../clone/virt-sysprep.pod:306
3080 msgid "Some things inside the block devices that might need to be changed:"
3081 msgstr ""
3082
3083 #. type: textblock
3084 #: ../clone/virt-sysprep.pod:312
3085 msgid "hostname and other net configuration"
3086 msgstr ""
3087
3088 #. type: textblock
3089 #: ../clone/virt-sysprep.pod:320
3090 msgid "SSH host keys"
3091 msgstr ""
3092
3093 #. type: textblock
3094 #: ../clone/virt-sysprep.pod:324
3095 msgid "Windows unique security ID (SID)"
3096 msgstr ""
3097
3098 #. type: textblock
3099 #: ../clone/virt-sysprep.pod:328
3100 msgid "Puppet registration"
3101 msgstr ""
3102
3103 #. type: =head2
3104 #: ../clone/virt-sysprep.pod:334
3105 msgid "COPYING THE BLOCK DEVICE"
3106 msgstr ""
3107
3108 #. type: textblock
3109 #: ../clone/virt-sysprep.pod:336
3110 msgid ""
3111 "Starting with an original guest, you probably wish to copy the guest block "
3112 "device and its configuration to make a template.  Then once you are happy "
3113 "with the template, you will want to make many clones from it."
3114 msgstr ""
3115
3116 #. type: verbatim
3117 #: ../clone/virt-sysprep.pod:341
3118 #, no-wrap
3119 msgid ""
3120 "                        virt-sysprep\n"
3121 "                             |\n"
3122 "                             v\n"
3123 " original guest --------> template ---------->\n"
3124 "                                      \\------> cloned\n"
3125 "                                       \\-----> guests\n"
3126 "                                        \\---->\n"
3127 "\n"
3128 msgstr ""
3129
3130 #. type: textblock
3131 #: ../clone/virt-sysprep.pod:349
3132 msgid ""
3133 "You can, of course, just copy the block device on the host using L<cp(1)> or "
3134 "L<dd(1)>."
3135 msgstr ""
3136
3137 #. type: verbatim
3138 #: ../clone/virt-sysprep.pod:352
3139 #, no-wrap
3140 msgid ""
3141 "                   dd                 dd\n"
3142 " original guest --------> template ---------->\n"
3143 "                                      \\------> cloned\n"
3144 "                                       \\-----> guests\n"
3145 "                                        \\---->\n"
3146 "\n"
3147 msgstr ""
3148
3149 #. type: textblock
3150 #: ../clone/virt-sysprep.pod:358
3151 msgid "There are some smarter (and faster) ways too:"
3152 msgstr ""
3153
3154 #. type: verbatim
3155 #: ../clone/virt-sysprep.pod:364
3156 #, no-wrap
3157 msgid ""
3158 "                          snapshot\n"
3159 "                template ---------->\n"
3160 "                            \\------> cloned\n"
3161 "                             \\-----> guests\n"
3162 "                              \\---->\n"
3163 "\n"
3164 msgstr ""
3165
3166 #. type: textblock
3167 #: ../clone/virt-sysprep.pod:370
3168 msgid ""
3169 "Use the block device as a backing file and create a snapshot on top for each "
3170 "guest.  The advantage is that you don't need to copy the block device (very "
3171 "fast) and only changes are stored (less storage required)."
3172 msgstr ""
3173
3174 #. type: textblock
3175 #: ../clone/virt-sysprep.pod:375
3176 msgid ""
3177 "Note that writing to the backing file once you have created guests on top of "
3178 "it is not possible: you will corrupt the guests."
3179 msgstr ""
3180
3181 #. type: textblock
3182 #: ../clone/virt-sysprep.pod:378
3183 msgid ""
3184 "Tools that can do this include: L<qemu-img(1)> (with the I<create -f qcow2 "
3185 "-o backing_file> option), L<lvcreate(8)> (I<--snapshot> option).  Some "
3186 "filesystems (such as btrfs) and most Network Attached Storage devices can "
3187 "also create cheap snapshots from files or LUNs."
3188 msgstr ""
3189
3190 #. type: textblock
3191 #: ../clone/virt-sysprep.pod:386
3192 msgid "Get your NAS to snapshot and/or duplicate the LUN."
3193 msgstr ""
3194
3195 #. type: textblock
3196 #: ../clone/virt-sysprep.pod:390
3197 msgid "Prepare your template using L<virt-sparsify(1)>.  See below."
3198 msgstr ""
3199
3200 #. type: =head2
3201 #: ../clone/virt-sysprep.pod:394
3202 msgid "VIRT-CLONE"
3203 msgstr ""
3204
3205 #. type: textblock
3206 #: ../clone/virt-sysprep.pod:396
3207 msgid ""
3208 "A separate tool, L<virt-clone(1)>, can be used to duplicate the block device "
3209 "and/or modify the external libvirt configuration of a guest.  It will reset "
3210 "the name, UUID and MAC address of the guest in the libvirt XML."
3211 msgstr ""
3212
3213 #. type: textblock
3214 #: ../clone/virt-sysprep.pod:401
3215 msgid ""
3216 "L<virt-clone(1)> does not use libguestfs and cannot look inside the disk "
3217 "image.  This was the original motivation to write virt-sysprep."
3218 msgstr ""
3219
3220 #. type: =head2
3221 #: ../clone/virt-sysprep.pod:404
3222 msgid "SPARSIFY"
3223 msgstr ""
3224
3225 #. type: verbatim
3226 #: ../clone/virt-sysprep.pod:406
3227 #, no-wrap
3228 msgid ""
3229 "              virt-sparsify\n"
3230 " original guest --------> template\n"
3231 "\n"
3232 msgstr ""
3233
3234 #. type: textblock
3235 #: ../clone/virt-sysprep.pod:409
3236 msgid ""
3237 "L<virt-sparsify(1)> can be used to make the cloning template smaller, making "
3238 "it easier to compress and/or faster to copy."
3239 msgstr ""
3240
3241 #. type: textblock
3242 #: ../clone/virt-sysprep.pod:412
3243 msgid ""
3244 "Notice that since virt-sparsify also copies the image, you can use it to "
3245 "make the initial copy (instead of C<dd>)."
3246 msgstr ""
3247
3248 #. type: =head2
3249 #: ../clone/virt-sysprep.pod:415
3250 msgid "RESIZE"
3251 msgstr ""
3252
3253 #. type: verbatim
3254 #: ../clone/virt-sysprep.pod:417
3255 #, no-wrap
3256 msgid ""
3257 "                         virt-resize\n"
3258 "                template ---------->\n"
3259 "                            \\------> cloned\n"
3260 "                             \\-----> guests\n"
3261 "                              \\---->\n"
3262 "\n"
3263 msgstr ""
3264
3265 #. type: textblock
3266 #: ../clone/virt-sysprep.pod:423
3267 msgid ""
3268 "If you want to give people cloned guests, but let them pick the size of the "
3269 "guest themselves (eg. depending on how much they are prepared to pay for "
3270 "disk space), then instead of copying the template, you can run "
3271 "L<virt-resize(1)>.  Virt-resize performs a copy and resize, and thus is "
3272 "ideal for cloning guests from a template."
3273 msgstr ""
3274
3275 #. type: =head1
3276 #: ../clone/virt-sysprep.pod:429 ../src/guestfs.pod:1164
3277 msgid "SECURITY"
3278 msgstr ""
3279
3280 #. type: textblock
3281 #: ../clone/virt-sysprep.pod:431
3282 msgid ""
3283 "Although virt-sysprep removes some sensitive information from the guest, it "
3284 "does not pretend to remove all of it.  You should examine the L</OPERATIONS> "
3285 "above, and the implementation of the operations in the shell script.  You "
3286 "should also examine the guest afterwards."
3287 msgstr ""
3288
3289 #. type: textblock
3290 #: ../clone/virt-sysprep.pod:436
3291 msgid ""
3292 "Sensitive files are simply removed.  The data they contained may still exist "
3293 "on the disk, easily recovered with a hex editor or undelete tool.  Use "
3294 "L<virt-sparsify(1)> as one way to remove this content.  See also the "
3295 "L<scrub(1)> command to get rid of deleted content in directory entries and "
3296 "inodes."
3297 msgstr ""
3298
3299 #. type: =head2
3300 #: ../clone/virt-sysprep.pod:442
3301 msgid "RANDOM SEED"
3302 msgstr ""
3303
3304 #. type: textblock
3305 #: ../clone/virt-sysprep.pod:444
3306 msgid "I<(This section applies to Linux guests only)>"
3307 msgstr ""
3308
3309 #. type: textblock
3310 #: ../clone/virt-sysprep.pod:446
3311 msgid ""
3312 "The virt-sysprep C<random-seed> operation writes a few bytes of randomness "
3313 "from the host into the guest's random seed file."
3314 msgstr ""
3315
3316 #. type: textblock
3317 #: ../clone/virt-sysprep.pod:449
3318 msgid ""
3319 "If this is just done once and the guest is cloned from the same template, "
3320 "then each guest will start with the same entropy, and things like SSH host "
3321 "keys and TCP sequence numbers may be predictable."
3322 msgstr ""
3323
3324 #. type: textblock
3325 #: ../clone/virt-sysprep.pod:453
3326 msgid ""
3327 "Therefore you should arrange to add more randomness I<after> cloning from a "
3328 "template too, which can be done by just enabling the C<random-seed> "
3329 "operation:"
3330 msgstr ""
3331
3332 #. type: verbatim
3333 #: ../clone/virt-sysprep.pod:457
3334 #, no-wrap
3335 msgid ""
3336 " cp template.img newguest.img\n"
3337 " virt-sysprep --enable=random-seed -a newguest.img\n"
3338 "\n"
3339 msgstr ""
3340
3341 #. type: =head2
3342 #: ../clone/virt-sysprep.pod:460
3343 msgid "SELINUX RELABELLING"
3344 msgstr ""
3345
3346 #. type: textblock
3347 #: ../clone/virt-sysprep.pod:462
3348 msgid "I<(This section applies to Linux guests using SELinux only)>"
3349 msgstr ""
3350
3351 #. type: textblock
3352 #: ../clone/virt-sysprep.pod:464
3353 msgid ""
3354 "If any new files are created by virt-sysprep, then virt-sysprep touches "
3355 "C</.autorelabel> so that these will be correctly labelled by SELinux the "
3356 "next time the guest is booted.  This process interrupts boot and can take "
3357 "some time."
3358 msgstr ""
3359
3360 #. type: textblock
3361 #: ../clone/virt-sysprep.pod:469
3362 msgid ""
3363 "You can force relabelling for all guests by supplying the "
3364 "I<--selinux-relabel> option."
3365 msgstr ""
3366
3367 #. type: textblock
3368 #: ../clone/virt-sysprep.pod:472
3369 msgid ""
3370 "You can disable relabelling entirely by supplying the "
3371 "I<--no-selinux-relabel> option."
3372 msgstr ""
3373
3374 #. type: textblock
3375 #: ../clone/virt-sysprep.pod:484
3376 msgid "This program returns 0 on success, or 1 if there was an error."
3377 msgstr ""
3378
3379 #. type: textblock
3380 #: ../clone/virt-sysprep.pod:488
3381 msgid ""
3382 "L<guestfs(3)>, L<guestfish(1)>, L<virt-clone(1)>, L<virt-rescue(1)>, "
3383 "L<virt-resize(1)>, L<virt-sparsify(1)>, L<virsh(1)>, L<lvcreate(8)>, "
3384 "L<qemu-img(1)>, L<scrub(1)>, L<http://libguestfs.org/>, "
3385 "L<http://libvirt.org/>."
3386 msgstr ""
3387
3388 #. type: textblock
3389 #: ../df/virt-df.pod:5
3390 msgid "virt-df - Display free space on virtual filesystems"
3391 msgstr ""
3392
3393 #. type: verbatim
3394 #: ../df/virt-df.pod:9
3395 #, no-wrap
3396 msgid ""
3397 " virt-df [--options]\n"
3398 "\n"
3399 msgstr ""
3400
3401 #. type: verbatim
3402 #: ../df/virt-df.pod:11
3403 #, no-wrap
3404 msgid ""
3405 " virt-df [--options] -d domname\n"
3406 "\n"
3407 msgstr ""
3408
3409 #. type: verbatim
3410 #: ../df/virt-df.pod:13
3411 #, no-wrap
3412 msgid ""
3413 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
3414 "\n"
3415 msgstr ""
3416
3417 #. type: verbatim
3418 #: ../df/virt-df.pod:17
3419 #, no-wrap
3420 msgid ""
3421 " virt-df [--options] domname\n"
3422 "\n"
3423 msgstr ""
3424
3425 #. type: verbatim
3426 #: ../df/virt-df.pod:19
3427 #, no-wrap
3428 msgid ""
3429 " virt-df [--options] disk.img [disk.img ...]\n"
3430 "\n"
3431 msgstr ""
3432
3433 #. type: textblock
3434 #: ../df/virt-df.pod:23
3435 msgid ""
3436 "C<virt-df> is a command line tool to display free space on virtual machine "
3437 "filesystems.  Unlike other tools, it doesn't just display the size of disk "
3438 "allocated to a virtual machine, but can look inside disk images to see how "
3439 "much space is really being used."
3440 msgstr ""
3441
3442 #. type: textblock
3443 #: ../df/virt-df.pod:28
3444 msgid ""
3445 "If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
3446 "to get a list of all active and inactive guests, and performs a C<df>-type "
3447 "operation on each one in turn, printing out the results."
3448 msgstr ""
3449
3450 #. type: textblock
3451 #: ../df/virt-df.pod:32
3452 msgid ""
3453 "If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a "
3454 "C<df>-type operation on either the single named libvirt domain, or on the "
3455 "disk image(s) listed on the command line (which must all belong to a single "
3456 "VM).  In this mode (with arguments), C<virt-df> will I<only work for a "
3457 "single guest>.  If you want to run on multiple guests, then you have to "
3458 "invoke C<virt-df> multiple times."
3459 msgstr ""
3460
3461 #. type: textblock
3462 #: ../df/virt-df.pod:39
3463 msgid ""
3464 "Use the I<--csv> option to get a format which can be easily parsed by other "
3465 "programs.  Other options are similar to the standard L<df(1)> command."
3466 msgstr ""
3467
3468 #. type: textblock
3469 #: ../df/virt-df.pod:45
3470 msgid ""
3471 "Show disk usage for a single libvirt guest called C<F14x64>.  Make the "
3472 "output human-readable:"
3473 msgstr ""
3474
3475 #. type: verbatim
3476 #: ../df/virt-df.pod:48
3477 #, no-wrap
3478 msgid ""
3479 " # virt-df -d F14x64 -h\n"
3480 " Filesystem                       Size     Used  Available  Use%\n"
3481 " F14x64:/dev/sda1                 484M      66M       393M   14%\n"
3482 " F14x64:/dev/vg_f13x64/lv_root    7.4G     3.4G       4.0G   46%\n"
3483 "\n"
3484 msgstr ""
3485
3486 #. type: textblock
3487 #: ../df/virt-df.pod:53
3488 msgid "Show disk usage for a disk image file called C<test.img>:"
3489 msgstr ""
3490
3491 #. type: verbatim
3492 #: ../df/virt-df.pod:55
3493 #, no-wrap
3494 msgid ""
3495 " $ virt-df -a test1.img\n"
3496 " Filesystem                  1K-blocks     Used  Available  Use%\n"
3497 " test1.img:/dev/sda1             99099     1551      92432    2%\n"
3498 "\n"
3499 msgstr ""
3500
3501 #. type: verbatim
3502 #: ../df/virt-df.pod:112
3503 #, no-wrap
3504 msgid ""
3505 " virt-df --format=raw -a disk.img\n"
3506 "\n"
3507 msgstr ""
3508
3509 #. type: verbatim
3510 #: ../df/virt-df.pod:116
3511 #, no-wrap
3512 msgid ""
3513 " virt-df --format=raw -a disk.img --format -a another.img\n"
3514 "\n"
3515 msgstr ""
3516
3517 #. type: textblock
3518 #: ../df/virt-df.pod:129
3519 msgid "Print sizes in human-readable format."
3520 msgstr ""
3521
3522 #. type: textblock
3523 #: ../df/virt-df.pod:131
3524 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
3525 msgstr ""
3526
3527 #. type: =item
3528 #: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:164
3529 msgid "B<-i>"
3530 msgstr ""
3531
3532 #. type: =item
3533 #: ../df/virt-df.pod:135
3534 msgid "B<--inodes>"
3535 msgstr ""
3536
3537 #. type: textblock
3538 #: ../df/virt-df.pod:137
3539 msgid "Print inodes instead of blocks."
3540 msgstr ""
3541
3542 #. type: =item
3543 #: ../df/virt-df.pod:139
3544 msgid "B<--one-per-guest>"
3545 msgstr ""
3546
3547 #. type: textblock
3548 #: ../df/virt-df.pod:141
3549 msgid ""
3550 "Run one libguestfs appliance per guest.  Normally C<virt-df> will add the "
3551 "disks from several guests to a single libguestfs appliance."
3552 msgstr ""
3553
3554 #. type: textblock
3555 #: ../df/virt-df.pod:144
3556 msgid "You might use this option in the following circumstances:"
3557 msgstr ""
3558
3559 #. type: textblock
3560 #: ../df/virt-df.pod:150
3561 msgid ""
3562 "If you think an untrusted guest might actively try to exploit the libguestfs "
3563 "appliance kernel, then this prevents one guest from interfering with the "
3564 "stats printed for another guest."
3565 msgstr ""
3566
3567 #. type: textblock
3568 #: ../df/virt-df.pod:156
3569 msgid ""
3570 "If the kernel has a bug which stops it from accessing a filesystem in one "
3571 "guest (see for example RHBZ#635373) then this allows libguestfs to continue "
3572 "and report stats for further guests."
3573 msgstr ""
3574
3575 #. type: textblock
3576 #: ../df/virt-df.pod:165
3577 msgid ""
3578 "Print UUIDs instead of names.  This is useful for following a guest even "
3579 "when the guest is migrated or renamed, or when two guests happen to have the "
3580 "same name."
3581 msgstr ""
3582
3583 #. type: textblock
3584 #: ../df/virt-df.pod:169
3585 msgid ""
3586 "Note that only domains that we fetch from libvirt come with UUIDs.  For disk "
3587 "images, we still print the disk image name even when this option is "
3588 "specified."
3589 msgstr ""
3590
3591 #. type: =head1
3592 #: ../df/virt-df.pod:191
3593 msgid "STATVFS NUMBERS"
3594 msgstr ""
3595
3596 #. type: textblock
3597 #: ../df/virt-df.pod:193
3598 msgid ""
3599 "C<virt-df> (and L<df(1)>) get information by issuing a L<statvfs(3)> system "
3600 "call.  You can get the same information directly, either from the host "
3601 "(using libguestfs) or inside the guest:"
3602 msgstr ""
3603
3604 #. type: =item
3605 #: ../df/virt-df.pod:199
3606 msgid "From the host"
3607 msgstr ""
3608
3609 #. type: textblock
3610 #: ../df/virt-df.pod:201 ../df/virt-df.pod:209
3611 msgid "Run this command:"
3612 msgstr ""
3613
3614 #. type: verbatim
3615 #: ../df/virt-df.pod:203
3616 #, no-wrap
3617 msgid ""
3618 " guestfish --ro -d GuestName -i statvfs /\n"
3619 "\n"
3620 msgstr ""
3621
3622 #. type: textblock
3623 #: ../df/virt-df.pod:205 ../df/virt-df.pod:213
3624 msgid "(change C</> to see stats for other filesystems)."
3625 msgstr ""
3626
3627 #. type: =item
3628 #: ../df/virt-df.pod:207
3629 msgid "From inside the guest"
3630 msgstr ""
3631
3632 #. type: verbatim
3633 #: ../df/virt-df.pod:211
3634 #, no-wrap
3635 msgid ""
3636 " python -c 'import os; s = os.statvfs (\"/\"); print s'\n"
3637 "\n"
3638 msgstr ""
3639
3640 #. type: textblock
3641 #: ../df/virt-df.pod:255
3642 msgid ""
3643 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, "
3644 "L<http://libguestfs.org/>."
3645 msgstr ""
3646
3647 #. type: textblock
3648 #: ../edit/virt-edit.pod:5
3649 msgid "virt-edit - Edit a file in a virtual machine"
3650 msgstr ""
3651
3652 #. type: verbatim
3653 #: ../edit/virt-edit.pod:9
3654 #, no-wrap
3655 msgid ""
3656 " virt-edit [--options] -d domname file [file ...]\n"
3657 "\n"
3658 msgstr ""
3659
3660 #. type: verbatim
3661 #: ../edit/virt-edit.pod:11
3662 #, no-wrap
3663 msgid ""
3664 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
3665 "\n"
3666 msgstr ""
3667
3668 #. type: verbatim
3669 #: ../edit/virt-edit.pod:13
3670 #, no-wrap
3671 msgid ""
3672 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
3673 "\n"
3674 msgstr ""
3675
3676 #. type: verbatim
3677 #: ../edit/virt-edit.pod:17
3678 #, no-wrap
3679 msgid ""
3680 " virt-edit domname file\n"
3681 "\n"
3682 msgstr ""
3683
3684 #. type: verbatim
3685 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
3686 #, no-wrap
3687 msgid ""
3688 " virt-edit disk.img [disk.img ...] file\n"
3689 "\n"
3690 msgstr ""
3691
3692 #. type: =head1
3693 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23 ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15 ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:21 ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
3694 msgid "WARNING"
3695 msgstr ""
3696
3697 #. type: textblock
3698 #: ../edit/virt-edit.pod:23
3699 msgid ""
3700 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
3701 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
3702 "doing this, but doesn't catch all cases."
3703 msgstr ""
3704
3705 #. type: textblock
3706 #: ../edit/virt-edit.pod:29
3707 msgid ""
3708 "C<virt-edit> is a command line tool to edit C<file> where each C<file> "
3709 "exists in the named virtual machine (or disk image)."
3710 msgstr ""
3711
3712 #. type: textblock
3713 #: ../edit/virt-edit.pod:32
3714 msgid ""
3715 "Multiple filenames can be given, in which case they are each edited in "
3716 "turn.  Each filename must be a full path, starting at the root directory "
3717 "(starting with '/')."
3718 msgstr ""
3719
3720 #. type: textblock
3721 #: ../edit/virt-edit.pod:36
3722 msgid "If you want to just view a file, use L<virt-cat(1)>."
3723 msgstr ""
3724
3725 #. type: textblock
3726 #: ../edit/virt-edit.pod:38
3727 msgid ""
3728 "For more complex cases you should look at the L<guestfish(1)> tool (see "
3729 "L</USING GUESTFISH> below)."
3730 msgstr ""
3731
3732 #. type: textblock
3733 #: ../edit/virt-edit.pod:41
3734 msgid ""
3735 "C<virt-edit> cannot be used to create a new file.  L<guestfish(1)> can do "
3736 "that and much more."
3737 msgstr ""
3738
3739 #. type: textblock
3740 #: ../edit/virt-edit.pod:46
3741 msgid "Edit the named files interactively:"
3742 msgstr ""
3743
3744 #. type: verbatim
3745 #: ../edit/virt-edit.pod:48
3746 #, no-wrap
3747 msgid ""
3748 " virt-edit -d mydomain /boot/grub/grub.conf\n"
3749 "\n"
3750 msgstr ""
3751
3752 #. type: verbatim
3753 #: ../edit/virt-edit.pod:50
3754 #, no-wrap
3755 msgid ""
3756 " virt-edit -d mydomain /etc/passwd\n"
3757 "\n"
3758 msgstr ""
3759
3760 #. type: textblock
3761 #: ../edit/virt-edit.pod:52
3762 msgid "For Windows guests, some Windows paths are understood:"
3763 msgstr ""
3764
3765 #. type: verbatim
3766 #: ../edit/virt-edit.pod:54
3767 #, no-wrap
3768 msgid ""
3769 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
3770 "\n"
3771 msgstr ""
3772
3773 #. type: textblock
3774 #: ../edit/virt-edit.pod:56
3775 msgid ""
3776 "If Perl is installed, you can also edit files non-interactively (see "
3777 "L</NON-INTERACTIVE EDITING> below).  To change the init default level to 5:"
3778 msgstr ""
3779
3780 #. type: verbatim
3781 #: ../edit/virt-edit.pod:60
3782 #, no-wrap
3783 msgid ""
3784 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
3785 "\n"
3786 msgstr ""
3787
3788 #. type: =item
3789 #: ../edit/virt-edit.pod:81
3790 msgid "B<-b> extension"
3791 msgstr ""
3792
3793 #. type: =item
3794 #: ../edit/virt-edit.pod:83
3795 msgid "B<--backup> extension"
3796 msgstr ""
3797
3798 #. type: textblock
3799 #: ../edit/virt-edit.pod:85
3800 msgid ""
3801 "Create a backup of the original file I<in the guest disk image>.  The backup "
3802 "has the original filename with C<extension> added."
3803 msgstr ""
3804
3805 #. type: textblock
3806 #: ../edit/virt-edit.pod:88
3807 msgid ""
3808 "Usually the first character of C<extension> would be a dot C<.> so you would "
3809 "write:"
3810 msgstr ""
3811
3812 #. type: verbatim
3813 #: ../edit/virt-edit.pod:91
3814 #, no-wrap
3815 msgid ""
3816 " virt-edit -b .orig [etc]\n"
3817 "\n"
3818 msgstr ""
3819
3820 #. type: textblock
3821 #: ../edit/virt-edit.pod:93
3822 msgid "By default, no backup file is made."
3823 msgstr ""
3824
3825 #. type: =item
3826 #: ../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
3827 msgid "B<-c URI>"
3828 msgstr ""
3829
3830 #. type: =item
3831 #: ../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
3832 msgid "B<--connect URI>"
3833 msgstr ""
3834
3835 #. type: textblock
3836 #: ../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
3837 msgid ""
3838 "If you specify guest block devices directly, then libvirt is not used at "
3839 "all."
3840 msgstr ""
3841
3842 #. type: textblock
3843 #: ../edit/virt-edit.pod:114
3844 msgid ""
3845 "When prompting for keys and passphrases, virt-edit normally turns echoing "
3846 "off so you cannot see what you are typing.  If you are not worried about "
3847 "Tempest attacks and there is no one else in the room you can specify this "
3848 "flag to see what you are typing."
3849 msgstr ""
3850
3851 #. type: =item
3852 #: ../edit/virt-edit.pod:119
3853 msgid "B<-e> EXPR"
3854 msgstr ""
3855
3856 #. type: =item
3857 #: ../edit/virt-edit.pod:121
3858 msgid "B<--expr> EXPR"
3859 msgstr ""
3860
3861 #. type: textblock
3862 #: ../edit/virt-edit.pod:123
3863 msgid ""
3864 "Instead of launching the external editor, non-interactively apply the Perl "
3865 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
3866 "EDITING> below."
3867 msgstr ""
3868
3869 #. type: textblock
3870 #: ../edit/virt-edit.pod:127
3871 msgid ""
3872 "Be careful to properly quote the expression to prevent it from being altered "
3873 "by the shell."
3874 msgstr ""
3875
3876 #. type: textblock
3877 #: ../edit/virt-edit.pod:130
3878 msgid "Note that this option is only available when Perl 5 is installed."
3879 msgstr ""
3880
3881 #. type: =item
3882 #: ../edit/virt-edit.pod:132
3883 msgid "B<--format> raw|qcow2|..."
3884 msgstr ""
3885
3886 #. type: verbatim
3887 #: ../edit/virt-edit.pod:143
3888 #, no-wrap
3889 msgid ""
3890 " virt-edit --format=raw -a disk.img file\n"
3891 "\n"