po-docs/ja.po

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