po-docs/uk.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 # Yuri Chornoivan <yurchor@ukr.net>, 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-08-28 10:15+0200\n"
  11 "PO-Revision-Date: 2011-07-17 20:50+0000\n"
  12 "Last-Translator: rjones <rjones@redhat.com>\n"
  13 "Language-Team: Ukrainian <trans-uk@lists.fedoraproject.org>\n"
  14 "Language: uk\n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n"
  19 "%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\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 #, fuzzy, no-wrap
  65 #| msgid ""
  66 #| " virt-list-partitions [--options] domname\n"
  67 #| "\n"
  68 msgid ""
  69 " virt-cat [--options] -d domname file [file ...]\n"
  70 "\n"
  71 msgstr ""
  72 " virt-list-partitions [--параметри] назва_домену\n"
  73 "\n"
  74
  75 #. type: verbatim
  76 #: ../cat/virt-cat.pod:11
  77 #, fuzzy, no-wrap
  78 #| msgid ""
  79 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
  80 #| "\n"
  81 msgid ""
  82 " virt-cat [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
  83 "\n"
  84 msgstr ""
  85 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
  86 "\n"
  87
  88 #. type: textblock
  89 #: ../cat/virt-cat.pod:13 ../edit/virt-edit.pod:15
  90 #: ../inspector/virt-inspector.pod:13
  91 msgid "Old-style:"
  92 msgstr ""
  93
  94 #. type: verbatim
  95 #: ../cat/virt-cat.pod:15
  96 #, no-wrap
  97 msgid ""
  98 " virt-cat domname file\n"
  99 "\n"
 100 msgstr ""
 101
 102 #. type: verbatim
 103 #: ../cat/virt-cat.pod:17
 104 #, no-wrap
 105 msgid ""
 106 " virt-cat disk.img file\n"
 107 "\n"
 108 msgstr ""
 109
 110 #. type: =head1
 111 #: ../cat/virt-cat.pod:19 ../cat/virt-filesystems.pod:13 ../cat/virt-ls.pod:19
 112 #: ../df/virt-df.pod:21 ../edit/virt-edit.pod:27
 113 #: ../examples/guestfs-examples.pod:19 ../examples/guestfs-recipes.pod:18
 114 #: ../fish/guestfish.pod:30 ../fish/virt-copy-in.pod:19
 115 #: ../fish/virt-copy-out.pod:13 ../fish/virt-tar-in.pod:21
 116 #: ../fish/virt-tar-out.pod:15 ../fuse/guestmount.pod:20
 117 #: ../inspector/virt-inspector.pod:19 ../java/examples/guestfs-java.pod:15
 118 #: ../ocaml/examples/guestfs-ocaml.pod:25 ../perl/examples/guestfs-perl.pod:18
 119 #: ../python/examples/guestfs-python.pod:14 ../rescue/virt-rescue.pod:29
 120 #: ../resize/virt-resize.pod:13 ../ruby/examples/guestfs-ruby.pod:15
 121 #: ../src/guestfs.pod:23 ../test-tool/libguestfs-test-tool.pod:11
 122 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-list-partitions.pl:40
 123 #: ../tools/virt-make-fs.pl:47 ../tools/virt-tar.pl:77
 124 #: ../tools/virt-win-reg.pl:63
 125 msgid "DESCRIPTION"
 126 msgstr "ОПИС"
 127
 128 #. type: textblock
 129 #: ../cat/virt-cat.pod:21
 130 msgid ""
 131 "C<virt-cat> is a command line tool to display the contents of C<file> where "
 132 "C<file> exists in the named virtual machine (or disk image)."
 133 msgstr ""
 134
 135 #. type: textblock
 136 #: ../cat/virt-cat.pod:24
 137 msgid ""
 138 "Multiple filenames can be given, in which case they are concatenated "
 139 "together.  Each filename must be a full path, starting at the root directory "
 140 "(starting with '/')."
 141 msgstr ""
 142
 143 #. type: textblock
 144 #: ../cat/virt-cat.pod:28
 145 msgid ""
 146 "C<virt-cat> can be used to quickly view a file.  To edit a file, use C<virt-"
 147 "edit>.  For more complex cases you should look at the L<guestfish(1)> tool "
 148 "(see L</USING GUESTFISH> below)."
 149 msgstr ""
 150
 151 #. type: =head1
 152 #: ../cat/virt-cat.pod:32 ../cat/virt-ls.pod:35 ../df/virt-df.pod:43
 153 #: ../edit/virt-edit.pod:44 ../fish/guestfish.pod:41
 154 #: ../fish/guestfish.pod:1018 ../fish/virt-copy-in.pod:29
 155 #: ../fish/virt-copy-out.pod:21 ../fish/virt-tar-in.pod:30
 156 #: ../fish/virt-tar-out.pod:24 ../fuse/guestmount.pod:39
 157 #: ../resize/virt-resize.pod:27 ../tools/virt-tar.pl:50
 158 msgid "EXAMPLES"
 159 msgstr "ПРИКЛАДИ"
 160
 161 #. type: textblock
 162 #: ../cat/virt-cat.pod:34
 163 msgid ""
 164 "Display C</etc/fstab> file from inside the libvirt VM called C<mydomain>:"
 165 msgstr ""
 166
 167 #. type: verbatim
 168 #: ../cat/virt-cat.pod:37
 169 #, no-wrap
 170 msgid ""
 171 " virt-cat -d mydomain /etc/fstab\n"
 172 "\n"
 173 msgstr ""
 174
 175 #. type: textblock
 176 #: ../cat/virt-cat.pod:39
 177 msgid "List syslog messages from a VM disk image file:"
 178 msgstr ""
 179
 180 #. type: verbatim
 181 #: ../cat/virt-cat.pod:41
 182 #, no-wrap
 183 msgid ""
 184 " virt-cat -a disk.img /var/log/messages | tail\n"
 185 "\n"
 186 msgstr ""
 187
 188 #. type: textblock
 189 #: ../cat/virt-cat.pod:43
 190 msgid "Find out what DHCP IP address a VM acquired:"
 191 msgstr ""
 192
 193 #. type: verbatim
 194 #: ../cat/virt-cat.pod:45
 195 #, no-wrap
 196 msgid ""
 197 " virt-cat -d mydomain /var/log/messages | \\\n"
 198 "   grep 'dhclient: bound to' | tail\n"
 199 "\n"
 200 msgstr ""
 201
 202 #. type: textblock
 203 #: ../cat/virt-cat.pod:48
 204 msgid "Find out what packages were recently installed:"
 205 msgstr ""
 206
 207 #. type: verbatim
 208 #: ../cat/virt-cat.pod:50
 209 #, no-wrap
 210 msgid ""
 211 " virt-cat -d mydomain /var/log/yum.log | tail\n"
 212 "\n"
 213 msgstr ""
 214
 215 #. type: textblock
 216 #: ../cat/virt-cat.pod:52
 217 msgid "Find out who is logged on inside a virtual machine:"
 218 msgstr ""
 219
 220 #. type: verbatim
 221 #: ../cat/virt-cat.pod:54
 222 #, no-wrap
 223 msgid ""
 224 " virt-cat -d mydomain /var/run/utmp > /tmp/utmp\n"
 225 " who /tmp/utmp\n"
 226 "\n"
 227 msgstr ""
 228
 229 #. type: textblock
 230 #: ../cat/virt-cat.pod:57
 231 msgid "or who was logged on:"
 232 msgstr ""
 233
 234 #. type: verbatim
 235 #: ../cat/virt-cat.pod:59
 236 #, no-wrap
 237 msgid ""
 238 " virt-cat -d mydomain /var/log/wtmp > /tmp/wtmp\n"
 239 " last -f /tmp/wtmp\n"
 240 "\n"
 241 msgstr ""
 242
 243 #. type: =head1
 244 #: ../cat/virt-cat.pod:62 ../cat/virt-filesystems.pod:91
 245 #: ../cat/virt-ls.pod:261 ../df/virt-df.pod:59 ../edit/virt-edit.pod:62
 246 #: ../fish/guestfish.pod:148 ../fish/virt-copy-in.pod:45
 247 #: ../fish/virt-copy-out.pod:34 ../fish/virt-tar-in.pod:42
 248 #: ../fish/virt-tar-out.pod:36 ../fuse/guestmount.pod:83
 249 #: ../inspector/virt-inspector.pod:55 ../rescue/virt-rescue.pod:84
 250 #: ../resize/virt-resize.pod:241 ../test-tool/libguestfs-test-tool.pod:37
 251 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-list-partitions.pl:54
 252 #: ../tools/virt-make-fs.pl:153 ../tools/virt-tar.pl:103
 253 #: ../tools/virt-win-reg.pl:96
 254 msgid "OPTIONS"
 255 msgstr "ПАРАМЕТРИ"
 256
 257 #. type: =item
 258 #: ../cat/virt-cat.pod:66 ../cat/virt-filesystems.pod:95
 259 #: ../cat/virt-ls.pod:265 ../df/virt-df.pod:63 ../edit/virt-edit.pod:66
 260 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:151
 261 #: ../inspector/virt-inspector.pod:59 ../rescue/virt-rescue.pod:88
 262 #: ../resize/virt-resize.pod:245 ../tools/virt-list-filesystems.pl:61
 263 #: ../tools/virt-list-partitions.pl:62 ../tools/virt-make-fs.pl:161
 264 #: ../tools/virt-tar.pl:111 ../tools/virt-win-reg.pl:104
 265 msgid "B<--help>"
 266 msgstr "B<--help>"
 267
 268 #. type: textblock
 269 #: ../cat/virt-cat.pod:68 ../cat/virt-filesystems.pod:97
 270 #: ../cat/virt-ls.pod:267 ../df/virt-df.pod:65 ../edit/virt-edit.pod:68
 271 #: ../inspector/virt-inspector.pod:61 ../rescue/virt-rescue.pod:90
 272 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-list-partitions.pl:64
 273 #: ../tools/virt-make-fs.pl:163 ../tools/virt-tar.pl:113
 274 #: ../tools/virt-win-reg.pl:106
 275 msgid "Display brief help."
 276 msgstr ""
 277
 278 #. type: =item
 279 #: ../cat/virt-cat.pod:70 ../cat/virt-filesystems.pod:99
 280 #: ../cat/virt-ls.pod:269 ../df/virt-df.pod:67 ../edit/virt-edit.pod:70
 281 #: ../inspector/virt-inspector.pod:63 ../rescue/virt-rescue.pod:92
 282 #, fuzzy
 283 #| msgid "B<-f file>"
 284 msgid "B<-a> file"
 285 msgstr "B<-f файл>"
 286
 287 #. type: =item
 288 #: ../cat/virt-cat.pod:72 ../cat/virt-filesystems.pod:101
 289 #: ../cat/virt-ls.pod:271 ../df/virt-df.pod:69 ../edit/virt-edit.pod:72
 290 #: ../inspector/virt-inspector.pod:65 ../rescue/virt-rescue.pod:94
 291 #, fuzzy
 292 #| msgid "B<--add image>"
 293 msgid "B<--add> file"
 294 msgstr "B<--add образ>"
 295
 296 #. type: textblock
 297 #: ../cat/virt-cat.pod:74 ../cat/virt-filesystems.pod:103
 298 #: ../cat/virt-ls.pod:273 ../df/virt-df.pod:71 ../edit/virt-edit.pod:74
 299 #: ../inspector/virt-inspector.pod:67 ../rescue/virt-rescue.pod:96
 300 msgid ""
 301 "Add I<file> which should be a disk image from a virtual machine.  If the "
 302 "virtual machine has multiple block devices, you must supply all of them with "
 303 "separate I<-a> options."
 304 msgstr ""
 305
 306 #. type: textblock
 307 #: ../cat/virt-cat.pod:78 ../cat/virt-filesystems.pod:107
 308 #: ../cat/virt-ls.pod:277 ../df/virt-df.pod:75 ../edit/virt-edit.pod:78
 309 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:93
 310 #: ../inspector/virt-inspector.pod:71 ../rescue/virt-rescue.pod:100
 311 msgid ""
 312 "The format of the disk image is auto-detected.  To override this and force a "
 313 "particular format use the I<--format=..> option."
 314 msgstr ""
 315
 316 #. type: =item
 317 #: ../cat/virt-cat.pod:81 ../cat/virt-filesystems.pod:125
 318 #: ../cat/virt-ls.pod:291 ../df/virt-df.pod:78 ../rescue/virt-rescue.pod:107
 319 #, fuzzy
 320 #| msgid "B<-c URI>"
 321 msgid "B<-c> URI"
 322 msgstr "B<-c адреса>"
 323
 324 #. type: =item
 325 #: ../cat/virt-cat.pod:83 ../cat/virt-filesystems.pod:127
 326 #: ../cat/virt-ls.pod:293 ../df/virt-df.pod:80 ../rescue/virt-rescue.pod:109
 327 #, fuzzy
 328 #| msgid "B<--connect URI>"
 329 msgid "B<--connect> URI"
 330 msgstr "B<--connect адреса>"
 331
 332 #. type: textblock
 333 #: ../cat/virt-cat.pod:85 ../cat/virt-filesystems.pod:129
 334 #: ../cat/virt-ls.pod:295 ../df/virt-df.pod:82 ../edit/virt-edit.pod:99
 335 #: ../inspector/virt-inspector.pod:78 ../rescue/virt-rescue.pod:111
 336 #: ../tools/virt-list-filesystems.pl:81 ../tools/virt-list-partitions.pl:82
 337 #: ../tools/virt-tar.pl:131 ../tools/virt-win-reg.pl:132
 338 msgid ""
 339 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
 340 "to the default libvirt hypervisor."
 341 msgstr ""
 342
 343 #. type: textblock
 344 #: ../cat/virt-cat.pod:88 ../cat/virt-filesystems.pod:132
 345 #: ../cat/virt-ls.pod:298 ../df/virt-df.pod:85 ../rescue/virt-rescue.pod:114
 346 msgid ""
 347 "If you specify guest block devices directly (I<-a>), then libvirt is not "
 348 "used at all."
 349 msgstr ""
 350
 351 #. type: =item
 352 #: ../cat/virt-cat.pod:91 ../cat/virt-filesystems.pod:141
 353 #: ../cat/virt-ls.pod:307 ../df/virt-df.pod:94 ../edit/virt-edit.pod:105
 354 #: ../inspector/virt-inspector.pod:85 ../rescue/virt-rescue.pod:117
 355 msgid "B<-d> guest"
 356 msgstr ""
 357
 358 #. type: =item
 359 #: ../cat/virt-cat.pod:93 ../cat/virt-filesystems.pod:143
 360 #: ../cat/virt-ls.pod:309 ../df/virt-df.pod:96 ../edit/virt-edit.pod:107
 361 #: ../inspector/virt-inspector.pod:87 ../rescue/virt-rescue.pod:119
 362 msgid "B<--domain> guest"
 363 msgstr ""
 364
 365 #. type: textblock
 366 #: ../cat/virt-cat.pod:95 ../cat/virt-filesystems.pod:145
 367 #: ../cat/virt-ls.pod:311 ../df/virt-df.pod:98 ../edit/virt-edit.pod:109
 368 #: ../inspector/virt-inspector.pod:89 ../rescue/virt-rescue.pod:121
 369 msgid ""
 370 "Add all the disks from the named libvirt guest.  Domain UUIDs can be used "
 371 "instead of names."
 372 msgstr ""
 373
 374 #. type: =item
 375 #: ../cat/virt-cat.pod:98 ../cat/virt-filesystems.pod:148
 376 #: ../cat/virt-ls.pod:314 ../edit/virt-edit.pod:112 ../fish/guestfish.pod:217
 377 #: ../fuse/guestmount.pod:126 ../inspector/virt-inspector.pod:92
 378 msgid "B<--echo-keys>"
 379 msgstr "B<--echo-keys>"
 380
 381 #. type: textblock
 382 #: ../cat/virt-cat.pod:100
 383 msgid ""
 384 "When prompting for keys and passphrases, virt-cat normally turns echoing off "
 385 "so you cannot see what you are typing.  If you are not worried about Tempest "
 386 "attacks and there is no one else in the room you can specify this flag to "
 387 "see what you are typing."
 388 msgstr ""
 389
 390 #. type: =item
 391 #: ../cat/virt-cat.pod:105 ../cat/virt-filesystems.pod:170
 392 #: ../cat/virt-ls.pod:328 ../df/virt-df.pod:101 ../fish/guestfish.pod:233
 393 #: ../fuse/guestmount.pod:133 ../inspector/virt-inspector.pod:99
 394 #: ../rescue/virt-rescue.pod:124
 395 msgid "B<--format=raw|qcow2|..>"
 396 msgstr "B<--format=raw|qcow2|..>"
 397
 398 #. type: =item
 399 #: ../cat/virt-cat.pod:107 ../cat/virt-filesystems.pod:172
 400 #: ../cat/virt-ls.pod:330 ../df/virt-df.pod:103 ../edit/virt-edit.pod:134
 401 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:135
 402 #: ../inspector/virt-inspector.pod:101 ../rescue/virt-rescue.pod:126
 403 msgid "B<--format>"
 404 msgstr "B<--format>"
 405
 406 #. type: textblock
 407 #: ../cat/virt-cat.pod:109 ../cat/virt-filesystems.pod:174
 408 #: ../cat/virt-ls.pod:332 ../df/virt-df.pod:105 ../edit/virt-edit.pod:136
 409 #: ../fish/guestfish.pod:237 ../fuse/guestmount.pod:137
 410 #: ../rescue/virt-rescue.pod:128
 411 msgid ""
 412 "The default for the I<-a> option is to auto-detect the format of the disk "
 413 "image.  Using this forces the disk format for I<-a> options which follow on "
 414 "the command line.  Using I<--format> with no argument switches back to auto-"
 415 "detection for subsequent I<-a> options."
 416 msgstr ""
 417
 418 #. type: textblock
 419 #: ../cat/virt-cat.pod:114 ../cat/virt-filesystems.pod:179
 420 #: ../cat/virt-ls.pod:337 ../df/virt-df.pod:110 ../edit/virt-edit.pod:141
 421 #: ../fish/guestfish.pod:242 ../fish/guestfish.pod:673
 422 #: ../inspector/virt-inspector.pod:336 ../rescue/virt-rescue.pod:133
 423 #: ../src/guestfs.pod:2652
 424 msgid "For example:"
 425 msgstr "Приклад:"
 426
 427 #. type: verbatim
 428 #: ../cat/virt-cat.pod:116
 429 #, fuzzy, no-wrap
 430 #| msgid ""
 431 #| " guestfish --format=raw -a disk.img\n"
 432 #| "\n"
 433 msgid ""
 434 " virt-cat --format=raw -a disk.img file\n"
 435 "\n"
 436 msgstr ""
 437 " guestfish --format=raw -a disk.img\n"
 438 "\n"
 439
 440 #. type: textblock
 441 #: ../cat/virt-cat.pod:118 ../cat/virt-filesystems.pod:183
 442 #: ../cat/virt-ls.pod:341 ../df/virt-df.pod:114 ../edit/virt-edit.pod:145
 443 #: ../fish/guestfish.pod:246 ../rescue/virt-rescue.pod:137
 444 msgid "forces raw format (no auto-detection) for C<disk.img>."
 445 msgstr ""
 446
 447 #. type: verbatim
 448 #: ../cat/virt-cat.pod:120
 449 #, fuzzy, no-wrap
 450 #| msgid ""
 451 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
 452 #| "\n"
 453 msgid ""
 454 " virt-cat --format=raw -a disk.img --format -a another.img file\n"
 455 "\n"
 456 msgstr ""
 457 " guestfish --format=raw -a disk.img --format -a another.img\n"
 458 "\n"
 459
 460 #. type: textblock
 461 #: ../cat/virt-cat.pod:122 ../cat/virt-filesystems.pod:187
 462 #: ../cat/virt-ls.pod:345 ../df/virt-df.pod:118 ../edit/virt-edit.pod:149
 463 #: ../fish/guestfish.pod:250 ../rescue/virt-rescue.pod:141
 464 msgid ""
 465 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
 466 "detection for C<another.img>."
 467 msgstr ""
 468
 469 #. type: textblock
 470 #: ../cat/virt-cat.pod:125 ../cat/virt-filesystems.pod:190
 471 #: ../cat/virt-ls.pod:348 ../df/virt-df.pod:121 ../edit/virt-edit.pod:152
 472 #: ../rescue/virt-rescue.pod:144
 473 msgid ""
 474 "If you have untrusted raw-format guest disk images, you should use this "
 475 "option to specify the disk format.  This avoids a possible security problem "
 476 "with malicious guests (CVE-2010-3851)."
 477 msgstr ""
 478
 479 #. type: =item
 480 #: ../cat/virt-cat.pod:129 ../cat/virt-filesystems.pod:200
 481 #: ../cat/virt-ls.pod:361 ../edit/virt-edit.pod:156 ../fish/guestfish.pod:289
 482 #: ../fuse/guestmount.pod:163 ../inspector/virt-inspector.pod:114
 483 msgid "B<--keys-from-stdin>"
 484 msgstr "B<--keys-from-stdin>"
 485
 486 #. type: textblock
 487 #: ../cat/virt-cat.pod:131 ../cat/virt-filesystems.pod:202
 488 #: ../cat/virt-ls.pod:363 ../edit/virt-edit.pod:158 ../fish/guestfish.pod:291
 489 #: ../fuse/guestmount.pod:165 ../inspector/virt-inspector.pod:116
 490 msgid ""
 491 "Read key or passphrase parameters from stdin.  The default is to try to read "
 492 "passphrases from the user by opening C</dev/tty>."
 493 msgstr ""
 494
 495 #. type: =item
 496 #: ../cat/virt-cat.pod:134 ../cat/virt-filesystems.pod:261
 497 #: ../cat/virt-ls.pod:425 ../df/virt-df.pod:173 ../edit/virt-edit.pod:161
 498 #: ../fish/guestfish.pod:390 ../fuse/guestmount.pod:257
 499 #: ../inspector/virt-inspector.pod:119 ../rescue/virt-rescue.pod:178
 500 msgid "B<-v>"
 501 msgstr "B<-v>"
 502
 503 #. type: =item
 504 #: ../cat/virt-cat.pod:136 ../cat/virt-filesystems.pod:263
 505 #: ../cat/virt-ls.pod:427 ../df/virt-df.pod:175 ../edit/virt-edit.pod:163
 506 #: ../fish/guestfish.pod:392 ../fuse/guestmount.pod:259
 507 #: ../inspector/virt-inspector.pod:121 ../rescue/virt-rescue.pod:180
 508 msgid "B<--verbose>"
 509 msgstr "B<--verbose>"
 510
 511 #. type: textblock
 512 #: ../cat/virt-cat.pod:138 ../cat/virt-filesystems.pod:265
 513 #: ../cat/virt-ls.pod:429 ../df/virt-df.pod:177 ../edit/virt-edit.pod:165
 514 #: ../inspector/virt-inspector.pod:123 ../rescue/virt-rescue.pod:182
 515 msgid "Enable verbose messages for debugging."
 516 msgstr ""
 517
 518 #. type: =item
 519 #: ../cat/virt-cat.pod:140 ../cat/virt-filesystems.pod:267
 520 #: ../cat/virt-ls.pod:431 ../df/virt-df.pod:179 ../edit/virt-edit.pod:167
 521 #: ../fish/guestfish.pod:397 ../fuse/guestmount.pod:263
 522 #: ../inspector/virt-inspector.pod:125 ../rescue/virt-rescue.pod:184
 523 #: ../resize/virt-resize.pod:484
 524 msgid "B<-V>"
 525 msgstr "B<-V>"
 526
 527 #. type: =item
 528 #: ../cat/virt-cat.pod:142 ../cat/virt-filesystems.pod:269
 529 #: ../cat/virt-ls.pod:433 ../df/virt-df.pod:181 ../edit/virt-edit.pod:169
 530 #: ../fish/guestfish.pod:399 ../fuse/guestmount.pod:265
 531 #: ../inspector/virt-inspector.pod:127 ../rescue/virt-rescue.pod:186
 532 #: ../resize/virt-resize.pod:486 ../tools/virt-list-filesystems.pl:69
 533 #: ../tools/virt-list-partitions.pl:70 ../tools/virt-make-fs.pl:169
 534 #: ../tools/virt-tar.pl:119 ../tools/virt-win-reg.pl:112
 535 msgid "B<--version>"
 536 msgstr "B<--version>"
 537
 538 #. type: textblock
 539 #: ../cat/virt-cat.pod:144 ../cat/virt-filesystems.pod:271
 540 #: ../cat/virt-ls.pod:435 ../df/virt-df.pod:183 ../edit/virt-edit.pod:171
 541 #: ../inspector/virt-inspector.pod:129 ../rescue/virt-rescue.pod:188
 542 #: ../resize/virt-resize.pod:488 ../tools/virt-list-filesystems.pl:71
 543 #: ../tools/virt-list-partitions.pl:72 ../tools/virt-make-fs.pl:171
 544 #: ../tools/virt-tar.pl:121 ../tools/virt-win-reg.pl:114
 545 msgid "Display version number and exit."
 546 msgstr "Показати дані щодо версії і завершити роботу."
 547
 548 #. type: =item
 549 #: ../cat/virt-cat.pod:146 ../cat/virt-filesystems.pod:281
 550 #: ../cat/virt-ls.pod:437 ../df/virt-df.pod:185 ../edit/virt-edit.pod:173
 551 #: ../fish/guestfish.pod:412 ../fuse/guestmount.pod:278
 552 #: ../inspector/virt-inspector.pod:131 ../rescue/virt-rescue.pod:199
 553 #: ../tools/virt-tar.pl:158
 554 msgid "B<-x>"
 555 msgstr "B<-x>"
 556
 557 #. type: textblock
 558 #: ../cat/virt-cat.pod:148 ../cat/virt-filesystems.pod:283
 559 #: ../cat/virt-ls.pod:439 ../df/virt-df.pod:187 ../edit/virt-edit.pod:175
 560 #: ../inspector/virt-inspector.pod:133 ../rescue/virt-rescue.pod:201
 561 msgid "Enable tracing of libguestfs API calls."
 562 msgstr ""
 563
 564 #. type: =head1
 565 #: ../cat/virt-cat.pod:152 ../cat/virt-ls.pod:443 ../edit/virt-edit.pod:179
 566 #: ../inspector/virt-inspector.pod:137 ../rescue/virt-rescue.pod:205
 567 msgid "OLD-STYLE COMMAND LINE ARGUMENTS"
 568 msgstr ""
 569
 570 #. type: textblock
 571 #: ../cat/virt-cat.pod:154
 572 msgid "Previous versions of virt-cat allowed you to write either:"
 573 msgstr ""
 574
 575 #. type: verbatim
 576 #: ../cat/virt-cat.pod:156
 577 #, fuzzy, no-wrap
 578 #| msgid ""
 579 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
 580 #| "\n"
 581 msgid ""
 582 " virt-cat disk.img [disk.img ...] file\n"
 583 "\n"
 584 msgstr ""
 585 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
 586 "\n"
 587
 588 #. type: textblock
 589 #: ../cat/virt-cat.pod:158 ../cat/virt-ls.pod:449 ../edit/virt-edit.pod:185
 590 #: ../inspector/virt-inspector.pod:143 ../rescue/virt-rescue.pod:211
 591 #, fuzzy
 592 #| msgid "or:"
 593 msgid "or"
 594 msgstr "або:"
 595
 596 #. type: verbatim
 597 #: ../cat/virt-cat.pod:160
 598 #, no-wrap
 599 msgid ""
 600 " virt-cat guestname file\n"
 601 "\n"
 602 msgstr ""
 603
 604 #. type: textblock
 605 #: ../cat/virt-cat.pod:162 ../cat/virt-ls.pod:453 ../edit/virt-edit.pod:189
 606 #: ../inspector/virt-inspector.pod:147 ../rescue/virt-rescue.pod:215
 607 msgid ""
 608 "whereas in this version you should use I<-a> or I<-d> respectively to avoid "
 609 "the confusing case where a disk image might have the same name as a guest."
 610 msgstr ""
 611
 612 #. type: textblock
 613 #: ../cat/virt-cat.pod:166 ../cat/virt-ls.pod:457 ../edit/virt-edit.pod:193
 614 #: ../inspector/virt-inspector.pod:151 ../rescue/virt-rescue.pod:219
 615 msgid "For compatibility the old style is still supported."
 616 msgstr ""
 617
 618 #. type: =head1
 619 #: ../cat/virt-cat.pod:168 ../edit/virt-edit.pod:297
 620 msgid "USING GUESTFISH"
 621 msgstr ""
 622
 623 #. type: textblock
 624 #: ../cat/virt-cat.pod:170
 625 msgid ""
 626 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
 627 "C<virt-cat> doesn't work."
 628 msgstr ""
 629
 630 #. type: textblock
 631 #: ../cat/virt-cat.pod:173
 632 msgid "Using C<virt-cat> is approximately equivalent to doing:"
 633 msgstr ""
 634
 635 #. type: verbatim
 636 #: ../cat/virt-cat.pod:175
 637 #, fuzzy, no-wrap
 638 #| msgid ""
 639 #| " guestfish --ro -d myguest -i\n"
 640 #| "\n"
 641 msgid ""
 642 " guestfish --ro -i -d domname download file -\n"
 643 "\n"
 644 msgstr ""
 645 " guestfish --ro -d myguest -i\n"
 646 "\n"
 647
 648 #. type: textblock
 649 #: ../cat/virt-cat.pod:177
 650 msgid ""
 651 "where C<domname> is the name of the libvirt guest, and C<file> is the full "
 652 "path to the file.  Note the final C<-> (meaning \"output to stdout\")."
 653 msgstr ""
 654
 655 #. type: textblock
 656 #: ../cat/virt-cat.pod:181
 657 msgid ""
 658 "The command above uses libguestfs's guest inspection feature and so does not "
 659 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
 660 "disk images that don't contain guests.  To display a file from a disk image "
 661 "directly, use:"
 662 msgstr ""
 663
 664 #. type: verbatim
 665 #: ../cat/virt-cat.pod:186
 666 #, fuzzy, no-wrap
 667 #| msgid ""
 668 #| " guestfish [--ro] -i disk.img\n"
 669 #| "\n"
 670 msgid ""
 671 " guestfish --ro -a disk.img -m /dev/sda1 download file -\n"
 672 "\n"
 673 msgstr ""
 674 " guestfish [--ro] -i disk.img\n"
 675 "\n"
 676
 677 #. type: textblock
 678 #: ../cat/virt-cat.pod:188
 679 msgid ""
 680 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
 681 "the disk image to edit, and C<file> is the full path to the file."
 682 msgstr ""
 683
 684 #. type: =head1
 685 #: ../cat/virt-cat.pod:192 ../cat/virt-filesystems.pod:365
 686 #: ../cat/virt-ls.pod:483 ../df/virt-df.pod:215 ../edit/virt-edit.pod:342
 687 #: ../inspector/virt-inspector.pod:352 ../rescue/virt-rescue.pod:262
 688 #: ../resize/virt-resize.pod:568 ../tools/virt-list-filesystems.pl:188
 689 #: ../tools/virt-list-partitions.pl:258 ../tools/virt-make-fs.pl:532
 690 #: ../tools/virt-tar.pl:289 ../tools/virt-win-reg.pl:733
 691 msgid "SHELL QUOTING"
 692 msgstr ""
 693
 694 #. type: textblock
 695 #: ../cat/virt-cat.pod:194 ../cat/virt-filesystems.pod:367
 696 #: ../cat/virt-ls.pod:485 ../df/virt-df.pod:217 ../edit/virt-edit.pod:344
 697 #: ../inspector/virt-inspector.pod:354 ../rescue/virt-rescue.pod:264
 698 #: ../resize/virt-resize.pod:570 ../tools/virt-list-filesystems.pl:190
 699 #: ../tools/virt-list-partitions.pl:260 ../tools/virt-make-fs.pl:534
 700 #: ../tools/virt-tar.pl:291 ../tools/virt-win-reg.pl:741
 701 msgid ""
 702 "Libvirt guest names can contain arbitrary characters, some of which have "
 703 "meaning to the shell such as C<#> and space.  You may need to quote or "
 704 "escape these characters on the command line.  See the shell manual page L<sh"
 705 "(1)> for details."
 706 msgstr ""
 707
 708 #. type: =head1
 709 #: ../cat/virt-cat.pod:199 ../cat/virt-filesystems.pod:372
 710 #: ../cat/virt-ls.pod:490 ../df/virt-df.pod:222 ../edit/virt-edit.pod:349
 711 #: ../fish/guestfish.pod:1081 ../fuse/guestmount.pod:303
 712 #: ../inspector/virt-inspector.pod:375 ../resize/virt-resize.pod:575
 713 #: ../test-tool/libguestfs-test-tool.pod:77
 714 msgid "EXIT STATUS"
 715 msgstr ""
 716
 717 #. type: textblock
 718 #: ../cat/virt-cat.pod:201 ../cat/virt-filesystems.pod:374
 719 #: ../cat/virt-ls.pod:492 ../df/virt-df.pod:224 ../edit/virt-edit.pod:351
 720 #: ../fuse/guestmount.pod:305 ../inspector/virt-inspector.pod:377
 721 #: ../resize/virt-resize.pod:577
 722 msgid ""
 723 "This program returns 0 if successful, or non-zero if there was an error."
 724 msgstr ""
 725
 726 #. type: =head1
 727 #: ../cat/virt-cat.pod:204 ../cat/virt-filesystems.pod:377
 728 #: ../cat/virt-ls.pod:495 ../df/virt-df.pod:227 ../edit/virt-edit.pod:354
 729 #: ../examples/guestfs-examples.pod:33 ../examples/guestfs-recipes.pod:384
 730 #: ../fish/guestfish.pod:1235 ../fish/virt-copy-in.pod:50
 731 #: ../fish/virt-copy-out.pod:39 ../fish/virt-tar-in.pod:47
 732 #: ../fish/virt-tar-out.pod:41 ../fuse/guestmount.pod:308
 733 #: ../inspector/virt-inspector.pod:380 ../java/examples/guestfs-java.pod:45
 734 #: ../ocaml/examples/guestfs-ocaml.pod:78 ../perl/examples/guestfs-perl.pod:39
 735 #: ../python/examples/guestfs-python.pod:42 ../rescue/virt-rescue.pod:284
 736 #: ../resize/virt-resize.pod:580 ../ruby/examples/guestfs-ruby.pod:36
 737 #: ../src/guestfs.pod:3026 ../test-tool/libguestfs-test-tool.pod:87
 738 #: ../tools/virt-list-filesystems.pl:195 ../tools/virt-list-partitions.pl:265
 739 #: ../tools/virt-make-fs.pl:539 ../tools/virt-tar.pl:296
 740 #: ../tools/virt-win-reg.pl:746
 741 msgid "SEE ALSO"
 742 msgstr "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
 743
 744 #. type: textblock
 745 #: ../cat/virt-cat.pod:206
 746 #, fuzzy
 747 #| msgid ""
 748 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
 749 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
 750 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
 751 msgid ""
 752 "L<guestfs(3)>, L<guestfish(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, L<virt-"
 753 "tar-out(1)>, L<http://libguestfs.org/>."
 754 msgstr ""
 755 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
 756 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
 757 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
 758
 759 #. type: =head1
 760 #: ../cat/virt-cat.pod:213 ../cat/virt-filesystems.pod:388
 761 #: ../cat/virt-ls.pod:507 ../df/virt-df.pod:235 ../edit/virt-edit.pod:368
 762 #: ../rescue/virt-rescue.pod:292 ../resize/virt-resize.pod:601
 763 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-list-partitions.pl:277
 764 #: ../tools/virt-make-fs.pl:564 ../tools/virt-tar.pl:311
 765 #: ../tools/virt-win-reg.pl:772
 766 msgid "AUTHOR"
 767 msgstr "АВТОР"
 768
 769 #. type: textblock
 770 #: ../cat/virt-cat.pod:215 ../cat/virt-filesystems.pod:390
 771 #: ../cat/virt-ls.pod:509 ../df/virt-df.pod:237 ../edit/virt-edit.pod:370
 772 #: ../inspector/virt-inspector.pod:395 ../rescue/virt-rescue.pod:294
 773 #: ../resize/virt-resize.pod:603 ../tools/virt-list-filesystems.pl:210
 774 #: ../tools/virt-list-partitions.pl:279 ../tools/virt-make-fs.pl:566
 775 #: ../tools/virt-tar.pl:313 ../tools/virt-win-reg.pl:774
 776 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
 777 msgstr "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
 778
 779 #. type: =head1
 780 #: ../cat/virt-cat.pod:217 ../cat/virt-filesystems.pod:392
 781 #: ../cat/virt-ls.pod:511 ../df/virt-df.pod:239 ../edit/virt-edit.pod:372
 782 #: ../examples/guestfs-examples.pod:48 ../examples/guestfs-recipes.pod:400
 783 #: ../fish/guestfish.pod:1264 ../fish/virt-copy-in.pod:64
 784 #: ../fish/virt-copy-out.pod:53 ../fish/virt-tar-in.pod:62
 785 #: ../fish/virt-tar-out.pod:55 ../fuse/guestmount.pod:323
 786 #: ../inspector/virt-inspector.pod:403 ../java/examples/guestfs-java.pod:61
 787 #: ../ocaml/examples/guestfs-ocaml.pod:94 ../perl/examples/guestfs-perl.pod:55
 788 #: ../python/examples/guestfs-python.pod:57 ../rescue/virt-rescue.pod:296
 789 #: ../resize/virt-resize.pod:605 ../ruby/examples/guestfs-ruby.pod:51
 790 #: ../src/guestfs.pod:3102 ../test-tool/libguestfs-test-tool.pod:97
 791 #: ../tools/virt-list-filesystems.pl:212 ../tools/virt-list-partitions.pl:281
 792 #: ../tools/virt-make-fs.pl:568 ../tools/virt-tar.pl:315
 793 #: ../tools/virt-win-reg.pl:776
 794 msgid "COPYRIGHT"
 795 msgstr "АВТОРСЬКІ ПРАВА"
 796
 797 #. type: textblock
 798 #: ../cat/virt-cat.pod:219 ../inspector/virt-inspector.pod:405
 799 #: ../resize/virt-resize.pod:607
 800 #, fuzzy
 801 #| msgid "Copyright (C) 2009-2010 Red Hat Inc."
 802 msgid "Copyright (C) 2010-2011 Red Hat Inc."
 803 msgstr "© Red Hat Inc., 2009–2010"
 804
 805 #. type: textblock
 806 #: ../cat/virt-cat.pod:221 ../cat/virt-filesystems.pod:396
 807 #: ../cat/virt-ls.pod:515 ../df/virt-df.pod:243 ../edit/virt-edit.pod:376
 808 #: ../fish/guestfish.pod:1269 ../fish/virt-copy-in.pod:69
 809 #: ../fish/virt-copy-out.pod:58 ../fish/virt-tar-in.pod:67
 810 #: ../fish/virt-tar-out.pod:60 ../fuse/guestmount.pod:328
 811 #: ../inspector/virt-inspector.pod:407 ../rescue/virt-rescue.pod:300
 812 #: ../resize/virt-resize.pod:609 ../test-tool/libguestfs-test-tool.pod:102
 813 #: ../tools/virt-list-filesystems.pl:216 ../tools/virt-list-partitions.pl:285
 814 #: ../tools/virt-make-fs.pl:572 ../tools/virt-tar.pl:319
 815 #: ../tools/virt-win-reg.pl:780
 816 msgid ""
 817 "This program is free software; you can redistribute it and/or modify it "
 818 "under the terms of the GNU General Public License as published by the Free "
 819 "Software Foundation; either version 2 of the License, or (at your option) "
 820 "any later version."
 821 msgstr ""
 822
 823 #. type: textblock
 824 #: ../cat/virt-cat.pod:226 ../cat/virt-filesystems.pod:401
 825 #: ../cat/virt-ls.pod:520 ../df/virt-df.pod:248 ../edit/virt-edit.pod:381
 826 #: ../fish/guestfish.pod:1274 ../fish/virt-copy-in.pod:74
 827 #: ../fish/virt-copy-out.pod:63 ../fish/virt-tar-in.pod:72
 828 #: ../fish/virt-tar-out.pod:65 ../fuse/guestmount.pod:333
 829 #: ../inspector/virt-inspector.pod:412 ../rescue/virt-rescue.pod:305
 830 #: ../resize/virt-resize.pod:614 ../test-tool/libguestfs-test-tool.pod:107
 831 #: ../tools/virt-list-filesystems.pl:221 ../tools/virt-list-partitions.pl:290
 832 #: ../tools/virt-make-fs.pl:577 ../tools/virt-tar.pl:324
 833 #: ../tools/virt-win-reg.pl:785
 834 msgid ""
 835 "This program is distributed in the hope that it will be useful, but WITHOUT "
 836 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
 837 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
 838 "more details."
 839 msgstr ""
 840 "Ця програма поширюється у сподіванні, що вона буде корисною, але БЕЗ БУДЬ-"
 841 "ЯКИХ ГАРАНТІЙНИХ ЗОБОВ’ЯЗАНЬ; навіть без очевидної гарантії ПРАЦЕЗДАТНОСТІ "
 842 "або ПРИДАТНОСТІ ДЛЯ ВИКОРИСТАННЯ З ПЕВНОЮ МЕТОЮ. Докладніше про це можна "
 843 "дізнатися з GNU General Public License."
 844
 845 #. type: textblock
 846 #: ../cat/virt-cat.pod:231 ../cat/virt-filesystems.pod:406
 847 #: ../cat/virt-ls.pod:525 ../df/virt-df.pod:253 ../edit/virt-edit.pod:386
 848 #: ../fish/guestfish.pod:1279 ../fish/virt-copy-in.pod:79
 849 #: ../fish/virt-copy-out.pod:68 ../fish/virt-tar-in.pod:77
 850 #: ../fish/virt-tar-out.pod:70 ../fuse/guestmount.pod:338
 851 #: ../inspector/virt-inspector.pod:417 ../rescue/virt-rescue.pod:310
 852 #: ../resize/virt-resize.pod:619 ../test-tool/libguestfs-test-tool.pod:112
 853 #: ../tools/virt-list-filesystems.pl:226 ../tools/virt-list-partitions.pl:295
 854 #: ../tools/virt-make-fs.pl:582 ../tools/virt-tar.pl:329
 855 #: ../tools/virt-win-reg.pl:790
 856 msgid ""
 857 "You should have received a copy of the GNU General Public License along with "
 858 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
 859 "Ave, Cambridge, MA 02139, USA."
 860 msgstr ""
 861
 862 #. type: textblock
 863 #: ../cat/virt-filesystems.pod:5
 864 msgid ""
 865 "virt-filesystems - List filesystems, partitions, block devices, LVM in a "
 866 "virtual machine or disk image"
 867 msgstr ""
 868
 869 #. type: verbatim
 870 #: ../cat/virt-filesystems.pod:9
 871 #, fuzzy, no-wrap
 872 #| msgid ""
 873 #| " virt-list-partitions [--options] domname\n"
 874 #| "\n"
 875 msgid ""
 876 " virt-filesystems [--options] -d domname\n"
 877 "\n"
 878 msgstr ""
 879 " virt-list-partitions [--параметри] назва_домену\n"
 880 "\n"
 881
 882 #. type: verbatim
 883 #: ../cat/virt-filesystems.pod:11
 884 #, fuzzy, no-wrap
 885 #| msgid ""
 886 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
 887 #| "\n"
 888 msgid ""
 889 " virt-filesystems [--options] -a disk.img [-a disk.img ...]\n"
 890 "\n"
 891 msgstr ""
 892 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
 893 "\n"
 894
 895 #. type: textblock
 896 #: ../cat/virt-filesystems.pod:15
 897 msgid ""
 898 "This tool allows you to discover filesystems, partitions, logical volumes, "
 899 "and their sizes in a disk image or virtual machine.  It is a replacement for "
 900 "L<virt-list-filesystems(1)> and L<virt-list-partitions(1)>."
 901 msgstr ""
 902
 903 #. type: textblock
 904 #: ../cat/virt-filesystems.pod:20
 905 msgid ""
 906 "One use for this tool is from shell scripts to iterate over all filesystems "
 907 "from a disk image:"
 908 msgstr ""
 909
 910 #. type: verbatim
 911 #: ../cat/virt-filesystems.pod:23
 912 #, no-wrap
 913 msgid ""
 914 " for fs in $(virt-filesystems -a disk.img); do\n"
 915 "   # ...\n"
 916 " done\n"
 917 "\n"
 918 msgstr ""
 919
 920 #. type: textblock
 921 #: ../cat/virt-filesystems.pod:27
 922 msgid ""
 923 "Another use is to list partitions before using another tool to modify those "
 924 "partitions (such as L<virt-resize(1)>).  If you are curious about what an "
 925 "unknown disk image contains, use this tool along with L<virt-inspector(1)>."
 926 msgstr ""
 927
 928 #. type: textblock
 929 #: ../cat/virt-filesystems.pod:32
 930 msgid ""
 931 "Various command line options control what this program displays.  You need "
 932 "to give either I<-a> or I<-d> options to specify the disk image or libvirt "
 933 "guest respectively.  If you just specify that then the program shows "
 934 "filesystems found, one per line, like this:"
 935 msgstr ""
 936
 937 #. type: verbatim
 938 #: ../cat/virt-filesystems.pod:37
 939 #, no-wrap
 940 msgid ""
 941 " $ virt-filesystems -a disk.img\n"
 942 " /dev/sda1\n"
 943 " /dev/vg_guest/lv_root\n"
 944 "\n"
 945 msgstr ""
 946
 947 #. type: textblock
 948 #: ../cat/virt-filesystems.pod:41
 949 msgid ""
 950 "If you add I<-l> or I<--long> then the output includes extra information:"
 951 msgstr ""
 952
 953 #. type: verbatim
 954 #: ../cat/virt-filesystems.pod:44
 955 #, no-wrap
 956 msgid ""
 957 " $ virt-filesystems -a disk.img -l\n"
 958 " Name                   Type         VFS   Label  Size\n"
 959 " /dev/sda1              filesystem   ext4  boot   524288000\n"
 960 " /dev/vg_guest/lv_root  filesystem   ext4  root   10212081664\n"
 961 "\n"
 962 msgstr ""
 963
 964 #. type: textblock
 965 #: ../cat/virt-filesystems.pod:49
 966 msgid ""
 967 "If you add I<--extra> then non-mountable (swap, unknown) filesystems are "
 968 "shown as well:"
 969 msgstr ""
 970
 971 #. type: verbatim
 972 #: ../cat/virt-filesystems.pod:52
 973 #, no-wrap
 974 msgid ""
 975 " $ virt-filesystems -a disk.img --extra\n"
 976 " /dev/sda1\n"
 977 " /dev/vg_guest/lv_root\n"
 978 " /dev/vg_guest/lv_swap\n"
 979 " /dev/vg_guest/lv_data\n"
 980 "\n"
 981 msgstr ""
 982
 983 #. type: textblock
 984 #: ../cat/virt-filesystems.pod:58
 985 msgid ""
 986 "If you add I<--partitions> then partitions are shown instead of filesystems:"
 987 msgstr ""
 988
 989 #. type: verbatim
 990 #: ../cat/virt-filesystems.pod:60
 991 #, no-wrap
 992 msgid ""
 993 " $ virt-filesystems -a disk.img --partitions\n"
 994 " /dev/sda1\n"
 995 " /dev/sda2\n"
 996 "\n"
 997 msgstr ""
 998
 999 #. type: textblock
1000 #: ../cat/virt-filesystems.pod:64
1001 msgid ""
1002 "Similarly you can use I<--logical-volumes>, I<--volume-groups>, I<--physical-"
1003 "volumes>, I<--block-devices> to list those items."
1004 msgstr ""
1005
1006 #. type: textblock
1007 #: ../cat/virt-filesystems.pod:67
1008 msgid ""
1009 "You can use these options in combination as well (if you want a combination "
1010 "including filesystems, you have to add I<--filesystems>).  Notice that some "
1011 "items fall into several categories (eg. C</dev/sda1> might be both a "
1012 "partition and a filesystem).  These items are listed several times.  To get "
1013 "a list which includes absolutely everything that virt-filesystems knows "
1014 "about, use the I<--all> option."
1015 msgstr ""
1016
1017 #. type: textblock
1018 #: ../cat/virt-filesystems.pod:74
1019 msgid ""
1020 "UUIDs (because they are quite long) are not shown by default.  Add the I<--"
1021 "uuid> option to display device and filesystem UUIDs in the long output."
1022 msgstr ""
1023
1024 #. type: textblock
1025 #: ../cat/virt-filesystems.pod:78
1026 msgid ""
1027 "I<--all --long --uuid> is a useful combination to display all possible "
1028 "information about everything."
1029 msgstr ""
1030
1031 #. type: verbatim
1032 #: ../cat/virt-filesystems.pod:81
1033 #, no-wrap
1034 msgid ""
1035 " $ virt-filesystems -a win.img --all --long --uuid -h\n"
1036 " Name      Type       VFS  Label           Size Parent   UUID\n"
1037 " /dev/sda1 filesystem ntfs System Reserved 100M -        F81C92571C92112C\n"
1038 " /dev/sda2 filesystem ntfs -               20G  -        F2E8996AE8992E3B\n"
1039 " /dev/sda1 partition  -    -               100M /dev/sda -\n"
1040 " /dev/sda2 partition  -    -               20G  /dev/sda -\n"
1041 " /dev/sda  device     -    -               20G  -        -\n"
1042 "\n"
1043 msgstr ""
1044
1045 #. type: textblock
1046 #: ../cat/virt-filesystems.pod:89
1047 msgid ""
1048 "For machine-readable output, use I<--csv> to get Comma-Separated Values."
1049 msgstr ""
1050
1051 #. type: =item
1052 #: ../cat/virt-filesystems.pod:110 ../tools/virt-list-filesystems.pl:121
1053 #, fuzzy
1054 #| msgid "B<--help>"
1055 msgid "B<--all>"
1056 msgstr "B<--help>"
1057
1058 #. type: textblock
1059 #: ../cat/virt-filesystems.pod:112
1060 msgid ""
1061 "Display everything.  This is currently the same as specifying these options: "
1062 "I<--filesystems>, I<--extra>, I<--partitions>, I<--block-devices>, I<--"
1063 "logical-volumes>, I<--volume-groups>, I<--physical-volumes>.  (More may be "
1064 "added to this list in future)."
1065 msgstr ""
1066
1067 #. type: textblock
1068 #: ../cat/virt-filesystems.pod:117
1069 #, fuzzy
1070 #| msgid "See also L</is-lv>."
1071 msgid "See also I<--long>."
1072 msgstr "Див. також L</is-lv>."
1073
1074 #. type: =item
1075 #: ../cat/virt-filesystems.pod:119
1076 #, fuzzy
1077 #| msgid "B<--live>"
1078 msgid "B<--blkdevs>"
1079 msgstr "B<--live>"
1080
1081 #. type: =item
1082 #: ../cat/virt-filesystems.pod:121
1083 #, fuzzy
1084 #| msgid "is-blockdev"
1085 msgid "B<--block-devices>"
1086 msgstr "is-blockdev"
1087
1088 #. type: textblock
1089 #: ../cat/virt-filesystems.pod:123
1090 #, fuzzy
1091 #| msgid "is-blockdev"
1092 msgid "Display block devices."
1093 msgstr "is-blockdev"
1094
1095 #. type: =item
1096 #: ../cat/virt-filesystems.pod:135 ../cat/virt-ls.pod:301 ../df/virt-df.pod:88
1097 #, fuzzy
1098 #| msgid "B<--csh>"
1099 msgid "B<--csv>"
1100 msgstr "B<--csh>"
1101
1102 #. type: textblock
1103 #: ../cat/virt-filesystems.pod:137 ../cat/virt-ls.pod:303 ../df/virt-df.pod:90
1104 msgid ""
1105 "Write out the results in CSV format (comma-separated values).  This format "
1106 "can be imported easily into databases and spreadsheets, but read L</NOTE "
1107 "ABOUT CSV FORMAT> below."
1108 msgstr ""
1109
1110 #. type: textblock
1111 #: ../cat/virt-filesystems.pod:150
1112 msgid ""
1113 "When prompting for keys and passphrases, virt-filesystems normally turns "
1114 "echoing off so you cannot see what you are typing.  If you are not worried "
1115 "about Tempest attacks and there is no one else in the room you can specify "
1116 "this flag to see what you are typing."
1117 msgstr ""
1118
1119 #. type: =item
1120 #: ../cat/virt-filesystems.pod:155
1121 #, fuzzy
1122 #| msgid "B<--ro>"
1123 msgid "B<--extra>"
1124 msgstr "B<--ro>"
1125
1126 #. type: textblock
1127 #: ../cat/virt-filesystems.pod:157
1128 msgid ""
1129 "This causes filesystems that are not ordinary, mountable filesystems to be "
1130 "displayed.  This category includes swapspace, and filesystems that are empty "
1131 "or contain unknown data."
1132 msgstr ""
1133
1134 #. type: textblock
1135 #: ../cat/virt-filesystems.pod:161
1136 msgid "This option implies I<--filesystems>."
1137 msgstr ""
1138
1139 #. type: =item
1140 #: ../cat/virt-filesystems.pod:163
1141 #, fuzzy
1142 #| msgid "list-filesystems"
1143 msgid "B<--filesystems>"
1144 msgstr "list-filesystems"
1145
1146 #. type: textblock
1147 #: ../cat/virt-filesystems.pod:165
1148 msgid ""
1149 "Display mountable filesystems.  If no display option was selected then this "
1150 "option is implied."
1151 msgstr ""
1152
1153 #. type: textblock
1154 #: ../cat/virt-filesystems.pod:168
1155 msgid "With I<--extra>, non-mountable filesystems are shown too."
1156 msgstr ""
1157
1158 #. type: verbatim
1159 #: ../cat/virt-filesystems.pod:181
1160 #, fuzzy, no-wrap
1161 #| msgid ""
1162 #| " guestfish --format=raw -a disk.img\n"
1163 #| "\n"
1164 msgid ""
1165 " virt-filesystems --format=raw -a disk.img\n"
1166 "\n"
1167 msgstr ""
1168 " guestfish --format=raw -a disk.img\n"
1169 "\n"
1170
1171 #. type: verbatim
1172 #: ../cat/virt-filesystems.pod:185
1173 #, fuzzy, no-wrap
1174 #| msgid ""
1175 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
1176 #| "\n"
1177 msgid ""
1178 " virt-filesystems --format=raw -a disk.img --format -a another.img\n"
1179 "\n"
1180 msgstr ""
1181 " guestfish --format=raw -a disk.img --format -a another.img\n"
1182 "\n"
1183
1184 #. type: =item
1185 #: ../cat/virt-filesystems.pod:194 ../cat/virt-ls.pod:352
1186 #: ../df/virt-df.pod:125 ../fish/guestfish.pod:156
1187 #: ../tools/virt-list-partitions.pl:109
1188 msgid "B<-h>"
1189 msgstr "B<-h>"
1190
1191 #. type: =item
1192 #: ../cat/virt-filesystems.pod:196 ../cat/virt-ls.pod:354
1193 #: ../df/virt-df.pod:127 ../tools/virt-list-partitions.pl:111
1194 #, fuzzy
1195 #| msgid "B<-h> | B<--human-readable>"
1196 msgid "B<--human-readable>"
1197 msgstr "B<-h> | B<--human-readable>"
1198
1199 #. type: textblock
1200 #: ../cat/virt-filesystems.pod:198
1201 msgid "In I<--long> mode, display sizes in human-readable format."
1202 msgstr ""
1203
1204 #. type: =item
1205 #: ../cat/virt-filesystems.pod:205 ../cat/virt-ls.pod:366
1206 #: ../tools/virt-list-filesystems.pl:108 ../tools/virt-list-partitions.pl:119
1207 msgid "B<-l>"
1208 msgstr ""
1209
1210 #. type: =item
1211 #: ../cat/virt-filesystems.pod:207 ../cat/virt-ls.pod:368
1212 #: ../tools/virt-list-filesystems.pl:110 ../tools/virt-list-partitions.pl:121
1213 #, fuzzy
1214 #| msgid "B<--ro>"
1215 msgid "B<--long>"
1216 msgstr "B<--ro>"
1217
1218 #. type: textblock
1219 #: ../cat/virt-filesystems.pod:209
1220 msgid "Display extra columns of data (\"long format\")."
1221 msgstr ""
1222
1223 #. type: textblock
1224 #: ../cat/virt-filesystems.pod:211
1225 msgid "A title row is added unless you also specify I<--no-title>."
1226 msgstr ""
1227
1228 #. type: textblock
1229 #: ../cat/virt-filesystems.pod:213
1230 msgid ""
1231 "The extra columns displayed depend on what output you select, and the "
1232 "ordering of columns may change in future versions.  Use the title row, I<--"
1233 "csv> output and/or L<csvtool(1)> to match columns to data in external "
1234 "programs."
1235 msgstr ""
1236
1237 #. type: textblock
1238 #: ../cat/virt-filesystems.pod:218
1239 msgid ""
1240 "Use I<-h> if you want sizes to be displayed in human-readable format.  The "
1241 "default is to show raw numbers of I<bytes>."
1242 msgstr ""
1243
1244 #. type: textblock
1245 #: ../cat/virt-filesystems.pod:221
1246 msgid "Use I<--uuid> to display UUIDs too."
1247 msgstr ""
1248
1249 #. type: =item
1250 #: ../cat/virt-filesystems.pod:223
1251 #, fuzzy
1252 #| msgid "B<--live>"
1253 msgid "B<--lvs>"
1254 msgstr "B<--live>"
1255
1256 #. type: =item
1257 #: ../cat/virt-filesystems.pod:225
1258 #, fuzzy
1259 #| msgid "B<--live>"
1260 msgid "B<--logvols>"
1261 msgstr "B<--live>"
1262
1263 #. type: =item
1264 #: ../cat/virt-filesystems.pod:227
1265 #, fuzzy
1266 #| msgid "B<--live>"
1267 msgid "B<--logical-volumes>"
1268 msgstr "B<--live>"
1269
1270 #. type: textblock
1271 #: ../cat/virt-filesystems.pod:229
1272 msgid ""
1273 "Display LVM logical volumes.  In this mode, these are displayed irrespective "
1274 "of whether the LVs contain filesystems."
1275 msgstr ""
1276
1277 #. type: =item
1278 #: ../cat/virt-filesystems.pod:232
1279 #, fuzzy
1280 #| msgid "B<--listen>"
1281 msgid "B<--no-title>"
1282 msgstr "B<--listen>"
1283
1284 #. type: textblock
1285 #: ../cat/virt-filesystems.pod:234
1286 msgid "In I<--long> mode, don't add a title row."
1287 msgstr ""
1288
1289 #. type: textblock
1290 #: ../cat/virt-filesystems.pod:236
1291 msgid ""
1292 "Note that the order of the columns is not fixed, and may change in future "
1293 "versions of virt-filesystems, so using this option may give you unexpected "
1294 "surprises."
1295 msgstr ""
1296
1297 #. type: =item
1298 #: ../cat/virt-filesystems.pod:240
1299 #, fuzzy
1300 #| msgid "B<--partition>"
1301 msgid "B<--parts>"
1302 msgstr "B<--partition>"
1303
1304 #. type: =item
1305 #: ../cat/virt-filesystems.pod:242
1306 #, fuzzy
1307 #| msgid "B<--partition>"
1308 msgid "B<--partitions>"
1309 msgstr "B<--partition>"
1310
1311 #. type: textblock
1312 #: ../cat/virt-filesystems.pod:244
1313 msgid ""
1314 "Display partitions.  In this mode, these are displayed irrespective of "
1315 "whether the partitions contain filesystems."
1316 msgstr ""
1317
1318 #. type: =item
1319 #: ../cat/virt-filesystems.pod:247
1320 #, fuzzy
1321 #| msgid "B<--csh>"
1322 msgid "B<--pvs>"
1323 msgstr "B<--csh>"
1324
1325 #. type: =item
1326 #: ../cat/virt-filesystems.pod:249
1327 #, fuzzy
1328 #| msgid "B<--verbose>"
1329 msgid "B<--physvols>"
1330 msgstr "B<--verbose>"
1331
1332 #. type: =item
1333 #: ../cat/virt-filesystems.pod:251
1334 msgid "B<--physical-volumes>"
1335 msgstr ""
1336
1337 #. type: textblock
1338 #: ../cat/virt-filesystems.pod:253
1339 msgid "Display LVM physical volumes."
1340 msgstr ""
1341
1342 #. type: =item
1343 #: ../cat/virt-filesystems.pod:255 ../df/virt-df.pod:163
1344 #, fuzzy
1345 #| msgid "B<--live>"
1346 msgid "B<--uuid>"
1347 msgstr "B<--live>"
1348
1349 #. type: =item
1350 #: ../cat/virt-filesystems.pod:257
1351 #, fuzzy
1352 #| msgid "B<--csh>"
1353 msgid "B<--uuids>"
1354 msgstr "B<--csh>"
1355
1356 #. type: textblock
1357 #: ../cat/virt-filesystems.pod:259
1358 msgid "In I<--long> mode, display UUIDs as well."
1359 msgstr ""
1360
1361 #. type: =item
1362 #: ../cat/virt-filesystems.pod:273
1363 #, fuzzy
1364 #| msgid "B<--csh>"
1365 msgid "B<--vgs>"
1366 msgstr "B<--csh>"
1367
1368 #. type: =item
1369 #: ../cat/virt-filesystems.pod:275
1370 #, fuzzy
1371 #| msgid "B<--verbose>"
1372 msgid "B<--volgroups>"
1373 msgstr "B<--verbose>"
1374
1375 #. type: =item
1376 #: ../cat/virt-filesystems.pod:277
1377 #, fuzzy
1378 #| msgid "B<--verbose>"
1379 msgid "B<--volume-groups>"
1380 msgstr "B<--verbose>"
1381
1382 #. type: textblock
1383 #: ../cat/virt-filesystems.pod:279
1384 msgid "Display LVM volume groups."
1385 msgstr ""
1386
1387 #. type: =head1
1388 #: ../cat/virt-filesystems.pod:287
1389 msgid "COLUMNS"
1390 msgstr ""
1391
1392 #. type: textblock
1393 #: ../cat/virt-filesystems.pod:289
1394 msgid ""
1395 "Note that columns in the output are subject to reordering and change in "
1396 "future versions of this tool."
1397 msgstr ""
1398
1399 #. type: =item
1400 #: ../cat/virt-filesystems.pod:294
1401 msgid "B<Name>"
1402 msgstr ""
1403
1404 #. type: textblock
1405 #: ../cat/virt-filesystems.pod:296
1406 msgid "The filesystem, partition, block device or LVM name."
1407 msgstr ""
1408
1409 #. type: textblock
1410 #: ../cat/virt-filesystems.pod:298
1411 msgid ""
1412 "For device and partition names these are displayed as canonical libguestfs "
1413 "names, so that for example C</dev/sda2> is the second partition on the first "
1414 "device."
1415 msgstr ""
1416
1417 #. type: textblock
1418 #: ../cat/virt-filesystems.pod:302
1419 msgid ""
1420 "If the I<--long> option is B<not> specified, then only the name column is "
1421 "shown in the output."
1422 msgstr ""
1423
1424 #. type: =item
1425 #: ../cat/virt-filesystems.pod:305
1426 #, fuzzy
1427 #| msgid "B<-N type>"
1428 msgid "B<Type>"
1429 msgstr "B<-N тип>"
1430
1431 #. type: textblock
1432 #: ../cat/virt-filesystems.pod:307
1433 msgid "The object type, for example C<filesystem>, C<lv>, C<device> etc."
1434 msgstr ""
1435
1436 #. type: =item
1437 #: ../cat/virt-filesystems.pod:309
1438 msgid "B<VFS>"
1439 msgstr ""
1440
1441 #. type: textblock
1442 #: ../cat/virt-filesystems.pod:311
1443 msgid ""
1444 "If there is a filesystem, then this column displays the filesystem type if "
1445 "one could be detected, eg. C<ext4>."
1446 msgstr ""
1447
1448 #. type: =item
1449 #: ../cat/virt-filesystems.pod:314
1450 msgid "B<Label>"
1451 msgstr ""
1452
1453 #. type: textblock
1454 #: ../cat/virt-filesystems.pod:316
1455 msgid ""
1456 "If the object has a label (used for identifying and mounting filesystems) "
1457 "then this column contains the label."
1458 msgstr ""
1459
1460 #. type: =item
1461 #: ../cat/virt-filesystems.pod:319
1462 #, fuzzy
1463 #| msgid "B<part_size>"
1464 msgid "B<Size>"
1465 msgstr "B<part_size>"
1466
1467 #. type: textblock
1468 #: ../cat/virt-filesystems.pod:321
1469 msgid ""
1470 "The size of the object in bytes.  If the I<--human> option is used then the "
1471 "size is displayed in a human-readable form."
1472 msgstr ""
1473
1474 #. type: =item
1475 #: ../cat/virt-filesystems.pod:324
1476 msgid "B<Parent>"
1477 msgstr ""
1478
1479 #. type: textblock
1480 #: ../cat/virt-filesystems.pod:326
1481 msgid ""
1482 "The parent column records the parent relationship between objects.  For "
1483 "example, if the object is a partition, then this column contains the name of "
1484 "the containing device.  If the object is a logical volume, then this column "
1485 "is the name of the volume group."
1486 msgstr ""
1487
1488 #. type: =item
1489 #: ../cat/virt-filesystems.pod:331
1490 msgid "B<UUID>"
1491 msgstr ""
1492
1493 #. type: textblock
1494 #: ../cat/virt-filesystems.pod:333
1495 msgid ""
1496 "If the object has a UUID (used for identifying and mounting filesystems and "
1497 "block devices) then this column contains the UUID as a string."
1498 msgstr ""
1499
1500 #. type: textblock
1501 #: ../cat/virt-filesystems.pod:337
1502 msgid "The UUID is only displayed if the I<--uuid> option is given."
1503 msgstr ""
1504
1505 #. type: =head1
1506 #: ../cat/virt-filesystems.pod:341 ../cat/virt-ls.pod:459
1507 #: ../df/virt-df.pod:191
1508 msgid "NOTE ABOUT CSV FORMAT"
1509 msgstr ""
1510
1511 #. type: textblock
1512 #: ../cat/virt-filesystems.pod:343 ../cat/virt-ls.pod:461
1513 #: ../df/virt-df.pod:193
1514 msgid ""
1515 "Comma-separated values (CSV) is a deceptive format.  It I<seems> like it "
1516 "should be easy to parse, but it is definitely not easy to parse."
1517 msgstr ""
1518
1519 #. type: textblock
1520 #: ../cat/virt-filesystems.pod:346 ../cat/virt-ls.pod:464
1521 #: ../df/virt-df.pod:196
1522 msgid ""
1523 "Myth: Just split fields at commas.  Reality: This does I<not> work "
1524 "reliably.  This example has two columns:"
1525 msgstr ""
1526
1527 #. type: verbatim
1528 #: ../cat/virt-filesystems.pod:349 ../cat/virt-ls.pod:467
1529 #: ../df/virt-df.pod:199
1530 #, no-wrap
1531 msgid ""
1532 " \"foo,bar\",baz\n"
1533 "\n"
1534 msgstr ""
1535
1536 #. type: textblock
1537 #: ../cat/virt-filesystems.pod:351 ../cat/virt-ls.pod:469
1538 #: ../df/virt-df.pod:201
1539 msgid ""
1540 "Myth: Read the file one line at a time.  Reality: This does I<not> work "
1541 "reliably.  This example has one row:"
1542 msgstr ""
1543
1544 #. type: verbatim
1545 #: ../cat/virt-filesystems.pod:354 ../cat/virt-ls.pod:472
1546 #: ../df/virt-df.pod:204
1547 #, no-wrap
1548 msgid ""
1549 " \"foo\n"
1550 " bar\",baz\n"
1551 "\n"
1552 msgstr ""
1553
1554 #. type: textblock
1555 #: ../cat/virt-filesystems.pod:357 ../cat/virt-ls.pod:475
1556 #: ../df/virt-df.pod:207
1557 msgid ""
1558 "For shell scripts, use C<csvtool> (L<http://merjis.com/developers/csv> also "
1559 "packaged in major Linux distributions)."
1560 msgstr ""
1561
1562 #. type: textblock
1563 #: ../cat/virt-filesystems.pod:360 ../cat/virt-ls.pod:478
1564 #: ../df/virt-df.pod:210
1565 msgid ""
1566 "For other languages, use a CSV processing library (eg. C<Text::CSV> for Perl "
1567 "or Python's built-in csv library)."
1568 msgstr ""
1569
1570 #. type: textblock
1571 #: ../cat/virt-filesystems.pod:363 ../cat/virt-ls.pod:481
1572 #: ../df/virt-df.pod:213
1573 msgid "Most spreadsheets and databases can import CSV directly."
1574 msgstr ""
1575
1576 #. type: textblock
1577 #: ../cat/virt-filesystems.pod:379
1578 #, fuzzy
1579 #| msgid ""
1580 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
1581 #| "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
1582 #| "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
1583 msgid ""
1584 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-df(1)>, L<virt-list-"
1585 "filesystems(1)>, L<virt-list-partitions(1)>, L<csvtool(1)>, L<http://"
1586 "libguestfs.org/>."
1587 msgstr ""
1588 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
1589 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
1590 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
1591
1592 #. type: textblock
1593 #: ../cat/virt-filesystems.pod:394 ../tools/virt-make-fs.pl:570
1594 #: ../tools/virt-win-reg.pl:778
1595 msgid "Copyright (C) 2010 Red Hat Inc."
1596 msgstr ""
1597
1598 #. type: textblock
1599 #: ../cat/virt-ls.pod:5
1600 msgid "virt-ls - List files in a virtual machine"
1601 msgstr ""
1602
1603 #. type: verbatim
1604 #: ../cat/virt-ls.pod:9
1605 #, no-wrap
1606 msgid ""
1607 " virt-ls [--options] -d domname directory [directory ...]\n"
1608 "\n"
1609 msgstr ""
1610
1611 #. type: verbatim
1612 #: ../cat/virt-ls.pod:11
1613 #, fuzzy, no-wrap
1614 #| msgid ""
1615 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
1616 #| "\n"
1617 msgid ""
1618 " virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]\n"
1619 "\n"
1620 msgstr ""
1621 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
1622 "\n"
1623
1624 #. type: textblock
1625 #: ../cat/virt-ls.pod:13 ../df/virt-df.pod:15 ../rescue/virt-rescue.pod:13
1626 msgid "Old style:"
1627 msgstr ""
1628
1629 #. type: verbatim
1630 #: ../cat/virt-ls.pod:15
1631 #, fuzzy, no-wrap
1632 #| msgid ""
1633 #| " virt-list-partitions [--options] domname\n"
1634 #| "\n"
1635 msgid ""
1636 " virt-ls [--options] domname directory\n"
1637 "\n"
1638 msgstr ""
1639 " virt-list-partitions [--параметри] назва_домену\n"
1640 "\n"
1641
1642 #. type: verbatim
1643 #: ../cat/virt-ls.pod:17
1644 #, fuzzy, no-wrap
1645 #| msgid ""
1646 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
1647 #| "\n"
1648 msgid ""
1649 " virt-ls [--options] disk.img [disk.img ...] directory\n"
1650 "\n"
1651 msgstr ""
1652 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
1653 "\n"
1654
1655 #. type: textblock
1656 #: ../cat/virt-ls.pod:21
1657 msgid ""
1658 "C<virt-ls> lists filenames, file sizes, checksums, extended attributes and "
1659 "more from a virtual machine or disk image."
1660 msgstr ""
1661
1662 #. type: textblock
1663 #: ../cat/virt-ls.pod:24
1664 msgid ""
1665 "Multiple directory names can be given, in which case the output from each is "
1666 "concatenated."
1667 msgstr ""
1668
1669 #. type: textblock
1670 #: ../cat/virt-ls.pod:27
1671 msgid ""
1672 "To list directories from a libvirt guest use the I<-d> option to specify the "
1673 "name of the guest.  For a disk image, use the I<-a> option."
1674 msgstr ""
1675
1676 #. type: textblock
1677 #: ../cat/virt-ls.pod:31
1678 msgid ""
1679 "C<virt-ls> can do many simple file listings.  For more complicated cases you "
1680 "may need to use L<guestfish(1)>, or write a program directly to the L<guestfs"
1681 "(3)> API."
1682 msgstr ""
1683
1684 #. type: textblock
1685 #: ../cat/virt-ls.pod:37
1686 msgid "Get a list of all files and directories in a virtual machine:"
1687 msgstr ""
1688
1689 #. type: verbatim
1690 #: ../cat/virt-ls.pod:39
1691 #, fuzzy, no-wrap
1692 #| msgid ""
1693 #| " guestfish --ro -d myguest -i\n"
1694 #| "\n"
1695 msgid ""
1696 " virt-ls -R -d guest /\n"
1697 "\n"
1698 msgstr ""
1699 " guestfish --ro -d myguest -i\n"
1700 "\n"
1701
1702 #. type: textblock
1703 #: ../cat/virt-ls.pod:41
1704 msgid "List all setuid or setgid programs in a Linux virtual machine:"
1705 msgstr ""
1706
1707 #. type: verbatim
1708 #: ../cat/virt-ls.pod:43
1709 #, no-wrap
1710 msgid ""
1711 " virt-ls -lR -d guest / | grep '^- [42]'\n"
1712 "\n"
1713 msgstr ""
1714
1715 #. type: textblock
1716 #: ../cat/virt-ls.pod:45
1717 msgid "List all public-writable directories in a Linux virtual machine:"
1718 msgstr ""
1719
1720 #. type: verbatim
1721 #: ../cat/virt-ls.pod:47
1722 #, no-wrap
1723 msgid ""
1724 " virt-ls -lR -d guest / | grep '^d ...7'\n"
1725 "\n"
1726 msgstr ""
1727
1728 #. type: textblock
1729 #: ../cat/virt-ls.pod:49
1730 msgid "List all Unix domain sockets in a Linux virtual machine:"
1731 msgstr ""
1732
1733 #. type: verbatim
1734 #: ../cat/virt-ls.pod:51
1735 #, no-wrap
1736 msgid ""
1737 " virt-ls -lR -d guest / | grep '^s'\n"
1738 "\n"
1739 msgstr ""
1740
1741 #. type: textblock
1742 #: ../cat/virt-ls.pod:53
1743 msgid "List all regular files with filenames ending in '.png':"
1744 msgstr ""
1745
1746 #. type: verbatim
1747 #: ../cat/virt-ls.pod:55
1748 #, no-wrap
1749 msgid ""
1750 " virt-ls -lR -d guest / | grep -i '^-.*\\.png$'\n"
1751 "\n"
1752 msgstr ""
1753
1754 #. type: textblock
1755 #: ../cat/virt-ls.pod:57
1756 msgid "To display files larger than 10MB in home directories:"
1757 msgstr ""
1758
1759 #. type: verbatim
1760 #: ../cat/virt-ls.pod:59
1761 #, no-wrap
1762 msgid ""
1763 " virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'\n"
1764 "\n"
1765 msgstr ""
1766
1767 #. type: textblock
1768 #: ../cat/virt-ls.pod:61
1769 msgid "Find everything modified in the last 7 days:"
1770 msgstr ""
1771
1772 #. type: verbatim
1773 #: ../cat/virt-ls.pod:63
1774 #, no-wrap
1775 msgid ""
1776 " virt-ls -lR -d guest --time-days / | awk '$6 <= 7'\n"
1777 "\n"
1778 msgstr ""
1779
1780 #. type: textblock
1781 #: ../cat/virt-ls.pod:65
1782 msgid "Find regular files modified in the last 24 hours:"
1783 msgstr ""
1784
1785 #. type: verbatim
1786 #: ../cat/virt-ls.pod:67
1787 #, no-wrap
1788 msgid ""
1789 " virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'\n"
1790 "\n"
1791 msgstr ""
1792
1793 #. type: =head2
1794 #: ../cat/virt-ls.pod:69
1795 msgid "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
1796 msgstr ""
1797
1798 #. type: textblock
1799 #: ../cat/virt-ls.pod:71
1800 msgid ""
1801 "Find the differences between files in a guest and an earlier snapshot of the "
1802 "same guest."
1803 msgstr ""
1804
1805 #. type: verbatim
1806 #: ../cat/virt-ls.pod:74
1807 #, no-wrap
1808 msgid ""
1809 " virt-ls -lR -a snapshot.img / --uids --time-t > old\n"
1810 " virt-ls -lR -a current.img / --uids --time-t > new\n"
1811 " diff -u old new | less\n"
1812 "\n"
1813 msgstr ""
1814
1815 #. type: textblock
1816 #: ../cat/virt-ls.pod:78
1817 msgid ""
1818 "The commands above won't find files where the content has changed but the "
1819 "metadata (eg. file size and modification date) is the same.  To do that, you "
1820 "need to add the I<--checksum> parameter to both C<virt-ls> commands.  I<--"
1821 "checksum> can be quite slow since it has to read and compute a checksum of "
1822 "every regular file in the virtual machine."
1823 msgstr ""
1824
1825 #. type: =head1
1826 #: ../cat/virt-ls.pod:84
1827 msgid "OUTPUT MODES"
1828 msgstr ""
1829
1830 #. type: textblock
1831 #: ../cat/virt-ls.pod:86
1832 msgid ""
1833 "C<virt-ls> has four output modes, controlled by different combinations of "
1834 "the I<-l> and I<-R> options."
1835 msgstr ""
1836
1837 #. type: =head2
1838 #: ../cat/virt-ls.pod:89
1839 msgid "SIMPLE LISTING"
1840 msgstr ""
1841
1842 #. type: textblock
1843 #: ../cat/virt-ls.pod:91
1844 msgid "A simple listing is like the ordinary L<ls(1)> command:"
1845 msgstr ""
1846
1847 #. type: verbatim
1848 #: ../cat/virt-ls.pod:93
1849 #, no-wrap
1850 msgid ""
1851 " $ virt-ls -d guest /\n"
1852 " bin\n"
1853 " boot\n"
1854 " [etc.]\n"
1855 "\n"
1856 msgstr ""
1857
1858 #. type: =head2
1859 #: ../cat/virt-ls.pod:98
1860 #, fuzzy
1861 #| msgid "MOUNTING"
1862 msgid "LONG LISTING"
1863 msgstr "МОНТУВАННЯ"
1864
1865 #. type: textblock
1866 #: ../cat/virt-ls.pod:100
1867 msgid ""
1868 "With the I<-l> (I<--long>) option, the output is like the C<ls -l> command "
1869 "(more specifically, like the C<guestfs_ll> function)."
1870 msgstr ""
1871
1872 #. type: verbatim
1873 #: ../cat/virt-ls.pod:103
1874 #, no-wrap
1875 msgid ""
1876 " $ virt-ls -l -d guest /\n"
1877 " total 204\n"
1878 " dr-xr-xr-x.   2 root root   4096 2009-08-25 19:06 bin\n"
1879 " dr-xr-xr-x.   5 root root   3072 2009-08-25 19:06 boot\n"
1880 " [etc.]\n"
1881 "\n"
1882 msgstr ""
1883
1884 #. type: textblock
1885 #: ../cat/virt-ls.pod:109
1886 msgid ""
1887 "Note that while this is useful for displaying a directory, do not try "
1888 "parsing this output in another program.  Use L</RECURSIVE LONG LISTING> "
1889 "instead."
1890 msgstr ""
1891
1892 #. type: =head2
1893 #: ../cat/virt-ls.pod:113
1894 msgid "RECURSIVE LISTING"
1895 msgstr ""
1896
1897 #. type: textblock
1898 #: ../cat/virt-ls.pod:115
1899 msgid ""
1900 "With the I<-R> (I<--recursive>) option, C<virt-ls> lists the names of files "
1901 "and directories recursively:"
1902 msgstr ""
1903
1904 #. type: verbatim
1905 #: ../cat/virt-ls.pod:118
1906 #, no-wrap
1907 msgid ""
1908 " $ virt-ls -R -d guest /tmp\n"
1909 " foo\n"
1910 " foo/bar\n"
1911 " [etc.]\n"
1912 "\n"
1913 msgstr ""
1914
1915 #. type: textblock
1916 #: ../cat/virt-ls.pod:123
1917 msgid ""
1918 "To generate this output, C<virt-ls> runs the C<guestfs_find0> function and "
1919 "converts C<\\0> characters to C<\\n>."
1920 msgstr ""
1921
1922 #. type: =head2
1923 #: ../cat/virt-ls.pod:126
1924 msgid "RECURSIVE LONG LISTING"
1925 msgstr ""
1926
1927 #. type: textblock
1928 #: ../cat/virt-ls.pod:128
1929 msgid ""
1930 "Using I<-lR> options together changes the output to display directories "
1931 "recursively, with file stats, and optionally other features such as "
1932 "checksums and extended attributes."
1933 msgstr ""
1934
1935 #. type: textblock
1936 #: ../cat/virt-ls.pod:132
1937 msgid ""
1938 "Most of the interesting features of C<virt-ls> are only available when using "
1939 "I<-lR> mode."
1940 msgstr ""
1941
1942 #. type: textblock
1943 #: ../cat/virt-ls.pod:135
1944 msgid ""
1945 "The fields are normally space-separated.  Filenames are B<not> quoted, so "
1946 "you cannot use the output in another program (because filenames can contain "
1947 "spaces and other unsafe characters).  If the guest was untrusted and someone "
1948 "knew you were using C<virt-ls> to analyze the guest, they could play tricks "
1949 "on you by creating filenames with embedded newline characters.  To B<safely> "
1950 "parse the output in another program, use the I<--csv> (Comma-Separated "
1951 "Values) option."
1952 msgstr ""
1953
1954 #. type: textblock
1955 #: ../cat/virt-ls.pod:143
1956 msgid ""
1957 "Note that this output format is completely unrelated to the C<ls -lR> "
1958 "command."
1959 msgstr ""
1960
1961 #. type: verbatim
1962 #: ../cat/virt-ls.pod:146
1963 #, no-wrap
1964 msgid ""
1965 " $ virt-ls -lR -d guest /bin\n"
1966 " d 0555       4096 /bin\n"
1967 " - 0755        123 /bin/alsaunmute\n"
1968 " - 0755      28328 /bin/arch\n"
1969 " l 0777          4 /bin/awk -> gawk\n"
1970 " - 0755      27216 /bin/basename\n"
1971 " - 0755     943360 /bin/bash\n"
1972 " [etc.]\n"
1973 "\n"
1974 msgstr ""
1975
1976 #. type: textblock
1977 #: ../cat/virt-ls.pod:155
1978 msgid "These basic fields are always shown:"
1979 msgstr ""
1980
1981 #. type: =item
1982 #: ../cat/virt-ls.pod:159
1983 #, fuzzy
1984 #| msgid "vfs-type"
1985 msgid "type"
1986 msgstr "vfs-type"
1987
1988 #. type: textblock
1989 #: ../cat/virt-ls.pod:161
1990 msgid ""
1991 "The file type, one of: C<-> (regular file), C<d> (directory), C<c> "
1992 "(character device), C<b> (block device), C<p> (named pipe), C<l> (symbolic "
1993 "link), C<s> (socket) or C<u> (unknown)."
1994 msgstr ""
1995
1996 #. type: =item
1997 #: ../cat/virt-ls.pod:171
1998 #, fuzzy
1999 #| msgid "version"
2000 msgid "permissions"
2001 msgstr "version"
2002
2003 #. type: textblock
2004 #: ../cat/virt-ls.pod:173
2005 msgid "The Unix permissions, displayed as a 4 digit octal number."
2006 msgstr ""
2007
2008 #. type: =item
2009 #: ../cat/virt-ls.pod:175
2010 #, fuzzy
2011 #| msgid "filesize"
2012 msgid "size"
2013 msgstr "filesize"
2014
2015 #. type: textblock
2016 #: ../cat/virt-ls.pod:177
2017 msgid ""
2018 "The size of the file.  This is shown in bytes unless I<-h> or I<--human-"
2019 "readable> option is given, in which case this is shown as a human-readable "
2020 "number."
2021 msgstr ""
2022
2023 #. type: =head2
2024 #: ../cat/virt-ls.pod:181 ../fish/guestfish-actions.pod:4188
2025 msgid "path"
2026 msgstr ""
2027
2028 #. type: textblock
2029 #: ../cat/virt-ls.pod:183
2030 msgid "The full path of the file or directory."
2031 msgstr ""
2032
2033 #. type: =item
2034 #: ../cat/virt-ls.pod:185
2035 #, fuzzy
2036 #| msgid "readlink"
2037 msgid "link"
2038 msgstr "readlink"
2039
2040 #. type: textblock
2041 #: ../cat/virt-ls.pod:187
2042 msgid "For symbolic links only, the link target."
2043 msgstr ""
2044
2045 #. type: textblock
2046 #: ../cat/virt-ls.pod:191
2047 msgid ""
2048 "In I<-lR> mode, additional command line options enable the display of more "
2049 "fields."
2050 msgstr ""
2051
2052 #. type: textblock
2053 #: ../cat/virt-ls.pod:194
2054 msgid ""
2055 "With the I<--uids> flag, these additional fields are displayed before the "
2056 "path:"
2057 msgstr ""
2058
2059 #. type: =item
2060 #: ../cat/virt-ls.pod:199
2061 #, fuzzy
2062 #| msgid "lvuuid"
2063 msgid "uid"
2064 msgstr "lvuuid"
2065
2066 #. type: =item
2067 #: ../cat/virt-ls.pod:201
2068 #, fuzzy
2069 #| msgid "vguuid"
2070 msgid "gid"
2071 msgstr "vguuid"
2072
2073 #. type: textblock
2074 #: ../cat/virt-ls.pod:203
2075 msgid ""
2076 "The UID and GID of the owner of the file (displayed numerically).  Note "
2077 "these only make sense in the context of a Unix-like guest."
2078 msgstr ""
2079
2080 #. type: textblock
2081 #: ../cat/virt-ls.pod:208
2082 msgid "With the I<--times> flag, these additional fields are displayed:"
2083 msgstr ""
2084
2085 #. type: =item
2086 #: ../cat/virt-ls.pod:212
2087 #, fuzzy
2088 #| msgid "time"
2089 msgid "atime"
2090 msgstr "time"
2091
2092 #. type: textblock
2093 #: ../cat/virt-ls.pod:214
2094 msgid "The time of last access."
2095 msgstr ""
2096
2097 #. type: =item
2098 #: ../cat/virt-ls.pod:216
2099 #, fuzzy
2100 #| msgid "time"
2101 msgid "mtime"
2102 msgstr "time"
2103
2104 #. type: textblock
2105 #: ../cat/virt-ls.pod:218
2106 msgid "The time of last modification."
2107 msgstr ""
2108
2109 #. type: =item
2110 #: ../cat/virt-ls.pod:220
2111 #, fuzzy
2112 #| msgid "time"
2113 msgid "ctime"
2114 msgstr "time"
2115
2116 #. type: textblock
2117 #: ../cat/virt-ls.pod:222
2118 msgid "The time of last status change."
2119 msgstr ""
2120
2121 #. type: textblock
2122 #: ../cat/virt-ls.pod:226
2123 msgid ""
2124 "The time fields are displayed as string dates and times, unless one of the "
2125 "I<--time-t>, I<--time-relative> or I<--time-days> flags is given."
2126 msgstr ""
2127
2128 #. type: textblock
2129 #: ../cat/virt-ls.pod:229
2130 msgid "With the I<--extra-stats> flag, these additional fields are displayed:"
2131 msgstr ""
2132
2133 #. type: =item
2134 #: ../cat/virt-ls.pod:233
2135 #, fuzzy
2136 #| msgid "zero-device"
2137 msgid "device"
2138 msgstr "zero-device"
2139
2140 #. type: textblock
2141 #: ../cat/virt-ls.pod:235
2142 msgid ""
2143 "The device containing the file (displayed as major:minor).  This may not "
2144 "match devices as known to the guest."
2145 msgstr ""
2146
2147 #. type: =item
2148 #: ../cat/virt-ls.pod:238
2149 msgid "inode"
2150 msgstr ""
2151
2152 #. type: textblock
2153 #: ../cat/virt-ls.pod:240
2154 msgid "The inode number."
2155 msgstr ""
2156
2157 #. type: =item
2158 #: ../cat/virt-ls.pod:242
2159 #, fuzzy
2160 #| msgid "readlink"
2161 msgid "nlink"
2162 msgstr "readlink"
2163
2164 #. type: textblock
2165 #: ../cat/virt-ls.pod:244
2166 msgid "The number of hard links."
2167 msgstr ""
2168
2169 #. type: =item
2170 #: ../cat/virt-ls.pod:246
2171 msgid "rdev"
2172 msgstr ""
2173
2174 #. type: textblock
2175 #: ../cat/virt-ls.pod:248
2176 msgid ""
2177 "For block and char special files, the device (displayed as major:minor)."
2178 msgstr ""
2179
2180 #. type: =item
2181 #: ../cat/virt-ls.pod:251
2182 #, fuzzy
2183 #| msgid "C<blocksize>"
2184 msgid "blocks"
2185 msgstr "C<blocksize>"
2186
2187 #. type: textblock
2188 #: ../cat/virt-ls.pod:253
2189 msgid "The number of 512 byte blocks allocated to the file."
2190 msgstr ""
2191
2192 #. type: textblock
2193 #: ../cat/virt-ls.pod:257
2194 msgid ""
2195 "With the I<--checksum> flag, the checksum of the file contents is shown "
2196 "(only for regular files).  Computing file checksums can take a considerable "
2197 "amount of time."
2198 msgstr ""
2199
2200 #. type: =item
2201 #: ../cat/virt-ls.pod:280
2202 #, fuzzy
2203 #| msgid "checksum"
2204 msgid "B<--checksum>"
2205 msgstr "checksum"
2206
2207 #. type: =item
2208 #: ../cat/virt-ls.pod:282
2209 msgid "B<--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512>"
2210 msgstr ""
2211
2212 #. type: textblock
2213 #: ../cat/virt-ls.pod:284
2214 msgid ""
2215 "Display checksum over file contents for regular files.  With no argument, "
2216 "this defaults to using I<md5>.  Using an argument, you can select the "
2217 "checksum type to use."
2218 msgstr ""
2219
2220 #. type: textblock
2221 #: ../cat/virt-ls.pod:288 ../cat/virt-ls.pod:325 ../cat/virt-ls.pod:358
2222 #: ../cat/virt-ls.pod:391 ../cat/virt-ls.pod:401 ../cat/virt-ls.pod:408
2223 #: ../cat/virt-ls.pod:415 ../cat/virt-ls.pod:422
2224 msgid ""
2225 "This option only has effect in I<-lR> output mode.  See L</RECURSIVE LONG "
2226 "LISTING> above."
2227 msgstr ""
2228
2229 #. type: textblock
2230 #: ../cat/virt-ls.pod:316
2231 msgid ""
2232 "When prompting for keys and passphrases, virt-ls normally turns echoing off "
2233 "so you cannot see what you are typing.  If you are not worried about Tempest "
2234 "attacks and there is no one else in the room you can specify this flag to "
2235 "see what you are typing."
2236 msgstr ""
2237
2238 #. type: =item
2239 #: ../cat/virt-ls.pod:321
2240 #, fuzzy
2241 #| msgid "B<--no-dest-paths>"
2242 msgid "B<--extra-stats>"
2243 msgstr "B<--no-dest-paths>"
2244
2245 #. type: textblock
2246 #: ../cat/virt-ls.pod:323
2247 msgid "Display extra stats."
2248 msgstr ""
2249
2250 #. type: verbatim
2251 #: ../cat/virt-ls.pod:339
2252 #, fuzzy, no-wrap
2253 #| msgid ""
2254 #| " guestfish --format=raw -a disk.img\n"
2255 #| "\n"
2256 msgid ""
2257 " virt-ls --format=raw -a disk.img /dir\n"
2258 "\n"
2259 msgstr ""
2260 " guestfish --format=raw -a disk.img\n"
2261 "\n"
2262
2263 #. type: verbatim
2264 #: ../cat/virt-ls.pod:343
2265 #, fuzzy, no-wrap
2266 #| msgid ""
2267 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
2268 #| "\n"
2269 msgid ""
2270 " virt-ls --format=raw -a disk.img --format -a another.img /dir\n"
2271 "\n"
2272 msgstr ""
2273 " guestfish --format=raw -a disk.img --format -a another.img\n"
2274 "\n"
2275
2276 #. type: textblock
2277 #: ../cat/virt-ls.pod:356
2278 msgid "Display file sizes in human-readable format."
2279 msgstr ""
2280
2281 #. type: =item
2282 #: ../cat/virt-ls.pod:370
2283 msgid "B<-R>"
2284 msgstr ""
2285
2286 #. type: =item
2287 #: ../cat/virt-ls.pod:372
2288 #, fuzzy
2289 #| msgid "B<--live>"
2290 msgid "B<--recursive>"
2291 msgstr "B<--live>"
2292
2293 #. type: textblock
2294 #: ../cat/virt-ls.pod:374
2295 msgid ""
2296 "Select the mode.  With neither of these options, C<virt-ls> produces a "
2297 "simple, flat list of the files in the named directory.  See L</SIMPLE "
2298 "LISTING>."
2299 msgstr ""
2300
2301 #. type: textblock
2302 #: ../cat/virt-ls.pod:378
2303 msgid ""
2304 "C<virt-ls -l> produces a \"long listing\", which shows more detail.  See L</"
2305 "LONG LISTING>."
2306 msgstr ""
2307
2308 #. type: textblock
2309 #: ../cat/virt-ls.pod:381
2310 msgid ""
2311 "C<virt-ls -R> produces a recursive list of files starting at the named "
2312 "directory.  See L</RECURSIVE LISTING>."
2313 msgstr ""
2314
2315 #. type: textblock
2316 #: ../cat/virt-ls.pod:384
2317 msgid ""
2318 "C<virt-ls -lR> produces a recursive long listing which can be more easily "
2319 "parsed.  See L</RECURSIVE LONG LISTING>."
2320 msgstr ""
2321
2322 #. type: =item
2323 #: ../cat/virt-ls.pod:387
2324 #, fuzzy
2325 #| msgid "B<--live>"
2326 msgid "B<--times>"
2327 msgstr "B<--live>"
2328
2329 #. type: textblock
2330 #: ../cat/virt-ls.pod:389
2331 msgid "Display time fields."
2332 msgstr ""
2333
2334 #. type: =item
2335 #: ../cat/virt-ls.pod:394
2336 #, fuzzy
2337 #| msgid "B<--echo-keys>"
2338 msgid "B<--time-days>"
2339 msgstr "B<--echo-keys>"
2340
2341 #. type: textblock
2342 #: ../cat/virt-ls.pod:396
2343 msgid "Display time fields as days before now (negative if in the future)."
2344 msgstr ""
2345
2346 #. type: textblock
2347 #: ../cat/virt-ls.pod:398
2348 msgid ""
2349 "Note that C<0> in output means \"up to 1 day before now\", or that the age "
2350 "of the file is between 0 and 86399 seconds."
2351 msgstr ""
2352
2353 #. type: =item
2354 #: ../cat/virt-ls.pod:404
2355 #, fuzzy
2356 #| msgid "B<--live>"
2357 msgid "B<--time-relative>"
2358 msgstr "B<--live>"
2359
2360 #. type: textblock
2361 #: ../cat/virt-ls.pod:406
2362 msgid "Display time fields as seconds before now (negative if in the future)."
2363 msgstr ""
2364
2365 #. type: =item
2366 #: ../cat/virt-ls.pod:411
2367 #, fuzzy
2368 #| msgid "I<--timeout N>"
2369 msgid "B<--time-t>"
2370 msgstr "I<--timeout N>"
2371
2372 #. type: textblock
2373 #: ../cat/virt-ls.pod:413
2374 msgid "Display time fields as seconds since the Unix epoch."
2375 msgstr ""
2376
2377 #. type: =item
2378 #: ../cat/virt-ls.pod:418
2379 #, fuzzy
2380 #| msgid "B<--csh>"
2381 msgid "B<--uids>"
2382 msgstr "B<--csh>"
2383
2384 #. type: textblock
2385 #: ../cat/virt-ls.pod:420
2386 msgid "Display UID and GID fields."
2387 msgstr ""
2388
2389 #. type: textblock
2390 #: ../cat/virt-ls.pod:445
2391 msgid "Previous versions of virt-ls allowed you to write either:"
2392 msgstr ""
2393
2394 #. type: verbatim
2395 #: ../cat/virt-ls.pod:447
2396 #, fuzzy, no-wrap
2397 #| msgid ""
2398 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2399 #| "\n"
2400 msgid ""
2401 " virt-ls disk.img [disk.img ...] /dir\n"
2402 "\n"
2403 msgstr ""
2404 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2405 "\n"
2406
2407 #. type: verbatim
2408 #: ../cat/virt-ls.pod:451
2409 #, fuzzy, no-wrap
2410 #| msgid ""
2411 #| " inspect-get-hostname root\n"
2412 #| "\n"
2413 msgid ""
2414 " virt-ls guestname /dir\n"
2415 "\n"
2416 msgstr ""
2417 " inspect-get-hostname корінь\n"
2418 "\n"
2419
2420 #. type: textblock
2421 #: ../cat/virt-ls.pod:497
2422 #, fuzzy
2423 #| msgid ""
2424 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
2425 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
2426 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
2427 msgid ""
2428 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-"
2429 "tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
2430 "L<http://libguestfs.org/>."
2431 msgstr ""
2432 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
2433 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
2434 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
2435
2436 #. type: textblock
2437 #: ../cat/virt-ls.pod:513 ../df/virt-df.pod:241 ../edit/virt-edit.pod:374
2438 #: ../rescue/virt-rescue.pod:298
2439 #, fuzzy
2440 #| msgid "Copyright (C) 2009-2010 Red Hat Inc."
2441 msgid "Copyright (C) 2009-2011 Red Hat Inc."
2442 msgstr "© Red Hat Inc., 2009–2010"
2443
2444 #. type: textblock
2445 #: ../df/virt-df.pod:5
2446 msgid "virt-df - Display free space on virtual filesystems"
2447 msgstr ""
2448
2449 #. type: verbatim
2450 #: ../df/virt-df.pod:9
2451 #, fuzzy, no-wrap
2452 #| msgid ""
2453 #| " virt-list-partitions [--options] domname\n"
2454 #| "\n"
2455 msgid ""
2456 " virt-df [--options]\n"
2457 "\n"
2458 msgstr ""
2459 " virt-list-partitions [--параметри] назва_домену\n"
2460 "\n"
2461
2462 #. type: verbatim
2463 #: ../df/virt-df.pod:11
2464 #, fuzzy, no-wrap
2465 #| msgid ""
2466 #| " virt-list-partitions [--options] domname\n"
2467 #| "\n"
2468 msgid ""
2469 " virt-df [--options] -d domname\n"
2470 "\n"
2471 msgstr ""
2472 " virt-list-partitions [--параметри] назва_домену\n"
2473 "\n"
2474
2475 #. type: verbatim
2476 #: ../df/virt-df.pod:13
2477 #, fuzzy, no-wrap
2478 #| msgid ""
2479 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2480 #| "\n"
2481 msgid ""
2482 " virt-df [--options] -a disk.img [-a disk.img ...]\n"
2483 "\n"
2484 msgstr ""
2485 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2486 "\n"
2487
2488 #. type: verbatim
2489 #: ../df/virt-df.pod:17
2490 #, fuzzy, no-wrap
2491 #| msgid ""
2492 #| " virt-list-partitions [--options] domname\n"
2493 #| "\n"
2494 msgid ""
2495 " virt-df [--options] domname\n"
2496 "\n"
2497 msgstr ""
2498 " virt-list-partitions [--параметри] назва_домену\n"
2499 "\n"
2500
2501 #. type: verbatim
2502 #: ../df/virt-df.pod:19
2503 #, fuzzy, no-wrap
2504 #| msgid ""
2505 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2506 #| "\n"
2507 msgid ""
2508 " virt-df [--options] disk.img [disk.img ...]\n"
2509 "\n"
2510 msgstr ""
2511 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2512 "\n"
2513
2514 #. type: textblock
2515 #: ../df/virt-df.pod:23
2516 msgid ""
2517 "C<virt-df> is a command line tool to display free space on virtual machine "
2518 "filesystems.  Unlike other tools, it doesn't just display the size of disk "
2519 "allocated to a virtual machine, but can look inside disk images to see how "
2520 "much space is really being used."
2521 msgstr ""
2522
2523 #. type: textblock
2524 #: ../df/virt-df.pod:28
2525 msgid ""
2526 "If used without any I<-a> or I<-d> arguments, C<virt-df> checks with libvirt "
2527 "to get a list of all active and inactive guests, and performs a C<df>-type "
2528 "operation on each one in turn, printing out the results."
2529 msgstr ""
2530
2531 #. type: textblock
2532 #: ../df/virt-df.pod:32
2533 msgid ""
2534 "If any I<-a> or I<-d> arguments are specified, C<virt-df> performs a C<df>-"
2535 "type operation on either the single named libvirt domain, or on the disk "
2536 "image(s) listed on the command line (which must all belong to a single VM).  "
2537 "In this mode (with arguments), C<virt-df> will I<only work for a single "
2538 "guest>.  If you want to run on multiple guests, then you have to invoke "
2539 "C<virt-df> multiple times."
2540 msgstr ""
2541
2542 #. type: textblock
2543 #: ../df/virt-df.pod:39
2544 msgid ""
2545 "Use the I<--csv> option to get a format which can be easily parsed by other "
2546 "programs.  Other options are similar to the standard L<df(1)> command."
2547 msgstr ""
2548
2549 #. type: textblock
2550 #: ../df/virt-df.pod:45
2551 msgid ""
2552 "Show disk usage for a single libvirt guest called C<F14x64>.  Make the "
2553 "output human-readable:"
2554 msgstr ""
2555
2556 #. type: verbatim
2557 #: ../df/virt-df.pod:48
2558 #, no-wrap
2559 msgid ""
2560 " # virt-df -d F14x64 -h\n"
2561 " Filesystem                       Size     Used  Available  Use%\n"
2562 " F14x64:/dev/sda1                 484M      66M       393M   14%\n"
2563 " F14x64:/dev/vg_f13x64/lv_root    7.4G     3.4G       4.0G   46%\n"
2564 "\n"
2565 msgstr ""
2566
2567 #. type: textblock
2568 #: ../df/virt-df.pod:53
2569 msgid "Show disk usage for a disk image file called C<test.img>:"
2570 msgstr ""
2571
2572 #. type: verbatim
2573 #: ../df/virt-df.pod:55
2574 #, no-wrap
2575 msgid ""
2576 " $ virt-df -a test1.img\n"
2577 " Filesystem                  1K-blocks     Used  Available  Use%\n"
2578 " test1.img:/dev/sda1             99099     1551      92432    2%\n"
2579 "\n"
2580 msgstr ""
2581
2582 #. type: verbatim
2583 #: ../df/virt-df.pod:112
2584 #, fuzzy, no-wrap
2585 #| msgid ""
2586 #| " guestfish --format=raw -a disk.img\n"
2587 #| "\n"
2588 msgid ""
2589 " virt-df --format=raw -a disk.img\n"
2590 "\n"
2591 msgstr ""
2592 " guestfish --format=raw -a disk.img\n"
2593 "\n"
2594
2595 #. type: verbatim
2596 #: ../df/virt-df.pod:116
2597 #, fuzzy, no-wrap
2598 #| msgid ""
2599 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
2600 #| "\n"
2601 msgid ""
2602 " virt-df --format=raw -a disk.img --format -a another.img\n"
2603 "\n"
2604 msgstr ""
2605 " guestfish --format=raw -a disk.img --format -a another.img\n"
2606 "\n"
2607
2608 #. type: textblock
2609 #: ../df/virt-df.pod:129
2610 msgid "Print sizes in human-readable format."
2611 msgstr ""
2612
2613 #. type: textblock
2614 #: ../df/virt-df.pod:131
2615 msgid "You are not allowed to use I<-h> and I<--csv> at the same time."
2616 msgstr ""
2617
2618 #. type: =item
2619 #: ../df/virt-df.pod:133 ../fish/guestfish.pod:258 ../fuse/guestmount.pod:155
2620 msgid "B<-i>"
2621 msgstr "B<-i>"
2622
2623 #. type: =item
2624 #: ../df/virt-df.pod:135
2625 #, fuzzy
2626 #| msgid "B<--live>"
2627 msgid "B<--inodes>"
2628 msgstr "B<--live>"
2629
2630 #. type: textblock
2631 #: ../df/virt-df.pod:137
2632 msgid "Print inodes instead of blocks."
2633 msgstr ""
2634
2635 #. type: =item
2636 #: ../df/virt-df.pod:139
2637 #, fuzzy
2638 #| msgid "B<--merge>"
2639 msgid "B<--one-per-guest>"
2640 msgstr "B<--merge>"
2641
2642 #. type: textblock
2643 #: ../df/virt-df.pod:141
2644 msgid ""
2645 "Run one libguestfs appliance per guest.  Normally C<virt-df> will add the "
2646 "disks from several guests to a single libguestfs appliance."
2647 msgstr ""
2648
2649 #. type: textblock
2650 #: ../df/virt-df.pod:144
2651 msgid "You might use this option in the following circumstances:"
2652 msgstr ""
2653
2654 #. type: =item
2655 #: ../df/virt-df.pod:148 ../df/virt-df.pod:154 ../edit/virt-edit.pod:266
2656 #: ../edit/virt-edit.pod:271 ../edit/virt-edit.pod:276
2657 #: ../edit/virt-edit.pod:287 ../edit/virt-edit.pod:291
2658 #: ../examples/guestfs-recipes.pod:98 ../examples/guestfs-recipes.pod:102
2659 #: ../examples/guestfs-recipes.pod:106 ../examples/guestfs-recipes.pod:132
2660 #: ../examples/guestfs-recipes.pod:137 ../examples/guestfs-recipes.pod:227
2661 #: ../examples/guestfs-recipes.pod:231 ../examples/guestfs-recipes.pod:235
2662 #: ../examples/guestfs-recipes.pod:239 ../examples/guestfs-recipes.pod:243
2663 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
2664 #: ../fish/guestfish-actions.pod:390 ../fish/guestfish-actions.pod:398
2665 #: ../fish/guestfish-actions.pod:405 ../fish/guestfish-actions.pod:412
2666 #: ../fish/guestfish-actions.pod:1104 ../fish/guestfish-actions.pod:1108
2667 #: ../fish/guestfish-actions.pod:1112 ../fish/guestfish-actions.pod:1116
2668 #: ../fish/guestfish-actions.pod:1124 ../fish/guestfish-actions.pod:1128
2669 #: ../fish/guestfish-actions.pod:1132 ../fish/guestfish-actions.pod:1142
2670 #: ../fish/guestfish-actions.pod:1146 ../fish/guestfish-actions.pod:1150
2671 #: ../fish/guestfish-actions.pod:1240 ../fish/guestfish-actions.pod:1244
2672 #: ../fish/guestfish-actions.pod:1249 ../fish/guestfish-actions.pod:1254
2673 #: ../fish/guestfish-actions.pod:1296 ../fish/guestfish-actions.pod:1300
2674 #: ../fish/guestfish-actions.pod:1305 ../fish/guestfish-actions.pod:1938
2675 #: ../fish/guestfish-actions.pod:1944 ../fish/guestfish-actions.pod:1952
2676 #: ../fish/guestfish-actions.pod:1959 ../fish/guestfish-actions.pod:1966
2677 #: ../fish/guestfish.pod:445 ../fish/guestfish.pod:449
2678 #: ../fish/guestfish.pod:453 ../fish/guestfish.pod:457
2679 #: ../inspector/virt-inspector.pod:393 ../inspector/virt-inspector.pod:397
2680 #: ../resize/virt-resize.pod:282 ../resize/virt-resize.pod:286
2681 #: ../resize/virt-resize.pod:295 ../resize/virt-resize.pod:301
2682 #: ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22
2683 #: ../src/guestfs-actions.pod:588 ../src/guestfs-actions.pod:596
2684 #: ../src/guestfs-actions.pod:603 ../src/guestfs-actions.pod:610
2685 #: ../src/guestfs-actions.pod:1667 ../src/guestfs-actions.pod:1671
2686 #: ../src/guestfs-actions.pod:1675 ../src/guestfs-actions.pod:1679
2687 #: ../src/guestfs-actions.pod:1687 ../src/guestfs-actions.pod:1691
2688 #: ../src/guestfs-actions.pod:1695 ../src/guestfs-actions.pod:1705
2689 #: ../src/guestfs-actions.pod:1709 ../src/guestfs-actions.pod:1713
2690 #: ../src/guestfs-actions.pod:1851 ../src/guestfs-actions.pod:1855
2691 #: ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1865
2692 #: ../src/guestfs-actions.pod:1926 ../src/guestfs-actions.pod:1930
2693 #: ../src/guestfs-actions.pod:1935 ../src/guestfs-actions.pod:2864
2694 #: ../src/guestfs-actions.pod:2870 ../src/guestfs-actions.pod:2878
2695 #: ../src/guestfs-actions.pod:2885 ../src/guestfs-actions.pod:2892
2696 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
2697 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
2698 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064
2699 #: ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077
2700 #: ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112
2701 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142
2702 #: ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154
2703 #: ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652
2704 #: ../src/guestfs.pod:1754 ../src/guestfs.pod:1759 ../src/guestfs.pod:1763
2705 #: ../src/guestfs.pod:1773 ../src/guestfs.pod:2047 ../src/guestfs.pod:2052
2706 #: ../src/guestfs.pod:2058 ../src/guestfs.pod:2066 ../src/guestfs.pod:2420
2707 #: ../src/guestfs.pod:2426 ../src/guestfs.pod:2431 ../src/guestfs.pod:2437
2708 #: ../src/guestfs.pod:2818 ../src/guestfs.pod:2823 ../src/guestfs.pod:2827
2709 #: ../src/guestfs.pod:2831 ../src/guestfs.pod:2835 ../src/guestfs.pod:2849
2710 #: ../src/guestfs.pod:2854 ../src/guestfs.pod:3079 ../src/guestfs.pod:3083
2711 #: ../src/guestfs.pod:3087 ../src/guestfs.pod:3091
2712 #: ../tools/virt-win-reg.pl:197 ../tools/virt-win-reg.pl:202
2713 #: ../tools/virt-win-reg.pl:208 ../tools/virt-win-reg.pl:710
2714 #: ../tools/virt-win-reg.pl:716 ../tools/virt-win-reg.pl:722
2715 msgid "*"
2716 msgstr "*"
2717
2718 #. type: textblock
2719 #: ../df/virt-df.pod:150
2720 msgid ""
2721 "If you think an untrusted guest might actively try to exploit the libguestfs "
2722 "appliance kernel, then this prevents one guest from interfering with the "
2723 "stats printed for another guest."
2724 msgstr ""
2725
2726 #. type: textblock
2727 #: ../df/virt-df.pod:156
2728 msgid ""
2729 "If the kernel has a bug which stops it from accessing a filesystem in one "
2730 "guest (see for example RHBZ#635373) then this allows libguestfs to continue "
2731 "and report stats for further guests."
2732 msgstr ""
2733
2734 #. type: textblock
2735 #: ../df/virt-df.pod:165
2736 msgid ""
2737 "Print UUIDs instead of names.  This is useful for following a guest even "
2738 "when the guest is migrated or renamed, or when two guests happen to have the "
2739 "same name."
2740 msgstr ""
2741
2742 #. type: textblock
2743 #: ../df/virt-df.pod:169
2744 msgid ""
2745 "Note that only domains that we fetch from libvirt come with UUIDs.  For disk "
2746 "images, we still print the disk image name even when this option is "
2747 "specified."
2748 msgstr ""
2749
2750 #. type: textblock
2751 #: ../df/virt-df.pod:229
2752 msgid ""
2753 "L<df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<http://"
2754 "libguestfs.org/>."
2755 msgstr ""
2756
2757 #. type: textblock
2758 #: ../edit/virt-edit.pod:5
2759 msgid "virt-edit - Edit a file in a virtual machine"
2760 msgstr ""
2761
2762 #. type: verbatim
2763 #: ../edit/virt-edit.pod:9
2764 #, fuzzy, no-wrap
2765 #| msgid ""
2766 #| " virt-list-partitions [--options] domname\n"
2767 #| "\n"
2768 msgid ""
2769 " virt-edit [--options] -d domname file [file ...]\n"
2770 "\n"
2771 msgstr ""
2772 " virt-list-partitions [--параметри] назва_домену\n"
2773 "\n"
2774
2775 #. type: verbatim
2776 #: ../edit/virt-edit.pod:11
2777 #, fuzzy, no-wrap
2778 #| msgid ""
2779 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2780 #| "\n"
2781 msgid ""
2782 " virt-edit [--options] -a disk.img [-a disk.img ...] file [file ...]\n"
2783 "\n"
2784 msgstr ""
2785 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2786 "\n"
2787
2788 #. type: verbatim
2789 #: ../edit/virt-edit.pod:13
2790 #, no-wrap
2791 msgid ""
2792 " virt-edit [-d domname|-a disk.img] file -e 'expr'\n"
2793 "\n"
2794 msgstr ""
2795
2796 #. type: verbatim
2797 #: ../edit/virt-edit.pod:17
2798 #, no-wrap
2799 msgid ""
2800 " virt-edit domname file\n"
2801 "\n"
2802 msgstr ""
2803
2804 #. type: verbatim
2805 #: ../edit/virt-edit.pod:19 ../edit/virt-edit.pod:183
2806 #, fuzzy, no-wrap
2807 #| msgid ""
2808 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
2809 #| "\n"
2810 msgid ""
2811 " virt-edit disk.img [disk.img ...] file\n"
2812 "\n"
2813 msgstr ""
2814 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
2815 "\n"
2816
2817 #. type: =head1
2818 #: ../edit/virt-edit.pod:21 ../fish/guestfish.pod:23
2819 #: ../fish/virt-copy-in.pod:13 ../fish/virt-tar-in.pod:15
2820 #: ../fuse/guestmount.pod:15 ../rescue/virt-rescue.pod:19
2821 #: ../tools/virt-tar.pl:64 ../tools/virt-win-reg.pl:51
2822 msgid "WARNING"
2823 msgstr "ПОПЕРЕДЖЕННЯ"
2824
2825 #. type: textblock
2826 #: ../edit/virt-edit.pod:23
2827 msgid ""
2828 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
2829 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
2830 "doing this, but doesn't catch all cases."
2831 msgstr ""
2832
2833 #. type: textblock
2834 #: ../edit/virt-edit.pod:29
2835 msgid ""
2836 "C<virt-edit> is a command line tool to edit C<file> where each C<file> "
2837 "exists in the named virtual machine (or disk image)."
2838 msgstr ""
2839
2840 #. type: textblock
2841 #: ../edit/virt-edit.pod:32
2842 msgid ""
2843 "Multiple filenames can be given, in which case they are each edited in "
2844 "turn.  Each filename must be a full path, starting at the root directory "
2845 "(starting with '/')."
2846 msgstr ""
2847
2848 #. type: textblock
2849 #: ../edit/virt-edit.pod:36
2850 msgid "If you want to just view a file, use L<virt-cat(1)>."
2851 msgstr ""
2852
2853 #. type: textblock
2854 #: ../edit/virt-edit.pod:38
2855 msgid ""
2856 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
2857 "USING GUESTFISH> below)."
2858 msgstr ""
2859
2860 #. type: textblock
2861 #: ../edit/virt-edit.pod:41
2862 msgid ""
2863 "C<virt-edit> cannot be used to create a new file.  L<guestfish(1)> can do "
2864 "that and much more."
2865 msgstr ""
2866
2867 #. type: textblock
2868 #: ../edit/virt-edit.pod:46
2869 msgid "Edit the named files interactively:"
2870 msgstr ""
2871
2872 #. type: verbatim
2873 #: ../edit/virt-edit.pod:48
2874 #, no-wrap
2875 msgid ""
2876 " virt-edit -d mydomain /boot/grub/grub.conf\n"
2877 "\n"
2878 msgstr ""
2879
2880 #. type: verbatim
2881 #: ../edit/virt-edit.pod:50
2882 #, no-wrap
2883 msgid ""
2884 " virt-edit -d mydomain /etc/passwd\n"
2885 "\n"
2886 msgstr ""
2887
2888 #. type: textblock
2889 #: ../edit/virt-edit.pod:52
2890 msgid "For Windows guests, some Windows paths are understood:"
2891 msgstr ""
2892
2893 #. type: verbatim
2894 #: ../edit/virt-edit.pod:54
2895 #, no-wrap
2896 msgid ""
2897 " virt-edit -d mywindomain 'c:\\autoexec.bat'\n"
2898 "\n"
2899 msgstr ""
2900
2901 #. type: textblock
2902 #: ../edit/virt-edit.pod:56
2903 msgid ""
2904 "If Perl is installed, you can also edit files non-interactively (see L</NON-"
2905 "INTERACTIVE EDITING> below).  To change the init default level to 5:"
2906 msgstr ""
2907
2908 #. type: verbatim
2909 #: ../edit/virt-edit.pod:60
2910 #, no-wrap
2911 msgid ""
2912 " virt-edit -d mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
2913 "\n"
2914 msgstr ""
2915
2916 #. type: =item
2917 #: ../edit/virt-edit.pod:81
2918 msgid "B<-b> extension"
2919 msgstr ""
2920
2921 #. type: =item
2922 #: ../edit/virt-edit.pod:83
2923 msgid "B<--backup> extension"
2924 msgstr ""
2925
2926 #. type: textblock
2927 #: ../edit/virt-edit.pod:85
2928 msgid ""
2929 "Create a backup of the original file I<in the guest disk image>.  The backup "
2930 "has the original filename with C<extension> added."
2931 msgstr ""
2932
2933 #. type: textblock
2934 #: ../edit/virt-edit.pod:88
2935 msgid ""
2936 "Usually the first character of C<extension> would be a dot C<.> so you would "
2937 "write:"
2938 msgstr ""
2939
2940 #. type: verbatim
2941 #: ../edit/virt-edit.pod:91
2942 #, no-wrap
2943 msgid ""
2944 " virt-edit -b .orig [etc]\n"
2945 "\n"
2946 msgstr ""
2947
2948 #. type: textblock
2949 #: ../edit/virt-edit.pod:93
2950 msgid "By default, no backup file is made."
2951 msgstr ""
2952
2953 #. type: =item
2954 #: ../edit/virt-edit.pod:95 ../fish/guestfish.pod:181
2955 #: ../fuse/guestmount.pod:96 ../inspector/virt-inspector.pod:74
2956 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-list-partitions.pl:78
2957 #: ../tools/virt-tar.pl:127 ../tools/virt-win-reg.pl:128
2958 msgid "B<-c URI>"
2959 msgstr "B<-c адреса>"
2960
2961 #. type: =item
2962 #: ../edit/virt-edit.pod:97 ../fish/guestfish.pod:183
2963 #: ../fuse/guestmount.pod:98 ../inspector/virt-inspector.pod:76
2964 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-list-partitions.pl:80
2965 #: ../tools/virt-tar.pl:129 ../tools/virt-win-reg.pl:130
2966 msgid "B<--connect URI>"
2967 msgstr "B<--connect адреса>"
2968
2969 #. type: textblock
2970 #: ../edit/virt-edit.pod:102 ../tools/virt-list-filesystems.pl:84
2971 #: ../tools/virt-list-partitions.pl:85 ../tools/virt-tar.pl:134
2972 #: ../tools/virt-win-reg.pl:135
2973 msgid ""
2974 "If you specify guest block devices directly, then libvirt is not used at all."
2975 msgstr ""
2976
2977 #. type: textblock
2978 #: ../edit/virt-edit.pod:114
2979 msgid ""
2980 "When prompting for keys and passphrases, virt-edit normally turns echoing "
2981 "off so you cannot see what you are typing.  If you are not worried about "
2982 "Tempest attacks and there is no one else in the room you can specify this "
2983 "flag to see what you are typing."
2984 msgstr ""
2985
2986 #. type: =item
2987 #: ../edit/virt-edit.pod:119
2988 msgid "B<-e> EXPR"
2989 msgstr ""
2990
2991 #. type: =item
2992 #: ../edit/virt-edit.pod:121
2993 #, fuzzy
2994 #| msgid "B<--help>"
2995 msgid "B<--expr> EXPR"
2996 msgstr "B<--help>"
2997
2998 #. type: textblock
2999 #: ../edit/virt-edit.pod:123
3000 msgid ""
3001 "Instead of launching the external editor, non-interactively apply the Perl "
3002 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
3003 "EDITING> below."
3004 msgstr ""
3005
3006 #. type: textblock
3007 #: ../edit/virt-edit.pod:127
3008 msgid ""
3009 "Be careful to properly quote the expression to prevent it from being altered "
3010 "by the shell."
3011 msgstr ""
3012
3013 #. type: textblock
3014 #: ../edit/virt-edit.pod:130
3015 msgid "Note that this option is only available when Perl 5 is installed."
3016 msgstr ""
3017
3018 #. type: =item
3019 #: ../edit/virt-edit.pod:132
3020 #, fuzzy
3021 #| msgid "B<--format=raw|qcow2|..>"
3022 msgid "B<--format> raw|qcow2|..."
3023 msgstr "B<--format=raw|qcow2|..>"
3024
3025 #. type: verbatim
3026 #: ../edit/virt-edit.pod:143
3027 #, fuzzy, no-wrap
3028 #| msgid ""
3029 #| " guestfish --format=raw -a disk.img\n"
3030 #| "\n"
3031 msgid ""
3032 " virt-edit --format=raw -a disk.img file\n"
3033 "\n"
3034 msgstr ""
3035 " guestfish --format=raw -a disk.img\n"
3036 "\n"
3037
3038 #. type: verbatim
3039 #: ../edit/virt-edit.pod:147
3040 #, fuzzy, no-wrap
3041 #| msgid ""
3042 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
3043 #| "\n"
3044 msgid ""
3045 " virt-edit --format=raw -a disk.img --format -a another.img file\n"
3046 "\n"
3047 msgstr ""
3048 " guestfish --format=raw -a disk.img --format -a another.img\n"
3049 "\n"
3050
3051 #. type: textblock
3052 #: ../edit/virt-edit.pod:181
3053 msgid "Previous versions of virt-edit allowed you to write either:"
3054 msgstr ""
3055
3056 #. type: verbatim
3057 #: ../edit/virt-edit.pod:187
3058 #, fuzzy, no-wrap
3059 #| msgid ""
3060 #| " edit filename\n"
3061 #| "\n"
3062 msgid ""
3063 " virt-edit guestname file\n"
3064 "\n"
3065 msgstr ""
3066 " edit назва_файла\n"
3067 "\n"
3068
3069 #. type: =head1
3070 #: ../edit/virt-edit.pod:195
3071 msgid "NON-INTERACTIVE EDITING"
3072 msgstr ""
3073
3074 #. type: textblock
3075 #: ../edit/virt-edit.pod:197
3076 msgid ""
3077 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
3078 "administrator can interactively edit the file."
3079 msgstr ""
3080
3081 #. type: textblock
3082 #: ../edit/virt-edit.pod:200
3083 msgid ""
3084 "There are two ways also to use C<virt-edit> from scripts in order to make "
3085 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
3086 "like this, it's less error-prone to write scripts directly using the "
3087 "libguestfs API and Augeas for configuration file editing.)"
3088 msgstr ""
3089
3090 #. type: textblock
3091 #: ../edit/virt-edit.pod:206
3092 msgid ""
3093 "The first method is to temporarily set C<$EDITOR> to any script or program "
3094 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
3095 "update C<tmpfile> in place however it likes."
3096 msgstr ""
3097
3098 #. type: textblock
3099 #: ../edit/virt-edit.pod:210
3100 msgid ""
3101 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
3102 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
3103 "instances of C<foo> with C<bar> in a file:"
3104 msgstr ""
3105
3106 #. type: verbatim
3107 #: ../edit/virt-edit.pod:214
3108 #, no-wrap
3109 msgid ""
3110 " virt-edit -d domname filename -e 's/foo/bar/'\n"
3111 "\n"
3112 msgstr ""
3113
3114 #. type: textblock
3115 #: ../edit/virt-edit.pod:216
3116 msgid ""
3117 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
3118 "For example to delete root's password you could do:"
3119 msgstr ""
3120
3121 #. type: verbatim
3122 #: ../edit/virt-edit.pod:219
3123 #, no-wrap
3124 msgid ""
3125 " virt-edit -d domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
3126 "\n"
3127 msgstr ""
3128
3129 #. type: textblock
3130 #: ../edit/virt-edit.pod:221
3131 msgid ""
3132 "What really happens is that the snippet is evaluated as a Perl expression "
3133 "for each line of the file.  The line, including the final C<\\n>, is passed "
3134 "in C<$_> and the expression should update C<$_> or leave it unchanged."
3135 msgstr ""
3136
3137 #. type: textblock
3138 #: ../edit/virt-edit.pod:226
3139 msgid ""
3140 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
3141 "C<apache> user account from the password file you can do:"
3142 msgstr ""
3143
3144 #. type: verbatim
3145 #: ../edit/virt-edit.pod:229
3146 #, no-wrap
3147 msgid ""
3148 " virt-edit -d mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
3149 "\n"
3150 msgstr ""
3151
3152 #. type: textblock
3153 #: ../edit/virt-edit.pod:231
3154 msgid ""
3155 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
3156 "the end of the file is rather difficult this way since there is no concept "
3157 "of \"last line of the file\" - your expression just doesn't get called "
3158 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
3159 "want to do this."
3160 msgstr ""
3161
3162 #. type: textblock
3163 #: ../edit/virt-edit.pod:237
3164 msgid ""
3165 "The variable C<$lineno> contains the current line number.  As is "
3166 "traditional, the first line in the file is number C<1>."
3167 msgstr ""
3168
3169 #. type: textblock
3170 #: ../edit/virt-edit.pod:240
3171 msgid ""
3172 "The return value from the expression is ignored, but the expression may call "
3173 "C<die> in order to abort the whole program, leaving the original file "
3174 "untouched."
3175 msgstr ""
3176
3177 #. type: textblock
3178 #: ../edit/virt-edit.pod:244
3179 msgid ""
3180 "Remember when matching the end of a line that C<$_> may contain the final C<"
3181 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
3182 "newline then neither of these.  Thus to match or substitute some text at the "
3183 "end of a line, use this regular expression:"
3184 msgstr ""
3185
3186 #. type: verbatim
3187 #: ../edit/virt-edit.pod:249
3188 #, no-wrap
3189 msgid ""
3190 " /some text(\\r?\\n)?$/\n"
3191 "\n"
3192 msgstr ""
3193
3194 #. type: textblock
3195 #: ../edit/virt-edit.pod:251
3196 msgid ""
3197 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
3198 "$_> itself (since that would remove all newlines from the file):"
3199 msgstr ""
3200
3201 #. type: verbatim
3202 #: ../edit/virt-edit.pod:255
3203 #, no-wrap
3204 msgid ""
3205 " my $m = $_; chomp $m; $m =~ /some text$/\n"
3206 "\n"
3207 msgstr ""
3208
3209 #. type: =head1
3210 #: ../edit/virt-edit.pod:257 ../fish/guestfish.pod:858
3211 msgid "WINDOWS PATHS"
3212 msgstr ""
3213
3214 #. type: textblock
3215 #: ../edit/virt-edit.pod:259
3216 msgid ""
3217 "C<virt-edit> has a limited ability to understand Windows drive letters and "
3218 "paths (eg. C<E:\\foo\\bar.txt>)."
3219 msgstr ""
3220
3221 #. type: textblock
3222 #: ../edit/virt-edit.pod:262
3223 msgid "If and only if the guest is running Windows then:"
3224 msgstr ""
3225
3226 #. type: textblock
3227 #: ../edit/virt-edit.pod:268
3228 msgid ""
3229 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
3230 "to the correct filesystem."
3231 msgstr ""
3232
3233 #. type: textblock
3234 #: ../edit/virt-edit.pod:273
3235 msgid ""
3236 "Any backslash (C<\\>) characters in the path are replaced with forward "
3237 "slashes so that libguestfs can process it."
3238 msgstr ""
3239
3240 #. type: textblock
3241 #: ../edit/virt-edit.pod:278
3242 msgid ""
3243 "The path is resolved case insensitively to locate the file that should be "
3244 "edited."
3245 msgstr ""
3246
3247 #. type: textblock
3248 #: ../edit/virt-edit.pod:283
3249 msgid "There are some known shortcomings:"
3250 msgstr ""
3251
3252 #. type: textblock
3253 #: ../edit/virt-edit.pod:289
3254 msgid "Some NTFS symbolic links may not be followed correctly."
3255 msgstr ""
3256
3257 #. type: textblock
3258 #: ../edit/virt-edit.pod:293
3259 msgid "NTFS junction points that cross filesystems are not followed."
3260 msgstr ""
3261
3262 #. type: textblock
3263 #: ../edit/virt-edit.pod:299
3264 msgid ""
3265 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
3266 "C<virt-edit> doesn't work."
3267 msgstr ""
3268
3269 #. type: textblock
3270 #: ../edit/virt-edit.pod:302
3271 msgid "Using C<virt-edit> is approximately equivalent to doing:"
3272 msgstr ""
3273
3274 #. type: verbatim
3275 #: ../edit/virt-edit.pod:304
3276 #, fuzzy, no-wrap
3277 #| msgid ""
3278 #| " guestfish --ro -d myguest -i\n"
3279 #| "\n"
3280 msgid ""
3281 " guestfish --rw -i -d domname edit /file\n"
3282 "\n"
3283 msgstr ""
3284 " guestfish --ro -d myguest -i\n"
3285 "\n"
3286
3287 #. type: textblock
3288 #: ../edit/virt-edit.pod:306
3289 msgid ""
3290 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
3291 "path to the file."
3292 msgstr ""
3293
3294 #. type: textblock
3295 #: ../edit/virt-edit.pod:309
3296 msgid ""
3297 "The command above uses libguestfs's guest inspection feature and so does not "
3298 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
3299 "disk images that don't contain guests.  To edit a file on a disk image "
3300 "directly, use:"
3301 msgstr ""
3302
3303 #. type: verbatim
3304 #: ../edit/virt-edit.pod:314
3305 #, fuzzy, no-wrap
3306 #| msgid ""
3307 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
3308 #| "\n"
3309 msgid ""
3310 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
3311 "\n"
3312 msgstr ""
3313 " guestfish --format=raw -a disk.img --format -a another.img\n"
3314 "\n"
3315
3316 #. type: textblock
3317 #: ../edit/virt-edit.pod:316
3318 msgid ""
3319 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
3320 "the disk image to edit, and C</file> is the full path to the file."
3321 msgstr ""
3322
3323 #. type: textblock
3324 #: ../edit/virt-edit.pod:320
3325 msgid ""
3326 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
3327 "C<write> or C<upload> instead:"
3328 msgstr ""
3329
3330 #. type: verbatim
3331 #: ../edit/virt-edit.pod:323
3332 #, fuzzy, no-wrap
3333 #| msgid ""
3334 #| " guestfish --ro -d myguest -i\n"
3335 #| "\n"
3336 msgid ""
3337 " guestfish --rw -i -d domname touch /newfile\n"
3338 "\n"
3339 msgstr ""
3340 " guestfish --ro -d myguest -i\n"
3341 "\n"
3342
3343 #. type: verbatim
3344 #: ../edit/virt-edit.pod:325
3345 #, no-wrap
3346 msgid ""
3347 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
3348 "\n"
3349 msgstr ""
3350
3351 #. type: verbatim
3352 #: ../edit/virt-edit.pod:327
3353 #, no-wrap
3354 msgid ""
3355 " guestfish --rw -i -d domname upload localfile /newfile\n"
3356 "\n"
3357 msgstr ""
3358
3359 #. type: =head1
3360 #: ../edit/virt-edit.pod:329 ../fish/guestfish.pod:1086
3361 #: ../rescue/virt-rescue.pod:257 ../src/guestfs.pod:2965
3362 #: ../test-tool/libguestfs-test-tool.pod:82
3363 msgid "ENVIRONMENT VARIABLES"
3364 msgstr "ЗМІННІ СЕРЕДОВИЩА"
3365
3366 #. type: =item
3367 #: ../edit/virt-edit.pod:333
3368 #, fuzzy
3369 #| msgid "EDITOR"
3370 msgid "C<EDITOR>"
3371 msgstr "РЕДАКТОР"
3372
3373 #. type: textblock
3374 #: ../edit/virt-edit.pod:335
3375 msgid ""
3376 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
3377 "\"emacs -nw\">"
3378 msgstr ""
3379
3380 #. type: textblock
3381 #: ../edit/virt-edit.pod:338
3382 msgid "If not set, C<vi> is used."
3383 msgstr ""
3384
3385 #. type: textblock
3386 #: ../edit/virt-edit.pod:356
3387 #, fuzzy
3388 #| msgid ""
3389 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3390 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
3391 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3392 msgid ""
3393 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
3394 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
3395 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
3396 msgstr ""
3397 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3398 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
3399 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3400
3401 #. type: textblock
3402 #: ../examples/guestfs-examples.pod:5
3403 msgid "guestfs-examples - Examples of using libguestfs from C"
3404 msgstr ""
3405
3406 #. type: verbatim
3407 #: ../examples/guestfs-examples.pod:9 ../src/guestfs.pod:9
3408 #, no-wrap
3409 msgid ""
3410 " #include <guestfs.h>\n"
3411 " \n"
3412 msgstr ""
3413 " #include <guestfs.h>\n"
3414 " \n"
3415
3416 #. type: verbatim
3417 #: ../examples/guestfs-examples.pod:11
3418 #, no-wrap
3419 msgid ""
3420 " guestfs_h *g = guestfs_create ();\n"
3421 " guestfs_add_drive_ro (g, \"disk.img\");\n"
3422 " guestfs_launch (g);\n"
3423 "\n"
3424 msgstr ""
3425
3426 #. type: verbatim
3427 #: ../examples/guestfs-examples.pod:15 ../src/guestfs.pod:19
3428 #, no-wrap
3429 msgid ""
3430 " cc prog.c -o prog -lguestfs\n"
3431 "or:\n"
3432 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
3433 "\n"
3434 msgstr ""
3435 " cc prog.c -o prog -lguestfs\n"
3436 "або:\n"
3437 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
3438 "\n"
3439
3440 #. type: textblock
3441 #: ../examples/guestfs-examples.pod:21
3442 msgid ""
3443 "This manual page contains examples of calling libguestfs from the C "
3444 "programming language.  If you are not familiar with using libguestfs, you "
3445 "also need to read L<guestfs(3)>."
3446 msgstr ""
3447
3448 #. type: =head1
3449 #: ../examples/guestfs-examples.pod:25 ../java/examples/guestfs-java.pod:37
3450 #: ../ocaml/examples/guestfs-ocaml.pod:70 ../perl/examples/guestfs-perl.pod:31
3451 #: ../python/examples/guestfs-python.pod:34
3452 #: ../ruby/examples/guestfs-ruby.pod:28
3453 msgid "EXAMPLE 1: CREATE A DISK IMAGE"
3454 msgstr ""
3455
3456 #. type: textblock
3457 #: ../examples/guestfs-examples.pod:27 ../java/examples/guestfs-java.pod:39
3458 #: ../ocaml/examples/guestfs-ocaml.pod:72 ../perl/examples/guestfs-perl.pod:33
3459 #: ../python/examples/guestfs-python.pod:36
3460 #: ../ruby/examples/guestfs-ruby.pod:30
3461 #, fuzzy
3462 #| msgid "EXAMPLE"
3463 msgid "@EXAMPLE1@"
3464 msgstr "ПРИКЛАД"
3465
3466 #. type: =head1
3467 #: ../examples/guestfs-examples.pod:29 ../java/examples/guestfs-java.pod:41
3468 #: ../ocaml/examples/guestfs-ocaml.pod:74 ../perl/examples/guestfs-perl.pod:35
3469 #: ../python/examples/guestfs-python.pod:38
3470 #: ../ruby/examples/guestfs-ruby.pod:32
3471 msgid "EXAMPLE 2: INSPECT A VIRTUAL MACHINE DISK IMAGE"
3472 msgstr ""
3473
3474 #. type: textblock
3475 #: ../examples/guestfs-examples.pod:31 ../java/examples/guestfs-java.pod:43
3476 #: ../ocaml/examples/guestfs-ocaml.pod:76 ../perl/examples/guestfs-perl.pod:37
3477 #: ../python/examples/guestfs-python.pod:40
3478 #: ../ruby/examples/guestfs-ruby.pod:34
3479 #, fuzzy
3480 #| msgid "EXAMPLE"
3481 msgid "@EXAMPLE2@"
3482 msgstr "ПРИКЛАД"
3483
3484 #. type: textblock
3485 #: ../examples/guestfs-examples.pod:35
3486 #, fuzzy
3487 #| msgid ""
3488 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3489 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
3490 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3491 msgid ""
3492 "L<guestfs(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, "
3493 "L<guestfs-python(3)>, L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, L<http://"
3494 "libguestfs.org/>."
3495 msgstr ""
3496 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
3497 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
3498 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
3499
3500 #. type: =head1
3501 #: ../examples/guestfs-examples.pod:44 ../examples/guestfs-recipes.pod:396
3502 #: ../fish/guestfish.pod:1260 ../fish/virt-copy-in.pod:60
3503 #: ../fish/virt-copy-out.pod:49 ../fish/virt-tar-in.pod:58
3504 #: ../fish/virt-tar-out.pod:51 ../fuse/guestmount.pod:319
3505 #: ../inspector/virt-inspector.pod:389 ../java/examples/guestfs-java.pod:57
3506 #: ../ocaml/examples/guestfs-ocaml.pod:90 ../perl/examples/guestfs-perl.pod:51
3507 #: ../python/examples/guestfs-python.pod:53
3508 #: ../ruby/examples/guestfs-ruby.pod:47 ../src/guestfs.pod:3098
3509 #: ../test-tool/libguestfs-test-tool.pod:93
3510 msgid "AUTHORS"
3511 msgstr "АВТОРИ"
3512
3513 #. type: textblock
3514 #: ../examples/guestfs-examples.pod:46 ../examples/guestfs-recipes.pod:398
3515 #: ../fish/guestfish.pod:1262 ../fish/virt-copy-in.pod:62
3516 #: ../fish/virt-copy-out.pod:51 ../fish/virt-tar-in.pod:60
3517 #: ../fish/virt-tar-out.pod:53 ../fuse/guestmount.pod:321
3518 #: ../java/examples/guestfs-java.pod:59 ../ocaml/examples/guestfs-ocaml.pod:92
3519 #: ../perl/examples/guestfs-perl.pod:53
3520 #: ../python/examples/guestfs-python.pod:55
3521 #: ../ruby/examples/guestfs-ruby.pod:49 ../src/guestfs.pod:3100
3522 #: ../test-tool/libguestfs-test-tool.pod:95
3523 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
3524 msgstr ""
3525
3526 #. type: textblock
3527 #: ../examples/guestfs-examples.pod:50 ../ocaml/examples/guestfs-ocaml.pod:96
3528 #: ../python/examples/guestfs-python.pod:59
3529 #: ../ruby/examples/guestfs-ruby.pod:53
3530 #, fuzzy
3531 #| msgid "Copyright (C) 2009 Red Hat Inc."
3532 msgid "Copyright (C) 2010 Red Hat Inc. L<http://libguestfs.org/>"
3533 msgstr "© Red Hat Inc., 2009"
3534
3535 #. type: textblock
3536 #: ../examples/guestfs-examples.pod:52 ../examples/guestfs-recipes.pod:404
3537 #: ../java/examples/guestfs-java.pod:65 ../ocaml/examples/guestfs-ocaml.pod:98
3538 #: ../perl/examples/guestfs-perl.pod:59
3539 #: ../python/examples/guestfs-python.pod:61
3540 #: ../ruby/examples/guestfs-ruby.pod:55
3541 msgid ""
3542 "The examples in this manual page may be freely copied, modified and "
3543 "distributed without any restrictions."
3544 msgstr ""
3545
3546 #. type: textblock
3547 #: ../examples/guestfs-examples.pod:55 ../examples/guestfs-recipes.pod:407
3548 #: ../java/examples/guestfs-java.pod:68
3549 #: ../ocaml/examples/guestfs-ocaml.pod:101
3550 #: ../perl/examples/guestfs-perl.pod:62
3551 #: ../python/examples/guestfs-python.pod:64
3552 #: ../ruby/examples/guestfs-ruby.pod:58 ../src/guestfs.pod:3107
3553 msgid ""
3554 "This library is free software; you can redistribute it and/or modify it "
3555 "under the terms of the GNU Lesser General Public License as published by the "
3556 "Free Software Foundation; either version 2 of the License, or (at your "
3557 "option) any later version."
3558 msgstr ""
3559
3560 #. type: textblock
3561 #: ../examples/guestfs-examples.pod:60 ../examples/guestfs-recipes.pod:412
3562 #: ../java/examples/guestfs-java.pod:73
3563 #: ../ocaml/examples/guestfs-ocaml.pod:106
3564 #: ../perl/examples/guestfs-perl.pod:67
3565 #: ../python/examples/guestfs-python.pod:69
3566 #: ../ruby/examples/guestfs-ruby.pod:63 ../src/guestfs.pod:3112
3567 msgid ""
3568 "This library is distributed in the hope that it will be useful, but WITHOUT "
3569 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
3570 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
3571 "for more details."
3572 msgstr ""
3573
3574 #. type: textblock
3575 #: ../examples/guestfs-examples.pod:65 ../examples/guestfs-recipes.pod:417
3576 #: ../java/examples/guestfs-java.pod:78
3577 #: ../ocaml/examples/guestfs-ocaml.pod:111
3578 #: ../perl/examples/guestfs-perl.pod:72
3579 #: ../python/examples/guestfs-python.pod:74
3580 #: ../ruby/examples/guestfs-ruby.pod:68 ../src/guestfs.pod:3117
3581 msgid ""
3582 "You should have received a copy of the GNU Lesser General Public License "
3583 "along with this library; if not, write to the Free Software Foundation, "
3584 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
3585 msgstr ""
3586
3587 #. type: =end
3588 #: ../examples/guestfs-recipes.pod:3 ../examples/guestfs-recipes.pod:12
3589 msgid "comment"
3590 msgstr ""
3591
3592 #. type: textblock
3593 #: ../examples/guestfs-recipes.pod:5
3594 msgid ""
3595 "pod2man and pod2html have differing bugs which makes it hard to write URLs "
3596 "here.  The only way which works for both sorts of output is to just write "
3597 "the URL directly.  Do NOT use L<...> for URLs."
3598 msgstr ""
3599
3600 #. type: textblock
3601 #: ../examples/guestfs-recipes.pod:9
3602 msgid ""
3603 "We break with tradition here and don't use ALL CAPS for the section "
3604 "headings, as this makes them much easier to read."
3605 msgstr ""
3606
3607 #. type: textblock
3608 #: ../examples/guestfs-recipes.pod:16
3609 msgid "guestfs-recipes - libguestfs, guestfish and virt tools recipes"
3610 msgstr ""
3611
3612 #. type: textblock
3613 #: ../examples/guestfs-recipes.pod:20
3614 msgid ""
3615 "This page contains recipes for and links to things you can do using "
3616 "libguestfs, L<guestfish(1)> and the virt tools."
3617 msgstr ""
3618
3619 #. type: =head1
3620 #: ../examples/guestfs-recipes.pod:23
3621 msgid "Audit a virtual machine for setuid files"
3622 msgstr ""
3623
3624 #. type: textblock
3625 #: ../examples/guestfs-recipes.pod:25
3626 msgid ""
3627 "The link below contains a small program which can be used to audit a Linux "
3628 "virtual machine to see what setuid and setgid files it contains."
3629 msgstr ""
3630
3631 #. type: textblock
3632 #: ../examples/guestfs-recipes.pod:28
3633 msgid ""
3634 "https://rwmj.wordpress.com/2010/12/15/tip-audit-virtual-machine-for-setuid-"
3635 "files/#content"
3636 msgstr ""
3637
3638 #. type: =head1
3639 #: ../examples/guestfs-recipes.pod:30
3640 msgid "Change the background image in a Windows XP VM"
3641 msgstr ""
3642
3643 #. type: textblock
3644 #: ../examples/guestfs-recipes.pod:32
3645 msgid ""
3646 "The links below explain how to use L<guestfish(1)> to change the background "
3647 "image for a user of a Windows XP VM.  Unfortunately the technique appears to "
3648 "be substantially different for each version of Windows."
3649 msgstr ""
3650
3651 #. type: textblock
3652 #: ../examples/guestfs-recipes.pod:37
3653 msgid ""
3654 "https://lists.fedoraproject.org/pipermail/virt/2011-May/002655.html https://"
3655 "lists.fedoraproject.org/pipermail/virt/2011-May/002658.html"
3656 msgstr ""
3657
3658 #. type: =head1
3659 #: ../examples/guestfs-recipes.pod:40
3660 msgid "Cloning a virtual machine (Linux)"
3661 msgstr ""
3662
3663 #. type: textblock
3664 #: ../examples/guestfs-recipes.pod:42
3665 msgid ""
3666 "The guestfish technique described in the link below works well for most "
3667 "Linux VMs.  Depending on the Linux distro you may need to change the paths "
3668 "slightly."
3669 msgstr ""
3670
3671 #. type: textblock
3672 #: ../examples/guestfs-recipes.pod:46
3673 msgid ""
3674 "https://rwmj.wordpress.com/2010/09/24/tip-my-procedure-for-cloning-a-fedora-"
3675 "vm/#content"
3676 msgstr ""
3677
3678 #. type: textblock
3679 #: ../examples/guestfs-recipes.pod:48
3680 msgid ""
3681 "Avoid L<virt-clone(1)>.  Currently what to do about virt-clone is under "
3682 "discussion."
3683 msgstr ""
3684
3685 #. type: textblock
3686 #: ../examples/guestfs-recipes.pod:51
3687 msgid "https://www.redhat.com/archives/virt-tools-list/2011-May/msg00019.html"
3688 msgstr ""
3689
3690 #. type: =head1
3691 #: ../examples/guestfs-recipes.pod:53
3692 msgid "Cloning a virtual machine (Windows)"
3693 msgstr ""
3694
3695 #. type: textblock
3696 #: ../examples/guestfs-recipes.pod:55
3697 msgid ""
3698 "It is possible to do a \"sysprep\" using libguestfs alone, although not "
3699 "straightforward.  Currently there is code in the Aeolus Oz project which "
3700 "does this (using libguestfs).  As part of our review of the virt-clone tool, "
3701 "we may add sysprepping ability."
3702 msgstr ""
3703
3704 #. type: textblock
3705 #: ../examples/guestfs-recipes.pod:60
3706 msgid ""
3707 "https://github.com/clalancette/oz https://www.redhat.com/archives/virt-tools-"
3708 "list/2011-May/msg00019.html"
3709 msgstr ""
3710
3711 #. type: =head1
3712 #: ../examples/guestfs-recipes.pod:63
3713 msgid "Convert a CD-ROM / DVD / ISO to a tarball"
3714 msgstr ""
3715
3716 #. type: textblock
3717 #: ../examples/guestfs-recipes.pod:65
3718 msgid "This converts input C<cd.iso> to output C<cd.tar.gz>:"
3719 msgstr ""
3720
3721 #. type: verbatim
3722 #: ../examples/guestfs-recipes.pod:67
3723 #, no-wrap
3724 msgid ""
3725 " guestfish --ro -a cd.iso -m /dev/sda tgz-out / cd.tar.gz\n"
3726 "\n"
3727 msgstr ""
3728
3729 #. type: textblock
3730 #: ../examples/guestfs-recipes.pod:69
3731 msgid "To export just a subdirectory, eg. C</files>, do:"
3732 msgstr ""
3733
3734 #. type: verbatim
3735 #: ../examples/guestfs-recipes.pod:71
3736 #, no-wrap
3737 msgid ""
3738 " guestfish --ro -a cd.iso -m /dev/sda tgz-out /files cd.tar.gz\n"
3739 "\n"
3740 msgstr ""
3741
3742 #. type: =head1
3743 #: ../examples/guestfs-recipes.pod:73
3744 msgid "Create empty disk images"
3745 msgstr ""
3746
3747 #. type: textblock
3748 #: ../examples/guestfs-recipes.pod:75
3749 msgid ""
3750 "You can use the L<guestfish(1)> I<-N> option to create empty disk images.  "
3751 "The useful guide below explains the options available."
3752 msgstr ""
3753
3754 #. type: textblock
3755 #: ../examples/guestfs-recipes.pod:78
3756 msgid ""
3757 "https://rwmj.wordpress.com/2010/09/08/new-guestfish-n-options-in-1-5-9/"
3758 "#content"
3759 msgstr ""
3760
3761 #. type: =head1
3762 #: ../examples/guestfs-recipes.pod:80
3763 msgid "Dump raw filesystem content from inside a disk image or VM"
3764 msgstr ""
3765
3766 #. type: textblock
3767 #: ../examples/guestfs-recipes.pod:82
3768 msgid ""
3769 "You can use the L<guestfish(1)> C<download> command to extract the raw "
3770 "filesystem content from any filesystem in a disk image or a VM (even one "
3771 "which is encrypted or buried inside an LV):"
3772 msgstr ""
3773
3774 #. type: verbatim
3775 #: ../examples/guestfs-recipes.pod:86
3776 #, fuzzy, no-wrap
3777 #| msgid ""
3778 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
3779 #| "\n"
3780 msgid ""
3781 " guestfish --ro -a disk.img run : download /dev/sda1 sda1.img\n"
3782 "\n"
3783 msgstr ""
3784 " guestfish --format=raw -a disk.img --format -a another.img\n"
3785 "\n"
3786
3787 #. type: verbatim
3788 #: ../examples/guestfs-recipes.pod:88
3789 #, no-wrap
3790 msgid ""
3791 " guestfish --ro -d Guest run : download /dev/vg_guest/lv_root lv.img\n"
3792 "\n"
3793 msgstr ""
3794
3795 #. type: textblock
3796 #: ../examples/guestfs-recipes.pod:90
3797 msgid "To list the filesystems in a disk image, use L<virt-filesystems(1)>."
3798 msgstr ""
3799
3800 #. type: =head1
3801 #: ../examples/guestfs-recipes.pod:92
3802 msgid "Edit grub configuration in a VM"
3803 msgstr ""
3804
3805 #. type: textblock
3806 #: ../examples/guestfs-recipes.pod:94
3807 msgid "You can use this to:"
3808 msgstr ""
3809
3810 #. type: textblock
3811 #: ../examples/guestfs-recipes.pod:100
3812 msgid "Fix a virtual machine that does not boot."
3813 msgstr ""
3814
3815 #. type: textblock
3816 #: ../examples/guestfs-recipes.pod:104
3817 msgid "Change which kernel is used to boot the VM."
3818 msgstr ""
3819
3820 #. type: textblock
3821 #: ../examples/guestfs-recipes.pod:108
3822 msgid "Change kernel command line options."
3823 msgstr ""
3824
3825 #. type: textblock
3826 #: ../examples/guestfs-recipes.pod:112
3827 msgid "Use L<virt-edit(1)> to edit the grub configuration:"
3828 msgstr ""
3829
3830 #. type: verbatim
3831 #: ../examples/guestfs-recipes.pod:114
3832 #, no-wrap
3833 msgid ""
3834 " virt-edit -d BrokenGuest /boot/grub/grub.conf\n"
3835 "\n"
3836 msgstr ""
3837
3838 #. type: textblock
3839 #: ../examples/guestfs-recipes.pod:116
3840 msgid ""
3841 "or for general tinkering inside an unbootable VM use L<virt-rescue(1)> like "
3842 "this:"
3843 msgstr ""
3844
3845 #. type: verbatim
3846 #: ../examples/guestfs-recipes.pod:119
3847 #, no-wrap
3848 msgid ""
3849 " virt-rescue -d BrokenGuest\n"
3850 "\n"
3851 msgstr ""
3852
3853 #. type: =head1
3854 #: ../examples/guestfs-recipes.pod:121
3855 msgid "Export any directory from a VM"
3856 msgstr ""
3857
3858 #. type: textblock
3859 #: ../examples/guestfs-recipes.pod:123
3860 msgid ""
3861 "To export C</home> from a VM into a local directory use L<virt-copy-out(1)>:"
3862 msgstr ""
3863
3864 #. type: verbatim
3865 #: ../examples/guestfs-recipes.pod:126
3866 #, fuzzy, no-wrap
3867 #| msgid ""
3868 #| " copy-out /home .\n"
3869 #| "\n"
3870 msgid ""
3871 " virt-copy-out -d Guest /home .\n"
3872 "\n"
3873 msgstr ""
3874 " copy-out /home .\n"
3875 "\n"
3876
3877 #. type: textblock
3878 #: ../examples/guestfs-recipes.pod:128 ../fish/guestfish-actions.pod:9
3879 #: ../fish/guestfish-actions.pod:1292 ../fish/guestfish-actions.pod:1934
3880 #: ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1922
3881 #: ../src/guestfs-actions.pod:2860 ../src/guestfs.pod:1639
3882 #: ../tools/virt-win-reg.pl:706
3883 msgid "Notes:"
3884 msgstr "Нотатки:"
3885
3886 #. type: textblock
3887 #: ../examples/guestfs-recipes.pod:134
3888 msgid ""
3889 "The final dot of the command is not a printing error.  It means we want to "
3890 "copy out to the current directory."
3891 msgstr ""
3892
3893 #. type: textblock
3894 #: ../examples/guestfs-recipes.pod:139
3895 msgid "This creates a directory called C<home> under the current directory."
3896 msgstr ""
3897
3898 #. type: textblock
3899 #: ../examples/guestfs-recipes.pod:143
3900 msgid ""
3901 "If the guest is a Windows guest then you can use drive letters and "
3902 "backslashes, but you must prefix the path with C<win:> and quote it to "
3903 "protect it from the shell, like this:"
3904 msgstr ""
3905
3906 #. type: verbatim
3907 #: ../examples/guestfs-recipes.pod:147
3908 #, no-wrap
3909 msgid ""
3910 " virt-copy-out -d WinGuest 'win:c:\\windows\\system32\\config' .\n"
3911 "\n"
3912 msgstr ""
3913
3914 #. type: textblock
3915 #: ../examples/guestfs-recipes.pod:149
3916 msgid "To get the output as a compressed tarball, do:"
3917 msgstr ""
3918
3919 #. type: verbatim
3920 #: ../examples/guestfs-recipes.pod:151
3921 #, no-wrap
3922 msgid ""
3923 " virt-tar-out -d Guest /home - | gzip --best > home.tar.gz\n"
3924 "\n"
3925 msgstr ""
3926
3927 #. type: textblock
3928 #: ../examples/guestfs-recipes.pod:153
3929 msgid ""
3930 "Although it sounds tempting, this is usually not a reliable way to get a "
3931 "backup from a running guest.  See the entry in the FAQ: http://libguestfs."
3932 "org/FAQ.html#backup"
3933 msgstr ""
3934
3935 #. type: =head1
3936 #: ../examples/guestfs-recipes.pod:157
3937 msgid "Find out which user is using the most space"
3938 msgstr ""
3939
3940 #. type: textblock
3941 #: ../examples/guestfs-recipes.pod:159
3942 msgid ""
3943 "This simple script examines a Linux guest to find out which user is using "
3944 "the most space in their home directory:"
3945 msgstr ""
3946
3947 #. type: verbatim
3948 #: ../examples/guestfs-recipes.pod:162
3949 #, fuzzy, no-wrap
3950 #| msgid ""
3951 #| " #!/usr/bin/guestfish -f\n"
3952 #| "\n"
3953 msgid ""
3954 " #!/bin/sh -\n"
3955 " \n"
3956 msgstr ""
3957 " #!/usr/bin/guestfish -f\n"
3958 "\n"
3959
3960 #. type: verbatim
3961 #: ../examples/guestfs-recipes.pod:164
3962 #, fuzzy, no-wrap
3963 #| msgid ""
3964 #| " set-qemu qemu\n"
3965 #| "\n"
3966 msgid ""
3967 " set -e\n"
3968 " \n"
3969 msgstr ""
3970 " set-qemu qemu\n"
3971 "\n"
3972
3973 #. type: verbatim
3974 #: ../examples/guestfs-recipes.pod:166
3975 #, no-wrap
3976 msgid ""
3977 " vm=\"$1\"\n"
3978 " dir=/home\n"
3979 " \n"
3980 msgstr ""
3981
3982 #. type: verbatim
3983 #: ../examples/guestfs-recipes.pod:169
3984 #, fuzzy, no-wrap
3985 #| msgid ""
3986 #| " guestfish --ro -d myguest -i\n"
3987 #| "\n"
3988 msgid ""
3989 " eval $(guestfish --ro -d \"$vm\" -i --listen)\n"
3990 " \n"
3991 msgstr ""
3992 " guestfish --ro -d myguest -i\n"
3993 "\n"
3994
3995 #. type: verbatim
3996 #: ../examples/guestfs-recipes.pod:171
3997 #, no-wrap
3998 msgid ""
3999 " for d in $(guestfish --remote ls \"$dir\"); do\n"
4000 "     echo -n \"$dir/$d\"\n"
4001 "     echo -ne '\\t'\n"
4002 "     guestfish --remote du \"$dir/$d\";\n"
4003 " done | sort -nr -k 2\n"
4004 " \n"
4005 msgstr ""
4006
4007 #. type: verbatim
4008 #: ../examples/guestfs-recipes.pod:177 ../fish/guestfish.pod:941
4009 #, no-wrap
4010 msgid ""
4011 " guestfish --remote exit\n"
4012 "\n"
4013 msgstr ""
4014
4015 #. type: =head1
4016 #: ../examples/guestfs-recipes.pod:179
4017 msgid "Get DHCP address from a VM"
4018 msgstr ""
4019
4020 #. type: textblock
4021 #: ../examples/guestfs-recipes.pod:181
4022 msgid ""
4023 "The link below explains the many different possible techniques for getting "
4024 "the last assigned DHCP address of a virtual machine."
4025 msgstr ""
4026
4027 #. type: textblock
4028 #: ../examples/guestfs-recipes.pod:184
4029 msgid ""
4030 "https://rwmj.wordpress.com/2011/03/31/tip-code-for-getting-dhcp-address-from-"
4031 "a-virtual-machine-disk-image/#content"
4032 msgstr ""
4033
4034 #. type: textblock
4035 #: ../examples/guestfs-recipes.pod:186
4036 msgid ""
4037 "In the libguestfs source examples directory you will find the latest version "
4038 "of the C<virt-dhcp-address.c> program."
4039 msgstr ""
4040
4041 #. type: =head1
4042 #: ../examples/guestfs-recipes.pod:189
4043 msgid "Get the operating system product name string"
4044 msgstr ""
4045
4046 #. type: textblock
4047 #: ../examples/guestfs-recipes.pod:191
4048 msgid "Save the following script into a file called C<product-name.sh>:"
4049 msgstr ""
4050
4051 #. type: verbatim
4052 #: ../examples/guestfs-recipes.pod:193
4053 #, fuzzy, no-wrap
4054 #| msgid ""
4055 #| " eval \"`guestfish --listen`\"\n"
4056 #| " guestfish --remote add-ro disk.img\n"
4057 #| " guestfish --remote run\n"
4058 #| " guestfish --remote lvs\n"
4059 #| "\n"
4060 msgid ""
4061 " #!/bin/sh -\n"
4062 " set -e\n"
4063 " eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
4064 " root=\"$(guestfish --remote inspect-get-roots)\"\n"
4065 " guestfish --remote inspect-get-product-name \"$root\"\n"
4066 " guestfish --remote exit\n"
4067 "\n"
4068 msgstr ""
4069 " eval \"`guestfish --listen`\"\n"
4070 " guestfish --remote add-ro disk.img\n"
4071 " guestfish --remote run\n"
4072 " guestfish --remote lvs\n"
4073 "\n"
4074
4075 #. type: textblock
4076 #: ../examples/guestfs-recipes.pod:200
4077 msgid "Make the script executable and run it on a named guest:"
4078 msgstr ""
4079
4080 #. type: verbatim
4081 #: ../examples/guestfs-recipes.pod:202
4082 #, no-wrap
4083 msgid ""
4084 " # product-name.sh RHEL60x64\n"
4085 " Red Hat Enterprise Linux Server release 6.0 (Santiago)\n"
4086 "\n"
4087 msgstr ""
4088
4089 #. type: textblock
4090 #: ../examples/guestfs-recipes.pod:205
4091 msgid ""
4092 "You can also use an XPath query on the L<virt-inspector(1)> XML using the "
4093 "C<xpath> command line tool or from your favourite programming language:"
4094 msgstr ""
4095
4096 #. type: verbatim
4097 #: ../examples/guestfs-recipes.pod:209
4098 #, no-wrap
4099 msgid ""
4100 " # virt-inspector RHEL60x64 > xml\n"
4101 " # xpath '//product_name' < xml\n"
4102 " Found 1 nodes:\n"
4103 " -- NODE --\n"
4104 " <product_name>Red Hat Enterprise Linux Server release 6.0 (Santiago)</product_name>\n"
4105 "\n"
4106 msgstr ""
4107
4108 #. type: =head1
4109 #: ../examples/guestfs-recipes.pod:215
4110 msgid "Get the default boot kernel for a Linux VM"
4111 msgstr ""
4112
4113 #. type: textblock
4114 #: ../examples/guestfs-recipes.pod:217
4115 msgid ""
4116 "The link below contains a program to print the default boot kernel for a "
4117 "Linux VM."
4118 msgstr ""
4119
4120 #. type: textblock
4121 #: ../examples/guestfs-recipes.pod:220
4122 msgid ""
4123 "https://rwmj.wordpress.com/2010/10/30/tip-use-augeas-to-get-the-default-boot-"
4124 "kernel-for-a-vm/#content"
4125 msgstr ""
4126
4127 #. type: textblock
4128 #: ../examples/guestfs-recipes.pod:222
4129 msgid ""
4130 "It uses Augeas, and the technique is generally applicable for many different "
4131 "tasks, such as:"
4132 msgstr ""
4133
4134 #. type: textblock
4135 #: ../examples/guestfs-recipes.pod:229
4136 msgid "listing the user accounts in the guest"
4137 msgstr ""
4138
4139 #. type: textblock
4140 #: ../examples/guestfs-recipes.pod:233
4141 msgid "what repositories is it configured to use"
4142 msgstr ""
4143
4144 #. type: textblock
4145 #: ../examples/guestfs-recipes.pod:237
4146 msgid "what NTP servers does it connect to"
4147 msgstr ""
4148
4149 #. type: textblock
4150 #: ../examples/guestfs-recipes.pod:241
4151 msgid "what were the boot messages last time it booted"
4152 msgstr ""
4153
4154 #. type: textblock
4155 #: ../examples/guestfs-recipes.pod:245
4156 msgid "listing who was logged in recently"
4157 msgstr ""
4158
4159 #. type: textblock
4160 #: ../examples/guestfs-recipes.pod:249
4161 msgid "http://augeas.net/"
4162 msgstr ""
4163
4164 #. type: =head1
4165 #: ../examples/guestfs-recipes.pod:251
4166 msgid "Install RPMs in a guest"
4167 msgstr ""
4168
4169 #. type: textblock
4170 #: ../examples/guestfs-recipes.pod:253
4171 msgid ""
4172 "The link below contains a method to install RPMs in a guest.  In fact the "
4173 "RPMs are just uploaded to the guest along with a \"firstboot\" script that "
4174 "installs them next time the guest is booted.  You could use this technique "
4175 "to install vital security updates in an offline guest."
4176 msgstr ""
4177
4178 #. type: textblock
4179 #: ../examples/guestfs-recipes.pod:259
4180 msgid ""
4181 "https://rwmj.wordpress.com/2010/12/01/tip-install-rpms-in-a-guest/#content"
4182 msgstr ""
4183
4184 #. type: =head1
4185 #: ../examples/guestfs-recipes.pod:261
4186 msgid "List applications installed in a VM"
4187 msgstr ""
4188
4189 #. type: textblock
4190 #: ../examples/guestfs-recipes.pod:263
4191 msgid "Save the following to a file C<list-apps.sh>:"
4192 msgstr ""
4193
4194 #. type: verbatim
4195 #: ../examples/guestfs-recipes.pod:265
4196 #, fuzzy, no-wrap
4197 #| msgid ""
4198 #| " eval \"`guestfish --listen`\"\n"
4199 #| " guestfish --remote add-ro disk.img\n"
4200 #| " guestfish --remote run\n"
4201 #| " guestfish --remote lvs\n"
4202 #| "\n"
4203 msgid ""
4204 " #!/bin/sh -\n"
4205 " set -e\n"
4206 " eval \"$(guestfish --ro -d \"$1\" --i --listen)\"\n"
4207 " root=\"$(guestfish --remote inspect-get-roots)\"\n"
4208 " guestfish --remote inspect-list-applications \"$root\"\n"
4209 " guestfish --remote exit\n"
4210 "\n"
4211 msgstr ""
4212 " eval \"`guestfish --listen`\"\n"
4213 " guestfish --remote add-ro disk.img\n"
4214 " guestfish --remote run\n"
4215 " guestfish --remote lvs\n"
4216 "\n"
4217
4218 #. type: textblock
4219 #: ../examples/guestfs-recipes.pod:272
4220 msgid ""
4221 "Make the file executable and then you can run it on any named virtual "
4222 "machine:"
4223 msgstr ""
4224
4225 #. type: verbatim
4226 #: ../examples/guestfs-recipes.pod:275
4227 #, no-wrap
4228 msgid ""
4229 " # list-apps.sh WinGuest\n"
4230 " [0] = {\n"
4231 "   app_name: Mozilla Firefox (3.6.12)\n"
4232 "   app_display_name: Mozilla Firefox (3.6.12)\n"
4233 "   app_epoch: 0\n"
4234 "   app_version: 3.6.12 (en-GB)\n"
4235 "   app_release:\n"
4236 "   app_install_path: C:\\Program Files\\Mozilla Firefox\n"
4237 "   app_trans_path:\n"
4238 "   app_publisher: Mozilla\n"
4239 "   app_url: http://www.mozilla.com/en-GB/\n"
4240 "   app_source_package:\n"
4241 "   app_summary:\n"
4242 "   app_description: Mozilla Firefox\n"
4243 " }\n"
4244 " [1] = {\n"
4245 "   app_name: VLC media player\n"
4246 "   app_display_name: VLC media player 1.1.5\n"
4247 "   app_epoch: 0\n"
4248 "   app_version: 1.1.5\n"
4249 "   app_release:\n"
4250 "   app_install_path: C:\\Program Files\\VideoLAN\\VLC\n"
4251 "   app_trans_path:\n"
4252 "   app_publisher: VideoLAN\n"
4253 "   app_url: http://www.videolan.org/\n"
4254 "   app_source_package:\n"
4255 "   app_summary:\n"
4256 "   app_description:\n"
4257 " }\n"
4258 "\n"
4259 msgstr ""
4260
4261 #. type: textblock
4262 #: ../examples/guestfs-recipes.pod:305
4263 msgid ""
4264 "If you want to run the script on disk images (instead of libvirt virtual "
4265 "machines), change C<-d \"$1\"> to C<-a \"$1\">.  See also L<virt-inspector(1)"
4266 ">."
4267 msgstr ""
4268
4269 #. type: =head1
4270 #: ../examples/guestfs-recipes.pod:309
4271 msgid "List files and directories in a VM"
4272 msgstr ""
4273
4274 #. type: textblock
4275 #: ../examples/guestfs-recipes.pod:311
4276 msgid "This involves using the L<guestfish(1)> C<find0> command like this:"
4277 msgstr ""
4278
4279 #. type: verbatim
4280 #: ../examples/guestfs-recipes.pod:313
4281 #, fuzzy, no-wrap
4282 #| msgid ""
4283 #| " guestfish --ro -d myguest -i\n"
4284 #| "\n"
4285 msgid ""
4286 " guestfish --ro -d Guest -i find0 / - | tr '\\0' '\\n' | sort\n"
4287 "\n"
4288 msgstr ""
4289 " guestfish --ro -d myguest -i\n"
4290 "\n"
4291
4292 #. type: =head1
4293 #: ../examples/guestfs-recipes.pod:315
4294 msgid "List services in a Windows VM"
4295 msgstr ""
4296
4297 #. type: textblock
4298 #: ../examples/guestfs-recipes.pod:317
4299 msgid ""
4300 "The link below contains a script that can be used to list out the services "
4301 "from a Windows VM, and whether those services run at boot time or are loaded "
4302 "on demand."
4303 msgstr ""
4304
4305 #. type: textblock
4306 #: ../examples/guestfs-recipes.pod:321
4307 msgid ""
4308 "https://rwmj.wordpress.com/2010/12/10/tip-list-services-in-a-windows-guest/"
4309 "#content"
4310 msgstr ""
4311
4312 #. type: =head1
4313 #: ../examples/guestfs-recipes.pod:323
4314 msgid "Make a disk image sparse"
4315 msgstr ""
4316
4317 #. type: textblock
4318 #: ../examples/guestfs-recipes.pod:325
4319 msgid ""
4320 "The link below contains some guides for making a disk image sparse (or "
4321 "reintroducing sparseness)."
4322 msgstr ""
4323
4324 #. type: textblock
4325 #: ../examples/guestfs-recipes.pod:328
4326 msgid ""
4327 "https://rwmj.wordpress.com/2010/10/19/tip-making-a-disk-image-sparse/#content"
4328 msgstr ""
4329
4330 #. type: =head1
4331 #: ../examples/guestfs-recipes.pod:330
4332 msgid "Monitor disk usage over time"
4333 msgstr ""
4334
4335 #. type: textblock
4336 #: ../examples/guestfs-recipes.pod:332
4337 msgid ""
4338 "You can use L<virt-df(1)> to monitor disk usage of your guests over time.  "
4339 "The link below contains a guide."
4340 msgstr ""
4341
4342 #. type: textblock
4343 #: ../examples/guestfs-recipes.pod:335
4344 msgid "http://virt-tools.org/learning/advanced-virt-df/"
4345 msgstr ""
4346
4347 #. type: =head1
4348 #: ../examples/guestfs-recipes.pod:337
4349 msgid "Reading the Windows Event Log from Windows Vista (or later)"
4350 msgstr ""
4351
4352 #. type: textblock
4353 #: ../examples/guestfs-recipes.pod:339
4354 msgid ""
4355 "L<guestfish(1)> plus the tools described in the link below can be used to "
4356 "read out the Windows Event Log from any virtual machine running Windows "
4357 "Vista or a later version."
4358 msgstr ""
4359
4360 #. type: textblock
4361 #: ../examples/guestfs-recipes.pod:343
4362 msgid ""
4363 "https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-"
4364 "guestfish/#content"
4365 msgstr ""
4366
4367 #. type: =head1
4368 #: ../examples/guestfs-recipes.pod:345
4369 msgid "Remove root password (Linux)"
4370 msgstr ""
4371
4372 #. type: textblock
4373 #: ../examples/guestfs-recipes.pod:347
4374 msgid ""
4375 "Using the L<virt-edit(1)> I<-e> option you can do simple replacements on "
4376 "files.  One use is to remove the root password from a Linux guest:"
4377 msgstr ""
4378
4379 #. type: verbatim
4380 #: ../examples/guestfs-recipes.pod:350
4381 #, no-wrap
4382 msgid ""
4383 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
4384 "\n"
4385 msgstr ""
4386
4387 #. type: =head1
4388 #: ../examples/guestfs-recipes.pod:352
4389 msgid "Remove Administrator password (Windows)"
4390 msgstr ""
4391
4392 #. type: textblock
4393 #: ../examples/guestfs-recipes.pod:354
4394 msgid ""
4395 "The link below contains one technique for removing the Administrator "
4396 "password from a Windows VM, or to be more precise, it gives you a command "
4397 "prompt the next time you log in which you can use to bypass any security:"
4398 msgstr ""
4399
4400 #. type: textblock
4401 #: ../examples/guestfs-recipes.pod:359
4402 msgid ""
4403 "https://mdbooth.wordpress.com/2010/10/18/resetting-a-windows-guests-"
4404 "administrator-password-with-guestfish/"
4405 msgstr ""
4406
4407 #. type: =head1
4408 #: ../examples/guestfs-recipes.pod:361
4409 msgid "Unpack a live CD"
4410 msgstr ""
4411
4412 #. type: textblock
4413 #: ../examples/guestfs-recipes.pod:363
4414 msgid ""
4415 "Linux live CDs often contain multiple layers of disk images wrapped like a "
4416 "Russian doll.  You can use L<guestfish(1)> to look inside these multiple "
4417 "layers, as outlined in the guide below."
4418 msgstr ""
4419
4420 #. type: textblock
4421 #: ../examples/guestfs-recipes.pod:367
4422 msgid ""
4423 "https://rwmj.wordpress.com/2009/07/15/unpack-the-russian-doll-of-a-f11-live-"
4424 "cd/#content"
4425 msgstr ""
4426
4427 #. type: =head1
4428 #: ../examples/guestfs-recipes.pod:369
4429 msgid "Uploading and downloading files"
4430 msgstr ""
4431
4432 #. type: textblock
4433 #: ../examples/guestfs-recipes.pod:371
4434 msgid ""
4435 "The link below contains general tips on uploading (copying in)  and "
4436 "downloading (copying out) files from VMs."
4437 msgstr ""
4438
4439 #. type: textblock
4440 #: ../examples/guestfs-recipes.pod:374
4441 msgid ""
4442 "https://rwmj.wordpress.com/2010/12/02/tip-uploading-and-downloading/#content"
4443 msgstr ""
4444
4445 #. type: =head1
4446 #: ../examples/guestfs-recipes.pod:376
4447 msgid "Use libguestfs tools on VMware ESX guests"
4448 msgstr ""
4449
4450 #. type: textblock
4451 #: ../examples/guestfs-recipes.pod:378
4452 msgid ""
4453 "The link below explains how to use libguestfs, L<guestfish(1)> and the virt "
4454 "tools on any VMware ESX guests, by first sharing the VMware VMFS over sshfs."
4455 msgstr ""
4456
4457 #. type: textblock
4458 #: ../examples/guestfs-recipes.pod:382
4459 msgid ""
4460 "https://rwmj.wordpress.com/2011/05/10/tip-use-libguestfs-on-vmware-esx-"
4461 "guests/#content"
4462 msgstr ""
4463
4464 #. type: textblock
4465 #: ../examples/guestfs-recipes.pod:386
4466 #, fuzzy
4467 #| msgid ""
4468 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
4469 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
4470 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
4471 msgid ""
4472 "L<guestfs(3)>, L<guestfish(1)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, "
4473 "L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-ruby"
4474 "(3)>, L<http://libguestfs.org/>."
4475 msgstr ""
4476 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
4477 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
4478 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
4479
4480 #. type: textblock
4481 #: ../examples/guestfs-recipes.pod:402
4482 #, fuzzy
4483 #| msgid "Copyright (C) 2009-2010 Red Hat Inc."
4484 msgid "Copyright (C) 2009-2011 Red Hat Inc. L<http://libguestfs.org/>"
4485 msgstr "© Red Hat Inc., 2009–2010"
4486
4487 #. type: =head2
4488 #: ../fish/guestfish-actions.pod:1
4489 msgid "add-cdrom"
4490 msgstr ""
4491
4492 #. type: verbatim
4493 #: ../fish/guestfish-actions.pod:3
4494 #, no-wrap
4495 msgid ""
4496 " add-cdrom filename\n"
4497 "\n"
4498 msgstr ""
4499
4500 #. type: textblock
4501 #: ../fish/guestfish-actions.pod:5 ../src/guestfs-actions.pod:7
4502 msgid "This function adds a virtual CD-ROM disk image to the guest."
4503 msgstr ""
4504
4505 #. type: textblock
4506 #: ../fish/guestfish-actions.pod:7 ../src/guestfs-actions.pod:9
4507 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
4508 msgstr ""
4509
4510 #. type: textblock
4511 #: ../fish/guestfish-actions.pod:15
4512 msgid ""
4513 "This call checks for the existence of C<filename>.  This stops you from "
4514 "specifying other types of drive which are supported by qemu such as C<nbd:> "
4515 "and C<http:> URLs.  To specify those, use the general L</config> call "
4516 "instead."
4517 msgstr ""
4518
4519 #. type: textblock
4520 #: ../fish/guestfish-actions.pod:22
4521 msgid ""
4522 "If you just want to add an ISO file (often you use this as an efficient way "
4523 "to transfer large files into the guest), then you should probably use L</add-"
4524 "drive-ro> instead."
4525 msgstr ""
4526
4527 #. type: textblock
4528 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:163
4529 #: ../fish/guestfish-actions.pod:177
4530 msgid ""
4531 "This function is deprecated.  In new code, use the L</add_drive_opts> call "
4532 "instead."
4533 msgstr ""
4534
4535 #. type: textblock
4536 #: ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:166
4537 #: ../fish/guestfish-actions.pod:180 ../fish/guestfish-actions.pod:991
4538 #: ../fish/guestfish-actions.pod:1351 ../fish/guestfish-actions.pod:1365
4539 #: ../fish/guestfish-actions.pod:3090 ../fish/guestfish-actions.pod:3297
4540 #: ../fish/guestfish-actions.pod:3411 ../fish/guestfish-actions.pod:3459
4541 #: ../fish/guestfish-actions.pod:4360 ../fish/guestfish-actions.pod:4383
4542 #: ../fish/guestfish-actions.pod:4405 ../fish/guestfish-actions.pod:4443
4543 #: ../fish/guestfish-actions.pod:5092 ../fish/guestfish-actions.pod:5198
4544 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257
4545 #: ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1518
4546 #: ../src/guestfs-actions.pod:2013 ../src/guestfs-actions.pod:2034
4547 #: ../src/guestfs-actions.pod:4633 ../src/guestfs-actions.pod:4952
4548 #: ../src/guestfs-actions.pod:5170 ../src/guestfs-actions.pod:5260
4549 #: ../src/guestfs-actions.pod:6549 ../src/guestfs-actions.pod:6579
4550 #: ../src/guestfs-actions.pod:6612 ../src/guestfs-actions.pod:6671
4551 #: ../src/guestfs-actions.pod:7607 ../src/guestfs-actions.pod:7719
4552 #: ../src/guestfs-actions.pod:7897
4553 msgid ""
4554 "Deprecated functions will not be removed from the API, but the fact that "
4555 "they are deprecated indicates that there are problems with correct use of "
4556 "these functions."
4557 msgstr ""
4558
4559 #. type: =head2
4560 #: ../fish/guestfish-actions.pod:35
4561 msgid "add-domain"
4562 msgstr "add-domain"
4563
4564 #. type: =head2
4565 #: ../fish/guestfish-actions.pod:37
4566 msgid "domain"
4567 msgstr ""
4568
4569 #. type: verbatim
4570 #: ../fish/guestfish-actions.pod:39
4571 #, no-wrap
4572 msgid ""
4573 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n"
4574 "\n"
4575 msgstr ""
4576
4577 #. type: textblock
4578 #: ../fish/guestfish-actions.pod:41
4579 msgid ""
4580 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
4581 "It works by connecting to libvirt, requesting the domain and domain XML from "
4582 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
4583 msgstr ""
4584
4585 #. type: textblock
4586 #: ../fish/guestfish-actions.pod:46 ../src/guestfs-actions.pod:64
4587 msgid ""
4588 "The number of disks added is returned.  This operation is atomic: if an "
4589 "error is returned, then no disks are added."
4590 msgstr ""
4591
4592 #. type: textblock
4593 #: ../fish/guestfish-actions.pod:49 ../src/guestfs-actions.pod:67
4594 msgid ""
4595 "This function does some minimal checks to make sure the libvirt domain is "
4596 "not running (unless C<readonly> is true).  In a future version we will try "
4597 "to acquire the libvirt lock on each disk."
4598 msgstr ""
4599
4600 #. type: textblock
4601 #: ../fish/guestfish-actions.pod:53 ../src/guestfs-actions.pod:71
4602 msgid ""
4603 "Disks must be accessible locally.  This often means that adding disks from a "
4604 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
4605 "unless those disks are accessible via the same device path locally too."
4606 msgstr ""
4607
4608 #. type: textblock
4609 #: ../fish/guestfish-actions.pod:58 ../src/guestfs-actions.pod:76
4610 msgid ""
4611 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
4612 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
4613 "libvirt URI (or one set through an environment variable, see the libvirt "
4614 "documentation for full details)."
4615 msgstr ""
4616
4617 #. type: textblock
4618 #: ../fish/guestfish-actions.pod:64 ../src/guestfs-actions.pod:82
4619 msgid ""
4620 "The optional C<live> flag controls whether this call will try to connect to "
4621 "a running virtual machine C<guestfsd> process if it sees a suitable "
4622 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
4623 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
4624 "DAEMONS> for more information."
4625 msgstr ""
4626
4627 #. type: textblock
4628 #: ../fish/guestfish-actions.pod:71 ../src/guestfs-actions.pod:89
4629 msgid ""
4630 "If the C<allowuuid> flag is true (default is false) then a UUID I<may> be "
4631 "passed instead of the domain name.  The C<dom> string is treated as a UUID "
4632 "first and looked up, and if that lookup fails then we treat C<dom> as a name "
4633 "as usual."
4634 msgstr ""
4635
4636 #. type: textblock
4637 #: ../fish/guestfish-actions.pod:76
4638 msgid ""
4639 "The other optional parameters are passed directly through to L</add-drive-"
4640 "opts>."
4641 msgstr ""
4642
4643 #. type: textblock
4644 #: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:143
4645 #: ../fish/guestfish-actions.pod:573 ../fish/guestfish-actions.pod:1973
4646 #: ../fish/guestfish-actions.pod:3139 ../fish/guestfish-actions.pod:3312
4647 #: ../fish/guestfish-actions.pod:3447
4648 msgid ""
4649 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
4650 msgstr ""
4651
4652 #. type: =head2
4653 #: ../fish/guestfish-actions.pod:81
4654 msgid "add-drive"
4655 msgstr "add-drive"
4656
4657 #. type: verbatim
4658 #: ../fish/guestfish-actions.pod:83
4659 #, no-wrap
4660 msgid ""
4661 " add-drive filename\n"
4662 "\n"
4663 msgstr ""
4664 " add-drive назва_файла\n"
4665 "\n"
4666
4667 #. type: textblock
4668 #: ../fish/guestfish-actions.pod:85
4669 msgid ""
4670 "This function is the equivalent of calling L</add-drive-opts> with no "
4671 "optional parameters, so the disk is added writable, with the format being "
4672 "detected automatically."
4673 msgstr ""
4674
4675 #. type: textblock
4676 #: ../fish/guestfish-actions.pod:89
4677 msgid ""
4678 "Automatic detection of the format opens you up to a potential security hole "
4679 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
4680 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
4681 "you should think about replacing calls to this function with calls to L</add-"
4682 "drive-opts>, and specifying the format."
4683 msgstr ""
4684
4685 #. type: =head2
4686 #: ../fish/guestfish-actions.pod:96
4687 msgid "add-drive-opts"
4688 msgstr "add-drive-opts"
4689
4690 #. type: =head2
4691 #: ../fish/guestfish-actions.pod:98
4692 msgid "add"
4693 msgstr "add"
4694
4695 #. type: verbatim
4696 #: ../fish/guestfish-actions.pod:100
4697 #, no-wrap
4698 msgid ""
4699 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
4700 "\n"
4701 msgstr ""
4702
4703 #. type: textblock
4704 #: ../fish/guestfish-actions.pod:102 ../src/guestfs-actions.pod:160
4705 msgid ""
4706 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
4707 "The first time you call this function, the disk appears as C</dev/sda>, the "
4708 "second time as C</dev/sdb>, and so on."
4709 msgstr ""
4710
4711 #. type: textblock
4712 #: ../fish/guestfish-actions.pod:107 ../src/guestfs-actions.pod:165
4713 msgid ""
4714 "You don't necessarily need to be root when using libguestfs.  However you "
4715 "obviously do need sufficient permissions to access the filename for whatever "
4716 "operations you want to perform (ie. read access if you just want to read the "
4717 "image or write access if you want to modify the image)."
4718 msgstr ""
4719
4720 #. type: textblock
4721 #: ../fish/guestfish-actions.pod:113 ../src/guestfs-actions.pod:171
4722 msgid "This call checks that C<filename> exists."
4723 msgstr ""
4724
4725 #. type: textblock
4726 #: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3101
4727 #: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4660
4728 msgid "The optional arguments are:"
4729 msgstr ""
4730
4731 #. type: =item
4732 #: ../fish/guestfish-actions.pod:119 ../src/guestfs-actions.pod:177
4733 msgid "C<readonly>"
4734 msgstr "C<readonly>"
4735
4736 #. type: textblock
4737 #: ../fish/guestfish-actions.pod:121 ../src/guestfs-actions.pod:179
4738 msgid ""
4739 "If true then the image is treated as read-only.  Writes are still allowed, "
4740 "but they are stored in a temporary snapshot overlay which is discarded at "
4741 "the end.  The disk that you add is not modified."
4742 msgstr ""
4743
4744 #. type: =item
4745 #: ../fish/guestfish-actions.pod:125 ../src/guestfs-actions.pod:183
4746 msgid "C<format>"
4747 msgstr "C<format>"
4748
4749 #. type: textblock
4750 #: ../fish/guestfish-actions.pod:127
4751 msgid ""
4752 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
4753 "add-drive-ro>) then the format is automatically detected.  Possible formats "
4754 "include C<raw> and C<qcow2>."
4755 msgstr ""
4756
4757 #. type: textblock
4758 #: ../fish/guestfish-actions.pod:131 ../src/guestfs-actions.pod:189
4759 msgid ""
4760 "Automatic detection of the format opens you up to a potential security hole "
4761 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
4762 "RHBZ#642934.  Specifying the format closes this security hole."
4763 msgstr ""
4764
4765 #. type: =item
4766 #: ../fish/guestfish-actions.pod:136 ../src/guestfs-actions.pod:194
4767 msgid "C<iface>"
4768 msgstr "C<iface>"
4769
4770 #. type: textblock
4771 #: ../fish/guestfish-actions.pod:138
4772 msgid ""
4773 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
4774 "add-drive-with-if> call (q.v.)"
4775 msgstr ""
4776
4777 #. type: =head2
4778 #: ../fish/guestfish-actions.pod:145
4779 msgid "add-drive-ro"
4780 msgstr "add-drive-ro"
4781
4782 #. type: =head2
4783 #: ../fish/guestfish-actions.pod:147
4784 msgid "add-ro"
4785 msgstr "add-ro"
4786
4787 #. type: verbatim
4788 #: ../fish/guestfish-actions.pod:149
4789 #, no-wrap
4790 msgid ""
4791 " add-drive-ro filename\n"
4792 "\n"
4793 msgstr ""
4794
4795 #. type: textblock
4796 #: ../fish/guestfish-actions.pod:151
4797 msgid ""
4798 "This function is the equivalent of calling L</add-drive-opts> with the "
4799 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
4800 "is added read-only, with the format being detected automatically."
4801 msgstr ""
4802
4803 #. type: =head2
4804 #: ../fish/guestfish-actions.pod:156
4805 msgid "add-drive-ro-with-if"
4806 msgstr ""
4807
4808 #. type: verbatim
4809 #: ../fish/guestfish-actions.pod:158
4810 #, no-wrap
4811 msgid ""
4812 " add-drive-ro-with-if filename iface\n"
4813 "\n"
4814 msgstr ""
4815
4816 #. type: textblock
4817 #: ../fish/guestfish-actions.pod:160
4818 msgid ""
4819 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
4820 "interface emulation to use at run time."
4821 msgstr ""
4822
4823 #. type: =head2
4824 #: ../fish/guestfish-actions.pod:170
4825 msgid "add-drive-with-if"
4826 msgstr ""
4827
4828 #. type: verbatim
4829 #: ../fish/guestfish-actions.pod:172
4830 #, no-wrap
4831 msgid ""
4832 " add-drive-with-if filename iface\n"
4833 "\n"
4834 msgstr ""
4835
4836 #. type: textblock
4837 #: ../fish/guestfish-actions.pod:174
4838 msgid ""
4839 "This is the same as L</add-drive> but it allows you to specify the QEMU "
4840 "interface emulation to use at run time."
4841 msgstr ""
4842
4843 #. type: =head2
4844 #: ../fish/guestfish-actions.pod:184
4845 msgid "aug-clear"
4846 msgstr ""
4847
4848 #. type: verbatim
4849 #: ../fish/guestfish-actions.pod:186
4850 #, no-wrap
4851 msgid ""
4852 " aug-clear augpath\n"
4853 "\n"
4854 msgstr ""
4855
4856 #. type: textblock
4857 #: ../fish/guestfish-actions.pod:188 ../src/guestfs-actions.pod:290
4858 msgid ""
4859 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
4860 "L<augtool(1)> C<clear> command."
4861 msgstr ""
4862
4863 #. type: =head2
4864 #: ../fish/guestfish-actions.pod:191
4865 msgid "aug-close"
4866 msgstr ""
4867
4868 #. type: verbatim
4869 #: ../fish/guestfish-actions.pod:193
4870 #, no-wrap
4871 msgid ""
4872 " aug-close\n"
4873 "\n"
4874 msgstr ""
4875
4876 #. type: textblock
4877 #: ../fish/guestfish-actions.pod:195
4878 msgid ""
4879 "Close the current Augeas handle and free up any resources used by it.  After "
4880 "calling this, you have to call L</aug-init> again before you can use any "
4881 "other Augeas functions."
4882 msgstr ""
4883
4884 #. type: =head2
4885 #: ../fish/guestfish-actions.pod:200
4886 msgid "aug-defnode"
4887 msgstr ""
4888
4889 #. type: verbatim
4890 #: ../fish/guestfish-actions.pod:202
4891 #, no-wrap
4892 msgid ""
4893 " aug-defnode name expr val\n"
4894 "\n"
4895 msgstr ""
4896
4897 #. type: textblock
4898 #: ../fish/guestfish-actions.pod:204 ../src/guestfs-actions.pod:319
4899 msgid ""
4900 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
4901 msgstr ""
4902
4903 #. type: textblock
4904 #: ../fish/guestfish-actions.pod:207
4905 msgid ""
4906 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
4907 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
4908 "containing that single node."
4909 msgstr ""
4910
4911 #. type: textblock
4912 #: ../fish/guestfish-actions.pod:211 ../src/guestfs-actions.pod:326
4913 msgid ""
4914 "On success this returns a pair containing the number of nodes in the "
4915 "nodeset, and a boolean flag if a node was created."
4916 msgstr ""
4917
4918 #. type: =head2
4919 #: ../fish/guestfish-actions.pod:215
4920 msgid "aug-defvar"
4921 msgstr ""
4922
4923 #. type: verbatim
4924 #: ../fish/guestfish-actions.pod:217
4925 #, no-wrap
4926 msgid ""
4927 " aug-defvar name expr\n"
4928 "\n"
4929 msgstr ""
4930
4931 #. type: textblock
4932 #: ../fish/guestfish-actions.pod:219 ../src/guestfs-actions.pod:343
4933 msgid ""
4934 "Defines an Augeas variable C<name> whose value is the result of evaluating "
4935 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
4936 msgstr ""
4937
4938 #. type: textblock
4939 #: ../fish/guestfish-actions.pod:223 ../src/guestfs-actions.pod:347
4940 msgid ""
4941 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
4942 "evaluates to something which is not a nodeset."
4943 msgstr ""
4944
4945 #. type: =head2
4946 #: ../fish/guestfish-actions.pod:226
4947 msgid "aug-get"
4948 msgstr ""
4949
4950 #. type: verbatim
4951 #: ../fish/guestfish-actions.pod:228
4952 #, no-wrap
4953 msgid ""
4954 " aug-get augpath\n"
4955 "\n"
4956 msgstr ""
4957
4958 #. type: textblock
4959 #: ../fish/guestfish-actions.pod:230 ../src/guestfs-actions.pod:360
4960 msgid ""
4961 "Look up the value associated with C<path>.  If C<path> matches exactly one "
4962 "node, the C<value> is returned."
4963 msgstr ""
4964
4965 #. type: =head2
4966 #: ../fish/guestfish-actions.pod:233
4967 msgid "aug-init"
4968 msgstr ""
4969
4970 #. type: verbatim
4971 #: ../fish/guestfish-actions.pod:235
4972 #, no-wrap
4973 msgid ""
4974 " aug-init root flags\n"
4975 "\n"
4976 msgstr ""
4977
4978 #. type: textblock
4979 #: ../fish/guestfish-actions.pod:237 ../src/guestfs-actions.pod:375
4980 msgid ""
4981 "Create a new Augeas handle for editing configuration files.  If there was "
4982 "any previous Augeas handle associated with this guestfs session, then it is "
4983 "closed."
4984 msgstr ""
4985
4986 #. type: textblock
4987 #: ../fish/guestfish-actions.pod:241
4988 msgid "You must call this before using any other L</aug-*> commands."
4989 msgstr ""
4990
4991 #. type: textblock
4992 #: ../fish/guestfish-actions.pod:244 ../src/guestfs-actions.pod:382
4993 msgid ""
4994 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
4995 msgstr ""
4996
4997 #. type: textblock
4998 #: ../fish/guestfish-actions.pod:247 ../src/guestfs-actions.pod:385
4999 msgid ""
5000 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
5001 "logical I<or> of the following integers:"
5002 msgstr ""
5003
5004 #. type: =item
5005 #: ../fish/guestfish-actions.pod:253 ../src/guestfs-actions.pod:391
5006 msgid "C<AUG_SAVE_BACKUP> = 1"
5007 msgstr "C<AUG_SAVE_BACKUP> = 1"
5008
5009 #. type: textblock
5010 #: ../fish/guestfish-actions.pod:255 ../src/guestfs-actions.pod:393
5011 msgid "Keep the original file with a C<.augsave> extension."
5012 msgstr ""
5013
5014 #. type: =item
5015 #: ../fish/guestfish-actions.pod:257 ../src/guestfs-actions.pod:395
5016 msgid "C<AUG_SAVE_NEWFILE> = 2"
5017 msgstr "C<AUG_SAVE_NEWFILE> = 2"
5018
5019 #. type: textblock
5020 #: ../fish/guestfish-actions.pod:259 ../src/guestfs-actions.pod:397
5021 msgid ""
5022 "Save changes into a file with extension C<.augnew>, and do not overwrite "
5023 "original.  Overrides C<AUG_SAVE_BACKUP>."
5024 msgstr ""
5025
5026 #. type: =item
5027 #: ../fish/guestfish-actions.pod:262 ../src/guestfs-actions.pod:400
5028 msgid "C<AUG_TYPE_CHECK> = 4"
5029 msgstr "C<AUG_TYPE_CHECK> = 4"
5030
5031 #. type: textblock
5032 #: ../fish/guestfish-actions.pod:264 ../src/guestfs-actions.pod:402
5033 msgid "Typecheck lenses."
5034 msgstr ""
5035
5036 #. type: textblock
5037 #: ../fish/guestfish-actions.pod:266
5038 msgid ""
5039 "This option is only useful when debugging Augeas lenses.  Use of this option "
5040 "may require additional memory for the libguestfs appliance.  You may need to "
5041 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call L</set-memsize>."
5042 msgstr ""
5043
5044 #. type: =item
5045 #: ../fish/guestfish-actions.pod:271 ../src/guestfs-actions.pod:409
5046 msgid "C<AUG_NO_STDINC> = 8"
5047 msgstr "C<AUG_NO_STDINC> = 8"
5048
5049 #. type: textblock
5050 #: ../fish/guestfish-actions.pod:273 ../src/guestfs-actions.pod:411
5051 msgid "Do not use standard load path for modules."
5052 msgstr ""
5053
5054 #. type: =item
5055 #: ../fish/guestfish-actions.pod:275 ../src/guestfs-actions.pod:413
5056 msgid "C<AUG_SAVE_NOOP> = 16"
5057 msgstr "C<AUG_SAVE_NOOP> = 16"
5058
5059 #. type: textblock
5060 #: ../fish/guestfish-actions.pod:277 ../src/guestfs-actions.pod:415
5061 msgid "Make save a no-op, just record what would have been changed."
5062 msgstr ""
5063
5064 #. type: =item
5065 #: ../fish/guestfish-actions.pod:279 ../src/guestfs-actions.pod:417
5066 msgid "C<AUG_NO_LOAD> = 32"
5067 msgstr "C<AUG_NO_LOAD> = 32"
5068
5069 #. type: textblock
5070 #: ../fish/guestfish-actions.pod:281
5071 msgid "Do not load the tree in L</aug-init>."
5072 msgstr ""
5073
5074 #. type: textblock
5075 #: ../fish/guestfish-actions.pod:285
5076 msgid "To close the handle, you can call L</aug-close>."
5077 msgstr ""
5078
5079 #. type: textblock
5080 #: ../fish/guestfish-actions.pod:287 ../src/guestfs-actions.pod:425
5081 msgid "To find out more about Augeas, see L<http://augeas.net/>."
5082 msgstr ""
5083
5084 #. type: =head2
5085 #: ../fish/guestfish-actions.pod:289
5086 msgid "aug-insert"
5087 msgstr ""
5088
5089 #. type: verbatim
5090 #: ../fish/guestfish-actions.pod:291
5091 #, no-wrap
5092 msgid ""
5093 " aug-insert augpath label true|false\n"
5094 "\n"
5095 msgstr ""
5096
5097 #. type: textblock
5098 #: ../fish/guestfish-actions.pod:293 ../src/guestfs-actions.pod:439
5099 msgid ""
5100 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
5101 "or after C<path> (depending on the boolean flag C<before>)."
5102 msgstr ""
5103
5104 #. type: textblock
5105 #: ../fish/guestfish-actions.pod:297 ../src/guestfs-actions.pod:443
5106 msgid ""
5107 "C<path> must match exactly one existing node in the tree, and C<label> must "
5108 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
5109 msgstr ""
5110
5111 #. type: =head2
5112 #: ../fish/guestfish-actions.pod:301
5113 msgid "aug-load"
5114 msgstr ""
5115
5116 #. type: verbatim
5117 #: ../fish/guestfish-actions.pod:303
5118 #, no-wrap
5119 msgid ""
5120 " aug-load\n"
5121 "\n"
5122 msgstr ""
5123
5124 #. type: textblock
5125 #: ../fish/guestfish-actions.pod:305 ../src/guestfs-actions.pod:456
5126 msgid "Load files into the tree."
5127 msgstr "Завантажити файли до ієрархії."
5128
5129 #. type: textblock
5130 #: ../fish/guestfish-actions.pod:307 ../src/guestfs-actions.pod:458
5131 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
5132 msgstr ""
5133
5134 #. type: =head2
5135 #: ../fish/guestfish-actions.pod:310
5136 msgid "aug-ls"
5137 msgstr ""
5138
5139 #. type: verbatim
5140 #: ../fish/guestfish-actions.pod:312
5141 #, no-wrap
5142 msgid ""
5143 " aug-ls augpath\n"
5144 "\n"
5145 msgstr ""
5146
5147 #. type: textblock
5148 #: ../fish/guestfish-actions.pod:314
5149 msgid ""
5150 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
5151 "resulting nodes into alphabetical order."
5152 msgstr ""
5153
5154 #. type: =head2
5155 #: ../fish/guestfish-actions.pod:317
5156 msgid "aug-match"
5157 msgstr ""
5158
5159 #. type: verbatim
5160 #: ../fish/guestfish-actions.pod:319
5161 #, no-wrap
5162 msgid ""
5163 " aug-match augpath\n"
5164 "\n"
5165 msgstr ""
5166
5167 #. type: textblock
5168 #: ../fish/guestfish-actions.pod:321 ../src/guestfs-actions.pod:486
5169 msgid ""
5170 "Returns a list of paths which match the path expression C<path>.  The "
5171 "returned paths are sufficiently qualified so that they match exactly one "
5172 "node in the current tree."
5173 msgstr ""
5174
5175 #. type: =head2
5176 #: ../fish/guestfish-actions.pod:325
5177 msgid "aug-mv"
5178 msgstr ""
5179
5180 #. type: verbatim
5181 #: ../fish/guestfish-actions.pod:327
5182 #, no-wrap
5183 msgid ""
5184 " aug-mv src dest\n"
5185 "\n"
5186 msgstr ""
5187
5188 #. type: textblock
5189 #: ../fish/guestfish-actions.pod:329 ../src/guestfs-actions.pod:503
5190 msgid ""
5191 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
5192 "C<dest> is overwritten if it exists."
5193 msgstr ""
5194
5195 #. type: =head2
5196 #: ../fish/guestfish-actions.pod:332
5197 msgid "aug-rm"
5198 msgstr ""
5199
5200 #. type: verbatim
5201 #: ../fish/guestfish-actions.pod:334
5202 #, no-wrap
5203 msgid ""
5204 " aug-rm augpath\n"
5205 "\n"
5206 msgstr ""
5207
5208 #. type: textblock
5209 #: ../fish/guestfish-actions.pod:336 ../src/guestfs-actions.pod:516
5210 msgid "Remove C<path> and all of its children."
5211 msgstr ""
5212
5213 #. type: textblock
5214 #: ../fish/guestfish-actions.pod:338 ../src/guestfs-actions.pod:518
5215 msgid "On success this returns the number of entries which were removed."
5216 msgstr ""
5217
5218 #. type: =head2
5219 #: ../fish/guestfish-actions.pod:340
5220 msgid "aug-save"
5221 msgstr ""
5222
5223 #. type: verbatim
5224 #: ../fish/guestfish-actions.pod:342
5225 #, no-wrap
5226 msgid ""
5227 " aug-save\n"
5228 "\n"
5229 msgstr ""
5230
5231 #. type: textblock
5232 #: ../fish/guestfish-actions.pod:344 ../src/guestfs-actions.pod:529
5233 msgid "This writes all pending changes to disk."
5234 msgstr ""
5235
5236 #. type: textblock
5237 #: ../fish/guestfish-actions.pod:346
5238 msgid ""
5239 "The flags which were passed to L</aug-init> affect exactly how files are "
5240 "saved."
5241 msgstr ""
5242
5243 #. type: =head2
5244 #: ../fish/guestfish-actions.pod:349
5245 msgid "aug-set"
5246 msgstr ""
5247
5248 #. type: verbatim
5249 #: ../fish/guestfish-actions.pod:351
5250 #, no-wrap
5251 msgid ""
5252 " aug-set augpath val\n"
5253 "\n"
5254 msgstr ""
5255
5256 #. type: textblock
5257 #: ../fish/guestfish-actions.pod:353 ../src/guestfs-actions.pod:545
5258 msgid "Set the value associated with C<path> to C<val>."
5259 msgstr ""
5260
5261 #. type: textblock
5262 #: ../fish/guestfish-actions.pod:355
5263 msgid ""
5264 "In the Augeas API, it is possible to clear a node by setting the value to "
5265 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
5266 "this call.  Instead you must use the L</aug-clear> call."
5267 msgstr ""
5268
5269 #. type: =head2
5270 #: ../fish/guestfish-actions.pod:360
5271 msgid "available"
5272 msgstr ""
5273
5274 #. type: verbatim
5275 #: ../fish/guestfish-actions.pod:362
5276 #, no-wrap
5277 msgid ""
5278 " available 'groups ...'\n"
5279 "\n"
5280 msgstr ""
5281
5282 #. type: textblock
5283 #: ../fish/guestfish-actions.pod:364 ../src/guestfs-actions.pod:562
5284 msgid ""
5285 "This command is used to check the availability of some groups of "
5286 "functionality in the appliance, which not all builds of the libguestfs "
5287 "appliance will be able to provide."
5288 msgstr ""
5289
5290 #. type: textblock
5291 #: ../fish/guestfish-actions.pod:368
5292 msgid ""
5293 "The libguestfs groups, and the functions that those groups correspond to, "
5294 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
5295 "runtime by calling L</available-all-groups>."
5296 msgstr ""
5297
5298 #. type: textblock
5299 #: ../fish/guestfish-actions.pod:373 ../src/guestfs-actions.pod:571
5300 msgid ""
5301 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
5302 "\"]> would check for the availability of the Linux inotify functions and "
5303 "Augeas (configuration file editing) functions."
5304 msgstr ""
5305
5306 #. type: textblock
5307 #: ../fish/guestfish-actions.pod:378 ../src/guestfs-actions.pod:576
5308 msgid "The command returns no error if I<all> requested groups are available."
5309 msgstr ""
5310
5311 #. type: textblock
5312 #: ../fish/guestfish-actions.pod:380 ../src/guestfs-actions.pod:578
5313 msgid ""
5314 "It fails with an error if one or more of the requested groups is unavailable "
5315 "in the appliance."
5316 msgstr ""
5317
5318 #. type: textblock
5319 #: ../fish/guestfish-actions.pod:383 ../src/guestfs-actions.pod:581
5320 msgid ""
5321 "If an unknown group name is included in the list of groups then an error is "
5322 "always returned."
5323 msgstr ""
5324
5325 #. type: textblock
5326 #: ../fish/guestfish-actions.pod:386 ../src/guestfs-actions.pod:584
5327 msgid "I<Notes:>"
5328 msgstr "I<Нотатки:>"
5329
5330 #. type: textblock
5331 #: ../fish/guestfish-actions.pod:392
5332 msgid "You must call L</launch> before calling this function."
5333 msgstr ""
5334
5335 #. type: textblock
5336 #: ../fish/guestfish-actions.pod:394 ../src/guestfs-actions.pod:592
5337 msgid ""
5338 "The reason is because we don't know what groups are supported by the "
5339 "appliance/daemon until it is running and can be queried."
5340 msgstr ""
5341
5342 #. type: textblock
5343 #: ../fish/guestfish-actions.pod:400 ../src/guestfs-actions.pod:598
5344 msgid ""
5345 "If a group of functions is available, this does not necessarily mean that "
5346 "they will work.  You still have to check for errors when calling individual "
5347 "API functions even if they are available."
5348 msgstr ""
5349
5350 #. type: textblock
5351 #: ../fish/guestfish-actions.pod:407 ../src/guestfs-actions.pod:605
5352 msgid ""
5353 "It is usually the job of distro packagers to build complete functionality "
5354 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
5355 "with all requirements satisfied, will support everything."
5356 msgstr ""
5357
5358 #. type: textblock
5359 #: ../fish/guestfish-actions.pod:414
5360 msgid ""
5361 "This call was added in version C<1.0.80>.  In previous versions of "
5362 "libguestfs all you could do would be to speculatively execute a command to "
5363 "find out if the daemon implemented it.  See also L</version>."
5364 msgstr ""
5365
5366 #. type: =head2
5367 #: ../fish/guestfish-actions.pod:421
5368 msgid "available-all-groups"
5369 msgstr ""
5370
5371 #. type: verbatim
5372 #: ../fish/guestfish-actions.pod:423
5373 #, no-wrap
5374 msgid ""
5375 " available-all-groups\n"
5376 "\n"
5377 msgstr ""
5378
5379 #. type: textblock
5380 #: ../fish/guestfish-actions.pod:425
5381 msgid ""
5382 "This command returns a list of all optional groups that this daemon knows "
5383 "about.  Note this returns both supported and unsupported groups.  To find "
5384 "out which ones the daemon can actually support you have to call L</"
5385 "available> on each member of the returned list."
5386 msgstr ""
5387
5388 #. type: textblock
5389 #: ../fish/guestfish-actions.pod:431
5390 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
5391 msgstr ""
5392
5393 #. type: =head2
5394 #: ../fish/guestfish-actions.pod:433
5395 msgid "base64-in"
5396 msgstr ""
5397
5398 #. type: verbatim
5399 #: ../fish/guestfish-actions.pod:435
5400 #, no-wrap
5401 msgid ""
5402 " base64-in (base64file|-) filename\n"
5403 "\n"
5404 msgstr ""
5405
5406 #. type: textblock
5407 #: ../fish/guestfish-actions.pod:437 ../src/guestfs-actions.pod:649
5408 msgid ""
5409 "This command uploads base64-encoded data from C<base64file> to C<filename>."
5410 msgstr ""
5411
5412 #. type: textblock
5413 #: ../fish/guestfish-actions.pod:440 ../fish/guestfish-actions.pod:449
5414 #: ../fish/guestfish-actions.pod:698 ../fish/guestfish-actions.pod:867
5415 #: ../fish/guestfish-actions.pod:886 ../fish/guestfish-actions.pod:1260
5416 #: ../fish/guestfish-actions.pod:4663 ../fish/guestfish-actions.pod:4675
5417 #: ../fish/guestfish-actions.pod:4686 ../fish/guestfish-actions.pod:4697
5418 #: ../fish/guestfish-actions.pod:4749 ../fish/guestfish-actions.pod:4758
5419 #: ../fish/guestfish-actions.pod:4812 ../fish/guestfish-actions.pod:4835
5420 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
5421 msgstr ""
5422
5423 #. type: =head2
5424 #: ../fish/guestfish-actions.pod:442
5425 msgid "base64-out"
5426 msgstr ""
5427
5428 #. type: verbatim
5429 #: ../fish/guestfish-actions.pod:444
5430 #, no-wrap
5431 msgid ""
5432 " base64-out filename (base64file|-)\n"
5433 "\n"
5434 msgstr ""
5435
5436 #. type: textblock
5437 #: ../fish/guestfish-actions.pod:446 ../src/guestfs-actions.pod:663
5438 msgid ""
5439 "This command downloads the contents of C<filename>, writing it out to local "
5440 "file C<base64file> encoded as base64."
5441 msgstr ""
5442
5443 #. type: =head2
5444 #: ../fish/guestfish-actions.pod:451
5445 msgid "blockdev-flushbufs"
5446 msgstr ""
5447
5448 #. type: verbatim
5449 #: ../fish/guestfish-actions.pod:453
5450 #, no-wrap
5451 msgid ""
5452 " blockdev-flushbufs device\n"
5453 "\n"
5454 msgstr ""
5455
5456 #. type: textblock
5457 #: ../fish/guestfish-actions.pod:455 ../src/guestfs-actions.pod:676
5458 msgid ""
5459 "This tells the kernel to flush internal buffers associated with C<device>."
5460 msgstr ""
5461
5462 #. type: textblock
5463 #: ../fish/guestfish-actions.pod:458 ../fish/guestfish-actions.pod:469
5464 #: ../fish/guestfish-actions.pod:478 ../fish/guestfish-actions.pod:488
5465 #: ../fish/guestfish-actions.pod:500 ../fish/guestfish-actions.pod:513
5466 #: ../fish/guestfish-actions.pod:521 ../fish/guestfish-actions.pod:532
5467 #: ../fish/guestfish-actions.pod:540 ../fish/guestfish-actions.pod:548
5468 #: ../src/guestfs-actions.pod:679 ../src/guestfs-actions.pod:696
5469 #: ../src/guestfs-actions.pod:711 ../src/guestfs-actions.pod:727
5470 #: ../src/guestfs-actions.pod:745 ../src/guestfs-actions.pod:764
5471 #: ../src/guestfs-actions.pod:778 ../src/guestfs-actions.pod:796
5472 #: ../src/guestfs-actions.pod:810 ../src/guestfs-actions.pod:824
5473 msgid "This uses the L<blockdev(8)> command."
5474 msgstr ""
5475
5476 #. type: =head2
5477 #: ../fish/guestfish-actions.pod:460
5478 msgid "blockdev-getbsz"
5479 msgstr ""
5480
5481 #. type: verbatim
5482 #: ../fish/guestfish-actions.pod:462
5483 #, no-wrap
5484 msgid ""
5485 " blockdev-getbsz device\n"
5486 "\n"
5487 msgstr ""
5488
5489 #. type: textblock
5490 #: ../fish/guestfish-actions.pod:464 ../src/guestfs-actions.pod:691
5491 msgid "This returns the block size of a device."
5492 msgstr ""
5493
5494 #. type: textblock
5495 #: ../fish/guestfish-actions.pod:466 ../fish/guestfish-actions.pod:529
5496 #: ../src/guestfs-actions.pod:693 ../src/guestfs-actions.pod:793
5497 msgid ""
5498 "(Note this is different from both I<size in blocks> and I<filesystem block "
5499 "size>)."
5500 msgstr ""
5501
5502 #. type: =head2
5503 #: ../fish/guestfish-actions.pod:471
5504 msgid "blockdev-getro"
5505 msgstr ""
5506
5507 #. type: verbatim
5508 #: ../fish/guestfish-actions.pod:473
5509 #, no-wrap
5510 msgid ""
5511 " blockdev-getro device\n"
5512 "\n"
5513 msgstr ""
5514
5515 #. type: textblock
5516 #: ../fish/guestfish-actions.pod:475 ../src/guestfs-actions.pod:708
5517 msgid ""
5518 "Returns a boolean indicating if the block device is read-only (true if read-"
5519 "only, false if not)."
5520 msgstr ""
5521
5522 #. type: =head2
5523 #: ../fish/guestfish-actions.pod:480
5524 msgid "blockdev-getsize64"
5525 msgstr ""
5526
5527 #. type: verbatim
5528 #: ../fish/guestfish-actions.pod:482
5529 #, no-wrap
5530 msgid ""
5531 " blockdev-getsize64 device\n"
5532 "\n"
5533 msgstr ""
5534
5535 #. type: textblock
5536 #: ../fish/guestfish-actions.pod:484 ../src/guestfs-actions.pod:723
5537 msgid "This returns the size of the device in bytes."
5538 msgstr ""
5539
5540 #. type: textblock
5541 #: ../fish/guestfish-actions.pod:486
5542 msgid "See also L</blockdev-getsz>."
5543 msgstr ""
5544
5545 #. type: =head2
5546 #: ../fish/guestfish-actions.pod:490
5547 msgid "blockdev-getss"
5548 msgstr ""
5549
5550 #. type: verbatim
5551 #: ../fish/guestfish-actions.pod:492
5552 #, no-wrap
5553 msgid ""
5554 " blockdev-getss device\n"
5555 "\n"
5556 msgstr ""
5557
5558 #. type: textblock
5559 #: ../fish/guestfish-actions.pod:494 ../src/guestfs-actions.pod:739
5560 msgid ""
5561 "This returns the size of sectors on a block device.  Usually 512, but can be "
5562 "larger for modern devices."
5563 msgstr ""
5564
5565 #. type: textblock
5566 #: ../fish/guestfish-actions.pod:497
5567 msgid ""
5568 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
5569 msgstr ""
5570
5571 #. type: =head2
5572 #: ../fish/guestfish-actions.pod:502
5573 msgid "blockdev-getsz"
5574 msgstr ""
5575
5576 #. type: verbatim
5577 #: ../fish/guestfish-actions.pod:504
5578 #, no-wrap
5579 msgid ""
5580 " blockdev-getsz device\n"
5581 "\n"
5582 msgstr ""
5583
5584 #. type: textblock
5585 #: ../fish/guestfish-actions.pod:506 ../src/guestfs-actions.pod:757
5586 msgid ""
5587 "This returns the size of the device in units of 512-byte sectors (even if "
5588 "the sectorsize isn't 512 bytes ... weird)."
5589 msgstr ""
5590
5591 #. type: textblock
5592 #: ../fish/guestfish-actions.pod:509
5593 msgid ""
5594 "See also L</blockdev-getss> for the real sector size of the device, and L</"
5595 "blockdev-getsize64> for the more useful I<size in bytes>."
5596 msgstr ""
5597
5598 #. type: =head2
5599 #: ../fish/guestfish-actions.pod:515
5600 msgid "blockdev-rereadpt"
5601 msgstr ""
5602
5603 #. type: verbatim
5604 #: ../fish/guestfish-actions.pod:517
5605 #, no-wrap
5606 msgid ""
5607 " blockdev-rereadpt device\n"
5608 "\n"
5609 msgstr ""
5610
5611 #. type: textblock
5612 #: ../fish/guestfish-actions.pod:519 ../src/guestfs-actions.pod:776
5613 msgid "Reread the partition table on C<device>."
5614 msgstr ""
5615
5616 #. type: =head2
5617 #: ../fish/guestfish-actions.pod:523
5618 msgid "blockdev-setbsz"
5619 msgstr ""
5620
5621 #. type: verbatim
5622 #: ../fish/guestfish-actions.pod:525
5623 #, no-wrap
5624 msgid ""
5625 " blockdev-setbsz device blocksize\n"
5626 "\n"
5627 msgstr ""
5628
5629 #. type: textblock
5630 #: ../fish/guestfish-actions.pod:527 ../src/guestfs-actions.pod:791
5631 msgid "This sets the block size of a device."
5632 msgstr ""
5633
5634 #. type: =head2
5635 #: ../fish/guestfish-actions.pod:534
5636 msgid "blockdev-setro"
5637 msgstr ""
5638
5639 #. type: verbatim
5640 #: ../fish/guestfish-actions.pod:536
5641 #, no-wrap
5642 msgid ""
5643 " blockdev-setro device\n"
5644 "\n"
5645 msgstr ""
5646
5647 #. type: textblock
5648 #: ../fish/guestfish-actions.pod:538 ../src/guestfs-actions.pod:808
5649 msgid "Sets the block device named C<device> to read-only."
5650 msgstr ""
5651
5652 #. type: =head2
5653 #: ../fish/guestfish-actions.pod:542
5654 msgid "blockdev-setrw"
5655 msgstr ""
5656
5657 #. type: verbatim
5658 #: ../fish/guestfish-actions.pod:544
5659 #, no-wrap
5660 msgid ""
5661 " blockdev-setrw device\n"
5662 "\n"
5663 msgstr ""
5664
5665 #. type: textblock
5666 #: ../fish/guestfish-actions.pod:546 ../src/guestfs-actions.pod:822
5667 msgid "Sets the block device named C<device> to read-write."
5668 msgstr ""
5669
5670 #. type: =head2
5671 #: ../fish/guestfish-actions.pod:550
5672 msgid "btrfs-filesystem-resize"
5673 msgstr ""
5674
5675 #. type: verbatim
5676 #: ../fish/guestfish-actions.pod:552
5677 #, no-wrap
5678 msgid ""
5679 " btrfs-filesystem-resize mountpoint [size:..]\n"
5680 "\n"
5681 msgstr ""
5682
5683 #. type: textblock
5684 #: ../fish/guestfish-actions.pod:554 ../src/guestfs-actions.pod:844
5685 msgid "This command resizes a btrfs filesystem."
5686 msgstr ""
5687
5688 #. type: textblock
5689 #: ../fish/guestfish-actions.pod:556 ../src/guestfs-actions.pod:846
5690 msgid ""
5691 "Note that unlike other resize calls, the filesystem has to be mounted and "
5692 "the parameter is the mountpoint not the device (this is a requirement of "
5693 "btrfs itself)."
5694 msgstr ""
5695
5696 #. type: textblock
5697 #: ../fish/guestfish-actions.pod:560 ../fish/guestfish-actions.pod:3422
5698 #: ../src/guestfs-actions.pod:850 ../src/guestfs-actions.pod:5194
5699 msgid "The optional parameters are:"
5700 msgstr ""
5701
5702 #. type: =item
5703 #: ../fish/guestfish-actions.pod:564 ../fish/guestfish-actions.pod:3426
5704 #: ../src/guestfs-actions.pod:854 ../src/guestfs-actions.pod:5198
5705 msgid "C<size>"
5706 msgstr ""
5707
5708 #. type: textblock
5709 #: ../fish/guestfish-actions.pod:566 ../src/guestfs-actions.pod:856
5710 msgid ""
5711 "The new size (in bytes) of the filesystem.  If omitted, the filesystem is "
5712 "resized to the maximum size."
5713 msgstr ""
5714
5715 #. type: textblock
5716 #: ../fish/guestfish-actions.pod:571 ../src/guestfs-actions.pod:861
5717 msgid "See also L<btrfs(8)>."
5718 msgstr ""
5719
5720 #. type: =head2
5721 #: ../fish/guestfish-actions.pod:575
5722 msgid "case-sensitive-path"
5723 msgstr ""
5724
5725 #. type: verbatim
5726 #: ../fish/guestfish-actions.pod:577
5727 #, no-wrap
5728 msgid ""
5729 " case-sensitive-path path\n"
5730 "\n"
5731 msgstr ""
5732
5733 #. type: textblock
5734 #: ../fish/guestfish-actions.pod:579 ../src/guestfs-actions.pod:895
5735 msgid ""
5736 "This can be used to resolve case insensitive paths on a filesystem which is "
5737 "case sensitive.  The use case is to resolve paths which you have read from "
5738 "Windows configuration files or the Windows Registry, to the true path."
5739 msgstr ""
5740
5741 #. type: textblock
5742 #: ../fish/guestfish-actions.pod:584 ../src/guestfs-actions.pod:900
5743 msgid ""
5744 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
5745 "(and probably others), which is that although the underlying filesystem is "
5746 "case-insensitive, the driver exports the filesystem to Linux as case-"
5747 "sensitive."
5748 msgstr ""
5749
5750 #. type: textblock
5751 #: ../fish/guestfish-actions.pod:589 ../src/guestfs-actions.pod:905
5752 msgid ""
5753 "One consequence of this is that special directories such as C<c:\\windows> "
5754 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
5755 "precise details of how they were created.  In Windows itself this would not "
5756 "be a problem."
5757 msgstr ""
5758
5759 #. type: textblock
5760 #: ../fish/guestfish-actions.pod:595 ../src/guestfs-actions.pod:911
5761 msgid ""
5762 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
5763 "#posixfilenames1>"
5764 msgstr ""
5765
5766 #. type: textblock
5767 #: ../fish/guestfish-actions.pod:598 ../src/guestfs-actions.pod:914
5768 msgid ""
5769 "This function resolves the true case of each element in the path and returns "
5770 "the case-sensitive path."
5771 msgstr ""
5772
5773 #. type: textblock
5774 #: ../fish/guestfish-actions.pod:601
5775 msgid ""
5776 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
5777 "WINDOWS/system32\"> (the exact return value would depend on details of how "
5778 "the directories were originally created under Windows)."
5779 msgstr ""
5780
5781 #. type: textblock
5782 #: ../fish/guestfish-actions.pod:606 ../src/guestfs-actions.pod:922
5783 msgid "I<Note>: This function does not handle drive names, backslashes etc."
5784 msgstr ""
5785
5786 #. type: textblock
5787 #: ../fish/guestfish-actions.pod:609
5788 msgid "See also L</realpath>."
5789 msgstr ""
5790
5791 #. type: =head2
5792 #: ../fish/guestfish-actions.pod:611
5793 msgid "cat"
5794 msgstr "cat"
5795
5796 #. type: verbatim
5797 #: ../fish/guestfish-actions.pod:613
5798 #, no-wrap
5799 msgid ""
5800 " cat path\n"
5801 "\n"
5802 msgstr ""
5803 " cat шлях\n"
5804 "\n"
5805
5806 #. type: textblock
5807 #: ../fish/guestfish-actions.pod:615 ../fish/guestfish-actions.pod:3842
5808 #: ../src/guestfs-actions.pod:938 ../src/guestfs-actions.pod:5837
5809 msgid "Return the contents of the file named C<path>."
5810 msgstr ""
5811
5812 #. type: textblock
5813 #: ../fish/guestfish-actions.pod:617
5814 msgid ""
5815 "Note that this function cannot correctly handle binary files (specifically, "
5816 "files containing C<\\0> character which is treated as end of string).  For "
5817 "those you need to use the L</read-file> or L</download> functions which have "
5818 "a more complex interface."
5819 msgstr ""
5820
5821 #. type: textblock
5822 #: ../fish/guestfish-actions.pod:622 ../fish/guestfish-actions.pod:757
5823 #: ../fish/guestfish-actions.pod:769 ../fish/guestfish-actions.pod:945
5824 #: ../fish/guestfish-actions.pod:955 ../fish/guestfish-actions.pod:1022
5825 #: ../fish/guestfish-actions.pod:1032 ../fish/guestfish-actions.pod:1224
5826 #: ../fish/guestfish-actions.pod:1531 ../fish/guestfish-actions.pod:1541
5827 #: ../fish/guestfish-actions.pod:1569 ../fish/guestfish-actions.pod:1584
5828 #: ../fish/guestfish-actions.pod:1594 ../fish/guestfish-actions.pod:1613
5829 #: ../fish/guestfish-actions.pod:3712 ../fish/guestfish-actions.pod:3727
5830 #: ../fish/guestfish-actions.pod:3803 ../fish/guestfish-actions.pod:3820
5831 #: ../fish/guestfish-actions.pod:3835 ../fish/guestfish-actions.pod:4504
5832 #: ../fish/guestfish-actions.pod:4550 ../fish/guestfish-actions.pod:4635
5833 #: ../fish/guestfish-actions.pod:4650 ../fish/guestfish-actions.pod:5056
5834 #: ../fish/guestfish-actions.pod:5068 ../fish/guestfish-actions.pod:5086
5835 #: ../fish/guestfish-actions.pod:5103 ../fish/guestfish-actions.pod:5113
5836 #: ../fish/guestfish-actions.pod:5170 ../fish/guestfish-actions.pod:5180
5837 #: ../fish/guestfish-actions.pod:5209 ../fish/guestfish-actions.pod:5219
5838 #: ../src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:1127
5839 #: ../src/guestfs-actions.pod:1147 ../src/guestfs-actions.pod:1443
5840 #: ../src/guestfs-actions.pod:1462 ../src/guestfs-actions.pod:1565
5841 #: ../src/guestfs-actions.pod:1584 ../src/guestfs-actions.pod:1830
5842 #: ../src/guestfs-actions.pod:2301 ../src/guestfs-actions.pod:2320
5843 #: ../src/guestfs-actions.pod:2363 ../src/guestfs-actions.pod:2387
5844 #: ../src/guestfs-actions.pod:2404 ../src/guestfs-actions.pod:2433
5845 #: ../src/guestfs-actions.pod:5619 ../src/guestfs-actions.pod:5645
5846 #: ../src/guestfs-actions.pod:5776 ../src/guestfs-actions.pod:5802
5847 #: ../src/guestfs-actions.pod:5826 ../src/guestfs-actions.pod:6777
5848 #: ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:6978
5849 #: ../src/guestfs-actions.pod:7002 ../src/guestfs-actions.pod:7667
5850 #: ../src/guestfs-actions.pod:7687 ../src/guestfs-actions.pod:7713
5851 #: ../src/guestfs-actions.pod:7739 ../src/guestfs-actions.pod:7758
5852 #: ../src/guestfs-actions.pod:7852 ../src/guestfs-actions.pod:7871
5853 #: ../src/guestfs-actions.pod:7917 ../src/guestfs-actions.pod:7936
5854 msgid ""
5855 "Because of the message protocol, there is a transfer limit of somewhere "
5856 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
5857 msgstr ""
5858
5859 #. type: =head2
5860 #: ../fish/guestfish-actions.pod:625
5861 msgid "checksum"
5862 msgstr "checksum"
5863
5864 #. type: verbatim
5865 #: ../fish/guestfish-actions.pod:627
5866 #, no-wrap
5867 msgid ""
5868 " checksum csumtype path\n"
5869 "\n"
5870 msgstr ""
5871
5872 #. type: textblock
5873 #: ../fish/guestfish-actions.pod:629 ../src/guestfs-actions.pod:960
5874 msgid ""
5875 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
5876 msgstr ""
5877
5878 #. type: textblock
5879 #: ../fish/guestfish-actions.pod:632 ../src/guestfs-actions.pod:963
5880 msgid ""
5881 "The type of checksum to compute is given by the C<csumtype> parameter which "
5882 "must have one of the following values:"
5883 msgstr ""
5884
5885 #. type: =item
5886 #: ../fish/guestfish-actions.pod:637 ../src/guestfs-actions.pod:968
5887 msgid "C<crc>"
5888 msgstr "C<crc>"
5889
5890 #. type: textblock
5891 #: ../fish/guestfish-actions.pod:639 ../src/guestfs-actions.pod:970
5892 msgid ""
5893 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
5894 "C<cksum> command."
5895 msgstr ""
5896
5897 #. type: =item
5898 #: ../fish/guestfish-actions.pod:642 ../src/guestfs-actions.pod:973
5899 msgid "C<md5>"
5900 msgstr "C<md5>"
5901
5902 #. type: textblock
5903 #: ../fish/guestfish-actions.pod:644 ../src/guestfs-actions.pod:975
5904 msgid "Compute the MD5 hash (using the C<md5sum> program)."
5905 msgstr ""
5906
5907 #. type: =item
5908 #: ../fish/guestfish-actions.pod:646 ../src/guestfs-actions.pod:977
5909 msgid "C<sha1>"
5910 msgstr "C<sha1>"
5911
5912 #. type: textblock
5913 #: ../fish/guestfish-actions.pod:648 ../src/guestfs-actions.pod:979
5914 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
5915 msgstr ""
5916
5917 #. type: =item
5918 #: ../fish/guestfish-actions.pod:650 ../src/guestfs-actions.pod:981
5919 msgid "C<sha224>"
5920 msgstr "C<sha224>"
5921
5922 #. type: textblock
5923 #: ../fish/guestfish-actions.pod:652 ../src/guestfs-actions.pod:983
5924 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
5925 msgstr ""
5926
5927 #. type: =item
5928 #: ../fish/guestfish-actions.pod:654 ../src/guestfs-actions.pod:985
5929 msgid "C<sha256>"
5930 msgstr "C<sha256>"
5931
5932 #. type: textblock
5933 #: ../fish/guestfish-actions.pod:656 ../src/guestfs-actions.pod:987
5934 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
5935 msgstr ""
5936
5937 #. type: =item
5938 #: ../fish/guestfish-actions.pod:658 ../src/guestfs-actions.pod:989
5939 msgid "C<sha384>"
5940 msgstr "C<sha384>"
5941
5942 #. type: textblock
5943 #: ../fish/guestfish-actions.pod:660 ../src/guestfs-actions.pod:991
5944 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
5945 msgstr ""
5946
5947 #. type: =item
5948 #: ../fish/guestfish-actions.pod:662 ../src/guestfs-actions.pod:993
5949 msgid "C<sha512>"
5950 msgstr "C<sha512>"
5951
5952 #. type: textblock
5953 #: ../fish/guestfish-actions.pod:664 ../src/guestfs-actions.pod:995
5954 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
5955 msgstr ""
5956
5957 #. type: textblock
5958 #: ../fish/guestfish-actions.pod:668 ../src/guestfs-actions.pod:999
5959 msgid "The checksum is returned as a printable string."
5960 msgstr ""
5961
5962 #. type: textblock
5963 #: ../fish/guestfish-actions.pod:670
5964 msgid "To get the checksum for a device, use L</checksum-device>."
5965 msgstr ""
5966
5967 #. type: textblock
5968 #: ../fish/guestfish-actions.pod:672
5969 msgid "To get the checksums for many files, use L</checksums-out>."
5970 msgstr ""
5971
5972 #. type: =head2
5973 #: ../fish/guestfish-actions.pod:674
5974 msgid "checksum-device"
5975 msgstr "checksum-device"
5976
5977 #. type: verbatim
5978 #: ../fish/guestfish-actions.pod:676
5979 #, no-wrap
5980 msgid ""
5981 " checksum-device csumtype device\n"
5982 "\n"
5983 msgstr ""
5984
5985 #. type: textblock
5986 #: ../fish/guestfish-actions.pod:678
5987 msgid ""
5988 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
5989 "device named C<device>.  For the types of checksums supported see the L</"
5990 "checksum> command."
5991 msgstr ""
5992
5993 #. type: =head2
5994 #: ../fish/guestfish-actions.pod:682
5995 msgid "checksums-out"
5996 msgstr ""
5997
5998 #. type: verbatim
5999 #: ../fish/guestfish-actions.pod:684
6000 #, no-wrap
6001 msgid ""
6002 " checksums-out csumtype directory (sumsfile|-)\n"
6003 "\n"
6004 msgstr ""
6005
6006 #. type: textblock
6007 #: ../fish/guestfish-actions.pod:686 ../src/guestfs-actions.pod:1034
6008 msgid ""
6009 "This command computes the checksums of all regular files in C<directory> and "
6010 "then emits a list of those checksums to the local output file C<sumsfile>."
6011 msgstr ""
6012
6013 #. type: textblock
6014 #: ../fish/guestfish-actions.pod:690 ../src/guestfs-actions.pod:1038
6015 msgid ""
6016 "This can be used for verifying the integrity of a virtual machine.  However "
6017 "to be properly secure you should pay attention to the output of the checksum "
6018 "command (it uses the ones from GNU coreutils).  In particular when the "
6019 "filename is not printable, coreutils uses a special backslash syntax.  For "
6020 "more information, see the GNU coreutils info file."
6021 msgstr ""
6022
6023 #. type: =head2
6024 #: ../fish/guestfish-actions.pod:700
6025 msgid "chmod"
6026 msgstr "chmod"
6027
6028 #. type: verbatim
6029 #: ../fish/guestfish-actions.pod:702
6030 #, no-wrap
6031 msgid ""
6032 " chmod mode path\n"
6033 "\n"
6034 msgstr ""
6035
6036 #. type: textblock
6037 #: ../fish/guestfish-actions.pod:704 ../src/guestfs-actions.pod:1057
6038 msgid ""
6039 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
6040 "supported."
6041 msgstr ""
6042
6043 #. type: textblock
6044 #: ../fish/guestfish-actions.pod:707 ../src/guestfs-actions.pod:1060
6045 msgid ""
6046 "I<Note>: When using this command from guestfish, C<mode> by default would be "
6047 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
6048 "C<700>."
6049 msgstr ""
6050
6051 #. type: textblock
6052 #: ../fish/guestfish-actions.pod:711 ../fish/guestfish-actions.pod:3065
6053 #: ../fish/guestfish-actions.pod:3204 ../fish/guestfish-actions.pod:3214
6054 #: ../fish/guestfish-actions.pod:3224 ../src/guestfs-actions.pod:1064
6055 #: ../src/guestfs-actions.pod:4591 ../src/guestfs-actions.pod:4800
6056 #: ../src/guestfs-actions.pod:4819 ../src/guestfs-actions.pod:4838
6057 msgid "The mode actually set is affected by the umask."
6058 msgstr ""
6059
6060 #. type: =head2
6061 #: ../fish/guestfish-actions.pod:713
6062 msgid "chown"
6063 msgstr "chown"
6064
6065 #. type: verbatim
6066 #: ../fish/guestfish-actions.pod:715
6067 #, no-wrap
6068 msgid ""
6069 " chown owner group path\n"
6070 "\n"
6071 msgstr ""
6072
6073 #. type: textblock
6074 #: ../fish/guestfish-actions.pod:717 ../src/guestfs-actions.pod:1078
6075 msgid "Change the file owner to C<owner> and group to C<group>."
6076 msgstr ""
6077
6078 #. type: textblock
6079 #: ../fish/guestfish-actions.pod:719 ../fish/guestfish-actions.pod:2500
6080 #: ../src/guestfs-actions.pod:1080 ../src/guestfs-actions.pod:3662
6081 msgid ""
6082 "Only numeric uid and gid are supported.  If you want to use names, you will "
6083 "need to locate and parse the password file yourself (Augeas support makes "
6084 "this relatively easy)."
6085 msgstr ""
6086
6087 #. type: =head2
6088 #: ../fish/guestfish-actions.pod:723
6089 msgid "command"
6090 msgstr ""
6091
6092 #. type: verbatim
6093 #: ../fish/guestfish-actions.pod:725
6094 #, no-wrap
6095 msgid ""
6096 " command 'arguments ...'\n"
6097 "\n"
6098 msgstr ""
6099
6100 #. type: textblock
6101 #: ../fish/guestfish-actions.pod:727 ../src/guestfs-actions.pod:1094
6102 msgid ""
6103 "This call runs a command from the guest filesystem.  The filesystem must be "
6104 "mounted, and must contain a compatible operating system (ie. something "
6105 "Linux, with the same or compatible processor architecture)."
6106 msgstr ""
6107
6108 #. type: textblock
6109 #: ../fish/guestfish-actions.pod:732
6110 msgid ""
6111 "The single parameter is an argv-style list of arguments.  The first element "
6112 "is the name of the program to run.  Subsequent elements are parameters.  The "
6113 "list must be non-empty (ie. must contain a program name).  Note that the "
6114 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
6115 msgstr ""
6116
6117 #. type: textblock
6118 #: ../fish/guestfish-actions.pod:739 ../src/guestfs-actions.pod:1106
6119 msgid "The return value is anything printed to I<stdout> by the command."
6120 msgstr ""
6121
6122 #. type: textblock
6123 #: ../fish/guestfish-actions.pod:742 ../src/guestfs-actions.pod:1109
6124 msgid ""
6125 "If the command returns a non-zero exit status, then this function returns an "
6126 "error message.  The error message string is the content of I<stderr> from "
6127 "the command."
6128 msgstr ""
6129
6130 #. type: textblock
6131 #: ../fish/guestfish-actions.pod:746 ../src/guestfs-actions.pod:1113
6132 msgid ""
6133 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
6134 "bin>.  If you require a program from another location, you should provide "
6135 "the full path in the first parameter."
6136 msgstr ""
6137
6138 #. type: textblock
6139 #: ../fish/guestfish-actions.pod:751 ../src/guestfs-actions.pod:1118
6140 msgid ""
6141 "Shared libraries and data files required by the program must be available on "
6142 "filesystems which are mounted in the correct places.  It is the caller's "
6143 "responsibility to ensure all filesystems that are needed are mounted at the "
6144 "right locations."
6145 msgstr ""
6146
6147 #. type: =head2
6148 #: ../fish/guestfish-actions.pod:760
6149 msgid "command-lines"
6150 msgstr ""
6151
6152 #. type: verbatim
6153 #: ../fish/guestfish-actions.pod:762
6154 #, no-wrap
6155 msgid ""
6156 " command-lines 'arguments ...'\n"
6157 "\n"
6158 msgstr ""
6159
6160 #. type: textblock
6161 #: ../fish/guestfish-actions.pod:764
6162 msgid ""
6163 "This is the same as L</command>, but splits the result into a list of lines."
6164 msgstr ""
6165
6166 #. type: textblock
6167 #: ../fish/guestfish-actions.pod:767
6168 msgid "See also: L</sh-lines>"
6169 msgstr ""
6170
6171 #. type: =head2
6172 #: ../fish/guestfish-actions.pod:772
6173 msgid "config"
6174 msgstr ""
6175
6176 #. type: verbatim
6177 #: ../fish/guestfish-actions.pod:774
6178 #, no-wrap
6179 msgid ""
6180 " config qemuparam qemuvalue\n"
6181 "\n"
6182 msgstr ""
6183
6184 #. type: textblock
6185 #: ../fish/guestfish-actions.pod:776 ../src/guestfs-actions.pod:1159
6186 msgid ""
6187 "This can be used to add arbitrary qemu command line parameters of the form "
6188 "I<-param value>.  Actually it's not quite arbitrary - we prevent you from "
6189 "setting some parameters which would interfere with parameters that we use."
6190 msgstr ""
6191
6192 #. type: textblock
6193 #: ../fish/guestfish-actions.pod:781 ../src/guestfs-actions.pod:1164
6194 msgid "The first character of C<param> string must be a C<-> (dash)."
6195 msgstr ""
6196
6197 #. type: textblock
6198 #: ../fish/guestfish-actions.pod:783 ../src/guestfs-actions.pod:1166
6199 msgid "C<value> can be NULL."
6200 msgstr ""
6201
6202 #. type: =head2
6203 #: ../fish/guestfish-actions.pod:785
6204 msgid "copy-size"
6205 msgstr ""
6206
6207 #. type: verbatim
6208 #: ../fish/guestfish-actions.pod:787
6209 #, no-wrap
6210 msgid ""
6211 " copy-size src dest size\n"
6212 "\n"
6213 msgstr ""
6214
6215 #. type: textblock
6216 #: ../fish/guestfish-actions.pod:789 ../src/guestfs-actions.pod:1180
6217 msgid ""
6218 "This command copies exactly C<size> bytes from one source device or file "
6219 "C<src> to another destination device or file C<dest>."
6220 msgstr ""
6221
6222 #. type: textblock
6223 #: ../fish/guestfish-actions.pod:792 ../src/guestfs-actions.pod:1183
6224 msgid ""
6225 "Note this will fail if the source is too short or if the destination is not "
6226 "large enough."
6227 msgstr ""
6228
6229 #. type: =head2
6230 #: ../fish/guestfish-actions.pod:795
6231 msgid "cp"
6232 msgstr "cp"
6233
6234 #. type: verbatim
6235 #: ../fish/guestfish-actions.pod:797
6236 #, no-wrap
6237 msgid ""
6238 " cp src dest\n"
6239 "\n"
6240 msgstr ""
6241
6242 #. type: textblock
6243 #: ../fish/guestfish-actions.pod:799 ../src/guestfs-actions.pod:1202
6244 msgid ""
6245 "This copies a file from C<src> to C<dest> where C<dest> is either a "
6246 "destination filename or destination directory."
6247 msgstr ""
6248
6249 #. type: =head2
6250 #: ../fish/guestfish-actions.pod:802
6251 msgid "cp-a"
6252 msgstr "cp-a"
6253
6254 #. type: verbatim
6255 #: ../fish/guestfish-actions.pod:804
6256 #, no-wrap
6257 msgid ""
6258 " cp-a src dest\n"
6259 "\n"
6260 msgstr ""
6261
6262 #. type: textblock
6263 #: ../fish/guestfish-actions.pod:806 ../src/guestfs-actions.pod:1216
6264 msgid ""
6265 "This copies a file or directory from C<src> to C<dest> recursively using the "
6266 "C<cp -a> command."
6267 msgstr ""
6268
6269 #. type: =head2
6270 #: ../fish/guestfish-actions.pod:809
6271 msgid "dd"
6272 msgstr "dd"
6273
6274 #. type: verbatim
6275 #: ../fish/guestfish-actions.pod:811
6276 #, no-wrap
6277 msgid ""
6278 " dd src dest\n"
6279 "\n"
6280 msgstr ""
6281
6282 #. type: textblock
6283 #: ../fish/guestfish-actions.pod:813 ../src/guestfs-actions.pod:1230
6284 msgid ""
6285 "This command copies from one source device or file C<src> to another "
6286 "destination device or file C<dest>.  Normally you would use this to copy to "
6287 "or from a device or partition, for example to duplicate a filesystem."
6288 msgstr ""
6289
6290 #. type: textblock
6291 #: ../fish/guestfish-actions.pod:818
6292 msgid ""
6293 "If the destination is a device, it must be as large or larger than the "
6294 "source file or device, otherwise the copy will fail.  This command cannot do "
6295 "partial copies (see L</copy-size>)."
6296 msgstr ""
6297
6298 #. type: =head2
6299 #: ../fish/guestfish-actions.pod:822
6300 msgid "df"
6301 msgstr "df"
6302
6303 #. type: verbatim
6304 #: ../fish/guestfish-actions.pod:824
6305 #, no-wrap
6306 msgid ""
6307 " df\n"
6308 "\n"
6309 msgstr ""
6310 " df\n"
6311 "\n"
6312
6313 #. type: textblock
6314 #: ../fish/guestfish-actions.pod:826 ../src/guestfs-actions.pod:1248
6315 msgid "This command runs the C<df> command to report disk space used."
6316 msgstr ""
6317
6318 #. type: textblock
6319 #: ../fish/guestfish-actions.pod:828 ../fish/guestfish-actions.pod:839
6320 msgid ""
6321 "This command is mostly useful for interactive sessions.  It is I<not> "
6322 "intended that you try to parse the output string.  Use L</statvfs> from "
6323 "programs."
6324 msgstr ""
6325
6326 #. type: =head2
6327 #: ../fish/guestfish-actions.pod:832
6328 msgid "df-h"
6329 msgstr "df-h"
6330
6331 #. type: verbatim
6332 #: ../fish/guestfish-actions.pod:834
6333 #, no-wrap
6334 msgid ""
6335 " df-h\n"
6336 "\n"
6337 msgstr ""
6338 " df-h\n"
6339 "\n"
6340
6341 #. type: textblock
6342 #: ../fish/guestfish-actions.pod:836 ../src/guestfs-actions.pod:1264
6343 msgid ""
6344 "This command runs the C<df -h> command to report disk space used in human-"
6345 "readable format."
6346 msgstr ""
6347
6348 #. type: =head2
6349 #: ../fish/guestfish-actions.pod:843
6350 msgid "dmesg"
6351 msgstr "dmesg"
6352
6353 #. type: verbatim
6354 #: ../fish/guestfish-actions.pod:845
6355 #, no-wrap
6356 msgid ""
6357 " dmesg\n"
6358 "\n"
6359 msgstr ""
6360 " dmesg\n"
6361 "\n"
6362
6363 #. type: textblock
6364 #: ../fish/guestfish-actions.pod:847 ../src/guestfs-actions.pod:1281
6365 msgid ""
6366 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
6367 "This is sometimes useful for extended debugging of problems."
6368 msgstr ""
6369
6370 #. type: textblock
6371 #: ../fish/guestfish-actions.pod:851
6372 msgid ""
6373 "Another way to get the same information is to enable verbose messages with "
6374 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
6375 "before running the program."
6376 msgstr ""
6377
6378 #. type: =head2
6379 #: ../fish/guestfish-actions.pod:856
6380 msgid "download"
6381 msgstr "download"
6382
6383 #. type: verbatim
6384 #: ../fish/guestfish-actions.pod:858
6385 #, no-wrap
6386 msgid ""
6387 " download remotefilename (filename|-)\n"
6388 "\n"
6389 msgstr ""
6390
6391 #. type: textblock
6392 #: ../fish/guestfish-actions.pod:860 ../fish/guestfish-actions.pod:873
6393 #: ../src/guestfs-actions.pod:1302 ../src/guestfs-actions.pod:1327
6394 msgid ""
6395 "Download file C<remotefilename> and save it as C<filename> on the local "
6396 "machine."
6397 msgstr ""
6398
6399 #. type: textblock
6400 #: ../fish/guestfish-actions.pod:863 ../fish/guestfish-actions.pod:4808
6401 #: ../src/guestfs-actions.pod:1305 ../src/guestfs-actions.pod:7237
6402 msgid "C<filename> can also be a named pipe."
6403 msgstr ""
6404
6405 #. type: textblock
6406 #: ../fish/guestfish-actions.pod:865
6407 msgid "See also L</upload>, L</cat>."
6408 msgstr ""
6409
6410 #. type: =head2
6411 #: ../fish/guestfish-actions.pod:869
6412 msgid "download-offset"
6413 msgstr "download-offset"
6414
6415 #. type: verbatim
6416 #: ../fish/guestfish-actions.pod:871
6417 #, no-wrap
6418 msgid ""
6419 " download-offset remotefilename (filename|-) offset size\n"
6420 "\n"
6421 msgstr ""
6422
6423 #. type: textblock
6424 #: ../fish/guestfish-actions.pod:876 ../src/guestfs-actions.pod:1330
6425 msgid ""
6426 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
6427 "region must be within the file or device)."
6428 msgstr ""
6429
6430 #. type: textblock
6431 #: ../fish/guestfish-actions.pod:879
6432 msgid ""
6433 "Note that there is no limit on the amount of data that can be downloaded "
6434 "with this call, unlike with L</pread>, and this call always reads the full "
6435 "amount unless an error occurs."
6436 msgstr ""
6437
6438 #. type: textblock
6439 #: ../fish/guestfish-actions.pod:884
6440 msgid "See also L</download>, L</pread>."
6441 msgstr ""
6442
6443 #. type: =head2
6444 #: ../fish/guestfish-actions.pod:888
6445 msgid "drop-caches"
6446 msgstr ""
6447
6448 #. type: verbatim
6449 #: ../fish/guestfish-actions.pod:890
6450 #, no-wrap
6451 msgid ""
6452 " drop-caches whattodrop\n"
6453 "\n"
6454 msgstr ""
6455
6456 #. type: textblock
6457 #: ../fish/guestfish-actions.pod:892 ../src/guestfs-actions.pod:1355
6458 msgid ""
6459 "This instructs the guest kernel to drop its page cache, and/or dentries and "
6460 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
6461 "to drop, see L<http://linux-mm.org/Drop_Caches>"
6462 msgstr ""
6463
6464 #. type: textblock
6465 #: ../fish/guestfish-actions.pod:897 ../src/guestfs-actions.pod:1360
6466 msgid "Setting C<whattodrop> to 3 should drop everything."
6467 msgstr ""
6468
6469 #. type: textblock
6470 #: ../fish/guestfish-actions.pod:899 ../src/guestfs-actions.pod:1362
6471 msgid ""
6472 "This automatically calls L<sync(2)> before the operation, so that the "
6473 "maximum guest memory is freed."
6474 msgstr ""
6475
6476 #. type: =head2
6477 #: ../fish/guestfish-actions.pod:902
6478 msgid "du"
6479 msgstr "du"
6480
6481 #. type: verbatim
6482 #: ../fish/guestfish-actions.pod:904
6483 #, no-wrap
6484 msgid ""
6485 " du path\n"
6486 "\n"
6487 msgstr ""
6488 " du шлях\n"
6489 "\n"
6490
6491 #. type: textblock
6492 #: ../fish/guestfish-actions.pod:906 ../src/guestfs-actions.pod:1375
6493 msgid ""
6494 "This command runs the C<du -s> command to estimate file space usage for "
6495 "C<path>."
6496 msgstr ""
6497
6498 #. type: textblock
6499 #: ../fish/guestfish-actions.pod:909 ../src/guestfs-actions.pod:1378
6500 msgid ""
6501 "C<path> can be a file or a directory.  If C<path> is a directory then the "
6502 "estimate includes the contents of the directory and all subdirectories "
6503 "(recursively)."
6504 msgstr ""
6505
6506 #. type: textblock
6507 #: ../fish/guestfish-actions.pod:913 ../src/guestfs-actions.pod:1382
6508 msgid ""
6509 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
6510 msgstr ""
6511
6512 #. type: =head2
6513 #: ../fish/guestfish-actions.pod:916
6514 msgid "e2fsck-f"
6515 msgstr "e2fsck-f"
6516
6517 #. type: verbatim
6518 #: ../fish/guestfish-actions.pod:918
6519 #, no-wrap
6520 msgid ""
6521 " e2fsck-f device\n"
6522 "\n"
6523 msgstr ""
6524
6525 #. type: textblock
6526 #: ../fish/guestfish-actions.pod:920 ../src/guestfs-actions.pod:1400
6527 msgid ""
6528 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
6529 "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
6530 "clean (I<-f>)."
6531 msgstr ""
6532
6533 #. type: textblock
6534 #: ../fish/guestfish-actions.pod:924
6535 msgid ""
6536 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
6537 "should use L</fsck>."
6538 msgstr ""
6539
6540 #. type: =head2
6541 #: ../fish/guestfish-actions.pod:927
6542 msgid "echo-daemon"
6543 msgstr ""
6544
6545 #. type: verbatim
6546 #: ../fish/guestfish-actions.pod:929
6547 #, no-wrap
6548 msgid ""
6549 " echo-daemon 'words ...'\n"
6550 "\n"
6551 msgstr ""
6552
6553 #. type: textblock
6554 #: ../fish/guestfish-actions.pod:931 ../src/guestfs-actions.pod:1417
6555 msgid ""
6556 "This command concatenates the list of C<words> passed with single spaces "
6557 "between them and returns the resulting string."
6558 msgstr ""
6559
6560 #. type: textblock
6561 #: ../fish/guestfish-actions.pod:934 ../src/guestfs-actions.pod:1420
6562 msgid "You can use this command to test the connection through to the daemon."
6563 msgstr ""
6564
6565 #. type: textblock
6566 #: ../fish/guestfish-actions.pod:936
6567 msgid "See also L</ping-daemon>."
6568 msgstr ""
6569
6570 #. type: =head2
6571 #: ../fish/guestfish-actions.pod:938
6572 msgid "egrep"
6573 msgstr "egrep"
6574
6575 #. type: verbatim
6576 #: ../fish/guestfish-actions.pod:940
6577 #, no-wrap
6578 msgid ""
6579 " egrep regex path\n"
6580 "\n"
6581 msgstr ""
6582
6583 #. type: textblock
6584 #: ../fish/guestfish-actions.pod:942 ../src/guestfs-actions.pod:1436
6585 msgid ""
6586 "This calls the external C<egrep> program and returns the matching lines."
6587 msgstr ""
6588
6589 #. type: =head2
6590 #: ../fish/guestfish-actions.pod:948
6591 msgid "egrepi"
6592 msgstr "egrepi"
6593
6594 #. type: verbatim
6595 #: ../fish/guestfish-actions.pod:950
6596 #, no-wrap
6597 msgid ""
6598 " egrepi regex path\n"
6599 "\n"
6600 msgstr ""
6601
6602 #. type: textblock
6603 #: ../fish/guestfish-actions.pod:952 ../src/guestfs-actions.pod:1455
6604 msgid ""
6605 "This calls the external C<egrep -i> program and returns the matching lines."
6606 msgstr ""
6607
6608 #. type: =head2
6609 #: ../fish/guestfish-actions.pod:958
6610 msgid "equal"
6611 msgstr "equal"
6612
6613 #. type: verbatim
6614 #: ../fish/guestfish-actions.pod:960
6615 #, no-wrap
6616 msgid ""
6617 " equal file1 file2\n"
6618 "\n"
6619 msgstr ""
6620 " equal файл1 файл2\n"
6621 "\n"
6622
6623 #. type: textblock
6624 #: ../fish/guestfish-actions.pod:962 ../src/guestfs-actions.pod:1474
6625 msgid ""
6626 "This compares the two files C<file1> and C<file2> and returns true if their "
6627 "content is exactly equal, or false otherwise."
6628 msgstr ""
6629
6630 #. type: textblock
6631 #: ../fish/guestfish-actions.pod:965 ../src/guestfs-actions.pod:1477
6632 msgid "The external L<cmp(1)> program is used for the comparison."
6633 msgstr ""
6634
6635 #. type: =head2
6636 #: ../fish/guestfish-actions.pod:967
6637 msgid "exists"
6638 msgstr "exists"
6639
6640 #. type: verbatim
6641 #: ../fish/guestfish-actions.pod:969
6642 #, no-wrap
6643 msgid ""
6644 " exists path\n"
6645 "\n"
6646 msgstr ""
6647 " exists шлях\n"
6648 "\n"
6649
6650 #. type: textblock
6651 #: ../fish/guestfish-actions.pod:971 ../src/guestfs-actions.pod:1489
6652 msgid ""
6653 "This returns C<true> if and only if there is a file, directory (or anything) "
6654 "with the given C<path> name."
6655 msgstr ""
6656
6657 #. type: textblock
6658 #: ../fish/guestfish-actions.pod:974
6659 msgid "See also L</is-file>, L</is-dir>, L</stat>."
6660 msgstr "Див. також L</is-file>, L</is-dir>, L</stat>."
6661
6662 #. type: =head2
6663 #: ../fish/guestfish-actions.pod:976
6664 msgid "fallocate"
6665 msgstr "fallocate"
6666
6667 #. type: verbatim
6668 #: ../fish/guestfish-actions.pod:978
6669 #, no-wrap
6670 msgid ""
6671 " fallocate path len\n"
6672 "\n"
6673 msgstr ""
6674 " fallocate шлях довжина\n"
6675 "\n"
6676
6677 #. type: textblock
6678 #: ../fish/guestfish-actions.pod:980 ../fish/guestfish-actions.pod:999
6679 #: ../src/guestfs-actions.pod:1505 ../src/guestfs-actions.pod:1531
6680 msgid ""
6681 "This command preallocates a file (containing zero bytes) named C<path> of "
6682 "size C<len> bytes.  If the file exists already, it is overwritten."
6683 msgstr ""
6684
6685 #. type: textblock
6686 #: ../fish/guestfish-actions.pod:984 ../src/guestfs-actions.pod:1509
6687 msgid ""
6688 "Do not confuse this with the guestfish-specific C<alloc> command which "
6689 "allocates a file in the host and attaches it as a device."
6690 msgstr ""
6691
6692 #. type: textblock
6693 #: ../fish/guestfish-actions.pod:988
6694 msgid ""
6695 "This function is deprecated.  In new code, use the L</fallocate64> call "
6696 "instead."
6697 msgstr ""
6698
6699 #. type: =head2
6700 #: ../fish/guestfish-actions.pod:995
6701 msgid "fallocate64"
6702 msgstr "fallocate64"
6703
6704 #. type: verbatim
6705 #: ../fish/guestfish-actions.pod:997
6706 #, no-wrap
6707 msgid ""
6708 " fallocate64 path len\n"
6709 "\n"
6710 msgstr ""
6711 " fallocate64 шлях довжина\n"
6712 "\n"
6713
6714 #. type: textblock
6715 #: ../fish/guestfish-actions.pod:1003
6716 msgid ""
6717 "Note that this call allocates disk blocks for the file.  To create a sparse "
6718 "file use L</truncate-size> instead."
6719 msgstr ""
6720
6721 #. type: textblock
6722 #: ../fish/guestfish-actions.pod:1006
6723 msgid ""
6724 "The deprecated call L</fallocate> does the same, but owing to an oversight "
6725 "it only allowed 30 bit lengths to be specified, effectively limiting the "
6726 "maximum size of files created through that call to 1GB."
6727 msgstr ""
6728
6729 #. type: textblock
6730 #: ../fish/guestfish-actions.pod:1011 ../src/guestfs-actions.pod:1543
6731 msgid ""
6732 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
6733 "commands which create a file in the host and attach it as a device."
6734 msgstr ""
6735
6736 #. type: =head2
6737 #: ../fish/guestfish-actions.pod:1015
6738 msgid "fgrep"
6739 msgstr "fgrep"
6740
6741 #. type: verbatim
6742 #: ../fish/guestfish-actions.pod:1017
6743 #, no-wrap
6744 msgid ""
6745 " fgrep pattern path\n"
6746 "\n"
6747 msgstr ""
6748 " fgrep шаблон шлях\n"
6749 "\n"
6750
6751 #. type: textblock
6752 #: ../fish/guestfish-actions.pod:1019 ../src/guestfs-actions.pod:1558
6753 msgid ""
6754 "This calls the external C<fgrep> program and returns the matching lines."
6755 msgstr ""
6756
6757 #. type: =head2
6758 #: ../fish/guestfish-actions.pod:1025
6759 msgid "fgrepi"
6760 msgstr "fgrepi"
6761
6762 #. type: verbatim
6763 #: ../fish/guestfish-actions.pod:1027
6764 #, no-wrap
6765 msgid ""
6766 " fgrepi pattern path\n"
6767 "\n"
6768 msgstr ""
6769 " fgrepi шаблон шлях\n"
6770 "\n"
6771
6772 #. type: textblock
6773 #: ../fish/guestfish-actions.pod:1029 ../src/guestfs-actions.pod:1577
6774 msgid ""
6775 "This calls the external C<fgrep -i> program and returns the matching lines."
6776 msgstr ""
6777
6778 #. type: =head2
6779 #: ../fish/guestfish-actions.pod:1035
6780 msgid "file"
6781 msgstr "file"
6782
6783 #. type: verbatim
6784 #: ../fish/guestfish-actions.pod:1037
6785 #, no-wrap
6786 msgid ""
6787 " file path\n"
6788 "\n"
6789 msgstr ""
6790 " file шлях\n"
6791 "\n"
6792
6793 #. type: textblock
6794 #: ../fish/guestfish-actions.pod:1039 ../src/guestfs-actions.pod:1595
6795 msgid ""
6796 "This call uses the standard L<file(1)> command to determine the type or "
6797 "contents of the file."
6798 msgstr ""
6799
6800 #. type: textblock
6801 #: ../fish/guestfish-actions.pod:1042 ../src/guestfs-actions.pod:1598
6802 msgid ""
6803 "This call will also transparently look inside various types of compressed "
6804 "file."
6805 msgstr ""
6806
6807 #. type: textblock
6808 #: ../fish/guestfish-actions.pod:1045 ../src/guestfs-actions.pod:1601
6809 msgid ""
6810 "The exact command which runs is C<file -zb path>.  Note in particular that "
6811 "the filename is not prepended to the output (the I<-b> option)."
6812 msgstr ""
6813
6814 #. type: textblock
6815 #: ../fish/guestfish-actions.pod:1049 ../src/guestfs-actions.pod:1605
6816 msgid ""
6817 "The output depends on the output of the underlying L<file(1)> command and it "
6818 "can change in future in ways beyond our control.  In other words, the output "
6819 "is not guaranteed by the ABI."
6820 msgstr ""
6821
6822 #. type: textblock
6823 #: ../fish/guestfish-actions.pod:1053
6824 msgid ""
6825 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
6826 "(etc), L</is-zero>."
6827 msgstr ""
6828
6829 #. type: =head2
6830 #: ../fish/guestfish-actions.pod:1056
6831 msgid "file-architecture"
6832 msgstr "file-architecture"
6833
6834 #. type: verbatim
6835 #: ../fish/guestfish-actions.pod:1058
6836 #, no-wrap
6837 msgid ""
6838 " file-architecture filename\n"
6839 "\n"
6840 msgstr ""
6841 " file-architecture назва_файла\n"
6842 "\n"
6843
6844 #. type: textblock
6845 #: ../fish/guestfish-actions.pod:1060 ../src/guestfs-actions.pod:1623
6846 msgid ""
6847 "This detects the architecture of the binary C<filename>, and returns it if "
6848 "known."
6849 msgstr ""
6850
6851 #. type: textblock
6852 #: ../fish/guestfish-actions.pod:1063 ../src/guestfs-actions.pod:1626
6853 msgid "Currently defined architectures are:"
6854 msgstr ""
6855
6856 #. type: =item
6857 #: ../fish/guestfish-actions.pod:1067 ../src/guestfs-actions.pod:1630
6858 msgid "\"i386\""
6859 msgstr "\"i386\""
6860
6861 #. type: textblock
6862 #: ../fish/guestfish-actions.pod:1069 ../src/guestfs-actions.pod:1632
6863 msgid ""
6864 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
6865 "irrespective of the precise processor requirements of the binary."
6866 msgstr ""
6867
6868 #. type: =item
6869 #: ../fish/guestfish-actions.pod:1072 ../src/guestfs-actions.pod:1635
6870 msgid "\"x86_64\""
6871 msgstr "\"x86_64\""
6872
6873 #. type: textblock
6874 #: ../fish/guestfish-actions.pod:1074 ../src/guestfs-actions.pod:1637
6875 msgid "64 bit x86-64."
6876 msgstr ""
6877
6878 #. type: =item
6879 #: ../fish/guestfish-actions.pod:1076 ../src/guestfs-actions.pod:1639
6880 msgid "\"sparc\""
6881 msgstr ""
6882
6883 #. type: textblock
6884 #: ../fish/guestfish-actions.pod:1078 ../src/guestfs-actions.pod:1641
6885 msgid "32 bit SPARC."
6886 msgstr ""
6887
6888 #. type: =item
6889 #: ../fish/guestfish-actions.pod:1080 ../src/guestfs-actions.pod:1643
6890 msgid "\"sparc64\""
6891 msgstr ""
6892
6893 #. type: textblock
6894 #: ../fish/guestfish-actions.pod:1082 ../src/guestfs-actions.pod:1645
6895 msgid "64 bit SPARC V9 and above."
6896 msgstr ""
6897
6898 #. type: =item
6899 #: ../fish/guestfish-actions.pod:1084 ../src/guestfs-actions.pod:1647
6900 msgid "\"ia64\""
6901 msgstr "\"ia64\""
6902
6903 #. type: textblock
6904 #: ../fish/guestfish-actions.pod:1086 ../src/guestfs-actions.pod:1649
6905 msgid "Intel Itanium."
6906 msgstr "Intel Itanium."
6907
6908 #. type: =item
6909 #: ../fish/guestfish-actions.pod:1088 ../src/guestfs-actions.pod:1651
6910 msgid "\"ppc\""
6911 msgstr ""
6912
6913 #. type: textblock
6914 #: ../fish/guestfish-actions.pod:1090 ../src/guestfs-actions.pod:1653
6915 msgid "32 bit Power PC."
6916 msgstr ""
6917
6918 #. type: =item
6919 #: ../fish/guestfish-actions.pod:1092 ../src/guestfs-actions.pod:1655
6920 msgid "\"ppc64\""
6921 msgstr ""
6922
6923 #. type: textblock
6924 #: ../fish/guestfish-actions.pod:1094 ../src/guestfs-actions.pod:1657
6925 msgid "64 bit Power PC."
6926 msgstr ""
6927
6928 #. type: textblock
6929 #: ../fish/guestfish-actions.pod:1098 ../src/guestfs-actions.pod:1661
6930 msgid "Libguestfs may return other architecture strings in future."
6931 msgstr ""
6932
6933 #. type: textblock
6934 #: ../fish/guestfish-actions.pod:1100 ../src/guestfs-actions.pod:1663
6935 msgid "The function works on at least the following types of files:"
6936 msgstr ""
6937
6938 #. type: textblock
6939 #: ../fish/guestfish-actions.pod:1106 ../src/guestfs-actions.pod:1669
6940 msgid "many types of Un*x and Linux binary"
6941 msgstr ""
6942
6943 #. type: textblock
6944 #: ../fish/guestfish-actions.pod:1110 ../src/guestfs-actions.pod:1673
6945 msgid "many types of Un*x and Linux shared library"
6946 msgstr ""
6947
6948 #. type: textblock
6949 #: ../fish/guestfish-actions.pod:1114 ../src/guestfs-actions.pod:1677
6950 msgid "Windows Win32 and Win64 binaries"
6951 msgstr ""
6952
6953 #. type: textblock
6954 #: ../fish/guestfish-actions.pod:1118 ../src/guestfs-actions.pod:1681
6955 msgid "Windows Win32 and Win64 DLLs"
6956 msgstr ""
6957
6958 #. type: textblock
6959 #: ../fish/guestfish-actions.pod:1120 ../src/guestfs-actions.pod:1683
6960 msgid "Win32 binaries and DLLs return C<i386>."
6961 msgstr ""
6962
6963 #. type: textblock
6964 #: ../fish/guestfish-actions.pod:1122 ../src/guestfs-actions.pod:1685
6965 msgid "Win64 binaries and DLLs return C<x86_64>."
6966 msgstr ""
6967
6968 #. type: textblock
6969 #: ../fish/guestfish-actions.pod:1126 ../src/guestfs-actions.pod:1689
6970 msgid "Linux kernel modules"
6971 msgstr ""
6972
6973 #. type: textblock
6974 #: ../fish/guestfish-actions.pod:1130 ../src/guestfs-actions.pod:1693
6975 msgid "Linux new-style initrd images"
6976 msgstr ""
6977
6978 #. type: textblock
6979 #: ../fish/guestfish-actions.pod:1134 ../src/guestfs-actions.pod:1697
6980 msgid "some non-x86 Linux vmlinuz kernels"
6981 msgstr ""
6982
6983 #. type: textblock
6984 #: ../fish/guestfish-actions.pod:1138 ../src/guestfs-actions.pod:1701
6985 msgid "What it can't do currently:"
6986 msgstr ""
6987
6988 #. type: textblock
6989 #: ../fish/guestfish-actions.pod:1144 ../src/guestfs-actions.pod:1707
6990 msgid "static libraries (libfoo.a)"
6991 msgstr ""
6992
6993 #. type: textblock
6994 #: ../fish/guestfish-actions.pod:1148 ../src/guestfs-actions.pod:1711
6995 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
6996 msgstr ""
6997
6998 #. type: textblock
6999 #: ../fish/guestfish-actions.pod:1152 ../src/guestfs-actions.pod:1715
7000 msgid "x86 Linux vmlinuz kernels"
7001 msgstr ""
7002
7003 #. type: textblock
7004 #: ../fish/guestfish-actions.pod:1154 ../src/guestfs-actions.pod:1717
7005 msgid ""
7006 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
7007 "compressed code, and are horribly hard to unpack.  If you want to find the "
7008 "architecture of a kernel, use the architecture of the associated initrd or "
7009 "kernel module(s) instead."
7010 msgstr ""
7011
7012 #. type: =head2
7013 #: ../fish/guestfish-actions.pod:1161
7014 msgid "filesize"
7015 msgstr "filesize"
7016
7017 #. type: verbatim
7018 #: ../fish/guestfish-actions.pod:1163
7019 #, no-wrap
7020 msgid ""
7021 " filesize file\n"
7022 "\n"
7023 msgstr ""
7024 " filesize файл\n"
7025 "\n"
7026
7027 #. type: textblock
7028 #: ../fish/guestfish-actions.pod:1165 ../src/guestfs-actions.pod:1735
7029 msgid "This command returns the size of C<file> in bytes."
7030 msgstr ""
7031
7032 #. type: textblock
7033 #: ../fish/guestfish-actions.pod:1167
7034 msgid ""
7035 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
7036 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
7037 msgstr ""
7038
7039 #. type: =head2
7040 #: ../fish/guestfish-actions.pod:1171
7041 msgid "fill"
7042 msgstr "fill"
7043
7044 #. type: verbatim
7045 #: ../fish/guestfish-actions.pod:1173
7046 #, no-wrap
7047 msgid ""
7048 " fill c len path\n"
7049 "\n"
7050 msgstr ""
7051
7052 #. type: textblock
7053 #: ../fish/guestfish-actions.pod:1175 ../src/guestfs-actions.pod:1753
7054 msgid ""
7055 "This command creates a new file called C<path>.  The initial content of the "
7056 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
7057 "[0..255]>."
7058 msgstr ""
7059
7060 #. type: textblock
7061 #: ../fish/guestfish-actions.pod:1179
7062 msgid ""
7063 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
7064 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
7065 "L</fill-pattern>."
7066 msgstr ""
7067
7068 #. type: =head2
7069 #: ../fish/guestfish-actions.pod:1184
7070 msgid "fill-pattern"
7071 msgstr "fill-pattern"
7072
7073 #. type: verbatim
7074 #: ../fish/guestfish-actions.pod:1186
7075 #, no-wrap
7076 msgid ""
7077 " fill-pattern pattern len path\n"
7078 "\n"
7079 msgstr ""
7080
7081 #. type: textblock
7082 #: ../fish/guestfish-actions.pod:1188
7083 msgid ""
7084 "This function is like L</fill> except that it creates a new file of length "
7085 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
7086 "is truncated if necessary to ensure the length of the file is exactly C<len> "
7087 "bytes."
7088 msgstr ""
7089
7090 #. type: =head2
7091 #: ../fish/guestfish-actions.pod:1193
7092 msgid "find"
7093 msgstr "find"
7094
7095 #. type: verbatim
7096 #: ../fish/guestfish-actions.pod:1195
7097 #, no-wrap
7098 msgid ""
7099 " find directory\n"
7100 "\n"
7101 msgstr ""
7102 " find каталог\n"
7103 "\n"
7104
7105 #. type: textblock
7106 #: ../fish/guestfish-actions.pod:1197 ../src/guestfs-actions.pod:1799
7107 msgid ""
7108 "This command lists out all files and directories, recursively, starting at "
7109 "C<directory>.  It is essentially equivalent to running the shell command "
7110 "C<find directory -print> but some post-processing happens on the output, "
7111 "described below."
7112 msgstr ""
7113
7114 #. type: textblock
7115 #: ../fish/guestfish-actions.pod:1202 ../src/guestfs-actions.pod:1804
7116 msgid ""
7117 "This returns a list of strings I<without any prefix>.  Thus if the directory "
7118 "structure was:"
7119 msgstr ""
7120
7121 #. type: verbatim
7122 #: ../fish/guestfish-actions.pod:1205 ../src/guestfs-actions.pod:1807
7123 #, no-wrap
7124 msgid ""
7125 " /tmp/a\n"
7126 " /tmp/b\n"
7127 " /tmp/c/d\n"
7128 "\n"
7129 msgstr ""
7130
7131 #. type: textblock
7132 #: ../fish/guestfish-actions.pod:1209
7133 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
7134 msgstr ""
7135
7136 #. type: verbatim
7137 #: ../fish/guestfish-actions.pod:1212 ../src/guestfs-actions.pod:1814
7138 #, no-wrap
7139 msgid ""
7140 " a\n"
7141 " b\n"
7142 " c\n"
7143 " c/d\n"
7144 "\n"
7145 msgstr ""
7146
7147 #. type: textblock
7148 #: ../fish/guestfish-actions.pod:1217 ../src/guestfs-actions.pod:1819
7149 msgid "If C<directory> is not a directory, then this command returns an error."
7150 msgstr ""
7151
7152 #. type: textblock
7153 #: ../fish/guestfish-actions.pod:1220 ../src/guestfs-actions.pod:1822
7154 msgid "The returned list is sorted."
7155 msgstr ""
7156
7157 #. type: textblock
7158 #: ../fish/guestfish-actions.pod:1222
7159 msgid "See also L</find0>."
7160 msgstr "Див. також L</find0>."
7161
7162 #. type: =head2
7163 #: ../fish/guestfish-actions.pod:1227
7164 msgid "find0"
7165 msgstr "find0"
7166
7167 #. type: verbatim
7168 #: ../fish/guestfish-actions.pod:1229
7169 #, no-wrap
7170 msgid ""
7171 " find0 directory (files|-)\n"
7172 "\n"
7173 msgstr ""
7174 " find0 каталог (файли|-)\n"
7175 "\n"
7176
7177 #. type: textblock
7178 #: ../fish/guestfish-actions.pod:1231 ../src/guestfs-actions.pod:1842
7179 msgid ""
7180 "This command lists out all files and directories, recursively, starting at "
7181 "C<directory>, placing the resulting list in the external file called "
7182 "C<files>."
7183 msgstr ""
7184
7185 #. type: textblock
7186 #: ../fish/guestfish-actions.pod:1235
7187 msgid ""
7188 "This command works the same way as L</find> with the following exceptions:"
7189 msgstr ""
7190
7191 #. type: textblock
7192 #: ../fish/guestfish-actions.pod:1242 ../src/guestfs-actions.pod:1853
7193 msgid "The resulting list is written to an external file."
7194 msgstr ""
7195
7196 #. type: textblock
7197 #: ../fish/guestfish-actions.pod:1246 ../src/guestfs-actions.pod:1857
7198 msgid ""
7199 "Items (filenames) in the result are separated by C<\\0> characters.  See "
7200 "L<find(1)> option I<-print0>."
7201 msgstr ""
7202
7203 #. type: textblock
7204 #: ../fish/guestfish-actions.pod:1251 ../src/guestfs-actions.pod:1862
7205 msgid "This command is not limited in the number of names that it can return."
7206 msgstr ""
7207
7208 #. type: textblock
7209 #: ../fish/guestfish-actions.pod:1256 ../src/guestfs-actions.pod:1867
7210 msgid "The result list is not sorted."
7211 msgstr ""
7212
7213 #. type: =head2
7214 #: ../fish/guestfish-actions.pod:1262
7215 msgid "findfs-label"
7216 msgstr "findfs-label"
7217
7218 #. type: verbatim
7219 #: ../fish/guestfish-actions.pod:1264
7220 #, no-wrap
7221 msgid ""
7222 " findfs-label label\n"
7223 "\n"
7224 msgstr ""
7225 " findfs-label мітка\n"
7226 "\n"
7227
7228 #. type: textblock
7229 #: ../fish/guestfish-actions.pod:1266 ../src/guestfs-actions.pod:1881
7230 msgid ""
7231 "This command searches the filesystems and returns the one which has the "
7232 "given label.  An error is returned if no such filesystem can be found."
7233 msgstr ""
7234
7235 #. type: textblock
7236 #: ../fish/guestfish-actions.pod:1270
7237 msgid "To find the label of a filesystem, use L</vfs-label>."
7238 msgstr "Для визначення мітки файлової системи скористайтеся L</vfs-label>."
7239
7240 #. type: =head2
7241 #: ../fish/guestfish-actions.pod:1272
7242 msgid "findfs-uuid"
7243 msgstr "findfs-uuid"
7244
7245 #. type: verbatim
7246 #: ../fish/guestfish-actions.pod:1274
7247 #, no-wrap
7248 msgid ""
7249 " findfs-uuid uuid\n"
7250 "\n"
7251 msgstr ""
7252 " findfs-uuid uuid\n"
7253 "\n"
7254
7255 #. type: textblock
7256 #: ../fish/guestfish-actions.pod:1276 ../src/guestfs-actions.pod:1898
7257 msgid ""
7258 "This command searches the filesystems and returns the one which has the "
7259 "given UUID.  An error is returned if no such filesystem can be found."
7260 msgstr ""
7261
7262 #. type: textblock
7263 #: ../fish/guestfish-actions.pod:1280
7264 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
7265 msgstr "Для визначення UUID файлової системи скористайтеся L</vfs-uuid>."
7266
7267 #. type: =head2
7268 #: ../fish/guestfish-actions.pod:1282
7269 msgid "fsck"
7270 msgstr "fsck"
7271
7272 #. type: verbatim
7273 #: ../fish/guestfish-actions.pod:1284
7274 #, no-wrap
7275 msgid ""
7276 " fsck fstype device\n"
7277 "\n"
7278 msgstr ""
7279 " fsck тип_файлової_системи пристрій\n"
7280 "\n"
7281
7282 #. type: textblock
7283 #: ../fish/guestfish-actions.pod:1286 ../src/guestfs-actions.pod:1916
7284 msgid ""
7285 "This runs the filesystem checker (fsck) on C<device> which should have "
7286 "filesystem type C<fstype>."
7287 msgstr ""
7288
7289 #. type: textblock
7290 #: ../fish/guestfish-actions.pod:1289 ../src/guestfs-actions.pod:1919
7291 msgid ""
7292 "The returned integer is the status.  See L<fsck(8)> for the list of status "
7293 "codes from C<fsck>."
7294 msgstr ""
7295
7296 #. type: textblock
7297 #: ../fish/guestfish-actions.pod:1298 ../src/guestfs-actions.pod:1928
7298 msgid "Multiple status codes can be summed together."
7299 msgstr ""
7300
7301 #. type: textblock
7302 #: ../fish/guestfish-actions.pod:1302 ../src/guestfs-actions.pod:1932
7303 msgid ""
7304 "A non-zero return code can mean \"success\", for example if errors have been "
7305 "corrected on the filesystem."
7306 msgstr ""
7307
7308 #. type: textblock
7309 #: ../fish/guestfish-actions.pod:1307 ../src/guestfs-actions.pod:1937
7310 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
7311 msgstr ""
7312
7313 #. type: textblock
7314 #: ../fish/guestfish-actions.pod:1312 ../src/guestfs-actions.pod:1942
7315 msgid ""
7316 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
7317 msgstr ""
7318
7319 #. type: =head2
7320 #: ../fish/guestfish-actions.pod:1314
7321 msgid "get-append"
7322 msgstr "get-append"
7323
7324 #. type: verbatim
7325 #: ../fish/guestfish-actions.pod:1316
7326 #, no-wrap
7327 msgid ""
7328 " get-append\n"
7329 "\n"
7330 msgstr ""
7331 " get-append\n"
7332 "\n"
7333
7334 #. type: textblock
7335 #: ../fish/guestfish-actions.pod:1318 ../src/guestfs-actions.pod:1953
7336 msgid ""
7337 "Return the additional kernel options which are added to the guest kernel "
7338 "command line."
7339 msgstr ""
7340
7341 #. type: textblock
7342 #: ../fish/guestfish-actions.pod:1321 ../src/guestfs-actions.pod:1956
7343 msgid "If C<NULL> then no options are added."
7344 msgstr ""
7345
7346 #. type: =head2
7347 #: ../fish/guestfish-actions.pod:1323
7348 msgid "get-attach-method"
7349 msgstr "get-attach-method"
7350
7351 #. type: verbatim
7352 #: ../fish/guestfish-actions.pod:1325
7353 #, no-wrap
7354 msgid ""
7355 " get-attach-method\n"
7356 "\n"
7357 msgstr ""
7358 " get-attach-method\n"
7359 "\n"
7360
7361 #. type: textblock
7362 #: ../fish/guestfish-actions.pod:1327
7363 msgid "Return the current attach method.  See L</set-attach-method>."
7364 msgstr ""
7365
7366 #. type: =head2
7367 #: ../fish/guestfish-actions.pod:1329
7368 msgid "get-autosync"
7369 msgstr "get-autosync"
7370
7371 #. type: verbatim
7372 #: ../fish/guestfish-actions.pod:1331
7373 #, no-wrap
7374 msgid ""
7375 " get-autosync\n"
7376 "\n"
7377 msgstr ""
7378 " get-autosync\n"
7379 "\n"
7380
7381 #. type: textblock
7382 #: ../fish/guestfish-actions.pod:1333 ../src/guestfs-actions.pod:1981
7383 msgid "Get the autosync flag."
7384 msgstr ""
7385
7386 #. type: =head2
7387 #: ../fish/guestfish-actions.pod:1335
7388 msgid "get-direct"
7389 msgstr "get-direct"
7390
7391 #. type: verbatim
7392 #: ../fish/guestfish-actions.pod:1337
7393 #, no-wrap
7394 msgid ""
7395 " get-direct\n"
7396 "\n"
7397 msgstr ""
7398 " get-direct\n"
7399 "\n"
7400
7401 #. type: textblock
7402 #: ../fish/guestfish-actions.pod:1339 ../src/guestfs-actions.pod:1992
7403 msgid "Return the direct appliance mode flag."
7404 msgstr ""
7405
7406 #. type: =head2
7407 #: ../fish/guestfish-actions.pod:1341
7408 msgid "get-e2label"
7409 msgstr "get-e2label"
7410
7411 #. type: verbatim
7412 #: ../fish/guestfish-actions.pod:1343
7413 #, no-wrap
7414 msgid ""
7415 " get-e2label device\n"
7416 "\n"
7417 msgstr ""
7418 " get-e2label пристрій\n"
7419 "\n"
7420
7421 #. type: textblock
7422 #: ../fish/guestfish-actions.pod:1345 ../src/guestfs-actions.pod:2004
7423 msgid ""
7424 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
7425 msgstr ""
7426
7427 #. type: textblock
7428 #: ../fish/guestfish-actions.pod:1348
7429 msgid ""
7430 "This function is deprecated.  In new code, use the L</vfs_label> call "
7431 "instead."
7432 msgstr ""
7433
7434 #. type: =head2
7435 #: ../fish/guestfish-actions.pod:1355
7436 msgid "get-e2uuid"
7437 msgstr "get-e2uuid"
7438
7439 #. type: verbatim
7440 #: ../fish/guestfish-actions.pod:1357
7441 #, no-wrap
7442 msgid ""
7443 " get-e2uuid device\n"
7444 "\n"
7445 msgstr ""
7446 " get-e2uuid пристрій\n"
7447 "\n"
7448
7449 #. type: textblock
7450 #: ../fish/guestfish-actions.pod:1359 ../src/guestfs-actions.pod:2025
7451 msgid ""
7452 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
7453 msgstr ""
7454
7455 #. type: textblock
7456 #: ../fish/guestfish-actions.pod:1362
7457 msgid ""
7458 "This function is deprecated.  In new code, use the L</vfs_uuid> call instead."
7459 msgstr ""
7460
7461 #. type: =head2
7462 #: ../fish/guestfish-actions.pod:1369
7463 msgid "get-memsize"
7464 msgstr "get-memsize"
7465
7466 #. type: verbatim
7467 #: ../fish/guestfish-actions.pod:1371
7468 #, no-wrap
7469 msgid ""
7470 " get-memsize\n"
7471 "\n"
7472 msgstr ""
7473 " get-memsize\n"
7474 "\n"
7475
7476 #. type: textblock
7477 #: ../fish/guestfish-actions.pod:1373 ../src/guestfs-actions.pod:2045
7478 msgid ""
7479 "This gets the memory size in megabytes allocated to the qemu subprocess."
7480 msgstr ""
7481
7482 #. type: textblock
7483 #: ../fish/guestfish-actions.pod:1376
7484 msgid ""
7485 "If L</set-memsize> was not called on this handle, and if "
7486 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
7487 "value for memsize."
7488 msgstr ""
7489
7490 #. type: textblock
7491 #: ../fish/guestfish-actions.pod:1380 ../fish/guestfish-actions.pod:1437
7492 #: ../fish/guestfish-actions.pod:4168 ../fish/guestfish-actions.pod:4270
7493 #: ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2144
7494 #: ../src/guestfs-actions.pod:6298 ../src/guestfs-actions.pod:6424
7495 msgid ""
7496 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
7497 msgstr ""
7498
7499 #. type: =head2
7500 #: ../fish/guestfish-actions.pod:1383
7501 msgid "get-network"
7502 msgstr "get-network"
7503
7504 #. type: verbatim
7505 #: ../fish/guestfish-actions.pod:1385
7506 #, no-wrap
7507 msgid ""
7508 " get-network\n"
7509 "\n"
7510 msgstr ""
7511 " get-network\n"
7512 "\n"
7513
7514 #. type: textblock
7515 #: ../fish/guestfish-actions.pod:1387 ../src/guestfs-actions.pod:2064
7516 msgid "This returns the enable network flag."
7517 msgstr ""
7518
7519 #. type: =head2
7520 #: ../fish/guestfish-actions.pod:1389
7521 msgid "get-path"
7522 msgstr "get-path"
7523
7524 #. type: verbatim
7525 #: ../fish/guestfish-actions.pod:1391
7526 #, no-wrap
7527 msgid ""
7528 " get-path\n"
7529 "\n"
7530 msgstr ""
7531 " get-path\n"
7532 "\n"
7533
7534 #. type: textblock
7535 #: ../fish/guestfish-actions.pod:1393 ../src/guestfs-actions.pod:2075
7536 msgid "Return the current search path."
7537 msgstr ""
7538
7539 #. type: textblock
7540 #: ../fish/guestfish-actions.pod:1395 ../src/guestfs-actions.pod:2077
7541 msgid ""
7542 "This is always non-NULL.  If it wasn't set already, then this will return "
7543 "the default path."
7544 msgstr ""
7545
7546 #. type: =head2
7547 #: ../fish/guestfish-actions.pod:1398
7548 msgid "get-pgroup"
7549 msgstr ""
7550
7551 #. type: verbatim
7552 #: ../fish/guestfish-actions.pod:1400
7553 #, no-wrap
7554 msgid ""
7555 " get-pgroup\n"
7556 "\n"
7557 msgstr ""
7558
7559 #. type: textblock
7560 #: ../fish/guestfish-actions.pod:1402 ../src/guestfs-actions.pod:2090
7561 msgid "This returns the process group flag."
7562 msgstr ""
7563
7564 #. type: =head2
7565 #: ../fish/guestfish-actions.pod:1404
7566 msgid "get-pid"
7567 msgstr "get-pid"
7568
7569 #. type: =head2
7570 #: ../fish/guestfish-actions.pod:1406
7571 msgid "pid"
7572 msgstr ""
7573
7574 #. type: verbatim
7575 #: ../fish/guestfish-actions.pod:1408
7576 #, no-wrap
7577 msgid ""
7578 " get-pid\n"
7579 "\n"
7580 msgstr ""
7581 " get-pid\n"
7582 "\n"
7583
7584 #. type: textblock
7585 #: ../fish/guestfish-actions.pod:1410 ../src/guestfs-actions.pod:2101
7586 msgid ""
7587 "Return the process ID of the qemu subprocess.  If there is no qemu "
7588 "subprocess, then this will return an error."
7589 msgstr ""
7590
7591 #. type: textblock
7592 #: ../fish/guestfish-actions.pod:1413 ../src/guestfs-actions.pod:2104
7593 msgid "This is an internal call used for debugging and testing."
7594 msgstr ""
7595
7596 #. type: =head2
7597 #: ../fish/guestfish-actions.pod:1415
7598 msgid "get-qemu"
7599 msgstr "get-qemu"
7600
7601 #. type: verbatim
7602 #: ../fish/guestfish-actions.pod:1417
7603 #, no-wrap
7604 msgid ""
7605 " get-qemu\n"
7606 "\n"
7607 msgstr ""
7608 " get-qemu\n"
7609 "\n"
7610
7611 #. type: textblock
7612 #: ../fish/guestfish-actions.pod:1419 ../src/guestfs-actions.pod:2115
7613 msgid "Return the current qemu binary."
7614 msgstr ""
7615
7616 #. type: textblock
7617 #: ../fish/guestfish-actions.pod:1421 ../src/guestfs-actions.pod:2117
7618 msgid ""
7619 "This is always non-NULL.  If it wasn't set already, then this will return "
7620 "the default qemu binary name."
7621 msgstr ""
7622
7623 #. type: =head2
7624 #: ../fish/guestfish-actions.pod:1424
7625 msgid "get-recovery-proc"
7626 msgstr "get-recovery-proc"
7627
7628 #. type: verbatim
7629 #: ../fish/guestfish-actions.pod:1426
7630 #, no-wrap
7631 msgid ""
7632 " get-recovery-proc\n"
7633 "\n"
7634 msgstr ""
7635 " get-recovery-proc\n"
7636 "\n"
7637
7638 #. type: textblock
7639 #: ../fish/guestfish-actions.pod:1428 ../src/guestfs-actions.pod:2130
7640 msgid "Return the recovery process enabled flag."
7641 msgstr ""
7642
7643 #. type: =head2
7644 #: ../fish/guestfish-actions.pod:1430
7645 msgid "get-selinux"
7646 msgstr "get-selinux"
7647
7648 #. type: verbatim
7649 #: ../fish/guestfish-actions.pod:1432
7650 #, no-wrap
7651 msgid ""
7652 " get-selinux\n"
7653 "\n"
7654 msgstr ""
7655 " get-selinux\n"
7656 "\n"
7657
7658 #. type: textblock
7659 #: ../fish/guestfish-actions.pod:1434
7660 msgid ""
7661 "This returns the current setting of the selinux flag which is passed to the "
7662 "appliance at boot time.  See L</set-selinux>."
7663 msgstr ""
7664
7665 #. type: =head2
7666 #: ../fish/guestfish-actions.pod:1440
7667 msgid "get-state"
7668 msgstr "get-state"
7669
7670 #. type: verbatim
7671 #: ../fish/guestfish-actions.pod:1442
7672 #, no-wrap
7673 msgid ""
7674 " get-state\n"
7675 "\n"
7676 msgstr ""
7677 " get-state\n"
7678 "\n"
7679
7680 #. type: textblock
7681 #: ../fish/guestfish-actions.pod:1444 ../src/guestfs-actions.pod:2156
7682 msgid ""
7683 "This returns the current state as an opaque integer.  This is only useful "
7684 "for printing debug and internal error messages."
7685 msgstr ""
7686
7687 #. type: textblock
7688 #: ../fish/guestfish-actions.pod:1447 ../fish/guestfish-actions.pod:2367
7689 #: ../fish/guestfish-actions.pod:2385 ../fish/guestfish-actions.pod:2423
7690 #: ../fish/guestfish-actions.pod:2439 ../src/guestfs-actions.pod:2159
7691 #: ../src/guestfs-actions.pod:3439 ../src/guestfs-actions.pod:3468
7692 #: ../src/guestfs-actions.pod:3529 ../src/guestfs-actions.pod:3556
7693 msgid "For more information on states, see L<guestfs(3)>."
7694 msgstr ""
7695
7696 #. type: =head2
7697 #: ../fish/guestfish-actions.pod:1449
7698 msgid "get-trace"
7699 msgstr "get-trace"
7700
7701 #. type: verbatim
7702 #: ../fish/guestfish-actions.pod:1451
7703 #, no-wrap
7704 msgid ""
7705 " get-trace\n"
7706 "\n"
7707 msgstr ""
7708 " get-trace\n"
7709 "\n"
7710
7711 #. type: textblock
7712 #: ../fish/guestfish-actions.pod:1453 ../src/guestfs-actions.pod:2170
7713 msgid "Return the command trace flag."
7714 msgstr ""
7715
7716 #. type: =head2
7717 #: ../fish/guestfish-actions.pod:1455
7718 msgid "get-umask"
7719 msgstr "get-umask"
7720
7721 #. type: verbatim
7722 #: ../fish/guestfish-actions.pod:1457
7723 #, no-wrap
7724 msgid ""
7725 " get-umask\n"
7726 "\n"
7727 msgstr ""
7728 " get-umask\n"
7729 "\n"
7730
7731 #. type: textblock
7732 #: ../fish/guestfish-actions.pod:1459
7733 msgid ""
7734 "Return the current umask.  By default the umask is C<022> unless it has been "
7735 "set by calling L</umask>."
7736 msgstr ""
7737
7738 #. type: =head2
7739 #: ../fish/guestfish-actions.pod:1462
7740 msgid "get-verbose"
7741 msgstr "get-verbose"
7742
7743 #. type: verbatim
7744 #: ../fish/guestfish-actions.pod:1464
7745 #, no-wrap
7746 msgid ""
7747 " get-verbose\n"
7748 "\n"
7749 msgstr ""
7750 " get-verbose\n"
7751 "\n"
7752
7753 #. type: textblock
7754 #: ../fish/guestfish-actions.pod:1466 ../src/guestfs-actions.pod:2193
7755 msgid "This returns the verbose messages flag."
7756 msgstr ""
7757
7758 #. type: =head2
7759 #: ../fish/guestfish-actions.pod:1468
7760 msgid "getcon"
7761 msgstr "getcon"
7762
7763 #. type: verbatim
7764 #: ../fish/guestfish-actions.pod:1470
7765 #, no-wrap
7766 msgid ""
7767 " getcon\n"
7768 "\n"
7769 msgstr ""
7770 " getcon\n"
7771 "\n"
7772
7773 #. type: textblock
7774 #: ../fish/guestfish-actions.pod:1472 ../src/guestfs-actions.pod:2204
7775 msgid "This gets the SELinux security context of the daemon."
7776 msgstr ""
7777
7778 #. type: textblock
7779 #: ../fish/guestfish-actions.pod:1474
7780 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
7781 msgstr ""
7782
7783 #. type: =head2
7784 #: ../fish/guestfish-actions.pod:1477
7785 msgid "getxattr"
7786 msgstr "getxattr"
7787
7788 #. type: verbatim
7789 #: ../fish/guestfish-actions.pod:1479
7790 #, no-wrap
7791 msgid ""
7792 " getxattr path name\n"
7793 "\n"
7794 msgstr ""
7795 " getxattr шлях назва\n"
7796 "\n"
7797
7798 #. type: textblock
7799 #: ../fish/guestfish-actions.pod:1481
7800 msgid ""
7801 "Get a single extended attribute from file C<path> named C<name>.  This call "
7802 "follows symlinks.  If you want to lookup an extended attribute for the "
7803 "symlink itself, use L</lgetxattr>."
7804 msgstr ""
7805
7806 #. type: textblock
7807 #: ../fish/guestfish-actions.pod:1485 ../fish/guestfish-actions.pod:2512
7808 msgid ""
7809 "Normally it is better to get all extended attributes from a file in one go "
7810 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
7811 "buggy and do not provide a way to list out attributes.  For these "
7812 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
7813 "attributes you want in advance and call this function."
7814 msgstr ""
7815
7816 #. type: textblock
7817 #: ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:2519
7818 #: ../src/guestfs-actions.pod:2233 ../src/guestfs-actions.pod:3689
7819 msgid ""
7820 "Extended attribute values are blobs of binary data.  If there is no extended "
7821 "attribute named C<name>, this returns an error."
7822 msgstr ""
7823
7824 #. type: textblock
7825 #: ../fish/guestfish-actions.pod:1495
7826 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
7827 msgstr "Див. також L</getxattrs>, L</lgetxattr>, L<attr(5)>."
7828
7829 #. type: =head2
7830 #: ../fish/guestfish-actions.pod:1497
7831 msgid "getxattrs"
7832 msgstr "getxattrs"
7833
7834 #. type: verbatim
7835 #: ../fish/guestfish-actions.pod:1499
7836 #, no-wrap
7837 msgid ""
7838 " getxattrs path\n"
7839 "\n"
7840 msgstr ""
7841 " getxattrs шлях\n"
7842 "\n"
7843
7844 #. type: textblock
7845 #: ../fish/guestfish-actions.pod:1501 ../src/guestfs-actions.pod:2250
7846 msgid ""
7847 "This call lists the extended attributes of the file or directory C<path>."
7848 msgstr ""
7849
7850 #. type: textblock
7851 #: ../fish/guestfish-actions.pod:1504 ../src/guestfs-actions.pod:2253
7852 msgid ""
7853 "At the system call level, this is a combination of the L<listxattr(2)> and "
7854 "L<getxattr(2)> calls."
7855 msgstr ""
7856
7857 #. type: textblock
7858 #: ../fish/guestfish-actions.pod:1507
7859 msgid "See also: L</lgetxattrs>, L<attr(5)>."
7860 msgstr "Див. також L</lgetxattrs>, L<attr(5)>."
7861
7862 #. type: =head2
7863 #: ../fish/guestfish-actions.pod:1509
7864 msgid "glob-expand"
7865 msgstr "glob-expand"
7866
7867 #. type: verbatim
7868 #: ../fish/guestfish-actions.pod:1511
7869 #, no-wrap
7870 msgid ""
7871 " glob-expand pattern\n"
7872 "\n"
7873 msgstr ""
7874 " glob-expand шаблон\n"
7875 "\n"
7876
7877 #. type: textblock
7878 #: ../fish/guestfish-actions.pod:1513 ../src/guestfs-actions.pod:2270
7879 msgid ""
7880 "This command searches for all the pathnames matching C<pattern> according to "
7881 "the wildcard expansion rules used by the shell."
7882 msgstr ""
7883
7884 #. type: textblock
7885 #: ../fish/guestfish-actions.pod:1517 ../src/guestfs-actions.pod:2274
7886 msgid ""
7887 "If no paths match, then this returns an empty list (note: not an error)."
7888 msgstr ""
7889
7890 #. type: textblock
7891 #: ../fish/guestfish-actions.pod:1520 ../src/guestfs-actions.pod:2277
7892 msgid ""
7893 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
7894 "GLOB_BRACE>.  See that manual page for more details."
7895 msgstr ""
7896
7897 #. type: =head2
7898 #: ../fish/guestfish-actions.pod:1524
7899 msgid "grep"
7900 msgstr "grep"
7901
7902 #. type: verbatim
7903 #: ../fish/guestfish-actions.pod:1526
7904 #, no-wrap
7905 msgid ""
7906 " grep regex path\n"
7907 "\n"
7908 msgstr ""
7909 " grepi формальний_вираз шлях\n"
7910 "\n"
7911
7912 #. type: textblock
7913 #: ../fish/guestfish-actions.pod:1528 ../src/guestfs-actions.pod:2294
7914 msgid "This calls the external C<grep> program and returns the matching lines."
7915 msgstr ""
7916
7917 #. type: =head2
7918 #: ../fish/guestfish-actions.pod:1534
7919 msgid "grepi"
7920 msgstr "grepi"
7921
7922 #. type: verbatim
7923 #: ../fish/guestfish-actions.pod:1536
7924 #, no-wrap
7925 msgid ""
7926 " grepi regex path\n"
7927 "\n"
7928 msgstr ""
7929 " grepi формальний_вираз шлях\n"
7930 "\n"
7931
7932 #. type: textblock
7933 #: ../fish/guestfish-actions.pod:1538 ../src/guestfs-actions.pod:2313
7934 msgid ""
7935 "This calls the external C<grep -i> program and returns the matching lines."
7936 msgstr ""
7937
7938 #. type: =head2
7939 #: ../fish/guestfish-actions.pod:1544
7940 msgid "grub-install"
7941 msgstr "grub-install"
7942
7943 #. type: verbatim
7944 #: ../fish/guestfish-actions.pod:1546
7945 #, no-wrap
7946 msgid ""
7947 " grub-install root device\n"
7948 "\n"
7949 msgstr ""
7950 " grub-install кореневий пристрій\n"
7951 "\n"
7952
7953 #. type: textblock
7954 #: ../fish/guestfish-actions.pod:1548 ../src/guestfs-actions.pod:2332
7955 msgid ""
7956 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
7957 "the root directory being C<root>."
7958 msgstr ""
7959
7960 #. type: textblock
7961 #: ../fish/guestfish-actions.pod:1551 ../src/guestfs-actions.pod:2335
7962 msgid ""
7963 "Note: If grub-install reports the error \"No suitable drive was found in the "
7964 "generated device map.\" it may be that you need to create a C</boot/grub/"
7965 "device.map> file first that contains the mapping between grub device names "
7966 "and Linux device names.  It is usually sufficient to create a file "
7967 "containing:"
7968 msgstr ""
7969
7970 #. type: verbatim
7971 #: ../fish/guestfish-actions.pod:1558 ../src/guestfs-actions.pod:2342
7972 #, no-wrap
7973 msgid ""
7974 " (hd0) /dev/vda\n"
7975 "\n"
7976 msgstr ""
7977
7978 #. type: textblock
7979 #: ../fish/guestfish-actions.pod:1560 ../src/guestfs-actions.pod:2344
7980 msgid "replacing C</dev/vda> with the name of the installation device."
7981 msgstr ""
7982
7983 #. type: =head2
7984 #: ../fish/guestfish-actions.pod:1562
7985 msgid "head"
7986 msgstr "head"
7987
7988 #. type: verbatim
7989 #: ../fish/guestfish-actions.pod:1564
7990 #, no-wrap
7991 msgid ""
7992 " head path\n"
7993 "\n"
7994 msgstr ""
7995 " head шлях\n"
7996 "\n"
7997
7998 #. type: textblock
7999 #: ../fish/guestfish-actions.pod:1566 ../src/guestfs-actions.pod:2356
8000 msgid ""
8001 "This command returns up to the first 10 lines of a file as a list of strings."
8002 msgstr ""
8003
8004 #. type: =head2
8005 #: ../fish/guestfish-actions.pod:1572
8006 msgid "head-n"
8007 msgstr "head-n"
8008
8009 #. type: verbatim
8010 #: ../fish/guestfish-actions.pod:1574
8011 #, no-wrap
8012 msgid ""
8013 " head-n nrlines path\n"
8014 "\n"
8015 msgstr ""
8016
8017 #. type: textblock
8018 #: ../fish/guestfish-actions.pod:1576 ../src/guestfs-actions.pod:2375
8019 msgid ""
8020 "If the parameter C<nrlines> is a positive number, this returns the first "
8021 "C<nrlines> lines of the file C<path>."
8022 msgstr ""
8023
8024 #. type: textblock
8025 #: ../fish/guestfish-actions.pod:1579 ../src/guestfs-actions.pod:2378
8026 msgid ""
8027 "If the parameter C<nrlines> is a negative number, this returns lines from "
8028 "the file C<path>, excluding the last C<nrlines> lines."
8029 msgstr ""
8030
8031 #. type: textblock
8032 #: ../fish/guestfish-actions.pod:1582 ../fish/guestfish-actions.pod:4648
8033 #: ../src/guestfs-actions.pod:2381 ../src/guestfs-actions.pod:6996
8034 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
8035 msgstr ""
8036
8037 #. type: =head2
8038 #: ../fish/guestfish-actions.pod:1587
8039 msgid "hexdump"
8040 msgstr "hexdump"
8041
8042 #. type: verbatim
8043 #: ../fish/guestfish-actions.pod:1589
8044 #, no-wrap
8045 msgid ""
8046 " hexdump path\n"
8047 "\n"
8048 msgstr ""
8049 " hexdump шлях\n"
8050 "\n"
8051
8052 #. type: textblock
8053 #: ../fish/guestfish-actions.pod:1591 ../src/guestfs-actions.pod:2398
8054 msgid ""
8055 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
8056 "readable, canonical hex dump of the file."
8057 msgstr ""
8058
8059 #. type: =head2
8060 #: ../fish/guestfish-actions.pod:1597
8061 msgid "initrd-cat"
8062 msgstr "initrd-cat"
8063
8064 #. type: verbatim
8065 #: ../fish/guestfish-actions.pod:1599
8066 #, no-wrap
8067 msgid ""
8068 " initrd-cat initrdpath filename\n"
8069 "\n"
8070 msgstr ""
8071 " initrd-cat шлях_initrd назва_файла\n"
8072 "\n"
8073
8074 #. type: textblock
8075 #: ../fish/guestfish-actions.pod:1601 ../src/guestfs-actions.pod:2417
8076 msgid ""
8077 "This command unpacks the file C<filename> from the initrd file called "
8078 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
8079 "character."
8080 msgstr ""
8081
8082 #. type: textblock
8083 #: ../fish/guestfish-actions.pod:1605 ../src/guestfs-actions.pod:2421
8084 msgid ""
8085 "For example, in guestfish you could use the following command to examine the "
8086 "boot script (usually called C</init>)  contained in a Linux initrd or "
8087 "initramfs image:"
8088 msgstr ""
8089
8090 #. type: verbatim
8091 #: ../fish/guestfish-actions.pod:1609 ../src/guestfs-actions.pod:2425
8092 #, no-wrap
8093 msgid ""
8094 " initrd-cat /boot/initrd-<version>.img init\n"
8095 "\n"
8096 msgstr ""
8097
8098 #. type: textblock
8099 #: ../fish/guestfish-actions.pod:1611
8100 msgid "See also L</initrd-list>."
8101 msgstr "Див. також L</initrd-list>."
8102
8103 #. type: =head2
8104 #: ../fish/guestfish-actions.pod:1616
8105 msgid "initrd-list"
8106 msgstr "initrd-list"
8107
8108 #. type: verbatim
8109 #: ../fish/guestfish-actions.pod:1618
8110 #, no-wrap
8111 msgid ""
8112 " initrd-list path\n"
8113 "\n"
8114 msgstr ""
8115 " initrd-list шлях\n"
8116 "\n"
8117
8118 #. type: textblock
8119 #: ../fish/guestfish-actions.pod:1620 ../src/guestfs-actions.pod:2444
8120 msgid "This command lists out files contained in an initrd."
8121 msgstr ""
8122
8123 #. type: textblock
8124 #: ../fish/guestfish-actions.pod:1622 ../src/guestfs-actions.pod:2446
8125 msgid ""
8126 "The files are listed without any initial C</> character.  The files are "
8127 "listed in the order they appear (not necessarily alphabetical).  Directory "
8128 "names are listed as separate items."
8129 msgstr ""
8130
8131 #. type: textblock
8132 #: ../fish/guestfish-actions.pod:1626 ../src/guestfs-actions.pod:2450
8133 msgid ""
8134 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
8135 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
8136 "files)."
8137 msgstr ""
8138
8139 #. type: =head2
8140 #: ../fish/guestfish-actions.pod:1630
8141 msgid "inotify-add-watch"
8142 msgstr "inotify-add-watch"
8143
8144 #. type: verbatim
8145 #: ../fish/guestfish-actions.pod:1632
8146 #, no-wrap
8147 msgid ""
8148 " inotify-add-watch path mask\n"
8149 "\n"
8150 msgstr ""
8151 " inotify-add-watch шлях маска\n"
8152 "\n"
8153
8154 #. type: textblock
8155 #: ../fish/guestfish-actions.pod:1634 ../src/guestfs-actions.pod:2467
8156 msgid "Watch C<path> for the events listed in C<mask>."
8157 msgstr ""
8158
8159 #. type: textblock
8160 #: ../fish/guestfish-actions.pod:1636 ../src/guestfs-actions.pod:2469
8161 msgid ""
8162 "Note that if C<path> is a directory then events within that directory are "
8163 "watched, but this does I<not> happen recursively (in subdirectories)."
8164 msgstr ""
8165
8166 #. type: textblock
8167 #: ../fish/guestfish-actions.pod:1640 ../src/guestfs-actions.pod:2473
8168 msgid ""
8169 "Note for non-C or non-Linux callers: the inotify events are defined by the "
8170 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
8171 msgstr ""
8172
8173 #. type: =head2
8174 #: ../fish/guestfish-actions.pod:1644
8175 msgid "inotify-close"
8176 msgstr "inotify-close"
8177
8178 #. type: verbatim
8179 #: ../fish/guestfish-actions.pod:1646
8180 #, no-wrap
8181 msgid ""
8182 " inotify-close\n"
8183 "\n"
8184 msgstr ""
8185 " inotify-close\n"
8186 "\n"
8187
8188 #. type: textblock
8189 #: ../fish/guestfish-actions.pod:1648 ../src/guestfs-actions.pod:2486
8190 msgid ""
8191 "This closes the inotify handle which was previously opened by inotify_init.  "
8192 "It removes all watches, throws away any pending events, and deallocates all "
8193 "resources."
8194 msgstr ""
8195
8196 #. type: =head2
8197 #: ../fish/guestfish-actions.pod:1652
8198 msgid "inotify-files"
8199 msgstr "inotify-files"
8200
8201 #. type: verbatim
8202 #: ../fish/guestfish-actions.pod:1654
8203 #, no-wrap
8204 msgid ""
8205 " inotify-files\n"
8206 "\n"
8207 msgstr ""
8208 " inotify-files\n"
8209 "\n"
8210
8211 #. type: textblock
8212 #: ../fish/guestfish-actions.pod:1656
8213 msgid ""
8214 "This function is a helpful wrapper around L</inotify-read> which just "
8215 "returns a list of pathnames of objects that were touched.  The returned "
8216 "pathnames are sorted and deduplicated."
8217 msgstr ""
8218
8219 #. type: =head2
8220 #: ../fish/guestfish-actions.pod:1660
8221 msgid "inotify-init"
8222 msgstr "inotify-init"
8223
8224 #. type: verbatim
8225 #: ../fish/guestfish-actions.pod:1662
8226 #, no-wrap
8227 msgid ""
8228 " inotify-init maxevents\n"
8229 "\n"
8230 msgstr ""
8231
8232 #. type: textblock
8233 #: ../fish/guestfish-actions.pod:1664 ../src/guestfs-actions.pod:2515
8234 msgid ""
8235 "This command creates a new inotify handle.  The inotify subsystem can be "
8236 "used to notify events which happen to objects in the guest filesystem."
8237 msgstr ""
8238
8239 #. type: textblock
8240 #: ../fish/guestfish-actions.pod:1668
8241 msgid ""
8242 "C<maxevents> is the maximum number of events which will be queued up between "
8243 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
8244 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
8245 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
8246 "but records the fact that it threw them away by setting a flag "
8247 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
8248 msgstr ""
8249
8250 #. type: textblock
8251 #: ../fish/guestfish-actions.pod:1678
8252 msgid ""
8253 "Before any events are generated, you have to add some watches to the "
8254 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
8255 "L</inotify-watch-all>."
8256 msgstr ""
8257
8258 #. type: textblock
8259 #: ../fish/guestfish-actions.pod:1684
8260 msgid ""
8261 "Queued up events should be read periodically by calling L</inotify-read> (or "
8262 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
8263 "If you don't read the events out often enough then you risk the internal "
8264 "queue overflowing."
8265 msgstr ""
8266
8267 #. type: textblock
8268 #: ../fish/guestfish-actions.pod:1691
8269 msgid ""
8270 "The handle should be closed after use by calling L</inotify-close>.  This "
8271 "also removes any watches automatically."
8272 msgstr ""
8273
8274 #. type: textblock
8275 #: ../fish/guestfish-actions.pod:1695 ../src/guestfs-actions.pod:2546
8276 msgid ""
8277 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
8278 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
8279 "that there is one global inotify handle per libguestfs instance."
8280 msgstr ""
8281
8282 #. type: =head2
8283 #: ../fish/guestfish-actions.pod:1700
8284 msgid "inotify-read"
8285 msgstr "inotify-read"
8286
8287 #. type: verbatim
8288 #: ../fish/guestfish-actions.pod:1702
8289 #, no-wrap
8290 msgid ""
8291 " inotify-read\n"
8292 "\n"
8293 msgstr ""
8294 " inotify-read\n"
8295 "\n"
8296
8297 #. type: textblock
8298 #: ../fish/guestfish-actions.pod:1704 ../src/guestfs-actions.pod:2560
8299 msgid ""
8300 "Return the complete queue of events that have happened since the previous "
8301 "read call."
8302 msgstr ""
8303
8304 #. type: textblock
8305 #: ../fish/guestfish-actions.pod:1707 ../src/guestfs-actions.pod:2563
8306 msgid "If no events have happened, this returns an empty list."
8307 msgstr ""
8308
8309 #. type: textblock
8310 #: ../fish/guestfish-actions.pod:1709 ../src/guestfs-actions.pod:2565
8311 msgid ""
8312 "I<Note>: In order to make sure that all events have been read, you must call "
8313 "this function repeatedly until it returns an empty list.  The reason is that "
8314 "the call will read events up to the maximum appliance-to-host message size "
8315 "and leave remaining events in the queue."
8316 msgstr ""
8317
8318 #. type: =head2
8319 #: ../fish/guestfish-actions.pod:1715
8320 msgid "inotify-rm-watch"
8321 msgstr "inotify-rm-watch"
8322
8323 #. type: verbatim
8324 #: ../fish/guestfish-actions.pod:1717
8325 #, no-wrap
8326 msgid ""
8327 " inotify-rm-watch wd\n"
8328 "\n"
8329 msgstr ""
8330
8331 #. type: textblock
8332 #: ../fish/guestfish-actions.pod:1719
8333 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
8334 msgstr ""
8335
8336 #. type: =head2
8337 #: ../fish/guestfish-actions.pod:1722
8338 msgid "inspect-get-arch"
8339 msgstr "inspect-get-arch"
8340
8341 #. type: verbatim
8342 #: ../fish/guestfish-actions.pod:1724
8343 #, no-wrap
8344 msgid ""
8345 " inspect-get-arch root\n"
8346 "\n"
8347 msgstr ""
8348 " inspect-get-arch корінь\n"
8349 "\n"
8350
8351 #. type: textblock
8352 #: ../fish/guestfish-actions.pod:1726
8353 msgid ""
8354 "This returns the architecture of the inspected operating system.  The "
8355 "possible return values are listed under L</file-architecture>."
8356 msgstr ""
8357
8358 #. type: textblock
8359 #: ../fish/guestfish-actions.pod:1730 ../src/guestfs-actions.pod:2600
8360 msgid ""
8361 "If the architecture could not be determined, then the string C<unknown> is "
8362 "returned."
8363 msgstr ""
8364
8365 #. type: textblock
8366 #: ../fish/guestfish-actions.pod:1733 ../fish/guestfish-actions.pod:1816
8367 #: ../fish/guestfish-actions.pod:1895 ../fish/guestfish-actions.pod:1907
8368 #: ../fish/guestfish-actions.pod:1991 ../fish/guestfish-actions.pod:2052
8369 #: ../fish/guestfish-actions.pod:2073 ../fish/guestfish-actions.pod:2087
8370 #: ../fish/guestfish-actions.pod:2127 ../fish/guestfish-actions.pod:2159
8371 #: ../fish/guestfish-actions.pod:2172 ../fish/guestfish-actions.pod:2185
8372 #: ../fish/guestfish-actions.pod:2195 ../fish/guestfish-actions.pod:2205
8373 #: ../fish/guestfish-actions.pod:2217 ../fish/guestfish-actions.pod:2313
8374 #: ../fish/guestfish-actions.pod:2347 ../src/guestfs-actions.pod:2603
8375 #: ../src/guestfs-actions.pod:2693 ../src/guestfs-actions.pod:2797
8376 #: ../src/guestfs-actions.pod:2816 ../src/guestfs-actions.pod:2947
8377 #: ../src/guestfs-actions.pod:3030 ../src/guestfs-actions.pod:3058
8378 #: ../src/guestfs-actions.pod:3079 ../src/guestfs-actions.pod:3132
8379 #: ../src/guestfs-actions.pod:3172 ../src/guestfs-actions.pod:3192
8380 #: ../src/guestfs-actions.pod:3212 ../src/guestfs-actions.pod:3229
8381 #: ../src/guestfs-actions.pod:3245 ../src/guestfs-actions.pod:3263
8382 #: ../src/guestfs-actions.pod:3365 ../src/guestfs-actions.pod:3406
8383 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
8384 msgstr ""
8385
8386 #. type: =head2
8387 #: ../fish/guestfish-actions.pod:1735
8388 msgid "inspect-get-distro"
8389 msgstr "inspect-get-distro"
8390
8391 #. type: verbatim
8392 #: ../fish/guestfish-actions.pod:1737
8393 #, no-wrap
8394 msgid ""
8395 " inspect-get-distro root\n"
8396 "\n"
8397 msgstr ""
8398 " inspect-get-distro корінь\n"
8399 "\n"
8400
8401 #. type: textblock
8402 #: ../fish/guestfish-actions.pod:1739 ../src/guestfs-actions.pod:2616
8403 msgid ""
8404 "This returns the distro (distribution) of the inspected operating system."
8405 msgstr ""
8406
8407 #. type: textblock
8408 #: ../fish/guestfish-actions.pod:1742 ../src/guestfs-actions.pod:2619
8409 msgid "Currently defined distros are:"
8410 msgstr ""
8411
8412 #. type: =item
8413 #: ../fish/guestfish-actions.pod:1746 ../src/guestfs-actions.pod:2623
8414 msgid "\"archlinux\""
8415 msgstr "\"archlinux\""
8416
8417 #. type: textblock
8418 #: ../fish/guestfish-actions.pod:1748 ../src/guestfs-actions.pod:2625
8419 msgid "Arch Linux."
8420 msgstr "Arch Linux."
8421
8422 #. type: =item
8423 #: ../fish/guestfish-actions.pod:1750 ../src/guestfs-actions.pod:2627
8424 msgid "\"centos\""
8425 msgstr ""
8426
8427 #. type: textblock
8428 #: ../fish/guestfish-actions.pod:1752 ../src/guestfs-actions.pod:2629
8429 msgid "CentOS."
8430 msgstr ""
8431
8432 #. type: =item
8433 #: ../fish/guestfish-actions.pod:1754 ../src/guestfs-actions.pod:2631
8434 msgid "\"debian\""
8435 msgstr "\"debian\""
8436
8437 #. type: textblock
8438 #: ../fish/guestfish-actions.pod:1756 ../src/guestfs-actions.pod:2633
8439 msgid "Debian."
8440 msgstr "Debian."
8441
8442 #. type: =item
8443 #: ../fish/guestfish-actions.pod:1758 ../src/guestfs-actions.pod:2635
8444 msgid "\"fedora\""
8445 msgstr "\"fedora\""
8446
8447 #. type: textblock
8448 #: ../fish/guestfish-actions.pod:1760 ../src/guestfs-actions.pod:2637
8449 msgid "Fedora."
8450 msgstr "Fedora."
8451
8452 #. type: =item
8453 #: ../fish/guestfish-actions.pod:1762 ../src/guestfs-actions.pod:2639
8454 msgid "\"gentoo\""
8455 msgstr "\"gentoo\""
8456
8457 #. type: textblock
8458 #: ../fish/guestfish-actions.pod:1764 ../src/guestfs-actions.pod:2641
8459 msgid "Gentoo."
8460 msgstr "Gentoo."
8461
8462 #. type: =item
8463 #: ../fish/guestfish-actions.pod:1766 ../src/guestfs-actions.pod:2643
8464 msgid "\"linuxmint\""
8465 msgstr "\"linuxmint\""
8466
8467 #. type: textblock
8468 #: ../fish/guestfish-actions.pod:1768 ../src/guestfs-actions.pod:2645
8469 msgid "Linux Mint."
8470 msgstr "Linux Mint."
8471
8472 #. type: =item
8473 #: ../fish/guestfish-actions.pod:1770 ../src/guestfs-actions.pod:2647
8474 msgid "\"mandriva\""
8475 msgstr "\"mandriva\""
8476
8477 #. type: textblock
8478 #: ../fish/guestfish-actions.pod:1772 ../src/guestfs-actions.pod:2649
8479 msgid "Mandriva."
8480 msgstr "Mandriva."
8481
8482 #. type: =item
8483 #: ../fish/guestfish-actions.pod:1774 ../src/guestfs-actions.pod:2651
8484 msgid "\"meego\""
8485 msgstr "\"meego\""
8486
8487 #. type: textblock
8488 #: ../fish/guestfish-actions.pod:1776 ../src/guestfs-actions.pod:2653
8489 msgid "MeeGo."
8490 msgstr "MeeGo."
8491
8492 #. type: =item
8493 #: ../fish/guestfish-actions.pod:1778 ../src/guestfs-actions.pod:2655
8494 msgid "\"pardus\""
8495 msgstr "\"pardus\""
8496
8497 #. type: textblock
8498 #: ../fish/guestfish-actions.pod:1780 ../src/guestfs-actions.pod:2657
8499 msgid "Pardus."
8500 msgstr "Pardus."
8501
8502 #. type: =item
8503 #: ../fish/guestfish-actions.pod:1782 ../src/guestfs-actions.pod:2659
8504 msgid "\"redhat-based\""
8505 msgstr "\"redhat-based\""
8506
8507 #. type: textblock
8508 #: ../fish/guestfish-actions.pod:1784 ../src/guestfs-actions.pod:2661
8509 msgid "Some Red Hat-derived distro."
8510 msgstr "Дистрибутив, що походить від Red Hat."
8511
8512 #. type: =item
8513 #: ../fish/guestfish-actions.pod:1786 ../src/guestfs-actions.pod:2663
8514 msgid "\"rhel\""
8515 msgstr "\"rhel\""
8516
8517 #. type: textblock
8518 #: ../fish/guestfish-actions.pod:1788 ../src/guestfs-actions.pod:2665
8519 msgid "Red Hat Enterprise Linux."
8520 msgstr ""
8521
8522 #. type: =item
8523 #: ../fish/guestfish-actions.pod:1790 ../src/guestfs-actions.pod:2667
8524 msgid "\"scientificlinux\""
8525 msgstr ""
8526
8527 #. type: textblock
8528 #: ../fish/guestfish-actions.pod:1792 ../src/guestfs-actions.pod:2669
8529 msgid "Scientific Linux."
8530 msgstr ""
8531
8532 #. type: =item
8533 #: ../fish/guestfish-actions.pod:1794 ../src/guestfs-actions.pod:2671
8534 msgid "\"slackware\""
8535 msgstr ""
8536
8537 #. type: textblock
8538 #: ../fish/guestfish-actions.pod:1796 ../src/guestfs-actions.pod:2673
8539 msgid "Slackware."
8540 msgstr ""
8541
8542 #. type: =item
8543 #: ../fish/guestfish-actions.pod:1798 ../src/guestfs-actions.pod:2675
8544 msgid "\"ubuntu\""
8545 msgstr "\"ubuntu\""
8546
8547 #. type: textblock
8548 #: ../fish/guestfish-actions.pod:1800 ../src/guestfs-actions.pod:2677
8549 msgid "Ubuntu."
8550 msgstr "Ubuntu."
8551
8552 #. type: =item
8553 #: ../fish/guestfish-actions.pod:1802 ../fish/guestfish-actions.pod:1886
8554 #: ../fish/guestfish-actions.pod:2150 ../src/guestfs-actions.pod:2679
8555 #: ../src/guestfs-actions.pod:2788 ../src/guestfs-actions.pod:3163
8556 msgid "\"unknown\""
8557 msgstr "\"unknown\""
8558
8559 #. type: textblock
8560 #: ../fish/guestfish-actions.pod:1804 ../src/guestfs-actions.pod:2681
8561 msgid "The distro could not be determined."
8562 msgstr "Дистрибутив, тип якого не вдалося визначити."
8563
8564 #. type: =item
8565 #: ../fish/guestfish-actions.pod:1806 ../fish/guestfish-actions.pod:2142
8566 #: ../src/guestfs-actions.pod:2683 ../src/guestfs-actions.pod:3155
8567 msgid "\"windows\""
8568 msgstr "\"windows\""
8569
8570 #. type: textblock
8571 #: ../fish/guestfish-actions.pod:1808 ../src/guestfs-actions.pod:2685
8572 msgid ""
8573 "Windows does not have distributions.  This string is returned if the OS type "
8574 "is Windows."
8575 msgstr ""
8576
8577 #. type: textblock
8578 #: ../fish/guestfish-actions.pod:1813 ../fish/guestfish-actions.pod:1892
8579 #: ../fish/guestfish-actions.pod:2156 ../src/guestfs-actions.pod:2690
8580 #: ../src/guestfs-actions.pod:2794 ../src/guestfs-actions.pod:3169
8581 msgid ""
8582 "Future versions of libguestfs may return other strings here.  The caller "
8583 "should be prepared to handle any string."
8584 msgstr ""
8585
8586 #. type: =head2
8587 #: ../fish/guestfish-actions.pod:1818
8588 msgid "inspect-get-drive-mappings"
8589 msgstr ""
8590
8591 #. type: verbatim
8592 #: ../fish/guestfish-actions.pod:1820
8593 #, no-wrap
8594 msgid ""
8595 " inspect-get-drive-mappings root\n"
8596 "\n"
8597 msgstr ""
8598
8599 #. type: textblock
8600 #: ../fish/guestfish-actions.pod:1822 ../src/guestfs-actions.pod:2706
8601 msgid ""
8602 "This call is useful for Windows which uses a primitive system of assigning "
8603 "drive letters (like \"C:\") to partitions.  This inspection API examines the "
8604 "Windows Registry to find out how disks/partitions are mapped to drive "
8605 "letters, and returns a hash table as in the example below:"
8606 msgstr ""
8607
8608 #. type: verbatim
8609 #: ../fish/guestfish-actions.pod:1828 ../src/guestfs-actions.pod:2712
8610 #, no-wrap
8611 msgid ""
8612 " C      =>     /dev/vda2\n"
8613 " E      =>     /dev/vdb1\n"
8614 " F      =>     /dev/vdc1\n"
8615 "\n"
8616 msgstr ""
8617
8618 #. type: textblock
8619 #: ../fish/guestfish-actions.pod:1832 ../src/guestfs-actions.pod:2716
8620 msgid ""
8621 "Note that keys are drive letters.  For Windows, the key is case insensitive "
8622 "and just contains the drive letter, without the customary colon separator "
8623 "character."
8624 msgstr ""
8625
8626 #. type: textblock
8627 #: ../fish/guestfish-actions.pod:1836 ../src/guestfs-actions.pod:2720
8628 msgid ""
8629 "In future we may support other operating systems that also used drive "
8630 "letters, but the keys for those might not be case insensitive and might be "
8631 "longer than 1 character.  For example in OS-9, hard drives were named C<h0>, "
8632 "C<h1> etc."
8633 msgstr ""
8634
8635 #. type: textblock
8636 #: ../fish/guestfish-actions.pod:1841 ../src/guestfs-actions.pod:2725
8637 msgid ""
8638 "For Windows guests, currently only hard drive mappings are returned.  "
8639 "Removable disks (eg. DVD-ROMs) are ignored."
8640 msgstr ""
8641
8642 #. type: textblock
8643 #: ../fish/guestfish-actions.pod:1844 ../src/guestfs-actions.pod:2728
8644 msgid ""
8645 "For guests that do not use drive mappings, or if the drive mappings could "
8646 "not be determined, this returns an empty hash table."
8647 msgstr ""
8648
8649 #. type: textblock
8650 #: ../fish/guestfish-actions.pod:1847
8651 msgid ""
8652 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
8653 "get-mountpoints>, L</inspect-get-filesystems>."
8654 msgstr ""
8655
8656 #. type: =head2
8657 #: ../fish/guestfish-actions.pod:1851
8658 msgid "inspect-get-filesystems"
8659 msgstr "inspect-get-filesystems"
8660
8661 #. type: verbatim
8662 #: ../fish/guestfish-actions.pod:1853
8663 #, no-wrap
8664 msgid ""
8665 " inspect-get-filesystems root\n"
8666 "\n"
8667 msgstr ""
8668 " inspect-get-filesystems корінь\n"
8669 "\n"
8670
8671 #. type: textblock
8672 #: ../fish/guestfish-actions.pod:1855 ../src/guestfs-actions.pod:2749
8673 msgid ""
8674 "This returns a list of all the filesystems that we think are associated with "
8675 "this operating system.  This includes the root filesystem, other ordinary "
8676 "filesystems, and non-mounted devices like swap partitions."
8677 msgstr ""
8678
8679 #. type: textblock
8680 #: ../fish/guestfish-actions.pod:1860 ../src/guestfs-actions.pod:2754
8681 msgid ""
8682 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
8683 "to be shared between operating systems."
8684 msgstr ""
8685
8686 #. type: textblock
8687 #: ../fish/guestfish-actions.pod:1863
8688 msgid ""
8689 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
8690 "get-mountpoints>."
8691 msgstr ""
8692
8693 #. type: =head2
8694 #: ../fish/guestfish-actions.pod:1866
8695 msgid "inspect-get-format"
8696 msgstr "inspect-get-format"
8697
8698 #. type: verbatim
8699 #: ../fish/guestfish-actions.pod:1868
8700 #, no-wrap
8701 msgid ""
8702 " inspect-get-format root\n"
8703 "\n"
8704 msgstr ""
8705 " inspect-get-format корінь\n"
8706 "\n"
8707
8708 #. type: textblock
8709 #: ../fish/guestfish-actions.pod:1870 ../src/guestfs-actions.pod:2772
8710 msgid ""
8711 "This returns the format of the inspected operating system.  You can use it "
8712 "to detect install images, live CDs and similar."
8713 msgstr ""
8714
8715 #. type: textblock
8716 #: ../fish/guestfish-actions.pod:1873 ../src/guestfs-actions.pod:2775
8717 msgid "Currently defined formats are:"
8718 msgstr ""
8719
8720 #. type: =item
8721 #: ../fish/guestfish-actions.pod:1877 ../src/guestfs-actions.pod:2779
8722 msgid "\"installed\""
8723 msgstr "\"installed\""
8724
8725 #. type: textblock
8726 #: ../fish/guestfish-actions.pod:1879 ../src/guestfs-actions.pod:2781
8727 msgid "This is an installed operating system."
8728 msgstr "Це встановлена операційна система."
8729
8730 #. type: =item
8731 #: ../fish/guestfish-actions.pod:1881 ../src/guestfs-actions.pod:2783
8732 msgid "\"installer\""
8733 msgstr ""
8734
8735 #. type: textblock
8736 #: ../fish/guestfish-actions.pod:1883 ../src/guestfs-actions.pod:2785
8737 msgid ""
8738 "The disk image being inspected is not an installed operating system, but a "
8739 "I<bootable> install disk, live CD, or similar."
8740 msgstr ""
8741
8742 #. type: textblock
8743 #: ../fish/guestfish-actions.pod:1888 ../src/guestfs-actions.pod:2790
8744 msgid "The format of this disk image is not known."
8745 msgstr ""
8746
8747 #. type: =head2
8748 #: ../fish/guestfish-actions.pod:1897
8749 msgid "inspect-get-hostname"
8750 msgstr "inspect-get-hostname"
8751
8752 #. type: verbatim
8753 #: ../fish/guestfish-actions.pod:1899
8754 #, no-wrap
8755 msgid ""
8756 " inspect-get-hostname root\n"
8757 "\n"
8758 msgstr ""
8759 " inspect-get-hostname корінь\n"
8760 "\n"
8761
8762 #. type: textblock
8763 #: ../fish/guestfish-actions.pod:1901 ../src/guestfs-actions.pod:2810
8764 msgid ""
8765 "This function returns the hostname of the operating system as found by "
8766 "inspection of the guest's configuration files."
8767 msgstr ""
8768
8769 #. type: textblock
8770 #: ../fish/guestfish-actions.pod:1904 ../src/guestfs-actions.pod:2813
8771 msgid ""
8772 "If the hostname could not be determined, then the string C<unknown> is "
8773 "returned."
8774 msgstr ""
8775
8776 #. type: =head2
8777 #: ../fish/guestfish-actions.pod:1909
8778 msgid "inspect-get-icon"
8779 msgstr ""
8780
8781 #. type: verbatim
8782 #: ../fish/guestfish-actions.pod:1911
8783 #, no-wrap
8784 msgid ""
8785 " inspect-get-icon root [favicon:..] [highquality:..]\n"
8786 "\n"
8787 msgstr ""
8788
8789 #. type: textblock
8790 #: ../fish/guestfish-actions.pod:1913 ../src/guestfs-actions.pod:2839
8791 msgid ""
8792 "This function returns an icon corresponding to the inspected operating "
8793 "system.  The icon is returned as a buffer containing a PNG image (re-encoded "
8794 "to PNG if necessary)."
8795 msgstr ""
8796
8797 #. type: textblock
8798 #: ../fish/guestfish-actions.pod:1917 ../src/guestfs-actions.pod:2843
8799 msgid ""
8800 "If it was not possible to get an icon this function returns a zero-length "
8801 "(non-NULL) buffer.  I<Callers must check for this case>."
8802 msgstr ""
8803
8804 #. type: textblock
8805 #: ../fish/guestfish-actions.pod:1920 ../src/guestfs-actions.pod:2846
8806 msgid ""
8807 "Libguestfs will start by looking for a file called C</etc/favicon.png> or "
8808 "C<C:\\etc\\favicon.png> and if it has the correct format, the contents of "
8809 "this file will be returned.  You can disable favicons by passing the "
8810 "optional C<favicon> boolean as false (default is true)."
8811 msgstr ""
8812
8813 #. type: textblock
8814 #: ../fish/guestfish-actions.pod:1926 ../src/guestfs-actions.pod:2852
8815 msgid ""
8816 "If finding the favicon fails, then we look in other places in the guest for "
8817 "a suitable icon."
8818 msgstr ""
8819
8820 #. type: textblock
8821 #: ../fish/guestfish-actions.pod:1929 ../src/guestfs-actions.pod:2855
8822 msgid ""
8823 "If the optional C<highquality> boolean is true then only high quality icons "
8824 "are returned, which means only icons of high resolution with an alpha "
8825 "channel.  The default (false) is to return any icon we can, even if it is of "
8826 "substandard quality."
8827 msgstr ""
8828
8829 #. type: textblock
8830 #: ../fish/guestfish-actions.pod:1940 ../src/guestfs-actions.pod:2866
8831 msgid ""
8832 "Unlike most other inspection API calls, the guest's disks must be mounted up "
8833 "before you call this, since it needs to read information from the guest "
8834 "filesystem during the call."
8835 msgstr ""
8836
8837 #. type: textblock
8838 #: ../fish/guestfish-actions.pod:1946 ../src/guestfs-actions.pod:2872
8839 msgid ""
8840 "B<Security:> The icon data comes from the untrusted guest, and should be "
8841 "treated with caution.  PNG files have been known to contain exploits.  "
8842 "Ensure that libpng (or other relevant libraries) are fully up to date before "
8843 "trying to process or display the icon."
8844 msgstr ""
8845
8846 #. type: textblock
8847 #: ../fish/guestfish-actions.pod:1954 ../src/guestfs-actions.pod:2880
8848 msgid ""
8849 "The PNG image returned can be any size.  It might not be square.  Libguestfs "
8850 "tries to return the largest, highest quality icon available.  The "
8851 "application must scale the icon to the required size."
8852 msgstr ""
8853
8854 #. type: textblock
8855 #: ../fish/guestfish-actions.pod:1961 ../src/guestfs-actions.pod:2887
8856 msgid ""
8857 "Extracting icons from Windows guests requires the external C<wrestool> "
8858 "program from the C<icoutils> package, and several programs (C<bmptopnm>, "
8859 "C<pnmtopng>, C<pamcut>)  from the C<netpbm> package.  These must be "
8860 "installed separately."
8861 msgstr ""
8862
8863 #. type: textblock
8864 #: ../fish/guestfish-actions.pod:1968 ../src/guestfs-actions.pod:2894
8865 msgid ""
8866 "Operating system icons are usually trademarks.  Seek legal advice before "
8867 "using trademarks in applications."
8868 msgstr ""
8869
8870 #. type: =head2
8871 #: ../fish/guestfish-actions.pod:1975
8872 msgid "inspect-get-major-version"
8873 msgstr "inspect-get-major-version"
8874
8875 #. type: verbatim
8876 #: ../fish/guestfish-actions.pod:1977
8877 #, no-wrap
8878 msgid ""
8879 " inspect-get-major-version root\n"
8880 "\n"
8881 msgstr ""
8882 " inspect-get-major-version корінь\n"
8883 "\n"
8884
8885 #. type: textblock
8886 #: ../fish/guestfish-actions.pod:1979 ../src/guestfs-actions.pod:2935
8887 msgid ""
8888 "This returns the major version number of the inspected operating system."
8889 msgstr ""
8890
8891 #. type: textblock
8892 #: ../fish/guestfish-actions.pod:1982 ../src/guestfs-actions.pod:2938
8893 msgid ""
8894 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
8895 "popular public names used by the operating system.  Notably the operating "
8896 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
8897 "1).  You can find out the real versions corresponding to releases of Windows "
8898 "by consulting Wikipedia or MSDN."
8899 msgstr ""
8900
8901 #. type: textblock
8902 #: ../fish/guestfish-actions.pod:1989 ../fish/guestfish-actions.pod:2000
8903 #: ../src/guestfs-actions.pod:2945 ../src/guestfs-actions.pod:2962
8904 msgid "If the version could not be determined, then C<0> is returned."
8905 msgstr ""
8906
8907 #. type: =head2
8908 #: ../fish/guestfish-actions.pod:1993
8909 msgid "inspect-get-minor-version"
8910 msgstr "inspect-get-minor-version"
8911
8912 #. type: verbatim
8913 #: ../fish/guestfish-actions.pod:1995
8914 #, no-wrap
8915 msgid ""
8916 " inspect-get-minor-version root\n"
8917 "\n"
8918 msgstr ""
8919 " inspect-get-minor-version корінь\n"
8920 "\n"
8921
8922 #. type: textblock
8923 #: ../fish/guestfish-actions.pod:1997 ../src/guestfs-actions.pod:2959
8924 msgid ""
8925 "This returns the minor version number of the inspected operating system."
8926 msgstr ""
8927
8928 #. type: textblock
8929 #: ../fish/guestfish-actions.pod:2002
8930 msgid ""
8931 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
8932 "get-major-version>."
8933 msgstr ""
8934
8935 #. type: =head2
8936 #: ../fish/guestfish-actions.pod:2005
8937 msgid "inspect-get-mountpoints"
8938 msgstr "inspect-get-mountpoints"
8939
8940 #. type: verbatim
8941 #: ../fish/guestfish-actions.pod:2007
8942 #, no-wrap
8943 msgid ""
8944 " inspect-get-mountpoints root\n"
8945 "\n"
8946 msgstr ""
8947 " inspect-get-mountpoints корінь\n"
8948 "\n"
8949
8950 #. type: textblock
8951 #: ../fish/guestfish-actions.pod:2009 ../src/guestfs-actions.pod:2977
8952 msgid ""
8953 "This returns a hash of where we think the filesystems associated with this "
8954 "operating system should be mounted.  Callers should note that this is at "
8955 "best an educated guess made by reading configuration files such as C</etc/"
8956 "fstab>.  I<In particular note> that this may return filesystems which are "
8957 "non-existent or not mountable and callers should be prepared to handle or "
8958 "ignore failures if they try to mount them."
8959 msgstr ""
8960
8961 #. type: textblock
8962 #: ../fish/guestfish-actions.pod:2018 ../src/guestfs-actions.pod:2986
8963 msgid ""
8964 "Each element in the returned hashtable has a key which is the path of the "
8965 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
8966 "mounted there (eg. C</dev/sda1>)."
8967 msgstr ""
8968
8969 #. type: textblock
8970 #: ../fish/guestfish-actions.pod:2023 ../src/guestfs-actions.pod:2991
8971 msgid ""
8972 "Non-mounted devices such as swap devices are I<not> returned in this list."
8973 msgstr ""
8974
8975 #. type: textblock
8976 #: ../fish/guestfish-actions.pod:2026
8977 msgid ""
8978 "For operating systems like Windows which still use drive letters, this call "
8979 "will only return an entry for the first drive \"mounted on\" C</>.  For "
8980 "information about the mapping of drive letters to partitions, see L</inspect-"
8981 "get-drive-mappings>."
8982 msgstr ""
8983
8984 #. type: textblock
8985 #: ../fish/guestfish-actions.pod:2032
8986 msgid ""
8987 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
8988 "get-filesystems>."
8989 msgstr ""
8990
8991 #. type: =head2
8992 #: ../fish/guestfish-actions.pod:2035
8993 msgid "inspect-get-package-format"
8994 msgstr "inspect-get-package-format"
8995
8996 #. type: verbatim
8997 #: ../fish/guestfish-actions.pod:2037
8998 #, no-wrap
8999 msgid ""
9000 " inspect-get-package-format root\n"
9001 "\n"
9002 msgstr ""
9003 " inspect-get-package-format корінь\n"
9004 "\n"
9005
9006 #. type: textblock
9007 #: ../fish/guestfish-actions.pod:2039
9008 msgid ""
9009 "This function and L</inspect-get-package-management> return the package "
9010 "format and package management tool used by the inspected operating system.  "
9011 "For example for Fedora these functions would return C<rpm> (package format) "
9012 "and C<yum> (package management)."
9013 msgstr ""
9014
9015 #. type: textblock
9016 #: ../fish/guestfish-actions.pod:2045 ../src/guestfs-actions.pod:3023
9017 msgid ""
9018 "This returns the string C<unknown> if we could not determine the package "
9019 "format I<or> if the operating system does not have a real packaging system "
9020 "(eg. Windows)."
9021 msgstr ""
9022
9023 #. type: textblock
9024 #: ../fish/guestfish-actions.pod:2049 ../src/guestfs-actions.pod:3027
9025 msgid ""
9026 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
9027 "Future versions of libguestfs may return other strings."
9028 msgstr ""
9029
9030 #. type: =head2
9031 #: ../fish/guestfish-actions.pod:2054
9032 msgid "inspect-get-package-management"
9033 msgstr "inspect-get-package-management"
9034
9035 #. type: verbatim
9036 #: ../fish/guestfish-actions.pod:2056
9037 #, no-wrap
9038 msgid ""
9039 " inspect-get-package-management root\n"
9040 "\n"
9041 msgstr ""
9042 " inspect-get-package-management корінь\n"
9043 "\n"
9044
9045 #. type: textblock
9046 #: ../fish/guestfish-actions.pod:2058
9047 msgid ""
9048 "L</inspect-get-package-format> and this function return the package format "
9049 "and package management tool used by the inspected operating system.  For "
9050 "example for Fedora these functions would return C<rpm> (package format) and "
9051 "C<yum> (package management)."
9052 msgstr ""
9053
9054 #. type: textblock
9055 #: ../fish/guestfish-actions.pod:2064 ../src/guestfs-actions.pod:3049
9056 msgid ""
9057 "This returns the string C<unknown> if we could not determine the package "
9058 "management tool I<or> if the operating system does not have a real packaging "
9059 "system (eg. Windows)."
9060 msgstr ""
9061
9062 #. type: textblock
9063 #: ../fish/guestfish-actions.pod:2068 ../src/guestfs-actions.pod:3053
9064 msgid ""
9065 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
9066 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
9067 "libguestfs may return other strings."
9068 msgstr ""
9069
9070 #. type: =head2
9071 #: ../fish/guestfish-actions.pod:2075
9072 msgid "inspect-get-product-name"
9073 msgstr "inspect-get-product-name"
9074
9075 #. type: verbatim
9076 #: ../fish/guestfish-actions.pod:2077
9077 #, no-wrap
9078 msgid ""
9079 " inspect-get-product-name root\n"
9080 "\n"
9081 msgstr ""
9082 " inspect-get-product-name корінь\n"
9083 "\n"
9084
9085 #. type: textblock
9086 #: ../fish/guestfish-actions.pod:2079 ../src/guestfs-actions.pod:3071
9087 msgid ""
9088 "This returns the product name of the inspected operating system.  The "
9089 "product name is generally some freeform string which can be displayed to the "
9090 "user, but should not be parsed by programs."
9091 msgstr ""
9092
9093 #. type: textblock
9094 #: ../fish/guestfish-actions.pod:2084 ../src/guestfs-actions.pod:3076
9095 msgid ""
9096 "If the product name could not be determined, then the string C<unknown> is "
9097 "returned."
9098 msgstr ""
9099
9100 #. type: =head2
9101 #: ../fish/guestfish-actions.pod:2089
9102 msgid "inspect-get-product-variant"
9103 msgstr ""
9104
9105 #. type: verbatim
9106 #: ../fish/guestfish-actions.pod:2091
9107 #, no-wrap
9108 msgid ""
9109 " inspect-get-product-variant root\n"
9110 "\n"
9111 msgstr ""
9112
9113 #. type: textblock
9114 #: ../fish/guestfish-actions.pod:2093 ../src/guestfs-actions.pod:3092
9115 msgid "This returns the product variant of the inspected operating system."
9116 msgstr ""
9117
9118 #. type: textblock
9119 #: ../fish/guestfish-actions.pod:2096 ../src/guestfs-actions.pod:3095
9120 msgid ""
9121 "For Windows guests, this returns the contents of the Registry key C<HKLM"
9122 "\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
9123 "is usually a string such as C<Client> or C<Server> (other values are "
9124 "possible).  This can be used to distinguish consumer and enterprise versions "
9125 "of Windows that have the same version number (for example, Windows 7 and "
9126 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
9127 "the latter is C<Server>)."
9128 msgstr ""
9129
9130 #. type: textblock
9131 #: ../fish/guestfish-actions.pod:2105 ../src/guestfs-actions.pod:3104
9132 msgid ""
9133 "For enterprise Linux guests, in future we intend this to return the product "
9134 "variant such as C<Desktop>, C<Server> and so on.  But this is not "
9135 "implemented at present."
9136 msgstr ""
9137
9138 #. type: textblock
9139 #: ../fish/guestfish-actions.pod:2109 ../src/guestfs-actions.pod:3108
9140 msgid ""
9141 "If the product variant could not be determined, then the string C<unknown> "
9142 "is returned."
9143 msgstr ""
9144
9145 #. type: textblock
9146 #: ../fish/guestfish-actions.pod:2112
9147 msgid ""
9148 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
9149 "get-product-name>, L</inspect-get-major-version>."
9150 msgstr ""
9151
9152 #. type: =head2
9153 #: ../fish/guestfish-actions.pod:2116
9154 msgid "inspect-get-roots"
9155 msgstr "inspect-get-roots"
9156
9157 #. type: verbatim
9158 #: ../fish/guestfish-actions.pod:2118
9159 #, no-wrap
9160 msgid ""
9161 " inspect-get-roots\n"
9162 "\n"
9163 msgstr ""
9164 " inspect-get-roots\n"
9165 "\n"
9166
9167 #. type: textblock
9168 #: ../fish/guestfish-actions.pod:2120
9169 msgid ""
9170 "This function is a convenient way to get the list of root devices, as "
9171 "returned from a previous call to L</inspect-os>, but without redoing the "
9172 "whole inspection process."
9173 msgstr ""
9174
9175 #. type: textblock
9176 #: ../fish/guestfish-actions.pod:2124
9177 msgid ""
9178 "This returns an empty list if either no root devices were found or the "
9179 "caller has not called L</inspect-os>."
9180 msgstr ""
9181
9182 #. type: =head2
9183 #: ../fish/guestfish-actions.pod:2129
9184 msgid "inspect-get-type"
9185 msgstr "inspect-get-type"
9186
9187 #. type: verbatim
9188 #: ../fish/guestfish-actions.pod:2131
9189 #, no-wrap
9190 msgid ""
9191 " inspect-get-type root\n"
9192 "\n"
9193 msgstr ""
9194 " inspect-get-type корінь\n"
9195 "\n"
9196
9197 #. type: textblock
9198 #: ../fish/guestfish-actions.pod:2133 ../src/guestfs-actions.pod:3146
9199 msgid ""
9200 "This returns the type of the inspected operating system.  Currently defined "
9201 "types are:"
9202 msgstr ""
9203
9204 #. type: =item
9205 #: ../fish/guestfish-actions.pod:2138 ../src/guestfs-actions.pod:3151
9206 msgid "\"linux\""
9207 msgstr "\"linux\""
9208
9209 #. type: textblock
9210 #: ../fish/guestfish-actions.pod:2140 ../src/guestfs-actions.pod:3153
9211 msgid "Any Linux-based operating system."
9212 msgstr ""
9213
9214 #. type: textblock
9215 #: ../fish/guestfish-actions.pod:2144 ../src/guestfs-actions.pod:3157
9216 msgid "Any Microsoft Windows operating system."
9217 msgstr ""
9218
9219 #. type: =item
9220 #: ../fish/guestfish-actions.pod:2146 ../src/guestfs-actions.pod:3159
9221 msgid "\"freebsd\""
9222 msgstr "\"freebsd\""
9223
9224 #. type: textblock
9225 #: ../fish/guestfish-actions.pod:2148 ../src/guestfs-actions.pod:3161
9226 msgid "FreeBSD."
9227 msgstr "FreeBSD."
9228
9229 #. type: textblock
9230 #: ../fish/guestfish-actions.pod:2152 ../src/guestfs-actions.pod:3165
9231 msgid "The operating system type could not be determined."
9232 msgstr ""
9233
9234 #. type: =head2
9235 #: ../fish/guestfish-actions.pod:2161
9236 msgid "inspect-get-windows-current-control-set"
9237 msgstr ""
9238
9239 #. type: verbatim
9240 #: ../fish/guestfish-actions.pod:2163
9241 #, no-wrap
9242 msgid ""
9243 " inspect-get-windows-current-control-set root\n"
9244 "\n"
9245 msgstr ""
9246
9247 #. type: textblock
9248 #: ../fish/guestfish-actions.pod:2165 ../src/guestfs-actions.pod:3185
9249 msgid ""
9250 "This returns the Windows CurrentControlSet of the inspected guest.  The "
9251 "CurrentControlSet is a registry key name such as C<ControlSet001>."
9252 msgstr ""
9253
9254 #. type: textblock
9255 #: ../fish/guestfish-actions.pod:2168 ../src/guestfs-actions.pod:3188
9256 msgid ""
9257 "This call assumes that the guest is Windows and that the Registry could be "
9258 "examined by inspection.  If this is not the case then an error is returned."
9259 msgstr ""
9260
9261 #. type: =head2
9262 #: ../fish/guestfish-actions.pod:2174
9263 msgid "inspect-get-windows-systemroot"
9264 msgstr "inspect-get-windows-systemroot"
9265
9266 #. type: verbatim
9267 #: ../fish/guestfish-actions.pod:2176
9268 #, no-wrap
9269 msgid ""
9270 " inspect-get-windows-systemroot root\n"
9271 "\n"
9272 msgstr ""
9273 " inspect-get-windows-systemroot корінь\n"
9274 "\n"
9275
9276 #. type: textblock
9277 #: ../fish/guestfish-actions.pod:2178 ../src/guestfs-actions.pod:3205
9278 msgid ""
9279 "This returns the Windows systemroot of the inspected guest.  The systemroot "
9280 "is a directory path such as C</WINDOWS>."
9281 msgstr ""
9282
9283 #. type: textblock
9284 #: ../fish/guestfish-actions.pod:2181 ../src/guestfs-actions.pod:3208
9285 msgid ""
9286 "This call assumes that the guest is Windows and that the systemroot could be "
9287 "determined by inspection.  If this is not the case then an error is returned."
9288 msgstr ""
9289
9290 #. type: =head2
9291 #: ../fish/guestfish-actions.pod:2187
9292 msgid "inspect-is-live"
9293 msgstr "inspect-is-live"
9294
9295 #. type: verbatim
9296 #: ../fish/guestfish-actions.pod:2189
9297 #, no-wrap
9298 msgid ""
9299 " inspect-is-live root\n"
9300 "\n"
9301 msgstr ""
9302 " inspect-is-live корінь\n"
9303 "\n"
9304
9305 #. type: textblock
9306 #: ../fish/guestfish-actions.pod:2191
9307 msgid ""
9308 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
9309 "then this returns true if a live image was detected on the disk."
9310 msgstr ""
9311
9312 #. type: =head2
9313 #: ../fish/guestfish-actions.pod:2197
9314 msgid "inspect-is-multipart"
9315 msgstr "inspect-is-multipart"
9316
9317 #. type: verbatim
9318 #: ../fish/guestfish-actions.pod:2199
9319 #, no-wrap
9320 msgid ""
9321 " inspect-is-multipart root\n"
9322 "\n"
9323 msgstr ""
9324 " inspect-is-multipart корінь\n"
9325 "\n"
9326
9327 #. type: textblock
9328 #: ../fish/guestfish-actions.pod:2201
9329 msgid ""
9330 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
9331 "then this returns true if the disk is part of a set."
9332 msgstr ""
9333
9334 #. type: =head2
9335 #: ../fish/guestfish-actions.pod:2207
9336 msgid "inspect-is-netinst"
9337 msgstr "inspect-is-netinst"
9338
9339 #. type: verbatim
9340 #: ../fish/guestfish-actions.pod:2209
9341 #, no-wrap
9342 msgid ""
9343 " inspect-is-netinst root\n"
9344 "\n"
9345 msgstr ""
9346 " inspect-is-netinst корінь\n"
9347 "\n"
9348
9349 #. type: textblock
9350 #: ../fish/guestfish-actions.pod:2211
9351 msgid ""
9352 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
9353 "then this returns true if the disk is a network installer, ie. not a self-"
9354 "contained install CD but one which is likely to require network access to "
9355 "complete the install."
9356 msgstr ""
9357
9358 #. type: =head2
9359 #: ../fish/guestfish-actions.pod:2219
9360 msgid "inspect-list-applications"
9361 msgstr "inspect-list-applications"
9362
9363 #. type: verbatim
9364 #: ../fish/guestfish-actions.pod:2221
9365 #, no-wrap
9366 msgid ""
9367 " inspect-list-applications root\n"
9368 "\n"
9369 msgstr ""
9370 " inspect-list-applications кореневий_каталог\n"
9371 "\n"
9372
9373 #. type: textblock
9374 #: ../fish/guestfish-actions.pod:2223 ../src/guestfs-actions.pod:3275
9375 msgid "Return the list of applications installed in the operating system."
9376 msgstr ""
9377
9378 #. type: textblock
9379 #: ../fish/guestfish-actions.pod:2225
9380 msgid ""
9381 "I<Note:> This call works differently from other parts of the inspection "
9382 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
9383 "then mount up the disks, before calling this.  Listing applications is a "
9384 "significantly more difficult operation which requires access to the full "
9385 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
9386 "are just returning data cached in the libguestfs handle, this call actually "
9387 "reads parts of the mounted filesystems during the call."
9388 msgstr ""
9389
9390 #. type: textblock
9391 #: ../fish/guestfish-actions.pod:2235 ../src/guestfs-actions.pod:3287
9392 msgid ""
9393 "This returns an empty list if the inspection code was not able to determine "
9394 "the list of applications."
9395 msgstr ""
9396
9397 #. type: textblock
9398 #: ../fish/guestfish-actions.pod:2238 ../src/guestfs-actions.pod:3290
9399 msgid "The application structure contains the following fields:"
9400 msgstr ""
9401
9402 #. type: =item
9403 #: ../fish/guestfish-actions.pod:2242 ../src/guestfs-actions.pod:3294
9404 msgid "C<app_name>"
9405 msgstr "C<app_name>"
9406
9407 #. type: textblock
9408 #: ../fish/guestfish-actions.pod:2244 ../src/guestfs-actions.pod:3296
9409 msgid ""
9410 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
9411 "guests, this is the package name."
9412 msgstr ""
9413
9414 #. type: =item
9415 #: ../fish/guestfish-actions.pod:2247 ../src/guestfs-actions.pod:3299
9416 msgid "C<app_display_name>"
9417 msgstr "C<app_display_name>"
9418
9419 #. type: textblock
9420 #: ../fish/guestfish-actions.pod:2249 ../src/guestfs-actions.pod:3301
9421 msgid ""
9422 "The display name of the application, sometimes localized to the install "
9423 "language of the guest operating system."
9424 msgstr ""
9425
9426 #. type: textblock
9427 #: ../fish/guestfish-actions.pod:2252 ../src/guestfs-actions.pod:3304
9428 msgid ""
9429 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
9430 "to display something can use C<app_name> instead."
9431 msgstr ""
9432
9433 #. type: =item
9434 #: ../fish/guestfish-actions.pod:2255 ../src/guestfs-actions.pod:3307
9435 msgid "C<app_epoch>"
9436 msgstr "C<app_epoch>"
9437
9438 #. type: textblock
9439 #: ../fish/guestfish-actions.pod:2257 ../src/guestfs-actions.pod:3309
9440 msgid ""
9441 "For package managers which use epochs, this contains the epoch of the "
9442 "package (an integer).  If unavailable, this is returned as C<0>."
9443 msgstr ""
9444
9445 #. type: =item
9446 #: ../fish/guestfish-actions.pod:2260 ../src/guestfs-actions.pod:3312
9447 msgid "C<app_version>"
9448 msgstr "C<app_version>"
9449
9450 #. type: textblock
9451 #: ../fish/guestfish-actions.pod:2262 ../src/guestfs-actions.pod:3314
9452 msgid ""
9453 "The version string of the application or package.  If unavailable this is "
9454 "returned as an empty string C<\"\">."
9455 msgstr ""
9456
9457 #. type: =item
9458 #: ../fish/guestfish-actions.pod:2265 ../src/guestfs-actions.pod:3317
9459 msgid "C<app_release>"
9460 msgstr "C<app_release>"
9461
9462 #. type: textblock
9463 #: ../fish/guestfish-actions.pod:2267 ../src/guestfs-actions.pod:3319
9464 msgid ""
9465 "The release string of the application or package, for package managers that "
9466 "use this.  If unavailable this is returned as an empty string C<\"\">."
9467 msgstr ""
9468
9469 #. type: =item
9470 #: ../fish/guestfish-actions.pod:2271 ../src/guestfs-actions.pod:3323
9471 msgid "C<app_install_path>"
9472 msgstr "C<app_install_path>"
9473
9474 #. type: textblock
9475 #: ../fish/guestfish-actions.pod:2273 ../src/guestfs-actions.pod:3325
9476 msgid ""
9477 "The installation path of the application (on operating systems such as "
9478 "Windows which use installation paths).  This path is in the format used by "
9479 "the guest operating system, it is not a libguestfs path."
9480 msgstr ""
9481
9482 #. type: textblock
9483 #: ../fish/guestfish-actions.pod:2278 ../src/guestfs-actions.pod:3330
9484 msgid "If unavailable this is returned as an empty string C<\"\">."
9485 msgstr ""
9486
9487 #. type: =item
9488 #: ../fish/guestfish-actions.pod:2280 ../src/guestfs-actions.pod:3332
9489 msgid "C<app_trans_path>"
9490 msgstr "C<app_trans_path>"
9491
9492 #. type: textblock
9493 #: ../fish/guestfish-actions.pod:2282 ../src/guestfs-actions.pod:3334
9494 msgid ""
9495 "The install path translated into a libguestfs path.  If unavailable this is "
9496 "returned as an empty string C<\"\">."
9497 msgstr ""
9498
9499 #. type: =item
9500 #: ../fish/guestfish-actions.pod:2285 ../src/guestfs-actions.pod:3337
9501 msgid "C<app_publisher>"
9502 msgstr "C<app_publisher>"
9503
9504 #. type: textblock
9505 #: ../fish/guestfish-actions.pod:2287 ../src/guestfs-actions.pod:3339
9506 msgid ""
9507 "The name of the publisher of the application, for package managers that use "
9508 "this.  If unavailable this is returned as an empty string C<\"\">."
9509 msgstr ""
9510
9511 #. type: =item
9512 #: ../fish/guestfish-actions.pod:2291 ../src/guestfs-actions.pod:3343
9513 msgid "C<app_url>"
9514 msgstr "C<app_url>"
9515
9516 #. type: textblock
9517 #: ../fish/guestfish-actions.pod:2293 ../src/guestfs-actions.pod:3345
9518 msgid ""
9519 "The URL (eg. upstream URL) of the application.  If unavailable this is "
9520 "returned as an empty string C<\"\">."
9521 msgstr ""
9522
9523 #. type: =item
9524 #: ../fish/guestfish-actions.pod:2296 ../src/guestfs-actions.pod:3348
9525 msgid "C<app_source_package>"
9526 msgstr "C<app_source_package>"
9527
9528 #. type: textblock
9529 #: ../fish/guestfish-actions.pod:2298 ../src/guestfs-actions.pod:3350
9530 msgid ""
9531 "For packaging systems which support this, the name of the source package.  "
9532 "If unavailable this is returned as an empty string C<\"\">."
9533 msgstr ""
9534
9535 #. type: =item
9536 #: ../fish/guestfish-actions.pod:2301 ../src/guestfs-actions.pod:3353
9537 msgid "C<app_summary>"
9538 msgstr "C<app_summary>"
9539
9540 #. type: textblock
9541 #: ../fish/guestfish-actions.pod:2303 ../src/guestfs-actions.pod:3355
9542 msgid ""
9543 "A short (usually one line) description of the application or package.  If "
9544 "unavailable this is returned as an empty string C<\"\">."
9545 msgstr ""
9546
9547 #. type: =item
9548 #: ../fish/guestfish-actions.pod:2306 ../src/guestfs-actions.pod:3358
9549 msgid "C<app_description>"
9550 msgstr "C<app_description>"
9551
9552 #. type: textblock
9553 #: ../fish/guestfish-actions.pod:2308 ../src/guestfs-actions.pod:3360
9554 msgid ""
9555 "A longer description of the application or package.  If unavailable this is "
9556 "returned as an empty string C<\"\">."
9557 msgstr ""
9558
9559 #. type: =head2
9560 #: ../fish/guestfish-actions.pod:2315
9561 msgid "inspect-os"
9562 msgstr "inspect-os"
9563
9564 #. type: verbatim
9565 #: ../fish/guestfish-actions.pod:2317
9566 #, no-wrap
9567 msgid ""
9568 " inspect-os\n"
9569 "\n"
9570 msgstr ""
9571 " inspect-os\n"
9572 "\n"
9573
9574 #. type: textblock
9575 #: ../fish/guestfish-actions.pod:2319 ../src/guestfs-actions.pod:3378
9576 msgid ""
9577 "This function uses other libguestfs functions and certain heuristics to "
9578 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
9579 "for operating systems."
9580 msgstr ""
9581
9582 #. type: textblock
9583 #: ../fish/guestfish-actions.pod:2323 ../src/guestfs-actions.pod:3382
9584 msgid "The list returned is empty if no operating systems were found."
9585 msgstr ""
9586
9587 #. type: textblock
9588 #: ../fish/guestfish-actions.pod:2325 ../src/guestfs-actions.pod:3384
9589 msgid ""
9590 "If one operating system was found, then this returns a list with a single "
9591 "element, which is the name of the root filesystem of this operating system.  "
9592 "It is also possible for this function to return a list containing more than "
9593 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
9594 "element being the root filesystem of one of the operating systems."
9595 msgstr ""
9596
9597 #. type: textblock
9598 #: ../fish/guestfish-actions.pod:2332
9599 msgid ""
9600 "You can pass the root string(s) returned to other L</inspect-get-*> "
9601 "functions in order to query further information about each operating system, "
9602 "such as the name and version."
9603 msgstr ""
9604
9605 #. type: textblock
9606 #: ../fish/guestfish-actions.pod:2337
9607 msgid ""
9608 "This function uses other libguestfs features such as L</mount-ro> and L</"
9609 "umount-all> in order to mount and unmount filesystems and look at the "
9610 "contents.  This should be called with no disks currently mounted.  The "
9611 "function may also use Augeas, so any existing Augeas handle will be closed."
9612 msgstr ""
9613
9614 #. type: textblock
9615 #: ../fish/guestfish-actions.pod:2343 ../src/guestfs-actions.pod:3402
9616 msgid ""
9617 "This function cannot decrypt encrypted disks.  The caller must do that first "
9618 "(supplying the necessary keys) if the disk is encrypted."
9619 msgstr ""
9620
9621 #. type: textblock
9622 #: ../fish/guestfish-actions.pod:2349 ../fish/guestfish-actions.pod:2547
9623 #: ../fish/guestfish-actions.pod:2606
9624 msgid "See also L</list-filesystems>."
9625 msgstr "Див. також L</list-filesystems>."
9626
9627 #. type: =head2
9628 #: ../fish/guestfish-actions.pod:2351
9629 msgid "is-blockdev"
9630 msgstr "is-blockdev"
9631
9632 #. type: verbatim
9633 #: ../fish/guestfish-actions.pod:2353
9634 #, no-wrap
9635 msgid ""
9636 " is-blockdev path\n"
9637 "\n"
9638 msgstr ""
9639 " is-blockdev шлях\n"
9640 "\n"
9641
9642 #. type: textblock
9643 #: ../fish/guestfish-actions.pod:2355 ../src/guestfs-actions.pod:3422
9644 msgid ""
9645 "This returns C<true> if and only if there is a block device with the given "
9646 "C<path> name."
9647 msgstr ""
9648
9649 #. type: textblock
9650 #: ../fish/guestfish-actions.pod:2358 ../fish/guestfish-actions.pod:2376
9651 #: ../fish/guestfish-actions.pod:2395 ../fish/guestfish-actions.pod:2404
9652 #: ../fish/guestfish-actions.pod:2414 ../fish/guestfish-actions.pod:2448
9653 #: ../fish/guestfish-actions.pod:2457
9654 msgid "See also L</stat>."
9655 msgstr "Див. також L</stat>."
9656
9657 #. type: =head2
9658 #: ../fish/guestfish-actions.pod:2360
9659 msgid "is-busy"
9660 msgstr "is-busy"
9661
9662 #. type: verbatim
9663 #: ../fish/guestfish-actions.pod:2362
9664 #, no-wrap
9665 msgid ""
9666 " is-busy\n"
9667 "\n"
9668 msgstr ""
9669 " is-busy\n"
9670 "\n"
9671
9672 #. type: textblock
9673 #: ../fish/guestfish-actions.pod:2364 ../src/guestfs-actions.pod:3436
9674 msgid ""
9675 "This returns true iff this handle is busy processing a command (in the "
9676 "C<BUSY> state)."
9677 msgstr ""
9678
9679 #. type: =head2
9680 #: ../fish/guestfish-actions.pod:2369
9681 msgid "is-chardev"
9682 msgstr "is-chardev"
9683
9684 #. type: verbatim
9685 #: ../fish/guestfish-actions.pod:2371
9686 #, no-wrap
9687 msgid ""
9688 " is-chardev path\n"
9689 "\n"
9690 msgstr ""
9691 " is-chardev шлях\n"
9692 "\n"
9693
9694 #. type: textblock
9695 #: ../fish/guestfish-actions.pod:2373 ../src/guestfs-actions.pod:3451
9696 msgid ""
9697 "This returns C<true> if and only if there is a character device with the "
9698 "given C<path> name."
9699 msgstr ""
9700
9701 #. type: =head2
9702 #: ../fish/guestfish-actions.pod:2378
9703 msgid "is-config"
9704 msgstr "is-config"
9705
9706 #. type: verbatim
9707 #: ../fish/guestfish-actions.pod:2380
9708 #, no-wrap
9709 msgid ""
9710 " is-config\n"
9711 "\n"
9712 msgstr ""
9713 " is-config\n"
9714 "\n"
9715
9716 #. type: textblock
9717 #: ../fish/guestfish-actions.pod:2382 ../src/guestfs-actions.pod:3465
9718 msgid ""
9719 "This returns true iff this handle is being configured (in the C<CONFIG> "
9720 "state)."
9721 msgstr ""
9722
9723 #. type: =head2
9724 #: ../fish/guestfish-actions.pod:2387
9725 msgid "is-dir"
9726 msgstr "is-dir"
9727
9728 #. type: verbatim
9729 #: ../fish/guestfish-actions.pod:2389
9730 #, no-wrap
9731 msgid ""
9732 " is-dir path\n"
9733 "\n"
9734 msgstr ""
9735 " is-dir шлях\n"
9736 "\n"
9737
9738 #. type: textblock
9739 #: ../fish/guestfish-actions.pod:2391 ../src/guestfs-actions.pod:3480
9740 msgid ""
9741 "This returns C<true> if and only if there is a directory with the given "
9742 "C<path> name.  Note that it returns false for other objects like files."
9743 msgstr ""
9744
9745 #. type: =head2
9746 #: ../fish/guestfish-actions.pod:2397
9747 msgid "is-fifo"
9748 msgstr "is-fifo"
9749
9750 #. type: verbatim
9751 #: ../fish/guestfish-actions.pod:2399
9752 #, no-wrap
9753 msgid ""
9754 " is-fifo path\n"
9755 "\n"
9756 msgstr ""
9757 " is-fifo шлях\n"
9758 "\n"
9759
9760 #. type: textblock
9761 #: ../fish/guestfish-actions.pod:2401 ../src/guestfs-actions.pod:3496
9762 msgid ""
9763 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
9764 "given C<path> name."
9765 msgstr ""
9766
9767 #. type: =head2
9768 #: ../fish/guestfish-actions.pod:2406
9769 msgid "is-file"
9770 msgstr "is-file"
9771
9772 #. type: verbatim
9773 #: ../fish/guestfish-actions.pod:2408
9774 #, no-wrap
9775 msgid ""
9776 " is-file path\n"
9777 "\n"
9778 msgstr ""
9779 " is-file шлях\n"
9780 "\n"
9781
9782 #. type: textblock
9783 #: ../fish/guestfish-actions.pod:2410 ../src/guestfs-actions.pod:3511
9784 msgid ""
9785 "This returns C<true> if and only if there is a regular file with the given "
9786 "C<path> name.  Note that it returns false for other objects like directories."
9787 msgstr ""
9788
9789 #. type: =head2
9790 #: ../fish/guestfish-actions.pod:2416
9791 msgid "is-launching"
9792 msgstr "is-launching"
9793
9794 #. type: verbatim
9795 #: ../fish/guestfish-actions.pod:2418
9796 #, no-wrap
9797 msgid ""
9798 " is-launching\n"
9799 "\n"
9800 msgstr ""
9801 " is-launching\n"
9802 "\n"
9803
9804 #. type: textblock
9805 #: ../fish/guestfish-actions.pod:2420 ../src/guestfs-actions.pod:3526
9806 msgid ""
9807 "This returns true iff this handle is launching the subprocess (in the "
9808 "C<LAUNCHING> state)."
9809 msgstr ""
9810
9811 #. type: =head2
9812 #: ../fish/guestfish-actions.pod:2425
9813 msgid "is-lv"
9814 msgstr "is-lv"
9815
9816 #. type: verbatim
9817 #: ../fish/guestfish-actions.pod:2427
9818 #, no-wrap
9819 msgid ""
9820 " is-lv device\n"
9821 "\n"
9822 msgstr ""
9823 " is-lv пристрій\n"
9824 "\n"
9825
9826 #. type: textblock
9827 #: ../fish/guestfish-actions.pod:2429 ../src/guestfs-actions.pod:3541
9828 msgid ""
9829 "This command tests whether C<device> is a logical volume, and returns true "
9830 "iff this is the case."
9831 msgstr ""
9832
9833 #. type: =head2
9834 #: ../fish/guestfish-actions.pod:2432
9835 msgid "is-ready"
9836 msgstr "is-ready"
9837
9838 #. type: verbatim
9839 #: ../fish/guestfish-actions.pod:2434
9840 #, no-wrap
9841 msgid ""
9842 " is-ready\n"
9843 "\n"
9844 msgstr ""
9845 " is-ready\n"
9846 "\n"
9847
9848 #. type: textblock
9849 #: ../fish/guestfish-actions.pod:2436 ../src/guestfs-actions.pod:3553
9850 msgid ""
9851 "This returns true iff this handle is ready to accept commands (in the "
9852 "C<READY> state)."
9853 msgstr ""
9854
9855 #. type: =head2
9856 #: ../fish/guestfish-actions.pod:2441
9857 msgid "is-socket"
9858 msgstr "is-socket"
9859
9860 #. type: verbatim
9861 #: ../fish/guestfish-actions.pod:2443
9862 #, no-wrap
9863 msgid ""
9864 " is-socket path\n"
9865 "\n"
9866 msgstr ""
9867 " is-socket шлях\n"
9868 "\n"
9869
9870 #. type: textblock
9871 #: ../fish/guestfish-actions.pod:2445 ../src/guestfs-actions.pod:3568
9872 msgid ""
9873 "This returns C<true> if and only if there is a Unix domain socket with the "
9874 "given C<path> name."
9875 msgstr ""
9876
9877 #. type: =head2
9878 #: ../fish/guestfish-actions.pod:2450
9879 msgid "is-symlink"
9880 msgstr "is-symlink"
9881
9882 #. type: verbatim
9883 #: ../fish/guestfish-actions.pod:2452
9884 #, no-wrap
9885 msgid ""
9886 " is-symlink path\n"
9887 "\n"
9888 msgstr ""
9889 " is-symlink шлях\n"
9890 "\n"
9891
9892 #. type: textblock
9893 #: ../fish/guestfish-actions.pod:2454 ../src/guestfs-actions.pod:3583
9894 msgid ""
9895 "This returns C<true> if and only if there is a symbolic link with the given "
9896 "C<path> name."
9897 msgstr ""
9898
9899 #. type: =head2
9900 #: ../fish/guestfish-actions.pod:2459
9901 msgid "is-zero"
9902 msgstr ""
9903
9904 #. type: verbatim
9905 #: ../fish/guestfish-actions.pod:2461
9906 #, no-wrap
9907 msgid ""
9908 " is-zero path\n"
9909 "\n"
9910 msgstr ""
9911
9912 #. type: textblock
9913 #: ../fish/guestfish-actions.pod:2463 ../src/guestfs-actions.pod:3598
9914 msgid ""
9915 "This returns true iff the file exists and the file is empty or it contains "
9916 "all zero bytes."
9917 msgstr ""
9918
9919 #. type: =head2
9920 #: ../fish/guestfish-actions.pod:2466
9921 msgid "is-zero-device"
9922 msgstr ""
9923
9924 #. type: verbatim
9925 #: ../fish/guestfish-actions.pod:2468
9926 #, no-wrap
9927 msgid ""
9928 " is-zero-device device\n"
9929 "\n"
9930 msgstr ""
9931
9932 #. type: textblock
9933 #: ../fish/guestfish-actions.pod:2470 ../src/guestfs-actions.pod:3611
9934 msgid "This returns true iff the device exists and contains all zero bytes."
9935 msgstr ""
9936
9937 #. type: textblock
9938 #: ../fish/guestfish-actions.pod:2472 ../src/guestfs-actions.pod:3613
9939 msgid "Note that for large devices this can take a long time to run."
9940 msgstr ""
9941
9942 #. type: =head2
9943 #: ../fish/guestfish-actions.pod:2474
9944 msgid "kill-subprocess"
9945 msgstr "kill-subprocess"
9946
9947 #. type: verbatim
9948 #: ../fish/guestfish-actions.pod:2476
9949 #, no-wrap
9950 msgid ""
9951 " kill-subprocess\n"
9952 "\n"
9953 msgstr ""
9954 " kill-subprocess\n"
9955 "\n"
9956
9957 #. type: textblock
9958 #: ../fish/guestfish-actions.pod:2478 ../src/guestfs-actions.pod:3624
9959 msgid "This kills the qemu subprocess.  You should never need to call this."
9960 msgstr ""
9961
9962 #. type: =head2
9963 #: ../fish/guestfish-actions.pod:2480
9964 msgid "launch"
9965 msgstr "launch"
9966
9967 #. type: =head2
9968 #: ../fish/guestfish-actions.pod:2482
9969 msgid "run"
9970 msgstr ""
9971
9972 #. type: verbatim
9973 #: ../fish/guestfish-actions.pod:2484
9974 #, no-wrap
9975 msgid ""
9976 " launch\n"
9977 "\n"
9978 msgstr ""
9979 " launch\n"
9980 "\n"
9981
9982 #. type: textblock
9983 #: ../fish/guestfish-actions.pod:2486 ../src/guestfs-actions.pod:3635
9984 msgid ""
9985 "Internally libguestfs is implemented by running a virtual machine using "
9986 "L<qemu(1)>."
9987 msgstr ""
9988
9989 #. type: textblock
9990 #: ../fish/guestfish-actions.pod:2489 ../src/guestfs-actions.pod:3638
9991 msgid ""
9992 "You should call this after configuring the handle (eg. adding drives) but "
9993 "before performing any actions."
9994 msgstr ""
9995
9996 #. type: =head2
9997 #: ../fish/guestfish-actions.pod:2492
9998 msgid "lchown"
9999 msgstr "lchown"
10000
10001 #. type: verbatim
10002 #: ../fish/guestfish-actions.pod:2494
10003 #, no-wrap
10004 msgid ""
10005 " lchown owner group path\n"
10006 "\n"
10007 msgstr ""
10008 " lchown власник група шлях\n"
10009 "\n"
10010
10011 #. type: textblock
10012 #: ../fish/guestfish-actions.pod:2496
10013 msgid ""
10014 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
10015 "chown> but if C<path> is a symlink then the link itself is changed, not the "
10016 "target."
10017 msgstr ""
10018
10019 #. type: =head2
10020 #: ../fish/guestfish-actions.pod:2504
10021 msgid "lgetxattr"
10022 msgstr "lgetxattr"
10023
10024 #. type: verbatim
10025 #: ../fish/guestfish-actions.pod:2506
10026 #, no-wrap
10027 msgid ""
10028 " lgetxattr path name\n"
10029 "\n"
10030 msgstr ""
10031 " lgetxattr шлях назва\n"
10032 "\n"
10033
10034 #. type: textblock
10035 #: ../fish/guestfish-actions.pod:2508 ../src/guestfs-actions.pod:3678
10036 msgid ""
10037 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
10038 "is a symlink, then this call returns an extended attribute from the symlink."
10039 msgstr ""
10040
10041 #. type: textblock
10042 #: ../fish/guestfish-actions.pod:2522
10043 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
10044 msgstr "Див. також L</lgetxattrs>, L</getxattr>, L<attr(5)>."
10045
10046 #. type: =head2
10047 #: ../fish/guestfish-actions.pod:2524
10048 msgid "lgetxattrs"
10049 msgstr "lgetxattrs"
10050
10051 #. type: verbatim
10052 #: ../fish/guestfish-actions.pod:2526
10053 #, no-wrap
10054 msgid ""
10055 " lgetxattrs path\n"
10056 "\n"
10057 msgstr ""
10058 " lgetxattrs шлях\n"
10059 "\n"
10060
10061 #. type: textblock
10062 #: ../fish/guestfish-actions.pod:2528
10063 msgid ""
10064 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
10065 "it returns the extended attributes of the link itself."
10066 msgstr ""
10067
10068 #. type: =head2
10069 #: ../fish/guestfish-actions.pod:2532
10070 msgid "list-9p"
10071 msgstr ""
10072
10073 #. type: verbatim
10074 #: ../fish/guestfish-actions.pod:2534
10075 #, no-wrap
10076 msgid ""
10077 " list-9p\n"
10078 "\n"
10079 msgstr ""
10080
10081 #. type: textblock
10082 #: ../fish/guestfish-actions.pod:2536 ../src/guestfs-actions.pod:3721
10083 msgid ""
10084 "List all 9p filesystems attached to the guest.  A list of mount tags is "
10085 "returned."
10086 msgstr ""
10087
10088 #. type: =head2
10089 #: ../fish/guestfish-actions.pod:2539
10090 msgid "list-devices"
10091 msgstr "list-devices"
10092
10093 #. type: verbatim
10094 #: ../fish/guestfish-actions.pod:2541
10095 #, no-wrap
10096 msgid ""
10097 " list-devices\n"
10098 "\n"
10099 msgstr ""
10100 " list-devices\n"
10101 "\n"
10102
10103 #. type: textblock
10104 #: ../fish/guestfish-actions.pod:2543 ../src/guestfs-actions.pod:3735
10105 msgid "List all the block devices."
10106 msgstr ""
10107
10108 #. type: textblock
10109 #: ../fish/guestfish-actions.pod:2545 ../src/guestfs-actions.pod:3737
10110 msgid "The full block device names are returned, eg. C</dev/sda>."
10111 msgstr ""
10112
10113 #. type: =head2
10114 #: ../fish/guestfish-actions.pod:2549
10115 msgid "list-dm-devices"
10116 msgstr ""
10117
10118 #. type: verbatim
10119 #: ../fish/guestfish-actions.pod:2551
10120 #, no-wrap
10121 msgid ""
10122 " list-dm-devices\n"
10123 "\n"
10124 msgstr ""
10125
10126 #. type: textblock
10127 #: ../fish/guestfish-actions.pod:2553 ../src/guestfs-actions.pod:3752
10128 msgid "List all device mapper devices."
10129 msgstr ""
10130
10131 #. type: textblock
10132 #: ../fish/guestfish-actions.pod:2555
10133 msgid ""
10134 "The returned list contains C</dev/mapper/*> devices, eg. ones created by a "
10135 "previous call to L</luks-open>."
10136 msgstr ""
10137
10138 #. type: textblock
10139 #: ../fish/guestfish-actions.pod:2558
10140 msgid ""
10141 "Device mapper devices which correspond to logical volumes are I<not> "
10142 "returned in this list.  Call L</lvs> if you want to list logical volumes."
10143 msgstr ""
10144
10145 #. type: =head2
10146 #: ../fish/guestfish-actions.pod:2562
10147 msgid "list-filesystems"
10148 msgstr "list-filesystems"
10149
10150 #. type: verbatim
10151 #: ../fish/guestfish-actions.pod:2564
10152 #, no-wrap
10153 msgid ""
10154 " list-filesystems\n"
10155 "\n"
10156 msgstr ""
10157 " list-filesystems\n"
10158 "\n"
10159
10160 #. type: textblock
10161 #: ../fish/guestfish-actions.pod:2566 ../src/guestfs-actions.pod:3772
10162 msgid ""
10163 "This inspection command looks for filesystems on partitions, block devices "
10164 "and logical volumes, returning a list of devices containing filesystems and "
10165 "their type."
10166 msgstr ""
10167
10168 #. type: textblock
10169 #: ../fish/guestfish-actions.pod:2570 ../src/guestfs-actions.pod:3776
10170 msgid ""
10171 "The return value is a hash, where the keys are the devices containing "
10172 "filesystems, and the values are the filesystem types.  For example:"
10173 msgstr ""
10174
10175 #. type: verbatim
10176 #: ../fish/guestfish-actions.pod:2574 ../src/guestfs-actions.pod:3780
10177 #, no-wrap
10178 msgid ""
10179 " \"/dev/sda1\" => \"ntfs\"\n"
10180 " \"/dev/sda2\" => \"ext2\"\n"
10181 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
10182 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
10183 "\n"
10184 msgstr ""
10185
10186 #. type: textblock
10187 #: ../fish/guestfish-actions.pod:2579 ../src/guestfs-actions.pod:3785
10188 msgid ""
10189 "The value can have the special value \"unknown\", meaning the content of the "
10190 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
10191 msgstr ""
10192
10193 #. type: textblock
10194 #: ../fish/guestfish-actions.pod:2583
10195 msgid ""
10196 "This command runs other libguestfs commands, which might include L</mount> "
10197 "and L</umount>, and therefore you should use this soon after launch and only "
10198 "when nothing is mounted."
10199 msgstr ""
10200
10201 #. type: textblock
10202 #: ../fish/guestfish-actions.pod:2587
10203 msgid ""
10204 "Not all of the filesystems returned will be mountable.  In particular, swap "
10205 "partitions are returned in the list.  Also this command does not check that "
10206 "each filesystem found is valid and mountable, and some filesystems might be "
10207 "mountable but require special options.  Filesystems may not all belong to a "
10208 "single logical operating system (use L</inspect-os> to look for OSes)."
10209 msgstr ""
10210
10211 #. type: =head2
10212 #: ../fish/guestfish-actions.pod:2595
10213 msgid "list-partitions"
10214 msgstr "list-partitions"
10215
10216 #. type: verbatim
10217 #: ../fish/guestfish-actions.pod:2597
10218 #, no-wrap
10219 msgid ""
10220 " list-partitions\n"
10221 "\n"
10222 msgstr ""
10223 " list-partitions\n"
10224 "\n"
10225
10226 #. type: textblock
10227 #: ../fish/guestfish-actions.pod:2599 ../src/guestfs-actions.pod:3814
10228 msgid "List all the partitions detected on all block devices."
10229 msgstr ""
10230
10231 #. type: textblock
10232 #: ../fish/guestfish-actions.pod:2601 ../src/guestfs-actions.pod:3816
10233 msgid "The full partition device names are returned, eg. C</dev/sda1>"
10234 msgstr ""
10235
10236 #. type: textblock
10237 #: ../fish/guestfish-actions.pod:2603
10238 msgid ""
10239 "This does not return logical volumes.  For that you will need to call L</"
10240 "lvs>."
10241 msgstr ""
10242
10243 #. type: =head2
10244 #: ../fish/guestfish-actions.pod:2608
10245 msgid "ll"
10246 msgstr "ll"
10247
10248 #. type: verbatim
10249 #: ../fish/guestfish-actions.pod:2610
10250 #, no-wrap
10251 msgid ""
10252 " ll directory\n"
10253 "\n"
10254 msgstr ""
10255 " ll каталог\n"
10256 "\n"
10257
10258 #. type: textblock
10259 #: ../fish/guestfish-actions.pod:2612 ../src/guestfs-actions.pod:3835
10260 msgid ""
10261 "List the files in C<directory> (relative to the root directory, there is no "
10262 "cwd) in the format of 'ls -la'."
10263 msgstr ""
10264
10265 #. type: textblock
10266 #: ../fish/guestfish-actions.pod:2615 ../src/guestfs-actions.pod:3838
10267 msgid ""
10268 "This command is mostly useful for interactive sessions.  It is I<not> "
10269 "intended that you try to parse the output string."
10270 msgstr ""
10271
10272 #. type: =head2
10273 #: ../fish/guestfish-actions.pod:2618
10274 msgid "ln"
10275 msgstr "ln"
10276
10277 #. type: verbatim
10278 #: ../fish/guestfish-actions.pod:2620
10279 #, no-wrap
10280 msgid ""
10281 " ln target linkname\n"
10282 "\n"
10283 msgstr ""
10284 " ln призначення назва_посилання\n"
10285 "\n"
10286
10287 #. type: textblock
10288 #: ../fish/guestfish-actions.pod:2622 ../src/guestfs-actions.pod:3853
10289 msgid "This command creates a hard link using the C<ln> command."
10290 msgstr ""
10291
10292 #. type: =head2
10293 #: ../fish/guestfish-actions.pod:2624
10294 msgid "ln-f"
10295 msgstr "ln-f"
10296
10297 #. type: verbatim
10298 #: ../fish/guestfish-actions.pod:2626
10299 #, no-wrap
10300 msgid ""
10301 " ln-f target linkname\n"
10302 "\n"
10303 msgstr ""
10304 " ln-f призначення назва_посилання\n"
10305 "\n"
10306
10307 #. type: textblock
10308 #: ../fish/guestfish-actions.pod:2628 ../src/guestfs-actions.pod:3866
10309 msgid ""
10310 "This command creates a hard link using the C<ln -f> command.  The I<-f> "
10311 "option removes the link (C<linkname>) if it exists already."
10312 msgstr ""
10313
10314 #. type: =head2
10315 #: ../fish/guestfish-actions.pod:2631
10316 msgid "ln-s"
10317 msgstr "ln-s"
10318
10319 #. type: verbatim
10320 #: ../fish/guestfish-actions.pod:2633
10321 #, no-wrap
10322 msgid ""
10323 " ln-s target linkname\n"
10324 "\n"
10325 msgstr ""
10326 " ln-s призначення назва_посилання\n"
10327 "\n"
10328
10329 #. type: textblock
10330 #: ../fish/guestfish-actions.pod:2635 ../src/guestfs-actions.pod:3880
10331 msgid "This command creates a symbolic link using the C<ln -s> command."
10332 msgstr ""
10333
10334 #. type: =head2
10335 #: ../fish/guestfish-actions.pod:2637
10336 msgid "ln-sf"
10337 msgstr "ln-sf"
10338
10339 #. type: verbatim
10340 #: ../fish/guestfish-actions.pod:2639
10341 #, no-wrap
10342 msgid ""
10343 " ln-sf target linkname\n"
10344 "\n"
10345 msgstr ""
10346 " ln-sf призначення назва_посилання\n"
10347 "\n"
10348
10349 #. type: textblock
10350 #: ../fish/guestfish-actions.pod:2641 ../src/guestfs-actions.pod:3893
10351 msgid ""
10352 "This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
10353 "option removes the link (C<linkname>) if it exists already."
10354 msgstr ""
10355
10356 #. type: =head2
10357 #: ../fish/guestfish-actions.pod:2644
10358 msgid "lremovexattr"
10359 msgstr "lremovexattr"
10360
10361 #. type: verbatim
10362 #: ../fish/guestfish-actions.pod:2646
10363 #, no-wrap
10364 msgid ""
10365 " lremovexattr xattr path\n"
10366 "\n"
10367 msgstr ""
10368
10369 #. type: textblock
10370 #: ../fish/guestfish-actions.pod:2648
10371 msgid ""
10372 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
10373 "it removes an extended attribute of the link itself."
10374 msgstr ""
10375
10376 #. type: =head2
10377 #: ../fish/guestfish-actions.pod:2652
10378 msgid "ls"
10379 msgstr "ls"
10380
10381 #. type: verbatim
10382 #: ../fish/guestfish-actions.pod:2654
10383 #, no-wrap
10384 msgid ""
10385 " ls directory\n"
10386 "\n"
10387 msgstr ""
10388 " ls каталог\n"
10389 "\n"
10390
10391 #. type: textblock
10392 #: ../fish/guestfish-actions.pod:2656 ../src/guestfs-actions.pod:3921
10393 msgid ""
10394 "List the files in C<directory> (relative to the root directory, there is no "
10395 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
10396 msgstr ""
10397
10398 #. type: textblock
10399 #: ../fish/guestfish-actions.pod:2660
10400 msgid ""
10401 "This command is mostly useful for interactive sessions.  Programs should "
10402 "probably use L</readdir> instead."
10403 msgstr ""
10404
10405 #. type: =head2
10406 #: ../fish/guestfish-actions.pod:2663
10407 msgid "lsetxattr"
10408 msgstr "lsetxattr"
10409
10410 #. type: verbatim
10411 #: ../fish/guestfish-actions.pod:2665
10412 #, no-wrap
10413 msgid ""
10414 " lsetxattr xattr val vallen path\n"
10415 "\n"
10416 msgstr ""
10417
10418 #. type: textblock
10419 #: ../fish/guestfish-actions.pod:2667
10420 msgid ""
10421 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
10422 "sets an extended attribute of the link itself."
10423 msgstr ""
10424
10425 #. type: =head2
10426 #: ../fish/guestfish-actions.pod:2671
10427 msgid "lstat"
10428 msgstr "lstat"
10429
10430 #. type: verbatim
10431 #: ../fish/guestfish-actions.pod:2673
10432 #, no-wrap
10433 msgid ""
10434 " lstat path\n"
10435 "\n"
10436 msgstr ""
10437 " lstat шлях\n"
10438 "\n"
10439
10440 #. type: textblock
10441 #: ../fish/guestfish-actions.pod:2675 ../fish/guestfish-actions.pod:4483
10442 #: ../src/guestfs-actions.pod:3957 ../src/guestfs-actions.pod:6736
10443 msgid "Returns file information for the given C<path>."
10444 msgstr ""
10445
10446 #. type: textblock
10447 #: ../fish/guestfish-actions.pod:2677
10448 msgid ""
10449 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
10450 "the link is stat-ed, not the file it refers to."
10451 msgstr ""
10452
10453 #. type: textblock
10454 #: ../fish/guestfish-actions.pod:2681 ../src/guestfs-actions.pod:3963
10455 msgid "This is the same as the C<lstat(2)> system call."
10456 msgstr ""
10457
10458 #. type: =head2
10459 #: ../fish/guestfish-actions.pod:2683
10460 msgid "lstatlist"
10461 msgstr "lstatlist"
10462
10463 #. type: verbatim
10464 #: ../fish/guestfish-actions.pod:2685
10465 #, no-wrap
10466 msgid ""
10467 " lstatlist path 'names ...'\n"
10468 "\n"
10469 msgstr ""
10470
10471 #. type: textblock
10472 #: ../fish/guestfish-actions.pod:2687
10473 msgid ""
10474 "This call allows you to perform the L</lstat> operation on multiple files, "
10475 "where all files are in the directory C<path>.  C<names> is the list of files "
10476 "from this directory."
10477 msgstr ""
10478
10479 #. type: textblock
10480 #: ../fish/guestfish-actions.pod:2691 ../src/guestfs-actions.pod:3982
10481 msgid ""
10482 "On return you get a list of stat structs, with a one-to-one correspondence "
10483 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
10484 "then the C<ino> field of that structure is set to C<-1>."
10485 msgstr ""
10486
10487 #. type: textblock
10488 #: ../fish/guestfish-actions.pod:2696
10489 msgid ""
10490 "This call is intended for programs that want to efficiently list a directory "
10491 "contents without making many round-trips.  See also L</lxattrlist> for a "
10492 "similarly efficient call for getting extended attributes.  Very long "
10493 "directory listings might cause the protocol message size to be exceeded, "
10494 "causing this call to fail.  The caller must split up such requests into "
10495 "smaller groups of names."
10496 msgstr ""
10497
10498 #. type: =head2
10499 #: ../fish/guestfish-actions.pod:2704
10500 msgid "luks-add-key"
10501 msgstr "luks-add-key"
10502
10503 #. type: verbatim
10504 #: ../fish/guestfish-actions.pod:2706
10505 #, no-wrap
10506 msgid ""
10507 " luks-add-key device keyslot\n"
10508 "\n"
10509 msgstr ""
10510
10511 #. type: textblock
10512 #: ../fish/guestfish-actions.pod:2708 ../src/guestfs-actions.pod:4010
10513 msgid ""
10514 "This command adds a new key on LUKS device C<device>.  C<key> is any "
10515 "existing key, and is used to access the device.  C<newkey> is the new key to "
10516 "add.  C<keyslot> is the key slot that will be replaced."
10517 msgstr ""
10518
10519 #. type: textblock
10520 #: ../fish/guestfish-actions.pod:2713
10521 msgid ""
10522 "Note that if C<keyslot> already contains a key, then this command will "
10523 "fail.  You have to use L</luks-kill-slot> first to remove that key."
10524 msgstr ""
10525
10526 #. type: textblock
10527 #: ../fish/guestfish-actions.pod:2717 ../fish/guestfish-actions.pod:2739
10528 #: ../fish/guestfish-actions.pod:2752 ../fish/guestfish-actions.pod:2766
10529 #: ../fish/guestfish-actions.pod:2792 ../fish/guestfish-actions.pod:2802
10530 msgid ""
10531 "This command has one or more key or passphrase parameters.  Guestfish will "
10532 "prompt for these separately."
10533 msgstr ""
10534
10535 #. type: =head2
10536 #: ../fish/guestfish-actions.pod:2720
10537 msgid "luks-close"
10538 msgstr "luks-close"
10539
10540 #. type: verbatim
10541 #: ../fish/guestfish-actions.pod:2722
10542 #, no-wrap
10543 msgid ""
10544 " luks-close device\n"
10545 "\n"
10546 msgstr ""
10547 " luks-close пристрій\n"
10548 "\n"
10549
10550 #. type: textblock
10551 #: ../fish/guestfish-actions.pod:2724
10552 msgid ""
10553 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
10554 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
10555 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
10556 "block device."
10557 msgstr ""
10558
10559 #. type: =head2
10560 #: ../fish/guestfish-actions.pod:2730
10561 msgid "luks-format"
10562 msgstr "luks-format"
10563
10564 #. type: verbatim
10565 #: ../fish/guestfish-actions.pod:2732
10566 #, no-wrap
10567 msgid ""
10568 " luks-format device keyslot\n"
10569 "\n"
10570 msgstr ""
10571
10572 #. type: textblock
10573 #: ../fish/guestfish-actions.pod:2734 ../src/guestfs-actions.pod:4051
10574 msgid ""
10575 "This command erases existing data on C<device> and formats the device as a "
10576 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
10577 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
10578 msgstr ""
10579
10580 #. type: textblock
10581 #: ../fish/guestfish-actions.pod:2742 ../fish/guestfish-actions.pod:2755
10582 #: ../fish/guestfish-actions.pod:2842 ../fish/guestfish-actions.pod:3503
10583 #: ../fish/guestfish-actions.pod:4029 ../fish/guestfish-actions.pod:4354
10584 #: ../fish/guestfish-actions.pod:4377 ../fish/guestfish-actions.pod:4399
10585 #: ../fish/guestfish-actions.pod:5145 ../src/guestfs-actions.pod:4058
10586 #: ../src/guestfs-actions.pod:4081 ../src/guestfs-actions.pod:4224
10587 #: ../src/guestfs-actions.pod:5327 ../src/guestfs-actions.pod:6115
10588 #: ../src/guestfs-actions.pod:6543 ../src/guestfs-actions.pod:6573
10589 #: ../src/guestfs-actions.pod:6606 ../src/guestfs-actions.pod:7812
10590 msgid ""
10591 "B<This command is dangerous.  Without careful use you can easily destroy all "
10592 "your data>."
10593 msgstr ""
10594
10595 #. type: =head2
10596 #: ../fish/guestfish-actions.pod:2745
10597 msgid "luks-format-cipher"
10598 msgstr "luks-format-cipher"
10599
10600 #. type: verbatim
10601 #: ../fish/guestfish-actions.pod:2747
10602 #, no-wrap
10603 msgid ""
10604 " luks-format-cipher device keyslot cipher\n"
10605 "\n"
10606 msgstr ""
10607
10608 #. type: textblock
10609 #: ../fish/guestfish-actions.pod:2749
10610 msgid ""
10611 "This command is the same as L</luks-format> but it also allows you to set "
10612 "the C<cipher> used."
10613 msgstr ""
10614
10615 #. type: =head2
10616 #: ../fish/guestfish-actions.pod:2758
10617 msgid "luks-kill-slot"
10618 msgstr "luks-kill-slot"
10619
10620 #. type: verbatim
10621 #: ../fish/guestfish-actions.pod:2760
10622 #, no-wrap
10623 msgid ""
10624 " luks-kill-slot device keyslot\n"
10625 "\n"
10626 msgstr ""
10627
10628 #. type: textblock
10629 #: ../fish/guestfish-actions.pod:2762 ../src/guestfs-actions.pod:4098
10630 msgid ""
10631 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
10632 "device C<device>.  C<key> must be one of the I<other> keys."
10633 msgstr ""
10634
10635 #. type: =head2
10636 #: ../fish/guestfish-actions.pod:2769
10637 msgid "luks-open"
10638 msgstr "luks-open"
10639
10640 #. type: verbatim
10641 #: ../fish/guestfish-actions.pod:2771
10642 #, no-wrap
10643 msgid ""
10644 " luks-open device mapname\n"
10645 "\n"
10646 msgstr ""
10647
10648 #. type: textblock
10649 #: ../fish/guestfish-actions.pod:2773 ../src/guestfs-actions.pod:4118
10650 msgid ""
10651 "This command opens a block device which has been encrypted according to the "
10652 "Linux Unified Key Setup (LUKS) standard."
10653 msgstr ""
10654
10655 #. type: textblock
10656 #: ../fish/guestfish-actions.pod:2776 ../src/guestfs-actions.pod:4121
10657 msgid "C<device> is the encrypted block device or partition."
10658 msgstr ""
10659
10660 #. type: textblock
10661 #: ../fish/guestfish-actions.pod:2778 ../src/guestfs-actions.pod:4123
10662 msgid ""
10663 "The caller must supply one of the keys associated with the LUKS block "
10664 "device, in the C<key> parameter."
10665 msgstr ""
10666
10667 #. type: textblock
10668 #: ../fish/guestfish-actions.pod:2781 ../src/guestfs-actions.pod:4126
10669 msgid ""
10670 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
10671 "writes to this block device are decrypted from and encrypted to the "
10672 "underlying C<device> respectively."
10673 msgstr ""
10674
10675 #. type: textblock
10676 #: ../fish/guestfish-actions.pod:2785
10677 msgid ""
10678 "If this block device contains LVM volume groups, then calling L</vgscan> "
10679 "followed by L</vg-activate-all> will make them visible."
10680 msgstr ""
10681
10682 #. type: textblock
10683 #: ../fish/guestfish-actions.pod:2789
10684 msgid "Use L</list-dm-devices> to list all device mapper devices."
10685 msgstr ""
10686
10687 #. type: =head2
10688 #: ../fish/guestfish-actions.pod:2795
10689 msgid "luks-open-ro"
10690 msgstr "luks-open-ro"
10691
10692 #. type: verbatim
10693 #: ../fish/guestfish-actions.pod:2797
10694 #, no-wrap
10695 msgid ""
10696 " luks-open-ro device mapname\n"
10697 "\n"
10698 msgstr ""
10699
10700 #. type: textblock
10701 #: ../fish/guestfish-actions.pod:2799
10702 msgid ""
10703 "This is the same as L</luks-open> except that a read-only mapping is created."
10704 msgstr ""
10705
10706 #. type: =head2
10707 #: ../fish/guestfish-actions.pod:2805
10708 msgid "lvcreate"
10709 msgstr "lvcreate"
10710
10711 #. type: verbatim
10712 #: ../fish/guestfish-actions.pod:2807
10713 #, no-wrap
10714 msgid ""
10715 " lvcreate logvol volgroup mbytes\n"
10716 "\n"
10717 msgstr ""
10718
10719 #. type: textblock
10720 #: ../fish/guestfish-actions.pod:2809 ../src/guestfs-actions.pod:4172
10721 msgid ""
10722 "This creates an LVM logical volume called C<logvol> on the volume group "
10723 "C<volgroup>, with C<size> megabytes."
10724 msgstr ""
10725
10726 #. type: =head2
10727 #: ../fish/guestfish-actions.pod:2812
10728 msgid "lvm-canonical-lv-name"
10729 msgstr "lvm-canonical-lv-name"
10730
10731 #. type: verbatim
10732 #: ../fish/guestfish-actions.pod:2814
10733 #, no-wrap
10734 msgid ""
10735 " lvm-canonical-lv-name lvname\n"
10736 "\n"
10737 msgstr ""
10738
10739 #. type: textblock
10740 #: ../fish/guestfish-actions.pod:2816 ../src/guestfs-actions.pod:4185
10741 msgid ""
10742 "This converts alternative naming schemes for LVs that you might find to the "
10743 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
10744 "LV>."
10745 msgstr ""
10746
10747 #. type: textblock
10748 #: ../fish/guestfish-actions.pod:2820 ../src/guestfs-actions.pod:4189
10749 msgid ""
10750 "This command returns an error if the C<lvname> parameter does not refer to a "
10751 "logical volume."
10752 msgstr ""
10753
10754 #. type: textblock
10755 #: ../fish/guestfish-actions.pod:2823
10756 msgid "See also L</is-lv>."
10757 msgstr "Див. також L</is-lv>."
10758
10759 #. type: =head2
10760 #: ../fish/guestfish-actions.pod:2825
10761 msgid "lvm-clear-filter"
10762 msgstr "lvm-clear-filter"
10763
10764 #. type: verbatim
10765 #: ../fish/guestfish-actions.pod:2827
10766 #, no-wrap
10767 msgid ""
10768 " lvm-clear-filter\n"
10769 "\n"
10770 msgstr ""
10771 " lvm-clear-filter\n"
10772 "\n"
10773
10774 #. type: textblock
10775 #: ../fish/guestfish-actions.pod:2829
10776 msgid ""
10777 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
10778 "block device."
10779 msgstr ""
10780
10781 #. type: textblock
10782 #: ../fish/guestfish-actions.pod:2832 ../fish/guestfish-actions.pod:2863
10783 #: ../src/guestfs-actions.pod:4207 ../src/guestfs-actions.pod:4249
10784 msgid ""
10785 "This command also clears the LVM cache and performs a volume group scan."
10786 msgstr ""
10787
10788 #. type: =head2
10789 #: ../fish/guestfish-actions.pod:2835
10790 msgid "lvm-remove-all"
10791 msgstr "lvm-remove-all"
10792
10793 #. type: verbatim
10794 #: ../fish/guestfish-actions.pod:2837
10795 #, no-wrap
10796 msgid ""
10797 " lvm-remove-all\n"
10798 "\n"
10799 msgstr ""
10800 " lvm-remove-all\n"
10801 "\n"
10802
10803 #. type: textblock
10804 #: ../fish/guestfish-actions.pod:2839 ../src/guestfs-actions.pod:4219
10805 msgid ""
10806 "This command removes all LVM logical volumes, volume groups and physical "
10807 "volumes."
10808 msgstr ""
10809
10810 #. type: =head2
10811 #: ../fish/guestfish-actions.pod:2845
10812 msgid "lvm-set-filter"
10813 msgstr "lvm-set-filter"
10814
10815 #. type: verbatim
10816 #: ../fish/guestfish-actions.pod:2847
10817 #, no-wrap
10818 msgid ""
10819 " lvm-set-filter 'devices ...'\n"
10820 "\n"
10821 msgstr ""
10822 " lvm-set-filter 'пристрої...'\n"
10823 "\n"
10824
10825 #. type: textblock
10826 #: ../fish/guestfish-actions.pod:2849 ../src/guestfs-actions.pod:4235
10827 msgid ""
10828 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
10829 "block devices in the list C<devices>, and will ignore all other attached "
10830 "block devices."
10831 msgstr ""
10832
10833 #. type: textblock
10834 #: ../fish/guestfish-actions.pod:2853 ../src/guestfs-actions.pod:4239
10835 msgid ""
10836 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
10837 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
10838 "there are two types of duplication possible: either cloned PVs/VGs which "
10839 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
10840 "same name.  In normal operation you cannot create this situation, but you "
10841 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
10842 "inside the LVM metadata."
10843 msgstr ""
10844
10845 #. type: textblock
10846 #: ../fish/guestfish-actions.pod:2866 ../src/guestfs-actions.pod:4252
10847 msgid "You can filter whole block devices or individual partitions."
10848 msgstr ""
10849
10850 #. type: textblock
10851 #: ../fish/guestfish-actions.pod:2868 ../src/guestfs-actions.pod:4254
10852 msgid ""
10853 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
10854 "filesystem), even if you are not filtering out that VG."
10855 msgstr ""
10856
10857 #. type: =head2
10858 #: ../fish/guestfish-actions.pod:2872
10859 msgid "lvremove"
10860 msgstr "lvremove"
10861
10862 #. type: verbatim
10863 #: ../fish/guestfish-actions.pod:2874
10864 #, no-wrap
10865 msgid ""
10866 " lvremove device\n"
10867 "\n"
10868 msgstr ""
10869 " lvremove пристрій\n"
10870 "\n"
10871
10872 #. type: textblock
10873 #: ../fish/guestfish-actions.pod:2876 ../src/guestfs-actions.pod:4268
10874 msgid ""
10875 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
10876 "LV, such as C</dev/VG/LV>."
10877 msgstr ""
10878
10879 #. type: textblock
10880 #: ../fish/guestfish-actions.pod:2879 ../src/guestfs-actions.pod:4271
10881 msgid ""
10882 "You can also remove all LVs in a volume group by specifying the VG name, C</"
10883 "dev/VG>."
10884 msgstr ""
10885
10886 #. type: =head2
10887 #: ../fish/guestfish-actions.pod:2882
10888 msgid "lvrename"
10889 msgstr "lvrename"
10890
10891 #. type: verbatim
10892 #: ../fish/guestfish-actions.pod:2884
10893 #, no-wrap
10894 msgid ""
10895 " lvrename logvol newlogvol\n"
10896 "\n"
10897 msgstr ""
10898
10899 #. type: textblock
10900 #: ../fish/guestfish-actions.pod:2886 ../src/guestfs-actions.pod:4285
10901 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
10902 msgstr ""
10903
10904 #. type: =head2
10905 #: ../fish/guestfish-actions.pod:2888
10906 msgid "lvresize"
10907 msgstr "lvresize"
10908
10909 #. type: verbatim
10910 #: ../fish/guestfish-actions.pod:2890
10911 #, no-wrap
10912 msgid ""
10913 " lvresize device mbytes\n"
10914 "\n"
10915 msgstr ""
10916
10917 #. type: textblock
10918 #: ../fish/guestfish-actions.pod:2892 ../src/guestfs-actions.pod:4298
10919 msgid ""
10920 "This resizes (expands or shrinks) an existing LVM logical volume to "
10921 "C<mbytes>.  When reducing, data in the reduced part is lost."
10922 msgstr ""
10923
10924 #. type: =head2
10925 #: ../fish/guestfish-actions.pod:2896
10926 msgid "lvresize-free"
10927 msgstr "lvresize-free"
10928
10929 #. type: verbatim
10930 #: ../fish/guestfish-actions.pod:2898
10931 #, no-wrap
10932 msgid ""
10933 " lvresize-free lv percent\n"
10934 "\n"
10935 msgstr ""
10936
10937 #. type: textblock
10938 #: ../fish/guestfish-actions.pod:2900 ../src/guestfs-actions.pod:4313
10939 msgid ""
10940 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
10941 "remaining free space in the volume group.  Commonly you would call this with "
10942 "pc = 100 which expands the logical volume as much as possible, using all "
10943 "remaining free space in the volume group."
10944 msgstr ""
10945
10946 #. type: =head2
10947 #: ../fish/guestfish-actions.pod:2906
10948 msgid "lvs"
10949 msgstr "lvs"
10950
10951 #. type: verbatim
10952 #: ../fish/guestfish-actions.pod:2908
10953 #, no-wrap
10954 msgid ""
10955 " lvs\n"
10956 "\n"
10957 msgstr ""
10958 " lvs\n"
10959 "\n"
10960
10961 #. type: textblock
10962 #: ../fish/guestfish-actions.pod:2910 ../src/guestfs-actions.pod:4328
10963 msgid ""
10964 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
10965 "(8)> command."
10966 msgstr ""
10967
10968 #. type: textblock
10969 #: ../fish/guestfish-actions.pod:2913 ../src/guestfs-actions.pod:4331
10970 msgid ""
10971 "This returns a list of the logical volume device names (eg. C</dev/"
10972 "VolGroup00/LogVol00>)."
10973 msgstr ""
10974
10975 #. type: textblock
10976 #: ../fish/guestfish-actions.pod:2916
10977 msgid "See also L</lvs-full>, L</list-filesystems>."
10978 msgstr "Див. також L</lvs-full>, L</list-filesystems>."
10979
10980 #. type: =head2
10981 #: ../fish/guestfish-actions.pod:2918
10982 msgid "lvs-full"
10983 msgstr "lvs-full"
10984
10985 #. type: verbatim
10986 #: ../fish/guestfish-actions.pod:2920
10987 #, no-wrap
10988 msgid ""
10989 " lvs-full\n"
10990 "\n"
10991 msgstr ""
10992 " lvs-full\n"
10993 "\n"
10994
10995 #. type: textblock
10996 #: ../fish/guestfish-actions.pod:2922 ../src/guestfs-actions.pod:4347
10997 msgid ""
10998 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
10999 "(8)> command.  The \"full\" version includes all fields."
11000 msgstr ""
11001
11002 #. type: =head2
11003 #: ../fish/guestfish-actions.pod:2925
11004 msgid "lvuuid"
11005 msgstr "lvuuid"
11006
11007 #. type: verbatim
11008 #: ../fish/guestfish-actions.pod:2927
11009 #, no-wrap
11010 msgid ""
11011 " lvuuid device\n"
11012 "\n"
11013 msgstr ""
11014 " lvuuid пристрій\n"
11015 "\n"
11016
11017 #. type: textblock
11018 #: ../fish/guestfish-actions.pod:2929 ../src/guestfs-actions.pod:4362
11019 msgid "This command returns the UUID of the LVM LV C<device>."
11020 msgstr ""
11021
11022 #. type: =head2
11023 #: ../fish/guestfish-actions.pod:2931
11024 msgid "lxattrlist"
11025 msgstr "lxattrlist"
11026
11027 #. type: verbatim
11028 #: ../fish/guestfish-actions.pod:2933
11029 #, no-wrap
11030 msgid ""
11031 " lxattrlist path 'names ...'\n"
11032 "\n"
11033 msgstr ""
11034
11035 #. type: textblock
11036 #: ../fish/guestfish-actions.pod:2935 ../src/guestfs-actions.pod:4376
11037 msgid ""
11038 "This call allows you to get the extended attributes of multiple files, where "
11039 "all files are in the directory C<path>.  C<names> is the list of files from "
11040 "this directory."
11041 msgstr ""
11042
11043 #. type: textblock
11044 #: ../fish/guestfish-actions.pod:2939 ../src/guestfs-actions.pod:4380
11045 msgid ""
11046 "On return you get a flat list of xattr structs which must be interpreted "
11047 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
11048 "C<attrval> in this struct is zero-length to indicate there was an error "
11049 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
11050 "number (the number of following attributes for this file, which could be C<"
11051 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
11052 "for the first named file.  This repeats for the second and subsequent files."
11053 msgstr ""
11054
11055 #. type: textblock
11056 #: ../fish/guestfish-actions.pod:2949
11057 msgid ""
11058 "This call is intended for programs that want to efficiently list a directory "
11059 "contents without making many round-trips.  See also L</lstatlist> for a "
11060 "similarly efficient call for getting standard stats.  Very long directory "
11061 "listings might cause the protocol message size to be exceeded, causing this "
11062 "call to fail.  The caller must split up such requests into smaller groups of "
11063 "names."
11064 msgstr ""
11065
11066 #. type: =head2
11067 #: ../fish/guestfish-actions.pod:2957
11068 msgid "mkdir"
11069 msgstr "mkdir"
11070
11071 #. type: verbatim
11072 #: ../fish/guestfish-actions.pod:2959
11073 #, no-wrap
11074 msgid ""
11075 " mkdir path\n"
11076 "\n"
11077 msgstr ""
11078 " mkdir шлях\n"
11079 "\n"
11080
11081 #. type: textblock
11082 #: ../fish/guestfish-actions.pod:2961 ../src/guestfs-actions.pod:4410
11083 msgid "Create a directory named C<path>."
11084 msgstr ""
11085
11086 #. type: =head2
11087 #: ../fish/guestfish-actions.pod:2963
11088 msgid "mkdir-mode"
11089 msgstr "mkdir-mode"
11090
11091 #. type: verbatim
11092 #: ../fish/guestfish-actions.pod:2965
11093 #, no-wrap
11094 msgid ""
11095 " mkdir-mode path mode\n"
11096 "\n"
11097 msgstr ""
11098 " mkdir-mode шлях режим\n"
11099 "\n"
11100
11101 #. type: textblock
11102 #: ../fish/guestfish-actions.pod:2967 ../src/guestfs-actions.pod:4423
11103 msgid ""
11104 "This command creates a directory, setting the initial permissions of the "
11105 "directory to C<mode>."
11106 msgstr ""
11107
11108 #. type: textblock
11109 #: ../fish/guestfish-actions.pod:2970 ../src/guestfs-actions.pod:4426
11110 msgid ""
11111 "For common Linux filesystems, the actual mode which is set will be C<mode & "
11112 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
11113 "other ways."
11114 msgstr ""
11115
11116 #. type: textblock
11117 #: ../fish/guestfish-actions.pod:2974
11118 msgid "See also L</mkdir>, L</umask>"
11119 msgstr "Див. також L</mkdir>, L</umask>"
11120
11121 #. type: =head2
11122 #: ../fish/guestfish-actions.pod:2976
11123 msgid "mkdir-p"
11124 msgstr "mkdir-p"
11125
11126 #. type: verbatim
11127 #: ../fish/guestfish-actions.pod:2978
11128 #, no-wrap
11129 msgid ""
11130 " mkdir-p path\n"
11131 "\n"
11132 msgstr ""
11133 " mkdir-p шлях\n"
11134 "\n"
11135
11136 #. type: textblock
11137 #: ../fish/guestfish-actions.pod:2980 ../src/guestfs-actions.pod:4442
11138 msgid ""
11139 "Create a directory named C<path>, creating any parent directories as "
11140 "necessary.  This is like the C<mkdir -p> shell command."
11141 msgstr ""
11142
11143 #. type: =head2
11144 #: ../fish/guestfish-actions.pod:2983
11145 msgid "mkdtemp"
11146 msgstr "mkdtemp"
11147
11148 #. type: verbatim
11149 #: ../fish/guestfish-actions.pod:2985
11150 #, no-wrap
11151 msgid ""
11152 " mkdtemp template\n"
11153 "\n"
11154 msgstr ""
11155 " mkdtemp шаблон\n"
11156 "\n"
11157
11158 #. type: textblock
11159 #: ../fish/guestfish-actions.pod:2987 ../src/guestfs-actions.pod:4455
11160 msgid ""
11161 "This command creates a temporary directory.  The C<template> parameter "
11162 "should be a full pathname for the temporary directory name with the final "
11163 "six characters being \"XXXXXX\"."
11164 msgstr ""
11165
11166 #. type: textblock
11167 #: ../fish/guestfish-actions.pod:2992 ../src/guestfs-actions.pod:4460
11168 msgid ""
11169 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
11170 "being suitable for Windows filesystems."
11171 msgstr ""
11172
11173 #. type: textblock
11174 #: ../fish/guestfish-actions.pod:2995 ../src/guestfs-actions.pod:4463
11175 msgid "The name of the temporary directory that was created is returned."
11176 msgstr ""
11177
11178 #. type: textblock
11179 #: ../fish/guestfish-actions.pod:2998 ../src/guestfs-actions.pod:4466
11180 msgid "The temporary directory is created with mode 0700 and is owned by root."
11181 msgstr ""
11182
11183 #. type: textblock
11184 #: ../fish/guestfish-actions.pod:3001 ../src/guestfs-actions.pod:4469
11185 msgid ""
11186 "The caller is responsible for deleting the temporary directory and its "
11187 "contents after use."
11188 msgstr ""
11189
11190 #. type: textblock
11191 #: ../fish/guestfish-actions.pod:3004 ../src/guestfs-actions.pod:4472
11192 msgid "See also: L<mkdtemp(3)>"
11193 msgstr ""
11194
11195 #. type: =head2
11196 #: ../fish/guestfish-actions.pod:3006
11197 msgid "mke2fs-J"
11198 msgstr "mke2fs-J"
11199
11200 #. type: verbatim
11201 #: ../fish/guestfish-actions.pod:3008
11202 #, no-wrap
11203 msgid ""
11204 " mke2fs-J fstype blocksize device journal\n"
11205 "\n"
11206 msgstr ""
11207
11208 #. type: textblock
11209 #: ../fish/guestfish-actions.pod:3010 ../src/guestfs-actions.pod:4488
11210 msgid ""
11211 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
11212 "C<journal>.  It is equivalent to the command:"
11213 msgstr ""
11214
11215 #. type: verbatim
11216 #: ../fish/guestfish-actions.pod:3014 ../src/guestfs-actions.pod:4492
11217 #, no-wrap
11218 msgid ""
11219 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
11220 "\n"
11221 msgstr ""
11222 " mke2fs -t fstype -b blocksize -J device=<журнал> <пристрій>\n"
11223 "\n"
11224
11225 #. type: textblock
11226 #: ../fish/guestfish-actions.pod:3016
11227 msgid "See also L</mke2journal>."
11228 msgstr "Див. також L</mke2journal>."
11229
11230 #. type: =head2
11231 #: ../fish/guestfish-actions.pod:3018
11232 msgid "mke2fs-JL"
11233 msgstr "mke2fs-JL"
11234
11235 #. type: verbatim
11236 #: ../fish/guestfish-actions.pod:3020
11237 #, no-wrap
11238 msgid ""
11239 " mke2fs-JL fstype blocksize device label\n"
11240 "\n"
11241 msgstr ""
11242
11243 #. type: textblock
11244 #: ../fish/guestfish-actions.pod:3022 ../src/guestfs-actions.pod:4509
11245 msgid ""
11246 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
11247 "the journal labeled C<label>."
11248 msgstr ""
11249
11250 #. type: textblock
11251 #: ../fish/guestfish-actions.pod:3025
11252 msgid "See also L</mke2journal-L>."
11253 msgstr "Див. також L</mke2journal-L>."
11254
11255 #. type: =head2
11256 #: ../fish/guestfish-actions.pod:3027
11257 msgid "mke2fs-JU"
11258 msgstr "mke2fs-JU"
11259
11260 #. type: verbatim
11261 #: ../fish/guestfish-actions.pod:3029
11262 #, no-wrap
11263 msgid ""
11264 " mke2fs-JU fstype blocksize device uuid\n"
11265 "\n"
11266 msgstr ""
11267
11268 #. type: textblock
11269 #: ../fish/guestfish-actions.pod:3031 ../src/guestfs-actions.pod:4527
11270 msgid ""
11271 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
11272 "the journal with UUID C<uuid>."
11273 msgstr ""
11274
11275 #. type: textblock
11276 #: ../fish/guestfish-actions.pod:3034
11277 msgid "See also L</mke2journal-U>."
11278 msgstr "Див. також L</mke2journal-U>."
11279
11280 #. type: =head2
11281 #: ../fish/guestfish-actions.pod:3036
11282 msgid "mke2journal"
11283 msgstr "mke2journal"
11284
11285 #. type: verbatim
11286 #: ../fish/guestfish-actions.pod:3038
11287 #, no-wrap
11288 msgid ""
11289 " mke2journal blocksize device\n"
11290 "\n"
11291 msgstr ""
11292
11293 #. type: textblock
11294 #: ../fish/guestfish-actions.pod:3040 ../src/guestfs-actions.pod:4543
11295 msgid ""
11296 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
11297 "command:"
11298 msgstr ""
11299
11300 #. type: verbatim
11301 #: ../fish/guestfish-actions.pod:3043 ../src/guestfs-actions.pod:4546
11302 #, no-wrap
11303 msgid ""
11304 " mke2fs -O journal_dev -b blocksize device\n"
11305 "\n"
11306 msgstr ""
11307
11308 #. type: =head2
11309 #: ../fish/guestfish-actions.pod:3045
11310 msgid "mke2journal-L"
11311 msgstr "mke2journal-L"
11312
11313 #. type: verbatim
11314 #: ../fish/guestfish-actions.pod:3047
11315 #, no-wrap
11316 msgid ""
11317 " mke2journal-L blocksize label device\n"
11318 "\n"
11319 msgstr ""
11320
11321 #. type: textblock
11322 #: ../fish/guestfish-actions.pod:3049 ../src/guestfs-actions.pod:4560
11323 msgid "This creates an ext2 external journal on C<device> with label C<label>."
11324 msgstr ""
11325
11326 #. type: =head2
11327 #: ../fish/guestfish-actions.pod:3051
11328 msgid "mke2journal-U"
11329 msgstr "mke2journal-U"
11330
11331 #. type: verbatim
11332 #: ../fish/guestfish-actions.pod:3053
11333 #, no-wrap
11334 msgid ""
11335 " mke2journal-U blocksize uuid device\n"
11336 "\n"
11337 msgstr ""
11338
11339 #. type: textblock
11340 #: ../fish/guestfish-actions.pod:3055 ../src/guestfs-actions.pod:4574
11341 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
11342 msgstr ""
11343
11344 #. type: =head2
11345 #: ../fish/guestfish-actions.pod:3057
11346 msgid "mkfifo"
11347 msgstr "mkfifo"
11348
11349 #. type: verbatim
11350 #: ../fish/guestfish-actions.pod:3059
11351 #, no-wrap
11352 msgid ""
11353 " mkfifo mode path\n"
11354 "\n"
11355 msgstr ""
11356 " mkfifo режим шлях\n"
11357 "\n"
11358
11359 #. type: textblock
11360 #: ../fish/guestfish-actions.pod:3061
11361 msgid ""
11362 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
11363 "is just a convenient wrapper around L</mknod>."
11364 msgstr ""
11365
11366 #. type: =head2
11367 #: ../fish/guestfish-actions.pod:3067
11368 msgid "mkfs"
11369 msgstr "mkfs"
11370
11371 #. type: verbatim
11372 #: ../fish/guestfish-actions.pod:3069
11373 #, no-wrap
11374 msgid ""
11375 " mkfs fstype device\n"
11376 "\n"
11377 msgstr ""
11378 " mkfs тип_файлової_системи пристрій\n"
11379 "\n"
11380
11381 #. type: textblock
11382 #: ../fish/guestfish-actions.pod:3071 ../src/guestfs-actions.pod:4604
11383 msgid ""
11384 "This creates a filesystem on C<device> (usually a partition or LVM logical "
11385 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
11386 msgstr ""
11387
11388 #. type: =head2
11389 #: ../fish/guestfish-actions.pod:3075
11390 msgid "mkfs-b"
11391 msgstr "mkfs-b"
11392
11393 #. type: verbatim
11394 #: ../fish/guestfish-actions.pod:3077
11395 #, no-wrap
11396 msgid ""
11397 " mkfs-b fstype blocksize device\n"
11398 "\n"
11399 msgstr ""
11400
11401 #. type: textblock
11402 #: ../fish/guestfish-actions.pod:3079
11403 msgid ""
11404 "This call is similar to L</mkfs>, but it allows you to control the block "
11405 "size of the resulting filesystem.  Supported block sizes depend on the "
11406 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
11407 msgstr ""
11408
11409 #. type: textblock
11410 #: ../fish/guestfish-actions.pod:3084 ../fish/guestfish-actions.pod:3111
11411 #: ../src/guestfs-actions.pod:4625 ../src/guestfs-actions.pod:4670
11412 msgid ""
11413 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
11414 "cluster size."
11415 msgstr ""
11416
11417 #. type: textblock
11418 #: ../fish/guestfish-actions.pod:3087
11419 msgid ""
11420 "This function is deprecated.  In new code, use the L</mkfs_opts> call "
11421 "instead."
11422 msgstr ""
11423
11424 #. type: =head2
11425 #: ../fish/guestfish-actions.pod:3094
11426 msgid "mkfs-opts"
11427 msgstr "mkfs-opts"
11428
11429 #. type: verbatim
11430 #: ../fish/guestfish-actions.pod:3096
11431 #, no-wrap
11432 msgid ""
11433 " mkfs-opts fstype device [blocksize:..] [features:..] [inode:..] [sectorsize:..]\n"
11434 "\n"
11435 msgstr ""
11436
11437 #. type: textblock
11438 #: ../fish/guestfish-actions.pod:3098 ../src/guestfs-actions.pod:4657
11439 msgid ""
11440 "This function creates a filesystem on C<device>.  The filesystem type is "
11441 "C<fstype>, for example C<ext3>."
11442 msgstr ""
11443
11444 #. type: =item
11445 #: ../fish/guestfish-actions.pod:3105 ../src/guestfs-actions.pod:4664
11446 msgid "C<blocksize>"
11447 msgstr "C<blocksize>"
11448
11449 #. type: textblock
11450 #: ../fish/guestfish-actions.pod:3107 ../src/guestfs-actions.pod:4666
11451 msgid ""
11452 "The filesystem block size.  Supported block sizes depend on the filesystem "
11453 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
11454 "filesystems."
11455 msgstr ""
11456
11457 #. type: textblock
11458 #: ../fish/guestfish-actions.pod:3114 ../src/guestfs-actions.pod:4673
11459 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
11460 msgstr ""
11461
11462 #. type: =item
11463 #: ../fish/guestfish-actions.pod:3116 ../src/guestfs-actions.pod:4675
11464 msgid "C<features>"
11465 msgstr "C<features>"
11466
11467 #. type: textblock
11468 #: ../fish/guestfish-actions.pod:3118 ../src/guestfs-actions.pod:4677
11469 msgid "This passes the I<-O> parameter to the external mkfs program."
11470 msgstr ""
11471
11472 #. type: textblock
11473 #: ../fish/guestfish-actions.pod:3120 ../src/guestfs-actions.pod:4679
11474 msgid ""
11475 "For certain filesystem types, this allows extra filesystem features to be "
11476 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
11477 msgstr ""
11478
11479 #. type: textblock
11480 #: ../fish/guestfish-actions.pod:3124 ../src/guestfs-actions.pod:4683
11481 msgid ""
11482 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
11483 "type."
11484 msgstr ""
11485
11486 #. type: =item
11487 #: ../fish/guestfish-actions.pod:3127 ../src/guestfs-actions.pod:4686
11488 msgid "C<inode>"
11489 msgstr ""
11490
11491 #. type: textblock
11492 #: ../fish/guestfish-actions.pod:3129 ../src/guestfs-actions.pod:4688
11493 msgid ""
11494 "This passes the I<-I> parameter to the external L<mke2fs(8)> program which "
11495 "sets the inode size (only for ext2/3/4 filesystems at present)."
11496 msgstr ""
11497
11498 #. type: =item
11499 #: ../fish/guestfish-actions.pod:3132 ../src/guestfs-actions.pod:4691
11500 msgid "C<sectorsize>"
11501 msgstr ""
11502
11503 #. type: textblock
11504 #: ../fish/guestfish-actions.pod:3134 ../src/guestfs-actions.pod:4693
11505 msgid ""
11506 "This passes the I<-S> parameter to external L<mkfs.ufs(8)> program, which "
11507 "sets sector size for ufs filesystem."
11508 msgstr ""
11509
11510 #. type: =head2
11511 #: ../fish/guestfish-actions.pod:3141
11512 msgid "mkmountpoint"
11513 msgstr "mkmountpoint"
11514
11515 #. type: verbatim
11516 #: ../fish/guestfish-actions.pod:3143
11517 #, no-wrap
11518 msgid ""
11519 " mkmountpoint exemptpath\n"
11520 "\n"
11521 msgstr ""
11522
11523 #. type: textblock
11524 #: ../fish/guestfish-actions.pod:3145
11525 msgid ""
11526 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
11527 "to create extra mountpoints before mounting the first filesystem."
11528 msgstr ""
11529
11530 #. type: textblock
11531 #: ../fish/guestfish-actions.pod:3149 ../src/guestfs-actions.pod:4736
11532 msgid ""
11533 "These calls are I<only> necessary in some very limited circumstances, mainly "
11534 "the case where you want to mount a mix of unrelated and/or read-only "
11535 "filesystems together."
11536 msgstr ""
11537
11538 #. type: textblock
11539 #: ../fish/guestfish-actions.pod:3153 ../src/guestfs-actions.pod:4740
11540 msgid ""
11541 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
11542 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
11543 "inside that.  You can unpack this as follows in guestfish:"
11544 msgstr ""
11545
11546 #. type: verbatim
11547 #: ../fish/guestfish-actions.pod:3158 ../src/guestfs-actions.pod:4745
11548 #, no-wrap
11549 msgid ""
11550 " add-ro Fedora-11-i686-Live.iso\n"
11551 " run\n"
11552 " mkmountpoint /cd\n"
11553 " mkmountpoint /sqsh\n"
11554 " mkmountpoint /ext3fs\n"
11555 " mount /dev/sda /cd\n"
11556 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
11557 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
11558 "\n"
11559 msgstr ""
11560 " add-ro Fedora-11-i686-Live.iso\n"
11561 " run\n"
11562 " mkmountpoint /cd\n"
11563 " mkmountpoint /sqsh\n"
11564 " mkmountpoint /ext3fs\n"
11565 " mount /dev/sda /cd\n"
11566 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
11567 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
11568 "\n"
11569
11570 #. type: textblock
11571 #: ../fish/guestfish-actions.pod:3167 ../src/guestfs-actions.pod:4754
11572 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
11573 msgstr ""
11574
11575 #. type: textblock
11576 #: ../fish/guestfish-actions.pod:3169
11577 msgid ""
11578 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
11579 "unexpected errors if you try to mix these calls.  It is safest to manually "
11580 "unmount filesystems and remove mountpoints after use."
11581 msgstr ""
11582
11583 #. type: textblock
11584 #: ../fish/guestfish-actions.pod:3173
11585 msgid ""
11586 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
11587 "for this to work for manual mountpoints, you must ensure that the innermost "
11588 "mountpoints have the longest pathnames, as in the example code above."
11589 msgstr ""
11590
11591 #. type: textblock
11592 #: ../fish/guestfish-actions.pod:3178 ../src/guestfs-actions.pod:4765
11593 msgid ""
11594 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
11595 msgstr ""
11596
11597 #. type: textblock
11598 #: ../fish/guestfish-actions.pod:3180
11599 msgid ""
11600 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
11601 "L</umount-all> to be called when the handle is closed which can also trigger "
11602 "these issues."
11603 msgstr ""
11604
11605 #. type: =head2
11606 #: ../fish/guestfish-actions.pod:3184
11607 msgid "mknod"
11608 msgstr "mknod"
11609
11610 #. type: verbatim
11611 #: ../fish/guestfish-actions.pod:3186
11612 #, no-wrap
11613 msgid ""
11614 " mknod mode devmajor devminor path\n"
11615 "\n"
11616 msgstr ""
11617
11618 #. type: textblock
11619 #: ../fish/guestfish-actions.pod:3188 ../src/guestfs-actions.pod:4784
11620 msgid ""
11621 "This call creates block or character special devices, or named pipes (FIFOs)."
11622 msgstr ""
11623
11624 #. type: textblock
11625 #: ../fish/guestfish-actions.pod:3191 ../src/guestfs-actions.pod:4787
11626 msgid ""
11627 "The C<mode> parameter should be the mode, using the standard constants.  "
11628 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
11629 "used when creating block and character special devices."
11630 msgstr ""
11631
11632 #. type: textblock
11633 #: ../fish/guestfish-actions.pod:3196
11634 msgid ""
11635 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
11636 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
11637 "regular file).  These constants are available in the standard Linux header "
11638 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
11639 "wrappers around this command which bitwise OR in the appropriate constant "
11640 "for you."
11641 msgstr ""
11642
11643 #. type: =head2
11644 #: ../fish/guestfish-actions.pod:3206
11645 msgid "mknod-b"
11646 msgstr "mknod-b"
11647
11648 #. type: verbatim
11649 #: ../fish/guestfish-actions.pod:3208
11650 #, no-wrap
11651 msgid ""
11652 " mknod-b mode devmajor devminor path\n"
11653 "\n"
11654 msgstr ""
11655
11656 #. type: textblock
11657 #: ../fish/guestfish-actions.pod:3210
11658 msgid ""
11659 "This call creates a block device node called C<path> with mode C<mode> and "
11660 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
11661 "wrapper around L</mknod>."
11662 msgstr ""
11663
11664 #. type: =head2
11665 #: ../fish/guestfish-actions.pod:3216
11666 msgid "mknod-c"
11667 msgstr "mknod-c"
11668
11669 #. type: verbatim
11670 #: ../fish/guestfish-actions.pod:3218
11671 #, no-wrap
11672 msgid ""
11673 " mknod-c mode devmajor devminor path\n"
11674 "\n"
11675 msgstr ""
11676
11677 #. type: textblock
11678 #: ../fish/guestfish-actions.pod:3220
11679 msgid ""
11680 "This call creates a char device node called C<path> with mode C<mode> and "
11681 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
11682 "wrapper around L</mknod>."
11683 msgstr ""
11684
11685 #. type: =head2
11686 #: ../fish/guestfish-actions.pod:3226
11687 msgid "mkswap"
11688 msgstr "mkswap"
11689
11690 #. type: verbatim
11691 #: ../fish/guestfish-actions.pod:3228
11692 #, no-wrap
11693 msgid ""
11694 " mkswap device\n"
11695 "\n"
11696 msgstr ""
11697 " mkswap пристрій\n"
11698 "\n"
11699
11700 #. type: textblock
11701 #: ../fish/guestfish-actions.pod:3230 ../src/guestfs-actions.pod:4850
11702 msgid "Create a swap partition on C<device>."
11703 msgstr ""
11704
11705 #. type: =head2
11706 #: ../fish/guestfish-actions.pod:3232
11707 msgid "mkswap-L"
11708 msgstr "mkswap-L"
11709
11710 #. type: verbatim
11711 #: ../fish/guestfish-actions.pod:3234
11712 #, no-wrap
11713 msgid ""
11714 " mkswap-L label device\n"
11715 "\n"
11716 msgstr ""
11717 " mkswap-L мітка пристрій\n"
11718 "\n"
11719
11720 #. type: textblock
11721 #: ../fish/guestfish-actions.pod:3236 ../src/guestfs-actions.pod:4863
11722 msgid "Create a swap partition on C<device> with label C<label>."
11723 msgstr ""
11724
11725 #. type: textblock
11726 #: ../fish/guestfish-actions.pod:3238 ../src/guestfs-actions.pod:4865
11727 msgid ""
11728 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
11729 "sda>), just to a partition.  This appears to be a limitation of the kernel "
11730 "or swap tools."
11731 msgstr ""
11732
11733 #. type: =head2
11734 #: ../fish/guestfish-actions.pod:3242
11735 msgid "mkswap-U"
11736 msgstr "mkswap-U"
11737
11738 #. type: verbatim
11739 #: ../fish/guestfish-actions.pod:3244
11740 #, no-wrap
11741 msgid ""
11742 " mkswap-U uuid device\n"
11743 "\n"
11744 msgstr ""
11745 " mkswap-U uuid пристрій\n"
11746 "\n"
11747
11748 #. type: textblock
11749 #: ../fish/guestfish-actions.pod:3246 ../src/guestfs-actions.pod:4880
11750 msgid "Create a swap partition on C<device> with UUID C<uuid>."
11751 msgstr ""
11752
11753 #. type: =head2
11754 #: ../fish/guestfish-actions.pod:3248
11755 msgid "mkswap-file"
11756 msgstr "mkswap-file"
11757
11758 #. type: verbatim
11759 #: ../fish/guestfish-actions.pod:3250
11760 #, no-wrap
11761 msgid ""
11762 " mkswap-file path\n"
11763 "\n"
11764 msgstr ""
11765 " mkswap-file шлях\n"
11766 "\n"
11767
11768 #. type: textblock
11769 #: ../fish/guestfish-actions.pod:3252 ../src/guestfs-actions.pod:4892
11770 msgid "Create a swap file."
11771 msgstr "Створити файл резервної пам’яті."
11772
11773 #. type: textblock
11774 #: ../fish/guestfish-actions.pod:3254
11775 msgid ""
11776 "This command just writes a swap file signature to an existing file.  To "
11777 "create the file itself, use something like L</fallocate>."
11778 msgstr ""
11779
11780 #. type: =head2
11781 #: ../fish/guestfish-actions.pod:3257
11782 msgid "modprobe"
11783 msgstr "modprobe"
11784
11785 #. type: verbatim
11786 #: ../fish/guestfish-actions.pod:3259
11787 #, no-wrap
11788 msgid ""
11789 " modprobe modulename\n"
11790 "\n"
11791 msgstr ""
11792 " modprobe назва_модуля\n"
11793 "\n"
11794
11795 #. type: textblock
11796 #: ../fish/guestfish-actions.pod:3261 ../src/guestfs-actions.pod:4907
11797 msgid "This loads a kernel module in the appliance."
11798 msgstr ""
11799
11800 #. type: textblock
11801 #: ../fish/guestfish-actions.pod:3263 ../src/guestfs-actions.pod:4909
11802 msgid ""
11803 "The kernel module must have been whitelisted when libguestfs was built (see "
11804 "C<appliance/kmod.whitelist.in> in the source)."
11805 msgstr ""
11806
11807 #. type: =head2
11808 #: ../fish/guestfish-actions.pod:3266
11809 msgid "mount"
11810 msgstr "mount"
11811
11812 #. type: verbatim
11813 #: ../fish/guestfish-actions.pod:3268
11814 #, no-wrap
11815 msgid ""
11816 " mount device mountpoint\n"
11817 "\n"
11818 msgstr ""
11819 " mount пристрій точка_монтування\n"
11820 "\n"
11821
11822 #. type: textblock
11823 #: ../fish/guestfish-actions.pod:3270 ../src/guestfs-actions.pod:4923
11824 msgid ""
11825 "Mount a guest disk at a position in the filesystem.  Block devices are named "
11826 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
11827 "those block devices contain partitions, they will have the usual names (eg. "
11828 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
11829 msgstr ""
11830
11831 #. type: textblock
11832 #: ../fish/guestfish-actions.pod:3276 ../src/guestfs-actions.pod:4929
11833 msgid ""
11834 "The rules are the same as for L<mount(2)>: A filesystem must first be "
11835 "mounted on C</> before others can be mounted.  Other filesystems can only be "
11836 "mounted on directories which already exist."
11837 msgstr ""
11838
11839 #. type: textblock
11840 #: ../fish/guestfish-actions.pod:3281 ../src/guestfs-actions.pod:4934
11841 msgid ""
11842 "The mounted filesystem is writable, if we have sufficient permissions on the "
11843 "underlying device."
11844 msgstr ""
11845
11846 #. type: textblock
11847 #: ../fish/guestfish-actions.pod:3284
11848 msgid ""
11849 "B<Important note:> When you use this call, the filesystem options C<sync> "
11850 "and C<noatime> are set implicitly.  This was originally done because we "
11851 "thought it would improve reliability, but it turns out that I<-o sync> has a "
11852 "very large negative performance impact and negligible effect on "
11853 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
11854 "code that needs performance, and instead use L</mount-options> (use an empty "
11855 "string for the first parameter if you don't want any options)."
11856 msgstr ""
11857
11858 #. type: textblock
11859 #: ../fish/guestfish-actions.pod:3294
11860 msgid ""
11861 "This function is deprecated.  In new code, use the L</mount_options> call "
11862 "instead."
11863 msgstr ""
11864
11865 #. type: =head2
11866 #: ../fish/guestfish-actions.pod:3301
11867 msgid "mount-9p"
11868 msgstr ""
11869
11870 #. type: verbatim
11871 #: ../fish/guestfish-actions.pod:3303
11872 #, no-wrap
11873 msgid ""
11874 " mount-9p mounttag mountpoint [options:..]\n"
11875 "\n"
11876 msgstr ""
11877
11878 #. type: textblock
11879 #: ../fish/guestfish-actions.pod:3305 ../src/guestfs-actions.pod:4973
11880 msgid ""
11881 "Mount the virtio-9p filesystem with the tag C<mounttag> on the directory "
11882 "C<mountpoint>."
11883 msgstr ""
11884
11885 #. type: textblock
11886 #: ../fish/guestfish-actions.pod:3308 ../src/guestfs-actions.pod:4976
11887 msgid ""
11888 "If required, C<trans=virtio> will be automatically added to the options.  "
11889 "Any other options required can be passed in the optional C<options> "
11890 "parameter."
11891 msgstr ""
11892
11893 #. type: =head2
11894 #: ../fish/guestfish-actions.pod:3314
11895 msgid "mount-loop"
11896 msgstr "mount-loop"
11897
11898 #. type: verbatim
11899 #: ../fish/guestfish-actions.pod:3316
11900 #, no-wrap
11901 msgid ""
11902 " mount-loop file mountpoint\n"
11903 "\n"
11904 msgstr ""
11905
11906 #. type: textblock
11907 #: ../fish/guestfish-actions.pod:3318 ../src/guestfs-actions.pod:5015
11908 msgid ""
11909 "This command lets you mount C<file> (a filesystem image in a file) on a "
11910 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
11911 "mountpoint>."
11912 msgstr ""
11913
11914 #. type: =head2
11915 #: ../fish/guestfish-actions.pod:3322
11916 msgid "mount-options"
11917 msgstr "mount-options"
11918
11919 #. type: verbatim
11920 #: ../fish/guestfish-actions.pod:3324
11921 #, no-wrap
11922 msgid ""
11923 " mount-options options device mountpoint\n"
11924 "\n"
11925 msgstr ""
11926
11927 #. type: textblock
11928 #: ../fish/guestfish-actions.pod:3326
11929 msgid ""
11930 "This is the same as the L</mount> command, but it allows you to set the "
11931 "mount options as for the L<mount(8)> I<-o> flag."
11932 msgstr ""
11933
11934 #. type: textblock
11935 #: ../fish/guestfish-actions.pod:3330 ../src/guestfs-actions.pod:5035
11936 msgid ""
11937 "If the C<options> parameter is an empty string, then no options are passed "
11938 "(all options default to whatever the filesystem uses)."
11939 msgstr ""
11940
11941 #. type: =head2
11942 #: ../fish/guestfish-actions.pod:3334
11943 msgid "mount-ro"
11944 msgstr "mount-ro"
11945
11946 #. type: verbatim
11947 #: ../fish/guestfish-actions.pod:3336
11948 #, no-wrap
11949 msgid ""
11950 " mount-ro device mountpoint\n"
11951 "\n"
11952 msgstr ""
11953 " mount-ro пристрій точка_монтування\n"
11954 "\n"
11955
11956 #. type: textblock
11957 #: ../fish/guestfish-actions.pod:3338
11958 msgid ""
11959 "This is the same as the L</mount> command, but it mounts the filesystem with "
11960 "the read-only (I<-o ro>) flag."
11961 msgstr ""
11962
11963 #. type: =head2
11964 #: ../fish/guestfish-actions.pod:3341
11965 msgid "mount-vfs"
11966 msgstr "mount-vfs"
11967
11968 #. type: verbatim
11969 #: ../fish/guestfish-actions.pod:3343
11970 #, no-wrap
11971 msgid ""
11972 " mount-vfs options vfstype device mountpoint\n"
11973 "\n"
11974 msgstr ""
11975
11976 #. type: textblock
11977 #: ../fish/guestfish-actions.pod:3345
11978 msgid ""
11979 "This is the same as the L</mount> command, but it allows you to set both the "
11980 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
11981 msgstr ""
11982
11983 #. type: =head2
11984 #: ../fish/guestfish-actions.pod:3349
11985 msgid "mountpoints"
11986 msgstr "mountpoints"
11987
11988 #. type: verbatim
11989 #: ../fish/guestfish-actions.pod:3351
11990 #, no-wrap
11991 msgid ""
11992 " mountpoints\n"
11993 "\n"
11994 msgstr ""
11995 " mountpoints\n"
11996 "\n"
11997
11998 #. type: textblock
11999 #: ../fish/guestfish-actions.pod:3353
12000 msgid ""
12001 "This call is similar to L</mounts>.  That call returns a list of devices.  "
12002 "This one returns a hash table (map) of device name to directory where the "
12003 "device is mounted."
12004 msgstr ""
12005
12006 #. type: =head2
12007 #: ../fish/guestfish-actions.pod:3357
12008 msgid "mounts"
12009 msgstr "mounts"
12010
12011 #. type: verbatim
12012 #: ../fish/guestfish-actions.pod:3359
12013 #, no-wrap
12014 msgid ""
12015 " mounts\n"
12016 "\n"
12017 msgstr ""
12018 " mounts\n"
12019 "\n"
12020
12021 #. type: textblock
12022 #: ../fish/guestfish-actions.pod:3361 ../src/guestfs-actions.pod:5096
12023 msgid ""
12024 "This returns the list of currently mounted filesystems.  It returns the list "
12025 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
12026 msgstr ""
12027
12028 #. type: textblock
12029 #: ../fish/guestfish-actions.pod:3364 ../src/guestfs-actions.pod:5099
12030 msgid "Some internal mounts are not shown."
12031 msgstr ""
12032
12033 #. type: textblock
12034 #: ../fish/guestfish-actions.pod:3366
12035 msgid "See also: L</mountpoints>"
12036 msgstr "Див. також L</mountpoints>"
12037
12038 #. type: =head2
12039 #: ../fish/guestfish-actions.pod:3368
12040 msgid "mv"
12041 msgstr "mv"
12042
12043 #. type: verbatim
12044 #: ../fish/guestfish-actions.pod:3370
12045 #, no-wrap
12046 msgid ""
12047 " mv src dest\n"
12048 "\n"
12049 msgstr ""
12050 " mv джерело призначення\n"
12051 "\n"
12052
12053 #. type: textblock
12054 #: ../fish/guestfish-actions.pod:3372 ../src/guestfs-actions.pod:5116
12055 msgid ""
12056 "This moves a file from C<src> to C<dest> where C<dest> is either a "
12057 "destination filename or destination directory."
12058 msgstr ""
12059
12060 #. type: =head2
12061 #: ../fish/guestfish-actions.pod:3375
12062 msgid "ntfs-3g-probe"
12063 msgstr "ntfs-3g-probe"
12064
12065 #. type: verbatim
12066 #: ../fish/guestfish-actions.pod:3377
12067 #, no-wrap
12068 msgid ""
12069 " ntfs-3g-probe true|false device\n"
12070 "\n"
12071 msgstr ""
12072
12073 #. type: textblock
12074 #: ../fish/guestfish-actions.pod:3379 ../src/guestfs-actions.pod:5130
12075 msgid ""
12076 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
12077 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
12078 "write, and some cannot be mounted at all)."
12079 msgstr ""
12080
12081 #. type: textblock
12082 #: ../fish/guestfish-actions.pod:3383 ../src/guestfs-actions.pod:5134
12083 msgid ""
12084 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
12085 "can be mounted read-write.  Set it to false if you want to test if the "
12086 "volume can be mounted read-only."
12087 msgstr ""
12088
12089 #. type: textblock
12090 #: ../fish/guestfish-actions.pod:3387 ../src/guestfs-actions.pod:5138
12091 msgid ""
12092 "The return value is an integer which C<0> if the operation would succeed, or "
12093 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
12094 msgstr ""
12095
12096 #. type: =head2
12097 #: ../fish/guestfish-actions.pod:3391
12098 msgid "ntfsresize"
12099 msgstr "ntfsresize"
12100
12101 #. type: verbatim
12102 #: ../fish/guestfish-actions.pod:3393
12103 #, no-wrap
12104 msgid ""
12105 " ntfsresize device\n"
12106 "\n"
12107 msgstr ""
12108 " ntfsresize пристрій\n"
12109 "\n"
12110
12111 #. type: textblock
12112 #: ../fish/guestfish-actions.pod:3395 ../fish/guestfish-actions.pod:3419
12113 #: ../src/guestfs-actions.pod:5152 ../src/guestfs-actions.pod:5191
12114 msgid ""
12115 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
12116 "size of the underlying device."
12117 msgstr ""
12118
12119 #. type: textblock
12120 #: ../fish/guestfish-actions.pod:3398 ../src/guestfs-actions.pod:5155
12121 msgid ""
12122 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
12123 "consistency check (for safety).  You have to boot into Windows to perform "
12124 "this check and clear this condition.  Furthermore, ntfsresize refuses to "
12125 "resize filesystems which have been marked in this way.  So in effect it is "
12126 "not possible to call ntfsresize multiple times on a single filesystem "
12127 "without booting into Windows between each resize."
12128 msgstr ""
12129
12130 #. type: textblock
12131 #: ../fish/guestfish-actions.pod:3406 ../fish/guestfish-actions.pod:3445
12132 #: ../src/guestfs-actions.pod:5163 ../src/guestfs-actions.pod:5217
12133 msgid "See also L<ntfsresize(8)>."
12134 msgstr ""
12135
12136 #. type: textblock
12137 #: ../fish/guestfish-actions.pod:3408 ../fish/guestfish-actions.pod:3456
12138 msgid ""
12139 "This function is deprecated.  In new code, use the L</ntfsresize_opts> call "
12140 "instead."
12141 msgstr ""
12142
12143 #. type: =head2
12144 #: ../fish/guestfish-actions.pod:3415
12145 msgid "ntfsresize-opts"
12146 msgstr ""
12147
12148 #. type: verbatim
12149 #: ../fish/guestfish-actions.pod:3417
12150 #, no-wrap
12151 msgid ""
12152 " ntfsresize-opts device [size:..] [force:..]\n"
12153 "\n"
12154 msgstr ""
12155
12156 #. type: textblock
12157 #: ../fish/guestfish-actions.pod:3428 ../src/guestfs-actions.pod:5200
12158 msgid ""
12159 "The new size (in bytes) of the filesystem.  If omitted, the filesystem is "
12160 "resized to fit the container (eg. partition)."
12161 msgstr ""
12162
12163 #. type: =item
12164 #: ../fish/guestfish-actions.pod:3431 ../src/guestfs-actions.pod:5203
12165 msgid "C<force>"
12166 msgstr ""
12167
12168 #. type: textblock
12169 #: ../fish/guestfish-actions.pod:3433 ../src/guestfs-actions.pod:5205
12170 msgid ""
12171 "If this option is true, then force the resize of the filesystem even if the "
12172 "filesystem is marked as requiring a consistency check."
12173 msgstr ""
12174
12175 #. type: textblock
12176 #: ../fish/guestfish-actions.pod:3436
12177 msgid ""
12178 "After the resize operation, the filesystem is always marked as requiring a "
12179 "consistency check (for safety).  You have to boot into Windows to perform "
12180 "this check and clear this condition.  If you I<don't> set the C<force> "
12181 "option then it is not possible to call L</ntfsresize-opts> multiple times on "
12182 "a single filesystem without booting into Windows between each resize."
12183 msgstr ""
12184
12185 #. type: =head2
12186 #: ../fish/guestfish-actions.pod:3449
12187 msgid "ntfsresize-size"
12188 msgstr "ntfsresize-size"
12189
12190 #. type: verbatim
12191 #: ../fish/guestfish-actions.pod:3451
12192 #, no-wrap
12193 msgid ""
12194 " ntfsresize-size device size\n"
12195 "\n"
12196 msgstr ""
12197
12198 #. type: textblock
12199 #: ../fish/guestfish-actions.pod:3453
12200 msgid ""
12201 "This command is the same as L</ntfsresize> except that it allows you to "
12202 "specify the new size (in bytes) explicitly."
12203 msgstr ""
12204
12205 #. type: =head2
12206 #: ../fish/guestfish-actions.pod:3463
12207 msgid "part-add"
12208 msgstr "part-add"
12209
12210 #. type: verbatim
12211 #: ../fish/guestfish-actions.pod:3465
12212 #, no-wrap
12213 msgid ""
12214 " part-add device prlogex startsect endsect\n"
12215 "\n"
12216 msgstr ""
12217
12218 #. type: textblock
12219 #: ../fish/guestfish-actions.pod:3467
12220 msgid ""
12221 "This command adds a partition to C<device>.  If there is no partition table "
12222 "on the device, call L</part-init> first."
12223 msgstr ""
12224
12225 #. type: textblock
12226 #: ../fish/guestfish-actions.pod:3470 ../src/guestfs-actions.pod:5278
12227 msgid ""
12228 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
12229 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
12230 "C<logical>) and C<e> (or C<extended>) partition types."
12231 msgstr ""
12232
12233 #. type: textblock
12234 #: ../fish/guestfish-actions.pod:3475 ../src/guestfs-actions.pod:5283
12235 msgid ""
12236 "C<startsect> and C<endsect> are the start and end of the partition in "
12237 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
12238 "from the end of the disk (C<-1> is the last sector)."
12239 msgstr ""
12240
12241 #. type: textblock
12242 #: ../fish/guestfish-actions.pod:3479
12243 msgid ""
12244 "Creating a partition which covers the whole disk is not so easy.  Use L</"
12245 "part-disk> to do that."
12246 msgstr ""
12247
12248 #. type: =head2
12249 #: ../fish/guestfish-actions.pod:3482
12250 msgid "part-del"
12251 msgstr "part-del"
12252
12253 #. type: verbatim
12254 #: ../fish/guestfish-actions.pod:3484
12255 #, no-wrap
12256 msgid ""
12257 " part-del device partnum\n"
12258 "\n"
12259 msgstr ""
12260
12261 #. type: textblock
12262 #: ../fish/guestfish-actions.pod:3486 ../src/guestfs-actions.pod:5301
12263 msgid "This command deletes the partition numbered C<partnum> on C<device>."
12264 msgstr ""
12265
12266 #. type: textblock
12267 #: ../fish/guestfish-actions.pod:3488 ../src/guestfs-actions.pod:5303
12268 msgid ""
12269 "Note that in the case of MBR partitioning, deleting an extended partition "
12270 "also deletes any logical partitions it contains."
12271 msgstr ""
12272
12273 #. type: =head2
12274 #: ../fish/guestfish-actions.pod:3492
12275 msgid "part-disk"
12276 msgstr "part-disk"
12277
12278 #. type: verbatim
12279 #: ../fish/guestfish-actions.pod:3494
12280 #, no-wrap
12281 msgid ""
12282 " part-disk device parttype\n"
12283 "\n"
12284 msgstr ""
12285 " part-disk пристрій тип_розділу\n"
12286 "\n"
12287
12288 #. type: textblock
12289 #: ../fish/guestfish-actions.pod:3496
12290 msgid ""
12291 "This command is simply a combination of L</part-init> followed by L</part-"
12292 "add> to create a single primary partition covering the whole disk."
12293 msgstr ""
12294
12295 #. type: textblock
12296 #: ../fish/guestfish-actions.pod:3500
12297 msgid ""
12298 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
12299 "possible values are described in L</part-init>."
12300 msgstr ""
12301
12302 #. type: =head2
12303 #: ../fish/guestfish-actions.pod:3506
12304 msgid "part-get-bootable"
12305 msgstr "part-get-bootable"
12306
12307 #. type: verbatim
12308 #: ../fish/guestfish-actions.pod:3508
12309 #, no-wrap
12310 msgid ""
12311 " part-get-bootable device partnum\n"
12312 "\n"
12313 msgstr ""
12314
12315 #. type: textblock
12316 #: ../fish/guestfish-actions.pod:3510 ../src/guestfs-actions.pod:5339
12317 msgid ""
12318 "This command returns true if the partition C<partnum> on C<device> has the "
12319 "bootable flag set."
12320 msgstr ""
12321
12322 #. type: textblock
12323 #: ../fish/guestfish-actions.pod:3513
12324 msgid "See also L</part-set-bootable>."
12325 msgstr "Див. також L</part-set-bootable>."
12326
12327 #. type: =head2
12328 #: ../fish/guestfish-actions.pod:3515
12329 msgid "part-get-mbr-id"
12330 msgstr "part-get-mbr-id"
12331
12332 #. type: verbatim
12333 #: ../fish/guestfish-actions.pod:3517
12334 #, no-wrap
12335 msgid ""
12336 " part-get-mbr-id device partnum\n"
12337 "\n"
12338 msgstr ""
12339
12340 #. type: textblock
12341 #: ../fish/guestfish-actions.pod:3519 ../src/guestfs-actions.pod:5355
12342 msgid ""
12343 "Returns the MBR type byte (also known as the ID byte) from the numbered "
12344 "partition C<partnum>."
12345 msgstr ""
12346
12347 #. type: textblock
12348 #: ../fish/guestfish-actions.pod:3522 ../fish/guestfish-actions.pod:3666
12349 msgid ""
12350 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
12351 "undefined results for other partition table types (see L</part-get-"
12352 "parttype>)."
12353 msgstr ""
12354
12355 #. type: =head2
12356 #: ../fish/guestfish-actions.pod:3526
12357 msgid "part-get-parttype"
12358 msgstr "part-get-parttype"
12359
12360 #. type: verbatim
12361 #: ../fish/guestfish-actions.pod:3528
12362 #, no-wrap
12363 msgid ""
12364 " part-get-parttype device\n"
12365 "\n"
12366 msgstr ""
12367 " part-get-parttype пристрій\n"
12368 "\n"
12369
12370 #. type: textblock
12371 #: ../fish/guestfish-actions.pod:3530 ../src/guestfs-actions.pod:5372
12372 msgid ""
12373 "This command examines the partition table on C<device> and returns the "
12374 "partition table type (format) being used."
12375 msgstr ""
12376
12377 #. type: textblock
12378 #: ../fish/guestfish-actions.pod:3533
12379 msgid ""
12380 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
12381 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
12382 "possible, although unusual.  See L</part-init> for a full list."
12383 msgstr ""
12384
12385 #. type: =head2
12386 #: ../fish/guestfish-actions.pod:3538
12387 msgid "part-init"
12388 msgstr "part-init"
12389
12390 #. type: verbatim
12391 #: ../fish/guestfish-actions.pod:3540
12392 #, no-wrap
12393 msgid ""
12394 " part-init device parttype\n"
12395 "\n"
12396 msgstr ""
12397
12398 #. type: textblock
12399 #: ../fish/guestfish-actions.pod:3542 ../src/guestfs-actions.pod:5392
12400 msgid ""
12401 "This creates an empty partition table on C<device> of one of the partition "
12402 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
12403 "(for large disks)."
12404 msgstr ""
12405
12406 #. type: textblock
12407 #: ../fish/guestfish-actions.pod:3546
12408 msgid ""
12409 "Initially there are no partitions.  Following this, you should call L</part-"
12410 "add> for each partition required."
12411 msgstr ""
12412
12413 #. type: textblock
12414 #: ../fish/guestfish-actions.pod:3549 ../src/guestfs-actions.pod:5399
12415 msgid "Possible values for C<parttype> are:"
12416 msgstr ""
12417
12418 #. type: =item
12419 #: ../fish/guestfish-actions.pod:3553 ../src/guestfs-actions.pod:5403
12420 msgid "B<efi>"
12421 msgstr ""
12422
12423 #. type: =item
12424 #: ../fish/guestfish-actions.pod:3555 ../src/guestfs-actions.pod:5405
12425 msgid "B<gpt>"
12426 msgstr ""
12427
12428 #. type: textblock
12429 #: ../fish/guestfish-actions.pod:3557 ../src/guestfs-actions.pod:5407
12430 msgid "Intel EFI / GPT partition table."
12431 msgstr ""
12432
12433 #. type: textblock
12434 #: ../fish/guestfish-actions.pod:3559 ../src/guestfs-actions.pod:5409
12435 msgid ""
12436 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
12437 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
12438 "the C<mbr> format."
12439 msgstr ""
12440
12441 #. type: =item
12442 #: ../fish/guestfish-actions.pod:3563 ../src/guestfs-actions.pod:5413
12443 msgid "B<mbr>"
12444 msgstr ""
12445
12446 #. type: =item
12447 #: ../fish/guestfish-actions.pod:3565 ../src/guestfs-actions.pod:5415
12448 msgid "B<msdos>"
12449 msgstr ""
12450
12451 #. type: textblock
12452 #: ../fish/guestfish-actions.pod:3567 ../src/guestfs-actions.pod:5417
12453 msgid ""
12454 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
12455 "Windows.  This partition type will B<only> work for device sizes up to 2 "
12456 "TB.  For large disks we recommend using C<gpt>."
12457 msgstr ""
12458
12459 #. type: textblock
12460 #: ../fish/guestfish-actions.pod:3574 ../src/guestfs-actions.pod:5424
12461 msgid ""
12462 "Other partition table types that may work but are not supported include:"
12463 msgstr ""
12464
12465 #. type: =item
12466 #: ../fish/guestfish-actions.pod:3579 ../src/guestfs-actions.pod:5429
12467 msgid "B<aix>"
12468 msgstr "B<aix>"
12469
12470 #. type: textblock
12471 #: ../fish/guestfish-actions.pod:3581 ../src/guestfs-actions.pod:5431
12472 msgid "AIX disk labels."
12473 msgstr "Мітки дисків AIX."
12474
12475 #. type: =item
12476 #: ../fish/guestfish-actions.pod:3583 ../src/guestfs-actions.pod:5433
12477 #, fuzzy
12478 #| msgid "B<amiga> | B<rdb>"
12479 msgid "B<amiga>"
12480 msgstr "B<amiga> | B<rdb>"
12481
12482 #. type: =item
12483 #: ../fish/guestfish-actions.pod:3585 ../src/guestfs-actions.pod:5435
12484 msgid "B<rdb>"
12485 msgstr ""
12486
12487 #. type: textblock
12488 #: ../fish/guestfish-actions.pod:3587 ../src/guestfs-actions.pod:5437
12489 msgid "Amiga \"Rigid Disk Block\" format."
12490 msgstr "Формат \"Rigid Disk Block\" Amiga."
12491
12492 #. type: =item
12493 #: ../fish/guestfish-actions.pod:3589 ../src/guestfs-actions.pod:5439
12494 msgid "B<bsd>"
12495 msgstr "B<bsd>"
12496
12497 #. type: textblock
12498 #: ../fish/guestfish-actions.pod:3591 ../src/guestfs-actions.pod:5441
12499 msgid "BSD disk labels."
12500 msgstr "Мітки дисків BSD."
12501
12502 #. type: =item
12503 #: ../fish/guestfish-actions.pod:3593 ../src/guestfs-actions.pod:5443
12504 msgid "B<dasd>"
12505 msgstr "B<dasd>"
12506
12507 #. type: textblock
12508 #: ../fish/guestfish-actions.pod:3595 ../src/guestfs-actions.pod:5445
12509 msgid "DASD, used on IBM mainframes."
12510 msgstr "DASD, використовувалися у мейнфреймах IBM."
12511
12512 #. type: =item
12513 #: ../fish/guestfish-actions.pod:3597 ../src/guestfs-actions.pod:5447
12514 msgid "B<dvh>"
12515 msgstr "B<dvh>"
12516
12517 #. type: textblock
12518 #: ../fish/guestfish-actions.pod:3599 ../src/guestfs-actions.pod:5449
12519 msgid "MIPS/SGI volumes."
12520 msgstr "Томи MIPS/SGI."
12521
12522 #. type: =item
12523 #: ../fish/guestfish-actions.pod:3601 ../src/guestfs-actions.pod:5451
12524 msgid "B<mac>"
12525 msgstr "B<mac>"
12526
12527 #. type: textblock
12528 #: ../fish/guestfish-actions.pod:3603 ../src/guestfs-actions.pod:5453
12529 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
12530 msgstr "Старий формат розділів Mac. Сучасні системи Mac використовують C<gpt>."
12531
12532 #. type: =item
12533 #: ../fish/guestfish-actions.pod:3605 ../src/guestfs-actions.pod:5455
12534 msgid "B<pc98>"
12535 msgstr "B<pc98>"
12536
12537 #. type: textblock
12538 #: ../fish/guestfish-actions.pod:3607 ../src/guestfs-actions.pod:5457
12539 msgid "NEC PC-98 format, common in Japan apparently."
12540 msgstr "Формат NEC PC-98, поширений у Японії."
12541
12542 #. type: =item
12543 #: ../fish/guestfish-actions.pod:3609 ../src/guestfs-actions.pod:5459
12544 msgid "B<sun>"
12545 msgstr "B<sun>"
12546
12547 #. type: textblock
12548 #: ../fish/guestfish-actions.pod:3611 ../src/guestfs-actions.pod:5461
12549 msgid "Sun disk labels."
12550 msgstr "Мітки дисків Sun."
12551
12552 #. type: =head2
12553 #: ../fish/guestfish-actions.pod:3615
12554 msgid "part-list"
12555 msgstr "part-list"
12556
12557 #. type: verbatim
12558 #: ../fish/guestfish-actions.pod:3617
12559 #, no-wrap
12560 msgid ""
12561 " part-list device\n"
12562 "\n"
12563 msgstr ""
12564 " part-list device\n"
12565 "\n"
12566
12567 #. type: textblock
12568 #: ../fish/guestfish-actions.pod:3619 ../src/guestfs-actions.pod:5475
12569 msgid ""
12570 "This command parses the partition table on C<device> and returns the list of "
12571 "partitions found."
12572 msgstr ""
12573
12574 #. type: textblock
12575 #: ../fish/guestfish-actions.pod:3622 ../src/guestfs-actions.pod:5478
12576 msgid "The fields in the returned structure are:"
12577 msgstr ""
12578
12579 #. type: =item
12580 #: ../fish/guestfish-actions.pod:3626 ../src/guestfs-actions.pod:5482
12581 msgid "B<part_num>"
12582 msgstr "B<part_num>"
12583
12584 #. type: textblock
12585 #: ../fish/guestfish-actions.pod:3628 ../src/guestfs-actions.pod:5484
12586 msgid "Partition number, counting from 1."
12587 msgstr ""
12588
12589 #. type: =item
12590 #: ../fish/guestfish-actions.pod:3630 ../src/guestfs-actions.pod:5486
12591 msgid "B<part_start>"
12592 msgstr "B<part_start>"
12593
12594 #. type: textblock
12595 #: ../fish/guestfish-actions.pod:3632
12596 msgid ""
12597 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
12598 "the device's sector size, see L</blockdev-getss>."
12599 msgstr ""
12600
12601 #. type: =item
12602 #: ../fish/guestfish-actions.pod:3635 ../src/guestfs-actions.pod:5491
12603 msgid "B<part_end>"
12604 msgstr "B<part_end>"
12605
12606 #. type: textblock
12607 #: ../fish/guestfish-actions.pod:3637 ../src/guestfs-actions.pod:5493
12608 msgid "End of the partition in bytes."
12609 msgstr ""
12610
12611 #. type: =item
12612 #: ../fish/guestfish-actions.pod:3639 ../src/guestfs-actions.pod:5495
12613 msgid "B<part_size>"
12614 msgstr "B<part_size>"
12615
12616 #. type: textblock
12617 #: ../fish/guestfish-actions.pod:3641 ../src/guestfs-actions.pod:5497
12618 msgid "Size of the partition in bytes."
12619 msgstr ""
12620
12621 #. type: =head2
12622 #: ../fish/guestfish-actions.pod:3645
12623 msgid "part-set-bootable"
12624 msgstr "part-set-bootable"
12625
12626 #. type: verbatim
12627 #: ../fish/guestfish-actions.pod:3647
12628 #, no-wrap
12629 msgid ""
12630 " part-set-bootable device partnum true|false\n"
12631 "\n"
12632 msgstr ""
12633
12634 #. type: textblock
12635 #: ../fish/guestfish-actions.pod:3649 ../src/guestfs-actions.pod:5515
12636 msgid ""
12637 "This sets the bootable flag on partition numbered C<partnum> on device "
12638 "C<device>.  Note that partitions are numbered from 1."
12639 msgstr ""
12640
12641 #. type: textblock
12642 #: ../fish/guestfish-actions.pod:3652 ../src/guestfs-actions.pod:5518
12643 msgid ""
12644 "The bootable flag is used by some operating systems (notably Windows) to "
12645 "determine which partition to boot from.  It is by no means universally "
12646 "recognized."
12647 msgstr ""
12648
12649 #. type: =head2
12650 #: ../fish/guestfish-actions.pod:3656
12651 msgid "part-set-mbr-id"
12652 msgstr "part-set-mbr-id"
12653
12654 #. type: verbatim
12655 #: ../fish/guestfish-actions.pod:3658
12656 #, no-wrap
12657 msgid ""
12658 " part-set-mbr-id device partnum idbyte\n"
12659 "\n"
12660 msgstr ""
12661
12662 #. type: textblock
12663 #: ../fish/guestfish-actions.pod:3660 ../src/guestfs-actions.pod:5534
12664 msgid ""
12665 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
12666 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
12667 "documentation are in fact hexadecimal numbers, but usually documented "
12668 "without any leading \"0x\" which might be confusing."
12669 msgstr ""
12670
12671 #. type: =head2
12672 #: ../fish/guestfish-actions.pod:3670
12673 msgid "part-set-name"
12674 msgstr "part-set-name"
12675
12676 #. type: verbatim
12677 #: ../fish/guestfish-actions.pod:3672
12678 #, no-wrap
12679 msgid ""
12680 " part-set-name device partnum name\n"
12681 "\n"
12682 msgstr ""
12683
12684 #. type: textblock
12685 #: ../fish/guestfish-actions.pod:3674 ../src/guestfs-actions.pod:5556
12686 msgid ""
12687 "This sets the partition name on partition numbered C<partnum> on device "
12688 "C<device>.  Note that partitions are numbered from 1."
12689 msgstr ""
12690
12691 #. type: textblock
12692 #: ../fish/guestfish-actions.pod:3677 ../src/guestfs-actions.pod:5559
12693 msgid ""
12694 "The partition name can only be set on certain types of partition table.  "
12695 "This works on C<gpt> but not on C<mbr> partitions."
12696 msgstr ""
12697
12698 #. type: =head2
12699 #: ../fish/guestfish-actions.pod:3680
12700 msgid "part-to-dev"
12701 msgstr "part-to-dev"
12702
12703 #. type: verbatim
12704 #: ../fish/guestfish-actions.pod:3682
12705 #, no-wrap
12706 msgid ""
12707 " part-to-dev partition\n"
12708 "\n"
12709 msgstr ""
12710 " part-to-dev розділ\n"
12711 "\n"
12712
12713 #. type: textblock
12714 #: ../fish/guestfish-actions.pod:3684 ../src/guestfs-actions.pod:5572
12715 msgid ""
12716 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
12717 "partition number, returning the device name (eg. \"/dev/sdb\")."
12718 msgstr ""
12719
12720 #. type: textblock
12721 #: ../fish/guestfish-actions.pod:3688
12722 msgid ""
12723 "The named partition must exist, for example as a string returned from L</"
12724 "list-partitions>."
12725 msgstr ""
12726
12727 #. type: =head2
12728 #: ../fish/guestfish-actions.pod:3691
12729 msgid "ping-daemon"
12730 msgstr "ping-daemon"
12731
12732 #. type: verbatim
12733 #: ../fish/guestfish-actions.pod:3693
12734 #, no-wrap
12735 msgid ""
12736 " ping-daemon\n"
12737 "\n"
12738 msgstr ""
12739 " ping-daemon\n"
12740 "\n"
12741
12742 #. type: textblock
12743 #: ../fish/guestfish-actions.pod:3695 ../src/guestfs-actions.pod:5589
12744 msgid ""
12745 "This is a test probe into the guestfs daemon running inside the qemu "
12746 "subprocess.  Calling this function checks that the daemon responds to the "
12747 "ping message, without affecting the daemon or attached block device(s) in "
12748 "any other way."
12749 msgstr ""
12750
12751 #. type: =head2
12752 #: ../fish/guestfish-actions.pod:3700
12753 msgid "pread"
12754 msgstr "pread"
12755
12756 #. type: verbatim
12757 #: ../fish/guestfish-actions.pod:3702
12758 #, no-wrap
12759 msgid ""
12760 " pread path count offset\n"
12761 "\n"
12762 msgstr ""
12763
12764 #. type: textblock
12765 #: ../fish/guestfish-actions.pod:3704 ../src/guestfs-actions.pod:5607
12766 msgid ""
12767 "This command lets you read part of a file.  It reads C<count> bytes of the "
12768 "file, starting at C<offset>, from file C<path>."
12769 msgstr ""
12770
12771 #. type: textblock
12772 #: ../fish/guestfish-actions.pod:3707 ../fish/guestfish-actions.pod:3722
12773 #: ../src/guestfs-actions.pod:5610 ../src/guestfs-actions.pod:5636
12774 msgid ""
12775 "This may read fewer bytes than requested.  For further details see the "
12776 "L<pread(2)> system call."
12777 msgstr ""
12778
12779 #. type: textblock
12780 #: ../fish/guestfish-actions.pod:3710
12781 msgid "See also L</pwrite>, L</pread-device>."
12782 msgstr "Див. також L</pwrite>, L</pread-device>."
12783
12784 #. type: =head2
12785 #: ../fish/guestfish-actions.pod:3715
12786 msgid "pread-device"
12787 msgstr "pread-device"
12788
12789 #. type: verbatim
12790 #: ../fish/guestfish-actions.pod:3717
12791 #, no-wrap
12792 msgid ""
12793 " pread-device device count offset\n"
12794 "\n"
12795 msgstr ""
12796
12797 #. type: textblock
12798 #: ../fish/guestfish-actions.pod:3719 ../src/guestfs-actions.pod:5633
12799 msgid ""
12800 "This command lets you read part of a file.  It reads C<count> bytes of "
12801 "C<device>, starting at C<offset>."
12802 msgstr ""
12803
12804 #. type: textblock
12805 #: ../fish/guestfish-actions.pod:3725
12806 msgid "See also L</pread>."
12807 msgstr "Див. також L</pread>."
12808
12809 #. type: =head2
12810 #: ../fish/guestfish-actions.pod:3730
12811 msgid "pvcreate"
12812 msgstr "pvcreate"
12813
12814 #. type: verbatim
12815 #: ../fish/guestfish-actions.pod:3732
12816 #, no-wrap
12817 msgid ""
12818 " pvcreate device\n"
12819 "\n"
12820 msgstr ""
12821 " pvcreate пристрій\n"
12822 "\n"
12823
12824 #. type: textblock
12825 #: ../fish/guestfish-actions.pod:3734 ../src/guestfs-actions.pod:5656
12826 msgid ""
12827 "This creates an LVM physical volume on the named C<device>, where C<device> "
12828 "should usually be a partition name such as C</dev/sda1>."
12829 msgstr ""
12830
12831 #. type: =head2
12832 #: ../fish/guestfish-actions.pod:3738
12833 msgid "pvremove"
12834 msgstr "pvremove"
12835
12836 #. type: verbatim
12837 #: ../fish/guestfish-actions.pod:3740
12838 #, no-wrap
12839 msgid ""
12840 " pvremove device\n"
12841 "\n"
12842 msgstr ""
12843 " pvremove пристрій\n"
12844 "\n"
12845
12846 #. type: textblock
12847 #: ../fish/guestfish-actions.pod:3742 ../src/guestfs-actions.pod:5670
12848 msgid ""
12849 "This wipes a physical volume C<device> so that LVM will no longer recognise "
12850 "it."
12851 msgstr ""
12852
12853 #. type: textblock
12854 #: ../fish/guestfish-actions.pod:3745 ../src/guestfs-actions.pod:5673
12855 msgid ""
12856 "The implementation uses the C<pvremove> command which refuses to wipe "
12857 "physical volumes that contain any volume groups, so you have to remove those "
12858 "first."
12859 msgstr ""
12860
12861 #. type: =head2
12862 #: ../fish/guestfish-actions.pod:3749
12863 msgid "pvresize"
12864 msgstr "pvresize"
12865
12866 #. type: verbatim
12867 #: ../fish/guestfish-actions.pod:3751
12868 #, no-wrap
12869 msgid ""
12870 " pvresize device\n"
12871 "\n"
12872 msgstr ""
12873 " pvresize пристрій\n"
12874 "\n"
12875
12876 #. type: textblock
12877 #: ../fish/guestfish-actions.pod:3753 ../src/guestfs-actions.pod:5687
12878 msgid ""
12879 "This resizes (expands or shrinks) an existing LVM physical volume to match "
12880 "the new size of the underlying device."
12881 msgstr ""
12882
12883 #. type: =head2
12884 #: ../fish/guestfish-actions.pod:3756
12885 msgid "pvresize-size"
12886 msgstr "pvresize-size"
12887
12888 #. type: verbatim
12889 #: ../fish/guestfish-actions.pod:3758
12890 #, no-wrap
12891 msgid ""
12892 " pvresize-size device size\n"
12893 "\n"
12894 msgstr ""
12895
12896 #. type: textblock
12897 #: ../fish/guestfish-actions.pod:3760
12898 msgid ""
12899 "This command is the same as L</pvresize> except that it allows you to "
12900 "specify the new size (in bytes) explicitly."
12901 msgstr ""
12902
12903 #. type: =head2
12904 #: ../fish/guestfish-actions.pod:3763
12905 msgid "pvs"
12906 msgstr "pvs"
12907
12908 #. type: verbatim
12909 #: ../fish/guestfish-actions.pod:3765
12910 #, no-wrap
12911 msgid ""
12912 " pvs\n"
12913 "\n"
12914 msgstr ""
12915 " pvs\n"
12916 "\n"
12917
12918 #. type: textblock
12919 #: ../fish/guestfish-actions.pod:3767 ../src/guestfs-actions.pod:5713
12920 msgid ""
12921 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
12922 "(8)> command."
12923 msgstr ""
12924
12925 #. type: textblock
12926 #: ../fish/guestfish-actions.pod:3770 ../src/guestfs-actions.pod:5716
12927 msgid ""
12928 "This returns a list of just the device names that contain PVs (eg. C</dev/"
12929 "sda2>)."
12930 msgstr ""
12931
12932 #. type: textblock
12933 #: ../fish/guestfish-actions.pod:3773
12934 msgid "See also L</pvs-full>."
12935 msgstr "Див. також L</pvs-full>."
12936
12937 #. type: =head2
12938 #: ../fish/guestfish-actions.pod:3775
12939 msgid "pvs-full"
12940 msgstr "pvs-full"
12941
12942 #. type: verbatim
12943 #: ../fish/guestfish-actions.pod:3777
12944 #, no-wrap
12945 msgid ""
12946 " pvs-full\n"
12947 "\n"
12948 msgstr ""
12949 " pvs-full\n"
12950 "\n"
12951
12952 #. type: textblock
12953 #: ../fish/guestfish-actions.pod:3779 ../src/guestfs-actions.pod:5732
12954 msgid ""
12955 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
12956 "(8)> command.  The \"full\" version includes all fields."
12957 msgstr ""
12958
12959 #. type: =head2
12960 #: ../fish/guestfish-actions.pod:3782
12961 msgid "pvuuid"
12962 msgstr "pvuuid"
12963
12964 #. type: verbatim
12965 #: ../fish/guestfish-actions.pod:3784
12966 #, no-wrap
12967 msgid ""
12968 " pvuuid device\n"
12969 "\n"
12970 msgstr ""
12971 " pvuuid пристрій\n"
12972 "\n"
12973
12974 #. type: textblock
12975 #: ../fish/guestfish-actions.pod:3786 ../src/guestfs-actions.pod:5747
12976 msgid "This command returns the UUID of the LVM PV C<device>."
12977 msgstr ""
12978
12979 #. type: =head2
12980 #: ../fish/guestfish-actions.pod:3788
12981 msgid "pwrite"
12982 msgstr "pwrite"
12983
12984 #. type: verbatim
12985 #: ../fish/guestfish-actions.pod:3790
12986 #, no-wrap
12987 msgid ""
12988 " pwrite path content offset\n"
12989 "\n"
12990 msgstr ""
12991
12992 #. type: textblock
12993 #: ../fish/guestfish-actions.pod:3792 ../src/guestfs-actions.pod:5763
12994 msgid ""
12995 "This command writes to part of a file.  It writes the data buffer C<content> "
12996 "to the file C<path> starting at offset C<offset>."
12997 msgstr ""
12998
12999 #. type: textblock
13000 #: ../fish/guestfish-actions.pod:3795 ../src/guestfs-actions.pod:5766
13001 msgid ""
13002 "This command implements the L<pwrite(2)> system call, and like that system "
13003 "call it may not write the full data requested.  The return value is the "
13004 "number of bytes that were actually written to the file.  This could even be "
13005 "0, although short writes are unlikely for regular files in ordinary "
13006 "circumstances."
13007 msgstr ""
13008
13009 #. type: textblock
13010 #: ../fish/guestfish-actions.pod:3801
13011 msgid "See also L</pread>, L</pwrite-device>."
13012 msgstr "Див. також L</pread>, L</pwrite-device>."
13013
13014 #. type: =head2
13015 #: ../fish/guestfish-actions.pod:3806
13016 msgid "pwrite-device"
13017 msgstr "pwrite-device"
13018
13019 #. type: verbatim
13020 #: ../fish/guestfish-actions.pod:3808
13021 #, no-wrap
13022 msgid ""
13023 " pwrite-device device content offset\n"
13024 "\n"
13025 msgstr ""
13026
13027 #. type: textblock
13028 #: ../fish/guestfish-actions.pod:3810 ../src/guestfs-actions.pod:5790
13029 msgid ""
13030 "This command writes to part of a device.  It writes the data buffer "
13031 "C<content> to C<device> starting at offset C<offset>."
13032 msgstr ""
13033
13034 #. type: textblock
13035 #: ../fish/guestfish-actions.pod:3813 ../src/guestfs-actions.pod:5793
13036 msgid ""
13037 "This command implements the L<pwrite(2)> system call, and like that system "
13038 "call it may not write the full data requested (although short writes to disk "
13039 "devices and partitions are probably impossible with standard Linux kernels)."
13040 msgstr ""
13041
13042 #. type: textblock
13043 #: ../fish/guestfish-actions.pod:3818
13044 msgid "See also L</pwrite>."
13045 msgstr "Див. також L</pwrite>."
13046
13047 #. type: =head2
13048 #: ../fish/guestfish-actions.pod:3823
13049 msgid "read-file"
13050 msgstr "read-file"
13051
13052 #. type: verbatim
13053 #: ../fish/guestfish-actions.pod:3825
13054 #, no-wrap
13055 msgid ""
13056 " read-file path\n"
13057 "\n"
13058 msgstr ""
13059 " read-file шлях\n"
13060 "\n"
13061
13062 #. type: textblock
13063 #: ../fish/guestfish-actions.pod:3827 ../src/guestfs-actions.pod:5814
13064 msgid "This calls returns the contents of the file C<path> as a buffer."
13065 msgstr ""
13066
13067 #. type: textblock
13068 #: ../fish/guestfish-actions.pod:3830
13069 msgid ""
13070 "Unlike L</cat>, this function can correctly handle files that contain "
13071 "embedded ASCII NUL characters.  However unlike L</download>, this function "
13072 "is limited in the total size of file that can be handled."
13073 msgstr ""
13074
13075 #. type: =head2
13076 #: ../fish/guestfish-actions.pod:3838
13077 msgid "read-lines"
13078 msgstr "read-lines"
13079
13080 #. type: verbatim
13081 #: ../fish/guestfish-actions.pod:3840
13082 #, no-wrap
13083 msgid ""
13084 " read-lines path\n"
13085 "\n"
13086 msgstr ""
13087 " read-lines шлях\n"
13088 "\n"
13089
13090 #. type: textblock
13091 #: ../fish/guestfish-actions.pod:3844 ../src/guestfs-actions.pod:5839
13092 msgid ""
13093 "The file contents are returned as a list of lines.  Trailing C<LF> and "
13094 "C<CRLF> character sequences are I<not> returned."
13095 msgstr ""
13096
13097 #. type: textblock
13098 #: ../fish/guestfish-actions.pod:3847
13099 msgid ""
13100 "Note that this function cannot correctly handle binary files (specifically, "
13101 "files containing C<\\0> character which is treated as end of line).  For "
13102 "those you need to use the L</read-file> function which has a more complex "
13103 "interface."
13104 msgstr ""
13105
13106 #. type: =head2
13107 #: ../fish/guestfish-actions.pod:3852
13108 msgid "readdir"
13109 msgstr "readdir"
13110
13111 #. type: verbatim
13112 #: ../fish/guestfish-actions.pod:3854
13113 #, no-wrap
13114 msgid ""
13115 " readdir dir\n"
13116 "\n"
13117 msgstr ""
13118 " readdir каталог\n"
13119 "\n"
13120
13121 #. type: textblock
13122 #: ../fish/guestfish-actions.pod:3856 ../src/guestfs-actions.pod:5859
13123 msgid "This returns the list of directory entries in directory C<dir>."
13124 msgstr ""
13125
13126 #. type: textblock
13127 #: ../fish/guestfish-actions.pod:3858 ../src/guestfs-actions.pod:5861
13128 msgid ""
13129 "All entries in the directory are returned, including C<.> and C<..>.  The "
13130 "entries are I<not> sorted, but returned in the same order as the underlying "
13131 "filesystem."
13132 msgstr ""
13133
13134 #. type: textblock
13135 #: ../fish/guestfish-actions.pod:3862 ../src/guestfs-actions.pod:5865
13136 msgid ""
13137 "Also this call returns basic file type information about each file.  The "
13138 "C<ftyp> field will contain one of the following characters:"
13139 msgstr ""
13140
13141 #. type: =item
13142 #: ../fish/guestfish-actions.pod:3867 ../src/guestfs-actions.pod:5870
13143 msgid "'b'"
13144 msgstr "'b'"
13145
13146 #. type: textblock
13147 #: ../fish/guestfish-actions.pod:3869 ../src/guestfs-actions.pod:5872
13148 msgid "Block special"
13149 msgstr "Блоковий особливий"
13150
13151 #. type: =item
13152 #: ../fish/guestfish-actions.pod:3871 ../src/guestfs-actions.pod:5874
13153 msgid "'c'"
13154 msgstr "'c'"
13155
13156 #. type: textblock
13157 #: ../fish/guestfish-actions.pod:3873 ../src/guestfs-actions.pod:5876
13158 msgid "Char special"
13159 msgstr "Символьний особливий"
13160
13161 #. type: =item
13162 #: ../fish/guestfish-actions.pod:3875 ../src/guestfs-actions.pod:5878
13163 msgid "'d'"
13164 msgstr "'d'"
13165
13166 #. type: textblock
13167 #: ../fish/guestfish-actions.pod:3877 ../src/guestfs-actions.pod:5880
13168 msgid "Directory"
13169 msgstr "Каталог"
13170
13171 #. type: =item
13172 #: ../fish/guestfish-actions.pod:3879 ../src/guestfs-actions.pod:5882
13173 msgid "'f'"
13174 msgstr "'f'"
13175
13176 #. type: textblock
13177 #: ../fish/guestfish-actions.pod:3881 ../src/guestfs-actions.pod:5884
13178 msgid "FIFO (named pipe)"
13179 msgstr "FIFO (іменований канал)"
13180
13181 #. type: =item
13182 #: ../fish/guestfish-actions.pod:3883 ../src/guestfs-actions.pod:5886
13183 msgid "'l'"
13184 msgstr "'l'"
13185
13186 #. type: textblock
13187 #: ../fish/guestfish-actions.pod:3885 ../src/guestfs-actions.pod:5888
13188 msgid "Symbolic link"
13189 msgstr "Символічне посилання"
13190
13191 #. type: =item
13192 #: ../fish/guestfish-actions.pod:3887 ../src/guestfs-actions.pod:5890
13193 msgid "'r'"
13194 msgstr "'r'"
13195
13196 #. type: textblock
13197 #: ../fish/guestfish-actions.pod:3889 ../src/guestfs-actions.pod:5892
13198 msgid "Regular file"
13199 msgstr "Звичайний файл"
13200
13201 #. type: =item
13202 #: ../fish/guestfish-actions.pod:3891 ../src/guestfs-actions.pod:5894
13203 msgid "'s'"
13204 msgstr "'s'"
13205
13206 #. type: textblock
13207 #: ../fish/guestfish-actions.pod:3893 ../src/guestfs-actions.pod:5896
13208 msgid "Socket"
13209 msgstr "Сокет"
13210
13211 #. type: =item
13212 #: ../fish/guestfish-actions.pod:3895 ../src/guestfs-actions.pod:5898
13213 msgid "'u'"
13214 msgstr "'u'"
13215
13216 #. type: textblock
13217 #: ../fish/guestfish-actions.pod:3897 ../src/guestfs-actions.pod:5900
13218 msgid "Unknown file type"
13219 msgstr "Невідомий тип файла"
13220
13221 #. type: =item
13222 #: ../fish/guestfish-actions.pod:3899 ../src/guestfs-actions.pod:5902
13223 msgid "'?'"
13224 msgstr ""
13225
13226 #. type: textblock
13227 #: ../fish/guestfish-actions.pod:3901 ../src/guestfs-actions.pod:5904
13228 msgid ""
13229 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
13230 msgstr ""
13231
13232 #. type: textblock
13233 #: ../fish/guestfish-actions.pod:3906
13234 msgid ""
13235 "This function is primarily intended for use by programs.  To get a simple "
13236 "list of names, use L</ls>.  To get a printable directory for human "
13237 "consumption, use L</ll>."
13238 msgstr ""
13239
13240 #. type: =head2
13241 #: ../fish/guestfish-actions.pod:3910
13242 msgid "readlink"
13243 msgstr "readlink"
13244
13245 #. type: verbatim
13246 #: ../fish/guestfish-actions.pod:3912
13247 #, no-wrap
13248 msgid ""
13249 " readlink path\n"
13250 "\n"
13251 msgstr ""
13252 " readlink шлях\n"
13253 "\n"
13254
13255 #. type: textblock
13256 #: ../fish/guestfish-actions.pod:3914 ../src/guestfs-actions.pod:5925
13257 msgid "This command reads the target of a symbolic link."
13258 msgstr ""
13259
13260 #. type: =head2
13261 #: ../fish/guestfish-actions.pod:3916
13262 msgid "readlinklist"
13263 msgstr "readlinklist"
13264
13265 #. type: verbatim
13266 #: ../fish/guestfish-actions.pod:3918
13267 #, no-wrap
13268 msgid ""
13269 " readlinklist path 'names ...'\n"
13270 "\n"
13271 msgstr ""
13272
13273 #. type: textblock
13274 #: ../fish/guestfish-actions.pod:3920 ../src/guestfs-actions.pod:5939
13275 msgid ""
13276 "This call allows you to do a C<readlink> operation on multiple files, where "
13277 "all files are in the directory C<path>.  C<names> is the list of files from "
13278 "this directory."
13279 msgstr ""
13280
13281 #. type: textblock
13282 #: ../fish/guestfish-actions.pod:3924 ../src/guestfs-actions.pod:5943
13283 msgid ""
13284 "On return you get a list of strings, with a one-to-one correspondence to the "
13285 "C<names> list.  Each string is the value of the symbolic link."
13286 msgstr ""
13287
13288 #. type: textblock
13289 #: ../fish/guestfish-actions.pod:3928 ../src/guestfs-actions.pod:5947
13290 msgid ""
13291 "If the C<readlink(2)> operation fails on any name, then the corresponding "
13292 "result string is the empty string C<\"\">.  However the whole operation is "
13293 "completed even if there were C<readlink(2)> errors, and so you can call this "
13294 "function with names where you don't know if they are symbolic links already "
13295 "(albeit slightly less efficient)."
13296 msgstr ""
13297
13298 #. type: textblock
13299 #: ../fish/guestfish-actions.pod:3935 ../src/guestfs-actions.pod:5954
13300 msgid ""
13301 "This call is intended for programs that want to efficiently list a directory "
13302 "contents without making many round-trips.  Very long directory listings "
13303 "might cause the protocol message size to be exceeded, causing this call to "
13304 "fail.  The caller must split up such requests into smaller groups of names."
13305 msgstr ""
13306
13307 #. type: =head2
13308 #: ../fish/guestfish-actions.pod:3942
13309 msgid "realpath"
13310 msgstr "realpath"
13311
13312 #. type: verbatim
13313 #: ../fish/guestfish-actions.pod:3944
13314 #, no-wrap
13315 msgid ""
13316 " realpath path\n"
13317 "\n"
13318 msgstr ""
13319 " realpath шлях\n"
13320 "\n"
13321
13322 #. type: textblock
13323 #: ../fish/guestfish-actions.pod:3946 ../src/guestfs-actions.pod:5973
13324 msgid ""
13325 "Return the canonicalized absolute pathname of C<path>.  The returned path "
13326 "has no C<.>, C<..> or symbolic link path elements."
13327 msgstr ""
13328
13329 #. type: =head2
13330 #: ../fish/guestfish-actions.pod:3949
13331 msgid "removexattr"
13332 msgstr "removexattr"
13333
13334 #. type: verbatim
13335 #: ../fish/guestfish-actions.pod:3951
13336 #, no-wrap
13337 msgid ""
13338 " removexattr xattr path\n"
13339 "\n"
13340 msgstr ""
13341
13342 #. type: textblock
13343 #: ../fish/guestfish-actions.pod:3953 ../src/guestfs-actions.pod:5988
13344 msgid ""
13345 "This call removes the extended attribute named C<xattr> of the file C<path>."
13346 msgstr ""
13347
13348 #. type: textblock
13349 #: ../fish/guestfish-actions.pod:3956
13350 msgid "See also: L</lremovexattr>, L<attr(5)>."
13351 msgstr "Див. також L</lremovexattr>, L<attr(5)>."
13352
13353 #. type: =head2
13354 #: ../fish/guestfish-actions.pod:3958
13355 msgid "resize2fs"
13356 msgstr "resize2fs"
13357
13358 #. type: verbatim
13359 #: ../fish/guestfish-actions.pod:3960
13360 #, no-wrap
13361 msgid ""
13362 " resize2fs device\n"
13363 "\n"
13364 msgstr ""
13365 " resize2fs пристрій\n"
13366 "\n"
13367
13368 #. type: textblock
13369 #: ../fish/guestfish-actions.pod:3962 ../src/guestfs-actions.pod:6003
13370 msgid ""
13371 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
13372 "underlying device."
13373 msgstr ""
13374
13375 #. type: textblock
13376 #: ../fish/guestfish-actions.pod:3965
13377 msgid ""
13378 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
13379 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
13380 "gives an error about this and sometimes not.  In any case, it is always safe "
13381 "to call L</e2fsck-f> before calling this function."
13382 msgstr ""
13383
13384 #. type: =head2
13385 #: ../fish/guestfish-actions.pod:3971
13386 msgid "resize2fs-M"
13387 msgstr "resize2fs-M"
13388
13389 #. type: verbatim
13390 #: ../fish/guestfish-actions.pod:3973
13391 #, no-wrap
13392 msgid ""
13393 " resize2fs-M device\n"
13394 "\n"
13395 msgstr ""
13396 " resize2fs-M пристрій\n"
13397 "\n"
13398
13399 #. type: textblock
13400 #: ../fish/guestfish-actions.pod:3975
13401 msgid ""
13402 "This command is the same as L</resize2fs>, but the filesystem is resized to "
13403 "its minimum size.  This works like the I<-M> option to the C<resize2fs> "
13404 "command."
13405 msgstr ""
13406
13407 #. type: textblock
13408 #: ../fish/guestfish-actions.pod:3979
13409 msgid ""
13410 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
13411 "and read the C<Block size> and C<Block count> values.  These two numbers, "
13412 "multiplied together, give the resulting size of the minimal filesystem in "
13413 "bytes."
13414 msgstr ""
13415
13416 #. type: =head2
13417 #: ../fish/guestfish-actions.pod:3984
13418 msgid "resize2fs-size"
13419 msgstr "resize2fs-size"
13420
13421 #. type: verbatim
13422 #: ../fish/guestfish-actions.pod:3986
13423 #, no-wrap
13424 msgid ""
13425 " resize2fs-size device size\n"
13426 "\n"
13427 msgstr ""
13428
13429 #. type: textblock
13430 #: ../fish/guestfish-actions.pod:3988
13431 msgid ""
13432 "This command is the same as L</resize2fs> except that it allows you to "
13433 "specify the new size (in bytes) explicitly."
13434 msgstr ""
13435
13436 #. type: =head2
13437 #: ../fish/guestfish-actions.pod:3991
13438 msgid "rm"
13439 msgstr "rm"
13440
13441 #. type: verbatim
13442 #: ../fish/guestfish-actions.pod:3993
13443 #, no-wrap
13444 msgid ""
13445 " rm path\n"
13446 "\n"
13447 msgstr ""
13448 " rm шлях\n"
13449 "\n"
13450
13451 #. type: textblock
13452 #: ../fish/guestfish-actions.pod:3995 ../src/guestfs-actions.pod:6055
13453 msgid "Remove the single file C<path>."
13454 msgstr ""
13455
13456 #. type: =head2
13457 #: ../fish/guestfish-actions.pod:3997
13458 msgid "rm-rf"
13459 msgstr "rm-rf"
13460
13461 #. type: verbatim
13462 #: ../fish/guestfish-actions.pod:3999
13463 #, no-wrap
13464 msgid ""
13465 " rm-rf path\n"
13466 "\n"
13467 msgstr ""
13468 " rm-rf шлях\n"
13469 "\n"
13470
13471 #. type: textblock
13472 #: ../fish/guestfish-actions.pod:4001 ../src/guestfs-actions.pod:6067
13473 msgid ""
13474 "Remove the file or directory C<path>, recursively removing the contents if "
13475 "its a directory.  This is like the C<rm -rf> shell command."
13476 msgstr ""
13477
13478 #. type: =head2
13479 #: ../fish/guestfish-actions.pod:4005
13480 msgid "rmdir"
13481 msgstr "rmdir"
13482
13483 #. type: verbatim
13484 #: ../fish/guestfish-actions.pod:4007
13485 #, no-wrap
13486 msgid ""
13487 " rmdir path\n"
13488 "\n"
13489 msgstr ""
13490 " rmdir шлях\n"
13491 "\n"
13492
13493 #. type: textblock
13494 #: ../fish/guestfish-actions.pod:4009 ../src/guestfs-actions.pod:6081
13495 msgid "Remove the single directory C<path>."
13496 msgstr ""
13497
13498 #. type: =head2
13499 #: ../fish/guestfish-actions.pod:4011
13500 msgid "rmmountpoint"
13501 msgstr "rmmountpoint"
13502
13503 #. type: verbatim
13504 #: ../fish/guestfish-actions.pod:4013
13505 #, no-wrap
13506 msgid ""
13507 " rmmountpoint exemptpath\n"
13508 "\n"
13509 msgstr ""
13510
13511 #. type: textblock
13512 #: ../fish/guestfish-actions.pod:4015
13513 msgid ""
13514 "This calls removes a mountpoint that was previously created with L</"
13515 "mkmountpoint>.  See L</mkmountpoint> for full details."
13516 msgstr ""
13517
13518 #. type: =head2
13519 #: ../fish/guestfish-actions.pod:4019
13520 msgid "scrub-device"
13521 msgstr "scrub-device"
13522
13523 #. type: verbatim
13524 #: ../fish/guestfish-actions.pod:4021
13525 #, no-wrap
13526 msgid ""
13527 " scrub-device device\n"
13528 "\n"
13529 msgstr ""
13530 " scrub-device пристрій\n"
13531 "\n"
13532
13533 #. type: textblock
13534 #: ../fish/guestfish-actions.pod:4023 ../src/guestfs-actions.pod:6107
13535 msgid ""
13536 "This command writes patterns over C<device> to make data retrieval more "
13537 "difficult."
13538 msgstr ""
13539
13540 #. type: textblock
13541 #: ../fish/guestfish-actions.pod:4026 ../fish/guestfish-actions.pod:4041
13542 #: ../fish/guestfish-actions.pod:4054 ../src/guestfs-actions.pod:6110
13543 #: ../src/guestfs-actions.pod:6131 ../src/guestfs-actions.pod:6150
13544 msgid ""
13545 "It is an interface to the L<scrub(1)> program.  See that manual page for "
13546 "more details."
13547 msgstr ""
13548
13549 #. type: =head2
13550 #: ../fish/guestfish-actions.pod:4032
13551 msgid "scrub-file"
13552 msgstr "scrub-file"
13553
13554 #. type: verbatim
13555 #: ../fish/guestfish-actions.pod:4034
13556 #, no-wrap
13557 msgid ""
13558 " scrub-file file\n"
13559 "\n"
13560 msgstr ""
13561 " scrub-file файл\n"
13562 "\n"
13563
13564 #. type: textblock
13565 #: ../fish/guestfish-actions.pod:4036 ../src/guestfs-actions.pod:6126
13566 msgid ""
13567 "This command writes patterns over a file to make data retrieval more "
13568 "difficult."
13569 msgstr ""
13570
13571 #. type: textblock
13572 #: ../fish/guestfish-actions.pod:4039 ../src/guestfs-actions.pod:6129
13573 msgid "The file is I<removed> after scrubbing."
13574 msgstr ""
13575
13576 #. type: =head2
13577 #: ../fish/guestfish-actions.pod:4044
13578 msgid "scrub-freespace"
13579 msgstr "scrub-freespace"
13580
13581 #. type: verbatim
13582 #: ../fish/guestfish-actions.pod:4046
13583 #, no-wrap
13584 msgid ""
13585 " scrub-freespace dir\n"
13586 "\n"
13587 msgstr ""
13588 " scrub-freespace каталог\n"
13589 "\n"
13590
13591 #. type: textblock
13592 #: ../fish/guestfish-actions.pod:4048
13593 msgid ""
13594 "This command creates the directory C<dir> and then fills it with files until "
13595 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
13596 "deletes them.  The intention is to scrub any free space on the partition "
13597 "containing C<dir>."
13598 msgstr ""
13599
13600 #. type: =head2
13601 #: ../fish/guestfish-actions.pod:4057
13602 msgid "set-append"
13603 msgstr "set-append"
13604
13605 #. type: =head2
13606 #: ../fish/guestfish-actions.pod:4059
13607 msgid "append"
13608 msgstr ""
13609
13610 #. type: verbatim
13611 #: ../fish/guestfish-actions.pod:4061
13612 #, no-wrap
13613 msgid ""
13614 " set-append append\n"
13615 "\n"
13616 msgstr ""
13617
13618 #. type: textblock
13619 #: ../fish/guestfish-actions.pod:4063 ../src/guestfs-actions.pod:6163
13620 msgid ""
13621 "This function is used to add additional options to the guest kernel command "
13622 "line."
13623 msgstr ""
13624
13625 #. type: textblock
13626 #: ../fish/guestfish-actions.pod:4066 ../src/guestfs-actions.pod:6166
13627 msgid ""
13628 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
13629 "environment variable."
13630 msgstr ""
13631
13632 #. type: textblock
13633 #: ../fish/guestfish-actions.pod:4069 ../src/guestfs-actions.pod:6169
13634 msgid ""
13635 "Setting C<append> to C<NULL> means I<no> additional options are passed "
13636 "(libguestfs always adds a few of its own)."
13637 msgstr ""
13638
13639 #. type: =head2
13640 #: ../fish/guestfish-actions.pod:4072
13641 msgid "set-attach-method"
13642 msgstr "set-attach-method"
13643
13644 #. type: =head2
13645 #: ../fish/guestfish-actions.pod:4074
13646 msgid "attach-method"
13647 msgstr ""
13648
13649 #. type: verbatim
13650 #: ../fish/guestfish-actions.pod:4076
13651 #, no-wrap
13652 msgid ""
13653 " set-attach-method attachmethod\n"
13654 "\n"
13655 msgstr ""
13656
13657 #. type: textblock
13658 #: ../fish/guestfish-actions.pod:4078 ../src/guestfs-actions.pod:6182
13659 msgid ""
13660 "Set the method that libguestfs uses to connect to the back end guestfsd "
13661 "daemon.  Possible methods are:"
13662 msgstr ""
13663
13664 #. type: =item
13665 #: ../fish/guestfish-actions.pod:4083 ../src/guestfs-actions.pod:6187
13666 #: ../src/guestfs.pod:2687
13667 msgid "C<appliance>"
13668 msgstr "C<appliance>"
13669
13670 #. type: textblock
13671 #: ../fish/guestfish-actions.pod:4085 ../src/guestfs-actions.pod:6189
13672 msgid ""
13673 "Launch an appliance and connect to it.  This is the ordinary method and the "
13674 "default."
13675 msgstr ""
13676
13677 #. type: =item
13678 #: ../fish/guestfish-actions.pod:4088 ../src/guestfs-actions.pod:6192
13679 msgid "C<unix:I<path>>"
13680 msgstr "C<unix:I<шлях>>"
13681
13682 #. type: textblock
13683 #: ../fish/guestfish-actions.pod:4090 ../src/guestfs-actions.pod:6194
13684 msgid "Connect to the Unix domain socket I<path>."
13685 msgstr "Встановити з’єднання з сокетом домену Unix I<шлях>."
13686
13687 #. type: textblock
13688 #: ../fish/guestfish-actions.pod:4092 ../src/guestfs-actions.pod:6196
13689 msgid ""
13690 "This method lets you connect to an existing daemon or (using virtio-serial) "
13691 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
13692 "RUNNING DAEMONS>."
13693 msgstr ""
13694
13695 #. type: =head2
13696 #: ../fish/guestfish-actions.pod:4098
13697 msgid "set-autosync"
13698 msgstr "set-autosync"
13699
13700 #. type: =head2
13701 #: ../fish/guestfish-actions.pod:4100
13702 msgid "autosync"
13703 msgstr "autosync"
13704
13705 #. type: verbatim
13706 #: ../fish/guestfish-actions.pod:4102
13707 #, no-wrap
13708 msgid ""
13709 " set-autosync true|false\n"
13710 "\n"
13711 msgstr ""
13712 " set-autosync true|false\n"
13713 "\n"
13714
13715 #. type: textblock
13716 #: ../fish/guestfish-actions.pod:4104 ../src/guestfs-actions.pod:6212
13717 msgid ""
13718 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
13719 "effort attempt to make filesystems consistent and synchronized when the "
13720 "handle is closed (also if the program exits without closing handles)."
13721 msgstr ""
13722
13723 #. type: textblock
13724 #: ../fish/guestfish-actions.pod:4109 ../src/guestfs-actions.pod:6217
13725 msgid ""
13726 "This is enabled by default (since libguestfs 1.5.24, previously it was "
13727 "disabled by default)."
13728 msgstr ""
13729
13730 #. type: =head2
13731 #: ../fish/guestfish-actions.pod:4112
13732 msgid "set-direct"
13733 msgstr "set-direct"
13734
13735 #. type: =head2
13736 #: ../fish/guestfish-actions.pod:4114
13737 msgid "direct"
13738 msgstr "direct"
13739
13740 #. type: verbatim
13741 #: ../fish/guestfish-actions.pod:4116
13742 #, no-wrap
13743 msgid ""
13744 " set-direct true|false\n"
13745 "\n"
13746 msgstr ""
13747 " set-direct true|false\n"
13748 "\n"
13749
13750 #. type: textblock
13751 #: ../fish/guestfish-actions.pod:4118 ../src/guestfs-actions.pod:6230
13752 msgid ""
13753 "If the direct appliance mode flag is enabled, then stdin and stdout are "
13754 "passed directly through to the appliance once it is launched."
13755 msgstr ""
13756
13757 #. type: textblock
13758 #: ../fish/guestfish-actions.pod:4122
13759 msgid ""
13760 "One consequence of this is that log messages aren't caught by the library "
13761 "and handled by L</set-log-message-callback>, but go straight to stdout."
13762 msgstr ""
13763
13764 #. type: textblock
13765 #: ../fish/guestfish-actions.pod:4126 ../src/guestfs-actions.pod:6238
13766 msgid "You probably don't want to use this unless you know what you are doing."
13767 msgstr ""
13768
13769 #. type: textblock
13770 #: ../fish/guestfish-actions.pod:4129 ../src/guestfs-actions.pod:6241
13771 msgid "The default is disabled."
13772 msgstr ""
13773
13774 #. type: =head2
13775 #: ../fish/guestfish-actions.pod:4131
13776 msgid "set-e2label"
13777 msgstr "set-e2label"
13778
13779 #. type: verbatim
13780 #: ../fish/guestfish-actions.pod:4133
13781 #, no-wrap
13782 msgid ""
13783 " set-e2label device label\n"
13784 "\n"
13785 msgstr ""
13786
13787 #. type: textblock
13788 #: ../fish/guestfish-actions.pod:4135 ../src/guestfs-actions.pod:6254
13789 msgid ""
13790 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
13791 "C<label>.  Filesystem labels are limited to 16 characters."
13792 msgstr ""
13793
13794 #. type: textblock
13795 #: ../fish/guestfish-actions.pod:4139
13796 msgid ""
13797 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
13798 "label on a filesystem."
13799 msgstr ""
13800
13801 #. type: =head2
13802 #: ../fish/guestfish-actions.pod:4142
13803 msgid "set-e2uuid"
13804 msgstr "set-e2uuid"
13805
13806 #. type: verbatim
13807 #: ../fish/guestfish-actions.pod:4144
13808 #, no-wrap
13809 msgid ""
13810 " set-e2uuid device uuid\n"
13811 "\n"
13812 msgstr ""
13813
13814 #. type: textblock
13815 #: ../fish/guestfish-actions.pod:4146 ../src/guestfs-actions.pod:6272
13816 msgid ""
13817 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
13818 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
13819 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
13820 msgstr ""
13821
13822 #. type: textblock
13823 #: ../fish/guestfish-actions.pod:4151
13824 msgid ""
13825 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
13826 "UUID of a filesystem."
13827 msgstr ""
13828
13829 #. type: =head2
13830 #: ../fish/guestfish-actions.pod:4154
13831 msgid "set-memsize"
13832 msgstr "set-memsize"
13833
13834 #. type: =head2
13835 #: ../fish/guestfish-actions.pod:4156
13836 msgid "memsize"
13837 msgstr ""
13838
13839 #. type: verbatim
13840 #: ../fish/guestfish-actions.pod:4158
13841 #, no-wrap
13842 msgid ""
13843 " set-memsize memsize\n"
13844 "\n"
13845 msgstr ""
13846
13847 #. type: textblock
13848 #: ../fish/guestfish-actions.pod:4160
13849 msgid ""
13850 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
13851 "This only has any effect if called before L</launch>."
13852 msgstr ""
13853
13854 #. type: textblock
13855 #: ../fish/guestfish-actions.pod:4164 ../src/guestfs-actions.pod:6294
13856 msgid ""
13857 "You can also change this by setting the environment variable "
13858 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
13859 msgstr ""
13860
13861 #. type: =head2
13862 #: ../fish/guestfish-actions.pod:4171
13863 msgid "set-network"
13864 msgstr "set-network"
13865
13866 #. type: =head2
13867 #: ../fish/guestfish-actions.pod:4173
13868 msgid "network"
13869 msgstr "network"
13870
13871 #. type: verbatim
13872 #: ../fish/guestfish-actions.pod:4175
13873 #, no-wrap
13874 msgid ""
13875 " set-network true|false\n"
13876 "\n"
13877 msgstr ""
13878 " set-network true|false\n"
13879 "\n"
13880
13881 #. type: textblock
13882 #: ../fish/guestfish-actions.pod:4177 ../src/guestfs-actions.pod:6311
13883 msgid ""
13884 "If C<network> is true, then the network is enabled in the libguestfs "
13885 "appliance.  The default is false."
13886 msgstr ""
13887
13888 #. type: textblock
13889 #: ../fish/guestfish-actions.pod:4180 ../src/guestfs-actions.pod:6314
13890 msgid ""
13891 "This affects whether commands are able to access the network (see L<guestfs"
13892 "(3)/RUNNING COMMANDS>)."
13893 msgstr ""
13894
13895 #. type: textblock
13896 #: ../fish/guestfish-actions.pod:4183
13897 msgid ""
13898 "You must call this before calling L</launch>, otherwise it has no effect."
13899 msgstr ""
13900
13901 #. type: =head2
13902 #: ../fish/guestfish-actions.pod:4186
13903 msgid "set-path"
13904 msgstr "set-path"
13905
13906 #. type: verbatim
13907 #: ../fish/guestfish-actions.pod:4190
13908 #, no-wrap
13909 msgid ""
13910 " set-path searchpath\n"
13911 "\n"
13912 msgstr ""
13913
13914 #. type: textblock
13915 #: ../fish/guestfish-actions.pod:4192 ../src/guestfs-actions.pod:6330
13916 msgid "Set the path that libguestfs searches for kernel and initrd.img."
13917 msgstr ""
13918
13919 #. type: textblock
13920 #: ../fish/guestfish-actions.pod:4194 ../src/guestfs-actions.pod:6332
13921 msgid ""
13922 "The default is C<$libdir/guestfs> unless overridden by setting "
13923 "C<LIBGUESTFS_PATH> environment variable."
13924 msgstr ""
13925
13926 #. type: textblock
13927 #: ../fish/guestfish-actions.pod:4197 ../src/guestfs-actions.pod:6335
13928 msgid "Setting C<path> to C<NULL> restores the default path."
13929 msgstr ""
13930
13931 #. type: =head2
13932 #: ../fish/guestfish-actions.pod:4199
13933 msgid "set-pgroup"
13934 msgstr ""
13935
13936 #. type: =head2
13937 #: ../fish/guestfish-actions.pod:4201
13938 msgid "pgroup"
13939 msgstr ""
13940
13941 #. type: verbatim
13942 #: ../fish/guestfish-actions.pod:4203
13943 #, no-wrap
13944 msgid ""
13945 " set-pgroup true|false\n"
13946 "\n"
13947 msgstr ""
13948
13949 #. type: textblock
13950 #: ../fish/guestfish-actions.pod:4205 ../src/guestfs-actions.pod:6347
13951 msgid ""
13952 "If C<pgroup> is true, child processes are placed into their own process "
13953 "group."
13954 msgstr ""
13955
13956 #. type: textblock
13957 #: ../fish/guestfish-actions.pod:4208 ../src/guestfs-actions.pod:6350
13958 msgid ""
13959 "The practical upshot of this is that signals like C<SIGINT> (from users "
13960 "pressing C<^C>) won't be received by the child process."
13961 msgstr ""
13962
13963 #. type: textblock
13964 #: ../fish/guestfish-actions.pod:4211 ../src/guestfs-actions.pod:6353
13965 msgid ""
13966 "The default for this flag is false, because usually you want C<^C> to kill "
13967 "the subprocess."
13968 msgstr ""
13969
13970 #. type: =head2
13971 #: ../fish/guestfish-actions.pod:4214
13972 msgid "set-qemu"
13973 msgstr "set-qemu"
13974
13975 #. type: =head2
13976 #: ../fish/guestfish-actions.pod:4216
13977 msgid "qemu"
13978 msgstr "qemu"
13979
13980 #. type: verbatim
13981 #: ../fish/guestfish-actions.pod:4218
13982 #, no-wrap
13983 msgid ""
13984 " set-qemu qemu\n"
13985 "\n"
13986 msgstr ""
13987 " set-qemu qemu\n"
13988 "\n"
13989
13990 #. type: textblock
13991 #: ../fish/guestfish-actions.pod:4220 ../src/guestfs-actions.pod:6366
13992 msgid "Set the qemu binary that we will use."
13993 msgstr ""
13994
13995 #. type: textblock
13996 #: ../fish/guestfish-actions.pod:4222 ../src/guestfs-actions.pod:6368
13997 msgid ""
13998 "The default is chosen when the library was compiled by the configure script."
13999 msgstr ""
14000
14001 #. type: textblock
14002 #: ../fish/guestfish-actions.pod:4225 ../src/guestfs-actions.pod:6371
14003 msgid ""
14004 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
14005 "variable."
14006 msgstr ""
14007
14008 #. type: textblock
14009 #: ../fish/guestfish-actions.pod:4228 ../src/guestfs-actions.pod:6374
14010 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
14011 msgstr ""
14012
14013 #. type: textblock
14014 #: ../fish/guestfish-actions.pod:4230 ../src/guestfs-actions.pod:6376
14015 msgid ""
14016 "Note that you should call this function as early as possible after creating "
14017 "the handle.  This is because some pre-launch operations depend on testing "
14018 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
14019 "don't retest features, and so you might see inconsistent results.  Using the "
14020 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
14021 "the qemu binary at the same time as the handle is created."
14022 msgstr ""
14023
14024 #. type: =head2
14025 #: ../fish/guestfish-actions.pod:4238
14026 msgid "set-recovery-proc"
14027 msgstr "set-recovery-proc"
14028
14029 #. type: =head2
14030 #: ../fish/guestfish-actions.pod:4240
14031 msgid "recovery-proc"
14032 msgstr "recovery-proc"
14033
14034 #. type: verbatim
14035 #: ../fish/guestfish-actions.pod:4242
14036 #, no-wrap
14037 msgid ""
14038 " set-recovery-proc true|false\n"
14039 "\n"
14040 msgstr ""
14041 " set-recovery-proc true|false\n"
14042 "\n"
14043
14044 #. type: textblock
14045 #: ../fish/guestfish-actions.pod:4244
14046 msgid ""
14047 "If this is called with the parameter C<false> then L</launch> does not "
14048 "create a recovery process.  The purpose of the recovery process is to stop "
14049 "runaway qemu processes in the case where the main program aborts abruptly."
14050 msgstr ""
14051
14052 #. type: textblock
14053 #: ../fish/guestfish-actions.pod:4249
14054 msgid ""
14055 "This only has any effect if called before L</launch>, and the default is "
14056 "true."
14057 msgstr ""
14058
14059 #. type: textblock
14060 #: ../fish/guestfish-actions.pod:4252 ../src/guestfs-actions.pod:6402
14061 msgid ""
14062 "About the only time when you would want to disable this is if the main "
14063 "process will fork itself into the background (\"daemonize\" itself).  In "
14064 "this case the recovery process thinks that the main program has disappeared "
14065 "and so kills qemu, which is not very helpful."
14066 msgstr ""
14067
14068 #. type: =head2
14069 #: ../fish/guestfish-actions.pod:4258
14070 msgid "set-selinux"
14071 msgstr "set-selinux"
14072
14073 #. type: =head2
14074 #: ../fish/guestfish-actions.pod:4260
14075 msgid "selinux"
14076 msgstr "selinux"
14077
14078 #. type: verbatim
14079 #: ../fish/guestfish-actions.pod:4262
14080 #, no-wrap
14081 msgid ""
14082 " set-selinux true|false\n"
14083 "\n"
14084 msgstr ""
14085 " set-selinux true|false\n"
14086 "\n"
14087
14088 #. type: textblock
14089 #: ../fish/guestfish-actions.pod:4264 ../src/guestfs-actions.pod:6418
14090 msgid ""
14091 "This sets the selinux flag that is passed to the appliance at boot time.  "
14092 "The default is C<selinux=0> (disabled)."
14093 msgstr ""
14094
14095 #. type: textblock
14096 #: ../fish/guestfish-actions.pod:4267 ../src/guestfs-actions.pod:6421
14097 msgid ""
14098 "Note that if SELinux is enabled, it is always in Permissive mode "
14099 "(C<enforcing=0>)."
14100 msgstr ""
14101
14102 #. type: =head2
14103 #: ../fish/guestfish-actions.pod:4273
14104 msgid "set-trace"
14105 msgstr "set-trace"
14106
14107 #. type: =head2
14108 #: ../fish/guestfish-actions.pod:4275
14109 msgid "trace"
14110 msgstr "trace"
14111
14112 #. type: verbatim
14113 #: ../fish/guestfish-actions.pod:4277
14114 #, no-wrap
14115 msgid ""
14116 " set-trace true|false\n"
14117 "\n"
14118 msgstr ""
14119 " set-trace true|false\n"
14120 "\n"
14121
14122 #. type: textblock
14123 #: ../fish/guestfish-actions.pod:4279 ../src/guestfs-actions.pod:6437
14124 msgid ""
14125 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
14126 "return values are traced."
14127 msgstr ""
14128
14129 #. type: textblock
14130 #: ../fish/guestfish-actions.pod:4282 ../src/guestfs-actions.pod:6440
14131 msgid ""
14132 "If you want to trace C API calls into libguestfs (and other libraries) then "
14133 "possibly a better way is to use the external ltrace(1) command."
14134 msgstr ""
14135
14136 #. type: textblock
14137 #: ../fish/guestfish-actions.pod:4286 ../src/guestfs-actions.pod:6444
14138 msgid ""
14139 "Command traces are disabled unless the environment variable "
14140 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
14141 msgstr ""
14142
14143 #. type: textblock
14144 #: ../fish/guestfish-actions.pod:4289
14145 msgid ""
14146 "Trace messages are normally sent to C<stderr>, unless you register a "
14147 "callback to send them somewhere else (see L</set-event-callback>)."
14148 msgstr ""
14149
14150 #. type: =head2
14151 #: ../fish/guestfish-actions.pod:4293
14152 msgid "set-verbose"
14153 msgstr "set-verbose"
14154
14155 #. type: =head2
14156 #: ../fish/guestfish-actions.pod:4295
14157 msgid "verbose"
14158 msgstr ""
14159
14160 #. type: verbatim
14161 #: ../fish/guestfish-actions.pod:4297
14162 #, no-wrap
14163 msgid ""
14164 " set-verbose true|false\n"
14165 "\n"
14166 msgstr ""
14167 " set-verbose true|false\n"
14168 "\n"
14169
14170 #. type: textblock
14171 #: ../fish/guestfish-actions.pod:4299 ../src/guestfs-actions.pod:6461
14172 msgid "If C<verbose> is true, this turns on verbose messages."
14173 msgstr ""
14174
14175 #. type: textblock
14176 #: ../fish/guestfish-actions.pod:4301 ../src/guestfs-actions.pod:6463
14177 msgid ""
14178 "Verbose messages are disabled unless the environment variable "
14179 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
14180 msgstr ""
14181
14182 #. type: textblock
14183 #: ../fish/guestfish-actions.pod:4304
14184 msgid ""
14185 "Verbose messages are normally sent to C<stderr>, unless you register a "
14186 "callback to send them somewhere else (see L</set-event-callback>)."
14187 msgstr ""
14188
14189 #. type: =head2
14190 #: ../fish/guestfish-actions.pod:4308
14191 msgid "setcon"
14192 msgstr "setcon"
14193
14194 #. type: verbatim
14195 #: ../fish/guestfish-actions.pod:4310
14196 #, no-wrap
14197 msgid ""
14198 " setcon context\n"
14199 "\n"
14200 msgstr ""
14201 " setcon контекст\n"
14202 "\n"
14203
14204 #. type: textblock
14205 #: ../fish/guestfish-actions.pod:4312 ../src/guestfs-actions.pod:6480
14206 msgid ""
14207 "This sets the SELinux security context of the daemon to the string "
14208 "C<context>."
14209 msgstr ""
14210
14211 #. type: textblock
14212 #: ../fish/guestfish-actions.pod:4315 ../src/guestfs-actions.pod:6483
14213 msgid "See the documentation about SELINUX in L<guestfs(3)>."
14214 msgstr ""
14215
14216 #. type: =head2
14217 #: ../fish/guestfish-actions.pod:4317
14218 msgid "setxattr"
14219 msgstr "setxattr"
14220
14221 #. type: verbatim
14222 #: ../fish/guestfish-actions.pod:4319
14223 #, no-wrap
14224 msgid ""
14225 " setxattr xattr val vallen path\n"
14226 "\n"
14227 msgstr ""
14228
14229 #. type: textblock
14230 #: ../fish/guestfish-actions.pod:4321 ../src/guestfs-actions.pod:6498
14231 msgid ""
14232 "This call sets the extended attribute named C<xattr> of the file C<path> to "
14233 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
14234 msgstr ""
14235
14236 #. type: textblock
14237 #: ../fish/guestfish-actions.pod:4325
14238 msgid "See also: L</lsetxattr>, L<attr(5)>."
14239 msgstr "Див. також L</lsetxattr>, L<attr(5)>."
14240
14241 #. type: =head2
14242 #: ../fish/guestfish-actions.pod:4327
14243 msgid "sfdisk"
14244 msgstr "sfdisk"
14245
14246 #. type: verbatim
14247 #: ../fish/guestfish-actions.pod:4329
14248 #, no-wrap
14249 msgid ""
14250 " sfdisk device cyls heads sectors 'lines ...'\n"
14251 "\n"
14252 msgstr ""
14253
14254 #. type: textblock
14255 #: ../fish/guestfish-actions.pod:4331 ../src/guestfs-actions.pod:6518
14256 msgid ""
14257 "This is a direct interface to the L<sfdisk(8)> program for creating "
14258 "partitions on block devices."
14259 msgstr ""
14260
14261 #. type: textblock
14262 #: ../fish/guestfish-actions.pod:4334 ../src/guestfs-actions.pod:6521
14263 msgid "C<device> should be a block device, for example C</dev/sda>."
14264 msgstr ""
14265
14266 #. type: textblock
14267 #: ../fish/guestfish-actions.pod:4336 ../src/guestfs-actions.pod:6523
14268 msgid ""
14269 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
14270 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
14271 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
14272 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
14273 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
14274 "the kernel) cannot work out the right geometry and you will need to tell it."
14275 msgstr ""
14276
14277 #. type: textblock
14278 #: ../fish/guestfish-actions.pod:4344 ../src/guestfs-actions.pod:6531
14279 msgid ""
14280 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
14281 "refer to the L<sfdisk(8)> manpage."
14282 msgstr ""
14283
14284 #. type: textblock
14285 #: ../fish/guestfish-actions.pod:4347 ../src/guestfs-actions.pod:6534
14286 msgid ""
14287 "To create a single partition occupying the whole disk, you would pass "
14288 "C<lines> as a single element list, when the single element being the string "
14289 "C<,> (comma)."
14290 msgstr ""
14291
14292 #. type: textblock
14293 #: ../fish/guestfish-actions.pod:4351
14294 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
14295 msgstr "Див. також L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
14296
14297 #. type: textblock
14298 #: ../fish/guestfish-actions.pod:4357 ../fish/guestfish-actions.pod:4380
14299 #: ../fish/guestfish-actions.pod:4402
14300 msgid ""
14301 "This function is deprecated.  In new code, use the L</part_add> call instead."
14302 msgstr ""
14303
14304 #. type: =head2
14305 #: ../fish/guestfish-actions.pod:4364
14306 msgid "sfdiskM"
14307 msgstr "sfdiskM"
14308
14309 #. type: verbatim
14310 #: ../fish/guestfish-actions.pod:4366
14311 #, no-wrap
14312 msgid ""
14313 " sfdiskM device 'lines ...'\n"
14314 "\n"
14315 msgstr ""
14316
14317 #. type: textblock
14318 #: ../fish/guestfish-actions.pod:4368
14319 msgid ""
14320 "This is a simplified interface to the L</sfdisk> command, where partition "
14321 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
14322 "you don't need to specify the cyls, heads and sectors parameters which were "
14323 "rarely if ever used anyway."
14324 msgstr ""
14325
14326 #. type: textblock
14327 #: ../fish/guestfish-actions.pod:4374
14328 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
14329 msgstr ""
14330 "Див також L</sfdisk>, сторінку довідки (man) L<sfdisk(8)> та L</part-disk>"
14331
14332 #. type: =head2
14333 #: ../fish/guestfish-actions.pod:4387
14334 msgid "sfdisk-N"
14335 msgstr "sfdisk-N"
14336
14337 #. type: verbatim
14338 #: ../fish/guestfish-actions.pod:4389
14339 #, no-wrap
14340 msgid ""
14341 " sfdisk-N device partnum cyls heads sectors line\n"
14342 "\n"
14343 msgstr ""
14344
14345 #. type: textblock
14346 #: ../fish/guestfish-actions.pod:4391 ../src/guestfs-actions.pod:6596
14347 msgid ""
14348 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
14349 "(note: C<n> counts from 1)."
14350 msgstr ""
14351
14352 #. type: textblock
14353 #: ../fish/guestfish-actions.pod:4394
14354 msgid ""
14355 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
14356 "cyls/heads/sectors parameters."
14357 msgstr ""
14358
14359 #. type: textblock
14360 #: ../fish/guestfish-actions.pod:4397
14361 msgid "See also: L</part-add>"
14362 msgstr "Див. також L</part-add>"
14363
14364 #. type: =head2
14365 #: ../fish/guestfish-actions.pod:4409
14366 msgid "sfdisk-disk-geometry"
14367 msgstr "sfdisk-disk-geometry"
14368
14369 #. type: verbatim
14370 #: ../fish/guestfish-actions.pod:4411
14371 #, no-wrap
14372 msgid ""
14373 " sfdisk-disk-geometry device\n"
14374 "\n"
14375 msgstr ""
14376 " sfdisk-disk-geometry пристрій\n"
14377 "\n"
14378
14379 #. type: textblock
14380 #: ../fish/guestfish-actions.pod:4413
14381 msgid ""
14382 "This displays the disk geometry of C<device> read from the partition table.  "
14383 "Especially in the case where the underlying block device has been resized, "
14384 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
14385 "kernel-geometry>)."
14386 msgstr ""
14387
14388 #. type: textblock
14389 #: ../fish/guestfish-actions.pod:4418 ../fish/guestfish-actions.pod:4427
14390 #: ../src/guestfs-actions.pod:6629 ../src/guestfs-actions.pod:6645
14391 msgid "The result is in human-readable format, and not designed to be parsed."
14392 msgstr ""
14393
14394 #. type: =head2
14395 #: ../fish/guestfish-actions.pod:4421
14396 msgid "sfdisk-kernel-geometry"
14397 msgstr "sfdisk-kernel-geometry"
14398
14399 #. type: verbatim
14400 #: ../fish/guestfish-actions.pod:4423
14401 #, no-wrap
14402 msgid ""
14403 " sfdisk-kernel-geometry device\n"
14404 "\n"
14405 msgstr ""
14406 " sfdisk-kernel-geometry пристрій\n"
14407 "\n"
14408
14409 #. type: textblock
14410 #: ../fish/guestfish-actions.pod:4425 ../src/guestfs-actions.pod:6643
14411 msgid "This displays the kernel's idea of the geometry of C<device>."
14412 msgstr ""
14413
14414 #. type: =head2
14415 #: ../fish/guestfish-actions.pod:4430
14416 msgid "sfdisk-l"
14417 msgstr "sfdisk-l"
14418
14419 #. type: verbatim
14420 #: ../fish/guestfish-actions.pod:4432
14421 #, no-wrap
14422 msgid ""
14423 " sfdisk-l device\n"
14424 "\n"
14425 msgstr ""
14426 " sfdisk-l пристрій\n"
14427 "\n"
14428
14429 #. type: textblock
14430 #: ../fish/guestfish-actions.pod:4434 ../src/guestfs-actions.pod:6659
14431 msgid ""
14432 "This displays the partition table on C<device>, in the human-readable output "
14433 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
14434 msgstr ""
14435
14436 #. type: textblock
14437 #: ../fish/guestfish-actions.pod:4438
14438 msgid "See also: L</part-list>"
14439 msgstr "Див. також L</part-list>"
14440
14441 #. type: textblock
14442 #: ../fish/guestfish-actions.pod:4440
14443 msgid ""
14444 "This function is deprecated.  In new code, use the L</part_list> call "
14445 "instead."
14446 msgstr ""
14447
14448 #. type: =head2
14449 #: ../fish/guestfish-actions.pod:4447
14450 msgid "sh"
14451 msgstr "sh"
14452
14453 #. type: verbatim
14454 #: ../fish/guestfish-actions.pod:4449
14455 #, no-wrap
14456 msgid ""
14457 " sh command\n"
14458 "\n"
14459 msgstr ""
14460 " sh команда\n"
14461 "\n"
14462
14463 #. type: textblock
14464 #: ../fish/guestfish-actions.pod:4451 ../src/guestfs-actions.pod:6683
14465 msgid ""
14466 "This call runs a command from the guest filesystem via the guest's C</bin/"
14467 "sh>."
14468 msgstr ""
14469
14470 #. type: textblock
14471 #: ../fish/guestfish-actions.pod:4454
14472 msgid "This is like L</command>, but passes the command to:"
14473 msgstr ""
14474
14475 #. type: verbatim
14476 #: ../fish/guestfish-actions.pod:4456 ../src/guestfs-actions.pod:6688
14477 #, no-wrap
14478 msgid ""
14479 " /bin/sh -c \"command\"\n"
14480 "\n"
14481 msgstr ""
14482
14483 #. type: textblock
14484 #: ../fish/guestfish-actions.pod:4458 ../src/guestfs-actions.pod:6690
14485 msgid ""
14486 "Depending on the guest's shell, this usually results in wildcards being "
14487 "expanded, shell expressions being interpolated and so on."
14488 msgstr ""
14489
14490 #. type: textblock
14491 #: ../fish/guestfish-actions.pod:4462
14492 msgid "All the provisos about L</command> apply to this call."
14493 msgstr ""
14494
14495 #. type: =head2
14496 #: ../fish/guestfish-actions.pod:4464
14497 msgid "sh-lines"
14498 msgstr "sh-lines"
14499
14500 #. type: verbatim
14501 #: ../fish/guestfish-actions.pod:4466
14502 #, no-wrap
14503 msgid ""
14504 " sh-lines command\n"
14505 "\n"
14506 msgstr ""
14507 " sh-lines команда\n"
14508 "\n"
14509
14510 #. type: textblock
14511 #: ../fish/guestfish-actions.pod:4468
14512 msgid "This is the same as L</sh>, but splits the result into a list of lines."
14513 msgstr ""
14514
14515 #. type: textblock
14516 #: ../fish/guestfish-actions.pod:4471
14517 msgid "See also: L</command-lines>"
14518 msgstr "Див. також L</command-lines>"
14519
14520 #. type: =head2
14521 #: ../fish/guestfish-actions.pod:4473
14522 msgid "sleep"
14523 msgstr "sleep"
14524
14525 #. type: verbatim
14526 #: ../fish/guestfish-actions.pod:4475
14527 #, no-wrap
14528 msgid ""
14529 " sleep secs\n"
14530 "\n"
14531 msgstr ""
14532 " sleep час_у_секундах\n"
14533 "\n"
14534
14535 #. type: textblock
14536 #: ../fish/guestfish-actions.pod:4477 ../src/guestfs-actions.pod:6724
14537 msgid "Sleep for C<secs> seconds."
14538 msgstr ""
14539
14540 #. type: =head2
14541 #: ../fish/guestfish-actions.pod:4479
14542 msgid "stat"
14543 msgstr "stat"
14544
14545 #. type: verbatim
14546 #: ../fish/guestfish-actions.pod:4481
14547 #, no-wrap
14548 msgid ""
14549 " stat path\n"
14550 "\n"
14551 msgstr ""
14552 " stat шлях\n"
14553 "\n"
14554
14555 #. type: textblock
14556 #: ../fish/guestfish-actions.pod:4485 ../src/guestfs-actions.pod:6738
14557 msgid "This is the same as the C<stat(2)> system call."
14558 msgstr ""
14559
14560 #. type: =head2
14561 #: ../fish/guestfish-actions.pod:4487
14562 msgid "statvfs"
14563 msgstr "statvfs"
14564
14565 #. type: verbatim
14566 #: ../fish/guestfish-actions.pod:4489
14567 #, no-wrap
14568 msgid ""
14569 " statvfs path\n"
14570 "\n"
14571 msgstr ""
14572 " statvfs шлях\n"
14573 "\n"
14574
14575 #. type: textblock
14576 #: ../fish/guestfish-actions.pod:4491 ../src/guestfs-actions.pod:6752
14577 msgid ""
14578 "Returns file system statistics for any mounted file system.  C<path> should "
14579 "be a file or directory in the mounted file system (typically it is the mount "
14580 "point itself, but it doesn't need to be)."
14581 msgstr ""
14582
14583 #. type: textblock
14584 #: ../fish/guestfish-actions.pod:4495 ../src/guestfs-actions.pod:6756
14585 msgid "This is the same as the C<statvfs(2)> system call."
14586 msgstr ""
14587
14588 #. type: =head2
14589 #: ../fish/guestfish-actions.pod:4497
14590 msgid "strings"
14591 msgstr "strings"
14592
14593 #. type: verbatim
14594 #: ../fish/guestfish-actions.pod:4499
14595 #, no-wrap
14596 msgid ""
14597 " strings path\n"
14598 "\n"
14599 msgstr ""
14600 " strings шлях\n"
14601 "\n"
14602
14603 #. type: textblock
14604 #: ../fish/guestfish-actions.pod:4501 ../src/guestfs-actions.pod:6770
14605 msgid ""
14606 "This runs the L<strings(1)> command on a file and returns the list of "
14607 "printable strings found."
14608 msgstr ""
14609
14610 #. type: =head2
14611 #: ../fish/guestfish-actions.pod:4507
14612 msgid "strings-e"
14613 msgstr "strings-e"
14614
14615 #. type: verbatim
14616 #: ../fish/guestfish-actions.pod:4509
14617 #, no-wrap
14618 msgid ""
14619 " strings-e encoding path\n"
14620 "\n"
14621 msgstr ""
14622 " strings-e кодування шлях\n"
14623 "\n"
14624
14625 #. type: textblock
14626 #: ../fish/guestfish-actions.pod:4511
14627 msgid ""
14628 "This is like the L</strings> command, but allows you to specify the encoding "
14629 "of strings that are looked for in the source file C<path>."
14630 msgstr ""
14631
14632 #. type: textblock
14633 #: ../fish/guestfish-actions.pod:4515 ../src/guestfs-actions.pod:6793
14634 msgid "Allowed encodings are:"
14635 msgstr "Можливими кодуваннями є:"
14636
14637 #. type: =item
14638 #: ../fish/guestfish-actions.pod:4519 ../src/guestfs-actions.pod:6797
14639 msgid "s"
14640 msgstr "s"
14641
14642 #. type: textblock
14643 #: ../fish/guestfish-actions.pod:4521
14644 msgid ""
14645 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
14646 "ISO-8859-X (this is what L</strings> uses)."
14647 msgstr ""
14648
14649 #. type: =item
14650 #: ../fish/guestfish-actions.pod:4524 ../src/guestfs-actions.pod:6802
14651 msgid "S"
14652 msgstr "S"
14653
14654 #. type: textblock
14655 #: ../fish/guestfish-actions.pod:4526 ../src/guestfs-actions.pod:6804
14656 msgid "Single 8-bit-byte characters."
14657 msgstr "Окремі 8-бітові-байтові символи."
14658
14659 #. type: =item
14660 #: ../fish/guestfish-actions.pod:4528 ../src/guestfs-actions.pod:6806
14661 msgid "b"
14662 msgstr "b"
14663
14664 #. type: textblock
14665 #: ../fish/guestfish-actions.pod:4530 ../src/guestfs-actions.pod:6808
14666 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
14667 msgstr ""
14668
14669 #. type: =item
14670 #: ../fish/guestfish-actions.pod:4533 ../src/guestfs-actions.pod:6811
14671 msgid "l (lower case letter L)"
14672 msgstr ""
14673
14674 #. type: textblock
14675 #: ../fish/guestfish-actions.pod:4535 ../src/guestfs-actions.pod:6813
14676 msgid ""
14677 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
14678 "examining binaries in Windows guests."
14679 msgstr ""
14680
14681 #. type: =item
14682 #: ../fish/guestfish-actions.pod:4538 ../src/guestfs-actions.pod:6816
14683 msgid "B"
14684 msgstr "B"
14685
14686 #. type: textblock
14687 #: ../fish/guestfish-actions.pod:4540 ../src/guestfs-actions.pod:6818
14688 msgid "32-bit big endian such as UCS-4BE."
14689 msgstr ""
14690
14691 #. type: =item
14692 #: ../fish/guestfish-actions.pod:4542 ../src/guestfs-actions.pod:6820
14693 msgid "L"
14694 msgstr "L"
14695
14696 #. type: textblock
14697 #: ../fish/guestfish-actions.pod:4544 ../src/guestfs-actions.pod:6822
14698 msgid "32-bit little endian such as UCS-4LE."
14699 msgstr ""
14700
14701 #. type: textblock
14702 #: ../fish/guestfish-actions.pod:4548 ../src/guestfs-actions.pod:6826
14703 msgid "The returned strings are transcoded to UTF-8."
14704 msgstr ""
14705
14706 #. type: =head2
14707 #: ../fish/guestfish-actions.pod:4553
14708 msgid "swapoff-device"
14709 msgstr "swapoff-device"
14710
14711 #. type: verbatim
14712 #: ../fish/guestfish-actions.pod:4555
14713 #, no-wrap
14714 msgid ""
14715 " swapoff-device device\n"
14716 "\n"
14717 msgstr ""
14718 " swapoff-device пристрій\n"
14719 "\n"
14720
14721 #. type: textblock
14722 #: ../fish/guestfish-actions.pod:4557
14723 msgid ""
14724 "This command disables the libguestfs appliance swap device or partition "
14725 "named C<device>.  See L</swapon-device>."
14726 msgstr ""
14727
14728 #. type: =head2
14729 #: ../fish/guestfish-actions.pod:4561
14730 msgid "swapoff-file"
14731 msgstr "swapoff-file"
14732
14733 #. type: verbatim
14734 #: ../fish/guestfish-actions.pod:4563
14735 #, no-wrap
14736 msgid ""
14737 " swapoff-file file\n"
14738 "\n"
14739 msgstr ""
14740 " swapoff-file файл\n"
14741 "\n"
14742
14743 #. type: textblock
14744 #: ../fish/guestfish-actions.pod:4565 ../src/guestfs-actions.pod:6857
14745 msgid "This command disables the libguestfs appliance swap on file."
14746 msgstr ""
14747
14748 #. type: =head2
14749 #: ../fish/guestfish-actions.pod:4567
14750 msgid "swapoff-label"
14751 msgstr "swapoff-label"
14752
14753 #. type: verbatim
14754 #: ../fish/guestfish-actions.pod:4569
14755 #, no-wrap
14756 msgid ""
14757 " swapoff-label label\n"
14758 "\n"
14759 msgstr ""
14760 " swapoff-label мітка\n"
14761 "\n"
14762
14763 #. type: textblock
14764 #: ../fish/guestfish-actions.pod:4571 ../src/guestfs-actions.pod:6869
14765 msgid ""
14766 "This command disables the libguestfs appliance swap on labeled swap "
14767 "partition."
14768 msgstr ""
14769
14770 #. type: =head2
14771 #: ../fish/guestfish-actions.pod:4574
14772 msgid "swapoff-uuid"
14773 msgstr "swapoff-uuid"
14774
14775 #. type: verbatim
14776 #: ../fish/guestfish-actions.pod:4576
14777 #, no-wrap
14778 msgid ""
14779 " swapoff-uuid uuid\n"
14780 "\n"
14781 msgstr ""
14782 " swapoff-uuid uuid\n"
14783 "\n"
14784
14785 #. type: textblock
14786 #: ../fish/guestfish-actions.pod:4578 ../src/guestfs-actions.pod:6882
14787 msgid ""
14788 "This command disables the libguestfs appliance swap partition with the given "
14789 "UUID."
14790 msgstr ""
14791
14792 #. type: =head2
14793 #: ../fish/guestfish-actions.pod:4581
14794 msgid "swapon-device"
14795 msgstr "swapon-device"
14796
14797 #. type: verbatim
14798 #: ../fish/guestfish-actions.pod:4583
14799 #, no-wrap
14800 msgid ""
14801 " swapon-device device\n"
14802 "\n"
14803 msgstr ""
14804 " swapon-device пристрій\n"
14805 "\n"
14806
14807 #. type: textblock
14808 #: ../fish/guestfish-actions.pod:4585
14809 msgid ""
14810 "This command enables the libguestfs appliance to use the swap device or "
14811 "partition named C<device>.  The increased memory is made available for all "
14812 "commands, for example those run using L</command> or L</sh>."
14813 msgstr ""
14814
14815 #. type: textblock
14816 #: ../fish/guestfish-actions.pod:4590 ../src/guestfs-actions.pod:6900
14817 msgid ""
14818 "Note that you should not swap to existing guest swap partitions unless you "
14819 "know what you are doing.  They may contain hibernation information, or other "
14820 "information that the guest doesn't want you to trash.  You also risk leaking "
14821 "information about the host to the guest this way.  Instead, attach a new "
14822 "host device to the guest and swap on that."
14823 msgstr ""
14824
14825 #. type: =head2
14826 #: ../fish/guestfish-actions.pod:4597
14827 msgid "swapon-file"
14828 msgstr "swapon-file"
14829
14830 #. type: verbatim
14831 #: ../fish/guestfish-actions.pod:4599
14832 #, no-wrap
14833 msgid ""
14834 " swapon-file file\n"
14835 "\n"
14836 msgstr ""
14837 " swapon-file файл\n"
14838 "\n"
14839
14840 #. type: textblock
14841 #: ../fish/guestfish-actions.pod:4601
14842 msgid ""
14843 "This command enables swap to a file.  See L</swapon-device> for other notes."
14844 msgstr ""
14845
14846 #. type: =head2
14847 #: ../fish/guestfish-actions.pod:4604
14848 msgid "swapon-label"
14849 msgstr "swapon-label"
14850
14851 #. type: verbatim
14852 #: ../fish/guestfish-actions.pod:4606
14853 #, no-wrap
14854 msgid ""
14855 " swapon-label label\n"
14856 "\n"
14857 msgstr ""
14858 " swapon-label мітка\n"
14859 "\n"
14860
14861 #. type: textblock
14862 #: ../fish/guestfish-actions.pod:4608
14863 msgid ""
14864 "This command enables swap to a labeled swap partition.  See L</swapon-"
14865 "device> for other notes."
14866 msgstr ""
14867
14868 #. type: =head2
14869 #: ../fish/guestfish-actions.pod:4611
14870 msgid "swapon-uuid"
14871 msgstr "swapon-uuid"
14872
14873 #. type: verbatim
14874 #: ../fish/guestfish-actions.pod:4613
14875 #, no-wrap
14876 msgid ""
14877 " swapon-uuid uuid\n"
14878 "\n"
14879 msgstr ""
14880 " swapon-uuid uuid\n"
14881 "\n"
14882
14883 #. type: textblock
14884 #: ../fish/guestfish-actions.pod:4615
14885 msgid ""
14886 "This command enables swap to a swap partition with the given UUID.  See L</"
14887 "swapon-device> for other notes."
14888 msgstr ""
14889
14890 #. type: =head2
14891 #: ../fish/guestfish-actions.pod:4618
14892 msgid "sync"
14893 msgstr "sync"
14894
14895 #. type: verbatim
14896 #: ../fish/guestfish-actions.pod:4620
14897 #, no-wrap
14898 msgid ""
14899 " sync\n"
14900 "\n"
14901 msgstr ""
14902 " sync\n"
14903 "\n"
14904
14905 #. type: textblock
14906 #: ../fish/guestfish-actions.pod:4622 ../src/guestfs-actions.pod:6955
14907 msgid ""
14908 "This syncs the disk, so that any writes are flushed through to the "
14909 "underlying disk image."
14910 msgstr ""
14911
14912 #. type: textblock
14913 #: ../fish/guestfish-actions.pod:4625 ../src/guestfs-actions.pod:6958
14914 msgid ""
14915 "You should always call this if you have modified a disk image, before "
14916 "closing the handle."
14917 msgstr ""
14918
14919 #. type: =head2
14920 #: ../fish/guestfish-actions.pod:4628
14921 msgid "tail"
14922 msgstr "tail"
14923
14924 #. type: verbatim
14925 #: ../fish/guestfish-actions.pod:4630
14926 #, no-wrap
14927 msgid ""
14928 " tail path\n"
14929 "\n"
14930 msgstr ""
14931 " tail шлях\n"
14932 "\n"
14933
14934 #. type: textblock
14935 #: ../fish/guestfish-actions.pod:4632 ../src/guestfs-actions.pod:6971
14936 msgid ""
14937 "This command returns up to the last 10 lines of a file as a list of strings."
14938 msgstr ""
14939
14940 #. type: =head2
14941 #: ../fish/guestfish-actions.pod:4638
14942 msgid "tail-n"
14943 msgstr "tail-n"
14944
14945 #. type: verbatim
14946 #: ../fish/guestfish-actions.pod:4640
14947 #, no-wrap
14948 msgid ""
14949 " tail-n nrlines path\n"
14950 "\n"
14951 msgstr ""
14952
14953 #. type: textblock
14954 #: ../fish/guestfish-actions.pod:4642 ../src/guestfs-actions.pod:6990
14955 msgid ""
14956 "If the parameter C<nrlines> is a positive number, this returns the last "
14957 "C<nrlines> lines of the file C<path>."
14958 msgstr ""
14959
14960 #. type: textblock
14961 #: ../fish/guestfish-actions.pod:4645 ../src/guestfs-actions.pod:6993
14962 msgid ""
14963 "If the parameter C<nrlines> is a negative number, this returns lines from "
14964 "the file C<path>, starting with the C<-nrlines>th line."
14965 msgstr ""
14966
14967 #. type: =head2
14968 #: ../fish/guestfish-actions.pod:4653
14969 msgid "tar-in"
14970 msgstr "tar-in"
14971
14972 #. type: verbatim
14973 #: ../fish/guestfish-actions.pod:4655
14974 #, no-wrap
14975 msgid ""
14976 " tar-in (tarfile|-) directory\n"
14977 "\n"
14978 msgstr ""
14979 " tar-in (файл_tar|-) каталог\n"
14980 "\n"
14981
14982 #. type: textblock
14983 #: ../fish/guestfish-actions.pod:4657 ../src/guestfs-actions.pod:7014
14984 msgid ""
14985 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
14986 "tar file) into C<directory>."
14987 msgstr ""
14988
14989 #. type: textblock
14990 #: ../fish/guestfish-actions.pod:4660
14991 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
14992 msgstr ""
14993
14994 #. type: =head2
14995 #: ../fish/guestfish-actions.pod:4665
14996 msgid "tar-out"
14997 msgstr "tar-out"
14998
14999 #. type: verbatim
15000 #: ../fish/guestfish-actions.pod:4667
15001 #, no-wrap
15002 msgid ""
15003 " tar-out directory (tarfile|-)\n"
15004 "\n"
15005 msgstr ""
15006 " tar-out каталог (файл tar|-)\n"
15007 "\n"
15008
15009 #. type: textblock
15010 #: ../fish/guestfish-actions.pod:4669 ../src/guestfs-actions.pod:7031
15011 msgid ""
15012 "This command packs the contents of C<directory> and downloads it to local "
15013 "file C<tarfile>."
15014 msgstr ""
15015
15016 #. type: textblock
15017 #: ../fish/guestfish-actions.pod:4672
15018 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
15019 msgstr ""
15020
15021 #. type: =head2
15022 #: ../fish/guestfish-actions.pod:4677
15023 msgid "tgz-in"
15024 msgstr "tgz-in"
15025
15026 #. type: verbatim
15027 #: ../fish/guestfish-actions.pod:4679
15028 #, no-wrap
15029 msgid ""
15030 " tgz-in (tarball|-) directory\n"
15031 "\n"
15032 msgstr ""
15033 " tgz-in (архів tar|-) каталог\n"
15034 "\n"
15035
15036 #. type: textblock
15037 #: ../fish/guestfish-actions.pod:4681 ../src/guestfs-actions.pod:7048
15038 msgid ""
15039 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
15040 "tar file) into C<directory>."
15041 msgstr ""
15042
15043 #. type: textblock
15044 #: ../fish/guestfish-actions.pod:4684
15045 msgid "To upload an uncompressed tarball, use L</tar-in>."
15046 msgstr ""
15047
15048 #. type: =head2
15049 #: ../fish/guestfish-actions.pod:4688
15050 msgid "tgz-out"
15051 msgstr "tgz-out"
15052
15053 #. type: verbatim
15054 #: ../fish/guestfish-actions.pod:4690
15055 #, no-wrap
15056 msgid ""
15057 " tgz-out directory (tarball|-)\n"
15058 "\n"
15059 msgstr ""
15060 " tgz-out каталог (архів tar|-)\n"
15061 "\n"
15062
15063 #. type: textblock
15064 #: ../fish/guestfish-actions.pod:4692 ../src/guestfs-actions.pod:7064
15065 msgid ""
15066 "This command packs the contents of C<directory> and downloads it to local "
15067 "file C<tarball>."
15068 msgstr ""
15069
15070 #. type: textblock
15071 #: ../fish/guestfish-actions.pod:4695
15072 msgid "To download an uncompressed tarball, use L</tar-out>."
15073 msgstr ""
15074
15075 #. type: =head2
15076 #: ../fish/guestfish-actions.pod:4699
15077 msgid "touch"
15078 msgstr "touch"
15079
15080 #. type: verbatim
15081 #: ../fish/guestfish-actions.pod:4701
15082 #, no-wrap
15083 msgid ""
15084 " touch path\n"
15085 "\n"
15086 msgstr ""
15087 " touch шлях\n"
15088 "\n"
15089
15090 #. type: textblock
15091 #: ../fish/guestfish-actions.pod:4703 ../src/guestfs-actions.pod:7079
15092 msgid ""
15093 "Touch acts like the L<touch(1)> command.  It can be used to update the "
15094 "timestamps on a file, or, if the file does not exist, to create a new zero-"
15095 "length file."
15096 msgstr ""
15097
15098 #. type: textblock
15099 #: ../fish/guestfish-actions.pod:4707 ../src/guestfs-actions.pod:7083
15100 msgid ""
15101 "This command only works on regular files, and will fail on other file types "
15102 "such as directories, symbolic links, block special etc."
15103 msgstr ""
15104
15105 #. type: =head2
15106 #: ../fish/guestfish-actions.pod:4710
15107 msgid "truncate"
15108 msgstr "truncate"
15109
15110 #. type: verbatim
15111 #: ../fish/guestfish-actions.pod:4712
15112 #, no-wrap
15113 msgid ""
15114 " truncate path\n"
15115 "\n"
15116 msgstr ""
15117 " truncate шлях\n"
15118 "\n"
15119
15120 #. type: textblock
15121 #: ../fish/guestfish-actions.pod:4714 ../src/guestfs-actions.pod:7096
15122 msgid ""
15123 "This command truncates C<path> to a zero-length file.  The file must exist "
15124 "already."
15125 msgstr ""
15126
15127 #. type: =head2
15128 #: ../fish/guestfish-actions.pod:4717
15129 msgid "truncate-size"
15130 msgstr "truncate-size"
15131
15132 #. type: verbatim
15133 #: ../fish/guestfish-actions.pod:4719
15134 #, no-wrap
15135 msgid ""
15136 " truncate-size path size\n"
15137 "\n"
15138 msgstr ""
15139 " truncate-size шлях розмір\n"
15140 "\n"
15141
15142 #. type: textblock
15143 #: ../fish/guestfish-actions.pod:4721 ../src/guestfs-actions.pod:7110
15144 msgid ""
15145 "This command truncates C<path> to size C<size> bytes.  The file must exist "
15146 "already."
15147 msgstr ""
15148
15149 #. type: textblock
15150 #: ../fish/guestfish-actions.pod:4724
15151 msgid ""
15152 "If the current file size is less than C<size> then the file is extended to "
15153 "the required size with zero bytes.  This creates a sparse file (ie. disk "
15154 "blocks are not allocated for the file until you write to it).  To create a "
15155 "non-sparse file of zeroes, use L</fallocate64> instead."
15156 msgstr ""
15157
15158 #. type: =head2
15159 #: ../fish/guestfish-actions.pod:4730
15160 msgid "tune2fs-l"
15161 msgstr "tune2fs-l"
15162
15163 #. type: verbatim
15164 #: ../fish/guestfish-actions.pod:4732
15165 #, no-wrap
15166 msgid ""
15167 " tune2fs-l device\n"
15168 "\n"
15169 msgstr ""
15170 " tune2fs-l пристрій\n"
15171 "\n"
15172
15173 #. type: textblock
15174 #: ../fish/guestfish-actions.pod:4734 ../src/guestfs-actions.pod:7129
15175 msgid ""
15176 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
15177 "C<device>."
15178 msgstr ""
15179
15180 #. type: textblock
15181 #: ../fish/guestfish-actions.pod:4737 ../src/guestfs-actions.pod:7132
15182 msgid ""
15183 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
15184 "for more details.  The list of fields returned isn't clearly defined, and "
15185 "depends on both the version of C<tune2fs> that libguestfs was built against, "
15186 "and the filesystem itself."
15187 msgstr ""
15188
15189 #. type: =head2
15190 #: ../fish/guestfish-actions.pod:4742
15191 msgid "txz-in"
15192 msgstr "txz-in"
15193
15194 #. type: verbatim
15195 #: ../fish/guestfish-actions.pod:4744
15196 #, no-wrap
15197 msgid ""
15198 " txz-in (tarball|-) directory\n"
15199 "\n"
15200 msgstr ""
15201 " txz-in (архів tar|-) каталог\n"
15202 "\n"
15203
15204 #. type: textblock
15205 #: ../fish/guestfish-actions.pod:4746 ../src/guestfs-actions.pod:7152
15206 msgid ""
15207 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
15208 "tar file) into C<directory>."
15209 msgstr ""
15210
15211 #. type: =head2
15212 #: ../fish/guestfish-actions.pod:4751
15213 msgid "txz-out"
15214 msgstr "txz-out"
15215
15216 #. type: verbatim
15217 #: ../fish/guestfish-actions.pod:4753
15218 #, no-wrap
15219 msgid ""
15220 " txz-out directory (tarball|-)\n"
15221 "\n"
15222 msgstr ""
15223 " txz-out каталог (архів tar|-)\n"
15224 "\n"
15225
15226 #. type: textblock
15227 #: ../fish/guestfish-actions.pod:4755 ../src/guestfs-actions.pod:7166
15228 msgid ""
15229 "This command packs the contents of C<directory> and downloads it to local "
15230 "file C<tarball> (as an xz compressed tar archive)."
15231 msgstr ""
15232
15233 #. type: =head2
15234 #: ../fish/guestfish-actions.pod:4760
15235 msgid "umask"
15236 msgstr "umask"
15237
15238 #. type: verbatim
15239 #: ../fish/guestfish-actions.pod:4762
15240 #, no-wrap
15241 msgid ""
15242 " umask mask\n"
15243 "\n"
15244 msgstr ""
15245 " umask маска\n"
15246 "\n"
15247
15248 #. type: textblock
15249 #: ../fish/guestfish-actions.pod:4764 ../src/guestfs-actions.pod:7179
15250 msgid ""
15251 "This function sets the mask used for creating new files and device nodes to "
15252 "C<mask & 0777>."
15253 msgstr ""
15254
15255 #. type: textblock
15256 #: ../fish/guestfish-actions.pod:4767 ../src/guestfs-actions.pod:7182
15257 msgid ""
15258 "Typical umask values would be C<022> which creates new files with "
15259 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
15260 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
15261 msgstr ""
15262
15263 #. type: textblock
15264 #: ../fish/guestfish-actions.pod:4772 ../src/guestfs-actions.pod:7187
15265 msgid ""
15266 "The default umask is C<022>.  This is important because it means that "
15267 "directories and device nodes will be created with C<0644> or C<0755> mode "
15268 "even if you specify C<0777>."
15269 msgstr ""
15270
15271 #. type: textblock
15272 #: ../fish/guestfish-actions.pod:4776
15273 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
15274 msgstr "Див. також L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
15275
15276 #. type: textblock
15277 #: ../fish/guestfish-actions.pod:4779 ../src/guestfs-actions.pod:7194
15278 msgid "This call returns the previous umask."
15279 msgstr ""
15280
15281 #. type: =head2
15282 #: ../fish/guestfish-actions.pod:4781
15283 msgid "umount"
15284 msgstr "umount"
15285
15286 #. type: =head2
15287 #: ../fish/guestfish-actions.pod:4783
15288 msgid "unmount"
15289 msgstr "unmount"
15290
15291 #. type: verbatim
15292 #: ../fish/guestfish-actions.pod:4785
15293 #, no-wrap
15294 msgid ""
15295 " umount pathordevice\n"
15296 "\n"
15297 msgstr ""
15298 " umount шлях_або_пристрій\n"
15299 "\n"
15300
15301 #. type: textblock
15302 #: ../fish/guestfish-actions.pod:4787 ../src/guestfs-actions.pod:7206
15303 msgid ""
15304 "This unmounts the given filesystem.  The filesystem may be specified either "
15305 "by its mountpoint (path) or the device which contains the filesystem."
15306 msgstr ""
15307
15308 #. type: =head2
15309 #: ../fish/guestfish-actions.pod:4791
15310 msgid "umount-all"
15311 msgstr "umount-all"
15312
15313 #. type: =head2
15314 #: ../fish/guestfish-actions.pod:4793
15315 msgid "unmount-all"
15316 msgstr "unmount-all"
15317
15318 #. type: verbatim
15319 #: ../fish/guestfish-actions.pod:4795
15320 #, no-wrap
15321 msgid ""
15322 " umount-all\n"
15323 "\n"
15324 msgstr ""
15325 " umount-all\n"
15326 "\n"
15327
15328 #. type: textblock
15329 #: ../fish/guestfish-actions.pod:4797 ../src/guestfs-actions.pod:7219
15330 msgid "This unmounts all mounted filesystems."
15331 msgstr ""
15332
15333 #. type: textblock
15334 #: ../fish/guestfish-actions.pod:4799 ../src/guestfs-actions.pod:7221
15335 msgid "Some internal mounts are not unmounted by this call."
15336 msgstr ""
15337
15338 #. type: =head2
15339 #: ../fish/guestfish-actions.pod:4801
15340 msgid "upload"
15341 msgstr "upload"
15342
15343 #. type: verbatim
15344 #: ../fish/guestfish-actions.pod:4803
15345 #, no-wrap
15346 msgid ""
15347 " upload (filename|-) remotefilename\n"
15348 "\n"
15349 msgstr ""
15350 " upload (назва_файла|-) назва_віддаленого_файла\n"
15351 "\n"
15352
15353 #. type: textblock
15354 #: ../fish/guestfish-actions.pod:4805 ../fish/guestfish-actions.pod:4818
15355 #: ../src/guestfs-actions.pod:7234 ../src/guestfs-actions.pod:7258
15356 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
15357 msgstr ""
15358
15359 #. type: textblock
15360 #: ../fish/guestfish-actions.pod:4810
15361 msgid "See also L</download>."
15362 msgstr "Див. також L</download>."
15363
15364 #. type: =head2
15365 #: ../fish/guestfish-actions.pod:4814
15366 msgid "upload-offset"
15367 msgstr "upload-offset"
15368
15369 #. type: verbatim
15370 #: ../fish/guestfish-actions.pod:4816
15371 #, no-wrap
15372 msgid ""
15373 " upload-offset (filename|-) remotefilename offset\n"
15374 "\n"
15375 msgstr ""
15376 " upload-offset (назва_файла|-) назва_віддаленого_файла відступ\n"
15377 "\n"
15378
15379 #. type: textblock
15380 #: ../fish/guestfish-actions.pod:4821 ../src/guestfs-actions.pod:7261
15381 msgid ""
15382 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
15383 "The intention is to overwrite parts of existing files or devices, although "
15384 "if a non-existant file is specified then it is created with a \"hole\" "
15385 "before C<offset>.  The size of the data written is implicit in the size of "
15386 "the source C<filename>."
15387 msgstr ""
15388
15389 #. type: textblock
15390 #: ../fish/guestfish-actions.pod:4828
15391 msgid ""
15392 "Note that there is no limit on the amount of data that can be uploaded with "
15393 "this call, unlike with L</pwrite>, and this call always writes the full "
15394 "amount unless an error occurs."
15395 msgstr ""
15396
15397 #. type: textblock
15398 #: ../fish/guestfish-actions.pod:4833
15399 msgid "See also L</upload>, L</pwrite>."
15400 msgstr "Див. також L</upload>, L</pwrite>."
15401
15402 #. type: =head2
15403 #: ../fish/guestfish-actions.pod:4837
15404 msgid "utimens"
15405 msgstr "utimens"
15406
15407 #. type: verbatim
15408 #: ../fish/guestfish-actions.pod:4839
15409 #, no-wrap
15410 msgid ""
15411 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
15412 "\n"
15413 msgstr ""
15414
15415 #. type: textblock
15416 #: ../fish/guestfish-actions.pod:4841 ../src/guestfs-actions.pod:7294
15417 msgid "This command sets the timestamps of a file with nanosecond precision."
15418 msgstr ""
15419
15420 #. type: textblock
15421 #: ../fish/guestfish-actions.pod:4844 ../src/guestfs-actions.pod:7297
15422 msgid ""
15423 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
15424 "from the epoch."
15425 msgstr ""
15426
15427 #. type: textblock
15428 #: ../fish/guestfish-actions.pod:4847 ../src/guestfs-actions.pod:7300
15429 msgid ""
15430 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
15431 "nanoseconds from the epoch."
15432 msgstr ""
15433
15434 #. type: textblock
15435 #: ../fish/guestfish-actions.pod:4850 ../src/guestfs-actions.pod:7303
15436 msgid ""
15437 "If the C<*nsecs> field contains the special value C<-1> then the "
15438 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
15439 "ignored in this case)."
15440 msgstr ""
15441
15442 #. type: textblock
15443 #: ../fish/guestfish-actions.pod:4854 ../src/guestfs-actions.pod:7307
15444 msgid ""
15445 "If the C<*nsecs> field contains the special value C<-2> then the "
15446 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
15447 "in this case)."
15448 msgstr ""
15449
15450 #. type: =head2
15451 #: ../fish/guestfish-actions.pod:4858
15452 msgid "version"
15453 msgstr "version"
15454
15455 #. type: verbatim
15456 #: ../fish/guestfish-actions.pod:4860
15457 #, no-wrap
15458 msgid ""
15459 " version\n"
15460 "\n"
15461 msgstr ""
15462 " version\n"
15463 "\n"
15464
15465 #. type: textblock
15466 #: ../fish/guestfish-actions.pod:4862 ../src/guestfs-actions.pod:7320
15467 msgid ""
15468 "Return the libguestfs version number that the program is linked against."
15469 msgstr ""
15470
15471 #. type: textblock
15472 #: ../fish/guestfish-actions.pod:4865 ../src/guestfs-actions.pod:7323
15473 msgid ""
15474 "Note that because of dynamic linking this is not necessarily the version of "
15475 "libguestfs that you compiled against.  You can compile the program, and then "
15476 "at runtime dynamically link against a completely different C<libguestfs.so> "
15477 "library."
15478 msgstr ""
15479
15480 #. type: textblock
15481 #: ../fish/guestfish-actions.pod:4870 ../src/guestfs-actions.pod:7328
15482 msgid ""
15483 "This call was added in version C<1.0.58>.  In previous versions of "
15484 "libguestfs there was no way to get the version number.  From C code you can "
15485 "use dynamic linker functions to find out if this symbol exists (if it "
15486 "doesn't, then it's an earlier version)."
15487 msgstr ""
15488
15489 #. type: textblock
15490 #: ../fish/guestfish-actions.pod:4876 ../src/guestfs-actions.pod:7334
15491 msgid ""
15492 "The call returns a structure with four elements.  The first three (C<major>, "
15493 "C<minor> and C<release>) are numbers and correspond to the usual version "
15494 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
15495 "but may be used for distro-specific information."
15496 msgstr ""
15497
15498 #. type: textblock
15499 #: ../fish/guestfish-actions.pod:4882 ../src/guestfs-actions.pod:7340
15500 msgid ""
15501 "To construct the original version string: C<$major.$minor.$release$extra>"
15502 msgstr ""
15503
15504 #. type: textblock
15505 #: ../fish/guestfish-actions.pod:4885 ../src/guestfs-actions.pod:7343
15506 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
15507 msgstr ""
15508
15509 #. type: textblock
15510 #: ../fish/guestfish-actions.pod:4887
15511 msgid ""
15512 "I<Note:> Don't use this call to test for availability of features.  In "
15513 "enterprise distributions we backport features from later versions into "
15514 "earlier versions, making this an unreliable way to test for features.  Use "
15515 "L</available> instead."
15516 msgstr ""
15517
15518 #. type: =head2
15519 #: ../fish/guestfish-actions.pod:4893
15520 msgid "vfs-label"
15521 msgstr "vfs-label"
15522
15523 #. type: verbatim
15524 #: ../fish/guestfish-actions.pod:4895
15525 #, no-wrap
15526 msgid ""
15527 " vfs-label device\n"
15528 "\n"
15529 msgstr ""
15530 " vfs-label пристрій\n"
15531 "\n"
15532
15533 #. type: textblock
15534 #: ../fish/guestfish-actions.pod:4897 ../src/guestfs-actions.pod:7363
15535 msgid "This returns the filesystem label of the filesystem on C<device>."
15536 msgstr ""
15537
15538 #. type: textblock
15539 #: ../fish/guestfish-actions.pod:4900 ../src/guestfs-actions.pod:7366
15540 msgid "If the filesystem is unlabeled, this returns the empty string."
15541 msgstr ""
15542
15543 #. type: textblock
15544 #: ../fish/guestfish-actions.pod:4902
15545 msgid "To find a filesystem from the label, use L</findfs-label>."
15546 msgstr ""
15547
15548 #. type: =head2
15549 #: ../fish/guestfish-actions.pod:4904
15550 msgid "vfs-type"
15551 msgstr "vfs-type"
15552
15553 #. type: verbatim
15554 #: ../fish/guestfish-actions.pod:4906
15555 #, no-wrap
15556 msgid ""
15557 " vfs-type device\n"
15558 "\n"
15559 msgstr ""
15560 " vfs-type пристрій\n"
15561 "\n"
15562
15563 #. type: textblock
15564 #: ../fish/guestfish-actions.pod:4908 ../src/guestfs-actions.pod:7381
15565 msgid ""
15566 "This command gets the filesystem type corresponding to the filesystem on "
15567 "C<device>."
15568 msgstr ""
15569
15570 #. type: textblock
15571 #: ../fish/guestfish-actions.pod:4911 ../src/guestfs-actions.pod:7384
15572 msgid ""
15573 "For most filesystems, the result is the name of the Linux VFS module which "
15574 "would be used to mount this filesystem if you mounted it without specifying "
15575 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
15576 msgstr ""
15577
15578 #. type: =head2
15579 #: ../fish/guestfish-actions.pod:4916
15580 msgid "vfs-uuid"
15581 msgstr "vfs-uuid"
15582
15583 #. type: verbatim
15584 #: ../fish/guestfish-actions.pod:4918
15585 #, no-wrap
15586 msgid ""
15587 " vfs-uuid device\n"
15588 "\n"
15589 msgstr ""
15590 " vfs-uuid пристрій\n"
15591 "\n"
15592
15593 #. type: textblock
15594 #: ../fish/guestfish-actions.pod:4920 ../src/guestfs-actions.pod:7400
15595 msgid "This returns the filesystem UUID of the filesystem on C<device>."
15596 msgstr ""
15597
15598 #. type: textblock
15599 #: ../fish/guestfish-actions.pod:4923 ../src/guestfs-actions.pod:7403
15600 msgid "If the filesystem does not have a UUID, this returns the empty string."
15601 msgstr ""
15602
15603 #. type: textblock
15604 #: ../fish/guestfish-actions.pod:4925
15605 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
15606 msgstr ""
15607
15608 #. type: =head2
15609 #: ../fish/guestfish-actions.pod:4927
15610 msgid "vg-activate"
15611 msgstr "vg-activate"
15612
15613 #. type: verbatim
15614 #: ../fish/guestfish-actions.pod:4929
15615 #, no-wrap
15616 msgid ""
15617 " vg-activate true|false 'volgroups ...'\n"
15618 "\n"
15619 msgstr ""
15620
15621 #. type: textblock
15622 #: ../fish/guestfish-actions.pod:4931 ../src/guestfs-actions.pod:7419
15623 msgid ""
15624 "This command activates or (if C<activate> is false) deactivates all logical "
15625 "volumes in the listed volume groups C<volgroups>."
15626 msgstr ""
15627
15628 #. type: textblock
15629 #: ../fish/guestfish-actions.pod:4934 ../src/guestfs-actions.pod:7422
15630 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
15631 msgstr ""
15632
15633 #. type: textblock
15634 #: ../fish/guestfish-actions.pod:4936 ../src/guestfs-actions.pod:7424
15635 msgid ""
15636 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
15637 "activated or deactivated."
15638 msgstr ""
15639
15640 #. type: =head2
15641 #: ../fish/guestfish-actions.pod:4939
15642 msgid "vg-activate-all"
15643 msgstr "vg-activate-all"
15644
15645 #. type: verbatim
15646 #: ../fish/guestfish-actions.pod:4941
15647 #, no-wrap
15648 msgid ""
15649 " vg-activate-all true|false\n"
15650 "\n"
15651 msgstr ""
15652 " vg-activate-all true|false\n"
15653 "\n"
15654
15655 #. type: textblock
15656 #: ../fish/guestfish-actions.pod:4943 ../src/guestfs-actions.pod:7437
15657 msgid ""
15658 "This command activates or (if C<activate> is false) deactivates all logical "
15659 "volumes in all volume groups."
15660 msgstr ""
15661
15662 #. type: textblock
15663 #: ../fish/guestfish-actions.pod:4946 ../src/guestfs-actions.pod:7440
15664 msgid "This command is the same as running C<vgchange -a y|n>"
15665 msgstr ""
15666
15667 #. type: =head2
15668 #: ../fish/guestfish-actions.pod:4948
15669 msgid "vgcreate"
15670 msgstr "vgcreate"
15671
15672 #. type: verbatim
15673 #: ../fish/guestfish-actions.pod:4950
15674 #, no-wrap
15675 msgid ""
15676 " vgcreate volgroup 'physvols ...'\n"
15677 "\n"
15678 msgstr ""
15679
15680 #. type: textblock
15681 #: ../fish/guestfish-actions.pod:4952 ../src/guestfs-actions.pod:7453
15682 msgid ""
15683 "This creates an LVM volume group called C<volgroup> from the non-empty list "
15684 "of physical volumes C<physvols>."
15685 msgstr ""
15686
15687 #. type: =head2
15688 #: ../fish/guestfish-actions.pod:4955
15689 msgid "vglvuuids"
15690 msgstr "vglvuuids"
15691
15692 #. type: verbatim
15693 #: ../fish/guestfish-actions.pod:4957
15694 #, no-wrap
15695 msgid ""
15696 " vglvuuids vgname\n"
15697 "\n"
15698 msgstr ""
15699
15700 #. type: textblock
15701 #: ../fish/guestfish-actions.pod:4959 ../src/guestfs-actions.pod:7466
15702 msgid ""
15703 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
15704 "volumes created in this volume group."
15705 msgstr ""
15706
15707 #. type: textblock
15708 #: ../fish/guestfish-actions.pod:4962
15709 msgid ""
15710 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
15711 "logical volumes and volume groups."
15712 msgstr ""
15713
15714 #. type: textblock
15715 #: ../fish/guestfish-actions.pod:4965
15716 msgid "See also L</vgpvuuids>."
15717 msgstr "Див. також L</vgpvuuids>."
15718
15719 #. type: =head2
15720 #: ../fish/guestfish-actions.pod:4967
15721 msgid "vgpvuuids"
15722 msgstr "vgpvuuids"
15723
15724 #. type: verbatim
15725 #: ../fish/guestfish-actions.pod:4969
15726 #, no-wrap
15727 msgid ""
15728 " vgpvuuids vgname\n"
15729 "\n"
15730 msgstr ""
15731
15732 #. type: textblock
15733 #: ../fish/guestfish-actions.pod:4971 ../src/guestfs-actions.pod:7486
15734 msgid ""
15735 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
15736 "volumes that this volume group resides on."
15737 msgstr ""
15738
15739 #. type: textblock
15740 #: ../fish/guestfish-actions.pod:4974
15741 msgid ""
15742 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
15743 "physical volumes and volume groups."
15744 msgstr ""
15745
15746 #. type: textblock
15747 #: ../fish/guestfish-actions.pod:4977
15748 msgid "See also L</vglvuuids>."
15749 msgstr "Див. також L</vglvuuids>."
15750
15751 #. type: =head2
15752 #: ../fish/guestfish-actions.pod:4979
15753 msgid "vgremove"
15754 msgstr "vgremove"
15755
15756 #. type: verbatim
15757 #: ../fish/guestfish-actions.pod:4981
15758 #, no-wrap
15759 msgid ""
15760 " vgremove vgname\n"
15761 "\n"
15762 msgstr ""
15763
15764 #. type: textblock
15765 #: ../fish/guestfish-actions.pod:4983 ../src/guestfs-actions.pod:7506
15766 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
15767 msgstr ""
15768
15769 #. type: textblock
15770 #: ../fish/guestfish-actions.pod:4985 ../src/guestfs-actions.pod:7508
15771 msgid ""
15772 "This also forcibly removes all logical volumes in the volume group (if any)."
15773 msgstr ""
15774
15775 #. type: =head2
15776 #: ../fish/guestfish-actions.pod:4988
15777 msgid "vgrename"
15778 msgstr "vgrename"
15779
15780 #. type: verbatim
15781 #: ../fish/guestfish-actions.pod:4990
15782 #, no-wrap
15783 msgid ""
15784 " vgrename volgroup newvolgroup\n"
15785 "\n"
15786 msgstr ""
15787
15788 #. type: textblock
15789 #: ../fish/guestfish-actions.pod:4992 ../src/guestfs-actions.pod:7522
15790 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
15791 msgstr ""
15792
15793 #. type: =head2
15794 #: ../fish/guestfish-actions.pod:4994
15795 msgid "vgs"
15796 msgstr "vgs"
15797
15798 #. type: verbatim
15799 #: ../fish/guestfish-actions.pod:4996
15800 #, no-wrap
15801 msgid ""
15802 " vgs\n"
15803 "\n"
15804 msgstr ""
15805 " vgs\n"
15806 "\n"
15807
15808 #. type: textblock
15809 #: ../fish/guestfish-actions.pod:4998 ../src/guestfs-actions.pod:7533
15810 msgid ""
15811 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
15812 "> command."
15813 msgstr ""
15814
15815 #. type: textblock
15816 #: ../fish/guestfish-actions.pod:5001 ../src/guestfs-actions.pod:7536
15817 msgid ""
15818 "This returns a list of just the volume group names that were detected (eg. "
15819 "C<VolGroup00>)."
15820 msgstr ""
15821
15822 #. type: textblock
15823 #: ../fish/guestfish-actions.pod:5004
15824 msgid "See also L</vgs-full>."
15825 msgstr "Див. також L</vgs-full>."
15826
15827 #. type: =head2
15828 #: ../fish/guestfish-actions.pod:5006
15829 msgid "vgs-full"
15830 msgstr "vgs-full"
15831
15832 #. type: verbatim
15833 #: ../fish/guestfish-actions.pod:5008
15834 #, no-wrap
15835 msgid ""
15836 " vgs-full\n"
15837 "\n"
15838 msgstr ""
15839 " vgs-full\n"
15840 "\n"
15841
15842 #. type: textblock
15843 #: ../fish/guestfish-actions.pod:5010 ../src/guestfs-actions.pod:7552
15844 msgid ""
15845 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
15846 "> command.  The \"full\" version includes all fields."
15847 msgstr ""
15848
15849 #. type: =head2
15850 #: ../fish/guestfish-actions.pod:5013
15851 msgid "vgscan"
15852 msgstr "vgscan"
15853
15854 #. type: verbatim
15855 #: ../fish/guestfish-actions.pod:5015
15856 #, no-wrap
15857 msgid ""
15858 " vgscan\n"
15859 "\n"
15860 msgstr ""
15861 " vgscan\n"
15862 "\n"
15863
15864 #. type: textblock
15865 #: ../fish/guestfish-actions.pod:5017 ../src/guestfs-actions.pod:7566
15866 msgid ""
15867 "This rescans all block devices and rebuilds the list of LVM physical "
15868 "volumes, volume groups and logical volumes."
15869 msgstr ""
15870
15871 #. type: =head2
15872 #: ../fish/guestfish-actions.pod:5020
15873 msgid "vguuid"
15874 msgstr "vguuid"
15875
15876 #. type: verbatim
15877 #: ../fish/guestfish-actions.pod:5022
15878 #, no-wrap
15879 msgid ""
15880 " vguuid vgname\n"
15881 "\n"
15882 msgstr ""
15883
15884 #. type: textblock
15885 #: ../fish/guestfish-actions.pod:5024 ../src/guestfs-actions.pod:7579
15886 msgid "This command returns the UUID of the LVM VG named C<vgname>."
15887 msgstr ""
15888
15889 #. type: =head2
15890 #: ../fish/guestfish-actions.pod:5026
15891 msgid "wc-c"
15892 msgstr "wc-c"
15893
15894 #. type: verbatim
15895 #: ../fish/guestfish-actions.pod:5028
15896 #, no-wrap
15897 msgid ""
15898 " wc-c path\n"
15899 "\n"
15900 msgstr ""
15901 " wc-c шлях\n"
15902 "\n"
15903
15904 #. type: textblock
15905 #: ../fish/guestfish-actions.pod:5030 ../src/guestfs-actions.pod:7619
15906 msgid ""
15907 "This command counts the characters in a file, using the C<wc -c> external "
15908 "command."
15909 msgstr ""
15910
15911 #. type: =head2
15912 #: ../fish/guestfish-actions.pod:5033
15913 msgid "wc-l"
15914 msgstr "wc-l"
15915
15916 #. type: verbatim
15917 #: ../fish/guestfish-actions.pod:5035
15918 #, no-wrap
15919 msgid ""
15920 " wc-l path\n"
15921 "\n"
15922 msgstr ""
15923 " wc-l шлях\n"
15924 "\n"
15925
15926 #. type: textblock
15927 #: ../fish/guestfish-actions.pod:5037 ../src/guestfs-actions.pod:7632
15928 msgid ""
15929 "This command counts the lines in a file, using the C<wc -l> external command."
15930 msgstr ""
15931
15932 #. type: =head2
15933 #: ../fish/guestfish-actions.pod:5040
15934 msgid "wc-w"
15935 msgstr "wc-w"
15936
15937 #. type: verbatim
15938 #: ../fish/guestfish-actions.pod:5042
15939 #, no-wrap
15940 msgid ""
15941 " wc-w path\n"
15942 "\n"
15943 msgstr ""
15944 " wc-w шлях\n"
15945 "\n"
15946
15947 #. type: textblock
15948 #: ../fish/guestfish-actions.pod:5044 ../src/guestfs-actions.pod:7645
15949 msgid ""
15950 "This command counts the words in a file, using the C<wc -w> external command."
15951 msgstr ""
15952
15953 #. type: =head2
15954 #: ../fish/guestfish-actions.pod:5047
15955 msgid "write"
15956 msgstr "write"
15957
15958 #. type: verbatim
15959 #: ../fish/guestfish-actions.pod:5049
15960 #, no-wrap
15961 msgid ""
15962 " write path content\n"
15963 "\n"
15964 msgstr ""
15965 " write шлях дані\n"
15966 "\n"
15967
15968 #. type: textblock
15969 #: ../fish/guestfish-actions.pod:5051 ../src/guestfs-actions.pod:7660
15970 msgid ""
15971 "This call creates a file called C<path>.  The content of the file is the "
15972 "string C<content> (which can contain any 8 bit data)."
15973 msgstr ""
15974
15975 #. type: textblock
15976 #: ../fish/guestfish-actions.pod:5054
15977 msgid "See also L</write-append>."
15978 msgstr ""
15979
15980 #. type: =head2
15981 #: ../fish/guestfish-actions.pod:5059
15982 msgid "write-append"
15983 msgstr ""
15984
15985 #. type: verbatim
15986 #: ../fish/guestfish-actions.pod:5061
15987 #, no-wrap
15988 msgid ""
15989 " write-append path content\n"
15990 "\n"
15991 msgstr ""
15992
15993 #. type: textblock
15994 #: ../fish/guestfish-actions.pod:5063 ../src/guestfs-actions.pod:7680
15995 msgid ""
15996 "This call appends C<content> to the end of file C<path>.  If C<path> does "
15997 "not exist, then a new file is created."
15998 msgstr ""
15999
16000 #. type: textblock
16001 #: ../fish/guestfish-actions.pod:5066
16002 msgid "See also L</write>."
16003 msgstr ""
16004
16005 #. type: =head2
16006 #: ../fish/guestfish-actions.pod:5071
16007 msgid "write-file"
16008 msgstr "write-file"
16009
16010 #. type: verbatim
16011 #: ../fish/guestfish-actions.pod:5073
16012 #, no-wrap
16013 msgid ""
16014 " write-file path content size\n"
16015 "\n"
16016 msgstr ""
16017
16018 #. type: textblock
16019 #: ../fish/guestfish-actions.pod:5075 ../src/guestfs-actions.pod:7700
16020 msgid ""
16021 "This call creates a file called C<path>.  The contents of the file is the "
16022 "string C<content> (which can contain any 8 bit data), with length C<size>."
16023 msgstr ""
16024
16025 #. type: textblock
16026 #: ../fish/guestfish-actions.pod:5079 ../src/guestfs-actions.pod:7704
16027 msgid ""
16028 "As a special case, if C<size> is C<0> then the length is calculated using "
16029 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
16030 msgstr ""
16031
16032 #. type: textblock
16033 #: ../fish/guestfish-actions.pod:5083 ../src/guestfs-actions.pod:7708
16034 msgid ""
16035 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
16036 "I<not> work, even if the length is specified."
16037 msgstr ""
16038
16039 #. type: textblock
16040 #: ../fish/guestfish-actions.pod:5089
16041 msgid ""
16042 "This function is deprecated.  In new code, use the L</write> call instead."
16043 msgstr ""
16044
16045 #. type: =head2
16046 #: ../fish/guestfish-actions.pod:5096
16047 msgid "zegrep"
16048 msgstr "zegrep"
16049
16050 #. type: verbatim
16051 #: ../fish/guestfish-actions.pod:5098
16052 #, no-wrap
16053 msgid ""
16054 " zegrep regex path\n"
16055 "\n"
16056 msgstr ""
16057 " zegrep формальний_вираз шлях\n"
16058 "\n"
16059
16060 #. type: textblock
16061 #: ../fish/guestfish-actions.pod:5100 ../src/guestfs-actions.pod:7732
16062 msgid ""
16063 "This calls the external C<zegrep> program and returns the matching lines."
16064 msgstr ""
16065
16066 #. type: =head2
16067 #: ../fish/guestfish-actions.pod:5106
16068 msgid "zegrepi"
16069 msgstr "zegrepi"
16070
16071 #. type: verbatim
16072 #: ../fish/guestfish-actions.pod:5108
16073 #, no-wrap
16074 msgid ""
16075 " zegrepi regex path\n"
16076 "\n"
16077 msgstr ""
16078
16079 #. type: textblock
16080 #: ../fish/guestfish-actions.pod:5110 ../src/guestfs-actions.pod:7751
16081 msgid ""
16082 "This calls the external C<zegrep -i> program and returns the matching lines."
16083 msgstr ""
16084
16085 #. type: =head2
16086 #: ../fish/guestfish-actions.pod:5116
16087 msgid "zero"
16088 msgstr "zero"
16089
16090 #. type: verbatim
16091 #: ../fish/guestfish-actions.pod:5118
16092 #, no-wrap
16093 msgid ""
16094 " zero device\n"
16095 "\n"
16096 msgstr ""
16097 " zero пристрій\n"
16098 "\n"
16099
16100 #. type: textblock
16101 #: ../fish/guestfish-actions.pod:5120 ../src/guestfs-actions.pod:7769
16102 msgid "This command writes zeroes over the first few blocks of C<device>."
16103 msgstr ""
16104
16105 #. type: textblock
16106 #: ../fish/guestfish-actions.pod:5122 ../src/guestfs-actions.pod:7771
16107 msgid ""
16108 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
16109 "securely wipe the device).  It should be sufficient to remove any partition "
16110 "tables, filesystem superblocks and so on."
16111 msgstr ""
16112
16113 #. type: textblock
16114 #: ../fish/guestfish-actions.pod:5126 ../fish/guestfish-actions.pod:5141
16115 #: ../src/guestfs-actions.pod:7775 ../src/guestfs-actions.pod:7801
16116 msgid ""
16117 "If blocks are already zero, then this command avoids writing zeroes.  This "
16118 "prevents the underlying device from becoming non-sparse or growing "
16119 "unnecessarily."
16120 msgstr ""
16121
16122 #. type: textblock
16123 #: ../fish/guestfish-actions.pod:5130
16124 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>"
16125 msgstr ""
16126
16127 #. type: =head2
16128 #: ../fish/guestfish-actions.pod:5133
16129 msgid "zero-device"
16130 msgstr "zero-device"
16131
16132 #. type: verbatim
16133 #: ../fish/guestfish-actions.pod:5135
16134 #, no-wrap
16135 msgid ""
16136 " zero-device device\n"
16137 "\n"
16138 msgstr ""
16139 " zero-device пристрій\n"
16140 "\n"
16141
16142 #. type: textblock
16143 #: ../fish/guestfish-actions.pod:5137
16144 msgid ""
16145 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
16146 "which just zeroes the first few blocks of a device."
16147 msgstr ""
16148
16149 #. type: =head2
16150 #: ../fish/guestfish-actions.pod:5148
16151 msgid "zerofree"
16152 msgstr "zerofree"
16153
16154 #. type: verbatim
16155 #: ../fish/guestfish-actions.pod:5150
16156 #, no-wrap
16157 msgid ""
16158 " zerofree device\n"
16159 "\n"
16160 msgstr ""
16161 " zerofree пристрій\n"
16162 "\n"
16163
16164 #. type: textblock
16165 #: ../fish/guestfish-actions.pod:5152 ../src/guestfs-actions.pod:7823
16166 msgid ""
16167 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
16168 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
16169 "possible to compress the filesystem more effectively."
16170 msgstr ""
16171
16172 #. type: textblock
16173 #: ../fish/guestfish-actions.pod:5157 ../src/guestfs-actions.pod:7828
16174 msgid "You should B<not> run this program if the filesystem is mounted."
16175 msgstr ""
16176
16177 #. type: textblock
16178 #: ../fish/guestfish-actions.pod:5160 ../src/guestfs-actions.pod:7831
16179 msgid ""
16180 "It is possible that using this program can damage the filesystem or data on "
16181 "the filesystem."
16182 msgstr ""
16183
16184 #. type: =head2
16185 #: ../fish/guestfish-actions.pod:5163
16186 msgid "zfgrep"
16187 msgstr "zfgrep"
16188
16189 #. type: verbatim
16190 #: ../fish/guestfish-actions.pod:5165
16191 #, no-wrap
16192 msgid ""
16193 " zfgrep pattern path\n"
16194 "\n"
16195 msgstr ""
16196 " zfgrep шаблон шлях\n"
16197 "\n"
16198
16199 #. type: textblock
16200 #: ../fish/guestfish-actions.pod:5167 ../src/guestfs-actions.pod:7845
16201 msgid ""
16202 "This calls the external C<zfgrep> program and returns the matching lines."
16203 msgstr ""
16204
16205 #. type: =head2
16206 #: ../fish/guestfish-actions.pod:5173
16207 msgid "zfgrepi"
16208 msgstr "zfgrepi"
16209
16210 #. type: verbatim
16211 #: ../fish/guestfish-actions.pod:5175
16212 #, no-wrap
16213 msgid ""
16214 " zfgrepi pattern path\n"
16215 "\n"
16216 msgstr ""
16217 " zfgrepi шаблон шлях\n"
16218 "\n"
16219
16220 #. type: textblock
16221 #: ../fish/guestfish-actions.pod:5177 ../src/guestfs-actions.pod:7864
16222 msgid ""
16223 "This calls the external C<zfgrep -i> program and returns the matching lines."
16224 msgstr ""
16225
16226 #. type: =head2
16227 #: ../fish/guestfish-actions.pod:5183
16228 msgid "zfile"
16229 msgstr "zfile"
16230
16231 #. type: verbatim
16232 #: ../fish/guestfish-actions.pod:5185
16233 #, no-wrap
16234 msgid ""
16235 " zfile meth path\n"
16236 "\n"
16237 msgstr ""
16238 " zfile метод шлях\n"
16239 "\n"
16240
16241 #. type: textblock
16242 #: ../fish/guestfish-actions.pod:5187 ../src/guestfs-actions.pod:7883
16243 msgid ""
16244 "This command runs C<file> after first decompressing C<path> using C<method>."
16245 msgstr ""
16246
16247 #. type: textblock
16248 #: ../fish/guestfish-actions.pod:5190 ../src/guestfs-actions.pod:7886
16249 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
16250 msgstr ""
16251
16252 #. type: textblock
16253 #: ../fish/guestfish-actions.pod:5192
16254 msgid ""
16255 "Since 1.0.63, use L</file> instead which can now process compressed files."
16256 msgstr ""
16257
16258 #. type: textblock
16259 #: ../fish/guestfish-actions.pod:5195
16260 msgid ""
16261 "This function is deprecated.  In new code, use the L</file> call instead."
16262 msgstr ""
16263
16264 #. type: =head2
16265 #: ../fish/guestfish-actions.pod:5202
16266 msgid "zgrep"
16267 msgstr "zgrep"
16268
16269 #. type: verbatim
16270 #: ../fish/guestfish-actions.pod:5204
16271 #, no-wrap
16272 msgid ""
16273 " zgrep regex path\n"
16274 "\n"
16275 msgstr ""
16276 " zgrep формальний_вираз шлях\n"
16277 "\n"
16278
16279 #. type: textblock
16280 #: ../fish/guestfish-actions.pod:5206 ../src/guestfs-actions.pod:7910
16281 msgid ""
16282 "This calls the external C<zgrep> program and returns the matching lines."
16283 msgstr ""
16284
16285 #. type: =head2
16286 #: ../fish/guestfish-actions.pod:5212
16287 msgid "zgrepi"
16288 msgstr "zgrepi"
16289
16290 #. type: verbatim
16291 #: ../fish/guestfish-actions.pod:5214
16292 #, no-wrap
16293 msgid ""
16294 " zgrepi regex path\n"
16295 "\n"
16296 msgstr ""
16297 " zgrepi формальний_вираз шлях\n"
16298 "\n"
16299
16300 #. type: textblock
16301 #: ../fish/guestfish-actions.pod:5216 ../src/guestfs-actions.pod:7929
16302 msgid ""
16303 "This calls the external C<zgrep -i> program and returns the matching lines."
16304 msgstr ""
16305
16306 #. type: =head2
16307 #: ../fish/guestfish-commands.pod:1
16308 msgid "alloc"
16309 msgstr "alloc"
16310
16311 #. type: =head2
16312 #: ../fish/guestfish-commands.pod:3
16313 msgid "allocate"
16314 msgstr ""
16315
16316 #. type: verbatim
16317 #: ../fish/guestfish-commands.pod:5
16318 #, no-wrap
16319 msgid ""
16320 " alloc filename size\n"
16321 "\n"
16322 msgstr ""
16323
16324 #. type: textblock
16325 #: ../fish/guestfish-commands.pod:7
16326 msgid ""
16327 "This creates an empty (zeroed) file of the given size, and then adds so it "
16328 "can be further examined."
16329 msgstr ""
16330
16331 #. type: textblock
16332 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:182
16333 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
16334 msgstr ""
16335
16336 #. type: textblock
16337 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:184
16338 msgid "Size can be specified using standard suffixes, eg. C<1M>."
16339 msgstr ""
16340
16341 #. type: textblock
16342 #: ../fish/guestfish-commands.pod:14
16343 msgid ""
16344 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
16345 "image, see L</PREPARED DISK IMAGES>."
16346 msgstr ""
16347
16348 #. type: =head2
16349 #: ../fish/guestfish-commands.pod:17
16350 msgid "copy-in"
16351 msgstr "copy-in"
16352
16353 #. type: verbatim
16354 #: ../fish/guestfish-commands.pod:19
16355 #, no-wrap
16356 msgid ""
16357 " copy-in local [local ...] /remotedir\n"
16358 "\n"
16359 msgstr ""
16360
16361 #. type: textblock
16362 #: ../fish/guestfish-commands.pod:21
16363 msgid ""
16364 "C<copy-in> copies local files or directories recursively into the disk "
16365 "image, placing them in the directory called C</remotedir> (which must "
16366 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
16367 "other commands as necessary."
16368 msgstr ""
16369
16370 #. type: textblock
16371 #: ../fish/guestfish-commands.pod:26
16372 msgid ""
16373 "Multiple local files and directories can be specified, but the last "
16374 "parameter must always be a remote directory.  Wildcards cannot be used."
16375 msgstr ""
16376
16377 #. type: =head2
16378 #: ../fish/guestfish-commands.pod:30
16379 msgid "copy-out"
16380 msgstr "copy-out"
16381
16382 #. type: verbatim
16383 #: ../fish/guestfish-commands.pod:32
16384 #, no-wrap
16385 msgid ""
16386 " copy-out remote [remote ...] localdir\n"
16387 "\n"
16388 msgstr ""
16389
16390 #. type: textblock
16391 #: ../fish/guestfish-commands.pod:34
16392 msgid ""
16393 "C<copy-out> copies remote files or directories recursively out of the disk "
16394 "image, placing them on the host disk in a local directory called C<localdir> "
16395 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
16396 "download>, L</tar-out> and other commands as necessary."
16397 msgstr ""
16398
16399 #. type: textblock
16400 #: ../fish/guestfish-commands.pod:40
16401 msgid ""
16402 "Multiple remote files and directories can be specified, but the last "
16403 "parameter must always be a local directory.  To download to the current "
16404 "directory, use C<.> as in:"
16405 msgstr ""
16406
16407 #. type: verbatim
16408 #: ../fish/guestfish-commands.pod:44
16409 #, no-wrap
16410 msgid ""
16411 " copy-out /home .\n"
16412 "\n"
16413 msgstr ""
16414 " copy-out /home .\n"
16415 "\n"
16416
16417 #. type: textblock
16418 #: ../fish/guestfish-commands.pod:46
16419 msgid ""
16420 "Wildcards cannot be used in the ordinary command, but you can use them with "
16421 "the help of L</glob> like this:"
16422 msgstr ""
16423
16424 #. type: verbatim
16425 #: ../fish/guestfish-commands.pod:49
16426 #, no-wrap
16427 msgid ""
16428 " glob copy-out /home/* .\n"
16429 "\n"
16430 msgstr ""
16431 " glob copy-out /home/* .\n"
16432 "\n"
16433
16434 #. type: =head2
16435 #: ../fish/guestfish-commands.pod:51
16436 msgid "display"
16437 msgstr ""
16438
16439 #. type: verbatim
16440 #: ../fish/guestfish-commands.pod:53
16441 #, no-wrap
16442 msgid ""
16443 " display filename\n"
16444 "\n"
16445 msgstr ""
16446
16447 #. type: textblock
16448 #: ../fish/guestfish-commands.pod:55
16449 msgid ""
16450 "Use C<display> (a graphical display program) to display an image file.  It "
16451 "downloads the file, and runs C<display> on it."
16452 msgstr ""
16453
16454 #. type: textblock
16455 #: ../fish/guestfish-commands.pod:58
16456 msgid ""
16457 "To use an alternative program, set the C<GUESTFISH_DISPLAY_IMAGE> "
16458 "environment variable.  For example to use the GNOME display program:"
16459 msgstr ""
16460
16461 #. type: verbatim
16462 #: ../fish/guestfish-commands.pod:61
16463 #, no-wrap
16464 msgid ""
16465 " export GUESTFISH_DISPLAY_IMAGE=eog\n"
16466 "\n"
16467 msgstr ""
16468
16469 #. type: textblock
16470 #: ../fish/guestfish-commands.pod:63
16471 msgid "See also L<display(1)>."
16472 msgstr ""
16473
16474 #. type: =head2
16475 #: ../fish/guestfish-commands.pod:65
16476 msgid "echo"
16477 msgstr "echo"
16478
16479 #. type: verbatim
16480 #: ../fish/guestfish-commands.pod:67
16481 #, no-wrap
16482 msgid ""
16483 " echo [params ...]\n"
16484 "\n"
16485 msgstr ""
16486 " echo [параметри...]\n"
16487 "\n"
16488
16489 #. type: textblock
16490 #: ../fish/guestfish-commands.pod:69
16491 msgid "This echos the parameters to the terminal."
16492 msgstr ""
16493
16494 #. type: =head2
16495 #: ../fish/guestfish-commands.pod:71
16496 msgid "edit"
16497 msgstr "edit"
16498
16499 #. type: =head2
16500 #: ../fish/guestfish-commands.pod:73
16501 msgid "vi"
16502 msgstr "vi"
16503
16504 #. type: =head2
16505 #: ../fish/guestfish-commands.pod:75
16506 msgid "emacs"
16507 msgstr "emacs"
16508
16509 #. type: verbatim
16510 #: ../fish/guestfish-commands.pod:77
16511 #, no-wrap
16512 msgid ""
16513 " edit filename\n"
16514 "\n"
16515 msgstr ""
16516 " edit назва_файла\n"
16517 "\n"
16518
16519 #. type: textblock
16520 #: ../fish/guestfish-commands.pod:79
16521 msgid ""
16522 "This is used to edit a file.  It downloads the file, edits it locally using "
16523 "your editor, then uploads the result."
16524 msgstr ""
16525
16526 #. type: textblock
16527 #: ../fish/guestfish-commands.pod:82
16528 msgid ""
16529 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
16530 "or C<emacs> you will get those corresponding editors."
16531 msgstr ""
16532
16533 #. type: =head2
16534 #: ../fish/guestfish-commands.pod:86
16535 msgid "glob"
16536 msgstr "glob"
16537
16538 #. type: verbatim
16539 #: ../fish/guestfish-commands.pod:88
16540 #, no-wrap
16541 msgid ""
16542 " glob command args...\n"
16543 "\n"
16544 msgstr ""
16545 " glob команда параметри...\n"
16546 "\n"
16547
16548 #. type: textblock
16549 #: ../fish/guestfish-commands.pod:90
16550 msgid ""
16551 "Expand wildcards in any paths in the args list, and run C<command> "
16552 "repeatedly on each matching path."
16553 msgstr ""
16554
16555 #. type: textblock
16556 #: ../fish/guestfish-commands.pod:93
16557 msgid "See L</WILDCARDS AND GLOBBING>."
16558 msgstr "Див. L</WILDCARDS AND GLOBBING>."
16559
16560 #. type: =head2
16561 #: ../fish/guestfish-commands.pod:95
16562 msgid "hexedit"
16563 msgstr "hexedit"
16564
16565 #. type: verbatim
16566 #: ../fish/guestfish-commands.pod:97
16567 #, no-wrap
16568 msgid ""
16569 " hexedit <filename|device>\n"
16570 " hexedit <filename|device> <max>\n"
16571 " hexedit <filename|device> <start> <max>\n"
16572 "\n"
16573 msgstr ""
16574
16575 #. type: textblock
16576 #: ../fish/guestfish-commands.pod:101
16577 msgid ""
16578 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
16579 "device."
16580 msgstr ""
16581
16582 #. type: textblock
16583 #: ../fish/guestfish-commands.pod:104
16584 msgid ""
16585 "This command works by downloading potentially the whole file or device, "
16586 "editing it locally, then uploading it.  If the file or device is large, you "
16587 "have to specify which part you wish to edit by using C<max> and/or C<start> "
16588 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
16589 "usual modifiers allowed such as C<1M> (1 megabyte)."
16590 msgstr ""
16591
16592 #. type: textblock
16593 #: ../fish/guestfish-commands.pod:111
16594 msgid "For example to edit the first few sectors of a disk you might do:"
16595 msgstr ""
16596
16597 #. type: verbatim
16598 #: ../fish/guestfish-commands.pod:114
16599 #, no-wrap
16600 msgid ""
16601 " hexedit /dev/sda 1M\n"
16602 "\n"
16603 msgstr ""
16604 " hexedit /dev/sda 1M\n"
16605 "\n"
16606
16607 #. type: textblock
16608 #: ../fish/guestfish-commands.pod:116
16609 msgid ""
16610 "which would allow you to edit anywhere within the first megabyte of the disk."
16611 msgstr ""
16612
16613 #. type: textblock
16614 #: ../fish/guestfish-commands.pod:119
16615 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
16616 msgstr ""
16617
16618 #. type: verbatim
16619 #: ../fish/guestfish-commands.pod:121
16620 #, no-wrap
16621 msgid ""
16622 " hexedit /dev/sda1 0x400 0x400\n"
16623 "\n"
16624 msgstr ""
16625 " hexedit /dev/sda1 0x400 0x400\n"
16626 "\n"
16627
16628 #. type: textblock
16629 #: ../fish/guestfish-commands.pod:123
16630 msgid "(assuming the superblock is in the standard location)."
16631 msgstr ""
16632
16633 #. type: textblock
16634 #: ../fish/guestfish-commands.pod:125
16635 msgid ""
16636 "This command requires the external L<hexedit(1)> program.  You can specify "
16637 "another program to use by setting the C<HEXEDITOR> environment variable."
16638 msgstr ""
16639
16640 #. type: textblock
16641 #: ../fish/guestfish-commands.pod:129
16642 msgid "See also L</hexdump>."
16643 msgstr "Див. також L</hexdump>."
16644
16645 #. type: =head2
16646 #: ../fish/guestfish-commands.pod:131
16647 msgid "lcd"
16648 msgstr "lcd"
16649
16650 #. type: verbatim
16651 #: ../fish/guestfish-commands.pod:133
16652 #, no-wrap
16653 msgid ""
16654 " lcd directory\n"
16655 "\n"
16656 msgstr ""
16657
16658 #. type: textblock
16659 #: ../fish/guestfish-commands.pod:135
16660 msgid ""
16661 "Change the local directory, ie. the current directory of guestfish itself."
16662 msgstr ""
16663
16664 #. type: textblock
16665 #: ../fish/guestfish-commands.pod:138
16666 msgid "Note that C<!cd> won't do what you might expect."
16667 msgstr ""
16668
16669 #. type: =head2
16670 #: ../fish/guestfish-commands.pod:140
16671 msgid "man"
16672 msgstr "man"
16673
16674 #. type: =head2
16675 #: ../fish/guestfish-commands.pod:142
16676 msgid "manual"
16677 msgstr ""
16678
16679 #. type: verbatim
16680 #: ../fish/guestfish-commands.pod:144
16681 #, no-wrap
16682 msgid ""
16683 "  man\n"
16684 "\n"
16685 msgstr ""
16686 "  man\n"
16687 "\n"
16688
16689 #. type: textblock
16690 #: ../fish/guestfish-commands.pod:146
16691 msgid "Opens the manual page for guestfish."
16692 msgstr ""
16693
16694 #. type: =head2
16695 #: ../fish/guestfish-commands.pod:148
16696 msgid "more"
16697 msgstr "more"
16698
16699 #. type: =head2
16700 #: ../fish/guestfish-commands.pod:150
16701 msgid "less"
16702 msgstr "less"
16703
16704 #. type: verbatim
16705 #: ../fish/guestfish-commands.pod:152
16706 #, no-wrap
16707 msgid ""
16708 " more filename\n"
16709 "\n"
16710 msgstr ""
16711
16712 #. type: verbatim
16713 #: ../fish/guestfish-commands.pod:154
16714 #, no-wrap
16715 msgid ""
16716 " less filename\n"
16717 "\n"
16718 msgstr ""
16719
16720 #. type: textblock
16721 #: ../fish/guestfish-commands.pod:156
16722 msgid "This is used to view a file."
16723 msgstr ""
16724
16725 #. type: textblock
16726 #: ../fish/guestfish-commands.pod:158
16727 msgid ""
16728 "The default viewer is C<$PAGER>.  However if you use the alternate command "
16729 "C<less> you will get the C<less> command specifically."
16730 msgstr ""
16731
16732 #. type: =head2
16733 #: ../fish/guestfish-commands.pod:161
16734 msgid "reopen"
16735 msgstr "reopen"
16736
16737 #. type: verbatim
16738 #: ../fish/guestfish-commands.pod:163
16739 #, no-wrap
16740 msgid ""
16741 "  reopen\n"
16742 "\n"
16743 msgstr ""
16744
16745 #. type: textblock
16746 #: ../fish/guestfish-commands.pod:165
16747 msgid ""
16748 "Close and reopen the libguestfs handle.  It is not necessary to use this "
16749 "normally, because the handle is closed properly when guestfish exits.  "
16750 "However this is occasionally useful for testing."
16751 msgstr ""
16752
16753 #. type: =head2
16754 #: ../fish/guestfish-commands.pod:169
16755 msgid "sparse"
16756 msgstr "sparse"
16757
16758 #. type: verbatim
16759 #: ../fish/guestfish-commands.pod:171
16760 #, no-wrap
16761 msgid ""
16762 " sparse filename size\n"
16763 "\n"
16764 msgstr ""
16765
16766 #. type: textblock
16767 #: ../fish/guestfish-commands.pod:173
16768 msgid ""
16769 "This creates an empty sparse file of the given size, and then adds so it can "
16770 "be further examined."
16771 msgstr ""
16772
16773 #. type: textblock
16774 #: ../fish/guestfish-commands.pod:176
16775 msgid ""
16776 "In all respects it works the same as the L</alloc> command, except that the "
16777 "image file is allocated sparsely, which means that disk blocks are not "
16778 "assigned to the file until they are needed.  Sparse disk files only use "
16779 "space when written to, but they are slower and there is a danger you could "
16780 "run out of real disk space during a write operation."
16781 msgstr ""
16782
16783 #. type: =head2
16784 #: ../fish/guestfish-commands.pod:186
16785 msgid "supported"
16786 msgstr "supported"
16787
16788 #. type: verbatim
16789 #: ../fish/guestfish-commands.pod:188
16790 #, no-wrap
16791 msgid ""
16792 " supported\n"
16793 "\n"
16794 msgstr ""
16795 " supported\n"
16796 "\n"
16797
16798 #. type: textblock
16799 #: ../fish/guestfish-commands.pod:190
16800 msgid ""
16801 "This command returns a list of the optional groups known to the daemon, and "
16802 "indicates which ones are supported by this build of the libguestfs appliance."
16803 msgstr ""
16804
16805 #. type: textblock
16806 #: ../fish/guestfish-commands.pod:194
16807 msgid "See also L<guestfs(3)/AVAILABILITY>."
16808 msgstr ""
16809
16810 #. type: =head2
16811 #: ../fish/guestfish-commands.pod:196
16812 msgid "time"
16813 msgstr "time"
16814
16815 #. type: verbatim
16816 #: ../fish/guestfish-commands.pod:198
16817 #, no-wrap
16818 msgid ""
16819 " time command args...\n"
16820 "\n"
16821 msgstr ""
16822
16823 #. type: textblock
16824 #: ../fish/guestfish-commands.pod:200
16825 msgid ""
16826 "Run the command as usual, but print the elapsed time afterwards.  This can "
16827 "be useful for benchmarking operations."
16828 msgstr ""
16829
16830 #. type: textblock
16831 #: ../fish/guestfish.pod:5
16832 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
16833 msgstr ""
16834
16835 #. type: verbatim
16836 #: ../fish/guestfish.pod:9
16837 #, no-wrap
16838 msgid ""
16839 " guestfish [--options] [commands]\n"
16840 "\n"
16841 msgstr ""
16842
16843 #. type: verbatim
16844 #: ../fish/guestfish.pod:11
16845 #, no-wrap
16846 msgid ""
16847 " guestfish\n"
16848 "\n"
16849 msgstr ""
16850
16851 #. type: verbatim
16852 #: ../fish/guestfish.pod:13
16853 #, no-wrap
16854 msgid ""
16855 " guestfish [--ro|--rw] -a disk.img\n"
16856 "\n"
16857 msgstr ""
16858
16859 #. type: verbatim
16860 #: ../fish/guestfish.pod:15
16861 #, no-wrap
16862 msgid ""
16863 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
16864 "\n"
16865 msgstr ""
16866
16867 #. type: verbatim
16868 #: ../fish/guestfish.pod:17
16869 #, no-wrap
16870 msgid ""
16871 " guestfish -d libvirt-domain\n"
16872 "\n"
16873 msgstr ""
16874
16875 #. type: verbatim
16876 #: ../fish/guestfish.pod:19
16877 #, no-wrap
16878 msgid ""
16879 " guestfish [--ro|--rw] -a disk.img -i\n"
16880 "\n"
16881 msgstr ""
16882
16883 #. type: verbatim
16884 #: ../fish/guestfish.pod:21
16885 #, no-wrap
16886 msgid ""
16887 " guestfish -d libvirt-domain -i\n"
16888 "\n"
16889 msgstr ""
16890
16891 #. type: textblock
16892 #: ../fish/guestfish.pod:25
16893 msgid ""
16894 "Using guestfish in read/write mode on live virtual machines can be "
16895 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
16896 "option to use guestfish safely if the disk image or virtual machine might be "
16897 "live."
16898 msgstr ""
16899
16900 #. type: textblock
16901 #: ../fish/guestfish.pod:32
16902 msgid ""
16903 "Guestfish is a shell and command-line tool for examining and modifying "
16904 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
16905 "functionality of the guestfs API, see L<guestfs(3)>."
16906 msgstr ""
16907
16908 #. type: textblock
16909 #: ../fish/guestfish.pod:36
16910 msgid ""
16911 "Guestfish gives you structured access to the libguestfs API, from shell "
16912 "scripts or the command line or interactively.  If you want to rescue a "
16913 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
16914 "command."
16915 msgstr ""
16916
16917 #. type: =head2
16918 #: ../fish/guestfish.pod:43
16919 msgid "As an interactive shell"
16920 msgstr ""
16921
16922 #. type: verbatim
16923 #: ../fish/guestfish.pod:45
16924 #, no-wrap
16925 msgid ""
16926 " $ guestfish\n"
16927 " \n"
16928 msgstr ""
16929
16930 #. type: verbatim
16931 #: ../fish/guestfish.pod:47
16932 #, no-wrap
16933 msgid ""
16934 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
16935 " editing virtual machine filesystems.\n"
16936 " \n"
16937 msgstr ""
16938
16939 #. type: verbatim
16940 #: ../fish/guestfish.pod:50
16941 #, no-wrap
16942 msgid ""
16943 " Type: 'help' for a list of commands\n"
16944 "       'man' to read the manual\n"
16945 "       'quit' to quit the shell\n"
16946 " \n"
16947 msgstr ""
16948
16949 #. type: verbatim
16950 #: ../fish/guestfish.pod:54
16951 #, no-wrap
16952 msgid ""
16953 " ><fs> add-ro disk.img\n"
16954 " ><fs> run\n"
16955 " ><fs> list-filesystems\n"
16956 " /dev/sda1: ext4\n"
16957 " /dev/vg_guest/lv_root: ext4\n"
16958 " /dev/vg_guest/lv_swap: swap\n"
16959 " ><fs> mount /dev/vg_guest/lv_root /\n"
16960 " ><fs> cat /etc/fstab\n"
16961 " # /etc/fstab\n"
16962 " # Created by anaconda\n"
16963 " [...]\n"
16964 " ><fs> exit\n"
16965 "\n"
16966 msgstr ""
16967
16968 #. type: =head2
16969 #: ../fish/guestfish.pod:67
16970 msgid "From shell scripts"
16971 msgstr ""
16972
16973 #. type: textblock
16974 #: ../fish/guestfish.pod:69
16975 msgid "Create a new C</etc/motd> file in a guest or disk image:"
16976 msgstr ""
16977
16978 #. type: verbatim
16979 #: ../fish/guestfish.pod:71
16980 #, no-wrap
16981 msgid ""
16982 " guestfish <<_EOF_\n"
16983 " add disk.img\n"
16984 " run\n"
16985 " mount /dev/vg_guest/lv_root /\n"
16986 " write /etc/motd \"Welcome, new users\"\n"
16987 " _EOF_\n"
16988 "\n"
16989 msgstr ""
16990
16991 #. type: textblock
16992 #: ../fish/guestfish.pod:78
16993 msgid "List the LVM logical volumes in a disk image:"
16994 msgstr ""
16995
16996 #. type: verbatim
16997 #: ../fish/guestfish.pod:80
16998 #, no-wrap
16999 msgid ""
17000 " guestfish -a disk.img --ro <<_EOF_\n"
17001 " run\n"
17002 " lvs\n"
17003 " _EOF_\n"
17004 "\n"
17005 msgstr ""
17006
17007 #. type: textblock
17008 #: ../fish/guestfish.pod:85
17009 msgid "List all the filesystems in a disk image:"
17010 msgstr ""
17011
17012 #. type: verbatim
17013 #: ../fish/guestfish.pod:87
17014 #, no-wrap
17015 msgid ""
17016 " guestfish -a disk.img --ro <<_EOF_\n"
17017 " run\n"
17018 " list-filesystems\n"
17019 " _EOF_\n"
17020 "\n"
17021 msgstr ""
17022
17023 #. type: =head2
17024 #: ../fish/guestfish.pod:92
17025 msgid "On one command line"
17026 msgstr ""
17027
17028 #. type: textblock
17029 #: ../fish/guestfish.pod:94 ../fish/virt-copy-in.pod:31
17030 msgid "Update C</etc/resolv.conf> in a guest:"
17031 msgstr ""
17032
17033 #. type: verbatim
17034 #: ../fish/guestfish.pod:96
17035 #, no-wrap
17036 msgid ""
17037 " guestfish \\\n"
17038 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
17039 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
17040 "\n"
17041 msgstr ""
17042
17043 #. type: textblock
17044 #: ../fish/guestfish.pod:100
17045 msgid "Edit C</boot/grub/grub.conf> interactively:"
17046 msgstr ""
17047
17048 #. type: verbatim
17049 #: ../fish/guestfish.pod:102
17050 #, no-wrap
17051 msgid ""
17052 " guestfish --rw --add disk.img \\\n"
17053 "   --mount /dev/vg_guest/lv_root \\\n"
17054 "   --mount /dev/sda1:/boot \\\n"
17055 "   edit /boot/grub/grub.conf\n"
17056 "\n"
17057 msgstr ""
17058
17059 #. type: =head2
17060 #: ../fish/guestfish.pod:107
17061 msgid "Mount disks automatically"
17062 msgstr ""
17063
17064 #. type: textblock
17065 #: ../fish/guestfish.pod:109
17066 msgid ""
17067 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
17068 msgstr ""
17069
17070 #. type: verbatim
17071 #: ../fish/guestfish.pod:112
17072 #, no-wrap
17073 msgid ""
17074 " guestfish --ro -a disk.img -i cat /etc/group\n"
17075 "\n"
17076 msgstr ""
17077
17078 #. type: verbatim
17079 #: ../fish/guestfish.pod:114
17080 #, no-wrap
17081 msgid ""
17082 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
17083 "\n"
17084 msgstr ""
17085
17086 #. type: textblock
17087 #: ../fish/guestfish.pod:116
17088 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
17089 msgstr ""
17090
17091 #. type: verbatim
17092 #: ../fish/guestfish.pod:118
17093 #, no-wrap
17094 msgid ""
17095 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
17096 "\n"
17097 msgstr ""
17098
17099 #. type: =head2
17100 #: ../fish/guestfish.pod:120
17101 msgid "As a script interpreter"
17102 msgstr ""
17103
17104 #. type: textblock
17105 #: ../fish/guestfish.pod:122
17106 msgid "Create a 100MB disk containing an ext2-formatted partition:"
17107 msgstr ""
17108
17109 #. type: verbatim
17110 #: ../fish/guestfish.pod:124
17111 #, no-wrap
17112 msgid ""
17113 " #!/usr/bin/guestfish -f\n"
17114 " sparse test1.img 100M\n"
17115 " run\n"
17116 " part-disk /dev/sda mbr\n"
17117 " mkfs ext2 /dev/sda1\n"
17118 "\n"
17119 msgstr ""
17120
17121 #. type: =head2
17122 #: ../fish/guestfish.pod:130
17123 msgid "Start with a prepared disk"
17124 msgstr ""
17125
17126 #. type: textblock
17127 #: ../fish/guestfish.pod:132
17128 msgid ""
17129 "An alternate way to create a 100MB disk called C<test1.img> containing a "
17130 "single ext2-formatted partition:"
17131 msgstr ""
17132
17133 #. type: verbatim
17134 #: ../fish/guestfish.pod:135
17135 #, no-wrap
17136 msgid ""
17137 " guestfish -N fs\n"
17138 "\n"
17139 msgstr ""
17140
17141 #. type: textblock
17142 #: ../fish/guestfish.pod:137
17143 msgid "To list what is available do:"
17144 msgstr ""
17145
17146 #. type: verbatim
17147 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:1009
17148 #, no-wrap
17149 msgid ""
17150 " guestfish -N help | less\n"
17151 "\n"
17152 msgstr ""
17153
17154 #. type: =head2
17155 #: ../fish/guestfish.pod:141
17156 msgid "Remote control"
17157 msgstr "Дистанційне керування"
17158
17159 #. type: verbatim
17160 #: ../fish/guestfish.pod:143
17161 #, no-wrap
17162 msgid ""
17163 " eval \"`guestfish --listen`\"\n"
17164 " guestfish --remote add-ro disk.img\n"
17165 " guestfish --remote run\n"
17166 " guestfish --remote lvs\n"
17167 "\n"
17168 msgstr ""
17169 " eval \"`guestfish --listen`\"\n"
17170 " guestfish --remote add-ro disk.img\n"
17171 " guestfish --remote run\n"
17172 " guestfish --remote lvs\n"
17173 "\n"
17174
17175 #. type: textblock
17176 #: ../fish/guestfish.pod:154
17177 msgid "Displays general help on options."
17178 msgstr ""
17179
17180 #. type: =item
17181 #: ../fish/guestfish.pod:158
17182 msgid "B<--cmd-help>"
17183 msgstr "B<--cmd-help>"
17184
17185 #. type: textblock
17186 #: ../fish/guestfish.pod:160
17187 msgid "Lists all available guestfish commands."
17188 msgstr ""
17189
17190 #. type: =item
17191 #: ../fish/guestfish.pod:162
17192 msgid "B<-h cmd>"
17193 msgstr "B<-h команда>"
17194
17195 #. type: =item
17196 #: ../fish/guestfish.pod:164
17197 msgid "B<--cmd-help cmd>"
17198 msgstr "B<--cmd-help команда>"
17199
17200 #. type: textblock
17201 #: ../fish/guestfish.pod:166
17202 msgid "Displays detailed help on a single command C<cmd>."
17203 msgstr ""
17204
17205 #. type: =item
17206 #: ../fish/guestfish.pod:168 ../fuse/guestmount.pod:87
17207 msgid "B<-a image>"
17208 msgstr "B<-a образ>"
17209
17210 #. type: =item
17211 #: ../fish/guestfish.pod:170 ../fuse/guestmount.pod:89
17212 msgid "B<--add image>"
17213 msgstr "B<--add образ>"
17214
17215 #. type: textblock
17216 #: ../fish/guestfish.pod:172
17217 msgid "Add a block device or virtual machine image to the shell."
17218 msgstr ""
17219
17220 #. type: textblock
17221 #: ../fish/guestfish.pod:177
17222 msgid ""
17223 "Using this flag is mostly equivalent to using the C<add> command, with "
17224 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
17225 "the I<--format=...> flag was given."
17226 msgstr ""
17227
17228 #. type: textblock
17229 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:100
17230 msgid ""
17231 "When used in conjunction with the I<-d> option, this specifies the libvirt "
17232 "URI to use.  The default is to use the default libvirt connection."
17233 msgstr ""
17234
17235 #. type: =item
17236 #: ../fish/guestfish.pod:189
17237 msgid "B<--csh>"
17238 msgstr "B<--csh>"
17239
17240 #. type: textblock
17241 #: ../fish/guestfish.pod:191
17242 msgid ""
17243 "If using the I<--listen> option and a csh-like shell, use this option.  See "
17244 "section L</REMOTE CONTROL AND CSH> below."
17245 msgstr ""
17246
17247 #. type: =item
17248 #: ../fish/guestfish.pod:194 ../fuse/guestmount.pod:104
17249 msgid "B<-d libvirt-domain>"
17250 msgstr "B<-d домен-libvirt>"
17251
17252 #. type: =item
17253 #: ../fish/guestfish.pod:196 ../fuse/guestmount.pod:106
17254 msgid "B<--domain libvirt-domain>"
17255 msgstr "B<--domain домен-libvirt>"
17256
17257 #. type: textblock
17258 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:108
17259 msgid ""
17260 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
17261 "used, then any libvirt domain can be used.  However in write mode, only "
17262 "libvirt domains which are shut down can be named here."
17263 msgstr ""
17264
17265 #. type: textblock
17266 #: ../fish/guestfish.pod:202 ../fuse/guestmount.pod:112
17267 msgid "Domain UUIDs can be used instead of names."
17268 msgstr ""
17269
17270 #. type: textblock
17271 #: ../fish/guestfish.pod:204
17272 msgid ""
17273 "Using this flag is mostly equivalent to using the C<add-domain> command, "
17274 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
17275 "if the I<--format:...> flag was given."
17276 msgstr ""
17277
17278 #. type: =item
17279 #: ../fish/guestfish.pod:208
17280 msgid "B<-D>"
17281 msgstr "B<-D>"
17282
17283 #. type: =item
17284 #: ../fish/guestfish.pod:210
17285 msgid "B<--no-dest-paths>"
17286 msgstr "B<--no-dest-paths>"
17287
17288 #. type: textblock
17289 #: ../fish/guestfish.pod:212
17290 msgid ""
17291 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
17292 "to hit the tab key to complete paths on the guest filesystem, but this "
17293 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
17294 "allow this feature to be disabled."
17295 msgstr ""
17296
17297 #. type: textblock
17298 #: ../fish/guestfish.pod:219 ../fuse/guestmount.pod:128
17299 msgid ""
17300 "When prompting for keys and passphrases, guestfish normally turns echoing "
17301 "off so you cannot see what you are typing.  If you are not worried about "
17302 "Tempest attacks and there is no one else in the room you can specify this "
17303 "flag to see what you are typing."
17304 msgstr ""
17305
17306 #. type: =item
17307 #: ../fish/guestfish.pod:224
17308 msgid "B<-f file>"
17309 msgstr "B<-f файл>"
17310
17311 #. type: =item
17312 #: ../fish/guestfish.pod:226
17313 msgid "B<--file file>"
17314 msgstr "B<--file файл>"
17315
17316 #. type: textblock
17317 #: ../fish/guestfish.pod:228
17318 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
17319 msgstr ""
17320
17321 #. type: verbatim
17322 #: ../fish/guestfish.pod:231
17323 #, no-wrap
17324 msgid ""
17325 " #!/usr/bin/guestfish -f\n"
17326 "\n"
17327 msgstr ""
17328 " #!/usr/bin/guestfish -f\n"
17329 "\n"
17330
17331 #. type: verbatim
17332 #: ../fish/guestfish.pod:244
17333 #, no-wrap
17334 msgid ""
17335 " guestfish --format=raw -a disk.img\n"
17336 "\n"
17337 msgstr ""
17338 " guestfish --format=raw -a disk.img\n"
17339 "\n"
17340
17341 #. type: verbatim
17342 #: ../fish/guestfish.pod:248
17343 #, no-wrap
17344 msgid ""
17345 " guestfish --format=raw -a disk.img --format -a another.img\n"
17346 "\n"
17347 msgstr ""
17348 " guestfish --format=raw -a disk.img --format -a another.img\n"
17349 "\n"
17350
17351 #. type: textblock
17352 #: ../fish/guestfish.pod:253
17353 msgid ""
17354 "If you have untrusted raw-format guest disk images, you should use this "
17355 "option to specify the disk format.  This avoids a possible security problem "
17356 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
17357 msgstr ""
17358
17359 #. type: =item
17360 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:157
17361 msgid "B<--inspector>"
17362 msgstr "B<--inspector>"
17363
17364 #. type: textblock
17365 #: ../fish/guestfish.pod:262 ../fuse/guestmount.pod:159
17366 msgid ""
17367 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
17368 "system and mount filesystems as they would be mounted on the real virtual "
17369 "machine."
17370 msgstr ""
17371
17372 #. type: textblock
17373 #: ../fish/guestfish.pod:266
17374 msgid "Typical usage is either:"
17375 msgstr ""
17376
17377 #. type: verbatim
17378 #: ../fish/guestfish.pod:268
17379 #, no-wrap
17380 msgid ""
17381 " guestfish -d myguest -i\n"
17382 "\n"
17383 msgstr ""
17384 " guestfish -d myguest -i\n"
17385 "\n"
17386
17387 #. type: textblock
17388 #: ../fish/guestfish.pod:270
17389 msgid "(for an inactive libvirt domain called I<myguest>), or:"
17390 msgstr ""
17391
17392 #. type: verbatim
17393 #: ../fish/guestfish.pod:272
17394 #, no-wrap
17395 msgid ""
17396 " guestfish --ro -d myguest -i\n"
17397 "\n"
17398 msgstr ""
17399 " guestfish --ro -d myguest -i\n"
17400 "\n"
17401
17402 #. type: textblock
17403 #: ../fish/guestfish.pod:274
17404 msgid "(for active domains, readonly), or specify the block device directly:"
17405 msgstr ""
17406
17407 #. type: verbatim
17408 #: ../fish/guestfish.pod:276
17409 #, no-wrap
17410 msgid ""
17411 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
17412 "\n"
17413 msgstr ""
17414 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
17415 "\n"
17416
17417 #. type: textblock
17418 #: ../fish/guestfish.pod:278
17419 msgid ""
17420 "Note that the command line syntax changed slightly over older versions of "
17421 "guestfish.  You can still use the old syntax:"
17422 msgstr ""
17423
17424 #. type: verbatim
17425 #: ../fish/guestfish.pod:281
17426 #, no-wrap
17427 msgid ""
17428 " guestfish [--ro] -i disk.img\n"
17429 "\n"
17430 msgstr ""
17431 " guestfish [--ro] -i disk.img\n"
17432 "\n"
17433
17434 #. type: verbatim
17435 #: ../fish/guestfish.pod:283
17436 #, no-wrap
17437 msgid ""
17438 " guestfish [--ro] -i libvirt-domain\n"
17439 "\n"
17440 msgstr ""
17441
17442 #. type: textblock
17443 #: ../fish/guestfish.pod:285
17444 msgid ""
17445 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
17446 "then using other commands to mount the filesystems that were found."
17447 msgstr ""
17448
17449 #. type: =item
17450 #: ../fish/guestfish.pod:294
17451 msgid "B<--listen>"
17452 msgstr "B<--listen>"
17453
17454 #. type: textblock
17455 #: ../fish/guestfish.pod:296
17456 msgid ""
17457 "Fork into the background and listen for remote commands.  See section L</"
17458 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
17459 msgstr ""
17460
17461 #. type: =item
17462 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:168
17463 msgid "B<--live>"
17464 msgstr "B<--live>"
17465
17466 #. type: textblock
17467 #: ../fish/guestfish.pod:301 ../fuse/guestmount.pod:170
17468 msgid ""
17469 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
17470 "ATTACHING TO RUNNING DAEMONS>)."
17471 msgstr ""
17472
17473 #. type: =item
17474 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:173
17475 msgid "B<-m dev[:mountpoint[:options]]>"
17476 msgstr ""
17477
17478 #. type: =item
17479 #: ../fish/guestfish.pod:306 ../fuse/guestmount.pod:175
17480 msgid "B<--mount dev[:mountpoint[:options]]>"
17481 msgstr ""
17482
17483 #. type: textblock
17484 #: ../fish/guestfish.pod:308
17485 msgid "Mount the named partition or logical volume on the given mountpoint."
17486 msgstr ""
17487
17488 #. type: textblock
17489 #: ../fish/guestfish.pod:310
17490 msgid "If the mountpoint is omitted, it defaults to C</>."
17491 msgstr ""
17492
17493 #. type: textblock
17494 #: ../fish/guestfish.pod:312
17495 msgid "You have to mount something on C</> before most commands will work."
17496 msgstr ""
17497
17498 #. type: textblock
17499 #: ../fish/guestfish.pod:314
17500 msgid ""
17501 "If any I<-m> or I<--mount> options are given, the guest is automatically "
17502 "launched."
17503 msgstr ""
17504
17505 #. type: textblock
17506 #: ../fish/guestfish.pod:317
17507 msgid ""
17508 "If you don't know what filesystems a disk image contains, you can either run "
17509 "guestfish without this option, then list the partitions, filesystems and LVs "
17510 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
17511 "commands), or you can use the L<virt-filesystems(1)> program."
17512 msgstr ""
17513
17514 #. type: textblock
17515 #: ../fish/guestfish.pod:323 ../fuse/guestmount.pod:183
17516 msgid ""
17517 "The third (and rarely used) part of the mount parameter is the list of mount "
17518 "options used to mount the underlying filesystem.  If this is not given, then "
17519 "the mount options are either the empty string or C<ro> (the latter if the "
17520 "I<--ro> flag is used).  By specifying the mount options, you override this "
17521 "default choice.  Probably the only time you would use this is to enable ACLs "
17522 "and/or extended attributes if the filesystem can support them:"
17523 msgstr ""
17524
17525 #. type: verbatim
17526 #: ../fish/guestfish.pod:331 ../fuse/guestmount.pod:191
17527 #, no-wrap
17528 msgid ""
17529 " -m /dev/sda1:/:acl,user_xattr\n"
17530 "\n"
17531 msgstr ""
17532
17533 #. type: textblock
17534 #: ../fish/guestfish.pod:333
17535 msgid "Using this flag is equivalent to using the C<mount-options> command."
17536 msgstr ""
17537
17538 #. type: =item
17539 #: ../fish/guestfish.pod:335 ../fuse/guestmount.pod:193
17540 #: ../resize/virt-resize.pod:358
17541 msgid "B<-n>"
17542 msgstr "B<-n>"
17543
17544 #. type: =item
17545 #: ../fish/guestfish.pod:337 ../fuse/guestmount.pod:195
17546 msgid "B<--no-sync>"
17547 msgstr "B<--no-sync>"
17548
17549 #. type: textblock
17550 #: ../fish/guestfish.pod:339
17551 msgid ""
17552 "Disable autosync.  This is enabled by default.  See the discussion of "
17553 "autosync in the L<guestfs(3)> manpage."
17554 msgstr ""
17555
17556 #. type: =item
17557 #: ../fish/guestfish.pod:342
17558 msgid "B<-N type>"
17559 msgstr "B<-N тип>"
17560
17561 #. type: =item
17562 #: ../fish/guestfish.pod:344
17563 msgid "B<--new type>"
17564 msgstr "B<--new тип>"
17565
17566 #. type: =item
17567 #: ../fish/guestfish.pod:346
17568 msgid "B<-N help>"
17569 msgstr "B<-N help>"
17570
17571 #. type: textblock
17572 #: ../fish/guestfish.pod:348
17573 msgid ""
17574 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
17575 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
17576 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
17577 "IMAGES> below."
17578 msgstr ""
17579
17580 #. type: =item
17581 #: ../fish/guestfish.pod:353
17582 msgid "B<--progress-bars>"
17583 msgstr "B<--progress-bars>"
17584
17585 #. type: textblock
17586 #: ../fish/guestfish.pod:355
17587 msgid "Enable progress bars, even when guestfish is used non-interactively."
17588 msgstr ""
17589
17590 #. type: textblock
17591 #: ../fish/guestfish.pod:357
17592 msgid ""
17593 "Progress bars are enabled by default when guestfish is used as an "
17594 "interactive shell."
17595 msgstr ""
17596
17597 #. type: =item
17598 #: ../fish/guestfish.pod:360
17599 msgid "B<--no-progress-bars>"
17600 msgstr "B<--no-progress-bars>"
17601
17602 #. type: textblock
17603 #: ../fish/guestfish.pod:362
17604 msgid "Disable progress bars."
17605 msgstr ""
17606
17607 #. type: =item
17608 #: ../fish/guestfish.pod:364
17609 msgid "B<--remote[=pid]>"
17610 msgstr "B<--remote[=pid]>"
17611
17612 #. type: textblock
17613 #: ../fish/guestfish.pod:366
17614 msgid ""
17615 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
17616 "CONTROL GUESTFISH OVER A SOCKET> below."
17617 msgstr ""
17618
17619 #. type: =item
17620 #: ../fish/guestfish.pod:369 ../fuse/guestmount.pod:239
17621 #: ../rescue/virt-rescue.pod:161
17622 msgid "B<-r>"
17623 msgstr "B<-r>"
17624
17625 #. type: =item
17626 #: ../fish/guestfish.pod:371 ../fuse/guestmount.pod:241
17627 #: ../rescue/virt-rescue.pod:163
17628 msgid "B<--ro>"
17629 msgstr "B<--ro>"
17630
17631 #. type: textblock
17632 #: ../fish/guestfish.pod:373
17633 msgid ""
17634 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
17635 "mounts are done read-only."
17636 msgstr ""
17637
17638 #. type: textblock
17639 #: ../fish/guestfish.pod:376 ../rescue/virt-rescue.pod:167
17640 msgid ""
17641 "The option must always be used if the disk image or virtual machine might be "
17642 "running, and is generally recommended in cases where you don't need write "
17643 "access to the disk."
17644 msgstr ""
17645
17646 #. type: textblock
17647 #: ../fish/guestfish.pod:380
17648 msgid ""
17649 "Note that prepared disk images created with I<-N> are not affected by this "
17650 "option.  Also commands like C<add> are not affected - you have to specify "
17651 "the C<readonly:true> option explicitly if you need it."
17652 msgstr ""
17653
17654 #. type: textblock
17655 #: ../fish/guestfish.pod:384
17656 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
17657 msgstr ""
17658
17659 #. type: =item
17660 #: ../fish/guestfish.pod:386 ../fuse/guestmount.pod:253
17661 #: ../rescue/virt-rescue.pod:173
17662 msgid "B<--selinux>"
17663 msgstr "B<--selinux>"
17664
17665 #. type: textblock
17666 #: ../fish/guestfish.pod:388
17667 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
17668 msgstr ""
17669
17670 #. type: textblock
17671 #: ../fish/guestfish.pod:394
17672 msgid ""
17673 "Enable very verbose messages.  This is particularly useful if you find a bug."
17674 msgstr ""
17675
17676 #. type: textblock
17677 #: ../fish/guestfish.pod:401
17678 msgid "Display the guestfish / libguestfs version number and exit."
17679 msgstr ""
17680
17681 #. type: =item
17682 #: ../fish/guestfish.pod:403 ../fuse/guestmount.pod:269
17683 #: ../rescue/virt-rescue.pod:190
17684 msgid "B<-w>"
17685 msgstr "B<-w>"
17686
17687 #. type: =item
17688 #: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:271
17689 #: ../rescue/virt-rescue.pod:192
17690 msgid "B<--rw>"
17691 msgstr "B<--rw>"
17692
17693 #. type: textblock
17694 #: ../fish/guestfish.pod:407 ../fuse/guestmount.pod:273
17695 msgid ""
17696 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
17697 "mounts are done read-write."
17698 msgstr ""
17699
17700 #. type: textblock
17701 #: ../fish/guestfish.pod:410
17702 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
17703 msgstr ""
17704
17705 #. type: textblock
17706 #: ../fish/guestfish.pod:414
17707 msgid "Echo each command before executing it."
17708 msgstr ""
17709
17710 #. type: =head1
17711 #: ../fish/guestfish.pod:418
17712 msgid "COMMANDS ON COMMAND LINE"
17713 msgstr ""
17714
17715 #. type: textblock
17716 #: ../fish/guestfish.pod:420
17717 msgid ""
17718 "Any additional (non-option) arguments are treated as commands to execute."
17719 msgstr ""
17720
17721 #. type: textblock
17722 #: ../fish/guestfish.pod:423
17723 msgid ""
17724 "Commands to execute should be separated by a colon (C<:>), where the colon "
17725 "is a separate parameter.  Thus:"
17726 msgstr ""
17727
17728 #. type: verbatim
17729 #: ../fish/guestfish.pod:426
17730 #, no-wrap
17731 msgid ""
17732 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
17733 "\n"
17734 msgstr ""
17735
17736 #. type: textblock
17737 #: ../fish/guestfish.pod:428
17738 msgid ""
17739 "If there are no additional arguments, then we enter a shell, either an "
17740 "interactive shell with a prompt (if the input is a terminal) or a non-"
17741 "interactive shell."
17742 msgstr ""
17743
17744 #. type: textblock
17745 #: ../fish/guestfish.pod:432
17746 msgid ""
17747 "In either command line mode or non-interactive shell, the first command that "
17748 "gives an error causes the whole shell to exit.  In interactive mode (with a "
17749 "prompt) if a command fails, you can continue to enter commands."
17750 msgstr ""
17751
17752 #. type: =head1
17753 #: ../fish/guestfish.pod:437
17754 msgid "USING launch (OR run)"
17755 msgstr ""
17756
17757 #. type: textblock
17758 #: ../fish/guestfish.pod:439
17759 msgid ""
17760 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
17761 "then launch it, then mount any disks you need, and finally issue actions/"
17762 "commands.  So the general order of the day is:"
17763 msgstr ""
17764
17765 #. type: textblock
17766 #: ../fish/guestfish.pod:447
17767 msgid "add or -a/--add"
17768 msgstr ""
17769
17770 #. type: textblock
17771 #: ../fish/guestfish.pod:451
17772 msgid "launch (aka run)"
17773 msgstr ""
17774
17775 #. type: textblock
17776 #: ../fish/guestfish.pod:455
17777 msgid "mount or -m/--mount"
17778 msgstr ""
17779
17780 #. type: textblock
17781 #: ../fish/guestfish.pod:459
17782 msgid "any other commands"
17783 msgstr ""
17784
17785 #. type: textblock
17786 #: ../fish/guestfish.pod:463
17787 msgid ""
17788 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
17789 "guest before mounting or performing any other commands."
17790 msgstr ""
17791
17792 #. type: textblock
17793 #: ../fish/guestfish.pod:466
17794 msgid ""
17795 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
17796 "I<--new> options were given then C<run> is done automatically, simply "
17797 "because guestfish can't perform the action you asked for without doing this."
17798 msgstr ""
17799
17800 #. type: =head1
17801 #: ../fish/guestfish.pod:471
17802 msgid "OPENING DISKS FOR READ AND WRITE"
17803 msgstr ""
17804
17805 #. type: textblock
17806 #: ../fish/guestfish.pod:473
17807 msgid ""
17808 "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and "
17809 "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, "
17810 "I<-i> and I<-m> open disk images read-only or for writing."
17811 msgstr ""
17812
17813 #. type: textblock
17814 #: ../fish/guestfish.pod:478
17815 msgid ""
17816 "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to "
17817 "opening disk images supplied on the command line for write.  To open a disk "
17818 "image read-only you have to do I<-a image --ro>."
17819 msgstr ""
17820
17821 #. type: textblock
17822 #: ../fish/guestfish.pod:482
17823 msgid ""
17824 "This matters: If you accidentally open a live VM disk image writable then "
17825 "you will cause irreversible disk corruption."
17826 msgstr ""
17827
17828 #. type: textblock
17829 #: ../fish/guestfish.pod:485
17830 msgid ""
17831 "In a future libguestfs we intend to change the default the other way.  Disk "
17832 "images will be opened read-only.  You will have to either specify "
17833 "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the "
17834 "configuration file C</etc/libguestfs-tools.conf> in order to get write "
17835 "access for disk images specified by those other command line options."
17836 msgstr ""
17837
17838 #. type: textblock
17839 #: ../fish/guestfish.pod:492
17840 msgid ""
17841 "This version of guestfish, guestmount and virt-rescue has a I<--rw> option "
17842 "which does nothing (it is already the default).  However it is highly "
17843 "recommended that you use this option to indicate that you need write access, "
17844 "and prepare your scripts for the day when this option will be required for "
17845 "write access."
17846 msgstr ""
17847
17848 #. type: textblock
17849 #: ../fish/guestfish.pod:498
17850 msgid ""
17851 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
17852 "other libguestfs program apart from guestfish and guestmount."
17853 msgstr ""
17854
17855 #. type: =head1
17856 #: ../fish/guestfish.pod:501
17857 msgid "QUOTING"
17858 msgstr ""
17859
17860 #. type: textblock
17861 #: ../fish/guestfish.pod:503
17862 msgid ""
17863 "You can quote ordinary parameters using either single or double quotes.  For "
17864 "example:"
17865 msgstr ""
17866
17867 #. type: verbatim
17868 #: ../fish/guestfish.pod:506
17869 #, no-wrap
17870 msgid ""
17871 " add \"file with a space.img\"\n"
17872 "\n"
17873 msgstr ""
17874
17875 #. type: verbatim
17876 #: ../fish/guestfish.pod:508
17877 #, no-wrap
17878 msgid ""
17879 " rm '/file name'\n"
17880 "\n"
17881 msgstr ""
17882
17883 #. type: verbatim
17884 #: ../fish/guestfish.pod:510
17885 #, no-wrap
17886 msgid ""
17887 " rm '/\"'\n"
17888 "\n"
17889 msgstr ""
17890
17891 #. type: textblock
17892 #: ../fish/guestfish.pod:512
17893 msgid ""
17894 "A few commands require a list of strings to be passed.  For these, use a "
17895 "whitespace-separated list, enclosed in quotes.  Strings containing "
17896 "whitespace to be passed through must be enclosed in single quotes.  A "
17897 "literal single quote must be escaped with a backslash."
17898 msgstr ""
17899
17900 #. type: verbatim
17901 #: ../fish/guestfish.pod:517
17902 #, no-wrap
17903 msgid ""
17904 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
17905 " command \"/bin/echo 'foo      bar'\"\n"
17906 " command \"/bin/echo \\'foo\\'\"\n"
17907 "\n"
17908 msgstr ""
17909
17910 #. type: =head2
17911 #: ../fish/guestfish.pod:521
17912 msgid "ESCAPE SEQUENCES IN DOUBLE QUOTED ARGUMENTS"
17913 msgstr ""
17914
17915 #. type: textblock
17916 #: ../fish/guestfish.pod:523
17917 msgid ""
17918 "In double-quoted arguments (only) use backslash to insert special characters:"
17919 msgstr ""
17920
17921 #. type: =item
17922 #: ../fish/guestfish.pod:528
17923 msgid "C<\\a>"
17924 msgstr ""
17925
17926 #. type: textblock
17927 #: ../fish/guestfish.pod:530
17928 msgid "Alert (bell) character."
17929 msgstr ""
17930
17931 #. type: =item
17932 #: ../fish/guestfish.pod:532
17933 msgid "C<\\b>"
17934 msgstr ""
17935
17936 #. type: textblock
17937 #: ../fish/guestfish.pod:534
17938 msgid "Backspace character."
17939 msgstr ""
17940
17941 #. type: =item
17942 #: ../fish/guestfish.pod:536
17943 msgid "C<\\f>"
17944 msgstr ""
17945
17946 #. type: textblock
17947 #: ../fish/guestfish.pod:538
17948 msgid "Form feed character."
17949 msgstr ""
17950
17951 #. type: =item
17952 #: ../fish/guestfish.pod:540
17953 msgid "C<\\n>"
17954 msgstr ""
17955
17956 #. type: textblock
17957 #: ../fish/guestfish.pod:542
17958 msgid "Newline character."
17959 msgstr ""
17960
17961 #. type: =item
17962 #: ../fish/guestfish.pod:544
17963 msgid "C<\\r>"
17964 msgstr ""
17965
17966 #. type: textblock
17967 #: ../fish/guestfish.pod:546
17968 msgid "Carriage return character."
17969 msgstr ""
17970
17971 #. type: =item
17972 #: ../fish/guestfish.pod:548
17973 msgid "C<\\t>"
17974 msgstr ""
17975
17976 #. type: textblock
17977 #: ../fish/guestfish.pod:550
17978 msgid "Horizontal tab character."
17979 msgstr ""
17980
17981 #. type: =item
17982 #: ../fish/guestfish.pod:552
17983 msgid "C<\\v>"
17984 msgstr ""
17985
17986 #. type: textblock
17987 #: ../fish/guestfish.pod:554
17988 msgid "Vertical tab character."
17989 msgstr ""
17990
17991 #. type: =item
17992 #: ../fish/guestfish.pod:556
17993 msgid "C<\\\">"
17994 msgstr ""
17995
17996 #. type: textblock
17997 #: ../fish/guestfish.pod:558
17998 msgid "A literal double quote character."
17999 msgstr ""
18000
18001 #. type: =item
18002 #: ../fish/guestfish.pod:560
18003 msgid "C<\\ooo>"
18004 msgstr ""
18005
18006 #. type: textblock
18007 #: ../fish/guestfish.pod:562
18008 msgid ""
18009 "A character with octal value I<ooo>.  There must be precisely 3 octal digits "
18010 "(unlike C)."
18011 msgstr ""
18012
18013 #. type: =item
18014 #: ../fish/guestfish.pod:565
18015 msgid "C<\\xhh>"
18016 msgstr ""
18017
18018 #. type: textblock
18019 #: ../fish/guestfish.pod:567
18020 msgid ""
18021 "A character with hex value I<hh>.  There must be precisely 2 hex digits."
18022 msgstr ""
18023
18024 #. type: textblock
18025 #: ../fish/guestfish.pod:570
18026 msgid ""
18027 "In the current implementation C<\\000> and C<\\x00> cannot be used in "
18028 "strings."
18029 msgstr ""
18030
18031 #. type: =item
18032 #: ../fish/guestfish.pod:573
18033 msgid "C<\\\\>"
18034 msgstr ""
18035
18036 #. type: textblock
18037 #: ../fish/guestfish.pod:575
18038 msgid "A literal backslash character."
18039 msgstr ""
18040
18041 #. type: =head1
18042 #: ../fish/guestfish.pod:579
18043 msgid "OPTIONAL ARGUMENTS"
18044 msgstr ""
18045
18046 #. type: textblock
18047 #: ../fish/guestfish.pod:581
18048 msgid ""
18049 "Some commands take optional arguments.  These arguments appear in this "
18050 "documentation as C<[argname:..]>.  You can use them as in these examples:"
18051 msgstr ""
18052
18053 #. type: verbatim
18054 #: ../fish/guestfish.pod:585
18055 #, no-wrap
18056 msgid ""
18057 " add-drive-opts filename\n"
18058 "\n"
18059 msgstr ""
18060
18061 #. type: verbatim
18062 #: ../fish/guestfish.pod:587
18063 #, no-wrap
18064 msgid ""
18065 " add-drive-opts filename readonly:true\n"
18066 "\n"
18067 msgstr ""
18068
18069 #. type: verbatim
18070 #: ../fish/guestfish.pod:589
18071 #, no-wrap
18072 msgid ""
18073 " add-drive-opts filename format:qcow2 readonly:false\n"
18074 "\n"
18075 msgstr ""
18076
18077 #. type: textblock
18078 #: ../fish/guestfish.pod:591
18079 msgid ""
18080 "Each optional argument can appear at most once.  All optional arguments must "
18081 "appear after the required ones."
18082 msgstr ""
18083
18084 #. type: =head1
18085 #: ../fish/guestfish.pod:594
18086 msgid "NUMBERS"
18087 msgstr "ЧИСЛА"
18088
18089 #. type: textblock
18090 #: ../fish/guestfish.pod:596
18091 msgid ""
18092 "This section applies to all commands which can take integers as parameters."
18093 msgstr ""
18094
18095 #. type: =head2
18096 #: ../fish/guestfish.pod:599
18097 msgid "SIZE SUFFIX"
18098 msgstr ""
18099
18100 #. type: textblock
18101 #: ../fish/guestfish.pod:601
18102 msgid ""
18103 "When the command takes a parameter measured in bytes, you can use one of the "
18104 "following suffixes to specify kilobytes, megabytes and larger sizes:"
18105 msgstr ""
18106
18107 #. type: =item
18108 #: ../fish/guestfish.pod:607
18109 msgid "B<k> or B<K> or B<KiB>"
18110 msgstr "B<k>, B<K> або B<KiB>"
18111
18112 #. type: textblock
18113 #: ../fish/guestfish.pod:609
18114 msgid "The size in kilobytes (multiplied by 1024)."
18115 msgstr ""
18116
18117 #. type: =item
18118 #: ../fish/guestfish.pod:611
18119 msgid "B<KB>"
18120 msgstr "B<KB>"
18121
18122 #. type: textblock
18123 #: ../fish/guestfish.pod:613
18124 msgid "The size in SI 1000 byte units."
18125 msgstr ""
18126
18127 #. type: =item
18128 #: ../fish/guestfish.pod:615
18129 msgid "B<M> or B<MiB>"
18130 msgstr "B<M> або B<MiB>"
18131
18132 #. type: textblock
18133 #: ../fish/guestfish.pod:617
18134 msgid "The size in megabytes (multiplied by 1048576)."
18135 msgstr ""
18136
18137 #. type: =item
18138 #: ../fish/guestfish.pod:619
18139 msgid "B<MB>"
18140 msgstr "B<MB>"
18141
18142 #. type: textblock
18143 #: ../fish/guestfish.pod:621
18144 msgid "The size in SI 1000000 byte units."
18145 msgstr ""
18146
18147 #. type: =item
18148 #: ../fish/guestfish.pod:623
18149 msgid "B<G> or B<GiB>"
18150 msgstr "B<G> або B<GiB>"
18151
18152 #. type: textblock
18153 #: ../fish/guestfish.pod:625
18154 msgid "The size in gigabytes (multiplied by 2**30)."
18155 msgstr "Розмір у гігабайтах (з множником 2**30)."
18156
18157 #. type: =item
18158 #: ../fish/guestfish.pod:627
18159 msgid "B<GB>"
18160 msgstr "B<GB>"
18161
18162 #. type: textblock
18163 #: ../fish/guestfish.pod:629
18164 msgid "The size in SI 10**9 byte units."
18165 msgstr "Розмір у одиницях СІ: 10**9 байтів."
18166
18167 #. type: =item
18168 #: ../fish/guestfish.pod:631
18169 msgid "B<T> or B<TiB>"
18170 msgstr "B<T> або B<TiB>"
18171
18172 #. type: textblock
18173 #: ../fish/guestfish.pod:633
18174 msgid "The size in terabytes (multiplied by 2**40)."
18175 msgstr "Розмір у терабайтах (з множником 2**40)."
18176
18177 #. type: =item
18178 #: ../fish/guestfish.pod:635
18179 msgid "B<TB>"
18180 msgstr "B<TB>"
18181
18182 #. type: textblock
18183 #: ../fish/guestfish.pod:637
18184 msgid "The size in SI 10**12 byte units."
18185 msgstr ""
18186
18187 #. type: =item
18188 #: ../fish/guestfish.pod:639
18189 msgid "B<P> or B<PiB>"
18190 msgstr "B<P> або B<PiB>"
18191
18192 #. type: textblock
18193 #: ../fish/guestfish.pod:641
18194 msgid "The size in petabytes (multiplied by 2**50)."
18195 msgstr ""
18196
18197 #. type: =item
18198 #: ../fish/guestfish.pod:643
18199 msgid "B<PB>"
18200 msgstr "B<PB>"
18201
18202 #. type: textblock
18203 #: ../fish/guestfish.pod:645
18204 msgid "The size in SI 10**15 byte units."
18205 msgstr ""
18206
18207 #. type: =item
18208 #: ../fish/guestfish.pod:647
18209 msgid "B<E> or B<EiB>"
18210 msgstr "B<E> або B<EiB>"
18211
18212 #. type: textblock
18213 #: ../fish/guestfish.pod:649
18214 msgid "The size in exabytes (multiplied by 2**60)."
18215 msgstr ""
18216
18217 #. type: =item
18218 #: ../fish/guestfish.pod:651
18219 msgid "B<EB>"
18220 msgstr "B<EB>"
18221
18222 #. type: textblock
18223 #: ../fish/guestfish.pod:653
18224 msgid "The size in SI 10**18 byte units."
18225 msgstr ""
18226
18227 #. type: =item
18228 #: ../fish/guestfish.pod:655
18229 msgid "B<Z> or B<ZiB>"
18230 msgstr "B<Z> або B<ZiB>"
18231
18232 #. type: textblock
18233 #: ../fish/guestfish.pod:657
18234 msgid "The size in zettabytes (multiplied by 2**70)."
18235 msgstr ""
18236
18237 #. type: =item
18238 #: ../fish/guestfish.pod:659
18239 msgid "B<ZB>"
18240 msgstr "B<ZB>"
18241
18242 #. type: textblock
18243 #: ../fish/guestfish.pod:661
18244 msgid "The size in SI 10**21 byte units."
18245 msgstr ""
18246
18247 #. type: =item
18248 #: ../fish/guestfish.pod:663
18249 msgid "B<Y> or B<YiB>"
18250 msgstr "B<Y> або B<YiB>"
18251
18252 #. type: textblock
18253 #: ../fish/guestfish.pod:665
18254 msgid "The size in yottabytes (multiplied by 2**80)."
18255 msgstr ""
18256
18257 #. type: =item
18258 #: ../fish/guestfish.pod:667
18259 msgid "B<YB>"
18260 msgstr "B<YB>"
18261
18262 #. type: textblock
18263 #: ../fish/guestfish.pod:669
18264 msgid "The size in SI 10**24 byte units."
18265 msgstr ""
18266
18267 #. type: verbatim
18268 #: ../fish/guestfish.pod:675
18269 #, no-wrap
18270 msgid ""
18271 " truncate-size /file 1G\n"
18272 "\n"
18273 msgstr ""
18274
18275 #. type: textblock
18276 #: ../fish/guestfish.pod:677
18277 msgid "would truncate the file to 1 gigabyte."
18278 msgstr ""
18279
18280 #. type: textblock
18281 #: ../fish/guestfish.pod:679
18282 msgid ""
18283 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
18284 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
18285 "suffix will probably not do what you expect."
18286 msgstr ""
18287
18288 #. type: =head2
18289 #: ../fish/guestfish.pod:683
18290 msgid "OCTAL AND HEXADECIMAL NUMBERS"
18291 msgstr ""
18292
18293 #. type: textblock
18294 #: ../fish/guestfish.pod:685
18295 msgid ""
18296 "For specifying the radix (base) use the C convention: C<0> to prefix an "
18297 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
18298 msgstr ""
18299
18300 #. type: verbatim
18301 #: ../fish/guestfish.pod:688
18302 #, no-wrap
18303 msgid ""
18304 " 1234      decimal number 1234\n"
18305 " 02322     octal number, equivalent to decimal 1234\n"
18306 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
18307 "\n"
18308 msgstr ""
18309
18310 #. type: textblock
18311 #: ../fish/guestfish.pod:692
18312 msgid ""
18313 "When using the C<chmod> command, you almost always want to specify an octal "
18314 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
18315 "L<chmod(1)> program):"
18316 msgstr ""
18317
18318 #. type: verbatim
18319 #: ../fish/guestfish.pod:696
18320 #, no-wrap
18321 msgid ""
18322 " chmod 0777 /public  # OK\n"
18323 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
18324 "\n"
18325 msgstr ""
18326
18327 #. type: textblock
18328 #: ../fish/guestfish.pod:699
18329 msgid ""
18330 "Commands that return numbers usually print them in decimal, but some "
18331 "commands print numbers in other radices (eg. C<umask> prints the mode in "
18332 "octal, preceeded by C<0>)."
18333 msgstr ""
18334
18335 #. type: =head1
18336 #: ../fish/guestfish.pod:703
18337 msgid "WILDCARDS AND GLOBBING"
18338 msgstr ""
18339
18340 #. type: textblock
18341 #: ../fish/guestfish.pod:705
18342 msgid ""
18343 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
18344 "(globbing) by default.  So for example the following will not do what you "
18345 "expect:"
18346 msgstr ""
18347
18348 #. type: verbatim
18349 #: ../fish/guestfish.pod:709
18350 #, no-wrap
18351 msgid ""
18352 " rm-rf /home/*\n"
18353 "\n"
18354 msgstr ""
18355
18356 #. type: textblock
18357 #: ../fish/guestfish.pod:711
18358 msgid ""
18359 "Assuming you don't have a directory called literally C</home/*> then the "
18360 "above command will return an error."
18361 msgstr ""
18362
18363 #. type: textblock
18364 #: ../fish/guestfish.pod:714
18365 msgid "To perform wildcard expansion, use the C<glob> command."
18366 msgstr ""
18367
18368 #. type: verbatim
18369 #: ../fish/guestfish.pod:716
18370 #, no-wrap
18371 msgid ""
18372 " glob rm-rf /home/*\n"
18373 "\n"
18374 msgstr ""
18375
18376 #. type: textblock
18377 #: ../fish/guestfish.pod:718
18378 msgid ""
18379 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
18380 "many times), equivalent to:"
18381 msgstr ""
18382
18383 #. type: verbatim
18384 #: ../fish/guestfish.pod:721
18385 #, no-wrap
18386 msgid ""
18387 " rm-rf /home/jim\n"
18388 " rm-rf /home/joe\n"
18389 " rm-rf /home/mary\n"
18390 "\n"
18391 msgstr ""
18392
18393 #. type: textblock
18394 #: ../fish/guestfish.pod:725
18395 msgid "C<glob> only works on simple guest paths and not on device names."
18396 msgstr ""
18397
18398 #. type: textblock
18399 #: ../fish/guestfish.pod:727
18400 msgid ""
18401 "If you have several parameters, each containing a wildcard, then glob will "
18402 "perform a Cartesian product."
18403 msgstr ""
18404
18405 #. type: =head1
18406 #: ../fish/guestfish.pod:730
18407 msgid "COMMENTS"
18408 msgstr "КОМЕНТАРІ"
18409
18410 #. type: textblock
18411 #: ../fish/guestfish.pod:732
18412 msgid ""
18413 "Any line which starts with a I<#> character is treated as a comment and "
18414 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
18415 "a command.  For example:"
18416 msgstr ""
18417
18418 #. type: verbatim
18419 #: ../fish/guestfish.pod:736
18420 #, no-wrap
18421 msgid ""
18422 " # this is a comment\n"
18423 "         # this is a comment\n"
18424 " foo # NOT a comment\n"
18425 "\n"
18426 msgstr ""
18427
18428 #. type: textblock
18429 #: ../fish/guestfish.pod:740
18430 msgid "Blank lines are also ignored."
18431 msgstr ""
18432
18433 #. type: =head1
18434 #: ../fish/guestfish.pod:742
18435 msgid "RUNNING COMMANDS LOCALLY"
18436 msgstr ""
18437
18438 #. type: textblock
18439 #: ../fish/guestfish.pod:744
18440 msgid ""
18441 "Any line which starts with a I<!> character is treated as a command sent to "
18442 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
18443 msgstr ""
18444
18445 #. type: verbatim
18446 #: ../fish/guestfish.pod:748
18447 #, no-wrap
18448 msgid ""
18449 " !mkdir local\n"
18450 " tgz-out /remote local/remote-data.tar.gz\n"
18451 "\n"
18452 msgstr ""
18453
18454 #. type: textblock
18455 #: ../fish/guestfish.pod:751
18456 msgid ""
18457 "will create a directory C<local> on the host, and then export the contents "
18458 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
18459 "(See C<tgz-out>)."
18460 msgstr ""
18461
18462 #. type: textblock
18463 #: ../fish/guestfish.pod:755
18464 msgid ""
18465 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
18466 "effect, due to the way that subprocesses work in Unix."
18467 msgstr ""
18468
18469 #. type: =head2
18470 #: ../fish/guestfish.pod:758
18471 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
18472 msgstr ""
18473
18474 #. type: textblock
18475 #: ../fish/guestfish.pod:760
18476 msgid ""
18477 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
18478 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
18479 "and executed as guestfish commands."
18480 msgstr ""
18481
18482 #. type: textblock
18483 #: ../fish/guestfish.pod:764
18484 msgid ""
18485 "Thus you can use shell script to construct arbitrary guestfish commands "
18486 "which are then parsed by guestfish."
18487 msgstr ""
18488
18489 #. type: textblock
18490 #: ../fish/guestfish.pod:767
18491 msgid ""
18492 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
18493 "through C</foo.100>) using guestfish commands alone.  However this is simple "
18494 "if we use a shell script to create the guestfish commands for us:"
18495 msgstr ""
18496
18497 #. type: verbatim
18498 #: ../fish/guestfish.pod:772
18499 #, no-wrap
18500 msgid ""
18501 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
18502 "\n"
18503 msgstr ""
18504
18505 #. type: textblock
18506 #: ../fish/guestfish.pod:774
18507 msgid "or with names like C</foo.001>:"
18508 msgstr ""
18509
18510 #. type: verbatim
18511 #: ../fish/guestfish.pod:776
18512 #, no-wrap
18513 msgid ""
18514 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
18515 "\n"
18516 msgstr ""
18517
18518 #. type: textblock
18519 #: ../fish/guestfish.pod:778
18520 msgid ""
18521 "When using guestfish interactively it can be helpful to just run the shell "
18522 "script first (ie. remove the initial C<E<lt>> character so it is just an "
18523 "ordinary I<!> local command), see what guestfish commands it would run, and "
18524 "when you are happy with those prepend the C<E<lt>> character to run the "
18525 "guestfish commands for real."
18526 msgstr ""
18527
18528 #. type: =head1
18529 #: ../fish/guestfish.pod:784
18530 msgid "PIPES"
18531 msgstr "КАНАЛИ"
18532
18533 #. type: textblock
18534 #: ../fish/guestfish.pod:786
18535 msgid ""
18536 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
18537 "command (a guestfish command) to the second command (any host command).  For "
18538 "example:"
18539 msgstr ""
18540
18541 #. type: verbatim
18542 #: ../fish/guestfish.pod:790
18543 #, no-wrap
18544 msgid ""
18545 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
18546 "\n"
18547 msgstr ""
18548
18549 #. type: textblock
18550 #: ../fish/guestfish.pod:792
18551 msgid ""
18552 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
18553 "program).  The above command would list all accounts in the guest filesystem "
18554 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
18555 msgstr ""
18556
18557 #. type: verbatim
18558 #: ../fish/guestfish.pod:797
18559 #, no-wrap
18560 msgid ""
18561 " hexdump /bin/ls | head\n"
18562 " list-devices | tail -1\n"
18563 " tgz-out / - | tar ztf -\n"
18564 "\n"
18565 msgstr ""
18566
18567 #. type: textblock
18568 #: ../fish/guestfish.pod:801
18569 msgid ""
18570 "The space before the pipe symbol is required, any space after the pipe "
18571 "symbol is optional.  Everything after the pipe symbol is just passed "
18572 "straight to the host shell, so it can contain redirections, globs and "
18573 "anything else that makes sense on the host side."
18574 msgstr ""
18575
18576 #. type: textblock
18577 #: ../fish/guestfish.pod:806
18578 msgid ""
18579 "To use a literal argument which begins with a pipe symbol, you have to quote "
18580 "it, eg:"
18581 msgstr ""
18582
18583 #. type: verbatim
18584 #: ../fish/guestfish.pod:809
18585 #, no-wrap
18586 msgid ""
18587 " echo \"|\"\n"
18588 "\n"
18589 msgstr ""
18590
18591 #. type: =head1
18592 #: ../fish/guestfish.pod:811
18593 msgid "HOME DIRECTORIES"
18594 msgstr ""
18595
18596 #. type: textblock
18597 #: ../fish/guestfish.pod:813
18598 msgid ""
18599 "If a parameter starts with the character C<~> then the tilde may be expanded "
18600 "as a home directory path (either C<~> for the current user's home directory, "
18601 "or C<~user> for another user)."
18602 msgstr ""
18603
18604 #. type: textblock
18605 #: ../fish/guestfish.pod:817
18606 msgid ""
18607 "Note that home directory expansion happens for users known I<on the host>, "
18608 "not in the guest filesystem."
18609 msgstr ""
18610
18611 #. type: textblock
18612 #: ../fish/guestfish.pod:820
18613 msgid ""
18614 "To use a literal argument which begins with a tilde, you have to quote it, "
18615 "eg:"
18616 msgstr ""
18617
18618 #. type: verbatim
18619 #: ../fish/guestfish.pod:823
18620 #, no-wrap
18621 msgid ""
18622 " echo \"~\"\n"
18623 "\n"
18624 msgstr ""
18625
18626 #. type: =head2
18627 #: ../fish/guestfish.pod:825 ../src/guestfs.pod:519
18628 msgid "ENCRYPTED DISKS"
18629 msgstr "ЗАШИФРОВАНІ ДИСКИ"
18630
18631 #. type: textblock
18632 #: ../fish/guestfish.pod:827
18633 msgid ""
18634 "Libguestfs has some support for Linux guests encrypted according to the "
18635 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
18636 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
18637 "LUKS is supported."
18638 msgstr ""
18639
18640 #. type: textblock
18641 #: ../fish/guestfish.pod:832
18642 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
18643 msgstr ""
18644
18645 #. type: verbatim
18646 #: ../fish/guestfish.pod:834
18647 #, no-wrap
18648 msgid ""
18649 " ><fs> vfs-type /dev/sda2\n"
18650 " crypto_LUKS\n"
18651 "\n"
18652 msgstr ""
18653
18654 #. type: textblock
18655 #: ../fish/guestfish.pod:837
18656 msgid ""
18657 "Then open those devices using L</luks-open>.  This creates a device-mapper "
18658 "device called C</dev/mapper/luksdev>."
18659 msgstr ""
18660
18661 #. type: verbatim
18662 #: ../fish/guestfish.pod:840
18663 #, no-wrap
18664 msgid ""
18665 " ><fs> luks-open /dev/sda2 luksdev\n"
18666 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
18667 "\n"
18668 msgstr ""
18669
18670 #. type: textblock
18671 #: ../fish/guestfish.pod:843
18672 msgid ""
18673 "Finally you have to tell LVM to scan for volume groups on the newly created "
18674 "mapper device:"
18675 msgstr ""
18676
18677 #. type: verbatim
18678 #: ../fish/guestfish.pod:846
18679 #, no-wrap
18680 msgid ""
18681 " vgscan\n"
18682 " vg-activate-all true\n"
18683 "\n"
18684 msgstr ""
18685
18686 #. type: textblock
18687 #: ../fish/guestfish.pod:849
18688 msgid "The logical volume(s) can now be mounted in the usual way."
18689 msgstr ""
18690
18691 #. type: textblock
18692 #: ../fish/guestfish.pod:851
18693 msgid ""
18694 "Before closing a LUKS device you must unmount any logical volumes on it and "
18695 "deactivate the volume groups by calling C<vg-activate false VG> on each "
18696 "one.  Then you can close the mapper device:"
18697 msgstr ""
18698
18699 #. type: verbatim
18700 #: ../fish/guestfish.pod:855
18701 #, no-wrap
18702 msgid ""
18703 " vg-activate false /dev/VG\n"
18704 " luks-close /dev/mapper/luksdev\n"
18705 "\n"
18706 msgstr ""
18707
18708 #. type: textblock
18709 #: ../fish/guestfish.pod:860
18710 msgid ""
18711 "If a path is prefixed with C<win:> then you can use Windows-style drive "
18712 "letters and paths (with some limitations).  The following commands are "
18713 "equivalent:"
18714 msgstr ""
18715
18716 #. type: verbatim
18717 #: ../fish/guestfish.pod:864
18718 #, no-wrap
18719 msgid ""
18720 " file /WINDOWS/system32/config/system.LOG\n"
18721 "\n"
18722 msgstr ""
18723
18724 #. type: verbatim
18725 #: ../fish/guestfish.pod:866
18726 #, no-wrap
18727 msgid ""
18728 " file win:\\windows\\system32\\config\\system.log\n"
18729 "\n"
18730 msgstr ""
18731
18732 #. type: verbatim
18733 #: ../fish/guestfish.pod:868
18734 #, no-wrap
18735 msgid ""
18736 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
18737 "\n"
18738 msgstr ""
18739
18740 #. type: textblock
18741 #: ../fish/guestfish.pod:870
18742 msgid ""
18743 "The parameter is rewritten \"behind the scenes\" by looking up the position "
18744 "where the drive is mounted, prepending that to the path, changing all "
18745 "backslash characters to forward slash, then resolving the result using L</"
18746 "case-sensitive-path>.  For example if the E: drive was mounted on C</e> then "
18747 "the parameter might be rewritten like this:"
18748 msgstr ""
18749
18750 #. type: verbatim
18751 #: ../fish/guestfish.pod:876
18752 #, no-wrap
18753 msgid ""
18754 " win:e:\\foo\\bar => /e/FOO/bar\n"
18755 "\n"
18756 msgstr ""
18757
18758 #. type: textblock
18759 #: ../fish/guestfish.pod:878
18760 msgid "This only works in argument positions that expect a path."
18761 msgstr ""
18762
18763 #. type: =head1
18764 #: ../fish/guestfish.pod:880
18765 msgid "UPLOADING AND DOWNLOADING FILES"
18766 msgstr ""
18767
18768 #. type: textblock
18769 #: ../fish/guestfish.pod:882
18770 msgid ""
18771 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
18772 "others which upload from or download to a local file, you can use the "
18773 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
18774 msgstr ""
18775
18776 #. type: verbatim
18777 #: ../fish/guestfish.pod:886
18778 #, no-wrap
18779 msgid ""
18780 " upload - /foo\n"
18781 "\n"
18782 msgstr ""
18783
18784 #. type: textblock
18785 #: ../fish/guestfish.pod:888
18786 msgid ""
18787 "reads stdin and creates from that a file C</foo> in the disk image, and:"
18788 msgstr ""
18789
18790 #. type: verbatim
18791 #: ../fish/guestfish.pod:891
18792 #, no-wrap
18793 msgid ""
18794 " tar-out /etc - | tar tf -\n"
18795 "\n"
18796 msgstr ""
18797
18798 #. type: textblock
18799 #: ../fish/guestfish.pod:893
18800 msgid ""
18801 "writes the tarball to stdout and then pipes that into the external \"tar\" "
18802 "command (see L</PIPES>)."
18803 msgstr ""
18804
18805 #. type: textblock
18806 #: ../fish/guestfish.pod:896
18807 msgid ""
18808 "When using C<-> to read from stdin, the input is read up to the end of "
18809 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
18810 "some arbitrary end marker:"
18811 msgstr ""
18812
18813 #. type: verbatim
18814 #: ../fish/guestfish.pod:900
18815 #, no-wrap
18816 msgid ""
18817 " upload -<<END /foo\n"
18818 " input line 1\n"
18819 " input line 2\n"
18820 " input line 3\n"
18821 " END\n"
18822 "\n"
18823 msgstr ""
18824
18825 #. type: textblock
18826 #: ../fish/guestfish.pod:906
18827 msgid ""
18828 "Any string of characters can be used instead of C<END>.  The end marker must "
18829 "appear on a line of its own, without any preceeding or following characters "
18830 "(not even spaces)."
18831 msgstr ""
18832
18833 #. type: textblock
18834 #: ../fish/guestfish.pod:910
18835 msgid ""
18836 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
18837 "upload local files (so-called \"FileIn\" parameters in the generator)."
18838 msgstr ""
18839
18840 #. type: =head1
18841 #: ../fish/guestfish.pod:913
18842 msgid "EXIT ON ERROR BEHAVIOUR"
18843 msgstr ""
18844
18845 #. type: textblock
18846 #: ../fish/guestfish.pod:915
18847 msgid ""
18848 "By default, guestfish will ignore any errors when in interactive mode (ie. "
18849 "taking commands from a human over a tty), and will exit on the first error "
18850 "in non-interactive mode (scripts, commands given on the command line)."
18851 msgstr ""
18852
18853 #. type: textblock
18854 #: ../fish/guestfish.pod:920
18855 msgid ""
18856 "If you prefix a command with a I<-> character, then that command will not "
18857 "cause guestfish to exit, even if that (one) command returns an error."
18858 msgstr ""
18859
18860 #. type: =head1
18861 #: ../fish/guestfish.pod:924
18862 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
18863 msgstr ""
18864
18865 #. type: textblock
18866 #: ../fish/guestfish.pod:926
18867 msgid ""
18868 "Guestfish can be remote-controlled over a socket.  This is useful "
18869 "particularly in shell scripts where you want to make several different "
18870 "changes to a filesystem, but you don't want the overhead of starting up a "
18871 "guestfish process each time."
18872 msgstr ""
18873
18874 #. type: textblock
18875 #: ../fish/guestfish.pod:931
18876 msgid "Start a guestfish server process using:"
18877 msgstr ""
18878
18879 #. type: verbatim
18880 #: ../fish/guestfish.pod:933
18881 #, no-wrap
18882 msgid ""
18883 " eval \"`guestfish --listen`\"\n"
18884 "\n"
18885 msgstr ""
18886
18887 #. type: textblock
18888 #: ../fish/guestfish.pod:935
18889 msgid "and then send it commands by doing:"
18890 msgstr ""
18891
18892 #. type: verbatim
18893 #: ../fish/guestfish.pod:937
18894 #, no-wrap
18895 msgid ""
18896 " guestfish --remote cmd [...]\n"
18897 "\n"
18898 msgstr ""
18899
18900 #. type: textblock
18901 #: ../fish/guestfish.pod:939
18902 msgid "To cause the server to exit, send it the exit command:"
18903 msgstr ""
18904
18905 #. type: textblock
18906 #: ../fish/guestfish.pod:943
18907 msgid ""
18908 "Note that the server will normally exit if there is an error in a command.  "
18909 "You can change this in the usual way.  See section L</EXIT ON ERROR "
18910 "BEHAVIOUR>."
18911 msgstr ""
18912
18913 #. type: =head2
18914 #: ../fish/guestfish.pod:947
18915 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
18916 msgstr ""
18917
18918 #. type: textblock
18919 #: ../fish/guestfish.pod:949
18920 msgid ""
18921 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
18922 "is how the I<--remote> option knows where to send the commands.  You can "
18923 "have several guestfish listener processes running using:"
18924 msgstr ""
18925
18926 #. type: verbatim
18927 #: ../fish/guestfish.pod:953
18928 #, no-wrap
18929 msgid ""
18930 " eval \"`guestfish --listen`\"\n"
18931 " pid1=$GUESTFISH_PID\n"
18932 " eval \"`guestfish --listen`\"\n"
18933 " pid2=$GUESTFISH_PID\n"
18934 " ...\n"
18935 " guestfish --remote=$pid1 cmd\n"
18936 " guestfish --remote=$pid2 cmd\n"
18937 "\n"
18938 msgstr ""
18939
18940 #. type: =head2
18941 #: ../fish/guestfish.pod:961
18942 msgid "REMOTE CONTROL AND CSH"
18943 msgstr ""
18944
18945 #. type: textblock
18946 #: ../fish/guestfish.pod:963
18947 msgid ""
18948 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
18949 "option:"
18950 msgstr ""
18951
18952 #. type: verbatim
18953 #: ../fish/guestfish.pod:966
18954 #, no-wrap
18955 msgid ""
18956 " eval \"`guestfish --listen --csh`\"\n"
18957 "\n"
18958 msgstr ""
18959
18960 #. type: =head2
18961 #: ../fish/guestfish.pod:968
18962 msgid "REMOTE CONTROL DETAILS"
18963 msgstr ""
18964
18965 #. type: textblock
18966 #: ../fish/guestfish.pod:970
18967 msgid ""
18968 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
18969 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
18970 "and C<$PID> is the process ID of the server."
18971 msgstr ""
18972
18973 #. type: textblock
18974 #: ../fish/guestfish.pod:974
18975 msgid "Guestfish client and server versions must match exactly."
18976 msgstr ""
18977
18978 #. type: =head2
18979 #: ../fish/guestfish.pod:976
18980 msgid "REMOTE CONTROL RUN COMMAND HANGING"
18981 msgstr ""
18982
18983 #. type: textblock
18984 #: ../fish/guestfish.pod:978
18985 msgid ""
18986 "Using the C<run> (or C<launch>) command remotely in a command substitution "
18987 "context hangs, ie. don't do (note the backquotes):"
18988 msgstr ""
18989
18990 #. type: verbatim
18991 #: ../fish/guestfish.pod:981
18992 #, fuzzy, no-wrap
18993 #| msgid ""
18994 #| " guestfish --ro -d myguest -i\n"
18995 #| "\n"
18996 msgid ""
18997 " a=`guestfish --remote run`\n"
18998 "\n"
18999 msgstr ""
19000 " guestfish --ro -d myguest -i\n"
19001 "\n"
19002
19003 #. type: textblock
19004 #: ../fish/guestfish.pod:983
19005 msgid ""
19006 "Since the C<run> command produces no output on stdout, this is not useful "
19007 "anyway.  For further information see L<https://bugzilla.redhat.com/show_bug."
19008 "cgi?id=592910>."
19009 msgstr ""
19010
19011 #. type: =head1
19012 #: ../fish/guestfish.pod:987
19013 msgid "PREPARED DISK IMAGES"
19014 msgstr ""
19015
19016 #. type: textblock
19017 #: ../fish/guestfish.pod:989
19018 msgid ""
19019 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
19020 "preformatted disk images that guestfish can make for you to save typing.  "
19021 "This is particularly useful for testing purposes.  This option is used "
19022 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
19023 "can be mixed with I<-a>)."
19024 msgstr ""
19025
19026 #. type: textblock
19027 #: ../fish/guestfish.pod:995
19028 msgid ""
19029 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
19030 "the second and so on.  Existing files in the current directory are "
19031 "I<overwritten>."
19032 msgstr ""
19033
19034 #. type: textblock
19035 #: ../fish/guestfish.pod:999
19036 msgid ""
19037 "The type briefly describes how the disk should be sized, partitioned, how "
19038 "filesystem(s) should be created, and how content should be added.  "
19039 "Optionally the type can be followed by extra parameters, separated by C<:> "
19040 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
19041 "allocated disk, containing a single partition, with the partition formatted "
19042 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
19043 "disk instead."
19044 msgstr ""
19045
19046 #. type: textblock
19047 #: ../fish/guestfish.pod:1007
19048 msgid "To list the available types and any extra parameters they take, run:"
19049 msgstr ""
19050
19051 #. type: textblock
19052 #: ../fish/guestfish.pod:1011
19053 msgid ""
19054 "Note that the prepared filesystem is not mounted.  You would usually have to "
19055 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
19056 msgstr ""
19057
19058 #. type: textblock
19059 #: ../fish/guestfish.pod:1015
19060 msgid ""
19061 "If any I<-N> or I<--new> options are given, the guest is automatically "
19062 "launched."
19063 msgstr ""
19064
19065 #. type: textblock
19066 #: ../fish/guestfish.pod:1020
19067 msgid "Create a 100MB disk with an ext4-formatted partition:"
19068 msgstr ""
19069
19070 #. type: verbatim
19071 #: ../fish/guestfish.pod:1022
19072 #, no-wrap
19073 msgid ""
19074 " guestfish -N fs:ext4\n"
19075 "\n"
19076 msgstr ""
19077
19078 #. type: textblock
19079 #: ../fish/guestfish.pod:1024
19080 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
19081 msgstr ""
19082
19083 #. type: verbatim
19084 #: ../fish/guestfish.pod:1026
19085 #, no-wrap
19086 msgid ""
19087 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
19088 "\n"
19089 msgstr ""
19090
19091 #. type: textblock
19092 #: ../fish/guestfish.pod:1028
19093 msgid "Create a blank 200MB disk:"
19094 msgstr ""
19095
19096 #. type: verbatim
19097 #: ../fish/guestfish.pod:1030
19098 #, no-wrap
19099 msgid ""
19100 " guestfish -N disk:200M\n"
19101 "\n"
19102 msgstr ""
19103
19104 #. type: =head1
19105 #: ../fish/guestfish.pod:1032
19106 msgid "PROGRESS BARS"
19107 msgstr ""
19108
19109 #. type: textblock
19110 #: ../fish/guestfish.pod:1034
19111 msgid ""
19112 "Some (not all) long-running commands send progress notification messages as "
19113 "they are running.  Guestfish turns these messages into progress bars."
19114 msgstr ""
19115
19116 #. type: textblock
19117 #: ../fish/guestfish.pod:1038
19118 msgid ""
19119 "When a command that supports progress bars takes longer than two seconds to "
19120 "run, and if progress bars are enabled, then you will see one appearing below "
19121 "the command:"
19122 msgstr ""
19123
19124 #. type: verbatim
19125 #: ../fish/guestfish.pod:1042
19126 #, no-wrap
19127 msgid ""
19128 " ><fs> copy-size /large-file /another-file 2048M\n"
19129 " / 10% [#####-----------------------------------------] 00:30\n"
19130 "\n"
19131 msgstr ""
19132
19133 #. type: textblock
19134 #: ../fish/guestfish.pod:1045
19135 msgid ""
19136 "The spinner on the left hand side moves round once for every progress "
19137 "notification received from the backend.  This is a (reasonably) golden "
19138 "assurance that the command is \"doing something\" even if the progress bar "
19139 "is not moving, because the command is able to send the progress "
19140 "notifications.  When the bar reaches 100% and the command finishes, the "
19141 "spinner disappears."
19142 msgstr ""
19143
19144 #. type: textblock
19145 #: ../fish/guestfish.pod:1052
19146 msgid ""
19147 "Progress bars are enabled by default when guestfish is used interactively.  "
19148 "You can enable them even for non-interactive modes using I<--progress-bars>, "
19149 "and you can disable them completely using I<--no-progress-bars>."
19150 msgstr ""
19151
19152 #. type: =head1
19153 #: ../fish/guestfish.pod:1057
19154 msgid "GUESTFISH COMMANDS"
19155 msgstr ""
19156
19157 #. type: textblock
19158 #: ../fish/guestfish.pod:1059
19159 msgid ""
19160 "The commands in this section are guestfish convenience commands, in other "
19161 "words, they are not part of the L<guestfs(3)> API."
19162 msgstr ""
19163
19164 #. type: =head2
19165 #: ../fish/guestfish.pod:1062
19166 msgid "help"
19167 msgstr "help"
19168
19169 #. type: verbatim
19170 #: ../fish/guestfish.pod:1064
19171 #, no-wrap
19172 msgid ""
19173 " help\n"
19174 " help cmd\n"
19175 "\n"
19176 msgstr ""
19177 " help\n"
19178 " help команда\n"
19179 "\n"
19180
19181 #. type: textblock
19182 #: ../fish/guestfish.pod:1067
19183 msgid "Without any parameter, this provides general help."
19184 msgstr "Без параметра показує загальну довідкову інформацію."
19185
19186 #. type: textblock
19187 #: ../fish/guestfish.pod:1069
19188 msgid "With a C<cmd> parameter, this displays detailed help for that command."
19189 msgstr ""
19190
19191 #. type: =head2
19192 #: ../fish/guestfish.pod:1071
19193 msgid "quit | exit"
19194 msgstr ""
19195
19196 #. type: textblock
19197 #: ../fish/guestfish.pod:1073
19198 msgid "This exits guestfish.  You can also use C<^D> key."
19199 msgstr ""
19200
19201 #. type: textblock
19202 #: ../fish/guestfish.pod:1075
19203 msgid "@FISH_COMMANDS@"
19204 msgstr ""
19205
19206 #. type: =head1
19207 #: ../fish/guestfish.pod:1077
19208 msgid "COMMANDS"
19209 msgstr "КОМАНДИ"
19210
19211 #. type: textblock
19212 #: ../fish/guestfish.pod:1079 ../src/guestfs.pod:1474
19213 msgid "@ACTIONS@"
19214 msgstr "@ACTIONS@"
19215
19216 #. type: textblock
19217 #: ../fish/guestfish.pod:1083
19218 msgid ""
19219 "guestfish returns 0 if the commands completed without error, or 1 if there "
19220 "was an error."
19221 msgstr ""
19222
19223 #. type: =item
19224 #: ../fish/guestfish.pod:1090
19225 msgid "EDITOR"
19226 msgstr "РЕДАКТОР"
19227
19228 #. type: textblock
19229 #: ../fish/guestfish.pod:1092
19230 msgid ""
19231 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
19232 "C<vi>."
19233 msgstr ""
19234
19235 #. type: =item
19236 #: ../fish/guestfish.pod:1095 ../src/guestfs.pod:2969
19237 msgid "FEBOOTSTRAP_KERNEL"
19238 msgstr ""
19239
19240 #. type: =item
19241 #: ../fish/guestfish.pod:1097 ../src/guestfs.pod:2971
19242 msgid "FEBOOTSTRAP_MODULES"
19243 msgstr ""
19244
19245 #. type: textblock
19246 #: ../fish/guestfish.pod:1099 ../src/guestfs.pod:2973
19247 msgid ""
19248 "These two environment variables allow the kernel that libguestfs uses in the "
19249 "appliance to be selected.  If C<$FEBOOTSTRAP_KERNEL> is not set, then the "
19250 "most recent host kernel is chosen.  For more information about kernel "
19251 "selection, see L<febootstrap-supermin-helper(8)>.  This feature is only "
19252 "available in febootstrap E<ge> 3.8."
19253 msgstr ""
19254
19255 #. type: =item
19256 #: ../fish/guestfish.pod:1105
19257 msgid "GUESTFISH_DISPLAY_IMAGE"
19258 msgstr ""
19259
19260 #. type: textblock
19261 #: ../fish/guestfish.pod:1107
19262 msgid ""
19263 "The C<display> command uses C<$GUESTFISH_DISPLAY_IMAGE> to display images.  "
19264 "If not set, it uses L<display(1)>."
19265 msgstr ""
19266
19267 #. type: =item
19268 #: ../fish/guestfish.pod:1110
19269 msgid "GUESTFISH_PID"
19270 msgstr ""
19271
19272 #. type: textblock
19273 #: ../fish/guestfish.pod:1112
19274 msgid ""
19275 "Used with the I<--remote> option to specify the remote guestfish process to "
19276 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
19277 msgstr ""
19278
19279 #. type: =item
19280 #: ../fish/guestfish.pod:1116
19281 msgid "HEXEDITOR"
19282 msgstr ""
19283
19284 #. type: textblock
19285 #: ../fish/guestfish.pod:1118
19286 msgid ""
19287 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
19288 "not specified, the external L<hexedit(1)> program is used."
19289 msgstr ""
19290
19291 #. type: =item
19292 #: ../fish/guestfish.pod:1122
19293 msgid "HOME"
19294 msgstr "ДОМІВКА"
19295
19296 #. type: textblock
19297 #: ../fish/guestfish.pod:1124
19298 msgid ""
19299 "If compiled with GNU readline support, various files in the home directory "
19300 "can be used.  See L</FILES>."
19301 msgstr ""
19302
19303 #. type: =item
19304 #: ../fish/guestfish.pod:1127 ../src/guestfs.pod:2979
19305 msgid "LIBGUESTFS_APPEND"
19306 msgstr ""
19307
19308 #. type: textblock
19309 #: ../fish/guestfish.pod:1129 ../src/guestfs.pod:2981
19310 msgid "Pass additional options to the guest kernel."
19311 msgstr ""
19312
19313 #. type: =item
19314 #: ../fish/guestfish.pod:1131 ../src/guestfs.pod:2983
19315 msgid "LIBGUESTFS_DEBUG"
19316 msgstr "LIBGUESTFS_DEBUG"
19317
19318 #. type: textblock
19319 #: ../fish/guestfish.pod:1133
19320 msgid ""
19321 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
19322 "effect as using the B<-v> option."
19323 msgstr ""
19324
19325 #. type: =item
19326 #: ../fish/guestfish.pod:1136 ../src/guestfs.pod:2988
19327 msgid "LIBGUESTFS_MEMSIZE"
19328 msgstr "LIBGUESTFS_MEMSIZE"
19329
19330 #. type: textblock
19331 #: ../fish/guestfish.pod:1138 ../src/guestfs.pod:2990
19332 msgid ""
19333 "Set the memory allocated to the qemu process, in megabytes.  For example:"
19334 msgstr ""
19335
19336 #. type: verbatim
19337 #: ../fish/guestfish.pod:1141 ../src/guestfs.pod:2993
19338 #, no-wrap
19339 msgid ""
19340 " LIBGUESTFS_MEMSIZE=700\n"
19341 "\n"
19342 msgstr ""
19343 " LIBGUESTFS_MEMSIZE=700\n"
19344 "\n"
19345
19346 #. type: =item
19347 #: ../fish/guestfish.pod:1143 ../src/guestfs.pod:2995
19348 msgid "LIBGUESTFS_PATH"
19349 msgstr ""
19350
19351 #. type: textblock
19352 #: ../fish/guestfish.pod:1145
19353 msgid ""
19354 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
19355 "the discussion of paths in L<guestfs(3)>."
19356 msgstr ""
19357
19358 #. type: =item
19359 #: ../fish/guestfish.pod:1148 ../src/guestfs.pod:3000
19360 msgid "LIBGUESTFS_QEMU"
19361 msgstr ""
19362
19363 #. type: textblock
19364 #: ../fish/guestfish.pod:1150 ../src/guestfs.pod:3002
19365 msgid ""
19366 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
19367 "which was found at compile time by the configure script is used."
19368 msgstr ""
19369
19370 #. type: =item
19371 #: ../fish/guestfish.pod:1154 ../src/guestfs.pod:3008
19372 msgid "LIBGUESTFS_TRACE"
19373 msgstr ""
19374
19375 #. type: textblock
19376 #: ../fish/guestfish.pod:1156
19377 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
19378 msgstr ""
19379
19380 #. type: =item
19381 #: ../fish/guestfish.pod:1158
19382 msgid "PAGER"
19383 msgstr "РОЗБИТТЯ НА СТОРІНКИ"
19384
19385 #. type: textblock
19386 #: ../fish/guestfish.pod:1160
19387 msgid ""
19388 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
19389 "C<more>."
19390 msgstr ""
19391
19392 #. type: =item
19393 #: ../fish/guestfish.pod:1163 ../src/guestfs.pod:3013
19394 msgid "TMPDIR"
19395 msgstr ""
19396
19397 #. type: textblock
19398 #: ../fish/guestfish.pod:1165 ../src/guestfs.pod:3015
19399 msgid ""
19400 "Location of temporary directory, defaults to C</tmp> except for the cached "
19401 "supermin appliance which defaults to C</var/tmp>."
19402 msgstr ""
19403
19404 #. type: textblock
19405 #: ../fish/guestfish.pod:1168 ../src/guestfs.pod:3018
19406 msgid ""
19407 "If libguestfs was compiled to use the supermin appliance then the real "
19408 "appliance is cached in this directory, shared between all handles belonging "
19409 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
19410 "use in case C</var/tmp> is not large enough."
19411 msgstr ""
19412
19413 #. type: =head1
19414 #: ../fish/guestfish.pod:1176 ../fuse/guestmount.pod:288
19415 #: ../rescue/virt-rescue.pod:269
19416 msgid "FILES"
19417 msgstr "ФАЙЛИ"
19418
19419 #. type: =item
19420 #: ../fish/guestfish.pod:1180 ../fuse/guestmount.pod:292
19421 #: ../rescue/virt-rescue.pod:273
19422 msgid "$HOME/.libguestfs-tools.rc"
19423 msgstr ""
19424
19425 #. type: =item
19426 #: ../fish/guestfish.pod:1182 ../fuse/guestmount.pod:294
19427 #: ../rescue/virt-rescue.pod:275
19428 msgid "/etc/libguestfs-tools.conf"
19429 msgstr ""
19430
19431 #. type: textblock
19432 #: ../fish/guestfish.pod:1184 ../fuse/guestmount.pod:296
19433 #: ../rescue/virt-rescue.pod:277
19434 msgid ""
19435 "This configuration file controls the default read-only or read-write mode "
19436 "(I<--ro> or I<--rw>)."
19437 msgstr ""
19438
19439 #. type: textblock
19440 #: ../fish/guestfish.pod:1187
19441 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
19442 msgstr ""
19443
19444 #. type: =item
19445 #: ../fish/guestfish.pod:1189
19446 msgid "$HOME/.guestfish"
19447 msgstr ""
19448
19449 #. type: textblock
19450 #: ../fish/guestfish.pod:1191
19451 msgid ""
19452 "If compiled with GNU readline support, then the command history is saved in "
19453 "this file."
19454 msgstr ""
19455
19456 #. type: =item
19457 #: ../fish/guestfish.pod:1194
19458 msgid "$HOME/.inputrc"
19459 msgstr ""
19460
19461 #. type: =item
19462 #: ../fish/guestfish.pod:1196
19463 msgid "/etc/inputrc"
19464 msgstr ""
19465
19466 #. type: textblock
19467 #: ../fish/guestfish.pod:1198
19468 msgid ""
19469 "If compiled with GNU readline support, then these files can be used to "
19470 "configure readline.  For further information, please see L<readline(3)/"
19471 "INITIALIZATION FILE>."
19472 msgstr ""
19473
19474 #. type: textblock
19475 #: ../fish/guestfish.pod:1202
19476 msgid "To write rules which only apply to guestfish, use:"
19477 msgstr ""
19478
19479 #. type: verbatim
19480 #: ../fish/guestfish.pod:1204
19481 #, no-wrap
19482 msgid ""
19483 " $if guestfish\n"
19484 " ...\n"
19485 " $endif\n"
19486 "\n"
19487 msgstr ""
19488
19489 #. type: textblock
19490 #: ../fish/guestfish.pod:1208
19491 msgid ""
19492 "Variables that you can set in inputrc that change the behaviour of guestfish "
19493 "in useful ways include:"
19494 msgstr ""
19495
19496 #. type: =item
19497 #: ../fish/guestfish.pod:1213
19498 msgid "completion-ignore-case (default: on)"
19499 msgstr ""
19500
19501 #. type: textblock
19502 #: ../fish/guestfish.pod:1215
19503 msgid ""
19504 "By default, guestfish will ignore case when tab-completing paths on the "
19505 "disk.  Use:"
19506 msgstr ""
19507
19508 #. type: verbatim
19509 #: ../fish/guestfish.pod:1218
19510 #, no-wrap
19511 msgid ""
19512 " set completion-ignore-case off\n"
19513 "\n"
19514 msgstr ""
19515
19516 #. type: textblock
19517 #: ../fish/guestfish.pod:1220
19518 msgid "to make guestfish case sensitive."
19519 msgstr ""
19520
19521 #. type: =item
19522 #: ../fish/guestfish.pod:1224
19523 msgid "test1.img"
19524 msgstr ""
19525
19526 #. type: =item
19527 #: ../fish/guestfish.pod:1226
19528 msgid "test2.img (etc)"
19529 msgstr ""
19530
19531 #. type: textblock
19532 #: ../fish/guestfish.pod:1228
19533 msgid ""
19534 "When using the I<-N> or I<--new> option, the prepared disk or filesystem "
19535 "will be created in the file C<test1.img> in the current directory.  The "
19536 "second use of I<-N> will use C<test2.img> and so on.  Any existing file with "
19537 "the same name will be overwritten."
19538 msgstr ""
19539
19540 #. type: textblock
19541 #: ../fish/guestfish.pod:1237
19542 msgid ""
19543 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-copy-in(1)"
19544 ">, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)"
19545 ">, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions"
19546 "(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)"
19547 ">, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)"
19548 ">, L<display(1)>, L<hexedit(1)>, L<febootstrap-supermin-helper(8)>."
19549 msgstr ""
19550
19551 #. type: textblock
19552 #: ../fish/guestfish.pod:1266 ../src/guestfs.pod:3104
19553 #: ../test-tool/libguestfs-test-tool.pod:99
19554 msgid "Copyright (C) 2009-2011 Red Hat Inc.  L<http://libguestfs.org/>"
19555 msgstr ""
19556
19557 #. type: textblock
19558 #: ../fish/virt-copy-in.pod:5
19559 msgid ""
19560 "virt-copy-in - Copy files and directories into a virtual machine disk image."
19561 msgstr ""
19562
19563 #. type: verbatim
19564 #: ../fish/virt-copy-in.pod:9
19565 #, no-wrap
19566 msgid ""
19567 " virt-copy-in -a disk.img file|dir [file|dir ...] /destination\n"
19568 "\n"
19569 msgstr ""
19570
19571 #. type: verbatim
19572 #: ../fish/virt-copy-in.pod:11
19573 #, no-wrap
19574 msgid ""
19575 " virt-copy-in -d domain file|dir [file|dir ...] /destination\n"
19576 "\n"
19577 msgstr ""
19578
19579 #. type: textblock
19580 #: ../fish/virt-copy-in.pod:15
19581 msgid ""
19582 "Using C<virt-copy-in> on live virtual machines can be dangerous, potentially "
19583 "causing disk corruption.  The virtual machine must be shut down before you "
19584 "use this command."
19585 msgstr ""
19586
19587 #. type: textblock
19588 #: ../fish/virt-copy-in.pod:21
19589 msgid ""
19590 "C<virt-copy-in> copies files and directories from the local disk into a "
19591 "virtual machine disk image or named libvirt domain."
19592 msgstr ""
19593
19594 #. type: textblock
19595 #: ../fish/virt-copy-in.pod:24
19596 msgid ""
19597 "You can give one of more filenames and directories on the command line.  "
19598 "Directories are copied in recursively.  The final parameter must be the "
19599 "destination directory in the disk image which must be an absolute path "
19600 "starting with a C</> character."
19601 msgstr ""
19602
19603 #. type: verbatim
19604 #: ../fish/virt-copy-in.pod:33
19605 #, no-wrap
19606 msgid ""
19607 " virt-copy-in -d MyGuest resolv.conf /etc\n"
19608 "\n"
19609 msgstr ""
19610
19611 #. type: textblock
19612 #: ../fish/virt-copy-in.pod:35 ../fish/virt-tar-in.pod:32
19613 msgid "Upload a home directory to a guest:"
19614 msgstr ""
19615
19616 #. type: verbatim
19617 #: ../fish/virt-copy-in.pod:37
19618 #, no-wrap
19619 msgid ""
19620 " virt-copy-in -d MyGuest skel /home\n"
19621 "\n"
19622 msgstr ""
19623
19624 #. type: =head1
19625 #: ../fish/virt-copy-in.pod:39 ../fish/virt-copy-out.pod:28
19626 #: ../fish/virt-tar-in.pod:36 ../fish/virt-tar-out.pod:30
19627 msgid "JUST A SHELL SCRIPT WRAPPER AROUND GUESTFISH"
19628 msgstr ""
19629
19630 #. type: textblock
19631 #: ../fish/virt-copy-in.pod:41
19632 msgid ""
19633 "This command is just a simple shell script wrapper around the L<guestfish(1)"
19634 "> C<copy-in> command.  For anything more complex than a trivial copy, you "
19635 "are probably better off using guestfish directly."
19636 msgstr ""
19637
19638 #. type: textblock
19639 #: ../fish/virt-copy-in.pod:47 ../fish/virt-copy-out.pod:36
19640 #: ../fish/virt-tar-in.pod:44 ../fish/virt-tar-out.pod:38
19641 msgid ""
19642 "Since the shell script just passes options straight to guestfish, read "
19643 "L<guestfish(1)> to see the full list of options."
19644 msgstr ""
19645
19646 #. type: textblock
19647 #: ../fish/virt-copy-in.pod:52
19648 #, fuzzy
19649 #| msgid ""
19650 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-"
19651 #| "copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, "
19652 #| "L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://"
19653 #| "libguestfs.org/>."
19654 msgid ""
19655 "L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-out(1)>, L<virt-edit(1)>, "
19656 "L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<http://libguestfs.org/>."
19657 msgstr ""
19658 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
19659 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
19660 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
19661 "org/>."
19662
19663 #. type: textblock
19664 #: ../fish/virt-copy-in.pod:66 ../fish/virt-copy-out.pod:55
19665 #: ../fish/virt-tar-in.pod:64 ../fish/virt-tar-out.pod:57
19666 #, fuzzy
19667 #| msgid "Copyright (C) 2009 Red Hat Inc."
19668 msgid "Copyright (C) 2011 Red Hat Inc.  L<http://libguestfs.org/>"
19669 msgstr "© Red Hat Inc., 2009"
19670
19671 #. type: textblock
19672 #: ../fish/virt-copy-out.pod:5
19673 msgid ""
19674 "virt-copy-out - Copy files and directories out of a virtual machine disk "
19675 "image."
19676 msgstr ""
19677
19678 #. type: verbatim
19679 #: ../fish/virt-copy-out.pod:9
19680 #, no-wrap
19681 msgid ""
19682 " virt-copy-out -a disk.img /file|dir [/file|dir ...] localdir\n"
19683 "\n"
19684 msgstr ""
19685
19686 #. type: verbatim
19687 #: ../fish/virt-copy-out.pod:11
19688 #, no-wrap
19689 msgid ""
19690 " virt-copy-out -d domain /file|dir [/file|dir ...] localdir\n"
19691 "\n"
19692 msgstr ""
19693
19694 #. type: textblock
19695 #: ../fish/virt-copy-out.pod:15
19696 msgid ""
19697 "C<virt-copy-out> copies files and directories out of a virtual machine disk "
19698 "image or named libvirt domain."
19699 msgstr ""
19700
19701 #. type: textblock
19702 #: ../fish/virt-copy-out.pod:18
19703 msgid ""
19704 "You can give one of more filenames and directories on the command line.  "
19705 "Directories are copied out recursively."
19706 msgstr ""
19707
19708 #. type: textblock
19709 #: ../fish/virt-copy-out.pod:23
19710 msgid "Download the home directories from a virtual machine:"
19711 msgstr ""
19712
19713 #. type: verbatim
19714 #: ../fish/virt-copy-out.pod:25
19715 #, no-wrap
19716 msgid ""
19717 " mkdir homes\n"
19718 " virt-copy-out -d MyGuest /home homes\n"
19719 "\n"
19720 msgstr ""
19721
19722 #. type: textblock
19723 #: ../fish/virt-copy-out.pod:30
19724 msgid ""
19725 "This command is just a simple shell script wrapper around the L<guestfish(1)"
19726 "> C<copy-out> command.  For anything more complex than a trivial copy, you "
19727 "are probably better off using guestfish directly."
19728 msgstr ""
19729
19730 #. type: textblock
19731 #: ../fish/virt-copy-out.pod:41
19732 #, fuzzy
19733 #| msgid ""
19734 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-"
19735 #| "copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, "
19736 #| "L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://"
19737 #| "libguestfs.org/>."
19738 msgid ""
19739 "L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-edit(1)>, L<virt-"
19740 "tar-in(1)>, L<virt-tar-out(1)>, L<http://libguestfs.org/>."
19741 msgstr ""
19742 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
19743 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
19744 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
19745 "org/>."
19746
19747 #. type: textblock
19748 #: ../fish/virt-tar-in.pod:5
19749 msgid "virt-tar-in - Unpack a tarball into a virtual machine disk image."
19750 msgstr ""
19751
19752 #. type: verbatim
19753 #: ../fish/virt-tar-in.pod:9
19754 #, no-wrap
19755 msgid ""
19756 " virt-tar-in -a disk.img data.tar /destination\n"
19757 "\n"
19758 msgstr ""
19759
19760 #. type: verbatim
19761 #: ../fish/virt-tar-in.pod:11
19762 #, no-wrap
19763 msgid ""
19764 " virt-tar-in -d domain data.tar /destination\n"
19765 "\n"
19766 msgstr ""
19767
19768 #. type: verbatim
19769 #: ../fish/virt-tar-in.pod:13
19770 #, no-wrap
19771 msgid ""
19772 " zcat data.tar.gz | virt-tar-in -d domain - /destination\n"
19773 "\n"
19774 msgstr ""
19775
19776 #. type: textblock
19777 #: ../fish/virt-tar-in.pod:17
19778 msgid ""
19779 "Using C<virt-tar-in> on live virtual machines can be dangerous, potentially "
19780 "causing disk corruption.  The virtual machine must be shut down before you "
19781 "use this command."
19782 msgstr ""
19783
19784 #. type: textblock
19785 #: ../fish/virt-tar-in.pod:23
19786 msgid ""
19787 "C<virt-tar-in> unpacks an uncompressed tarball into a virtual machine disk "
19788 "image or named libvirt domain."
19789 msgstr ""
19790
19791 #. type: textblock
19792 #: ../fish/virt-tar-in.pod:26
19793 msgid ""
19794 "The first parameter is the tar file.  Use C<-> to read the tar file from "
19795 "standard input.  The second parameter is the absolute target directory to "
19796 "unpack into."
19797 msgstr ""
19798
19799 #. type: verbatim
19800 #: ../fish/virt-tar-in.pod:34
19801 #, no-wrap
19802 msgid ""
19803 " virt-tar-in -d MyGuest homes.tar /home\n"
19804 "\n"
19805 msgstr ""
19806
19807 #. type: textblock
19808 #: ../fish/virt-tar-in.pod:38
19809 msgid ""
19810 "This command is just a simple shell script wrapper around the L<guestfish(1)"
19811 "> C<tar-in> command.  For anything more complex than a trivial copy, you are "
19812 "probably better off using guestfish directly."
19813 msgstr ""
19814
19815 #. type: textblock
19816 #: ../fish/virt-tar-in.pod:49
19817 #, fuzzy
19818 #| msgid ""
19819 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-"
19820 #| "copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, "
19821 #| "L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://"
19822 #| "libguestfs.org/>."
19823 msgid ""
19824 "L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, "
19825 "L<virt-edit(1)>, L<virt-make-fs(1)>, L<virt-tar-out(1)>, L<http://libguestfs."
19826 "org/>."
19827 msgstr ""
19828 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
19829 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
19830 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
19831 "org/>."
19832
19833 #. type: textblock
19834 #: ../fish/virt-tar-out.pod:5
19835 msgid ""
19836 "virt-tar-out - Pack a virtual machine disk image directory into a tarball."
19837 msgstr ""
19838
19839 #. type: verbatim
19840 #: ../fish/virt-tar-out.pod:9
19841 #, no-wrap
19842 msgid ""
19843 " virt-tar-out -a disk.img /dir files.tar\n"
19844 "\n"
19845 msgstr ""
19846
19847 #. type: verbatim
19848 #: ../fish/virt-tar-out.pod:11
19849 #, no-wrap
19850 msgid ""
19851 " virt-tar-out -d domain /dir files.tar\n"
19852 "\n"
19853 msgstr ""
19854
19855 #. type: verbatim
19856 #: ../fish/virt-tar-out.pod:13
19857 #, no-wrap
19858 msgid ""
19859 " virt-tar-out -d domain /dir - | gzip --best > files.tar.gz\n"
19860 "\n"
19861 msgstr ""
19862
19863 #. type: textblock
19864 #: ../fish/virt-tar-out.pod:17
19865 msgid ""
19866 "C<virt-tar-out> packs a virtual machine disk image directory into a tarball."
19867 msgstr ""
19868
19869 #. type: textblock
19870 #: ../fish/virt-tar-out.pod:20
19871 msgid ""
19872 "The first parameter is the absolute path of the virtual machine directory.  "
19873 "The second parameter is the tar file to write.  Use C<-> to write to "
19874 "standard output."
19875 msgstr ""
19876
19877 #. type: textblock
19878 #: ../fish/virt-tar-out.pod:26
19879 msgid "Download the home directories from a guest:"
19880 msgstr ""
19881
19882 #. type: verbatim
19883 #: ../fish/virt-tar-out.pod:28
19884 #, no-wrap
19885 msgid ""
19886 " virt-tar-out -d MyGuest /home - | gzip --best > homes.tar.gz\n"
19887 "\n"
19888 msgstr ""
19889
19890 #. type: textblock
19891 #: ../fish/virt-tar-out.pod:32
19892 msgid ""
19893 "This command is just a simple shell script wrapper around the L<guestfish(1)"
19894 "> C<tar-out> command.  For anything more complex than a trivial copy, you "
19895 "are probably better off using guestfish directly."
19896 msgstr ""
19897
19898 #. type: textblock
19899 #: ../fish/virt-tar-out.pod:43
19900 #, fuzzy
19901 #| msgid ""
19902 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-"
19903 #| "copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, "
19904 #| "L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://"
19905 #| "libguestfs.org/>."
19906 msgid ""
19907 "L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, "
19908 "L<virt-edit(1)>, L<virt-tar-in(1)>, L<http://libguestfs.org/>."
19909 msgstr ""
19910 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
19911 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
19912 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
19913 "org/>."
19914
19915 #. type: textblock
19916 #: ../fuse/guestmount.pod:5
19917 msgid ""
19918 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
19919 msgstr ""
19920
19921 #. type: verbatim
19922 #: ../fuse/guestmount.pod:9
19923 #, no-wrap
19924 msgid ""
19925 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
19926 "\n"
19927 msgstr ""
19928
19929 #. type: verbatim
19930 #: ../fuse/guestmount.pod:11
19931 #, no-wrap
19932 msgid ""
19933 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
19934 "\n"
19935 msgstr ""
19936
19937 #. type: verbatim
19938 #: ../fuse/guestmount.pod:13
19939 #, no-wrap
19940 msgid ""
19941 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
19942 "\n"
19943 msgstr ""
19944
19945 #. type: textblock
19946 #: ../fuse/guestmount.pod:17
19947 msgid ""
19948 "You must I<not> use C<guestmount> in read-write mode on live virtual "
19949 "machines.  If you do this, you risk disk corruption in the VM."
19950 msgstr ""
19951
19952 #. type: textblock
19953 #: ../fuse/guestmount.pod:22
19954 msgid ""
19955 "The guestmount program can be used to mount virtual machine filesystems and "
19956 "other disk images on the host.  It uses libguestfs for access to the guest "
19957 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
19958 "a mountable device."
19959 msgstr ""
19960
19961 #. type: textblock
19962 #: ../fuse/guestmount.pod:27
19963 msgid ""
19964 "Along with other options, you have to give at least one device (I<-a> "
19965 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
19966 "option) or use the I<-i> inspection option.  How this works is better "
19967 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
19968 "below."
19969 msgstr ""
19970
19971 #. type: textblock
19972 #: ../fuse/guestmount.pod:33
19973 msgid ""
19974 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
19975 "by you, and the filesystem will not be visible to any other users unless you "
19976 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
19977 "the filesystem, use the C<fusermount -u> command."
19978 msgstr ""
19979
19980 #. type: textblock
19981 #: ../fuse/guestmount.pod:41
19982 msgid ""
19983 "For a typical Windows guest which has its main filesystem on the first "
19984 "partition:"
19985 msgstr ""
19986
19987 #. type: verbatim
19988 #: ../fuse/guestmount.pod:44
19989 #, no-wrap
19990 msgid ""
19991 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
19992 "\n"
19993 msgstr ""
19994
19995 #. type: textblock
19996 #: ../fuse/guestmount.pod:46
19997 msgid ""
19998 "For a typical Linux guest which has a /boot filesystem on the first "
19999 "partition, and the root filesystem on a logical volume:"
20000 msgstr ""
20001
20002 #. type: verbatim
20003 #: ../fuse/guestmount.pod:49
20004 #, no-wrap
20005 msgid ""
20006 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
20007 "\n"
20008 msgstr ""
20009
20010 #. type: textblock
20011 #: ../fuse/guestmount.pod:51
20012 msgid "To get libguestfs to detect guest mountpoints for you:"
20013 msgstr ""
20014
20015 #. type: verbatim
20016 #: ../fuse/guestmount.pod:53
20017 #, no-wrap
20018 msgid ""
20019 " guestmount -a guest.img -i --ro /mnt\n"
20020 "\n"
20021 msgstr ""
20022
20023 #. type: textblock
20024 #: ../fuse/guestmount.pod:55
20025 msgid "For a libvirt guest called \"Guest\" you could do:"
20026 msgstr ""
20027
20028 #. type: verbatim
20029 #: ../fuse/guestmount.pod:57
20030 #, no-wrap
20031 msgid ""
20032 " guestmount -d Guest -i --ro /mnt\n"
20033 "\n"
20034 msgstr ""
20035
20036 #. type: textblock
20037 #: ../fuse/guestmount.pod:59
20038 msgid ""
20039 "If you don't know what filesystems are contained in a guest or disk image, "
20040 "use L<virt-filesystems(1)> first:"
20041 msgstr ""
20042
20043 #. type: verbatim
20044 #: ../fuse/guestmount.pod:62
20045 #, no-wrap
20046 msgid ""
20047 " virt-filesystems MyGuest\n"
20048 "\n"
20049 msgstr ""
20050
20051 #. type: textblock
20052 #: ../fuse/guestmount.pod:64
20053 msgid ""
20054 "If you want to trace the libguestfs calls but without excessive debugging "
20055 "information, we recommend:"
20056 msgstr ""
20057
20058 #. type: verbatim
20059 #: ../fuse/guestmount.pod:67
20060 #, no-wrap
20061 msgid ""
20062 " guestmount [...] --trace /mnt\n"
20063 "\n"
20064 msgstr ""
20065
20066 #. type: textblock
20067 #: ../fuse/guestmount.pod:69
20068 msgid "If you want to debug the program, we recommend:"
20069 msgstr ""
20070
20071 #. type: verbatim
20072 #: ../fuse/guestmount.pod:71
20073 #, no-wrap
20074 msgid ""
20075 " guestmount [...] --trace --verbose /mnt\n"
20076 "\n"
20077 msgstr ""
20078
20079 #. type: =head1
20080 #: ../fuse/guestmount.pod:73 ../rescue/virt-rescue.pod:68
20081 #: ../resize/virt-resize.pod:511
20082 msgid "NOTES"
20083 msgstr "ПРИМІТКИ"
20084
20085 #. type: =head2
20086 #: ../fuse/guestmount.pod:75
20087 msgid "Other users cannot see the filesystem by default"
20088 msgstr ""
20089
20090 #. type: textblock
20091 #: ../fuse/guestmount.pod:77
20092 msgid ""
20093 "If you mount a filesystem as one user (eg. root), then other users will not "
20094 "be able to see it by default.  The fix is to add the FUSE C<allow_other> "
20095 "option when mounting:"
20096 msgstr ""
20097
20098 #. type: verbatim
20099 #: ../fuse/guestmount.pod:81
20100 #, no-wrap
20101 msgid ""
20102 " sudo guestmount [...] -o allow_other /mnt\n"
20103 "\n"
20104 msgstr ""
20105
20106 #. type: textblock
20107 #: ../fuse/guestmount.pod:91
20108 msgid "Add a block device or virtual machine image."
20109 msgstr ""
20110
20111 #. type: =item
20112 #: ../fuse/guestmount.pod:114
20113 msgid "B<--dir-cache-timeout N>"
20114 msgstr "B<--dir-cache-timeout N>"
20115
20116 #. type: textblock
20117 #: ../fuse/guestmount.pod:116
20118 msgid ""
20119 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
20120 "seconds.  The readdir cache [actually, there are several semi-independent "
20121 "caches] is populated after a readdir(2) call with the stat and extended "
20122 "attributes of the files in the directory, in anticipation that they will be "
20123 "requested soon after."
20124 msgstr ""
20125
20126 #. type: textblock
20127 #: ../fuse/guestmount.pod:122
20128 msgid ""
20129 "There is also a different attribute cache implemented by FUSE (see the FUSE "
20130 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
20131 "requests, only cache existing ones."
20132 msgstr ""
20133
20134 #. type: textblock
20135 #: ../fuse/guestmount.pod:142
20136 msgid ""
20137 "If you have untrusted raw-format guest disk images, you should use this "
20138 "option to specify the disk format.  This avoids a possible security problem "
20139 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
20140 "guestfs_add_drive_opts>."
20141 msgstr ""
20142
20143 #. type: =item
20144 #: ../fuse/guestmount.pod:147
20145 msgid "B<--fuse-help>"
20146 msgstr "B<--fuse-help>"
20147
20148 #. type: textblock
20149 #: ../fuse/guestmount.pod:149
20150 msgid "Display help on special FUSE options (see I<-o> below)."
20151 msgstr ""
20152
20153 #. type: textblock
20154 #: ../fuse/guestmount.pod:153
20155 msgid "Display brief help and exit."
20156 msgstr ""
20157
20158 #. type: textblock
20159 #: ../fuse/guestmount.pod:177
20160 msgid ""
20161 "Mount the named partition or logical volume on the given mountpoint B<in the "
20162 "guest> (this has nothing to do with mountpoints in the host)."
20163 msgstr ""
20164
20165 #. type: textblock
20166 #: ../fuse/guestmount.pod:180
20167 msgid ""
20168 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
20169 "something on C</>."
20170 msgstr ""
20171
20172 #. type: textblock
20173 #: ../fuse/guestmount.pod:197
20174 msgid ""
20175 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
20176 "unmounted.  If you specify this option, then we don't attempt to sync the "
20177 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
20178 msgstr ""
20179
20180 #. type: =item
20181 #: ../fuse/guestmount.pod:202
20182 #, fuzzy
20183 #| msgid "B<--partition>"
20184 msgid "B<-o option>"
20185 msgstr "B<--partition>"
20186
20187 #. type: =item
20188 #: ../fuse/guestmount.pod:204
20189 #, fuzzy
20190 #| msgid "B<--partition>"
20191 msgid "B<--option option>"
20192 msgstr "B<--partition>"
20193
20194 #. type: textblock
20195 #: ../fuse/guestmount.pod:206
20196 msgid "Pass extra options to FUSE."
20197 msgstr ""
20198
20199 #. type: textblock
20200 #: ../fuse/guestmount.pod:208
20201 msgid ""
20202 "To get a list of all the extra options supported by FUSE, use the command "
20203 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
20204 "of them are a good idea."
20205 msgstr ""
20206
20207 #. type: verbatim
20208 #: ../fuse/guestmount.pod:212
20209 #, no-wrap
20210 msgid ""
20211 " guestmount --fuse-help\n"
20212 "\n"
20213 msgstr ""
20214
20215 #. type: textblock
20216 #: ../fuse/guestmount.pod:214
20217 msgid "Some potentially useful FUSE options:"
20218 msgstr ""
20219
20220 #. type: =item
20221 #: ../fuse/guestmount.pod:218
20222 msgid "B<-o allow_other>"
20223 msgstr ""
20224
20225 #. type: textblock
20226 #: ../fuse/guestmount.pod:220
20227 msgid "Allow other users to see the filesystem."
20228 msgstr ""
20229
20230 #. type: =item
20231 #: ../fuse/guestmount.pod:222
20232 msgid "B<-o attr_timeout=N>"
20233 msgstr "B<-o attr_timeout=N>"
20234
20235 #. type: textblock
20236 #: ../fuse/guestmount.pod:224
20237 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
20238 msgstr ""
20239
20240 #. type: =item
20241 #: ../fuse/guestmount.pod:226
20242 msgid "B<-o kernel_cache>"
20243 msgstr ""
20244
20245 #. type: textblock
20246 #: ../fuse/guestmount.pod:228
20247 msgid ""
20248 "Allow the kernel to cache files (reduces the number of reads that have to go "
20249 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
20250 "afford the extra memory usage."
20251 msgstr ""
20252
20253 #. type: =item
20254 #: ../fuse/guestmount.pod:232
20255 msgid "B<-o uid=N> B<-o gid=N>"
20256 msgstr ""
20257
20258 #. type: textblock
20259 #: ../fuse/guestmount.pod:234
20260 msgid ""
20261 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
20262 "the chosen values."
20263 msgstr ""
20264
20265 #. type: textblock
20266 #: ../fuse/guestmount.pod:243
20267 msgid ""
20268 "Add devices and mount everything read-only.  Also disallow writes and make "
20269 "the disk appear read-only to FUSE."
20270 msgstr ""
20271
20272 #. type: textblock
20273 #: ../fuse/guestmount.pod:246
20274 msgid ""
20275 "This is highly recommended if you are not going to edit the guest disk.  If "
20276 "the guest is running and this option is I<not> supplied, then there is a "
20277 "strong risk of disk corruption in the guest.  We try to prevent this from "
20278 "happening, but it is not always possible."
20279 msgstr ""
20280
20281 #. type: textblock
20282 #: ../fuse/guestmount.pod:251 ../rescue/virt-rescue.pod:171
20283 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
20284 msgstr ""
20285
20286 #. type: textblock
20287 #: ../fuse/guestmount.pod:255
20288 msgid "Enable SELinux support for the guest."
20289 msgstr ""
20290
20291 #. type: textblock
20292 #: ../fuse/guestmount.pod:261
20293 msgid "Enable verbose messages from underlying libguestfs."
20294 msgstr ""
20295
20296 #. type: textblock
20297 #: ../fuse/guestmount.pod:267
20298 msgid "Display the program version and exit."
20299 msgstr ""
20300
20301 #. type: textblock
20302 #: ../fuse/guestmount.pod:276 ../fuse/guestmount.pod:299
20303 #: ../rescue/virt-rescue.pod:197 ../rescue/virt-rescue.pod:280
20304 msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
20305 msgstr ""
20306
20307 #. type: =item
20308 #: ../fuse/guestmount.pod:280
20309 #, fuzzy
20310 #| msgid "B<--ro>"
20311 msgid "B<--trace>"
20312 msgstr "B<--ro>"
20313
20314 #. type: textblock
20315 #: ../fuse/guestmount.pod:282
20316 msgid "Trace libguestfs calls and entry into each FUSE function."
20317 msgstr ""
20318
20319 #. type: textblock
20320 #: ../fuse/guestmount.pod:284
20321 msgid "This also stops the daemon from forking into the background."
20322 msgstr ""
20323
20324 #. type: textblock
20325 #: ../fuse/guestmount.pod:310
20326 msgid ""
20327 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
20328 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
20329 "net/>."
20330 msgstr ""
20331
20332 #. type: textblock
20333 #: ../fuse/guestmount.pod:325
20334 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
20335 msgstr ""
20336
20337 #. type: textblock
20338 #: ../inspector/virt-inspector.pod:5
20339 msgid ""
20340 "virt-inspector - Display operating system version and other information "
20341 "about a virtual machine"
20342 msgstr ""
20343
20344 #. type: verbatim
20345 #: ../inspector/virt-inspector.pod:9
20346 #, fuzzy, no-wrap
20347 #| msgid ""
20348 #| " virt-list-partitions [--options] domname\n"
20349 #| "\n"
20350 msgid ""
20351 " virt-inspector [--options] -d domname\n"
20352 "\n"
20353 msgstr ""
20354 " virt-list-partitions [--параметри] назва_домену\n"
20355 "\n"
20356
20357 #. type: verbatim
20358 #: ../inspector/virt-inspector.pod:11
20359 #, fuzzy, no-wrap
20360 #| msgid ""
20361 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
20362 #| "\n"
20363 msgid ""
20364 " virt-inspector [--options] -a disk.img [-a disk.img ...]\n"
20365 "\n"
20366 msgstr ""
20367 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
20368 "\n"
20369
20370 #. type: verbatim
20371 #: ../inspector/virt-inspector.pod:15
20372 #, fuzzy, no-wrap
20373 #| msgid ""
20374 #| " virt-list-partitions [--options] domname\n"
20375 #| "\n"
20376 msgid ""
20377 " virt-inspector domname\n"
20378 "\n"
20379 msgstr ""
20380 " virt-list-partitions [--параметри] назва_домену\n"
20381 "\n"
20382
20383 #. type: verbatim
20384 #: ../inspector/virt-inspector.pod:17 ../inspector/virt-inspector.pod:141
20385 #, fuzzy, no-wrap
20386 #| msgid ""
20387 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
20388 #| "\n"
20389 msgid ""
20390 " virt-inspector disk.img [disk.img ...]\n"
20391 "\n"
20392 msgstr ""
20393 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
20394 "\n"
20395
20396 #. type: textblock
20397 #: ../inspector/virt-inspector.pod:21
20398 msgid ""
20399 "B<virt-inspector> examines a virtual machine or disk image and tries to "
20400 "determine the version of the operating system and other information about "
20401 "the virtual machine."
20402 msgstr ""
20403
20404 #. type: textblock
20405 #: ../inspector/virt-inspector.pod:25
20406 msgid "Virt-inspector produces XML output for feeding into other programs."
20407 msgstr ""
20408
20409 #. type: textblock
20410 #: ../inspector/virt-inspector.pod:27
20411 msgid ""
20412 "In the normal usage, use C<virt-inspector -d domname> where C<domname> is "
20413 "the libvirt domain (see: C<virsh list --all>)."
20414 msgstr ""
20415
20416 #. type: textblock
20417 #: ../inspector/virt-inspector.pod:30
20418 msgid ""
20419 "You can also run virt-inspector directly on disk images from a single "
20420 "virtual machine.  Use C<virt-inspector -a disk.img>.  In rare cases a domain "
20421 "has several block devices, in which case you should list several I<-a> "
20422 "options one after another, with the first corresponding to the guest's C</"
20423 "dev/sda>, the second to the guest's C</dev/sdb> and so on."
20424 msgstr ""
20425
20426 #. type: textblock
20427 #: ../inspector/virt-inspector.pod:37
20428 msgid ""
20429 "You can also run virt-inspector on install disks, live CDs, bootable USB "
20430 "keys and similar."
20431 msgstr ""
20432
20433 #. type: textblock
20434 #: ../inspector/virt-inspector.pod:40
20435 msgid ""
20436 "Virt-inspector can only inspect and report upon I<one domain at a time>.  To "
20437 "inspect several virtual machines, you have to run virt-inspector several "
20438 "times (for example, from a shell script for-loop)."
20439 msgstr ""
20440
20441 #. type: textblock
20442 #: ../inspector/virt-inspector.pod:45
20443 msgid ""
20444 "Because virt-inspector needs direct access to guest images, it won't "
20445 "normally work over remote libvirt connections."
20446 msgstr ""
20447
20448 #. type: textblock
20449 #: ../inspector/virt-inspector.pod:48
20450 msgid ""
20451 "All of the information available from virt-inspector is also available "
20452 "through the core libguestfs inspection API (see L<guestfs(3)/INSPECTION>).  "
20453 "The same information can also be fetched using guestfish or via libguestfs "
20454 "bindings in many programming languages (see L<guestfs(3)/USING LIBGUESTFS "
20455 "WITH OTHER PROGRAMMING LANGUAGES>)."
20456 msgstr ""
20457
20458 #. type: textblock
20459 #: ../inspector/virt-inspector.pod:81
20460 msgid ""
20461 "Libvirt is only used if you specify a C<domname> on the command line.  If "
20462 "you specify guest block devices directly (I<-a>), then libvirt is not used "
20463 "at all."
20464 msgstr ""
20465
20466 #. type: textblock
20467 #: ../inspector/virt-inspector.pod:94
20468 msgid ""
20469 "When prompting for keys and passphrases, virt-inspector normally turns "
20470 "echoing off so you cannot see what you are typing.  If you are not worried "
20471 "about Tempest attacks and there is no one else in the room you can specify "
20472 "this flag to see what you are typing."
20473 msgstr ""
20474
20475 #. type: textblock
20476 #: ../inspector/virt-inspector.pod:103 ../tools/virt-list-filesystems.pl:93
20477 #: ../tools/virt-list-partitions.pl:94 ../tools/virt-tar.pl:143
20478 #: ../tools/virt-win-reg.pl:144
20479 msgid ""
20480 "Specify the format of disk images given on the command line.  If this is "
20481 "omitted then the format is autodetected from the content of the disk image."
20482 msgstr ""
20483
20484 #. type: textblock
20485 #: ../inspector/virt-inspector.pod:107 ../tools/virt-list-filesystems.pl:97
20486 #: ../tools/virt-list-partitions.pl:98 ../tools/virt-tar.pl:147
20487 #: ../tools/virt-win-reg.pl:148
20488 msgid ""
20489 "If disk images are requested from libvirt, then this program asks libvirt "
20490 "for this information.  In this case, the value of the format parameter is "
20491 "ignored."
20492 msgstr ""
20493
20494 #. type: textblock
20495 #: ../inspector/virt-inspector.pod:111 ../resize/virt-resize.pod:314
20496 #: ../resize/virt-resize.pod:406 ../tools/virt-list-filesystems.pl:101
20497 #: ../tools/virt-list-partitions.pl:102 ../tools/virt-tar.pl:151
20498 #: ../tools/virt-win-reg.pl:152
20499 msgid ""
20500 "If working with untrusted raw-format guest disk images, you should ensure "
20501 "the format is always specified."
20502 msgstr ""
20503
20504 #. type: textblock
20505 #: ../inspector/virt-inspector.pod:139
20506 msgid "Previous versions of virt-inspector allowed you to write either:"
20507 msgstr ""
20508
20509 #. type: verbatim
20510 #: ../inspector/virt-inspector.pod:145
20511 #, fuzzy, no-wrap
20512 #| msgid ""
20513 #| " inspect-get-hostname root\n"
20514 #| "\n"
20515 msgid ""
20516 " virt-inspector guestname\n"
20517 "\n"
20518 msgstr ""
20519 " inspect-get-hostname корінь\n"
20520 "\n"
20521
20522 #. type: =head1
20523 #: ../inspector/virt-inspector.pod:153
20524 msgid "XML FORMAT"
20525 msgstr ""
20526
20527 #. type: textblock
20528 #: ../inspector/virt-inspector.pod:155
20529 msgid ""
20530 "The virt-inspector XML is described precisely in a RELAX NG schema file "
20531 "C<virt-inspector.rng> which is supplied with libguestfs.  This section is "
20532 "just an overview."
20533 msgstr ""
20534
20535 #. type: textblock
20536 #: ../inspector/virt-inspector.pod:159
20537 msgid ""
20538 "The top-level element is E<lt>operatingsystemsE<gt>, and it contains one or "
20539 "more E<lt>operatingsystemE<gt> elements.  You would only see more than one "
20540 "E<lt>operatingsystemE<gt> element if the virtual machine is multi-boot, "
20541 "which is vanishingly rare in real world VMs."
20542 msgstr ""
20543
20544 #. type: =head2
20545 #: ../inspector/virt-inspector.pod:164
20546 msgid "E<lt>operatingsystemE<gt>"
20547 msgstr ""
20548
20549 #. type: textblock
20550 #: ../inspector/virt-inspector.pod:166
20551 msgid ""
20552 "In the E<lt>operatingsystemE<gt> tag are various optional fields that "
20553 "describe the operating system, its architecture, the descriptive \"product "
20554 "name\" string, the type of OS and so on, as in this example:"
20555 msgstr ""
20556
20557 #. type: verbatim
20558 #: ../inspector/virt-inspector.pod:170
20559 #, no-wrap
20560 msgid ""
20561 " <operatingsystems>\n"
20562 "   <operatingsystem>\n"
20563 "     <root>/dev/sda2</root>\n"
20564 "     <name>windows</name>\n"
20565 "     <arch>i386</arch>\n"
20566 "     <distro>windows</distro>\n"
20567 "     <product_name>Windows 7 Enterprise</product_name>\n"
20568 "     <product_variant>Client</product_variant>\n"
20569 "     <major_version>6</major_version>\n"
20570 "     <minor_version>1</minor_version>\n"
20571 "     <windows_systemroot>/Windows</windows_systemroot>\n"
20572 "     <format>installed</format>\n"
20573 "\n"
20574 msgstr ""
20575
20576 #. type: textblock
20577 #: ../inspector/virt-inspector.pod:183
20578 msgid ""
20579 "In brief, E<lt>nameE<gt> is the class of operating system (something like "
20580 "C<linux> or C<windows>), E<lt>distroE<gt> is the distribution (eg. C<fedora> "
20581 "but many other distros are recognized) and E<lt>archE<gt> is the guest "
20582 "architecture.  The other fields are fairly self-explanatory, but because "
20583 "these fields are taken directly from the libguestfs inspection API you can "
20584 "find precise information from L<guestfs(3)/INSPECTION>."
20585 msgstr ""
20586
20587 #. type: textblock
20588 #: ../inspector/virt-inspector.pod:191
20589 msgid ""
20590 "The E<lt>rootE<gt> element is the root filesystem device, but from the point "
20591 "of view of libguestfs (block devices may have completely different names "
20592 "inside the VM itself)."
20593 msgstr ""
20594
20595 #. type: =head2
20596 #: ../inspector/virt-inspector.pod:195
20597 #, fuzzy
20598 #| msgid "mountpoints"
20599 msgid "E<lt>mountpointsE<gt>"
20600 msgstr "mountpoints"
20601
20602 #. type: textblock
20603 #: ../inspector/virt-inspector.pod:197
20604 msgid ""
20605 "Un*x-like guests typically have multiple filesystems which are mounted at "
20606 "various mountpoints, and these are described in the E<lt>mountpointsE<gt> "
20607 "element which looks like this:"
20608 msgstr ""
20609
20610 #. type: verbatim
20611 #: ../inspector/virt-inspector.pod:201
20612 #, no-wrap
20613 msgid ""
20614 " <operatingsystems>\n"
20615 "   <operatingsystem>\n"
20616 "     ...\n"
20617 "     <mountpoints>\n"
20618 "       <mountpoint dev=\"/dev/vg_f13x64/lv_root\">/</mountpoint>\n"
20619 "       <mountpoint dev=\"/dev/sda1\">/boot</mountpoint>\n"
20620 "     </mountpoints>\n"
20621 "\n"
20622 msgstr ""
20623
20624 #. type: textblock
20625 #: ../inspector/virt-inspector.pod:209
20626 msgid ""
20627 "As with E<lt>rootE<gt>, devices are from the point of view of libguestfs, "
20628 "and may have completely different names inside the guest.  Only mountable "
20629 "filesystems appear in this list, not things like swap devices."
20630 msgstr ""
20631
20632 #. type: =head2
20633 #: ../inspector/virt-inspector.pod:214
20634 #, fuzzy
20635 #| msgid "list-filesystems"
20636 msgid "E<lt>filesystemsE<gt>"
20637 msgstr "list-filesystems"
20638
20639 #. type: textblock
20640 #: ../inspector/virt-inspector.pod:216
20641 msgid ""
20642 "E<lt>filesystemsE<gt> is like E<lt>mountpointsE<gt> but covers I<all> "
20643 "filesystems belonging to the guest, including swap and empty partitions.  "
20644 "(In the rare case of a multi-boot guest, it covers filesystems belonging to "
20645 "this OS or shared with this OS and other OSes)."
20646 msgstr ""
20647
20648 #. type: textblock
20649 #: ../inspector/virt-inspector.pod:222
20650 msgid "You might see something like this:"
20651 msgstr ""
20652
20653 #. type: verbatim
20654 #: ../inspector/virt-inspector.pod:224
20655 #, no-wrap
20656 msgid ""
20657 " <operatingsystems>\n"
20658 "   <operatingsystem>\n"
20659 "     ...\n"
20660 "     <filesystems>\n"
20661 "       <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
20662 "         <type>ext4</type>\n"
20663 "         <label>Fedora-13-x86_64</label>\n"
20664 "         <uuid>e6a4db1e-15c2-477b-ac2a-699181c396aa</uuid>\n"
20665 "       </filesystem>\n"
20666 "\n"
20667 msgstr ""
20668
20669 #. type: textblock
20670 #: ../inspector/virt-inspector.pod:234
20671 msgid ""
20672 "The optional elements within E<lt>filesystemE<gt> are the filesystem type, "
20673 "the label, and the UUID."
20674 msgstr ""
20675
20676 #. type: =head2
20677 #: ../inspector/virt-inspector.pod:237
20678 msgid "E<lt>applicationsE<gt>"
20679 msgstr ""
20680
20681 #. type: textblock
20682 #: ../inspector/virt-inspector.pod:239
20683 msgid ""
20684 "The related elements E<lt>package_formatE<gt>, E<lt>package_managementE<gt> "
20685 "and E<lt>applicationsE<gt> describe applications installed in the virtual "
20686 "machine."
20687 msgstr ""
20688
20689 #. type: textblock
20690 #: ../inspector/virt-inspector.pod:243
20691 msgid ""
20692 "E<lt>package_formatE<gt>, if present, describes the packaging system used.  "
20693 "Typical values would be C<rpm> and C<deb>."
20694 msgstr ""
20695
20696 #. type: textblock
20697 #: ../inspector/virt-inspector.pod:246
20698 msgid ""
20699 "E<lt>package_managementE<gt>, if present, describes the package manager.  "
20700 "Typical values include C<yum>, C<up2date> and C<apt>"
20701 msgstr ""
20702
20703 #. type: textblock
20704 #: ../inspector/virt-inspector.pod:249
20705 msgid "E<lt>applicationsE<gt> lists the packages or applications installed."
20706 msgstr ""
20707
20708 #. type: verbatim
20709 #: ../inspector/virt-inspector.pod:252
20710 #, no-wrap
20711 msgid ""
20712 " <operatingsystems>\n"
20713 "   <operatingsystem>\n"
20714 "     ...\n"
20715 "     <applications>\n"
20716 "       <application>\n"
20717 "         <name>coreutils</name>\n"
20718 "         <version>8.5</version>\n"
20719 "         <release>1</release>\n"
20720 "       </application>\n"
20721 "\n"
20722 msgstr ""
20723
20724 #. type: textblock
20725 #: ../inspector/virt-inspector.pod:262
20726 msgid ""
20727 "The version and release fields may not be available for some types guests.  "
20728 "Other fields are possible, see L<guestfs(3)/"
20729 "guestfs_inspect_list_applications>."
20730 msgstr ""
20731
20732 #. type: =head2
20733 #: ../inspector/virt-inspector.pod:266
20734 msgid "E<lt>drive_mappingsE<gt>"
20735 msgstr ""
20736
20737 #. type: textblock
20738 #: ../inspector/virt-inspector.pod:268
20739 msgid ""
20740 "For operating systems like Windows which use drive letters, virt-inspector "
20741 "is able to find out how drive letters map to filesystems."
20742 msgstr ""
20743
20744 #. type: verbatim
20745 #: ../inspector/virt-inspector.pod:272
20746 #, no-wrap
20747 msgid ""
20748 " <operatingsystems>\n"
20749 "   <operatingsystem>\n"
20750 "     ...\n"
20751 "     <drive_mappings>\n"
20752 "       <drive_mapping name=\"C\">/dev/sda2</drive_mapping>\n"
20753 "       <drive_mapping name=\"E\">/dev/sdb1</drive_mapping>\n"
20754 "     </drive_mappings>\n"
20755 "\n"
20756 msgstr ""
20757
20758 #. type: textblock
20759 #: ../inspector/virt-inspector.pod:280
20760 msgid ""
20761 "In the example above, drive C maps to the filesystem on the second partition "
20762 "on the first disk, and drive E maps to the filesystem on the first partition "
20763 "on the second disk."
20764 msgstr ""
20765
20766 #. type: textblock
20767 #: ../inspector/virt-inspector.pod:284
20768 msgid ""
20769 "Note that this only covers permanent local filesystem mappings, not things "
20770 "like network shares.  Furthermore NTFS volume mount points may not be listed "
20771 "here."
20772 msgstr ""
20773
20774 #. type: =head2
20775 #: ../inspector/virt-inspector.pod:288
20776 #, fuzzy
20777 #| msgid "B<-s E<lt>NE<gt>>"
20778 msgid "E<lt>iconE<gt>"
20779 msgstr "B<-s E<lt>NE<gt>>"
20780
20781 #. type: textblock
20782 #: ../inspector/virt-inspector.pod:290
20783 msgid ""
20784 "Virt-inspector is sometimes able to extract an icon or logo for the guest.  "
20785 "The icon is returned as base64-encoded PNG data.  Note that the icon can be "
20786 "very large and high quality."
20787 msgstr ""
20788
20789 #. type: verbatim
20790 #: ../inspector/virt-inspector.pod:294
20791 #, no-wrap
20792 msgid ""
20793 " <operatingsystems>\n"
20794 "   <operatingsystem>\n"
20795 "     ...\n"
20796 "     <icon>\n"
20797 "       iVBORw0KGgoAAAANSUhEUgAAAGAAAABg[.......]\n"
20798 "       [... many lines of base64 data ...]\n"
20799 "     </icon>\n"
20800 "\n"
20801 msgstr ""
20802
20803 #. type: textblock
20804 #: ../inspector/virt-inspector.pod:302
20805 msgid ""
20806 "To display the icon, you have to extract it and convert the base64 data back "
20807 "to a binary file.  Use an XPath query or simply an editor to extract the "
20808 "data, then use the coreutils L<base64(1)> program to do the conversion back "
20809 "to a PNG file:"
20810 msgstr ""
20811
20812 #. type: verbatim
20813 #: ../inspector/virt-inspector.pod:307
20814 #, no-wrap
20815 msgid ""
20816 " base64 -i -d < icon.data > icon.png\n"
20817 "\n"
20818 msgstr ""
20819
20820 #. type: =head2
20821 #: ../inspector/virt-inspector.pod:309
20822 msgid "INSPECTING INSTALL DISKS, LIVE CDs"
20823 msgstr ""
20824
20825 #. type: textblock
20826 #: ../inspector/virt-inspector.pod:311
20827 msgid ""
20828 "Virt-inspector can detect some operating system installers on install disks, "
20829 "live CDs, bootable USB keys and more."
20830 msgstr ""
20831
20832 #. type: textblock
20833 #: ../inspector/virt-inspector.pod:314
20834 msgid ""
20835 "In this case the E<lt>formatE<gt> tag will contain C<installer> and other "
20836 "fields may be present to indicate a live CD, network installer, or one part "
20837 "of a multipart CD.  For example:"
20838 msgstr ""
20839
20840 #. type: verbatim
20841 #: ../inspector/virt-inspector.pod:318
20842 #, no-wrap
20843 msgid ""
20844 " <operatingsystems>\n"
20845 "   <operatingsystem>\n"
20846 "     <root>/dev/sda</root>\n"
20847 "     <name>linux</name>\n"
20848 "     <arch>i386</arch>\n"
20849 "     <distro>ubuntu</distro>\n"
20850 "     <product_name>Ubuntu 10.10 &quot;Maverick Meerkat&quot;</product_name>\n"
20851 "     <major_version>10</major_version>\n"
20852 "     <minor_version>10</minor_version>\n"
20853 "     <format>installer</format>\n"
20854 "     <live/>\n"
20855 "\n"
20856 msgstr ""
20857
20858 #. type: =head1
20859 #: ../inspector/virt-inspector.pod:330
20860 msgid "USING XPATH"
20861 msgstr ""
20862
20863 #. type: textblock
20864 #: ../inspector/virt-inspector.pod:332
20865 msgid ""
20866 "You can use the XPath query language to select parts of the XML.  We "
20867 "recommend using C<xmlstarlet> to perform XPath queries from the command line."
20868 msgstr ""
20869
20870 #. type: verbatim
20871 #: ../inspector/virt-inspector.pod:338
20872 #, no-wrap
20873 msgid ""
20874 " $ virt-inspector -d Guest | xmlstarlet sel -t -c '//filesystems'\n"
20875 " <filesystems>\n"
20876 "      <filesystem dev=\"/dev/vg_f13x64/lv_root\">\n"
20877 "        <type>ext4</type>\n"
20878 " [...]\n"
20879 "\n"
20880 msgstr ""
20881
20882 #. type: verbatim
20883 #: ../inspector/virt-inspector.pod:344
20884 #, no-wrap
20885 msgid ""
20886 " $ virt-inspector -d Guest | \\\n"
20887 "     xmlstarlet sel -t -c \"string(//filesystem[@dev='/dev/sda1']/type)\"\n"
20888 " ext4\n"
20889 "\n"
20890 msgstr ""
20891
20892 #. type: verbatim
20893 #: ../inspector/virt-inspector.pod:348
20894 #, no-wrap
20895 msgid ""
20896 " $ virt-inspector -d Guest | \\\n"
20897 "    xmlstarlet sel -t -v '//icon' | base64 -i -d | display -\n"
20898 " [displays the guest icon, if there is one]\n"
20899 "\n"
20900 msgstr ""
20901
20902 #. type: =head1
20903 #: ../inspector/virt-inspector.pod:359
20904 msgid "OLD VERSIONS OF VIRT-INSPECTOR"
20905 msgstr ""
20906
20907 #. type: textblock
20908 #: ../inspector/virt-inspector.pod:361
20909 msgid ""
20910 "Early versions of libguestfs shipped with a different virt-inspector program "
20911 "written in Perl (the current version is written in C).  The XML output of "
20912 "the Perl virt-inspector was different and it could also output in other "
20913 "formats like text."
20914 msgstr ""
20915
20916 #. type: textblock
20917 #: ../inspector/virt-inspector.pod:366
20918 msgid ""
20919 "The old virt-inspector is no longer supported or shipped with libguestfs."
20920 msgstr ""
20921
20922 #. type: textblock
20923 #: ../inspector/virt-inspector.pod:369
20924 msgid ""
20925 "To confuse matters further, in Red Hat Enterprise Linux 6 we ship two "
20926 "versions of virt-inspector with different names:"
20927 msgstr ""
20928
20929 #. type: verbatim
20930 #: ../inspector/virt-inspector.pod:372
20931 #, no-wrap
20932 msgid ""
20933 " virt-inspector     Old Perl version.\n"
20934 " virt-inspector2    New C version.\n"
20935 "\n"
20936 msgstr ""
20937
20938 #. type: textblock
20939 #: ../inspector/virt-inspector.pod:382
20940 #, fuzzy
20941 #| msgid ""
20942 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
20943 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
20944 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
20945 msgid ""
20946 "L<guestfs(3)>, L<guestfish(1)>, L<http://www.w3.org/TR/xpath/>, L<base64(1)"
20947 ">, L<xmlstarlet(1)>, L<http://libguestfs.org/>."
20948 msgstr ""
20949 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
20950 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
20951 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
20952
20953 #. type: textblock
20954 #: ../inspector/virt-inspector.pod:399
20955 msgid "Matthew Booth L<mbooth@redhat.com>"
20956 msgstr ""
20957
20958 #. type: textblock
20959 #: ../java/examples/guestfs-java.pod:5
20960 msgid "guestfs-java - How to use libguestfs from Java"
20961 msgstr ""
20962
20963 #. type: verbatim
20964 #: ../java/examples/guestfs-java.pod:9
20965 #, no-wrap
20966 msgid ""
20967 " import com.redhat.et.libguestfs.*;\n"
20968 " \n"
20969 msgstr ""
20970
20971 #. type: verbatim
20972 #: ../java/examples/guestfs-java.pod:11
20973 #, no-wrap
20974 msgid ""
20975 " GuestFS g = new GuestFS ();\n"
20976 " g.add_drive_opts (\"disk.img\", null);\n"
20977 " g.launch ();\n"
20978 "\n"
20979 msgstr ""
20980
20981 #. type: textblock
20982 #: ../java/examples/guestfs-java.pod:17
20983 msgid ""
20984 "This manual page documents how to call libguestfs from the Java programming "
20985 "language.  This page just documents the differences from the C API and gives "
20986 "some examples.  If you are not familiar with using libguestfs, you also need "
20987 "to read L<guestfs(3)>."
20988 msgstr ""
20989
20990 #. type: =head2
20991 #: ../java/examples/guestfs-java.pod:22 ../ocaml/examples/guestfs-ocaml.pod:53
20992 msgid "CLOSING THE HANDLE"
20993 msgstr ""
20994
20995 #. type: textblock
20996 #: ../java/examples/guestfs-java.pod:24
20997 msgid ""
20998 "The handle is closed when it is reaped by the garbage collector.  Because "
20999 "libguestfs handles include a lot of state, it is also possible to close (and "
21000 "hence free) them explicitly by calling the C<close> method."
21001 msgstr ""
21002
21003 #. type: =head2
21004 #: ../java/examples/guestfs-java.pod:29 ../ocaml/examples/guestfs-ocaml.pod:60
21005 #: ../python/examples/guestfs-python.pod:21
21006 #: ../ruby/examples/guestfs-ruby.pod:22
21007 #, fuzzy
21008 #| msgid "OPTIONS"
21009 msgid "EXCEPTIONS"
21010 msgstr "ПАРАМЕТРИ"
21011
21012 #. type: textblock
21013 #: ../java/examples/guestfs-java.pod:31
21014 msgid ""
21015 "Errors from libguestfs functions are mapped into the C<LibGuestFSException> "
21016 "exception.  This has a single parameter which is the error message (a "
21017 "C<String>)."
21018 msgstr ""
21019
21020 #. type: textblock
21021 #: ../java/examples/guestfs-java.pod:35
21022 msgid "Calling any method on a closed handle raises the same exception."
21023 msgstr ""
21024
21025 #. type: textblock
21026 #: ../java/examples/guestfs-java.pod:47
21027 #, fuzzy
21028 #| msgid ""
21029 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21030 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
21031 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21032 msgid ""
21033 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)"
21034 ">, L<guestfs-python(3)>, L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, L<http://"
21035 "libguestfs.org/>, L<http://caml.inria.fr/>."
21036 msgstr ""
21037 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21038 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
21039 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21040
21041 #. type: textblock
21042 #: ../java/examples/guestfs-java.pod:63 ../perl/examples/guestfs-perl.pod:57
21043 #, fuzzy
21044 #| msgid "Copyright (C) 2009 Red Hat Inc."
21045 msgid "Copyright (C) 2011 Red Hat Inc. L<http://libguestfs.org/>"
21046 msgstr "© Red Hat Inc., 2009"
21047
21048 #. type: textblock
21049 #: ../ocaml/examples/guestfs-ocaml.pod:5
21050 msgid "guestfs-ocaml - How to use libguestfs from OCaml"
21051 msgstr ""
21052
21053 #. type: textblock
21054 #: ../ocaml/examples/guestfs-ocaml.pod:9
21055 msgid "Module style:"
21056 msgstr ""
21057
21058 #. type: verbatim
21059 #: ../ocaml/examples/guestfs-ocaml.pod:11
21060 #, no-wrap
21061 msgid ""
21062 " let g = Guestfs.create () in\n"
21063 " Guestfs.add_drive_opts g ~format:\"raw\" ~readonly:true \"disk.img\";\n"
21064 " Guestfs.launch g;\n"
21065 "\n"
21066 msgstr ""
21067
21068 #. type: textblock
21069 #: ../ocaml/examples/guestfs-ocaml.pod:15
21070 msgid "Object-oriented style:"
21071 msgstr ""
21072
21073 #. type: verbatim
21074 #: ../ocaml/examples/guestfs-ocaml.pod:17
21075 #, no-wrap
21076 msgid ""
21077 " let g = new Guestfs.guestfs () in\n"
21078 " g#add_drive_opts ~format:\"raw\" ~readonly:true \"disk.img\";\n"
21079 " g#launch ();\n"
21080 "\n"
21081 msgstr ""
21082
21083 #. type: verbatim
21084 #: ../ocaml/examples/guestfs-ocaml.pod:21
21085 #, no-wrap
21086 msgid ""
21087 " ocamlfind opt prog.ml -package guestfs -linkpkg -o prog\n"
21088 "or:\n"
21089 " ocamlopt -I +guestfs mlguestfs.cmxa prog.ml -o prog\n"
21090 "\n"
21091 msgstr ""
21092
21093 #. type: textblock
21094 #: ../ocaml/examples/guestfs-ocaml.pod:27
21095 msgid ""
21096 "This manual page documents how to call libguestfs from the OCaml programming "
21097 "language.  This page just documents the differences from the C API and gives "
21098 "some examples.  If you are not familiar with using libguestfs, you also need "
21099 "to read L<guestfs(3)>."
21100 msgstr ""
21101
21102 #. type: =head2
21103 #: ../ocaml/examples/guestfs-ocaml.pod:32
21104 msgid "PROGRAMMING STYLES"
21105 msgstr ""
21106
21107 #. type: textblock
21108 #: ../ocaml/examples/guestfs-ocaml.pod:34
21109 msgid ""
21110 "There are two different programming styles supported by the OCaml bindings.  "
21111 "You can use a module style, with each C function mapped to an OCaml function:"
21112 msgstr ""
21113
21114 #. type: verbatim
21115 #: ../ocaml/examples/guestfs-ocaml.pod:38
21116 #, fuzzy, no-wrap
21117 #| msgid ""
21118 #| " int guestfs_last_errno (guestfs_h *g);\n"
21119 #| "\n"
21120 msgid ""
21121 " int guestfs_set_verbose (guestfs_h *g, int flag);\n"
21122 "\n"
21123 msgstr ""
21124 " int guestfs_last_errno (guestfs_h *g);\n"
21125 "\n"
21126
21127 #. type: textblock
21128 #: ../ocaml/examples/guestfs-ocaml.pod:40
21129 msgid "becomes:"
21130 msgstr ""
21131
21132 #. type: verbatim
21133 #: ../ocaml/examples/guestfs-ocaml.pod:42
21134 #, no-wrap
21135 msgid ""
21136 " val Guestfs.set_verbose : Guestfs.t -> bool -> unit\n"
21137 "\n"
21138 msgstr ""
21139
21140 #. type: textblock
21141 #: ../ocaml/examples/guestfs-ocaml.pod:44
21142 msgid ""
21143 "Alternately you can use an object-oriented style, calling methods on the "
21144 "class C<Guestfs.guestfs>:"
21145 msgstr ""
21146
21147 #. type: verbatim
21148 #: ../ocaml/examples/guestfs-ocaml.pod:47
21149 #, no-wrap
21150 msgid ""
21151 " method set_verbose : bool -> unit\n"
21152 "\n"
21153 msgstr ""
21154
21155 #. type: textblock
21156 #: ../ocaml/examples/guestfs-ocaml.pod:49
21157 msgid ""
21158 "The object-oriented style is usually briefer, and the minor performance "
21159 "penalty isn't noticable in the general overhead of performing libguestfs "
21160 "functions."
21161 msgstr ""
21162
21163 #. type: textblock
21164 #: ../ocaml/examples/guestfs-ocaml.pod:55
21165 msgid ""
21166 "The handle is closed when it is reaped by the garbage collector.  Because "
21167 "libguestfs handles include a lot of state, it is also possible to close (and "
21168 "hence free) them explicitly by calling C<Guestfs.close> or the C<#close> "
21169 "method."
21170 msgstr ""
21171
21172 #. type: textblock
21173 #: ../ocaml/examples/guestfs-ocaml.pod:62
21174 msgid ""
21175 "Errors from libguestfs functions are mapped into the C<Guestfs.Error> "
21176 "exception.  This has a single parameter which is the error message (a "
21177 "string)."
21178 msgstr ""
21179
21180 #. type: textblock
21181 #: ../ocaml/examples/guestfs-ocaml.pod:66
21182 msgid ""
21183 "Calling any function/method on a closed handle raises C<Guestfs."
21184 "Handle_closed>.  The single parameter is the name of the function that you "
21185 "called."
21186 msgstr ""
21187
21188 #. type: textblock
21189 #: ../ocaml/examples/guestfs-ocaml.pod:80
21190 #, fuzzy
21191 #| msgid ""
21192 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21193 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
21194 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21195 msgid ""
21196 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, L<guestfs-perl(3)"
21197 ">, L<guestfs-python(3)>, L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, L<http://"
21198 "libguestfs.org/>, L<http://caml.inria.fr/>."
21199 msgstr ""
21200 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21201 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
21202 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21203
21204 #. type: textblock
21205 #: ../perl/examples/guestfs-perl.pod:5
21206 msgid "guestfs-perl - How to use libguestfs from Perl"
21207 msgstr ""
21208
21209 #. type: verbatim
21210 #: ../perl/examples/guestfs-perl.pod:9
21211 #, no-wrap
21212 msgid ""
21213 " use Sys::Guestfs;\n"
21214 " \n"
21215 msgstr ""
21216
21217 #. type: verbatim
21218 #: ../perl/examples/guestfs-perl.pod:11
21219 #, no-wrap
21220 msgid ""
21221 " my $h = Sys::Guestfs->new ();\n"
21222 " $h->add_drive_opts ('guest.img', format => 'raw');\n"
21223 " $h->launch ();\n"
21224 " $h->mount_options ('', '/dev/sda1', '/');\n"
21225 " $h->touch ('/hello');\n"
21226 " $h->sync ();\n"
21227 "\n"
21228 msgstr ""
21229
21230 #. type: textblock
21231 #: ../perl/examples/guestfs-perl.pod:20
21232 msgid ""
21233 "This manual page documents how to call libguestfs from the Perl programming "
21234 "language.  This page just documents the differences from the C API and gives "
21235 "some examples.  If you are not familiar with using libguestfs, you also need "
21236 "to read L<guestfs(3)>.  To read the full Perl API, see L<Sys::Guestfs(3)>."
21237 msgstr ""
21238
21239 #. type: =head2
21240 #: ../perl/examples/guestfs-perl.pod:26
21241 msgid "ERRORS"
21242 msgstr ""
21243
21244 #. type: textblock
21245 #: ../perl/examples/guestfs-perl.pod:28
21246 msgid ""
21247 "Errors from libguestfs functions turn into calls to C<croak> (see L<Carp(3)"
21248 ">)."
21249 msgstr ""
21250
21251 #. type: textblock
21252 #: ../perl/examples/guestfs-perl.pod:41
21253 #, fuzzy
21254 #| msgid ""
21255 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21256 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
21257 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21258 msgid ""
21259 "L<Sys::Guestfs(3)>, L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-java(3)"
21260 ">, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, "
21261 "L<guestfs-ruby(3)>, L<http://libguestfs.org/>."
21262 msgstr ""
21263 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21264 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
21265 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21266
21267 #. type: textblock
21268 #: ../python/examples/guestfs-python.pod:5
21269 msgid "guestfs-python - How to use libguestfs from Python"
21270 msgstr ""
21271
21272 #. type: verbatim
21273 #: ../python/examples/guestfs-python.pod:9
21274 #, no-wrap
21275 msgid ""
21276 " import guestfs\n"
21277 " g = guestfs.GuestFS ()\n"
21278 " g.add_drive_opts (\"disk.img\", format=\"raw\", readonly=1)\n"
21279 " g.launch\n"
21280 "\n"
21281 msgstr ""
21282
21283 #. type: textblock
21284 #: ../python/examples/guestfs-python.pod:16
21285 msgid ""
21286 "This manual page documents how to call libguestfs from the Python "
21287 "programming language.  This page just documents the differences from the C "
21288 "API and gives some examples.  If you are not familiar with using libguestfs, "
21289 "you also need to read L<guestfs(3)>."
21290 msgstr ""
21291
21292 #. type: textblock
21293 #: ../python/examples/guestfs-python.pod:23
21294 msgid ""
21295 "Errors from libguestfs functions are mapped into C<RuntimeException> with a "
21296 "single string argument which is the error message."
21297 msgstr ""
21298
21299 #. type: =head2
21300 #: ../python/examples/guestfs-python.pod:26
21301 msgid "MORE DOCUMENTATION"
21302 msgstr ""
21303
21304 #. type: textblock
21305 #: ../python/examples/guestfs-python.pod:28
21306 msgid "Type:"
21307 msgstr ""
21308
21309 #. type: verbatim
21310 #: ../python/examples/guestfs-python.pod:30
21311 #, no-wrap
21312 msgid ""
21313 " $ python\n"
21314 " >>> import guestfs\n"
21315 " >>> help (guestfs)\n"
21316 "\n"
21317 msgstr ""
21318
21319 #. type: textblock
21320 #: ../python/examples/guestfs-python.pod:44
21321 #, fuzzy
21322 #| msgid ""
21323 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21324 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
21325 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21326 msgid ""
21327 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
21328 ">, L<guestfs-perl(3)>, L<guestfs-recipes(1)>, L<guestfs-ruby(3)>, L<http://"
21329 "libguestfs.org/>."
21330 msgstr ""
21331 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21332 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
21333 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21334
21335 #. type: textblock
21336 #: ../rescue/virt-rescue.pod:5
21337 msgid "virt-rescue - Run a rescue shell on a virtual machine"
21338 msgstr ""
21339
21340 #. type: verbatim
21341 #: ../rescue/virt-rescue.pod:9
21342 #, fuzzy, no-wrap
21343 #| msgid ""
21344 #| " virt-list-partitions [--options] domname\n"
21345 #| "\n"
21346 msgid ""
21347 " virt-rescue [--options] -d domname\n"
21348 "\n"
21349 msgstr ""
21350 " virt-list-partitions [--параметри] назва_домену\n"
21351 "\n"
21352
21353 #. type: verbatim
21354 #: ../rescue/virt-rescue.pod:11
21355 #, fuzzy, no-wrap
21356 #| msgid ""
21357 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
21358 #| "\n"
21359 msgid ""
21360 " virt-rescue [--options] -a disk.img [-a disk.img ...]\n"
21361 "\n"
21362 msgstr ""
21363 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
21364 "\n"
21365
21366 #. type: verbatim
21367 #: ../rescue/virt-rescue.pod:15
21368 #, fuzzy, no-wrap
21369 #| msgid ""
21370 #| " virt-list-partitions [--options] domname\n"
21371 #| "\n"
21372 msgid ""
21373 " virt-rescue [--options] domname\n"
21374 "\n"
21375 msgstr ""
21376 " virt-list-partitions [--параметри] назва_домену\n"
21377 "\n"
21378
21379 #. type: verbatim
21380 #: ../rescue/virt-rescue.pod:17
21381 #, fuzzy, no-wrap
21382 #| msgid ""
21383 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
21384 #| "\n"
21385 msgid ""
21386 " virt-rescue [--options] disk.img [disk.img ...]\n"
21387 "\n"
21388 msgstr ""
21389 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
21390 "\n"
21391
21392 #. type: textblock
21393 #: ../rescue/virt-rescue.pod:21
21394 msgid ""
21395 "You must I<not> use C<virt-rescue> on live virtual machines.  Doing so will "
21396 "probably result in disk corruption in the VM.  C<virt-rescue> tries to stop "
21397 "you from doing this, but doesn't catch all cases."
21398 msgstr ""
21399
21400 #. type: textblock
21401 #: ../rescue/virt-rescue.pod:25
21402 msgid ""
21403 "However if you use the I<--ro> (read only) option, then you can attach a "
21404 "shell to a live virtual machine.  The results might be strange or "
21405 "inconsistent at times but you won't get disk corruption."
21406 msgstr ""
21407
21408 #. type: textblock
21409 #: ../rescue/virt-rescue.pod:31
21410 msgid ""
21411 "virt-rescue is like a Rescue CD, but for virtual machines, and without the "
21412 "need for a CD.  virt-rescue gives you a rescue shell and some simple "
21413 "recovery tools which you can use to examine or rescue a virtual machine or "
21414 "disk image."
21415 msgstr ""
21416
21417 #. type: textblock
21418 #: ../rescue/virt-rescue.pod:36
21419 msgid ""
21420 "You can run virt-rescue on any virtual machine known to libvirt, or directly "
21421 "on disk image(s):"
21422 msgstr ""
21423
21424 #. type: verbatim
21425 #: ../rescue/virt-rescue.pod:39
21426 #, no-wrap
21427 msgid ""
21428 " virt-rescue -d GuestName\n"
21429 "\n"
21430 msgstr ""
21431
21432 #. type: verbatim
21433 #: ../rescue/virt-rescue.pod:41
21434 #, no-wrap
21435 msgid ""
21436 " virt-rescue --ro -a /path/to/disk.img\n"
21437 "\n"
21438 msgstr ""
21439
21440 #. type: verbatim
21441 #: ../rescue/virt-rescue.pod:43
21442 #, no-wrap
21443 msgid ""
21444 " virt-rescue -a /dev/sdc\n"
21445 "\n"
21446 msgstr ""
21447
21448 #. type: textblock
21449 #: ../rescue/virt-rescue.pod:45
21450 msgid "For live VMs you I<must> use the --ro option."
21451 msgstr ""
21452
21453 #. type: textblock
21454 #: ../rescue/virt-rescue.pod:47
21455 msgid ""
21456 "When you run virt-rescue on a virtual machine or disk image, you are placed "
21457 "in an interactive bash shell where you can use many ordinary Linux "
21458 "commands.  What you see in C</> (C</bin>, C</lib> etc) is the rescue "
21459 "appliance.  You must mount the virtual machine's filesystems by hand.  There "
21460 "is an empty directory called C</sysroot> where you can mount filesystems."
21461 msgstr ""
21462
21463 #. type: textblock
21464 #: ../rescue/virt-rescue.pod:54
21465 msgid ""
21466 "In the example below, we list logical volumes, then choose one to mount "
21467 "under C</sysroot>:"
21468 msgstr ""
21469
21470 #. type: verbatim
21471 #: ../rescue/virt-rescue.pod:57
21472 #, no-wrap
21473 msgid ""
21474 " ><rescue> lvs\n"
21475 " LV      VG        Attr   LSize   Origin Snap%  Move Log Copy%  Convert\n"
21476 " lv_root vg_f11x64 -wi-a-   8.83G\n"
21477 " lv_swap vg_f11x64 -wi-a- 992.00M\n"
21478 " ><rescue> mount /dev/vg_f11x64/lv_root /sysroot\n"
21479 " ><rescue> ls /sysroot\n"
21480 "\n"
21481 msgstr ""
21482
21483 #. type: textblock
21484 #: ../rescue/virt-rescue.pod:64
21485 msgid ""
21486 "If you don't know what filesystems are available on the virtual machine then "
21487 "you can use commands such as L<parted(8)> and L<lvs(8)> to find out."
21488 msgstr ""
21489
21490 #. type: textblock
21491 #: ../rescue/virt-rescue.pod:70
21492 msgid ""
21493 "Virt-rescue can be used on I<any> disk image file or device, not just a "
21494 "virtual machine.  For example you can use it on a blank file if you want to "
21495 "partition that file (although we would recommend using L<guestfish(1)> "
21496 "instead as it is more suitable for this purpose).  You can even use virt-"
21497 "rescue on things like SD cards."
21498 msgstr ""
21499
21500 #. type: textblock
21501 #: ../rescue/virt-rescue.pod:76
21502 msgid ""
21503 "Virt-rescue does not require root.  You only need to run it as root if you "
21504 "need root to open the disk image."
21505 msgstr ""
21506
21507 #. type: textblock
21508 #: ../rescue/virt-rescue.pod:79
21509 msgid ""
21510 "This tool is just designed for quick interactive hacking on a virtual "
21511 "machine.  For more structured access to a virtual machine disk image, you "
21512 "should use L<guestfs(3)>.  To get a structured shell that you can use to "
21513 "make scripted changes to guests, use L<guestfish(1)>."
21514 msgstr ""
21515
21516 #. type: =item
21517 #: ../rescue/virt-rescue.pod:103
21518 msgid "B<--append kernelopts>"
21519 msgstr ""
21520
21521 #. type: textblock
21522 #: ../rescue/virt-rescue.pod:105
21523 msgid "Pass additional options to the rescue kernel."
21524 msgstr ""
21525
21526 #. type: verbatim
21527 #: ../rescue/virt-rescue.pod:135
21528 #, fuzzy, no-wrap
21529 #| msgid ""
21530 #| " guestfish --format=raw -a disk.img\n"
21531 #| "\n"
21532 msgid ""
21533 " virt-rescue --format=raw -a disk.img\n"
21534 "\n"
21535 msgstr ""
21536 " guestfish --format=raw -a disk.img\n"
21537 "\n"
21538
21539 #. type: verbatim
21540 #: ../rescue/virt-rescue.pod:139
21541 #, fuzzy, no-wrap
21542 #| msgid ""
21543 #| " guestfish --format=raw -a disk.img --format -a another.img\n"
21544 #| "\n"
21545 msgid ""
21546 " virt-rescue --format=raw -a disk.img --format -a another.img\n"
21547 "\n"
21548 msgstr ""
21549 " guestfish --format=raw -a disk.img --format -a another.img\n"
21550 "\n"
21551
21552 #. type: =item
21553 #: ../rescue/virt-rescue.pod:148
21554 msgid "B<-m MB>"
21555 msgstr ""
21556
21557 #. type: =item
21558 #: ../rescue/virt-rescue.pod:150
21559 #, fuzzy
21560 #| msgid "B<--merge>"
21561 msgid "B<--memsize MB>"
21562 msgstr "B<--merge>"
21563
21564 #. type: textblock
21565 #: ../rescue/virt-rescue.pod:152
21566 msgid ""
21567 "Change the amount of memory allocated to the rescue system.  The default is "
21568 "set by libguestfs and is small but adequate for running system tools.  The "
21569 "occasional program might need more memory.  The parameter is specified in "
21570 "megabytes."
21571 msgstr ""
21572
21573 #. type: =item
21574 #: ../rescue/virt-rescue.pod:157
21575 #, fuzzy
21576 #| msgid "B<--inspector>"
21577 msgid "B<--network>"
21578 msgstr "B<--inspector>"
21579
21580 #. type: textblock
21581 #: ../rescue/virt-rescue.pod:159
21582 msgid "Enable QEMU user networking in the guest.  See L</NETWORK>."
21583 msgstr ""
21584
21585 #. type: textblock
21586 #: ../rescue/virt-rescue.pod:165
21587 msgid "Open the image read-only."
21588 msgstr ""
21589
21590 #. type: textblock
21591 #: ../rescue/virt-rescue.pod:175
21592 msgid ""
21593 "Enable SELinux in the rescue appliance.  You should read L<guestfs(3)/"
21594 "SELINUX> before using this option."
21595 msgstr ""
21596
21597 #. type: textblock
21598 #: ../rescue/virt-rescue.pod:194
21599 msgid ""
21600 "This changes the I<-a> and I<-d> options so that disks are added and mounts "
21601 "are done read-write."
21602 msgstr ""
21603
21604 #. type: textblock
21605 #: ../rescue/virt-rescue.pod:207
21606 msgid "Previous versions of virt-rescue allowed you to write either:"
21607 msgstr ""
21608
21609 #. type: verbatim
21610 #: ../rescue/virt-rescue.pod:209
21611 #, fuzzy, no-wrap
21612 #| msgid ""
21613 #| " virt-list-partitions [--options] disk.img [disk.img ...]\n"
21614 #| "\n"
21615 msgid ""
21616 " virt-rescue disk.img [disk.img ...]\n"
21617 "\n"
21618 msgstr ""
21619 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
21620 "\n"
21621
21622 #. type: verbatim
21623 #: ../rescue/virt-rescue.pod:213
21624 #, fuzzy, no-wrap
21625 #| msgid ""
21626 #| " file-architecture filename\n"
21627 #| "\n"
21628 msgid ""
21629 " virt-rescue guestname\n"
21630 "\n"
21631 msgstr ""
21632 " file-architecture назва_файла\n"
21633 "\n"
21634
21635 #. type: =head1
21636 #: ../rescue/virt-rescue.pod:221
21637 msgid "NETWORK"
21638 msgstr ""
21639
21640 #. type: textblock
21641 #: ../rescue/virt-rescue.pod:223
21642 msgid ""
21643 "Adding the I<--network> option enables QEMU user networking in the rescue "
21644 "appliance.  There are some differences between user networking and ordinary "
21645 "networking:"
21646 msgstr ""
21647
21648 #. type: =item
21649 #: ../rescue/virt-rescue.pod:229
21650 msgid "ping does not work"
21651 msgstr ""
21652
21653 #. type: textblock
21654 #: ../rescue/virt-rescue.pod:231
21655 msgid ""
21656 "Because the ICMP ECHO_REQUEST protocol generally requires root in order to "
21657 "send the ping packets, and because virt-rescue must be able to run as non-"
21658 "root, QEMU user networking is not able to emulate the L<ping(8)> command.  "
21659 "The ping command will appear to resolve addresses but will not be able to "
21660 "send or receive any packets.  This does not mean that the network is not "
21661 "working."
21662 msgstr ""
21663
21664 #. type: =item
21665 #: ../rescue/virt-rescue.pod:238
21666 msgid "cannot receive connections"
21667 msgstr ""
21668
21669 #. type: textblock
21670 #: ../rescue/virt-rescue.pod:240
21671 msgid "QEMU user networking cannot receive incoming connections."
21672 msgstr ""
21673
21674 #. type: =item
21675 #: ../rescue/virt-rescue.pod:242
21676 msgid "making TCP connections"
21677 msgstr ""
21678
21679 #. type: textblock
21680 #: ../rescue/virt-rescue.pod:244
21681 msgid ""
21682 "The virt-rescue appliance needs to be small and so does not include many "
21683 "network tools.  In particular there is no L<telnet(1)> command.  You can "
21684 "make TCP connections from the shell using the magical C</dev/tcp/"
21685 "E<lt>hostnameE<gt>/E<lt>portE<gt>> syntax:"
21686 msgstr ""
21687
21688 #. type: verbatim
21689 #: ../rescue/virt-rescue.pod:249
21690 #, no-wrap
21691 msgid ""
21692 " exec 3<>/dev/tcp/redhat.com/80\n"
21693 " echo \"GET /\" >&3\n"
21694 " cat <&3\n"
21695 "\n"
21696 msgstr ""
21697
21698 #. type: textblock
21699 #: ../rescue/virt-rescue.pod:253
21700 msgid "See L<bash(1)> for more details."
21701 msgstr ""
21702
21703 #. type: textblock
21704 #: ../rescue/virt-rescue.pod:259
21705 msgid ""
21706 "Several environment variables affect virt-rescue.  See L<guestfs(3)/"
21707 "ENVIRONMENT VARIABLES> for the complete list."
21708 msgstr ""
21709
21710 #. type: textblock
21711 #: ../rescue/virt-rescue.pod:286
21712 #, fuzzy
21713 #| msgid ""
21714 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21715 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
21716 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21717 msgid ""
21718 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<http://"
21719 "libguestfs.org/>."
21720 msgstr ""
21721 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
21722 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
21723 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
21724
21725 #. type: textblock
21726 #: ../resize/virt-resize.pod:5
21727 msgid "virt-resize - Resize a virtual machine disk"
21728 msgstr ""
21729
21730 #. type: verbatim
21731 #: ../resize/virt-resize.pod:9
21732 #, no-wrap
21733 msgid ""
21734 " virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n"
21735 "   [--expand /dev/sdaN] [--shrink /dev/sdaN]\n"
21736 "   [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n"
21737 "\n"
21738 msgstr ""
21739
21740 #. type: textblock
21741 #: ../resize/virt-resize.pod:15
21742 msgid ""
21743 "Virt-resize is a tool which can resize a virtual machine disk, making it "
21744 "larger or smaller overall, and resizing or deleting any partitions contained "
21745 "within."
21746 msgstr ""
21747
21748 #. type: textblock
21749 #: ../resize/virt-resize.pod:19
21750 msgid ""
21751 "Virt-resize B<cannot> resize disk images in-place.  Virt-resize B<should "
21752 "not> be used on live virtual machines - for consistent results, shut the "
21753 "virtual machine down before resizing it."
21754 msgstr ""
21755
21756 #. type: textblock
21757 #: ../resize/virt-resize.pod:23
21758 msgid ""
21759 "If you are not familiar with the associated tools: L<virt-filesystems(1)> "
21760 "and L<virt-df(1)>, we recommend you go and read those manual pages first."
21761 msgstr ""
21762
21763 #. type: =item
21764 #: ../resize/virt-resize.pod:31 ../src/guestfs.pod:469 ../src/guestfs.pod:1257
21765 #: ../src/guestfs.pod:1395 ../src/guestfs.pod:2465
21766 msgid "1."
21767 msgstr "1."
21768
21769 #. type: textblock
21770 #: ../resize/virt-resize.pod:33
21771 msgid ""
21772 "Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to "
21773 "fill the extra 5GB of space."
21774 msgstr ""
21775
21776 #. type: verbatim
21777 #: ../resize/virt-resize.pod:36
21778 #, no-wrap
21779 msgid ""
21780 " virt-filesystems --long -h --all -a olddisk\n"
21781 " \n"
21782 msgstr ""
21783
21784 #. type: verbatim
21785 #: ../resize/virt-resize.pod:38
21786 #, no-wrap
21787 msgid ""
21788 " truncate -r olddisk newdisk\n"
21789 " truncate -s +5G newdisk\n"
21790 " \n"
21791 msgstr ""
21792
21793 #. type: verbatim
21794 #: ../resize/virt-resize.pod:41
21795 #, no-wrap
21796 msgid ""
21797 " # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
21798 " virt-resize --expand /dev/sda2 olddisk newdisk\n"
21799 "\n"
21800 msgstr ""
21801
21802 #. type: =item
21803 #: ../resize/virt-resize.pod:44 ../src/guestfs.pod:475 ../src/guestfs.pod:1261
21804 #: ../src/guestfs.pod:1399 ../src/guestfs.pod:2490
21805 msgid "2."
21806 msgstr "2."
21807
21808 #. type: textblock
21809 #: ../resize/virt-resize.pod:46
21810 msgid ""
21811 "As above, but make the /boot partition 200MB bigger, while giving the "
21812 "remaining space to /dev/sda2:"
21813 msgstr ""
21814
21815 #. type: verbatim
21816 #: ../resize/virt-resize.pod:49
21817 #, no-wrap
21818 msgid ""
21819 " virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
21820 "   olddisk newdisk\n"
21821 "\n"
21822 msgstr ""
21823
21824 #. type: =item
21825 #: ../resize/virt-resize.pod:52 ../src/guestfs.pod:486 ../src/guestfs.pod:1405
21826 msgid "3."
21827 msgstr "3."
21828
21829 #. type: textblock
21830 #: ../resize/virt-resize.pod:54
21831 msgid ""
21832 "As in the first example, but expand a logical volume as the final step.  "
21833 "This is what you would typically use for Linux guests that use LVM:"
21834 msgstr ""
21835
21836 #. type: verbatim
21837 #: ../resize/virt-resize.pod:58
21838 #, no-wrap
21839 msgid ""
21840 " virt-resize --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root \\\n"
21841 "   olddisk newdisk\n"
21842 "\n"
21843 msgstr ""
21844
21845 #. type: =item
21846 #: ../resize/virt-resize.pod:61
21847 msgid "4."
21848 msgstr ""
21849
21850 #. type: textblock
21851 #: ../resize/virt-resize.pod:63
21852 msgid ""
21853 "As in the first example, but the output format will be qcow2 instead of a "
21854 "raw disk:"
21855 msgstr ""
21856
21857 #. type: verbatim
21858 #: ../resize/virt-resize.pod:66
21859 #, no-wrap
21860 msgid ""
21861 " qemu-img create -f qcow2 newdisk.qcow2 15G\n"
21862 " virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
21863 "\n"
21864 msgstr ""
21865
21866 #. type: =head1
21867 #: ../resize/virt-resize.pod:71
21868 msgid "DETAILED USAGE"
21869 msgstr ""
21870
21871 #. type: =head2
21872 #: ../resize/virt-resize.pod:73
21873 msgid "EXPANDING A VIRTUAL MACHINE DISK"
21874 msgstr ""
21875
21876 #. type: =item
21877 #: ../resize/virt-resize.pod:77
21878 msgid "1. Shut down the virtual machine"
21879 msgstr ""
21880
21881 #. type: =item
21882 #: ../resize/virt-resize.pod:79
21883 msgid "2. Locate input disk image"
21884 msgstr ""
21885
21886 #. type: textblock
21887 #: ../resize/virt-resize.pod:81
21888 msgid ""
21889 "Locate the input disk image (ie. the file or device on the host containing "
21890 "the guest's disk).  If the guest is managed by libvirt, you can use C<virsh "
21891 "dumpxml> like this to find the disk image name:"
21892 msgstr ""
21893
21894 #. type: verbatim
21895 #: ../resize/virt-resize.pod:85
21896 #, no-wrap
21897 msgid ""
21898 " # virsh dumpxml guestname | xpath /domain/devices/disk/source\n"
21899 " Found 1 nodes:\n"
21900 " -- NODE --\n"
21901 " <source dev=\"/dev/vg/lv_guest\" />\n"
21902 "\n"
21903 msgstr ""
21904
21905 #. type: =item
21906 #: ../resize/virt-resize.pod:90
21907 msgid "3. Look at current sizing"
21908 msgstr ""
21909
21910 #. type: textblock
21911 #: ../resize/virt-resize.pod:92
21912 msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
21913 msgstr ""
21914
21915 #. type: verbatim
21916 #: ../resize/virt-resize.pod:95
21917 #, no-wrap
21918 msgid ""
21919 " # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n"
21920 " Name       Type       Size  Parent\n"
21921 " /dev/sda1  partition  101M  /dev/sda\n"
21922 " /dev/sda2  partition  7.9G  /dev/sda\n"
21923 " /dev/sda   device     8.0G  -\n"
21924 "\n"
21925 msgstr ""
21926
21927 #. type: textblock
21928 #: ../resize/virt-resize.pod:101
21929 msgid ""
21930 "(This example is a virtual machine with an 8 GB disk which we would like to "
21931 "expand up to 10 GB)."
21932 msgstr ""
21933
21934 #. type: =item
21935 #: ../resize/virt-resize.pod:104
21936 msgid "4. Create output disk"
21937 msgstr ""
21938
21939 #. type: textblock
21940 #: ../resize/virt-resize.pod:106
21941 msgid ""
21942 "Virt-resize cannot do in-place disk modifications.  You have to have space "
21943 "to store the resized output disk."
21944 msgstr ""
21945
21946 #. type: textblock
21947 #: ../resize/virt-resize.pod:109
21948 msgid ""
21949 "To store the resized disk image in a file, create a file of a suitable size:"
21950 msgstr ""
21951
21952 #. type: verbatim
21953 #: ../resize/virt-resize.pod:112
21954 #, no-wrap
21955 msgid ""
21956 " # rm -f outdisk\n"
21957 " # truncate -s 10G outdisk\n"
21958 "\n"
21959 msgstr ""
21960
21961 #. type: textblock
21962 #: ../resize/virt-resize.pod:115
21963 msgid "Or use L<lvcreate(1)> to create a logical volume:"
21964 msgstr ""
21965
21966 #. type: verbatim
21967 #: ../resize/virt-resize.pod:117
21968 #, no-wrap
21969 msgid ""
21970 " # lvcreate -L 10G -n lv_name vg_name\n"
21971 "\n"
21972 msgstr ""
21973
21974 #. type: textblock
21975 #: ../resize/virt-resize.pod:119
21976 msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
21977 msgstr ""
21978
21979 #. type: verbatim
21980 #: ../resize/virt-resize.pod:121
21981 #, no-wrap
21982 msgid ""
21983 " # virsh pool-list\n"
21984 " # virsh vol-create-as poolname newvol 10G\n"
21985 "\n"
21986 msgstr ""
21987
21988 #. type: =item
21989 #: ../resize/virt-resize.pod:124
21990 msgid "5. Resize"
21991 msgstr ""
21992
21993 #. type: textblock
21994 #: ../resize/virt-resize.pod:126
21995 msgid ""
21996 "virt-resize takes two mandatory parameters, the input disk (eg. device or "
21997 "file) and the output disk.  The output disk is the one created in the "
21998 "previous step."
21999 msgstr ""
22000
22001 #. type: verbatim
22002 #: ../resize/virt-resize.pod:130
22003 #, no-wrap
22004 msgid ""
22005 " # virt-resize indisk outdisk\n"
22006 "\n"
22007 msgstr ""
22008
22009 #. type: textblock
22010 #: ../resize/virt-resize.pod:132
22011 msgid ""
22012 "This command just copies disk image C<indisk> to disk image C<outdisk> "
22013 "I<without> resizing or changing any existing partitions.  If C<outdisk> is "
22014 "larger, then an extra, empty partition is created at the end of the disk "
22015 "covering the extra space.  If C<outdisk> is smaller, then it will give an "
22016 "error."
22017 msgstr ""
22018
22019 #. type: textblock
22020 #: ../resize/virt-resize.pod:138
22021 msgid ""
22022 "More realistically you'd want to expand existing partitions in the disk "
22023 "image by passing extra options (for the full list see the L</OPTIONS> "
22024 "section below)."
22025 msgstr ""
22026
22027 #. type: textblock
22028 #: ../resize/virt-resize.pod:142
22029 msgid ""
22030 "L</--expand> is the most useful option.  It expands the named partition "
22031 "within the disk to fill any extra space:"
22032 msgstr ""
22033
22034 #. type: verbatim
22035 #: ../resize/virt-resize.pod:145
22036 #, no-wrap
22037 msgid ""
22038 " # virt-resize --expand /dev/sda2 indisk outdisk\n"
22039 "\n"
22040 msgstr ""
22041
22042 #. type: textblock
22043 #: ../resize/virt-resize.pod:147
22044 msgid ""
22045 "(In this case, an extra partition is I<not> created at the end of the disk, "
22046 "because there will be no unused space)."
22047 msgstr ""
22048
22049 #. type: textblock
22050 #: ../resize/virt-resize.pod:150
22051 msgid ""
22052 "L</--resize> is the other commonly used option.  The following would "
22053 "increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the "
22054 "rest of the available space:"
22055 msgstr ""
22056
22057 #. type: verbatim
22058 #: ../resize/virt-resize.pod:154
22059 #, no-wrap
22060 msgid ""
22061 " # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
22062 "     indisk outdisk\n"
22063 "\n"
22064 msgstr ""
22065
22066 #. type: textblock
22067 #: ../resize/virt-resize.pod:157
22068 msgid ""
22069 "If the expanded partition in the image contains a filesystem or LVM PV, then "
22070 "if virt-resize knows how, it will resize the contents, the equivalent of "
22071 "calling a command such as L<pvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)> "
22072 "or L<btrfs(8)>.  However virt-resize does not know how to resize some "
22073 "filesystems, so you would have to online resize them after booting the guest."
22074 msgstr ""
22075
22076 #. type: textblock
22077 #: ../resize/virt-resize.pod:164
22078 msgid "Other options are covered below."
22079 msgstr ""
22080
22081 #. type: =item
22082 #: ../resize/virt-resize.pod:166
22083 msgid "6. Test"
22084 msgstr ""
22085
22086 #. type: textblock
22087 #: ../resize/virt-resize.pod:168
22088 msgid "Thoroughly test the new disk image I<before> discarding the old one."
22089 msgstr ""
22090
22091 #. type: textblock
22092 #: ../resize/virt-resize.pod:170
22093 msgid "If you are using libvirt, edit the XML to point at the new disk:"
22094 msgstr ""
22095
22096 #. type: verbatim
22097 #: ../resize/virt-resize.pod:172
22098 #, fuzzy, no-wrap
22099 #| msgid ""
22100 #| " edit filename\n"
22101 #| "\n"
22102 msgid ""
22103 " # virsh edit guestname\n"
22104 "\n"
22105 msgstr ""
22106 " edit назва_файла\n"
22107 "\n"
22108
22109 #. type: textblock
22110 #: ../resize/virt-resize.pod:174
22111 msgid ""
22112 "Change E<lt>source ...E<gt>, see L<http://libvirt.org/formatdomain."
22113 "html#elementsDisks>"
22114 msgstr ""
22115
22116 #. type: textblock
22117 #: ../resize/virt-resize.pod:177
22118 msgid "Then start up the domain with the new, resized disk:"
22119 msgstr ""
22120
22121 #. type: verbatim
22122 #: ../resize/virt-resize.pod:179
22123 #, fuzzy, no-wrap
22124 #| msgid ""
22125 #| " ln-s target linkname\n"
22126 #| "\n"
22127 msgid ""
22128 " # virsh start guestname\n"
22129 "\n"
22130 msgstr ""
22131 " ln-s призначення назва_посилання\n"
22132 "\n"
22133
22134 #. type: textblock
22135 #: ../resize/virt-resize.pod:181
22136 msgid ""
22137 "and check that it still works.  See also the L</NOTES> section below for "
22138 "additional information."
22139 msgstr ""
22140
22141 #. type: =item
22142 #: ../resize/virt-resize.pod:184
22143 msgid "7. Resize LVs etc inside the guest"
22144 msgstr ""
22145
22146 #. type: textblock
22147 #: ../resize/virt-resize.pod:186
22148 msgid "(This can also be done offline using L<guestfish(1)>)"
22149 msgstr ""
22150
22151 #. type: textblock
22152 #: ../resize/virt-resize.pod:188
22153 msgid ""
22154 "Once the guest has booted you should see the new space available, at least "
22155 "for filesystems that virt-resize knows how to resize, and for PVs.  The user "
22156 "may need to resize LVs inside PVs, and also resize filesystem types that "
22157 "virt-resize does not know how to expand."
22158 msgstr ""
22159
22160 #. type: =head2
22161 #: ../resize/virt-resize.pod:195
22162 msgid "SHRINKING A VIRTUAL MACHINE DISK"
22163 msgstr ""
22164
22165 #. type: textblock
22166 #: ../resize/virt-resize.pod:197
22167 msgid ""
22168 "Shrinking is somewhat more complex than expanding, and only an overview is "
22169 "given here."
22170 msgstr ""
22171
22172 #. type: textblock
22173 #: ../resize/virt-resize.pod:200
22174 msgid ""
22175 "Firstly virt-resize will not attempt to shrink any partition content (PVs, "
22176 "filesystems).  The user has to shrink content before passing the disk image "
22177 "to virt-resize, and virt-resize will check that the content has been shrunk "
22178 "properly."
22179 msgstr ""
22180
22181 #. type: textblock
22182 #: ../resize/virt-resize.pod:205
22183 msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
22184 msgstr ""
22185
22186 #. type: textblock
22187 #: ../resize/virt-resize.pod:207
22188 msgid ""
22189 "After shrinking PVs and filesystems, shut down the guest, and proceed with "
22190 "steps 3 and 4 above to allocate a new disk image."
22191 msgstr ""
22192
22193 #. type: textblock
22194 #: ../resize/virt-resize.pod:210
22195 msgid ""
22196 "Then run virt-resize with any of the I<--shrink> and/or I<--resize> options."
22197 msgstr ""
22198
22199 #. type: =head2
22200 #: ../resize/virt-resize.pod:213
22201 msgid "IGNORING OR DELETING PARTITIONS"
22202 msgstr ""
22203
22204 #. type: textblock
22205 #: ../resize/virt-resize.pod:215
22206 msgid ""
22207 "virt-resize also gives a convenient way to ignore or delete partitions when "
22208 "copying from the input disk to the output disk.  Ignoring a partition speeds "
22209 "up the copy where you don't care about the existing contents of a "
22210 "partition.  Deleting a partition removes it completely, but note that it "
22211 "also renumbers any partitions after the one which is deleted, which can "
22212 "leave some guests unbootable."
22213 msgstr ""
22214
22215 #. type: =head2
22216 #: ../resize/virt-resize.pod:222
22217 msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
22218 msgstr ""
22219
22220 #. type: textblock
22221 #: ../resize/virt-resize.pod:224
22222 msgid ""
22223 "If the input disk is in qcow2 format, then you may prefer that the output is "
22224 "in qcow2 format as well.  Alternately, virt-resize can convert the format on "
22225 "the fly.  The output format is simply determined by the format of the empty "
22226 "output container that you provide.  Thus to create qcow2 output, use:"
22227 msgstr ""
22228
22229 #. type: verbatim
22230 #: ../resize/virt-resize.pod:230
22231 #, no-wrap
22232 msgid ""
22233 " qemu-img create [-c] -f qcow2 outdisk [size]\n"
22234 "\n"
22235 msgstr ""
22236
22237 #. type: textblock
22238 #: ../resize/virt-resize.pod:232
22239 msgid "instead of the truncate command (use I<-c> for a compressed disk)."
22240 msgstr ""
22241
22242 #. type: textblock
22243 #: ../resize/virt-resize.pod:234
22244 msgid "Similarly, to get non-sparse raw output use:"
22245 msgstr ""
22246
22247 #. type: verbatim
22248 #: ../resize/virt-resize.pod:236
22249 #, fuzzy, no-wrap
22250 #| msgid ""
22251 #| " fallocate path len\n"
22252 #| "\n"
22253 msgid ""
22254 " fallocate -l size outdisk\n"
22255 "\n"
22256 msgstr ""
22257 " fallocate шлях довжина\n"
22258 "\n"
22259
22260 #. type: textblock
22261 #: ../resize/virt-resize.pod:238
22262 msgid ""
22263 "(on older systems that don't have the L<fallocate(1)> command use C<dd if=/"
22264 "dev/zero of=outdisk bs=1M count=..>)"
22265 msgstr ""
22266
22267 #. type: textblock
22268 #: ../resize/virt-resize.pod:247
22269 msgid "Display help."
22270 msgstr ""
22271
22272 #. type: =item
22273 #: ../resize/virt-resize.pod:249
22274 msgid "B<-d>"
22275 msgstr ""
22276
22277 #. type: =item
22278 #: ../resize/virt-resize.pod:251 ../tools/virt-make-fs.pl:177
22279 #: ../tools/virt-win-reg.pl:120
22280 msgid "B<--debug>"
22281 msgstr "B<--debug>"
22282
22283 #. type: textblock
22284 #: ../resize/virt-resize.pod:253 ../tools/virt-win-reg.pl:122
22285 msgid "Enable debugging messages."
22286 msgstr ""
22287
22288 #. type: =item
22289 #: ../resize/virt-resize.pod:255
22290 #, fuzzy
22291 #| msgid "B<--no-dest-paths>"
22292 msgid "B<--delete part>"
22293 msgstr "B<--no-dest-paths>"
22294
22295 #. type: textblock
22296 #: ../resize/virt-resize.pod:257
22297 msgid ""
22298 "Delete the named partition.  It would be more accurate to describe this as "
22299 "\"don't copy it over\", since virt-resize doesn't do in-place changes and "
22300 "the original disk image is left intact."
22301 msgstr ""
22302
22303 #. type: textblock
22304 #: ../resize/virt-resize.pod:261
22305 msgid ""
22306 "Note that when you delete a partition, then anything contained in the "
22307 "partition is also deleted.  Furthermore, this causes any partitions that "
22308 "come after to be I<renumbered>, which can easily make your guest unbootable."
22309 msgstr ""
22310
22311 #. type: textblock
22312 #: ../resize/virt-resize.pod:266 ../resize/virt-resize.pod:327
22313 #: ../resize/virt-resize.pod:454
22314 msgid "You can give this option multiple times."
22315 msgstr ""
22316
22317 #. type: =item
22318 #: ../resize/virt-resize.pod:268
22319 #, fuzzy
22320 #| msgid "B<--partition>"
22321 msgid "B<--expand part>"
22322 msgstr "B<--partition>"
22323
22324 #. type: textblock
22325 #: ../resize/virt-resize.pod:270
22326 msgid ""
22327 "Expand the named partition so it uses up all extra space (space left over "
22328 "after any other resize changes that you request have been done)."
22329 msgstr ""
22330
22331 #. type: textblock
22332 #: ../resize/virt-resize.pod:273
22333 msgid ""
22334 "If virt-resize knows how, it will expand the direct content of the "
22335 "partition.  For example, if the partition is an LVM PV, it will expand the "
22336 "PV to fit (like calling L<pvresize(8)>).  Virt-resize leaves any other "
22337 "content it doesn't know about alone."
22338 msgstr ""
22339
22340 #. type: textblock
22341 #: ../resize/virt-resize.pod:278
22342 msgid "Currently virt-resize can resize:"
22343 msgstr ""
22344
22345 #. type: textblock
22346 #: ../resize/virt-resize.pod:284
22347 msgid "ext2, ext3 and ext4 filesystems."
22348 msgstr ""
22349
22350 #. type: textblock
22351 #: ../resize/virt-resize.pod:288
22352 msgid "NTFS filesystems, if libguestfs was compiled with support for NTFS."
22353 msgstr ""
22354
22355 #. type: textblock
22356 #: ../resize/virt-resize.pod:290
22357 msgid ""
22358 "The filesystem must have been shut down consistently last time it was used.  "
22359 "Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a "
22360 "consistency check, so at the first boot after resizing Windows will check "
22361 "the disk."
22362 msgstr ""
22363
22364 #. type: textblock
22365 #: ../resize/virt-resize.pod:297
22366 msgid ""
22367 "LVM PVs (physical volumes).  virt-resize does not usually resize anything "
22368 "inside the PV, but see the I<--LV-expand> option.  The user could also "
22369 "resize LVs as desired after boot."
22370 msgstr ""
22371
22372 #. type: textblock
22373 #: ../resize/virt-resize.pod:303
22374 msgid "Btrfs filesystems, if libguestfs was compiled with support for btrfs."
22375 msgstr ""
22376
22377 #. type: textblock
22378 #: ../resize/virt-resize.pod:307 ../resize/virt-resize.pod:482
22379 msgid "Note that you cannot use I<--expand> and I<--shrink> together."
22380 msgstr ""
22381
22382 #. type: =item
22383 #: ../resize/virt-resize.pod:309 ../tools/virt-list-filesystems.pl:91
22384 #: ../tools/virt-list-partitions.pl:92 ../tools/virt-tar.pl:141
22385 #: ../tools/virt-win-reg.pl:142
22386 msgid "B<--format> raw"
22387 msgstr ""
22388
22389 #. type: textblock
22390 #: ../resize/virt-resize.pod:311
22391 msgid ""
22392 "Specify the format of the input disk image.  If this flag is not given then "
22393 "it is auto-detected from the image itself."
22394 msgstr ""
22395
22396 #. type: textblock
22397 #: ../resize/virt-resize.pod:317
22398 msgid ""
22399 "Note that this option I<does not> affect the output format.  See L</QCOW2 "
22400 "AND NON-SPARSE RAW FORMATS>."
22401 msgstr ""
22402
22403 #. type: =item
22404 #: ../resize/virt-resize.pod:320
22405 #, fuzzy
22406 #| msgid "B<--format>"
22407 msgid "B<--ignore part>"
22408 msgstr "B<--format>"
22409
22410 #. type: textblock
22411 #: ../resize/virt-resize.pod:322
22412 msgid ""
22413 "Ignore the named partition.  Effectively this means the partition is "
22414 "allocated on the destination disk, but the content is not copied across from "
22415 "the source disk.  The content of the partition will be blank (all zero "
22416 "bytes)."
22417 msgstr ""
22418
22419 #. type: =item
22420 #: ../resize/virt-resize.pod:329
22421 msgid "B<--LV-expand logvol>"
22422 msgstr ""
22423
22424 #. type: textblock
22425 #: ../resize/virt-resize.pod:331
22426 msgid ""
22427 "This takes the logical volume and, as a final step, expands it to fill all "
22428 "the space available in its volume group.  A typical usage, assuming a Linux "
22429 "guest with a single PV C</dev/sda2> and a root device called C</dev/vg_guest/"
22430 "lv_root> would be:"
22431 msgstr ""
22432
22433 #. type: verbatim
22434 #: ../resize/virt-resize.pod:336
22435 #, no-wrap
22436 msgid ""
22437 " virt-resize indisk outdisk \\\n"
22438 "   --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
22439 "\n"
22440 msgstr ""
22441
22442 #. type: textblock
22443 #: ../resize/virt-resize.pod:339
22444 msgid ""
22445 "This would first expand the partition (and PV), and then expand the root "
22446 "device to fill the extra space in the PV."
22447 msgstr ""
22448
22449 #. type: textblock
22450 #: ../resize/virt-resize.pod:342
22451 msgid ""
22452 "The contents of the LV are also resized if virt-resize knows how to do "
22453 "that.  You can stop virt-resize from trying to expand the content by using "
22454 "the option I<--no-expand-content>."
22455 msgstr ""
22456
22457 #. type: textblock
22458 #: ../resize/virt-resize.pod:346
22459 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
22460 msgstr ""
22461
22462 #. type: textblock
22463 #: ../resize/virt-resize.pod:348
22464 msgid ""
22465 "You can give this option multiple times, I<but> it doesn't make sense to do "
22466 "this unless the logical volumes you specify are all in different volume "
22467 "groups."
22468 msgstr ""
22469
22470 #. type: =item
22471 #: ../resize/virt-resize.pod:352
22472 #, fuzzy
22473 #| msgid "B<-h> | B<--human-readable>"
22474 msgid "B<--machine-readable>"
22475 msgstr "B<-h> | B<--human-readable>"
22476
22477 #. type: textblock
22478 #: ../resize/virt-resize.pod:354
22479 msgid ""
22480 "This option is used to make the output more machine friendly when being "
22481 "parsed by other programs.  See L</MACHINE READABLE OUTPUT> below."
22482 msgstr ""
22483
22484 #. type: =item
22485 #: ../resize/virt-resize.pod:360
22486 #, fuzzy
22487 #| msgid "B<--debug>"
22488 msgid "B<--dryrun>"
22489 msgstr "B<--debug>"
22490
22491 #. type: textblock
22492 #: ../resize/virt-resize.pod:362
22493 msgid "Print a summary of what would be done, but don't do anything."
22494 msgstr ""
22495
22496 #. type: =item
22497 #: ../resize/virt-resize.pod:364
22498 msgid "B<--no-copy-boot-loader>"
22499 msgstr ""
22500
22501 #. type: textblock
22502 #: ../resize/virt-resize.pod:366
22503 msgid ""
22504 "By default, virt-resize copies over some sectors at the start of the disk "
22505 "(up to the beginning of the first partition).  Commonly these sectors "
22506 "contain the Master Boot Record (MBR) and the boot loader, and are required "
22507 "in order for the guest to boot correctly."
22508 msgstr ""
22509
22510 #. type: textblock
22511 #: ../resize/virt-resize.pod:371
22512 msgid ""
22513 "If you specify this flag, then this initial copy is not done.  You may need "
22514 "to reinstall the boot loader in this case."
22515 msgstr ""
22516
22517 #. type: =item
22518 #: ../resize/virt-resize.pod:374
22519 #, fuzzy
22520 #| msgid "B<--partition>"
22521 msgid "B<--no-extra-partition>"
22522 msgstr "B<--partition>"
22523
22524 #. type: textblock
22525 #: ../resize/virt-resize.pod:376
22526 msgid ""
22527 "By default, virt-resize creates an extra partition if there is any extra, "
22528 "unused space after all resizing has happened.  Use this option to prevent "
22529 "the extra partition from being created.  If you do this then the extra space "
22530 "will be inaccessible until you run fdisk, parted, or some other partitioning "
22531 "tool in the guest."
22532 msgstr ""
22533
22534 #. type: textblock
22535 #: ../resize/virt-resize.pod:382
22536 msgid ""
22537 "Note that if the surplus space is smaller than 10 MB, no extra partition "
22538 "will be created."
22539 msgstr ""
22540
22541 #. type: =item
22542 #: ../resize/virt-resize.pod:385
22543 #, fuzzy
22544 #| msgid "B<--no-dest-paths>"
22545 msgid "B<--no-expand-content>"
22546 msgstr "B<--no-dest-paths>"
22547
22548 #. type: textblock
22549 #: ../resize/virt-resize.pod:387
22550 msgid ""
22551 "By default, virt-resize will try to expand the direct contents of "
22552 "partitions, if it knows how (see I<--expand> option above)."
22553 msgstr ""
22554
22555 #. type: textblock
22556 #: ../resize/virt-resize.pod:390
22557 msgid ""
22558 "If you give the I<--no-expand-content> option then virt-resize will not "
22559 "attempt this."
22560 msgstr ""
22561
22562 #. type: =item
22563 #: ../resize/virt-resize.pod:393
22564 #, fuzzy
22565 #| msgid "ntfsresize-size"
22566 msgid "B<--ntfsresize-force>"
22567 msgstr "ntfsresize-size"
22568
22569 #. type: textblock
22570 #: ../resize/virt-resize.pod:395
22571 msgid ""
22572 "Pass the I<--force> option to L<ntfsresize(8)>, allowing resizing even if "
22573 "the NTFS disk is marked as needing a consistency check.  You have to use "
22574 "this option if you want to resize a Windows guest multiple times without "
22575 "booting into Windows between each resize."
22576 msgstr ""
22577
22578 #. type: =item
22579 #: ../resize/virt-resize.pod:401
22580 #, fuzzy
22581 #| msgid "B<--format>"
22582 msgid "B<--output-format> raw"
22583 msgstr "B<--format>"
22584
22585 #. type: textblock
22586 #: ../resize/virt-resize.pod:403
22587 msgid ""
22588 "Specify the format of the output disk image.  If this flag is not given then "
22589 "it is auto-detected from the image itself."
22590 msgstr ""
22591
22592 #. type: textblock
22593 #: ../resize/virt-resize.pod:409
22594 msgid ""
22595 "Note that this option I<does not create> the output format.  This option "
22596 "just tells libguestfs what it is so it doesn't try to guess it.  You still "
22597 "need to create the output disk with the right format.  See L</QCOW2 AND NON-"
22598 "SPARSE RAW FORMATS>."
22599 msgstr ""
22600
22601 #. type: =item
22602 #: ../resize/virt-resize.pod:414
22603 msgid "B<-q>"
22604 msgstr ""
22605
22606 #. type: =item
22607 #: ../resize/virt-resize.pod:416
22608 #, fuzzy
22609 #| msgid "B<--live>"
22610 msgid "B<--quiet>"
22611 msgstr "B<--live>"
22612
22613 #. type: textblock
22614 #: ../resize/virt-resize.pod:418
22615 msgid "Don't print the summary."
22616 msgstr ""
22617
22618 #. type: =item
22619 #: ../resize/virt-resize.pod:420
22620 #, fuzzy
22621 #| msgid "B<part_size>"
22622 msgid "B<--resize part=size>"
22623 msgstr "B<part_size>"
22624
22625 #. type: textblock
22626 #: ../resize/virt-resize.pod:422
22627 msgid ""
22628 "Resize the named partition (expanding or shrinking it) so that it has the "
22629 "given size."
22630 msgstr ""
22631
22632 #. type: textblock
22633 #: ../resize/virt-resize.pod:425
22634 msgid ""
22635 "C<size> can be expressed as an absolute number followed by b/K/M/G to mean "
22636 "bytes, Kilobytes, Megabytes, or Gigabytes; or as a percentage of the current "
22637 "size; or as a relative number or percentage.  For example:"
22638 msgstr ""
22639
22640 #. type: verbatim
22641 #: ../resize/virt-resize.pod:431
22642 #, fuzzy, no-wrap
22643 #| msgid ""
22644 #| " hexedit /dev/sda 1M\n"
22645 #| "\n"
22646 msgid ""
22647 " --resize /dev/sda2=10G\n"
22648 "\n"
22649 msgstr ""
22650 " hexedit /dev/sda 1M\n"
22651 "\n"
22652
22653 #. type: verbatim
22654 #: ../resize/virt-resize.pod:433
22655 #, fuzzy, no-wrap
22656 #| msgid ""
22657 #| " pvresize device\n"
22658 #| "\n"
22659 msgid ""
22660 " --resize /dev/sda4=90%\n"
22661 "\n"
22662 msgstr ""
22663 " pvresize пристрій\n"
22664 "\n"
22665
22666 #. type: verbatim
22667 #: ../resize/virt-resize.pod:435
22668 #, fuzzy, no-wrap
22669 #| msgid ""
22670 #| " hexedit /dev/sda 1M\n"
22671 #| "\n"
22672 msgid ""
22673 " --resize /dev/sda2=+1G\n"
22674 "\n"
22675 msgstr ""
22676 " hexedit /dev/sda 1M\n"
22677 "\n"
22678
22679 #. type: verbatim
22680 #: ../resize/virt-resize.pod:437
22681 #, fuzzy, no-wrap
22682 #| msgid ""
22683 #| " hexedit /dev/sda 1M\n"
22684 #| "\n"
22685 msgid ""
22686 " --resize /dev/sda2=-200M\n"
22687 "\n"
22688 msgstr ""
22689 " hexedit /dev/sda 1M\n"
22690 "\n"
22691
22692 #. type: verbatim
22693 #: ../resize/virt-resize.pod:439
22694 #, fuzzy, no-wrap
22695 #| msgid ""
22696 #| " hexedit /dev/sda 1M\n"
22697 #| "\n"
22698 msgid ""
22699 " --resize /dev/sda1=+128K\n"
22700 "\n"
22701 msgstr ""
22702 " hexedit /dev/sda 1M\n"
22703 "\n"
22704
22705 #. type: verbatim
22706 #: ../resize/virt-resize.pod:441
22707 #, fuzzy, no-wrap
22708 #| msgid ""
22709 #| " hexedit /dev/sda 1M\n"
22710 #| "\n"
22711 msgid ""
22712 " --resize /dev/sda1=+10%\n"
22713 "\n"
22714 msgstr ""
22715 " hexedit /dev/sda 1M\n"
22716 "\n"
22717
22718 #. type: verbatim
22719 #: ../resize/virt-resize.pod:443
22720 #, fuzzy, no-wrap
22721 #| msgid ""
22722 #| " hexedit /dev/sda 1M\n"
22723 #| "\n"
22724 msgid ""
22725 " --resize /dev/sda1=-10%\n"
22726 "\n"
22727 msgstr ""
22728 " hexedit /dev/sda 1M\n"
22729 "\n"
22730
22731 #. type: textblock
22732 #: ../resize/virt-resize.pod:445
22733 msgid ""
22734 "You can increase the size of any partition.  Virt-resize will expand the "
22735 "direct content of the partition if it knows how (see I<--expand> below)."
22736 msgstr ""
22737
22738 #. type: textblock
22739 #: ../resize/virt-resize.pod:449
22740 msgid ""
22741 "You can only I<decrease> the size of partitions that contain filesystems or "
22742 "PVs which have already been shrunk.  Virt-resize will check this has been "
22743 "done before proceeding, or else will print an error (see also I<--resize-"
22744 "force>)."
22745 msgstr ""
22746
22747 #. type: =item
22748 #: ../resize/virt-resize.pod:456
22749 msgid "B<--resize-force part=size>"
22750 msgstr ""
22751
22752 #. type: textblock
22753 #: ../resize/virt-resize.pod:458
22754 msgid ""
22755 "This is the same as I<--resize> except that it will let you decrease the "
22756 "size of any partition.  Generally this means you will lose any data which "
22757 "was at the end of the partition you shrink, but you may not care about that "
22758 "(eg. if shrinking an unused partition, or if you can easily recreate it such "
22759 "as a swap partition)."
22760 msgstr ""
22761
22762 #. type: textblock
22763 #: ../resize/virt-resize.pod:464
22764 msgid "See also the I<--ignore> option."
22765 msgstr ""
22766
22767 #. type: =item
22768 #: ../resize/virt-resize.pod:466
22769 #, fuzzy
22770 #| msgid "B<--partition>"
22771 msgid "B<--shrink part>"
22772 msgstr "B<--partition>"
22773
22774 #. type: textblock
22775 #: ../resize/virt-resize.pod:468
22776 msgid ""
22777 "Shrink the named partition until the overall disk image fits in the "
22778 "destination.  The named partition B<must> contain a filesystem or PV which "
22779 "has already been shrunk using another tool (eg. L<guestfish(1)> or other "
22780 "online tools).  Virt-resize will check this and give an error if it has not "
22781 "been done."
22782 msgstr ""
22783
22784 #. type: textblock
22785 #: ../resize/virt-resize.pod:474
22786 msgid ""
22787 "The amount by which the overall disk must be shrunk (after carrying out all "
22788 "other operations requested by the user) is called the \"deficit\".  For "
22789 "example, a straight copy (assume no other operations)  from a 5GB disk image "
22790 "to a 4GB disk image results in a 1GB deficit.  In this case, virt-resize "
22791 "would give an error unless the user specified a partition to shrink and that "
22792 "partition had more than a gigabyte of free space."
22793 msgstr ""
22794
22795 #. type: =head1
22796 #: ../resize/virt-resize.pod:492
22797 msgid "MACHINE READABLE OUTPUT"
22798 msgstr ""
22799
22800 #. type: textblock
22801 #: ../resize/virt-resize.pod:494
22802 msgid ""
22803 "The I<--machine-readable> option can be used to make the output more machine "
22804 "friendly, which is useful when calling virt-resize from other programs, GUIs "
22805 "etc."
22806 msgstr ""
22807
22808 #. type: textblock
22809 #: ../resize/virt-resize.pod:498
22810 msgid ""
22811 "Use the option on its own to query the capabilities of the virt-resize "
22812 "binary.  Typical output looks like this:"
22813 msgstr ""
22814
22815 #. type: verbatim
22816 #: ../resize/virt-resize.pod:501
22817 #, no-wrap
22818 msgid ""
22819 " $ virt-resize --machine-readable\n"
22820 " virt-resize\n"
22821 " ntfsresize-force\n"
22822 " 32bitok\n"
22823 " ntfs\n"
22824 " btrfs\n"
22825 "\n"
22826 msgstr ""
22827
22828 #. type: textblock
22829 #: ../resize/virt-resize.pod:508
22830 msgid ""
22831 "A list of features is printed, one per line, and the program exits with "
22832 "status 0."
22833 msgstr ""
22834
22835 #. type: =head2
22836 #: ../resize/virt-resize.pod:513
22837 msgid "\"Partition 1 does not end on cylinder boundary.\""
22838 msgstr ""
22839
22840 #. type: textblock
22841 #: ../resize/virt-resize.pod:515
22842 msgid ""
22843 "Virt-resize aligns partitions to multiples of 64 sectors.  Usually this "
22844 "means the partitions will not be aligned to the ancient CHS geometry.  "
22845 "However CHS geometry is meaningless for disks manufactured since the early "
22846 "1990s, and doubly so for virtual hard drives.  Alignment of partitions to "
22847 "cylinders is not required by any modern operating system."
22848 msgstr ""
22849
22850 #. type: =head2
22851 #: ../resize/virt-resize.pod:522
22852 msgid "RESIZING WINDOWS VIRTUAL MACHINES"
22853 msgstr ""
22854
22855 #. type: textblock
22856 #: ../resize/virt-resize.pod:524
22857 msgid ""
22858 "In Windows Vista and later versions, Microsoft switched to using a separate "
22859 "boot partition.  In these VMs, typically C</dev/sda1> is the boot partition "
22860 "and C</dev/sda2> is the main (C:) drive.  We have not had any luck resizing "
22861 "the boot partition.  Doing so seems to break the guest completely.  However "
22862 "expanding the second partition (ie. C: drive) should work."
22863 msgstr ""
22864
22865 #. type: textblock
22866 #: ../resize/virt-resize.pod:531
22867 msgid ""
22868 "Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if "
22869 "NTFS partitions have been expanded.  This is just a safety check and (unless "
22870 "it find errors) is nothing to worry about."
22871 msgstr ""
22872
22873 #. type: =head2
22874 #: ../resize/virt-resize.pod:535
22875 msgid "GUEST BOOT STUCK AT \"GRUB\""
22876 msgstr ""
22877
22878 #. type: textblock
22879 #: ../resize/virt-resize.pod:537
22880 msgid ""
22881 "If a Linux guest does not boot after resizing, and the boot is stuck after "
22882 "printing C<GRUB> on the console, try reinstalling grub.  This sometimes "
22883 "happens on older (RHEL 5-era) guests, for reasons we don't fully understand, "
22884 "although we think is to do with partition alignment."
22885 msgstr ""
22886
22887 #. type: verbatim
22888 #: ../resize/virt-resize.pod:542
22889 #, no-wrap
22890 msgid ""
22891 " guestfish -i -a newdisk\n"
22892 " ><fs> cat /boot/grub/device.map\n"
22893 " # check the contents of this file are sensible or\n"
22894 " # edit the file if necessary\n"
22895 " ><fs> grub-install / /dev/vda\n"
22896 " ><fs> exit\n"
22897 "\n"
22898 msgstr ""
22899
22900 #. type: textblock
22901 #: ../resize/virt-resize.pod:549
22902 msgid ""
22903 "For more flexible guest reconfiguration, including if you need to specify "
22904 "other parameters to grub-install, use L<virt-rescue(1)>."
22905 msgstr ""
22906
22907 #. type: =head1
22908 #: ../resize/virt-resize.pod:552
22909 msgid "ALTERNATIVE TOOLS"
22910 msgstr ""
22911
22912 #. type: textblock
22913 #: ../resize/virt-resize.pod:554
22914 msgid ""
22915 "There are several proprietary tools for resizing partitions.  We won't "
22916 "mention any here."
22917 msgstr ""
22918
22919 #. type: textblock
22920 #: ../resize/virt-resize.pod:557
22921 msgid ""
22922 "L<parted(8)> and its graphical shell gparted can do some types of resizing "
22923 "operations on disk images.  They can resize and move partitions, but I don't "
22924 "think they can do anything with the contents, and they certainly don't "
22925 "understand LVM."
22926 msgstr ""
22927
22928 #. type: textblock
22929 #: ../resize/virt-resize.pod:562
22930 msgid ""
22931 "L<guestfish(1)> can do everything that virt-resize can do and a lot more, "
22932 "but at a much lower level.  You will probably end up hand-calculating sector "
22933 "offsets, which is something that virt-resize was designed to avoid.  If you "
22934 "want to see the guestfish-equivalent commands that virt-resize runs, use the "
22935 "I<--debug> flag."
22936 msgstr ""
22937
22938 #. type: textblock
22939 #: ../resize/virt-resize.pod:582
22940 msgid ""
22941 "L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<lvm"
22942 "(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)>, "
22943 "L<btrfs(8)>, L<virsh(1)>, L<parted(8)>, L<truncate(1)>, L<fallocate(1)>, "
22944 "L<grub(8)>, L<grub-install(8)>, L<virt-rescue(1)>, L<http://libguestfs.org/>."
22945 msgstr ""
22946
22947 #. type: textblock
22948 #: ../ruby/examples/guestfs-ruby.pod:5
22949 msgid "guestfs-ruby - How to use libguestfs from Ruby"
22950 msgstr ""
22951
22952 #. type: verbatim
22953 #: ../ruby/examples/guestfs-ruby.pod:9
22954 #, no-wrap
22955 msgid ""
22956 " require 'guestfs'\n"
22957 " g = Guestfs::Guestfs.new()\n"
22958 " g.add_drive_opts(\"disk.img\",\n"
22959 "                  :readonly => 1, :format => \"raw\")\n"
22960 " g.launch()\n"
22961 "\n"
22962 msgstr ""
22963
22964 #. type: textblock
22965 #: ../ruby/examples/guestfs-ruby.pod:17
22966 msgid ""
22967 "This manual page documents how to call libguestfs from the Ruby programming "
22968 "language.  This page just documents the differences from the C API and gives "
22969 "some examples.  If you are not familiar with using libguestfs, you also need "
22970 "to read L<guestfs(3)>."
22971 msgstr ""
22972
22973 #. type: textblock
22974 #: ../ruby/examples/guestfs-ruby.pod:24
22975 msgid ""
22976 "Errors from libguestfs functions are mapped into the C<Error> exception.  "
22977 "This has a single parameter which is the error message (a string)."
22978 msgstr ""
22979
22980 #. type: textblock
22981 #: ../ruby/examples/guestfs-ruby.pod:38
22982 #, fuzzy
22983 #| msgid ""
22984 #| "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
22985 #| "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::"
22986 #| "Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
22987 msgid ""
22988 "L<guestfs(3)>, L<guestfs-examples(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)"
22989 ">, L<guestfs-perl(3)>, L<guestfs-python(3)>, L<guestfs-recipes(1)>, L<http://"
22990 "libguestfs.org/>."
22991 msgstr ""
22992 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
22993 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
22994 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
22995
22996 #. type: =head2
22997 #: ../src/guestfs-actions.pod:1
22998 msgid "guestfs_add_cdrom"
22999 msgstr ""
23000
23001 #. type: verbatim
23002 #: ../src/guestfs-actions.pod:3
23003 #, no-wrap
23004 msgid ""
23005 " int\n"
23006 " guestfs_add_cdrom (guestfs_h *g,\n"
23007 "                    const char *filename);\n"
23008 "\n"
23009 msgstr ""
23010
23011 #. type: textblock
23012 #: ../src/guestfs-actions.pod:17
23013 msgid ""
23014 "This call checks for the existence of C<filename>.  This stops you from "
23015 "specifying other types of drive which are supported by qemu such as C<nbd:> "
23016 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
23017 "instead."
23018 msgstr ""
23019
23020 #. type: textblock
23021 #: ../src/guestfs-actions.pod:24
23022 msgid ""
23023 "If you just want to add an ISO file (often you use this as an efficient way "
23024 "to transfer large files into the guest), then you should probably use "
23025 "C<guestfs_add_drive_ro> instead."
23026 msgstr ""
23027
23028 #. type: textblock
23029 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:140
23030 #: ../src/guestfs-actions.pod:201 ../src/guestfs-actions.pod:238
23031 #: ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273
23032 #: ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:307
23033 #: ../src/guestfs-actions.pod:427 ../src/guestfs-actions.pod:447
23034 #: ../src/guestfs-actions.pod:461 ../src/guestfs-actions.pod:506
23035 #: ../src/guestfs-actions.pod:534 ../src/guestfs-actions.pod:552
23036 #: ../src/guestfs-actions.pod:619 ../src/guestfs-actions.pod:652
23037 #: ../src/guestfs-actions.pod:666 ../src/guestfs-actions.pod:681
23038 #: ../src/guestfs-actions.pod:780 ../src/guestfs-actions.pod:798
23039 #: ../src/guestfs-actions.pod:812 ../src/guestfs-actions.pod:826
23040 #: ../src/guestfs-actions.pod:863 ../src/guestfs-actions.pod:1046
23041 #: ../src/guestfs-actions.pod:1066 ../src/guestfs-actions.pod:1084
23042 #: ../src/guestfs-actions.pod:1168 ../src/guestfs-actions.pod:1186
23043 #: ../src/guestfs-actions.pod:1205 ../src/guestfs-actions.pod:1219
23044 #: ../src/guestfs-actions.pod:1239 ../src/guestfs-actions.pod:1309
23045 #: ../src/guestfs-actions.pod:1340 ../src/guestfs-actions.pod:1365
23046 #: ../src/guestfs-actions.pod:1407 ../src/guestfs-actions.pod:1513
23047 #: ../src/guestfs-actions.pod:1547 ../src/guestfs-actions.pod:1762
23048 #: ../src/guestfs-actions.pod:1784 ../src/guestfs-actions.pod:1871
23049 #: ../src/guestfs-actions.pod:2346 ../src/guestfs-actions.pod:2490
23050 #: ../src/guestfs-actions.pod:2551 ../src/guestfs-actions.pod:2586
23051 #: ../src/guestfs-actions.pod:3626 ../src/guestfs-actions.pod:3641
23052 #: ../src/guestfs-actions.pod:3666 ../src/guestfs-actions.pod:3855
23053 #: ../src/guestfs-actions.pod:3869 ../src/guestfs-actions.pod:3882
23054 #: ../src/guestfs-actions.pod:3896 ../src/guestfs-actions.pod:3911
23055 #: ../src/guestfs-actions.pod:3947 ../src/guestfs-actions.pod:4019
23056 #: ../src/guestfs-actions.pod:4039 ../src/guestfs-actions.pod:4056
23057 #: ../src/guestfs-actions.pod:4079 ../src/guestfs-actions.pod:4102
23058 #: ../src/guestfs-actions.pod:4137 ../src/guestfs-actions.pod:4156
23059 #: ../src/guestfs-actions.pod:4175 ../src/guestfs-actions.pod:4210
23060 #: ../src/guestfs-actions.pod:4222 ../src/guestfs-actions.pod:4258
23061 #: ../src/guestfs-actions.pod:4274 ../src/guestfs-actions.pod:4287
23062 #: ../src/guestfs-actions.pod:4302 ../src/guestfs-actions.pod:4319
23063 #: ../src/guestfs-actions.pod:4412 ../src/guestfs-actions.pod:4432
23064 #: ../src/guestfs-actions.pod:4445 ../src/guestfs-actions.pod:4496
23065 #: ../src/guestfs-actions.pod:4514 ../src/guestfs-actions.pod:4532
23066 #: ../src/guestfs-actions.pod:4548 ../src/guestfs-actions.pod:4562
23067 #: ../src/guestfs-actions.pod:4576 ../src/guestfs-actions.pod:4593
23068 #: ../src/guestfs-actions.pod:4608 ../src/guestfs-actions.pod:4628
23069 #: ../src/guestfs-actions.pod:4698 ../src/guestfs-actions.pod:4771
23070 #: ../src/guestfs-actions.pod:4802 ../src/guestfs-actions.pod:4821
23071 #: ../src/guestfs-actions.pod:4840 ../src/guestfs-actions.pod:4852
23072 #: ../src/guestfs-actions.pod:4869 ../src/guestfs-actions.pod:4882
23073 #: ../src/guestfs-actions.pod:4897 ../src/guestfs-actions.pod:4912
23074 #: ../src/guestfs-actions.pod:4947 ../src/guestfs-actions.pod:4980
23075 #: ../src/guestfs-actions.pod:5019 ../src/guestfs-actions.pod:5039
23076 #: ../src/guestfs-actions.pod:5053 ../src/guestfs-actions.pod:5070
23077 #: ../src/guestfs-actions.pod:5119 ../src/guestfs-actions.pod:5165
23078 #: ../src/guestfs-actions.pod:5219 ../src/guestfs-actions.pod:5255
23079 #: ../src/guestfs-actions.pod:5290 ../src/guestfs-actions.pod:5307
23080 #: ../src/guestfs-actions.pod:5325 ../src/guestfs-actions.pod:5465
23081 #: ../src/guestfs-actions.pod:5522 ../src/guestfs-actions.pod:5544
23082 #: ../src/guestfs-actions.pod:5562 ../src/guestfs-actions.pod:5594
23083 #: ../src/guestfs-actions.pod:5660 ../src/guestfs-actions.pod:5677
23084 #: ../src/guestfs-actions.pod:5690 ../src/guestfs-actions.pod:5704
23085 #: ../src/guestfs-actions.pod:5993 ../src/guestfs-actions.pod:6012
23086 #: ../src/guestfs-actions.pod:6031 ../src/guestfs-actions.pod:6045
23087 #: ../src/guestfs-actions.pod:6057 ../src/guestfs-actions.pod:6071
23088 #: ../src/guestfs-actions.pod:6083 ../src/guestfs-actions.pod:6097
23089 #: ../src/guestfs-actions.pod:6113 ../src/guestfs-actions.pod:6134
23090 #: ../src/guestfs-actions.pod:6153 ../src/guestfs-actions.pod:6172
23091 #: ../src/guestfs-actions.pod:6202 ../src/guestfs-actions.pod:6220
23092 #: ../src/guestfs-actions.pod:6243 ../src/guestfs-actions.pod:6261
23093 #: ../src/guestfs-actions.pod:6280 ../src/guestfs-actions.pod:6301
23094 #: ../src/guestfs-actions.pod:6320 ../src/guestfs-actions.pod:6337
23095 #: ../src/guestfs-actions.pod:6356 ../src/guestfs-actions.pod:6384
23096 #: ../src/guestfs-actions.pod:6408 ../src/guestfs-actions.pod:6427
23097 #: ../src/guestfs-actions.pod:6451 ../src/guestfs-actions.pod:6470
23098 #: ../src/guestfs-actions.pod:6485 ../src/guestfs-actions.pod:6504
23099 #: ../src/guestfs-actions.pod:6541 ../src/guestfs-actions.pod:6571
23100 #: ../src/guestfs-actions.pod:6604 ../src/guestfs-actions.pod:6726
23101 #: ../src/guestfs-actions.pod:6847 ../src/guestfs-actions.pod:6859
23102 #: ../src/guestfs-actions.pod:6872 ../src/guestfs-actions.pod:6885
23103 #: ../src/guestfs-actions.pod:6907 ../src/guestfs-actions.pod:6920
23104 #: ../src/guestfs-actions.pod:6933 ../src/guestfs-actions.pod:6946
23105 #: ../src/guestfs-actions.pod:6961 ../src/guestfs-actions.pod:7020
23106 #: ../src/guestfs-actions.pod:7037 ../src/guestfs-actions.pod:7053
23107 #: ../src/guestfs-actions.pod:7069 ../src/guestfs-actions.pod:7086
23108 #: ../src/guestfs-actions.pod:7099 ../src/guestfs-actions.pod:7119
23109 #: ../src/guestfs-actions.pod:7155 ../src/guestfs-actions.pod:7169
23110 #: ../src/guestfs-actions.pod:7210 ../src/guestfs-actions.pod:7223
23111 #: ../src/guestfs-actions.pod:7241 ../src/guestfs-actions.pod:7275
23112 #: ../src/guestfs-actions.pod:7311 ../src/guestfs-actions.pod:7427
23113 #: ../src/guestfs-actions.pod:7442 ../src/guestfs-actions.pod:7456
23114 #: ../src/guestfs-actions.pod:7511 ../src/guestfs-actions.pod:7524
23115 #: ../src/guestfs-actions.pod:7569 ../src/guestfs-actions.pod:7602
23116 #: ../src/guestfs-actions.pod:7665 ../src/guestfs-actions.pod:7685
23117 #: ../src/guestfs-actions.pod:7711 ../src/guestfs-actions.pod:7782
23118 #: ../src/guestfs-actions.pod:7805 ../src/guestfs-actions.pod:7834
23119 msgid "This function returns 0 on success or -1 on error."
23120 msgstr ""
23121
23122 #. type: textblock
23123 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:254
23124 #: ../src/guestfs-actions.pod:275
23125 msgid ""
23126 "This function is deprecated.  In new code, use the L</"
23127 "guestfs_add_drive_opts> call instead."
23128 msgstr ""
23129
23130 #. type: textblock
23131 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:142
23132 #: ../src/guestfs-actions.pod:1170 ../src/guestfs-actions.pod:1985
23133 #: ../src/guestfs-actions.pod:2083 ../src/guestfs-actions.pod:2197
23134 #: ../src/guestfs-actions.pod:3628 ../src/guestfs-actions.pod:3648
23135 #: ../src/guestfs-actions.pod:4956 ../src/guestfs-actions.pod:6222
23136 #: ../src/guestfs-actions.pod:6339 ../src/guestfs-actions.pod:6472
23137 #: ../src/guestfs-actions.pod:6963 ../src/guestfs-actions.pod:7088
23138 #: ../src/guestfs-actions.pod:7611
23139 msgid "(Added in 0.3)"
23140 msgstr ""
23141
23142 #. type: =head2
23143 #: ../src/guestfs-actions.pod:41
23144 msgid "guestfs_add_domain"
23145 msgstr ""
23146
23147 #. type: verbatim
23148 #: ../src/guestfs-actions.pod:43
23149 #, no-wrap
23150 msgid ""
23151 " int\n"
23152 " guestfs_add_domain (guestfs_h *g,\n"
23153 "                     const char *dom,\n"
23154 "                     ...);\n"
23155 "\n"
23156 msgstr ""
23157
23158 #. type: textblock
23159 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:151
23160 #: ../src/guestfs-actions.pod:837 ../src/guestfs-actions.pod:2831
23161 #: ../src/guestfs-actions.pod:4647 ../src/guestfs-actions.pod:4966
23162 #: ../src/guestfs-actions.pod:5183
23163 msgid ""
23164 "You may supply a list of optional arguments to this call.  Use zero or more "
23165 "of the following pairs of parameters, and terminate the list with C<-1> on "
23166 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
23167 msgstr ""
23168
23169 #. type: verbatim
23170 #: ../src/guestfs-actions.pod:53
23171 #, no-wrap
23172 msgid ""
23173 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
23174 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
23175 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
23176 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
23177 " GUESTFS_ADD_DOMAIN_ALLOWUUID, int allowuuid,\n"
23178 "\n"
23179 msgstr ""
23180
23181 #. type: textblock
23182 #: ../src/guestfs-actions.pod:59
23183 msgid ""
23184 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
23185 "It works by connecting to libvirt, requesting the domain and domain XML from "
23186 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
23187 "one."
23188 msgstr ""
23189
23190 #. type: textblock
23191 #: ../src/guestfs-actions.pod:94
23192 msgid ""
23193 "The other optional parameters are passed directly through to "
23194 "C<guestfs_add_drive_opts>."
23195 msgstr ""
23196
23197 #. type: textblock
23198 #: ../src/guestfs-actions.pod:97 ../src/guestfs-actions.pod:350
23199 #: ../src/guestfs-actions.pod:520 ../src/guestfs-actions.pod:698
23200 #: ../src/guestfs-actions.pod:729 ../src/guestfs-actions.pod:747
23201 #: ../src/guestfs-actions.pod:766 ../src/guestfs-actions.pod:1385
23202 #: ../src/guestfs-actions.pod:1741 ../src/guestfs-actions.pod:1944
23203 #: ../src/guestfs-actions.pod:2055 ../src/guestfs-actions.pod:2106
23204 #: ../src/guestfs-actions.pod:2161 ../src/guestfs-actions.pod:2184
23205 #: ../src/guestfs-actions.pod:2477 ../src/guestfs-actions.pod:2949
23206 #: ../src/guestfs-actions.pod:2967 ../src/guestfs-actions.pod:5142
23207 #: ../src/guestfs-actions.pod:5362 ../src/guestfs-actions.pod:5774
23208 #: ../src/guestfs-actions.pod:5800 ../src/guestfs-actions.pod:7196
23209 #: ../src/guestfs-actions.pod:7622 ../src/guestfs-actions.pod:7635
23210 #: ../src/guestfs-actions.pod:7648
23211 msgid "On error this function returns -1."
23212 msgstr ""
23213
23214 #. type: textblock
23215 #: ../src/guestfs-actions.pod:99
23216 msgid "(Added in 1.7.4)"
23217 msgstr ""
23218
23219 #. type: =head2
23220 #: ../src/guestfs-actions.pod:101
23221 msgid "guestfs_add_domain_va"
23222 msgstr ""
23223
23224 #. type: verbatim
23225 #: ../src/guestfs-actions.pod:103
23226 #, no-wrap
23227 msgid ""
23228 " int\n"
23229 " guestfs_add_domain_va (guestfs_h *g,\n"
23230 "                        const char *dom,\n"
23231 "                        va_list args);\n"
23232 "\n"
23233 msgstr ""
23234
23235 #. type: textblock
23236 #: ../src/guestfs-actions.pod:108
23237 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
23238 msgstr ""
23239
23240 #. type: textblock
23241 #: ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121
23242 #: ../src/guestfs-actions.pod:214 ../src/guestfs-actions.pod:225
23243 #: ../src/guestfs-actions.pod:876 ../src/guestfs-actions.pod:887
23244 #: ../src/guestfs-actions.pod:2915 ../src/guestfs-actions.pod:2927
23245 #: ../src/guestfs-actions.pod:4712 ../src/guestfs-actions.pod:4724
23246 #: ../src/guestfs-actions.pod:4994 ../src/guestfs-actions.pod:5006
23247 #: ../src/guestfs-actions.pod:5232 ../src/guestfs-actions.pod:5243
23248 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
23249 msgstr "Див. L</CALLS WITH OPTIONAL ARGUMENTS>."
23250
23251 #. type: =head2
23252 #: ../src/guestfs-actions.pod:112
23253 msgid "guestfs_add_domain_argv"
23254 msgstr "guestfs_add_domain_argv"
23255
23256 #. type: verbatim
23257 #: ../src/guestfs-actions.pod:114
23258 #, no-wrap
23259 msgid ""
23260 " int\n"
23261 " guestfs_add_domain_argv (guestfs_h *g,\n"
23262 "                          const char *dom,\n"
23263 "                          const struct guestfs_add_domain_argv *optargs);\n"
23264 "\n"
23265 msgstr ""
23266
23267 #. type: textblock
23268 #: ../src/guestfs-actions.pod:119
23269 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
23270 msgstr ""
23271
23272 #. type: =head2
23273 #: ../src/guestfs-actions.pod:123
23274 msgid "guestfs_add_drive"
23275 msgstr ""
23276
23277 #. type: verbatim
23278 #: ../src/guestfs-actions.pod:125
23279 #, no-wrap
23280 msgid ""
23281 " int\n"
23282 " guestfs_add_drive (guestfs_h *g,\n"
23283 "                    const char *filename);\n"
23284 "\n"
23285 msgstr ""
23286
23287 #. type: textblock
23288 #: ../src/guestfs-actions.pod:129
23289 msgid ""
23290 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
23291 "optional parameters, so the disk is added writable, with the format being "
23292 "detected automatically."
23293 msgstr ""
23294
23295 #. type: textblock
23296 #: ../src/guestfs-actions.pod:133
23297 msgid ""
23298 "Automatic detection of the format opens you up to a potential security hole "
23299 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
23300 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
23301 "you should think about replacing calls to this function with calls to "
23302 "C<guestfs_add_drive_opts>, and specifying the format."
23303 msgstr ""
23304
23305 #. type: =head2
23306 #: ../src/guestfs-actions.pod:144
23307 msgid "guestfs_add_drive_opts"
23308 msgstr ""
23309
23310 #. type: verbatim
23311 #: ../src/guestfs-actions.pod:146
23312 #, no-wrap
23313 msgid ""
23314 " int\n"
23315 " guestfs_add_drive_opts (guestfs_h *g,\n"
23316 "                         const char *filename,\n"
23317 "                         ...);\n"
23318 "\n"
23319 msgstr ""
23320
23321 #. type: verbatim
23322 #: ../src/guestfs-actions.pod:156
23323 #, no-wrap
23324 msgid ""
23325 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
23326 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
23327 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
23328 "\n"
23329 msgstr ""
23330
23331 #. type: textblock
23332 #: ../src/guestfs-actions.pod:185
23333 msgid ""
23334 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
23335 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
23336 "Possible formats include C<raw> and C<qcow2>."
23337 msgstr ""
23338
23339 #. type: textblock
23340 #: ../src/guestfs-actions.pod:196
23341 msgid ""
23342 "This rarely-used option lets you emulate the behaviour of the deprecated "
23343 "C<guestfs_add_drive_with_if> call (q.v.)"
23344 msgstr ""
23345
23346 #. type: textblock
23347 #: ../src/guestfs-actions.pod:203
23348 msgid "(Added in 1.5.23)"
23349 msgstr ""
23350
23351 #. type: =head2
23352 #: ../src/guestfs-actions.pod:205
23353 msgid "guestfs_add_drive_opts_va"
23354 msgstr ""
23355
23356 #. type: verbatim
23357 #: ../src/guestfs-actions.pod:207
23358 #, no-wrap
23359 msgid ""
23360 " int\n"
23361 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
23362 "                            const char *filename,\n"
23363 "                            va_list args);\n"
23364 "\n"
23365 msgstr ""
23366
23367 #. type: textblock
23368 #: ../src/guestfs-actions.pod:212
23369 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
23370 msgstr ""
23371
23372 #. type: =head2
23373 #: ../src/guestfs-actions.pod:216
23374 msgid "guestfs_add_drive_opts_argv"
23375 msgstr ""
23376
23377 #. type: verbatim
23378 #: ../src/guestfs-actions.pod:218
23379 #, no-wrap
23380 msgid ""
23381 " int\n"
23382 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
23383 "                              const char *filename,\n"
23384 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
23385 "\n"
23386 msgstr ""
23387
23388 #. type: textblock
23389 #: ../src/guestfs-actions.pod:223
23390 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
23391 msgstr ""
23392
23393 #. type: =head2
23394 #: ../src/guestfs-actions.pod:227
23395 msgid "guestfs_add_drive_ro"
23396 msgstr ""
23397
23398 #. type: verbatim
23399 #: ../src/guestfs-actions.pod:229
23400 #, no-wrap
23401 msgid ""
23402 " int\n"
23403 " guestfs_add_drive_ro (guestfs_h *g,\n"
23404 "                       const char *filename);\n"
23405 "\n"
23406 msgstr ""
23407
23408 #. type: textblock
23409 #: ../src/guestfs-actions.pod:233
23410 msgid ""
23411 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
23412 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
23413 "disk is added read-only, with the format being detected automatically."
23414 msgstr ""
23415
23416 #. type: textblock
23417 #: ../src/guestfs-actions.pod:240
23418 msgid "(Added in 1.0.38)"
23419 msgstr ""
23420
23421 #. type: =head2
23422 #: ../src/guestfs-actions.pod:242
23423 msgid "guestfs_add_drive_ro_with_if"
23424 msgstr ""
23425
23426 #. type: verbatim
23427 #: ../src/guestfs-actions.pod:244
23428 #, no-wrap
23429 msgid ""
23430 " int\n"
23431 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
23432 "                               const char *filename,\n"
23433 "                               const char *iface);\n"
23434 "\n"
23435 msgstr ""
23436
23437 #. type: textblock
23438 #: ../src/guestfs-actions.pod:249
23439 msgid ""
23440 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
23441 "QEMU interface emulation to use at run time."
23442 msgstr ""
23443
23444 #. type: textblock
23445 #: ../src/guestfs-actions.pod:261 ../src/guestfs-actions.pod:282
23446 #: ../src/guestfs-actions.pod:2436
23447 msgid "(Added in 1.0.84)"
23448 msgstr ""
23449
23450 #. type: =head2
23451 #: ../src/guestfs-actions.pod:263
23452 msgid "guestfs_add_drive_with_if"
23453 msgstr ""
23454
23455 #. type: verbatim
23456 #: ../src/guestfs-actions.pod:265
23457 #, no-wrap
23458 msgid ""
23459 " int\n"
23460 " guestfs_add_drive_with_if (guestfs_h *g,\n"
23461 "                            const char *filename,\n"
23462 "                            const char *iface);\n"
23463 "\n"
23464 msgstr ""
23465
23466 #. type: textblock
23467 #: ../src/guestfs-actions.pod:270
23468 msgid ""
23469 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
23470 "QEMU interface emulation to use at run time."
23471 msgstr ""
23472
23473 #. type: =head2
23474 #: ../src/guestfs-actions.pod:284
23475 msgid "guestfs_aug_clear"
23476 msgstr ""
23477
23478 #. type: verbatim
23479 #: ../src/guestfs-actions.pod:286
23480 #, no-wrap
23481 msgid ""
23482 " int\n"
23483 " guestfs_aug_clear (guestfs_h *g,\n"
23484 "                    const char *augpath);\n"
23485 "\n"
23486 msgstr ""
23487
23488 #. type: textblock
23489 #: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:2186
23490 msgid "(Added in 1.3.4)"
23491 msgstr ""
23492
23493 #. type: =head2
23494 #: ../src/guestfs-actions.pod:297
23495 msgid "guestfs_aug_close"
23496 msgstr ""
23497
23498 #. type: verbatim
23499 #: ../src/guestfs-actions.pod:299
23500 #, no-wrap
23501 msgid ""
23502 " int\n"
23503 " guestfs_aug_close (guestfs_h *g);\n"
23504 "\n"
23505 msgstr ""
23506
23507 #. type: textblock
23508 #: ../src/guestfs-actions.pod:302
23509 msgid ""
23510 "Close the current Augeas handle and free up any resources used by it.  After "
23511 "calling this, you have to call C<guestfs_aug_init> again before you can use "
23512 "any other Augeas functions."
23513 msgstr ""
23514
23515 #. type: textblock
23516 #: ../src/guestfs-actions.pod:309 ../src/guestfs-actions.pod:334
23517 #: ../src/guestfs-actions.pod:352 ../src/guestfs-actions.pod:366
23518 #: ../src/guestfs-actions.pod:429 ../src/guestfs-actions.pod:449
23519 #: ../src/guestfs-actions.pod:463 ../src/guestfs-actions.pod:494
23520 #: ../src/guestfs-actions.pod:508 ../src/guestfs-actions.pod:522
23521 #: ../src/guestfs-actions.pod:536 ../src/guestfs-actions.pod:554
23522 #: ../src/guestfs-actions.pod:5851
23523 msgid "(Added in 0.7)"
23524 msgstr ""
23525
23526 #. type: =head2
23527 #: ../src/guestfs-actions.pod:311
23528 msgid "guestfs_aug_defnode"
23529 msgstr ""
23530
23531 #. type: verbatim
23532 #: ../src/guestfs-actions.pod:313
23533 #, no-wrap
23534 msgid ""
23535 " struct guestfs_int_bool *\n"
23536 " guestfs_aug_defnode (guestfs_h *g,\n"
23537 "                      const char *name,\n"
23538 "                      const char *expr,\n"
23539 "                      const char *val);\n"
23540 "\n"
23541 msgstr ""
23542
23543 #. type: textblock
23544 #: ../src/guestfs-actions.pod:322
23545 msgid ""
23546 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
23547 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
23548 "containing that single node."
23549 msgstr ""
23550
23551 #. type: textblock
23552 #: ../src/guestfs-actions.pod:330
23553 msgid ""
23554 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
23555 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
23556 msgstr ""
23557
23558 #. type: =head2
23559 #: ../src/guestfs-actions.pod:336
23560 msgid "guestfs_aug_defvar"
23561 msgstr ""
23562
23563 #. type: verbatim
23564 #: ../src/guestfs-actions.pod:338
23565 #, no-wrap
23566 msgid ""
23567 " int\n"
23568 " guestfs_aug_defvar (guestfs_h *g,\n"
23569 "                     const char *name,\n"
23570 "                     const char *expr);\n"
23571 "\n"
23572 msgstr ""
23573
23574 #. type: =head2
23575 #: ../src/guestfs-actions.pod:354
23576 msgid "guestfs_aug_get"
23577 msgstr ""
23578
23579 #. type: verbatim
23580 #: ../src/guestfs-actions.pod:356
23581 #, no-wrap
23582 msgid ""
23583 " char *\n"
23584 " guestfs_aug_get (guestfs_h *g,\n"
23585 "                  const char *augpath);\n"
23586 "\n"
23587 msgstr ""
23588
23589 #. type: textblock
23590 #: ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:927
23591 #: ../src/guestfs-actions.pod:945 ../src/guestfs-actions.pod:1005
23592 #: ../src/guestfs-actions.pod:1021 ../src/guestfs-actions.pod:1124
23593 #: ../src/guestfs-actions.pod:1254 ../src/guestfs-actions.pod:1271
23594 #: ../src/guestfs-actions.pod:1290 ../src/guestfs-actions.pod:1424
23595 #: ../src/guestfs-actions.pod:1612 ../src/guestfs-actions.pod:1724
23596 #: ../src/guestfs-actions.pod:1887 ../src/guestfs-actions.pod:1904
23597 #: ../src/guestfs-actions.pod:1971 ../src/guestfs-actions.pod:2007
23598 #: ../src/guestfs-actions.pod:2028 ../src/guestfs-actions.pod:2209
23599 #: ../src/guestfs-actions.pod:2401 ../src/guestfs-actions.pod:2605
23600 #: ../src/guestfs-actions.pod:2695 ../src/guestfs-actions.pod:2799
23601 #: ../src/guestfs-actions.pod:2818 ../src/guestfs-actions.pod:3032
23602 #: ../src/guestfs-actions.pod:3060 ../src/guestfs-actions.pod:3081
23603 #: ../src/guestfs-actions.pod:3115 ../src/guestfs-actions.pod:3174
23604 #: ../src/guestfs-actions.pod:3194 ../src/guestfs-actions.pod:3214
23605 #: ../src/guestfs-actions.pod:3841 ../src/guestfs-actions.pod:4194
23606 #: ../src/guestfs-actions.pod:4364 ../src/guestfs-actions.pod:4474
23607 #: ../src/guestfs-actions.pod:5380 ../src/guestfs-actions.pod:5579
23608 #: ../src/guestfs-actions.pod:5749 ../src/guestfs-actions.pod:5927
23609 #: ../src/guestfs-actions.pod:5976 ../src/guestfs-actions.pod:6632
23610 #: ../src/guestfs-actions.pod:6648 ../src/guestfs-actions.pod:6665
23611 #: ../src/guestfs-actions.pod:6696 ../src/guestfs-actions.pod:7370
23612 #: ../src/guestfs-actions.pod:7389 ../src/guestfs-actions.pod:7407
23613 #: ../src/guestfs-actions.pod:7581 ../src/guestfs-actions.pod:7891
23614 msgid ""
23615 "This function returns a string, or NULL on error.  I<The caller must free "
23616 "the returned string after use>."
23617 msgstr ""
23618
23619 #. type: =head2
23620 #: ../src/guestfs-actions.pod:368
23621 msgid "guestfs_aug_init"
23622 msgstr ""
23623
23624 #. type: verbatim
23625 #: ../src/guestfs-actions.pod:370
23626 #, no-wrap
23627 msgid ""
23628 " int\n"
23629 " guestfs_aug_init (guestfs_h *g,\n"
23630 "                   const char *root,\n"
23631 "                   int flags);\n"
23632 "\n"
23633 msgstr ""
23634
23635 #. type: textblock
23636 #: ../src/guestfs-actions.pod:379
23637 msgid "You must call this before using any other C<guestfs_aug_*> commands."
23638 msgstr ""
23639
23640 #. type: textblock
23641 #: ../src/guestfs-actions.pod:404
23642 msgid ""
23643 "This option is only useful when debugging Augeas lenses.  Use of this option "
23644 "may require additional memory for the libguestfs appliance.  You may need to "
23645 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call "
23646 "C<guestfs_set_memsize>."
23647 msgstr ""
23648
23649 #. type: textblock
23650 #: ../src/guestfs-actions.pod:419
23651 msgid "Do not load the tree in C<guestfs_aug_init>."
23652 msgstr ""
23653
23654 #. type: textblock
23655 #: ../src/guestfs-actions.pod:423
23656 msgid "To close the handle, you can call C<guestfs_aug_close>."
23657 msgstr ""
23658
23659 #. type: =head2
23660 #: ../src/guestfs-actions.pod:431
23661 msgid "guestfs_aug_insert"
23662 msgstr ""
23663
23664 #. type: verbatim
23665 #: ../src/guestfs-actions.pod:433
23666 #, no-wrap
23667 msgid ""
23668 " int\n"
23669 " guestfs_aug_insert (guestfs_h *g,\n"
23670 "                     const char *augpath,\n"
23671 "                     const char *label,\n"
23672 "                     int before);\n"
23673 "\n"
23674 msgstr ""
23675
23676 #. type: =head2
23677 #: ../src/guestfs-actions.pod:451
23678 msgid "guestfs_aug_load"
23679 msgstr ""
23680
23681 #. type: verbatim
23682 #: ../src/guestfs-actions.pod:453
23683 #, no-wrap
23684 msgid ""
23685 " int\n"
23686 " guestfs_aug_load (guestfs_h *g);\n"
23687 "\n"
23688 msgstr ""
23689
23690 #. type: =head2
23691 #: ../src/guestfs-actions.pod:465
23692 msgid "guestfs_aug_ls"
23693 msgstr ""
23694
23695 #. type: verbatim
23696 #: ../src/guestfs-actions.pod:467
23697 #, no-wrap
23698 msgid ""
23699 " char **\n"
23700 " guestfs_aug_ls (guestfs_h *g,\n"
23701 "                 const char *augpath);\n"
23702 "\n"
23703 msgstr ""
23704
23705 #. type: textblock
23706 #: ../src/guestfs-actions.pod:471
23707 msgid ""
23708 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
23709 "sorting the resulting nodes into alphabetical order."
23710 msgstr ""
23711
23712 #. type: textblock
23713 #: ../src/guestfs-actions.pod:474 ../src/guestfs-actions.pod:490
23714 #: ../src/guestfs-actions.pod:636 ../src/guestfs-actions.pod:1143
23715 #: ../src/guestfs-actions.pod:1439 ../src/guestfs-actions.pod:1458
23716 #: ../src/guestfs-actions.pod:1561 ../src/guestfs-actions.pod:1580
23717 #: ../src/guestfs-actions.pod:1826 ../src/guestfs-actions.pod:2281
23718 #: ../src/guestfs-actions.pod:2297 ../src/guestfs-actions.pod:2316
23719 #: ../src/guestfs-actions.pod:2359 ../src/guestfs-actions.pod:2383
23720 #: ../src/guestfs-actions.pod:2454 ../src/guestfs-actions.pod:2503
23721 #: ../src/guestfs-actions.pod:2760 ../src/guestfs-actions.pod:3134
23722 #: ../src/guestfs-actions.pod:3410 ../src/guestfs-actions.pod:3724
23723 #: ../src/guestfs-actions.pod:3741 ../src/guestfs-actions.pod:3761
23724 #: ../src/guestfs-actions.pod:3823 ../src/guestfs-actions.pod:3928
23725 #: ../src/guestfs-actions.pod:4336 ../src/guestfs-actions.pod:5103
23726 #: ../src/guestfs-actions.pod:5721 ../src/guestfs-actions.pod:5847
23727 #: ../src/guestfs-actions.pod:5961 ../src/guestfs-actions.pod:6712
23728 #: ../src/guestfs-actions.pod:6773 ../src/guestfs-actions.pod:6828
23729 #: ../src/guestfs-actions.pod:6974 ../src/guestfs-actions.pod:6998
23730 #: ../src/guestfs-actions.pod:7474 ../src/guestfs-actions.pod:7494
23731 #: ../src/guestfs-actions.pod:7541 ../src/guestfs-actions.pod:7735
23732 #: ../src/guestfs-actions.pod:7754 ../src/guestfs-actions.pod:7848
23733 #: ../src/guestfs-actions.pod:7867 ../src/guestfs-actions.pod:7913
23734 #: ../src/guestfs-actions.pod:7932
23735 msgid ""
23736 "This function returns a NULL-terminated array of strings (like L<environ(3)"
23737 ">), or NULL if there was an error.  I<The caller must free the strings and "
23738 "the array after use>."
23739 msgstr ""
23740
23741 #. type: textblock
23742 #: ../src/guestfs-actions.pod:478 ../src/guestfs-actions.pod:1068
23743 #: ../src/guestfs-actions.pod:1086 ../src/guestfs-actions.pod:1496
23744 #: ../src/guestfs-actions.pod:3488 ../src/guestfs-actions.pod:3519
23745 #: ../src/guestfs-actions.pod:4177 ../src/guestfs-actions.pod:4227
23746 #: ../src/guestfs-actions.pod:4414 ../src/guestfs-actions.pod:4447
23747 #: ../src/guestfs-actions.pod:4610 ../src/guestfs-actions.pod:5107
23748 #: ../src/guestfs-actions.pod:5662 ../src/guestfs-actions.pod:6059
23749 #: ../src/guestfs-actions.pod:6073 ../src/guestfs-actions.pod:6085
23750 #: ../src/guestfs-actions.pod:6553 ../src/guestfs-actions.pod:7212
23751 #: ../src/guestfs-actions.pod:7225 ../src/guestfs-actions.pod:7458
23752 #: ../src/guestfs-actions.pod:7723
23753 msgid "(Added in 0.8)"
23754 msgstr ""
23755
23756 #. type: =head2
23757 #: ../src/guestfs-actions.pod:480
23758 msgid "guestfs_aug_match"
23759 msgstr ""
23760
23761 #. type: verbatim
23762 #: ../src/guestfs-actions.pod:482
23763 #, no-wrap
23764 msgid ""
23765 " char **\n"
23766 " guestfs_aug_match (guestfs_h *g,\n"
23767 "                    const char *augpath);\n"
23768 "\n"
23769 msgstr ""
23770
23771 #. type: =head2
23772 #: ../src/guestfs-actions.pod:496
23773 msgid "guestfs_aug_mv"
23774 msgstr ""
23775
23776 #. type: verbatim
23777 #: ../src/guestfs-actions.pod:498
23778 #, no-wrap
23779 msgid ""
23780 " int\n"
23781 " guestfs_aug_mv (guestfs_h *g,\n"
23782 "                 const char *src,\n"
23783 "                 const char *dest);\n"
23784 "\n"
23785 msgstr ""
23786
23787 #. type: =head2
23788 #: ../src/guestfs-actions.pod:510
23789 msgid "guestfs_aug_rm"
23790 msgstr ""
23791
23792 #. type: verbatim
23793 #: ../src/guestfs-actions.pod:512
23794 #, no-wrap
23795 msgid ""
23796 " int\n"
23797 " guestfs_aug_rm (guestfs_h *g,\n"
23798 "                 const char *augpath);\n"
23799 "\n"
23800 msgstr ""
23801
23802 #. type: =head2
23803 #: ../src/guestfs-actions.pod:524
23804 msgid "guestfs_aug_save"
23805 msgstr ""
23806
23807 #. type: verbatim
23808 #: ../src/guestfs-actions.pod:526
23809 #, no-wrap
23810 msgid ""
23811 " int\n"
23812 " guestfs_aug_save (guestfs_h *g);\n"
23813 "\n"
23814 msgstr ""
23815
23816 #. type: textblock
23817 #: ../src/guestfs-actions.pod:531
23818 msgid ""
23819 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
23820 "are saved."
23821 msgstr ""
23822
23823 #. type: =head2
23824 #: ../src/guestfs-actions.pod:538
23825 msgid "guestfs_aug_set"
23826 msgstr ""
23827
23828 #. type: verbatim
23829 #: ../src/guestfs-actions.pod:540
23830 #, no-wrap
23831 msgid ""
23832 " int\n"
23833 " guestfs_aug_set (guestfs_h *g,\n"
23834 "                  const char *augpath,\n"
23835 "                  const char *val);\n"
23836 "\n"
23837 msgstr ""
23838
23839 #. type: textblock
23840 #: ../src/guestfs-actions.pod:547
23841 msgid ""
23842 "In the Augeas API, it is possible to clear a node by setting the value to "
23843 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
23844 "this call.  Instead you must use the C<guestfs_aug_clear> call."
23845 msgstr ""
23846
23847 #. type: =head2
23848 #: ../src/guestfs-actions.pod:556
23849 msgid "guestfs_available"
23850 msgstr ""
23851
23852 #. type: verbatim
23853 #: ../src/guestfs-actions.pod:558
23854 #, no-wrap
23855 msgid ""
23856 " int\n"
23857 " guestfs_available (guestfs_h *g,\n"
23858 "                    char *const *groups);\n"
23859 "\n"
23860 msgstr ""
23861
23862 #. type: textblock
23863 #: ../src/guestfs-actions.pod:566
23864 msgid ""
23865 "The libguestfs groups, and the functions that those groups correspond to, "
23866 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
23867 "runtime by calling C<guestfs_available_all_groups>."
23868 msgstr ""
23869
23870 #. type: textblock
23871 #: ../src/guestfs-actions.pod:590
23872 msgid "You must call C<guestfs_launch> before calling this function."
23873 msgstr ""
23874
23875 #. type: textblock
23876 #: ../src/guestfs-actions.pod:612
23877 msgid ""
23878 "This call was added in version C<1.0.80>.  In previous versions of "
23879 "libguestfs all you could do would be to speculatively execute a command to "
23880 "find out if the daemon implemented it.  See also C<guestfs_version>."
23881 msgstr ""
23882
23883 #. type: textblock
23884 #: ../src/guestfs-actions.pod:621 ../src/guestfs-actions.pod:1241
23885 msgid "(Added in 1.0.80)"
23886 msgstr ""
23887
23888 #. type: =head2
23889 #: ../src/guestfs-actions.pod:623
23890 msgid "guestfs_available_all_groups"
23891 msgstr ""
23892
23893 #. type: verbatim
23894 #: ../src/guestfs-actions.pod:625
23895 #, no-wrap
23896 msgid ""
23897 " char **\n"
23898 " guestfs_available_all_groups (guestfs_h *g);\n"
23899 "\n"
23900 msgstr ""
23901
23902 #. type: textblock
23903 #: ../src/guestfs-actions.pod:628
23904 msgid ""
23905 "This command returns a list of all optional groups that this daemon knows "
23906 "about.  Note this returns both supported and unsupported groups.  To find "
23907 "out which ones the daemon can actually support you have to call "
23908 "C<guestfs_available> on each member of the returned list."
23909 msgstr ""
23910
23911 #. type: textblock
23912 #: ../src/guestfs-actions.pod:634
23913 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
23914 msgstr ""
23915
23916 #. type: textblock
23917 #: ../src/guestfs-actions.pod:640
23918 msgid "(Added in 1.3.15)"
23919 msgstr ""
23920
23921 #. type: =head2
23922 #: ../src/guestfs-actions.pod:642
23923 msgid "guestfs_base64_in"
23924 msgstr ""
23925
23926 #. type: verbatim
23927 #: ../src/guestfs-actions.pod:644
23928 #, no-wrap
23929 msgid ""
23930 " int\n"
23931 " guestfs_base64_in (guestfs_h *g,\n"
23932 "                    const char *base64file,\n"
23933 "                    const char *filename);\n"
23934 "\n"
23935 msgstr ""
23936
23937 #. type: textblock
23938 #: ../src/guestfs-actions.pod:654 ../src/guestfs-actions.pod:668
23939 msgid "(Added in 1.3.5)"
23940 msgstr ""
23941
23942 #. type: =head2
23943 #: ../src/guestfs-actions.pod:656
23944 msgid "guestfs_base64_out"
23945 msgstr ""
23946
23947 #. type: verbatim
23948 #: ../src/guestfs-actions.pod:658
23949 #, no-wrap
23950 msgid ""
23951 " int\n"
23952 " guestfs_base64_out (guestfs_h *g,\n"
23953 "                     const char *filename,\n"
23954 "                     const char *base64file);\n"
23955 "\n"
23956 msgstr ""
23957
23958 #. type: =head2
23959 #: ../src/guestfs-actions.pod:670
23960 msgid "guestfs_blockdev_flushbufs"
23961 msgstr ""
23962
23963 #. type: verbatim
23964 #: ../src/guestfs-actions.pod:672
23965 #, no-wrap
23966 msgid ""
23967 " int\n"
23968 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
23969 "                             const char *device);\n"
23970 "\n"
23971 msgstr ""
23972
23973 #. type: textblock
23974 #: ../src/guestfs-actions.pod:683 ../src/guestfs-actions.pod:700
23975 #: ../src/guestfs-actions.pod:715 ../src/guestfs-actions.pod:731
23976 #: ../src/guestfs-actions.pod:749 ../src/guestfs-actions.pod:768
23977 #: ../src/guestfs-actions.pod:782 ../src/guestfs-actions.pod:800
23978 #: ../src/guestfs-actions.pod:814 ../src/guestfs-actions.pod:828
23979 msgid "(Added in 0.9.3)"
23980 msgstr ""
23981
23982 #. type: =head2
23983 #: ../src/guestfs-actions.pod:685
23984 msgid "guestfs_blockdev_getbsz"
23985 msgstr ""
23986
23987 #. type: verbatim
23988 #: ../src/guestfs-actions.pod:687
23989 #, no-wrap
23990 msgid ""
23991 " int\n"
23992 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
23993 "                          const char *device);\n"
23994 "\n"
23995 msgstr ""
23996
23997 #. type: =head2
23998 #: ../src/guestfs-actions.pod:702
23999 msgid "guestfs_blockdev_getro"
24000 msgstr ""
24001
24002 #. type: verbatim
24003 #: ../src/guestfs-actions.pod:704
24004 #, no-wrap
24005 msgid ""
24006 " int\n"
24007 " guestfs_blockdev_getro (guestfs_h *g,\n"
24008 "                         const char *device);\n"
24009 "\n"
24010 msgstr ""
24011
24012 #. type: textblock
24013 #: ../src/guestfs-actions.pod:713 ../src/guestfs-actions.pod:1479
24014 #: ../src/guestfs-actions.pod:1494 ../src/guestfs-actions.pod:1983
24015 #: ../src/guestfs-actions.pod:1994 ../src/guestfs-actions.pod:2066
24016 #: ../src/guestfs-actions.pod:2092 ../src/guestfs-actions.pod:2132
24017 #: ../src/guestfs-actions.pod:2147 ../src/guestfs-actions.pod:2172
24018 #: ../src/guestfs-actions.pod:2195 ../src/guestfs-actions.pod:3231
24019 #: ../src/guestfs-actions.pod:3247 ../src/guestfs-actions.pod:3265
24020 #: ../src/guestfs-actions.pod:3427 ../src/guestfs-actions.pod:3441
24021 #: ../src/guestfs-actions.pod:3456 ../src/guestfs-actions.pod:3470
24022 #: ../src/guestfs-actions.pod:3486 ../src/guestfs-actions.pod:3501
24023 #: ../src/guestfs-actions.pod:3517 ../src/guestfs-actions.pod:3531
24024 #: ../src/guestfs-actions.pod:3544 ../src/guestfs-actions.pod:3558
24025 #: ../src/guestfs-actions.pod:3573 ../src/guestfs-actions.pod:3588
24026 #: ../src/guestfs-actions.pod:3601 ../src/guestfs-actions.pod:3615
24027 #: ../src/guestfs-actions.pod:5344
24028 msgid "This function returns a C truth value on success or -1 on error."
24029 msgstr ""
24030
24031 #. type: =head2
24032 #: ../src/guestfs-actions.pod:717
24033 msgid "guestfs_blockdev_getsize64"
24034 msgstr ""
24035
24036 #. type: verbatim
24037 #: ../src/guestfs-actions.pod:719
24038 #, no-wrap
24039 msgid ""
24040 " int64_t\n"
24041 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
24042 "                             const char *device);\n"
24043 "\n"
24044 msgstr ""
24045
24046 #. type: textblock
24047 #: ../src/guestfs-actions.pod:725
24048 msgid "See also C<guestfs_blockdev_getsz>."
24049 msgstr ""
24050
24051 #. type: =head2
24052 #: ../src/guestfs-actions.pod:733
24053 msgid "guestfs_blockdev_getss"
24054 msgstr ""
24055
24056 #. type: verbatim
24057 #: ../src/guestfs-actions.pod:735
24058 #, no-wrap
24059 msgid ""
24060 " int\n"
24061 " guestfs_blockdev_getss (guestfs_h *g,\n"
24062 "                         const char *device);\n"
24063 "\n"
24064 msgstr ""
24065
24066 #. type: textblock
24067 #: ../src/guestfs-actions.pod:742
24068 msgid ""
24069 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
24070 "that)."
24071 msgstr ""
24072
24073 #. type: =head2
24074 #: ../src/guestfs-actions.pod:751
24075 msgid "guestfs_blockdev_getsz"
24076 msgstr ""
24077
24078 #. type: verbatim
24079 #: ../src/guestfs-actions.pod:753
24080 #, no-wrap
24081 msgid ""
24082 " int64_t\n"
24083 " guestfs_blockdev_getsz (guestfs_h *g,\n"
24084 "                         const char *device);\n"
24085 "\n"
24086 msgstr ""
24087
24088 #. type: textblock
24089 #: ../src/guestfs-actions.pod:760
24090 msgid ""
24091 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
24092 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
24093 msgstr ""
24094
24095 #. type: =head2
24096 #: ../src/guestfs-actions.pod:770
24097 msgid "guestfs_blockdev_rereadpt"
24098 msgstr ""
24099
24100 #. type: verbatim
24101 #: ../src/guestfs-actions.pod:772
24102 #, no-wrap
24103 msgid ""
24104 " int\n"
24105 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
24106 "                            const char *device);\n"
24107 "\n"
24108 msgstr ""
24109
24110 #. type: =head2
24111 #: ../src/guestfs-actions.pod:784
24112 msgid "guestfs_blockdev_setbsz"
24113 msgstr ""
24114
24115 #. type: verbatim
24116 #: ../src/guestfs-actions.pod:786
24117 #, no-wrap
24118 msgid ""
24119 " int\n"
24120 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
24121 "                          const char *device,\n"
24122 "                          int blocksize);\n"
24123 "\n"
24124 msgstr ""
24125
24126 #. type: =head2
24127 #: ../src/guestfs-actions.pod:802
24128 msgid "guestfs_blockdev_setro"
24129 msgstr ""
24130
24131 #. type: verbatim
24132 #: ../src/guestfs-actions.pod:804
24133 #, no-wrap
24134 msgid ""
24135 " int\n"
24136 " guestfs_blockdev_setro (guestfs_h *g,\n"
24137 "                         const char *device);\n"
24138 "\n"
24139 msgstr ""
24140
24141 #. type: =head2
24142 #: ../src/guestfs-actions.pod:816
24143 msgid "guestfs_blockdev_setrw"
24144 msgstr ""
24145
24146 #. type: verbatim
24147 #: ../src/guestfs-actions.pod:818
24148 #, no-wrap
24149 msgid ""
24150 " int\n"
24151 " guestfs_blockdev_setrw (guestfs_h *g,\n"
24152 "                         const char *device);\n"
24153 "\n"
24154 msgstr ""
24155
24156 #. type: =head2
24157 #: ../src/guestfs-actions.pod:830
24158 msgid "guestfs_btrfs_filesystem_resize"
24159 msgstr ""
24160
24161 #. type: verbatim
24162 #: ../src/guestfs-actions.pod:832
24163 #, no-wrap
24164 msgid ""
24165 " int\n"
24166 " guestfs_btrfs_filesystem_resize (guestfs_h *g,\n"
24167 "                                  const char *mountpoint,\n"
24168 "                                  ...);\n"
24169 "\n"
24170 msgstr ""
24171
24172 #. type: verbatim
24173 #: ../src/guestfs-actions.pod:842
24174 #, no-wrap
24175 msgid ""
24176 " GUESTFS_BTRFS_FILESYSTEM_RESIZE_SIZE, int64_t size,\n"
24177 "\n"
24178 msgstr ""
24179
24180 #. type: textblock
24181 #: ../src/guestfs-actions.pod:865
24182 msgid "(Added in 1.11.17)"
24183 msgstr ""
24184
24185 #. type: =head2
24186 #: ../src/guestfs-actions.pod:867
24187 msgid "guestfs_btrfs_filesystem_resize_va"
24188 msgstr ""
24189
24190 #. type: verbatim
24191 #: ../src/guestfs-actions.pod:869
24192 #, no-wrap
24193 msgid ""
24194 " int\n"
24195 " guestfs_btrfs_filesystem_resize_va (guestfs_h *g,\n"
24196 "                                     const char *mountpoint,\n"
24197 "                                     va_list args);\n"
24198 "\n"
24199 msgstr ""
24200
24201 #. type: textblock
24202 #: ../src/guestfs-actions.pod:874
24203 msgid "This is the \"va_list variant\" of L</guestfs_btrfs_filesystem_resize>."
24204 msgstr ""
24205
24206 #. type: =head2
24207 #: ../src/guestfs-actions.pod:878
24208 msgid "guestfs_btrfs_filesystem_resize_argv"
24209 msgstr ""
24210
24211 #. type: verbatim
24212 #: ../src/guestfs-actions.pod:880
24213 #, no-wrap
24214 msgid ""
24215 " int\n"
24216 " guestfs_btrfs_filesystem_resize_argv (guestfs_h *g,\n"
24217 "                                       const char *mountpoint,\n"
24218 "                                       const struct guestfs_btrfs_filesystem_resize_argv *optargs);\n"
24219 "\n"
24220 msgstr ""
24221
24222 #. type: textblock
24223 #: ../src/guestfs-actions.pod:885
24224 msgid "This is the \"argv variant\" of L</guestfs_btrfs_filesystem_resize>."
24225 msgstr ""
24226
24227 #. type: =head2
24228 #: ../src/guestfs-actions.pod:889
24229 msgid "guestfs_case_sensitive_path"
24230 msgstr ""
24231
24232 #. type: verbatim
24233 #: ../src/guestfs-actions.pod:891
24234 #, no-wrap
24235 msgid ""
24236 " char *\n"
24237 " guestfs_case_sensitive_path (guestfs_h *g,\n"
24238 "                              const char *path);\n"
24239 "\n"
24240 msgstr ""
24241
24242 #. type: textblock
24243 #: ../src/guestfs-actions.pod:917
24244 msgid ""
24245 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
24246 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
24247 "how the directories were originally created under Windows)."
24248 msgstr ""
24249
24250 #. type: textblock
24251 #: ../src/guestfs-actions.pod:925
24252 msgid "See also C<guestfs_realpath>."
24253 msgstr ""
24254
24255 #. type: textblock
24256 #: ../src/guestfs-actions.pod:930 ../src/guestfs-actions.pod:7392
24257 msgid "(Added in 1.0.75)"
24258 msgstr ""
24259
24260 #. type: =head2
24261 #: ../src/guestfs-actions.pod:932
24262 msgid "guestfs_cat"
24263 msgstr ""
24264
24265 #. type: verbatim
24266 #: ../src/guestfs-actions.pod:934
24267 #, no-wrap
24268 msgid ""
24269 " char *\n"
24270 " guestfs_cat (guestfs_h *g,\n"
24271 "              const char *path);\n"
24272 "\n"
24273 msgstr ""
24274
24275 #. type: textblock
24276 #: ../src/guestfs-actions.pod:940
24277 msgid ""
24278 "Note that this function cannot correctly handle binary files (specifically, "
24279 "files containing C<\\0> character which is treated as end of string).  For "
24280 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
24281 "functions which have a more complex interface."
24282 msgstr ""
24283
24284 #. type: textblock
24285 #: ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:3745
24286 #: ../src/guestfs-actions.pod:3827 ../src/guestfs-actions.pod:3844
24287 #: ../src/guestfs-actions.pod:3932 ../src/guestfs-actions.pod:4340
24288 #: ../src/guestfs-actions.pod:4354 ../src/guestfs-actions.pod:5725
24289 #: ../src/guestfs-actions.pod:5739 ../src/guestfs-actions.pod:7545
24290 #: ../src/guestfs-actions.pod:7559
24291 msgid "(Added in 0.4)"
24292 msgstr ""
24293
24294 #. type: =head2
24295 #: ../src/guestfs-actions.pod:953
24296 msgid "guestfs_checksum"
24297 msgstr ""
24298
24299 #. type: verbatim
24300 #: ../src/guestfs-actions.pod:955
24301 #, no-wrap
24302 msgid ""
24303 " char *\n"
24304 " guestfs_checksum (guestfs_h *g,\n"
24305 "                   const char *csumtype,\n"
24306 "                   const char *path);\n"
24307 "\n"
24308 msgstr ""
24309
24310 #. type: textblock
24311 #: ../src/guestfs-actions.pod:1001
24312 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
24313 msgstr ""
24314
24315 #. type: textblock
24316 #: ../src/guestfs-actions.pod:1003
24317 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
24318 msgstr ""
24319
24320 #. type: textblock
24321 #: ../src/guestfs-actions.pod:1008 ../src/guestfs-actions.pod:1316
24322 #: ../src/guestfs-actions.pod:2163 ../src/guestfs-actions.pod:3443
24323 #: ../src/guestfs-actions.pod:3472 ../src/guestfs-actions.pod:3533
24324 #: ../src/guestfs-actions.pod:3560 ../src/guestfs-actions.pod:7248
24325 msgid "(Added in 1.0.2)"
24326 msgstr ""
24327
24328 #. type: =head2
24329 #: ../src/guestfs-actions.pod:1010
24330 msgid "guestfs_checksum_device"
24331 msgstr ""
24332
24333 #. type: verbatim
24334 #: ../src/guestfs-actions.pod:1012
24335 #, no-wrap
24336 msgid ""
24337 " char *\n"
24338 " guestfs_checksum_device (guestfs_h *g,\n"
24339 "                          const char *csumtype,\n"
24340 "                          const char *device);\n"
24341 "\n"
24342 msgstr ""
24343
24344 #. type: textblock
24345 #: ../src/guestfs-actions.pod:1017
24346 msgid ""
24347 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
24348 "device named C<device>.  For the types of checksums supported see the "
24349 "C<guestfs_checksum> command."
24350 msgstr ""
24351
24352 #. type: textblock
24353 #: ../src/guestfs-actions.pod:1024 ../src/guestfs-actions.pod:5174
24354 #: ../src/guestfs-actions.pod:5309 ../src/guestfs-actions.pod:5346
24355 #: ../src/guestfs-actions.pod:5364 ../src/guestfs-actions.pod:5546
24356 #: ../src/guestfs-actions.pod:7157 ../src/guestfs-actions.pod:7171
24357 #: ../src/guestfs-actions.pod:7571
24358 msgid "(Added in 1.3.2)"
24359 msgstr ""
24360
24361 #. type: =head2
24362 #: ../src/guestfs-actions.pod:1026
24363 msgid "guestfs_checksums_out"
24364 msgstr ""
24365
24366 #. type: verbatim
24367 #: ../src/guestfs-actions.pod:1028
24368 #, no-wrap
24369 msgid ""
24370 " int\n"
24371 " guestfs_checksums_out (guestfs_h *g,\n"
24372 "                        const char *csumtype,\n"
24373 "                        const char *directory,\n"
24374 "                        const char *sumsfile);\n"
24375 "\n"
24376 msgstr ""
24377
24378 #. type: textblock
24379 #: ../src/guestfs-actions.pod:1048
24380 msgid "(Added in 1.3.7)"
24381 msgstr ""
24382
24383 #. type: =head2
24384 #: ../src/guestfs-actions.pod:1050
24385 msgid "guestfs_chmod"
24386 msgstr ""
24387
24388 #. type: verbatim
24389 #: ../src/guestfs-actions.pod:1052
24390 #, no-wrap
24391 msgid ""
24392 " int\n"
24393 " guestfs_chmod (guestfs_h *g,\n"
24394 "                int mode,\n"
24395 "                const char *path);\n"
24396 "\n"
24397 msgstr ""
24398
24399 #. type: =head2
24400 #: ../src/guestfs-actions.pod:1070
24401 msgid "guestfs_chown"
24402 msgstr ""
24403
24404 #. type: verbatim
24405 #: ../src/guestfs-actions.pod:1072
24406 #, no-wrap
24407 msgid ""
24408 " int\n"
24409 " guestfs_chown (guestfs_h *g,\n"
24410 "                int owner,\n"
24411 "                int group,\n"
24412 "                const char *path);\n"
24413 "\n"
24414 msgstr ""
24415
24416 #. type: =head2
24417 #: ../src/guestfs-actions.pod:1088
24418 msgid "guestfs_command"
24419 msgstr ""
24420
24421 #. type: verbatim
24422 #: ../src/guestfs-actions.pod:1090
24423 #, no-wrap
24424 msgid ""
24425 " char *\n"
24426 " guestfs_command (guestfs_h *g,\n"
24427 "                  char *const *arguments);\n"
24428 "\n"
24429 msgstr ""
24430
24431 #. type: textblock
24432 #: ../src/guestfs-actions.pod:1099
24433 msgid ""
24434 "The single parameter is an argv-style list of arguments.  The first element "
24435 "is the name of the program to run.  Subsequent elements are parameters.  The "
24436 "list must be non-empty (ie. must contain a program name).  Note that the "
24437 "command runs directly, and is I<not> invoked via the shell (see "
24438 "C<guestfs_sh>)."
24439 msgstr ""
24440
24441 #. type: textblock
24442 #: ../src/guestfs-actions.pod:1130 ../src/guestfs-actions.pod:1150
24443 #: ../src/guestfs-actions.pod:1615
24444 msgid "(Added in 0.9.1)"
24445 msgstr ""
24446
24447 #. type: =head2
24448 #: ../src/guestfs-actions.pod:1132
24449 msgid "guestfs_command_lines"
24450 msgstr ""
24451
24452 #. type: verbatim
24453 #: ../src/guestfs-actions.pod:1134
24454 #, no-wrap
24455 msgid ""
24456 " char **\n"
24457 " guestfs_command_lines (guestfs_h *g,\n"
24458 "                        char *const *arguments);\n"
24459 "\n"
24460 msgstr ""
24461
24462 #. type: textblock
24463 #: ../src/guestfs-actions.pod:1138
24464 msgid ""
24465 "This is the same as C<guestfs_command>, but splits the result into a list of "
24466 "lines."
24467 msgstr ""
24468
24469 #. type: textblock
24470 #: ../src/guestfs-actions.pod:1141
24471 msgid "See also: C<guestfs_sh_lines>"
24472 msgstr ""
24473
24474 #. type: =head2
24475 #: ../src/guestfs-actions.pod:1152
24476 msgid "guestfs_config"
24477 msgstr ""
24478
24479 #. type: verbatim
24480 #: ../src/guestfs-actions.pod:1154
24481 #, no-wrap
24482 msgid ""
24483 " int\n"
24484 " guestfs_config (guestfs_h *g,\n"
24485 "                 const char *qemuparam,\n"
24486 "                 const char *qemuvalue);\n"
24487 "\n"
24488 msgstr ""
24489
24490 #. type: =head2
24491 #: ../src/guestfs-actions.pod:1172
24492 msgid "guestfs_copy_size"
24493 msgstr ""
24494
24495 #. type: verbatim
24496 #: ../src/guestfs-actions.pod:1174
24497 #, no-wrap
24498 msgid ""
24499 " int\n"
24500 " guestfs_copy_size (guestfs_h *g,\n"
24501 "                    const char *src,\n"
24502 "                    const char *dest,\n"
24503 "                    int64_t size);\n"
24504 "\n"
24505 msgstr ""
24506
24507 #. type: textblock
24508 #: ../src/guestfs-actions.pod:1188 ../src/guestfs-actions.pod:1311
24509 #: ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:1387
24510 #: ../src/guestfs-actions.pod:1764 ../src/guestfs-actions.pod:1786
24511 #: ../src/guestfs-actions.pod:3643 ../src/guestfs-actions.pod:7243
24512 #: ../src/guestfs-actions.pod:7277 ../src/guestfs-actions.pod:7784
24513 #: ../src/guestfs-actions.pod:7807
24514 msgid ""
24515 "This long-running command can generate progress notification messages so "
24516 "that the caller can display a progress bar or indicator.  To receive these "
24517 "messages, the caller must register a progress event callback.  See L<guestfs"
24518 "(3)/GUESTFS_EVENT_PROGRESS>."
24519 msgstr ""
24520
24521 #. type: textblock
24522 #: ../src/guestfs-actions.pod:1193 ../src/guestfs-actions.pod:4367
24523 #: ../src/guestfs-actions.pod:5752 ../src/guestfs-actions.pod:7478
24524 #: ../src/guestfs-actions.pod:7498 ../src/guestfs-actions.pod:7584
24525 msgid "(Added in 1.0.87)"
24526 msgstr ""
24527
24528 #. type: =head2
24529 #: ../src/guestfs-actions.pod:1195
24530 msgid "guestfs_cp"
24531 msgstr ""
24532
24533 #. type: verbatim
24534 #: ../src/guestfs-actions.pod:1197
24535 #, no-wrap
24536 msgid ""
24537 " int\n"
24538 " guestfs_cp (guestfs_h *g,\n"
24539 "             const char *src,\n"
24540 "             const char *dest);\n"
24541 "\n"
24542 msgstr ""
24543
24544 #. type: textblock
24545 #: ../src/guestfs-actions.pod:1207 ../src/guestfs-actions.pod:1221
24546 #: ../src/guestfs-actions.pod:1293 ../src/guestfs-actions.pod:1367
24547 #: ../src/guestfs-actions.pod:1481 ../src/guestfs-actions.pod:5121
24548 #: ../src/guestfs-actions.pod:5596
24549 msgid "(Added in 1.0.18)"
24550 msgstr ""
24551
24552 #. type: =head2
24553 #: ../src/guestfs-actions.pod:1209
24554 msgid "guestfs_cp_a"
24555 msgstr ""
24556
24557 #. type: verbatim
24558 #: ../src/guestfs-actions.pod:1211
24559 #, no-wrap
24560 msgid ""
24561 " int\n"
24562 " guestfs_cp_a (guestfs_h *g,\n"
24563 "               const char *src,\n"
24564 "               const char *dest);\n"
24565 "\n"
24566 msgstr ""
24567
24568 #. type: =head2
24569 #: ../src/guestfs-actions.pod:1223
24570 msgid "guestfs_dd"
24571 msgstr ""
24572
24573 #. type: verbatim
24574 #: ../src/guestfs-actions.pod:1225
24575 #, no-wrap
24576 msgid ""
24577 " int\n"
24578 " guestfs_dd (guestfs_h *g,\n"
24579 "             const char *src,\n"
24580 "             const char *dest);\n"
24581 "\n"
24582 msgstr ""
24583
24584 #. type: textblock
24585 #: ../src/guestfs-actions.pod:1235
24586 msgid ""
24587 "If the destination is a device, it must be as large or larger than the "
24588 "source file or device, otherwise the copy will fail.  This command cannot do "
24589 "partial copies (see C<guestfs_copy_size>)."
24590 msgstr ""
24591
24592 #. type: =head2
24593 #: ../src/guestfs-actions.pod:1243
24594 msgid "guestfs_df"
24595 msgstr ""
24596
24597 #. type: verbatim
24598 #: ../src/guestfs-actions.pod:1245
24599 #, no-wrap
24600 msgid ""
24601 " char *\n"
24602 " guestfs_df (guestfs_h *g);\n"
24603 "\n"
24604 msgstr ""
24605
24606 #. type: textblock
24607 #: ../src/guestfs-actions.pod:1250 ../src/guestfs-actions.pod:1267
24608 msgid ""
24609 "This command is mostly useful for interactive sessions.  It is I<not> "
24610 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
24611 "from programs."
24612 msgstr ""
24613
24614 #. type: textblock
24615 #: ../src/guestfs-actions.pod:1257 ../src/guestfs-actions.pod:1274
24616 #: ../src/guestfs-actions.pod:1392 ../src/guestfs-actions.pod:2366
24617 #: ../src/guestfs-actions.pod:2390 ../src/guestfs-actions.pod:2458
24618 #: ../src/guestfs-actions.pod:4477 ../src/guestfs-actions.pod:5021
24619 #: ../src/guestfs-actions.pod:6981 ../src/guestfs-actions.pod:7005
24620 #: ../src/guestfs-actions.pod:7624 ../src/guestfs-actions.pod:7637
24621 #: ../src/guestfs-actions.pod:7650
24622 msgid "(Added in 1.0.54)"
24623 msgstr ""
24624
24625 #. type: =head2
24626 #: ../src/guestfs-actions.pod:1259
24627 msgid "guestfs_df_h"
24628 msgstr ""
24629
24630 #. type: verbatim
24631 #: ../src/guestfs-actions.pod:1261
24632 #, no-wrap
24633 msgid ""
24634 " char *\n"
24635 " guestfs_df_h (guestfs_h *g);\n"
24636 "\n"
24637 msgstr ""
24638
24639 #. type: =head2
24640 #: ../src/guestfs-actions.pod:1276
24641 msgid "guestfs_dmesg"
24642 msgstr ""
24643
24644 #. type: verbatim
24645 #: ../src/guestfs-actions.pod:1278
24646 #, no-wrap
24647 msgid ""
24648 " char *\n"
24649 " guestfs_dmesg (guestfs_h *g);\n"
24650 "\n"
24651 msgstr ""
24652
24653 #. type: textblock
24654 #: ../src/guestfs-actions.pod:1285
24655 msgid ""
24656 "Another way to get the same information is to enable verbose messages with "
24657 "C<guestfs_set_verbose> or by setting the environment variable "
24658 "C<LIBGUESTFS_DEBUG=1> before running the program."
24659 msgstr ""
24660
24661 #. type: =head2
24662 #: ../src/guestfs-actions.pod:1295
24663 msgid "guestfs_download"
24664 msgstr ""
24665
24666 #. type: verbatim
24667 #: ../src/guestfs-actions.pod:1297
24668 #, no-wrap
24669 msgid ""
24670 " int\n"
24671 " guestfs_download (guestfs_h *g,\n"
24672 "                   const char *remotefilename,\n"
24673 "                   const char *filename);\n"
24674 "\n"
24675 msgstr ""
24676
24677 #. type: textblock
24678 #: ../src/guestfs-actions.pod:1307
24679 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
24680 msgstr ""
24681
24682 #. type: =head2
24683 #: ../src/guestfs-actions.pod:1318
24684 msgid "guestfs_download_offset"
24685 msgstr ""
24686
24687 #. type: verbatim
24688 #: ../src/guestfs-actions.pod:1320
24689 #, no-wrap
24690 msgid ""
24691 " int\n"
24692 " guestfs_download_offset (guestfs_h *g,\n"
24693 "                          const char *remotefilename,\n"
24694 "                          const char *filename,\n"
24695 "                          int64_t offset,\n"
24696 "                          int64_t size);\n"
24697 "\n"
24698 msgstr ""
24699
24700 #. type: textblock
24701 #: ../src/guestfs-actions.pod:1333
24702 msgid ""
24703 "Note that there is no limit on the amount of data that can be downloaded "
24704 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
24705 "full amount unless an error occurs."
24706 msgstr ""
24707
24708 #. type: textblock
24709 #: ../src/guestfs-actions.pod:1338
24710 msgid "See also C<guestfs_download>, C<guestfs_pread>."
24711 msgstr ""
24712
24713 #. type: textblock
24714 #: ../src/guestfs-actions.pod:1347 ../src/guestfs-actions.pod:7282
24715 msgid "(Added in 1.5.17)"
24716 msgstr ""
24717
24718 #. type: =head2
24719 #: ../src/guestfs-actions.pod:1349
24720 msgid "guestfs_drop_caches"
24721 msgstr ""
24722
24723 #. type: verbatim
24724 #: ../src/guestfs-actions.pod:1351
24725 #, no-wrap
24726 msgid ""
24727 " int\n"
24728 " guestfs_drop_caches (guestfs_h *g,\n"
24729 "                      int whattodrop);\n"
24730 "\n"
24731 msgstr ""
24732
24733 #. type: =head2
24734 #: ../src/guestfs-actions.pod:1369
24735 msgid "guestfs_du"
24736 msgstr ""
24737
24738 #. type: verbatim
24739 #: ../src/guestfs-actions.pod:1371
24740 #, no-wrap
24741 msgid ""
24742 " int64_t\n"
24743 " guestfs_du (guestfs_h *g,\n"
24744 "             const char *path);\n"
24745 "\n"
24746 msgstr ""
24747
24748 #. type: =head2
24749 #: ../src/guestfs-actions.pod:1394
24750 msgid "guestfs_e2fsck_f"
24751 msgstr ""
24752
24753 #. type: verbatim
24754 #: ../src/guestfs-actions.pod:1396
24755 #, no-wrap
24756 msgid ""
24757 " int\n"
24758 " guestfs_e2fsck_f (guestfs_h *g,\n"
24759 "                   const char *device);\n"
24760 "\n"
24761 msgstr ""
24762
24763 #. type: textblock
24764 #: ../src/guestfs-actions.pod:1404
24765 msgid ""
24766 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
24767 "Normally you should use C<guestfs_fsck>."
24768 msgstr ""
24769
24770 #. type: textblock
24771 #: ../src/guestfs-actions.pod:1409
24772 msgid "(Added in 1.0.29)"
24773 msgstr ""
24774
24775 #. type: =head2
24776 #: ../src/guestfs-actions.pod:1411
24777 msgid "guestfs_echo_daemon"
24778 msgstr ""
24779
24780 #. type: verbatim
24781 #: ../src/guestfs-actions.pod:1413
24782 #, no-wrap
24783 msgid ""
24784 " char *\n"
24785 " guestfs_echo_daemon (guestfs_h *g,\n"
24786 "                      char *const *words);\n"
24787 "\n"
24788 msgstr ""
24789
24790 #. type: textblock
24791 #: ../src/guestfs-actions.pod:1422
24792 msgid "See also C<guestfs_ping_daemon>."
24793 msgstr ""
24794
24795 #. type: textblock
24796 #: ../src/guestfs-actions.pod:1427 ../src/guestfs-actions.pod:2174
24797 #: ../src/guestfs-actions.pod:6453
24798 msgid "(Added in 1.0.69)"
24799 msgstr ""
24800
24801 #. type: =head2
24802 #: ../src/guestfs-actions.pod:1429
24803 msgid "guestfs_egrep"
24804 msgstr ""
24805
24806 #. type: verbatim
24807 #: ../src/guestfs-actions.pod:1431
24808 #, no-wrap
24809 msgid ""
24810 " char **\n"
24811 " guestfs_egrep (guestfs_h *g,\n"
24812 "                const char *regex,\n"
24813 "                const char *path);\n"
24814 "\n"
24815 msgstr ""
24816
24817 #. type: textblock
24818 #: ../src/guestfs-actions.pod:1446 ../src/guestfs-actions.pod:1465
24819 #: ../src/guestfs-actions.pod:1522 ../src/guestfs-actions.pod:1568
24820 #: ../src/guestfs-actions.pod:1587 ../src/guestfs-actions.pod:2304
24821 #: ../src/guestfs-actions.pod:2323 ../src/guestfs-actions.pod:2479
24822 #: ../src/guestfs-actions.pod:2492 ../src/guestfs-actions.pod:2507
24823 #: ../src/guestfs-actions.pod:2553 ../src/guestfs-actions.pod:2575
24824 #: ../src/guestfs-actions.pod:2588 ../src/guestfs-actions.pod:3857
24825 #: ../src/guestfs-actions.pod:3871 ../src/guestfs-actions.pod:3884
24826 #: ../src/guestfs-actions.pod:3898 ../src/guestfs-actions.pod:4899
24827 #: ../src/guestfs-actions.pod:5930 ../src/guestfs-actions.pod:5979
24828 #: ../src/guestfs-actions.pod:6849 ../src/guestfs-actions.pod:6861
24829 #: ../src/guestfs-actions.pod:6874 ../src/guestfs-actions.pod:6887
24830 #: ../src/guestfs-actions.pod:6909 ../src/guestfs-actions.pod:6922
24831 #: ../src/guestfs-actions.pod:6935 ../src/guestfs-actions.pod:6948
24832 #: ../src/guestfs-actions.pod:7742 ../src/guestfs-actions.pod:7761
24833 #: ../src/guestfs-actions.pod:7855 ../src/guestfs-actions.pod:7874
24834 #: ../src/guestfs-actions.pod:7920 ../src/guestfs-actions.pod:7939
24835 msgid "(Added in 1.0.66)"
24836 msgstr ""
24837
24838 #. type: =head2
24839 #: ../src/guestfs-actions.pod:1448
24840 msgid "guestfs_egrepi"
24841 msgstr ""
24842
24843 #. type: verbatim
24844 #: ../src/guestfs-actions.pod:1450
24845 #, no-wrap
24846 msgid ""
24847 " char **\n"
24848 " guestfs_egrepi (guestfs_h *g,\n"
24849 "                 const char *regex,\n"
24850 "                 const char *path);\n"
24851 "\n"
24852 msgstr ""
24853
24854 #. type: =head2
24855 #: ../src/guestfs-actions.pod:1467
24856 msgid "guestfs_equal"
24857 msgstr ""
24858
24859 #. type: verbatim
24860 #: ../src/guestfs-actions.pod:1469
24861 #, no-wrap
24862 msgid ""
24863 " int\n"
24864 " guestfs_equal (guestfs_h *g,\n"
24865 "                const char *file1,\n"
24866 "                const char *file2);\n"
24867 "\n"
24868 msgstr ""
24869
24870 #. type: =head2
24871 #: ../src/guestfs-actions.pod:1483
24872 msgid "guestfs_exists"
24873 msgstr ""
24874
24875 #. type: verbatim
24876 #: ../src/guestfs-actions.pod:1485
24877 #, no-wrap
24878 msgid ""
24879 " int\n"
24880 " guestfs_exists (guestfs_h *g,\n"
24881 "                 const char *path);\n"
24882 "\n"
24883 msgstr ""
24884
24885 #. type: textblock
24886 #: ../src/guestfs-actions.pod:1492
24887 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
24888 msgstr ""
24889
24890 #. type: =head2
24891 #: ../src/guestfs-actions.pod:1498
24892 msgid "guestfs_fallocate"
24893 msgstr ""
24894
24895 #. type: verbatim
24896 #: ../src/guestfs-actions.pod:1500
24897 #, no-wrap
24898 msgid ""
24899 " int\n"
24900 " guestfs_fallocate (guestfs_h *g,\n"
24901 "                    const char *path,\n"
24902 "                    int len);\n"
24903 "\n"
24904 msgstr ""
24905
24906 #. type: textblock
24907 #: ../src/guestfs-actions.pod:1515
24908 msgid ""
24909 "This function is deprecated.  In new code, use the L</guestfs_fallocate64> "
24910 "call instead."
24911 msgstr ""
24912
24913 #. type: =head2
24914 #: ../src/guestfs-actions.pod:1524
24915 msgid "guestfs_fallocate64"
24916 msgstr ""
24917
24918 #. type: verbatim
24919 #: ../src/guestfs-actions.pod:1526
24920 #, no-wrap
24921 msgid ""
24922 " int\n"
24923 " guestfs_fallocate64 (guestfs_h *g,\n"
24924 "                      const char *path,\n"
24925 "                      int64_t len);\n"
24926 "\n"
24927 msgstr ""
24928
24929 #. type: textblock
24930 #: ../src/guestfs-actions.pod:1535
24931 msgid ""
24932 "Note that this call allocates disk blocks for the file.  To create a sparse "
24933 "file use C<guestfs_truncate_size> instead."
24934 msgstr ""
24935
24936 #. type: textblock
24937 #: ../src/guestfs-actions.pod:1538
24938 msgid ""
24939 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
24940 "oversight it only allowed 30 bit lengths to be specified, effectively "
24941 "limiting the maximum size of files created through that call to 1GB."
24942 msgstr ""
24943
24944 #. type: textblock
24945 #: ../src/guestfs-actions.pod:1549
24946 msgid "(Added in 1.3.17)"
24947 msgstr ""
24948
24949 #. type: =head2
24950 #: ../src/guestfs-actions.pod:1551
24951 msgid "guestfs_fgrep"
24952 msgstr ""
24953
24954 #. type: verbatim
24955 #: ../src/guestfs-actions.pod:1553
24956 #, no-wrap
24957 msgid ""
24958 " char **\n"
24959 " guestfs_fgrep (guestfs_h *g,\n"
24960 "                const char *pattern,\n"
24961 "                const char *path);\n"
24962 "\n"
24963 msgstr ""
24964
24965 #. type: =head2
24966 #: ../src/guestfs-actions.pod:1570
24967 msgid "guestfs_fgrepi"
24968 msgstr ""
24969
24970 #. type: verbatim
24971 #: ../src/guestfs-actions.pod:1572
24972 #, no-wrap
24973 msgid ""
24974 " char **\n"
24975 " guestfs_fgrepi (guestfs_h *g,\n"
24976 "                 const char *pattern,\n"
24977 "                 const char *path);\n"
24978 "\n"
24979 msgstr ""
24980
24981 #. type: =head2
24982 #: ../src/guestfs-actions.pod:1589
24983 msgid "guestfs_file"
24984 msgstr ""
24985
24986 #. type: verbatim
24987 #: ../src/guestfs-actions.pod:1591
24988 #, no-wrap
24989 msgid ""
24990 " char *\n"
24991 " guestfs_file (guestfs_h *g,\n"
24992 "               const char *path);\n"
24993 "\n"
24994 msgstr ""
24995
24996 #. type: textblock
24997 #: ../src/guestfs-actions.pod:1609
24998 msgid ""
24999 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
25000 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc), C<guestfs_is_zero>."
25001 msgstr ""
25002
25003 #. type: =head2
25004 #: ../src/guestfs-actions.pod:1617
25005 msgid "guestfs_file_architecture"
25006 msgstr ""
25007
25008 #. type: verbatim
25009 #: ../src/guestfs-actions.pod:1619
25010 #, no-wrap
25011 msgid ""
25012 " char *\n"
25013 " guestfs_file_architecture (guestfs_h *g,\n"
25014 "                            const char *filename);\n"
25015 "\n"
25016 msgstr ""
25017
25018 #. type: textblock
25019 #: ../src/guestfs-actions.pod:1727 ../src/guestfs-actions.pod:1890
25020 #: ../src/guestfs-actions.pod:1907 ../src/guestfs-actions.pod:2608
25021 #: ../src/guestfs-actions.pod:2698 ../src/guestfs-actions.pod:2764
25022 #: ../src/guestfs-actions.pod:2951 ../src/guestfs-actions.pod:2969
25023 #: ../src/guestfs-actions.pod:3009 ../src/guestfs-actions.pod:3084
25024 #: ../src/guestfs-actions.pod:3177 ../src/guestfs-actions.pod:3414
25025 #: ../src/guestfs-actions.pod:3546
25026 msgid "(Added in 1.5.3)"
25027 msgstr ""
25028
25029 #. type: =head2
25030 #: ../src/guestfs-actions.pod:1729
25031 msgid "guestfs_filesize"
25032 msgstr ""
25033
25034 #. type: verbatim
25035 #: ../src/guestfs-actions.pod:1731
25036 #, no-wrap
25037 msgid ""
25038 " int64_t\n"
25039 " guestfs_filesize (guestfs_h *g,\n"
25040 "                   const char *file);\n"
25041 "\n"
25042 msgstr ""
25043
25044 #. type: textblock
25045 #: ../src/guestfs-actions.pod:1737
25046 msgid ""
25047 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
25048 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
25049 "devices, use C<guestfs_blockdev_getsize64>."
25050 msgstr ""
25051
25052 #. type: textblock
25053 #: ../src/guestfs-actions.pod:1743
25054 msgid "(Added in 1.0.82)"
25055 msgstr ""
25056
25057 #. type: =head2
25058 #: ../src/guestfs-actions.pod:1745
25059 msgid "guestfs_fill"
25060 msgstr ""
25061
25062 #. type: verbatim
25063 #: ../src/guestfs-actions.pod:1747
25064 #, no-wrap
25065 msgid ""
25066 " int\n"
25067 " guestfs_fill (guestfs_h *g,\n"
25068 "               int c,\n"
25069 "               int len,\n"
25070 "               const char *path);\n"
25071 "\n"
25072 msgstr ""
25073
25074 #. type: textblock
25075 #: ../src/guestfs-actions.pod:1757
25076 msgid ""
25077 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
25078 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
25079 "bytes use C<guestfs_fill_pattern>."
25080 msgstr ""
25081
25082 #. type: textblock
25083 #: ../src/guestfs-actions.pod:1769
25084 msgid "(Added in 1.0.79)"
25085 msgstr ""
25086
25087 #. type: =head2
25088 #: ../src/guestfs-actions.pod:1771
25089 msgid "guestfs_fill_pattern"
25090 msgstr ""
25091
25092 #. type: verbatim
25093 #: ../src/guestfs-actions.pod:1773
25094 #, no-wrap
25095 msgid ""
25096 " int\n"
25097 " guestfs_fill_pattern (guestfs_h *g,\n"
25098 "                       const char *pattern,\n"
25099 "                       int len,\n"
25100 "                       const char *path);\n"
25101 "\n"
25102 msgstr ""
25103
25104 #. type: textblock
25105 #: ../src/guestfs-actions.pod:1779
25106 msgid ""
25107 "This function is like C<guestfs_fill> except that it creates a new file of "
25108 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
25109 "pattern is truncated if necessary to ensure the length of the file is "
25110 "exactly C<len> bytes."
25111 msgstr ""
25112
25113 #. type: textblock
25114 #: ../src/guestfs-actions.pod:1791
25115 msgid "(Added in 1.3.12)"
25116 msgstr ""
25117
25118 #. type: =head2
25119 #: ../src/guestfs-actions.pod:1793
25120 msgid "guestfs_find"
25121 msgstr ""
25122
25123 #. type: verbatim
25124 #: ../src/guestfs-actions.pod:1795
25125 #, no-wrap
25126 msgid ""
25127 " char **\n"
25128 " guestfs_find (guestfs_h *g,\n"
25129 "               const char *directory);\n"
25130 "\n"
25131 msgstr ""
25132
25133 #. type: textblock
25134 #: ../src/guestfs-actions.pod:1811
25135 msgid ""
25136 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
25137 msgstr ""
25138
25139 #. type: textblock
25140 #: ../src/guestfs-actions.pod:1824
25141 msgid "See also C<guestfs_find0>."
25142 msgstr ""
25143
25144 #. type: textblock
25145 #: ../src/guestfs-actions.pod:1833 ../src/guestfs-actions.pod:4304
25146 #: ../src/guestfs-actions.pod:6014
25147 msgid "(Added in 1.0.27)"
25148 msgstr ""
25149
25150 #. type: =head2
25151 #: ../src/guestfs-actions.pod:1835
25152 msgid "guestfs_find0"
25153 msgstr ""
25154
25155 #. type: verbatim
25156 #: ../src/guestfs-actions.pod:1837
25157 #, no-wrap
25158 msgid ""
25159 " int\n"
25160 " guestfs_find0 (guestfs_h *g,\n"
25161 "                const char *directory,\n"
25162 "                const char *files);\n"
25163 "\n"
25164 msgstr ""
25165
25166 #. type: textblock
25167 #: ../src/guestfs-actions.pod:1846
25168 msgid ""
25169 "This command works the same way as C<guestfs_find> with the following "
25170 "exceptions:"
25171 msgstr ""
25172
25173 #. type: textblock
25174 #: ../src/guestfs-actions.pod:1873
25175 msgid "(Added in 1.0.74)"
25176 msgstr ""
25177
25178 #. type: =head2
25179 #: ../src/guestfs-actions.pod:1875
25180 msgid "guestfs_findfs_label"
25181 msgstr ""
25182
25183 #. type: verbatim
25184 #: ../src/guestfs-actions.pod:1877
25185 #, no-wrap
25186 msgid ""
25187 " char *\n"
25188 " guestfs_findfs_label (guestfs_h *g,\n"
25189 "                       const char *label);\n"
25190 "\n"
25191 msgstr ""
25192
25193 #. type: textblock
25194 #: ../src/guestfs-actions.pod:1885
25195 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
25196 msgstr ""
25197
25198 #. type: =head2
25199 #: ../src/guestfs-actions.pod:1892
25200 msgid "guestfs_findfs_uuid"
25201 msgstr ""
25202
25203 #. type: verbatim
25204 #: ../src/guestfs-actions.pod:1894
25205 #, no-wrap
25206 msgid ""
25207 " char *\n"
25208 " guestfs_findfs_uuid (guestfs_h *g,\n"
25209 "                      const char *uuid);\n"
25210 "\n"
25211 msgstr ""
25212
25213 #. type: textblock
25214 #: ../src/guestfs-actions.pod:1902
25215 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
25216 msgstr ""
25217
25218 #. type: =head2
25219 #: ../src/guestfs-actions.pod:1909
25220 msgid "guestfs_fsck"
25221 msgstr ""
25222
25223 #. type: verbatim
25224 #: ../src/guestfs-actions.pod:1911
25225 #, no-wrap
25226 msgid ""
25227 " int\n"
25228 " guestfs_fsck (guestfs_h *g,\n"
25229 "               const char *fstype,\n"
25230 "               const char *device);\n"
25231 "\n"
25232 msgstr ""
25233
25234 #. type: textblock
25235 #: ../src/guestfs-actions.pod:1946 ../src/guestfs-actions.pod:7789
25236 msgid "(Added in 1.0.16)"
25237 msgstr ""
25238
25239 #. type: =head2
25240 #: ../src/guestfs-actions.pod:1948
25241 msgid "guestfs_get_append"
25242 msgstr ""
25243
25244 #. type: verbatim
25245 #: ../src/guestfs-actions.pod:1950
25246 #, no-wrap
25247 msgid ""
25248 " const char *\n"
25249 " guestfs_get_append (guestfs_h *g);\n"
25250 "\n"
25251 msgstr ""
25252
25253 #. type: textblock
25254 #: ../src/guestfs-actions.pod:1958
25255 msgid ""
25256 "This function returns a string which may be NULL.  There is no way to return "
25257 "an error from this function.  The string is owned by the guest handle and "
25258 "must I<not> be freed."
25259 msgstr ""
25260
25261 #. type: textblock
25262 #: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:5692
25263 #: ../src/guestfs-actions.pod:6174 ../src/guestfs-actions.pod:6616
25264 #: ../src/guestfs-actions.pod:6635 ../src/guestfs-actions.pod:6651
25265 #: ../src/guestfs-actions.pod:6675 ../src/guestfs-actions.pod:7429
25266 #: ../src/guestfs-actions.pod:7444 ../src/guestfs-actions.pod:7836
25267 msgid "(Added in 1.0.26)"
25268 msgstr ""
25269
25270 #. type: =head2
25271 #: ../src/guestfs-actions.pod:1964
25272 msgid "guestfs_get_attach_method"
25273 msgstr ""
25274
25275 #. type: verbatim
25276 #: ../src/guestfs-actions.pod:1966
25277 #, no-wrap
25278 msgid ""
25279 " char *\n"
25280 " guestfs_get_attach_method (guestfs_h *g);\n"
25281 "\n"
25282 msgstr ""
25283
25284 #. type: textblock
25285 #: ../src/guestfs-actions.pod:1969
25286 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
25287 msgstr ""
25288
25289 #. type: textblock
25290 #: ../src/guestfs-actions.pod:1974 ../src/guestfs-actions.pod:6204
25291 msgid "(Added in 1.9.8)"
25292 msgstr ""
25293
25294 #. type: =head2
25295 #: ../src/guestfs-actions.pod:1976
25296 msgid "guestfs_get_autosync"
25297 msgstr ""
25298
25299 #. type: verbatim
25300 #: ../src/guestfs-actions.pod:1978
25301 #, no-wrap
25302 msgid ""
25303 " int\n"
25304 " guestfs_get_autosync (guestfs_h *g);\n"
25305 "\n"
25306 msgstr ""
25307
25308 #. type: =head2
25309 #: ../src/guestfs-actions.pod:1987
25310 msgid "guestfs_get_direct"
25311 msgstr ""
25312
25313 #. type: verbatim
25314 #: ../src/guestfs-actions.pod:1989
25315 #, no-wrap
25316 msgid ""
25317 " int\n"
25318 " guestfs_get_direct (guestfs_h *g);\n"
25319 "\n"
25320 msgstr ""
25321
25322 #. type: textblock
25323 #: ../src/guestfs-actions.pod:1996 ../src/guestfs-actions.pod:6245
25324 msgid "(Added in 1.0.72)"
25325 msgstr ""
25326
25327 #. type: =head2
25328 #: ../src/guestfs-actions.pod:1998
25329 msgid "guestfs_get_e2label"
25330 msgstr ""
25331
25332 #. type: verbatim
25333 #: ../src/guestfs-actions.pod:2000
25334 #, no-wrap
25335 msgid ""
25336 " char *\n"
25337 " guestfs_get_e2label (guestfs_h *g,\n"
25338 "                      const char *device);\n"
25339 "\n"
25340 msgstr ""
25341
25342 #. type: textblock
25343 #: ../src/guestfs-actions.pod:2010
25344 msgid ""
25345 "This function is deprecated.  In new code, use the L</guestfs_vfs_label> "
25346 "call instead."
25347 msgstr ""
25348
25349 #. type: textblock
25350 #: ../src/guestfs-actions.pod:2017 ../src/guestfs-actions.pod:2038
25351 #: ../src/guestfs-actions.pod:6263 ../src/guestfs-actions.pod:6282
25352 msgid "(Added in 1.0.15)"
25353 msgstr ""
25354
25355 #. type: =head2
25356 #: ../src/guestfs-actions.pod:2019
25357 msgid "guestfs_get_e2uuid"
25358 msgstr ""
25359
25360 #. type: verbatim
25361 #: ../src/guestfs-actions.pod:2021
25362 #, no-wrap
25363 msgid ""
25364 " char *\n"
25365 " guestfs_get_e2uuid (guestfs_h *g,\n"
25366 "                     const char *device);\n"
25367 "\n"
25368 msgstr ""
25369
25370 #. type: textblock
25371 #: ../src/guestfs-actions.pod:2031
25372 msgid ""
25373 "This function is deprecated.  In new code, use the L</guestfs_vfs_uuid> call "
25374 "instead."
25375 msgstr ""
25376
25377 #. type: =head2
25378 #: ../src/guestfs-actions.pod:2040
25379 msgid "guestfs_get_memsize"
25380 msgstr ""
25381
25382 #. type: verbatim
25383 #: ../src/guestfs-actions.pod:2042
25384 #, no-wrap
25385 msgid ""
25386 " int\n"
25387 " guestfs_get_memsize (guestfs_h *g);\n"
25388 "\n"
25389 msgstr ""
25390
25391 #. type: textblock
25392 #: ../src/guestfs-actions.pod:2048
25393 msgid ""
25394 "If C<guestfs_set_memsize> was not called on this handle, and if "
25395 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
25396 "value for memsize."
25397 msgstr ""
25398
25399 #. type: textblock
25400 #: ../src/guestfs-actions.pod:2057 ../src/guestfs-actions.pod:4595
25401 #: ../src/guestfs-actions.pod:4804 ../src/guestfs-actions.pod:4823
25402 #: ../src/guestfs-actions.pod:4842 ../src/guestfs-actions.pod:4854
25403 #: ../src/guestfs-actions.pod:4871 ../src/guestfs-actions.pod:4884
25404 #: ../src/guestfs-actions.pod:5917 ../src/guestfs-actions.pod:6303
25405 #: ../src/guestfs-actions.pod:6583 ../src/guestfs-actions.pod:7198
25406 msgid "(Added in 1.0.55)"
25407 msgstr ""
25408
25409 #. type: =head2
25410 #: ../src/guestfs-actions.pod:2059
25411 msgid "guestfs_get_network"
25412 msgstr ""
25413
25414 #. type: verbatim
25415 #: ../src/guestfs-actions.pod:2061
25416 #, no-wrap
25417 msgid ""
25418 " int\n"
25419 " guestfs_get_network (guestfs_h *g);\n"
25420 "\n"
25421 msgstr ""
25422
25423 #. type: textblock
25424 #: ../src/guestfs-actions.pod:2068 ../src/guestfs-actions.pod:6322
25425 msgid "(Added in 1.5.4)"
25426 msgstr ""
25427
25428 #. type: =head2
25429 #: ../src/guestfs-actions.pod:2070
25430 msgid "guestfs_get_path"
25431 msgstr ""
25432
25433 #. type: verbatim
25434 #: ../src/guestfs-actions.pod:2072
25435 #, no-wrap
25436 msgid ""
25437 " const char *\n"
25438 " guestfs_get_path (guestfs_h *g);\n"
25439 "\n"
25440 msgstr ""
25441
25442 #. type: textblock
25443 #: ../src/guestfs-actions.pod:2080 ../src/guestfs-actions.pod:2120
25444 msgid ""
25445 "This function returns a string, or NULL on error.  The string is owned by "
25446 "the guest handle and must I<not> be freed."
25447 msgstr ""
25448
25449 #. type: =head2
25450 #: ../src/guestfs-actions.pod:2085
25451 msgid "guestfs_get_pgroup"
25452 msgstr ""
25453
25454 #. type: verbatim
25455 #: ../src/guestfs-actions.pod:2087
25456 #, no-wrap
25457 msgid ""
25458 " int\n"
25459 " guestfs_get_pgroup (guestfs_h *g);\n"
25460 "\n"
25461 msgstr ""
25462
25463 #. type: textblock
25464 #: ../src/guestfs-actions.pod:2094 ../src/guestfs-actions.pod:6358
25465 #: ../src/guestfs-actions.pod:7690
25466 #, fuzzy
25467 #| msgid "(Added in 1.5.1)"
25468 msgid "(Added in 1.11.18)"
25469 msgstr "(Додано у 1.5.1)"
25470
25471 #. type: =head2
25472 #: ../src/guestfs-actions.pod:2096
25473 msgid "guestfs_get_pid"
25474 msgstr ""
25475
25476 #. type: verbatim
25477 #: ../src/guestfs-actions.pod:2098
25478 #, no-wrap
25479 msgid ""
25480 " int\n"
25481 " guestfs_get_pid (guestfs_h *g);\n"
25482 "\n"
25483 msgstr ""
25484
25485 #. type: textblock
25486 #: ../src/guestfs-actions.pod:2108
25487 msgid "(Added in 1.0.56)"
25488 msgstr ""
25489
25490 #. type: =head2
25491 #: ../src/guestfs-actions.pod:2110
25492 msgid "guestfs_get_qemu"
25493 msgstr ""
25494
25495 #. type: verbatim
25496 #: ../src/guestfs-actions.pod:2112
25497 #, no-wrap
25498 msgid ""
25499 " const char *\n"
25500 " guestfs_get_qemu (guestfs_h *g);\n"
25501 "\n"
25502 msgstr ""
25503
25504 #. type: textblock
25505 #: ../src/guestfs-actions.pod:2123 ../src/guestfs-actions.pod:6386
25506 msgid "(Added in 1.0.6)"
25507 msgstr ""
25508
25509 #. type: =head2
25510 #: ../src/guestfs-actions.pod:2125
25511 msgid "guestfs_get_recovery_proc"
25512 msgstr ""
25513
25514 #. type: verbatim
25515 #: ../src/guestfs-actions.pod:2127
25516 #, no-wrap
25517 msgid ""
25518 " int\n"
25519 " guestfs_get_recovery_proc (guestfs_h *g);\n"
25520 "\n"
25521 msgstr ""
25522
25523 #. type: textblock
25524 #: ../src/guestfs-actions.pod:2134 ../src/guestfs-actions.pod:3668
25525 #: ../src/guestfs-actions.pod:3999 ../src/guestfs-actions.pod:4402
25526 #: ../src/guestfs-actions.pod:4434 ../src/guestfs-actions.pod:5622
25527 #: ../src/guestfs-actions.pod:5965 ../src/guestfs-actions.pod:6410
25528 #: ../src/guestfs-actions.pod:7101 ../src/guestfs-actions.pod:7121
25529 #: ../src/guestfs-actions.pod:7313
25530 msgid "(Added in 1.0.77)"
25531 msgstr ""
25532
25533 #. type: =head2
25534 #: ../src/guestfs-actions.pod:2136
25535 msgid "guestfs_get_selinux"
25536 msgstr ""
25537
25538 #. type: verbatim
25539 #: ../src/guestfs-actions.pod:2138
25540 #, no-wrap
25541 msgid ""
25542 " int\n"
25543 " guestfs_get_selinux (guestfs_h *g);\n"
25544 "\n"
25545 msgstr ""
25546
25547 #. type: textblock
25548 #: ../src/guestfs-actions.pod:2141
25549 msgid ""
25550 "This returns the current setting of the selinux flag which is passed to the "
25551 "appliance at boot time.  See C<guestfs_set_selinux>."
25552 msgstr ""
25553
25554 #. type: textblock
25555 #: ../src/guestfs-actions.pod:2149 ../src/guestfs-actions.pod:2212
25556 #: ../src/guestfs-actions.pod:6429 ../src/guestfs-actions.pod:6487
25557 msgid "(Added in 1.0.67)"
25558 msgstr ""
25559
25560 #. type: =head2
25561 #: ../src/guestfs-actions.pod:2151
25562 msgid "guestfs_get_state"
25563 msgstr ""
25564
25565 #. type: verbatim
25566 #: ../src/guestfs-actions.pod:2153
25567 #, no-wrap
25568 msgid ""
25569 " int\n"
25570 " guestfs_get_state (guestfs_h *g);\n"
25571 "\n"
25572 msgstr ""
25573
25574 #. type: =head2
25575 #: ../src/guestfs-actions.pod:2165
25576 msgid "guestfs_get_trace"
25577 msgstr ""
25578
25579 #. type: verbatim
25580 #: ../src/guestfs-actions.pod:2167
25581 #, no-wrap
25582 msgid ""
25583 " int\n"
25584 " guestfs_get_trace (guestfs_h *g);\n"
25585 "\n"
25586 msgstr ""
25587
25588 #. type: =head2
25589 #: ../src/guestfs-actions.pod:2176
25590 msgid "guestfs_get_umask"
25591 msgstr ""
25592
25593 #. type: verbatim
25594 #: ../src/guestfs-actions.pod:2178
25595 #, no-wrap
25596 msgid ""
25597 " int\n"
25598 " guestfs_get_umask (guestfs_h *g);\n"
25599 "\n"
25600 msgstr ""
25601
25602 #. type: textblock
25603 #: ../src/guestfs-actions.pod:2181
25604 msgid ""
25605 "Return the current umask.  By default the umask is C<022> unless it has been "
25606 "set by calling C<guestfs_umask>."
25607 msgstr ""
25608
25609 #. type: =head2
25610 #: ../src/guestfs-actions.pod:2188
25611 msgid "guestfs_get_verbose"
25612 msgstr ""
25613
25614 #. type: verbatim
25615 #: ../src/guestfs-actions.pod:2190
25616 #, no-wrap
25617 msgid ""
25618 " int\n"
25619 " guestfs_get_verbose (guestfs_h *g);\n"
25620 "\n"
25621 msgstr ""
25622
25623 #. type: =head2
25624 #: ../src/guestfs-actions.pod:2199
25625 msgid "guestfs_getcon"
25626 msgstr ""
25627
25628 #. type: verbatim
25629 #: ../src/guestfs-actions.pod:2201
25630 #, no-wrap
25631 msgid ""
25632 " char *\n"
25633 " guestfs_getcon (guestfs_h *g);\n"
25634 "\n"
25635 msgstr ""
25636
25637 #. type: textblock
25638 #: ../src/guestfs-actions.pod:2206
25639 msgid ""
25640 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
25641 msgstr ""
25642
25643 #. type: =head2
25644 #: ../src/guestfs-actions.pod:2214
25645 msgid "guestfs_getxattr"
25646 msgstr ""
25647
25648 #. type: verbatim
25649 #: ../src/guestfs-actions.pod:2216
25650 #, no-wrap
25651 msgid ""
25652 " char *\n"
25653 " guestfs_getxattr (guestfs_h *g,\n"
25654 "                   const char *path,\n"
25655 "                   const char *name,\n"
25656 "                   size_t *size_r);\n"
25657 "\n"
25658 msgstr ""
25659
25660 #. type: textblock
25661 #: ../src/guestfs-actions.pod:2222
25662 msgid ""
25663 "Get a single extended attribute from file C<path> named C<name>.  This call "
25664 "follows symlinks.  If you want to lookup an extended attribute for the "
25665 "symlink itself, use C<guestfs_lgetxattr>."
25666 msgstr ""
25667
25668 #. type: textblock
25669 #: ../src/guestfs-actions.pod:2226 ../src/guestfs-actions.pod:3682
25670 msgid ""
25671 "Normally it is better to get all extended attributes from a file in one go "
25672 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
25673 "implementations are buggy and do not provide a way to list out attributes.  "
25674 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
25675 "extended attributes you want in advance and call this function."
25676 msgstr ""
25677
25678 #. type: textblock
25679 #: ../src/guestfs-actions.pod:2236
25680 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
25681 msgstr ""
25682
25683 #. type: textblock
25684 #: ../src/guestfs-actions.pod:2238 ../src/guestfs-actions.pod:2429
25685 #: ../src/guestfs-actions.pod:2899 ../src/guestfs-actions.pod:3694
25686 #: ../src/guestfs-actions.pod:5615 ../src/guestfs-actions.pod:5641
25687 #: ../src/guestfs-actions.pod:5822
25688 msgid ""
25689 "This function returns a buffer, or NULL on error.  The size of the returned "
25690 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
25691 "after use>."
25692 msgstr ""
25693
25694 #. type: textblock
25695 #: ../src/guestfs-actions.pod:2242 ../src/guestfs-actions.pod:3698
25696 msgid "(Added in 1.7.24)"
25697 msgstr ""
25698
25699 #. type: =head2
25700 #: ../src/guestfs-actions.pod:2244
25701 msgid "guestfs_getxattrs"
25702 msgstr ""
25703
25704 #. type: verbatim
25705 #: ../src/guestfs-actions.pod:2246
25706 #, no-wrap
25707 msgid ""
25708 " struct guestfs_xattr_list *\n"
25709 " guestfs_getxattrs (guestfs_h *g,\n"
25710 "                    const char *path);\n"
25711 "\n"
25712 msgstr ""
25713
25714 #. type: textblock
25715 #: ../src/guestfs-actions.pod:2256
25716 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
25717 msgstr ""
25718
25719 #. type: textblock
25720 #: ../src/guestfs-actions.pod:2258 ../src/guestfs-actions.pod:3710
25721 #: ../src/guestfs-actions.pod:4398
25722 msgid ""
25723 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
25724 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
25725 msgstr ""
25726
25727 #. type: textblock
25728 #: ../src/guestfs-actions.pod:2262 ../src/guestfs-actions.pod:3714
25729 #: ../src/guestfs-actions.pod:3913 ../src/guestfs-actions.pod:3949
25730 #: ../src/guestfs-actions.pod:5995 ../src/guestfs-actions.pod:6506
25731 #: ../src/guestfs-actions.pod:7901
25732 msgid "(Added in 1.0.59)"
25733 msgstr ""
25734
25735 #. type: =head2
25736 #: ../src/guestfs-actions.pod:2264
25737 msgid "guestfs_glob_expand"
25738 msgstr ""
25739
25740 #. type: verbatim
25741 #: ../src/guestfs-actions.pod:2266
25742 #, no-wrap
25743 msgid ""
25744 " char **\n"
25745 " guestfs_glob_expand (guestfs_h *g,\n"
25746 "                      const char *pattern);\n"
25747 "\n"
25748 msgstr ""
25749
25750 #. type: textblock
25751 #: ../src/guestfs-actions.pod:2285 ../src/guestfs-actions.pod:6699
25752 #: ../src/guestfs-actions.pod:6716
25753 msgid "(Added in 1.0.50)"
25754 msgstr ""
25755
25756 #. type: =head2
25757 #: ../src/guestfs-actions.pod:2287
25758 msgid "guestfs_grep"
25759 msgstr ""
25760
25761 #. type: verbatim
25762 #: ../src/guestfs-actions.pod:2289
25763 #, no-wrap
25764 msgid ""
25765 " char **\n"
25766 " guestfs_grep (guestfs_h *g,\n"
25767 "               const char *regex,\n"
25768 "               const char *path);\n"
25769 "\n"
25770 msgstr ""
25771
25772 #. type: =head2
25773 #: ../src/guestfs-actions.pod:2306
25774 msgid "guestfs_grepi"
25775 msgstr ""
25776
25777 #. type: verbatim
25778 #: ../src/guestfs-actions.pod:2308
25779 #, no-wrap
25780 msgid ""
25781 " char **\n"
25782 " guestfs_grepi (guestfs_h *g,\n"
25783 "                const char *regex,\n"
25784 "                const char *path);\n"
25785 "\n"
25786 msgstr ""
25787
25788 #. type: =head2
25789 #: ../src/guestfs-actions.pod:2325
25790 msgid "guestfs_grub_install"
25791 msgstr ""
25792
25793 #. type: verbatim
25794 #: ../src/guestfs-actions.pod:2327
25795 #, no-wrap
25796 msgid ""
25797 " int\n"
25798 " guestfs_grub_install (guestfs_h *g,\n"
25799 "                       const char *root,\n"
25800 "                       const char *device);\n"
25801 "\n"
25802 msgstr ""
25803
25804 #. type: textblock
25805 #: ../src/guestfs-actions.pod:2348
25806 msgid "(Added in 1.0.17)"
25807 msgstr ""
25808
25809 #. type: =head2
25810 #: ../src/guestfs-actions.pod:2350
25811 msgid "guestfs_head"
25812 msgstr ""
25813
25814 #. type: verbatim
25815 #: ../src/guestfs-actions.pod:2352
25816 #, no-wrap
25817 msgid ""
25818 " char **\n"
25819 " guestfs_head (guestfs_h *g,\n"
25820 "               const char *path);\n"
25821 "\n"
25822 msgstr ""
25823
25824 #. type: =head2
25825 #: ../src/guestfs-actions.pod:2368
25826 msgid "guestfs_head_n"
25827 msgstr ""
25828
25829 #. type: verbatim
25830 #: ../src/guestfs-actions.pod:2370
25831 #, no-wrap
25832 msgid ""
25833 " char **\n"
25834 " guestfs_head_n (guestfs_h *g,\n"
25835 "                 int nrlines,\n"
25836 "                 const char *path);\n"
25837 "\n"
25838 msgstr ""
25839
25840 #. type: =head2
25841 #: ../src/guestfs-actions.pod:2392
25842 msgid "guestfs_hexdump"
25843 msgstr ""
25844
25845 #. type: verbatim
25846 #: ../src/guestfs-actions.pod:2394
25847 #, no-wrap
25848 msgid ""
25849 " char *\n"
25850 " guestfs_hexdump (guestfs_h *g,\n"
25851 "                  const char *path);\n"
25852 "\n"
25853 msgstr ""
25854
25855 #. type: textblock
25856 #: ../src/guestfs-actions.pod:2407 ../src/guestfs-actions.pod:6780
25857 #: ../src/guestfs-actions.pod:6835
25858 msgid "(Added in 1.0.22)"
25859 msgstr ""
25860
25861 #. type: =head2
25862 #: ../src/guestfs-actions.pod:2409
25863 msgid "guestfs_initrd_cat"
25864 msgstr ""
25865
25866 #. type: verbatim
25867 #: ../src/guestfs-actions.pod:2411
25868 #, no-wrap
25869 msgid ""
25870 " char *\n"
25871 " guestfs_initrd_cat (guestfs_h *g,\n"
25872 "                     const char *initrdpath,\n"
25873 "                     const char *filename,\n"
25874 "                     size_t *size_r);\n"
25875 "\n"
25876 msgstr ""
25877
25878 #. type: textblock
25879 #: ../src/guestfs-actions.pod:2427
25880 msgid "See also C<guestfs_initrd_list>."
25881 msgstr ""
25882
25883 #. type: =head2
25884 #: ../src/guestfs-actions.pod:2438
25885 msgid "guestfs_initrd_list"
25886 msgstr ""
25887
25888 #. type: verbatim
25889 #: ../src/guestfs-actions.pod:2440
25890 #, no-wrap
25891 msgid ""
25892 " char **\n"
25893 " guestfs_initrd_list (guestfs_h *g,\n"
25894 "                      const char *path);\n"
25895 "\n"
25896 msgstr ""
25897
25898 #. type: =head2
25899 #: ../src/guestfs-actions.pod:2460
25900 msgid "guestfs_inotify_add_watch"
25901 msgstr ""
25902
25903 #. type: verbatim
25904 #: ../src/guestfs-actions.pod:2462
25905 #, no-wrap
25906 msgid ""
25907 " int64_t\n"
25908 " guestfs_inotify_add_watch (guestfs_h *g,\n"
25909 "                            const char *path,\n"
25910 "                            int mask);\n"
25911 "\n"
25912 msgstr ""
25913
25914 #. type: =head2
25915 #: ../src/guestfs-actions.pod:2481
25916 msgid "guestfs_inotify_close"
25917 msgstr ""
25918
25919 #. type: verbatim
25920 #: ../src/guestfs-actions.pod:2483
25921 #, no-wrap
25922 msgid ""
25923 " int\n"
25924 " guestfs_inotify_close (guestfs_h *g);\n"
25925 "\n"
25926 msgstr ""
25927
25928 #. type: =head2
25929 #: ../src/guestfs-actions.pod:2494
25930 msgid "guestfs_inotify_files"
25931 msgstr ""
25932
25933 #. type: verbatim
25934 #: ../src/guestfs-actions.pod:2496
25935 #, no-wrap
25936 msgid ""
25937 " char **\n"
25938 " guestfs_inotify_files (guestfs_h *g);\n"
25939 "\n"
25940 msgstr ""
25941
25942 #. type: textblock
25943 #: ../src/guestfs-actions.pod:2499
25944 msgid ""
25945 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
25946 "returns a list of pathnames of objects that were touched.  The returned "
25947 "pathnames are sorted and deduplicated."
25948 msgstr ""
25949
25950 #. type: =head2
25951 #: ../src/guestfs-actions.pod:2509
25952 msgid "guestfs_inotify_init"
25953 msgstr ""
25954
25955 #. type: verbatim
25956 #: ../src/guestfs-actions.pod:2511
25957 #, no-wrap
25958 msgid ""
25959 " int\n"
25960 " guestfs_inotify_init (guestfs_h *g,\n"
25961 "                       int maxevents);\n"
25962 "\n"
25963 msgstr ""
25964
25965 #. type: textblock
25966 #: ../src/guestfs-actions.pod:2519
25967 msgid ""
25968 "C<maxevents> is the maximum number of events which will be queued up between "
25969 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
25970 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
25971 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
25972 "throws away events, but records the fact that it threw them away by setting "
25973 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
25974 "C<guestfs_inotify_read>)."
25975 msgstr ""
25976
25977 #. type: textblock
25978 #: ../src/guestfs-actions.pod:2529
25979 msgid ""
25980 "Before any events are generated, you have to add some watches to the "
25981 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
25982 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
25983 msgstr ""
25984
25985 #. type: textblock
25986 #: ../src/guestfs-actions.pod:2535
25987 msgid ""
25988 "Queued up events should be read periodically by calling "
25989 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
25990 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
25991 "often enough then you risk the internal queue overflowing."
25992 msgstr ""
25993
25994 #. type: textblock
25995 #: ../src/guestfs-actions.pod:2542
25996 msgid ""
25997 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
25998 "This also removes any watches automatically."
25999 msgstr ""
26000
26001 #. type: =head2
26002 #: ../src/guestfs-actions.pod:2555
26003 msgid "guestfs_inotify_read"
26004 msgstr ""
26005
26006 #. type: verbatim
26007 #: ../src/guestfs-actions.pod:2557
26008 #, no-wrap
26009 msgid ""
26010 " struct guestfs_inotify_event_list *\n"
26011 " guestfs_inotify_read (guestfs_h *g);\n"
26012 "\n"
26013 msgstr ""
26014
26015 #. type: textblock
26016 #: ../src/guestfs-actions.pod:2571
26017 msgid ""
26018 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
26019 "there was an error.  I<The caller must call "
26020 "C<guestfs_free_inotify_event_list> after use>."
26021 msgstr ""
26022
26023 #. type: =head2
26024 #: ../src/guestfs-actions.pod:2577
26025 msgid "guestfs_inotify_rm_watch"
26026 msgstr ""
26027
26028 #. type: verbatim
26029 #: ../src/guestfs-actions.pod:2579
26030 #, no-wrap
26031 msgid ""
26032 " int\n"
26033 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
26034 "                           int wd);\n"
26035 "\n"
26036 msgstr ""
26037
26038 #. type: textblock
26039 #: ../src/guestfs-actions.pod:2583
26040 msgid ""
26041 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
26042 msgstr ""
26043
26044 #. type: =head2
26045 #: ../src/guestfs-actions.pod:2590
26046 msgid "guestfs_inspect_get_arch"
26047 msgstr ""
26048
26049 #. type: verbatim
26050 #: ../src/guestfs-actions.pod:2592
26051 #, no-wrap
26052 msgid ""
26053 " char *\n"
26054 " guestfs_inspect_get_arch (guestfs_h *g,\n"
26055 "                           const char *root);\n"
26056 "\n"
26057 msgstr ""
26058
26059 #. type: textblock
26060 #: ../src/guestfs-actions.pod:2596
26061 msgid ""
26062 "This returns the architecture of the inspected operating system.  The "
26063 "possible return values are listed under C<guestfs_file_architecture>."
26064 msgstr ""
26065
26066 #. type: =head2
26067 #: ../src/guestfs-actions.pod:2610
26068 msgid "guestfs_inspect_get_distro"
26069 msgstr ""
26070
26071 #. type: verbatim
26072 #: ../src/guestfs-actions.pod:2612
26073 #, no-wrap
26074 msgid ""
26075 " char *\n"
26076 " guestfs_inspect_get_distro (guestfs_h *g,\n"
26077 "                             const char *root);\n"
26078 "\n"
26079 msgstr ""
26080
26081 #. type: =head2
26082 #: ../src/guestfs-actions.pod:2700
26083 msgid "guestfs_inspect_get_drive_mappings"
26084 msgstr ""
26085
26086 #. type: verbatim
26087 #: ../src/guestfs-actions.pod:2702
26088 #, no-wrap
26089 msgid ""
26090 " char **\n"
26091 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
26092 "                                     const char *root);\n"
26093 "\n"
26094 msgstr ""
26095
26096 #. type: textblock
26097 #: ../src/guestfs-actions.pod:2731
26098 msgid ""
26099 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
26100 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
26101 msgstr ""
26102
26103 #. type: textblock
26104 #: ../src/guestfs-actions.pod:2735 ../src/guestfs-actions.pod:3003
26105 #: ../src/guestfs-actions.pod:3801 ../src/guestfs-actions.pod:5083
26106 #: ../src/guestfs-actions.pod:7137
26107 msgid ""
26108 "This function returns a NULL-terminated array of strings, or NULL if there "
26109 "was an error.  The array of strings will always have length C<2n+1>, where "
26110 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
26111 "caller must free the strings and the array after use>."
26112 msgstr ""
26113
26114 #. type: textblock
26115 #: ../src/guestfs-actions.pod:2741 ../src/guestfs-actions.pod:3197
26116 msgid "(Added in 1.9.17)"
26117 msgstr ""
26118
26119 #. type: =head2
26120 #: ../src/guestfs-actions.pod:2743
26121 msgid "guestfs_inspect_get_filesystems"
26122 msgstr ""
26123
26124 #. type: verbatim
26125 #: ../src/guestfs-actions.pod:2745
26126 #, no-wrap
26127 msgid ""
26128 " char **\n"
26129 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
26130 "                                  const char *root);\n"
26131 "\n"
26132 msgstr ""
26133
26134 #. type: textblock
26135 #: ../src/guestfs-actions.pod:2757
26136 msgid ""
26137 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
26138 "C<guestfs_inspect_get_mountpoints>."
26139 msgstr ""
26140
26141 #. type: =head2
26142 #: ../src/guestfs-actions.pod:2766
26143 msgid "guestfs_inspect_get_format"
26144 msgstr ""
26145
26146 #. type: verbatim
26147 #: ../src/guestfs-actions.pod:2768
26148 #, no-wrap
26149 msgid ""
26150 " char *\n"
26151 " guestfs_inspect_get_format (guestfs_h *g,\n"
26152 "                             const char *root);\n"
26153 "\n"
26154 msgstr ""
26155
26156 #. type: textblock
26157 #: ../src/guestfs-actions.pod:2802 ../src/guestfs-actions.pod:3233
26158 #: ../src/guestfs-actions.pod:3249 ../src/guestfs-actions.pod:3267
26159 #: ../src/guestfs-actions.pod:6033
26160 msgid "(Added in 1.9.4)"
26161 msgstr ""
26162
26163 #. type: =head2
26164 #: ../src/guestfs-actions.pod:2804
26165 msgid "guestfs_inspect_get_hostname"
26166 msgstr ""
26167
26168 #. type: verbatim
26169 #: ../src/guestfs-actions.pod:2806
26170 #, no-wrap
26171 msgid ""
26172 " char *\n"
26173 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
26174 "                               const char *root);\n"
26175 "\n"
26176 msgstr ""
26177
26178 #. type: textblock
26179 #: ../src/guestfs-actions.pod:2821
26180 msgid "(Added in 1.7.9)"
26181 msgstr ""
26182
26183 #. type: =head2
26184 #: ../src/guestfs-actions.pod:2823
26185 msgid "guestfs_inspect_get_icon"
26186 msgstr ""
26187
26188 #. type: verbatim
26189 #: ../src/guestfs-actions.pod:2825
26190 #, no-wrap
26191 msgid ""
26192 " char *\n"
26193 " guestfs_inspect_get_icon (guestfs_h *g,\n"
26194 "                           const char *root,\n"
26195 "                           size_t *size_r,\n"
26196 "                           ...);\n"
26197 "\n"
26198 msgstr ""
26199
26200 #. type: verbatim
26201 #: ../src/guestfs-actions.pod:2836
26202 #, no-wrap
26203 msgid ""
26204 " GUESTFS_INSPECT_GET_ICON_FAVICON, int favicon,\n"
26205 " GUESTFS_INSPECT_GET_ICON_HIGHQUALITY, int highquality,\n"
26206 "\n"
26207 msgstr ""
26208
26209 #. type: textblock
26210 #: ../src/guestfs-actions.pod:2903 ../src/guestfs-actions.pod:3728
26211 #: ../src/guestfs-actions.pod:4982
26212 msgid "(Added in 1.11.12)"
26213 msgstr ""
26214
26215 #. type: =head2
26216 #: ../src/guestfs-actions.pod:2905
26217 msgid "guestfs_inspect_get_icon_va"
26218 msgstr ""
26219
26220 #. type: verbatim
26221 #: ../src/guestfs-actions.pod:2907
26222 #, no-wrap
26223 msgid ""
26224 " char *\n"
26225 " guestfs_inspect_get_icon_va (guestfs_h *g,\n"
26226 "                              const char *root,\n"
26227 "                              size_t *size_r,\n"
26228 "                              va_list args);\n"
26229 "\n"
26230 msgstr ""
26231
26232 #. type: textblock
26233 #: ../src/guestfs-actions.pod:2913
26234 msgid "This is the \"va_list variant\" of L</guestfs_inspect_get_icon>."
26235 msgstr ""
26236
26237 #. type: =head2
26238 #: ../src/guestfs-actions.pod:2917
26239 msgid "guestfs_inspect_get_icon_argv"
26240 msgstr ""
26241
26242 #. type: verbatim
26243 #: ../src/guestfs-actions.pod:2919
26244 #, no-wrap
26245 msgid ""
26246 " char *\n"
26247 " guestfs_inspect_get_icon_argv (guestfs_h *g,\n"
26248 "                                const char *root,\n"
26249 "                                size_t *size_r,\n"
26250 "                                const struct guestfs_inspect_get_icon_argv *optargs);\n"
26251 "\n"
26252 msgstr ""
26253
26254 #. type: textblock
26255 #: ../src/guestfs-actions.pod:2925
26256 msgid "This is the \"argv variant\" of L</guestfs_inspect_get_icon>."
26257 msgstr ""
26258
26259 #. type: =head2
26260 #: ../src/guestfs-actions.pod:2929
26261 msgid "guestfs_inspect_get_major_version"
26262 msgstr ""
26263
26264 #. type: verbatim
26265 #: ../src/guestfs-actions.pod:2931
26266 #, no-wrap
26267 msgid ""
26268 " int\n"
26269 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
26270 "                                    const char *root);\n"
26271 "\n"
26272 msgstr ""
26273
26274 #. type: =head2
26275 #: ../src/guestfs-actions.pod:2953
26276 msgid "guestfs_inspect_get_minor_version"
26277 msgstr ""
26278
26279 #. type: verbatim
26280 #: ../src/guestfs-actions.pod:2955
26281 #, no-wrap
26282 msgid ""
26283 " int\n"
26284 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
26285 "                                    const char *root);\n"
26286 "\n"
26287 msgstr ""
26288
26289 #. type: textblock
26290 #: ../src/guestfs-actions.pod:2964
26291 msgid ""
26292 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
26293 "C<guestfs_inspect_get_major_version>."
26294 msgstr ""
26295
26296 #. type: =head2
26297 #: ../src/guestfs-actions.pod:2971
26298 msgid "guestfs_inspect_get_mountpoints"
26299 msgstr ""
26300
26301 #. type: verbatim
26302 #: ../src/guestfs-actions.pod:2973
26303 #, no-wrap
26304 msgid ""
26305 " char **\n"
26306 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
26307 "                                  const char *root);\n"
26308 "\n"
26309 msgstr ""
26310
26311 #. type: textblock
26312 #: ../src/guestfs-actions.pod:2994
26313 msgid ""
26314 "For operating systems like Windows which still use drive letters, this call "
26315 "will only return an entry for the first drive \"mounted on\" C</>.  For "
26316 "information about the mapping of drive letters to partitions, see "
26317 "C<guestfs_inspect_get_drive_mappings>."
26318 msgstr ""
26319
26320 #. type: textblock
26321 #: ../src/guestfs-actions.pod:3000
26322 msgid ""
26323 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
26324 "C<guestfs_inspect_get_filesystems>."
26325 msgstr ""
26326
26327 #. type: =head2
26328 #: ../src/guestfs-actions.pod:3011
26329 msgid "guestfs_inspect_get_package_format"
26330 msgstr ""
26331
26332 #. type: verbatim
26333 #: ../src/guestfs-actions.pod:3013
26334 #, no-wrap
26335 msgid ""
26336 " char *\n"
26337 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
26338 "                                     const char *root);\n"
26339 "\n"
26340 msgstr ""
26341
26342 #. type: textblock
26343 #: ../src/guestfs-actions.pod:3017
26344 msgid ""
26345 "This function and C<guestfs_inspect_get_package_management> return the "
26346 "package format and package management tool used by the inspected operating "
26347 "system.  For example for Fedora these functions would return C<rpm> (package "
26348 "format) and C<yum> (package management)."
26349 msgstr ""
26350
26351 #. type: textblock
26352 #: ../src/guestfs-actions.pod:3035 ../src/guestfs-actions.pod:3063
26353 msgid "(Added in 1.7.5)"
26354 msgstr ""
26355
26356 #. type: =head2
26357 #: ../src/guestfs-actions.pod:3037
26358 msgid "guestfs_inspect_get_package_management"
26359 msgstr ""
26360
26361 #. type: verbatim
26362 #: ../src/guestfs-actions.pod:3039
26363 #, no-wrap
26364 msgid ""
26365 " char *\n"
26366 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
26367 "                                         const char *root);\n"
26368 "\n"
26369 msgstr ""
26370
26371 #. type: textblock
26372 #: ../src/guestfs-actions.pod:3043
26373 msgid ""
26374 "C<guestfs_inspect_get_package_format> and this function return the package "
26375 "format and package management tool used by the inspected operating system.  "
26376 "For example for Fedora these functions would return C<rpm> (package format) "
26377 "and C<yum> (package management)."
26378 msgstr ""
26379
26380 #. type: =head2
26381 #: ../src/guestfs-actions.pod:3065
26382 msgid "guestfs_inspect_get_product_name"
26383 msgstr ""
26384
26385 #. type: verbatim
26386 #: ../src/guestfs-actions.pod:3067
26387 #, no-wrap
26388 msgid ""
26389 " char *\n"
26390 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
26391 "                                   const char *root);\n"
26392 "\n"
26393 msgstr ""
26394
26395 #. type: =head2
26396 #: ../src/guestfs-actions.pod:3086
26397 msgid "guestfs_inspect_get_product_variant"
26398 msgstr ""
26399
26400 #. type: verbatim
26401 #: ../src/guestfs-actions.pod:3088
26402 #, no-wrap
26403 msgid ""
26404 " char *\n"
26405 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
26406 "                                      const char *root);\n"
26407 "\n"
26408 msgstr ""
26409
26410 #. type: textblock
26411 #: ../src/guestfs-actions.pod:3111
26412 msgid ""
26413 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
26414 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
26415 msgstr ""
26416
26417 #. type: textblock
26418 #: ../src/guestfs-actions.pod:3118
26419 msgid "(Added in 1.9.13)"
26420 msgstr ""
26421
26422 #. type: =head2
26423 #: ../src/guestfs-actions.pod:3120
26424 msgid "guestfs_inspect_get_roots"
26425 msgstr ""
26426
26427 #. type: verbatim
26428 #: ../src/guestfs-actions.pod:3122
26429 #, no-wrap
26430 msgid ""
26431 " char **\n"
26432 " guestfs_inspect_get_roots (guestfs_h *g);\n"
26433 "\n"
26434 msgstr ""
26435
26436 #. type: textblock
26437 #: ../src/guestfs-actions.pod:3125
26438 msgid ""
26439 "This function is a convenient way to get the list of root devices, as "
26440 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
26441 "the whole inspection process."
26442 msgstr ""
26443
26444 #. type: textblock
26445 #: ../src/guestfs-actions.pod:3129
26446 msgid ""
26447 "This returns an empty list if either no root devices were found or the "
26448 "caller has not called C<guestfs_inspect_os>."
26449 msgstr ""
26450
26451 #. type: textblock
26452 #: ../src/guestfs-actions.pod:3138
26453 msgid "(Added in 1.7.3)"
26454 msgstr ""
26455
26456 #. type: =head2
26457 #: ../src/guestfs-actions.pod:3140
26458 msgid "guestfs_inspect_get_type"
26459 msgstr ""
26460
26461 #. type: verbatim
26462 #: ../src/guestfs-actions.pod:3142
26463 #, no-wrap
26464 msgid ""
26465 " char *\n"
26466 " guestfs_inspect_get_type (guestfs_h *g,\n"
26467 "                           const char *root);\n"
26468 "\n"
26469 msgstr ""
26470
26471 #. type: =head2
26472 #: ../src/guestfs-actions.pod:3179
26473 msgid "guestfs_inspect_get_windows_current_control_set"
26474 msgstr ""
26475
26476 #. type: verbatim
26477 #: ../src/guestfs-actions.pod:3181
26478 #, no-wrap
26479 msgid ""
26480 " char *\n"
26481 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
26482 "                                                  const char *root);\n"
26483 "\n"
26484 msgstr ""
26485
26486 #. type: =head2
26487 #: ../src/guestfs-actions.pod:3199
26488 msgid "guestfs_inspect_get_windows_systemroot"
26489 msgstr ""
26490
26491 #. type: verbatim
26492 #: ../src/guestfs-actions.pod:3201
26493 #, no-wrap
26494 msgid ""
26495 " char *\n"
26496 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
26497 "                                         const char *root);\n"
26498 "\n"
26499 msgstr ""
26500
26501 #. type: textblock
26502 #: ../src/guestfs-actions.pod:3217
26503 msgid "(Added in 1.5.25)"
26504 msgstr ""
26505
26506 #. type: =head2
26507 #: ../src/guestfs-actions.pod:3219
26508 msgid "guestfs_inspect_is_live"
26509 msgstr ""
26510
26511 #. type: verbatim
26512 #: ../src/guestfs-actions.pod:3221
26513 #, no-wrap
26514 msgid ""
26515 " int\n"
26516 " guestfs_inspect_is_live (guestfs_h *g,\n"
26517 "                          const char *root);\n"
26518 "\n"
26519 msgstr ""
26520
26521 #. type: textblock
26522 #: ../src/guestfs-actions.pod:3225
26523 msgid ""
26524 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
26525 "disk), then this returns true if a live image was detected on the disk."
26526 msgstr ""
26527
26528 #. type: =head2
26529 #: ../src/guestfs-actions.pod:3235
26530 msgid "guestfs_inspect_is_multipart"
26531 msgstr ""
26532
26533 #. type: verbatim
26534 #: ../src/guestfs-actions.pod:3237
26535 #, no-wrap
26536 msgid ""
26537 " int\n"
26538 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
26539 "                               const char *root);\n"
26540 "\n"
26541 msgstr ""
26542
26543 #. type: textblock
26544 #: ../src/guestfs-actions.pod:3241
26545 msgid ""
26546 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
26547 "disk), then this returns true if the disk is part of a set."
26548 msgstr ""
26549
26550 #. type: =head2
26551 #: ../src/guestfs-actions.pod:3251
26552 msgid "guestfs_inspect_is_netinst"
26553 msgstr ""
26554
26555 #. type: verbatim
26556 #: ../src/guestfs-actions.pod:3253
26557 #, no-wrap
26558 msgid ""
26559 " int\n"
26560 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
26561 "                             const char *root);\n"
26562 "\n"
26563 msgstr ""
26564
26565 #. type: textblock
26566 #: ../src/guestfs-actions.pod:3257
26567 msgid ""
26568 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
26569 "disk), then this returns true if the disk is a network installer, ie. not a "
26570 "self-contained install CD but one which is likely to require network access "
26571 "to complete the install."
26572 msgstr ""
26573
26574 #. type: =head2
26575 #: ../src/guestfs-actions.pod:3269
26576 msgid "guestfs_inspect_list_applications"
26577 msgstr ""
26578
26579 #. type: verbatim
26580 #: ../src/guestfs-actions.pod:3271
26581 #, no-wrap
26582 msgid ""
26583 " struct guestfs_application_list *\n"
26584 " guestfs_inspect_list_applications (guestfs_h *g,\n"
26585 "                                    const char *root);\n"
26586 "\n"
26587 msgstr ""
26588
26589 #. type: textblock
26590 #: ../src/guestfs-actions.pod:3277
26591 msgid ""
26592 "I<Note:> This call works differently from other parts of the inspection "
26593 "API.  You have to call C<guestfs_inspect_os>, then "
26594 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
26595 "this.  Listing applications is a significantly more difficult operation "
26596 "which requires access to the full filesystem.  Also note that unlike the "
26597 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
26598 "the libguestfs handle, this call actually reads parts of the mounted "
26599 "filesystems during the call."
26600 msgstr ""
26601
26602 #. type: textblock
26603 #: ../src/guestfs-actions.pod:3367
26604 msgid ""
26605 "This function returns a C<struct guestfs_application_list *>, or NULL if "
26606 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
26607 "after use>."
26608 msgstr ""
26609
26610 #. type: textblock
26611 #: ../src/guestfs-actions.pod:3371
26612 msgid "(Added in 1.7.8)"
26613 msgstr ""
26614
26615 #. type: =head2
26616 #: ../src/guestfs-actions.pod:3373
26617 msgid "guestfs_inspect_os"
26618 msgstr ""
26619
26620 #. type: verbatim
26621 #: ../src/guestfs-actions.pod:3375
26622 #, no-wrap
26623 msgid ""
26624 " char **\n"
26625 " guestfs_inspect_os (guestfs_h *g);\n"
26626 "\n"
26627 msgstr ""
26628
26629 #. type: textblock
26630 #: ../src/guestfs-actions.pod:3391
26631 msgid ""
26632 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
26633 "functions in order to query further information about each operating system, "
26634 "such as the name and version."
26635 msgstr ""
26636
26637 #. type: textblock
26638 #: ../src/guestfs-actions.pod:3396
26639 msgid ""
26640 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
26641 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
26642 "the contents.  This should be called with no disks currently mounted.  The "
26643 "function may also use Augeas, so any existing Augeas handle will be closed."
26644 msgstr ""
26645
26646 #. type: textblock
26647 #: ../src/guestfs-actions.pod:3408 ../src/guestfs-actions.pod:3739
26648 #: ../src/guestfs-actions.pod:3821
26649 msgid "See also C<guestfs_list_filesystems>."
26650 msgstr ""
26651
26652 #. type: =head2
26653 #: ../src/guestfs-actions.pod:3416
26654 msgid "guestfs_is_blockdev"
26655 msgstr ""
26656
26657 #. type: verbatim
26658 #: ../src/guestfs-actions.pod:3418
26659 #, no-wrap
26660 msgid ""
26661 " int\n"
26662 " guestfs_is_blockdev (guestfs_h *g,\n"
26663 "                      const char *path);\n"
26664 "\n"
26665 msgstr ""
26666
26667 #. type: textblock
26668 #: ../src/guestfs-actions.pod:3425 ../src/guestfs-actions.pod:3454
26669 #: ../src/guestfs-actions.pod:3484 ../src/guestfs-actions.pod:3499
26670 #: ../src/guestfs-actions.pod:3515 ../src/guestfs-actions.pod:3571
26671 #: ../src/guestfs-actions.pod:3586
26672 msgid "See also C<guestfs_stat>."
26673 msgstr ""
26674
26675 #. type: textblock
26676 #: ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3458
26677 #: ../src/guestfs-actions.pod:3503 ../src/guestfs-actions.pod:3575
26678 #: ../src/guestfs-actions.pod:3590
26679 msgid "(Added in 1.5.10)"
26680 msgstr ""
26681
26682 #. type: =head2
26683 #: ../src/guestfs-actions.pod:3431
26684 msgid "guestfs_is_busy"
26685 msgstr ""
26686
26687 #. type: verbatim
26688 #: ../src/guestfs-actions.pod:3433
26689 #, no-wrap
26690 msgid ""
26691 " int\n"
26692 " guestfs_is_busy (guestfs_h *g);\n"
26693 "\n"
26694 msgstr ""
26695
26696 #. type: =head2
26697 #: ../src/guestfs-actions.pod:3445
26698 msgid "guestfs_is_chardev"
26699 msgstr ""
26700
26701 #. type: verbatim
26702 #: ../src/guestfs-actions.pod:3447
26703 #, no-wrap
26704 msgid ""
26705 " int\n"
26706 " guestfs_is_chardev (guestfs_h *g,\n"
26707 "                     const char *path);\n"
26708 "\n"
26709 msgstr ""
26710
26711 #. type: =head2
26712 #: ../src/guestfs-actions.pod:3460
26713 msgid "guestfs_is_config"
26714 msgstr ""
26715
26716 #. type: verbatim
26717 #: ../src/guestfs-actions.pod:3462
26718 #, no-wrap
26719 msgid ""
26720 " int\n"
26721 " guestfs_is_config (guestfs_h *g);\n"
26722 "\n"
26723 msgstr ""
26724
26725 #. type: =head2
26726 #: ../src/guestfs-actions.pod:3474
26727 msgid "guestfs_is_dir"
26728 msgstr ""
26729
26730 #. type: verbatim
26731 #: ../src/guestfs-actions.pod:3476
26732 #, no-wrap
26733 msgid ""
26734 " int\n"
26735 " guestfs_is_dir (guestfs_h *g,\n"
26736 "                 const char *path);\n"
26737 "\n"
26738 msgstr ""
26739
26740 #. type: =head2
26741 #: ../src/guestfs-actions.pod:3490
26742 msgid "guestfs_is_fifo"
26743 msgstr ""
26744
26745 #. type: verbatim
26746 #: ../src/guestfs-actions.pod:3492
26747 #, no-wrap
26748 msgid ""
26749 " int\n"
26750 " guestfs_is_fifo (guestfs_h *g,\n"
26751 "                  const char *path);\n"
26752 "\n"
26753 msgstr ""
26754
26755 #. type: =head2
26756 #: ../src/guestfs-actions.pod:3505
26757 msgid "guestfs_is_file"
26758 msgstr ""
26759
26760 #. type: verbatim
26761 #: ../src/guestfs-actions.pod:3507
26762 #, no-wrap
26763 msgid ""
26764 " int\n"
26765 " guestfs_is_file (guestfs_h *g,\n"
26766 "                  const char *path);\n"
26767 "\n"
26768 msgstr ""
26769
26770 #. type: =head2
26771 #: ../src/guestfs-actions.pod:3521
26772 msgid "guestfs_is_launching"
26773 msgstr ""
26774
26775 #. type: verbatim
26776 #: ../src/guestfs-actions.pod:3523
26777 #, no-wrap
26778 msgid ""
26779 " int\n"
26780 " guestfs_is_launching (guestfs_h *g);\n"
26781 "\n"
26782 msgstr ""
26783
26784 #. type: =head2
26785 #: ../src/guestfs-actions.pod:3535
26786 msgid "guestfs_is_lv"
26787 msgstr ""
26788
26789 #. type: verbatim
26790 #: ../src/guestfs-actions.pod:3537
26791 #, no-wrap
26792 msgid ""
26793 " int\n"
26794 " guestfs_is_lv (guestfs_h *g,\n"
26795 "                const char *device);\n"
26796 "\n"
26797 msgstr ""
26798
26799 #. type: =head2
26800 #: ../src/guestfs-actions.pod:3548
26801 msgid "guestfs_is_ready"
26802 msgstr ""
26803
26804 #. type: verbatim
26805 #: ../src/guestfs-actions.pod:3550
26806 #, no-wrap
26807 msgid ""
26808 " int\n"
26809 " guestfs_is_ready (guestfs_h *g);\n"
26810 "\n"
26811 msgstr ""
26812
26813 #. type: =head2
26814 #: ../src/guestfs-actions.pod:3562
26815 msgid "guestfs_is_socket"
26816 msgstr ""
26817
26818 #. type: verbatim
26819 #: ../src/guestfs-actions.pod:3564
26820 #, no-wrap
26821 msgid ""
26822 " int\n"
26823 " guestfs_is_socket (guestfs_h *g,\n"
26824 "                    const char *path);\n"
26825 "\n"
26826 msgstr ""
26827
26828 #. type: =head2
26829 #: ../src/guestfs-actions.pod:3577
26830 msgid "guestfs_is_symlink"
26831 msgstr ""
26832
26833 #. type: verbatim
26834 #: ../src/guestfs-actions.pod:3579
26835 #, no-wrap
26836 msgid ""
26837 " int\n"
26838 " guestfs_is_symlink (guestfs_h *g,\n"
26839 "                     const char *path);\n"
26840 "\n"
26841 msgstr ""
26842
26843 #. type: =head2
26844 #: ../src/guestfs-actions.pod:3592
26845 msgid "guestfs_is_zero"
26846 msgstr ""
26847
26848 #. type: verbatim
26849 #: ../src/guestfs-actions.pod:3594
26850 #, no-wrap
26851 msgid ""
26852 " int\n"
26853 " guestfs_is_zero (guestfs_h *g,\n"
26854 "                  const char *path);\n"
26855 "\n"
26856 msgstr ""
26857
26858 #. type: textblock
26859 #: ../src/guestfs-actions.pod:3603 ../src/guestfs-actions.pod:3617
26860 msgid "(Added in 1.11.8)"
26861 msgstr ""
26862
26863 #. type: =head2
26864 #: ../src/guestfs-actions.pod:3605
26865 msgid "guestfs_is_zero_device"
26866 msgstr ""
26867
26868 #. type: verbatim
26869 #: ../src/guestfs-actions.pod:3607
26870 #, no-wrap
26871 msgid ""
26872 " int\n"
26873 " guestfs_is_zero_device (guestfs_h *g,\n"
26874 "                         const char *device);\n"
26875 "\n"
26876 msgstr ""
26877
26878 #. type: =head2
26879 #: ../src/guestfs-actions.pod:3619
26880 msgid "guestfs_kill_subprocess"
26881 msgstr ""
26882
26883 #. type: verbatim
26884 #: ../src/guestfs-actions.pod:3621
26885 #, no-wrap
26886 msgid ""
26887 " int\n"
26888 " guestfs_kill_subprocess (guestfs_h *g);\n"
26889 "\n"
26890 msgstr ""
26891
26892 #. type: =head2
26893 #: ../src/guestfs-actions.pod:3630
26894 msgid "guestfs_launch"
26895 msgstr ""
26896
26897 #. type: verbatim
26898 #: ../src/guestfs-actions.pod:3632
26899 #, no-wrap
26900 msgid ""
26901 " int\n"
26902 " guestfs_launch (guestfs_h *g);\n"
26903 "\n"
26904 msgstr ""
26905
26906 #. type: =head2
26907 #: ../src/guestfs-actions.pod:3650
26908 msgid "guestfs_lchown"
26909 msgstr ""
26910
26911 #. type: verbatim
26912 #: ../src/guestfs-actions.pod:3652
26913 #, no-wrap
26914 msgid ""
26915 " int\n"
26916 " guestfs_lchown (guestfs_h *g,\n"
26917 "                 int owner,\n"
26918 "                 int group,\n"
26919 "                 const char *path);\n"
26920 "\n"
26921 msgstr ""
26922
26923 #. type: textblock
26924 #: ../src/guestfs-actions.pod:3658
26925 msgid ""
26926 "Change the file owner to C<owner> and group to C<group>.  This is like "
26927 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
26928 "changed, not the target."
26929 msgstr ""
26930
26931 #. type: =head2
26932 #: ../src/guestfs-actions.pod:3670
26933 msgid "guestfs_lgetxattr"
26934 msgstr ""
26935
26936 #. type: verbatim
26937 #: ../src/guestfs-actions.pod:3672
26938 #, no-wrap
26939 msgid ""
26940 " char *\n"
26941 " guestfs_lgetxattr (guestfs_h *g,\n"
26942 "                    const char *path,\n"
26943 "                    const char *name,\n"
26944 "                    size_t *size_r);\n"
26945 "\n"
26946 msgstr ""
26947
26948 #. type: textblock
26949 #: ../src/guestfs-actions.pod:3692
26950 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
26951 msgstr ""
26952
26953 #. type: =head2
26954 #: ../src/guestfs-actions.pod:3700
26955 msgid "guestfs_lgetxattrs"
26956 msgstr ""
26957
26958 #. type: verbatim
26959 #: ../src/guestfs-actions.pod:3702
26960 #, no-wrap
26961 msgid ""
26962 " struct guestfs_xattr_list *\n"
26963 " guestfs_lgetxattrs (guestfs_h *g,\n"
26964 "                     const char *path);\n"
26965 "\n"
26966 msgstr ""
26967
26968 #. type: textblock
26969 #: ../src/guestfs-actions.pod:3706
26970 msgid ""
26971 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
26972 "then it returns the extended attributes of the link itself."
26973 msgstr ""
26974
26975 #. type: =head2
26976 #: ../src/guestfs-actions.pod:3716
26977 msgid "guestfs_list_9p"
26978 msgstr ""
26979
26980 #. type: verbatim
26981 #: ../src/guestfs-actions.pod:3718
26982 #, no-wrap
26983 msgid ""
26984 " char **\n"
26985 " guestfs_list_9p (guestfs_h *g);\n"
26986 "\n"
26987 msgstr ""
26988
26989 #. type: =head2
26990 #: ../src/guestfs-actions.pod:3730
26991 msgid "guestfs_list_devices"
26992 msgstr ""
26993
26994 #. type: verbatim
26995 #: ../src/guestfs-actions.pod:3732
26996 #, no-wrap
26997 msgid ""
26998 " char **\n"
26999 " guestfs_list_devices (guestfs_h *g);\n"
27000 "\n"
27001 msgstr ""
27002
27003 #. type: =head2
27004 #: ../src/guestfs-actions.pod:3747
27005 msgid "guestfs_list_dm_devices"
27006 msgstr ""
27007
27008 #. type: verbatim
27009 #: ../src/guestfs-actions.pod:3749
27010 #, no-wrap
27011 msgid ""
27012 " char **\n"
27013 " guestfs_list_dm_devices (guestfs_h *g);\n"
27014 "\n"
27015 msgstr ""
27016
27017 #. type: textblock
27018 #: ../src/guestfs-actions.pod:3754
27019 msgid ""
27020 "The returned list contains C</dev/mapper/*> devices, eg. ones created by a "
27021 "previous call to C<guestfs_luks_open>."
27022 msgstr ""
27023
27024 #. type: textblock
27025 #: ../src/guestfs-actions.pod:3757
27026 msgid ""
27027 "Device mapper devices which correspond to logical volumes are I<not> "
27028 "returned in this list.  Call C<guestfs_lvs> if you want to list logical "
27029 "volumes."
27030 msgstr ""
27031
27032 #. type: textblock
27033 #: ../src/guestfs-actions.pod:3765 ../src/guestfs-actions.pod:5221
27034 msgid "(Added in 1.11.15)"
27035 msgstr ""
27036
27037 #. type: =head2
27038 #: ../src/guestfs-actions.pod:3767
27039 msgid "guestfs_list_filesystems"
27040 msgstr ""
27041
27042 #. type: verbatim
27043 #: ../src/guestfs-actions.pod:3769
27044 #, no-wrap
27045 msgid ""
27046 " char **\n"
27047 " guestfs_list_filesystems (guestfs_h *g);\n"
27048 "\n"
27049 msgstr ""
27050
27051 #. type: textblock
27052 #: ../src/guestfs-actions.pod:3789
27053 msgid ""
27054 "This command runs other libguestfs commands, which might include "
27055 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
27056 "soon after launch and only when nothing is mounted."
27057 msgstr ""
27058
27059 #. type: textblock
27060 #: ../src/guestfs-actions.pod:3793
27061 msgid ""
27062 "Not all of the filesystems returned will be mountable.  In particular, swap "
27063 "partitions are returned in the list.  Also this command does not check that "
27064 "each filesystem found is valid and mountable, and some filesystems might be "
27065 "mountable but require special options.  Filesystems may not all belong to a "
27066 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
27067 msgstr ""
27068
27069 #. type: textblock
27070 #: ../src/guestfs-actions.pod:3807 ../src/guestfs-actions.pod:5582
27071 msgid "(Added in 1.5.15)"
27072 msgstr ""
27073
27074 #. type: =head2
27075 #: ../src/guestfs-actions.pod:3809
27076 msgid "guestfs_list_partitions"
27077 msgstr "guestfs_list_partitions"
27078
27079 #. type: verbatim
27080 #: ../src/guestfs-actions.pod:3811
27081 #, no-wrap
27082 msgid ""
27083 " char **\n"
27084 " guestfs_list_partitions (guestfs_h *g);\n"
27085 "\n"
27086 msgstr ""
27087 " char **\n"
27088 " guestfs_list_partitions (guestfs_h *g);\n"
27089 "\n"
27090
27091 #. type: textblock
27092 #: ../src/guestfs-actions.pod:3818
27093 msgid ""
27094 "This does not return logical volumes.  For that you will need to call "
27095 "C<guestfs_lvs>."
27096 msgstr ""
27097
27098 #. type: =head2
27099 #: ../src/guestfs-actions.pod:3829
27100 msgid "guestfs_ll"
27101 msgstr "guestfs_ll"
27102
27103 #. type: verbatim
27104 #: ../src/guestfs-actions.pod:3831
27105 #, no-wrap
27106 msgid ""
27107 " char *\n"
27108 " guestfs_ll (guestfs_h *g,\n"
27109 "             const char *directory);\n"
27110 "\n"
27111 msgstr ""
27112 " char *\n"
27113 " guestfs_ll (guestfs_h *g,\n"
27114 "             const char *directory);\n"
27115 "\n"
27116
27117 #. type: =head2
27118 #: ../src/guestfs-actions.pod:3846
27119 msgid "guestfs_ln"
27120 msgstr "guestfs_ln"
27121
27122 #. type: verbatim
27123 #: ../src/guestfs-actions.pod:3848
27124 #, no-wrap
27125 msgid ""
27126 " int\n"
27127 " guestfs_ln (guestfs_h *g,\n"
27128 "             const char *target,\n"
27129 "             const char *linkname);\n"
27130 "\n"
27131 msgstr ""
27132 " int\n"
27133 " guestfs_ln (guestfs_h *g,\n"
27134 "             const char *target,\n"
27135 "             const char *linkname);\n"
27136 "\n"
27137
27138 #. type: =head2
27139 #: ../src/guestfs-actions.pod:3859
27140 msgid "guestfs_ln_f"
27141 msgstr "guestfs_ln_f"
27142
27143 #. type: verbatim
27144 #: ../src/guestfs-actions.pod:3861
27145 #, no-wrap
27146 msgid ""
27147 " int\n"
27148 " guestfs_ln_f (guestfs_h *g,\n"
27149 "               const char *target,\n"
27150 "               const char *linkname);\n"
27151 "\n"
27152 msgstr ""
27153 " int\n"
27154 " guestfs_ln_f (guestfs_h *g,\n"
27155 "               const char *target,\n"
27156 "               const char *linkname);\n"
27157 "\n"
27158
27159 #. type: =head2
27160 #: ../src/guestfs-actions.pod:3873
27161 msgid "guestfs_ln_s"
27162 msgstr "guestfs_ln_s"
27163
27164 #. type: verbatim
27165 #: ../src/guestfs-actions.pod:3875
27166 #, no-wrap
27167 msgid ""
27168 " int\n"
27169 " guestfs_ln_s (guestfs_h *g,\n"
27170 "               const char *target,\n"
27171 "               const char *linkname);\n"
27172 "\n"
27173 msgstr ""
27174 " int\n"
27175 " guestfs_ln_s (guestfs_h *g,\n"
27176 "               const char *target,\n"
27177 "               const char *linkname);\n"
27178 "\n"
27179
27180 #. type: =head2
27181 #: ../src/guestfs-actions.pod:3886
27182 msgid "guestfs_ln_sf"
27183 msgstr "guestfs_ln_sf"
27184
27185 #. type: verbatim
27186 #: ../src/guestfs-actions.pod:3888
27187 #, no-wrap
27188 msgid ""
27189 " int\n"
27190 " guestfs_ln_sf (guestfs_h *g,\n"
27191 "                const char *target,\n"
27192 "                const char *linkname);\n"
27193 "\n"
27194 msgstr ""
27195 " int\n"
27196 " guestfs_ln_sf (guestfs_h *g,\n"
27197 "                const char *target,\n"
27198 "                const char *linkname);\n"
27199 "\n"
27200
27201 #. type: =head2
27202 #: ../src/guestfs-actions.pod:3900
27203 msgid "guestfs_lremovexattr"
27204 msgstr "guestfs_lremovexattr"
27205
27206 #. type: verbatim
27207 #: ../src/guestfs-actions.pod:3902
27208 #, no-wrap
27209 msgid ""
27210 " int\n"
27211 " guestfs_lremovexattr (guestfs_h *g,\n"
27212 "                       const char *xattr,\n"
27213 "                       const char *path);\n"
27214 "\n"
27215 msgstr ""
27216 " int\n"
27217 " guestfs_lremovexattr (guestfs_h *g,\n"
27218 "                       const char *xattr,\n"
27219 "                       const char *path);\n"
27220 "\n"
27221
27222 #. type: textblock
27223 #: ../src/guestfs-actions.pod:3907
27224 msgid ""
27225 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
27226 "link, then it removes an extended attribute of the link itself."
27227 msgstr ""
27228
27229 #. type: =head2
27230 #: ../src/guestfs-actions.pod:3915
27231 msgid "guestfs_ls"
27232 msgstr "guestfs_ls"
27233
27234 #. type: verbatim
27235 #: ../src/guestfs-actions.pod:3917
27236 #, no-wrap
27237 msgid ""
27238 " char **\n"
27239 " guestfs_ls (guestfs_h *g,\n"
27240 "             const char *directory);\n"
27241 "\n"
27242 msgstr ""
27243 " char **\n"
27244 " guestfs_ls (guestfs_h *g,\n"
27245 "             const char *directory);\n"
27246 "\n"
27247
27248 #. type: textblock
27249 #: ../src/guestfs-actions.pod:3925
27250 msgid ""
27251 "This command is mostly useful for interactive sessions.  Programs should "
27252 "probably use C<guestfs_readdir> instead."
27253 msgstr ""
27254
27255 #. type: =head2
27256 #: ../src/guestfs-actions.pod:3934
27257 msgid "guestfs_lsetxattr"
27258 msgstr "guestfs_lsetxattr"
27259
27260 #. type: verbatim
27261 #: ../src/guestfs-actions.pod:3936
27262 #, no-wrap
27263 msgid ""
27264 " int\n"
27265 " guestfs_lsetxattr (guestfs_h *g,\n"
27266 "                    const char *xattr,\n"
27267 "                    const char *val,\n"
27268 "                    int vallen,\n"
27269 "                    const char *path);\n"
27270 "\n"
27271 msgstr ""
27272 " int\n"
27273 " guestfs_lsetxattr (guestfs_h *g,\n"
27274 "                    const char *xattr,\n"
27275 "                    const char *val,\n"
27276 "                    int vallen,\n"
27277 "                    const char *path);\n"
27278 "\n"
27279
27280 #. type: textblock
27281 #: ../src/guestfs-actions.pod:3943
27282 msgid ""
27283 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
27284 "then it sets an extended attribute of the link itself."
27285 msgstr ""
27286
27287 #. type: =head2
27288 #: ../src/guestfs-actions.pod:3951
27289 msgid "guestfs_lstat"
27290 msgstr "guestfs_lstat"
27291
27292 #. type: verbatim
27293 #: ../src/guestfs-actions.pod:3953
27294 #, no-wrap
27295 msgid ""
27296 " struct guestfs_stat *\n"
27297 " guestfs_lstat (guestfs_h *g,\n"
27298 "                const char *path);\n"
27299 "\n"
27300 msgstr ""
27301 " struct guestfs_stat *\n"
27302 " guestfs_lstat (guestfs_h *g,\n"
27303 "                const char *path);\n"
27304 "\n"
27305
27306 #. type: textblock
27307 #: ../src/guestfs-actions.pod:3959
27308 msgid ""
27309 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
27310 "link, then the link is stat-ed, not the file it refers to."
27311 msgstr ""
27312
27313 #. type: textblock
27314 #: ../src/guestfs-actions.pod:3965 ../src/guestfs-actions.pod:6740
27315 msgid ""
27316 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
27317 "error.  I<The caller must call C<guestfs_free_stat> after use>."
27318 msgstr ""
27319
27320 #. type: textblock
27321 #: ../src/guestfs-actions.pod:3969 ../src/guestfs-actions.pod:6744
27322 #: ../src/guestfs-actions.pod:6762 ../src/guestfs-actions.pod:7143
27323 msgid "(Added in 0.9.2)"
27324 msgstr "(Додано у 0.9.2)"
27325
27326 #. type: =head2
27327 #: ../src/guestfs-actions.pod:3971
27328 msgid "guestfs_lstatlist"
27329 msgstr "guestfs_lstatlist"
27330
27331 #. type: verbatim
27332 #: ../src/guestfs-actions.pod:3973
27333 #, no-wrap
27334 msgid ""
27335 " struct guestfs_stat_list *\n"
27336 " guestfs_lstatlist (guestfs_h *g,\n"
27337 "                    const char *path,\n"
27338 "                    char *const *names);\n"
27339 "\n"
27340 msgstr ""
27341 " struct guestfs_stat_list *\n"
27342 " guestfs_lstatlist (guestfs_h *g,\n"
27343 "                    const char *path,\n"
27344 "                    char *const *names);\n"
27345 "\n"
27346
27347 #. type: textblock
27348 #: ../src/guestfs-actions.pod:3978
27349 msgid ""
27350 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
27351 "files, where all files are in the directory C<path>.  C<names> is the list "
27352 "of files from this directory."
27353 msgstr ""
27354
27355 #. type: textblock
27356 #: ../src/guestfs-actions.pod:3987
27357 msgid ""
27358 "This call is intended for programs that want to efficiently list a directory "
27359 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
27360 "for a similarly efficient call for getting extended attributes.  Very long "
27361 "directory listings might cause the protocol message size to be exceeded, "
27362 "causing this call to fail.  The caller must split up such requests into "
27363 "smaller groups of names."
27364 msgstr ""
27365
27366 #. type: textblock
27367 #: ../src/guestfs-actions.pod:3995
27368 msgid ""
27369 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
27370 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
27371 msgstr ""
27372
27373 #. type: =head2
27374 #: ../src/guestfs-actions.pod:4001
27375 msgid "guestfs_luks_add_key"
27376 msgstr "guestfs_luks_add_key"
27377
27378 #. type: verbatim
27379 #: ../src/guestfs-actions.pod:4003
27380 #, no-wrap
27381 msgid ""
27382 " int\n"
27383 " guestfs_luks_add_key (guestfs_h *g,\n"
27384 "                       const char *device,\n"
27385 "                       const char *key,\n"
27386 "                       const char *newkey,\n"
27387 "                       int keyslot);\n"
27388 "\n"
27389 msgstr ""
27390 " int\n"
27391 " guestfs_luks_add_key (guestfs_h *g,\n"
27392 "                       const char *device,\n"
27393 "                       const char *key,\n"
27394 "                       const char *newkey,\n"
27395 "                       int keyslot);\n"
27396 "\n"
27397
27398 #. type: textblock
27399 #: ../src/guestfs-actions.pod:4015
27400 msgid ""
27401 "Note that if C<keyslot> already contains a key, then this command will "
27402 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
27403 msgstr ""
27404
27405 #. type: textblock
27406 #: ../src/guestfs-actions.pod:4021 ../src/guestfs-actions.pod:4061
27407 #: ../src/guestfs-actions.pod:4084 ../src/guestfs-actions.pod:4104
27408 #: ../src/guestfs-actions.pod:4139 ../src/guestfs-actions.pod:4158
27409 msgid ""
27410 "This function takes a key or passphrase parameter which could contain "
27411 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
27412 "information."
27413 msgstr ""
27414
27415 #. type: textblock
27416 #: ../src/guestfs-actions.pod:4025 ../src/guestfs-actions.pod:4065
27417 #: ../src/guestfs-actions.pod:4088 ../src/guestfs-actions.pod:4108
27418 msgid "(Added in 1.5.2)"
27419 msgstr "(Додано у 1.5.2)"
27420
27421 #. type: =head2
27422 #: ../src/guestfs-actions.pod:4027
27423 msgid "guestfs_luks_close"
27424 msgstr "guestfs_luks_close"
27425
27426 #. type: verbatim
27427 #: ../src/guestfs-actions.pod:4029
27428 #, no-wrap
27429 msgid ""
27430 " int\n"
27431 " guestfs_luks_close (guestfs_h *g,\n"
27432 "                     const char *device);\n"
27433 "\n"
27434 msgstr ""
27435 " int\n"
27436 " guestfs_luks_close (guestfs_h *g,\n"
27437 "                     const char *device);\n"
27438 "\n"
27439
27440 #. type: textblock
27441 #: ../src/guestfs-actions.pod:4033
27442 msgid ""
27443 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
27444 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
27445 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
27446 "underlying block device."
27447 msgstr ""
27448
27449 #. type: textblock
27450 #: ../src/guestfs-actions.pod:4041 ../src/guestfs-actions.pod:4143
27451 #: ../src/guestfs-actions.pod:4162 ../src/guestfs-actions.pod:4212
27452 #: ../src/guestfs-actions.pod:4260
27453 msgid "(Added in 1.5.1)"
27454 msgstr "(Додано у 1.5.1)"
27455
27456 #. type: =head2
27457 #: ../src/guestfs-actions.pod:4043
27458 msgid "guestfs_luks_format"
27459 msgstr "guestfs_luks_format"
27460
27461 #. type: verbatim
27462 #: ../src/guestfs-actions.pod:4045
27463 #, no-wrap
27464 msgid ""
27465 " int\n"
27466 " guestfs_luks_format (guestfs_h *g,\n"
27467 "                      const char *device,\n"
27468 "                      const char *key,\n"
27469 "                      int keyslot);\n"
27470 "\n"
27471 msgstr ""
27472 " int\n"
27473 " guestfs_luks_format (guestfs_h *g,\n"
27474 "                      const char *device,\n"
27475 "                      const char *key,\n"
27476 "                      int keyslot);\n"
27477 "\n"
27478
27479 #. type: =head2
27480 #: ../src/guestfs-actions.pod:4067
27481 msgid "guestfs_luks_format_cipher"
27482 msgstr "guestfs_luks_format_cipher"
27483
27484 #. type: verbatim
27485 #: ../src/guestfs-actions.pod:4069
27486 #, no-wrap
27487 msgid ""
27488 " int\n"
27489 " guestfs_luks_format_cipher (guestfs_h *g,\n"
27490 "                             const char *device,\n"
27491 "                             const char *key,\n"
27492 "                             int keyslot,\n"
27493 "                             const char *cipher);\n"
27494 "\n"
27495 msgstr ""
27496 " int\n"
27497 " guestfs_luks_format_cipher (guestfs_h *g,\n"
27498 "                             const char *device,\n"
27499 "                             const char *key,\n"
27500 "                             int keyslot,\n"
27501 "                             const char *cipher);\n"
27502 "\n"
27503
27504 #. type: textblock
27505 #: ../src/guestfs-actions.pod:4076
27506 msgid ""
27507 "This command is the same as C<guestfs_luks_format> but it also allows you to "
27508 "set the C<cipher> used."
27509 msgstr ""
27510
27511 #. type: =head2
27512 #: ../src/guestfs-actions.pod:4090
27513 msgid "guestfs_luks_kill_slot"
27514 msgstr "guestfs_luks_kill_slot"
27515
27516 #. type: verbatim
27517 #: ../src/guestfs-actions.pod:4092
27518 #, no-wrap
27519 msgid ""
27520 " int\n"
27521 " guestfs_luks_kill_slot (guestfs_h *g,\n"
27522 "                         const char *device,\n"
27523 "                         const char *key,\n"
27524 "                         int keyslot);\n"
27525 "\n"
27526 msgstr ""
27527 " int\n"
27528 " guestfs_luks_kill_slot (guestfs_h *g,\n"
27529 "                         const char *device,\n"
27530 "                         const char *key,\n"
27531 "                         int keyslot);\n"
27532 "\n"
27533
27534 #. type: =head2
27535 #: ../src/guestfs-actions.pod:4110
27536 msgid "guestfs_luks_open"
27537 msgstr "guestfs_luks_open"
27538
27539 #. type: verbatim
27540 #: ../src/guestfs-actions.pod:4112
27541 #, no-wrap
27542 msgid ""
27543 " int\n"
27544 " guestfs_luks_open (guestfs_h *g,\n"
27545 "                    const char *device,\n"
27546 "                    const char *key,\n"
27547 "                    const char *mapname);\n"
27548 "\n"
27549 msgstr ""
27550 " int\n"
27551 " guestfs_luks_open (guestfs_h *g,\n"
27552 "                    const char *device,\n"
27553 "                    const char *key,\n"
27554 "                    const char *mapname);\n"
27555 "\n"
27556
27557 #. type: textblock
27558 #: ../src/guestfs-actions.pod:4130
27559 msgid ""
27560 "If this block device contains LVM volume groups, then calling "
27561 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
27562 "visible."
27563 msgstr ""
27564
27565 #. type: textblock
27566 #: ../src/guestfs-actions.pod:4134
27567 msgid "Use C<guestfs_list_dm_devices> to list all device mapper devices."
27568 msgstr ""
27569
27570 #. type: =head2
27571 #: ../src/guestfs-actions.pod:4145
27572 msgid "guestfs_luks_open_ro"
27573 msgstr "guestfs_luks_open_ro"
27574
27575 #. type: verbatim
27576 #: ../src/guestfs-actions.pod:4147
27577 #, no-wrap
27578 msgid ""
27579 " int\n"
27580 " guestfs_luks_open_ro (guestfs_h *g,\n"
27581 "                       const char *device,\n"
27582 "                       const char *key,\n"
27583 "                       const char *mapname);\n"
27584 "\n"
27585 msgstr ""
27586 " int\n"
27587 " guestfs_luks_open_ro (guestfs_h *g,\n"
27588 "                       const char *device,\n"
27589 "                       const char *key,\n"
27590 "                       const char *mapname);\n"
27591 "\n"
27592
27593 #. type: textblock
27594 #: ../src/guestfs-actions.pod:4153
27595 msgid ""
27596 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
27597 "created."
27598 msgstr ""
27599
27600 #. type: =head2
27601 #: ../src/guestfs-actions.pod:4164
27602 msgid "guestfs_lvcreate"
27603 msgstr "guestfs_lvcreate"
27604
27605 #. type: verbatim
27606 #: ../src/guestfs-actions.pod:4166
27607 #, no-wrap
27608 msgid ""
27609 " int\n"
27610 " guestfs_lvcreate (guestfs_h *g,\n"
27611 "                   const char *logvol,\n"
27612 "                   const char *volgroup,\n"
27613 "                   int mbytes);\n"
27614 "\n"
27615 msgstr ""
27616 " int\n"
27617 " guestfs_lvcreate (guestfs_h *g,\n"
27618 "                   const char *logvol,\n"
27619 "                   const char *volgroup,\n"
27620 "                   int mbytes);\n"
27621 "\n"
27622
27623 #. type: =head2
27624 #: ../src/guestfs-actions.pod:4179
27625 msgid "guestfs_lvm_canonical_lv_name"
27626 msgstr "guestfs_lvm_canonical_lv_name"
27627
27628 #. type: verbatim
27629 #: ../src/guestfs-actions.pod:4181
27630 #, no-wrap
27631 msgid ""
27632 " char *\n"
27633 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
27634 "                                const char *lvname);\n"
27635 "\n"
27636 msgstr ""
27637 " char *\n"
27638 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
27639 "                                const char *lvname);\n"
27640 "\n"
27641
27642 #. type: textblock
27643 #: ../src/guestfs-actions.pod:4192
27644 msgid "See also C<guestfs_is_lv>."
27645 msgstr ""
27646
27647 #. type: textblock
27648 #: ../src/guestfs-actions.pod:4197
27649 msgid "(Added in 1.5.24)"
27650 msgstr "(Додано у 1.5.24)"
27651
27652 #. type: =head2
27653 #: ../src/guestfs-actions.pod:4199
27654 msgid "guestfs_lvm_clear_filter"
27655 msgstr "guestfs_lvm_clear_filter"
27656
27657 #. type: verbatim
27658 #: ../src/guestfs-actions.pod:4201
27659 #, no-wrap
27660 msgid ""
27661 " int\n"
27662 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
27663 "\n"
27664 msgstr ""
27665 " int\n"
27666 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
27667 "\n"
27668
27669 #. type: textblock
27670 #: ../src/guestfs-actions.pod:4204
27671 msgid ""
27672 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
27673 "see every block device."
27674 msgstr ""
27675
27676 #. type: =head2
27677 #: ../src/guestfs-actions.pod:4214
27678 msgid "guestfs_lvm_remove_all"
27679 msgstr "guestfs_lvm_remove_all"
27680
27681 #. type: verbatim
27682 #: ../src/guestfs-actions.pod:4216
27683 #, no-wrap
27684 msgid ""
27685 " int\n"
27686 " guestfs_lvm_remove_all (guestfs_h *g);\n"
27687 "\n"
27688 msgstr ""
27689 " int\n"
27690 " guestfs_lvm_remove_all (guestfs_h *g);\n"
27691 "\n"
27692
27693 #. type: =head2
27694 #: ../src/guestfs-actions.pod:4229
27695 msgid "guestfs_lvm_set_filter"
27696 msgstr "guestfs_lvm_set_filter"
27697
27698 #. type: verbatim
27699 #: ../src/guestfs-actions.pod:4231
27700 #, no-wrap
27701 msgid ""
27702 " int\n"
27703 " guestfs_lvm_set_filter (guestfs_h *g,\n"
27704 "                         char *const *devices);\n"
27705 "\n"
27706 msgstr ""
27707 " int\n"
27708 " guestfs_lvm_set_filter (guestfs_h *g,\n"
27709 "                         char *const *devices);\n"
27710 "\n"
27711
27712 #. type: =head2
27713 #: ../src/guestfs-actions.pod:4262
27714 msgid "guestfs_lvremove"
27715 msgstr "guestfs_lvremove"
27716
27717 #. type: verbatim
27718 #: ../src/guestfs-actions.pod:4264
27719 #, no-wrap
27720 msgid ""
27721 " int\n"
27722 " guestfs_lvremove (guestfs_h *g,\n"
27723 "                   const char *device);\n"
27724 "\n"
27725 msgstr ""
27726 " int\n"
27727 " guestfs_lvremove (guestfs_h *g,\n"
27728 "                   const char *device);\n"
27729 "\n"
27730
27731 #. type: textblock
27732 #: ../src/guestfs-actions.pod:4276 ../src/guestfs-actions.pod:5679
27733 #: ../src/guestfs-actions.pod:7513
27734 msgid "(Added in 1.0.13)"
27735 msgstr "(Додано у 1.0.13)"
27736
27737 #. type: =head2
27738 #: ../src/guestfs-actions.pod:4278
27739 msgid "guestfs_lvrename"
27740 msgstr "guestfs_lvrename"
27741
27742 #. type: verbatim
27743 #: ../src/guestfs-actions.pod:4280
27744 #, no-wrap
27745 msgid ""
27746 " int\n"
27747 " guestfs_lvrename (guestfs_h *g,\n"
27748 "                   const char *logvol,\n"
27749 "                   const char *newlogvol);\n"
27750 "\n"
27751 msgstr ""
27752 " int\n"
27753 " guestfs_lvrename (guestfs_h *g,\n"
27754 "                   const char *logvol,\n"
27755 "                   const char *newlogvol);\n"
27756 "\n"
27757
27758 #. type: textblock
27759 #: ../src/guestfs-actions.pod:4289 ../src/guestfs-actions.pod:7526
27760 msgid "(Added in 1.0.83)"
27761 msgstr "(Додано у 1.0.83)"
27762
27763 #. type: =head2
27764 #: ../src/guestfs-actions.pod:4291
27765 msgid "guestfs_lvresize"
27766 msgstr "guestfs_lvresize"
27767
27768 #. type: verbatim
27769 #: ../src/guestfs-actions.pod:4293
27770 #, no-wrap
27771 msgid ""
27772 " int\n"
27773 " guestfs_lvresize (guestfs_h *g,\n"
27774 "                   const char *device,\n"
27775 "                   int mbytes);\n"
27776 "\n"
27777 msgstr ""
27778 " int\n"
27779 " guestfs_lvresize (guestfs_h *g,\n"
27780 "                   const char *device,\n"
27781 "                   int mbytes);\n"
27782 "\n"
27783
27784 #. type: =head2
27785 #: ../src/guestfs-actions.pod:4306
27786 msgid "guestfs_lvresize_free"
27787 msgstr "guestfs_lvresize_free"
27788
27789 #. type: verbatim
27790 #: ../src/guestfs-actions.pod:4308
27791 #, no-wrap
27792 msgid ""
27793 " int\n"
27794 " guestfs_lvresize_free (guestfs_h *g,\n"
27795 "                        const char *lv,\n"
27796 "                        int percent);\n"
27797 "\n"
27798 msgstr ""
27799 " int\n"
27800 " guestfs_lvresize_free (guestfs_h *g,\n"
27801 "                        const char *lv,\n"
27802 "                        int percent);\n"
27803 "\n"
27804
27805 #. type: textblock
27806 #: ../src/guestfs-actions.pod:4321
27807 msgid "(Added in 1.3.3)"
27808 msgstr "(Додано у 1.3.3)"
27809
27810 #. type: =head2
27811 #: ../src/guestfs-actions.pod:4323
27812 msgid "guestfs_lvs"
27813 msgstr "guestfs_lvs"
27814
27815 #. type: verbatim
27816 #: ../src/guestfs-actions.pod:4325
27817 #, no-wrap
27818 msgid ""
27819 " char **\n"
27820 " guestfs_lvs (guestfs_h *g);\n"
27821 "\n"
27822 msgstr ""
27823 " char **\n"
27824 " guestfs_lvs (guestfs_h *g);\n"
27825 "\n"
27826
27827 #. type: textblock
27828 #: ../src/guestfs-actions.pod:4334
27829 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
27830 msgstr ""
27831
27832 #. type: =head2
27833 #: ../src/guestfs-actions.pod:4342
27834 msgid "guestfs_lvs_full"
27835 msgstr "guestfs_lvs_full"
27836
27837 #. type: verbatim
27838 #: ../src/guestfs-actions.pod:4344
27839 #, no-wrap
27840 msgid ""
27841 " struct guestfs_lvm_lv_list *\n"
27842 " guestfs_lvs_full (guestfs_h *g);\n"
27843 "\n"
27844 msgstr ""
27845 " struct guestfs_lvm_lv_list *\n"
27846 " guestfs_lvs_full (guestfs_h *g);\n"
27847 "\n"
27848
27849 #. type: textblock
27850 #: ../src/guestfs-actions.pod:4350
27851 msgid ""
27852 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
27853 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
27854 msgstr ""
27855
27856 #. type: =head2
27857 #: ../src/guestfs-actions.pod:4356
27858 msgid "guestfs_lvuuid"
27859 msgstr "guestfs_lvuuid"
27860
27861 #. type: verbatim
27862 #: ../src/guestfs-actions.pod:4358
27863 #, no-wrap
27864 msgid ""
27865 " char *\n"
27866 " guestfs_lvuuid (guestfs_h *g,\n"
27867 "                 const char *device);\n"
27868 "\n"
27869 msgstr ""
27870 " char *\n"
27871 " guestfs_lvuuid (guestfs_h *g,\n"
27872 "                 const char *device);\n"
27873 "\n"
27874
27875 #. type: =head2
27876 #: ../src/guestfs-actions.pod:4369
27877 msgid "guestfs_lxattrlist"
27878 msgstr "guestfs_lxattrlist"
27879
27880 #. type: verbatim
27881 #: ../src/guestfs-actions.pod:4371
27882 #, no-wrap
27883 msgid ""
27884 " struct guestfs_xattr_list *\n"
27885 " guestfs_lxattrlist (guestfs_h *g,\n"
27886 "                     const char *path,\n"
27887 "                     char *const *names);\n"
27888 "\n"
27889 msgstr ""
27890 " struct guestfs_xattr_list *\n"
27891 " guestfs_lxattrlist (guestfs_h *g,\n"
27892 "                     const char *path,\n"
27893 "                     char *const *names);\n"
27894 "\n"
27895
27896 #. type: textblock
27897 #: ../src/guestfs-actions.pod:4390
27898 msgid ""
27899 "This call is intended for programs that want to efficiently list a directory "
27900 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
27901 "a similarly efficient call for getting standard stats.  Very long directory "
27902 "listings might cause the protocol message size to be exceeded, causing this "
27903 "call to fail.  The caller must split up such requests into smaller groups of "
27904 "names."
27905 msgstr ""
27906
27907 #. type: =head2
27908 #: ../src/guestfs-actions.pod:4404
27909 msgid "guestfs_mkdir"
27910 msgstr "guestfs_mkdir"
27911
27912 #. type: verbatim
27913 #: ../src/guestfs-actions.pod:4406
27914 #, no-wrap
27915 msgid ""
27916 " int\n"
27917 " guestfs_mkdir (guestfs_h *g,\n"
27918 "                const char *path);\n"
27919 "\n"
27920 msgstr ""
27921 " int\n"
27922 " guestfs_mkdir (guestfs_h *g,\n"
27923 "                const char *path);\n"
27924 "\n"
27925
27926 #. type: =head2
27927 #: ../src/guestfs-actions.pod:4416
27928 msgid "guestfs_mkdir_mode"
27929 msgstr "guestfs_mkdir_mode"
27930
27931 #. type: verbatim
27932 #: ../src/guestfs-actions.pod:4418
27933 #, no-wrap
27934 msgid ""
27935 " int\n"
27936 " guestfs_mkdir_mode (guestfs_h *g,\n"
27937 "                     const char *path,\n"
27938 "                     int mode);\n"
27939 "\n"
27940 msgstr ""
27941 " int\n"
27942 " guestfs_mkdir_mode (guestfs_h *g,\n"
27943 "                     const char *path,\n"
27944 "                     int mode);\n"
27945 "\n"
27946
27947 #. type: textblock
27948 #: ../src/guestfs-actions.pod:4430
27949 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
27950 msgstr ""
27951
27952 #. type: =head2
27953 #: ../src/guestfs-actions.pod:4436
27954 msgid "guestfs_mkdir_p"
27955 msgstr "guestfs_mkdir_p"
27956
27957 #. type: verbatim
27958 #: ../src/guestfs-actions.pod:4438
27959 #, no-wrap
27960 msgid ""
27961 " int\n"
27962 " guestfs_mkdir_p (guestfs_h *g,\n"
27963 "                  const char *path);\n"
27964 "\n"
27965 msgstr ""
27966 " int\n"
27967 " guestfs_mkdir_p (guestfs_h *g,\n"
27968 "                  const char *path);\n"
27969 "\n"
27970
27971 #. type: =head2
27972 #: ../src/guestfs-actions.pod:4449
27973 msgid "guestfs_mkdtemp"
27974 msgstr "guestfs_mkdtemp"
27975
27976 #. type: verbatim
27977 #: ../src/guestfs-actions.pod:4451
27978 #, no-wrap
27979 msgid ""
27980 " char *\n"
27981 " guestfs_mkdtemp (guestfs_h *g,\n"
27982 "                  const char *template);\n"
27983 "\n"
27984 msgstr ""
27985 " char *\n"
27986 " guestfs_mkdtemp (guestfs_h *g,\n"
27987 "                  const char *template);\n"
27988 "\n"
27989
27990 #. type: =head2
27991 #: ../src/guestfs-actions.pod:4479
27992 msgid "guestfs_mke2fs_J"
27993 msgstr "guestfs_mke2fs_J"
27994
27995 #. type: verbatim
27996 #: ../src/guestfs-actions.pod:4481
27997 #, no-wrap
27998 msgid ""
27999 " int\n"
28000 " guestfs_mke2fs_J (guestfs_h *g,\n"
28001 "                   const char *fstype,\n"
28002 "                   int blocksize,\n"
28003 "                   const char *device,\n"
28004 "                   const char *journal);\n"
28005 "\n"
28006 msgstr ""
28007 " int\n"
28008 " guestfs_mke2fs_J (guestfs_h *g,\n"
28009 "                   const char *fstype,\n"
28010 "                   int blocksize,\n"
28011 "                   const char *device,\n"
28012 "                   const char *journal);\n"
28013 "\n"
28014
28015 #. type: textblock
28016 #: ../src/guestfs-actions.pod:4494
28017 msgid "See also C<guestfs_mke2journal>."
28018 msgstr ""
28019
28020 #. type: textblock
28021 #: ../src/guestfs-actions.pod:4498 ../src/guestfs-actions.pod:4516
28022 #: ../src/guestfs-actions.pod:4534 ../src/guestfs-actions.pod:4550
28023 #: ../src/guestfs-actions.pod:4564 ../src/guestfs-actions.pod:4578
28024 #: ../src/guestfs-actions.pod:4637 ../src/guestfs-actions.pod:4914
28025 msgid "(Added in 1.0.68)"
28026 msgstr "(Додано у 1.0.68)"
28027
28028 #. type: =head2
28029 #: ../src/guestfs-actions.pod:4500
28030 msgid "guestfs_mke2fs_JL"
28031 msgstr "guestfs_mke2fs_JL"
28032
28033 #. type: verbatim
28034 #: ../src/guestfs-actions.pod:4502
28035 #, no-wrap
28036 msgid ""
28037 " int\n"
28038 " guestfs_mke2fs_JL (guestfs_h *g,\n"
28039 "                    const char *fstype,\n"
28040 "                    int blocksize,\n"
28041 "                    const char *device,\n"
28042 "                    const char *label);\n"
28043 "\n"
28044 msgstr ""
28045 " int\n"
28046 " guestfs_mke2fs_JL (guestfs_h *g,\n"
28047 "                    const char *fstype,\n"
28048 "                    int blocksize,\n"
28049 "                    const char *device,\n"
28050 "                    const char *label);\n"
28051 "\n"
28052
28053 #. type: textblock
28054 #: ../src/guestfs-actions.pod:4512
28055 msgid "See also C<guestfs_mke2journal_L>."
28056 msgstr ""
28057
28058 #. type: =head2
28059 #: ../src/guestfs-actions.pod:4518
28060 msgid "guestfs_mke2fs_JU"
28061 msgstr "guestfs_mke2fs_JU"
28062
28063 #. type: verbatim
28064 #: ../src/guestfs-actions.pod:4520
28065 #, no-wrap
28066 msgid ""
28067 " int\n"
28068 " guestfs_mke2fs_JU (guestfs_h *g,\n"
28069 "                    const char *fstype,\n"
28070 "                    int blocksize,\n"
28071 "                    const char *device,\n"
28072 "                    const char *uuid);\n"
28073 "\n"
28074 msgstr ""
28075 " int\n"
28076 " guestfs_mke2fs_JU (guestfs_h *g,\n"
28077 "                    const char *fstype,\n"
28078 "                    int blocksize,\n"
28079 "                    const char *device,\n"
28080 "                    const char *uuid);\n"
28081 "\n"
28082
28083 #. type: textblock
28084 #: ../src/guestfs-actions.pod:4530
28085 msgid "See also C<guestfs_mke2journal_U>."
28086 msgstr ""
28087
28088 #. type: =head2
28089 #: ../src/guestfs-actions.pod:4536
28090 msgid "guestfs_mke2journal"
28091 msgstr "guestfs_mke2journal"
28092
28093 #. type: verbatim
28094 #: ../src/guestfs-actions.pod:4538
28095 #, no-wrap
28096 msgid ""
28097 " int\n"
28098 " guestfs_mke2journal (guestfs_h *g,\n"
28099 "                      int blocksize,\n"
28100 "                      const char *device);\n"
28101 "\n"
28102 msgstr ""
28103 " int\n"
28104 " guestfs_mke2journal (guestfs_h *g,\n"
28105 "                      int blocksize,\n"
28106 "                      const char *device);\n"
28107 "\n"
28108
28109 #. type: =head2
28110 #: ../src/guestfs-actions.pod:4552
28111 msgid "guestfs_mke2journal_L"
28112 msgstr "guestfs_mke2journal_L"
28113
28114 #. type: verbatim
28115 #: ../src/guestfs-actions.pod:4554
28116 #, no-wrap
28117 msgid ""
28118 " int\n"
28119 " guestfs_mke2journal_L (guestfs_h *g,\n"
28120 "                        int blocksize,\n"
28121 "                        const char *label,\n"
28122 "                        const char *device);\n"
28123 "\n"
28124 msgstr ""
28125 " int\n"
28126 " guestfs_mke2journal_L (guestfs_h *g,\n"
28127 "                        int blocksize,\n"
28128 "                        const char *label,\n"
28129 "                        const char *device);\n"
28130 "\n"
28131
28132 #. type: =head2
28133 #: ../src/guestfs-actions.pod:4566
28134 msgid "guestfs_mke2journal_U"
28135 msgstr "guestfs_mke2journal_U"
28136
28137 #. type: verbatim
28138 #: ../src/guestfs-actions.pod:4568
28139 #, no-wrap
28140 msgid ""
28141 " int\n"
28142 " guestfs_mke2journal_U (guestfs_h *g,\n"
28143 "                        int blocksize,\n"
28144 "                        const char *uuid,\n"
28145 "                        const char *device);\n"
28146 "\n"
28147 msgstr ""
28148 " int\n"
28149 " guestfs_mke2journal_U (guestfs_h *g,\n"
28150 "                        int blocksize,\n"
28151 "                        const char *uuid,\n"
28152 "                        const char *device);\n"
28153 "\n"
28154
28155 #. type: =head2
28156 #: ../src/guestfs-actions.pod:4580
28157 msgid "guestfs_mkfifo"
28158 msgstr "guestfs_mkfifo"
28159
28160 #. type: verbatim
28161 #: ../src/guestfs-actions.pod:4582
28162 #, no-wrap
28163 msgid ""
28164 " int\n"
28165 " guestfs_mkfifo (guestfs_h *g,\n"
28166 "                 int mode,\n"
28167 "                 const char *path);\n"
28168 "\n"
28169 msgstr ""
28170 " int\n"
28171 " guestfs_mkfifo (guestfs_h *g,\n"
28172 "                 int mode,\n"
28173 "                 const char *path);\n"
28174 "\n"
28175
28176 #. type: textblock
28177 #: ../src/guestfs-actions.pod:4587
28178 msgid ""
28179 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
28180 "is just a convenient wrapper around C<guestfs_mknod>."
28181 msgstr ""
28182
28183 #. type: =head2
28184 #: ../src/guestfs-actions.pod:4597
28185 msgid "guestfs_mkfs"
28186 msgstr "guestfs_mkfs"
28187
28188 #. type: verbatim
28189 #: ../src/guestfs-actions.pod:4599
28190 #, no-wrap
28191 msgid ""
28192 " int\n"
28193 " guestfs_mkfs (guestfs_h *g,\n"
28194 "               const char *fstype,\n"
28195 "               const char *device);\n"
28196 "\n"
28197 msgstr ""
28198 " int\n"
28199 " guestfs_mkfs (guestfs_h *g,\n"
28200 "               const char *fstype,\n"
28201 "               const char *device);\n"
28202 "\n"
28203
28204 #. type: =head2
28205 #: ../src/guestfs-actions.pod:4612
28206 msgid "guestfs_mkfs_b"
28207 msgstr "guestfs_mkfs_b"
28208
28209 #. type: verbatim
28210 #: ../src/guestfs-actions.pod:4614
28211 #, no-wrap
28212 msgid ""
28213 " int\n"
28214 " guestfs_mkfs_b (guestfs_h *g,\n"
28215 "                 const char *fstype,\n"
28216 "                 int blocksize,\n"
28217 "                 const char *device);\n"
28218 "\n"
28219 msgstr ""
28220 " int\n"
28221 " guestfs_mkfs_b (guestfs_h *g,\n"
28222 "                 const char *fstype,\n"
28223 "                 int blocksize,\n"
28224 "                 const char *device);\n"
28225 "\n"
28226
28227 #. type: textblock
28228 #: ../src/guestfs-actions.pod:4620
28229 msgid ""
28230 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
28231 "block size of the resulting filesystem.  Supported block sizes depend on the "
28232 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
28233 msgstr ""
28234
28235 #. type: textblock
28236 #: ../src/guestfs-actions.pod:4630
28237 msgid ""
28238 "This function is deprecated.  In new code, use the L</guestfs_mkfs_opts> "
28239 "call instead."
28240 msgstr ""
28241
28242 #. type: =head2
28243 #: ../src/guestfs-actions.pod:4639
28244 msgid "guestfs_mkfs_opts"
28245 msgstr "guestfs_mkfs_opts"
28246
28247 #. type: verbatim
28248 #: ../src/guestfs-actions.pod:4641
28249 #, no-wrap
28250 msgid ""
28251 " int\n"
28252 " guestfs_mkfs_opts (guestfs_h *g,\n"
28253 "                    const char *fstype,\n"
28254 "                    const char *device,\n"
28255 "                    ...);\n"
28256 "\n"
28257 msgstr ""
28258 " int\n"
28259 " guestfs_mkfs_opts (guestfs_h *g,\n"
28260 "                    const char *fstype,\n"
28261 "                    const char *device,\n"
28262 "                    ...);\n"
28263 "\n"
28264
28265 #. type: verbatim
28266 #: ../src/guestfs-actions.pod:4652
28267 #, no-wrap
28268 msgid ""
28269 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
28270 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
28271 " GUESTFS_MKFS_OPTS_INODE, int inode,\n"
28272 " GUESTFS_MKFS_OPTS_SECTORSIZE, int sectorsize,\n"
28273 "\n"
28274 msgstr ""
28275
28276 #. type: textblock
28277 #: ../src/guestfs-actions.pod:4700
28278 msgid "(Added in 1.7.19)"
28279 msgstr "(Додано у 1.7.19)"
28280
28281 #. type: =head2
28282 #: ../src/guestfs-actions.pod:4702
28283 msgid "guestfs_mkfs_opts_va"
28284 msgstr "guestfs_mkfs_opts_va"
28285
28286 #. type: verbatim
28287 #: ../src/guestfs-actions.pod:4704
28288 #, no-wrap
28289 msgid ""
28290 " int\n"
28291 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
28292 "                       const char *fstype,\n"
28293 "                       const char *device,\n"
28294 "                       va_list args);\n"
28295 "\n"
28296 msgstr ""
28297 " int\n"
28298 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
28299 "                       const char *fstype,\n"
28300 "                       const char *device,\n"
28301 "                       va_list args);\n"
28302 "\n"
28303
28304 #. type: textblock
28305 #: ../src/guestfs-actions.pod:4710
28306 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
28307 msgstr ""
28308
28309 #. type: =head2
28310 #: ../src/guestfs-actions.pod:4714
28311 msgid "guestfs_mkfs_opts_argv"
28312 msgstr "guestfs_mkfs_opts_argv"
28313
28314 #. type: verbatim
28315 #: ../src/guestfs-actions.pod:4716
28316 #, no-wrap
28317 msgid ""
28318 " int\n"
28319 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
28320 "                         const char *fstype,\n"
28321 "                         const char *device,\n"
28322 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
28323 "\n"
28324 msgstr ""
28325 " int\n"
28326 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
28327 "                         const char *fstype,\n"
28328 "                         const char *device,\n"
28329 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
28330 "\n"
28331
28332 #. type: textblock
28333 #: ../src/guestfs-actions.pod:4722
28334 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
28335 msgstr ""
28336
28337 #. type: =head2
28338 #: ../src/guestfs-actions.pod:4726
28339 msgid "guestfs_mkmountpoint"
28340 msgstr "guestfs_mkmountpoint"
28341
28342 #. type: verbatim
28343 #: ../src/guestfs-actions.pod:4728
28344 #, no-wrap
28345 msgid ""
28346 " int\n"
28347 " guestfs_mkmountpoint (guestfs_h *g,\n"
28348 "                       const char *exemptpath);\n"
28349 "\n"
28350 msgstr ""
28351 " int\n"
28352 " guestfs_mkmountpoint (guestfs_h *g,\n"
28353 "                       const char *exemptpath);\n"
28354 "\n"
28355
28356 #. type: textblock
28357 #: ../src/guestfs-actions.pod:4732
28358 msgid ""
28359 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
28360 "that can be used to create extra mountpoints before mounting the first "
28361 "filesystem."
28362 msgstr ""
28363
28364 #. type: textblock
28365 #: ../src/guestfs-actions.pod:4756
28366 msgid ""
28367 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
28368 "may get unexpected errors if you try to mix these calls.  It is safest to "
28369 "manually unmount filesystems and remove mountpoints after use."
28370 msgstr ""
28371
28372 #. type: textblock
28373 #: ../src/guestfs-actions.pod:4760
28374 msgid ""
28375 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
28376 "first, so for this to work for manual mountpoints, you must ensure that the "
28377 "innermost mountpoints have the longest pathnames, as in the example code "
28378 "above."
28379 msgstr ""
28380
28381 #. type: textblock
28382 #: ../src/guestfs-actions.pod:4767
28383 msgid ""
28384 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
28385 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
28386 "can also trigger these issues."
28387 msgstr ""
28388
28389 #. type: textblock
28390 #: ../src/guestfs-actions.pod:4773 ../src/guestfs-actions.pod:5089
28391 #: ../src/guestfs-actions.pod:6099
28392 msgid "(Added in 1.0.62)"
28393 msgstr "(Додано у 1.0.62)"
28394
28395 #. type: =head2
28396 #: ../src/guestfs-actions.pod:4775
28397 msgid "guestfs_mknod"
28398 msgstr ""
28399
28400 #. type: verbatim
28401 #: ../src/guestfs-actions.pod:4777
28402 #, no-wrap
28403 msgid ""
28404 " int\n"
28405 " guestfs_mknod (guestfs_h *g,\n"
28406 "                int mode,\n"
28407 "                int devmajor,\n"
28408 "                int devminor,\n"
28409 "                const char *path);\n"
28410 "\n"
28411 msgstr ""
28412
28413 #. type: textblock
28414 #: ../src/guestfs-actions.pod:4792
28415 msgid ""
28416 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
28417 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
28418 "regular file).  These constants are available in the standard Linux header "
28419 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
28420 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
28421 "the appropriate constant for you."
28422 msgstr ""
28423
28424 #. type: =head2
28425 #: ../src/guestfs-actions.pod:4806
28426 msgid "guestfs_mknod_b"
28427 msgstr ""
28428
28429 #. type: verbatim
28430 #: ../src/guestfs-actions.pod:4808
28431 #, no-wrap
28432 msgid ""
28433 " int\n"
28434 " guestfs_mknod_b (guestfs_h *g,\n"
28435 "                  int mode,\n"
28436 "                  int devmajor,\n"
28437 "                  int devminor,\n"
28438 "                  const char *path);\n"
28439 "\n"
28440 msgstr ""
28441
28442 #. type: textblock
28443 #: ../src/guestfs-actions.pod:4815
28444 msgid ""
28445 "This call creates a block device node called C<path> with mode C<mode> and "
28446 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28447 "wrapper around C<guestfs_mknod>."
28448 msgstr ""
28449
28450 #. type: =head2
28451 #: ../src/guestfs-actions.pod:4825
28452 msgid "guestfs_mknod_c"
28453 msgstr ""
28454
28455 #. type: verbatim
28456 #: ../src/guestfs-actions.pod:4827
28457 #, no-wrap
28458 msgid ""
28459 " int\n"
28460 " guestfs_mknod_c (guestfs_h *g,\n"
28461 "                  int mode,\n"
28462 "                  int devmajor,\n"
28463 "                  int devminor,\n"
28464 "                  const char *path);\n"
28465 "\n"
28466 msgstr ""
28467
28468 #. type: textblock
28469 #: ../src/guestfs-actions.pod:4834
28470 msgid ""
28471 "This call creates a char device node called C<path> with mode C<mode> and "
28472 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28473 "wrapper around C<guestfs_mknod>."
28474 msgstr ""
28475
28476 #. type: =head2
28477 #: ../src/guestfs-actions.pod:4844
28478 msgid "guestfs_mkswap"
28479 msgstr ""
28480
28481 #. type: verbatim
28482 #: ../src/guestfs-actions.pod:4846
28483 #, no-wrap
28484 msgid ""
28485 " int\n"
28486 " guestfs_mkswap (guestfs_h *g,\n"
28487 "                 const char *device);\n"
28488 "\n"
28489 msgstr ""
28490
28491 #. type: =head2
28492 #: ../src/guestfs-actions.pod:4856
28493 msgid "guestfs_mkswap_L"
28494 msgstr ""
28495
28496 #. type: verbatim
28497 #: ../src/guestfs-actions.pod:4858
28498 #, no-wrap
28499 msgid ""
28500 " int\n"
28501 " guestfs_mkswap_L (guestfs_h *g,\n"
28502 "                   const char *label,\n"
28503 "                   const char *device);\n"
28504 "\n"
28505 msgstr ""
28506
28507 #. type: =head2
28508 #: ../src/guestfs-actions.pod:4873
28509 msgid "guestfs_mkswap_U"
28510 msgstr ""
28511
28512 #. type: verbatim
28513 #: ../src/guestfs-actions.pod:4875
28514 #, no-wrap
28515 msgid ""
28516 " int\n"
28517 " guestfs_mkswap_U (guestfs_h *g,\n"
28518 "                   const char *uuid,\n"
28519 "                   const char *device);\n"
28520 "\n"
28521 msgstr ""
28522
28523 #. type: =head2
28524 #: ../src/guestfs-actions.pod:4886
28525 msgid "guestfs_mkswap_file"
28526 msgstr ""
28527
28528 #. type: verbatim
28529 #: ../src/guestfs-actions.pod:4888
28530 #, no-wrap
28531 msgid ""
28532 " int\n"
28533 " guestfs_mkswap_file (guestfs_h *g,\n"
28534 "                      const char *path);\n"
28535 "\n"
28536 msgstr ""
28537
28538 #. type: textblock
28539 #: ../src/guestfs-actions.pod:4894
28540 msgid ""
28541 "This command just writes a swap file signature to an existing file.  To "
28542 "create the file itself, use something like C<guestfs_fallocate>."
28543 msgstr ""
28544
28545 #. type: =head2
28546 #: ../src/guestfs-actions.pod:4901
28547 msgid "guestfs_modprobe"
28548 msgstr ""
28549
28550 #. type: verbatim
28551 #: ../src/guestfs-actions.pod:4903
28552 #, no-wrap
28553 msgid ""
28554 " int\n"
28555 " guestfs_modprobe (guestfs_h *g,\n"
28556 "                   const char *modulename);\n"
28557 "\n"
28558 msgstr ""
28559
28560 #. type: =head2
28561 #: ../src/guestfs-actions.pod:4916
28562 msgid "guestfs_mount"
28563 msgstr ""
28564
28565 #. type: verbatim
28566 #: ../src/guestfs-actions.pod:4918
28567 #, no-wrap
28568 msgid ""
28569 " int\n"
28570 " guestfs_mount (guestfs_h *g,\n"
28571 "                const char *device,\n"
28572 "                const char *mountpoint);\n"
28573 "\n"
28574 msgstr ""
28575
28576 #. type: textblock
28577 #: ../src/guestfs-actions.pod:4937
28578 msgid ""
28579 "B<Important note:> When you use this call, the filesystem options C<sync> "
28580 "and C<noatime> are set implicitly.  This was originally done because we "
28581 "thought it would improve reliability, but it turns out that I<-o sync> has a "
28582 "very large negative performance impact and negligible effect on "
28583 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
28584 "in any code that needs performance, and instead use C<guestfs_mount_options> "
28585 "(use an empty string for the first parameter if you don't want any options)."
28586 msgstr ""
28587
28588 #. type: textblock
28589 #: ../src/guestfs-actions.pod:4949
28590 msgid ""
28591 "This function is deprecated.  In new code, use the L</guestfs_mount_options> "
28592 "call instead."
28593 msgstr ""
28594
28595 #. type: =head2
28596 #: ../src/guestfs-actions.pod:4958
28597 msgid "guestfs_mount_9p"
28598 msgstr ""
28599
28600 #. type: verbatim
28601 #: ../src/guestfs-actions.pod:4960
28602 #, no-wrap
28603 msgid ""
28604 " int\n"
28605 " guestfs_mount_9p (guestfs_h *g,\n"
28606 "                   const char *mounttag,\n"
28607 "                   const char *mountpoint,\n"
28608 "                   ...);\n"
28609 "\n"
28610 msgstr ""
28611
28612 #. type: verbatim
28613 #: ../src/guestfs-actions.pod:4971
28614 #, no-wrap
28615 msgid ""
28616 " GUESTFS_MOUNT_9P_OPTIONS, const char *options,\n"
28617 "\n"
28618 msgstr ""
28619
28620 #. type: =head2
28621 #: ../src/guestfs-actions.pod:4984
28622 msgid "guestfs_mount_9p_va"
28623 msgstr ""
28624
28625 #. type: verbatim
28626 #: ../src/guestfs-actions.pod:4986
28627 #, no-wrap
28628 msgid ""
28629 " int\n"
28630 " guestfs_mount_9p_va (guestfs_h *g,\n"
28631 "                      const char *mounttag,\n"
28632 "                      const char *mountpoint,\n"
28633 "                      va_list args);\n"
28634 "\n"
28635 msgstr ""
28636
28637 #. type: textblock
28638 #: ../src/guestfs-actions.pod:4992
28639 msgid "This is the \"va_list variant\" of L</guestfs_mount_9p>."
28640 msgstr ""
28641
28642 #. type: =head2
28643 #: ../src/guestfs-actions.pod:4996
28644 msgid "guestfs_mount_9p_argv"
28645 msgstr ""
28646
28647 #. type: verbatim
28648 #: ../src/guestfs-actions.pod:4998
28649 #, no-wrap
28650 msgid ""
28651 " int\n"
28652 " guestfs_mount_9p_argv (guestfs_h *g,\n"
28653 "                        const char *mounttag,\n"
28654 "                        const char *mountpoint,\n"
28655 "                        const struct guestfs_mount_9p_argv *optargs);\n"
28656 "\n"
28657 msgstr ""
28658
28659 #. type: textblock
28660 #: ../src/guestfs-actions.pod:5004
28661 msgid "This is the \"argv variant\" of L</guestfs_mount_9p>."
28662 msgstr ""
28663
28664 #. type: =head2
28665 #: ../src/guestfs-actions.pod:5008
28666 msgid "guestfs_mount_loop"
28667 msgstr ""
28668
28669 #. type: verbatim
28670 #: ../src/guestfs-actions.pod:5010
28671 #, no-wrap
28672 msgid ""
28673 " int\n"
28674 " guestfs_mount_loop (guestfs_h *g,\n"
28675 "                     const char *file,\n"
28676 "                     const char *mountpoint);\n"
28677 "\n"
28678 msgstr ""
28679
28680 #. type: =head2
28681 #: ../src/guestfs-actions.pod:5023
28682 msgid "guestfs_mount_options"
28683 msgstr ""
28684
28685 #. type: verbatim
28686 #: ../src/guestfs-actions.pod:5025
28687 #, no-wrap
28688 msgid ""
28689 " int\n"
28690 " guestfs_mount_options (guestfs_h *g,\n"
28691 "                        const char *options,\n"
28692 "                        const char *device,\n"
28693 "                        const char *mountpoint);\n"
28694 "\n"
28695 msgstr ""
28696
28697 #. type: textblock
28698 #: ../src/guestfs-actions.pod:5031
28699 msgid ""
28700 "This is the same as the C<guestfs_mount> command, but it allows you to set "
28701 "the mount options as for the L<mount(8)> I<-o> flag."
28702 msgstr ""
28703
28704 #. type: textblock
28705 #: ../src/guestfs-actions.pod:5041 ../src/guestfs-actions.pod:5055
28706 #: ../src/guestfs-actions.pod:5072
28707 msgid "(Added in 1.0.10)"
28708 msgstr ""
28709
28710 #. type: =head2
28711 #: ../src/guestfs-actions.pod:5043
28712 msgid "guestfs_mount_ro"
28713 msgstr ""
28714
28715 #. type: verbatim
28716 #: ../src/guestfs-actions.pod:5045
28717 #, no-wrap
28718 msgid ""
28719 " int\n"
28720 " guestfs_mount_ro (guestfs_h *g,\n"
28721 "                   const char *device,\n"
28722 "                   const char *mountpoint);\n"
28723 "\n"
28724 msgstr ""
28725
28726 #. type: textblock
28727 #: ../src/guestfs-actions.pod:5050
28728 msgid ""
28729 "This is the same as the C<guestfs_mount> command, but it mounts the "
28730 "filesystem with the read-only (I<-o ro>) flag."
28731 msgstr ""
28732
28733 #. type: =head2
28734 #: ../src/guestfs-actions.pod:5057
28735 msgid "guestfs_mount_vfs"
28736 msgstr ""
28737
28738 #. type: verbatim
28739 #: ../src/guestfs-actions.pod:5059
28740 #, no-wrap
28741 msgid ""
28742 " int\n"
28743 " guestfs_mount_vfs (guestfs_h *g,\n"
28744 "                    const char *options,\n"
28745 "                    const char *vfstype,\n"
28746 "                    const char *device,\n"
28747 "                    const char *mountpoint);\n"
28748 "\n"
28749 msgstr ""
28750
28751 #. type: textblock
28752 #: ../src/guestfs-actions.pod:5066
28753 msgid ""
28754 "This is the same as the C<guestfs_mount> command, but it allows you to set "
28755 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
28756 "t> flags."
28757 msgstr ""
28758
28759 #. type: =head2
28760 #: ../src/guestfs-actions.pod:5074
28761 msgid "guestfs_mountpoints"
28762 msgstr ""
28763
28764 #. type: verbatim
28765 #: ../src/guestfs-actions.pod:5076
28766 #, no-wrap
28767 msgid ""
28768 " char **\n"
28769 " guestfs_mountpoints (guestfs_h *g);\n"
28770 "\n"
28771 msgstr ""
28772
28773 #. type: textblock
28774 #: ../src/guestfs-actions.pod:5079
28775 msgid ""
28776 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
28777 "devices.  This one returns a hash table (map) of device name to directory "
28778 "where the device is mounted."
28779 msgstr ""
28780
28781 #. type: =head2
28782 #: ../src/guestfs-actions.pod:5091
28783 msgid "guestfs_mounts"
28784 msgstr ""
28785
28786 #. type: verbatim
28787 #: ../src/guestfs-actions.pod:5093
28788 #, no-wrap
28789 msgid ""
28790 " char **\n"
28791 " guestfs_mounts (guestfs_h *g);\n"
28792 "\n"
28793 msgstr ""
28794
28795 #. type: textblock
28796 #: ../src/guestfs-actions.pod:5101
28797 msgid "See also: C<guestfs_mountpoints>"
28798 msgstr ""
28799
28800 #. type: =head2
28801 #: ../src/guestfs-actions.pod:5109
28802 msgid "guestfs_mv"
28803 msgstr ""
28804
28805 #. type: verbatim
28806 #: ../src/guestfs-actions.pod:5111
28807 #, no-wrap
28808 msgid ""
28809 " int\n"
28810 " guestfs_mv (guestfs_h *g,\n"
28811 "             const char *src,\n"
28812 "             const char *dest);\n"
28813 "\n"
28814 msgstr ""
28815
28816 #. type: =head2
28817 #: ../src/guestfs-actions.pod:5123
28818 msgid "guestfs_ntfs_3g_probe"
28819 msgstr ""
28820
28821 #. type: verbatim
28822 #: ../src/guestfs-actions.pod:5125
28823 #, no-wrap
28824 msgid ""
28825 " int\n"
28826 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
28827 "                        int rw,\n"
28828 "                        const char *device);\n"
28829 "\n"
28830 msgstr ""
28831
28832 #. type: textblock
28833 #: ../src/guestfs-actions.pod:5144
28834 msgid "(Added in 1.0.43)"
28835 msgstr ""
28836
28837 #. type: =head2
28838 #: ../src/guestfs-actions.pod:5146
28839 msgid "guestfs_ntfsresize"
28840 msgstr ""
28841
28842 #. type: verbatim
28843 #: ../src/guestfs-actions.pod:5148
28844 #, no-wrap
28845 msgid ""
28846 " int\n"
28847 " guestfs_ntfsresize (guestfs_h *g,\n"
28848 "                     const char *device);\n"
28849 "\n"
28850 msgstr ""
28851
28852 #. type: textblock
28853 #: ../src/guestfs-actions.pod:5167 ../src/guestfs-actions.pod:5257
28854 msgid ""
28855 "This function is deprecated.  In new code, use the L</"
28856 "guestfs_ntfsresize_opts> call instead."
28857 msgstr ""
28858
28859 #. type: =head2
28860 #: ../src/guestfs-actions.pod:5176
28861 msgid "guestfs_ntfsresize_opts"
28862 msgstr ""
28863
28864 #. type: verbatim
28865 #: ../src/guestfs-actions.pod:5178
28866 #, no-wrap
28867 msgid ""
28868 " int\n"
28869 " guestfs_ntfsresize_opts (guestfs_h *g,\n"
28870 "                          const char *device,\n"
28871 "                          ...);\n"
28872 "\n"
28873 msgstr ""
28874
28875 #. type: verbatim
28876 #: ../src/guestfs-actions.pod:5188
28877 #, no-wrap
28878 msgid ""
28879 " GUESTFS_NTFSRESIZE_OPTS_SIZE, int64_t size,\n"
28880 " GUESTFS_NTFSRESIZE_OPTS_FORCE, int force,\n"
28881 "\n"
28882 msgstr ""
28883
28884 #. type: textblock
28885 #: ../src/guestfs-actions.pod:5208
28886 msgid ""
28887 "After the resize operation, the filesystem is always marked as requiring a "
28888 "consistency check (for safety).  You have to boot into Windows to perform "
28889 "this check and clear this condition.  If you I<don't> set the C<force> "
28890 "option then it is not possible to call C<guestfs_ntfsresize_opts> multiple "
28891 "times on a single filesystem without booting into Windows between each "
28892 "resize."
28893 msgstr ""
28894
28895 #. type: =head2
28896 #: ../src/guestfs-actions.pod:5223
28897 msgid "guestfs_ntfsresize_opts_va"
28898 msgstr ""
28899
28900 #. type: verbatim
28901 #: ../src/guestfs-actions.pod:5225
28902 #, no-wrap
28903 msgid ""
28904 " int\n"
28905 " guestfs_ntfsresize_opts_va (guestfs_h *g,\n"
28906 "                             const char *device,\n"
28907 "                             va_list args);\n"
28908 "\n"
28909 msgstr ""
28910
28911 #. type: textblock
28912 #: ../src/guestfs-actions.pod:5230
28913 msgid "This is the \"va_list variant\" of L</guestfs_ntfsresize_opts>."
28914 msgstr ""
28915
28916 #. type: =head2
28917 #: ../src/guestfs-actions.pod:5234
28918 msgid "guestfs_ntfsresize_opts_argv"
28919 msgstr ""
28920
28921 #. type: verbatim
28922 #: ../src/guestfs-actions.pod:5236
28923 #, no-wrap
28924 msgid ""
28925 " int\n"
28926 " guestfs_ntfsresize_opts_argv (guestfs_h *g,\n"
28927 "                               const char *device,\n"
28928 "                               const struct guestfs_ntfsresize_opts_argv *optargs);\n"
28929 "\n"
28930 msgstr ""
28931
28932 #. type: textblock
28933 #: ../src/guestfs-actions.pod:5241
28934 msgid "This is the \"argv variant\" of L</guestfs_ntfsresize_opts>."
28935 msgstr ""
28936
28937 #. type: =head2
28938 #: ../src/guestfs-actions.pod:5245
28939 msgid "guestfs_ntfsresize_size"
28940 msgstr ""
28941
28942 #. type: verbatim
28943 #: ../src/guestfs-actions.pod:5247
28944 #, no-wrap
28945 msgid ""
28946 " int\n"
28947 " guestfs_ntfsresize_size (guestfs_h *g,\n"
28948 "                          const char *device,\n"
28949 "                          int64_t size);\n"
28950 "\n"
28951 msgstr ""
28952
28953 #. type: textblock
28954 #: ../src/guestfs-actions.pod:5252
28955 msgid ""
28956 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
28957 "to specify the new size (in bytes) explicitly."
28958 msgstr ""
28959
28960 #. type: textblock
28961 #: ../src/guestfs-actions.pod:5264 ../src/guestfs-actions.pod:5706
28962 #: ../src/guestfs-actions.pod:5779 ../src/guestfs-actions.pod:6047
28963 #: ../src/guestfs-actions.pod:7670
28964 msgid "(Added in 1.3.14)"
28965 msgstr ""
28966
28967 #. type: =head2
28968 #: ../src/guestfs-actions.pod:5266
28969 msgid "guestfs_part_add"
28970 msgstr ""
28971
28972 #. type: verbatim
28973 #: ../src/guestfs-actions.pod:5268
28974 #, no-wrap
28975 msgid ""
28976 " int\n"
28977 " guestfs_part_add (guestfs_h *g,\n"
28978 "                   const char *device,\n"
28979 "                   const char *prlogex,\n"
28980 "                   int64_t startsect,\n"
28981 "                   int64_t endsect);\n"
28982 "\n"
28983 msgstr ""
28984
28985 #. type: textblock
28986 #: ../src/guestfs-actions.pod:5275
28987 msgid ""
28988 "This command adds a partition to C<device>.  If there is no partition table "
28989 "on the device, call C<guestfs_part_init> first."
28990 msgstr ""
28991
28992 #. type: textblock
28993 #: ../src/guestfs-actions.pod:5287
28994 msgid ""
28995 "Creating a partition which covers the whole disk is not so easy.  Use "
28996 "C<guestfs_part_disk> to do that."
28997 msgstr ""
28998
28999 #. type: textblock
29000 #: ../src/guestfs-actions.pod:5292 ../src/guestfs-actions.pod:5330
29001 #: ../src/guestfs-actions.pod:5383 ../src/guestfs-actions.pod:5467
29002 #: ../src/guestfs-actions.pod:5505 ../src/guestfs-actions.pod:5524
29003 #: ../src/guestfs-actions.pod:5564
29004 msgid "(Added in 1.0.78)"
29005 msgstr ""
29006
29007 #. type: =head2
29008 #: ../src/guestfs-actions.pod:5294
29009 msgid "guestfs_part_del"
29010 msgstr ""
29011
29012 #. type: verbatim
29013 #: ../src/guestfs-actions.pod:5296
29014 #, no-wrap
29015 msgid ""
29016 " int\n"
29017 " guestfs_part_del (guestfs_h *g,\n"
29018 "                   const char *device,\n"
29019 "                   int partnum);\n"
29020 "\n"
29021 msgstr ""
29022
29023 #. type: =head2
29024 #: ../src/guestfs-actions.pod:5311
29025 msgid "guestfs_part_disk"
29026 msgstr ""
29027
29028 #. type: verbatim
29029 #: ../src/guestfs-actions.pod:5313
29030 #, no-wrap
29031 msgid ""
29032 " int\n"
29033 " guestfs_part_disk (guestfs_h *g,\n"
29034 "                    const char *device,\n"
29035 "                    const char *parttype);\n"
29036 "\n"
29037 msgstr ""
29038
29039 #. type: textblock
29040 #: ../src/guestfs-actions.pod:5318
29041 msgid ""
29042 "This command is simply a combination of C<guestfs_part_init> followed by "
29043 "C<guestfs_part_add> to create a single primary partition covering the whole "
29044 "disk."
29045 msgstr ""
29046
29047 #. type: textblock
29048 #: ../src/guestfs-actions.pod:5322
29049 msgid ""
29050 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
29051 "possible values are described in C<guestfs_part_init>."
29052 msgstr ""
29053
29054 #. type: =head2
29055 #: ../src/guestfs-actions.pod:5332
29056 msgid "guestfs_part_get_bootable"
29057 msgstr ""
29058
29059 #. type: verbatim
29060 #: ../src/guestfs-actions.pod:5334
29061 #, no-wrap
29062 msgid ""
29063 " int\n"
29064 " guestfs_part_get_bootable (guestfs_h *g,\n"
29065 "                            const char *device,\n"
29066 "                            int partnum);\n"
29067 "\n"
29068 msgstr ""
29069
29070 #. type: textblock
29071 #: ../src/guestfs-actions.pod:5342
29072 msgid "See also C<guestfs_part_set_bootable>."
29073 msgstr ""
29074
29075 #. type: =head2
29076 #: ../src/guestfs-actions.pod:5348
29077 msgid "guestfs_part_get_mbr_id"
29078 msgstr ""
29079
29080 #. type: verbatim
29081 #: ../src/guestfs-actions.pod:5350
29082 #, no-wrap
29083 msgid ""
29084 " int\n"
29085 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
29086 "                          const char *device,\n"
29087 "                          int partnum);\n"
29088 "\n"
29089 msgstr ""
29090
29091 #. type: textblock
29092 #: ../src/guestfs-actions.pod:5358 ../src/guestfs-actions.pod:5540
29093 msgid ""
29094 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
29095 "undefined results for other partition table types (see "
29096 "C<guestfs_part_get_parttype>)."
29097 msgstr ""
29098
29099 #. type: =head2
29100 #: ../src/guestfs-actions.pod:5366
29101 msgid "guestfs_part_get_parttype"
29102 msgstr ""
29103
29104 #. type: verbatim
29105 #: ../src/guestfs-actions.pod:5368
29106 #, no-wrap
29107 msgid ""
29108 " char *\n"
29109 " guestfs_part_get_parttype (guestfs_h *g,\n"
29110 "                            const char *device);\n"
29111 "\n"
29112 msgstr ""
29113
29114 #. type: textblock
29115 #: ../src/guestfs-actions.pod:5375
29116 msgid ""
29117 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
29118 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
29119 "possible, although unusual.  See C<guestfs_part_init> for a full list."
29120 msgstr ""
29121
29122 #. type: =head2
29123 #: ../src/guestfs-actions.pod:5385
29124 msgid "guestfs_part_init"
29125 msgstr ""
29126
29127 #. type: verbatim
29128 #: ../src/guestfs-actions.pod:5387
29129 #, no-wrap
29130 msgid ""
29131 " int\n"
29132 " guestfs_part_init (guestfs_h *g,\n"
29133 "                    const char *device,\n"
29134 "                    const char *parttype);\n"
29135 "\n"
29136 msgstr ""
29137
29138 #. type: textblock
29139 #: ../src/guestfs-actions.pod:5396
29140 msgid ""
29141 "Initially there are no partitions.  Following this, you should call "
29142 "C<guestfs_part_add> for each partition required."
29143 msgstr ""
29144
29145 #. type: =head2
29146 #: ../src/guestfs-actions.pod:5469
29147 msgid "guestfs_part_list"
29148 msgstr "guestfs_part_list"
29149
29150 #. type: verbatim
29151 #: ../src/guestfs-actions.pod:5471
29152 #, no-wrap
29153 msgid ""
29154 " struct guestfs_partition_list *\n"
29155 " guestfs_part_list (guestfs_h *g,\n"
29156 "                    const char *device);\n"
29157 "\n"
29158 msgstr ""
29159 " struct guestfs_partition_list *\n"
29160 " guestfs_part_list (guestfs_h *g,\n"
29161 "                    const char *device);\n"
29162 "\n"
29163
29164 #. type: textblock
29165 #: ../src/guestfs-actions.pod:5488
29166 msgid ""
29167 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
29168 "the device's sector size, see C<guestfs_blockdev_getss>."
29169 msgstr ""
29170
29171 #. type: textblock
29172 #: ../src/guestfs-actions.pod:5501
29173 msgid ""
29174 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
29175 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
29176 "use>."
29177 msgstr ""
29178
29179 #. type: =head2
29180 #: ../src/guestfs-actions.pod:5507
29181 msgid "guestfs_part_set_bootable"
29182 msgstr ""
29183
29184 #. type: verbatim
29185 #: ../src/guestfs-actions.pod:5509
29186 #, no-wrap
29187 msgid ""
29188 " int\n"
29189 " guestfs_part_set_bootable (guestfs_h *g,\n"
29190 "                            const char *device,\n"
29191 "                            int partnum,\n"
29192 "                            int bootable);\n"
29193 "\n"
29194 msgstr ""
29195
29196 #. type: =head2
29197 #: ../src/guestfs-actions.pod:5526
29198 msgid "guestfs_part_set_mbr_id"
29199 msgstr ""
29200
29201 #. type: verbatim
29202 #: ../src/guestfs-actions.pod:5528
29203 #, no-wrap
29204 msgid ""
29205 " int\n"
29206 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
29207 "                          const char *device,\n"
29208 "                          int partnum,\n"
29209 "                          int idbyte);\n"
29210 "\n"
29211 msgstr ""
29212
29213 #. type: =head2
29214 #: ../src/guestfs-actions.pod:5548
29215 msgid "guestfs_part_set_name"
29216 msgstr ""
29217
29218 #. type: verbatim
29219 #: ../src/guestfs-actions.pod:5550
29220 #, no-wrap
29221 msgid ""
29222 " int\n"
29223 " guestfs_part_set_name (guestfs_h *g,\n"
29224 "                        const char *device,\n"
29225 "                        int partnum,\n"
29226 "                        const char *name);\n"
29227 "\n"
29228 msgstr ""
29229
29230 #. type: =head2
29231 #: ../src/guestfs-actions.pod:5566
29232 msgid "guestfs_part_to_dev"
29233 msgstr ""
29234
29235 #. type: verbatim
29236 #: ../src/guestfs-actions.pod:5568
29237 #, no-wrap
29238 msgid ""
29239 " char *\n"
29240 " guestfs_part_to_dev (guestfs_h *g,\n"
29241 "                      const char *partition);\n"
29242 "\n"
29243 msgstr ""
29244
29245 #. type: textblock
29246 #: ../src/guestfs-actions.pod:5576
29247 msgid ""
29248 "The named partition must exist, for example as a string returned from "
29249 "C<guestfs_list_partitions>."
29250 msgstr ""
29251
29252 #. type: =head2
29253 #: ../src/guestfs-actions.pod:5584
29254 msgid "guestfs_ping_daemon"
29255 msgstr ""
29256
29257 #. type: verbatim
29258 #: ../src/guestfs-actions.pod:5586
29259 #, no-wrap
29260 msgid ""
29261 " int\n"
29262 " guestfs_ping_daemon (guestfs_h *g);\n"
29263 "\n"
29264 msgstr ""
29265
29266 #. type: =head2
29267 #: ../src/guestfs-actions.pod:5598
29268 msgid "guestfs_pread"
29269 msgstr ""
29270
29271 #. type: verbatim
29272 #: ../src/guestfs-actions.pod:5600
29273 #, no-wrap
29274 msgid ""
29275 " char *\n"
29276 " guestfs_pread (guestfs_h *g,\n"
29277 "                const char *path,\n"
29278 "                int count,\n"
29279 "                int64_t offset,\n"
29280 "                size_t *size_r);\n"
29281 "\n"
29282 msgstr ""
29283
29284 #. type: textblock
29285 #: ../src/guestfs-actions.pod:5613
29286 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
29287 msgstr ""
29288
29289 #. type: =head2
29290 #: ../src/guestfs-actions.pod:5624
29291 msgid "guestfs_pread_device"
29292 msgstr ""
29293
29294 #. type: verbatim
29295 #: ../src/guestfs-actions.pod:5626
29296 #, no-wrap
29297 msgid ""
29298 " char *\n"
29299 " guestfs_pread_device (guestfs_h *g,\n"
29300 "                       const char *device,\n"
29301 "                       int count,\n"
29302 "                       int64_t offset,\n"
29303 "                       size_t *size_r);\n"
29304 "\n"
29305 msgstr ""
29306
29307 #. type: textblock
29308 #: ../src/guestfs-actions.pod:5639
29309 msgid "See also C<guestfs_pread>."
29310 msgstr ""
29311
29312 #. type: textblock
29313 #: ../src/guestfs-actions.pod:5648
29314 msgid "(Added in 1.5.21)"
29315 msgstr ""
29316
29317 #. type: =head2
29318 #: ../src/guestfs-actions.pod:5650
29319 msgid "guestfs_pvcreate"
29320 msgstr ""
29321
29322 #. type: verbatim
29323 #: ../src/guestfs-actions.pod:5652
29324 #, no-wrap
29325 msgid ""
29326 " int\n"
29327 " guestfs_pvcreate (guestfs_h *g,\n"
29328 "                   const char *device);\n"
29329 "\n"
29330 msgstr ""
29331
29332 #. type: =head2
29333 #: ../src/guestfs-actions.pod:5664
29334 msgid "guestfs_pvremove"
29335 msgstr ""
29336
29337 #. type: verbatim
29338 #: ../src/guestfs-actions.pod:5666
29339 #, no-wrap
29340 msgid ""
29341 " int\n"
29342 " guestfs_pvremove (guestfs_h *g,\n"
29343 "                   const char *device);\n"
29344 "\n"
29345 msgstr ""
29346
29347 #. type: =head2
29348 #: ../src/guestfs-actions.pod:5681
29349 msgid "guestfs_pvresize"
29350 msgstr ""
29351
29352 #. type: verbatim
29353 #: ../src/guestfs-actions.pod:5683
29354 #, no-wrap
29355 msgid ""
29356 " int\n"
29357 " guestfs_pvresize (guestfs_h *g,\n"
29358 "                   const char *device);\n"
29359 "\n"
29360 msgstr ""
29361
29362 #. type: =head2
29363 #: ../src/guestfs-actions.pod:5694
29364 msgid "guestfs_pvresize_size"
29365 msgstr ""
29366
29367 #. type: verbatim
29368 #: ../src/guestfs-actions.pod:5696
29369 #, no-wrap
29370 msgid ""
29371 " int\n"
29372 " guestfs_pvresize_size (guestfs_h *g,\n"
29373 "                        const char *device,\n"
29374 "                        int64_t size);\n"
29375 "\n"
29376 msgstr ""
29377
29378 #. type: textblock
29379 #: ../src/guestfs-actions.pod:5701
29380 msgid ""
29381 "This command is the same as C<guestfs_pvresize> except that it allows you to "
29382 "specify the new size (in bytes) explicitly."
29383 msgstr ""
29384
29385 #. type: =head2
29386 #: ../src/guestfs-actions.pod:5708
29387 msgid "guestfs_pvs"
29388 msgstr ""
29389
29390 #. type: verbatim
29391 #: ../src/guestfs-actions.pod:5710
29392 #, no-wrap
29393 msgid ""
29394 " char **\n"
29395 " guestfs_pvs (guestfs_h *g);\n"
29396 "\n"
29397 msgstr ""
29398
29399 #. type: textblock
29400 #: ../src/guestfs-actions.pod:5719
29401 msgid "See also C<guestfs_pvs_full>."
29402 msgstr ""
29403
29404 #. type: =head2
29405 #: ../src/guestfs-actions.pod:5727
29406 msgid "guestfs_pvs_full"
29407 msgstr ""
29408
29409 #. type: verbatim
29410 #: ../src/guestfs-actions.pod:5729
29411 #, no-wrap
29412 msgid ""
29413 " struct guestfs_lvm_pv_list *\n"
29414 " guestfs_pvs_full (guestfs_h *g);\n"
29415 "\n"
29416 msgstr ""
29417
29418 #. type: textblock
29419 #: ../src/guestfs-actions.pod:5735
29420 msgid ""
29421 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
29422 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
29423 msgstr ""
29424
29425 #. type: =head2
29426 #: ../src/guestfs-actions.pod:5741
29427 msgid "guestfs_pvuuid"
29428 msgstr ""
29429
29430 #. type: verbatim
29431 #: ../src/guestfs-actions.pod:5743
29432 #, no-wrap
29433 msgid ""
29434 " char *\n"
29435 " guestfs_pvuuid (guestfs_h *g,\n"
29436 "                 const char *device);\n"
29437 "\n"
29438 msgstr ""
29439
29440 #. type: =head2
29441 #: ../src/guestfs-actions.pod:5754
29442 msgid "guestfs_pwrite"
29443 msgstr ""
29444
29445 #. type: verbatim
29446 #: ../src/guestfs-actions.pod:5756
29447 #, no-wrap
29448 msgid ""
29449 " int\n"
29450 " guestfs_pwrite (guestfs_h *g,\n"
29451 "                 const char *path,\n"
29452 "                 const char *content,\n"
29453 "                 size_t content_size,\n"
29454 "                 int64_t offset);\n"
29455 "\n"
29456 msgstr ""
29457
29458 #. type: textblock
29459 #: ../src/guestfs-actions.pod:5772
29460 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
29461 msgstr ""
29462
29463 #. type: =head2
29464 #: ../src/guestfs-actions.pod:5781
29465 msgid "guestfs_pwrite_device"
29466 msgstr ""
29467
29468 #. type: verbatim
29469 #: ../src/guestfs-actions.pod:5783
29470 #, no-wrap
29471 msgid ""
29472 " int\n"
29473 " guestfs_pwrite_device (guestfs_h *g,\n"
29474 "                        const char *device,\n"
29475 "                        const char *content,\n"
29476 "                        size_t content_size,\n"
29477 "                        int64_t offset);\n"
29478 "\n"
29479 msgstr ""
29480
29481 #. type: textblock
29482 #: ../src/guestfs-actions.pod:5798
29483 msgid "See also C<guestfs_pwrite>."
29484 msgstr ""
29485
29486 #. type: textblock
29487 #: ../src/guestfs-actions.pod:5805
29488 msgid "(Added in 1.5.20)"
29489 msgstr ""
29490
29491 #. type: =head2
29492 #: ../src/guestfs-actions.pod:5807
29493 msgid "guestfs_read_file"
29494 msgstr ""
29495
29496 #. type: verbatim
29497 #: ../src/guestfs-actions.pod:5809
29498 #, no-wrap
29499 msgid ""
29500 " char *\n"
29501 " guestfs_read_file (guestfs_h *g,\n"
29502 "                    const char *path,\n"
29503 "                    size_t *size_r);\n"
29504 "\n"
29505 msgstr ""
29506
29507 #. type: textblock
29508 #: ../src/guestfs-actions.pod:5817
29509 msgid ""
29510 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
29511 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
29512 "function is limited in the total size of file that can be handled."
29513 msgstr ""
29514
29515 #. type: textblock
29516 #: ../src/guestfs-actions.pod:5829
29517 msgid "(Added in 1.0.63)"
29518 msgstr ""
29519
29520 #. type: =head2
29521 #: ../src/guestfs-actions.pod:5831
29522 msgid "guestfs_read_lines"
29523 msgstr ""
29524
29525 #. type: verbatim
29526 #: ../src/guestfs-actions.pod:5833
29527 #, no-wrap
29528 msgid ""
29529 " char **\n"
29530 " guestfs_read_lines (guestfs_h *g,\n"
29531 "                     const char *path);\n"
29532 "\n"
29533 msgstr ""
29534
29535 #. type: textblock
29536 #: ../src/guestfs-actions.pod:5842
29537 msgid ""
29538 "Note that this function cannot correctly handle binary files (specifically, "
29539 "files containing C<\\0> character which is treated as end of line).  For "
29540 "those you need to use the C<guestfs_read_file> function which has a more "
29541 "complex interface."
29542 msgstr ""
29543
29544 #. type: =head2
29545 #: ../src/guestfs-actions.pod:5853
29546 msgid "guestfs_readdir"
29547 msgstr ""
29548
29549 #. type: verbatim
29550 #: ../src/guestfs-actions.pod:5855
29551 #, no-wrap
29552 msgid ""
29553 " struct guestfs_dirent_list *\n"
29554 " guestfs_readdir (guestfs_h *g,\n"
29555 "                  const char *dir);\n"
29556 "\n"
29557 msgstr ""
29558
29559 #. type: textblock
29560 #: ../src/guestfs-actions.pod:5909
29561 msgid ""
29562 "This function is primarily intended for use by programs.  To get a simple "
29563 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
29564 "consumption, use C<guestfs_ll>."
29565 msgstr ""
29566
29567 #. type: textblock
29568 #: ../src/guestfs-actions.pod:5913
29569 msgid ""
29570 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
29571 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
29572 msgstr ""
29573
29574 #. type: =head2
29575 #: ../src/guestfs-actions.pod:5919
29576 msgid "guestfs_readlink"
29577 msgstr ""
29578
29579 #. type: verbatim
29580 #: ../src/guestfs-actions.pod:5921
29581 #, no-wrap
29582 msgid ""
29583 " char *\n"
29584 " guestfs_readlink (guestfs_h *g,\n"
29585 "                   const char *path);\n"
29586 "\n"
29587 msgstr ""
29588
29589 #. type: =head2
29590 #: ../src/guestfs-actions.pod:5932
29591 msgid "guestfs_readlinklist"
29592 msgstr ""
29593
29594 #. type: verbatim
29595 #: ../src/guestfs-actions.pod:5934
29596 #, no-wrap
29597 msgid ""
29598 " char **\n"
29599 " guestfs_readlinklist (guestfs_h *g,\n"
29600 "                       const char *path,\n"
29601 "                       char *const *names);\n"
29602 "\n"
29603 msgstr ""
29604
29605 #. type: =head2
29606 #: ../src/guestfs-actions.pod:5967
29607 msgid "guestfs_realpath"
29608 msgstr ""
29609
29610 #. type: verbatim
29611 #: ../src/guestfs-actions.pod:5969
29612 #, no-wrap
29613 msgid ""
29614 " char *\n"
29615 " guestfs_realpath (guestfs_h *g,\n"
29616 "                   const char *path);\n"
29617 "\n"
29618 msgstr ""
29619
29620 #. type: =head2
29621 #: ../src/guestfs-actions.pod:5981
29622 msgid "guestfs_removexattr"
29623 msgstr ""
29624
29625 #. type: verbatim
29626 #: ../src/guestfs-actions.pod:5983
29627 #, no-wrap
29628 msgid ""
29629 " int\n"
29630 " guestfs_removexattr (guestfs_h *g,\n"
29631 "                      const char *xattr,\n"
29632 "                      const char *path);\n"
29633 "\n"
29634 msgstr ""
29635
29636 #. type: textblock
29637 #: ../src/guestfs-actions.pod:5991
29638 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
29639 msgstr ""
29640
29641 #. type: =head2
29642 #: ../src/guestfs-actions.pod:5997
29643 msgid "guestfs_resize2fs"
29644 msgstr ""
29645
29646 #. type: verbatim
29647 #: ../src/guestfs-actions.pod:5999
29648 #, no-wrap
29649 msgid ""
29650 " int\n"
29651 " guestfs_resize2fs (guestfs_h *g,\n"
29652 "                    const char *device);\n"
29653 "\n"
29654 msgstr ""
29655
29656 #. type: textblock
29657 #: ../src/guestfs-actions.pod:6006
29658 msgid ""
29659 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
29660 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
29661 "sometimes gives an error about this and sometimes not.  In any case, it is "
29662 "always safe to call C<guestfs_e2fsck_f> before calling this function."
29663 msgstr ""
29664
29665 #. type: =head2
29666 #: ../src/guestfs-actions.pod:6016
29667 msgid "guestfs_resize2fs_M"
29668 msgstr ""
29669
29670 #. type: verbatim
29671 #: ../src/guestfs-actions.pod:6018
29672 #, no-wrap
29673 msgid ""
29674 " int\n"
29675 " guestfs_resize2fs_M (guestfs_h *g,\n"
29676 "                      const char *device);\n"
29677 "\n"
29678 msgstr ""
29679
29680 #. type: textblock
29681 #: ../src/guestfs-actions.pod:6022
29682 msgid ""
29683 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
29684 "resized to its minimum size.  This works like the I<-M> option to the "
29685 "C<resize2fs> command."
29686 msgstr ""
29687
29688 #. type: textblock
29689 #: ../src/guestfs-actions.pod:6026
29690 msgid ""
29691 "To get the resulting size of the filesystem you should call "
29692 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
29693 "These two numbers, multiplied together, give the resulting size of the "
29694 "minimal filesystem in bytes."
29695 msgstr ""
29696
29697 #. type: =head2
29698 #: ../src/guestfs-actions.pod:6035
29699 msgid "guestfs_resize2fs_size"
29700 msgstr ""
29701
29702 #. type: verbatim
29703 #: ../src/guestfs-actions.pod:6037
29704 #, no-wrap
29705 msgid ""
29706 " int\n"
29707 " guestfs_resize2fs_size (guestfs_h *g,\n"
29708 "                         const char *device,\n"
29709 "                         int64_t size);\n"
29710 "\n"
29711 msgstr ""
29712
29713 #. type: textblock
29714 #: ../src/guestfs-actions.pod:6042
29715 msgid ""
29716 "This command is the same as C<guestfs_resize2fs> except that it allows you "
29717 "to specify the new size (in bytes) explicitly."
29718 msgstr ""
29719
29720 #. type: =head2
29721 #: ../src/guestfs-actions.pod:6049
29722 msgid "guestfs_rm"
29723 msgstr ""
29724
29725 #. type: verbatim
29726 #: ../src/guestfs-actions.pod:6051
29727 #, no-wrap
29728 msgid ""
29729 " int\n"
29730 " guestfs_rm (guestfs_h *g,\n"
29731 "             const char *path);\n"
29732 "\n"
29733 msgstr ""
29734
29735 #. type: =head2
29736 #: ../src/guestfs-actions.pod:6061
29737 msgid "guestfs_rm_rf"
29738 msgstr ""
29739
29740 #. type: verbatim
29741 #: ../src/guestfs-actions.pod:6063
29742 #, no-wrap
29743 msgid ""
29744 " int\n"
29745 " guestfs_rm_rf (guestfs_h *g,\n"
29746 "                const char *path);\n"
29747 "\n"
29748 msgstr ""
29749
29750 #. type: =head2
29751 #: ../src/guestfs-actions.pod:6075
29752 msgid "guestfs_rmdir"
29753 msgstr ""
29754
29755 #. type: verbatim
29756 #: ../src/guestfs-actions.pod:6077
29757 #, no-wrap
29758 msgid ""
29759 " int\n"
29760 " guestfs_rmdir (guestfs_h *g,\n"
29761 "                const char *path);\n"
29762 "\n"
29763 msgstr ""
29764
29765 #. type: =head2
29766 #: ../src/guestfs-actions.pod:6087
29767 msgid "guestfs_rmmountpoint"
29768 msgstr ""
29769
29770 #. type: verbatim
29771 #: ../src/guestfs-actions.pod:6089
29772 #, no-wrap
29773 msgid ""
29774 " int\n"
29775 " guestfs_rmmountpoint (guestfs_h *g,\n"
29776 "                       const char *exemptpath);\n"
29777 "\n"
29778 msgstr ""
29779
29780 #. type: textblock
29781 #: ../src/guestfs-actions.pod:6093
29782 msgid ""
29783 "This calls removes a mountpoint that was previously created with "
29784 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
29785 msgstr ""
29786
29787 #. type: =head2
29788 #: ../src/guestfs-actions.pod:6101
29789 msgid "guestfs_scrub_device"
29790 msgstr ""
29791
29792 #. type: verbatim
29793 #: ../src/guestfs-actions.pod:6103
29794 #, no-wrap
29795 msgid ""
29796 " int\n"
29797 " guestfs_scrub_device (guestfs_h *g,\n"
29798 "                       const char *device);\n"
29799 "\n"
29800 msgstr ""
29801
29802 #. type: textblock
29803 #: ../src/guestfs-actions.pod:6118 ../src/guestfs-actions.pod:6136
29804 #: ../src/guestfs-actions.pod:6155
29805 msgid "(Added in 1.0.52)"
29806 msgstr ""
29807
29808 #. type: =head2
29809 #: ../src/guestfs-actions.pod:6120
29810 msgid "guestfs_scrub_file"
29811 msgstr ""
29812
29813 #. type: verbatim
29814 #: ../src/guestfs-actions.pod:6122
29815 #, no-wrap
29816 msgid ""
29817 " int\n"
29818 " guestfs_scrub_file (guestfs_h *g,\n"
29819 "                     const char *file);\n"
29820 "\n"
29821 msgstr ""
29822
29823 #. type: =head2
29824 #: ../src/guestfs-actions.pod:6138
29825 msgid "guestfs_scrub_freespace"
29826 msgstr ""
29827
29828 #. type: verbatim
29829 #: ../src/guestfs-actions.pod:6140
29830 #, no-wrap
29831 msgid ""
29832 " int\n"
29833 " guestfs_scrub_freespace (guestfs_h *g,\n"
29834 "                          const char *dir);\n"
29835 "\n"
29836 msgstr ""
29837
29838 #. type: textblock
29839 #: ../src/guestfs-actions.pod:6144
29840 msgid ""
29841 "This command creates the directory C<dir> and then fills it with files until "
29842 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
29843 "and deletes them.  The intention is to scrub any free space on the partition "
29844 "containing C<dir>."
29845 msgstr ""
29846
29847 #. type: =head2
29848 #: ../src/guestfs-actions.pod:6157
29849 msgid "guestfs_set_append"
29850 msgstr ""
29851
29852 #. type: verbatim
29853 #: ../src/guestfs-actions.pod:6159
29854 #, no-wrap
29855 msgid ""
29856 " int\n"
29857 " guestfs_set_append (guestfs_h *g,\n"
29858 "                     const char *append);\n"
29859 "\n"
29860 msgstr ""
29861
29862 #. type: =head2
29863 #: ../src/guestfs-actions.pod:6176
29864 msgid "guestfs_set_attach_method"
29865 msgstr ""
29866
29867 #. type: verbatim
29868 #: ../src/guestfs-actions.pod:6178
29869 #, no-wrap
29870 msgid ""
29871 " int\n"
29872 " guestfs_set_attach_method (guestfs_h *g,\n"
29873 "                            const char *attachmethod);\n"
29874 "\n"
29875 msgstr ""
29876
29877 #. type: =head2
29878 #: ../src/guestfs-actions.pod:6206
29879 msgid "guestfs_set_autosync"
29880 msgstr ""
29881
29882 #. type: verbatim
29883 #: ../src/guestfs-actions.pod:6208
29884 #, no-wrap
29885 msgid ""
29886 " int\n"
29887 " guestfs_set_autosync (guestfs_h *g,\n"
29888 "                       int autosync);\n"
29889 "\n"
29890 msgstr ""
29891
29892 #. type: =head2
29893 #: ../src/guestfs-actions.pod:6224
29894 msgid "guestfs_set_direct"
29895 msgstr ""
29896
29897 #. type: verbatim
29898 #: ../src/guestfs-actions.pod:6226
29899 #, no-wrap
29900 msgid ""
29901 " int\n"
29902 " guestfs_set_direct (guestfs_h *g,\n"
29903 "                     int direct);\n"
29904 "\n"
29905 msgstr ""
29906
29907 #. type: textblock
29908 #: ../src/guestfs-actions.pod:6234
29909 msgid ""
29910 "One consequence of this is that log messages aren't caught by the library "
29911 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
29912 "stdout."
29913 msgstr ""
29914
29915 #. type: =head2
29916 #: ../src/guestfs-actions.pod:6247
29917 msgid "guestfs_set_e2label"
29918 msgstr ""
29919
29920 #. type: verbatim
29921 #: ../src/guestfs-actions.pod:6249
29922 #, no-wrap
29923 msgid ""
29924 " int\n"
29925 " guestfs_set_e2label (guestfs_h *g,\n"
29926 "                      const char *device,\n"
29927 "                      const char *label);\n"
29928 "\n"
29929 msgstr ""
29930
29931 #. type: textblock
29932 #: ../src/guestfs-actions.pod:6258
29933 msgid ""
29934 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
29935 "the existing label on a filesystem."
29936 msgstr ""
29937
29938 #. type: =head2
29939 #: ../src/guestfs-actions.pod:6265
29940 msgid "guestfs_set_e2uuid"
29941 msgstr ""
29942
29943 #. type: verbatim
29944 #: ../src/guestfs-actions.pod:6267
29945 #, no-wrap
29946 msgid ""
29947 " int\n"
29948 " guestfs_set_e2uuid (guestfs_h *g,\n"
29949 "                     const char *device,\n"
29950 "                     const char *uuid);\n"
29951 "\n"
29952 msgstr ""
29953
29954 #. type: textblock
29955 #: ../src/guestfs-actions.pod:6277
29956 msgid ""
29957 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
29958 "the existing UUID of a filesystem."
29959 msgstr ""
29960
29961 #. type: =head2
29962 #: ../src/guestfs-actions.pod:6284
29963 msgid "guestfs_set_memsize"
29964 msgstr ""
29965
29966 #. type: verbatim
29967 #: ../src/guestfs-actions.pod:6286
29968 #, no-wrap
29969 msgid ""
29970 " int\n"
29971 " guestfs_set_memsize (guestfs_h *g,\n"
29972 "                      int memsize);\n"
29973 "\n"
29974 msgstr ""
29975
29976 #. type: textblock
29977 #: ../src/guestfs-actions.pod:6290
29978 msgid ""
29979 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
29980 "This only has any effect if called before C<guestfs_launch>."
29981 msgstr ""
29982
29983 #. type: =head2
29984 #: ../src/guestfs-actions.pod:6305
29985 msgid "guestfs_set_network"
29986 msgstr ""
29987
29988 #. type: verbatim
29989 #: ../src/guestfs-actions.pod:6307
29990 #, no-wrap
29991 msgid ""
29992 " int\n"
29993 " guestfs_set_network (guestfs_h *g,\n"
29994 "                      int network);\n"
29995 "\n"
29996 msgstr ""
29997
29998 #. type: textblock
29999 #: ../src/guestfs-actions.pod:6317
30000 msgid ""
30001 "You must call this before calling C<guestfs_launch>, otherwise it has no "
30002 "effect."
30003 msgstr ""
30004
30005 #. type: =head2
30006 #: ../src/guestfs-actions.pod:6324
30007 msgid "guestfs_set_path"
30008 msgstr ""
30009
30010 #. type: verbatim
30011 #: ../src/guestfs-actions.pod:6326
30012 #, no-wrap
30013 msgid ""
30014 " int\n"
30015 " guestfs_set_path (guestfs_h *g,\n"
30016 "                   const char *searchpath);\n"
30017 "\n"
30018 msgstr ""
30019
30020 #. type: =head2
30021 #: ../src/guestfs-actions.pod:6341
30022 msgid "guestfs_set_pgroup"
30023 msgstr ""
30024
30025 #. type: verbatim
30026 #: ../src/guestfs-actions.pod:6343
30027 #, no-wrap
30028 msgid ""
30029 " int\n"
30030 " guestfs_set_pgroup (guestfs_h *g,\n"
30031 "                     int pgroup);\n"
30032 "\n"
30033 msgstr ""
30034
30035 #. type: =head2
30036 #: ../src/guestfs-actions.pod:6360
30037 msgid "guestfs_set_qemu"
30038 msgstr ""
30039
30040 #. type: verbatim
30041 #: ../src/guestfs-actions.pod:6362
30042 #, no-wrap
30043 msgid ""
30044 " int\n"
30045 " guestfs_set_qemu (guestfs_h *g,\n"
30046 "                   const char *qemu);\n"
30047 "\n"
30048 msgstr ""
30049
30050 #. type: =head2
30051 #: ../src/guestfs-actions.pod:6388
30052 msgid "guestfs_set_recovery_proc"
30053 msgstr ""
30054
30055 #. type: verbatim
30056 #: ../src/guestfs-actions.pod:6390
30057 #, no-wrap
30058 msgid ""
30059 " int\n"
30060 " guestfs_set_recovery_proc (guestfs_h *g,\n"
30061 "                            int recoveryproc);\n"
30062 "\n"
30063 msgstr ""
30064
30065 #. type: textblock
30066 #: ../src/guestfs-actions.pod:6394
30067 msgid ""
30068 "If this is called with the parameter C<false> then C<guestfs_launch> does "
30069 "not create a recovery process.  The purpose of the recovery process is to "
30070 "stop runaway qemu processes in the case where the main program aborts "
30071 "abruptly."
30072 msgstr ""
30073
30074 #. type: textblock
30075 #: ../src/guestfs-actions.pod:6399
30076 msgid ""
30077 "This only has any effect if called before C<guestfs_launch>, and the default "
30078 "is true."
30079 msgstr ""
30080
30081 #. type: =head2
30082 #: ../src/guestfs-actions.pod:6412
30083 msgid "guestfs_set_selinux"
30084 msgstr ""
30085
30086 #. type: verbatim
30087 #: ../src/guestfs-actions.pod:6414
30088 #, no-wrap
30089 msgid ""
30090 " int\n"
30091 " guestfs_set_selinux (guestfs_h *g,\n"
30092 "                      int selinux);\n"
30093 "\n"
30094 msgstr ""
30095
30096 #. type: =head2
30097 #: ../src/guestfs-actions.pod:6431
30098 msgid "guestfs_set_trace"
30099 msgstr ""
30100
30101 #. type: verbatim
30102 #: ../src/guestfs-actions.pod:6433
30103 #, no-wrap
30104 msgid ""
30105 " int\n"
30106 " guestfs_set_trace (guestfs_h *g,\n"
30107 "                    int trace);\n"
30108 "\n"
30109 msgstr ""
30110
30111 #. type: textblock
30112 #: ../src/guestfs-actions.pod:6447
30113 msgid ""
30114 "Trace messages are normally sent to C<stderr>, unless you register a "
30115 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
30116 msgstr ""
30117
30118 #. type: =head2
30119 #: ../src/guestfs-actions.pod:6455
30120 msgid "guestfs_set_verbose"
30121 msgstr ""
30122
30123 #. type: verbatim
30124 #: ../src/guestfs-actions.pod:6457
30125 #, no-wrap
30126 msgid ""
30127 " int\n"
30128 " guestfs_set_verbose (guestfs_h *g,\n"
30129 "                      int verbose);\n"
30130 "\n"
30131 msgstr ""
30132
30133 #. type: textblock
30134 #: ../src/guestfs-actions.pod:6466
30135 msgid ""
30136 "Verbose messages are normally sent to C<stderr>, unless you register a "
30137 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
30138 msgstr ""
30139
30140 #. type: =head2
30141 #: ../src/guestfs-actions.pod:6474
30142 msgid "guestfs_setcon"
30143 msgstr ""
30144
30145 #. type: verbatim
30146 #: ../src/guestfs-actions.pod:6476
30147 #, no-wrap
30148 msgid ""
30149 " int\n"
30150 " guestfs_setcon (guestfs_h *g,\n"
30151 "                 const char *context);\n"
30152 "\n"
30153 msgstr ""
30154
30155 #. type: =head2
30156 #: ../src/guestfs-actions.pod:6489
30157 msgid "guestfs_setxattr"
30158 msgstr ""
30159
30160 #. type: verbatim
30161 #: ../src/guestfs-actions.pod:6491
30162 #, no-wrap
30163 msgid ""
30164 " int\n"
30165 " guestfs_setxattr (guestfs_h *g,\n"
30166 "                   const char *xattr,\n"
30167 "                   const char *val,\n"
30168 "                   int vallen,\n"
30169 "                   const char *path);\n"
30170 "\n"
30171 msgstr ""
30172
30173 #. type: textblock
30174 #: ../src/guestfs-actions.pod:6502
30175 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
30176 msgstr ""
30177
30178 #. type: =head2
30179 #: ../src/guestfs-actions.pod:6508
30180 msgid "guestfs_sfdisk"
30181 msgstr ""
30182
30183 #. type: verbatim
30184 #: ../src/guestfs-actions.pod:6510
30185 #, no-wrap
30186 msgid ""
30187 " int\n"
30188 " guestfs_sfdisk (guestfs_h *g,\n"
30189 "                 const char *device,\n"
30190 "                 int cyls,\n"
30191 "                 int heads,\n"
30192 "                 int sectors,\n"
30193 "                 char *const *lines);\n"
30194 "\n"
30195 msgstr ""
30196
30197 #. type: textblock
30198 #: ../src/guestfs-actions.pod:6538
30199 msgid ""
30200 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
30201 msgstr ""
30202
30203 #. type: textblock
30204 #: ../src/guestfs-actions.pod:6546 ../src/guestfs-actions.pod:6576
30205 #: ../src/guestfs-actions.pod:6609
30206 msgid ""
30207 "This function is deprecated.  In new code, use the L</guestfs_part_add> call "
30208 "instead."
30209 msgstr ""
30210
30211 #. type: =head2
30212 #: ../src/guestfs-actions.pod:6555
30213 msgid "guestfs_sfdiskM"
30214 msgstr ""
30215
30216 #. type: verbatim
30217 #: ../src/guestfs-actions.pod:6557
30218 #, no-wrap
30219 msgid ""
30220 " int\n"
30221 " guestfs_sfdiskM (guestfs_h *g,\n"
30222 "                  const char *device,\n"
30223 "                  char *const *lines);\n"
30224 "\n"
30225 msgstr ""
30226
30227 #. type: textblock
30228 #: ../src/guestfs-actions.pod:6562
30229 msgid ""
30230 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
30231 "partition sizes are specified in megabytes only (rounded to the nearest "
30232 "cylinder) and you don't need to specify the cyls, heads and sectors "
30233 "parameters which were rarely if ever used anyway."
30234 msgstr ""
30235
30236 #. type: textblock
30237 #: ../src/guestfs-actions.pod:6568
30238 msgid ""
30239 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
30240 "C<guestfs_part_disk>"
30241 msgstr ""
30242
30243 #. type: =head2
30244 #: ../src/guestfs-actions.pod:6585
30245 msgid "guestfs_sfdisk_N"
30246 msgstr ""
30247
30248 #. type: verbatim
30249 #: ../src/guestfs-actions.pod:6587
30250 #, no-wrap
30251 msgid ""
30252 " int\n"
30253 " guestfs_sfdisk_N (guestfs_h *g,\n"
30254 "                   const char *device,\n"
30255 "                   int partnum,\n"
30256 "                   int cyls,\n"
30257 "                   int heads,\n"
30258 "                   int sectors,\n"
30259 "                   const char *line);\n"
30260 "\n"
30261 msgstr ""
30262
30263 #. type: textblock
30264 #: ../src/guestfs-actions.pod:6599
30265 msgid ""
30266 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
30267 "for the cyls/heads/sectors parameters."
30268 msgstr ""
30269
30270 #. type: textblock
30271 #: ../src/guestfs-actions.pod:6602
30272 msgid "See also: C<guestfs_part_add>"
30273 msgstr ""
30274
30275 #. type: =head2
30276 #: ../src/guestfs-actions.pod:6618
30277 msgid "guestfs_sfdisk_disk_geometry"
30278 msgstr ""
30279
30280 #. type: verbatim
30281 #: ../src/guestfs-actions.pod:6620
30282 #, no-wrap
30283 msgid ""
30284 " char *\n"
30285 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
30286 "                               const char *device);\n"
30287 "\n"
30288 msgstr ""
30289
30290 #. type: textblock
30291 #: ../src/guestfs-actions.pod:6624
30292 msgid ""
30293 "This displays the disk geometry of C<device> read from the partition table.  "
30294 "Especially in the case where the underlying block device has been resized, "
30295 "this can be different from the kernel's idea of the geometry (see "
30296 "C<guestfs_sfdisk_kernel_geometry>)."
30297 msgstr ""
30298
30299 #. type: =head2
30300 #: ../src/guestfs-actions.pod:6637
30301 msgid "guestfs_sfdisk_kernel_geometry"
30302 msgstr ""
30303
30304 #. type: verbatim
30305 #: ../src/guestfs-actions.pod:6639
30306 #, no-wrap
30307 msgid ""
30308 " char *\n"
30309 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
30310 "                                 const char *device);\n"
30311 "\n"
30312 msgstr ""
30313
30314 #. type: =head2
30315 #: ../src/guestfs-actions.pod:6653
30316 msgid "guestfs_sfdisk_l"
30317 msgstr ""
30318
30319 #. type: verbatim
30320 #: ../src/guestfs-actions.pod:6655
30321 #, no-wrap
30322 msgid ""
30323 " char *\n"
30324 " guestfs_sfdisk_l (guestfs_h *g,\n"
30325 "                   const char *device);\n"
30326 "\n"
30327 msgstr ""
30328
30329 #. type: textblock
30330 #: ../src/guestfs-actions.pod:6663
30331 msgid "See also: C<guestfs_part_list>"
30332 msgstr ""
30333
30334 #. type: textblock
30335 #: ../src/guestfs-actions.pod:6668
30336 msgid ""
30337 "This function is deprecated.  In new code, use the L</guestfs_part_list> "
30338 "call instead."
30339 msgstr ""
30340
30341 #. type: =head2
30342 #: ../src/guestfs-actions.pod:6677
30343 msgid "guestfs_sh"
30344 msgstr ""
30345
30346 #. type: verbatim
30347 #: ../src/guestfs-actions.pod:6679
30348 #, no-wrap
30349 msgid ""
30350 " char *\n"
30351 " guestfs_sh (guestfs_h *g,\n"
30352 "             const char *command);\n"
30353 "\n"
30354 msgstr ""
30355
30356 #. type: textblock
30357 #: ../src/guestfs-actions.pod:6686
30358 msgid "This is like C<guestfs_command>, but passes the command to:"
30359 msgstr ""
30360
30361 #. type: textblock
30362 #: ../src/guestfs-actions.pod:6694
30363 msgid "All the provisos about C<guestfs_command> apply to this call."
30364 msgstr ""
30365
30366 #. type: =head2
30367 #: ../src/guestfs-actions.pod:6701
30368 msgid "guestfs_sh_lines"
30369 msgstr ""
30370
30371 #. type: verbatim
30372 #: ../src/guestfs-actions.pod:6703
30373 #, no-wrap
30374 msgid ""
30375 " char **\n"
30376 " guestfs_sh_lines (guestfs_h *g,\n"
30377 "                   const char *command);\n"
30378 "\n"
30379 msgstr ""
30380
30381 #. type: textblock
30382 #: ../src/guestfs-actions.pod:6707
30383 msgid ""
30384 "This is the same as C<guestfs_sh>, but splits the result into a list of "
30385 "lines."
30386 msgstr ""
30387
30388 #. type: textblock
30389 #: ../src/guestfs-actions.pod:6710
30390 msgid "See also: C<guestfs_command_lines>"
30391 msgstr ""
30392
30393 #. type: =head2
30394 #: ../src/guestfs-actions.pod:6718
30395 msgid "guestfs_sleep"
30396 msgstr ""
30397
30398 #. type: verbatim
30399 #: ../src/guestfs-actions.pod:6720
30400 #, no-wrap
30401 msgid ""
30402 " int\n"
30403 " guestfs_sleep (guestfs_h *g,\n"
30404 "                int secs);\n"
30405 "\n"
30406 msgstr ""
30407
30408 #. type: textblock
30409 #: ../src/guestfs-actions.pod:6728
30410 msgid "(Added in 1.0.41)"
30411 msgstr ""
30412
30413 #. type: =head2
30414 #: ../src/guestfs-actions.pod:6730 ../src/guestfs-structs.pod:109
30415 msgid "guestfs_stat"
30416 msgstr ""
30417
30418 #. type: verbatim
30419 #: ../src/guestfs-actions.pod:6732
30420 #, no-wrap
30421 msgid ""
30422 " struct guestfs_stat *\n"
30423 " guestfs_stat (guestfs_h *g,\n"
30424 "               const char *path);\n"
30425 "\n"
30426 msgstr ""
30427
30428 #. type: =head2
30429 #: ../src/guestfs-actions.pod:6746 ../src/guestfs-structs.pod:135
30430 msgid "guestfs_statvfs"
30431 msgstr ""
30432
30433 #. type: verbatim
30434 #: ../src/guestfs-actions.pod:6748
30435 #, no-wrap
30436 msgid ""
30437 " struct guestfs_statvfs *\n"
30438 " guestfs_statvfs (guestfs_h *g,\n"
30439 "                  const char *path);\n"
30440 "\n"
30441 msgstr ""
30442
30443 #. type: textblock
30444 #: ../src/guestfs-actions.pod:6758
30445 msgid ""
30446 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
30447 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
30448 msgstr ""
30449
30450 #. type: =head2
30451 #: ../src/guestfs-actions.pod:6764
30452 msgid "guestfs_strings"
30453 msgstr ""
30454
30455 #. type: verbatim
30456 #: ../src/guestfs-actions.pod:6766
30457 #, no-wrap
30458 msgid ""
30459 " char **\n"
30460 " guestfs_strings (guestfs_h *g,\n"
30461 "                  const char *path);\n"
30462 "\n"
30463 msgstr ""
30464
30465 #. type: =head2
30466 #: ../src/guestfs-actions.pod:6782
30467 msgid "guestfs_strings_e"
30468 msgstr ""
30469
30470 #. type: verbatim
30471 #: ../src/guestfs-actions.pod:6784
30472 #, no-wrap
30473 msgid ""
30474 " char **\n"
30475 " guestfs_strings_e (guestfs_h *g,\n"
30476 "                    const char *encoding,\n"
30477 "                    const char *path);\n"
30478 "\n"
30479 msgstr ""
30480
30481 #. type: textblock
30482 #: ../src/guestfs-actions.pod:6789
30483 msgid ""
30484 "This is like the C<guestfs_strings> command, but allows you to specify the "
30485 "encoding of strings that are looked for in the source file C<path>."
30486 msgstr ""
30487
30488 #. type: textblock
30489 #: ../src/guestfs-actions.pod:6799
30490 msgid ""
30491 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
30492 "ISO-8859-X (this is what C<guestfs_strings> uses)."
30493 msgstr ""
30494
30495 #. type: =head2
30496 #: ../src/guestfs-actions.pod:6837
30497 msgid "guestfs_swapoff_device"
30498 msgstr ""
30499
30500 #. type: verbatim
30501 #: ../src/guestfs-actions.pod:6839
30502 #, no-wrap
30503 msgid ""
30504 " int\n"
30505 " guestfs_swapoff_device (guestfs_h *g,\n"
30506 "                         const char *device);\n"
30507 "\n"
30508 msgstr ""
30509
30510 #. type: textblock
30511 #: ../src/guestfs-actions.pod:6843
30512 msgid ""
30513 "This command disables the libguestfs appliance swap device or partition "
30514 "named C<device>.  See C<guestfs_swapon_device>."
30515 msgstr ""
30516
30517 #. type: =head2
30518 #: ../src/guestfs-actions.pod:6851
30519 msgid "guestfs_swapoff_file"
30520 msgstr ""
30521
30522 #. type: verbatim
30523 #: ../src/guestfs-actions.pod:6853
30524 #, no-wrap
30525 msgid ""
30526 " int\n"
30527 " guestfs_swapoff_file (guestfs_h *g,\n"
30528 "                       const char *file);\n"
30529 "\n"
30530 msgstr ""
30531
30532 #. type: =head2
30533 #: ../src/guestfs-actions.pod:6863
30534 msgid "guestfs_swapoff_label"
30535 msgstr ""
30536
30537 #. type: verbatim
30538 #: ../src/guestfs-actions.pod:6865
30539 #, no-wrap
30540 msgid ""
30541 " int\n"
30542 " guestfs_swapoff_label (guestfs_h *g,\n"
30543 "                        const char *label);\n"
30544 "\n"
30545 msgstr ""
30546
30547 #. type: =head2
30548 #: ../src/guestfs-actions.pod:6876
30549 msgid "guestfs_swapoff_uuid"
30550 msgstr ""
30551
30552 #. type: verbatim
30553 #: ../src/guestfs-actions.pod:6878
30554 #, no-wrap
30555 msgid ""
30556 " int\n"
30557 " guestfs_swapoff_uuid (guestfs_h *g,\n"
30558 "                       const char *uuid);\n"
30559 "\n"
30560 msgstr ""
30561
30562 #. type: =head2
30563 #: ../src/guestfs-actions.pod:6889
30564 msgid "guestfs_swapon_device"
30565 msgstr ""
30566
30567 #. type: verbatim
30568 #: ../src/guestfs-actions.pod:6891
30569 #, no-wrap
30570 msgid ""
30571 " int\n"
30572 " guestfs_swapon_device (guestfs_h *g,\n"
30573 "                        const char *device);\n"
30574 "\n"
30575 msgstr ""
30576
30577 #. type: textblock
30578 #: ../src/guestfs-actions.pod:6895
30579 msgid ""
30580 "This command enables the libguestfs appliance to use the swap device or "
30581 "partition named C<device>.  The increased memory is made available for all "
30582 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
30583 msgstr ""
30584
30585 #. type: =head2
30586 #: ../src/guestfs-actions.pod:6911
30587 msgid "guestfs_swapon_file"
30588 msgstr ""
30589
30590 #. type: verbatim
30591 #: ../src/guestfs-actions.pod:6913
30592 #, no-wrap
30593 msgid ""
30594 " int\n"
30595 " guestfs_swapon_file (guestfs_h *g,\n"
30596 "                      const char *file);\n"
30597 "\n"
30598 msgstr ""
30599
30600 #. type: textblock
30601 #: ../src/guestfs-actions.pod:6917
30602 msgid ""
30603 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
30604 "notes."
30605 msgstr ""
30606
30607 #. type: =head2
30608 #: ../src/guestfs-actions.pod:6924
30609 msgid "guestfs_swapon_label"
30610 msgstr ""
30611
30612 #. type: verbatim
30613 #: ../src/guestfs-actions.pod:6926
30614 #, no-wrap
30615 msgid ""
30616 " int\n"
30617 " guestfs_swapon_label (guestfs_h *g,\n"
30618 "                       const char *label);\n"
30619 "\n"
30620 msgstr ""
30621
30622 #. type: textblock
30623 #: ../src/guestfs-actions.pod:6930
30624 msgid ""
30625 "This command enables swap to a labeled swap partition.  See "
30626 "C<guestfs_swapon_device> for other notes."
30627 msgstr ""
30628
30629 #. type: =head2
30630 #: ../src/guestfs-actions.pod:6937
30631 msgid "guestfs_swapon_uuid"
30632 msgstr ""
30633
30634 #. type: verbatim
30635 #: ../src/guestfs-actions.pod:6939
30636 #, no-wrap
30637 msgid ""
30638 " int\n"
30639 " guestfs_swapon_uuid (guestfs_h *g,\n"
30640 "                      const char *uuid);\n"
30641 "\n"
30642 msgstr ""
30643
30644 #. type: textblock
30645 #: ../src/guestfs-actions.pod:6943
30646 msgid ""
30647 "This command enables swap to a swap partition with the given UUID.  See "
30648 "C<guestfs_swapon_device> for other notes."
30649 msgstr ""
30650
30651 #. type: =head2
30652 #: ../src/guestfs-actions.pod:6950
30653 msgid "guestfs_sync"
30654 msgstr ""
30655
30656 #. type: verbatim
30657 #: ../src/guestfs-actions.pod:6952
30658 #, no-wrap
30659 msgid ""
30660 " int\n"
30661 " guestfs_sync (guestfs_h *g);\n"
30662 "\n"
30663 msgstr ""
30664
30665 #. type: =head2
30666 #: ../src/guestfs-actions.pod:6965
30667 msgid "guestfs_tail"
30668 msgstr ""
30669
30670 #. type: verbatim
30671 #: ../src/guestfs-actions.pod:6967
30672 #, no-wrap
30673 msgid ""
30674 " char **\n"
30675 " guestfs_tail (guestfs_h *g,\n"
30676 "               const char *path);\n"
30677 "\n"
30678 msgstr ""
30679
30680 #. type: =head2
30681 #: ../src/guestfs-actions.pod:6983
30682 msgid "guestfs_tail_n"
30683 msgstr ""
30684
30685 #. type: verbatim
30686 #: ../src/guestfs-actions.pod:6985
30687 #, no-wrap
30688 msgid ""
30689 " char **\n"
30690 " guestfs_tail_n (guestfs_h *g,\n"
30691 "                 int nrlines,\n"
30692 "                 const char *path);\n"
30693 "\n"
30694 msgstr ""
30695
30696 #. type: =head2
30697 #: ../src/guestfs-actions.pod:7007
30698 msgid "guestfs_tar_in"
30699 msgstr ""
30700
30701 #. type: verbatim
30702 #: ../src/guestfs-actions.pod:7009
30703 #, no-wrap
30704 msgid ""
30705 " int\n"
30706 " guestfs_tar_in (guestfs_h *g,\n"
30707 "                 const char *tarfile,\n"
30708 "                 const char *directory);\n"
30709 "\n"
30710 msgstr ""
30711
30712 #. type: textblock
30713 #: ../src/guestfs-actions.pod:7017
30714 msgid ""
30715 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
30716 msgstr ""
30717
30718 #. type: textblock
30719 #: ../src/guestfs-actions.pod:7022 ../src/guestfs-actions.pod:7039
30720 #: ../src/guestfs-actions.pod:7055 ../src/guestfs-actions.pod:7071
30721 msgid "(Added in 1.0.3)"
30722 msgstr ""
30723
30724 #. type: =head2
30725 #: ../src/guestfs-actions.pod:7024
30726 msgid "guestfs_tar_out"
30727 msgstr ""
30728
30729 #. type: verbatim
30730 #: ../src/guestfs-actions.pod:7026
30731 #, no-wrap
30732 msgid ""
30733 " int\n"
30734 " guestfs_tar_out (guestfs_h *g,\n"
30735 "                  const char *directory,\n"
30736 "                  const char *tarfile);\n"
30737 "\n"
30738 msgstr ""
30739
30740 #. type: textblock
30741 #: ../src/guestfs-actions.pod:7034
30742 msgid ""
30743 "To download a compressed tarball, use C<guestfs_tgz_out> or "
30744 "C<guestfs_txz_out>."
30745 msgstr ""
30746
30747 #. type: =head2
30748 #: ../src/guestfs-actions.pod:7041
30749 msgid "guestfs_tgz_in"
30750 msgstr ""
30751
30752 #. type: verbatim
30753 #: ../src/guestfs-actions.pod:7043
30754 #, no-wrap
30755 msgid ""
30756 " int\n"
30757 " guestfs_tgz_in (guestfs_h *g,\n"
30758 "                 const char *tarball,\n"
30759 "                 const char *directory);\n"
30760 "\n"
30761 msgstr ""
30762
30763 #. type: textblock
30764 #: ../src/guestfs-actions.pod:7051
30765 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
30766 msgstr ""
30767
30768 #. type: =head2
30769 #: ../src/guestfs-actions.pod:7057
30770 msgid "guestfs_tgz_out"
30771 msgstr ""
30772
30773 #. type: verbatim
30774 #: ../src/guestfs-actions.pod:7059
30775 #, no-wrap
30776 msgid ""
30777 " int\n"
30778 " guestfs_tgz_out (guestfs_h *g,\n"
30779 "                  const char *directory,\n"
30780 "                  const char *tarball);\n"
30781 "\n"
30782 msgstr ""
30783
30784 #. type: textblock
30785 #: ../src/guestfs-actions.pod:7067
30786 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
30787 msgstr ""
30788
30789 #. type: =head2
30790 #: ../src/guestfs-actions.pod:7073
30791 msgid "guestfs_touch"
30792 msgstr ""
30793
30794 #. type: verbatim
30795 #: ../src/guestfs-actions.pod:7075
30796 #, no-wrap
30797 msgid ""
30798 " int\n"
30799 " guestfs_touch (guestfs_h *g,\n"
30800 "                const char *path);\n"
30801 "\n"
30802 msgstr ""
30803
30804 #. type: =head2
30805 #: ../src/guestfs-actions.pod:7090
30806 msgid "guestfs_truncate"
30807 msgstr ""
30808
30809 #. type: verbatim
30810 #: ../src/guestfs-actions.pod:7092
30811 #, no-wrap
30812 msgid ""
30813 " int\n"
30814 " guestfs_truncate (guestfs_h *g,\n"
30815 "                   const char *path);\n"
30816 "\n"
30817 msgstr ""
30818
30819 #. type: =head2
30820 #: ../src/guestfs-actions.pod:7103
30821 msgid "guestfs_truncate_size"
30822 msgstr ""
30823
30824 #. type: verbatim
30825 #: ../src/guestfs-actions.pod:7105
30826 #, no-wrap
30827 msgid ""
30828 " int\n"
30829 " guestfs_truncate_size (guestfs_h *g,\n"
30830 "                        const char *path,\n"
30831 "                        int64_t size);\n"
30832 "\n"
30833 msgstr ""
30834
30835 #. type: textblock
30836 #: ../src/guestfs-actions.pod:7113
30837 msgid ""
30838 "If the current file size is less than C<size> then the file is extended to "
30839 "the required size with zero bytes.  This creates a sparse file (ie. disk "
30840 "blocks are not allocated for the file until you write to it).  To create a "
30841 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
30842 msgstr ""
30843
30844 #. type: =head2
30845 #: ../src/guestfs-actions.pod:7123
30846 msgid "guestfs_tune2fs_l"
30847 msgstr ""
30848
30849 #. type: verbatim
30850 #: ../src/guestfs-actions.pod:7125
30851 #, no-wrap
30852 msgid ""
30853 " char **\n"
30854 " guestfs_tune2fs_l (guestfs_h *g,\n"
30855 "                    const char *device);\n"
30856 "\n"
30857 msgstr ""
30858
30859 #. type: =head2
30860 #: ../src/guestfs-actions.pod:7145
30861 msgid "guestfs_txz_in"
30862 msgstr ""
30863
30864 #. type: verbatim
30865 #: ../src/guestfs-actions.pod:7147
30866 #, no-wrap
30867 msgid ""
30868 " int\n"
30869 " guestfs_txz_in (guestfs_h *g,\n"
30870 "                 const char *tarball,\n"
30871 "                 const char *directory);\n"
30872 "\n"
30873 msgstr ""
30874
30875 #. type: =head2
30876 #: ../src/guestfs-actions.pod:7159
30877 msgid "guestfs_txz_out"
30878 msgstr ""
30879
30880 #. type: verbatim
30881 #: ../src/guestfs-actions.pod:7161
30882 #, no-wrap
30883 msgid ""
30884 " int\n"
30885 " guestfs_txz_out (guestfs_h *g,\n"
30886 "                  const char *directory,\n"
30887 "                  const char *tarball);\n"
30888 "\n"
30889 msgstr ""
30890
30891 #. type: =head2
30892 #: ../src/guestfs-actions.pod:7173
30893 msgid "guestfs_umask"
30894 msgstr ""
30895
30896 #. type: verbatim
30897 #: ../src/guestfs-actions.pod:7175
30898 #, no-wrap
30899 msgid ""
30900 " int\n"
30901 " guestfs_umask (guestfs_h *g,\n"
30902 "                int mask);\n"
30903 "\n"
30904 msgstr ""
30905
30906 #. type: textblock
30907 #: ../src/guestfs-actions.pod:7191
30908 msgid ""
30909 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
30910 "C<guestfs_mkdir>."
30911 msgstr ""
30912
30913 #. type: =head2
30914 #: ../src/guestfs-actions.pod:7200
30915 msgid "guestfs_umount"
30916 msgstr ""
30917
30918 #. type: verbatim
30919 #: ../src/guestfs-actions.pod:7202
30920 #, no-wrap
30921 msgid ""
30922 " int\n"
30923 " guestfs_umount (guestfs_h *g,\n"
30924 "                 const char *pathordevice);\n"
30925 "\n"
30926 msgstr ""
30927
30928 #. type: =head2
30929 #: ../src/guestfs-actions.pod:7214
30930 msgid "guestfs_umount_all"
30931 msgstr ""
30932
30933 #. type: verbatim
30934 #: ../src/guestfs-actions.pod:7216
30935 #, no-wrap
30936 msgid ""
30937 " int\n"
30938 " guestfs_umount_all (guestfs_h *g);\n"
30939 "\n"
30940 msgstr ""
30941
30942 #. type: =head2
30943 #: ../src/guestfs-actions.pod:7227
30944 msgid "guestfs_upload"
30945 msgstr ""
30946
30947 #. type: verbatim
30948 #: ../src/guestfs-actions.pod:7229
30949 #, no-wrap
30950 msgid ""
30951 " int\n"
30952 " guestfs_upload (guestfs_h *g,\n"
30953 "                 const char *filename,\n"
30954 "                 const char *remotefilename);\n"
30955 "\n"
30956 msgstr ""
30957
30958 #. type: textblock
30959 #: ../src/guestfs-actions.pod:7239
30960 msgid "See also C<guestfs_download>."
30961 msgstr ""
30962
30963 #. type: =head2
30964 #: ../src/guestfs-actions.pod:7250
30965 msgid "guestfs_upload_offset"
30966 msgstr ""
30967
30968 #. type: verbatim
30969 #: ../src/guestfs-actions.pod:7252
30970 #, no-wrap
30971 msgid ""
30972 " int\n"
30973 " guestfs_upload_offset (guestfs_h *g,\n"
30974 "                        const char *filename,\n"
30975 "                        const char *remotefilename,\n"
30976 "                        int64_t offset);\n"
30977 "\n"
30978 msgstr ""
30979
30980 #. type: textblock
30981 #: ../src/guestfs-actions.pod:7268
30982 msgid ""
30983 "Note that there is no limit on the amount of data that can be uploaded with "
30984 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
30985 "full amount unless an error occurs."
30986 msgstr ""
30987
30988 #. type: textblock
30989 #: ../src/guestfs-actions.pod:7273
30990 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
30991 msgstr ""
30992
30993 #. type: =head2
30994 #: ../src/guestfs-actions.pod:7284
30995 msgid "guestfs_utimens"
30996 msgstr ""
30997
30998 #. type: verbatim
30999 #: ../src/guestfs-actions.pod:7286
31000 #, no-wrap
31001 msgid ""
31002 " int\n"
31003 " guestfs_utimens (guestfs_h *g,\n"
31004 "                  const char *path,\n"
31005 "                  int64_t atsecs,\n"
31006 "                  int64_t atnsecs,\n"
31007 "                  int64_t mtsecs,\n"
31008 "                  int64_t mtnsecs);\n"
31009 "\n"
31010 msgstr ""
31011
31012 #. type: =head2
31013 #: ../src/guestfs-actions.pod:7315 ../src/guestfs-structs.pod:175
31014 msgid "guestfs_version"
31015 msgstr ""
31016
31017 #. type: verbatim
31018 #: ../src/guestfs-actions.pod:7317
31019 #, no-wrap
31020 msgid ""
31021 " struct guestfs_version *\n"
31022 " guestfs_version (guestfs_h *g);\n"
31023 "\n"
31024 msgstr ""
31025
31026 #. type: textblock
31027 #: ../src/guestfs-actions.pod:7345
31028 msgid ""
31029 "I<Note:> Don't use this call to test for availability of features.  In "
31030 "enterprise distributions we backport features from later versions into "
31031 "earlier versions, making this an unreliable way to test for features.  Use "
31032 "C<guestfs_available> instead."
31033 msgstr ""
31034
31035 #. type: textblock
31036 #: ../src/guestfs-actions.pod:7351
31037 msgid ""
31038 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
31039 "error.  I<The caller must call C<guestfs_free_version> after use>."
31040 msgstr ""
31041
31042 #. type: textblock
31043 #: ../src/guestfs-actions.pod:7355
31044 msgid "(Added in 1.0.58)"
31045 msgstr ""
31046
31047 #. type: =head2
31048 #: ../src/guestfs-actions.pod:7357
31049 msgid "guestfs_vfs_label"
31050 msgstr ""
31051
31052 #. type: verbatim
31053 #: ../src/guestfs-actions.pod:7359
31054 #, no-wrap
31055 msgid ""
31056 " char *\n"
31057 " guestfs_vfs_label (guestfs_h *g,\n"
31058 "                    const char *device);\n"
31059 "\n"
31060 msgstr ""
31061
31062 #. type: textblock
31063 #: ../src/guestfs-actions.pod:7368
31064 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
31065 msgstr ""
31066
31067 #. type: textblock
31068 #: ../src/guestfs-actions.pod:7373 ../src/guestfs-actions.pod:7410
31069 msgid "(Added in 1.3.18)"
31070 msgstr ""
31071
31072 #. type: =head2
31073 #: ../src/guestfs-actions.pod:7375
31074 msgid "guestfs_vfs_type"
31075 msgstr ""
31076
31077 #. type: verbatim
31078 #: ../src/guestfs-actions.pod:7377
31079 #, no-wrap
31080 msgid ""
31081 " char *\n"
31082 " guestfs_vfs_type (guestfs_h *g,\n"
31083 "                   const char *device);\n"
31084 "\n"
31085 msgstr ""
31086
31087 #. type: =head2
31088 #: ../src/guestfs-actions.pod:7394
31089 msgid "guestfs_vfs_uuid"
31090 msgstr ""
31091
31092 #. type: verbatim
31093 #: ../src/guestfs-actions.pod:7396
31094 #, no-wrap
31095 msgid ""
31096 " char *\n"
31097 " guestfs_vfs_uuid (guestfs_h *g,\n"
31098 "                   const char *device);\n"
31099 "\n"
31100 msgstr ""
31101
31102 #. type: textblock
31103 #: ../src/guestfs-actions.pod:7405
31104 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
31105 msgstr ""
31106
31107 #. type: =head2
31108 #: ../src/guestfs-actions.pod:7412
31109 msgid "guestfs_vg_activate"
31110 msgstr ""
31111
31112 #. type: verbatim
31113 #: ../src/guestfs-actions.pod:7414
31114 #, no-wrap
31115 msgid ""
31116 " int\n"
31117 " guestfs_vg_activate (guestfs_h *g,\n"
31118 "                      int activate,\n"
31119 "                      char *const *volgroups);\n"
31120 "\n"
31121 msgstr ""
31122
31123 #. type: =head2
31124 #: ../src/guestfs-actions.pod:7431
31125 msgid "guestfs_vg_activate_all"
31126 msgstr ""
31127
31128 #. type: verbatim
31129 #: ../src/guestfs-actions.pod:7433
31130 #, no-wrap
31131 msgid ""
31132 " int\n"
31133 " guestfs_vg_activate_all (guestfs_h *g,\n"
31134 "                          int activate);\n"
31135 "\n"
31136 msgstr ""
31137
31138 #. type: =head2
31139 #: ../src/guestfs-actions.pod:7446
31140 msgid "guestfs_vgcreate"
31141 msgstr ""
31142
31143 #. type: verbatim
31144 #: ../src/guestfs-actions.pod:7448
31145 #, no-wrap
31146 msgid ""
31147 " int\n"
31148 " guestfs_vgcreate (guestfs_h *g,\n"
31149 "                   const char *volgroup,\n"
31150 "                   char *const *physvols);\n"
31151 "\n"
31152 msgstr ""
31153
31154 #. type: =head2
31155 #: ../src/guestfs-actions.pod:7460
31156 msgid "guestfs_vglvuuids"
31157 msgstr ""
31158
31159 #. type: verbatim
31160 #: ../src/guestfs-actions.pod:7462
31161 #, no-wrap
31162 msgid ""
31163 " char **\n"
31164 " guestfs_vglvuuids (guestfs_h *g,\n"
31165 "                    const char *vgname);\n"
31166 "\n"
31167 msgstr ""
31168
31169 #. type: textblock
31170 #: ../src/guestfs-actions.pod:7469
31171 msgid ""
31172 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
31173 "associate logical volumes and volume groups."
31174 msgstr ""
31175
31176 #. type: textblock
31177 #: ../src/guestfs-actions.pod:7472
31178 msgid "See also C<guestfs_vgpvuuids>."
31179 msgstr ""
31180
31181 #. type: =head2
31182 #: ../src/guestfs-actions.pod:7480
31183 msgid "guestfs_vgpvuuids"
31184 msgstr ""
31185
31186 #. type: verbatim
31187 #: ../src/guestfs-actions.pod:7482
31188 #, no-wrap
31189 msgid ""
31190 " char **\n"
31191 " guestfs_vgpvuuids (guestfs_h *g,\n"
31192 "                    const char *vgname);\n"
31193 "\n"
31194 msgstr ""
31195
31196 #. type: textblock
31197 #: ../src/guestfs-actions.pod:7489
31198 msgid ""
31199 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
31200 "associate physical volumes and volume groups."
31201 msgstr ""
31202
31203 #. type: textblock
31204 #: ../src/guestfs-actions.pod:7492
31205 msgid "See also C<guestfs_vglvuuids>."
31206 msgstr ""
31207
31208 #. type: =head2
31209 #: ../src/guestfs-actions.pod:7500
31210 msgid "guestfs_vgremove"
31211 msgstr ""
31212
31213 #. type: verbatim
31214 #: ../src/guestfs-actions.pod:7502
31215 #, no-wrap
31216 msgid ""
31217 " int\n"
31218 " guestfs_vgremove (guestfs_h *g,\n"
31219 "                   const char *vgname);\n"
31220 "\n"
31221 msgstr ""
31222
31223 #. type: =head2
31224 #: ../src/guestfs-actions.pod:7515
31225 msgid "guestfs_vgrename"
31226 msgstr ""
31227
31228 #. type: verbatim
31229 #: ../src/guestfs-actions.pod:7517
31230 #, no-wrap
31231 msgid ""
31232 " int\n"
31233 " guestfs_vgrename (guestfs_h *g,\n"
31234 "                   const char *volgroup,\n"
31235 "                   const char *newvolgroup);\n"
31236 "\n"
31237 msgstr ""
31238
31239 #. type: =head2
31240 #: ../src/guestfs-actions.pod:7528
31241 msgid "guestfs_vgs"
31242 msgstr ""
31243
31244 #. type: verbatim
31245 #: ../src/guestfs-actions.pod:7530
31246 #, no-wrap
31247 msgid ""
31248 " char **\n"
31249 " guestfs_vgs (guestfs_h *g);\n"
31250 "\n"
31251 msgstr ""
31252
31253 #. type: textblock
31254 #: ../src/guestfs-actions.pod:7539
31255 msgid "See also C<guestfs_vgs_full>."
31256 msgstr ""
31257
31258 #. type: =head2
31259 #: ../src/guestfs-actions.pod:7547
31260 msgid "guestfs_vgs_full"
31261 msgstr ""
31262
31263 #. type: verbatim
31264 #: ../src/guestfs-actions.pod:7549
31265 #, no-wrap
31266 msgid ""
31267 " struct guestfs_lvm_vg_list *\n"
31268 " guestfs_vgs_full (guestfs_h *g);\n"
31269 "\n"
31270 msgstr ""
31271
31272 #. type: textblock
31273 #: ../src/guestfs-actions.pod:7555
31274 msgid ""
31275 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
31276 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
31277 msgstr ""
31278
31279 #. type: =head2
31280 #: ../src/guestfs-actions.pod:7561
31281 msgid "guestfs_vgscan"
31282 msgstr ""
31283
31284 #. type: verbatim
31285 #: ../src/guestfs-actions.pod:7563
31286 #, no-wrap
31287 msgid ""
31288 " int\n"
31289 " guestfs_vgscan (guestfs_h *g);\n"
31290 "\n"
31291 msgstr ""
31292
31293 #. type: =head2
31294 #: ../src/guestfs-actions.pod:7573
31295 msgid "guestfs_vguuid"
31296 msgstr ""
31297
31298 #. type: verbatim
31299 #: ../src/guestfs-actions.pod:7575
31300 #, no-wrap
31301 msgid ""
31302 " char *\n"
31303 " guestfs_vguuid (guestfs_h *g,\n"
31304 "                 const char *vgname);\n"
31305 "\n"
31306 msgstr ""
31307
31308 #. type: =head2
31309 #: ../src/guestfs-actions.pod:7586
31310 msgid "guestfs_wait_ready"
31311 msgstr ""
31312
31313 #. type: verbatim
31314 #: ../src/guestfs-actions.pod:7588
31315 #, no-wrap
31316 msgid ""
31317 " int\n"
31318 " guestfs_wait_ready (guestfs_h *g);\n"
31319 "\n"
31320 msgstr ""
31321
31322 #. type: textblock
31323 #: ../src/guestfs-actions.pod:7591
31324 msgid "This function is a no op."
31325 msgstr ""
31326
31327 #. type: textblock
31328 #: ../src/guestfs-actions.pod:7593
31329 msgid ""
31330 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
31331 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
31332 "is no longer necessary because C<guestfs_launch> now does the waiting."
31333 msgstr ""
31334
31335 #. type: textblock
31336 #: ../src/guestfs-actions.pod:7598
31337 msgid ""
31338 "If you see any calls to this function in code then you can just remove them, "
31339 "unless you want to retain compatibility with older versions of the API."
31340 msgstr ""
31341
31342 #. type: textblock
31343 #: ../src/guestfs-actions.pod:7604
31344 msgid ""
31345 "This function is deprecated.  In new code, use the L</guestfs_launch> call "
31346 "instead."
31347 msgstr ""
31348
31349 #. type: =head2
31350 #: ../src/guestfs-actions.pod:7613
31351 msgid "guestfs_wc_c"
31352 msgstr ""
31353
31354 #. type: verbatim
31355 #: ../src/guestfs-actions.pod:7615
31356 #, no-wrap
31357 msgid ""
31358 " int\n"
31359 " guestfs_wc_c (guestfs_h *g,\n"
31360 "               const char *path);\n"
31361 "\n"
31362 msgstr ""
31363
31364 #. type: =head2
31365 #: ../src/guestfs-actions.pod:7626
31366 msgid "guestfs_wc_l"
31367 msgstr ""
31368
31369 #. type: verbatim
31370 #: ../src/guestfs-actions.pod:7628
31371 #, no-wrap
31372 msgid ""
31373 " int\n"
31374 " guestfs_wc_l (guestfs_h *g,\n"
31375 "               const char *path);\n"
31376 "\n"
31377 msgstr ""
31378
31379 #. type: =head2
31380 #: ../src/guestfs-actions.pod:7639
31381 msgid "guestfs_wc_w"
31382 msgstr ""
31383
31384 #. type: verbatim
31385 #: ../src/guestfs-actions.pod:7641
31386 #, no-wrap
31387 msgid ""
31388 " int\n"
31389 " guestfs_wc_w (guestfs_h *g,\n"
31390 "               const char *path);\n"
31391 "\n"
31392 msgstr ""
31393
31394 #. type: =head2
31395 #: ../src/guestfs-actions.pod:7652
31396 msgid "guestfs_write"
31397 msgstr ""
31398
31399 #. type: verbatim
31400 #: ../src/guestfs-actions.pod:7654
31401 #, no-wrap
31402 msgid ""
31403 " int\n"
31404 " guestfs_write (guestfs_h *g,\n"
31405 "                const char *path,\n"
31406 "                const char *content,\n"
31407 "                size_t content_size);\n"
31408 "\n"
31409 msgstr ""
31410
31411 #. type: textblock
31412 #: ../src/guestfs-actions.pod:7663
31413 msgid "See also C<guestfs_write_append>."
31414 msgstr ""
31415
31416 #. type: =head2
31417 #: ../src/guestfs-actions.pod:7672
31418 msgid "guestfs_write_append"
31419 msgstr ""
31420
31421 #. type: verbatim
31422 #: ../src/guestfs-actions.pod:7674
31423 #, no-wrap
31424 msgid ""
31425 " int\n"
31426 " guestfs_write_append (guestfs_h *g,\n"
31427 "                       const char *path,\n"
31428 "                       const char *content,\n"
31429 "                       size_t content_size);\n"
31430 "\n"
31431 msgstr ""
31432
31433 #. type: textblock
31434 #: ../src/guestfs-actions.pod:7683
31435 msgid "See also C<guestfs_write>."
31436 msgstr ""
31437
31438 #. type: =head2
31439 #: ../src/guestfs-actions.pod:7692
31440 msgid "guestfs_write_file"
31441 msgstr "guestfs_write_file"
31442
31443 #. type: verbatim
31444 #: ../src/guestfs-actions.pod:7694
31445 #, no-wrap
31446 msgid ""
31447 " int\n"
31448 " guestfs_write_file (guestfs_h *g,\n"
31449 "                     const char *path,\n"
31450 "                     const char *content,\n"
31451 "                     int size);\n"
31452 "\n"
31453 msgstr ""
31454 " int\n"
31455 " guestfs_write_file (guestfs_h *g,\n"
31456 "                     const char *path,\n"
31457 "                     const char *content,\n"
31458 "                     int size);\n"
31459 "\n"
31460
31461 #. type: textblock
31462 #: ../src/guestfs-actions.pod:7716
31463 msgid ""
31464 "This function is deprecated.  In new code, use the L</guestfs_write> call "
31465 "instead."
31466 msgstr ""
31467
31468 #. type: =head2
31469 #: ../src/guestfs-actions.pod:7725
31470 msgid "guestfs_zegrep"
31471 msgstr "guestfs_zegrep"
31472
31473 #. type: verbatim
31474 #: ../src/guestfs-actions.pod:7727
31475 #, no-wrap
31476 msgid ""
31477 " char **\n"
31478 " guestfs_zegrep (guestfs_h *g,\n"
31479 "                 const char *regex,\n"
31480 "                 const char *path);\n"
31481 "\n"
31482 msgstr ""
31483 " char **\n"
31484 " guestfs_zegrep (guestfs_h *g,\n"
31485 "                 const char *regex,\n"
31486 "                 const char *path);\n"
31487 "\n"
31488
31489 #. type: =head2
31490 #: ../src/guestfs-actions.pod:7744
31491 msgid "guestfs_zegrepi"
31492 msgstr "guestfs_zegrepi"
31493
31494 #. type: verbatim
31495 #: ../src/guestfs-actions.pod:7746
31496 #, no-wrap
31497 msgid ""
31498 " char **\n"
31499 " guestfs_zegrepi (guestfs_h *g,\n"
31500 "                  const char *regex,\n"
31501 "                  const char *path);\n"
31502 "\n"
31503 msgstr ""
31504 " char **\n"
31505 " guestfs_zegrepi (guestfs_h *g,\n"
31506 "                  const char *regex,\n"
31507 "                  const char *path);\n"
31508 "\n"
31509
31510 #. type: =head2
31511 #: ../src/guestfs-actions.pod:7763
31512 msgid "guestfs_zero"
31513 msgstr "guestfs_zero"
31514
31515 #. type: verbatim
31516 #: ../src/guestfs-actions.pod:7765
31517 #, no-wrap
31518 msgid ""
31519 " int\n"
31520 " guestfs_zero (guestfs_h *g,\n"
31521 "               const char *device);\n"
31522 "\n"
31523 msgstr ""
31524 " int\n"
31525 " guestfs_zero (guestfs_h *g,\n"
31526 "               const char *device);\n"
31527 "\n"
31528
31529 #. type: textblock
31530 #: ../src/guestfs-actions.pod:7779
31531 msgid ""
31532 "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, "
31533 "C<guestfs_is_zero_device>"
31534 msgstr ""
31535
31536 #. type: =head2
31537 #: ../src/guestfs-actions.pod:7791
31538 msgid "guestfs_zero_device"
31539 msgstr "guestfs_zero_device"
31540
31541 #. type: verbatim
31542 #: ../src/guestfs-actions.pod:7793
31543 #, no-wrap
31544 msgid ""
31545 " int\n"
31546 " guestfs_zero_device (guestfs_h *g,\n"
31547 "                      const char *device);\n"
31548 "\n"
31549 msgstr ""
31550 " int\n"
31551 " guestfs_zero_device (guestfs_h *g,\n"
31552 "                      const char *device);\n"
31553 "\n"
31554
31555 #. type: textblock
31556 #: ../src/guestfs-actions.pod:7797
31557 msgid ""
31558 "This command writes zeroes over the entire C<device>.  Compare with "
31559 "C<guestfs_zero> which just zeroes the first few blocks of a device."
31560 msgstr ""
31561
31562 #. type: textblock
31563 #: ../src/guestfs-actions.pod:7815
31564 msgid "(Added in 1.3.1)"
31565 msgstr "(Додано у 1.3.1)"
31566
31567 #. type: =head2
31568 #: ../src/guestfs-actions.pod:7817
31569 msgid "guestfs_zerofree"
31570 msgstr "guestfs_zerofree"
31571
31572 #. type: verbatim
31573 #: ../src/guestfs-actions.pod:7819
31574 #, no-wrap
31575 msgid ""
31576 " int\n"
31577 " guestfs_zerofree (guestfs_h *g,\n"
31578 "                   const char *device);\n"
31579 "\n"
31580 msgstr ""
31581 " int\n"
31582 " guestfs_zerofree (guestfs_h *g,\n"
31583 "                   const char *device);\n"
31584 "\n"
31585
31586 #. type: =head2
31587 #: ../src/guestfs-actions.pod:7838
31588 msgid "guestfs_zfgrep"
31589 msgstr "guestfs_zfgrep"
31590
31591 #. type: verbatim
31592 #: ../src/guestfs-actions.pod:7840
31593 #, no-wrap
31594 msgid ""
31595 " char **\n"
31596 " guestfs_zfgrep (guestfs_h *g,\n"
31597 "                 const char *pattern,\n"
31598 "                 const char *path);\n"
31599 "\n"
31600 msgstr ""
31601 " char **\n"
31602 " guestfs_zfgrep (guestfs_h *g,\n"
31603 "                 const char *pattern,\n"
31604 "                 const char *path);\n"
31605 "\n"
31606
31607 #. type: =head2
31608 #: ../src/guestfs-actions.pod:7857
31609 msgid "guestfs_zfgrepi"
31610 msgstr "guestfs_zfgrepi"
31611
31612 #. type: verbatim
31613 #: ../src/guestfs-actions.pod:7859
31614 #, no-wrap
31615 msgid ""
31616 " char **\n"
31617 " guestfs_zfgrepi (guestfs_h *g,\n"
31618 "                  const char *pattern,\n"
31619 "                  const char *path);\n"
31620 "\n"
31621 msgstr ""
31622 " char **\n"
31623 " guestfs_zfgrepi (guestfs_h *g,\n"
31624 "                  const char *pattern,\n"
31625 "                  const char *path);\n"
31626 "\n"
31627
31628 #. type: =head2
31629 #: ../src/guestfs-actions.pod:7876
31630 msgid "guestfs_zfile"
31631 msgstr "guestfs_zfile"
31632
31633 #. type: verbatim
31634 #: ../src/guestfs-actions.pod:7878
31635 #, no-wrap
31636 msgid ""
31637 " char *\n"
31638 " guestfs_zfile (guestfs_h *g,\n"
31639 "                const char *meth,\n"
31640 "                const char *path);\n"
31641 "\n"
31642 msgstr ""
31643 " char *\n"
31644 " guestfs_zfile (guestfs_h *g,\n"
31645 "                const char *meth,\n"
31646 "                const char *path);\n"
31647 "\n"
31648
31649 #. type: textblock
31650 #: ../src/guestfs-actions.pod:7888
31651 msgid ""
31652 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
31653 "files."
31654 msgstr ""
31655
31656 #. type: textblock
31657 #: ../src/guestfs-actions.pod:7894
31658 msgid ""
31659 "This function is deprecated.  In new code, use the L</guestfs_file> call "
31660 "instead."
31661 msgstr ""
31662
31663 #. type: =head2
31664 #: ../src/guestfs-actions.pod:7903
31665 msgid "guestfs_zgrep"
31666 msgstr "guestfs_zgrep"
31667
31668 #. type: verbatim
31669 #: ../src/guestfs-actions.pod:7905
31670 #, no-wrap
31671 msgid ""
31672 " char **\n"
31673 " guestfs_zgrep (guestfs_h *g,\n"
31674 "                const char *regex,\n"
31675 "                const char *path);\n"
31676 "\n"
31677 msgstr ""
31678 " char **\n"
31679 " guestfs_zgrep (guestfs_h *g,\n"
31680 "                const char *regex,\n"
31681 "                const char *path);\n"
31682 "\n"
31683
31684 #. type: =head2
31685 #: ../src/guestfs-actions.pod:7922
31686 msgid "guestfs_zgrepi"
31687 msgstr "guestfs_zgrepi"
31688
31689 #. type: verbatim
31690 #: ../src/guestfs-actions.pod:7924
31691 #, no-wrap
31692 msgid ""
31693 " char **\n"
31694 " guestfs_zgrepi (guestfs_h *g,\n"
31695 "                 const char *regex,\n"
31696 "                 const char *path);\n"
31697 "\n"
31698 msgstr ""
31699 " char **\n"
31700 " guestfs_zgrepi (guestfs_h *g,\n"
31701 "                 const char *regex,\n"
31702 "                 const char *path);\n"
31703 "\n"
31704
31705 #. type: =item
31706 #: ../src/guestfs-availability.pod:3
31707 msgid "B<augeas>"
31708 msgstr "B<augeas>"
31709
31710 #. type: textblock
31711 #: ../src/guestfs-availability.pod:5
31712 msgid ""
31713 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
31714 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
31715 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
31716 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
31717 "L</guestfs_aug_save> L</guestfs_aug_set>"
31718 msgstr ""
31719
31720 #. type: =item
31721 #: ../src/guestfs-availability.pod:21
31722 msgid "B<btrfs>"
31723 msgstr ""
31724
31725 #. type: textblock
31726 #: ../src/guestfs-availability.pod:23
31727 msgid "The following functions: L</guestfs_btrfs_filesystem_resize>"
31728 msgstr ""
31729
31730 #. type: =item
31731 #: ../src/guestfs-availability.pod:26
31732 msgid "B<inotify>"
31733 msgstr "B<inotify>"
31734
31735 #. type: textblock
31736 #: ../src/guestfs-availability.pod:28
31737 msgid ""
31738 "The following functions: L</guestfs_inotify_add_watch> L</"
31739 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
31740 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
31741 msgstr ""
31742
31743 #. type: =item
31744 #: ../src/guestfs-availability.pod:36
31745 msgid "B<linuxfsuuid>"
31746 msgstr "B<linuxfsuuid>"
31747
31748 #. type: textblock
31749 #: ../src/guestfs-availability.pod:38
31750 msgid ""
31751 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
31752 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
31753 msgstr ""
31754
31755 #. type: =item
31756 #: ../src/guestfs-availability.pod:45
31757 msgid "B<linuxmodules>"
31758 msgstr "B<linuxmodules>"
31759
31760 #. type: textblock
31761 #: ../src/guestfs-availability.pod:47
31762 msgid "The following functions: L</guestfs_modprobe>"
31763 msgstr ""
31764
31765 #. type: =item
31766 #: ../src/guestfs-availability.pod:50
31767 msgid "B<linuxxattrs>"
31768 msgstr "B<linuxxattrs>"
31769
31770 #. type: textblock
31771 #: ../src/guestfs-availability.pod:52
31772 msgid ""
31773 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
31774 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
31775 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
31776 "guestfs_setxattr>"
31777 msgstr ""
31778
31779 #. type: =item
31780 #: ../src/guestfs-availability.pod:63
31781 msgid "B<luks>"
31782 msgstr "B<luks>"
31783
31784 #. type: textblock
31785 #: ../src/guestfs-availability.pod:65
31786 msgid ""
31787 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
31788 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
31789 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
31790 msgstr ""
31791
31792 #. type: =item
31793 #: ../src/guestfs-availability.pod:74
31794 msgid "B<lvm2>"
31795 msgstr "B<lvm2>"
31796
31797 #. type: textblock
31798 #: ../src/guestfs-availability.pod:76
31799 msgid ""
31800 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
31801 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
31802 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
31803 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
31804 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
31805 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
31806 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
31807 msgstr ""
31808
31809 #. type: =item
31810 #: ../src/guestfs-availability.pod:99
31811 msgid "B<mknod>"
31812 msgstr "B<mknod>"
31813
31814 #. type: textblock
31815 #: ../src/guestfs-availability.pod:101
31816 msgid ""
31817 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
31818 "guestfs_mknod_b> L</guestfs_mknod_c>"
31819 msgstr ""
31820
31821 #. type: =item
31822 #: ../src/guestfs-availability.pod:107
31823 msgid "B<ntfs3g>"
31824 msgstr "B<ntfs3g>"
31825
31826 #. type: textblock
31827 #: ../src/guestfs-availability.pod:109
31828 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
31829 msgstr ""
31830
31831 #. type: =item
31832 #: ../src/guestfs-availability.pod:112
31833 msgid "B<ntfsprogs>"
31834 msgstr "B<ntfsprogs>"
31835
31836 #. type: textblock
31837 #: ../src/guestfs-availability.pod:114
31838 msgid ""
31839 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_opts> "
31840 "L</guestfs_ntfsresize_size>"
31841 msgstr ""
31842
31843 #. type: =item
31844 #: ../src/guestfs-availability.pod:119
31845 msgid "B<realpath>"
31846 msgstr "B<realpath>"
31847
31848 #. type: textblock
31849 #: ../src/guestfs-availability.pod:121
31850 msgid "The following functions: L</guestfs_realpath>"
31851 msgstr ""
31852
31853 #. type: =item
31854 #: ../src/guestfs-availability.pod:124
31855 msgid "B<scrub>"
31856 msgstr "B<scrub>"
31857
31858 #. type: textblock
31859 #: ../src/guestfs-availability.pod:126
31860 msgid ""
31861 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
31862 "guestfs_scrub_freespace>"
31863 msgstr ""
31864
31865 #. type: =item
31866 #: ../src/guestfs-availability.pod:131
31867 msgid "B<selinux>"
31868 msgstr "B<selinux>"
31869
31870 #. type: textblock
31871 #: ../src/guestfs-availability.pod:133
31872 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
31873 msgstr ""
31874
31875 #. type: =item
31876 #: ../src/guestfs-availability.pod:137
31877 msgid "B<xz>"
31878 msgstr "B<xz>"
31879
31880 #. type: textblock
31881 #: ../src/guestfs-availability.pod:139
31882 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
31883 msgstr ""
31884
31885 #. type: =item
31886 #: ../src/guestfs-availability.pod:143
31887 msgid "B<zerofree>"
31888 msgstr "B<zerofree>"
31889
31890 #. type: textblock
31891 #: ../src/guestfs-availability.pod:145
31892 msgid "The following functions: L</guestfs_zerofree>"
31893 msgstr ""
31894
31895 #. type: =head2
31896 #: ../src/guestfs-structs.pod:1
31897 msgid "guestfs_int_bool"
31898 msgstr ""
31899
31900 #. type: verbatim
31901 #: ../src/guestfs-structs.pod:3
31902 #, no-wrap
31903 msgid ""
31904 " struct guestfs_int_bool {\n"
31905 "   int32_t i;\n"
31906 "   int32_t b;\n"
31907 " };\n"
31908 " \n"
31909 msgstr ""
31910
31911 #. type: verbatim
31912 #: ../src/guestfs-structs.pod:8
31913 #, no-wrap
31914 msgid ""
31915 " struct guestfs_int_bool_list {\n"
31916 "   uint32_t len; /* Number of elements in list. */\n"
31917 "   struct guestfs_int_bool *val; /* Elements. */\n"
31918 " };\n"
31919 " \n"
31920 msgstr ""
31921
31922 #. type: verbatim
31923 #: ../src/guestfs-structs.pod:13
31924 #, no-wrap
31925 msgid ""
31926 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
31927 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
31928 "\n"
31929 msgstr ""
31930
31931 #. type: =head2
31932 #: ../src/guestfs-structs.pod:16
31933 msgid "guestfs_lvm_pv"
31934 msgstr ""
31935
31936 #. type: verbatim
31937 #: ../src/guestfs-structs.pod:18
31938 #, no-wrap
31939 msgid ""
31940 " struct guestfs_lvm_pv {\n"
31941 "   char *pv_name;\n"
31942 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
31943 "   char pv_uuid[32];\n"
31944 "   char *pv_fmt;\n"
31945 "   uint64_t pv_size;\n"
31946 "   uint64_t dev_size;\n"
31947 "   uint64_t pv_free;\n"
31948 "   uint64_t pv_used;\n"
31949 "   char *pv_attr;\n"
31950 "   int64_t pv_pe_count;\n"
31951 "   int64_t pv_pe_alloc_count;\n"
31952 "   char *pv_tags;\n"
31953 "   uint64_t pe_start;\n"
31954 "   int64_t pv_mda_count;\n"
31955 "   uint64_t pv_mda_free;\n"
31956 " };\n"
31957 " \n"
31958 msgstr ""
31959
31960 #. type: verbatim
31961 #: ../src/guestfs-structs.pod:36
31962 #, no-wrap
31963 msgid ""
31964 " struct guestfs_lvm_pv_list {\n"
31965 "   uint32_t len; /* Number of elements in list. */\n"
31966 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
31967 " };\n"
31968 " \n"
31969 msgstr ""
31970
31971 #. type: verbatim
31972 #: ../src/guestfs-structs.pod:41
31973 #, no-wrap
31974 msgid ""
31975 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
31976 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
31977 "\n"
31978 msgstr ""
31979
31980 #. type: =head2
31981 #: ../src/guestfs-structs.pod:44
31982 msgid "guestfs_lvm_vg"
31983 msgstr ""
31984
31985 #. type: verbatim
31986 #: ../src/guestfs-structs.pod:46
31987 #, no-wrap
31988 msgid ""
31989 " struct guestfs_lvm_vg {\n"
31990 "   char *vg_name;\n"
31991 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
31992 "   char vg_uuid[32];\n"
31993 "   char *vg_fmt;\n"
31994 "   char *vg_attr;\n"
31995 "   uint64_t vg_size;\n"
31996 "   uint64_t vg_free;\n"
31997 "   char *vg_sysid;\n"
31998 "   uint64_t vg_extent_size;\n"
31999 "   int64_t vg_extent_count;\n"
32000 "   int64_t vg_free_count;\n"
32001 "   int64_t max_lv;\n"
32002 "   int64_t max_pv;\n"
32003 "   int64_t pv_count;\n"
32004 "   int64_t lv_count;\n"
32005 "   int64_t snap_count;\n"
32006 "   int64_t vg_seqno;\n"
32007 "   char *vg_tags;\n"
32008 "   int64_t vg_mda_count;\n"
32009 "   uint64_t vg_mda_free;\n"
32010 " };\n"
32011 " \n"
32012 msgstr ""
32013
32014 #. type: verbatim
32015 #: ../src/guestfs-structs.pod:69
32016 #, no-wrap
32017 msgid ""
32018 " struct guestfs_lvm_vg_list {\n"
32019 "   uint32_t len; /* Number of elements in list. */\n"
32020 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
32021 " };\n"
32022 " \n"
32023 msgstr ""
32024
32025 #. type: verbatim
32026 #: ../src/guestfs-structs.pod:74
32027 #, no-wrap
32028 msgid ""
32029 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
32030 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
32031 "\n"
32032 msgstr ""
32033
32034 #. type: =head2
32035 #: ../src/guestfs-structs.pod:77
32036 msgid "guestfs_lvm_lv"
32037 msgstr ""
32038
32039 #. type: verbatim
32040 #: ../src/guestfs-structs.pod:79
32041 #, no-wrap
32042 msgid ""
32043 " struct guestfs_lvm_lv {\n"
32044 "   char *lv_name;\n"
32045 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
32046 "   char lv_uuid[32];\n"
32047 "   char *lv_attr;\n"
32048 "   int64_t lv_major;\n"
32049 "   int64_t lv_minor;\n"
32050 "   int64_t lv_kernel_major;\n"
32051 "   int64_t lv_kernel_minor;\n"
32052 "   uint64_t lv_size;\n"
32053 "   int64_t seg_count;\n"
32054 "   char *origin;\n"
32055 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
32056 "   float snap_percent;\n"
32057 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
32058 "   float copy_percent;\n"
32059 "   char *move_pv;\n"
32060 "   char *lv_tags;\n"
32061 "   char *mirror_log;\n"
32062 "   char *modules;\n"
32063 " };\n"
32064 " \n"
32065 msgstr ""
32066
32067 #. type: verbatim
32068 #: ../src/guestfs-structs.pod:101
32069 #, no-wrap
32070 msgid ""
32071 " struct guestfs_lvm_lv_list {\n"
32072 "   uint32_t len; /* Number of elements in list. */\n"
32073 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
32074 " };\n"
32075 " \n"
32076 msgstr ""
32077
32078 #. type: verbatim
32079 #: ../src/guestfs-structs.pod:106
32080 #, no-wrap
32081 msgid ""
32082 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
32083 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
32084 "\n"
32085 msgstr ""
32086
32087 #. type: verbatim
32088 #: ../src/guestfs-structs.pod:111
32089 #, no-wrap
32090 msgid ""
32091 " struct guestfs_stat {\n"
32092 "   int64_t dev;\n"
32093 "   int64_t ino;\n"
32094 "   int64_t mode;\n"
32095 "   int64_t nlink;\n"
32096 "   int64_t uid;\n"
32097 "   int64_t gid;\n"
32098 "   int64_t rdev;\n"
32099 "   int64_t size;\n"
32100 "   int64_t blksize;\n"
32101 "   int64_t blocks;\n"
32102 "   int64_t atime;\n"
32103 "   int64_t mtime;\n"
32104 "   int64_t ctime;\n"
32105 " };\n"
32106 " \n"
32107 msgstr ""
32108
32109 #. type: verbatim
32110 #: ../src/guestfs-structs.pod:127
32111 #, no-wrap
32112 msgid ""
32113 " struct guestfs_stat_list {\n"
32114 "   uint32_t len; /* Number of elements in list. */\n"
32115 "   struct guestfs_stat *val; /* Elements. */\n"
32116 " };\n"
32117 " \n"
32118 msgstr ""
32119
32120 #. type: verbatim
32121 #: ../src/guestfs-structs.pod:132
32122 #, no-wrap
32123 msgid ""
32124 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
32125 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
32126 "\n"
32127 msgstr ""
32128
32129 #. type: verbatim
32130 #: ../src/guestfs-structs.pod:137
32131 #, no-wrap
32132 msgid ""
32133 " struct guestfs_statvfs {\n"
32134 "   int64_t bsize;\n"
32135 "   int64_t frsize;\n"
32136 "   int64_t blocks;\n"
32137 "   int64_t bfree;\n"
32138 "   int64_t bavail;\n"
32139 "   int64_t files;\n"
32140 "   int64_t ffree;\n"
32141 "   int64_t favail;\n"
32142 "   int64_t fsid;\n"
32143 "   int64_t flag;\n"
32144 "   int64_t namemax;\n"
32145 " };\n"
32146 " \n"
32147 msgstr ""
32148
32149 #. type: verbatim
32150 #: ../src/guestfs-structs.pod:151
32151 #, no-wrap
32152 msgid ""
32153 " struct guestfs_statvfs_list {\n"
32154 "   uint32_t len; /* Number of elements in list. */\n"
32155 "   struct guestfs_statvfs *val; /* Elements. */\n"
32156 " };\n"
32157 " \n"
32158 msgstr ""
32159
32160 #. type: verbatim
32161 #: ../src/guestfs-structs.pod:156
32162 #, no-wrap
32163 msgid ""
32164 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
32165 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
32166 "\n"
32167 msgstr ""
32168
32169 #. type: =head2
32170 #: ../src/guestfs-structs.pod:159
32171 msgid "guestfs_dirent"
32172 msgstr ""
32173
32174 #. type: verbatim
32175 #: ../src/guestfs-structs.pod:161
32176 #, no-wrap
32177 msgid ""
32178 " struct guestfs_dirent {\n"
32179 "   int64_t ino;\n"
32180 "   char ftyp;\n"
32181 "   char *name;\n"
32182 " };\n"
32183 " \n"
32184 msgstr ""
32185
32186 #. type: verbatim
32187 #: ../src/guestfs-structs.pod:167
32188 #, no-wrap
32189 msgid ""
32190 " struct guestfs_dirent_list {\n"
32191 "   uint32_t len; /* Number of elements in list. */\n"
32192 "   struct guestfs_dirent *val; /* Elements. */\n"
32193 " };\n"
32194 " \n"
32195 msgstr ""
32196
32197 #. type: verbatim
32198 #: ../src/guestfs-structs.pod:172
32199 #, no-wrap
32200 msgid ""
32201 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
32202 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
32203 "\n"
32204 msgstr ""
32205
32206 #. type: verbatim
32207 #: ../src/guestfs-structs.pod:177
32208 #, no-wrap
32209 msgid ""
32210 " struct guestfs_version {\n"
32211 "   int64_t major;\n"
32212 "   int64_t minor;\n"
32213 "   int64_t release;\n"
32214 "   char *extra;\n"
32215 " };\n"
32216 " \n"
32217 msgstr ""
32218
32219 #. type: verbatim
32220 #: ../src/guestfs-structs.pod:184
32221 #, no-wrap
32222 msgid ""
32223 " struct guestfs_version_list {\n"
32224 "   uint32_t len; /* Number of elements in list. */\n"
32225 "   struct guestfs_version *val; /* Elements. */\n"
32226 " };\n"
32227 " \n"
32228 msgstr ""
32229
32230 #. type: verbatim
32231 #: ../src/guestfs-structs.pod:189
32232 #, no-wrap
32233 msgid ""
32234 " void guestfs_free_version (struct guestfs_free_version *);\n"
32235 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
32236 "\n"
32237 msgstr ""
32238
32239 #. type: =head2
32240 #: ../src/guestfs-structs.pod:192
32241 msgid "guestfs_xattr"
32242 msgstr ""
32243
32244 #. type: verbatim
32245 #: ../src/guestfs-structs.pod:194
32246 #, no-wrap
32247 msgid ""
32248 " struct guestfs_xattr {\n"
32249 "   char *attrname;\n"
32250 "   /* The next two fields describe a byte array. */\n"
32251 "   uint32_t attrval_len;\n"
32252 "   char *attrval;\n"
32253 " };\n"
32254 " \n"
32255 msgstr ""
32256
32257 #. type: verbatim
32258 #: ../src/guestfs-structs.pod:201
32259 #, no-wrap
32260 msgid ""
32261 " struct guestfs_xattr_list {\n"
32262 "   uint32_t len; /* Number of elements in list. */\n"
32263 "   struct guestfs_xattr *val; /* Elements. */\n"
32264 " };\n"
32265 " \n"
32266 msgstr ""
32267
32268 #. type: verbatim
32269 #: ../src/guestfs-structs.pod:206
32270 #, no-wrap
32271 msgid ""
32272 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
32273 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
32274 "\n"
32275 msgstr ""
32276
32277 #. type: =head2
32278 #: ../src/guestfs-structs.pod:209
32279 msgid "guestfs_inotify_event"
32280 msgstr ""
32281
32282 #. type: verbatim
32283 #: ../src/guestfs-structs.pod:211
32284 #, no-wrap
32285 msgid ""
32286 " struct guestfs_inotify_event {\n"
32287 "   int64_t in_wd;\n"
32288 "   uint32_t in_mask;\n"
32289 "   uint32_t in_cookie;\n"
32290 "   char *in_name;\n"
32291 " };\n"
32292 " \n"
32293 msgstr ""
32294
32295 #. type: verbatim
32296 #: ../src/guestfs-structs.pod:218
32297 #, no-wrap
32298 msgid ""
32299 " struct guestfs_inotify_event_list {\n"
32300 "   uint32_t len; /* Number of elements in list. */\n"
32301 "   struct guestfs_inotify_event *val; /* Elements. */\n"
32302 " };\n"
32303 " \n"
32304 msgstr ""
32305
32306 #. type: verbatim
32307 #: ../src/guestfs-structs.pod:223
32308 #, no-wrap
32309 msgid ""
32310 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
32311 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
32312 "\n"
32313 msgstr ""
32314
32315 #. type: =head2
32316 #: ../src/guestfs-structs.pod:226
32317 msgid "guestfs_partition"
32318 msgstr ""
32319
32320 #. type: verbatim
32321 #: ../src/guestfs-structs.pod:228
32322 #, no-wrap
32323 msgid ""
32324 " struct guestfs_partition {\n"
32325 "   int32_t part_num;\n"
32326 "   uint64_t part_start;\n"
32327 "   uint64_t part_end;\n"
32328 "   uint64_t part_size;\n"
32329 " };\n"
32330 " \n"
32331 msgstr ""
32332
32333 #. type: verbatim
32334 #: ../src/guestfs-structs.pod:235
32335 #, no-wrap
32336 msgid ""
32337 " struct guestfs_partition_list {\n"
32338 "   uint32_t len; /* Number of elements in list. */\n"
32339 "   struct guestfs_partition *val; /* Elements. */\n"
32340 " };\n"
32341 " \n"
32342 msgstr ""
32343
32344 #. type: verbatim
32345 #: ../src/guestfs-structs.pod:240
32346 #, no-wrap
32347 msgid ""
32348 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
32349 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
32350 "\n"
32351 msgstr ""
32352
32353 #. type: =head2
32354 #: ../src/guestfs-structs.pod:243
32355 msgid "guestfs_application"
32356 msgstr ""
32357
32358 #. type: verbatim
32359 #: ../src/guestfs-structs.pod:245
32360 #, no-wrap
32361 msgid ""
32362 " struct guestfs_application {\n"
32363 "   char *app_name;\n"
32364 "   char *app_display_name;\n"
32365 "   int32_t app_epoch;\n"
32366 "   char *app_version;\n"
32367 "   char *app_release;\n"
32368 "   char *app_install_path;\n"
32369 "   char *app_trans_path;\n"
32370 "   char *app_publisher;\n"
32371 "   char *app_url;\n"
32372 "   char *app_source_package;\n"
32373 "   char *app_summary;\n"
32374 "   char *app_description;\n"
32375 " };\n"
32376 " \n"
32377 msgstr ""
32378
32379 #. type: verbatim
32380 #: ../src/guestfs-structs.pod:260
32381 #, no-wrap
32382 msgid ""
32383 " struct guestfs_application_list {\n"
32384 "   uint32_t len; /* Number of elements in list. */\n"
32385 "   struct guestfs_application *val; /* Elements. */\n"
32386 " };\n"
32387 " \n"
32388 msgstr ""
32389
32390 #. type: verbatim
32391 #: ../src/guestfs-structs.pod:265
32392 #, no-wrap
32393 msgid ""
32394 " void guestfs_free_application (struct guestfs_free_application *);\n"
32395 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
32396 "\n"
32397 msgstr ""
32398
32399 #. type: textblock
32400 #: ../src/guestfs.pod:5
32401 msgid "guestfs - Library for accessing and modifying virtual machine images"
32402 msgstr ""
32403 "guestfs — бібліотека для доступу та внесення змін до образів віртуальних "
32404 "машин"
32405
32406 #. type: verbatim
32407 #: ../src/guestfs.pod:11
32408 #, no-wrap
32409 msgid ""
32410 " guestfs_h *g = guestfs_create ();\n"
32411 " guestfs_add_drive (g, \"guest.img\");\n"
32412 " guestfs_launch (g);\n"
32413 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
32414 " guestfs_touch (g, \"/hello\");\n"
32415 " guestfs_umount (g, \"/\");\n"
32416 " guestfs_close (g);\n"
32417 "\n"
32418 msgstr ""
32419 " guestfs_h *g = guestfs_create ();\n"
32420 " guestfs_add_drive (g, \"guest.img\");\n"
32421 " guestfs_launch (g);\n"
32422 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
32423 " guestfs_touch (g, \"/hello\");\n"
32424 " guestfs_umount (g, \"/\");\n"
32425 " guestfs_close (g);\n"
32426 "\n"
32427
32428 #. type: textblock
32429 #: ../src/guestfs.pod:25
32430 msgid ""
32431 "Libguestfs is a library for accessing and modifying guest disk images.  "
32432 "Amongst the things this is good for: making batch configuration changes to "
32433 "guests, getting disk used/free statistics (see also: virt-df), migrating "
32434 "between virtualization systems (see also: virt-p2v), performing partial "
32435 "backups, performing partial guest clones, cloning guests and changing "
32436 "registry/UUID/hostname info, and much else besides."
32437 msgstr ""
32438
32439 #. type: textblock
32440 #: ../src/guestfs.pod:33
32441 msgid ""
32442 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
32443 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
32444 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
32445 "qcow2, vmdk."
32446 msgstr ""
32447
32448 #. type: textblock
32449 #: ../src/guestfs.pod:38
32450 msgid ""
32451 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
32452 "what filesystem is in each LV, etc.).  It can also run commands in the "
32453 "context of the guest.  Also you can access filesystems over FUSE."
32454 msgstr ""
32455
32456 #. type: textblock
32457 #: ../src/guestfs.pod:43
32458 msgid ""
32459 "Libguestfs is a library that can be linked with C and C++ management "
32460 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
32461 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
32462 "line."
32463 msgstr ""
32464
32465 #. type: textblock
32466 #: ../src/guestfs.pod:48
32467 msgid ""
32468 "You don't need to be root to use libguestfs, although obviously you do need "
32469 "enough permissions to access the disk images."
32470 msgstr ""
32471
32472 #. type: textblock
32473 #: ../src/guestfs.pod:51
32474 msgid ""
32475 "Libguestfs is a large API because it can do many things.  For a gentle "
32476 "introduction, please read the L</API OVERVIEW> section next."
32477 msgstr ""
32478
32479 #. type: textblock
32480 #: ../src/guestfs.pod:54
32481 msgid ""
32482 "There are also some example programs in the L<guestfs-examples(3)> manual "
32483 "page."
32484 msgstr ""
32485
32486 #. type: =head1
32487 #: ../src/guestfs.pod:57
32488 msgid "API OVERVIEW"
32489 msgstr "ОГЛЯД API"
32490
32491 #. type: textblock
32492 #: ../src/guestfs.pod:59
32493 msgid ""
32494 "This section provides a gentler overview of the libguestfs API.  We also try "
32495 "to group API calls together, where that may not be obvious from reading "
32496 "about the individual calls in the main section of this manual."
32497 msgstr ""
32498
32499 #. type: =head2
32500 #: ../src/guestfs.pod:64
32501 msgid "HANDLES"
32502 msgstr "ОБРОБНИКИ"
32503
32504 #. type: textblock
32505 #: ../src/guestfs.pod:66
32506 msgid ""
32507 "Before you can use libguestfs calls, you have to create a handle.  Then you "
32508 "must add at least one disk image to the handle, followed by launching the "
32509 "handle, then performing whatever operations you want, and finally closing "
32510 "the handle.  By convention we use the single letter C<g> for the name of the "
32511 "handle variable, although of course you can use any name you want."
32512 msgstr ""
32513
32514 #. type: textblock
32515 #: ../src/guestfs.pod:73
32516 msgid "The general structure of all libguestfs-using programs looks like this:"
32517 msgstr ""
32518
32519 #. type: verbatim
32520 #: ../src/guestfs.pod:76
32521 #, no-wrap
32522 msgid ""
32523 " guestfs_h *g = guestfs_create ();\n"
32524 " \n"
32525 msgstr ""
32526 " guestfs_h *g = guestfs_create ();\n"
32527 " \n"
32528
32529 #. type: verbatim
32530 #: ../src/guestfs.pod:78
32531 #, no-wrap
32532 msgid ""
32533 " /* Call guestfs_add_drive additional times if there are\n"
32534 "  * multiple disk images.\n"
32535 "  */\n"
32536 " guestfs_add_drive (g, \"guest.img\");\n"
32537 " \n"
32538 msgstr ""
32539
32540 #. type: verbatim
32541 #: ../src/guestfs.pod:83
32542 #, no-wrap
32543 msgid ""
32544 " /* Most manipulation calls won't work until you've launched\n"
32545 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
32546 "  * and _before_ other commands.\n"
32547 "  */\n"
32548 " guestfs_launch (g);\n"
32549 " \n"
32550 msgstr ""
32551
32552 #. type: verbatim
32553 #: ../src/guestfs.pod:89
32554 #, no-wrap
32555 msgid ""
32556 " /* Now you can examine what partitions, LVs etc are available.\n"
32557 "  */\n"
32558 " char **partitions = guestfs_list_partitions (g);\n"
32559 " char **logvols = guestfs_lvs (g);\n"
32560 " \n"
32561 msgstr ""
32562 " /* Тепер можна перевірити, які розділи, логічні томи тощо доступні.\n"
32563 "  */\n"
32564 " char **partitions = guestfs_list_partitions (g);\n"
32565 " char **logvols = guestfs_lvs (g);\n"
32566 " \n"
32567
32568 #. type: verbatim
32569 #: ../src/guestfs.pod:94
32570 #, no-wrap
32571 msgid ""
32572 " /* To access a filesystem in the image, you must mount it.\n"
32573 "  */\n"
32574 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
32575 " \n"
32576 msgstr ""
32577 " /* Щоб отримати доступ до файлової системи на образі, вам слід його змонтувати.\n"
32578 "  */\n"
32579 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
32580 " \n"
32581
32582 #. type: verbatim
32583 #: ../src/guestfs.pod:98
32584 #, no-wrap
32585 msgid ""
32586 " /* Now you can perform filesystem actions on the guest\n"
32587 "  * disk image.\n"
32588 "  */\n"
32589 " guestfs_touch (g, \"/hello\");\n"
32590 " \n"
32591 msgstr ""
32592
32593 #. type: verbatim
32594 #: ../src/guestfs.pod:103
32595 #, no-wrap
32596 msgid ""
32597 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
32598 "  * it is done automatically when you close the handle.  See\n"
32599 "  * discussion of autosync in this page.\n"
32600 "  */\n"
32601 " guestfs_sync (g);\n"
32602 " \n"
32603 msgstr ""
32604
32605 #. type: verbatim
32606 #: ../src/guestfs.pod:109
32607 #, no-wrap
32608 msgid ""
32609 " /* Close the handle 'g'. */\n"
32610 " guestfs_close (g);\n"
32611 "\n"
32612 msgstr ""
32613 " /* Закрити дескриптор 'g'. */\n"
32614 " guestfs_close (g);\n"
32615 "\n"
32616
32617 #. type: textblock
32618 #: ../src/guestfs.pod:112
32619 msgid ""
32620 "The code above doesn't include any error checking.  In real code you should "
32621 "check return values carefully for errors.  In general all functions that "
32622 "return integers return C<-1> on error, and all functions that return "
32623 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
32624 "how to handle errors, and consult the documentation for each function call "
32625 "below to see precisely how they return error indications.  See L<guestfs-"
32626 "examples(3)> for fully worked examples."
32627 msgstr ""
32628
32629 #. type: =head2
32630 #: ../src/guestfs.pod:121
32631 msgid "DISK IMAGES"
32632 msgstr "ОБРАЗИ ДИСКІВ"
32633
32634 #. type: textblock
32635 #: ../src/guestfs.pod:123
32636 msgid ""
32637 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
32638 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
32639 "actual block device, or simply an empty file of zeroes that you have created "
32640 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
32641 "of these."
32642 msgstr ""
32643
32644 #. type: textblock
32645 #: ../src/guestfs.pod:129
32646 msgid ""
32647 "The call you should use in modern code for adding drives is L</"
32648 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
32649 "specifying that the format is raw, do:"
32650 msgstr ""
32651
32652 #. type: verbatim
32653 #: ../src/guestfs.pod:133
32654 #, no-wrap
32655 msgid ""
32656 " guestfs_add_drive_opts (g, filename,\n"
32657 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
32658 "                         -1);\n"
32659 "\n"
32660 msgstr ""
32661 " guestfs_add_drive_opts (g, filename,\n"
32662 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
32663 "                         -1);\n"
32664 "\n"
32665
32666 #. type: textblock
32667 #: ../src/guestfs.pod:137
32668 msgid "You can add a disk read-only using:"
32669 msgstr "Ви можете додати диск у режимі лише читання:"
32670
32671 #. type: verbatim
32672 #: ../src/guestfs.pod:139
32673 #, no-wrap
32674 msgid ""
32675 " guestfs_add_drive_opts (g, filename,\n"
32676 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
32677 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
32678 "                         -1);\n"
32679 "\n"
32680 msgstr ""
32681 " guestfs_add_drive_opts (g, filename,\n"
32682 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
32683 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
32684 "                         -1);\n"
32685 "\n"
32686
32687 #. type: textblock
32688 #: ../src/guestfs.pod:144
32689 msgid ""
32690 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
32691 "libguestfs won't modify the file."
32692 msgstr ""
32693
32694 #. type: textblock
32695 #: ../src/guestfs.pod:147
32696 msgid ""
32697 "Be extremely cautious if the disk image is in use, eg. if it is being used "
32698 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
32699 "corruption, but adding it read-only is safe."
32700 msgstr ""
32701
32702 #. type: textblock
32703 #: ../src/guestfs.pod:151
32704 msgid ""
32705 "You must add at least one disk image, and you may add multiple disk images.  "
32706 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
32707 "first one you added), C</dev/sdb> (for the second one you added), etc."
32708 msgstr ""
32709
32710 #. type: textblock
32711 #: ../src/guestfs.pod:156
32712 msgid ""
32713 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
32714 "can call L</guestfs_list_devices> to get a list of the device names, in the "
32715 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
32716 msgstr ""
32717
32718 #. type: =head2
32719 #: ../src/guestfs.pod:161
32720 msgid "MOUNTING"
32721 msgstr "МОНТУВАННЯ"
32722
32723 #. type: textblock
32724 #: ../src/guestfs.pod:163
32725 msgid ""
32726 "Before you can read or write files, create directories and so on in a disk "
32727 "image that contains filesystems, you have to mount those filesystems using "
32728 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
32729 "a disk image contains (for example) one partition with a filesystem on that "
32730 "partition, then you can mount it directly:"
32731 msgstr ""
32732
32733 #. type: verbatim
32734 #: ../src/guestfs.pod:170
32735 #, no-wrap
32736 msgid ""
32737 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
32738 "\n"
32739 msgstr ""
32740 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
32741 "\n"
32742
32743 #. type: textblock
32744 #: ../src/guestfs.pod:172
32745 msgid ""
32746 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
32747 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
32748 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
32749 "that these are libguestfs virtual devices, and are nothing to do with host "
32750 "devices."
32751 msgstr ""
32752
32753 #. type: textblock
32754 #: ../src/guestfs.pod:178
32755 msgid ""
32756 "If you are given a disk image and you don't know what it contains then you "
32757 "have to find out.  Libguestfs can do that too: use L</"
32758 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
32759 "LVs, and either try mounting each to see what is mountable, or else examine "
32760 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
32761 "filesystems, use L</guestfs_list_filesystems>."
32762 msgstr ""
32763
32764 #. type: textblock
32765 #: ../src/guestfs.pod:186
32766 msgid ""
32767 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
32768 "L</INSPECTION> below).  But you might find it easier to look at higher level "
32769 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
32770 msgstr ""
32771
32772 #. type: textblock
32773 #: ../src/guestfs.pod:191
32774 msgid ""
32775 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
32776 "several other variations of the C<guestfs_mount_*> call."
32777 msgstr ""
32778
32779 #. type: =head2
32780 #: ../src/guestfs.pod:194
32781 msgid "FILESYSTEM ACCESS AND MODIFICATION"
32782 msgstr "ДОСТУП ТА ВНЕСЕННЯ ЗМІН ДО ФАЙЛОВИХ СИСТЕМ"
32783
32784 #. type: textblock
32785 #: ../src/guestfs.pod:196
32786 msgid ""
32787 "The majority of the libguestfs API consists of fairly low-level calls for "
32788 "accessing and modifying the files, directories, symlinks etc on mounted "
32789 "filesystems.  There are over a hundred such calls which you can find listed "
32790 "in detail below in this man page, and we don't even pretend to cover them "
32791 "all in this overview."
32792 msgstr ""
32793
32794 #. type: textblock
32795 #: ../src/guestfs.pod:202
32796 msgid ""
32797 "Specify filenames as full paths, starting with C<\"/\"> and including the "
32798 "mount point."
32799 msgstr ""
32800 "Вказуйте адреси і назви файлів повністю, починаючи з C<\"/\">, разом з "
32801 "точкою монтування."
32802
32803 #. type: textblock
32804 #: ../src/guestfs.pod:205
32805 msgid ""
32806 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
32807 "the file called C<\"etc/passwd\"> then you could do:"
32808 msgstr ""
32809 "Наприклад, якщо вами змонтовано файлову систему до C<\"/\">, і ви бажаєте "
32810 "виконати читання файла з назвою C<\"etc/passwd\">, ви можете скористатися "
32811 "таким кодом:"
32812
32813 #. type: verbatim
32814 #: ../src/guestfs.pod:208
32815 #, no-wrap
32816 msgid ""
32817 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
32818 "\n"
32819 msgstr ""
32820 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
32821 "\n"
32822
32823 #. type: textblock
32824 #: ../src/guestfs.pod:210
32825 msgid ""
32826 "This would return C<data> as a newly allocated buffer containing the full "
32827 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
32828 "or C<NULL> if there was an error."
32829 msgstr ""
32830
32831 #. type: textblock
32832 #: ../src/guestfs.pod:214
32833 msgid ""
32834 "As another example, to create a top-level directory on that filesystem "
32835 "called C<\"var\"> you would do:"
32836 msgstr ""
32837
32838 #. type: verbatim
32839 #: ../src/guestfs.pod:217
32840 #, no-wrap
32841 msgid ""
32842 " guestfs_mkdir (g, \"/var\");\n"
32843 "\n"
32844 msgstr ""
32845 " guestfs_mkdir (g, \"/var\");\n"
32846 "\n"
32847
32848 #. type: textblock
32849 #: ../src/guestfs.pod:219
32850 msgid "To create a symlink you could do:"
32851 msgstr "Щоб створити символічне посилання, ви можете скористатися таким кодом:"
32852
32853 #. type: verbatim
32854 #: ../src/guestfs.pod:221
32855 #, no-wrap
32856 msgid ""
32857 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
32858 "               \"/etc/rc3.d/S30portmap\");\n"
32859 "\n"
32860 msgstr ""
32861 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
32862 "               \"/etc/rc3.d/S30portmap\");\n"
32863 "\n"
32864
32865 #. type: textblock
32866 #: ../src/guestfs.pod:224
32867 msgid ""
32868 "Libguestfs will reject attempts to use relative paths and there is no "
32869 "concept of a current working directory."
32870 msgstr ""
32871
32872 #. type: textblock
32873 #: ../src/guestfs.pod:227
32874 msgid ""
32875 "Libguestfs can return errors in many situations: for example if the "
32876 "filesystem isn't writable, or if a file or directory that you requested "
32877 "doesn't exist.  If you are using the C API (documented here)  you have to "
32878 "check for those error conditions after each call.  (Other language bindings "
32879 "turn these errors into exceptions)."
32880 msgstr ""
32881
32882 #. type: textblock
32883 #: ../src/guestfs.pod:233
32884 msgid ""
32885 "File writes are affected by the per-handle umask, set by calling L</"
32886 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
32887 msgstr ""
32888
32889 #. type: =head2
32890 #: ../src/guestfs.pod:236
32891 msgid "PARTITIONING"
32892 msgstr "ПОДІЛ НА РОЗДІЛИ"
32893
32894 #. type: textblock
32895 #: ../src/guestfs.pod:238
32896 msgid ""
32897 "Libguestfs contains API calls to read, create and modify partition tables on "
32898 "disk images."
32899 msgstr ""
32900
32901 #. type: textblock
32902 #: ../src/guestfs.pod:241
32903 msgid ""
32904 "In the common case where you want to create a single partition covering the "
32905 "whole disk, you should use the L</guestfs_part_disk> call:"
32906 msgstr ""
32907
32908 #. type: verbatim
32909 #: ../src/guestfs.pod:245
32910 #, no-wrap
32911 msgid ""
32912 " const char *parttype = \"mbr\";\n"
32913 " if (disk_is_larger_than_2TB)\n"
32914 "   parttype = \"gpt\";\n"
32915 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
32916 "\n"
32917 msgstr ""
32918 " const char *parttype = \"mbr\";\n"
32919 " if (disk_is_larger_than_2TB)\n"
32920 "   parttype = \"gpt\";\n"
32921 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
32922 "\n"
32923
32924 #. type: textblock
32925 #: ../src/guestfs.pod:250
32926 msgid ""
32927 "Obviously this effectively wipes anything that was on that disk image before."
32928 msgstr ""
32929
32930 #. type: =head2
32931 #: ../src/guestfs.pod:253
32932 msgid "LVM2"
32933 msgstr "LVM2"
32934
32935 #. type: textblock
32936 #: ../src/guestfs.pod:255
32937 msgid ""
32938 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
32939 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
32940 "you familiarize yourself with the concepts of physical volumes, volume "
32941 "groups and logical volumes."
32942 msgstr ""
32943
32944 #. type: textblock
32945 #: ../src/guestfs.pod:260
32946 msgid ""
32947 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
32948 "tldp.org/HOWTO/LVM-HOWTO/>."
32949 msgstr ""
32950
32951 #. type: =head2
32952 #: ../src/guestfs.pod:263
32953 msgid "DOWNLOADING"
32954 msgstr "ОТРИМАННЯ ДАНИХ"
32955
32956 #. type: textblock
32957 #: ../src/guestfs.pod:265
32958 msgid ""
32959 "Use L</guestfs_cat> to download small, text only files.  This call is "
32960 "limited to files which are less than 2 MB and which cannot contain any ASCII "
32961 "NUL (C<\\0>) characters.  However the API is very simple to use."
32962 msgstr ""
32963
32964 #. type: textblock
32965 #: ../src/guestfs.pod:269
32966 msgid ""
32967 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
32968 "bit data, since it returns a (pointer, size) pair.  However it is still "
32969 "limited to \"small\" files, less than 2 MB."
32970 msgstr ""
32971
32972 #. type: textblock
32973 #: ../src/guestfs.pod:273
32974 msgid ""
32975 "L</guestfs_download> can be used to download any file, with no limits on "
32976 "content or size (even files larger than 4 GB)."
32977 msgstr ""
32978
32979 #. type: textblock
32980 #: ../src/guestfs.pod:276
32981 msgid ""
32982 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
32983 msgstr ""
32984
32985 #. type: =head2
32986 #: ../src/guestfs.pod:279
32987 msgid "UPLOADING"
32988 msgstr "ВИВАНТАЖЕННЯ"
32989
32990 #. type: textblock
32991 #: ../src/guestfs.pod:281
32992 msgid ""
32993 "It's often the case that you want to write a file or files to the disk image."
32994 msgstr ""
32995
32996 #. type: textblock
32997 #: ../src/guestfs.pod:284
32998 msgid ""
32999 "To write a small file with fixed content, use L</guestfs_write>.  To create "
33000 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
33001 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
33002 "of other functions for creating test files, for example L</guestfs_fill> and "
33003 "L</guestfs_fill_pattern>."
33004 msgstr ""
33005
33006 #. type: textblock
33007 #: ../src/guestfs.pod:290
33008 msgid ""
33009 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
33010 "file content or size (even files larger than 4 GB)."
33011 msgstr ""
33012
33013 #. type: textblock
33014 #: ../src/guestfs.pod:293
33015 msgid ""
33016 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
33017 msgstr ""
33018
33019 #. type: textblock
33020 #: ../src/guestfs.pod:295
33021 msgid ""
33022 "However the fastest way to upload I<large numbers of arbitrary files> is to "
33023 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
33024 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
33025 "in a predictable way (eg. adding it last after all other drives) then you "
33026 "can get the device name from L</guestfs_list_devices> and mount it directly "
33027 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
33028 "portable between kernel versions, and they don't support labels or UUIDs.  "
33029 "If you want to pre-build an image or you need to mount it using a label or "
33030 "UUID, use an ISO image instead."
33031 msgstr ""
33032
33033 #. type: =head2
33034 #: ../src/guestfs.pod:306
33035 msgid "COPYING"
33036 msgstr "КОПІЮВАННЯ"
33037
33038 #. type: textblock
33039 #: ../src/guestfs.pod:308
33040 msgid ""
33041 "There are various different commands for copying between files and devices "
33042 "and in and out of the guest filesystem.  These are summarised in the table "
33043 "below."
33044 msgstr ""
33045
33046 #. type: =item
33047 #: ../src/guestfs.pod:314
33048 msgid "B<file> to B<file>"
33049 msgstr "B<файл> у B<файл>"
33050
33051 #. type: textblock
33052 #: ../src/guestfs.pod:316
33053 msgid ""
33054 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
33055 "directories recursively."
33056 msgstr ""
33057
33058 #. type: =item
33059 #: ../src/guestfs.pod:319
33060 msgid "B<file or device> to B<file or device>"
33061 msgstr "B<файл або пристрій> у B<файл або пристрій>"
33062
33063 #. type: textblock
33064 #: ../src/guestfs.pod:321
33065 msgid ""
33066 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
33067 "devices in the guest."
33068 msgstr ""
33069
33070 #. type: textblock
33071 #: ../src/guestfs.pod:324
33072 msgid "Example: duplicate the contents of an LV:"
33073 msgstr ""
33074
33075 #. type: verbatim
33076 #: ../src/guestfs.pod:326
33077 #, no-wrap
33078 msgid ""
33079 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
33080 "\n"
33081 msgstr ""
33082 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
33083 "\n"
33084
33085 #. type: textblock
33086 #: ../src/guestfs.pod:328
33087 msgid ""
33088 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
33089 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
33090 "guestfs_copy_size>."
33091 msgstr ""
33092
33093 #. type: =item
33094 #: ../src/guestfs.pod:332
33095 msgid "B<file on the host> to B<file or device>"
33096 msgstr ""
33097
33098 #. type: textblock
33099 #: ../src/guestfs.pod:334
33100 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
33101 msgstr ""
33102
33103 #. type: =item
33104 #: ../src/guestfs.pod:336
33105 msgid "B<file or device> to B<file on the host>"
33106 msgstr ""
33107
33108 #. type: textblock
33109 #: ../src/guestfs.pod:338
33110 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
33111 msgstr ""
33112
33113 #. type: =head2
33114 #: ../src/guestfs.pod:342
33115 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
33116 msgstr ""
33117
33118 #. type: textblock
33119 #: ../src/guestfs.pod:344
33120 msgid ""
33121 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
33122 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
33123 "appears you can only upload and download to files.  However many Un*x-like "
33124 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
33125 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
33126 "and arbitrary file descriptor N."
33127 msgstr ""
33128
33129 #. type: textblock
33130 #: ../src/guestfs.pod:352
33131 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
33132 msgstr ""
33133
33134 #. type: verbatim
33135 #: ../src/guestfs.pod:355
33136 #, no-wrap
33137 msgid ""
33138 " guestfs_download (g, filename, \"/dev/stdout\");\n"
33139 "\n"
33140 msgstr ""
33141 " guestfs_download (g, filename, \"/dev/stdout\");\n"
33142 "\n"
33143
33144 #. type: textblock
33145 #: ../src/guestfs.pod:357
33146 msgid "and you can write tar output to a file descriptor C<fd> by doing:"
33147 msgstr ""
33148
33149 #. type: verbatim
33150 #: ../src/guestfs.pod:359
33151 #, no-wrap
33152 msgid ""
33153 " char devfd[64];\n"
33154 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
33155 " guestfs_tar_out (g, \"/\", devfd);\n"
33156 "\n"
33157 msgstr ""
33158 " char devfd[64];\n"
33159 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
33160 " guestfs_tar_out (g, \"/\", devfd);\n"
33161 "\n"
33162
33163 #. type: =head2
33164 #: ../src/guestfs.pod:363
33165 msgid "LISTING FILES"
33166 msgstr "СПИСКИ ФАЙЛІВ"
33167
33168 #. type: textblock
33169 #: ../src/guestfs.pod:365
33170 msgid ""
33171 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
33172 "L<guestfish(1)>-equivalent command C<ll>)."
33173 msgstr ""
33174
33175 #. type: textblock
33176 #: ../src/guestfs.pod:368
33177 msgid ""
33178 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
33179 "programs, as a flat list of strings."
33180 msgstr ""
33181
33182 #. type: textblock
33183 #: ../src/guestfs.pod:371
33184 msgid ""
33185 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
33186 "directory, plus additional information about each one.  It is more "
33187 "equivalent to using the L<readdir(3)> call on a local filesystem."
33188 msgstr ""
33189
33190 #. type: textblock
33191 #: ../src/guestfs.pod:375
33192 msgid ""
33193 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
33194 msgstr ""
33195
33196 #. type: =head2
33197 #: ../src/guestfs.pod:378
33198 msgid "RUNNING COMMANDS"
33199 msgstr "ВИКОНАННЯ КОМАНД"
33200
33201 #. type: textblock
33202 #: ../src/guestfs.pod:380
33203 msgid ""
33204 "Although libguestfs is primarily an API for manipulating files inside guest "
33205 "images, we also provide some limited facilities for running commands inside "
33206 "guests."
33207 msgstr ""
33208
33209 #. type: textblock
33210 #: ../src/guestfs.pod:384
33211 msgid "There are many limitations to this:"
33212 msgstr ""
33213
33214 #. type: textblock
33215 #: ../src/guestfs.pod:390
33216 msgid ""
33217 "The kernel version that the command runs under will be different from what "
33218 "it expects."
33219 msgstr ""
33220
33221 #. type: textblock
33222 #: ../src/guestfs.pod:395
33223 msgid ""
33224 "If the command needs to communicate with daemons, then most likely they "
33225 "won't be running."
33226 msgstr ""
33227
33228 #. type: textblock
33229 #: ../src/guestfs.pod:400
33230 msgid "The command will be running in limited memory."
33231 msgstr ""
33232
33233 #. type: textblock
33234 #: ../src/guestfs.pod:404
33235 msgid ""
33236 "The network may not be available unless you enable it (see L</"
33237 "guestfs_set_network>)."
33238 msgstr ""
33239
33240 #. type: textblock
33241 #: ../src/guestfs.pod:409
33242 msgid "Only supports Linux guests (not Windows, BSD, etc)."
33243 msgstr ""
33244
33245 #. type: textblock
33246 #: ../src/guestfs.pod:413
33247 msgid ""
33248 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
33249 msgstr ""
33250
33251 #. type: textblock
33252 #: ../src/guestfs.pod:418
33253 msgid ""
33254 "For SELinux guests, you may need to enable SELinux and load policy first.  "
33255 "See L</SELINUX> in this manpage."
33256 msgstr ""
33257
33258 #. type: textblock
33259 #: ../src/guestfs.pod:423
33260 msgid ""
33261 "I<Security:> It is not safe to run commands from untrusted, possibly "
33262 "malicious guests.  These commands may attempt to exploit your program by "
33263 "sending unexpected output.  They could also try to exploit the Linux kernel "
33264 "or qemu provided by the libguestfs appliance.  They could use the network "
33265 "provided by the libguestfs appliance to bypass ordinary network partitions "
33266 "and firewalls.  They could use the elevated privileges or different SELinux "
33267 "context of your program to their advantage."
33268 msgstr ""
33269
33270 #. type: textblock
33271 #: ../src/guestfs.pod:432
33272 msgid ""
33273 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
33274 "(a script which runs when the guest next boots normally), and to have this "
33275 "script run the commands you want in the normal context of the running guest, "
33276 "network security and so on.  For information about other security issues, "
33277 "see L</SECURITY>."
33278 msgstr ""
33279
33280 #. type: textblock
33281 #: ../src/guestfs.pod:440
33282 msgid ""
33283 "The two main API calls to run commands are L</guestfs_command> and L</"
33284 "guestfs_sh> (there are also variations)."
33285 msgstr ""
33286
33287 #. type: textblock
33288 #: ../src/guestfs.pod:443
33289 msgid ""
33290 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
33291 "shell globs, redirections, etc will work."
33292 msgstr ""
33293
33294 #. type: =head2
33295 #: ../src/guestfs.pod:446
33296 msgid "CONFIGURATION FILES"
33297 msgstr "ФАЙЛИ НАЛАШТУВАННЯ"
33298
33299 #. type: textblock
33300 #: ../src/guestfs.pod:448
33301 msgid ""
33302 "To read and write configuration files in Linux guest filesystems, we "
33303 "strongly recommend using Augeas.  For example, Augeas understands how to "
33304 "read and write, say, a Linux shadow password file or X.org configuration "
33305 "file, and so avoids you having to write that code."
33306 msgstr ""
33307
33308 #. type: textblock
33309 #: ../src/guestfs.pod:453
33310 msgid ""
33311 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
33312 "document Augeas itself here because there is excellent documentation on the "
33313 "L<http://augeas.net/> website."
33314 msgstr ""
33315
33316 #. type: textblock
33317 #: ../src/guestfs.pod:457
33318 msgid ""
33319 "If you don't want to use Augeas (you fool!) then try calling L</"
33320 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
33321 "over."
33322 msgstr ""
33323
33324 #. type: =head2
33325 #: ../src/guestfs.pod:461
33326 msgid "SELINUX"
33327 msgstr "SELINUX"
33328
33329 #. type: textblock
33330 #: ../src/guestfs.pod:463
33331 msgid ""
33332 "We support SELinux guests.  To ensure that labeling happens correctly in "
33333 "SELinux guests, you need to enable SELinux and load the guest's policy:"
33334 msgstr ""
33335
33336 #. type: textblock
33337 #: ../src/guestfs.pod:471
33338 msgid "Before launching, do:"
33339 msgstr ""
33340
33341 #. type: verbatim
33342 #: ../src/guestfs.pod:473
33343 #, no-wrap
33344 msgid ""
33345 " guestfs_set_selinux (g, 1);\n"
33346 "\n"
33347 msgstr ""
33348 " guestfs_set_selinux (g, 1);\n"
33349 "\n"
33350
33351 #. type: textblock
33352 #: ../src/guestfs.pod:477
33353 msgid ""
33354 "After mounting the guest's filesystem(s), load the policy.  This is best "
33355 "done by running the L<load_policy(8)> command in the guest itself:"
33356 msgstr ""
33357
33358 #. type: verbatim
33359 #: ../src/guestfs.pod:481
33360 #, no-wrap
33361 msgid ""
33362 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
33363 "\n"
33364 msgstr ""
33365 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
33366 "\n"
33367
33368 #. type: textblock
33369 #: ../src/guestfs.pod:483
33370 msgid ""
33371 "(Older versions of C<load_policy> require you to specify the name of the "
33372 "policy file)."
33373 msgstr ""
33374
33375 #. type: textblock
33376 #: ../src/guestfs.pod:488
33377 msgid ""
33378 "Optionally, set the security context for the API.  The correct security "
33379 "context to use can only be known by inspecting the guest.  As an example:"
33380 msgstr ""
33381
33382 #. type: verbatim
33383 #: ../src/guestfs.pod:492
33384 #, no-wrap
33385 msgid ""
33386 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
33387 "\n"
33388 msgstr ""
33389 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
33390 "\n"
33391
33392 #. type: textblock
33393 #: ../src/guestfs.pod:496
33394 msgid "This will work for running commands and editing existing files."
33395 msgstr ""
33396
33397 #. type: textblock
33398 #: ../src/guestfs.pod:498
33399 msgid ""
33400 "When new files are created, you may need to label them explicitly, for "
33401 "example by running the external command C<restorecon pathname>."
33402 msgstr ""
33403
33404 #. type: =head2
33405 #: ../src/guestfs.pod:502
33406 msgid "UMASK"
33407 msgstr "UMASK"
33408
33409 #. type: textblock
33410 #: ../src/guestfs.pod:504
33411 msgid ""
33412 "Certain calls are affected by the current file mode creation mask (the "
33413 "\"umask\").  In particular ones which create files or directories, such as "
33414 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
33415 "either the default mode that the file is created with or modifies the mode "
33416 "that you supply."
33417 msgstr ""
33418
33419 #. type: textblock
33420 #: ../src/guestfs.pod:510
33421 msgid ""
33422 "The default umask is C<022>, so files are created with modes such as C<0644> "
33423 "and directories with C<0755>."
33424 msgstr ""
33425
33426 #. type: textblock
33427 #: ../src/guestfs.pod:513
33428 msgid ""
33429 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
33430 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
33431 "guestfs_chmod> after creating each file or directory."
33432 msgstr ""
33433
33434 #. type: textblock
33435 #: ../src/guestfs.pod:517
33436 msgid "For more information about umask, see L<umask(2)>."
33437 msgstr ""
33438
33439 #. type: textblock
33440 #: ../src/guestfs.pod:521
33441 msgid ""
33442 "Libguestfs allows you to access Linux guests which have been encrypted using "
33443 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
33444 "standard.  This includes nearly all whole disk encryption systems used by "
33445 "modern Linux guests."
33446 msgstr ""
33447
33448 #. type: textblock
33449 #: ../src/guestfs.pod:527
33450 msgid ""
33451 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
33452 "returns the string C<crypto_LUKS>)."
33453 msgstr ""
33454
33455 #. type: textblock
33456 #: ../src/guestfs.pod:530
33457 msgid ""
33458 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
33459 "will require the passphrase!"
33460 msgstr ""
33461
33462 #. type: textblock
33463 #: ../src/guestfs.pod:533
33464 msgid ""
33465 "Opening a LUKS device creates a new device mapper device called C</dev/"
33466 "mapper/mapname> (where C<mapname> is the string you supply to L</"
33467 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
33468 "from and encrypted to the underlying block device respectively."
33469 msgstr ""
33470
33471 #. type: textblock
33472 #: ../src/guestfs.pod:539
33473 msgid ""
33474 "LVM volume groups on the device can be made visible by calling L</"
33475 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
33476 "(s) can now be mounted in the usual way."
33477 msgstr ""
33478
33479 #. type: textblock
33480 #: ../src/guestfs.pod:543
33481 msgid ""
33482 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
33483 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
33484 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
33485 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
33486 "underlying encrypted block device)."
33487 msgstr ""
33488
33489 #. type: =head2
33490 #: ../src/guestfs.pod:550
33491 msgid "INSPECTION"
33492 msgstr "ПЕРЕВІРКА"
33493
33494 #. type: textblock
33495 #: ../src/guestfs.pod:552
33496 msgid ""
33497 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
33498 "contains operating systems, an install CD or a live CD.  (These APIs used to "
33499 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
33500 "version 1.5.3 the most frequently used part of this library has been "
33501 "rewritten in C and moved into the core code)."
33502 msgstr ""
33503
33504 #. type: textblock
33505 #: ../src/guestfs.pod:559
33506 msgid ""
33507 "Add all disks belonging to the unknown virtual machine and call L</"
33508 "guestfs_launch> in the usual way."
33509 msgstr ""
33510
33511 #. type: textblock
33512 #: ../src/guestfs.pod:562
33513 msgid ""
33514 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
33515 "and certain heuristics, and returns a list of operating systems that were "
33516 "found.  An empty list means none were found.  A single element is the root "
33517 "filesystem of the operating system.  For dual- or multi-boot guests, "
33518 "multiple roots can be returned, each one corresponding to a separate "
33519 "operating system.  (Multi-boot virtual machines are extremely rare in the "
33520 "world of virtualization, but since this scenario can happen, we have built "
33521 "libguestfs to deal with it.)"
33522 msgstr ""
33523
33524 #. type: textblock
33525 #: ../src/guestfs.pod:571
33526 msgid ""
33527 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
33528 "to get additional details about that operating system.  For example, call L</"
33529 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
33530 "Windows and Linux-based operating systems respectively."
33531 msgstr ""
33532
33533 #. type: textblock
33534 #: ../src/guestfs.pod:577
33535 msgid ""
33536 "Un*x-like and Linux-based operating systems usually consist of several "
33537 "filesystems which are mounted at boot time (for example, a separate boot "
33538 "partition mounted on C</boot>).  The inspection rules are able to detect how "
33539 "filesystems correspond to mount points.  Call "
33540 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
33541 "hash table like this example:"
33542 msgstr ""
33543
33544 #. type: verbatim
33545 #: ../src/guestfs.pod:584
33546 #, no-wrap
33547 msgid ""
33548 " /boot => /dev/sda1\n"
33549 " /     => /dev/vg_guest/lv_root\n"
33550 " /usr  => /dev/vg_guest/lv_usr\n"
33551 "\n"
33552 msgstr ""
33553 " /boot => /dev/sda1\n"
33554 " /     => /dev/vg_guest/lv_root\n"
33555 " /usr  => /dev/vg_guest/lv_usr\n"
33556 "\n"
33557
33558 #. type: textblock
33559 #: ../src/guestfs.pod:588
33560 msgid ""
33561 "The caller can then make calls to L</guestfs_mount_options> to mount the "
33562 "filesystems as suggested."
33563 msgstr ""
33564
33565 #. type: textblock
33566 #: ../src/guestfs.pod:591
33567 msgid ""
33568 "Be careful to mount filesystems in the right order (eg. C</> before C</"
33569 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
33570 msgstr ""
33571
33572 #. type: textblock
33573 #: ../src/guestfs.pod:595
33574 msgid ""
33575 "Inspection currently only works for some common operating systems.  "
33576 "Contributors are welcome to send patches for other operating systems that we "
33577 "currently cannot detect."
33578 msgstr ""
33579
33580 #. type: textblock
33581 #: ../src/guestfs.pod:599
33582 msgid ""
33583 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
33584 "for more details.  The L</guestfs_inspect_os> function just ignores any "
33585 "encrypted devices."
33586 msgstr ""
33587
33588 #. type: textblock
33589 #: ../src/guestfs.pod:603
33590 msgid ""
33591 "A note on the implementation: The call L</guestfs_inspect_os> performs "
33592 "inspection and caches the results in the guest handle.  Subsequent calls to "
33593 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
33594 "read the disks.  If you change the content of the guest disks, you can redo "
33595 "inspection by calling L</guestfs_inspect_os> again.  (L</"
33596 "guestfs_inspect_list_applications> works a little differently from the other "
33597 "calls and does read the disks.  See documentation for that function for "
33598 "details)."
33599 msgstr ""
33600
33601 #. type: =head3
33602 #: ../src/guestfs.pod:612
33603 msgid "INSPECTING INSTALL DISKS"
33604 msgstr ""
33605
33606 #. type: textblock
33607 #: ../src/guestfs.pod:614
33608 msgid ""
33609 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
33610 "CDs and more."
33611 msgstr ""
33612
33613 #. type: textblock
33614 #: ../src/guestfs.pod:617
33615 msgid ""
33616 "Call L</guestfs_inspect_get_format> to return the format of the operating "
33617 "system, which currently can be C<installed> (a regular operating system) or "
33618 "C<installer> (some sort of install disk)."
33619 msgstr ""
33620
33621 #. type: textblock
33622 #: ../src/guestfs.pod:621
33623 msgid ""
33624 "Further information is available about the operating system that can be "
33625 "installed using the regular inspection APIs like L</"
33626 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
33627 msgstr ""
33628
33629 #. type: textblock
33630 #: ../src/guestfs.pod:626
33631 msgid ""
33632 "Some additional information specific to installer disks is also available "
33633 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
33634 "guestfs_inspect_is_multipart> calls."
33635 msgstr ""
33636
33637 #. type: =head2
33638 #: ../src/guestfs.pod:631
33639 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
33640 msgstr ""
33641
33642 #. type: textblock
33643 #: ../src/guestfs.pod:633
33644 msgid ""
33645 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
33646 "ntfs-3g.org/> driver."
33647 msgstr ""
33648
33649 #. type: =head3
33650 #: ../src/guestfs.pod:636
33651 msgid "DRIVE LETTERS AND PATHS"
33652 msgstr "ЛІТЕРИ ДИСКІВ ТА ШЛЯХИ"
33653
33654 #. type: textblock
33655 #: ../src/guestfs.pod:638
33656 msgid ""
33657 "DOS and Windows still use drive letters, and the filesystems are always "
33658 "treated as case insensitive by Windows itself, and therefore you might find "
33659 "a Windows configuration file referring to a path like C<c:\\windows"
33660 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
33661 "might be referred to as C</WINDOWS/System32>."
33662 msgstr ""
33663
33664 #. type: textblock
33665 #: ../src/guestfs.pod:644
33666 msgid ""
33667 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
33668 "L</guestfs_inspect_get_drive_mappings>)"
33669 msgstr ""
33670
33671 #. type: textblock
33672 #: ../src/guestfs.pod:647
33673 msgid ""
33674 "Dealing with separator characters (backslash vs forward slash) is outside "
33675 "the scope of libguestfs, but usually a simple character replacement will "
33676 "work."
33677 msgstr ""
33678
33679 #. type: textblock
33680 #: ../src/guestfs.pod:651
33681 msgid ""
33682 "To resolve the case insensitivity of paths, call L</"
33683 "guestfs_case_sensitive_path>."
33684 msgstr ""
33685
33686 #. type: =head3
33687 #: ../src/guestfs.pod:654
33688 msgid "ACCESSING THE WINDOWS REGISTRY"
33689 msgstr "ДОСТУП ДО РЕГІСТРУ WINDOWS"
33690
33691 #. type: textblock
33692 #: ../src/guestfs.pod:656
33693 msgid ""
33694 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
33695 "files, through the library C<hivex> which is part of the libguestfs project "
33696 "although ships as a separate tarball.  You have to locate and download the "
33697 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
33698 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
33699 "reg(1)> for more help on this issue."
33700 msgstr ""
33701
33702 #. type: =head3
33703 #: ../src/guestfs.pod:664
33704 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
33705 msgstr "СИМВОЛІЧНІ ПОСИЛАННЯ У ФАЙЛОВИХ СИСТЕМАХ NTFS-3G"
33706
33707 #. type: textblock
33708 #: ../src/guestfs.pod:666
33709 msgid ""
33710 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
33711 "provide something which looks like a Linux symlink.  The way it tries to do "
33712 "the rewriting is described here:"
33713 msgstr ""
33714
33715 #. type: textblock
33716 #: ../src/guestfs.pod:670
33717 msgid ""
33718 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
33719 "symbolic-links/>"
33720 msgstr ""
33721 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
33722 "symbolic-links/>"
33723
33724 #. type: textblock
33725 #: ../src/guestfs.pod:672
33726 msgid ""
33727 "The essential problem is that ntfs-3g simply does not have enough "
33728 "information to do a correct job.  NTFS links can contain drive letters and "
33729 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
33730 "It is almost certainly the case that libguestfs callers should ignore what "
33731 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
33732 msgstr ""
33733
33734 #. type: textblock
33735 #: ../src/guestfs.pod:679
33736 msgid ""
33737 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
33738 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
33739 "attribute, and read the raw reparse data from that (you can find the format "
33740 "documented in various places around the web)."
33741 msgstr ""
33742
33743 #. type: =head3
33744 #: ../src/guestfs.pod:684
33745 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
33746 msgstr ""
33747
33748 #. type: textblock
33749 #: ../src/guestfs.pod:686
33750 msgid ""
33751 "There are other useful extended attributes that can be read from ntfs-3g "
33752 "filesystems (using L</guestfs_getxattr>).  See:"
33753 msgstr ""
33754
33755 #. type: textblock
33756 #: ../src/guestfs.pod:689
33757 msgid ""
33758 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
33759 msgstr ""
33760 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
33761
33762 #. type: =head2
33763 #: ../src/guestfs.pod:691
33764 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
33765 msgstr "ВИКОРИСТАННЯ LIBGUESTFS ЗА ДОПОМОГОЮ ІНШИХ МОВ ПРОГРАМУВАННЯ"
33766
33767 #. type: textblock
33768 #: ../src/guestfs.pod:693
33769 msgid ""
33770 "Although we don't want to discourage you from using the C API, we will "
33771 "mention here that the same API is also available in other languages."
33772 msgstr ""
33773
33774 #. type: textblock
33775 #: ../src/guestfs.pod:696
33776 msgid ""
33777 "The API is broadly identical in all supported languages.  This means that "
33778 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
33779 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
33780 "OCaml.  In other words, a straightforward, predictable isomorphism between "
33781 "each language."
33782 msgstr ""
33783
33784 #. type: textblock
33785 #: ../src/guestfs.pod:702
33786 msgid ""
33787 "Error messages are automatically transformed into exceptions if the language "
33788 "supports it."
33789 msgstr ""
33790
33791 #. type: textblock
33792 #: ../src/guestfs.pod:705
33793 msgid ""
33794 "We don't try to \"object orientify\" parts of the API in OO languages, "
33795 "although contributors are welcome to write higher level APIs above what we "
33796 "provide in their favourite languages if they wish."
33797 msgstr ""
33798
33799 #. type: =item
33800 #: ../src/guestfs.pod:711
33801 msgid "B<C++>"
33802 msgstr "B<C++>"
33803
33804 #. type: textblock
33805 #: ../src/guestfs.pod:713
33806 msgid ""
33807 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
33808 "identical to the C API.  C++ classes and exceptions are not used."
33809 msgstr ""
33810
33811 #. type: =item
33812 #: ../src/guestfs.pod:717
33813 msgid "B<C#>"
33814 msgstr "B<C#>"
33815
33816 #. type: textblock
33817 #: ../src/guestfs.pod:719
33818 msgid ""
33819 "The C# bindings are highly experimental.  Please read the warnings at the "
33820 "top of C<csharp/Libguestfs.cs>."
33821 msgstr ""
33822
33823 #. type: =item
33824 #: ../src/guestfs.pod:722
33825 msgid "B<Haskell>"
33826 msgstr "B<Haskell>"
33827
33828 #. type: textblock
33829 #: ../src/guestfs.pod:724
33830 msgid ""
33831 "This is the only language binding that is working but incomplete.  Only "
33832 "calls which return simple integers have been bound in Haskell, and we are "
33833 "looking for help to complete this binding."
33834 msgstr ""
33835
33836 #. type: =item
33837 #: ../src/guestfs.pod:728
33838 msgid "B<Java>"
33839 msgstr "B<Java>"
33840
33841 #. type: textblock
33842 #: ../src/guestfs.pod:730
33843 msgid ""
33844 "Full documentation is contained in the Javadoc which is distributed with "
33845 "libguestfs.  For examples, see L<guestfs-java(3)>."
33846 msgstr ""
33847
33848 #. type: =item
33849 #: ../src/guestfs.pod:733
33850 msgid "B<OCaml>"
33851 msgstr "B<OCaml>"
33852
33853 #. type: textblock
33854 #: ../src/guestfs.pod:735
33855 msgid "See L<guestfs-ocaml(3)>."
33856 msgstr "Див. L<guestfs-ocaml(3)>."
33857
33858 #. type: =item
33859 #: ../src/guestfs.pod:737
33860 msgid "B<Perl>"
33861 msgstr "B<Perl>"
33862
33863 #. type: textblock
33864 #: ../src/guestfs.pod:739
33865 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
33866 msgstr "Див. L<guestfs-perl(3)> та L<Sys::Guestfs(3)>."
33867
33868 #. type: =item
33869 #: ../src/guestfs.pod:741
33870 msgid "B<PHP>"
33871 msgstr "B<PHP>"
33872
33873 #. type: textblock
33874 #: ../src/guestfs.pod:743
33875 msgid ""
33876 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
33877 "the php-libguestfs package for your distribution."
33878 msgstr ""
33879
33880 #. type: textblock
33881 #: ../src/guestfs.pod:746
33882 msgid "The PHP binding only works correctly on 64 bit machines."
33883 msgstr ""
33884
33885 #. type: =item
33886 #: ../src/guestfs.pod:748
33887 msgid "B<Python>"
33888 msgstr "B<Python>"
33889
33890 #. type: textblock
33891 #: ../src/guestfs.pod:750
33892 msgid "See L<guestfs-python(3)>."
33893 msgstr "Див. L<guestfs-python(3)>."
33894
33895 #. type: =item
33896 #: ../src/guestfs.pod:752
33897 msgid "B<Ruby>"
33898 msgstr "B<Ruby>"
33899
33900 #. type: textblock
33901 #: ../src/guestfs.pod:754
33902 msgid "See L<guestfs-ruby(3)>."
33903 msgstr "Див. L<guestfs-ruby(3)>."
33904
33905 #. type: =item
33906 #: ../src/guestfs.pod:756
33907 msgid "B<shell scripts>"
33908 msgstr "B<скрипти оболонки>"
33909
33910 #. type: textblock
33911 #: ../src/guestfs.pod:758
33912 msgid "See L<guestfish(1)>."
33913 msgstr "Див. L<guestfish(1)>."
33914
33915 #. type: =head2
33916 #: ../src/guestfs.pod:762
33917 msgid "LIBGUESTFS GOTCHAS"
33918 msgstr ""
33919
33920 #. type: textblock
33921 #: ../src/guestfs.pod:764
33922 msgid ""
33923 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
33924 "system [...] that works in the way it is documented but is counterintuitive "
33925 "and almost invites mistakes.\""
33926 msgstr ""
33927
33928 #. type: textblock
33929 #: ../src/guestfs.pod:768
33930 msgid ""
33931 "Since we developed libguestfs and the associated tools, there are several "
33932 "things we would have designed differently, but are now stuck with for "
33933 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
33934 "release, you can expect these to change.  Beware of them."
33935 msgstr ""
33936
33937 #. type: =item
33938 #: ../src/guestfs.pod:776
33939 msgid "Autosync / forgetting to sync."
33940 msgstr ""
33941
33942 #. type: textblock
33943 #: ../src/guestfs.pod:778
33944 msgid ""
33945 "I<Update:> Autosync is enabled by default for all API users starting from "
33946 "libguestfs 1.5.24.  This section only applies to older versions."
33947 msgstr ""
33948
33949 #. type: textblock
33950 #: ../src/guestfs.pod:781
33951 msgid ""
33952 "When modifying a filesystem from C or another language, you B<must> unmount "
33953 "all filesystems and call L</guestfs_sync> explicitly before you close the "
33954 "libguestfs handle.  You can also call:"
33955 msgstr ""
33956
33957 #. type: verbatim
33958 #: ../src/guestfs.pod:785
33959 #, no-wrap
33960 msgid ""
33961 " guestfs_set_autosync (g, 1);\n"
33962 "\n"
33963 msgstr ""
33964 " guestfs_set_autosync (g, 1);\n"
33965 "\n"
33966
33967 #. type: textblock
33968 #: ../src/guestfs.pod:787
33969 msgid ""
33970 "to have the unmount/sync done automatically for you when the handle 'g' is "
33971 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
33972 msgstr ""
33973
33974 #. type: textblock
33975 #: ../src/guestfs.pod:791
33976 msgid ""
33977 "If you forget to do this, then it is entirely possible that your changes "
33978 "won't be written out, or will be partially written, or (very rarely) that "
33979 "you'll get disk corruption."
33980 msgstr ""
33981
33982 #. type: textblock
33983 #: ../src/guestfs.pod:795
33984 msgid ""
33985 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
33986 "guestfish scripts that forget to sync will work just fine, which can make "
33987 "this very puzzling if you are trying to debug a problem."
33988 msgstr ""
33989
33990 #. type: =item
33991 #: ../src/guestfs.pod:799
33992 msgid "Mount option C<-o sync> should not be the default."
33993 msgstr ""
33994
33995 #. type: textblock
33996 #: ../src/guestfs.pod:801
33997 msgid ""
33998 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
33999 "However C<-o sync> does not add any reliability benefit, but does have a "
34000 "very large performance impact."
34001 msgstr ""
34002
34003 #. type: textblock
34004 #: ../src/guestfs.pod:805
34005 msgid ""
34006 "The work around is to use L</guestfs_mount_options> and set the mount "
34007 "options that you actually want to use."
34008 msgstr ""
34009
34010 #. type: =item
34011 #: ../src/guestfs.pod:808
34012 msgid "Read-only should be the default."
34013 msgstr ""
34014
34015 #. type: textblock
34016 #: ../src/guestfs.pod:810
34017 msgid ""
34018 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
34019 "specify I<--rw> if you want to make changes to the image."
34020 msgstr ""
34021
34022 #. type: textblock
34023 #: ../src/guestfs.pod:813
34024 msgid "This would reduce the potential to corrupt live VM images."
34025 msgstr ""
34026
34027 #. type: textblock
34028 #: ../src/guestfs.pod:815
34029 msgid ""
34030 "Note that many filesystems change the disk when you just mount and unmount, "
34031 "even if you didn't perform any writes.  You need to use L</"
34032 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
34033 msgstr ""
34034
34035 #. type: =item
34036 #: ../src/guestfs.pod:819
34037 msgid "guestfish command line is hard to use."
34038 msgstr ""
34039
34040 #. type: textblock
34041 #: ../src/guestfs.pod:821
34042 msgid ""
34043 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
34044 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
34045 "exist, so it fails.  In earlier versions of guestfish the error message was "
34046 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
34047 "we should have used C<guestfish -c command> to run commands."
34048 msgstr ""
34049
34050 #. type: =item
34051 #: ../src/guestfs.pod:828
34052 msgid "guestfish megabyte modifiers don't work right on all commands"
34053 msgstr ""
34054
34055 #. type: textblock
34056 #: ../src/guestfs.pod:830
34057 msgid ""
34058 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
34059 "other modifiers).  What guestfish actually does is to multiply the number "
34060 "part by the modifier part and pass the result to the C API.  However this "
34061 "doesn't work for a few APIs which aren't expecting bytes, but are already "
34062 "expecting some other unit (eg. megabytes)."
34063 msgstr ""
34064
34065 #. type: textblock
34066 #: ../src/guestfs.pod:837
34067 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
34068 msgstr ""
34069
34070 #. type: verbatim
34071 #: ../src/guestfs.pod:839
34072 #, no-wrap
34073 msgid ""
34074 " lvcreate LV VG 100M\n"
34075 "\n"
34076 msgstr ""
34077 " lvcreate LV VG 100M\n"
34078 "\n"
34079
34080 #. type: textblock
34081 #: ../src/guestfs.pod:841
34082 msgid ""
34083 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
34084 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
34085 "megabytes * megabytes) logical volume.  The error message you get from this "
34086 "is also a little obscure."
34087 msgstr ""
34088
34089 #. type: textblock
34090 #: ../src/guestfs.pod:846
34091 msgid ""
34092 "This could be fixed in the generator by specially marking parameters and "
34093 "return values which take bytes or other units."
34094 msgstr ""
34095
34096 #. type: =item
34097 #: ../src/guestfs.pod:849
34098 msgid "Ambiguity between devices and paths"
34099 msgstr ""
34100
34101 #. type: textblock
34102 #: ../src/guestfs.pod:851
34103 msgid ""
34104 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
34105 "sdb2>) and a similar pathname.  A file might just happen to be called "
34106 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
34107 msgstr ""
34108
34109 #. type: textblock
34110 #: ../src/guestfs.pod:856
34111 msgid ""
34112 "In the current API we usually resolve this ambiguity by having two separate "
34113 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
34114 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
34115 "detecting if the path supplied begins with C</dev/>."
34116 msgstr ""
34117
34118 #. type: textblock
34119 #: ../src/guestfs.pod:862
34120 msgid ""
34121 "To avoid both the ambiguity and the need to duplicate some calls, we could "
34122 "make paths/devices into structured names.  One way to do this would be to "
34123 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
34124 "aspect of grub.  Another way would be to use a structured type, equivalent "
34125 "to this OCaml type:"
34126 msgstr ""
34127
34128 #. type: verbatim
34129 #: ../src/guestfs.pod:868
34130 #, no-wrap
34131 msgid ""
34132 " type path = Path of string | Device of int | Partition of int * int\n"
34133 "\n"
34134 msgstr ""
34135
34136 #. type: textblock
34137 #: ../src/guestfs.pod:870
34138 msgid "which would allow you to pass arguments like:"
34139 msgstr ""
34140
34141 #. type: verbatim
34142 #: ../src/guestfs.pod:872
34143 #, no-wrap
34144 msgid ""
34145 " Path \"/foo/bar\"\n"
34146 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
34147 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
34148 " Path \"/dev/sdb2\"    (* not a device *)\n"
34149 "\n"
34150 msgstr ""
34151
34152 #. type: textblock
34153 #: ../src/guestfs.pod:877
34154 msgid ""
34155 "As you can see there are still problems to resolve even with this "
34156 "representation.  Also consider how it might work in guestfish."
34157 msgstr ""
34158
34159 #. type: =head2
34160 #: ../src/guestfs.pod:882
34161 msgid "KEYS AND PASSPHRASES"
34162 msgstr "КЛЮЧІ І ПАРОЛІ"
34163
34164 #. type: textblock
34165 #: ../src/guestfs.pod:884
34166 msgid ""
34167 "Certain libguestfs calls take a parameter that contains sensitive key "
34168 "material, passed in as a C string."
34169 msgstr ""
34170
34171 #. type: textblock
34172 #: ../src/guestfs.pod:887
34173 msgid ""
34174 "In the future we would hope to change the libguestfs implementation so that "
34175 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
34176 "swap.  However this is I<not> done at the moment, because of the complexity "
34177 "of such an implementation."
34178 msgstr ""
34179
34180 #. type: textblock
34181 #: ../src/guestfs.pod:892
34182 msgid ""
34183 "Therefore you should be aware that any key parameter you pass to libguestfs "
34184 "might end up being written out to the swap partition.  If this is a concern, "
34185 "scrub the swap partition or don't use libguestfs on encrypted devices."
34186 msgstr ""
34187
34188 #. type: =head2
34189 #: ../src/guestfs.pod:897
34190 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
34191 msgstr ""
34192
34193 #. type: textblock
34194 #: ../src/guestfs.pod:899
34195 msgid ""
34196 "All high-level libguestfs actions are synchronous.  If you want to use "
34197 "libguestfs asynchronously then you must create a thread."
34198 msgstr ""
34199
34200 #. type: textblock
34201 #: ../src/guestfs.pod:902
34202 msgid ""
34203 "Only use the handle from a single thread.  Either use the handle exclusively "
34204 "from one thread, or provide your own mutex so that two threads cannot issue "
34205 "calls on the same handle at the same time."
34206 msgstr ""
34207
34208 #. type: textblock
34209 #: ../src/guestfs.pod:906
34210 msgid ""
34211 "See the graphical program guestfs-browser for one possible architecture for "
34212 "multithreaded programs using libvirt and libguestfs."
34213 msgstr ""
34214
34215 #. type: =head2
34216 #: ../src/guestfs.pod:909
34217 msgid "PATH"
34218 msgstr "ШЛЯХ"
34219
34220 #. type: textblock
34221 #: ../src/guestfs.pod:911
34222 msgid ""
34223 "Libguestfs needs a supermin appliance, which it finds by looking along an "
34224 "internal path."
34225 msgstr ""
34226
34227 #. type: textblock
34228 #: ../src/guestfs.pod:914
34229 msgid ""
34230 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
34231 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
34232 msgstr ""
34233
34234 #. type: textblock
34235 #: ../src/guestfs.pod:917
34236 msgid ""
34237 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
34238 "to change the directories that libguestfs will search in.  The value is a "
34239 "colon-separated list of paths.  The current directory is I<not> searched "
34240 "unless the path contains an empty element or C<.>.  For example "
34241 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
34242 "then C</usr/lib/guestfs>."
34243 msgstr ""
34244
34245 #. type: =head2
34246 #: ../src/guestfs.pod:924
34247 msgid "QEMU WRAPPERS"
34248 msgstr ""
34249
34250 #. type: textblock
34251 #: ../src/guestfs.pod:926
34252 msgid ""
34253 "If you want to compile your own qemu, run qemu from a non-standard location, "
34254 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
34255 "around qemu."
34256 msgstr ""
34257
34258 #. type: textblock
34259 #: ../src/guestfs.pod:930
34260 msgid ""
34261 "There is one important rule to remember: you I<must C<exec qemu>> as the "
34262 "last command in the shell script (so that qemu replaces the shell and "
34263 "becomes the direct child of the libguestfs-using program).  If you don't do "
34264 "this, then the qemu process won't be cleaned up correctly."
34265 msgstr ""
34266
34267 #. type: textblock
34268 #: ../src/guestfs.pod:935
34269 msgid ""
34270 "Here is an example of a wrapper, where I have built my own copy of qemu from "
34271 "source:"
34272 msgstr ""
34273
34274 #. type: verbatim
34275 #: ../src/guestfs.pod:938
34276 #, no-wrap
34277 msgid ""
34278 " #!/bin/sh -\n"
34279 " qemudir=/home/rjones/d/qemu\n"
34280 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
34281 "\n"
34282 msgstr ""
34283 " #!/bin/sh -\n"
34284 " qemudir=/home/rjones/d/qemu\n"
34285 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
34286 "\n"
34287
34288 #. type: textblock
34289 #: ../src/guestfs.pod:942
34290 msgid ""
34291 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
34292 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
34293 "example:"
34294 msgstr ""
34295
34296 #. type: verbatim
34297 #: ../src/guestfs.pod:946
34298 #, no-wrap
34299 msgid ""
34300 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
34301 "\n"
34302 msgstr ""
34303 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
34304 "\n"
34305
34306 #. type: textblock
34307 #: ../src/guestfs.pod:948
34308 msgid ""
34309 "Note that libguestfs also calls qemu with the -help and -version options in "
34310 "order to determine features."
34311 msgstr ""
34312
34313 #. type: =head2
34314 #: ../src/guestfs.pod:951
34315 msgid "ATTACHING TO RUNNING DAEMONS"
34316 msgstr "ДОЛУЧЕННЯ ДО ЗАПУЩЕНИХ ФОНОВИХ СЛУЖБ"
34317
34318 #. type: textblock
34319 #: ../src/guestfs.pod:953
34320 msgid ""
34321 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
34322 "babies.  Use with caution."
34323 msgstr ""
34324
34325 #. type: textblock
34326 #: ../src/guestfs.pod:956
34327 msgid ""
34328 "I<Note (2):> This section explains how to attach to a running daemon from a "
34329 "low level perspective.  For most users, simply using virt tools such as "
34330 "L<guestfish(1)> with the I<--live> option will \"just work\"."
34331 msgstr ""
34332
34333 #. type: =head3
34334 #: ../src/guestfs.pod:960
34335 msgid "Using guestfs_set_attach_method"
34336 msgstr "За допомогою guestfs_set_attach_method"
34337
34338 #. type: textblock
34339 #: ../src/guestfs.pod:962
34340 msgid ""
34341 "By calling L</guestfs_set_attach_method> you can change how the library "
34342 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
34343 "ARCHITECTURE> for some background)."
34344 msgstr ""
34345
34346 #. type: textblock
34347 #: ../src/guestfs.pod:966
34348 msgid ""
34349 "The normal attach method is C<appliance>, where a small appliance is created "
34350 "containing the daemon, and then the library connects to this."
34351 msgstr ""
34352
34353 #. type: textblock
34354 #: ../src/guestfs.pod:969
34355 msgid ""
34356 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
34357 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
34358 "daemon over the Unix domain socket."
34359 msgstr ""
34360
34361 #. type: textblock
34362 #: ../src/guestfs.pod:973
34363 msgid ""
34364 "The normal use for this is to connect to a running virtual machine that "
34365 "contains a C<guestfsd> daemon, and send commands so you can read and write "
34366 "files inside the live virtual machine."
34367 msgstr ""
34368
34369 #. type: =head3
34370 #: ../src/guestfs.pod:977
34371 msgid "Using guestfs_add_domain with live flag"
34372 msgstr "За допомогою guestfs_add_domain з прапорцем live"
34373
34374 #. type: textblock
34375 #: ../src/guestfs.pod:979
34376 msgid ""
34377 "L</guestfs_add_domain> provides some help for getting the correct attach "
34378 "method.  If you pass the C<live> option to this function, then (if the "
34379 "virtual machine is running) it will examine the libvirt XML looking for a "
34380 "virtio-serial channel to connect to:"
34381 msgstr ""
34382
34383 #. type: verbatim
34384 #: ../src/guestfs.pod:985
34385 #, no-wrap
34386 msgid ""
34387 " <domain>\n"
34388 "   ...\n"
34389 "   <devices>\n"
34390 "     ...\n"
34391 "     <channel type='unix'>\n"
34392 "       <source mode='bind' path='/path/to/socket'/>\n"
34393 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
34394 "     </channel>\n"
34395 "     ...\n"
34396 "   </devices>\n"
34397 " </domain>\n"
34398 "\n"
34399 msgstr ""
34400 " <domain>\n"
34401 "   ...\n"
34402 "   <devices>\n"
34403 "     ...\n"
34404 "     <channel type='unix'>\n"
34405 "       <source mode='bind' path='/path/to/socket'/>\n"
34406 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
34407 "     </channel>\n"
34408 "     ...\n"
34409 "   </devices>\n"
34410 " </domain>\n"
34411 "\n"
34412
34413 #. type: textblock
34414 #: ../src/guestfs.pod:997
34415 msgid ""
34416 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
34417 "method to C<unix:/path/to/socket>."
34418 msgstr ""
34419
34420 #. type: textblock
34421 #: ../src/guestfs.pod:1000
34422 msgid ""
34423 "Some of the libguestfs tools (including guestfish) support a I<--live> "
34424 "option which is passed through to L</guestfs_add_domain> thus allowing you "
34425 "to attach to and modify live virtual machines."
34426 msgstr ""
34427
34428 #. type: textblock
34429 #: ../src/guestfs.pod:1004
34430 msgid ""
34431 "The virtual machine needs to have been set up beforehand so that it has the "
34432 "virtio-serial channel and so that guestfsd is running inside it."
34433 msgstr ""
34434
34435 #. type: =head2
34436 #: ../src/guestfs.pod:1008
34437 msgid "ABI GUARANTEE"
34438 msgstr "ГАРАНТІЯ ЩОДО ABI"
34439
34440 #. type: textblock
34441 #: ../src/guestfs.pod:1010
34442 msgid ""
34443 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
34444 "actions as outlined in this section.  Although we will deprecate some "
34445 "actions, for example if they get replaced by newer calls, we will keep the "
34446 "old actions forever.  This allows you the developer to program in confidence "
34447 "against the libguestfs API."
34448 msgstr ""
34449
34450 #. type: =head2
34451 #: ../src/guestfs.pod:1016
34452 msgid "BLOCK DEVICE NAMING"
34453 msgstr "ІМЕНУВАННЯ БЛОКОВИХ ПРИСТРОЇВ"
34454
34455 #. type: textblock
34456 #: ../src/guestfs.pod:1018
34457 msgid ""
34458 "In the kernel there is now quite a profusion of schemata for naming block "
34459 "devices (in this context, by I<block device> I mean a physical or virtual "
34460 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
34461 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
34462 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
34463 "for the old IDE driver (particularly for SATA devices) those devices also "
34464 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
34465 "paravirtualized drivers.  This has created several different naming systems, "
34466 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
34467 msgstr ""
34468
34469 #. type: textblock
34470 #: ../src/guestfs.pod:1030
34471 msgid ""
34472 "As discussed above, libguestfs uses a qemu appliance running an embedded "
34473 "Linux kernel to access block devices.  We can run a variety of appliances "
34474 "based on a variety of Linux kernels."
34475 msgstr ""
34476
34477 #. type: textblock
34478 #: ../src/guestfs.pod:1034
34479 msgid ""
34480 "This causes a problem for libguestfs because many API calls use device or "
34481 "partition names.  Working scripts and the recipe (example) scripts that we "
34482 "make available over the internet could fail if the naming scheme changes."
34483 msgstr ""
34484
34485 #. type: textblock
34486 #: ../src/guestfs.pod:1039
34487 msgid ""
34488 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
34489 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
34490 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
34491 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
34492 msgstr ""
34493
34494 #. type: textblock
34495 #: ../src/guestfs.pod:1045
34496 msgid ""
34497 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
34498 "L</guestfs_list_partitions> and similar calls return the true names of the "
34499 "devices and partitions as known to the appliance."
34500 msgstr ""
34501
34502 #. type: =head3
34503 #: ../src/guestfs.pod:1050
34504 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
34505 msgstr ""
34506
34507 #. type: textblock
34508 #: ../src/guestfs.pod:1052
34509 msgid ""
34510 "Usually this translation is transparent.  However in some (very rare)  cases "
34511 "you may need to know the exact algorithm.  Such cases include where you use "
34512 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
34513 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
34514 msgstr ""
34515
34516 #. type: textblock
34517 #: ../src/guestfs.pod:1058
34518 msgid ""
34519 "The algorithm is applied only to I<parameters> which are known to be either "
34520 "device or partition names.  Return values from functions such as L</"
34521 "guestfs_list_devices> are never changed."
34522 msgstr ""
34523
34524 #. type: textblock
34525 #: ../src/guestfs.pod:1066
34526 msgid "Is the string a parameter which is a device or partition name?"
34527 msgstr ""
34528
34529 #. type: textblock
34530 #: ../src/guestfs.pod:1070
34531 msgid "Does the string begin with C</dev/sd>?"
34532 msgstr "Чи починається рядок з C</dev/sd>?"
34533
34534 #. type: textblock
34535 #: ../src/guestfs.pod:1074
34536 msgid ""
34537 "Does the named device exist? If so, we use that device.  However if I<not> "
34538 "then we continue with this algorithm."
34539 msgstr ""
34540
34541 #. type: textblock
34542 #: ../src/guestfs.pod:1079
34543 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
34544 msgstr ""
34545
34546 #. type: textblock
34547 #: ../src/guestfs.pod:1081
34548 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
34549 msgstr ""
34550
34551 #. type: textblock
34552 #: ../src/guestfs.pod:1083
34553 msgid "If that named device exists, use it.  If not, continue."
34554 msgstr ""
34555
34556 #. type: textblock
34557 #: ../src/guestfs.pod:1087
34558 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
34559 msgstr ""
34560
34561 #. type: textblock
34562 #: ../src/guestfs.pod:1089
34563 msgid "If that named device exists, use it.  If not, return an error."
34564 msgstr ""
34565
34566 #. type: =head3
34567 #: ../src/guestfs.pod:1093
34568 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
34569 msgstr ""
34570
34571 #. type: textblock
34572 #: ../src/guestfs.pod:1095
34573 msgid ""
34574 "Although the standard naming scheme and automatic translation is useful for "
34575 "simple programs and guestfish scripts, for larger programs it is best not to "
34576 "rely on this mechanism."
34577 msgstr ""
34578
34579 #. type: textblock
34580 #: ../src/guestfs.pod:1099
34581 msgid ""
34582 "Where possible for maximum future portability programs using libguestfs "
34583 "should use these future-proof techniques:"
34584 msgstr ""
34585
34586 #. type: textblock
34587 #: ../src/guestfs.pod:1106
34588 msgid ""
34589 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
34590 "device names, and then use those names directly."
34591 msgstr ""
34592
34593 #. type: textblock
34594 #: ../src/guestfs.pod:1109
34595 msgid ""
34596 "Since those device names exist by definition, they will never be translated."
34597 msgstr ""
34598
34599 #. type: textblock
34600 #: ../src/guestfs.pod:1114
34601 msgid ""
34602 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
34603 "filesystem labels."
34604 msgstr ""
34605
34606 #. type: =head1
34607 #: ../src/guestfs.pod:1119
34608 msgid "SECURITY"
34609 msgstr "БЕЗПЕКА"
34610
34611 #. type: textblock
34612 #: ../src/guestfs.pod:1121
34613 msgid ""
34614 "This section discusses security implications of using libguestfs, "
34615 "particularly with untrusted or malicious guests or disk images."
34616 msgstr ""
34617
34618 #. type: =head2
34619 #: ../src/guestfs.pod:1124
34620 msgid "GENERAL SECURITY CONSIDERATIONS"
34621 msgstr "ЗАГАЛЬНІ ЗАУВАЖЕННЯ ЩОДО ЗАХИСТУ"
34622
34623 #. type: textblock
34624 #: ../src/guestfs.pod:1126
34625 msgid ""
34626 "Be careful with any files or data that you download from a guest (by "
34627 "\"download\" we mean not just the L</guestfs_download> command but any "
34628 "command that reads files, filenames, directories or anything else from a "
34629 "disk image).  An attacker could manipulate the data to fool your program "
34630 "into doing the wrong thing.  Consider cases such as:"
34631 msgstr ""
34632
34633 #. type: textblock
34634 #: ../src/guestfs.pod:1136
34635 msgid "the data (file etc) not being present"
34636 msgstr ""
34637
34638 #. type: textblock
34639 #: ../src/guestfs.pod:1140
34640 msgid "being present but empty"
34641 msgstr ""
34642
34643 #. type: textblock
34644 #: ../src/guestfs.pod:1144
34645 msgid "being much larger than normal"
34646 msgstr ""
34647
34648 #. type: textblock
34649 #: ../src/guestfs.pod:1148
34650 msgid "containing arbitrary 8 bit data"
34651 msgstr ""
34652
34653 #. type: textblock
34654 #: ../src/guestfs.pod:1152
34655 msgid "being in an unexpected character encoding"
34656 msgstr ""
34657
34658 #. type: textblock
34659 #: ../src/guestfs.pod:1156
34660 msgid "containing homoglyphs."
34661 msgstr ""
34662
34663 #. type: =head2
34664 #: ../src/guestfs.pod:1160
34665 msgid "SECURITY OF MOUNTING FILESYSTEMS"
34666 msgstr "ЗАХИСТ ФАЙЛОВИХ СИСТЕМ МОНТУВАННЯ"
34667
34668 #. type: textblock
34669 #: ../src/guestfs.pod:1162
34670 msgid ""
34671 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
34672 "(VFS) module can sometimes be escalated into exploits by deliberately "
34673 "creating a malicious, malformed filesystem.  These exploits are very severe "
34674 "for two reasons.  Firstly there are very many filesystem drivers in the "
34675 "kernel, and many of them are infrequently used and not much developer "
34676 "attention has been paid to the code.  Linux userspace helps potential "
34677 "crackers by detecting the filesystem type and automatically choosing the "
34678 "right VFS driver, even if that filesystem type is obscure or unexpected for "
34679 "the administrator.  Secondly, a kernel-level exploit is like a local root "
34680 "exploit (worse in some ways), giving immediate and total access to the "
34681 "system right down to the hardware level."
34682 msgstr ""
34683
34684 #. type: textblock
34685 #: ../src/guestfs.pod:1175
34686 msgid ""
34687 "That explains why you should never mount a filesystem from an untrusted "
34688 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
34689 "inside a qemu virtual machine, usually running as a non-root user.  The "
34690 "attacker would need to write a filesystem which first exploited the kernel, "
34691 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
34692 "the libguestfs protocol, and finally to be as serious as the host kernel "
34693 "exploit it would need to escalate its privileges to root.  This multi-step "
34694 "escalation, performed by a static piece of data, is thought to be extremely "
34695 "hard to do, although we never say 'never' about security issues."
34696 msgstr ""
34697
34698 #. type: textblock
34699 #: ../src/guestfs.pod:1186
34700 msgid ""
34701 "In any case callers can reduce the attack surface by forcing the filesystem "
34702 "type when mounting (use L</guestfs_mount_vfs>)."
34703 msgstr ""
34704
34705 #. type: =head2
34706 #: ../src/guestfs.pod:1189
34707 msgid "PROTOCOL SECURITY"
34708 msgstr "ЗАХИСТ ПРОТОКОЛУ"
34709
34710 #. type: textblock
34711 #: ../src/guestfs.pod:1191
34712 msgid ""
34713 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
34714 "defined upper message size.  However a program that uses libguestfs must "
34715 "also take care - for example you can write a program that downloads a binary "
34716 "from a disk image and executes it locally, and no amount of protocol "
34717 "security will save you from the consequences."
34718 msgstr ""
34719
34720 #. type: =head2
34721 #: ../src/guestfs.pod:1197
34722 msgid "INSPECTION SECURITY"
34723 msgstr ""
34724
34725 #. type: textblock
34726 #: ../src/guestfs.pod:1199
34727 msgid ""
34728 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
34729 "directly from the guest, and these could contain any 8 bit data.  Callers "
34730 "should be careful to escape these before printing them to a structured file "
34731 "(for example, use HTML escaping if creating a web page)."
34732 msgstr ""
34733
34734 #. type: textblock
34735 #: ../src/guestfs.pod:1205
34736 msgid ""
34737 "Guest configuration may be altered in unusual ways by the administrator of "
34738 "the virtual machine, and may not reflect reality (particularly for untrusted "
34739 "or actively malicious guests).  For example we parse the hostname from "
34740 "configuration files like C</etc/sysconfig/network> that we find in the "
34741 "guest, but the guest administrator can easily manipulate these files to "
34742 "provide the wrong hostname."
34743 msgstr ""
34744
34745 #. type: textblock
34746 #: ../src/guestfs.pod:1213
34747 msgid ""
34748 "The inspection API parses guest configuration using two external libraries: "
34749 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
34750 "designed to be robust in the face of malicious data, although denial of "
34751 "service attacks are still possible, for example with oversized configuration "
34752 "files."
34753 msgstr ""
34754
34755 #. type: =head2
34756 #: ../src/guestfs.pod:1219
34757 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
34758 msgstr "ЗАПУСК НЕЗАХИЩЕНИХ КОМАНД ГОСТЬОВОЇ СИСТЕМИ"
34759
34760 #. type: textblock
34761 #: ../src/guestfs.pod:1221
34762 msgid ""
34763 "Be very cautious about running commands from the guest.  By running a "
34764 "command in the guest, you are giving CPU time to a binary that you do not "
34765 "control, under the same user account as the library, albeit wrapped in qemu "
34766 "virtualization.  More information and alternatives can be found in the "
34767 "section L</RUNNING COMMANDS>."
34768 msgstr ""
34769
34770 #. type: =head2
34771 #: ../src/guestfs.pod:1227
34772 msgid "CVE-2010-3851"
34773 msgstr "CVE-2010-3851"
34774
34775 #. type: textblock
34776 #: ../src/guestfs.pod:1229
34777 msgid "https://bugzilla.redhat.com/642934"
34778 msgstr "https://bugzilla.redhat.com/642934"
34779
34780 #. type: textblock
34781 #: ../src/guestfs.pod:1231
34782 msgid ""
34783 "This security bug concerns the automatic disk format detection that qemu "
34784 "does on disk images."
34785 msgstr ""
34786
34787 #. type: textblock
34788 #: ../src/guestfs.pod:1234
34789 msgid ""
34790 "A raw disk image is just the raw bytes, there is no header.  Other disk "
34791 "images like qcow2 contain a special header.  Qemu deals with this by looking "
34792 "for one of the known headers, and if none is found then assuming the disk "
34793 "image must be raw."
34794 msgstr ""
34795
34796 #. type: textblock
34797 #: ../src/guestfs.pod:1239
34798 msgid ""
34799 "This allows a guest which has been given a raw disk image to write some "
34800 "other header.  At next boot (or when the disk image is accessed by "
34801 "libguestfs) qemu would do autodetection and think the disk image format was, "
34802 "say, qcow2 based on the header written by the guest."
34803 msgstr ""
34804
34805 #. type: textblock
34806 #: ../src/guestfs.pod:1244
34807 msgid ""
34808 "This in itself would not be a problem, but qcow2 offers many features, one "
34809 "of which is to allow a disk image to refer to another image (called the "
34810 "\"backing disk\").  It does this by placing the path to the backing disk "
34811 "into the qcow2 header.  This path is not validated and could point to any "
34812 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
34813 "\"holes\" in the qcow2 disk image, which of course is completely under the "
34814 "control of the attacker."
34815 msgstr ""
34816
34817 #. type: textblock
34818 #: ../src/guestfs.pod:1252
34819 msgid ""
34820 "In libguestfs this is rather hard to exploit except under two circumstances:"
34821 msgstr ""
34822
34823 #. type: textblock
34824 #: ../src/guestfs.pod:1259
34825 msgid "You have enabled the network or have opened the disk in write mode."
34826 msgstr ""
34827
34828 #. type: textblock
34829 #: ../src/guestfs.pod:1263
34830 msgid ""
34831 "You are also running untrusted code from the guest (see L</RUNNING "
34832 "COMMANDS>)."
34833 msgstr ""
34834
34835 #. type: textblock
34836 #: ../src/guestfs.pod:1268
34837 msgid ""
34838 "The way to avoid this is to specify the expected disk format when adding "
34839 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
34840 "should always do this if the disk is raw format, and it's a good idea for "
34841 "other cases too."
34842 msgstr ""
34843
34844 #. type: textblock
34845 #: ../src/guestfs.pod:1273
34846 msgid ""
34847 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
34848 "format is fetched from libvirt and passed through."
34849 msgstr ""
34850
34851 #. type: textblock
34852 #: ../src/guestfs.pod:1276
34853 msgid ""
34854 "For libguestfs tools, use the I<--format> command line parameter as "
34855 "appropriate."
34856 msgstr ""
34857
34858 #. type: =head1
34859 #: ../src/guestfs.pod:1279
34860 msgid "CONNECTION MANAGEMENT"
34861 msgstr "КЕРУВАННЯ З’ЄДНАННЯМ"
34862
34863 #. type: =head2
34864 #: ../src/guestfs.pod:1281
34865 msgid "guestfs_h *"
34866 msgstr "guestfs_h *"
34867
34868 #. type: textblock
34869 #: ../src/guestfs.pod:1283
34870 msgid ""
34871 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
34872 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
34873 "handle and release all resources used."
34874 msgstr ""
34875
34876 #. type: textblock
34877 #: ../src/guestfs.pod:1287
34878 msgid ""
34879 "For information on using multiple handles and threads, see the section L</"
34880 "MULTIPLE HANDLES AND MULTIPLE THREADS> above."
34881 msgstr ""
34882
34883 #. type: =head2
34884 #: ../src/guestfs.pod:1290
34885 msgid "guestfs_create"
34886 msgstr "guestfs_create"
34887
34888 #. type: verbatim
34889 #: ../src/guestfs.pod:1292
34890 #, no-wrap
34891 msgid ""
34892 " guestfs_h *guestfs_create (void);\n"
34893 "\n"
34894 msgstr ""
34895 " guestfs_h *guestfs_create (void);\n"
34896 "\n"
34897
34898 #. type: textblock
34899 #: ../src/guestfs.pod:1294
34900 msgid "Create a connection handle."
34901 msgstr "Створити дескриптор з’єднання."
34902
34903 #. type: textblock
34904 #: ../src/guestfs.pod:1296
34905 msgid ""
34906 "On success this returns a non-NULL pointer to a handle.  On error it returns "
34907 "NULL."
34908 msgstr ""
34909
34910 #. type: textblock
34911 #: ../src/guestfs.pod:1299
34912 msgid ""
34913 "You have to \"configure\" the handle after creating it.  This includes "
34914 "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the "
34915 "handle at least once."
34916 msgstr ""
34917
34918 #. type: textblock
34919 #: ../src/guestfs.pod:1303
34920 msgid "After configuring the handle, you have to call L</guestfs_launch>."
34921 msgstr ""
34922
34923 #. type: textblock
34924 #: ../src/guestfs.pod:1305
34925 msgid ""
34926 "You may also want to configure error handling for the handle.  See the L</"
34927 "ERROR HANDLING> section below."
34928 msgstr ""
34929
34930 #. type: =head2
34931 #: ../src/guestfs.pod:1308
34932 msgid "guestfs_close"
34933 msgstr "guestfs_close"
34934
34935 #. type: verbatim
34936 #: ../src/guestfs.pod:1310
34937 #, no-wrap
34938 msgid ""
34939 " void guestfs_close (guestfs_h *g);\n"
34940 "\n"
34941 msgstr ""
34942 " void guestfs_close (guestfs_h *g);\n"
34943 "\n"
34944
34945 #. type: textblock
34946 #: ../src/guestfs.pod:1312
34947 msgid "This closes the connection handle and frees up all resources used."
34948 msgstr ""
34949
34950 #. type: textblock
34951 #: ../src/guestfs.pod:1314
34952 msgid ""
34953 "If autosync was set on the handle and the handle was launched, then this "
34954 "implicitly calls various functions to unmount filesystems and sync the "
34955 "disk.  See L</guestfs_set_autosync> for more details."
34956 msgstr ""
34957
34958 #. type: textblock
34959 #: ../src/guestfs.pod:1318
34960 msgid "If a close callback was set on the handle, then it is called."
34961 msgstr ""
34962
34963 #. type: =head1
34964 #: ../src/guestfs.pod:1320
34965 msgid "ERROR HANDLING"
34966 msgstr "ОБРОБКА ПОМИЛОК"
34967
34968 #. type: textblock
34969 #: ../src/guestfs.pod:1322
34970 msgid ""
34971 "API functions can return errors.  For example, almost all functions that "
34972 "return C<int> will return C<-1> to indicate an error."
34973 msgstr ""
34974
34975 #. type: textblock
34976 #: ../src/guestfs.pod:1325
34977 msgid ""
34978 "Additional information is available for errors: an error message string and "
34979 "optionally an error number (errno) if the thing that failed was a system "
34980 "call."
34981 msgstr ""
34982
34983 #. type: textblock
34984 #: ../src/guestfs.pod:1329
34985 msgid ""
34986 "You can get at the additional information about the last error on the handle "
34987 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
34988 "up an error handler with L</guestfs_set_error_handler>."
34989 msgstr ""
34990
34991 #. type: textblock
34992 #: ../src/guestfs.pod:1334
34993 msgid ""
34994 "When the handle is created, a default error handler is installed which "
34995 "prints the error message string to C<stderr>.  For small short-running "
34996 "command line programs it is sufficient to do:"
34997 msgstr ""
34998
34999 #. type: verbatim
35000 #: ../src/guestfs.pod:1338
35001 #, no-wrap
35002 msgid ""
35003 " if (guestfs_launch (g) == -1)\n"
35004 "   exit (EXIT_FAILURE);\n"
35005 "\n"
35006 msgstr ""
35007 " if (guestfs_launch (g) == -1)\n"
35008 "   exit (EXIT_FAILURE);\n"
35009 "\n"
35010
35011 #. type: textblock
35012 #: ../src/guestfs.pod:1341
35013 msgid ""
35014 "since the default error handler will ensure that an error message has been "
35015 "printed to C<stderr> before the program exits."
35016 msgstr ""
35017
35018 #. type: textblock
35019 #: ../src/guestfs.pod:1344
35020 msgid ""
35021 "For other programs the caller will almost certainly want to install an "
35022 "alternate error handler or do error handling in-line like this:"
35023 msgstr ""
35024
35025 #. type: verbatim
35026 #: ../src/guestfs.pod:1347
35027 #, no-wrap
35028 msgid ""
35029 " g = guestfs_create ();\n"
35030 " \n"
35031 msgstr ""
35032 " g = guestfs_create ();\n"
35033 " \n"
35034
35035 #. type: verbatim
35036 #: ../src/guestfs.pod:1349
35037 #, no-wrap
35038 msgid ""
35039 " /* This disables the default behaviour of printing errors\n"
35040 "    on stderr. */\n"
35041 " guestfs_set_error_handler (g, NULL, NULL);\n"
35042 " \n"
35043 msgstr ""
35044
35045 #. type: verbatim
35046 #: ../src/guestfs.pod:1353
35047 #, no-wrap
35048 msgid ""
35049 " if (guestfs_launch (g) == -1) {\n"
35050 "   /* Examine the error message and print it etc. */\n"
35051 "   char *msg = guestfs_last_error (g);\n"
35052 "   int errnum = guestfs_last_errno (g);\n"
35053 "   fprintf (stderr, \"%s\\n\", msg);\n"
35054 "   /* ... */\n"
35055 "  }\n"
35056 "\n"
35057 msgstr ""
35058 " if (guestfs_launch (g) == -1) {\n"
35059 "   /* Вивчити повідомлення про помилку і вивести його тощо. */\n"
35060 "   char *msg = guestfs_last_error (g);\n"
35061 "   int errnum = guestfs_last_errno (g);\n"
35062 "   fprintf (stderr, \"%s\\n\", msg);\n"
35063 "   /* ... */\n"
35064 "  }\n"
35065 "\n"
35066
35067 #. type: textblock
35068 #: ../src/guestfs.pod:1361
35069 msgid ""
35070 "Out of memory errors are handled differently.  The default action is to call "
35071 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
35072 "guestfs_set_out_of_memory_handler>."
35073 msgstr ""
35074
35075 #. type: textblock
35076 #: ../src/guestfs.pod:1365
35077 msgid ""
35078 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
35079 "because there is no handle if this happens there is no way to get additional "
35080 "error information.  However L</guestfs_create> is supposed to be a "
35081 "lightweight operation which can only fail because of insufficient memory (it "
35082 "returns NULL in this case)."
35083 msgstr ""
35084
35085 #. type: =head2
35086 #: ../src/guestfs.pod:1371
35087 msgid "guestfs_last_error"
35088 msgstr "guestfs_last_error"
35089
35090 #. type: verbatim
35091 #: ../src/guestfs.pod:1373
35092 #, no-wrap
35093 msgid ""
35094 " const char *guestfs_last_error (guestfs_h *g);\n"
35095 "\n"
35096 msgstr ""
35097 " const char *guestfs_last_error (guestfs_h *g);\n"
35098 "\n"
35099
35100 #. type: textblock
35101 #: ../src/guestfs.pod:1375
35102 msgid ""
35103 "This returns the last error message that happened on C<g>.  If there has not "
35104 "been an error since the handle was created, then this returns C<NULL>."
35105 msgstr ""
35106
35107 #. type: textblock
35108 #: ../src/guestfs.pod:1379
35109 msgid ""
35110 "The lifetime of the returned string is until the next error occurs, or L</"
35111 "guestfs_close> is called."
35112 msgstr ""
35113
35114 #. type: =head2
35115 #: ../src/guestfs.pod:1382
35116 msgid "guestfs_last_errno"
35117 msgstr "guestfs_last_errno"
35118
35119 #. type: verbatim
35120 #: ../src/guestfs.pod:1384
35121 #, no-wrap
35122 msgid ""
35123 " int guestfs_last_errno (guestfs_h *g);\n"
35124 "\n"
35125 msgstr ""
35126 " int guestfs_last_errno (guestfs_h *g);\n"
35127 "\n"
35128
35129 #. type: textblock
35130 #: ../src/guestfs.pod:1386
35131 msgid "This returns the last error number (errno) that happened on C<g>."
35132 msgstr ""
35133
35134 #. type: textblock
35135 #: ../src/guestfs.pod:1388
35136 msgid "If successful, an errno integer not equal to zero is returned."
35137 msgstr ""
35138
35139 #. type: textblock
35140 #: ../src/guestfs.pod:1390
35141 msgid ""
35142 "If no error, this returns 0.  This call can return 0 in three situations:"
35143 msgstr ""
35144
35145 #. type: textblock
35146 #: ../src/guestfs.pod:1397
35147 msgid "There has not been any error on the handle."
35148 msgstr ""
35149
35150 #. type: textblock
35151 #: ../src/guestfs.pod:1401
35152 msgid ""
35153 "There has been an error but the errno was meaningless.  This corresponds to "
35154 "the case where the error did not come from a failed system call, but for "
35155 "some other reason."
35156 msgstr ""
35157
35158 #. type: textblock
35159 #: ../src/guestfs.pod:1407
35160 msgid ""
35161 "There was an error from a failed system call, but for some reason the errno "
35162 "was not captured and returned.  This usually indicates a bug in libguestfs."
35163 msgstr ""
35164
35165 #. type: textblock
35166 #: ../src/guestfs.pod:1413
35167 msgid ""
35168 "Libguestfs tries to convert the errno from inside the applicance into a "
35169 "corresponding errno for the caller (not entirely trivial: the appliance "
35170 "might be running a completely different operating system from the library "
35171 "and error numbers are not standardized across Un*xen).  If this could not be "
35172 "done, then the error is translated to C<EINVAL>.  In practice this should "
35173 "only happen in very rare circumstances."
35174 msgstr ""
35175
35176 #. type: =head2
35177 #: ../src/guestfs.pod:1421
35178 msgid "guestfs_set_error_handler"
35179 msgstr "guestfs_set_error_handler"
35180
35181 #. type: verbatim
35182 #: ../src/guestfs.pod:1423
35183 #, no-wrap
35184 msgid ""
35185 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
35186 "                                           void *opaque,\n"
35187 "                                           const char *msg);\n"
35188 " void guestfs_set_error_handler (guestfs_h *g,\n"
35189 "                                 guestfs_error_handler_cb cb,\n"
35190 "                                 void *opaque);\n"
35191 "\n"
35192 msgstr ""
35193 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
35194 "                                           void *opaque,\n"
35195 "                                           const char *msg);\n"
35196 " void guestfs_set_error_handler (guestfs_h *g,\n"
35197 "                                 guestfs_error_handler_cb cb,\n"
35198 "                                 void *opaque);\n"
35199 "\n"
35200
35201 #. type: textblock
35202 #: ../src/guestfs.pod:1430
35203 msgid ""
35204 "The callback C<cb> will be called if there is an error.  The parameters "
35205 "passed to the callback are an opaque data pointer and the error message "
35206 "string."
35207 msgstr ""
35208
35209 #. type: textblock
35210 #: ../src/guestfs.pod:1434
35211 msgid ""
35212 "C<errno> is not passed to the callback.  To get that the callback must call "
35213 "L</guestfs_last_errno>."
35214 msgstr ""
35215
35216 #. type: textblock
35217 #: ../src/guestfs.pod:1437
35218 msgid ""
35219 "Note that the message string C<msg> is freed as soon as the callback "
35220 "function returns, so if you want to stash it somewhere you must make your "
35221 "own copy."
35222 msgstr ""
35223
35224 #. type: textblock
35225 #: ../src/guestfs.pod:1441
35226 msgid "The default handler prints messages on C<stderr>."
35227 msgstr ""
35228
35229 #. type: textblock
35230 #: ../src/guestfs.pod:1443
35231 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
35232 msgstr ""
35233
35234 #. type: =head2
35235 #: ../src/guestfs.pod:1445
35236 msgid "guestfs_get_error_handler"
35237 msgstr "guestfs_get_error_handler"
35238
35239 #. type: verbatim
35240 #: ../src/guestfs.pod:1447
35241 #, no-wrap
35242 msgid ""
35243 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
35244 "                                                     void **opaque_rtn);\n"
35245 "\n"
35246 msgstr ""
35247 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
35248 "                                                     void **opaque_rtn);\n"
35249 "\n"
35250
35251 #. type: textblock
35252 #: ../src/guestfs.pod:1450
35253 msgid "Returns the current error handler callback."
35254 msgstr ""
35255
35256 #. type: =head2
35257 #: ../src/guestfs.pod:1452
35258 msgid "guestfs_set_out_of_memory_handler"
35259 msgstr "guestfs_set_out_of_memory_handler"
35260
35261 #. type: verbatim
35262 #: ../src/guestfs.pod:1454
35263 #, fuzzy, no-wrap
35264 #| msgid ""
35265 #| " typedef void (*guestfs_abort_cb) (void);\n"
35266 #| " int guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
35267 #| "                                        guestfs_abort_cb);\n"
35268 #| "\n"
35269 msgid ""
35270 " typedef void (*guestfs_abort_cb) (void);\n"
35271 " void guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
35272 "                                         guestfs_abort_cb);\n"
35273 "\n"
35274 msgstr ""
35275 " typedef void (*guestfs_abort_cb) (void);\n"
35276 " int guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
35277 "                                        guestfs_abort_cb);\n"
35278 "\n"
35279
35280 #. type: textblock
35281 #: ../src/guestfs.pod:1458
35282 msgid ""
35283 "The callback C<cb> will be called if there is an out of memory situation.  "
35284 "I<Note this callback must not return>."
35285 msgstr ""
35286
35287 #. type: textblock
35288 #: ../src/guestfs.pod:1461
35289 msgid "The default is to call L<abort(3)>."
35290 msgstr ""
35291
35292 #. type: textblock
35293 #: ../src/guestfs.pod:1463
35294 msgid ""
35295 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
35296 msgstr ""
35297
35298 #. type: =head2
35299 #: ../src/guestfs.pod:1466
35300 msgid "guestfs_get_out_of_memory_handler"
35301 msgstr "guestfs_get_out_of_memory_handler"
35302
35303 #. type: verbatim
35304 #: ../src/guestfs.pod:1468
35305 #, no-wrap
35306 msgid ""
35307 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
35308 "\n"
35309 msgstr ""
35310 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
35311 "\n"
35312
35313 #. type: textblock
35314 #: ../src/guestfs.pod:1470
35315 msgid "This returns the current out of memory handler."
35316 msgstr ""
35317
35318 #. type: =head1
35319 #: ../src/guestfs.pod:1472
35320 msgid "API CALLS"
35321 msgstr "ВИКЛИКИ API"
35322
35323 #. type: =head1
35324 #: ../src/guestfs.pod:1476
35325 msgid "STRUCTURES"
35326 msgstr "СТРУКТУРИ"
35327
35328 #. type: textblock
35329 #: ../src/guestfs.pod:1478
35330 msgid "@STRUCTS@"
35331 msgstr "@STRUCTS@"
35332
35333 #. type: =head1
35334 #: ../src/guestfs.pod:1480
35335 msgid "AVAILABILITY"
35336 msgstr "ДОСТУПНІСТЬ"
35337
35338 #. type: =head2
35339 #: ../src/guestfs.pod:1482
35340 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
35341 msgstr "ГРУПИ ФУНКЦІОНАЛЬНИХ МОЖЛИВОСТЕЙ У ОБРАЗІ ОСНОВНОЇ СИСТЕМИ"
35342
35343 #. type: textblock
35344 #: ../src/guestfs.pod:1484
35345 msgid ""
35346 "Using L</guestfs_available> you can test availability of the following "
35347 "groups of functions.  This test queries the appliance to see if the "
35348 "appliance you are currently using supports the functionality."
35349 msgstr ""
35350
35351 #. type: textblock
35352 #: ../src/guestfs.pod:1489
35353 msgid "@AVAILABILITY@"
35354 msgstr "@AVAILABILITY@"
35355
35356 #. type: =head2
35357 #: ../src/guestfs.pod:1491
35358 msgid "GUESTFISH supported COMMAND"
35359 msgstr ""
35360
35361 #. type: textblock
35362 #: ../src/guestfs.pod:1493
35363 msgid ""
35364 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
35365 "prints out the available groups and whether they are supported by this build "
35366 "of libguestfs.  Note however that you have to do C<run> first."
35367 msgstr ""
35368
35369 #. type: =head2
35370 #: ../src/guestfs.pod:1498
35371 msgid "SINGLE CALLS AT COMPILE TIME"
35372 msgstr ""
35373
35374 #. type: textblock
35375 #: ../src/guestfs.pod:1500
35376 msgid ""
35377 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
35378 "function, such as:"
35379 msgstr ""
35380
35381 #. type: verbatim
35382 #: ../src/guestfs.pod:1503
35383 #, no-wrap
35384 msgid ""
35385 " #define LIBGUESTFS_HAVE_DD 1\n"
35386 "\n"
35387 msgstr ""
35388 " #define LIBGUESTFS_HAVE_DD 1\n"
35389 "\n"
35390
35391 #. type: textblock
35392 #: ../src/guestfs.pod:1505
35393 msgid "if L</guestfs_dd> is available."
35394 msgstr ""
35395
35396 #. type: textblock
35397 #: ../src/guestfs.pod:1507
35398 msgid ""
35399 "Before version 1.5.8, if you needed to test whether a single libguestfs "
35400 "function is available at compile time, we recommended using build tools such "
35401 "as autoconf or cmake.  For example in autotools you could use:"
35402 msgstr ""
35403
35404 #. type: verbatim
35405 #: ../src/guestfs.pod:1512
35406 #, no-wrap
35407 msgid ""
35408 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
35409 " AC_CHECK_FUNCS([guestfs_dd])\n"
35410 "\n"
35411 msgstr ""
35412 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
35413 " AC_CHECK_FUNCS([guestfs_dd])\n"
35414 "\n"
35415
35416 #. type: textblock
35417 #: ../src/guestfs.pod:1515
35418 msgid ""
35419 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
35420 "in your program."
35421 msgstr ""
35422
35423 #. type: =head2
35424 #: ../src/guestfs.pod:1518
35425 msgid "SINGLE CALLS AT RUN TIME"
35426 msgstr ""
35427
35428 #. type: textblock
35429 #: ../src/guestfs.pod:1520
35430 msgid ""
35431 "Testing at compile time doesn't guarantee that a function really exists in "
35432 "the library.  The reason is that you might be dynamically linked against a "
35433 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
35434 "This situation unfortunately results in a segmentation fault, which is a "
35435 "shortcoming of the C dynamic linking system itself."
35436 msgstr ""
35437
35438 #. type: textblock
35439 #: ../src/guestfs.pod:1527
35440 msgid ""
35441 "You can use L<dlopen(3)> to test if a function is available at run time, as "
35442 "in this example program (note that you still need the compile time check as "
35443 "well):"
35444 msgstr ""
35445
35446 #. type: verbatim
35447 #: ../src/guestfs.pod:1531
35448 #, no-wrap
35449 msgid ""
35450 " #include <stdio.h>\n"
35451 " #include <stdlib.h>\n"
35452 " #include <unistd.h>\n"
35453 " #include <dlfcn.h>\n"
35454 " #include <guestfs.h>\n"
35455 " \n"
35456 msgstr ""
35457 " #include <stdio.h>\n"
35458 " #include <stdlib.h>\n"
35459 " #include <unistd.h>\n"
35460 " #include <dlfcn.h>\n"
35461 " #include <guestfs.h>\n"
35462 " \n"
35463
35464 #. type: verbatim
35465 #: ../src/guestfs.pod:1537
35466 #, no-wrap
35467 msgid ""
35468 " main ()\n"
35469 " {\n"
35470 " #ifdef LIBGUESTFS_HAVE_DD\n"
35471 "   void *dl;\n"
35472 "   int has_function;\n"
35473 " \n"
35474 msgstr ""
35475 " main ()\n"
35476 " {\n"
35477 " #ifdef LIBGUESTFS_HAVE_DD\n"
35478 "   void *dl;\n"
35479 "   int has_function;\n"
35480 " \n"
35481
35482 #. type: verbatim
35483 #: ../src/guestfs.pod:1543
35484 #, no-wrap
35485 msgid ""
35486 "   /* Test if the function guestfs_dd is really available. */\n"
35487 "   dl = dlopen (NULL, RTLD_LAZY);\n"
35488 "   if (!dl) {\n"
35489 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
35490 "     exit (EXIT_FAILURE);\n"
35491 "   }\n"
35492 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
35493 "   dlclose (dl);\n"
35494 " \n"
35495 msgstr ""
35496
35497 #. type: verbatim
35498 #: ../src/guestfs.pod:1552
35499 #, no-wrap
35500 msgid ""
35501 "   if (!has_function)\n"
35502 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
35503 "   else {\n"
35504 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
35505 "     /* Now it's safe to call\n"
35506 "     guestfs_dd (g, \"foo\", \"bar\");\n"
35507 "     */\n"
35508 "   }\n"
35509 " #else\n"
35510 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
35511 " #endif\n"
35512 "  }\n"
35513 "\n"
35514 msgstr ""
35515
35516 #. type: textblock
35517 #: ../src/guestfs.pod:1565
35518 msgid ""
35519 "You may think the above is an awful lot of hassle, and it is.  There are "
35520 "other ways outside of the C linking system to ensure that this kind of "
35521 "incompatibility never arises, such as using package versioning:"
35522 msgstr ""
35523
35524 #. type: verbatim
35525 #: ../src/guestfs.pod:1570
35526 #, no-wrap
35527 msgid ""
35528 " Requires: libguestfs >= 1.0.80\n"
35529 "\n"
35530 msgstr ""
35531
35532 #. type: =head1
35533 #: ../src/guestfs.pod:1572
35534 msgid "CALLS WITH OPTIONAL ARGUMENTS"
35535 msgstr ""
35536
35537 #. type: textblock
35538 #: ../src/guestfs.pod:1574
35539 msgid ""
35540 "A recent feature of the API is the introduction of calls which take optional "
35541 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
35542 "takes variable arguments (ie. C<...>), as in this example:"
35543 msgstr ""
35544
35545 #. type: verbatim
35546 #: ../src/guestfs.pod:1579
35547 #, no-wrap
35548 msgid ""
35549 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
35550 "\n"
35551 msgstr ""
35552 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
35553 "\n"
35554
35555 #. type: textblock
35556 #: ../src/guestfs.pod:1581
35557 msgid ""
35558 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
35559 "call with no optional arguments specified:"
35560 msgstr ""
35561
35562 #. type: verbatim
35563 #: ../src/guestfs.pod:1584
35564 #, no-wrap
35565 msgid ""
35566 " guestfs_add_drive_opts (g, filename, -1);\n"
35567 "\n"
35568 msgstr ""
35569 " guestfs_add_drive_opts (g, filename, -1);\n"
35570 "\n"
35571
35572 #. type: textblock
35573 #: ../src/guestfs.pod:1586
35574 msgid "With a single optional argument:"
35575 msgstr ""
35576
35577 #. type: verbatim
35578 #: ../src/guestfs.pod:1588
35579 #, no-wrap
35580 msgid ""
35581 " guestfs_add_drive_opts (g, filename,\n"
35582 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
35583 "                         -1);\n"
35584 "\n"
35585 msgstr ""
35586 " guestfs_add_drive_opts (g, filename,\n"
35587 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
35588 "                         -1);\n"
35589 "\n"
35590
35591 #. type: textblock
35592 #: ../src/guestfs.pod:1592
35593 msgid "With two:"
35594 msgstr ""
35595
35596 #. type: verbatim
35597 #: ../src/guestfs.pod:1594
35598 #, no-wrap
35599 msgid ""
35600 " guestfs_add_drive_opts (g, filename,\n"
35601 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
35602 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
35603 "                         -1);\n"
35604 "\n"
35605 msgstr ""
35606 " guestfs_add_drive_opts (g, filename,\n"
35607 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
35608 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
35609 "                         -1);\n"
35610 "\n"
35611
35612 #. type: textblock
35613 #: ../src/guestfs.pod:1599
35614 msgid ""
35615 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
35616 "happen!"
35617 msgstr ""
35618
35619 #. type: =head2
35620 #: ../src/guestfs.pod:1602
35621 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
35622 msgstr ""
35623
35624 #. type: textblock
35625 #: ../src/guestfs.pod:1604
35626 msgid ""
35627 "The second variant has the same name with the suffix C<_va>, which works the "
35628 "same way but takes a C<va_list>.  See the C manual for details.  For the "
35629 "example function, this is declared:"
35630 msgstr ""
35631
35632 #. type: verbatim
35633 #: ../src/guestfs.pod:1608
35634 #, no-wrap
35635 msgid ""
35636 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
35637 "                                va_list args);\n"
35638 "\n"
35639 msgstr ""
35640 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
35641 "                                va_list args);\n"
35642 "\n"
35643
35644 #. type: =head2
35645 #: ../src/guestfs.pod:1611
35646 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
35647 msgstr ""
35648
35649 #. type: textblock
35650 #: ../src/guestfs.pod:1613
35651 msgid ""
35652 "The third variant is useful where you need to construct these calls.  You "
35653 "pass in a structure where you fill in the optional fields.  The structure "
35654 "has a bitmask as the first element which you must set to indicate which "
35655 "fields you have filled in.  For our example function the structure and call "
35656 "are declared:"
35657 msgstr ""
35658
35659 #. type: verbatim
35660 #: ../src/guestfs.pod:1619
35661 #, no-wrap
35662 msgid ""
35663 " struct guestfs_add_drive_opts_argv {\n"
35664 "   uint64_t bitmask;\n"
35665 "   int readonly;\n"
35666 "   const char *format;\n"
35667 "   /* ... */\n"
35668 " };\n"
35669 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
35670 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
35671 "\n"
35672 msgstr ""
35673 " struct guestfs_add_drive_opts_argv {\n"
35674 "   uint64_t bitmask;\n"
35675 "   int readonly;\n"
35676 "   const char *format;\n"
35677 "   /* ... */\n"
35678 " };\n"
35679 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
35680 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
35681 "\n"
35682
35683 #. type: textblock
35684 #: ../src/guestfs.pod:1628
35685 msgid "You could call it like this:"
35686 msgstr ""
35687
35688 #. type: verbatim
35689 #: ../src/guestfs.pod:1630
35690 #, no-wrap
35691 msgid ""
35692 " struct guestfs_add_drive_opts_argv optargs = {\n"
35693 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
35694 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
35695 "   .readonly = 1,\n"
35696 "   .format = \"qcow2\"\n"
35697 " };\n"
35698 " \n"
35699 msgstr ""
35700 " struct guestfs_add_drive_opts_argv optargs = {\n"
35701 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
35702 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
35703 "   .readonly = 1,\n"
35704 "   .format = \"qcow2\"\n"
35705 " };\n"
35706 " \n"
35707
35708 #. type: verbatim
35709 #: ../src/guestfs.pod:1637
35710 #, no-wrap
35711 msgid ""
35712 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
35713 "\n"
35714 msgstr ""
35715 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
35716 "\n"
35717
35718 #. type: textblock
35719 #: ../src/guestfs.pod:1645
35720 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
35721 msgstr ""
35722
35723 #. type: textblock
35724 #: ../src/guestfs.pod:1650
35725 msgid "You do not need to fill in all fields of the structure."
35726 msgstr ""
35727
35728 #. type: textblock
35729 #: ../src/guestfs.pod:1654
35730 msgid ""
35731 "There must be a one-to-one correspondence between fields of the structure "
35732 "that are filled in, and bits set in the bitmask."
35733 msgstr ""
35734
35735 #. type: =head2
35736 #: ../src/guestfs.pod:1659
35737 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
35738 msgstr ""
35739
35740 #. type: textblock
35741 #: ../src/guestfs.pod:1661
35742 msgid ""
35743 "In other languages, optional arguments are expressed in the way that is "
35744 "natural for that language.  We refer you to the language-specific "
35745 "documentation for more details on that."
35746 msgstr ""
35747
35748 #. type: textblock
35749 #: ../src/guestfs.pod:1665
35750 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
35751 msgstr ""
35752
35753 #. type: =head2
35754 #: ../src/guestfs.pod:1667
35755 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
35756 msgstr ""
35757
35758 #. type: textblock
35759 #: ../src/guestfs.pod:1669
35760 msgid ""
35761 "B<Note:> This section documents the generic event mechanism introduced in "
35762 "libguestfs 1.10, which you should use in new code if possible.  The old "
35763 "functions C<guestfs_set_log_message_callback>, "
35764 "C<guestfs_set_subprocess_quit_callback>, "
35765 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
35766 "C<guestfs_set_progress_callback> are no longer documented in this manual "
35767 "page.  Because of the ABI guarantee, the old functions continue to work."
35768 msgstr ""
35769
35770 #. type: textblock
35771 #: ../src/guestfs.pod:1678
35772 msgid ""
35773 "Handles generate events when certain things happen, such as log messages "
35774 "being generated, progress messages during long-running operations, or the "
35775 "handle being closed.  The API calls described below let you register a "
35776 "callback to be called when events happen.  You can register multiple "
35777 "callbacks (for the same, different or overlapping sets of events), and "
35778 "individually remove callbacks.  If callbacks are not removed, then they "
35779 "remain in force until the handle is closed."
35780 msgstr ""
35781
35782 #. type: textblock
35783 #: ../src/guestfs.pod:1686
35784 msgid ""
35785 "In the current implementation, events are only generated synchronously: that "
35786 "means that events (and hence callbacks) can only happen while you are in the "
35787 "middle of making another libguestfs call.  The callback is called in the "
35788 "same thread."
35789 msgstr ""
35790
35791 #. type: textblock
35792 #: ../src/guestfs.pod:1691
35793 msgid ""
35794 "Events may contain a payload, usually nothing (void), an array of 64 bit "
35795 "unsigned integers, or a message buffer.  Payloads are discussed later on."
35796 msgstr ""
35797
35798 #. type: =head3
35799 #: ../src/guestfs.pod:1695
35800 msgid "CLASSES OF EVENTS"
35801 msgstr ""
35802
35803 #. type: =item
35804 #: ../src/guestfs.pod:1699
35805 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
35806 msgstr ""
35807
35808 #. type: textblock
35809 #: ../src/guestfs.pod:1702
35810 msgid ""
35811 "The callback function will be called while the handle is being closed "
35812 "(synchronously from L</guestfs_close>)."
35813 msgstr ""
35814
35815 #. type: textblock
35816 #: ../src/guestfs.pod:1705
35817 msgid ""
35818 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
35819 "handles that are open when the program exits.  This means that this callback "
35820 "might be called indirectly from L<exit(3)>, which can cause unexpected "
35821 "problems in higher-level languages (eg. if your HLL interpreter has already "
35822 "been cleaned up by the time this is called, and if your callback then jumps "
35823 "into some HLL function)."
35824 msgstr ""
35825
35826 #. type: textblock
35827 #: ../src/guestfs.pod:1712
35828 msgid ""
35829 "If no callback is registered: the handle is closed without any callback "
35830 "being invoked."
35831 msgstr ""
35832
35833 #. type: =item
35834 #: ../src/guestfs.pod:1715
35835 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
35836 msgstr ""
35837
35838 #. type: textblock
35839 #: ../src/guestfs.pod:1718
35840 msgid ""
35841 "The callback function will be called when the child process quits, either "
35842 "asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
35843 "corresponds to a transition from any state to the CONFIG state)."
35844 msgstr ""
35845
35846 #. type: textblock
35847 #: ../src/guestfs.pod:1722 ../src/guestfs.pod:1731
35848 msgid "If no callback is registered: the event is ignored."
35849 msgstr ""
35850
35851 #. type: =item
35852 #: ../src/guestfs.pod:1724
35853 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
35854 msgstr ""
35855
35856 #. type: textblock
35857 #: ../src/guestfs.pod:1727
35858 msgid ""
35859 "The callback function will be called when the child process becomes ready "
35860 "first time after it has been launched.  (This corresponds to a transition "
35861 "from LAUNCHING to the READY state)."
35862 msgstr ""
35863
35864 #. type: =item
35865 #: ../src/guestfs.pod:1733
35866 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
35867 msgstr ""
35868
35869 #. type: textblock
35870 #: ../src/guestfs.pod:1736
35871 msgid ""
35872 "Some long-running operations can generate progress messages.  If this "
35873 "callback is registered, then it will be called each time a progress message "
35874 "is generated (usually two seconds after the operation started, and three "
35875 "times per second thereafter until it completes, although the frequency may "
35876 "change in future versions)."
35877 msgstr ""
35878
35879 #. type: textblock
35880 #: ../src/guestfs.pod:1742
35881 msgid ""
35882 "The callback receives in the payload four unsigned 64 bit numbers which are "
35883 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
35884 msgstr ""
35885
35886 #. type: textblock
35887 #: ../src/guestfs.pod:1745
35888 msgid ""
35889 "The units of C<total> are not defined, although for some operations C<total> "
35890 "may relate in some way to the amount of data to be transferred (eg. in bytes "
35891 "or megabytes), and C<position> may be the portion which has been transferred."
35892 msgstr ""
35893
35894 #. type: textblock
35895 #: ../src/guestfs.pod:1750
35896 msgid "The only defined and stable parts of the API are:"
35897 msgstr ""
35898
35899 #. type: textblock
35900 #: ../src/guestfs.pod:1756
35901 msgid ""
35902 "The callback can display to the user some type of progress bar or indicator "
35903 "which shows the ratio of C<position>:C<total>."
35904 msgstr ""
35905
35906 #. type: textblock
35907 #: ../src/guestfs.pod:1761
35908 msgid "0 E<lt>= C<position> E<lt>= C<total>"
35909 msgstr ""
35910
35911 #. type: textblock
35912 #: ../src/guestfs.pod:1765
35913 msgid ""
35914 "If any progress notification is sent during a call, then a final progress "
35915 "notification is always sent when C<position> = C<total> (I<unless> the call "
35916 "fails with an error)."
35917 msgstr ""
35918
35919 #. type: textblock
35920 #: ../src/guestfs.pod:1769
35921 msgid ""
35922 "This is to simplify caller code, so callers can easily set the progress "
35923 "indicator to \"100%\" at the end of the operation, without requiring special "
35924 "code to detect this case."
35925 msgstr ""
35926
35927 #. type: textblock
35928 #: ../src/guestfs.pod:1775
35929 msgid ""
35930 "For some calls we are unable to estimate the progress of the call, but we "
35931 "can still generate progress messages to indicate activity.  This is known as "
35932 "\"pulse mode\", and is directly supported by certain progress bar "
35933 "implementations (eg. GtkProgressBar)."
35934 msgstr ""
35935
35936 #. type: textblock
35937 #: ../src/guestfs.pod:1780
35938 msgid ""
35939 "For these calls, zero or more progress messages are generated with "
35940 "C<position = 0> and C<total = 1>, followed by a final message with "
35941 "C<position = total = 1>."
35942 msgstr ""
35943
35944 #. type: textblock
35945 #: ../src/guestfs.pod:1784
35946 msgid ""
35947 "As noted above, if the call fails with an error then the final message may "
35948 "not be generated."
35949 msgstr ""
35950
35951 #. type: textblock
35952 #: ../src/guestfs.pod:1789
35953 msgid ""
35954 "The callback also receives the procedure number (C<proc_nr>) and serial "
35955 "number (C<serial>) of the call.  These are only useful for debugging "
35956 "protocol issues, and the callback can normally ignore them.  The callback "
35957 "may want to print these numbers in error messages or debugging messages."
35958 msgstr ""
35959
35960 #. type: textblock
35961 #: ../src/guestfs.pod:1795
35962 msgid "If no callback is registered: progress messages are discarded."
35963 msgstr ""
35964
35965 #. type: =item
35966 #: ../src/guestfs.pod:1797
35967 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
35968 msgstr ""
35969
35970 #. type: textblock
35971 #: ../src/guestfs.pod:1800
35972 msgid ""
35973 "The callback function is called whenever a log message is generated by qemu, "
35974 "the appliance kernel, guestfsd (daemon), or utility programs."
35975 msgstr ""
35976
35977 #. type: textblock
35978 #: ../src/guestfs.pod:1803
35979 msgid ""
35980 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
35981 "guestfs_launch>) then additional debug messages are generated."
35982 msgstr ""
35983
35984 #. type: textblock
35985 #: ../src/guestfs.pod:1806 ../src/guestfs.pod:1820
35986 msgid ""
35987 "If no callback is registered: the messages are discarded unless the verbose "
35988 "flag is set in which case they are sent to stderr.  You can override the "
35989 "printing of verbose messages to stderr by setting up a callback."
35990 msgstr ""
35991
35992 #. type: =item
35993 #: ../src/guestfs.pod:1811
35994 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
35995 msgstr ""
35996
35997 #. type: textblock
35998 #: ../src/guestfs.pod:1814
35999 msgid ""
36000 "The callback function is called whenever a log message is generated by the "
36001 "library part of libguestfs."
36002 msgstr ""
36003
36004 #. type: textblock
36005 #: ../src/guestfs.pod:1817
36006 msgid ""
36007 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
36008 "messages are generated."
36009 msgstr ""
36010
36011 #. type: =item
36012 #: ../src/guestfs.pod:1825
36013 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
36014 msgstr ""
36015
36016 #. type: textblock
36017 #: ../src/guestfs.pod:1828
36018 msgid ""
36019 "The callback function is called whenever a trace message is generated.  This "
36020 "only applies if the trace flag (L</guestfs_set_trace>) is set."
36021 msgstr ""
36022
36023 #. type: textblock
36024 #: ../src/guestfs.pod:1831
36025 msgid ""
36026 "If no callback is registered: the messages are sent to stderr.  You can "
36027 "override the printing of trace messages to stderr by setting up a callback."
36028 msgstr ""
36029
36030 #. type: =head3
36031 #: ../src/guestfs.pod:1837
36032 msgid "guestfs_set_event_callback"
36033 msgstr ""
36034
36035 #. type: verbatim
36036 #: ../src/guestfs.pod:1839
36037 #, no-wrap
36038 msgid ""
36039 " int guestfs_set_event_callback (guestfs_h *g,\n"
36040 "                                 guestfs_event_callback cb,\n"
36041 "                                 uint64_t event_bitmask,\n"
36042 "                                 int flags,\n"
36043 "                                 void *opaque);\n"
36044 "\n"
36045 msgstr ""
36046
36047 #. type: textblock
36048 #: ../src/guestfs.pod:1845
36049 msgid ""
36050 "This function registers a callback (C<cb>) for all event classes in the "
36051 "C<event_bitmask>."
36052 msgstr ""
36053
36054 #. type: textblock
36055 #: ../src/guestfs.pod:1848
36056 msgid ""
36057 "For example, to register for all log message events, you could call this "
36058 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>.  "
36059 "To register a single callback for all possible classes of events, use "
36060 "C<GUESTFS_EVENT_ALL>."
36061 msgstr ""
36062
36063 #. type: textblock
36064 #: ../src/guestfs.pod:1854
36065 msgid "C<flags> should always be passed as 0."
36066 msgstr ""
36067
36068 #. type: textblock
36069 #: ../src/guestfs.pod:1856
36070 msgid ""
36071 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
36072 "it for any purpose."
36073 msgstr ""
36074
36075 #. type: textblock
36076 #: ../src/guestfs.pod:1859
36077 msgid ""
36078 "The return value is the event handle (an integer) which you can use to "
36079 "delete the callback (see below)."
36080 msgstr ""
36081
36082 #. type: textblock
36083 #: ../src/guestfs.pod:1862
36084 msgid ""
36085 "If there is an error, this function returns C<-1>, and sets the error in the "
36086 "handle in the usual way (see L</guestfs_last_error> etc.)"
36087 msgstr ""
36088
36089 #. type: textblock
36090 #: ../src/guestfs.pod:1865
36091 msgid ""
36092 "Callbacks remain in effect until they are deleted, or until the handle is "
36093 "closed."
36094 msgstr ""
36095
36096 #. type: textblock
36097 #: ../src/guestfs.pod:1868
36098 msgid ""
36099 "In the case where multiple callbacks are registered for a particular event "
36100 "class, all of the callbacks are called.  The order in which multiple "
36101 "callbacks are called is not defined."
36102 msgstr ""
36103
36104 #. type: =head3
36105 #: ../src/guestfs.pod:1872
36106 msgid "guestfs_delete_event_callback"
36107 msgstr ""
36108
36109 #. type: verbatim
36110 #: ../src/guestfs.pod:1874
36111 #, no-wrap
36112 msgid ""
36113 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
36114 "\n"
36115 msgstr ""
36116
36117 #. type: textblock
36118 #: ../src/guestfs.pod:1876
36119 msgid ""
36120 "Delete a callback that was previously registered.  C<event_handle> should be "
36121 "the integer that was returned by a previous call to "
36122 "C<guestfs_set_event_callback> on the same handle."
36123 msgstr ""
36124
36125 #. type: =head3
36126 #: ../src/guestfs.pod:1880
36127 msgid "guestfs_event_callback"
36128 msgstr ""
36129
36130 #. type: verbatim
36131 #: ../src/guestfs.pod:1882
36132 #, no-wrap
36133 msgid ""
36134 " typedef void (*guestfs_event_callback) (\n"
36135 "                  guestfs_h *g,\n"
36136 "                  void *opaque,\n"
36137 "                  uint64_t event,\n"
36138 "                  int event_handle,\n"
36139 "                  int flags,\n"
36140 "                  const char *buf, size_t buf_len,\n"
36141 "                  const uint64_t *array, size_t array_len);\n"
36142 "\n"
36143 msgstr ""
36144
36145 #. type: textblock
36146 #: ../src/guestfs.pod:1891
36147 msgid ""
36148 "This is the type of the event callback function that you have to provide."
36149 msgstr ""
36150
36151 #. type: textblock
36152 #: ../src/guestfs.pod:1894
36153 msgid ""
36154 "The basic parameters are: the handle (C<g>), the opaque user pointer "
36155 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
36156 "handle, and C<flags> which in the current API you should ignore."
36157 msgstr ""
36158
36159 #. type: textblock
36160 #: ../src/guestfs.pod:1898
36161 msgid ""
36162 "The remaining parameters contain the event payload (if any).  Each event may "
36163 "contain a payload, which usually relates to the event class, but for future "
36164 "proofing your code should be written to handle any payload for any event "
36165 "class."
36166 msgstr ""
36167
36168 #. type: textblock
36169 #: ../src/guestfs.pod:1903
36170 msgid ""
36171 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
36172 "there is no message buffer).  Note that this message buffer can contain "
36173 "arbitrary 8 bit data, including NUL bytes."
36174 msgstr ""
36175
36176 #. type: textblock
36177 #: ../src/guestfs.pod:1907
36178 msgid ""
36179 "C<array> and C<array_len> is an array of 64 bit unsigned integers.  At the "
36180 "moment this is only used for progress messages."
36181 msgstr ""
36182
36183 #. type: =head3
36184 #: ../src/guestfs.pod:1910
36185 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
36186 msgstr ""
36187
36188 #. type: textblock
36189 #: ../src/guestfs.pod:1912
36190 msgid ""
36191 "One motivation for the generic event API was to allow GUI programs to "
36192 "capture debug and other messages.  In libguestfs E<le> 1.8 these were sent "
36193 "unconditionally to C<stderr>."
36194 msgstr ""
36195
36196 #. type: textblock
36197 #: ../src/guestfs.pod:1916
36198 msgid ""
36199 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
36200 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>.  (Note that error "
36201 "messages are not events; you must capture error messages separately)."
36202 msgstr ""
36203
36204 #. type: textblock
36205 #: ../src/guestfs.pod:1921
36206 msgid ""
36207 "Programs have to set up a callback to capture the classes of events of "
36208 "interest:"
36209 msgstr ""
36210
36211 #. type: verbatim
36212 #: ../src/guestfs.pod:1924
36213 #, no-wrap
36214 msgid ""
36215 " int eh =\n"
36216 "   guestfs_set_event_callback\n"
36217 "     (g, message_callback,\n"
36218 "      GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
36219 "      GUESTFS_EVENT_TRACE,\n"
36220 "      0, NULL) == -1)\n"
36221 " if (eh == -1) {\n"
36222 "   // handle error in the usual way\n"
36223 " }\n"
36224 "\n"
36225 msgstr ""
36226
36227 #. type: textblock
36228 #: ../src/guestfs.pod:1934
36229 msgid ""
36230 "The callback can then direct messages to the appropriate place.  In this "
36231 "example, messages are directed to syslog:"
36232 msgstr ""
36233
36234 #. type: verbatim
36235 #: ../src/guestfs.pod:1937
36236 #, no-wrap
36237 msgid ""
36238 " static void\n"
36239 " message_callback (\n"
36240 "         guestfs_h *g,\n"
36241 "         void *opaque,\n"
36242 "         uint64_t event,\n"
36243 "         int event_handle,\n"
36244 "         int flags,\n"
36245 "         const char *buf, size_t buf_len,\n"
36246 "         const uint64_t *array, size_t array_len)\n"
36247 " {\n"
36248 "   const int priority = LOG_USER|LOG_INFO;\n"
36249 "   if (buf_len > 0)\n"
36250 "     syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
36251 " }\n"
36252 "\n"
36253 msgstr ""
36254
36255 #. type: =head1
36256 #: ../src/guestfs.pod:1952
36257 msgid "CANCELLING LONG TRANSFERS"
36258 msgstr ""
36259
36260 #. type: textblock
36261 #: ../src/guestfs.pod:1954
36262 msgid ""
36263 "Some operations can be cancelled by the caller while they are in progress.  "
36264 "Currently only operations that involve uploading or downloading data can be "
36265 "cancelled (technically: operations that have C<FileIn> or C<FileOut> "
36266 "parameters in the generator)."
36267 msgstr ""
36268
36269 #. type: =head2
36270 #: ../src/guestfs.pod:1959
36271 msgid "guestfs_user_cancel"
36272 msgstr ""
36273
36274 #. type: verbatim
36275 #: ../src/guestfs.pod:1961
36276 #, no-wrap
36277 msgid ""
36278 " void guestfs_user_cancel (guestfs_h *g);\n"
36279 "\n"
36280 msgstr ""
36281
36282 #. type: textblock
36283 #: ../src/guestfs.pod:1963
36284 msgid ""
36285 "C<guestfs_user_cancel> cancels the current upload or download operation."
36286 msgstr ""
36287
36288 #. type: textblock
36289 #: ../src/guestfs.pod:1966
36290 msgid ""
36291 "Unlike most other libguestfs calls, this function is signal safe and thread "
36292 "safe.  You can call it from a signal handler or from another thread, without "
36293 "needing to do any locking."
36294 msgstr ""
36295
36296 #. type: textblock
36297 #: ../src/guestfs.pod:1970
36298 msgid ""
36299 "The transfer that was in progress (if there is one) will stop shortly "
36300 "afterwards, and will return an error.  The errno (see L</"
36301 "guestfs_last_errno>) is set to C<EINTR>, so you can test for this to find "
36302 "out if the operation was cancelled or failed because of another error."
36303 msgstr ""
36304
36305 #. type: textblock
36306 #: ../src/guestfs.pod:1976
36307 msgid ""
36308 "No cleanup is performed: for example, if a file was being uploaded then "
36309 "after cancellation there may be a partially uploaded file.  It is the "
36310 "caller's responsibility to clean up if necessary."
36311 msgstr ""
36312
36313 #. type: textblock
36314 #: ../src/guestfs.pod:1980
36315 msgid "There are two common places that you might call C<guestfs_user_cancel>."
36316 msgstr ""
36317
36318 #. type: textblock
36319 #: ../src/guestfs.pod:1982
36320 msgid ""
36321 "In an interactive text-based program, you might call it from a C<SIGINT> "
36322 "signal handler so that pressing C<^C> cancels the current operation.  (You "
36323 "also need to call L</guestfs_set_pgroup> so that child processes don't "
36324 "receive the C<^C> signal)."
36325 msgstr ""
36326
36327 #. type: textblock
36328 #: ../src/guestfs.pod:1987
36329 msgid ""
36330 "In a graphical program, when the main thread is displaying a progress bar "
36331 "with a cancel button, wire up the cancel button to call this function."
36332 msgstr ""
36333
36334 #. type: =head1
36335 #: ../src/guestfs.pod:1991
36336 msgid "PRIVATE DATA AREA"
36337 msgstr ""
36338
36339 #. type: textblock
36340 #: ../src/guestfs.pod:1993
36341 msgid ""
36342 "You can attach named pieces of private data to the libguestfs handle, fetch "
36343 "them by name, and walk over them, for the lifetime of the handle.  This is "
36344 "called the private data area and is only available from the C API."
36345 msgstr ""
36346
36347 #. type: textblock
36348 #: ../src/guestfs.pod:1998
36349 msgid "To attach a named piece of data, use the following call:"
36350 msgstr ""
36351
36352 #. type: verbatim
36353 #: ../src/guestfs.pod:2000
36354 #, no-wrap
36355 msgid ""
36356 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
36357 "\n"
36358 msgstr ""
36359 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
36360 "\n"
36361
36362 #. type: textblock
36363 #: ../src/guestfs.pod:2002
36364 msgid ""
36365 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
36366 "pointer (which can be C<NULL>).  Any previous item with the same key is "
36367 "overwritten."
36368 msgstr ""
36369
36370 #. type: textblock
36371 #: ../src/guestfs.pod:2006
36372 msgid ""
36373 "You can use any C<key> you want, but your key should I<not> start with an "
36374 "underscore character.  Keys beginning with an underscore character are "
36375 "reserved for internal libguestfs purposes (eg. for implementing language "
36376 "bindings).  It is recommended that you prefix the key with some unique "
36377 "string to avoid collisions with other users."
36378 msgstr ""
36379
36380 #. type: textblock
36381 #: ../src/guestfs.pod:2012
36382 msgid "To retrieve the pointer, use:"
36383 msgstr ""
36384
36385 #. type: verbatim
36386 #: ../src/guestfs.pod:2014
36387 #, no-wrap
36388 msgid ""
36389 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
36390 "\n"
36391 msgstr ""
36392 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
36393 "\n"
36394
36395 #. type: textblock
36396 #: ../src/guestfs.pod:2016
36397 msgid ""
36398 "This function returns C<NULL> if either no data is found associated with "
36399 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
36400 "C<NULL>."
36401 msgstr ""
36402
36403 #. type: textblock
36404 #: ../src/guestfs.pod:2020
36405 msgid ""
36406 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
36407 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
36408 "all.  In particular, libguestfs does I<not> try to free the data when the "
36409 "handle is closed.  If the data must be freed, then the caller must either "
36410 "free it before calling L</guestfs_close> or must set up a close callback to "
36411 "do it (see L</GUESTFS_EVENT_CLOSE>)."
36412 msgstr ""
36413
36414 #. type: textblock
36415 #: ../src/guestfs.pod:2027
36416 msgid "To walk over all entries, use these two functions:"
36417 msgstr ""
36418
36419 #. type: verbatim
36420 #: ../src/guestfs.pod:2029
36421 #, no-wrap
36422 msgid ""
36423 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
36424 "\n"
36425 msgstr ""
36426
36427 #. type: verbatim
36428 #: ../src/guestfs.pod:2031
36429 #, no-wrap
36430 msgid ""
36431 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
36432 "\n"
36433 msgstr ""
36434
36435 #. type: textblock
36436 #: ../src/guestfs.pod:2033
36437 msgid ""
36438 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
36439 "not have any particular meaning -- keys are not returned in any defined "
36440 "order).  A pointer to the key is returned in C<*key_rtn> and the "
36441 "corresponding data pointer is returned from the function.  C<NULL> is "
36442 "returned if there are no keys stored in the handle."
36443 msgstr ""
36444
36445 #. type: textblock
36446 #: ../src/guestfs.pod:2039
36447 msgid ""
36448 "C<guestfs_next_private> returns the next key, pointer pair.  The return "
36449 "value of this function is also C<NULL> is there are no further entries to "
36450 "return."
36451 msgstr ""
36452
36453 #. type: textblock
36454 #: ../src/guestfs.pod:2043
36455 msgid "Notes about walking over entries:"
36456 msgstr ""
36457
36458 #. type: textblock
36459 #: ../src/guestfs.pod:2049
36460 msgid ""
36461 "You must not call C<guestfs_set_private> while walking over the entries."
36462 msgstr ""
36463
36464 #. type: textblock
36465 #: ../src/guestfs.pod:2054
36466 msgid ""
36467 "The handle maintains an internal iterator which is reset when you call "
36468 "C<guestfs_first_private>.  This internal iterator is invalidated when you "
36469 "call C<guestfs_set_private>."
36470 msgstr ""
36471
36472 #. type: textblock
36473 #: ../src/guestfs.pod:2060
36474 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
36475 msgstr ""
36476
36477 #. type: verbatim
36478 #: ../src/guestfs.pod:2062
36479 #, no-wrap
36480 msgid ""
36481 " guestfs_set_private (g, key, NULL);\n"
36482 "\n"
36483 msgstr ""
36484
36485 #. type: textblock
36486 #: ../src/guestfs.pod:2064
36487 msgid "then that C<key> is not returned when walking."
36488 msgstr ""
36489
36490 #. type: textblock
36491 #: ../src/guestfs.pod:2068
36492 msgid ""
36493 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
36494 "C<guestfs_next_private> or C<guestfs_set_private>."
36495 msgstr ""
36496
36497 #. type: textblock
36498 #: ../src/guestfs.pod:2074
36499 msgid ""
36500 "The following example code shows how to print all keys and data pointers "
36501 "that are associated with the handle C<g>:"
36502 msgstr ""
36503
36504 #. type: verbatim
36505 #: ../src/guestfs.pod:2077
36506 #, no-wrap
36507 msgid ""
36508 " const char *key;\n"
36509 " void *data = guestfs_first_private (g, &key);\n"
36510 " while (data != NULL)\n"
36511 "   {\n"
36512 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
36513 "     data = guestfs_next_private (g, &key);\n"
36514 "   }\n"
36515 "\n"
36516 msgstr ""
36517
36518 #. type: textblock
36519 #: ../src/guestfs.pod:2085
36520 msgid ""
36521 "More commonly you are only interested in keys that begin with an application-"
36522 "specific prefix C<foo_>.  Modify the loop like so:"
36523 msgstr ""
36524
36525 #. type: verbatim
36526 #: ../src/guestfs.pod:2088
36527 #, no-wrap
36528 msgid ""
36529 " const char *key;\n"
36530 " void *data = guestfs_first_private (g, &key);\n"
36531 " while (data != NULL)\n"
36532 "   {\n"
36533 "     if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
36534 "       printf (\"key = %s, data = %p\\n\", key, data);\n"
36535 "     data = guestfs_next_private (g, &key);\n"
36536 "   }\n"
36537 "\n"
36538 msgstr ""
36539
36540 #. type: textblock
36541 #: ../src/guestfs.pod:2097
36542 msgid ""
36543 "If you need to modify keys while walking, then you have to jump back to the "
36544 "beginning of the loop.  For example, to delete all keys prefixed with "
36545 "C<foo_>:"
36546 msgstr ""
36547
36548 #. type: verbatim
36549 #: ../src/guestfs.pod:2101
36550 #, no-wrap
36551 msgid ""
36552 "  const char *key;\n"
36553 "  void *data;\n"
36554 " again:\n"
36555 "  data = guestfs_first_private (g, &key);\n"
36556 "  while (data != NULL)\n"
36557 "    {\n"
36558 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
36559 "        {\n"
36560 "          guestfs_set_private (g, key, NULL);\n"
36561 "          /* note that 'key' pointer is now invalid, and so is\n"
36562 "             the internal iterator */\n"
36563 "          goto again;\n"
36564 "        }\n"
36565 "      data = guestfs_next_private (g, &key);\n"
36566 "    }\n"
36567 "\n"
36568 msgstr ""
36569
36570 #. type: textblock
36571 #: ../src/guestfs.pod:2117
36572 msgid ""
36573 "Note that the above loop is guaranteed to terminate because the keys are "
36574 "being deleted, but other manipulations of keys within the loop might not "
36575 "terminate unless you also maintain an indication of which keys have been "
36576 "visited."
36577 msgstr ""
36578
36579 #. type: =end
36580 #: ../src/guestfs.pod:2122 ../src/guestfs.pod:2127
36581 msgid "html"
36582 msgstr "html"
36583
36584 #. type: textblock
36585 #: ../src/guestfs.pod:2124
36586 msgid ""
36587 "<!-- old anchor for the next section --> <a name="
36588 "\"state_machine_and_low_level_event_api\"/>"
36589 msgstr ""
36590 "<!-- old anchor for the next section --> <a name="
36591 "\"state_machine_and_low_level_event_api\"/>"
36592
36593 #. type: =head1
36594 #: ../src/guestfs.pod:2129
36595 msgid "ARCHITECTURE"
36596 msgstr "АРХІТЕКТУРА"
36597
36598 #. type: textblock
36599 #: ../src/guestfs.pod:2131
36600 msgid ""
36601 "Internally, libguestfs is implemented by running an appliance (a special "
36602 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
36603 "process of the main program."
36604 msgstr ""
36605
36606 #. type: verbatim
36607 #: ../src/guestfs.pod:2135
36608 #, no-wrap
36609 msgid ""
36610 "  ___________________\n"
36611 " /                   \\\n"
36612 " | main program      |\n"
36613 " |                   |\n"
36614 " |                   |           child process / appliance\n"
36615 " |                   |           __________________________\n"
36616 " |                   |          / qemu                     \\\n"
36617 " +-------------------+   RPC    |      +-----------------+ |\n"
36618 " | libguestfs     <--------------------> guestfsd        | |\n"
36619 " |                   |          |      +-----------------+ |\n"
36620 " \\___________________/          |      | Linux kernel    | |\n"
36621 "                                |      +--^--------------+ |\n"
36622 "                                \\_________|________________/\n"
36623 "                                          |\n"
36624 "                                   _______v______\n"
36625 "                                  /              \\\n"
36626 "                                  | Device or    |\n"
36627 "                                  | disk image   |\n"
36628 "                                  \\______________/\n"
36629 "\n"
36630 msgstr ""
36631
36632 #. type: textblock
36633 #: ../src/guestfs.pod:2155
36634 msgid ""
36635 "The library, linked to the main program, creates the child process and hence "
36636 "the appliance in the L</guestfs_launch> function."
36637 msgstr ""
36638
36639 #. type: textblock
36640 #: ../src/guestfs.pod:2158
36641 msgid ""
36642 "Inside the appliance is a Linux kernel and a complete stack of userspace "
36643 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
36644 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
36645 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
36646 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
36647 "attached to the qemu process which translates device access by the "
36648 "appliance's Linux kernel into accesses to the image."
36649 msgstr ""
36650
36651 #. type: textblock
36652 #: ../src/guestfs.pod:2167
36653 msgid ""
36654 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
36655 "Although the disk image you are attached to might also be used by some "
36656 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
36657 "care if both libguestfs's qemu process and your virtual machine are trying "
36658 "to update the disk image at the same time, since these usually results in "
36659 "massive disk corruption)."
36660 msgstr ""
36661
36662 #. type: =head1
36663 #: ../src/guestfs.pod:2174
36664 msgid "STATE MACHINE"
36665 msgstr "СКІНЧЕННИЙ АВТОМАТ"
36666
36667 #. type: textblock
36668 #: ../src/guestfs.pod:2176
36669 msgid "libguestfs uses a state machine to model the child process:"
36670 msgstr ""
36671
36672 #. type: verbatim
36673 #: ../src/guestfs.pod:2178
36674 #, no-wrap
36675 msgid ""
36676 "                         |\n"
36677 "                    guestfs_create\n"
36678 "                         |\n"
36679 "                         |\n"
36680 "                     ____V_____\n"
36681 "                    /          \\\n"
36682 "                    |  CONFIG  |\n"
36683 "                    \\__________/\n"
36684 "                     ^ ^   ^  \\\n"
36685 "                    /  |    \\  \\ guestfs_launch\n"
36686 "                   /   |    _\\__V______\n"
36687 "                  /    |   /           \\\n"
36688 "                 /     |   | LAUNCHING |\n"
36689 "                /      |   \\___________/\n"
36690 "               /       |       /\n"
36691 "              /        |  guestfs_launch\n"
36692 "             /         |     /\n"
36693 "    ______  /        __|____V\n"
36694 "   /      \\ ------> /        \\\n"
36695 "   | BUSY |         | READY  |\n"
36696 "   \\______/ <------ \\________/\n"
36697 "\n"
36698 msgstr ""
36699
36700 #. type: textblock
36701 #: ../src/guestfs.pod:2200
36702 msgid ""
36703 "The normal transitions are (1) CONFIG (when the handle is created, but there "
36704 "is no child process), (2) LAUNCHING (when the child process is booting up), "
36705 "(3) alternating between READY and BUSY as commands are issued to, and "
36706 "carried out by, the child process."
36707 msgstr ""
36708
36709 #. type: textblock
36710 #: ../src/guestfs.pod:2205
36711 msgid ""
36712 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
36713 "asynchronously at any time (eg. due to some internal error), and that causes "
36714 "the state to transition back to CONFIG."
36715 msgstr ""
36716
36717 #. type: textblock
36718 #: ../src/guestfs.pod:2209
36719 msgid ""
36720 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
36721 "issued when in the CONFIG state."
36722 msgstr ""
36723
36724 #. type: textblock
36725 #: ../src/guestfs.pod:2212
36726 msgid ""
36727 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
36728 "L</guestfs_launch> blocks until the child process is READY to accept "
36729 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
36730 "moves the state from CONFIG to LAUNCHING while it is running."
36731 msgstr ""
36732
36733 #. type: textblock
36734 #: ../src/guestfs.pod:2218
36735 msgid ""
36736 "API actions such as L</guestfs_mount> can only be issued when in the READY "
36737 "state.  These API calls block waiting for the command to be carried out (ie. "
36738 "the state to transition to BUSY and then back to READY).  There are no non-"
36739 "blocking versions, and no way to issue more than one command per handle at "
36740 "the same time."
36741 msgstr ""
36742
36743 #. type: textblock
36744 #: ../src/guestfs.pod:2224
36745 msgid ""
36746 "Finally, the child process sends asynchronous messages back to the main "
36747 "program, such as kernel log messages.  You can register a callback to "
36748 "receive these messages."
36749 msgstr ""
36750
36751 #. type: =head1
36752 #: ../src/guestfs.pod:2228
36753 msgid "INTERNALS"
36754 msgstr ""
36755
36756 #. type: =head2
36757 #: ../src/guestfs.pod:2230
36758 msgid "COMMUNICATION PROTOCOL"
36759 msgstr ""
36760
36761 #. type: textblock
36762 #: ../src/guestfs.pod:2232
36763 msgid ""
36764 "Don't rely on using this protocol directly.  This section documents how it "
36765 "currently works, but it may change at any time."
36766 msgstr ""
36767
36768 #. type: textblock
36769 #: ../src/guestfs.pod:2235
36770 msgid ""
36771 "The protocol used to talk between the library and the daemon running inside "
36772 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
36773 "1014, RFC 1832, RFC 4506)."
36774 msgstr ""
36775
36776 #. type: textblock
36777 #: ../src/guestfs.pod:2239
36778 msgid ""
36779 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
36780 "this file is automatically generated)."
36781 msgstr ""
36782
36783 #. type: textblock
36784 #: ../src/guestfs.pod:2242
36785 msgid ""
36786 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
36787 "and C<FileOut> parameters, which are handled with very simple request/reply "
36788 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
36789 "parameters, which use the same request and reply messages, but they may also "
36790 "be followed by files sent using a chunked encoding."
36791 msgstr ""
36792
36793 #. type: =head3
36794 #: ../src/guestfs.pod:2249
36795 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
36796 msgstr ""
36797
36798 #. type: textblock
36799 #: ../src/guestfs.pod:2251
36800 msgid "For ordinary functions, the request message is:"
36801 msgstr ""
36802
36803 #. type: verbatim
36804 #: ../src/guestfs.pod:2253
36805 #, no-wrap
36806 msgid ""
36807 " total length (header + arguments,\n"
36808 "      but not including the length word itself)\n"
36809 " struct guestfs_message_header (encoded as XDR)\n"
36810 " struct guestfs_<foo>_args (encoded as XDR)\n"
36811 "\n"
36812 msgstr ""
36813
36814 #. type: textblock
36815 #: ../src/guestfs.pod:2258
36816 msgid ""
36817 "The total length field allows the daemon to allocate a fixed size buffer "
36818 "into which it slurps the rest of the message.  As a result, the total length "
36819 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
36820 "effective size of any request is limited to somewhere under this size."
36821 msgstr ""
36822
36823 #. type: textblock
36824 #: ../src/guestfs.pod:2264
36825 msgid ""
36826 "Note also that many functions don't take any arguments, in which case the "
36827 "C<guestfs_I<foo>_args> is completely omitted."
36828 msgstr ""
36829
36830 #. type: textblock
36831 #: ../src/guestfs.pod:2267
36832 msgid ""
36833 "The header contains the procedure number (C<guestfs_proc>) which is how the "
36834 "receiver knows what type of args structure to expect, or none at all."
36835 msgstr ""
36836
36837 #. type: textblock
36838 #: ../src/guestfs.pod:2271
36839 msgid ""
36840 "For functions that take optional arguments, the optional arguments are "
36841 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
36842 "arguments.  A bitmask in the header indicates which optional arguments are "
36843 "meaningful.  The bitmask is also checked to see if it contains bits set "
36844 "which the daemon does not know about (eg. if more optional arguments were "
36845 "added in a later version of the library), and this causes the call to be "
36846 "rejected."
36847 msgstr ""
36848
36849 #. type: textblock
36850 #: ../src/guestfs.pod:2279
36851 msgid "The reply message for ordinary functions is:"
36852 msgstr ""
36853
36854 #. type: verbatim
36855 #: ../src/guestfs.pod:2281
36856 #, no-wrap
36857 msgid ""
36858 " total length (header + ret,\n"
36859 "      but not including the length word itself)\n"
36860 " struct guestfs_message_header (encoded as XDR)\n"
36861 " struct guestfs_<foo>_ret (encoded as XDR)\n"
36862 "\n"
36863 msgstr ""
36864
36865 #. type: textblock
36866 #: ../src/guestfs.pod:2286
36867 msgid ""
36868 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
36869 "functions that return no formal return values."
36870 msgstr ""
36871
36872 #. type: textblock
36873 #: ../src/guestfs.pod:2289
36874 msgid ""
36875 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
36876 msgstr ""
36877
36878 #. type: textblock
36879 #: ../src/guestfs.pod:2292
36880 msgid ""
36881 "In the case of an error, a flag is set in the header, and the reply message "
36882 "is slightly changed:"
36883 msgstr ""
36884
36885 #. type: verbatim
36886 #: ../src/guestfs.pod:2295
36887 #, no-wrap
36888 msgid ""
36889 " total length (header + error,\n"
36890 "      but not including the length word itself)\n"
36891 " struct guestfs_message_header (encoded as XDR)\n"
36892 " struct guestfs_message_error (encoded as XDR)\n"
36893 "\n"
36894 msgstr ""
36895
36896 #. type: textblock
36897 #: ../src/guestfs.pod:2300
36898 msgid ""
36899 "The C<guestfs_message_error> structure contains the error message as a "
36900 "string."
36901 msgstr ""
36902
36903 #. type: =head3
36904 #: ../src/guestfs.pod:2303
36905 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
36906 msgstr ""
36907
36908 #. type: textblock
36909 #: ../src/guestfs.pod:2305
36910 msgid ""
36911 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
36912 "The normal request message is sent (see above).  However this is followed by "
36913 "a sequence of file chunks."
36914 msgstr ""
36915
36916 #. type: verbatim
36917 #: ../src/guestfs.pod:2309
36918 #, no-wrap
36919 msgid ""
36920 " total length (header + arguments,\n"
36921 "      but not including the length word itself,\n"
36922 "      and not including the chunks)\n"
36923 " struct guestfs_message_header (encoded as XDR)\n"
36924 " struct guestfs_<foo>_args (encoded as XDR)\n"
36925 " sequence of chunks for FileIn param #0\n"
36926 " sequence of chunks for FileIn param #1 etc.\n"
36927 "\n"
36928 msgstr ""
36929
36930 #. type: textblock
36931 #: ../src/guestfs.pod:2317
36932 msgid "The \"sequence of chunks\" is:"
36933 msgstr ""
36934
36935 #. type: verbatim
36936 #: ../src/guestfs.pod:2319
36937 #, no-wrap
36938 msgid ""
36939 " length of chunk (not including length word itself)\n"
36940 " struct guestfs_chunk (encoded as XDR)\n"
36941 " length of chunk\n"
36942 " struct guestfs_chunk (encoded as XDR)\n"
36943 "   ...\n"
36944 " length of chunk\n"
36945 " struct guestfs_chunk (with data.data_len == 0)\n"
36946 "\n"
36947 msgstr ""
36948
36949 #. type: textblock
36950 #: ../src/guestfs.pod:2327
36951 msgid ""
36952 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
36953 "is set in the final chunk to indicate either successful completion or early "
36954 "cancellation."
36955 msgstr ""
36956
36957 #. type: textblock
36958 #: ../src/guestfs.pod:2331
36959 msgid ""
36960 "At time of writing there are no functions that have more than one FileIn "
36961 "parameter.  However this is (theoretically) supported, by sending the "
36962 "sequence of chunks for each FileIn parameter one after another (from left to "
36963 "right)."
36964 msgstr ""
36965
36966 #. type: textblock
36967 #: ../src/guestfs.pod:2336
36968 msgid ""
36969 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
36970 "transfer.  The library does this by sending a chunk with a special flag set "
36971 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
36972 "RPC, does I<not> send any reply, and goes back to reading the next request."
36973 msgstr ""
36974
36975 #. type: textblock
36976 #: ../src/guestfs.pod:2342
36977 msgid ""
36978 "The daemon may also cancel.  It does this by writing a special word "
36979 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
36980 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
36981 "cancel chunk).  The special word is chosen so that even if cancellation "
36982 "happens right at the end of the transfer (after the library has finished "
36983 "writing and has started listening for the reply), the \"spurious\" cancel "
36984 "flag will not be confused with the reply message."
36985 msgstr ""
36986
36987 #. type: textblock
36988 #: ../src/guestfs.pod:2351
36989 msgid ""
36990 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
36991 "limit), and also files where the size is not known in advance (eg. from "
36992 "pipes or sockets).  However the chunks are rather small "
36993 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
36994 "to keep much in memory."
36995 msgstr ""
36996
36997 #. type: =head3
36998 #: ../src/guestfs.pod:2357
36999 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
37000 msgstr ""
37001
37002 #. type: textblock
37003 #: ../src/guestfs.pod:2359
37004 msgid ""
37005 "The protocol for FileOut parameters is exactly the same as for FileIn "
37006 "parameters, but with the roles of daemon and library reversed."
37007 msgstr ""
37008
37009 #. type: verbatim
37010 #: ../src/guestfs.pod:2362
37011 #, no-wrap
37012 msgid ""
37013 " total length (header + ret,\n"
37014 "      but not including the length word itself,\n"
37015 "      and not including the chunks)\n"
37016 " struct guestfs_message_header (encoded as XDR)\n"
37017 " struct guestfs_<foo>_ret (encoded as XDR)\n"
37018 " sequence of chunks for FileOut param #0\n"
37019 " sequence of chunks for FileOut param #1 etc.\n"
37020 "\n"
37021 msgstr ""
37022
37023 #. type: =head3
37024 #: ../src/guestfs.pod:2370
37025 msgid "INITIAL MESSAGE"
37026 msgstr ""
37027
37028 #. type: textblock
37029 #: ../src/guestfs.pod:2372
37030 msgid ""
37031 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
37032 "which indicates that the guest and daemon is alive.  This is what L</"
37033 "guestfs_launch> waits for."
37034 msgstr ""
37035
37036 #. type: =head3
37037 #: ../src/guestfs.pod:2376
37038 msgid "PROGRESS NOTIFICATION MESSAGES"
37039 msgstr ""
37040
37041 #. type: textblock
37042 #: ../src/guestfs.pod:2378
37043 msgid ""
37044 "The daemon may send progress notification messages at any time.  These are "
37045 "distinguished by the normal length word being replaced by "
37046 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
37047 msgstr ""
37048
37049 #. type: textblock
37050 #: ../src/guestfs.pod:2382
37051 msgid ""
37052 "The library turns them into progress callbacks (see L</"
37053 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
37054 "if not."
37055 msgstr ""
37056
37057 #. type: textblock
37058 #: ../src/guestfs.pod:2386
37059 msgid ""
37060 "The daemon self-limits the frequency of progress messages it sends (see "
37061 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
37062 "messages."
37063 msgstr ""
37064
37065 #. type: =head1
37066 #: ../src/guestfs.pod:2390
37067 msgid "LIBGUESTFS VERSION NUMBERS"
37068 msgstr ""
37069
37070 #. type: textblock
37071 #: ../src/guestfs.pod:2392
37072 msgid ""
37073 "Since April 2010, libguestfs has started to make separate development and "
37074 "stable releases, along with corresponding branches in our git repository.  "
37075 "These separate releases can be identified by version number:"
37076 msgstr ""
37077
37078 #. type: verbatim
37079 #: ../src/guestfs.pod:2397
37080 #, no-wrap
37081 msgid ""
37082 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
37083 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
37084 "       |\n"
37085 "       v\n"
37086 " 1  .  3  .  5\n"
37087 " ^           ^\n"
37088 " |           |\n"
37089 " |           `-------- sub-version\n"
37090 " |\n"
37091 " `------ always '1' because we don't change the ABI\n"
37092 "\n"
37093 msgstr ""
37094
37095 #. type: textblock
37096 #: ../src/guestfs.pod:2408
37097 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
37098 msgstr ""
37099
37100 #. type: textblock
37101 #: ../src/guestfs.pod:2410
37102 msgid ""
37103 "As time passes we cherry pick fixes from the development branch and backport "
37104 "those into the stable branch, the effect being that the stable branch should "
37105 "get more stable and less buggy over time.  So the stable releases are ideal "
37106 "for people who don't need new features but would just like the software to "
37107 "work."
37108 msgstr ""
37109
37110 #. type: textblock
37111 #: ../src/guestfs.pod:2416
37112 msgid "Our criteria for backporting changes are:"
37113 msgstr ""
37114
37115 #. type: textblock
37116 #: ../src/guestfs.pod:2422
37117 msgid ""
37118 "Documentation changes which don't affect any code are backported unless the "
37119 "documentation refers to a future feature which is not in stable."
37120 msgstr ""
37121
37122 #. type: textblock
37123 #: ../src/guestfs.pod:2428
37124 msgid ""
37125 "Bug fixes which are not controversial, fix obvious problems, and have been "
37126 "well tested are backported."
37127 msgstr ""
37128
37129 #. type: textblock
37130 #: ../src/guestfs.pod:2433
37131 msgid ""
37132 "Simple rearrangements of code which shouldn't affect how it works get "
37133 "backported.  This is so that the code in the two branches doesn't get too "
37134 "far out of step, allowing us to backport future fixes more easily."
37135 msgstr ""
37136
37137 #. type: textblock
37138 #: ../src/guestfs.pod:2439
37139 msgid ""
37140 "We I<don't> backport new features, new APIs, new tools etc, except in one "
37141 "exceptional case: the new feature is required in order to implement an "
37142 "important bug fix."
37143 msgstr ""
37144
37145 #. type: textblock
37146 #: ../src/guestfs.pod:2445
37147 msgid ""
37148 "A new stable branch starts when we think the new features in development are "
37149 "substantial and compelling enough over the current stable branch to warrant "
37150 "it.  When that happens we create new stable and development versions 1.N.0 "
37151 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
37152 "stable at this point, but by backporting fixes from development, that branch "
37153 "will stabilize over time."
37154 msgstr ""
37155
37156 #. type: =head1
37157 #: ../src/guestfs.pod:2453
37158 msgid "EXTENDING LIBGUESTFS"
37159 msgstr ""
37160
37161 #. type: =head2
37162 #: ../src/guestfs.pod:2455
37163 msgid "ADDING A NEW API ACTION"
37164 msgstr ""
37165
37166 #. type: textblock
37167 #: ../src/guestfs.pod:2457
37168 msgid ""
37169 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
37170 "documentation) are generated, and this makes it easy to extend the "
37171 "libguestfs API."
37172 msgstr ""
37173
37174 #. type: textblock
37175 #: ../src/guestfs.pod:2461
37176 msgid "To add a new API action there are two changes:"
37177 msgstr ""
37178
37179 #. type: textblock
37180 #: ../src/guestfs.pod:2467
37181 msgid ""
37182 "You need to add a description of the call (name, parameters, return type, "
37183 "tests, documentation) to C<generator/generator_actions.ml>."
37184 msgstr ""
37185
37186 #. type: textblock
37187 #: ../src/guestfs.pod:2470
37188 msgid ""
37189 "There are two sorts of API action, depending on whether the call goes "
37190 "through to the daemon in the appliance, or is serviced entirely by the "
37191 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
37192 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
37193 "an example of the latter, since a trace flag is maintained in the handle and "
37194 "all tracing is done on the library side."
37195 msgstr ""
37196
37197 #. type: textblock
37198 #: ../src/guestfs.pod:2478
37199 msgid ""
37200 "Most new actions are of the first type, and get added to the "
37201 "C<daemon_functions> list.  Each function has a unique procedure number used "
37202 "in the RPC protocol which is assigned to that action when we publish "
37203 "libguestfs and cannot be reused.  Take the latest procedure number and "
37204 "increment it."
37205 msgstr ""
37206
37207 #. type: textblock
37208 #: ../src/guestfs.pod:2484
37209 msgid ""
37210 "For library-only actions of the second type, add to the "
37211 "C<non_daemon_functions> list.  Since these functions are serviced by the "
37212 "library and do not travel over the RPC mechanism to the daemon, these "
37213 "functions do not need a procedure number, and so the procedure number is set "
37214 "to C<-1>."
37215 msgstr ""
37216
37217 #. type: textblock
37218 #: ../src/guestfs.pod:2492
37219 msgid "Implement the action (in C):"
37220 msgstr ""
37221
37222 #. type: textblock
37223 #: ../src/guestfs.pod:2494
37224 msgid ""
37225 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
37226 "C<daemon/> directory."
37227 msgstr ""
37228
37229 #. type: textblock
37230 #: ../src/guestfs.pod:2497
37231 msgid ""
37232 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
37233 "(note: double underscore) in the C<src/> directory."
37234 msgstr ""
37235
37236 #. type: textblock
37237 #: ../src/guestfs.pod:2500
37238 msgid "In either case, use another function as an example of what to do."
37239 msgstr ""
37240
37241 #. type: textblock
37242 #: ../src/guestfs.pod:2504
37243 msgid "After making these changes, use C<make> to compile."
37244 msgstr ""
37245
37246 #. type: textblock
37247 #: ../src/guestfs.pod:2506
37248 msgid ""
37249 "Note that you don't need to implement the RPC, language bindings, manual "
37250 "pages or anything else.  It's all automatically generated from the OCaml "
37251 "description."
37252 msgstr ""
37253
37254 #. type: =head2
37255 #: ../src/guestfs.pod:2510
37256 msgid "ADDING TESTS FOR AN API ACTION"
37257 msgstr ""
37258
37259 #. type: textblock
37260 #: ../src/guestfs.pod:2512
37261 msgid ""
37262 "You can supply zero or as many tests as you want per API call.  The tests "
37263 "can either be added as part of the API description (C<generator/"
37264 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
37265 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
37266 "slower, so if possible use the first method."
37267 msgstr ""
37268
37269 #. type: textblock
37270 #: ../src/guestfs.pod:2518
37271 msgid ""
37272 "The following describes the test environment used when you add an API test "
37273 "in C<generator_actions.ml>."
37274 msgstr ""
37275
37276 #. type: textblock
37277 #: ../src/guestfs.pod:2521
37278 msgid "The test environment has 4 block devices:"
37279 msgstr ""
37280
37281 #. type: =item
37282 #: ../src/guestfs.pod:2525
37283 msgid "C</dev/sda> 500MB"
37284 msgstr "C</dev/sda> 500 МБ"
37285
37286 #. type: textblock
37287 #: ../src/guestfs.pod:2527
37288 msgid "General block device for testing."
37289 msgstr ""
37290
37291 #. type: =item
37292 #: ../src/guestfs.pod:2529
37293 msgid "C</dev/sdb> 50MB"
37294 msgstr "C</dev/sdb> 50 МБ"
37295
37296 #. type: textblock
37297 #: ../src/guestfs.pod:2531
37298 msgid ""
37299 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
37300 "operations."
37301 msgstr ""
37302
37303 #. type: =item
37304 #: ../src/guestfs.pod:2534
37305 msgid "C</dev/sdc> 10MB"
37306 msgstr "C</dev/sdc> 10 МБ"
37307
37308 #. type: textblock
37309 #: ../src/guestfs.pod:2536
37310 msgid "Used in a few tests where two block devices are needed."
37311 msgstr ""
37312
37313 #. type: =item
37314 #: ../src/guestfs.pod:2538
37315 msgid "C</dev/sdd>"
37316 msgstr "C</dev/sdd>"
37317
37318 #. type: textblock
37319 #: ../src/guestfs.pod:2540
37320 msgid "ISO with fixed content (see C<images/test.iso>)."
37321 msgstr ""
37322
37323 #. type: textblock
37324 #: ../src/guestfs.pod:2544
37325 msgid ""
37326 "To be able to run the tests in a reasonable amount of time, the libguestfs "
37327 "appliance and block devices are reused between tests.  So don't try testing "
37328 "L</guestfs_kill_subprocess> :-x"
37329 msgstr ""
37330
37331 #. type: textblock
37332 #: ../src/guestfs.pod:2548
37333 msgid ""
37334 "Each test starts with an initial scenario, selected using one of the "
37335 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
37336 "initialize the disks mentioned above in a particular way as documented in "
37337 "C<generator_types.ml>.  You should not assume anything about the previous "
37338 "contents of other disks that are not initialized."
37339 msgstr ""
37340
37341 #. type: textblock
37342 #: ../src/guestfs.pod:2554
37343 msgid ""
37344 "You can add a prerequisite clause to any individual test.  This is a run-"
37345 "time check, which, if it fails, causes the test to be skipped.  Useful if "
37346 "testing a command which might not work on all variations of libguestfs "
37347 "builds.  A test that has prerequisite of C<Always> means to run "
37348 "unconditionally."
37349 msgstr ""
37350
37351 #. type: textblock
37352 #: ../src/guestfs.pod:2560
37353 msgid ""
37354 "In addition, packagers can skip individual tests by setting environment "
37355 "variables before running C<make check>."
37356 msgstr ""
37357
37358 #. type: verbatim
37359 #: ../src/guestfs.pod:2563
37360 #, no-wrap
37361 msgid ""
37362 " SKIP_TEST_<CMD>_<NUM>=1\n"
37363 "\n"
37364 msgstr ""
37365
37366 #. type: textblock
37367 #: ../src/guestfs.pod:2565
37368 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
37369 msgstr ""
37370
37371 #. type: textblock
37372 #: ../src/guestfs.pod:2567
37373 msgid "or:"
37374 msgstr "або:"
37375
37376 #. type: verbatim
37377 #: ../src/guestfs.pod:2569
37378 #, no-wrap
37379 msgid ""
37380 " SKIP_TEST_<CMD>=1\n"
37381 "\n"
37382 msgstr ""
37383
37384 #. type: textblock
37385 #: ../src/guestfs.pod:2571
37386 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
37387 msgstr ""
37388
37389 #. type: textblock
37390 #: ../src/guestfs.pod:2573
37391 msgid "Packagers can run only certain tests by setting for example:"
37392 msgstr ""
37393
37394 #. type: verbatim
37395 #: ../src/guestfs.pod:2575
37396 #, no-wrap
37397 msgid ""
37398 " TEST_ONLY=\"vfs_type zerofree\"\n"
37399 "\n"
37400 msgstr ""
37401
37402 #. type: textblock
37403 #: ../src/guestfs.pod:2577
37404 msgid ""
37405 "See C<capitests/tests.c> for more details of how these environment variables "
37406 "work."
37407 msgstr ""
37408
37409 #. type: =head2
37410 #: ../src/guestfs.pod:2580
37411 msgid "DEBUGGING NEW API ACTIONS"
37412 msgstr ""
37413
37414 #. type: textblock
37415 #: ../src/guestfs.pod:2582
37416 msgid "Test new actions work before submitting them."
37417 msgstr ""
37418
37419 #. type: textblock
37420 #: ../src/guestfs.pod:2584
37421 msgid "You can use guestfish to try out new commands."
37422 msgstr ""
37423
37424 #. type: textblock
37425 #: ../src/guestfs.pod:2586
37426 msgid ""
37427 "Debugging the daemon is a problem because it runs inside a minimal "
37428 "environment.  However you can fprintf messages in the daemon to stderr, and "
37429 "they will show up if you use C<guestfish -v>."
37430 msgstr ""
37431
37432 #. type: =head2
37433 #: ../src/guestfs.pod:2590
37434 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
37435 msgstr ""
37436
37437 #. type: textblock
37438 #: ../src/guestfs.pod:2592
37439 msgid ""
37440 "Our C source code generally adheres to some basic code-formatting "
37441 "conventions.  The existing code base is not totally consistent on this "
37442 "front, but we do prefer that contributed code be formatted similarly.  In "
37443 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
37444 "indentation level, and other than that, follow the K&R style."
37445 msgstr ""
37446
37447 #. type: textblock
37448 #: ../src/guestfs.pod:2598
37449 msgid ""
37450 "If you use Emacs, add the following to one of one of your start-up files (e."
37451 "g., ~/.emacs), to help ensure that you get indentation right:"
37452 msgstr ""
37453
37454 #. type: verbatim
37455 #: ../src/guestfs.pod:2601
37456 #, no-wrap
37457 msgid ""
37458 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
37459 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
37460 " (add-hook 'find-file-hook\n"
37461 "     '(lambda () (if (and buffer-file-name\n"
37462 "                          (string-match \"/libguestfs\\\\>\"\n"
37463 "                              (buffer-file-name))\n"
37464 "                          (not (string-equal mode-name \"Change Log\"))\n"
37465 "                          (not (string-equal mode-name \"Makefile\")))\n"
37466 "                     (setq indent-tabs-mode nil))))\n"
37467 " \n"
37468 msgstr ""
37469
37470 #. type: verbatim
37471 #: ../src/guestfs.pod:2611
37472 #, no-wrap
37473 msgid ""
37474 " ;;; When editing C sources in libguestfs, use this style.\n"
37475 " (defun libguestfs-c-mode ()\n"
37476 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
37477 "   (interactive)\n"
37478 "   (c-set-style \"K&R\")\n"
37479 "   (setq c-indent-level 2)\n"
37480 "   (setq c-basic-offset 2))\n"
37481 " (add-hook 'c-mode-hook\n"
37482 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
37483 "                               (buffer-file-name))\n"
37484 "                           (libguestfs-c-mode))))\n"
37485 "\n"
37486 msgstr ""
37487
37488 #. type: textblock
37489 #: ../src/guestfs.pod:2623
37490 msgid "Enable warnings when compiling (and fix any problems this finds):"
37491 msgstr ""
37492
37493 #. type: verbatim
37494 #: ../src/guestfs.pod:2626
37495 #, no-wrap
37496 msgid ""
37497 " ./configure --enable-gcc-warnings\n"
37498 "\n"
37499 msgstr ""
37500 " ./configure --enable-gcc-warnings\n"
37501 "\n"
37502
37503 #. type: textblock
37504 #: ../src/guestfs.pod:2628
37505 msgid "Useful targets are:"
37506 msgstr ""
37507
37508 #. type: verbatim
37509 #: ../src/guestfs.pod:2630
37510 #, no-wrap
37511 msgid ""
37512 " make syntax-check  # checks the syntax of the C code\n"
37513 " make check         # runs the test suite\n"
37514 "\n"
37515 msgstr ""
37516
37517 #. type: =head2
37518 #: ../src/guestfs.pod:2633
37519 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
37520 msgstr ""
37521
37522 #. type: textblock
37523 #: ../src/guestfs.pod:2635
37524 msgid ""
37525 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
37526 "which are used to do shell quoting."
37527 msgstr ""
37528
37529 #. type: =item
37530 #: ../src/guestfs.pod:2640
37531 msgid "%Q"
37532 msgstr "%Q"
37533
37534 #. type: textblock
37535 #: ../src/guestfs.pod:2642
37536 msgid ""
37537 "Simple shell quoted string.  Any spaces or other shell characters are "
37538 "escaped for you."
37539 msgstr ""
37540
37541 #. type: =item
37542 #: ../src/guestfs.pod:2645
37543 msgid "%R"
37544 msgstr "%R"
37545
37546 #. type: textblock
37547 #: ../src/guestfs.pod:2647
37548 msgid ""
37549 "Same as C<%Q> except the string is treated as a path which is prefixed by "
37550 "the sysroot."
37551 msgstr ""
37552
37553 #. type: verbatim
37554 #: ../src/guestfs.pod:2654
37555 #, no-wrap
37556 msgid ""
37557 " asprintf (&cmd, \"cat %R\", path);\n"
37558 "\n"
37559 msgstr ""
37560
37561 #. type: textblock
37562 #: ../src/guestfs.pod:2656
37563 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
37564 msgstr ""
37565
37566 #. type: textblock
37567 #: ../src/guestfs.pod:2658
37568 msgid ""
37569 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
37570 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
37571 "they are not passed via the shell (instead, straight to exec).  You probably "
37572 "want to use the C<sysroot_path()> function however."
37573 msgstr ""
37574
37575 #. type: =head2
37576 #: ../src/guestfs.pod:2664
37577 msgid "SUBMITTING YOUR NEW API ACTIONS"
37578 msgstr ""
37579
37580 #. type: textblock
37581 #: ../src/guestfs.pod:2666
37582 msgid ""
37583 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
37584 "libguestfs> and CC to L<rjones@redhat.com>."
37585 msgstr ""
37586
37587 #. type: =head2
37588 #: ../src/guestfs.pod:2670
37589 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
37590 msgstr ""
37591
37592 #. type: textblock
37593 #: ../src/guestfs.pod:2672
37594 msgid "We support i18n (gettext anyhow) in the library."
37595 msgstr ""
37596
37597 #. type: textblock
37598 #: ../src/guestfs.pod:2674
37599 msgid ""
37600 "However many messages come from the daemon, and we don't translate those at "
37601 "the moment.  One reason is that the appliance generally has all locale files "
37602 "removed from it, because they take up a lot of space.  So we'd have to readd "
37603 "some of those, as well as copying our PO files into the appliance."
37604 msgstr ""
37605
37606 #. type: textblock
37607 #: ../src/guestfs.pod:2680
37608 msgid ""
37609 "Debugging messages are never translated, since they are intended for the "
37610 "programmers."
37611 msgstr ""
37612
37613 #. type: =head2
37614 #: ../src/guestfs.pod:2683
37615 msgid "SOURCE CODE SUBDIRECTORIES"
37616 msgstr ""
37617
37618 #. type: textblock
37619 #: ../src/guestfs.pod:2689
37620 msgid "The libguestfs appliance, build scripts and so on."
37621 msgstr ""
37622
37623 #. type: =item
37624 #: ../src/guestfs.pod:2691
37625 msgid "C<capitests>"
37626 msgstr "C<capitests>"
37627
37628 #. type: textblock
37629 #: ../src/guestfs.pod:2693
37630 msgid "Automated tests of the C API."
37631 msgstr ""
37632
37633 #. type: =item
37634 #: ../src/guestfs.pod:2695
37635 msgid "C<cat>"
37636 msgstr "C<cat>"
37637
37638 #. type: textblock
37639 #: ../src/guestfs.pod:2697
37640 msgid ""
37641 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
37642 "documentation."
37643 msgstr ""
37644
37645 #. type: =item
37646 #: ../src/guestfs.pod:2700
37647 msgid "C<caution>"
37648 msgstr ""
37649
37650 #. type: textblock
37651 #: ../src/guestfs.pod:2702
37652 msgid ""
37653 "Safety and liveness tests of components that libguestfs depends upon (not of "
37654 "libguestfs itself).  Mainly this is for qemu and the kernel."
37655 msgstr ""
37656
37657 #. type: =item
37658 #: ../src/guestfs.pod:2705
37659 msgid "C<contrib>"
37660 msgstr "C<contrib>"
37661
37662 #. type: textblock
37663 #: ../src/guestfs.pod:2707
37664 msgid "Outside contributions, experimental parts."
37665 msgstr ""
37666
37667 #. type: =item
37668 #: ../src/guestfs.pod:2709
37669 msgid "C<daemon>"
37670 msgstr "C<daemon>"
37671
37672 #. type: textblock
37673 #: ../src/guestfs.pod:2711
37674 msgid ""
37675 "The daemon that runs inside the libguestfs appliance and carries out actions."
37676 msgstr ""
37677
37678 #. type: =item
37679 #: ../src/guestfs.pod:2714
37680 msgid "C<df>"
37681 msgstr "C<df>"
37682
37683 #. type: textblock
37684 #: ../src/guestfs.pod:2716
37685 msgid "L<virt-df(1)> command and documentation."
37686 msgstr ""
37687
37688 #. type: =item
37689 #: ../src/guestfs.pod:2718
37690 msgid "C<edit>"
37691 msgstr ""
37692
37693 #. type: textblock
37694 #: ../src/guestfs.pod:2720
37695 msgid "L<virt-edit(1)> command and documentation."
37696 msgstr ""
37697
37698 #. type: =item
37699 #: ../src/guestfs.pod:2722
37700 msgid "C<examples>"
37701 msgstr "C<examples>"
37702
37703 #. type: textblock
37704 #: ../src/guestfs.pod:2724
37705 msgid "C API example code."
37706 msgstr "Код прикладів використання програмного інтерфейсу мовою C."
37707
37708 #. type: =item
37709 #: ../src/guestfs.pod:2726
37710 msgid "C<fish>"
37711 msgstr "C<fish>"
37712
37713 #. type: textblock
37714 #: ../src/guestfs.pod:2728
37715 msgid ""
37716 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
37717 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
37718 "L<virt-tar-out(1)>."
37719 msgstr ""
37720
37721 #. type: =item
37722 #: ../src/guestfs.pod:2732
37723 msgid "C<fuse>"
37724 msgstr "C<fuse>"
37725
37726 #. type: textblock
37727 #: ../src/guestfs.pod:2734
37728 msgid ""
37729 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
37730 msgstr ""
37731
37732 #. type: =item
37733 #: ../src/guestfs.pod:2736
37734 msgid "C<generator>"
37735 msgstr "C<generator>"
37736
37737 #. type: textblock
37738 #: ../src/guestfs.pod:2738
37739 msgid ""
37740 "The crucially important generator, used to automatically generate large "
37741 "amounts of boilerplate C code for things like RPC and bindings."
37742 msgstr ""
37743
37744 #. type: =item
37745 #: ../src/guestfs.pod:2741
37746 msgid "C<images>"
37747 msgstr "C<images>"
37748
37749 #. type: textblock
37750 #: ../src/guestfs.pod:2743
37751 msgid "Files used by the test suite."
37752 msgstr ""
37753
37754 #. type: textblock
37755 #: ../src/guestfs.pod:2745
37756 msgid "Some \"phony\" guest images which we test against."
37757 msgstr ""
37758
37759 #. type: =item
37760 #: ../src/guestfs.pod:2747
37761 msgid "C<inspector>"
37762 msgstr "C<inspector>"
37763
37764 #. type: textblock
37765 #: ../src/guestfs.pod:2749
37766 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
37767 msgstr ""
37768
37769 #. type: =item
37770 #: ../src/guestfs.pod:2751
37771 msgid "C<logo>"
37772 msgstr "C<logo>"
37773
37774 #. type: textblock
37775 #: ../src/guestfs.pod:2753
37776 msgid "Logo used on the website.  The fish is called Arthur by the way."
37777 msgstr ""
37778
37779 #. type: =item
37780 #: ../src/guestfs.pod:2755
37781 msgid "C<m4>"
37782 msgstr "C<m4>"
37783
37784 #. type: textblock
37785 #: ../src/guestfs.pod:2757
37786 msgid "M4 macros used by autoconf."
37787 msgstr ""
37788
37789 #. type: =item
37790 #: ../src/guestfs.pod:2759
37791 msgid "C<po>"
37792 msgstr "C<po>"
37793
37794 #. type: textblock
37795 #: ../src/guestfs.pod:2761
37796 msgid "Translations of simple gettext strings."
37797 msgstr "Переклади простих рядків gettext."
37798
37799 #. type: =item
37800 #: ../src/guestfs.pod:2763
37801 msgid "C<po-docs>"
37802 msgstr "C<po-docs>"
37803
37804 #. type: textblock
37805 #: ../src/guestfs.pod:2765
37806 msgid ""
37807 "The build infrastructure and PO files for translations of manpages and POD "
37808 "files.  Eventually this will be combined with the C<po> directory, but that "
37809 "is rather complicated."
37810 msgstr ""
37811
37812 #. type: =item
37813 #: ../src/guestfs.pod:2769
37814 msgid "C<regressions>"
37815 msgstr "C<regressions>"
37816
37817 #. type: textblock
37818 #: ../src/guestfs.pod:2771
37819 msgid "Regression tests."
37820 msgstr "Тести на регресії."
37821
37822 #. type: =item
37823 #: ../src/guestfs.pod:2773
37824 msgid "C<rescue>"
37825 msgstr "C<rescue>"
37826
37827 #. type: textblock
37828 #: ../src/guestfs.pod:2775
37829 msgid "L<virt-rescue(1)> command and documentation."
37830 msgstr ""
37831
37832 #. type: =item
37833 #: ../src/guestfs.pod:2777
37834 msgid "C<src>"
37835 msgstr "C<src>"
37836
37837 #. type: textblock
37838 #: ../src/guestfs.pod:2779
37839 msgid "Source code to the C library."
37840 msgstr ""
37841
37842 #. type: =item
37843 #: ../src/guestfs.pod:2781
37844 msgid "C<tools>"
37845 msgstr "C<tools>"
37846
37847 #. type: textblock
37848 #: ../src/guestfs.pod:2783
37849 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
37850 msgstr ""
37851
37852 #. type: =item
37853 #: ../src/guestfs.pod:2785
37854 msgid "C<test-tool>"
37855 msgstr "C<test-tool>"
37856
37857 #. type: textblock
37858 #: ../src/guestfs.pod:2787
37859 msgid ""
37860 "Test tool for end users to test if their qemu/kernel combination will work "
37861 "with libguestfs."
37862 msgstr ""
37863
37864 #. type: =item
37865 #: ../src/guestfs.pod:2790
37866 msgid "C<csharp>"
37867 msgstr "C<csharp>"
37868
37869 #. type: =item
37870 #: ../src/guestfs.pod:2792
37871 msgid "C<haskell>"
37872 msgstr "C<haskell>"
37873
37874 #. type: =item
37875 #: ../src/guestfs.pod:2794
37876 msgid "C<java>"
37877 msgstr "C<java>"
37878
37879 #. type: =item
37880 #: ../src/guestfs.pod:2796
37881 msgid "C<ocaml>"
37882 msgstr "C<ocaml>"
37883
37884 #. type: =item
37885 #: ../src/guestfs.pod:2798
37886 msgid "C<php>"
37887 msgstr "C<php>"
37888
37889 #. type: =item
37890 #: ../src/guestfs.pod:2800
37891 msgid "C<perl>"
37892 msgstr "C<perl>"
37893
37894 #. type: =item
37895 #: ../src/guestfs.pod:2802
37896 msgid "C<python>"
37897 msgstr "C<python>"
37898
37899 #. type: =item
37900 #: ../src/guestfs.pod:2804
37901 msgid "C<ruby>"
37902 msgstr "C<ruby>"
37903
37904 #. type: textblock
37905 #: ../src/guestfs.pod:2806
37906 msgid "Language bindings."
37907 msgstr "Прив’язки до мов програмування."
37908
37909 #. type: =head2
37910 #: ../src/guestfs.pod:2810
37911 msgid "MAKING A STABLE RELEASE"
37912 msgstr ""
37913
37914 #. type: textblock
37915 #: ../src/guestfs.pod:2812
37916 msgid ""
37917 "When we make a stable release, there are several steps documented here.  See "
37918 "L</LIBGUESTFS VERSION NUMBERS> for general information about the stable "
37919 "branch policy."
37920 msgstr ""
37921
37922 #. type: textblock
37923 #: ../src/guestfs.pod:2820
37924 msgid ""
37925 "Check C<make && make check> works on at least Fedora, Debian and Ubuntu."
37926 msgstr ""
37927
37928 #. type: textblock
37929 #: ../src/guestfs.pod:2825
37930 msgid "Finalize RELEASE-NOTES."
37931 msgstr ""
37932
37933 #. type: textblock
37934 #: ../src/guestfs.pod:2829
37935 msgid "Update ROADMAP."
37936 msgstr ""
37937
37938 #. type: textblock
37939 #: ../src/guestfs.pod:2833
37940 msgid "Run C<src/api-support/update-from-tarballs.sh>."
37941 msgstr ""
37942
37943 #. type: textblock
37944 #: ../src/guestfs.pod:2837
37945 msgid "Push and pull from Transifex."
37946 msgstr ""
37947
37948 #. type: textblock
37949 #: ../src/guestfs.pod:2839
37950 msgid "Run:"
37951 msgstr ""
37952
37953 #. type: verbatim
37954 #: ../src/guestfs.pod:2841
37955 #, no-wrap
37956 msgid ""
37957 " tx push -s\n"
37958 "\n"
37959 msgstr ""
37960
37961 #. type: textblock
37962 #: ../src/guestfs.pod:2843
37963 msgid "to push the latest POT files to Transifex.  Then run:"
37964 msgstr ""
37965
37966 #. type: verbatim
37967 #: ../src/guestfs.pod:2845
37968 #, no-wrap
37969 msgid ""
37970 " ./tx-pull.sh\n"
37971 "\n"
37972 msgstr ""
37973
37974 #. type: textblock
37975 #: ../src/guestfs.pod:2847
37976 msgid "which is a wrapper to pull the latest translated C<*.po> files."
37977 msgstr ""
37978
37979 #. type: textblock
37980 #: ../src/guestfs.pod:2851
37981 msgid ""
37982 "Create new stable and development directories under L<http://libguestfs.org/"
37983 "download>."
37984 msgstr ""
37985
37986 #. type: textblock
37987 #: ../src/guestfs.pod:2856
37988 msgid "Create the branch in git:"
37989 msgstr ""
37990
37991 #. type: verbatim
37992 #: ../src/guestfs.pod:2858
37993 #, no-wrap
37994 msgid ""
37995 " git tag -a 1.XX.0 -m \"Version 1.XX.0 (stable)\"\n"
37996 " git tag -a 1.YY.0 -m \"Version 1.YY.0 (development)\"\n"
37997 " git branch stable-1.XX\n"
37998 " git push origin tag 1.XX.0 1.YY.0 stable-1.XX\n"
37999 "\n"
38000 msgstr ""
38001
38002 #. type: =head1
38003 #: ../src/guestfs.pod:2865
38004 msgid "LIMITS"
38005 msgstr ""
38006
38007 #. type: =head2
38008 #: ../src/guestfs.pod:2867
38009 msgid "PROTOCOL LIMITS"
38010 msgstr "ОБМЕЖЕННЯ ПРОТОКОЛУ"
38011
38012 #. type: textblock
38013 #: ../src/guestfs.pod:2869
38014 msgid ""
38015 "Internally libguestfs uses a message-based protocol to pass API calls and "
38016 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
38017 "plenty more detail about this).  The maximum message size used by the "
38018 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
38019 "aware of this limit.  The API calls which may be affected are individually "
38020 "documented, with a link back to this section of the documentation."
38021 msgstr ""
38022
38023 #. type: textblock
38024 #: ../src/guestfs.pod:2877
38025 msgid ""
38026 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
38027 "a simple string.  Because this string is at some point internally encoded as "
38028 "a message, the maximum size that it can return is slightly under 4 MB.  If "
38029 "the requested file is larger than this then you will get an error."
38030 msgstr ""
38031
38032 #. type: textblock
38033 #: ../src/guestfs.pod:2883
38034 msgid ""
38035 "In order to transfer large files into and out of the guest filesystem, you "
38036 "need to use particular calls that support this.  The sections L</UPLOADING> "
38037 "and L</DOWNLOADING> document how to do this."
38038 msgstr ""
38039
38040 #. type: textblock
38041 #: ../src/guestfs.pod:2887
38042 msgid ""
38043 "You might also consider mounting the disk image using our FUSE filesystem "
38044 "support (L<guestmount(1)>)."
38045 msgstr ""
38046
38047 #. type: =head2
38048 #: ../src/guestfs.pod:2890
38049 msgid "MAXIMUM NUMBER OF DISKS"
38050 msgstr ""
38051
38052 #. type: textblock
38053 #: ../src/guestfs.pod:2892
38054 msgid "When using virtio disks (the default) the current limit is B<25> disks."
38055 msgstr ""
38056
38057 #. type: textblock
38058 #: ../src/guestfs.pod:2895
38059 msgid ""
38060 "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 "
38061 "slots.  However febootstrap only understands disks with names C</dev/vda> "
38062 "through C</dev/vdz> (26 letters) and it reserves one disk for its own "
38063 "purposes."
38064 msgstr ""
38065
38066 #. type: textblock
38067 #: ../src/guestfs.pod:2900
38068 msgid ""
38069 "We are working to substantially raise this limit in future versions but it "
38070 "requires complex changes to qemu."
38071 msgstr ""
38072
38073 #. type: textblock
38074 #: ../src/guestfs.pod:2903
38075 msgid ""
38076 "In future versions of libguestfs it should also be possible to \"hot plug\" "
38077 "disks (add and remove disks after calling L</guestfs_launch>).  This also "
38078 "requires changes to qemu."
38079 msgstr ""
38080
38081 #. type: =head2
38082 #: ../src/guestfs.pod:2907
38083 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK"
38084 msgstr ""
38085
38086 #. type: textblock
38087 #: ../src/guestfs.pod:2909
38088 msgid "Virtio limits the maximum number of partitions per disk to B<15>."
38089 msgstr ""
38090
38091 #. type: textblock
38092 #: ../src/guestfs.pod:2911
38093 msgid ""
38094 "This is because it reserves 4 bits for the minor device number (thus C</dev/"
38095 "vda>, and C</dev/vda1> through C</dev/vda15>)."
38096 msgstr ""
38097
38098 #. type: textblock
38099 #: ../src/guestfs.pod:2914
38100 msgid ""
38101 "If you attach a disk with more than 15 partitions, the extra partitions are "
38102 "ignored by libguestfs."
38103 msgstr ""
38104
38105 #. type: =head2
38106 #: ../src/guestfs.pod:2917
38107 msgid "MAXIMUM SIZE OF A DISK"
38108 msgstr ""
38109
38110 #. type: textblock
38111 #: ../src/guestfs.pod:2919
38112 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes."
38113 msgstr ""
38114
38115 #. type: textblock
38116 #: ../src/guestfs.pod:2921
38117 msgid ""
38118 "We have tested block devices up to 1 exabyte (2**60 or "
38119 "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host "
38120 "filesystem."
38121 msgstr ""
38122
38123 #. type: textblock
38124 #: ../src/guestfs.pod:2925
38125 msgid ""
38126 "Although libguestfs probably does not impose any limit, the underlying host "
38127 "storage will.  If you store disk images on a host ext4 filesystem, then the "
38128 "maximum size will be limited by the maximum ext4 file size (currently 16 "
38129 "TB).  If you store disk images as host logical volumes then you are limited "
38130 "by the maximum size of an LV."
38131 msgstr ""
38132
38133 #. type: textblock
38134 #: ../src/guestfs.pod:2931
38135 msgid ""
38136 "For the hugest disk image files, we recommend using XFS on the host for "
38137 "storage."
38138 msgstr ""
38139
38140 #. type: =head2
38141 #: ../src/guestfs.pod:2934
38142 msgid "MAXIMUM SIZE OF A PARTITION"
38143 msgstr ""
38144
38145 #. type: textblock
38146 #: ../src/guestfs.pod:2936
38147 msgid ""
38148 "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector "
38149 "numbers.  Assuming a 512 byte sector size, this means that MBR cannot "
38150 "address a partition located beyond 2 TB on the disk."
38151 msgstr ""
38152
38153 #. type: textblock
38154 #: ../src/guestfs.pod:2940
38155 msgid ""
38156 "It is recommended that you use GPT partitions on disks which are larger than "
38157 "this size.  GPT uses 64 bit sector numbers and so can address partitions "
38158 "which are theoretically larger than the largest disk we could support."
38159 msgstr ""
38160
38161 #. type: =head2
38162 #: ../src/guestfs.pod:2945
38163 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES"
38164 msgstr ""
38165
38166 #. type: textblock
38167 #: ../src/guestfs.pod:2947
38168 msgid ""
38169 "This depends on the filesystem type.  libguestfs itself does not impose any "
38170 "known limit.  Consult Wikipedia or the filesystem documentation to find out "
38171 "what these limits are."
38172 msgstr ""
38173
38174 #. type: =head2
38175 #: ../src/guestfs.pod:2951
38176 msgid "MAXIMUM UPLOAD AND DOWNLOAD"
38177 msgstr ""
38178
38179 #. type: textblock
38180 #: ../src/guestfs.pod:2953
38181 msgid ""
38182 "The API functions L</guestfs_upload>, L</guestfs_download>, L</"
38183 "guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized "
38184 "uploads and downloads."
38185 msgstr ""
38186
38187 #. type: =head2
38188 #: ../src/guestfs.pod:2957
38189 msgid "INSPECTION LIMITS"
38190 msgstr ""
38191
38192 #. type: textblock
38193 #: ../src/guestfs.pod:2959
38194 msgid ""
38195 "The inspection code has several arbitrary limits on things like the size of "
38196 "Windows Registry hive it will read, and the length of product name.  These "
38197 "are intended to stop a malicious guest from consuming arbitrary amounts of "
38198 "memory and disk space on the host, and should not be reached in practice.  "
38199 "See the source code for more information."
38200 msgstr ""
38201
38202 #. type: textblock
38203 #: ../src/guestfs.pod:2985
38204 msgid ""
38205 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
38206 "effect as calling C<guestfs_set_verbose (g, 1)>."
38207 msgstr ""
38208
38209 #. type: textblock
38210 #: ../src/guestfs.pod:2997
38211 msgid ""
38212 "Set the path that libguestfs uses to search for a supermin appliance.  See "
38213 "the discussion of paths in section L</PATH> above."
38214 msgstr ""
38215
38216 #. type: textblock
38217 #: ../src/guestfs.pod:3006
38218 msgid "See also L</QEMU WRAPPERS> above."
38219 msgstr ""
38220
38221 #. type: textblock
38222 #: ../src/guestfs.pod:3010
38223 msgid ""
38224 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
38225 "effect as calling C<guestfs_set_trace (g, 1)>."
38226 msgstr ""
38227
38228 #. type: textblock
38229 #: ../src/guestfs.pod:3028
38230 msgid ""
38231 "L<guestfs-examples(3)>, L<guestfs-java(3)>, L<guestfs-ocaml(3)>, L<guestfs-"
38232 "perl(3)>, L<guestfs-python(3)>, L<guestfs-ruby(3)>, L<guestfish(1)>, "
38233 "L<guestmount(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, "
38234 "L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)>, L<virt-inspector(1)"
38235 ">, L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, L<virt-ls(1)>, "
38236 "L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, "
38237 "L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>, "
38238 "L<febootstrap-supermin-helper(8)>, L<hivex(3)>, L<http://libguestfs.org/>."
38239 msgstr ""
38240
38241 #. type: textblock
38242 #: ../src/guestfs.pod:3058
38243 msgid ""
38244 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
38245 "(8)>, L<disktype(1)>."
38246 msgstr ""
38247
38248 #. type: =head1
38249 #: ../src/guestfs.pod:3065 ../tools/virt-make-fs.pl:553
38250 #: ../tools/virt-win-reg.pl:761
38251 msgid "BUGS"
38252 msgstr "ВАДИ"
38253
38254 #. type: textblock
38255 #: ../src/guestfs.pod:3067
38256 msgid "To get a list of bugs against libguestfs use this link:"
38257 msgstr ""
38258 "Щоб переглянути список відомих вад у libguestfs, скористайтеся таким "
38259 "посиланням:"
38260
38261 #. type: textblock
38262 #: ../src/guestfs.pod:3069
38263 msgid ""
38264 "L<https://bugzilla.redhat.com/buglist.cgi?"
38265 "component=libguestfs&product=Virtualization+Tools>"
38266 msgstr ""
38267 "L<https://bugzilla.redhat.com/buglist.cgi?"
38268 "component=libguestfs&product=Virtualization+Tools>"
38269
38270 #. type: textblock
38271 #: ../src/guestfs.pod:3071
38272 msgid "To report a new bug against libguestfs use this link:"
38273 msgstr "Для звітування щодо вад у libguestfs скористайтеся цим посиланням:"
38274
38275 #. type: textblock
38276 #: ../src/guestfs.pod:3073
38277 msgid ""
38278 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
38279 "component=libguestfs&product=Virtualization+Tools>"
38280 msgstr ""
38281 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
38282 "component=libguestfs&product=Virtualization+Tools>"
38283
38284 #. type: textblock
38285 #: ../src/guestfs.pod:3075
38286 msgid "When reporting a bug, please check:"
38287 msgstr ""
38288
38289 #. type: textblock
38290 #: ../src/guestfs.pod:3081
38291 msgid "That the bug hasn't been reported already."
38292 msgstr ""
38293
38294 #. type: textblock
38295 #: ../src/guestfs.pod:3085
38296 msgid "That you are testing a recent version."
38297 msgstr ""
38298
38299 #. type: textblock
38300 #: ../src/guestfs.pod:3089
38301 msgid "Describe the bug accurately, and give a way to reproduce it."
38302 msgstr ""
38303
38304 #. type: textblock
38305 #: ../src/guestfs.pod:3093
38306 msgid ""
38307 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
38308 "bug report."
38309 msgstr ""
38310
38311 #. type: textblock
38312 #: ../test-tool/libguestfs-test-tool.pod:5
38313 msgid "libguestfs-test-tool - End user tests for libguestfs"
38314 msgstr ""
38315
38316 #. type: verbatim
38317 #: ../test-tool/libguestfs-test-tool.pod:9
38318 #, no-wrap
38319 msgid ""
38320 " libguestfs-test-tool [--options]\n"
38321 "\n"
38322 msgstr ""
38323
38324 #. type: textblock
38325 #: ../test-tool/libguestfs-test-tool.pod:13
38326 msgid ""
38327 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
38328 "and developers, to allow them to check basic libguestfs functionality is "
38329 "working.  This is needed because libguestfs occasionally breaks for reasons "
38330 "beyond our control: usually because of changes in the underlying qemu or "
38331 "kernel packages, or the host environment."
38332 msgstr ""
38333
38334 #. type: textblock
38335 #: ../test-tool/libguestfs-test-tool.pod:20
38336 msgid "If you suspect a problem in libguestfs, then just run:"
38337 msgstr ""
38338
38339 #. type: verbatim
38340 #: ../test-tool/libguestfs-test-tool.pod:22
38341 #, no-wrap
38342 msgid ""
38343 " libguestfs-test-tool\n"
38344 "\n"
38345 msgstr ""
38346
38347 #. type: textblock
38348 #: ../test-tool/libguestfs-test-tool.pod:24
38349 msgid "It will print lots of diagnostic messages."
38350 msgstr ""
38351
38352 #. type: textblock
38353 #: ../test-tool/libguestfs-test-tool.pod:26
38354 msgid "If it runs to completion successfully, you will see this near the end:"
38355 msgstr ""
38356
38357 #. type: verbatim
38358 #: ../test-tool/libguestfs-test-tool.pod:28
38359 #, no-wrap
38360 msgid ""
38361 " ===== TEST FINISHED OK =====\n"
38362 "\n"
38363 msgstr ""
38364
38365 #. type: textblock
38366 #: ../test-tool/libguestfs-test-tool.pod:30
38367 msgid "and the test tool will exit with code 0."
38368 msgstr ""
38369
38370 #. type: textblock
38371 #: ../test-tool/libguestfs-test-tool.pod:32
38372 msgid ""
38373 "If it fails (and/or exits with non-zero error code), please paste the "
38374 "B<complete, unedited> output of the test tool into a bug report.  More "
38375 "information about reporting bugs can be found on the L<http://libguestfs.org/"
38376 "> website."
38377 msgstr ""
38378
38379 #. type: =item
38380 #: ../test-tool/libguestfs-test-tool.pod:41
38381 msgid "I<--help>"
38382 msgstr "I<--help>"
38383
38384 #. type: textblock
38385 #: ../test-tool/libguestfs-test-tool.pod:43
38386 msgid "Display short usage information and exit."
38387 msgstr ""
38388
38389 #. type: =item
38390 #: ../test-tool/libguestfs-test-tool.pod:45
38391 msgid "I<--qemu qemu_binary>"
38392 msgstr "I<--qemu виконуваний_файл_qemu>"
38393
38394 #. type: textblock
38395 #: ../test-tool/libguestfs-test-tool.pod:47
38396 msgid ""
38397 "If you have downloaded another qemu binary, point this option at the full "
38398 "path of the binary to try it."
38399 msgstr ""
38400
38401 #. type: =item
38402 #: ../test-tool/libguestfs-test-tool.pod:50
38403 msgid "I<--qemudir qemu_source_dir>"
38404 msgstr ""
38405
38406 #. type: textblock
38407 #: ../test-tool/libguestfs-test-tool.pod:52
38408 msgid ""
38409 "If you have compiled qemu from source, point this option at the source "
38410 "directory to try it."
38411 msgstr ""
38412
38413 #. type: =item
38414 #: ../test-tool/libguestfs-test-tool.pod:55
38415 msgid "I<--timeout N>"
38416 msgstr "I<--timeout N>"
38417
38418 #. type: textblock
38419 #: ../test-tool/libguestfs-test-tool.pod:57
38420 msgid ""
38421 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
38422 "does not usually need to be adjusted unless your machine is very slow."
38423 msgstr ""
38424
38425 #. type: =head1
38426 #: ../test-tool/libguestfs-test-tool.pod:63
38427 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
38428 msgstr ""
38429
38430 #. type: textblock
38431 #: ../test-tool/libguestfs-test-tool.pod:65
38432 msgid ""
38433 "If you have compiled another version of qemu from source and would like to "
38434 "try that, then you can use the I<--qemudir> option to point to the qemu "
38435 "source directory."
38436 msgstr ""
38437
38438 #. type: textblock
38439 #: ../test-tool/libguestfs-test-tool.pod:69
38440 msgid ""
38441 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
38442 "option to point to the binary."
38443 msgstr ""
38444
38445 #. type: textblock
38446 #: ../test-tool/libguestfs-test-tool.pod:72
38447 msgid ""
38448 "When using an alternate qemu with libguestfs, usually you would need to "
38449 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
38450 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
38451 "use either of the I<--qemudir> or I<--qemu> options."
38452 msgstr ""
38453
38454 #. type: textblock
38455 #: ../test-tool/libguestfs-test-tool.pod:79
38456 msgid ""
38457 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
38458 "I<1> if there was an error."
38459 msgstr ""
38460
38461 #. type: textblock
38462 #: ../test-tool/libguestfs-test-tool.pod:84
38463 msgid ""
38464 "For the full list of environment variables which may affect libguestfs, "
38465 "please see the L<guestfs(3)> manual page."
38466 msgstr ""
38467
38468 #. type: textblock
38469 #: ../test-tool/libguestfs-test-tool.pod:89
38470 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
38471 msgstr ""
38472
38473 #. type: textblock
38474 #: ../tools/virt-list-filesystems.pl:32
38475 msgid ""
38476 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
38477 msgstr ""
38478
38479 #. type: verbatim
38480 #: ../tools/virt-list-filesystems.pl:36
38481 #, no-wrap
38482 msgid ""
38483 " virt-list-filesystems [--options] domname\n"
38484 "\n"
38485 msgstr ""
38486
38487 #. type: verbatim
38488 #: ../tools/virt-list-filesystems.pl:38
38489 #, no-wrap
38490 msgid ""
38491 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
38492 "\n"
38493 msgstr ""
38494
38495 #. type: textblock
38496 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
38497 msgid ""
38498 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
38499 "replacement."
38500 msgstr ""
38501
38502 #. type: textblock
38503 #: ../tools/virt-list-filesystems.pl:45
38504 msgid ""
38505 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
38506 "are contained in a virtual machine or disk image."
38507 msgstr ""
38508
38509 #. type: textblock
38510 #: ../tools/virt-list-filesystems.pl:49
38511 msgid ""
38512 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
38513 "functionality.  For more complex cases you should look at the L<guestfish(1)"
38514 "> tool."
38515 msgstr ""
38516
38517 #. type: textblock
38518 #: ../tools/virt-list-filesystems.pl:112
38519 msgid ""
38520 "With this option, C<virt-list-filesystems> displays the type of each "
38521 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
38522 msgstr ""
38523
38524 #. type: =item
38525 #: ../tools/virt-list-filesystems.pl:119
38526 #, fuzzy
38527 #| msgid "B<-a image>"
38528 msgid "B<-a>"
38529 msgstr "B<-a образ>"
38530
38531 #. type: textblock
38532 #: ../tools/virt-list-filesystems.pl:123
38533 msgid ""
38534 "Normally we only show mountable filesystems.  If this option is given then "
38535 "swap devices are shown too."
38536 msgstr ""
38537
38538 #. type: textblock
38539 #: ../tools/virt-list-filesystems.pl:197
38540 msgid ""
38541 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
38542 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
38543 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
38544 msgstr ""
38545 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
38546 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
38547 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
38548
38549 #. type: textblock
38550 #: ../tools/virt-list-filesystems.pl:214 ../tools/virt-tar.pl:317
38551 msgid "Copyright (C) 2009 Red Hat Inc."
38552 msgstr "© Red Hat Inc., 2009"
38553
38554 #. type: textblock
38555 #: ../tools/virt-list-partitions.pl:32
38556 msgid ""
38557 "virt-list-partitions - List partitions in a virtual machine or disk image"
38558 msgstr ""
38559
38560 #. type: verbatim
38561 #: ../tools/virt-list-partitions.pl:36
38562 #, no-wrap
38563 msgid ""
38564 " virt-list-partitions [--options] domname\n"
38565 "\n"
38566 msgstr ""
38567 " virt-list-partitions [--параметри] назва_домену\n"
38568 "\n"
38569
38570 #. type: verbatim
38571 #: ../tools/virt-list-partitions.pl:38
38572 #, no-wrap
38573 msgid ""
38574 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
38575 "\n"
38576 msgstr ""
38577 " virt-list-partitions [--параметри] диск.img [диск.img ...]\n"
38578 "\n"
38579
38580 #. type: textblock
38581 #: ../tools/virt-list-partitions.pl:45
38582 msgid ""
38583 "C<virt-list-partitions> is a command line tool to list the partitions that "
38584 "are contained in a virtual machine or disk image.  It is mainly useful as a "
38585 "first step to using L<virt-resize(1)>."
38586 msgstr ""
38587
38588 #. type: textblock
38589 #: ../tools/virt-list-partitions.pl:50
38590 msgid ""
38591 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
38592 "functionality.  For more complex cases you should look at the L<guestfish(1)"
38593 "> tool."
38594 msgstr ""
38595
38596 #. type: textblock
38597 #: ../tools/virt-list-partitions.pl:113
38598 msgid "Show sizes in human-readable form (eg. \"1G\")."
38599 msgstr ""
38600
38601 #. type: textblock
38602 #: ../tools/virt-list-partitions.pl:123
38603 msgid ""
38604 "With this option, C<virt-list-partitions> displays the type and size of each "
38605 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
38606 msgstr ""
38607
38608 #. type: =item
38609 #: ../tools/virt-list-partitions.pl:130
38610 msgid "B<-t>"
38611 msgstr ""
38612
38613 #. type: =item
38614 #: ../tools/virt-list-partitions.pl:132
38615 #, fuzzy
38616 #| msgid "B<-t> | B<--total>"
38617 msgid "B<--total>"
38618 msgstr "B<-t> | B<--total>"
38619
38620 #. type: textblock
38621 #: ../tools/virt-list-partitions.pl:134
38622 msgid ""
38623 "Display the total size of each block device (as a separate row or rows)."
38624 msgstr ""
38625
38626 #. type: textblock
38627 #: ../tools/virt-list-partitions.pl:267
38628 msgid ""
38629 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
38630 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
38631 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
38632 msgstr ""
38633 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
38634 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
38635 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
38636
38637 #. type: textblock
38638 #: ../tools/virt-list-partitions.pl:283
38639 msgid "Copyright (C) 2009-2010 Red Hat Inc."
38640 msgstr "© Red Hat Inc., 2009–2010"
38641
38642 #. type: textblock
38643 #: ../tools/virt-make-fs.pl:37
38644 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
38645 msgstr ""
38646
38647 #. type: verbatim
38648 #: ../tools/virt-make-fs.pl:41
38649 #, no-wrap
38650 msgid ""
38651 " virt-make-fs [--options] input.tar output.img\n"
38652 "\n"
38653 msgstr ""
38654
38655 #. type: verbatim
38656 #: ../tools/virt-make-fs.pl:43
38657 #, no-wrap
38658 msgid ""
38659 " virt-make-fs [--options] input.tar.gz output.img\n"
38660 "\n"
38661 msgstr ""
38662
38663 #. type: verbatim
38664 #: ../tools/virt-make-fs.pl:45
38665 #, no-wrap
38666 msgid ""
38667 " virt-make-fs [--options] directory output.img\n"
38668 "\n"
38669 msgstr ""
38670
38671 #. type: textblock
38672 #: ../tools/virt-make-fs.pl:49
38673 msgid ""
38674 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
38675 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
38676 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
38677 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
38678 "you want to attach these filesystems to existing virtual machines (eg. to "
38679 "import large amounts of read-only data to a VM)."
38680 msgstr ""
38681
38682 #. type: textblock
38683 #: ../tools/virt-make-fs.pl:57
38684 msgid "Basic usage is:"
38685 msgstr ""
38686
38687 #. type: verbatim
38688 #: ../tools/virt-make-fs.pl:59
38689 #, no-wrap
38690 msgid ""
38691 " virt-make-fs input output\n"
38692 "\n"
38693 msgstr ""
38694
38695 #. type: textblock
38696 #: ../tools/virt-make-fs.pl:61
38697 msgid ""
38698 "where C<input> is either a directory containing files that you want to add, "
38699 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
38700 "C<output> is a disk image.  The input type is detected automatically.  The "
38701 "output disk image defaults to a raw ext2 image unless you specify extra "
38702 "flags (see L</OPTIONS> below)."
38703 msgstr ""
38704
38705 #. type: =head2
38706 #: ../tools/virt-make-fs.pl:67
38707 msgid "EXTRA SPACE"
38708 msgstr ""
38709
38710 #. type: textblock
38711 #: ../tools/virt-make-fs.pl:69
38712 msgid ""
38713 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
38714 "the files that it contains, but might have extra space.  Depending on how "
38715 "you are going to use the output, you might think this extra space is wasted "
38716 "and want to minimize it, or you might want to leave space so that more files "
38717 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
38718 "but you can use the I<--size> flag to leave space in the filesystem if you "
38719 "want it."
38720 msgstr ""
38721
38722 #. type: textblock
38723 #: ../tools/virt-make-fs.pl:77
38724 msgid ""
38725 "An alternative way to leave extra space but not make the output image any "
38726 "bigger is to use an alternative disk image format (instead of the default "
38727 "\"raw\" format).  Using I<--format=qcow2> will use the native QEmu/KVM qcow2 "
38728 "image format (check your hypervisor supports this before using it).  This "
38729 "allows you to choose a large I<--size> but the extra space won't actually be "
38730 "allocated in the image until you try to store something in it."
38731 msgstr ""
38732
38733 #. type: textblock
38734 #: ../tools/virt-make-fs.pl:85
38735 msgid ""
38736 "Don't forget that you can also use local commands including L<resize2fs(8)> "
38737 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
38738 "to build another image from scratch."
38739 msgstr ""
38740
38741 #. type: =head3
38742 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
38743 #: ../tools/virt-make-fs.pl:142
38744 msgid "EXAMPLE"
38745 msgstr "ПРИКЛАД"
38746
38747 #. type: verbatim
38748 #: ../tools/virt-make-fs.pl:91
38749 #, no-wrap
38750 msgid ""
38751 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
38752 "\n"
38753 msgstr ""
38754 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
38755 "\n"
38756
38757 #. type: =head2
38758 #: ../tools/virt-make-fs.pl:93
38759 msgid "FILESYSTEM TYPE"
38760 msgstr "ТИП ФАЙЛОВОЇ СИСТЕМИ"
38761
38762 #. type: textblock
38763 #: ../tools/virt-make-fs.pl:95
38764 msgid ""
38765 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
38766 "libguestfs supports can be used (but I<not> read-only formats like "
38767 "ISO9660).  Here are some of the more common choices:"
38768 msgstr ""
38769
38770 #. type: =item
38771 #: ../tools/virt-make-fs.pl:101
38772 msgid "I<ext3>"
38773 msgstr "I<ext3>"
38774
38775 #. type: textblock
38776 #: ../tools/virt-make-fs.pl:103
38777 msgid ""
38778 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
38779 "you are not going to use the filesystem in a way that requires the journal, "
38780 "then this is just wasted overhead."
38781 msgstr ""
38782
38783 #. type: =item
38784 #: ../tools/virt-make-fs.pl:107
38785 msgid "I<ntfs> or I<vfat>"
38786 msgstr "I<ntfs> або I<vfat>"
38787
38788 #. type: textblock
38789 #: ../tools/virt-make-fs.pl:109
38790 msgid "Useful if exporting data to a Windows guest."
38791 msgstr ""
38792
38793 #. type: textblock
38794 #: ../tools/virt-make-fs.pl:111
38795 msgid ""
38796 "I<Note for vfat>: The tar archive or local directory must only contain files "
38797 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
38798 "program running within libguestfs is unable to change the ownership of non-"
38799 "root files, since vfat itself does not support this."
38800 msgstr ""
38801
38802 #. type: =item
38803 #: ../tools/virt-make-fs.pl:116
38804 msgid "I<minix>"
38805 msgstr "I<minix>"
38806
38807 #. type: textblock
38808 #: ../tools/virt-make-fs.pl:118
38809 msgid ""
38810 "Lower overhead than C<ext2>, but certain limitations on filename length and "
38811 "total filesystem size."
38812 msgstr ""
38813
38814 #. type: verbatim
38815 #: ../tools/virt-make-fs.pl:125
38816 #, no-wrap
38817 msgid ""
38818 " virt-make-fs --type=minix input minixfs.img\n"
38819 "\n"
38820 msgstr ""
38821
38822 #. type: =head2
38823 #: ../tools/virt-make-fs.pl:127
38824 msgid "TO PARTITION OR NOT TO PARTITION"
38825 msgstr ""
38826
38827 #. type: textblock
38828 #: ../tools/virt-make-fs.pl:129
38829 msgid "Optionally virt-make-fs can add a partition table to the output disk."
38830 msgstr ""
38831
38832 #. type: textblock
38833 #: ../tools/virt-make-fs.pl:131
38834 msgid ""
38835 "Adding a partition can make the disk image more compatible with certain "
38836 "virtualized operating systems which don't expect to see a filesystem "
38837 "directly located on a block device (Linux doesn't care and will happily "
38838 "handle both types)."
38839 msgstr ""
38840
38841 #. type: textblock
38842 #: ../tools/virt-make-fs.pl:136
38843 msgid ""
38844 "On the other hand, if you have a partition table then the output image is no "
38845 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
38846 "directly on a partitioned disk image.  (However libguestfs tools such as "
38847 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
38848 msgstr ""
38849
38850 #. type: textblock
38851 #: ../tools/virt-make-fs.pl:144
38852 msgid "Add an MBR partition:"
38853 msgstr ""
38854
38855 #. type: verbatim
38856 #: ../tools/virt-make-fs.pl:146
38857 #, no-wrap
38858 msgid ""
38859 " virt-make-fs --partition -- input disk.img\n"
38860 "\n"
38861 msgstr ""
38862
38863 #. type: textblock
38864 #: ../tools/virt-make-fs.pl:148
38865 msgid ""
38866 "If the output disk image could be terabyte-sized or larger, it's better to "
38867 "use an EFI/GPT-compatible partition table:"
38868 msgstr ""
38869
38870 #. type: verbatim
38871 #: ../tools/virt-make-fs.pl:151
38872 #, no-wrap
38873 msgid ""
38874 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
38875 "\n"
38876 msgstr ""
38877
38878 #. type: textblock
38879 #: ../tools/virt-make-fs.pl:179
38880 msgid "Enable debugging information."
38881 msgstr "Увімкнути виведення діагностичних даних."
38882
38883 #. type: =item
38884 #: ../tools/virt-make-fs.pl:185
38885 msgid "B<--size=E<lt>NE<gt>>"
38886 msgstr "B<--size=E<lt>NE<gt>>"
38887
38888 #. type: =item
38889 #: ../tools/virt-make-fs.pl:187
38890 msgid "B<--size=+E<lt>NE<gt>>"
38891 msgstr "B<--size=+E<lt>NE<gt>>"
38892
38893 #. type: =item
38894 #: ../tools/virt-make-fs.pl:189
38895 msgid "B<-s E<lt>NE<gt>>"
38896 msgstr "B<-s E<lt>NE<gt>>"
38897
38898 #. type: =item
38899 #: ../tools/virt-make-fs.pl:191
38900 msgid "B<-s +E<lt>NE<gt>>"
38901 msgstr "B<-s +E<lt>NE<gt>>"
38902
38903 #. type: textblock
38904 #: ../tools/virt-make-fs.pl:193
38905 msgid ""
38906 "Use the I<--size> (or I<-s>) option to choose the size of the output image."
38907 msgstr ""
38908
38909 #. type: textblock
38910 #: ../tools/virt-make-fs.pl:196
38911 msgid ""
38912 "If this option is I<not> given, then the output image will be just large "
38913 "enough to contain all the files, with not much wasted space."
38914 msgstr ""
38915
38916 #. type: textblock
38917 #: ../tools/virt-make-fs.pl:199
38918 msgid ""
38919 "To choose a fixed size output disk, specify an absolute number followed by b/"
38920 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
38921 "Petabytes or Exabytes.  This must be large enough to contain all the input "
38922 "files, else you will get an error."
38923 msgstr ""
38924
38925 #. type: textblock
38926 #: ../tools/virt-make-fs.pl:204
38927 msgid ""
38928 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
38929 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
38930 "Petabytes or Exabytes.  For example: I<--size=+200M> means enough space for "
38931 "the input files, and (approximately) an extra 200 MB free space."
38932 msgstr ""
38933
38934 #. type: textblock
38935 #: ../tools/virt-make-fs.pl:210
38936 msgid ""
38937 "Note that virt-make-fs estimates free space, and therefore will not produce "
38938 "filesystems containing precisely the free space requested.  (It is much more "
38939 "expensive and time-consuming to produce a filesystem which has precisely the "
38940 "desired free space)."
38941 msgstr ""
38942
38943 #. type: =item
38944 #: ../tools/virt-make-fs.pl:219
38945 msgid "B<--format=E<lt>fmtE<gt>>"
38946 msgstr ""
38947
38948 #. type: =item
38949 #: ../tools/virt-make-fs.pl:221
38950 msgid "B<-F E<lt>fmtE<gt>>"
38951 msgstr ""
38952
38953 #. type: textblock
38954 #: ../tools/virt-make-fs.pl:223
38955 msgid "Choose the output disk image format."
38956 msgstr ""
38957
38958 #. type: textblock
38959 #: ../tools/virt-make-fs.pl:225
38960 msgid "The default is C<raw> (raw disk image)."
38961 msgstr ""
38962
38963 #. type: textblock
38964 #: ../tools/virt-make-fs.pl:227
38965 msgid ""
38966 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
38967 "that would really make sense here is C<qcow2>."
38968 msgstr ""
38969
38970 #. type: =item
38971 #: ../tools/virt-make-fs.pl:234
38972 msgid "B<--type=E<lt>fsE<gt>>"
38973 msgstr ""
38974
38975 #. type: =item
38976 #: ../tools/virt-make-fs.pl:236
38977 msgid "B<-t E<lt>fsE<gt>>"
38978 msgstr ""
38979
38980 #. type: textblock
38981 #: ../tools/virt-make-fs.pl:238
38982 msgid "Choose the output filesystem type."
38983 msgstr ""
38984
38985 #. type: textblock
38986 #: ../tools/virt-make-fs.pl:240
38987 msgid "The default is C<ext2>."
38988 msgstr "Типовим значенням є C<ext2>."
38989
38990 #. type: textblock
38991 #: ../tools/virt-make-fs.pl:242
38992 msgid ""
38993 "Any filesystem which is supported read-write by libguestfs can be used here."
38994 msgstr ""
38995
38996 #. type: =item
38997 #: ../tools/virt-make-fs.pl:249
38998 msgid "B<--partition>"
38999 msgstr "B<--partition>"
39000
39001 #. type: =item
39002 #: ../tools/virt-make-fs.pl:251
39003 msgid "B<--partition=E<lt>parttypeE<gt>>"
39004 msgstr ""
39005
39006 #. type: textblock
39007 #: ../tools/virt-make-fs.pl:253
39008 msgid ""
39009 "If specified, this flag adds an MBR partition table to the output disk image."
39010 msgstr ""
39011
39012 #. type: textblock
39013 #: ../tools/virt-make-fs.pl:256
39014 msgid ""
39015 "You can change the partition table type, eg. I<--partition=gpt> for large "
39016 "disks."
39017 msgstr ""
39018
39019 #. type: textblock
39020 #: ../tools/virt-make-fs.pl:259
39021 msgid ""
39022 "Note that if you just use a lonesome I<--partition>, the Perl option parser "
39023 "might consider the next parameter to be the partition type.  For example:"
39024 msgstr ""
39025
39026 #. type: verbatim
39027 #: ../tools/virt-make-fs.pl:263
39028 #, no-wrap
39029 msgid ""
39030 " virt-make-fs --partition input.tar ...\n"
39031 "\n"
39032 msgstr ""
39033
39034 #. type: textblock
39035 #: ../tools/virt-make-fs.pl:265
39036 msgid ""
39037 "would cause virt-make-fs to think you wanted to use a partition type of "
39038 "C<input.tar> which is completely wrong.  To avoid this, use I<--> (a double "
39039 "dash) between options and the input file argument:"
39040 msgstr ""
39041
39042 #. type: verbatim
39043 #: ../tools/virt-make-fs.pl:269
39044 #, no-wrap
39045 msgid ""
39046 " virt-make-fs --partition -- input.tar ...\n"
39047 "\n"
39048 msgstr ""
39049 " virt-make-fs --partition -- input.tar ...\n"
39050 "\n"
39051
39052 #. type: textblock
39053 #: ../tools/virt-make-fs.pl:541
39054 msgid ""
39055 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
39056 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
39057 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
39058 msgstr ""
39059 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
39060 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
39061 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
39062
39063 #. type: textblock
39064 #: ../tools/virt-make-fs.pl:555 ../tools/virt-win-reg.pl:763
39065 msgid ""
39066 "When reporting bugs, please enable debugging and capture the I<complete> "
39067 "output:"
39068 msgstr ""
39069
39070 #. type: verbatim
39071 #: ../tools/virt-make-fs.pl:558
39072 #, no-wrap
39073 msgid ""
39074 " export LIBGUESTFS_DEBUG=1\n"
39075 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
39076 "\n"
39077 msgstr ""
39078 " export LIBGUESTFS_DEBUG=1\n"
39079 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
39080 "\n"
39081
39082 #. type: textblock
39083 #: ../tools/virt-make-fs.pl:561
39084 msgid ""
39085 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
39086 "redhat.com/>"
39087 msgstr ""
39088
39089 #. type: textblock
39090 #: ../tools/virt-tar.pl:33
39091 msgid "virt-tar - Extract or upload files to a virtual machine"
39092 msgstr ""
39093
39094 #. type: verbatim
39095 #: ../tools/virt-tar.pl:37
39096 #, no-wrap
39097 msgid ""
39098 " virt-tar [--options] -x domname directory tarball\n"
39099 "\n"
39100 msgstr ""
39101
39102 #. type: verbatim
39103 #: ../tools/virt-tar.pl:39
39104 #, no-wrap
39105 msgid ""
39106 " virt-tar [--options] -u domname tarball directory\n"
39107 "\n"
39108 msgstr ""
39109
39110 #. type: verbatim
39111 #: ../tools/virt-tar.pl:41
39112 #, no-wrap
39113 msgid ""
39114 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
39115 "\n"
39116 msgstr ""
39117
39118 #. type: verbatim
39119 #: ../tools/virt-tar.pl:43
39120 #, no-wrap
39121 msgid ""
39122 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
39123 "\n"
39124 msgstr ""
39125
39126 #. type: =head2
39127 #: ../tools/virt-tar.pl:45 ../tools/virt-win-reg.pl:88
39128 msgid "NOTE"
39129 msgstr "ПРИМІТКА"
39130
39131 #. type: textblock
39132 #: ../tools/virt-tar.pl:47
39133 msgid ""
39134 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
39135 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
39136 msgstr ""
39137
39138 #. type: textblock
39139 #: ../tools/virt-tar.pl:52
39140 msgid "Download C</home> from the VM into a local tarball:"
39141 msgstr ""
39142
39143 #. type: verbatim
39144 #: ../tools/virt-tar.pl:54
39145 #, no-wrap
39146 msgid ""
39147 " virt-tar -x domname /home home.tar\n"
39148 "\n"
39149 msgstr ""
39150
39151 #. type: verbatim
39152 #: ../tools/virt-tar.pl:56
39153 #, no-wrap
39154 msgid ""
39155 " virt-tar -zx domname /home home.tar.gz\n"
39156 "\n"
39157 msgstr ""
39158
39159 #. type: textblock
39160 #: ../tools/virt-tar.pl:58
39161 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
39162 msgstr ""
39163
39164 #. type: verbatim
39165 #: ../tools/virt-tar.pl:60
39166 #, no-wrap
39167 msgid ""
39168 " virt-tar -u domname uploadstuff.tar /tmp\n"
39169 "\n"
39170 msgstr ""
39171
39172 #. type: verbatim
39173 #: ../tools/virt-tar.pl:62
39174 #, no-wrap
39175 msgid ""
39176 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
39177 "\n"
39178 msgstr ""
39179
39180 #. type: textblock
39181 #: ../tools/virt-tar.pl:66
39182 msgid ""
39183 "You must I<not> use C<virt-tar> with the I<-u> option (upload) on live "
39184 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
39185 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
39186 msgstr ""
39187
39188 #. type: textblock
39189 #: ../tools/virt-tar.pl:71
39190 msgid ""
39191 "You can use I<-x> (extract) on live virtual machines, but you might get "
39192 "inconsistent results or errors if there is filesystem activity inside the "
39193 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
39194 "work, but the only way to guarantee consistent results is if the virtual "
39195 "machine is shut down."
39196 msgstr ""
39197
39198 #. type: textblock
39199 #: ../tools/virt-tar.pl:79
39200 msgid ""
39201 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
39202 "parts of a guest filesystem.  There are many possibilities: making backups, "
39203 "uploading data files, snooping on guest activity, fixing or customizing "
39204 "guests, etc."
39205 msgstr ""
39206
39207 #. type: textblock
39208 #: ../tools/virt-tar.pl:84
39209 msgid ""
39210 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
39211 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
39212 "should look at the L<guestfish(1)> tool."
39213 msgstr ""
39214
39215 #. type: textblock
39216 #: ../tools/virt-tar.pl:88
39217 msgid ""
39218 "There are two modes of operation: I<-x> (eXtract) downloads a directory and "
39219 "its contents (recursively) from the virtual machine into a local tarball.  "
39220 "I<-u> uploads from a local tarball, unpacking it into a directory inside the "
39221 "virtual machine.  You cannot use these two options together."
39222 msgstr ""
39223
39224 #. type: textblock
39225 #: ../tools/virt-tar.pl:94
39226 msgid ""
39227 "In addition, you may need to use the I<-z> (gZip) option to enable "
39228 "compression.  When uploading, you have to specify I<-z> if the upload file "
39229 "is compressed because virt-tar won't detect this on its own."
39230 msgstr ""
39231
39232 #. type: textblock
39233 #: ../tools/virt-tar.pl:98
39234 msgid ""
39235 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
39236 "example it cannot do PKZip files or bzip2 compression.  If you want that "
39237 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
39238 "the L<libguestfs(3)> API)."
39239 msgstr ""
39240
39241 #. type: =item
39242 #: ../tools/virt-tar.pl:160
39243 #, fuzzy
39244 #| msgid "B<--format>"
39245 msgid "B<--extract>"
39246 msgstr "B<--format>"
39247
39248 #. type: =item
39249 #: ../tools/virt-tar.pl:162
39250 #, fuzzy
39251 #| msgid "download"
39252 msgid "B<--download>"
39253 msgstr "download"
39254
39255 #. type: =item
39256 #: ../tools/virt-tar.pl:164
39257 msgid "B<-u>"
39258 msgstr ""
39259
39260 #. type: =item
39261 #: ../tools/virt-tar.pl:166
39262 #, fuzzy
39263 #| msgid "B<-u> | B<--upload>"
39264 msgid "B<--upload>"
39265 msgstr "B<-u> | B<--upload>"
39266
39267 #. type: textblock
39268 #: ../tools/virt-tar.pl:168
39269 msgid ""
39270 "Use I<-x> to extract (download) a directory from a virtual machine to a "
39271 "local tarball."
39272 msgstr ""
39273
39274 #. type: textblock
39275 #: ../tools/virt-tar.pl:171
39276 msgid ""
39277 "Use I<-u> to upload and unpack from a local tarball into a virtual machine.  "
39278 "Please read the L</WARNING> section above before using this option."
39279 msgstr ""
39280
39281 #. type: textblock
39282 #: ../tools/virt-tar.pl:175
39283 msgid "You must specify exactly one of these options."
39284 msgstr ""
39285
39286 #. type: =item
39287 #: ../tools/virt-tar.pl:181
39288 msgid "B<-z>"
39289 msgstr ""
39290
39291 #. type: =item
39292 #: ../tools/virt-tar.pl:183
39293 #, fuzzy
39294 #| msgid "B<-z> | B<--gzip>"
39295 msgid "B<--gzip>"
39296 msgstr "B<-z> | B<--gzip>"
39297
39298 #. type: textblock
39299 #: ../tools/virt-tar.pl:185
39300 msgid "Specify that the input or output tarball is gzip-compressed."
39301 msgstr ""
39302
39303 #. type: textblock
39304 #: ../tools/virt-tar.pl:298
39305 msgid ""
39306 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
39307 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
39308 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
39309 "org/>."
39310 msgstr ""
39311 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
39312 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
39313 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
39314 "org/>."
39315
39316 #. type: textblock
39317 #: ../tools/virt-win-reg.pl:37
39318 msgid ""
39319 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
39320 msgstr ""
39321
39322 #. type: verbatim
39323 #: ../tools/virt-win-reg.pl:41
39324 #, no-wrap
39325 msgid ""
39326 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
39327 "\n"
39328 msgstr ""
39329
39330 #. type: verbatim
39331 #: ../tools/virt-win-reg.pl:43
39332 #, no-wrap
39333 msgid ""
39334 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
39335 "\n"
39336 msgstr ""
39337
39338 #. type: verbatim
39339 #: ../tools/virt-win-reg.pl:45
39340 #, no-wrap
39341 msgid ""
39342 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
39343 "\n"
39344 msgstr ""
39345
39346 #. type: verbatim
39347 #: ../tools/virt-win-reg.pl:47
39348 #, no-wrap
39349 msgid ""
39350 " virt-win-reg --merge domname [input.reg ...]\n"
39351 "\n"
39352 msgstr ""
39353
39354 #. type: verbatim
39355 #: ../tools/virt-win-reg.pl:49
39356 #, no-wrap
39357 msgid ""
39358 " virt-win-reg [--options] disk.img ... # instead of domname\n"
39359 "\n"
39360 msgstr ""
39361
39362 #. type: textblock
39363 #: ../tools/virt-win-reg.pl:53
39364 msgid ""
39365 "You must I<not> use C<virt-win-reg> with the I<--merge> option on live "
39366 "virtual machines.  If you do this, you I<will> get irreversible disk "
39367 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
39368 "but doesn't catch all cases."
39369 msgstr ""
39370
39371 #. type: textblock
39372 #: ../tools/virt-win-reg.pl:58
39373 msgid ""
39374 "Modifying the Windows Registry is an inherently risky operation.  The format "
39375 "is deliberately obscure and undocumented, and Registry changes can leave the "
39376 "system unbootable.  Therefore when using the I<--merge> option, make sure "
39377 "you have a reliable backup first."
39378 msgstr ""
39379
39380 #. type: textblock
39381 #: ../tools/virt-win-reg.pl:65
39382 msgid ""
39383 "This program can export and merge Windows Registry entries from a Windows "
39384 "guest."
39385 msgstr ""
39386
39387 #. type: textblock
39388 #: ../tools/virt-win-reg.pl:68
39389 msgid ""
39390 "The first parameter is the libvirt guest name or the raw disk image of a "
39391 "Windows guest."
39392 msgstr ""
39393
39394 #. type: textblock
39395 #: ../tools/virt-win-reg.pl:71
39396 msgid ""
39397 "If I<--merge> is I<not> specified, then the chosen registry key is displayed/"
39398 "exported (recursively).  For example:"
39399 msgstr ""
39400
39401 #. type: verbatim
39402 #: ../tools/virt-win-reg.pl:74
39403 #, no-wrap
39404 msgid ""
39405 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
39406 "\n"
39407 msgstr ""
39408
39409 #. type: textblock
39410 #: ../tools/virt-win-reg.pl:76
39411 msgid ""
39412 "You can also display single values from within registry keys, for example:"
39413 msgstr ""
39414
39415 #. type: verbatim
39416 #: ../tools/virt-win-reg.pl:79
39417 #, no-wrap
39418 msgid ""
39419 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
39420 " $ virt-win-reg Windows7 $cvkey ProductName\n"
39421 " Windows 7 Enterprise\n"
39422 "\n"
39423 msgstr ""
39424
39425 #. type: textblock
39426 #: ../tools/virt-win-reg.pl:83
39427 msgid ""
39428 "With I<--merge>, you can merge a textual regedit file into the Windows "
39429 "Registry:"
39430 msgstr ""
39431
39432 #. type: verbatim
39433 #: ../tools/virt-win-reg.pl:86
39434 #, no-wrap
39435 msgid ""
39436 " $ virt-win-reg --merge Windows7 changes.reg\n"
39437 "\n"
39438 msgstr ""
39439
39440 #. type: textblock
39441 #: ../tools/virt-win-reg.pl:90
39442 msgid ""
39443 "This program is only meant for simple access to the registry.  If you want "
39444 "to do complicated things with the registry, we suggest you download the "
39445 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
39446 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
39447 "L<hivexregedit(1)>."
39448 msgstr ""
39449
39450 #. type: =item
39451 #: ../tools/virt-win-reg.pl:159
39452 msgid "B<--merge>"
39453 msgstr "B<--merge>"
39454
39455 #. type: textblock
39456 #: ../tools/virt-win-reg.pl:161
39457 msgid ""
39458 "In merge mode, this merges a textual regedit file into the Windows Registry "
39459 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
39460 "displays or exports Registry entries instead."
39461 msgstr ""
39462
39463 #. type: textblock
39464 #: ../tools/virt-win-reg.pl:165
39465 msgid ""
39466 "Note that I<--merge> is I<unsafe> to use on live virtual machines, and will "
39467 "result in disk corruption.  However exporting (without this flag)  is always "
39468 "safe."
39469 msgstr ""
39470
39471 #. type: =item
39472 #: ../tools/virt-win-reg.pl:173
39473 msgid "B<--encoding> UTF-16LE|ASCII"
39474 msgstr ""
39475
39476 #. type: textblock
39477 #: ../tools/virt-win-reg.pl:175
39478 msgid ""
39479 "When merging (only), you may need to specify the encoding for strings to be "
39480 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
39481 "(3)/ENCODING STRINGS>."
39482 msgstr ""
39483
39484 #. type: textblock
39485 #: ../tools/virt-win-reg.pl:179
39486 msgid ""
39487 "The default is to use UTF-16LE, which should work with recent versions of "
39488 "Windows."
39489 msgstr ""
39490
39491 #. type: =item
39492 #: ../tools/virt-win-reg.pl:186
39493 msgid "B<--unsafe-printable-strings>"
39494 msgstr ""
39495
39496 #. type: textblock
39497 #: ../tools/virt-win-reg.pl:188
39498 msgid ""
39499 "When exporting (only), assume strings are UTF-16LE and print them as strings "
39500 "instead of hex sequences.  Remove the final zero codepoint from strings if "
39501 "present."
39502 msgstr ""
39503
39504 #. type: textblock
39505 #: ../tools/virt-win-reg.pl:192
39506 msgid ""
39507 "This is unsafe and does not preserve the fidelity of strings in the original "
39508 "Registry for various reasons:"
39509 msgstr ""
39510
39511 #. type: textblock
39512 #: ../tools/virt-win-reg.pl:199
39513 msgid ""
39514 "Assumes the original encoding is UTF-16LE.  ASCII strings and strings in "
39515 "other encodings will be corrupted by this transformation."
39516 msgstr ""
39517
39518 #. type: textblock
39519 #: ../tools/virt-win-reg.pl:204
39520 msgid ""
39521 "Assumes that everything which has type 1 or 2 is really a string and that "
39522 "everything else is not a string, but the type field in real Registries is "
39523 "not reliable."
39524 msgstr ""
39525
39526 #. type: textblock
39527 #: ../tools/virt-win-reg.pl:210
39528 msgid ""
39529 "Loses information about whether a zero codepoint followed the string in the "
39530 "Registry or not."
39531 msgstr ""
39532
39533 #. type: textblock
39534 #: ../tools/virt-win-reg.pl:215
39535 msgid ""
39536 "This all happens because the Registry itself contains no information about "
39537 "how strings are encoded (see L<Win::Hivex::Regedit(3)/ENCODING STRINGS>)."
39538 msgstr ""
39539
39540 #. type: textblock
39541 #: ../tools/virt-win-reg.pl:219
39542 msgid ""
39543 "You should only use this option for quick hacking and debugging of the "
39544 "Registry contents, and I<never> use it if the output is going to be passed "
39545 "into another program or stored in another Registry."
39546 msgstr ""
39547
39548 #. type: =head1
39549 #: ../tools/virt-win-reg.pl:556
39550 msgid "SUPPORTED SYSTEMS"
39551 msgstr ""
39552
39553 #. type: textblock
39554 #: ../tools/virt-win-reg.pl:558
39555 msgid ""
39556 "The program currently supports Windows NT-derived guests starting with "
39557 "Windows XP through to at least Windows 7."
39558 msgstr ""
39559
39560 #. type: textblock
39561 #: ../tools/virt-win-reg.pl:561
39562 msgid "The following Registry keys are supported:"
39563 msgstr ""
39564
39565 #. type: =item
39566 #: ../tools/virt-win-reg.pl:565
39567 msgid "C<HKEY_LOCAL_MACHINE\\SAM>"
39568 msgstr ""
39569
39570 #. type: =item
39571 #: ../tools/virt-win-reg.pl:567
39572 msgid "C<HKEY_LOCAL_MACHINE\\SECURITY>"
39573 msgstr ""
39574
39575 #. type: =item
39576 #: ../tools/virt-win-reg.pl:569
39577 msgid "C<HKEY_LOCAL_MACHINE\\SOFTWARE>"
39578 msgstr ""
39579
39580 #. type: =item
39581 #: ../tools/virt-win-reg.pl:571
39582 msgid "C<HKEY_LOCAL_MACHINE\\SYSTEM>"
39583 msgstr ""
39584
39585 #. type: =item
39586 #: ../tools/virt-win-reg.pl:573
39587 msgid "C<HKEY_USERS\\.DEFAULT>"
39588 msgstr ""
39589
39590 #. type: =item
39591 #: ../tools/virt-win-reg.pl:575
39592 msgid "C<HKEY_USERS\\I<SID>>"
39593 msgstr ""
39594
39595 #. type: textblock
39596 #: ../tools/virt-win-reg.pl:577
39597 msgid "where I<SID> is a Windows User SID (eg. C<S-1-5-18>)."
39598 msgstr ""
39599
39600 #. type: =item
39601 #: ../tools/virt-win-reg.pl:579
39602 msgid "C<HKEY_USERS\\I<username>>"
39603 msgstr ""
39604
39605 #. type: textblock
39606 #: ../tools/virt-win-reg.pl:581
39607 msgid ""
39608 "where I<username> is a local user name (this is a libguestfs extension)."
39609 msgstr ""
39610
39611 #. type: textblock
39612 #: ../tools/virt-win-reg.pl:585
39613 msgid ""
39614 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
39615 "C<HKEY_USERS>."
39616 msgstr ""
39617
39618 #. type: textblock
39619 #: ../tools/virt-win-reg.pl:588
39620 msgid ""
39621 "The literal keys C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are not "
39622 "supported (there is no \"current user\")."
39623 msgstr ""
39624
39625 #. type: =head1
39626 #: ../tools/virt-win-reg.pl:591
39627 msgid "ENCODING"
39628 msgstr "КОДУВАННЯ"
39629
39630 #. type: textblock
39631 #: ../tools/virt-win-reg.pl:593
39632 msgid ""
39633 "C<virt-win-reg> expects that regedit files have already been reencoded in "
39634 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
39635 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
39636 "Windows-style line endings, you may need to reencode the whole file before "
39637 "or after processing."
39638 msgstr ""
39639
39640 #. type: textblock
39641 #: ../tools/virt-win-reg.pl:599
39642 msgid ""
39643 "To reencode a file from Windows format to Linux (before processing it with "
39644 "the I<--merge> option), you would do something like this:"
39645 msgstr ""
39646
39647 #. type: verbatim
39648 #: ../tools/virt-win-reg.pl:602
39649 #, no-wrap
39650 msgid ""
39651 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
39652 "\n"
39653 msgstr ""
39654
39655 #. type: textblock
39656 #: ../tools/virt-win-reg.pl:604
39657 msgid ""
39658 "To go in the opposite direction, after exporting and before sending the file "
39659 "to a Windows user, do something like this:"
39660 msgstr ""
39661
39662 #. type: verbatim
39663 #: ../tools/virt-win-reg.pl:607
39664 #, no-wrap
39665 msgid ""
39666 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
39667 "\n"
39668 msgstr ""
39669
39670 #. type: textblock
39671 #: ../tools/virt-win-reg.pl:609
39672 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
39673 msgstr ""
39674
39675 #. type: textblock
39676 #: ../tools/virt-win-reg.pl:611
39677 msgid ""
39678 "If you are unsure about the current encoding, use the L<file(1)> command.  "
39679 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
39680 "style (CRLF) line endings, like this:"
39681 msgstr ""
39682
39683 #. type: verbatim
39684 #: ../tools/virt-win-reg.pl:615
39685 #, no-wrap
39686 msgid ""
39687 " $ file software.reg\n"
39688 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
39689 " with CRLF line terminators\n"
39690 "\n"
39691 msgstr ""
39692
39693 #. type: textblock
39694 #: ../tools/virt-win-reg.pl:619
39695 msgid "This file would need conversion before you could I<--merge> it."
39696 msgstr ""
39697
39698 #. type: =head1
39699 #: ../tools/virt-win-reg.pl:621
39700 msgid "CurrentControlSet etc."
39701 msgstr ""
39702
39703 #. type: textblock
39704 #: ../tools/virt-win-reg.pl:623
39705 msgid ""
39706 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
39707 "Registry at the level of the hive file, and therefore you cannot modify "
39708 "these."
39709 msgstr ""
39710
39711 #. type: textblock
39712 #: ../tools/virt-win-reg.pl:627
39713 msgid ""
39714 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
39715 "circumstances it might refer to another control set.  The way to find out is "
39716 "to look at the C<HKLM\\SYSTEM\\Select> key:"
39717 msgstr ""
39718
39719 #. type: verbatim
39720 #: ../tools/virt-win-reg.pl:631
39721 #, no-wrap
39722 msgid ""
39723 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
39724 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
39725 " \"Current\"=dword:00000001\n"
39726 " \"Default\"=dword:00000001\n"
39727 " \"Failed\"=dword:00000000\n"
39728 " \"LastKnownGood\"=dword:00000002\n"
39729 "\n"
39730 msgstr ""
39731
39732 #. type: textblock
39733 #: ../tools/virt-win-reg.pl:638
39734 msgid "\"Current\" is the one which Windows will choose when it boots."
39735 msgstr ""
39736
39737 #. type: textblock
39738 #: ../tools/virt-win-reg.pl:640
39739 msgid ""
39740 "Similarly, other C<Current...> keys in the path may need to be replaced."
39741 msgstr ""
39742
39743 #. type: =head1
39744 #: ../tools/virt-win-reg.pl:643
39745 msgid "WINDOWS TIPS"
39746 msgstr ""
39747
39748 #. type: textblock
39749 #: ../tools/virt-win-reg.pl:645
39750 msgid ""
39751 "Note that some of these tips modify the guest disk image.  The guest I<must> "
39752 "be shut off, else you will get disk corruption."
39753 msgstr ""
39754
39755 #. type: =head2
39756 #: ../tools/virt-win-reg.pl:648
39757 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
39758 msgstr ""
39759
39760 #. type: textblock
39761 #: ../tools/virt-win-reg.pl:650
39762 msgid ""
39763 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
39764 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
39765 "is uploaded into C<C:\\>:"
39766 msgstr ""
39767
39768 #. type: verbatim
39769 #: ../tools/virt-win-reg.pl:654
39770 #, no-wrap
39771 msgid ""
39772 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
39773 "\n"
39774 msgstr ""
39775
39776 #. type: textblock
39777 #: ../tools/virt-win-reg.pl:656
39778 msgid "Prepare a regedit file containing the registry change:"
39779 msgstr ""
39780
39781 #. type: verbatim
39782 #: ../tools/virt-win-reg.pl:658
39783 #, no-wrap
39784 msgid ""
39785 " cat > test.reg <<'EOF'\n"
39786 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
39787 " \"Test\"=\"c:\\\\test.bat\"\n"
39788 " EOF\n"
39789 "\n"
39790 msgstr ""
39791
39792 #. type: textblock
39793 #: ../tools/virt-win-reg.pl:663
39794 msgid ""
39795 "In this example we use the key C<RunOnce> which means that the script will "
39796 "run precisely once when the first user logs in.  If you want it to run every "
39797 "time a user logs in, replace C<RunOnce> with C<Run>."
39798 msgstr ""
39799
39800 #. type: textblock
39801 #: ../tools/virt-win-reg.pl:667
39802 msgid "Now update the registry:"
39803 msgstr ""
39804
39805 #. type: verbatim
39806 #: ../tools/virt-win-reg.pl:669
39807 #, no-wrap
39808 msgid ""
39809 " virt-win-reg --merge WindowsGuest test.reg\n"
39810 "\n"
39811 msgstr ""
39812
39813 #. type: =head2
39814 #: ../tools/virt-win-reg.pl:671
39815 msgid "INSTALLING A SERVICE"
39816 msgstr ""
39817
39818 #. type: textblock
39819 #: ../tools/virt-win-reg.pl:673
39820 msgid ""
39821 "This section assumes you are familiar with Windows services, and you either "
39822 "have a program which handles the Windows Service Control Protocol directly "
39823 "or you want to run any program using a service wrapper like SrvAny or the "
39824 "free RHSrvAny."
39825 msgstr ""
39826
39827 #. type: textblock
39828 #: ../tools/virt-win-reg.pl:678
39829 msgid ""
39830 "First upload the program and optionally the service wrapper.  In this case "
39831 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
39832 msgstr ""
39833
39834 #. type: verbatim
39835 #: ../tools/virt-win-reg.pl:682
39836 #, no-wrap
39837 msgid ""
39838 " guestfish -i -d WindowsGuest <<EOF\n"
39839 "   upload rhsrvany.exe /rhsrvany.exe\n"
39840 "   upload test.exe /test.exe\n"
39841 " EOF\n"
39842 "\n"
39843 msgstr ""
39844
39845 #. type: textblock
39846 #: ../tools/virt-win-reg.pl:687
39847 msgid ""
39848 "Prepare a regedit file containing the registry changes.  In this example, "
39849 "the first registry change is needed for the service itself or the service "
39850 "wrapper (if used).  The second registry change is only needed because I am "
39851 "using the RHSrvAny service wrapper."
39852 msgstr ""
39853
39854 #. type: verbatim
39855 #: ../tools/virt-win-reg.pl:692
39856 #, no-wrap
39857 msgid ""
39858 " cat > service.reg <<'EOF'\n"
39859 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
39860 " \"Type\"=dword:00000010\n"
39861 " \"Start\"=dword:00000002\n"
39862 " \"ErrorControl\"=dword:00000001\n"
39863 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
39864 " \"DisplayName\"=\"RHSrvAny\"\n"
39865 " \"ObjectName\"=\"NetworkService\"\n"
39866 " \n"
39867 msgstr ""
39868
39869 #. type: verbatim
39870 #: ../tools/virt-win-reg.pl:701
39871 #, no-wrap
39872 msgid ""
39873 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
39874 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
39875 " \"PWD\"=\"c:\\\\Temp\"\n"
39876 " EOF\n"
39877 "\n"
39878 msgstr ""
39879
39880 #. type: textblock
39881 #: ../tools/virt-win-reg.pl:712
39882 msgid ""
39883 "For use of C<ControlSet001> see the section above in this manual page.  You "
39884 "may need to adjust this according to the control set that is in use by the "
39885 "guest."
39886 msgstr ""
39887
39888 #. type: textblock
39889 #: ../tools/virt-win-reg.pl:718
39890 msgid ""
39891 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
39892 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
39893 "privileged account."
39894 msgstr ""
39895
39896 #. type: textblock
39897 #: ../tools/virt-win-reg.pl:724
39898 msgid ""
39899 "For the meaning of the magic numbers, see this Microsoft KB article: "
39900 "L<http://support.microsoft.com/kb/103000>."
39901 msgstr ""
39902
39903 #. type: textblock
39904 #: ../tools/virt-win-reg.pl:729
39905 msgid "Update the registry:"
39906 msgstr ""
39907
39908 #. type: verbatim
39909 #: ../tools/virt-win-reg.pl:731
39910 #, no-wrap
39911 msgid ""
39912 " virt-win-reg --merge WindowsGuest service.reg\n"
39913 "\n"
39914 msgstr ""
39915
39916 #. type: textblock
39917 #: ../tools/virt-win-reg.pl:735
39918 msgid ""
39919 "Be careful when passing parameters containing C<\\> (backslash) in the "
39920 "shell.  Usually you will have to use 'single quotes' or double backslashes "
39921 "(but not both) to protect them from the shell."
39922 msgstr ""
39923
39924 #. type: textblock
39925 #: ../tools/virt-win-reg.pl:739
39926 msgid "Paths and value names are case-insensitive."
39927 msgstr ""
39928
39929 #. type: textblock
39930 #: ../tools/virt-win-reg.pl:748
39931 msgid ""
39932 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
39933 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
39934 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
39935 msgstr ""
39936
39937 #. type: verbatim
39938 #: ../tools/virt-win-reg.pl:766
39939 #, no-wrap
39940 msgid ""
39941 " export LIBGUESTFS_DEBUG=1\n"
39942 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
39943 "\n"
39944 msgstr ""
39945
39946 #. type: textblock
39947 #: ../tools/virt-win-reg.pl:769
39948 msgid ""
39949 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
39950 "redhat.com/>"
39951 msgstr ""
39952
39953 #~ msgid "EXIT CODE"
39954 #~ msgstr "КОД ВИХОДУ"
39955
39956 #~ msgid "B<-a> | B<--all>"
39957 #~ msgstr "B<-a> | B<--all>"
39958
39959 #~ msgid "B<-x> | B<--extract> | B<--download>"
39960 #~ msgstr "B<-x> | B<--extract> | B<--download>"