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-07-20 17:31+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 #: ../cat/virt-cat.pod:3 ../cat/virt-filesystems.pod:3 ../cat/virt-ls.pod:3
  23 #: ../df/virt-df.pod:3 ../edit/virt-edit.pod:3
  24 #: ../examples/guestfs-examples.pod:3 ../examples/guestfs-recipes.pod:14
  25 #: ../fish/guestfish.pod:3 ../fish/virt-copy-in.pod:3
  26 #: ../fish/virt-copy-out.pod:3 ../fish/virt-tar-in.pod:3
  27 #: ../fish/virt-tar-out.pod:3 ../fuse/guestmount.pod:3
  28 #: ../inspector/virt-inspector.pod:3 ../java/examples/guestfs-java.pod:3
  29 #: ../ocaml/examples/guestfs-ocaml.pod:3 ../perl/examples/guestfs-perl.pod:3
  30 #: ../python/examples/guestfs-python.pod:3 ../rescue/virt-rescue.pod:3
  31 #: ../resize/virt-resize.pod:3 ../ruby/examples/guestfs-ruby.pod:3
  32 #: ../src/guestfs.pod:3 ../test-tool/libguestfs-test-tool.pod:3
  33 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
  34 #: ../tools/virt-make-fs.pl:35 ../tools/virt-tar.pl:31
  35 #: ../tools/virt-win-reg.pl:35
  36 msgid "NAME"
  37 msgstr "名前"
  38
  39 #. type: textblock
  40 #: ../cat/virt-cat.pod:5
  41 msgid "virt-cat - Display files in a virtual machine"
  42 msgstr ""
  43
  44 #. type: =head1
  45 #: ../cat/virt-cat.pod:7 ../cat/virt-filesystems.pod:7 ../cat/virt-ls.pod:7
  46 #: ../df/virt-df.pod:7 ../edit/virt-edit.pod:7
  47 #: ../examples/guestfs-examples.pod:7 ../fish/guestfish.pod:7
  48 #: ../fish/virt-copy-in.pod:7 ../fish/virt-copy-out.pod:7
  49 #: ../fish/virt-tar-in.pod:7 ../fish/virt-tar-out.pod:7
  50 #: ../fuse/guestmount.pod:7 ../inspector/virt-inspector.pod:7
  51 #: ../java/examples/guestfs-java.pod:7 ../ocaml/examples/guestfs-ocaml.pod:7
  52 #: ../perl/examples/guestfs-perl.pod:7 ../python/examples/guestfs-python.pod:7
  53 #: ../rescue/virt-rescue.pod:7 ../resize/virt-resize.pod:7
  54 #: ../ruby/examples/guestfs-ruby.pod:7 ../src/guestfs.pod:7
  55 #: ../test-tool/libguestfs-test-tool.pod:7
  56 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-list-partitions.pl:34
  57 #: ../tools/virt-make-fs.pl:39 ../tools/virt-tar.pl:35
  58 #: ../tools/virt-win-reg.pl:39
  59 msgid "SYNOPSIS"
  60 msgstr ""
  61
  62 #. type: verbatim
  63 #: ../cat/virt-cat.pod:9
  64 #, no-wrap
  65 msgid ""
  66 " virt-cat [--options] -d domname file [file ...]\n"
  67 "\n"
  68 msgstr ""
  69
  70 #. type: verbatim
  71 #: ../cat/virt-cat.pod:11
  72 #, no-wrap
  73 msgid ""
  74 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
  75 "\n"
  76 msgstr ""
  77
  78 #. type: textblock
  79 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15
  80 #: ../inspector/virt-inspector.pod:13
  81 msgid "Old-style:"
  82 msgstr ""
  83
  84 #. type: verbatim
  85 #: ../cat/virt-cat.pod:15
  86 #, no-wrap
  87 msgid ""
  88 " virt-cat domname file\n"
  89 "\n"
  90 msgstr ""
  91
  92 #. type: verbatim
  93 #: ../cat/virt-cat.pod:17
  94 #, no-wrap
  95 msgid ""
  96 " virt-cat disk.img file\n"
  97 "\n"
  98 msgstr ""
  99
 100 #. type: =head1
 101 #: ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19
 102 #: ../df/virt-df.pod:21 ../edit/virt-edit.pod:27
 103 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
 104 #: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19
 105 #: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21
 106 #: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20
 107 #: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15
 108 #: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18
 109 #: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29
 110 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
 111 #: ../src/guestfs.pod:23 ../test-tool/libguestfs-test-tool.pod:11
 112 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40
 113 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77
 114 #: ../tools/virt-win-reg.pl:63
 115 msgid "DESCRIPTION"
 116 msgstr ""
 117
 118 #. type: textblock
 119 #: ../cat/virt-cat.pod:21
 120 msgid ""
 121 "C<virt-cat> is a command line tool to display the contents of C<file> where "
 122 "C<file> exists in the named virtual machine (or disk image)."
 123 msgstr ""
 124
 125 #. type: textblock
 126 #: ../cat/virt-cat.pod:24
 127 msgid ""
 128 "Multiple filenames can be given, in which case they are concatenated "
 129 "together.  Each filename must be a full path, starting at the root directory "
 130 "(starting with '/')."
 131 msgstr ""
 132
 133 #. type: textblock
 134 #: ../cat/virt-cat.pod:28
 135 msgid ""
 136 "C<virt-cat> can be used to quickly view a file.  To edit a file, use C<virt-"
 137 "edit>.  For more complex cases you should look at the L<guestfish(1)> tool "
 138 "(see L</USING GUESTFISH> below)."
 139 msgstr ""
 140
 141 #. type: =head1
 142 #: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43
 143 #: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41
 144 #: ../fish/guestfish.pod:1007 ../fish/virt-copy-in.pod:29
 145 #: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30
 146 #: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39
 147 #: ../resize/virt-resize.pod:27 ../tools/virt-tar.pl:50
 148 msgid "EXAMPLES"
 149 msgstr ""
 150
 151 #. type: textblock
 152 #: ../cat/virt-cat.pod:34
 153 msgid ""
 154 "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
 155 msgstr ""
 156
 157 #. type: verbatim
 158 #: ../cat/virt-cat.pod:37
 159 #, no-wrap
 160 msgid ""
 161 " virt-cat -d mydomain /etc/fstab\n"
 162 "\n"
 163 msgstr ""
 164
 165 #. type: textblock
 166 #: ../cat/virt-cat.pod:39
 167 msgid "List syslog messages from a VM disk image file:"
 168 msgstr ""
 169
 170 #. type: verbatim
 171 #: ../cat/virt-cat.pod:41
 172 #, no-wrap
 173 msgid ""
 174 " virt-cat -a disk.img /var/log/messages | tail\n"
 175 "\n"
 176 msgstr ""
 177
 178 #. type: textblock
 179 #: ../cat/virt-cat.pod:43
 180 msgid "Find out what DHCP IP address a VM acquired:"
 181 msgstr ""
 182
 183 #. type: verbatim
 184 #: ../cat/virt-cat.pod:45
 185 #, no-wrap
 186 msgid ""
 187 " virt-cat -d mydomain /var/log/messages | \\\n"
 188 "   grep 'dhclient: bound to' | tail\n"
 189 "\n"
 190 msgstr ""
 191
 192 #. type: textblock
 193 #: ../cat/virt-cat.pod:48
 194 msgid "Find out what packages were recently installed:"
 195 msgstr ""
 196
 197 #. type: verbatim
 198 #: ../cat/virt-cat.pod:50
 199 #, no-wrap
 200 msgid ""
 201 " virt-cat -d mydomain /var/log/yum.log | tail\n"
 202 "\n"
 203 msgstr ""
 204
 205 #. type: textblock
 206 #: ../cat/virt-cat.pod:52
 207 msgid "Find out who is logged on inside a virtual machine:"
 208 msgstr ""
 209
 210 #. type: verbatim
 211 #: ../cat/virt-cat.pod:54
 212 #, no-wrap
 213 msgid ""
 214 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
 215 " who /tmp/utmp\n"
 216 "\n"
 217 msgstr ""
 218
 219 #. type: textblock
 220 #: ../cat/virt-cat.pod:57
 221 msgid "or who was logged on:"
 222 msgstr ""
 223
 224 #. type: verbatim
 225 #: ../cat/virt-cat.pod:59
 226 #, no-wrap
 227 msgid ""
 228 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
 229 " last -f /tmp/wtmp\n"
 230 "\n"
 231 msgstr ""
 232
 233 #. type: =head1
 234 #: ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91
 235 #: ../cat/virt-ls.pod:261 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62
 236 #: ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45
 237 #: ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42
 238 #: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:83
 239 #: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84
 240 #: ../resize/virt-resize.pod:241 ../test-tool/libguestfs-test-tool.pod:37
 241 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54
 242 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103
 243 #: ../tools/virt-win-reg.pl:96
 244 msgid "OPTIONS"
 245 msgstr ""
 246
 247 #. type: =item
 248 #: ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95
 249 #: ../cat/virt-ls.pod:265 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66
 250 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:151
 251 #: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88
 252 #: ../resize/virt-resize.pod:245 ../tools/virt-list-filesystems.pl:61
 253 #: ../tools/virt-list-partitions.pl:62 ../tools/virt-make-fs.pl:161
 254 #: ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104
 255 msgid "B<--help>"
 256 msgstr ""
 257
 258 #. type: textblock
 259 #: ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97
 260 #: ../cat/virt-ls.pod:267 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68
 261 #: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90
 262 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64
 263 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113
 264 #: ../tools/virt-win-reg.pl:106
 265 msgid "Display brief help."
 266 msgstr ""
 267
 268 #. type: =item
 269 #: ../cat/virt-cat.pod:70 ../cat/virt-filesystems.pod:99
 270 #: ../cat/virt-ls.pod:269 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70
 271 #: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92
 272 msgid "B<-a> file"
 273 msgstr ""
 274
 275 #. type: =item
 276 #: ../cat/virt-cat.pod:72 ../cat/virt-filesystems.pod:101
 277 #: ../cat/virt-ls.pod:271 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72
 278 #: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94
 279 msgid "B<--add> file"
 280 msgstr ""
 281
 282 #. type: textblock
 283 #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103
 284 #: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74
 285 #: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96
 286 msgid ""
 287 "Add I<file> which should be a disk image from a virtual machine.  If the "
 288 "virtual machine has multiple block devices, you must supply all of them with "
 289 "separate I<-a> options."
 290 msgstr ""
 291
 292 #. type: textblock
 293 #: ../cat/virt-cat.pod:78 ../cat/virt-filesystems.pod:107
 294 #: ../cat/virt-ls.pod:277 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78
 295 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:93
 296 #: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100
 297 msgid ""
 298 "The format of the disk image is auto-detected.  To override this and force a "
 299 "particular format use the I<--format=..> option."
 300 msgstr ""
 301
 302 #. type: =item
 303 #: ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125
 304 #: ../cat/virt-ls.pod:291 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:107
 305 msgid "B<-c> URI"
 306 msgstr ""
 307
 308 #. type: =item
 309 #: ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127
 310 #: ../cat/virt-ls.pod:293 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:109
 311 msgid "B<--connect> URI"
 312 msgstr ""
 313
 314 #. type: textblock
 315 #: ../cat/virt-cat.pod:85 ../cat/virt-filesystems.pod:129
 316 #: ../cat/virt-ls.pod:295 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99
 317 #: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111
 318 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82
 319 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
 320 msgid ""
 321 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
 322 "to the default libvirt hypervisor."
 323 msgstr ""
 324
 325 #. type: textblock
 326 #: ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132
 327 #: ../cat/virt-ls.pod:298 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:114
 328 msgid ""
 329 "If you specify guest block devices directly (I<-a>), then libvirt is not "
 330 "used at all."
 331 msgstr ""
 332
 333 #. type: =item
 334 #: ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141
 335 #: ../cat/virt-ls.pod:307 ../df/virt-df.pod:88 ../edit/virt-edit.pod:105
 336 #: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117
 337 msgid "B<-d> guest"
 338 msgstr ""
 339
 340 #. type: =item
 341 #: ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143
 342 #: ../cat/virt-ls.pod:309 ../df/virt-df.pod:90 ../edit/virt-edit.pod:107
 343 #: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119
 344 msgid "B<--domain> guest"
 345 msgstr ""
 346
 347 #. type: textblock
 348 #: ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145
 349 #: ../cat/virt-ls.pod:311 ../df/virt-df.pod:92 ../edit/virt-edit.pod:109
 350 #: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121
 351 msgid ""
 352 "Add all the disks from the named libvirt guest.  Domain UUIDs can be used "
 353 "instead of names."
 354 msgstr ""
 355
 356 #. type: =item
 357 #: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148
 358 #: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217
 359 #: ../fuse/guestmount.pod:126 ../inspector/virt-inspector.pod:92
 360 msgid "B<--echo-keys>"
 361 msgstr ""
 362
 363 #. type: textblock
 364 #: ../cat/virt-cat.pod:100
 365 msgid ""
 366 "When prompting for keys and passphrases, virt-cat normally turns echoing off "
 367 "so you cannot see what you are typing.  If you are not worried about Tempest "
 368 "attacks and there is no one else in the room you can specify this flag to "
 369 "see what you are typing."
 370 msgstr ""
 371
 372 #. type: =item
 373 #: ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170
 374 #: ../cat/virt-ls.pod:328 ../df/virt-df.pod:95 ../fish/guestfish.pod:233
 375 #: ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99
 376 #: ../rescue/virt-rescue.pod:124
 377 msgid "B<--format=raw|qcow2|..>"
 378 msgstr ""
 379
 380 #. type: =item
 381 #: ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172
 382 #: ../cat/virt-ls.pod:330 ../df/virt-df.pod:97 ../edit/virt-edit.pod:134
 383 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:135
 384 #: ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:126
 385 msgid "B<--format>"
 386 msgstr ""
 387
 388 #. type: textblock
 389 #: ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174
 390 #: ../cat/virt-ls.pod:332 ../df/virt-df.pod:99 ../edit/virt-edit.pod:136
 391 #: ../fish/guestfish.pod:237 ../fuse/guestmount.pod:137
 392 #: ../rescue/virt-rescue.pod:128
 393 msgid ""
 394 "The default for the I<-a> option is to auto-detect the format of the disk "
 395 "image.  Using this forces the disk format for I<-a> options which follow on "
 396 "the command line.  Using I<--format> with no argument switches back to auto-"
 397 "detection for subsequent I<-a> options."
 398 msgstr ""
 399
 400 #. type: textblock
 401 #: ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179
 402 #: ../cat/virt-ls.pod:337 ../df/virt-df.pod:104 ../edit/virt-edit.pod:141
 403 #: ../fish/guestfish.pod:242 ../fish/guestfish.pod:673
 404 #: ../inspector/virt-inspector.pod:335 ../rescue/virt-rescue.pod:133
 405 #: ../src/guestfs.pod:2652
 406 msgid "For example:"
 407 msgstr ""
 408
 409 #. type: verbatim
 410 #: ../cat/virt-cat.pod:116
 411 #, no-wrap
 412 msgid ""
 413 " virt-cat --format=raw -a disk.img file\n"
 414 "\n"
 415 msgstr ""
 416
 417 #. type: textblock
 418 #: ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183
 419 #: ../cat/virt-ls.pod:341 ../df/virt-df.pod:108 ../edit/virt-edit.pod:145
 420 #: ../fish/guestfish.pod:246 ../rescue/virt-rescue.pod:137
 421 msgid "forces raw format (no auto-detection) for C<disk.img>."
 422 msgstr ""
 423
 424 #. type: verbatim
 425 #: ../cat/virt-cat.pod:120
 426 #, no-wrap
 427 msgid ""
 428 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
 429 "\n"
 430 msgstr ""
 431
 432 #. type: textblock
 433 #: ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187
 434 #: ../cat/virt-ls.pod:345 ../df/virt-df.pod:112 ../edit/virt-edit.pod:149
 435 #: ../fish/guestfish.pod:250 ../rescue/virt-rescue.pod:141
 436 msgid ""
 437 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
 438 "detection for C<another.img>."
 439 msgstr ""
 440
 441 #. type: textblock
 442 #: ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190
 443 #: ../cat/virt-ls.pod:348 ../df/virt-df.pod:115 ../edit/virt-edit.pod:152
 444 #: ../rescue/virt-rescue.pod:144
 445 msgid ""
 446 "If you have untrusted raw-format guest disk images, you should use this "
 447 "option to specify the disk format.  This avoids a possible security problem "
 448 "with malicious guests (CVE-2010-3851)."
 449 msgstr ""
 450
 451 #. type: =item
 452 #: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200
 453 #: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289
 454 #: ../fuse/guestmount.pod:163 ../inspector/virt-inspector.pod:114
 455 msgid "B<--keys-from-stdin>"
 456 msgstr ""
 457
 458 #. type: textblock
 459 #: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202
 460 #: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291
 461 #: ../fuse/guestmount.pod:165 ../inspector/virt-inspector.pod:116
 462 msgid ""
 463 "Read key or passphrase parameters from stdin.  The default is to try to read "
 464 "passphrases from the user by opening C</dev/tty>."
 465 msgstr ""
 466
 467 #. type: =item
 468 #: ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261
 469 #: ../cat/virt-ls.pod:425 ../df/virt-df.pod:167 ../edit/virt-edit.pod:161
 470 #: ../fish/guestfish.pod:390 ../fuse/guestmount.pod:257
 471 #: ../inspector/virt-inspector.pod:119 ../rescue/virt-rescue.pod:178
 472 msgid "B<-v>"
 473 msgstr ""
 474
 475 #. type: =item
 476 #: ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263
 477 #: ../cat/virt-ls.pod:427 ../df/virt-df.pod:169 ../edit/virt-edit.pod:163
 478 #: ../fish/guestfish.pod:392 ../fuse/guestmount.pod:259
 479 #: ../inspector/virt-inspector.pod:121 ../rescue/virt-rescue.pod:180
 480 msgid "B<--verbose>"
 481 msgstr ""
 482
 483 #. type: textblock
 484 #: ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265
 485 #: ../cat/virt-ls.pod:429 ../df/virt-df.pod:171 ../edit/virt-edit.pod:165
 486 #: ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:182
 487 msgid "Enable verbose messages for debugging."
 488 msgstr ""
 489
 490 #. type: =item
 491 #: ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267
 492 #: ../cat/virt-ls.pod:431 ../df/virt-df.pod:173 ../edit/virt-edit.pod:167
 493 #: ../fish/guestfish.pod:397 ../fuse/guestmount.pod:263
 494 #: ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:184
 495 #: ../resize/virt-resize.pod:478
 496 msgid "B<-V>"
 497 msgstr ""
 498
 499 #. type: =item
 500 #: ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269
 501 #: ../cat/virt-ls.pod:433 ../df/virt-df.pod:175 ../edit/virt-edit.pod:169
 502 #: ../fish/guestfish.pod:399 ../fuse/guestmount.pod:265
 503 #: ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:186
 504 #: ../resize/virt-resize.pod:480 ../tools/virt-list-filesystems.pl:69
 505 #: ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169
 506 #: ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112
 507 msgid "B<--version>"
 508 msgstr ""
 509
 510 #. type: textblock
 511 #: ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271
 512 #: ../cat/virt-ls.pod:435 ../df/virt-df.pod:177 ../edit/virt-edit.pod:171
 513 #: ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:188
 514 #: ../resize/virt-resize.pod:482 ../tools/virt-list-filesystems.pl:71
 515 #: ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171
 516 #: ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114
 517 msgid "Display version number and exit."
 518 msgstr ""
 519
 520 #. type: =item
 521 #: ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281
 522 #: ../cat/virt-ls.pod:437 ../df/virt-df.pod:179 ../edit/virt-edit.pod:173
 523 #: ../fish/guestfish.pod:412 ../fuse/guestmount.pod:278
 524 #: ../inspector/virt-inspector.pod:131 ../rescue/virt-rescue.pod:199
 525 #: ../tools/virt-tar.pl:158
 526 msgid "B<-x>"
 527 msgstr ""
 528
 529 #. type: textblock
 530 #: ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283
 531 #: ../cat/virt-ls.pod:439 ../df/virt-df.pod:181 ../edit/virt-edit.pod:175
 532 #: ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:201
 533 msgid "Enable tracing of libguestfs API calls."
 534 msgstr ""
 535
 536 #. type: =head1
 537 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179
 538 #: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:205
 539 msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
 540 msgstr ""
 541
 542 #. type: textblock
 543 #: ../cat/virt-cat.pod:154
 544 msgid "Previous versions of virt-cat allowed you to write either:"
 545 msgstr ""
 546
 547 #. type: verbatim
 548 #: ../cat/virt-cat.pod:156
 549 #, no-wrap
 550 msgid ""
 551 " virt-cat disk.img [disk.img ...] file\n"
 552 "\n"
 553 msgstr ""
 554
 555 #. type: textblock
 556 #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185
 557 #: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:211
 558 msgid "or"
 559 msgstr ""
 560
 561 #. type: verbatim
 562 #: ../cat/virt-cat.pod:160
 563 #, no-wrap
 564 msgid ""
 565 " virt-cat guestname file\n"
 566 "\n"
 567 msgstr ""
 568
 569 #. type: textblock
 570 #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189
 571 #: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:215
 572 msgid ""
 573 "whereas in this version you should use I<-a> or I<-d> respectively to avoid "
 574 "the confusing case where a disk image might have the same name as a guest."
 575 msgstr ""
 576
 577 #. type: textblock
 578 #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193
 579 #: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:219
 580 msgid "For compatibility the old style is still supported."
 581 msgstr ""
 582
 583 #. type: =head1
 584 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297
 585 msgid "USING GUESTFISH"
 586 msgstr ""
 587
 588 #. type: textblock
 589 #: ../cat/virt-cat.pod:170
 590 msgid ""
 591 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
 592 "C<virt-cat> doesn't work."
 593 msgstr ""
 594
 595 #. type: textblock
 596 #: ../cat/virt-cat.pod:173
 597 msgid "Using C<virt-cat> is approximately equivalent to doing:"
 598 msgstr ""
 599
 600 #. type: verbatim
 601 #: ../cat/virt-cat.pod:175
 602 #, no-wrap
 603 msgid ""
 604 " guestfish --ro -i -d domname download file -\n"
 605 "\n"
 606 msgstr ""
 607
 608 #. type: textblock
 609 #: ../cat/virt-cat.pod:177
 610 msgid ""
 611 "where C<domname> is the name of the libvirt guest, and C<file> is the full "
 612 "path to the file.  Note the final C<-> (meaning \"output to stdout\")."
 613 msgstr ""
 614
 615 #. type: textblock
 616 #: ../cat/virt-cat.pod:181
 617 msgid ""
 618 "The command above uses libguestfs's guest inspection feature and so does not "
 619 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
 620 "disk images that don't contain guests.  To display a file from a disk image "
 621 "directly, use:"
 622 msgstr ""
 623
 624 #. type: verbatim
 625 #: ../cat/virt-cat.pod:186
 626 #, no-wrap
 627 msgid ""
 628 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
 629 "\n"
 630 msgstr ""
 631
 632 #. type: textblock
 633 #: ../cat/virt-cat.pod:188
 634 msgid ""
 635 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
 636 "the disk image to edit, and C<file> is the full path to the file."
 637 msgstr ""
 638
 639 #. type: =head1
 640 #: ../cat/virt-cat.pod:192 ../cat/virt-filesystems.pod:365
 641 #: ../cat/virt-ls.pod:483 ../df/virt-df.pod:209 ../edit/virt-edit.pod:342
 642 #: ../inspector/virt-inspector.pod:349 ../rescue/virt-rescue.pod:262
 643 #: ../resize/virt-resize.pod:543 ../tools/virt-list-filesystems.pl:188
 644 #: ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532
 645 #: ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733
 646 msgid "SHELL QUOTING"
 647 msgstr ""
 648
 649 #. type: textblock
 650 #: ../cat/virt-cat.pod:194 ../cat/virt-filesystems.pod:367
 651 #: ../cat/virt-ls.pod:485 ../df/virt-df.pod:211 ../edit/virt-edit.pod:344
 652 #: ../inspector/virt-inspector.pod:351 ../rescue/virt-rescue.pod:264
 653 #: ../resize/virt-resize.pod:545 ../tools/virt-list-filesystems.pl:190
 654 #: ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534
 655 #: ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741
 656 msgid ""
 657 "Libvirt guest names can contain arbitrary characters, some of which have "
 658 "meaning to the shell such as C<#> and space.  You may need to quote or "
 659 "escape these characters on the command line.  See the shell manual page L<sh"
 660 "(1)> for details."
 661 msgstr ""
 662
 663 #. type: =head1
 664 #: ../cat/virt-cat.pod:199 ../cat/virt-filesystems.pod:372
 665 #: ../cat/virt-ls.pod:490 ../df/virt-df.pod:216 ../edit/virt-edit.pod:349
 666 #: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
 667 #: ../fish/guestfish.pod:1214 ../fish/virt-copy-in.pod:50
 668 #: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
 669 #: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:303
 670 #: ../inspector/virt-inspector.pod:372 ../java/examples/guestfs-java.pod:45
 671 #: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
 672 #: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:284
 673 #: ../resize/virt-resize.pod:550 ../ruby/examples/guestfs-ruby.pod:36
 674 #: ../src/guestfs.pod:3016 ../test-tool/libguestfs-test-tool.pod:87
 675 #: ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265
 676 #: ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296
 677 #: ../tools/virt-win-reg.pl:746
 678 msgid "SEE ALSO"
 679 msgstr ""
 680
 681 #. type: textblock
 682 #: ../cat/virt-cat.pod:201
 683 msgid ""
 684 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
 685 "tar-out(1)>, L<http://libguestfs.org/>."
 686 msgstr ""
 687
 688 #. type: =head1
 689 #: ../cat/virt-cat.pod:208 ../cat/virt-filesystems.pod:383
 690 #: ../cat/virt-ls.pod:502 ../df/virt-df.pod:224 ../edit/virt-edit.pod:363
 691 #: ../rescue/virt-rescue.pod:292 ../resize/virt-resize.pod:571
 692 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277
 693 #: ../tools/virt-make-fs.pl:564 ../tools/virt-tar.pl:311
 694 #: ../tools/virt-win-reg.pl:772
 695 msgid "AUTHOR"
 696 msgstr ""
 697
 698 #. type: textblock
 699 #: ../cat/virt-cat.pod:210 ../cat/virt-filesystems.pod:385
 700 #: ../cat/virt-ls.pod:504 ../df/virt-df.pod:226 ../edit/virt-edit.pod:365
 701 #: ../inspector/virt-inspector.pod:386 ../rescue/virt-rescue.pod:294
 702 #: ../resize/virt-resize.pod:573 ../tools/virt-list-filesystems.pl:210
 703 #: ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:566
 704 #: ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:774
 705 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
 706 msgstr ""
 707
 708 #. type: =head1
 709 #: ../cat/virt-cat.pod:212 ../cat/virt-filesystems.pod:387
 710 #: ../cat/virt-ls.pod:506 ../df/virt-df.pod:228 ../edit/virt-edit.pod:367
 711 #: ../examples/guestfs-examples.pod:48 ../examples/guestfs-recipes.pod:400
 712 #: ../fish/guestfish.pod:1242 ../fish/virt-copy-in.pod:64
 713 #: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62
 714 #: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:318
 715 #: ../inspector/virt-inspector.pod:394 ../java/examples/guestfs-java.pod:61
 716 #: ../ocaml/examples/guestfs-ocaml.pod:94 ../perl/examples/guestfs-perl.pod:55
 717 #: ../python/examples/guestfs-python.pod:57 ../rescue/virt-rescue.pod:296
 718 #: ../resize/virt-resize.pod:575 ../ruby/examples/guestfs-ruby.pod:51
 719 #: ../src/guestfs.pod:3091 ../test-tool/libguestfs-test-tool.pod:97
 720 #: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
 721 #: ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315
 722 #: ../tools/virt-win-reg.pl:776
 723 msgid "COPYRIGHT"
 724 msgstr ""
 725
 726 #. type: textblock
 727 #: ../cat/virt-cat.pod:214 ../inspector/virt-inspector.pod:396
 728 #: ../resize/virt-resize.pod:577
 729 msgid "Copyright (C) 2010-2011 Red Hat Inc."
 730 msgstr ""
 731
 732 #. type: textblock
 733 #: ../cat/virt-cat.pod:216 ../cat/virt-filesystems.pod:391
 734 #: ../cat/virt-ls.pod:510 ../df/virt-df.pod:232 ../edit/virt-edit.pod:371
 735 #: ../fish/guestfish.pod:1247 ../fish/virt-copy-in.pod:69
 736 #: ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67
 737 #: ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:323
 738 #: ../inspector/virt-inspector.pod:398 ../rescue/virt-rescue.pod:300
 739 #: ../resize/virt-resize.pod:579 ../test-tool/libguestfs-test-tool.pod:102
 740 #: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285
 741 #: ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319
 742 #: ../tools/virt-win-reg.pl:780
 743 msgid ""
 744 "This program is free software; you can redistribute it and/or modify it "
 745 "under the terms of the GNU General Public License as published by the Free "
 746 "Software Foundation; either version 2 of the License, or (at your option) "
 747 "any later version."
 748 msgstr ""
 749
 750 #. type: textblock
 751 #: ../cat/virt-cat.pod:221 ../cat/virt-filesystems.pod:396
 752 #: ../cat/virt-ls.pod:515 ../df/virt-df.pod:237 ../edit/virt-edit.pod:376
 753 #: ../fish/guestfish.pod:1252 ../fish/virt-copy-in.pod:74
 754 #: ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72
 755 #: ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:328
 756 #: ../inspector/virt-inspector.pod:403 ../rescue/virt-rescue.pod:305
 757 #: ../resize/virt-resize.pod:584 ../test-tool/libguestfs-test-tool.pod:107
 758 #: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290
 759 #: ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324
 760 #: ../tools/virt-win-reg.pl:785
 761 msgid ""
 762 "This program is distributed in the hope that it will be useful, but WITHOUT "
 763 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
 764 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
 765 "more details."
 766 msgstr ""
 767
 768 #. type: textblock
 769 #: ../cat/virt-cat.pod:226 ../cat/virt-filesystems.pod:401
 770 #: ../cat/virt-ls.pod:520 ../df/virt-df.pod:242 ../edit/virt-edit.pod:381
 771 #: ../fish/guestfish.pod:1257 ../fish/virt-copy-in.pod:79
 772 #: ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77
 773 #: ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:333
 774 #: ../inspector/virt-inspector.pod:408 ../rescue/virt-rescue.pod:310
 775 #: ../resize/virt-resize.pod:589 ../test-tool/libguestfs-test-tool.pod:112
 776 #: ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295
 777 #: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329
 778 #: ../tools/virt-win-reg.pl:790
 779 msgid ""
 780 "You should have received a copy of the GNU General Public License along with "
 781 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
 782 "Ave, Cambridge, MA 02139, USA."
 783 msgstr ""
 784
 785 #. type: textblock
 786 #: ../cat/virt-filesystems.pod:5
 787 msgid ""
 788 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
 789 "virtual machine or disk image"
 790 msgstr ""
 791
 792 #. type: verbatim
 793 #: ../cat/virt-filesystems.pod:9
 794 #, no-wrap
 795 msgid ""
 796 " virt-filesystems [--options] -d domname\n"
 797 "\n"
 798 msgstr ""
 799
 800 #. type: verbatim
 801 #: ../cat/virt-filesystems.pod:11
 802 #, no-wrap
 803 msgid ""
 804 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
 805 "\n"
 806 msgstr ""
 807
 808 #. type: textblock
 809 #: ../cat/virt-filesystems.pod:15
 810 msgid ""
 811 "This tool allows you to discover filesystems, partitions, logical volumes, "
 812 "and their sizes in a disk image or virtual machine.  It is a replacement for "
 813 "L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
 814 msgstr ""
 815
 816 #. type: textblock
 817 #: ../cat/virt-filesystems.pod:20
 818 msgid ""
 819 "One use for this tool is from shell scripts to iterate over all filesystems "
 820 "from a disk image:"
 821 msgstr ""
 822
 823 #. type: verbatim
 824 #: ../cat/virt-filesystems.pod:23
 825 #, no-wrap
 826 msgid ""
 827 " for fs in $(virt-filesystems -a disk.img); do\n"
 828 "   # ...\n"
 829 " done\n"
 830 "\n"
 831 msgstr ""
 832
 833 #. type: textblock
 834 #: ../cat/virt-filesystems.pod:27
 835 msgid ""
 836 "Another use is to list partitions before using another tool to modify those "
 837 "partitions (such as L<virt-resize(1)>).  If you are curious about what an "
 838 "unknown disk image contains, use this tool along with L<virt-inspector(1)>."
 839 msgstr ""
 840
 841 #. type: textblock
 842 #: ../cat/virt-filesystems.pod:32
 843 msgid ""
 844 "Various command line options control what this program displays.  You need "
 845 "to give either I<-a> or I<-d> options to specify the disk image or libvirt "
 846 "guest respectively.  If you just specify that then the program shows "
 847 "filesystems found, one per line, like this:"
 848 msgstr ""
 849
 850 #. type: verbatim
 851 #: ../cat/virt-filesystems.pod:37
 852 #, no-wrap
 853 msgid ""
 854 " $ virt-filesystems -a disk.img\n"
 855 " /dev/sda1\n"
 856 " /dev/vg_guest/lv_root\n"
 857 "\n"
 858 msgstr ""
 859
 860 #. type: textblock
 861 #: ../cat/virt-filesystems.pod:41
 862 msgid ""
 863 "If you add I<-l> or I<--long> then the output includes extra information:"
 864 msgstr ""
 865
 866 #. type: verbatim
 867 #: ../cat/virt-filesystems.pod:44
 868 #, no-wrap
 869 msgid ""
 870 " $ virt-filesystems -a disk.img -l\n"
 871 " Name                   Type         VFS   Label  Size\n"
 872 " /dev/sda1              filesystem   ext4  boot   524288000\n"
 873 " /dev/vg_guest/lv_root  filesystem   ext4  root   10212081664\n"
 874 "\n"
 875 msgstr ""
 876
 877 #. type: textblock
 878 #: ../cat/virt-filesystems.pod:49
 879 msgid ""
 880 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
 881 "shown as well:"
 882 msgstr ""
 883
 884 #. type: verbatim
 885 #: ../cat/virt-filesystems.pod:52
 886 #, no-wrap
 887 msgid ""
 888 " $ virt-filesystems -a disk.img --extra\n"
 889 " /dev/sda1\n"
 890 " /dev/vg_guest/lv_root\n"
 891 " /dev/vg_guest/lv_swap\n"
 892 " /dev/vg_guest/lv_data\n"
 893 "\n"
 894 msgstr ""
 895
 896 #. type: textblock
 897 #: ../cat/virt-filesystems.pod:58
 898 msgid ""
 899 "If you add I<--partitions> then partitions are shown instead of filesystems:"
 900 msgstr ""
 901
 902 #. type: verbatim
 903 #: ../cat/virt-filesystems.pod:60
 904 #, no-wrap
 905 msgid ""
 906 " $ virt-filesystems -a disk.img --partitions\n"
 907 " /dev/sda1\n"
 908 " /dev/sda2\n"
 909 "\n"
 910 msgstr ""
 911
 912 #. type: textblock
 913 #: ../cat/virt-filesystems.pod:64
 914 msgid ""
 915 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-"
 916 "volumes>, I<--block-devices> to list those items."
 917 msgstr ""
 918
 919 #. type: textblock
 920 #: ../cat/virt-filesystems.pod:67
 921 msgid ""
 922 "You can use these options in combination as well (if you want a combination "
 923 "including filesystems, you have to add I<--filesystems>).  Notice that some "
 924 "items fall into several categories (eg. C</dev/sda1> might be both a "
 925 "partition and a filesystem).  These items are listed several times.  To get "
 926 "a list which includes absolutely everything that virt-filesystems knows "
 927 "about, use the I<--all> option."
 928 msgstr ""
 929
 930 #. type: textblock
 931 #: ../cat/virt-filesystems.pod:74
 932 msgid ""
 933 "UUIDs (because they are quite long) are not shown by default.  Add the I<--"
 934 "uuid> option to display device and filesystem UUIDs in the long output."
 935 msgstr ""
 936
 937 #. type: textblock
 938 #: ../cat/virt-filesystems.pod:78
 939 msgid ""
 940 "I<--all --long --uuid> is a useful combination to display all possible "
 941 "information about everything."
 942 msgstr ""
 943
 944 #. type: verbatim
 945 #: ../cat/virt-filesystems.pod:81
 946 #, no-wrap
 947 msgid ""
 948 " $ virt-filesystems -a win.img --all --long --uuid -h\n"
 949 " Name      Type       VFS  Label           Size Parent   UUID\n"
 950 " /dev/sda1 filesystem ntfs System Reserved 100M -        F81C92571C92112C\n"
 951 " /dev/sda2 filesystem ntfs -               20G  -        F2E8996AE8992E3B\n"
 952 " /dev/sda1 partition  -    -               100M /dev/sda -\n"
 953 " /dev/sda2 partition  -    -               20G  /dev/sda -\n"
 954 " /dev/sda  device     -    -               20G  -        -\n"
 955 "\n"
 956 msgstr ""
 957
 958 #. type: textblock
 959 #: ../cat/virt-filesystems.pod:89
 960 msgid ""
 961 "For machine-readable output, use I<--csv> to get Comma-Separated Values."
 962 msgstr ""
 963
 964 #. type: =item
 965 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
 966 msgid "B<--all>"
 967 msgstr ""
 968
 969 #. type: textblock
 970 #: ../cat/virt-filesystems.pod:112
 971 msgid ""
 972 "Display everything.  This is currently the same as specifying these options: "
 973 "I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, I<--"
 974 "logical-volumes>, I<--volume-groups>, I<--physical-volumes>.  (More may be "
 975 "added to this list in future)."
 976 msgstr ""
 977
 978 #. type: textblock
 979 #: ../cat/virt-filesystems.pod:117
 980 msgid "See also I<--long>."
 981 msgstr ""
 982
 983 #. type: =item
 984 #: ../cat/virt-filesystems.pod:119
 985 msgid "B<--blkdevs>"
 986 msgstr ""
 987
 988 #. type: =item
 989 #: ../cat/virt-filesystems.pod:121
 990 msgid "B<--block-devices>"
 991 msgstr ""
 992
 993 #. type: textblock
 994 #: ../cat/virt-filesystems.pod:123
 995 msgid "Display block devices."
 996 msgstr ""
 997
 998 #. type: =item
 999 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301
1000 msgid "B<--csv>"
1001 msgstr ""
1002
1003 #. type: textblock
1004 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303
1005 msgid ""
1006 "Write out the results in CSV format (comma-separated values).  This format "
1007 "can be imported easily into databases and spreadsheets, but read L</NOTE "
1008 "ABOUT CSV FORMAT> below."
1009 msgstr ""
1010
1011 #. type: textblock
1012 #: ../cat/virt-filesystems.pod:150
1013 msgid ""
1014 "When prompting for keys and passphrases, virt-filesystems normally turns "
1015 "echoing off so you cannot see what you are typing.  If you are not worried "
1016 "about Tempest attacks and there is no one else in the room you can specify "
1017 "this flag to see what you are typing."
1018 msgstr ""
1019
1020 #. type: =item
1021 #: ../cat/virt-filesystems.pod:155
1022 msgid "B<--extra>"
1023 msgstr ""
1024
1025 #. type: textblock
1026 #: ../cat/virt-filesystems.pod:157
1027 msgid ""
1028 "This causes filesystems that are not ordinary, mountable filesystems to be "
1029 "displayed.  This category includes swapspace, and filesystems that are empty "
1030 "or contain unknown data."
1031 msgstr ""
1032
1033 #. type: textblock
1034 #: ../cat/virt-filesystems.pod:161
1035 msgid "This option implies I<--filesystems>."
1036 msgstr ""
1037
1038 #. type: =item
1039 #: ../cat/virt-filesystems.pod:163
1040 msgid "B<--filesystems>"
1041 msgstr ""
1042
1043 #. type: textblock
1044 #: ../cat/virt-filesystems.pod:165
1045 msgid ""
1046 "Display mountable filesystems.  If no display option was selected then this "
1047 "option is implied."
1048 msgstr ""
1049
1050 #. type: textblock
1051 #: ../cat/virt-filesystems.pod:168
1052 msgid "With I<--extra>, non-mountable filesystems are shown too."
1053 msgstr ""
1054
1055 #. type: verbatim
1056 #: ../cat/virt-filesystems.pod:181
1057 #, no-wrap
1058 msgid ""
1059 " virt-filesystems --format=raw -a disk.img\n"
1060 "\n"
1061 msgstr ""
1062
1063 #. type: verbatim
1064 #: ../cat/virt-filesystems.pod:185
1065 #, no-wrap
1066 msgid ""
1067 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1068 "\n"
1069 msgstr ""
1070
1071 #. type: =item
1072 #: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352
1073 #: ../df/virt-df.pod:119 ../fish/guestfish.pod:156
1074 #: ../tools/virt-list-partitions.pl:109
1075 msgid "B<-h>"
1076 msgstr ""
1077
1078 #. type: =item
1079 #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354
1080 #: ../df/virt-df.pod:121 ../tools/virt-list-partitions.pl:111
1081 msgid "B<--human-readable>"
1082 msgstr ""
1083
1084 #. type: textblock
1085 #: ../cat/virt-filesystems.pod:198
1086 msgid "In I<--long> mode, display sizes in human-readable format."
1087 msgstr ""
1088
1089 #. type: =item
1090 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366
1091 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1092 msgid "B<-l>"
1093 msgstr ""
1094
1095 #. type: =item
1096 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
1097 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1098 msgid "B<--long>"
1099 msgstr ""
1100
1101 #. type: textblock
1102 #: ../cat/virt-filesystems.pod:209
1103 msgid "Display extra columns of data (\"long format\")."
1104 msgstr ""
1105
1106 #. type: textblock
1107 #: ../cat/virt-filesystems.pod:211
1108 msgid "A title row is added unless you also specify I<--no-title>."
1109 msgstr ""
1110
1111 #. type: textblock
1112 #: ../cat/virt-filesystems.pod:213
1113 msgid ""
1114 "The extra columns displayed depend on what output you select, and the "
1115 "ordering of columns may change in future versions.  Use the title row, I<--"
1116 "csv> output and/or L<csvtool(1)> to match columns to data in external "
1117 "programs."
1118 msgstr ""
1119
1120 #. type: textblock
1121 #: ../cat/virt-filesystems.pod:218
1122 msgid ""
1123 "Use I<-h> if you want sizes to be displayed in human-readable format.  The "
1124 "default is to show raw numbers of I<bytes>."
1125 msgstr ""
1126
1127 #. type: textblock
1128 #: ../cat/virt-filesystems.pod:221
1129 msgid "Use I<--uuid> to display UUIDs too."
1130 msgstr ""
1131
1132 #. type: =item
1133 #: ../cat/virt-filesystems.pod:223
1134 msgid "B<--lvs>"
1135 msgstr ""
1136
1137 #. type: =item
1138 #: ../cat/virt-filesystems.pod:225
1139 msgid "B<--logvols>"
1140 msgstr ""
1141
1142 #. type: =item
1143 #: ../cat/virt-filesystems.pod:227
1144 msgid "B<--logical-volumes>"
1145 msgstr ""
1146
1147 #. type: textblock
1148 #: ../cat/virt-filesystems.pod:229
1149 msgid ""
1150 "Display LVM logical volumes.  In this mode, these are displayed irrespective "
1151 "of whether the LVs contain filesystems."
1152 msgstr ""
1153
1154 #. type: =item
1155 #: ../cat/virt-filesystems.pod:232
1156 msgid "B<--no-title>"
1157 msgstr ""
1158
1159 #. type: textblock
1160 #: ../cat/virt-filesystems.pod:234
1161 msgid "In I<--long> mode, don't add a title row."
1162 msgstr ""
1163
1164 #. type: textblock
1165 #: ../cat/virt-filesystems.pod:236
1166 msgid ""
1167 "Note that the order of the columns is not fixed, and may change in future "
1168 "versions of virt-filesystems, so using this option may give you unexpected "
1169 "surprises."
1170 msgstr ""
1171
1172 #. type: =item
1173 #: ../cat/virt-filesystems.pod:240
1174 msgid "B<--parts>"
1175 msgstr ""
1176
1177 #. type: =item
1178 #: ../cat/virt-filesystems.pod:242
1179 msgid "B<--partitions>"
1180 msgstr ""
1181
1182 #. type: textblock
1183 #: ../cat/virt-filesystems.pod:244
1184 msgid ""
1185 "Display partitions.  In this mode, these are displayed irrespective of "
1186 "whether the partitions contain filesystems."
1187 msgstr ""
1188
1189 #. type: =item
1190 #: ../cat/virt-filesystems.pod:247
1191 msgid "B<--pvs>"
1192 msgstr ""
1193
1194 #. type: =item
1195 #: ../cat/virt-filesystems.pod:249
1196 msgid "B<--physvols>"
1197 msgstr ""
1198
1199 #. type: =item
1200 #: ../cat/virt-filesystems.pod:251
1201 msgid "B<--physical-volumes>"
1202 msgstr ""
1203
1204 #. type: textblock
1205 #: ../cat/virt-filesystems.pod:253
1206 msgid "Display LVM physical volumes."
1207 msgstr ""
1208
1209 #. type: =item
1210 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:157
1211 msgid "B<--uuid>"
1212 msgstr ""
1213
1214 #. type: =item
1215 #: ../cat/virt-filesystems.pod:257
1216 msgid "B<--uuids>"
1217 msgstr ""
1218
1219 #. type: textblock
1220 #: ../cat/virt-filesystems.pod:259
1221 msgid "In I<--long> mode, display UUIDs as well."
1222 msgstr ""
1223
1224 #. type: =item
1225 #: ../cat/virt-filesystems.pod:273
1226 msgid "B<--vgs>"
1227 msgstr ""
1228
1229 #. type: =item
1230 #: ../cat/virt-filesystems.pod:275
1231 msgid "B<--volgroups>"
1232 msgstr ""
1233
1234 #. type: =item
1235 #: ../cat/virt-filesystems.pod:277
1236 msgid "B<--volume-groups>"
1237 msgstr ""
1238
1239 #. type: textblock
1240 #: ../cat/virt-filesystems.pod:279
1241 msgid "Display LVM volume groups."
1242 msgstr ""
1243
1244 #. type: =head1
1245 #: ../cat/virt-filesystems.pod:287
1246 msgid "COLUMNS"
1247 msgstr ""
1248
1249 #. type: textblock
1250 #: ../cat/virt-filesystems.pod:289
1251 msgid ""
1252 "Note that columns in the output are subject to reordering and change in "
1253 "future versions of this tool."
1254 msgstr ""
1255
1256 #. type: =item
1257 #: ../cat/virt-filesystems.pod:294
1258 msgid "B<Name>"
1259 msgstr ""
1260
1261 #. type: textblock
1262 #: ../cat/virt-filesystems.pod:296
1263 msgid "The filesystem, partition, block device or LVM name."
1264 msgstr ""
1265
1266 #. type: textblock
1267 #: ../cat/virt-filesystems.pod:298
1268 msgid ""
1269 "For device and partition names these are displayed as canonical libguestfs "
1270 "names, so that for example C</dev/sda2> is the second partition on the first "
1271 "device."
1272 msgstr ""
1273
1274 #. type: textblock
1275 #: ../cat/virt-filesystems.pod:302
1276 msgid ""
1277 "If the I<--long> option is B<not> specified, then only the name column is "
1278 "shown in the output."
1279 msgstr ""
1280
1281 #. type: =item
1282 #: ../cat/virt-filesystems.pod:305
1283 msgid "B<Type>"
1284 msgstr ""
1285
1286 #. type: textblock
1287 #: ../cat/virt-filesystems.pod:307
1288 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
1289 msgstr ""
1290
1291 #. type: =item
1292 #: ../cat/virt-filesystems.pod:309
1293 msgid "B<VFS>"
1294 msgstr ""
1295
1296 #. type: textblock
1297 #: ../cat/virt-filesystems.pod:311
1298 msgid ""
1299 "If there is a filesystem, then this column displays the filesystem type if "
1300 "one could be detected, eg. C<ext4>."
1301 msgstr ""
1302
1303 #. type: =item
1304 #: ../cat/virt-filesystems.pod:314
1305 msgid "B<Label>"
1306 msgstr ""
1307
1308 #. type: textblock
1309 #: ../cat/virt-filesystems.pod:316
1310 msgid ""
1311 "If the object has a label (used for identifying and mounting filesystems) "
1312 "then this column contains the label."
1313 msgstr ""
1314
1315 #. type: =item
1316 #: ../cat/virt-filesystems.pod:319
1317 msgid "B<Size>"
1318 msgstr ""
1319
1320 #. type: textblock
1321 #: ../cat/virt-filesystems.pod:321
1322 msgid ""
1323 "The size of the object in bytes.  If the I<--human> option is used then the "
1324 "size is displayed in a human-readable form."
1325 msgstr ""
1326
1327 #. type: =item
1328 #: ../cat/virt-filesystems.pod:324
1329 msgid "B<Parent>"
1330 msgstr ""
1331
1332 #. type: textblock
1333 #: ../cat/virt-filesystems.pod:326
1334 msgid ""
1335 "The parent column records the parent relationship between objects.  For "
1336 "example, if the object is a partition, then this column contains the name of "
1337 "the containing device.  If the object is a logical volume, then this column "
1338 "is the name of the volume group."
1339 msgstr ""
1340
1341 #. type: =item
1342 #: ../cat/virt-filesystems.pod:331
1343 msgid "B<UUID>"
1344 msgstr ""
1345
1346 #. type: textblock
1347 #: ../cat/virt-filesystems.pod:333
1348 msgid ""
1349 "If the object has a UUID (used for identifying and mounting filesystems and "
1350 "block devices) then this column contains the UUID as a string."
1351 msgstr ""
1352
1353 #. type: textblock
1354 #: ../cat/virt-filesystems.pod:337
1355 msgid "The UUID is only displayed if the I<--uuid> option is given."
1356 msgstr ""
1357
1358 #. type: =head1
1359 #: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459
1360 #: ../df/virt-df.pod:185
1361 msgid "NOTE ABOUT CSV FORMAT"
1362 msgstr ""
1363
1364 #. type: textblock
1365 #: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461
1366 #: ../df/virt-df.pod:187
1367 msgid ""
1368 "Comma-separated values (CSV) is a deceptive format.  It I<seems> like it "
1369 "should be easy to parse, but it is definitely not easy to parse."
1370 msgstr ""
1371
1372 #. type: textblock
1373 #: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464
1374 #: ../df/virt-df.pod:190
1375 msgid ""
1376 "Myth: Just split fields at commas.  Reality: This does I<not> work "
1377 "reliably.  This example has two columns:"
1378 msgstr ""
1379
1380 #. type: verbatim
1381 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467
1382 #: ../df/virt-df.pod:193
1383 #, no-wrap
1384 msgid ""
1385 " \"foo,bar\",baz\n"
1386 "\n"
1387 msgstr ""
1388
1389 #. type: textblock
1390 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469
1391 #: ../df/virt-df.pod:195
1392 msgid ""
1393 "Myth: Read the file one line at a time.  Reality: This does I<not> work "
1394 "reliably.  This example has one row:"
1395 msgstr ""
1396
1397 #. type: verbatim
1398 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472
1399 #: ../df/virt-df.pod:198
1400 #, no-wrap
1401 msgid ""
1402 " \"foo\n"
1403 " bar\",baz\n"
1404 "\n"
1405 msgstr ""
1406
1407 #. type: textblock
1408 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475
1409 #: ../df/virt-df.pod:201
1410 msgid ""
1411 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
1412 "packaged in major Linux distributions)."
1413 msgstr ""
1414
1415 #. type: textblock
1416 #: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478
1417 #: ../df/virt-df.pod:204
1418 msgid ""
1419 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
1420 "or Python's built-in csv library)."
1421 msgstr ""
1422
1423 #. type: textblock
1424 #: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481
1425 #: ../df/virt-df.pod:207
1426 msgid "Most spreadsheets and databases can import CSV directly."
1427 msgstr ""
1428
1429 #. type: textblock
1430 #: ../cat/virt-filesystems.pod:374
1431 msgid ""
1432 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
1433 "filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
1434 "libguestfs.org/>."
1435 msgstr ""
1436
1437 #. type: textblock
1438 #: ../cat/virt-filesystems.pod:389 ../tools/virt-make-fs.pl:570
1439 #: ../tools/virt-win-reg.pl:778
1440 msgid "Copyright (C) 2010 Red Hat Inc."
1441 msgstr ""
1442
1443 #. type: textblock
1444 #: ../cat/virt-ls.pod:5
1445 msgid "virt-ls - List files in a virtual machine"
1446 msgstr ""
1447
1448 #. type: verbatim
1449 #: ../cat/virt-ls.pod:9
1450 #, no-wrap
1451 msgid ""
1452 " virt-ls [--options] -d domname directory [directory ...]\n"
1453 "\n"
1454 msgstr ""
1455
1456 #. type: verbatim
1457 #: ../cat/virt-ls.pod:11
1458 #, no-wrap
1459 msgid ""
1460 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
1461 "\n"
1462 msgstr ""
1463
1464 #. type: textblock
1465 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13
1466 msgid "Old style:"
1467 msgstr ""
1468
1469 #. type: verbatim
1470 #: ../cat/virt-ls.pod:15
1471 #, no-wrap
1472 msgid ""
1473 " virt-ls [--options] domname directory\n"
1474 "\n"
1475 msgstr ""
1476
1477 #. type: verbatim
1478 #: ../cat/virt-ls.pod:17
1479 #, no-wrap
1480 msgid ""
1481 " virt-ls [--options] disk.img [disk.img ...] directory\n"
1482 "\n"
1483 msgstr ""
1484
1485 #. type: textblock
1486 #: ../cat/virt-ls.pod:21
1487 msgid ""
1488 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
1489 "more from a virtual machine or disk image."
1490 msgstr ""
1491
1492 #. type: textblock
1493 #: ../cat/virt-ls.pod:24
1494 msgid ""
1495 "Multiple directory names can be given, in which case the output from each is "
1496 "concatenated."
1497 msgstr ""
1498
1499 #. type: textblock
1500 #: ../cat/virt-ls.pod:27
1501 msgid ""
1502 "To list directories from a libvirt guest use the I<-d> option to specify the "
1503 "name of the guest.  For a disk image, use the I<-a> option."
1504 msgstr ""
1505
1506 #. type: textblock
1507 #: ../cat/virt-ls.pod:31
1508 msgid ""
1509 "C<virt-ls> can do many simple file listings.  For more complicated cases you "
1510 "may need to use L<guestfish(1)>, or write a program directly to the L<guestfs"
1511 "(3)> API."
1512 msgstr ""
1513
1514 #. type: textblock
1515 #: ../cat/virt-ls.pod:37
1516 msgid "Get a list of all files and directories in a virtual machine:"
1517 msgstr ""
1518
1519 #. type: verbatim
1520 #: ../cat/virt-ls.pod:39
1521 #, no-wrap
1522 msgid ""
1523 " virt-ls -R -d guest /\n"
1524 "\n"
1525 msgstr ""
1526
1527 #. type: textblock
1528 #: ../cat/virt-ls.pod:41
1529 msgid "List all setuid or setgid programs in a Linux virtual machine:"
1530 msgstr ""
1531
1532 #. type: verbatim
1533 #: ../cat/virt-ls.pod:43
1534 #, no-wrap
1535 msgid ""
1536 " virt-ls -lR -d guest / | grep '^- [42]'\n"
1537 "\n"
1538 msgstr ""
1539
1540 #. type: textblock
1541 #: ../cat/virt-ls.pod:45
1542 msgid "List all public-writable directories in a Linux virtual machine:"
1543 msgstr ""
1544
1545 #. type: verbatim
1546 #: ../cat/virt-ls.pod:47
1547 #, no-wrap
1548 msgid ""
1549 " virt-ls -lR -d guest / | grep '^d ...7'\n"
1550 "\n"
1551 msgstr ""
1552
1553 #. type: textblock
1554 #: ../cat/virt-ls.pod:49
1555 msgid "List all Unix domain sockets in a Linux virtual machine:"
1556 msgstr ""
1557
1558 #. type: verbatim
1559 #: ../cat/virt-ls.pod:51
1560 #, no-wrap
1561 msgid ""
1562 " virt-ls -lR -d guest / | grep '^s'\n"
1563 "\n"
1564 msgstr ""
1565
1566 #. type: textblock
1567 #: ../cat/virt-ls.pod:53
1568 msgid "List all regular files with filenames ending in '.png':"
1569 msgstr ""
1570
1571 #. type: verbatim
1572 #: ../cat/virt-ls.pod:55
1573 #, no-wrap
1574 msgid ""
1575 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
1576 "\n"
1577 msgstr ""
1578
1579 #. type: textblock
1580 #: ../cat/virt-ls.pod:57
1581 msgid "To display files larger than 10MB in home directories:"
1582 msgstr ""
1583
1584 #. type: verbatim
1585 #: ../cat/virt-ls.pod:59
1586 #, no-wrap
1587 msgid ""
1588 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
1589 "\n"
1590 msgstr ""
1591
1592 #. type: textblock
1593 #: ../cat/virt-ls.pod:61
1594 msgid "Find everything modified in the last 7 days:"
1595 msgstr ""
1596
1597 #. type: verbatim
1598 #: ../cat/virt-ls.pod:63
1599 #, no-wrap
1600 msgid ""
1601 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
1602 "\n"
1603 msgstr ""
1604
1605 #. type: textblock
1606 #: ../cat/virt-ls.pod:65
1607 msgid "Find regular files modified in the last 24 hours:"
1608 msgstr ""
1609
1610 #. type: verbatim
1611 #: ../cat/virt-ls.pod:67
1612 #, no-wrap
1613 msgid ""
1614 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
1615 "\n"
1616 msgstr ""
1617
1618 #. type: =head2
1619 #: ../cat/virt-ls.pod:69
1620 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
1621 msgstr ""
1622
1623 #. type: textblock
1624 #: ../cat/virt-ls.pod:71
1625 msgid ""
1626 "Find the differences between files in a guest and an earlier snapshot of the "
1627 "same guest."
1628 msgstr ""
1629
1630 #. type: verbatim
1631 #: ../cat/virt-ls.pod:74
1632 #, no-wrap
1633 msgid ""
1634 " virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
1635 " virt-ls -lR -a current.img / --uids --time-t > new\n"
1636 " diff -u old new | less\n"
1637 "\n"
1638 msgstr ""
1639
1640 #. type: textblock
1641 #: ../cat/virt-ls.pod:78
1642 msgid ""
1643 "The commands above won't find files where the content has changed but the "
1644 "metadata (eg. file size and modification date) is the same.  To do that, you "
1645 "need to add the I<--checksum> parameter to both C<virt-ls> commands.  I<--"
1646 "checksum> can be quite slow since it has to read and compute a checksum of "
1647 "every regular file in the virtual machine."
1648 msgstr ""
1649
1650 #. type: =head1
1651 #: ../cat/virt-ls.pod:84
1652 msgid "OUTPUT MODES"
1653 msgstr ""
1654
1655 #. type: textblock
1656 #: ../cat/virt-ls.pod:86
1657 msgid ""
1658 "C<virt-ls> has four output modes, controlled by different combinations of "
1659 "the I<-l> and I<-R> options."
1660 msgstr ""
1661
1662 #. type: =head2
1663 #: ../cat/virt-ls.pod:89
1664 msgid "SIMPLE LISTING"
1665 msgstr ""
1666
1667 #. type: textblock
1668 #: ../cat/virt-ls.pod:91
1669 msgid "A simple listing is like the ordinary L<ls(1)> command:"
1670 msgstr ""
1671
1672 #. type: verbatim
1673 #: ../cat/virt-ls.pod:93
1674 #, no-wrap
1675 msgid ""
1676 " $ virt-ls -d guest /\n"
1677 " bin\n"
1678 " boot\n"
1679 " [etc.]\n"
1680 "\n"
1681 msgstr ""
1682
1683 #. type: =head2
1684 #: ../cat/virt-ls.pod:98
1685 msgid "LONG LISTING"
1686 msgstr ""
1687
1688 #. type: textblock
1689 #: ../cat/virt-ls.pod:100
1690 msgid ""
1691 "With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
1692 "(more specifically, like the C<guestfs_ll> function)."
1693 msgstr ""
1694
1695 #. type: verbatim
1696 #: ../cat/virt-ls.pod:103
1697 #, no-wrap
1698 msgid ""
1699 " $ virt-ls -l -d guest /\n"
1700 " total 204\n"
1701 " dr-xr-xr-x.   2 root root   4096 2009-08-25 19:06 bin\n"
1702 " dr-xr-xr-x.   5 root root   3072 2009-08-25 19:06 boot\n"
1703 " [etc.]\n"
1704 "\n"
1705 msgstr ""
1706
1707 #. type: textblock
1708 #: ../cat/virt-ls.pod:109
1709 msgid ""
1710 "Note that while this is useful for displaying a directory, do not try "
1711 "parsing this output in another program.  Use L</RECURSIVE LONG LISTING> "
1712 "instead."
1713 msgstr ""
1714
1715 #. type: =head2
1716 #: ../cat/virt-ls.pod:113
1717 msgid "RECURSIVE LISTING"
1718 msgstr ""
1719
1720 #. type: textblock
1721 #: ../cat/virt-ls.pod:115
1722 msgid ""
1723 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
1724 "and directories recursively:"
1725 msgstr ""
1726
1727 #. type: verbatim
1728 #: ../cat/virt-ls.pod:118
1729 #, no-wrap
1730 msgid ""
1731 " $ virt-ls -R -d guest /tmp\n"
1732 " foo\n"
1733 " foo/bar\n"
1734 " [etc.]\n"
1735 "\n"
1736 msgstr ""
1737
1738 #. type: textblock
1739 #: ../cat/virt-ls.pod:123
1740 msgid ""
1741 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
1742 "converts C<\\0> characters to C<\\n>."
1743 msgstr ""
1744
1745 #. type: =head2
1746 #: ../cat/virt-ls.pod:126
1747 msgid "RECURSIVE LONG LISTING"
1748 msgstr ""
1749
1750 #. type: textblock
1751 #: ../cat/virt-ls.pod:128
1752 msgid ""
1753 "Using I<-lR> options together changes the output to display directories "
1754 "recursively, with file stats, and optionally other features such as "
1755 "checksums and extended attributes."
1756 msgstr ""
1757
1758 #. type: textblock
1759 #: ../cat/virt-ls.pod:132
1760 msgid ""
1761 "Most of the interesting features of C<virt-ls> are only available when using "
1762 "I<-lR> mode."
1763 msgstr ""
1764
1765 #. type: textblock
1766 #: ../cat/virt-ls.pod:135
1767 msgid ""
1768 "The fields are normally space-separated.  Filenames are B<not> quoted, so "
1769 "you cannot use the output in another program (because filenames can contain "
1770 "spaces and other unsafe characters).  If the guest was untrusted and someone "
1771 "knew you were using C<virt-ls> to analyze the guest, they could play tricks "
1772 "on you by creating filenames with embedded newline characters.  To B<safely> "
1773 "parse the output in another program, use the I<--csv> (Comma-Separated "
1774 "Values) option."
1775 msgstr ""
1776
1777 #. type: textblock
1778 #: ../cat/virt-ls.pod:143
1779 msgid ""
1780 "Note that this output format is completely unrelated to the C<ls -lR> "
1781 "command."
1782 msgstr ""
1783
1784 #. type: verbatim
1785 #: ../cat/virt-ls.pod:146
1786 #, no-wrap
1787 msgid ""
1788 " $ virt-ls -lR -d guest /bin\n"
1789 " d 0555       4096 /bin\n"
1790 " - 0755        123 /bin/alsaunmute\n"
1791 " - 0755      28328 /bin/arch\n"
1792 " l 0777          4 /bin/awk -> gawk\n"
1793 " - 0755      27216 /bin/basename\n"
1794 " - 0755     943360 /bin/bash\n"
1795 " [etc.]\n"
1796 "\n"
1797 msgstr ""
1798
1799 #. type: textblock
1800 #: ../cat/virt-ls.pod:155
1801 msgid "These basic fields are always shown:"
1802 msgstr ""
1803
1804 #. type: =item
1805 #: ../cat/virt-ls.pod:159
1806 msgid "type"
1807 msgstr ""
1808
1809 #. type: textblock
1810 #: ../cat/virt-ls.pod:161
1811 msgid ""
1812 "The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
1813 "(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
1814 "link), C<s> (socket) or C<u> (unknown)."
1815 msgstr ""
1816
1817 #. type: =item
1818 #: ../cat/virt-ls.pod:171
1819 msgid "permissions"
1820 msgstr ""
1821
1822 #. type: textblock
1823 #: ../cat/virt-ls.pod:173
1824 msgid "The Unix permissions, displayed as a 4 digit octal number."
1825 msgstr ""
1826
1827 #. type: =item
1828 #: ../cat/virt-ls.pod:175
1829 msgid "size"
1830 msgstr ""
1831
1832 #. type: textblock
1833 #: ../cat/virt-ls.pod:177
1834 msgid ""
1835 "The size of the file.  This is shown in bytes unless I<-h> or I<--human-"
1836 "readable> option is given, in which case this is shown as a human-readable "
1837 "number."
1838 msgstr ""
1839
1840 #. type: =head2
1841 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4183
1842 msgid "path"
1843 msgstr ""
1844
1845 #. type: textblock
1846 #: ../cat/virt-ls.pod:183
1847 msgid "The full path of the file or directory."
1848 msgstr ""
1849
1850 #. type: =item
1851 #: ../cat/virt-ls.pod:185
1852 msgid "link"
1853 msgstr ""
1854
1855 #. type: textblock
1856 #: ../cat/virt-ls.pod:187
1857 msgid "For symbolic links only, the link target."
1858 msgstr ""
1859
1860 #. type: textblock
1861 #: ../cat/virt-ls.pod:191
1862 msgid ""
1863 "In I<-lR> mode, additional command line options enable the display of more "
1864 "fields."
1865 msgstr ""
1866
1867 #. type: textblock
1868 #: ../cat/virt-ls.pod:194
1869 msgid ""
1870 "With the I<--uids> flag, these additional fields are displayed before the "
1871 "path:"
1872 msgstr ""
1873
1874 #. type: =item
1875 #: ../cat/virt-ls.pod:199
1876 msgid "uid"
1877 msgstr ""
1878
1879 #. type: =item
1880 #: ../cat/virt-ls.pod:201
1881 msgid "gid"
1882 msgstr ""
1883
1884 #. type: textblock
1885 #: ../cat/virt-ls.pod:203
1886 msgid ""
1887 "The UID and GID of the owner of the file (displayed numerically).  Note "
1888 "these only make sense in the context of a Unix-like guest."
1889 msgstr ""
1890
1891 #. type: textblock
1892 #: ../cat/virt-ls.pod:208
1893 msgid "With the I<--times> flag, these additional fields are displayed:"
1894 msgstr ""
1895
1896 #. type: =item
1897 #: ../cat/virt-ls.pod:212
1898 msgid "atime"
1899 msgstr ""
1900
1901 #. type: textblock
1902 #: ../cat/virt-ls.pod:214
1903 msgid "The time of last access."
1904 msgstr ""
1905
1906 #. type: =item
1907 #: ../cat/virt-ls.pod:216
1908 msgid "mtime"
1909 msgstr ""
1910
1911 #. type: textblock
1912 #: ../cat/virt-ls.pod:218
1913 msgid "The time of last modification."
1914 msgstr ""
1915
1916 #. type: =item
1917 #: ../cat/virt-ls.pod:220
1918 msgid "ctime"
1919 msgstr ""
1920
1921 #. type: textblock
1922 #: ../cat/virt-ls.pod:222
1923 msgid "The time of last status change."
1924 msgstr ""
1925
1926 #. type: textblock
1927 #: ../cat/virt-ls.pod:226
1928 msgid ""
1929 "The time fields are displayed as string dates and times, unless one of the "
1930 "I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
1931 msgstr ""
1932
1933 #. type: textblock
1934 #: ../cat/virt-ls.pod:229
1935 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
1936 msgstr ""
1937
1938 #. type: =item
1939 #: ../cat/virt-ls.pod:233
1940 msgid "device"
1941 msgstr ""
1942
1943 #. type: textblock
1944 #: ../cat/virt-ls.pod:235
1945 msgid ""
1946 "The device containing the file (displayed as major:minor).  This may not "
1947 "match devices as known to the guest."
1948 msgstr ""
1949
1950 #. type: =item
1951 #: ../cat/virt-ls.pod:238
1952 msgid "inode"
1953 msgstr ""
1954
1955 #. type: textblock
1956 #: ../cat/virt-ls.pod:240
1957 msgid "The inode number."
1958 msgstr ""
1959
1960 #. type: =item
1961 #: ../cat/virt-ls.pod:242
1962 msgid "nlink"
1963 msgstr ""
1964
1965 #. type: textblock
1966 #: ../cat/virt-ls.pod:244
1967 msgid "The number of hard links."
1968 msgstr ""
1969
1970 #. type: =item
1971 #: ../cat/virt-ls.pod:246
1972 msgid "rdev"
1973 msgstr ""
1974
1975 #. type: textblock
1976 #: ../cat/virt-ls.pod:248
1977 msgid ""
1978 "For block and char special files, the device (displayed as major:minor)."
1979 msgstr ""
1980
1981 #. type: =item
1982 #: ../cat/virt-ls.pod:251
1983 msgid "blocks"
1984 msgstr ""
1985
1986 #. type: textblock
1987 #: ../cat/virt-ls.pod:253
1988 msgid "The number of 512 byte blocks allocated to the file."
1989 msgstr ""
1990
1991 #. type: textblock
1992 #: ../cat/virt-ls.pod:257
1993 msgid ""
1994 "With the I<--checksum> flag, the checksum of the file contents is shown "
1995 "(only for regular files).  Computing file checksums can take a considerable "
1996 "amount of time."
1997 msgstr ""
1998
1999 #. type: =item
2000 #: ../cat/virt-ls.pod:280
2001 msgid "B<--checksum>"
2002 msgstr ""
2003
2004 #. type: =item
2005 #: ../cat/virt-ls.pod:282
2006 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2007 msgstr ""
2008
2009 #. type: textblock
2010 #: ../cat/virt-ls.pod:284
2011 msgid ""
2012 "Display checksum over file contents for regular files.  With no argument, "
2013 "this defaults to using I<md5>.  Using an argument, you can select the "
2014 "checksum type to use."
2015 msgstr ""
2016
2017 #. type: textblock
2018 #: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358
2019 #: ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408
2020 #: ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422
2021 msgid ""
2022 "This option only has effect in I<-lR> output mode.  See L</RECURSIVE LONG "
2023 "LISTING> above."
2024 msgstr ""
2025
2026 #. type: textblock
2027 #: ../cat/virt-ls.pod:316
2028 msgid ""
2029 "When prompting for keys and passphrases, virt-ls normally turns echoing off "
2030 "so you cannot see what you are typing.  If you are not worried about Tempest "
2031 "attacks and there is no one else in the room you can specify this flag to "
2032 "see what you are typing."
2033 msgstr ""
2034
2035 #. type: =item
2036 #: ../cat/virt-ls.pod:321
2037 msgid "B<--extra-stats>"
2038 msgstr ""
2039
2040 #. type: textblock
2041 #: ../cat/virt-ls.pod:323
2042 msgid "Display extra stats."
2043 msgstr ""
2044
2045 #. type: verbatim
2046 #: ../cat/virt-ls.pod:339
2047 #, no-wrap
2048 msgid ""
2049 " virt-ls --format=raw -a disk.img /dir\n"
2050 "\n"
2051 msgstr ""
2052
2053 #. type: verbatim
2054 #: ../cat/virt-ls.pod:343
2055 #, no-wrap
2056 msgid ""
2057 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2058 "\n"
2059 msgstr ""
2060
2061 #. type: textblock
2062 #: ../cat/virt-ls.pod:356
2063 msgid "Display file sizes in human-readable format."
2064 msgstr ""
2065
2066 #. type: =item
2067 #: ../cat/virt-ls.pod:370
2068 msgid "B<-R>"
2069 msgstr ""
2070
2071 #. type: =item
2072 #: ../cat/virt-ls.pod:372
2073 msgid "B<--recursive>"
2074 msgstr ""
2075
2076 #. type: textblock
2077 #: ../cat/virt-ls.pod:374
2078 msgid ""
2079 "Select the mode.  With neither of these options, C<virt-ls> produces a "
2080 "simple, flat list of the files in the named directory.  See L</SIMPLE "
2081 "LISTING>."
2082 msgstr ""
2083
2084 #. type: textblock
2085 #: ../cat/virt-ls.pod:378
2086 msgid ""
2087 "C<virt-ls -l> produces a \"long listing\", which shows more detail.  See L</"
2088 "LONG LISTING>."
2089 msgstr ""
2090
2091 #. type: textblock
2092 #: ../cat/virt-ls.pod:381
2093 msgid ""
2094 "C<virt-ls -R> produces a recursive list of files starting at the named "
2095 "directory.  See L</RECURSIVE LISTING>."
2096 msgstr ""
2097
2098 #. type: textblock
2099 #: ../cat/virt-ls.pod:384
2100 msgid ""
2101 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2102 "parsed.  See L</RECURSIVE LONG LISTING>."
2103 msgstr ""
2104
2105 #. type: =item
2106 #: ../cat/virt-ls.pod:387
2107 msgid "B<--times>"
2108 msgstr ""
2109
2110 #. type: textblock
2111 #: ../cat/virt-ls.pod:389
2112 msgid "Display time fields."
2113 msgstr ""
2114
2115 #. type: =item
2116 #: ../cat/virt-ls.pod:394
2117 msgid "B<--time-days>"
2118 msgstr ""
2119
2120 #. type: textblock
2121 #: ../cat/virt-ls.pod:396
2122 msgid "Display time fields as days before now (negative if in the future)."
2123 msgstr ""
2124
2125 #. type: textblock
2126 #: ../cat/virt-ls.pod:398
2127 msgid ""
2128 "Note that C<0> in output means \"up to 1 day before now\", or that the age "
2129 "of the file is between 0 and 86399 seconds."
2130 msgstr ""
2131
2132 #. type: =item
2133 #: ../cat/virt-ls.pod:404
2134 msgid "B<--time-relative>"
2135 msgstr ""
2136
2137 #. type: textblock
2138 #: ../cat/virt-ls.pod:406
2139 msgid "Display time fields as seconds before now (negative if in the future)."
2140 msgstr ""
2141
2142 #. type: =item
2143 #: ../cat/virt-ls.pod:411
2144 msgid "B<--time-t>"
2145 msgstr ""
2146
2147 #. type: textblock
2148 #: ../cat/virt-ls.pod:413
2149 msgid "Display time fields as seconds since the Unix epoch."
2150 msgstr ""
2151
2152 #. type: =item
2153 #: ../cat/virt-ls.pod:418
2154 msgid "B<--uids>"
2155 msgstr ""
2156
2157 #. type: textblock
2158 #: ../cat/virt-ls.pod:420
2159 msgid "Display UID and GID fields."
2160 msgstr ""
2161
2162 #. type: textblock
2163 #: ../cat/virt-ls.pod:445
2164 msgid "Previous versions of virt-ls allowed you to write either:"
2165 msgstr ""
2166
2167 #. type: verbatim
2168 #: ../cat/virt-ls.pod:447
2169 #, no-wrap
2170 msgid ""
2171 " virt-ls disk.img [disk.img ...] /dir\n"
2172 "\n"
2173 msgstr ""
2174
2175 #. type: verbatim
2176 #: ../cat/virt-ls.pod:451
2177 #, no-wrap
2178 msgid ""
2179 " virt-ls guestname /dir\n"
2180 "\n"
2181 msgstr ""
2182
2183 #. type: textblock
2184 #: ../cat/virt-ls.pod:492
2185 msgid ""
2186 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
2187 "tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
2188 "L<http://libguestfs.org/>."
2189 msgstr ""
2190
2191 #. type: textblock
2192 #: ../cat/virt-ls.pod:508 ../df/virt-df.pod:230 ../edit/virt-edit.pod:369
2193 #: ../rescue/virt-rescue.pod:298
2194 msgid "Copyright (C) 2009-2011 Red Hat Inc."
2195 msgstr ""
2196
2197 #. type: textblock
2198 #: ../df/virt-df.pod:5
2199 msgid "virt-df - Display free space on virtual filesystems"
2200 msgstr ""
2201
2202 #. type: verbatim
2203 #: ../df/virt-df.pod:9
2204 #, no-wrap
2205 msgid ""
2206 " virt-df [--options]\n"
2207 "\n"
2208 msgstr ""
2209
2210 #. type: verbatim
2211 #: ../df/virt-df.pod:11
2212 #, no-wrap
2213 msgid ""
2214 " virt-df [--options] -d domname\n"
2215 "\n"
2216 msgstr ""
2217
2218 #. type: verbatim
2219 #: ../df/virt-df.pod:13
2220 #, no-wrap
2221 msgid ""
2222 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
2223 "\n"
2224 msgstr ""
2225
2226 #. type: verbatim
2227 #: ../df/virt-df.pod:17
2228 #, no-wrap
2229 msgid ""
2230 " virt-df [--options] domname\n"
2231 "\n"
2232 msgstr ""
2233
2234 #. type: verbatim
2235 #: ../df/virt-df.pod:19
2236 #, no-wrap
2237 msgid ""
2238 " virt-df [--options] disk.img [disk.img ...]\n"
2239 "\n"
2240 msgstr ""
2241
2242 #. type: textblock
2243 #: ../df/virt-df.pod:23
2244 msgid ""
2245 "C<virt-df> is a command line tool to display free space on virtual machine "
2246 "filesystems.  Unlike other tools, it doesn't just display the size of disk "
2247 "allocated to a virtual machine, but can look inside disk images to see how "
2248 "much space is really being used."
2249 msgstr ""
2250
2251 #. type: textblock
2252 #: ../df/virt-df.pod:28
2253 msgid ""
2254 "If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
2255 "to get a list of all active and inactive guests, and performs a C<df>-type "
2256 "operation on each one in turn, printing out the results."
2257 msgstr ""
2258
2259 #. type: textblock
2260 #: ../df/virt-df.pod:32
2261 msgid ""
2262 "If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a C<df>-"
2263 "type operation on either the single named libvirt domain, or on the disk "
2264 "image(s) listed on the command line (which must all belong to a single VM).  "
2265 "In this mode (with arguments), C<virt-df> will I<only work for a single "
2266 "guest>.  If you want to run on multiple guests, then you have to invoke "
2267 "C<virt-df> multiple times."
2268 msgstr ""
2269
2270 #. type: textblock
2271 #: ../df/virt-df.pod:39
2272 msgid ""
2273 "Use the I<--csv> option to get a format which can be easily parsed by other "
2274 "programs.  Other options are similar to the standard L<df(1)> command."
2275 msgstr ""
2276
2277 #. type: textblock
2278 #: ../df/virt-df.pod:45
2279 msgid ""
2280 "Show disk usage for a single libvirt guest called C<F14x64>.  Make the "
2281 "output human-readable:"
2282 msgstr ""
2283
2284 #. type: verbatim
2285 #: ../df/virt-df.pod:48
2286 #, no-wrap
2287 msgid ""
2288 " # virt-df -d F14x64 -h\n"
2289 " Filesystem                       Size     Used  Available  Use%\n"
2290 " F14x64:/dev/sda1                 484M      66M       393M   14%\n"
2291 " F14x64:/dev/vg_f13x64/lv_root    7.4G     3.4G       4.0G   46%\n"
2292 "\n"
2293 msgstr ""
2294
2295 #. type: textblock
2296 #: ../df/virt-df.pod:53
2297 msgid "Show disk usage for a disk image file called C<test.img>:"
2298 msgstr ""
2299
2300 #. type: verbatim
2301 #: ../df/virt-df.pod:55
2302 #, no-wrap
2303 msgid ""
2304 " $ virt-df -a test1.img\n"
2305 " Filesystem                  1K-blocks     Used  Available  Use%\n"
2306 " test1.img:/dev/sda1             99099     1551      92432    2%\n"
2307 "\n"
2308 msgstr ""
2309
2310 #. type: verbatim
2311 #: ../df/virt-df.pod:106
2312 #, no-wrap
2313 msgid ""
2314 " virt-df --format=raw -a disk.img\n"
2315 "\n"
2316 msgstr ""
2317
2318 #. type: verbatim
2319 #: ../df/virt-df.pod:110
2320 #, no-wrap
2321 msgid ""
2322 " virt-df --format=raw -a disk.img --format -a another.img\n"
2323 "\n"
2324 msgstr ""
2325
2326 #. type: textblock
2327 #: ../df/virt-df.pod:123
2328 msgid "Print sizes in human-readable format."
2329 msgstr ""
2330
2331 #. type: textblock
2332 #: ../df/virt-df.pod:125
2333 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
2334 msgstr ""
2335
2336 #. type: =item
2337 #: ../df/virt-df.pod:127 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155
2338 msgid "B<-i>"
2339 msgstr ""
2340
2341 #. type: =item
2342 #: ../df/virt-df.pod:129
2343 msgid "B<--inodes>"
2344 msgstr ""
2345
2346 #. type: textblock
2347 #: ../df/virt-df.pod:131
2348 msgid "Print inodes instead of blocks."
2349 msgstr ""
2350
2351 #. type: =item
2352 #: ../df/virt-df.pod:133
2353 msgid "B<--one-per-guest>"
2354 msgstr ""
2355
2356 #. type: textblock
2357 #: ../df/virt-df.pod:135
2358 msgid ""
2359 "Run one libguestfs appliance per guest.  Normally C<virt-df> will add the "
2360 "disks from several guests to a single libguestfs appliance."
2361 msgstr ""
2362
2363 #. type: textblock
2364 #: ../df/virt-df.pod:138
2365 msgid "You might use this option in the following circumstances:"
2366 msgstr ""
2367
2368 #. type: =item
2369 #: ../df/virt-df.pod:142 ../df/virt-df.pod:148 ../edit/virt-edit.pod:266
2370 #: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276
2371 #: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291
2372 #: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102
2373 #: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132
2374 #: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227
2375 #: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235
2376 #: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243
2377 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
2378 #: ../fish/guestfish-actions.pod:385 ../fish/guestfish-actions.pod:393
2379 #: ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:407
2380 #: ../fish/guestfish-actions.pod:1099 ../fish/guestfish-actions.pod:1103
2381 #: ../fish/guestfish-actions.pod:1107 ../fish/guestfish-actions.pod:1111
2382 #: ../fish/guestfish-actions.pod:1119 ../fish/guestfish-actions.pod:1123
2383 #: ../fish/guestfish-actions.pod:1127 ../fish/guestfish-actions.pod:1137
2384 #: ../fish/guestfish-actions.pod:1141 ../fish/guestfish-actions.pod:1145
2385 #: ../fish/guestfish-actions.pod:1235 ../fish/guestfish-actions.pod:1239
2386 #: ../fish/guestfish-actions.pod:1244 ../fish/guestfish-actions.pod:1249
2387 #: ../fish/guestfish-actions.pod:1291 ../fish/guestfish-actions.pod:1295
2388 #: ../fish/guestfish-actions.pod:1300 ../fish/guestfish-actions.pod:1933
2389 #: ../fish/guestfish-actions.pod:1939 ../fish/guestfish-actions.pod:1947
2390 #: ../fish/guestfish-actions.pod:1954 ../fish/guestfish-actions.pod:1961
2391 #: ../fish/guestfish.pod:445 ../fish/guestfish.pod:449
2392 #: ../fish/guestfish.pod:453 ../fish/guestfish.pod:457
2393 #: ../inspector/virt-inspector.pod:384 ../inspector/virt-inspector.pod:388
2394 #: ../resize/virt-resize.pod:282 ../resize/virt-resize.pod:286
2395 #: ../resize/virt-resize.pod:295 ../resize/virt-resize.pod:301
2396 #: ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22
2397 #: ../src/guestfs-actions.pod:583 ../src/guestfs-actions.pod:591
2398 #: ../src/guestfs-actions.pod:598 ../src/guestfs-actions.pod:605
2399 #: ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1666
2400 #: ../src/guestfs-actions.pod:1670 ../src/guestfs-actions.pod:1674
2401 #: ../src/guestfs-actions.pod:1682 ../src/guestfs-actions.pod:1686
2402 #: ../src/guestfs-actions.pod:1690 ../src/guestfs-actions.pod:1700
2403 #: ../src/guestfs-actions.pod:1704 ../src/guestfs-actions.pod:1708
2404 #: ../src/guestfs-actions.pod:1846 ../src/guestfs-actions.pod:1850
2405 #: ../src/guestfs-actions.pod:1855 ../src/guestfs-actions.pod:1860
2406 #: ../src/guestfs-actions.pod:1921 ../src/guestfs-actions.pod:1925
2407 #: ../src/guestfs-actions.pod:1930 ../src/guestfs-actions.pod:2859
2408 #: ../src/guestfs-actions.pod:2865 ../src/guestfs-actions.pod:2873
2409 #: ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:2887
2410 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
2411 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
2412 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064
2413 #: ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077
2414 #: ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112
2415 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142
2416 #: ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154
2417 #: ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652
2418 #: ../src/guestfs.pod:1754 ../src/guestfs.pod:1759 ../src/guestfs.pod:1763
2419 #: ../src/guestfs.pod:1773 ../src/guestfs.pod:2047 ../src/guestfs.pod:2052
2420 #: ../src/guestfs.pod:2058 ../src/guestfs.pod:2066 ../src/guestfs.pod:2420
2421 #: ../src/guestfs.pod:2426 ../src/guestfs.pod:2431 ../src/guestfs.pod:2437
2422 #: ../src/guestfs.pod:2818 ../src/guestfs.pod:2823 ../src/guestfs.pod:2827
2423 #: ../src/guestfs.pod:2831 ../src/guestfs.pod:2835 ../src/guestfs.pod:2849
2424 #: ../src/guestfs.pod:2854 ../src/guestfs.pod:3068 ../src/guestfs.pod:3072
2425 #: ../src/guestfs.pod:3076 ../src/guestfs.pod:3080
2426 #: ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202
2427 #: ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:710
2428 #: ../tools/virt-win-reg.pl:716 ../tools/virt-win-reg.pl:722
2429 msgid "*"
2430 msgstr ""
2431
2432 #. type: textblock
2433 #: ../df/virt-df.pod:144
2434 msgid ""
2435 "If you think an untrusted guest might actively try to exploit the libguestfs "
2436 "appliance kernel, then this prevents one guest from interfering with the "
2437 "stats printed for another guest."
2438 msgstr ""
2439
2440 #. type: textblock
2441 #: ../df/virt-df.pod:150
2442 msgid ""
2443 "If the kernel has a bug which stops it from accessing a filesystem in one "
2444 "guest (see for example RHBZ#635373) then this allows libguestfs to continue "
2445 "and report stats for further guests."
2446 msgstr ""
2447
2448 #. type: textblock
2449 #: ../df/virt-df.pod:159
2450 msgid ""
2451 "Print UUIDs instead of names.  This is useful for following a guest even "
2452 "when the guest is migrated or renamed, or when two guests happen to have the "
2453 "same name."
2454 msgstr ""
2455
2456 #. type: textblock
2457 #: ../df/virt-df.pod:163
2458 msgid ""
2459 "Note that only domains that we fetch from libvirt come with UUIDs.  For disk "
2460 "images, we still print the disk image name even when this option is "
2461 "specified."
2462 msgstr ""
2463
2464 #. type: textblock
2465 #: ../df/virt-df.pod:218
2466 msgid ""
2467 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
2468 "libguestfs.org/>."
2469 msgstr ""
2470
2471 #. type: textblock
2472 #: ../edit/virt-edit.pod:5
2473 msgid "virt-edit - Edit a file in a virtual machine"
2474 msgstr ""
2475
2476 #. type: verbatim
2477 #: ../edit/virt-edit.pod:9
2478 #, no-wrap
2479 msgid ""
2480 " virt-edit [--options] -d domname file [file ...]\n"
2481 "\n"
2482 msgstr ""
2483
2484 #. type: verbatim
2485 #: ../edit/virt-edit.pod:11
2486 #, no-wrap
2487 msgid ""
2488 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
2489 "\n"
2490 msgstr ""
2491
2492 #. type: verbatim
2493 #: ../edit/virt-edit.pod:13
2494 #, no-wrap
2495 msgid ""
2496 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
2497 "\n"
2498 msgstr ""
2499
2500 #. type: verbatim
2501 #: ../edit/virt-edit.pod:17
2502 #, no-wrap
2503 msgid ""
2504 " virt-edit domname file\n"
2505 "\n"
2506 msgstr ""
2507
2508 #. type: verbatim
2509 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
2510 #, no-wrap
2511 msgid ""
2512 " virt-edit disk.img [disk.img ...] file\n"
2513 "\n"
2514 msgstr ""
2515
2516 #. type: =head1
2517 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23
2518 #: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15
2519 #: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19
2520 #: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
2521 msgid "WARNING"
2522 msgstr ""
2523
2524 #. type: textblock
2525 #: ../edit/virt-edit.pod:23
2526 msgid ""
2527 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
2528 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
2529 "doing this, but doesn't catch all cases."
2530 msgstr ""
2531
2532 #. type: textblock
2533 #: ../edit/virt-edit.pod:29
2534 msgid ""
2535 "C<virt-edit> is a command line tool to edit C<file> where each C<file> "
2536 "exists in the named virtual machine (or disk image)."
2537 msgstr ""
2538
2539 #. type: textblock
2540 #: ../edit/virt-edit.pod:32
2541 msgid ""
2542 "Multiple filenames can be given, in which case they are each edited in "
2543 "turn.  Each filename must be a full path, starting at the root directory "
2544 "(starting with '/')."
2545 msgstr ""
2546
2547 #. type: textblock
2548 #: ../edit/virt-edit.pod:36
2549 msgid "If you want to just view a file, use L<virt-cat(1)>."
2550 msgstr ""
2551
2552 #. type: textblock
2553 #: ../edit/virt-edit.pod:38
2554 msgid ""
2555 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
2556 "USING GUESTFISH> below)."
2557 msgstr ""
2558
2559 #. type: textblock
2560 #: ../edit/virt-edit.pod:41
2561 msgid ""
2562 "C<virt-edit> cannot be used to create a new file.  L<guestfish(1)> can do "
2563 "that and much more."
2564 msgstr ""
2565
2566 #. type: textblock
2567 #: ../edit/virt-edit.pod:46
2568 msgid "Edit the named files interactively:"
2569 msgstr ""
2570
2571 #. type: verbatim
2572 #: ../edit/virt-edit.pod:48
2573 #, no-wrap
2574 msgid ""
2575 " virt-edit -d mydomain /boot/grub/grub.conf\n"
2576 "\n"
2577 msgstr ""
2578
2579 #. type: verbatim
2580 #: ../edit/virt-edit.pod:50
2581 #, no-wrap
2582 msgid ""
2583 " virt-edit -d mydomain /etc/passwd\n"
2584 "\n"
2585 msgstr ""
2586
2587 #. type: textblock
2588 #: ../edit/virt-edit.pod:52
2589 msgid "For Windows guests, some Windows paths are understood:"
2590 msgstr ""
2591
2592 #. type: verbatim
2593 #: ../edit/virt-edit.pod:54
2594 #, no-wrap
2595 msgid ""
2596 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
2597 "\n"
2598 msgstr ""
2599
2600 #. type: textblock
2601 #: ../edit/virt-edit.pod:56
2602 msgid ""
2603 "If Perl is installed, you can also edit files non-interactively (see L</NON-"
2604 "INTERACTIVE EDITING> below).  To change the init default level to 5:"
2605 msgstr ""
2606
2607 #. type: verbatim
2608 #: ../edit/virt-edit.pod:60
2609 #, no-wrap
2610 msgid ""
2611 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
2612 "\n"
2613 msgstr ""
2614
2615 #. type: =item
2616 #: ../edit/virt-edit.pod:81
2617 msgid "B<-b> extension"
2618 msgstr ""
2619
2620 #. type: =item
2621 #: ../edit/virt-edit.pod:83
2622 msgid "B<--backup> extension"
2623 msgstr ""
2624
2625 #. type: textblock
2626 #: ../edit/virt-edit.pod:85
2627 msgid ""
2628 "Create a backup of the original file I<in the guest disk image>.  The backup "
2629 "has the original filename with C<extension> added."
2630 msgstr ""
2631
2632 #. type: textblock
2633 #: ../edit/virt-edit.pod:88
2634 msgid ""
2635 "Usually the first character of C<extension> would be a dot C<.> so you would "
2636 "write:"
2637 msgstr ""
2638
2639 #. type: verbatim
2640 #: ../edit/virt-edit.pod:91
2641 #, no-wrap
2642 msgid ""
2643 " virt-edit -b .orig [etc]\n"
2644 "\n"
2645 msgstr ""
2646
2647 #. type: textblock
2648 #: ../edit/virt-edit.pod:93
2649 msgid "By default, no backup file is made."
2650 msgstr ""
2651
2652 #. type: =item
2653 #: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181
2654 #: ../fuse/guestmount.pod:96 ../inspector/virt-inspector.pod:74
2655 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78
2656 #: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128
2657 msgid "B<-c URI>"
2658 msgstr ""
2659
2660 #. type: =item
2661 #: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183
2662 #: ../fuse/guestmount.pod:98 ../inspector/virt-inspector.pod:76
2663 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80
2664 #: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130
2665 msgid "B<--connect URI>"
2666 msgstr ""
2667
2668 #. type: textblock
2669 #: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84
2670 #: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134
2671 #: ../tools/virt-win-reg.pl:135
2672 msgid ""
2673 "If you specify guest block devices directly, then libvirt is not used at all."
2674 msgstr ""
2675
2676 #. type: textblock
2677 #: ../edit/virt-edit.pod:114
2678 msgid ""
2679 "When prompting for keys and passphrases, virt-edit normally turns echoing "
2680 "off so you cannot see what you are typing.  If you are not worried about "
2681 "Tempest attacks and there is no one else in the room you can specify this "
2682 "flag to see what you are typing."
2683 msgstr ""
2684
2685 #. type: =item
2686 #: ../edit/virt-edit.pod:119
2687 msgid "B<-e> EXPR"
2688 msgstr ""
2689
2690 #. type: =item
2691 #: ../edit/virt-edit.pod:121
2692 msgid "B<--expr> EXPR"
2693 msgstr ""
2694
2695 #. type: textblock
2696 #: ../edit/virt-edit.pod:123
2697 msgid ""
2698 "Instead of launching the external editor, non-interactively apply the Perl "
2699 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
2700 "EDITING> below."
2701 msgstr ""
2702
2703 #. type: textblock
2704 #: ../edit/virt-edit.pod:127
2705 msgid ""
2706 "Be careful to properly quote the expression to prevent it from being altered "
2707 "by the shell."
2708 msgstr ""
2709
2710 #. type: textblock
2711 #: ../edit/virt-edit.pod:130
2712 msgid "Note that this option is only available when Perl 5 is installed."
2713 msgstr ""
2714
2715 #. type: =item
2716 #: ../edit/virt-edit.pod:132
2717 msgid "B<--format> raw|qcow2|..."
2718 msgstr ""
2719
2720 #. type: verbatim
2721 #: ../edit/virt-edit.pod:143
2722 #, no-wrap
2723 msgid ""
2724 " virt-edit --format=raw -a disk.img file\n"
2725 "\n"
2726 msgstr ""
2727
2728 #. type: verbatim
2729 #: ../edit/virt-edit.pod:147
2730 #, no-wrap
2731 msgid ""
2732 " virt-edit --format=raw -a disk.img --format -a another.img file\n"
2733 "\n"
2734 msgstr ""
2735
2736 #. type: textblock
2737 #: ../edit/virt-edit.pod:181
2738 msgid "Previous versions of virt-edit allowed you to write either:"
2739 msgstr ""
2740
2741 #. type: verbatim
2742 #: ../edit/virt-edit.pod:187
2743 #, no-wrap
2744 msgid ""
2745 " virt-edit guestname file\n"
2746 "\n"
2747 msgstr ""
2748
2749 #. type: =head1
2750 #: ../edit/virt-edit.pod:195
2751 msgid "NON-INTERACTIVE EDITING"
2752 msgstr ""
2753
2754 #. type: textblock
2755 #: ../edit/virt-edit.pod:197
2756 msgid ""
2757 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
2758 "administrator can interactively edit the file."
2759 msgstr ""
2760
2761 #. type: textblock
2762 #: ../edit/virt-edit.pod:200
2763 msgid ""
2764 "There are two ways also to use C<virt-edit> from scripts in order to make "
2765 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
2766 "like this, it's less error-prone to write scripts directly using the "
2767 "libguestfs API and Augeas for configuration file editing.)"
2768 msgstr ""
2769
2770 #. type: textblock
2771 #: ../edit/virt-edit.pod:206
2772 msgid ""
2773 "The first method is to temporarily set C<$EDITOR> to any script or program "
2774 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
2775 "update C<tmpfile> in place however it likes."
2776 msgstr ""
2777
2778 #. type: textblock
2779 #: ../edit/virt-edit.pod:210
2780 msgid ""
2781 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
2782 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
2783 "instances of C<foo> with C<bar> in a file:"
2784 msgstr ""
2785
2786 #. type: verbatim
2787 #: ../edit/virt-edit.pod:214
2788 #, no-wrap
2789 msgid ""
2790 " virt-edit -d domname filename -e 's/foo/bar/'\n"
2791 "\n"
2792 msgstr ""
2793
2794 #. type: textblock
2795 #: ../edit/virt-edit.pod:216
2796 msgid ""
2797 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
2798 "For example to delete root's password you could do:"
2799 msgstr ""
2800
2801 #. type: verbatim
2802 #: ../edit/virt-edit.pod:219
2803 #, no-wrap
2804 msgid ""
2805 " virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
2806 "\n"
2807 msgstr ""
2808
2809 #. type: textblock
2810 #: ../edit/virt-edit.pod:221
2811 msgid ""
2812 "What really happens is that the snippet is evaluated as a Perl expression "
2813 "for each line of the file.  The line, including the final C<\\n>, is passed "
2814 "in C<$_> and the expression should update C<$_> or leave it unchanged."
2815 msgstr ""
2816
2817 #. type: textblock
2818 #: ../edit/virt-edit.pod:226
2819 msgid ""
2820 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
2821 "C<apache> user account from the password file you can do:"
2822 msgstr ""
2823
2824 #. type: verbatim
2825 #: ../edit/virt-edit.pod:229
2826 #, no-wrap
2827 msgid ""
2828 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
2829 "\n"
2830 msgstr ""
2831
2832 #. type: textblock
2833 #: ../edit/virt-edit.pod:231
2834 msgid ""
2835 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
2836 "the end of the file is rather difficult this way since there is no concept "
2837 "of \"last line of the file\" - your expression just doesn't get called "
2838 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
2839 "want to do this."
2840 msgstr ""
2841
2842 #. type: textblock
2843 #: ../edit/virt-edit.pod:237
2844 msgid ""
2845 "The variable C<$lineno> contains the current line number.  As is "
2846 "traditional, the first line in the file is number C<1>."
2847 msgstr ""
2848
2849 #. type: textblock
2850 #: ../edit/virt-edit.pod:240
2851 msgid ""
2852 "The return value from the expression is ignored, but the expression may call "
2853 "C<die> in order to abort the whole program, leaving the original file "
2854 "untouched."
2855 msgstr ""
2856
2857 #. type: textblock
2858 #: ../edit/virt-edit.pod:244
2859 msgid ""
2860 "Remember when matching the end of a line that C<$_> may contain the final C<"
2861 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
2862 "newline then neither of these.  Thus to match or substitute some text at the "
2863 "end of a line, use this regular expression:"
2864 msgstr ""
2865
2866 #. type: verbatim
2867 #: ../edit/virt-edit.pod:249
2868 #, no-wrap
2869 msgid ""
2870 " /some text(\\r?\\n)?$/\n"
2871 "\n"
2872 msgstr ""
2873
2874 #. type: textblock
2875 #: ../edit/virt-edit.pod:251
2876 msgid ""
2877 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
2878 "$_> itself (since that would remove all newlines from the file):"
2879 msgstr ""
2880
2881 #. type: verbatim
2882 #: ../edit/virt-edit.pod:255
2883 #, no-wrap
2884 msgid ""
2885 " my $m = $_; chomp $m; $m =~ /some text$/\n"
2886 "\n"
2887 msgstr ""
2888
2889 #. type: =head1
2890 #: ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
2891 msgid "WINDOWS PATHS"
2892 msgstr ""
2893
2894 #. type: textblock
2895 #: ../edit/virt-edit.pod:259
2896 msgid ""
2897 "C<virt-edit> has a limited ability to understand Windows drive letters and "
2898 "paths (eg. C<E:\\foo\\bar.txt>)."
2899 msgstr ""
2900
2901 #. type: textblock
2902 #: ../edit/virt-edit.pod:262
2903 msgid "If and only if the guest is running Windows then:"
2904 msgstr ""
2905
2906 #. type: textblock
2907 #: ../edit/virt-edit.pod:268
2908 msgid ""
2909 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
2910 "to the correct filesystem."
2911 msgstr ""
2912
2913 #. type: textblock
2914 #: ../edit/virt-edit.pod:273
2915 msgid ""
2916 "Any backslash (C<\\>) characters in the path are replaced with forward "
2917 "slashes so that libguestfs can process it."
2918 msgstr ""
2919
2920 #. type: textblock
2921 #: ../edit/virt-edit.pod:278
2922 msgid ""
2923 "The path is resolved case insensitively to locate the file that should be "
2924 "edited."
2925 msgstr ""
2926
2927 #. type: textblock
2928 #: ../edit/virt-edit.pod:283
2929 msgid "There are some known shortcomings:"
2930 msgstr ""
2931
2932 #. type: textblock
2933 #: ../edit/virt-edit.pod:289
2934 msgid "Some NTFS symbolic links may not be followed correctly."
2935 msgstr ""
2936
2937 #. type: textblock
2938 #: ../edit/virt-edit.pod:293
2939 msgid "NTFS junction points that cross filesystems are not followed."
2940 msgstr ""
2941
2942 #. type: textblock
2943 #: ../edit/virt-edit.pod:299
2944 msgid ""
2945 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
2946 "C<virt-edit> doesn't work."
2947 msgstr ""
2948
2949 #. type: textblock
2950 #: ../edit/virt-edit.pod:302
2951 msgid "Using C<virt-edit> is approximately equivalent to doing:"
2952 msgstr ""
2953
2954 #. type: verbatim
2955 #: ../edit/virt-edit.pod:304
2956 #, no-wrap
2957 msgid ""
2958 " guestfish --rw -i -d domname edit /file\n"
2959 "\n"
2960 msgstr ""
2961
2962 #. type: textblock
2963 #: ../edit/virt-edit.pod:306
2964 msgid ""
2965 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
2966 "path to the file."
2967 msgstr ""
2968
2969 #. type: textblock
2970 #: ../edit/virt-edit.pod:309
2971 msgid ""
2972 "The command above uses libguestfs's guest inspection feature and so does not "
2973 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
2974 "disk images that don't contain guests.  To edit a file on a disk image "
2975 "directly, use:"
2976 msgstr ""
2977
2978 #. type: verbatim
2979 #: ../edit/virt-edit.pod:314
2980 #, no-wrap
2981 msgid ""
2982 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
2983 "\n"
2984 msgstr ""
2985
2986 #. type: textblock
2987 #: ../edit/virt-edit.pod:316
2988 msgid ""
2989 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
2990 "the disk image to edit, and C</file> is the full path to the file."
2991 msgstr ""
2992
2993 #. type: textblock
2994 #: ../edit/virt-edit.pod:320
2995 msgid ""
2996 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
2997 "C<write> or C<upload> instead:"
2998 msgstr ""
2999
3000 #. type: verbatim
3001 #: ../edit/virt-edit.pod:323
3002 #, no-wrap
3003 msgid ""
3004 " guestfish --rw -i -d domname touch /newfile\n"
3005 "\n"
3006 msgstr ""
3007
3008 #. type: verbatim
3009 #: ../edit/virt-edit.pod:325
3010 #, no-wrap
3011 msgid ""
3012 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
3013 "\n"
3014 msgstr ""
3015
3016 #. type: verbatim
3017 #: ../edit/virt-edit.pod:327
3018 #, no-wrap
3019 msgid ""
3020 " guestfish --rw -i -d domname upload localfile /newfile\n"
3021 "\n"
3022 msgstr ""
3023
3024 #. type: =head1
3025 #: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1075
3026 #: ../rescue/virt-rescue.pod:257 ../src/guestfs.pod:2965
3027 #: ../test-tool/libguestfs-test-tool.pod:82
3028 msgid "ENVIRONMENT VARIABLES"
3029 msgstr ""
3030
3031 #. type: =item
3032 #: ../edit/virt-edit.pod:333
3033 msgid "C<EDITOR>"
3034 msgstr ""
3035
3036 #. type: textblock
3037 #: ../edit/virt-edit.pod:335
3038 msgid ""
3039 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
3040 "\"emacs -nw\">"
3041 msgstr ""
3042
3043 #. type: textblock
3044 #: ../edit/virt-edit.pod:338
3045 msgid "If not set, C<vi> is used."
3046 msgstr ""
3047
3048 #. type: textblock
3049 #: ../edit/virt-edit.pod:351
3050 msgid ""
3051 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
3052 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
3053 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
3054 msgstr ""
3055
3056 #. type: textblock
3057 #: ../examples/guestfs-examples.pod:5
3058 msgid "guestfs-examples - Examples of using libguestfs from C"
3059 msgstr ""
3060
3061 #. type: verbatim
3062 #: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9
3063 #, no-wrap
3064 msgid ""
3065 " #include <guestfs.h>\n"
3066 " \n"
3067 msgstr ""
3068
3069 #. type: verbatim
3070 #: ../examples/guestfs-examples.pod:11
3071 #, no-wrap
3072 msgid ""
3073 " guestfs_h *g = guestfs_create ();\n"
3074 " guestfs_add_drive_ro (g, \"disk.img\");\n"
3075 " guestfs_launch (g);\n"
3076 "\n"
3077 msgstr ""
3078
3079 #. type: verbatim
3080 #: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19
3081 #, no-wrap
3082 msgid ""
3083 " cc prog.c -o prog -lguestfs\n"
3084 "or:\n"
3085 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
3086 "\n"
3087 msgstr ""
3088
3089 #. type: textblock
3090 #: ../examples/guestfs-examples.pod:21
3091 msgid ""
3092 "This manual page contains examples of calling libguestfs from the C "
3093 "programming language.  If you are not familiar with using libguestfs, you "
3094 "also need to read L<guestfs(3)>."
3095 msgstr ""
3096
3097 #. type: =head1
3098 #: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37
3099 #: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31
3100 #: ../python/examples/guestfs-python.pod:34
3101 #: ../ruby/examples/guestfs-ruby.pod:28
3102 msgid "EXAMPLE 1: CREATE A DISK IMAGE"
3103 msgstr ""
3104
3105 #. type: textblock
3106 #: ../examples/guestfs-examples.pod:27 ../java/examples/guestfs-java.pod:39
3107 #: ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33
3108 #: ../python/examples/guestfs-python.pod:36
3109 #: ../ruby/examples/guestfs-ruby.pod:30
3110 msgid "@EXAMPLE1@"
3111 msgstr ""
3112
3113 #. type: =head1
3114 #: ../examples/guestfs-examples.pod:29 ../java/examples/guestfs-java.pod:41
3115 #: ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35
3116 #: ../python/examples/guestfs-python.pod:38
3117 #: ../ruby/examples/guestfs-ruby.pod:32
3118 msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE"
3119 msgstr ""
3120
3121 #. type: textblock
3122 #: ../examples/guestfs-examples.pod:31 ../java/examples/guestfs-java.pod:43
3123 #: ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37
3124 #: ../python/examples/guestfs-python.pod:40
3125 #: ../ruby/examples/guestfs-ruby.pod:34
3126 msgid "@EXAMPLE2@"
3127 msgstr ""
3128
3129 #. type: textblock
3130 #: ../examples/guestfs-examples.pod:35
3131 msgid ""
3132 "L<guestfs(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, "
3133 "L<guestfs-python(3)>, L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, L<http://"
3134 "libguestfs.org/>."
3135 msgstr ""
3136
3137 #. type: =head1
3138 #: ../examples/guestfs-examples.pod:44 ../examples/guestfs-recipes.pod:396
3139 #: ../fish/guestfish.pod:1238 ../fish/virt-copy-in.pod:60
3140 #: ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58
3141 #: ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:314
3142 #: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:57
3143 #: ../ocaml/examples/guestfs-ocaml.pod:90 ../perl/examples/guestfs-perl.pod:51
3144 #: ../python/examples/guestfs-python.pod:53
3145 #: ../ruby/examples/guestfs-ruby.pod:47 ../src/guestfs.pod:3087
3146 #: ../test-tool/libguestfs-test-tool.pod:93
3147 msgid "AUTHORS"
3148 msgstr ""
3149
3150 #. type: textblock
3151 #: ../examples/guestfs-examples.pod:46 ../examples/guestfs-recipes.pod:398
3152 #: ../fish/guestfish.pod:1240 ../fish/virt-copy-in.pod:62
3153 #: ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60
3154 #: ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:316
3155 #: ../java/examples/guestfs-java.pod:59 ../ocaml/examples/guestfs-ocaml.pod:92
3156 #: ../perl/examples/guestfs-perl.pod:53
3157 #: ../python/examples/guestfs-python.pod:55
3158 #: ../ruby/examples/guestfs-ruby.pod:49 ../src/guestfs.pod:3089
3159 #: ../test-tool/libguestfs-test-tool.pod:95
3160 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
3161 msgstr ""
3162
3163 #. type: textblock
3164 #: ../examples/guestfs-examples.pod:50 ../ocaml/examples/guestfs-ocaml.pod:96
3165 #: ../python/examples/guestfs-python.pod:59
3166 #: ../ruby/examples/guestfs-ruby.pod:53
3167 msgid "Copyright (C) 2010 Red Hat Inc. L<http://libguestfs.org/>"
3168 msgstr ""
3169
3170 #. type: textblock
3171 #: ../examples/guestfs-examples.pod:52 ../examples/guestfs-recipes.pod:404
3172 #: ../java/examples/guestfs-java.pod:65 ../ocaml/examples/guestfs-ocaml.pod:98
3173 #: ../perl/examples/guestfs-perl.pod:59
3174 #: ../python/examples/guestfs-python.pod:61
3175 #: ../ruby/examples/guestfs-ruby.pod:55
3176 msgid ""
3177 "The examples in this manual page may be freely copied, modified and "
3178 "distributed without any restrictions."
3179 msgstr ""
3180
3181 #. type: textblock
3182 #: ../examples/guestfs-examples.pod:55 ../examples/guestfs-recipes.pod:407
3183 #: ../java/examples/guestfs-java.pod:68
3184 #: ../ocaml/examples/guestfs-ocaml.pod:101
3185 #: ../perl/examples/guestfs-perl.pod:62
3186 #: ../python/examples/guestfs-python.pod:64
3187 #: ../ruby/examples/guestfs-ruby.pod:58 ../src/guestfs.pod:3096
3188 msgid ""
3189 "This library is free software; you can redistribute it and/or modify it "
3190 "under the terms of the GNU Lesser General Public License as published by the "
3191 "Free Software Foundation; either version 2 of the License, or (at your "
3192 "option) any later version."
3193 msgstr ""
3194
3195 #. type: textblock
3196 #: ../examples/guestfs-examples.pod:60 ../examples/guestfs-recipes.pod:412
3197 #: ../java/examples/guestfs-java.pod:73
3198 #: ../ocaml/examples/guestfs-ocaml.pod:106
3199 #: ../perl/examples/guestfs-perl.pod:67
3200 #: ../python/examples/guestfs-python.pod:69
3201 #: ../ruby/examples/guestfs-ruby.pod:63 ../src/guestfs.pod:3101
3202 msgid ""
3203 "This library is distributed in the hope that it will be useful, but WITHOUT "
3204 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
3205 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
3206 "for more details."
3207 msgstr ""
3208
3209 #. type: textblock
3210 #: ../examples/guestfs-examples.pod:65 ../examples/guestfs-recipes.pod:417
3211 #: ../java/examples/guestfs-java.pod:78
3212 #: ../ocaml/examples/guestfs-ocaml.pod:111
3213 #: ../perl/examples/guestfs-perl.pod:72
3214 #: ../python/examples/guestfs-python.pod:74
3215 #: ../ruby/examples/guestfs-ruby.pod:68 ../src/guestfs.pod:3106
3216 msgid ""
3217 "You should have received a copy of the GNU Lesser General Public License "
3218 "along with this library; if not, write to the Free Software Foundation, "
3219 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
3220 msgstr ""
3221
3222 #. type: =end
3223 #: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12
3224 msgid "comment"
3225 msgstr ""
3226
3227 #. type: textblock
3228 #: ../examples/guestfs-recipes.pod:5
3229 msgid ""
3230 "pod2man and pod2html have differing bugs which makes it hard to write URLs "
3231 "here.  The only way which works for both sorts of output is to just write "
3232 "the URL directly.  Do NOT use L<...> for URLs."
3233 msgstr ""
3234
3235 #. type: textblock
3236 #: ../examples/guestfs-recipes.pod:9
3237 msgid ""
3238 "We break with tradition here and don't use ALL CAPS for the section "
3239 "headings, as this makes them much easier to read."
3240 msgstr ""
3241
3242 #. type: textblock
3243 #: ../examples/guestfs-recipes.pod:16
3244 msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes"
3245 msgstr ""
3246
3247 #. type: textblock
3248 #: ../examples/guestfs-recipes.pod:20
3249 msgid ""
3250 "This page contains recipes for and links to things you can do using "
3251 "libguestfs, L<guestfish(1)> and the virt tools."
3252 msgstr ""
3253
3254 #. type: =head1
3255 #: ../examples/guestfs-recipes.pod:23
3256 msgid "Audit a virtual machine for setuid files"
3257 msgstr ""
3258
3259 #. type: textblock
3260 #: ../examples/guestfs-recipes.pod:25
3261 msgid ""
3262 "The link below contains a small program which can be used to audit a Linux "
3263 "virtual machine to see what setuid and setgid files it contains."
3264 msgstr ""
3265
3266 #. type: textblock
3267 #: ../examples/guestfs-recipes.pod:28
3268 msgid ""
3269 "https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-"
3270 "files/#content"
3271 msgstr ""
3272
3273 #. type: =head1
3274 #: ../examples/guestfs-recipes.pod:30
3275 msgid "Change the background image in a Windows XP VM"
3276 msgstr ""
3277
3278 #. type: textblock
3279 #: ../examples/guestfs-recipes.pod:32
3280 msgid ""
3281 "The links below explain how to use L<guestfish(1)> to change the background "
3282 "image for a user of a Windows XP VM.  Unfortunately the technique appears to "
3283 "be substantially different for each version of Windows."
3284 msgstr ""
3285
3286 #. type: textblock
3287 #: ../examples/guestfs-recipes.pod:37
3288 msgid ""
3289 "https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://"
3290 "lists.fedoraproject.org/pipermail/virt/2011-May/002658.html"
3291 msgstr ""
3292
3293 #. type: =head1
3294 #: ../examples/guestfs-recipes.pod:40
3295 msgid "Cloning a virtual machine (Linux)"
3296 msgstr ""
3297
3298 #. type: textblock
3299 #: ../examples/guestfs-recipes.pod:42
3300 msgid ""
3301 "The guestfish technique described in the link below works well for most "
3302 "Linux VMs.  Depending on the Linux distro you may need to change the paths "
3303 "slightly."
3304 msgstr ""
3305
3306 #. type: textblock
3307 #: ../examples/guestfs-recipes.pod:46
3308 msgid ""
3309 "https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-"
3310 "vm/#content"
3311 msgstr ""
3312
3313 #. type: textblock
3314 #: ../examples/guestfs-recipes.pod:48
3315 msgid ""
3316 "Avoid L<virt-clone(1)>.  Currently what to do about virt-clone is under "
3317 "discussion."
3318 msgstr ""
3319
3320 #. type: textblock
3321 #: ../examples/guestfs-recipes.pod:51
3322 msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html"
3323 msgstr ""
3324
3325 #. type: =head1
3326 #: ../examples/guestfs-recipes.pod:53
3327 msgid "Cloning a virtual machine (Windows)"
3328 msgstr ""
3329
3330 #. type: textblock
3331 #: ../examples/guestfs-recipes.pod:55
3332 msgid ""
3333 "It is possible to do a \"sysprep\" using libguestfs alone, although not "
3334 "straightforward.  Currently there is code in the Aeolus Oz project which "
3335 "does this (using libguestfs).  As part of our review of the virt-clone tool, "
3336 "we may add sysprepping ability."
3337 msgstr ""
3338
3339 #. type: textblock
3340 #: ../examples/guestfs-recipes.pod:60
3341 msgid ""
3342 "https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-"
3343 "list/2011-May/msg00019.html"
3344 msgstr ""
3345
3346 #. type: =head1
3347 #: ../examples/guestfs-recipes.pod:63
3348 msgid "Convert a CD-ROM / DVD / ISO to a tarball"
3349 msgstr ""
3350
3351 #. type: textblock
3352 #: ../examples/guestfs-recipes.pod:65
3353 msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:"
3354 msgstr ""
3355
3356 #. type: verbatim
3357 #: ../examples/guestfs-recipes.pod:67
3358 #, no-wrap
3359 msgid ""
3360 " guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n"
3361 "\n"
3362 msgstr ""
3363
3364 #. type: textblock
3365 #: ../examples/guestfs-recipes.pod:69
3366 msgid "To export just a subdirectory, eg. C</files>, do:"
3367 msgstr ""
3368
3369 #. type: verbatim
3370 #: ../examples/guestfs-recipes.pod:71
3371 #, no-wrap
3372 msgid ""
3373 " guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n"
3374 "\n"
3375 msgstr ""
3376
3377 #. type: =head1
3378 #: ../examples/guestfs-recipes.pod:73
3379 msgid "Create empty disk images"
3380 msgstr ""
3381
3382 #. type: textblock
3383 #: ../examples/guestfs-recipes.pod:75
3384 msgid ""
3385 "You can use the L<guestfish(1)> I<-N> option to create empty disk images.  "
3386 "The useful guide below explains the options available."
3387 msgstr ""
3388
3389 #. type: textblock
3390 #: ../examples/guestfs-recipes.pod:78
3391 msgid ""
3392 "https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/"
3393 "#content"
3394 msgstr ""
3395
3396 #. type: =head1
3397 #: ../examples/guestfs-recipes.pod:80
3398 msgid "Dump raw filesystem content from inside a disk image or VM"
3399 msgstr ""
3400
3401 #. type: textblock
3402 #: ../examples/guestfs-recipes.pod:82
3403 msgid ""
3404 "You can use the L<guestfish(1)> C<download> command to extract the raw "
3405 "filesystem content from any filesystem in a disk image or a VM (even one "
3406 "which is encrypted or buried inside an LV):"
3407 msgstr ""
3408
3409 #. type: verbatim
3410 #: ../examples/guestfs-recipes.pod:86
3411 #, no-wrap
3412 msgid ""
3413 " guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n"
3414 "\n"
3415 msgstr ""
3416
3417 #. type: verbatim
3418 #: ../examples/guestfs-recipes.pod:88
3419 #, no-wrap
3420 msgid ""
3421 " guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n"
3422 "\n"
3423 msgstr ""
3424
3425 #. type: textblock
3426 #: ../examples/guestfs-recipes.pod:90
3427 msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>."
3428 msgstr ""
3429
3430 #. type: =head1
3431 #: ../examples/guestfs-recipes.pod:92
3432 msgid "Edit grub configuration in a VM"
3433 msgstr ""
3434
3435 #. type: textblock
3436 #: ../examples/guestfs-recipes.pod:94
3437 msgid "You can use this to:"
3438 msgstr ""
3439
3440 #. type: textblock
3441 #: ../examples/guestfs-recipes.pod:100
3442 msgid "Fix a virtual machine that does not boot."
3443 msgstr ""
3444
3445 #. type: textblock
3446 #: ../examples/guestfs-recipes.pod:104
3447 msgid "Change which kernel is used to boot the VM."
3448 msgstr ""
3449
3450 #. type: textblock
3451 #: ../examples/guestfs-recipes.pod:108
3452 msgid "Change kernel command line options."
3453 msgstr ""
3454
3455 #. type: textblock
3456 #: ../examples/guestfs-recipes.pod:112
3457 msgid "Use L<virt-edit(1)> to edit the grub configuration:"
3458 msgstr ""
3459
3460 #. type: verbatim
3461 #: ../examples/guestfs-recipes.pod:114
3462 #, no-wrap
3463 msgid ""
3464 " virt-edit -d BrokenGuest /boot/grub/grub.conf\n"
3465 "\n"
3466 msgstr ""
3467
3468 #. type: textblock
3469 #: ../examples/guestfs-recipes.pod:116
3470 msgid ""
3471 "or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like "
3472 "this:"
3473 msgstr ""
3474
3475 #. type: verbatim
3476 #: ../examples/guestfs-recipes.pod:119
3477 #, no-wrap
3478 msgid ""
3479 " virt-rescue -d BrokenGuest\n"
3480 "\n"
3481 msgstr ""
3482
3483 #. type: =head1
3484 #: ../examples/guestfs-recipes.pod:121
3485 msgid "Export any directory from a VM"
3486 msgstr ""
3487
3488 #. type: textblock
3489 #: ../examples/guestfs-recipes.pod:123
3490 msgid ""
3491 "To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:"
3492 msgstr ""
3493
3494 #. type: verbatim
3495 #: ../examples/guestfs-recipes.pod:126
3496 #, no-wrap
3497 msgid ""
3498 " virt-copy-out -d Guest /home .\n"
3499 "\n"
3500 msgstr ""
3501
3502 #. type: textblock
3503 #: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9
3504 #: ../fish/guestfish-actions.pod:1287 ../fish/guestfish-actions.pod:1929
3505 #: ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1917
3506 #: ../src/guestfs-actions.pod:2855 ../src/guestfs.pod:1639
3507 #: ../tools/virt-win-reg.pl:706
3508 msgid "Notes:"
3509 msgstr ""
3510
3511 #. type: textblock
3512 #: ../examples/guestfs-recipes.pod:134
3513 msgid ""
3514 "The final dot of the command is not a printing error.  It means we want to "
3515 "copy out to the current directory."
3516 msgstr ""
3517
3518 #. type: textblock
3519 #: ../examples/guestfs-recipes.pod:139
3520 msgid "This creates a directory called C<home> under the current directory."
3521 msgstr ""
3522
3523 #. type: textblock
3524 #: ../examples/guestfs-recipes.pod:143
3525 msgid ""
3526 "If the guest is a Windows guest then you can use drive letters and "
3527 "backslashes, but you must prefix the path with C<win:> and quote it to "
3528 "protect it from the shell, like this:"
3529 msgstr ""
3530
3531 #. type: verbatim
3532 #: ../examples/guestfs-recipes.pod:147
3533 #, no-wrap
3534 msgid ""
3535 " virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n"
3536 "\n"
3537 msgstr ""
3538
3539 #. type: textblock
3540 #: ../examples/guestfs-recipes.pod:149
3541 msgid "To get the output as a compressed tarball, do:"
3542 msgstr ""
3543
3544 #. type: verbatim
3545 #: ../examples/guestfs-recipes.pod:151
3546 #, no-wrap
3547 msgid ""
3548 " virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n"
3549 "\n"
3550 msgstr ""
3551
3552 #. type: textblock
3553 #: ../examples/guestfs-recipes.pod:153
3554 msgid ""
3555 "Although it sounds tempting, this is usually not a reliable way to get a "
3556 "backup from a running guest.  See the entry in the FAQ: http://libguestfs."
3557 "org/FAQ.html#backup"
3558 msgstr ""
3559
3560 #. type: =head1
3561 #: ../examples/guestfs-recipes.pod:157
3562 msgid "Find out which user is using the most space"
3563 msgstr ""
3564
3565 #. type: textblock
3566 #: ../examples/guestfs-recipes.pod:159
3567 msgid ""
3568 "This simple script examines a Linux guest to find out which user is using "
3569 "the most space in their home directory:"
3570 msgstr ""
3571
3572 #. type: verbatim
3573 #: ../examples/guestfs-recipes.pod:162
3574 #, no-wrap
3575 msgid ""
3576 " #!/bin/sh -\n"
3577 " \n"
3578 msgstr ""
3579
3580 #. type: verbatim
3581 #: ../examples/guestfs-recipes.pod:164
3582 #, no-wrap
3583 msgid ""
3584 " set -e\n"
3585 " \n"
3586 msgstr ""
3587
3588 #. type: verbatim
3589 #: ../examples/guestfs-recipes.pod:166
3590 #, no-wrap
3591 msgid ""
3592 " vm=\"$1\"\n"
3593 " dir=/home\n"
3594 " \n"
3595 msgstr ""
3596
3597 #. type: verbatim
3598 #: ../examples/guestfs-recipes.pod:169
3599 #, no-wrap
3600 msgid ""
3601 " eval $(guestfish --ro -d \"$vm\" -i --listen)\n"
3602 " \n"
3603 msgstr ""
3604
3605 #. type: verbatim
3606 #: ../examples/guestfs-recipes.pod:171
3607 #, no-wrap
3608 msgid ""
3609 " for d in $(guestfish --remote ls \"$dir\"); do\n"
3610 "     echo -n \"$dir/$d\"\n"
3611 "     echo -ne '\\t'\n"
3612 "     guestfish --remote du \"$dir/$d\";\n"
3613 " done | sort -nr -k 2\n"
3614 " \n"
3615 msgstr ""
3616
3617 #. type: verbatim
3618 #: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941
3619 #, no-wrap
3620 msgid ""
3621 " guestfish --remote exit\n"
3622 "\n"
3623 msgstr ""
3624
3625 #. type: =head1
3626 #: ../examples/guestfs-recipes.pod:179
3627 msgid "Get DHCP address from a VM"
3628 msgstr ""
3629
3630 #. type: textblock
3631 #: ../examples/guestfs-recipes.pod:181
3632 msgid ""
3633 "The link below explains the many different possible techniques for getting "
3634 "the last assigned DHCP address of a virtual machine."
3635 msgstr ""
3636
3637 #. type: textblock
3638 #: ../examples/guestfs-recipes.pod:184
3639 msgid ""
3640 "https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-"
3641 "a-virtual-machine-disk-image/#content"
3642 msgstr ""
3643
3644 #. type: textblock
3645 #: ../examples/guestfs-recipes.pod:186
3646 msgid ""
3647 "In the libguestfs source examples directory you will find the latest version "
3648 "of the C<virt-dhcp-address.c> program."
3649 msgstr ""
3650
3651 #. type: =head1
3652 #: ../examples/guestfs-recipes.pod:189
3653 msgid "Get the operating system product name string"
3654 msgstr ""
3655
3656 #. type: textblock
3657 #: ../examples/guestfs-recipes.pod:191
3658 msgid "Save the following script into a file called C<product-name.sh>:"
3659 msgstr ""
3660
3661 #. type: verbatim
3662 #: ../examples/guestfs-recipes.pod:193
3663 #, no-wrap
3664 msgid ""
3665 " #!/bin/sh -\n"
3666 " set -e\n"
3667 " eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
3668 " root=\"$(guestfish --remote inspect-get-roots)\"\n"
3669 " guestfish --remote inspect-get-product-name \"$root\"\n"
3670 " guestfish --remote exit\n"
3671 "\n"
3672 msgstr ""
3673
3674 #. type: textblock
3675 #: ../examples/guestfs-recipes.pod:200
3676 msgid "Make the script executable and run it on a named guest:"
3677 msgstr ""
3678
3679 #. type: verbatim
3680 #: ../examples/guestfs-recipes.pod:202
3681 #, no-wrap
3682 msgid ""
3683 " # product-name.sh RHEL60x64\n"
3684 " Red Hat Enterprise Linux Server release 6.0 (Santiago)\n"
3685 "\n"
3686 msgstr ""
3687
3688 #. type: textblock
3689 #: ../examples/guestfs-recipes.pod:205
3690 msgid ""
3691 "You can also use an XPath query on the L<virt-inspector(1)> XML using the "
3692 "C<xpath> command line tool or from your favourite programming language:"
3693 msgstr ""
3694
3695 #. type: verbatim
3696 #: ../examples/guestfs-recipes.pod:209
3697 #, no-wrap
3698 msgid ""
3699 " # virt-inspector RHEL60x64 > xml\n"
3700 " # xpath '//product_name' < xml\n"
3701 " Found 1 nodes:\n"
3702 " -- NODE --\n"
3703 " <product_name>Red Hat Enterprise Linux Server release 6.0 (Santiago)</product_name>\n"
3704 "\n"
3705 msgstr ""
3706
3707 #. type: =head1
3708 #: ../examples/guestfs-recipes.pod:215
3709 msgid "Get the default boot kernel for a Linux VM"
3710 msgstr ""
3711
3712 #. type: textblock
3713 #: ../examples/guestfs-recipes.pod:217
3714 msgid ""
3715 "The link below contains a program to print the default boot kernel for a "
3716 "Linux VM."
3717 msgstr ""
3718
3719 #. type: textblock
3720 #: ../examples/guestfs-recipes.pod:220
3721 msgid ""
3722 "https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-"
3723 "kernel-for-a-vm/#content"
3724 msgstr ""
3725
3726 #. type: textblock
3727 #: ../examples/guestfs-recipes.pod:222
3728 msgid ""
3729 "It uses Augeas, and the technique is generally applicable for many different "
3730 "tasks, such as:"
3731 msgstr ""
3732
3733 #. type: textblock
3734 #: ../examples/guestfs-recipes.pod:229
3735 msgid "listing the user accounts in the guest"
3736 msgstr ""
3737
3738 #. type: textblock
3739 #: ../examples/guestfs-recipes.pod:233
3740 msgid "what repositories is it configured to use"
3741 msgstr ""
3742
3743 #. type: textblock
3744 #: ../examples/guestfs-recipes.pod:237
3745 msgid "what NTP servers does it connect to"
3746 msgstr ""
3747
3748 #. type: textblock
3749 #: ../examples/guestfs-recipes.pod:241
3750 msgid "what were the boot messages last time it booted"
3751 msgstr ""
3752
3753 #. type: textblock
3754 #: ../examples/guestfs-recipes.pod:245
3755 msgid "listing who was logged in recently"
3756 msgstr ""
3757
3758 #. type: textblock
3759 #: ../examples/guestfs-recipes.pod:249
3760 msgid "http://augeas.net/"
3761 msgstr ""
3762
3763 #. type: =head1
3764 #: ../examples/guestfs-recipes.pod:251
3765 msgid "Install RPMs in a guest"
3766 msgstr ""
3767
3768 #. type: textblock
3769 #: ../examples/guestfs-recipes.pod:253
3770 msgid ""
3771 "The link below contains a method to install RPMs in a guest.  In fact the "
3772 "RPMs are just uploaded to the guest along with a \"firstboot\" script that "
3773 "installs them next time the guest is booted.  You could use this technique "
3774 "to install vital security updates in an offline guest."
3775 msgstr ""
3776
3777 #. type: textblock
3778 #: ../examples/guestfs-recipes.pod:259
3779 msgid ""
3780 "https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content"
3781 msgstr ""
3782
3783 #. type: =head1
3784 #: ../examples/guestfs-recipes.pod:261
3785 msgid "List applications installed in a VM"
3786 msgstr ""
3787
3788 #. type: textblock
3789 #: ../examples/guestfs-recipes.pod:263
3790 msgid "Save the following to a file C<list-apps.sh>:"
3791 msgstr ""
3792
3793 #. type: verbatim
3794 #: ../examples/guestfs-recipes.pod:265
3795 #, no-wrap
3796 msgid ""
3797 " #!/bin/sh -\n"
3798 " set -e\n"
3799 " eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
3800 " root=\"$(guestfish --remote inspect-get-roots)\"\n"
3801 " guestfish --remote inspect-list-applications \"$root\"\n"
3802 " guestfish --remote exit\n"
3803 "\n"
3804 msgstr ""
3805
3806 #. type: textblock
3807 #: ../examples/guestfs-recipes.pod:272
3808 msgid ""
3809 "Make the file executable and then you can run it on any named virtual "
3810 "machine:"
3811 msgstr ""
3812
3813 #. type: verbatim
3814 #: ../examples/guestfs-recipes.pod:275
3815 #, no-wrap
3816 msgid ""
3817 " # list-apps.sh WinGuest\n"
3818 " [0] = {\n"
3819 "   app_name: Mozilla Firefox (3.6.12)\n"
3820 "   app_display_name: Mozilla Firefox (3.6.12)\n"
3821 "   app_epoch: 0\n"
3822 "   app_version: 3.6.12 (en-GB)\n"
3823 "   app_release:\n"
3824 "   app_install_path: C:\\Program Files\\Mozilla Firefox\n"
3825 "   app_trans_path:\n"
3826 "   app_publisher: Mozilla\n"
3827 "   app_url: http://www.mozilla.com/en-GB/\n"
3828 "   app_source_package:\n"
3829 "   app_summary:\n"
3830 "   app_description: Mozilla Firefox\n"
3831 " }\n"
3832 " [1] = {\n"
3833 "   app_name: VLC media player\n"
3834 "   app_display_name: VLC media player 1.1.5\n"
3835 "   app_epoch: 0\n"
3836 "   app_version: 1.1.5\n"
3837 "   app_release:\n"
3838 "   app_install_path: C:\\Program Files\\VideoLAN\\VLC\n"
3839 "   app_trans_path:\n"
3840 "   app_publisher: VideoLAN\n"
3841 "   app_url: http://www.videolan.org/\n"
3842 "   app_source_package:\n"
3843 "   app_summary:\n"
3844 "   app_description:\n"
3845 " }\n"
3846 "\n"
3847 msgstr ""
3848
3849 #. type: textblock
3850 #: ../examples/guestfs-recipes.pod:305
3851 msgid ""
3852 "If you want to run the script on disk images (instead of libvirt virtual "
3853 "machines), change C<-d \"$1\"> to C<-a \"$1\">.  See also L<virt-inspector(1)"
3854 ">."
3855 msgstr ""
3856
3857 #. type: =head1
3858 #: ../examples/guestfs-recipes.pod:309
3859 msgid "List files and directories in a VM"
3860 msgstr ""
3861
3862 #. type: textblock
3863 #: ../examples/guestfs-recipes.pod:311
3864 msgid "This involves using the L<guestfish(1)> C<find0> command like this:"
3865 msgstr ""
3866
3867 #. type: verbatim
3868 #: ../examples/guestfs-recipes.pod:313
3869 #, no-wrap
3870 msgid ""
3871 " guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n"
3872 "\n"
3873 msgstr ""
3874
3875 #. type: =head1
3876 #: ../examples/guestfs-recipes.pod:315
3877 msgid "List services in a Windows VM"
3878 msgstr ""
3879
3880 #. type: textblock
3881 #: ../examples/guestfs-recipes.pod:317
3882 msgid ""
3883 "The link below contains a script that can be used to list out the services "
3884 "from a Windows VM, and whether those services run at boot time or are loaded "
3885 "on demand."
3886 msgstr ""
3887
3888 #. type: textblock
3889 #: ../examples/guestfs-recipes.pod:321
3890 msgid ""
3891 "https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/"
3892 "#content"
3893 msgstr ""
3894
3895 #. type: =head1
3896 #: ../examples/guestfs-recipes.pod:323
3897 msgid "Make a disk image sparse"
3898 msgstr ""
3899
3900 #. type: textblock
3901 #: ../examples/guestfs-recipes.pod:325
3902 msgid ""
3903 "The link below contains some guides for making a disk image sparse (or "
3904 "reintroducing sparseness)."
3905 msgstr ""
3906
3907 #. type: textblock
3908 #: ../examples/guestfs-recipes.pod:328
3909 msgid ""
3910 "https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content"
3911 msgstr ""
3912
3913 #. type: =head1
3914 #: ../examples/guestfs-recipes.pod:330
3915 msgid "Monitor disk usage over time"
3916 msgstr ""
3917
3918 #. type: textblock
3919 #: ../examples/guestfs-recipes.pod:332
3920 msgid ""
3921 "You can use L<virt-df(1)> to monitor disk usage of your guests over time.  "
3922 "The link below contains a guide."
3923 msgstr ""
3924
3925 #. type: textblock
3926 #: ../examples/guestfs-recipes.pod:335
3927 msgid "http://virt-tools.org/learning/advanced-virt-df/"
3928 msgstr ""
3929
3930 #. type: =head1
3931 #: ../examples/guestfs-recipes.pod:337
3932 msgid "Reading the Windows Event Log from Windows Vista (or later)"
3933 msgstr ""
3934
3935 #. type: textblock
3936 #: ../examples/guestfs-recipes.pod:339
3937 msgid ""
3938 "L<guestfish(1)> plus the tools described in the link below can be used to "
3939 "read out the Windows Event Log from any virtual machine running Windows "
3940 "Vista or a later version."
3941 msgstr ""
3942
3943 #. type: textblock
3944 #: ../examples/guestfs-recipes.pod:343
3945 msgid ""
3946 "https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-"
3947 "guestfish/#content"
3948 msgstr ""
3949
3950 #. type: =head1
3951 #: ../examples/guestfs-recipes.pod:345
3952 msgid "Remove root password (Linux)"
3953 msgstr ""
3954
3955 #. type: textblock
3956 #: ../examples/guestfs-recipes.pod:347
3957 msgid ""
3958 "Using the L<virt-edit(1)> I<-e> option you can do simple replacements on "
3959 "files.  One use is to remove the root password from a Linux guest:"
3960 msgstr ""
3961
3962 #. type: verbatim
3963 #: ../examples/guestfs-recipes.pod:350
3964 #, no-wrap
3965 msgid ""
3966 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
3967 "\n"
3968 msgstr ""
3969
3970 #. type: =head1
3971 #: ../examples/guestfs-recipes.pod:352
3972 msgid "Remove Administrator password (Windows)"
3973 msgstr ""
3974
3975 #. type: textblock
3976 #: ../examples/guestfs-recipes.pod:354
3977 msgid ""
3978 "The link below contains one technique for removing the Administrator "
3979 "password from a Windows VM, or to be more precise, it gives you a command "
3980 "prompt the next time you log in which you can use to bypass any security:"
3981 msgstr ""
3982
3983 #. type: textblock
3984 #: ../examples/guestfs-recipes.pod:359
3985 msgid ""
3986 "https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-"
3987 "administrator-password-with-guestfish/"
3988 msgstr ""
3989
3990 #. type: =head1
3991 #: ../examples/guestfs-recipes.pod:361
3992 msgid "Unpack a live CD"
3993 msgstr ""
3994
3995 #. type: textblock
3996 #: ../examples/guestfs-recipes.pod:363
3997 msgid ""
3998 "Linux live CDs often contain multiple layers of disk images wrapped like a "
3999 "Russian doll.  You can use L<guestfish(1)> to look inside these multiple "
4000 "layers, as outlined in the guide below."
4001 msgstr ""
4002
4003 #. type: textblock
4004 #: ../examples/guestfs-recipes.pod:367
4005 msgid ""
4006 "https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-"
4007 "cd/#content"
4008 msgstr ""
4009
4010 #. type: =head1
4011 #: ../examples/guestfs-recipes.pod:369
4012 msgid "Uploading and downloading files"
4013 msgstr ""
4014
4015 #. type: textblock
4016 #: ../examples/guestfs-recipes.pod:371
4017 msgid ""
4018 "The link below contains general tips on uploading (copying in)  and "
4019 "downloading (copying out) files from VMs."
4020 msgstr ""
4021
4022 #. type: textblock
4023 #: ../examples/guestfs-recipes.pod:374
4024 msgid ""
4025 "https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content"
4026 msgstr ""
4027
4028 #. type: =head1
4029 #: ../examples/guestfs-recipes.pod:376
4030 msgid "Use libguestfs tools on VMware ESX guests"
4031 msgstr ""
4032
4033 #. type: textblock
4034 #: ../examples/guestfs-recipes.pod:378
4035 msgid ""
4036 "The link below explains how to use libguestfs, L<guestfish(1)> and the virt "
4037 "tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs."
4038 msgstr ""
4039
4040 #. type: textblock
4041 #: ../examples/guestfs-recipes.pod:382
4042 msgid ""
4043 "https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-"
4044 "guests/#content"
4045 msgstr ""
4046
4047 #. type: textblock
4048 #: ../examples/guestfs-recipes.pod:386
4049 msgid ""
4050 "L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, "
4051 "L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-ruby"
4052 "(3)>, L<http://libguestfs.org/>."
4053 msgstr ""
4054
4055 #. type: textblock
4056 #: ../examples/guestfs-recipes.pod:402
4057 msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
4058 msgstr ""
4059
4060 #. type: =head2
4061 #: ../fish/guestfish-actions.pod:1
4062 msgid "add-cdrom"
4063 msgstr ""
4064
4065 #. type: verbatim
4066 #: ../fish/guestfish-actions.pod:3
4067 #, no-wrap
4068 msgid ""
4069 " add-cdrom filename\n"
4070 "\n"
4071 msgstr ""
4072
4073 #. type: textblock
4074 #: ../fish/guestfish-actions.pod:5 ../src/guestfs-actions.pod:7
4075 msgid "This function adds a virtual CD-ROM disk image to the guest."
4076 msgstr ""
4077
4078 #. type: textblock
4079 #: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:9
4080 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
4081 msgstr ""
4082
4083 #. type: textblock
4084 #: ../fish/guestfish-actions.pod:15
4085 msgid ""
4086 "This call checks for the existence of C<filename>.  This stops you from "
4087 "specifying other types of drive which are supported by qemu such as C<nbd:> "
4088 "and C<http:> URLs.  To specify those, use the general L</config> call "
4089 "instead."
4090 msgstr ""
4091
4092 #. type: textblock
4093 #: ../fish/guestfish-actions.pod:22
4094 msgid ""
4095 "If you just want to add an ISO file (often you use this as an efficient way "
4096 "to transfer large files into the guest), then you should probably use L</add-"
4097 "drive-ro> instead."
4098 msgstr ""
4099
4100 #. type: textblock
4101 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163
4102 #: ../fish/guestfish-actions.pod:177 ../src/guestfs-actions.pod:32
4103 #: ../src/guestfs-actions.pod:254 ../src/guestfs-actions.pod:275
4104 msgid ""
4105 "This function is deprecated.  In new code, use the C<add_drive_opts> call "
4106 "instead."
4107 msgstr ""
4108
4109 #. type: textblock
4110 #: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166
4111 #: ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:986
4112 #: ../fish/guestfish-actions.pod:1346 ../fish/guestfish-actions.pod:1360
4113 #: ../fish/guestfish-actions.pod:3085 ../fish/guestfish-actions.pod:3292
4114 #: ../fish/guestfish-actions.pod:3406 ../fish/guestfish-actions.pod:3454
4115 #: ../fish/guestfish-actions.pod:4355 ../fish/guestfish-actions.pod:4378
4116 #: ../fish/guestfish-actions.pod:4400 ../fish/guestfish-actions.pod:4438
4117 #: ../fish/guestfish-actions.pod:5087 ../fish/guestfish-actions.pod:5185
4118 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257
4119 #: ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1513
4120 #: ../src/guestfs-actions.pod:2008 ../src/guestfs-actions.pod:2029
4121 #: ../src/guestfs-actions.pod:4628 ../src/guestfs-actions.pod:4947
4122 #: ../src/guestfs-actions.pod:5165 ../src/guestfs-actions.pod:5255
4123 #: ../src/guestfs-actions.pod:6544 ../src/guestfs-actions.pod:6574
4124 #: ../src/guestfs-actions.pod:6607 ../src/guestfs-actions.pod:6666
4125 #: ../src/guestfs-actions.pod:7602 ../src/guestfs-actions.pod:7714
4126 #: ../src/guestfs-actions.pod:7884
4127 msgid ""
4128 "Deprecated functions will not be removed from the API, but the fact that "
4129 "they are deprecated indicates that there are problems with correct use of "
4130 "these functions."
4131 msgstr ""
4132
4133 #. type: =head2
4134 #: ../fish/guestfish-actions.pod:35
4135 msgid "add-domain"
4136 msgstr ""
4137
4138 #. type: =head2
4139 #: ../fish/guestfish-actions.pod:37
4140 msgid "domain"
4141 msgstr ""
4142
4143 #. type: verbatim
4144 #: ../fish/guestfish-actions.pod:39
4145 #, no-wrap
4146 msgid ""
4147 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n"
4148 "\n"
4149 msgstr ""
4150
4151 #. type: textblock
4152 #: ../fish/guestfish-actions.pod:41
4153 msgid ""
4154 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
4155 "It works by connecting to libvirt, requesting the domain and domain XML from "
4156 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
4157 msgstr ""
4158
4159 #. type: textblock
4160 #: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:64
4161 msgid ""
4162 "The number of disks added is returned.  This operation is atomic: if an "
4163 "error is returned, then no disks are added."
4164 msgstr ""
4165
4166 #. type: textblock
4167 #: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:67
4168 msgid ""
4169 "This function does some minimal checks to make sure the libvirt domain is "
4170 "not running (unless C<readonly> is true).  In a future version we will try "
4171 "to acquire the libvirt lock on each disk."
4172 msgstr ""
4173
4174 #. type: textblock
4175 #: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:71
4176 msgid ""
4177 "Disks must be accessible locally.  This often means that adding disks from a "
4178 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
4179 "unless those disks are accessible via the same device path locally too."
4180 msgstr ""
4181
4182 #. type: textblock
4183 #: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:76
4184 msgid ""
4185 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
4186 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
4187 "libvirt URI (or one set through an environment variable, see the libvirt "
4188 "documentation for full details)."
4189 msgstr ""
4190
4191 #. type: textblock
4192 #: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:82
4193 msgid ""
4194 "The optional C<live> flag controls whether this call will try to connect to "
4195 "a running virtual machine C<guestfsd> process if it sees a suitable "
4196 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
4197 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
4198 "DAEMONS> for more information."
4199 msgstr ""
4200
4201 #. type: textblock
4202 #: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:89
4203 msgid ""
4204 "If the C<allowuuid> flag is true (default is false) then a UUID I<may> be "
4205 "passed instead of the domain name.  The C<dom> string is treated as a UUID "
4206 "first and looked up, and if that lookup fails then we treat C<dom> as a name "
4207 "as usual."
4208 msgstr ""
4209
4210 #. type: textblock
4211 #: ../fish/guestfish-actions.pod:76
4212 msgid ""
4213 "The other optional parameters are passed directly through to L</add-drive-"
4214 "opts>."
4215 msgstr ""
4216
4217 #. type: textblock
4218 #: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:143
4219 #: ../fish/guestfish-actions.pod:568 ../fish/guestfish-actions.pod:1968
4220 #: ../fish/guestfish-actions.pod:3134 ../fish/guestfish-actions.pod:3307
4221 #: ../fish/guestfish-actions.pod:3442
4222 msgid ""
4223 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
4224 msgstr ""
4225
4226 #. type: =head2
4227 #: ../fish/guestfish-actions.pod:81
4228 msgid "add-drive"
4229 msgstr ""
4230
4231 #. type: verbatim
4232 #: ../fish/guestfish-actions.pod:83
4233 #, no-wrap
4234 msgid ""
4235 " add-drive filename\n"
4236 "\n"
4237 msgstr ""
4238
4239 #. type: textblock
4240 #: ../fish/guestfish-actions.pod:85
4241 msgid ""
4242 "This function is the equivalent of calling L</add-drive-opts> with no "
4243 "optional parameters, so the disk is added writable, with the format being "
4244 "detected automatically."
4245 msgstr ""
4246
4247 #. type: textblock
4248 #: ../fish/guestfish-actions.pod:89
4249 msgid ""
4250 "Automatic detection of the format opens you up to a potential security hole "
4251 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
4252 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
4253 "you should think about replacing calls to this function with calls to L</add-"
4254 "drive-opts>, and specifying the format."
4255 msgstr ""
4256
4257 #. type: =head2
4258 #: ../fish/guestfish-actions.pod:96
4259 msgid "add-drive-opts"
4260 msgstr ""
4261
4262 #. type: =head2
4263 #: ../fish/guestfish-actions.pod:98
4264 msgid "add"
4265 msgstr ""
4266
4267 #. type: verbatim
4268 #: ../fish/guestfish-actions.pod:100
4269 #, no-wrap
4270 msgid ""
4271 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
4272 "\n"
4273 msgstr ""
4274
4275 #. type: textblock
4276 #: ../fish/guestfish-actions.pod:102 ../src/guestfs-actions.pod:160
4277 msgid ""
4278 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
4279 "The first time you call this function, the disk appears as C</dev/sda>, the "
4280 "second time as C</dev/sdb>, and so on."
4281 msgstr ""
4282
4283 #. type: textblock
4284 #: ../fish/guestfish-actions.pod:107 ../src/guestfs-actions.pod:165
4285 msgid ""
4286 "You don't necessarily need to be root when using libguestfs.  However you "
4287 "obviously do need sufficient permissions to access the filename for whatever "
4288 "operations you want to perform (ie. read access if you just want to read the "
4289 "image or write access if you want to modify the image)."
4290 msgstr ""
4291
4292 #. type: textblock
4293 #: ../fish/guestfish-actions.pod:113 ../src/guestfs-actions.pod:171
4294 msgid "This call checks that C<filename> exists."
4295 msgstr ""
4296
4297 #. type: textblock
4298 #: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3096
4299 #: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4655
4300 msgid "The optional arguments are:"
4301 msgstr ""
4302
4303 #. type: =item
4304 #: ../fish/guestfish-actions.pod:119 ../src/guestfs-actions.pod:177
4305 msgid "C<readonly>"
4306 msgstr ""
4307
4308 #. type: textblock
4309 #: ../fish/guestfish-actions.pod:121 ../src/guestfs-actions.pod:179
4310 msgid ""
4311 "If true then the image is treated as read-only.  Writes are still allowed, "
4312 "but they are stored in a temporary snapshot overlay which is discarded at "
4313 "the end.  The disk that you add is not modified."
4314 msgstr ""
4315
4316 #. type: =item
4317 #: ../fish/guestfish-actions.pod:125 ../src/guestfs-actions.pod:183
4318 msgid "C<format>"
4319 msgstr ""
4320
4321 #. type: textblock
4322 #: ../fish/guestfish-actions.pod:127
4323 msgid ""
4324 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
4325 "add-drive-ro>) then the format is automatically detected.  Possible formats "
4326 "include C<raw> and C<qcow2>."
4327 msgstr ""
4328
4329 #. type: textblock
4330 #: ../fish/guestfish-actions.pod:131 ../src/guestfs-actions.pod:189
4331 msgid ""
4332 "Automatic detection of the format opens you up to a potential security hole "
4333 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
4334 "RHBZ#642934.  Specifying the format closes this security hole."
4335 msgstr ""
4336
4337 #. type: =item
4338 #: ../fish/guestfish-actions.pod:136 ../src/guestfs-actions.pod:194
4339 msgid "C<iface>"
4340 msgstr ""
4341
4342 #. type: textblock
4343 #: ../fish/guestfish-actions.pod:138
4344 msgid ""
4345 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
4346 "add-drive-with-if> call (q.v.)"
4347 msgstr ""
4348
4349 #. type: =head2
4350 #: ../fish/guestfish-actions.pod:145
4351 msgid "add-drive-ro"
4352 msgstr ""
4353
4354 #. type: =head2
4355 #: ../fish/guestfish-actions.pod:147
4356 msgid "add-ro"
4357 msgstr ""
4358
4359 #. type: verbatim
4360 #: ../fish/guestfish-actions.pod:149
4361 #, no-wrap
4362 msgid ""
4363 " add-drive-ro filename\n"
4364 "\n"
4365 msgstr ""
4366
4367 #. type: textblock
4368 #: ../fish/guestfish-actions.pod:151
4369 msgid ""
4370 "This function is the equivalent of calling L</add-drive-opts> with the "
4371 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
4372 "is added read-only, with the format being detected automatically."
4373 msgstr ""
4374
4375 #. type: =head2
4376 #: ../fish/guestfish-actions.pod:156
4377 msgid "add-drive-ro-with-if"
4378 msgstr ""
4379
4380 #. type: verbatim
4381 #: ../fish/guestfish-actions.pod:158
4382 #, no-wrap
4383 msgid ""
4384 " add-drive-ro-with-if filename iface\n"
4385 "\n"
4386 msgstr ""
4387
4388 #. type: textblock
4389 #: ../fish/guestfish-actions.pod:160
4390 msgid ""
4391 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
4392 "interface emulation to use at run time."
4393 msgstr ""
4394
4395 #. type: =head2
4396 #: ../fish/guestfish-actions.pod:170
4397 msgid "add-drive-with-if"
4398 msgstr ""
4399
4400 #. type: verbatim
4401 #: ../fish/guestfish-actions.pod:172
4402 #, no-wrap
4403 msgid ""
4404 " add-drive-with-if filename iface\n"
4405 "\n"
4406 msgstr ""
4407
4408 #. type: textblock
4409 #: ../fish/guestfish-actions.pod:174
4410 msgid ""
4411 "This is the same as L</add-drive> but it allows you to specify the QEMU "
4412 "interface emulation to use at run time."
4413 msgstr ""
4414
4415 #. type: =head2
4416 #: ../fish/guestfish-actions.pod:184
4417 msgid "aug-clear"
4418 msgstr ""
4419
4420 #. type: verbatim
4421 #: ../fish/guestfish-actions.pod:186
4422 #, no-wrap
4423 msgid ""
4424 " aug-clear augpath\n"
4425 "\n"
4426 msgstr ""
4427
4428 #. type: textblock
4429 #: ../fish/guestfish-actions.pod:188 ../src/guestfs-actions.pod:290
4430 msgid ""
4431 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
4432 "L<augtool(1)> C<clear> command."
4433 msgstr ""
4434
4435 #. type: =head2
4436 #: ../fish/guestfish-actions.pod:191
4437 msgid "aug-close"
4438 msgstr ""
4439
4440 #. type: verbatim
4441 #: ../fish/guestfish-actions.pod:193
4442 #, no-wrap
4443 msgid ""
4444 " aug-close\n"
4445 "\n"
4446 msgstr ""
4447
4448 #. type: textblock
4449 #: ../fish/guestfish-actions.pod:195
4450 msgid ""
4451 "Close the current Augeas handle and free up any resources used by it.  After "
4452 "calling this, you have to call L</aug-init> again before you can use any "
4453 "other Augeas functions."
4454 msgstr ""
4455
4456 #. type: =head2
4457 #: ../fish/guestfish-actions.pod:200
4458 msgid "aug-defnode"
4459 msgstr ""
4460
4461 #. type: verbatim
4462 #: ../fish/guestfish-actions.pod:202
4463 #, no-wrap
4464 msgid ""
4465 " aug-defnode name expr val\n"
4466 "\n"
4467 msgstr ""
4468
4469 #. type: textblock
4470 #: ../fish/guestfish-actions.pod:204 ../src/guestfs-actions.pod:319
4471 msgid ""
4472 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
4473 msgstr ""
4474
4475 #. type: textblock
4476 #: ../fish/guestfish-actions.pod:207
4477 msgid ""
4478 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
4479 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
4480 "containing that single node."
4481 msgstr ""
4482
4483 #. type: textblock
4484 #: ../fish/guestfish-actions.pod:211 ../src/guestfs-actions.pod:326
4485 msgid ""
4486 "On success this returns a pair containing the number of nodes in the "
4487 "nodeset, and a boolean flag if a node was created."
4488 msgstr ""
4489
4490 #. type: =head2
4491 #: ../fish/guestfish-actions.pod:215
4492 msgid "aug-defvar"
4493 msgstr ""
4494
4495 #. type: verbatim
4496 #: ../fish/guestfish-actions.pod:217
4497 #, no-wrap
4498 msgid ""
4499 " aug-defvar name expr\n"
4500 "\n"
4501 msgstr ""
4502
4503 #. type: textblock
4504 #: ../fish/guestfish-actions.pod:219 ../src/guestfs-actions.pod:343
4505 msgid ""
4506 "Defines an Augeas variable C<name> whose value is the result of evaluating "
4507 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
4508 msgstr ""
4509
4510 #. type: textblock
4511 #: ../fish/guestfish-actions.pod:223 ../src/guestfs-actions.pod:347
4512 msgid ""
4513 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
4514 "evaluates to something which is not a nodeset."
4515 msgstr ""
4516
4517 #. type: =head2
4518 #: ../fish/guestfish-actions.pod:226
4519 msgid "aug-get"
4520 msgstr ""
4521
4522 #. type: verbatim
4523 #: ../fish/guestfish-actions.pod:228
4524 #, no-wrap
4525 msgid ""
4526 " aug-get augpath\n"
4527 "\n"
4528 msgstr ""
4529
4530 #. type: textblock
4531 #: ../fish/guestfish-actions.pod:230 ../src/guestfs-actions.pod:360
4532 msgid ""
4533 "Look up the value associated with C<path>.  If C<path> matches exactly one "
4534 "node, the C<value> is returned."
4535 msgstr ""
4536
4537 #. type: =head2
4538 #: ../fish/guestfish-actions.pod:233
4539 msgid "aug-init"
4540 msgstr ""
4541
4542 #. type: verbatim
4543 #: ../fish/guestfish-actions.pod:235
4544 #, no-wrap
4545 msgid ""
4546 " aug-init root flags\n"
4547 "\n"
4548 msgstr ""
4549
4550 #. type: textblock
4551 #: ../fish/guestfish-actions.pod:237 ../src/guestfs-actions.pod:375
4552 msgid ""
4553 "Create a new Augeas handle for editing configuration files.  If there was "
4554 "any previous Augeas handle associated with this guestfs session, then it is "
4555 "closed."
4556 msgstr ""
4557
4558 #. type: textblock
4559 #: ../fish/guestfish-actions.pod:241
4560 msgid "You must call this before using any other L</aug-*> commands."
4561 msgstr ""
4562
4563 #. type: textblock
4564 #: ../fish/guestfish-actions.pod:244 ../src/guestfs-actions.pod:382
4565 msgid ""
4566 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
4567 msgstr ""
4568
4569 #. type: textblock
4570 #: ../fish/guestfish-actions.pod:247 ../src/guestfs-actions.pod:385
4571 msgid ""
4572 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
4573 "logical I<or> of the following integers:"
4574 msgstr ""
4575
4576 #. type: =item
4577 #: ../fish/guestfish-actions.pod:253 ../src/guestfs-actions.pod:391
4578 msgid "C<AUG_SAVE_BACKUP> = 1"
4579 msgstr ""
4580
4581 #. type: textblock
4582 #: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:393
4583 msgid "Keep the original file with a C<.augsave> extension."
4584 msgstr ""
4585
4586 #. type: =item
4587 #: ../fish/guestfish-actions.pod:257 ../src/guestfs-actions.pod:395
4588 msgid "C<AUG_SAVE_NEWFILE> = 2"
4589 msgstr ""
4590
4591 #. type: textblock
4592 #: ../fish/guestfish-actions.pod:259 ../src/guestfs-actions.pod:397
4593 msgid ""
4594 "Save changes into a file with extension C<.augnew>, and do not overwrite "
4595 "original.  Overrides C<AUG_SAVE_BACKUP>."
4596 msgstr ""
4597
4598 #. type: =item
4599 #: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:400
4600 msgid "C<AUG_TYPE_CHECK> = 4"
4601 msgstr ""
4602
4603 #. type: textblock
4604 #: ../fish/guestfish-actions.pod:264 ../src/guestfs-actions.pod:402
4605 msgid "Typecheck lenses (can be expensive)."
4606 msgstr ""
4607
4608 #. type: =item
4609 #: ../fish/guestfish-actions.pod:266 ../src/guestfs-actions.pod:404
4610 msgid "C<AUG_NO_STDINC> = 8"
4611 msgstr ""
4612
4613 #. type: textblock
4614 #: ../fish/guestfish-actions.pod:268 ../src/guestfs-actions.pod:406
4615 msgid "Do not use standard load path for modules."
4616 msgstr ""
4617
4618 #. type: =item
4619 #: ../fish/guestfish-actions.pod:270 ../src/guestfs-actions.pod:408
4620 msgid "C<AUG_SAVE_NOOP> = 16"
4621 msgstr ""
4622
4623 #. type: textblock
4624 #: ../fish/guestfish-actions.pod:272 ../src/guestfs-actions.pod:410
4625 msgid "Make save a no-op, just record what would have been changed."
4626 msgstr ""
4627
4628 #. type: =item
4629 #: ../fish/guestfish-actions.pod:274 ../src/guestfs-actions.pod:412
4630 msgid "C<AUG_NO_LOAD> = 32"
4631 msgstr ""
4632
4633 #. type: textblock
4634 #: ../fish/guestfish-actions.pod:276
4635 msgid "Do not load the tree in L</aug-init>."
4636 msgstr ""
4637
4638 #. type: textblock
4639 #: ../fish/guestfish-actions.pod:280
4640 msgid "To close the handle, you can call L</aug-close>."
4641 msgstr ""
4642
4643 #. type: textblock
4644 #: ../fish/guestfish-actions.pod:282 ../src/guestfs-actions.pod:420
4645 msgid "To find out more about Augeas, see L<http://augeas.net/>."
4646 msgstr ""
4647
4648 #. type: =head2
4649 #: ../fish/guestfish-actions.pod:284
4650 msgid "aug-insert"
4651 msgstr ""
4652
4653 #. type: verbatim
4654 #: ../fish/guestfish-actions.pod:286
4655 #, no-wrap
4656 msgid ""
4657 " aug-insert augpath label true|false\n"
4658 "\n"
4659 msgstr ""
4660
4661 #. type: textblock
4662 #: ../fish/guestfish-actions.pod:288 ../src/guestfs-actions.pod:434
4663 msgid ""
4664 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
4665 "or after C<path> (depending on the boolean flag C<before>)."
4666 msgstr ""
4667
4668 #. type: textblock
4669 #: ../fish/guestfish-actions.pod:292 ../src/guestfs-actions.pod:438
4670 msgid ""
4671 "C<path> must match exactly one existing node in the tree, and C<label> must "
4672 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
4673 msgstr ""
4674
4675 #. type: =head2
4676 #: ../fish/guestfish-actions.pod:296
4677 msgid "aug-load"
4678 msgstr ""
4679
4680 #. type: verbatim
4681 #: ../fish/guestfish-actions.pod:298
4682 #, no-wrap
4683 msgid ""
4684 " aug-load\n"
4685 "\n"
4686 msgstr ""
4687
4688 #. type: textblock
4689 #: ../fish/guestfish-actions.pod:300 ../src/guestfs-actions.pod:451
4690 msgid "Load files into the tree."
4691 msgstr ""
4692
4693 #. type: textblock
4694 #: ../fish/guestfish-actions.pod:302 ../src/guestfs-actions.pod:453
4695 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
4696 msgstr ""
4697
4698 #. type: =head2
4699 #: ../fish/guestfish-actions.pod:305
4700 msgid "aug-ls"
4701 msgstr ""
4702
4703 #. type: verbatim
4704 #: ../fish/guestfish-actions.pod:307
4705 #, no-wrap
4706 msgid ""
4707 " aug-ls augpath\n"
4708 "\n"
4709 msgstr ""
4710
4711 #. type: textblock
4712 #: ../fish/guestfish-actions.pod:309
4713 msgid ""
4714 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
4715 "resulting nodes into alphabetical order."
4716 msgstr ""
4717
4718 #. type: =head2
4719 #: ../fish/guestfish-actions.pod:312
4720 msgid "aug-match"
4721 msgstr ""
4722
4723 #. type: verbatim
4724 #: ../fish/guestfish-actions.pod:314
4725 #, no-wrap
4726 msgid ""
4727 " aug-match augpath\n"
4728 "\n"
4729 msgstr ""
4730
4731 #. type: textblock
4732 #: ../fish/guestfish-actions.pod:316 ../src/guestfs-actions.pod:481
4733 msgid ""
4734 "Returns a list of paths which match the path expression C<path>.  The "
4735 "returned paths are sufficiently qualified so that they match exactly one "
4736 "node in the current tree."
4737 msgstr ""
4738
4739 #. type: =head2
4740 #: ../fish/guestfish-actions.pod:320
4741 msgid "aug-mv"
4742 msgstr ""
4743
4744 #. type: verbatim
4745 #: ../fish/guestfish-actions.pod:322
4746 #, no-wrap
4747 msgid ""
4748 " aug-mv src dest\n"
4749 "\n"
4750 msgstr ""
4751
4752 #. type: textblock
4753 #: ../fish/guestfish-actions.pod:324 ../src/guestfs-actions.pod:498
4754 msgid ""
4755 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
4756 "C<dest> is overwritten if it exists."
4757 msgstr ""
4758
4759 #. type: =head2
4760 #: ../fish/guestfish-actions.pod:327
4761 msgid "aug-rm"
4762 msgstr ""
4763
4764 #. type: verbatim
4765 #: ../fish/guestfish-actions.pod:329
4766 #, no-wrap
4767 msgid ""
4768 " aug-rm augpath\n"
4769 "\n"
4770 msgstr ""
4771
4772 #. type: textblock
4773 #: ../fish/guestfish-actions.pod:331 ../src/guestfs-actions.pod:511
4774 msgid "Remove C<path> and all of its children."
4775 msgstr ""
4776
4777 #. type: textblock
4778 #: ../fish/guestfish-actions.pod:333 ../src/guestfs-actions.pod:513
4779 msgid "On success this returns the number of entries which were removed."
4780 msgstr ""
4781
4782 #. type: =head2
4783 #: ../fish/guestfish-actions.pod:335
4784 msgid "aug-save"
4785 msgstr ""
4786
4787 #. type: verbatim
4788 #: ../fish/guestfish-actions.pod:337
4789 #, no-wrap
4790 msgid ""
4791 " aug-save\n"
4792 "\n"
4793 msgstr ""
4794
4795 #. type: textblock
4796 #: ../fish/guestfish-actions.pod:339 ../src/guestfs-actions.pod:524
4797 msgid "This writes all pending changes to disk."
4798 msgstr ""
4799
4800 #. type: textblock
4801 #: ../fish/guestfish-actions.pod:341
4802 msgid ""
4803 "The flags which were passed to L</aug-init> affect exactly how files are "
4804 "saved."
4805 msgstr ""
4806
4807 #. type: =head2
4808 #: ../fish/guestfish-actions.pod:344
4809 msgid "aug-set"
4810 msgstr ""
4811
4812 #. type: verbatim
4813 #: ../fish/guestfish-actions.pod:346
4814 #, no-wrap
4815 msgid ""
4816 " aug-set augpath val\n"
4817 "\n"
4818 msgstr ""
4819
4820 #. type: textblock
4821 #: ../fish/guestfish-actions.pod:348 ../src/guestfs-actions.pod:540
4822 msgid "Set the value associated with C<path> to C<val>."
4823 msgstr ""
4824
4825 #. type: textblock
4826 #: ../fish/guestfish-actions.pod:350
4827 msgid ""
4828 "In the Augeas API, it is possible to clear a node by setting the value to "
4829 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
4830 "this call.  Instead you must use the L</aug-clear> call."
4831 msgstr ""
4832
4833 #. type: =head2
4834 #: ../fish/guestfish-actions.pod:355
4835 msgid "available"
4836 msgstr ""
4837
4838 #. type: verbatim
4839 #: ../fish/guestfish-actions.pod:357
4840 #, no-wrap
4841 msgid ""
4842 " available 'groups ...'\n"
4843 "\n"
4844 msgstr ""
4845
4846 #. type: textblock
4847 #: ../fish/guestfish-actions.pod:359 ../src/guestfs-actions.pod:557
4848 msgid ""
4849 "This command is used to check the availability of some groups of "
4850 "functionality in the appliance, which not all builds of the libguestfs "
4851 "appliance will be able to provide."
4852 msgstr ""
4853
4854 #. type: textblock
4855 #: ../fish/guestfish-actions.pod:363
4856 msgid ""
4857 "The libguestfs groups, and the functions that those groups correspond to, "
4858 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
4859 "runtime by calling L</available-all-groups>."
4860 msgstr ""
4861
4862 #. type: textblock
4863 #: ../fish/guestfish-actions.pod:368 ../src/guestfs-actions.pod:566
4864 msgid ""
4865 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
4866 "\"]> would check for the availability of the Linux inotify functions and "
4867 "Augeas (configuration file editing) functions."
4868 msgstr ""
4869
4870 #. type: textblock
4871 #: ../fish/guestfish-actions.pod:373 ../src/guestfs-actions.pod:571
4872 msgid "The command returns no error if I<all> requested groups are available."
4873 msgstr ""
4874
4875 #. type: textblock
4876 #: ../fish/guestfish-actions.pod:375 ../src/guestfs-actions.pod:573
4877 msgid ""
4878 "It fails with an error if one or more of the requested groups is unavailable "
4879 "in the appliance."
4880 msgstr ""
4881
4882 #. type: textblock
4883 #: ../fish/guestfish-actions.pod:378 ../src/guestfs-actions.pod:576
4884 msgid ""
4885 "If an unknown group name is included in the list of groups then an error is "
4886 "always returned."
4887 msgstr ""
4888
4889 #. type: textblock
4890 #: ../fish/guestfish-actions.pod:381 ../src/guestfs-actions.pod:579
4891 msgid "I<Notes:>"
4892 msgstr ""
4893
4894 #. type: textblock
4895 #: ../fish/guestfish-actions.pod:387
4896 msgid "You must call L</launch> before calling this function."
4897 msgstr ""
4898
4899 #. type: textblock
4900 #: ../fish/guestfish-actions.pod:389 ../src/guestfs-actions.pod:587
4901 msgid ""
4902 "The reason is because we don't know what groups are supported by the "
4903 "appliance/daemon until it is running and can be queried."
4904 msgstr ""
4905
4906 #. type: textblock
4907 #: ../fish/guestfish-actions.pod:395 ../src/guestfs-actions.pod:593
4908 msgid ""
4909 "If a group of functions is available, this does not necessarily mean that "
4910 "they will work.  You still have to check for errors when calling individual "
4911 "API functions even if they are available."
4912 msgstr ""
4913
4914 #. type: textblock
4915 #: ../fish/guestfish-actions.pod:402 ../src/guestfs-actions.pod:600
4916 msgid ""
4917 "It is usually the job of distro packagers to build complete functionality "
4918 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
4919 "with all requirements satisfied, will support everything."
4920 msgstr ""
4921
4922 #. type: textblock
4923 #: ../fish/guestfish-actions.pod:409
4924 msgid ""
4925 "This call was added in version C<1.0.80>.  In previous versions of "
4926 "libguestfs all you could do would be to speculatively execute a command to "
4927 "find out if the daemon implemented it.  See also L</version>."
4928 msgstr ""
4929
4930 #. type: =head2
4931 #: ../fish/guestfish-actions.pod:416
4932 msgid "available-all-groups"
4933 msgstr ""
4934
4935 #. type: verbatim
4936 #: ../fish/guestfish-actions.pod:418
4937 #, no-wrap
4938 msgid ""
4939 " available-all-groups\n"
4940 "\n"
4941 msgstr ""
4942
4943 #. type: textblock
4944 #: ../fish/guestfish-actions.pod:420
4945 msgid ""
4946 "This command returns a list of all optional groups that this daemon knows "
4947 "about.  Note this returns both supported and unsupported groups.  To find "
4948 "out which ones the daemon can actually support you have to call L</"
4949 "available> on each member of the returned list."
4950 msgstr ""
4951
4952 #. type: textblock
4953 #: ../fish/guestfish-actions.pod:426
4954 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
4955 msgstr ""
4956
4957 #. type: =head2
4958 #: ../fish/guestfish-actions.pod:428
4959 msgid "base64-in"
4960 msgstr ""
4961
4962 #. type: verbatim
4963 #: ../fish/guestfish-actions.pod:430
4964 #, no-wrap
4965 msgid ""
4966 " base64-in (base64file|-) filename\n"
4967 "\n"
4968 msgstr ""
4969
4970 #. type: textblock
4971 #: ../fish/guestfish-actions.pod:432 ../src/guestfs-actions.pod:644
4972 msgid ""
4973 "This command uploads base64-encoded data from C<base64file> to C<filename>."
4974 msgstr ""
4975
4976 #. type: textblock
4977 #: ../fish/guestfish-actions.pod:435 ../fish/guestfish-actions.pod:444
4978 #: ../fish/guestfish-actions.pod:693 ../fish/guestfish-actions.pod:862
4979 #: ../fish/guestfish-actions.pod:881 ../fish/guestfish-actions.pod:1255
4980 #: ../fish/guestfish-actions.pod:4658 ../fish/guestfish-actions.pod:4670
4981 #: ../fish/guestfish-actions.pod:4681 ../fish/guestfish-actions.pod:4692
4982 #: ../fish/guestfish-actions.pod:4744 ../fish/guestfish-actions.pod:4753
4983 #: ../fish/guestfish-actions.pod:4807 ../fish/guestfish-actions.pod:4830
4984 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
4985 msgstr ""
4986
4987 #. type: =head2
4988 #: ../fish/guestfish-actions.pod:437
4989 msgid "base64-out"
4990 msgstr ""
4991
4992 #. type: verbatim
4993 #: ../fish/guestfish-actions.pod:439
4994 #, no-wrap
4995 msgid ""
4996 " base64-out filename (base64file|-)\n"
4997 "\n"
4998 msgstr ""
4999
5000 #. type: textblock
5001 #: ../fish/guestfish-actions.pod:441 ../src/guestfs-actions.pod:658
5002 msgid ""
5003 "This command downloads the contents of C<filename>, writing it out to local "
5004 "file C<base64file> encoded as base64."
5005 msgstr ""
5006
5007 #. type: =head2
5008 #: ../fish/guestfish-actions.pod:446
5009 msgid "blockdev-flushbufs"
5010 msgstr ""
5011
5012 #. type: verbatim
5013 #: ../fish/guestfish-actions.pod:448
5014 #, no-wrap
5015 msgid ""
5016 " blockdev-flushbufs device\n"
5017 "\n"
5018 msgstr ""
5019
5020 #. type: textblock
5021 #: ../fish/guestfish-actions.pod:450 ../src/guestfs-actions.pod:671
5022 msgid ""
5023 "This tells the kernel to flush internal buffers associated with C<device>."
5024 msgstr ""
5025
5026 #. type: textblock
5027 #: ../fish/guestfish-actions.pod:453 ../fish/guestfish-actions.pod:464
5028 #: ../fish/guestfish-actions.pod:473 ../fish/guestfish-actions.pod:483
5029 #: ../fish/guestfish-actions.pod:495 ../fish/guestfish-actions.pod:508
5030 #: ../fish/guestfish-actions.pod:516 ../fish/guestfish-actions.pod:527
5031 #: ../fish/guestfish-actions.pod:535 ../fish/guestfish-actions.pod:543
5032 #: ../src/guestfs-actions.pod:674 ../src/guestfs-actions.pod:691
5033 #: ../src/guestfs-actions.pod:706 ../src/guestfs-actions.pod:722
5034 #: ../src/guestfs-actions.pod:740 ../src/guestfs-actions.pod:759
5035 #: ../src/guestfs-actions.pod:773 ../src/guestfs-actions.pod:791
5036 #: ../src/guestfs-actions.pod:805 ../src/guestfs-actions.pod:819
5037 msgid "This uses the L<blockdev(8)> command."
5038 msgstr ""
5039
5040 #. type: =head2
5041 #: ../fish/guestfish-actions.pod:455
5042 msgid "blockdev-getbsz"
5043 msgstr ""
5044
5045 #. type: verbatim
5046 #: ../fish/guestfish-actions.pod:457
5047 #, no-wrap
5048 msgid ""
5049 " blockdev-getbsz device\n"
5050 "\n"
5051 msgstr ""
5052
5053 #. type: textblock
5054 #: ../fish/guestfish-actions.pod:459 ../src/guestfs-actions.pod:686
5055 msgid "This returns the block size of a device."
5056 msgstr ""
5057
5058 #. type: textblock
5059 #: ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:524
5060 #: ../src/guestfs-actions.pod:688 ../src/guestfs-actions.pod:788
5061 msgid ""
5062 "(Note this is different from both I<size in blocks> and I<filesystem block "
5063 "size>)."
5064 msgstr ""
5065
5066 #. type: =head2
5067 #: ../fish/guestfish-actions.pod:466
5068 msgid "blockdev-getro"
5069 msgstr ""
5070
5071 #. type: verbatim
5072 #: ../fish/guestfish-actions.pod:468
5073 #, no-wrap
5074 msgid ""
5075 " blockdev-getro device\n"
5076 "\n"
5077 msgstr ""
5078
5079 #. type: textblock
5080 #: ../fish/guestfish-actions.pod:470 ../src/guestfs-actions.pod:703
5081 msgid ""
5082 "Returns a boolean indicating if the block device is read-only (true if read-"
5083 "only, false if not)."
5084 msgstr ""
5085
5086 #. type: =head2
5087 #: ../fish/guestfish-actions.pod:475
5088 msgid "blockdev-getsize64"
5089 msgstr ""
5090
5091 #. type: verbatim
5092 #: ../fish/guestfish-actions.pod:477
5093 #, no-wrap
5094 msgid ""
5095 " blockdev-getsize64 device\n"
5096 "\n"
5097 msgstr ""
5098
5099 #. type: textblock
5100 #: ../fish/guestfish-actions.pod:479 ../src/guestfs-actions.pod:718
5101 msgid "This returns the size of the device in bytes."
5102 msgstr ""
5103
5104 #. type: textblock
5105 #: ../fish/guestfish-actions.pod:481
5106 msgid "See also L</blockdev-getsz>."
5107 msgstr ""
5108
5109 #. type: =head2
5110 #: ../fish/guestfish-actions.pod:485
5111 msgid "blockdev-getss"
5112 msgstr ""
5113
5114 #. type: verbatim
5115 #: ../fish/guestfish-actions.pod:487
5116 #, no-wrap
5117 msgid ""
5118 " blockdev-getss device\