NOTE: This file is automatically generated from "update-bugs.sh".

This contains a local list of the bugs that are open against

libguestfs. Bugs are tracked in the Red Hat Bugzilla database

701814 NEW https://bugzilla.redhat.com/show_bug.cgi?id=701814

virt-win-reg fails on a libvirt guest that has no defined disk format: "format parameter is empty or contains disallowed characters"

563450 NEW https://bugzilla.redhat.com/show_bug.cgi?id=563450

list-devices returns devices of different types out of order

# major/minor/release must be numbers

m4_define([libguestfs_major], [1])

m4_define([libguestfs_minor], [11])

# extra can be any string

m4_define([libguestfs_extra], [])

msgstr ""

"Project-Id-Version: PACKAGE VERSION\n"

"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"

"PO-Revision-Date: 2010-09-02 14:46+0100\n"

"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

"Language-Team: LANGUAGE <LL@li.org>\n"

#: ../fish/guestfish-actions.pod:1213 ../fish/guestfish-actions.pod:1217

#: ../fish/guestfish-actions.pod:1222 ../fish/guestfish-actions.pod:1227

#: ../fish/guestfish-actions.pod:1269 ../fish/guestfish-actions.pod:1273

msgid "*"

msgstr ""

#. type: textblock

#: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11

#: ../src/guestfs-actions.pod:1861 ../fish/guestfish-actions.pod:9

msgid "Notes:"

msgstr ""

msgstr ""

#. type: =item

msgid "C<appliance>"

msgstr ""

#. type: =head1

#: ../src/guestfs.pod:2917 ../fish/guestfish.pod:1151

#: ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:269

#: ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539

#: ../tools/virt-list-partitions.pl:257

msgid "SEE ALSO"

# type: =head1

#. type: =head1

#: ../tools/virt-make-fs.pl:553

msgid "BUGS"

msgstr ""

#. type: =head1

#: ../src/guestfs.pod:2990 ../fish/guestfish.pod:1178

#: ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:284

#: ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568

#: ../tools/virt-list-partitions.pl:273

msgid "COPYRIGHT"

#: ../src/guestfs-actions.pod:4642 ../src/guestfs-actions.pod:4659

#: ../src/guestfs-actions.pod:4672 ../src/guestfs-actions.pod:4687

#: ../src/guestfs-actions.pod:4702 ../src/guestfs-actions.pod:4737

#: ../src/guestfs-actions.pod:6491 ../src/guestfs-actions.pod:6504

msgid "This function returns 0 on success or -1 on error."

msgstr ""

#: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257

#: ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1454

#: ../src/guestfs-actions.pod:1950 ../src/guestfs-actions.pod:1971

#: ../fish/guestfish-actions.pod:166 ../fish/guestfish-actions.pod:180

#: ../fish/guestfish-actions.pod:961 ../fish/guestfish-actions.pod:1324

#: ../fish/guestfish-actions.pod:1338 ../fish/guestfish-actions.pod:3013

msgid ""

"Deprecated functions will not be removed from the API, but the fact that "

"they are deprecated indicates that there are problems with correct use of "

#: ../src/guestfs-actions.pod:1106 ../src/guestfs-actions.pod:1922

#: ../src/guestfs-actions.pod:2020 ../src/guestfs-actions.pod:2123

#: ../src/guestfs-actions.pod:3467 ../src/guestfs-actions.pod:3487

msgid "(Added in 0.3)"

msgstr ""

#: ../src/guestfs-actions.pod:1992 ../src/guestfs-actions.pod:2032

#: ../src/guestfs-actions.pod:2087 ../src/guestfs-actions.pod:2110

#: ../src/guestfs-actions.pod:2403 ../src/guestfs-actions.pod:2786

msgid "On error this function returns -1."

msgstr ""

#: ../src/guestfs-actions.pod:458 ../src/guestfs-actions.pod:489

#: ../src/guestfs-actions.pod:503 ../src/guestfs-actions.pod:517

#: ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:549

msgid "(Added in 0.7)"

msgstr ""

#: ../src/guestfs-actions.pod:3053 ../src/guestfs-actions.pod:3074

#: ../src/guestfs-actions.pod:3646 ../src/guestfs-actions.pod:3996

#: ../src/guestfs-actions.pod:4166 ../src/guestfs-actions.pod:4276

msgid ""

"This function returns a string, or NULL on error. I<The caller must free "

"the returned string after use>."

#: ../src/guestfs-actions.pod:2696 ../src/guestfs-actions.pod:2987

#: ../src/guestfs-actions.pod:3276 ../src/guestfs-actions.pod:3566

#: ../src/guestfs-actions.pod:3628 ../src/guestfs-actions.pod:3733

msgid ""

"This function returns a NULL-terminated array of strings (like L<environ(3)"

">), or NULL if there was an error. I<The caller must free the strings and "

#: ../src/guestfs-actions.pod:3354 ../src/guestfs-actions.pod:3385

#: ../src/guestfs-actions.pod:3979 ../src/guestfs-actions.pod:4029

#: ../src/guestfs-actions.pod:4216 ../src/guestfs-actions.pod:4249

msgid "(Added in 0.8)"

msgstr ""

#: ../src/guestfs-actions.pod:3367 ../src/guestfs-actions.pod:3383

#: ../src/guestfs-actions.pod:3397 ../src/guestfs-actions.pod:3410

#: ../src/guestfs-actions.pod:3424 ../src/guestfs-actions.pod:3439

msgid "This function returns a C truth value on success or -1 on error."

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.75)"

msgstr ""

# type: textblock

#. type: textblock

msgid "Return the contents of the file named C<path>."

msgstr ""

#: ../src/guestfs-actions.pod:2227 ../src/guestfs-actions.pod:2246

#: ../src/guestfs-actions.pod:2289 ../src/guestfs-actions.pod:2313

#: ../src/guestfs-actions.pod:2330 ../src/guestfs-actions.pod:2359

#: ../fish/guestfish-actions.pod:727 ../fish/guestfish-actions.pod:739

#: ../fish/guestfish-actions.pod:915 ../fish/guestfish-actions.pod:925

#: ../fish/guestfish-actions.pod:992 ../fish/guestfish-actions.pod:1002

#: ../fish/guestfish-actions.pod:1197 ../fish/guestfish-actions.pod:1498

#: ../fish/guestfish-actions.pod:1508 ../fish/guestfish-actions.pod:1536

#: ../fish/guestfish-actions.pod:1551 ../fish/guestfish-actions.pod:1561

msgid ""

"Because of the message protocol, there is a transfer limit of somewhere "

"between 2MB and 4MB. See L<guestfs(3)/PROTOCOL LIMITS>."

#: ../src/guestfs-actions.pod:887 ../src/guestfs-actions.pod:3570

#: ../src/guestfs-actions.pod:3632 ../src/guestfs-actions.pod:3649

#: ../src/guestfs-actions.pod:3737 ../src/guestfs-actions.pod:4142

msgid "(Added in 0.4)"

msgstr ""

#: ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:1252

#: ../src/guestfs-actions.pod:2089 ../src/guestfs-actions.pod:3309

#: ../src/guestfs-actions.pod:3338 ../src/guestfs-actions.pod:3399

msgid "(Added in 1.0.2)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.3.2)"

msgstr ""

#: ../src/guestfs-actions.pod:1124 ../src/guestfs-actions.pod:1247

#: ../src/guestfs-actions.pod:1278 ../src/guestfs-actions.pod:1323

#: ../src/guestfs-actions.pod:1703 ../src/guestfs-actions.pod:1725

msgid ""

"This long-running command can generate progress notification messages so "

"that the caller can display a progress bar or indicator. To receive these "

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:1129 ../src/guestfs-actions.pod:4169

msgid "(Added in 1.0.87)"

msgstr ""

#. type: textblock

#: ../src/guestfs-actions.pod:1143 ../src/guestfs-actions.pod:1157

#: ../src/guestfs-actions.pod:1229 ../src/guestfs-actions.pod:1303

msgid "(Added in 1.0.18)"

msgstr ""

#: ../src/guestfs-actions.pod:1193 ../src/guestfs-actions.pod:1210

#: ../src/guestfs-actions.pod:1328 ../src/guestfs-actions.pod:2292

#: ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2384

msgid "(Added in 1.0.54)"

msgstr ""

# type: textblock

#. type: textblock

msgid "C<filename> can also be a named pipe."

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.5.17)"

msgstr ""

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:1363 ../src/guestfs-actions.pod:2100

msgid "(Added in 1.0.69)"

msgstr ""

#: ../src/guestfs-actions.pod:2514 ../src/guestfs-actions.pod:3662

#: ../src/guestfs-actions.pod:3676 ../src/guestfs-actions.pod:3689

#: ../src/guestfs-actions.pod:3703 ../src/guestfs-actions.pod:4689

#: ../src/guestfs-actions.pod:6493 ../src/guestfs-actions.pod:6506

msgid "(Added in 1.0.66)"

msgstr ""

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:1772 ../src/guestfs-actions.pod:4106

msgid "(Added in 1.0.27)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.16)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.26)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.72)"

msgstr ""

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:1954 ../src/guestfs-actions.pod:1975

msgid "(Added in 1.0.15)"

msgstr ""

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:1989 ../src/guestfs-actions.pod:2070

#: ../fish/guestfish-actions.pod:1353 ../fish/guestfish-actions.pod:1404

msgid ""

"For more information on the architecture of libguestfs, see L<guestfs(3)>."

msgstr ""

#: ../src/guestfs-actions.pod:4594 ../src/guestfs-actions.pod:4613

#: ../src/guestfs-actions.pod:4632 ../src/guestfs-actions.pod:4644

#: ../src/guestfs-actions.pod:4661 ../src/guestfs-actions.pod:4674

msgid "(Added in 1.0.55)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.5.4)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.6)"

msgstr ""

#. type: textblock

#: ../src/guestfs-actions.pod:2060 ../src/guestfs-actions.pod:3507

#: ../src/guestfs-actions.pod:3804 ../src/guestfs-actions.pod:4204

msgid "(Added in 1.0.77)"

msgstr ""

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:2075 ../src/guestfs-actions.pod:2138

msgid "(Added in 1.0.67)"

msgstr ""

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:2164 ../src/guestfs-actions.pod:2355

msgid ""

"This function returns a buffer, or NULL on error. The size of the returned "

"buffer is written to C<*size_r>. I<The caller must free the returned buffer "

#. type: textblock

#: ../src/guestfs-actions.pod:2188 ../src/guestfs-actions.pod:3553

#: ../src/guestfs-actions.pod:3718 ../src/guestfs-actions.pod:3754

msgid "(Added in 1.0.59)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.50)"

msgstr ""

# type: textblock

#. type: textblock

msgid "If the parameter C<nrlines> is zero, this returns an empty list."

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.22)"

msgstr ""

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:2670 ../src/guestfs-actions.pod:2846

msgid ""

"This function returns a NULL-terminated array of strings, or NULL if there "

"was an error. The array of strings will always have length C<2n+1>, where "

# type: textblock

#. type: textblock

msgid "(Added in 1.5.15)"

msgstr ""

# type: textblock

#. type: textblock

msgid "Returns file information for the given C<path>."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"This function returns a C<struct guestfs_stat *>, or NULL if there was an "

"error. I<The caller must call C<guestfs_free_stat> after use>."

# type: textblock

#. type: textblock

msgid "(Added in 0.9.2)"

msgstr ""

# type: textblock

#. type: textblock

#: ../src/guestfs-actions.pod:3863 ../src/guestfs-actions.pod:3886

#: ../fish/guestfish-actions.pod:2681 ../fish/guestfish-actions.pod:2765

msgid ""

"B<This command is dangerous. Without careful use you can easily destroy all "

"your data>."

# type: textblock

#. type: textblock

msgid "(Added in 1.0.13)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.83)"

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.62)"

msgstr ""

"(use an empty string for the first parameter if you don't want any options)."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_mount_loop"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command lets you mount C<file> (a filesystem image in a file) on a "

"mount point. It is entirely equivalent to the command C<mount -o loop file "

# type: =head2

#. type: =head2

msgid "guestfs_mount_options"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This is the same as the C<guestfs_mount> command, but it allows you to set "

"the mount options as for the L<mount(8)> I<-o> flag."

# type: textblock

#. type: textblock

msgid ""

"If the C<options> parameter is an empty string, then no options are passed "

"(all options default to whatever the filesystem uses)."

# type: textblock

#. type: textblock

msgid "(Added in 1.0.10)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_mount_ro"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This is the same as the C<guestfs_mount> command, but it mounts the "

"filesystem with the read-only (I<-o ro>) flag."

# type: =head2

#. type: =head2

msgid "guestfs_mount_vfs"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This is the same as the C<guestfs_mount> command, but it allows you to set "

"both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"

# type: =head2

#. type: =head2

msgid "guestfs_mountpoints"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This call is similar to C<guestfs_mounts>. That call returns a list of "

"devices. This one returns a hash table (map) of device name to directory "

# type: =head2

#. type: =head2

msgid "guestfs_mounts"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This returns the list of currently mounted filesystems. It returns the list "

"of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."

# type: textblock

#. type: textblock

msgid "Some internal mounts are not shown."

msgstr ""

# type: textblock

#. type: textblock

msgid "See also: C<guestfs_mountpoints>"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_mv"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This moves a file from C<src> to C<dest> where C<dest> is either a "

"destination filename or destination directory."

# type: =head2

#. type: =head2

msgid "guestfs_ntfs_3g_probe"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "

"C<device> for mountability. (Not all NTFS volumes can be mounted read-"

# type: textblock

#. type: textblock

msgid ""

"C<rw> is a boolean flag. Set it to true if you want to test if the volume "

"can be mounted read-write. Set it to false if you want to test if the "

# type: textblock

#. type: textblock

msgid ""

"The return value is an integer which C<0> if the operation would succeed, or "

"some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."

# type: textblock

#. type: textblock

msgid "(Added in 1.0.43)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_ntfsresize"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command resizes an NTFS filesystem, expanding or shrinking it to the "

"size of the underlying device. See also L<ntfsresize(8)>."

# type: =head2

#. type: =head2

msgid "guestfs_ntfsresize_size"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command is the same as C<guestfs_ntfsresize> except that it allows you "

"to specify the new size (in bytes) explicitly."

# type: textblock

#. type: textblock

msgid "(Added in 1.3.14)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_part_add"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command adds a partition to C<device>. If there is no partition table "

"on the device, call C<guestfs_part_init> first."

# type: textblock

#. type: textblock

msgid ""

"The C<prlogex> parameter is the type of partition. Normally you should pass "

"C<p> or C<primary> here, but MBR partition tables also support C<l> (or "

# type: textblock

#. type: textblock

msgid ""

"C<startsect> and C<endsect> are the start and end of the partition in "

"I<sectors>. C<endsect> may be negative, which means it counts backwards "

# type: textblock

#. type: textblock

msgid ""

"Creating a partition which covers the whole disk is not so easy. Use "

"C<guestfs_part_disk> to do that."

# type: textblock

#. type: textblock

msgid "(Added in 1.0.78)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_part_del"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "This command deletes the partition numbered C<partnum> on C<device>."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Note that in the case of MBR partitioning, deleting an extended partition "

"also deletes any logical partitions it contains."

# type: =head2

#. type: =head2

msgid "guestfs_part_disk"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command is simply a combination of C<guestfs_part_init> followed by "

"C<guestfs_part_add> to create a single primary partition covering the whole "

# type: textblock

#. type: textblock

msgid ""

"C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "

"possible values are described in C<guestfs_part_init>."

# type: =head2

#. type: =head2

msgid "guestfs_part_get_bootable"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command returns true if the partition C<partnum> on C<device> has the "

"bootable flag set."

# type: textblock

#. type: textblock

msgid "See also C<guestfs_part_set_bootable>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_part_get_mbr_id"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"Returns the MBR type byte (also known as the ID byte) from the numbered "

"partition C<partnum>."

# type: textblock

#. type: textblock

msgid ""

"Note that only MBR (old DOS-style) partitions have type bytes. You will get "

"undefined results for other partition table types (see "

# type: =head2

#. type: =head2

msgid "guestfs_part_get_parttype"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This command examines the partition table on C<device> and returns the "

"partition table type (format) being used."

# type: textblock

#. type: textblock

msgid ""

"Common return values include: C<msdos> (a DOS/Windows style MBR partition "

"table), C<gpt> (a GPT/EFI-style partition table). Other values are "

# type: =head2

#. type: =head2

msgid "guestfs_part_init"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This creates an empty partition table on C<device> of one of the partition "

"types listed below. Usually C<parttype> should be either C<msdos> or C<gpt> "

# type: textblock

#. type: textblock

msgid ""

"Initially there are no partitions. Following this, you should call "

"C<guestfs_part_add> for each partition required."

# type: textblock

#. type: textblock

msgid "Possible values for C<parttype> are:"

msgstr ""

# type: =item

#. type: =item

msgid "B<efi> | B<gpt>"

msgstr ""

# type: textblock

#. type: textblock

msgid "Intel EFI / GPT partition table."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"This is recommended for >= 2 TB partitions that will be accessed from Linux "

"and Intel-based Mac OS X. It also has limited backwards compatibility with "

# type: =item

#. type: =item

msgid "B<mbr> | B<msdos>"

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "

"Windows. This partition type will B<only> work for device sizes up to 2 "

# type: textblock

#. type: textblock

msgid ""

"Other partition table types that may work but are not supported include:"

msgstr ""

# type: =item

#. type: =item

msgid "B<aix>"

msgstr ""

# type: textblock

#. type: textblock

msgid "AIX disk labels."

msgstr ""

# type: =item

#. type: =item

msgid "B<amiga> | B<rdb>"

msgstr ""

# type: textblock

#. type: textblock

msgid "Amiga \"Rigid Disk Block\" format."

msgstr ""

# type: =item

#. type: =item

msgid "B<bsd>"

msgstr ""

# type: textblock

#. type: textblock

msgid "BSD disk labels."

msgstr ""

# type: =item

#. type: =item

msgid "B<dasd>"

msgstr ""

# type: textblock

#. type: textblock

msgid "DASD, used on IBM mainframes."

msgstr ""

# type: =item

#. type: =item

msgid "B<dvh>"

msgstr ""

# type: textblock

#. type: textblock

msgid "MIPS/SGI volumes."

msgstr ""

# type: =item

#. type: =item

msgid "B<mac>"

msgstr ""

# type: textblock

#. type: textblock

msgid "Old Mac partition format. Modern Macs use C<gpt>."

msgstr ""

# type: =item

#. type: =item

msgid "B<pc98>"

msgstr ""

# type: textblock

#. type: textblock

msgid "NEC PC-98 format, common in Japan apparently."

msgstr ""

# type: =item

#. type: =item

msgid "B<sun>"

msgstr ""

# type: textblock

#. type: textblock

msgid "Sun disk labels."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_part_list"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" struct guestfs_partition_list *\n"

# type: textblock

#. type: textblock

msgid ""

"This command parses the partition table on C<device> and returns the list of "

"partitions found."

# type: textblock

#. type: textblock

msgid "The fields in the returned structure are:"

msgstr ""

# type: =item

#. type: =item

msgid "B<part_num>"

msgstr ""

# type: textblock

#. type: textblock

msgid "Partition number, counting from 1."

msgstr ""

# type: =item

#. type: =item

msgid "B<part_start>"

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Start of the partition I<in bytes>. To get sectors you have to divide by "

"the device's sector size, see C<guestfs_blockdev_getss>."

# type: =item

#. type: =item

msgid "B<part_end>"

msgstr ""

# type: textblock

#. type: textblock

msgid "End of the partition in bytes."

msgstr ""

# type: =item

#. type: =item

msgid "B<part_size>"

msgstr ""

# type: textblock

#. type: textblock

msgid "Size of the partition in bytes."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"This function returns a C<struct guestfs_partition_list *>, or NULL if there "

"was an error. I<The caller must call C<guestfs_free_partition_list> after "

# type: =head2

#. type: =head2

msgid "guestfs_part_set_bootable"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This sets the bootable flag on partition numbered C<partnum> on device "

"C<device>. Note that partitions are numbered from 1."

# type: textblock

#. type: textblock

msgid ""

"The bootable flag is used by some operating systems (notably Windows) to "

"determine which partition to boot from. It is by no means universally "

# type: =head2

#. type: =head2

msgid "guestfs_part_set_mbr_id"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"Sets the MBR type byte (also known as the ID byte) of the numbered partition "

"C<partnum> to C<idbyte>. Note that the type bytes quoted in most "

# type: =head2

#. type: =head2

msgid "guestfs_part_set_name"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This sets the partition name on partition numbered C<partnum> on device "

"C<device>. Note that partitions are numbered from 1."

# type: textblock

#. type: textblock

msgid ""

"The partition name can only be set on certain types of partition table. "

"This works on C<gpt> but not on C<mbr> partitions."

# type: =head2

#. type: =head2

msgid "guestfs_part_to_dev"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This function takes a partition name (eg. \"/dev/sdb1\") and removes the "

"partition number, returning the device name (eg. \"/dev/sdb\")."

# type: textblock

#. type: textblock

msgid ""

"The named partition must exist, for example as a string returned from "

"C<guestfs_list_partitions>."

# type: =head2

#. type: =head2

msgid "guestfs_ping_daemon"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This is a test probe into the guestfs daemon running inside the qemu "

"subprocess. Calling this function checks that the daemon responds to the "

# type: =head2

#. type: =head2

msgid "guestfs_pread"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This command lets you read part of a file. It reads C<count> bytes of the "

"file, starting at C<offset>, from file C<path>."

# type: textblock

#. type: textblock

msgid ""

"This may read fewer bytes than requested. For further details see the "

"L<pread(2)> system call."

# type: textblock

#. type: textblock

msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_pread_device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This command lets you read part of a file. It reads C<count> bytes of "

"C<device>, starting at C<offset>."

# type: textblock

#. type: textblock

msgid "See also C<guestfs_pread>."

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.5.21)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_pvcreate"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This creates an LVM physical volume on the named C<device>, where C<device> "

"should usually be a partition name such as C</dev/sda1>."

# type: =head2

#. type: =head2

msgid "guestfs_pvremove"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This wipes a physical volume C<device> so that LVM will no longer recognise "

"it."

# type: textblock

#. type: textblock

msgid ""

"The implementation uses the C<pvremove> command which refuses to wipe "

"physical volumes that contain any volume groups, so you have to remove those "

# type: =head2

#. type: =head2

msgid "guestfs_pvresize"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This resizes (expands or shrinks) an existing LVM physical volume to match "

"the new size of the underlying device."

# type: =head2

#. type: =head2

msgid "guestfs_pvresize_size"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command is the same as C<guestfs_pvresize> except that it allows you to "

"specify the new size (in bytes) explicitly."

# type: =head2

#. type: =head2

msgid "guestfs_pvs"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"List all the physical volumes detected. This is the equivalent of the L<pvs"

"(8)> command."

# type: textblock

#. type: textblock

msgid ""

"This returns a list of just the device names that contain PVs (eg. C</dev/"

"sda2>)."

# type: textblock

#. type: textblock

msgid "See also C<guestfs_pvs_full>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_pvs_full"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" struct guestfs_lvm_pv_list *\n"

# type: textblock

#. type: textblock

msgid ""

"List all the physical volumes detected. This is the equivalent of the L<pvs"

"(8)> command. The \"full\" version includes all fields."

# type: textblock

#. type: textblock

msgid ""

"This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "

"was an error. I<The caller must call C<guestfs_free_lvm_pv_list> after use>."

# type: =head2

#. type: =head2

msgid "guestfs_pvuuid"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid "This command returns the UUID of the LVM PV C<device>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_pwrite"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command writes to part of a file. It writes the data buffer C<content> "

"to the file C<path> starting at offset C<offset>."

# type: textblock

#. type: textblock

msgid ""

"This command implements the L<pwrite(2)> system call, and like that system "

"call it may not write the full data requested. The return value is the "

# type: textblock

#. type: textblock

msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_pwrite_device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command writes to part of a device. It writes the data buffer "

"C<content> to C<device> starting at offset C<offset>."

# type: textblock

#. type: textblock

msgid ""

"This command implements the L<pwrite(2)> system call, and like that system "

"call it may not write the full data requested (although short writes to disk "

# type: textblock

#. type: textblock

msgid "See also C<guestfs_pwrite>."

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.5.20)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_read_file"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid "This calls returns the contents of the file C<path> as a buffer."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Unlike C<guestfs_cat>, this function can correctly handle files that contain "

"embedded ASCII NUL characters. However unlike C<guestfs_download>, this "

# type: textblock

#. type: textblock

msgid "(Added in 1.0.63)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_read_lines"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"The file contents are returned as a list of lines. Trailing C<LF> and "

"C<CRLF> character sequences are I<not> returned."

# type: textblock

#. type: textblock

msgid ""

"Note that this function cannot correctly handle binary files (specifically, "

"files containing C<\\0> character which is treated as end of line). For "

# type: =head2

#. type: =head2

msgid "guestfs_readdir"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" struct guestfs_dirent_list *\n"

# type: textblock

#. type: textblock

msgid "This returns the list of directory entries in directory C<dir>."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"All entries in the directory are returned, including C<.> and C<..>. The "

"entries are I<not> sorted, but returned in the same order as the underlying "

# type: textblock

#. type: textblock

msgid ""

"Also this call returns basic file type information about each file. The "

"C<ftyp> field will contain one of the following characters:"

# type: =item

#. type: =item

msgid "'b'"

msgstr ""

# type: textblock

#. type: textblock

msgid "Block special"

msgstr ""

# type: =item

#. type: =item

msgid "'c'"

msgstr ""

# type: textblock

#. type: textblock

msgid "Char special"

msgstr ""

# type: =item

#. type: =item

msgid "'d'"

msgstr ""

# type: textblock

#. type: textblock

msgid "Directory"

msgstr ""

# type: =item

#. type: =item

msgid "'f'"

msgstr ""

# type: textblock

#. type: textblock

msgid "FIFO (named pipe)"

msgstr ""

# type: =item

#. type: =item

msgid "'l'"

msgstr ""

# type: textblock

#. type: textblock

msgid "Symbolic link"

msgstr ""

# type: =item

#. type: =item

msgid "'r'"

msgstr ""

# type: textblock

#. type: textblock

msgid "Regular file"

msgstr ""

# type: =item

#. type: =item

msgid "'s'"

msgstr ""

# type: textblock

#. type: textblock

msgid "Socket"

msgstr ""

# type: =item

#. type: =item

msgid "'u'"

msgstr ""

# type: textblock

#. type: textblock

msgid "Unknown file type"

msgstr ""

# type: =item

#. type: =item

msgid "'?'"

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"The L<readdir(3)> call returned a C<d_type> field with an unexpected value"

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"This function is primarily intended for use by programs. To get a simple "

"list of names, use C<guestfs_ls>. To get a printable directory for human "

# type: textblock

#. type: textblock

msgid ""

"This function returns a C<struct guestfs_dirent_list *>, or NULL if there "

"was an error. I<The caller must call C<guestfs_free_dirent_list> after use>."

# type: =head2

#. type: =head2

msgid "guestfs_readlink"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid "This command reads the target of a symbolic link."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_readlinklist"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This call allows you to do a C<readlink> operation on multiple files, where "

"all files are in the directory C<path>. C<names> is the list of files from "

# type: textblock

#. type: textblock

msgid ""

"On return you get a list of strings, with a one-to-one correspondence to the "

"C<names> list. Each string is the value of the symbolic link."

# type: textblock

#. type: textblock

msgid ""

"If the C<readlink(2)> operation fails on any name, then the corresponding "

"result string is the empty string C<\"\">. However the whole operation is "

# type: textblock

#. type: textblock

msgid ""

"This call is intended for programs that want to efficiently list a directory "

"contents without making many round-trips. Very long directory listings "

# type: =head2

#. type: =head2

msgid "guestfs_realpath"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"Return the canonicalized absolute pathname of C<path>. The returned path "

"has no C<.>, C<..> or symbolic link path elements."

# type: =head2

#. type: =head2

msgid "guestfs_removexattr"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This call removes the extended attribute named C<xattr> of the file C<path>."

msgstr ""

# type: textblock

#. type: textblock

msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_resize2fs"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This resizes an ext2, ext3 or ext4 filesystem to match the size of the "

"underlying device."

# type: textblock

#. type: textblock

msgid ""

"I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "

"C<device> before calling this command. For unknown reasons C<resize2fs> "

msgstr ""

#. type: =head2

msgid "guestfs_resize2fs_M"

msgstr ""

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

msgstr ""

#. type: textblock

msgid ""

"This command is the same as C<guestfs_resize2fs>, but the filesystem is "

"resized to its minimum size. This works like the I<-M> option to the "

msgstr ""

#. type: textblock

msgid ""

"To get the resulting size of the filesystem you should call "

"C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values. "

# type: =head2

#. type: =head2

msgid "guestfs_resize2fs_size"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command is the same as C<guestfs_resize2fs> except that it allows you "

"to specify the new size (in bytes) explicitly."

# type: =head2

#. type: =head2

msgid "guestfs_rm"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "Remove the single file C<path>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_rm_rf"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"Remove the file or directory C<path>, recursively removing the contents if "

"its a directory. This is like the C<rm -rf> shell command."

# type: =head2

#. type: =head2

msgid "guestfs_rmdir"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "Remove the single directory C<path>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_rmmountpoint"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This calls removes a mountpoint that was previously created with "

"C<guestfs_mkmountpoint>. See C<guestfs_mkmountpoint> for full details."

# type: =head2

#. type: =head2

msgid "guestfs_scrub_device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command writes patterns over C<device> to make data retrieval more "

"difficult."

# type: textblock

#. type: textblock

msgid ""

"It is an interface to the L<scrub(1)> program. See that manual page for "

"more details."

# type: textblock

#. type: textblock

msgid "(Added in 1.0.52)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_scrub_file"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command writes patterns over a file to make data retrieval more "

"difficult."

# type: textblock

#. type: textblock

msgid "The file is I<removed> after scrubbing."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_scrub_freespace"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command creates the directory C<dir> and then fills it with files until "

"the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "

# type: =head2

#. type: =head2

msgid "guestfs_set_append"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This function is used to add additional options to the guest kernel command "

"line."

# type: textblock

#. type: textblock

msgid ""

"The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "

"environment variable."

# type: textblock

#. type: textblock

msgid ""

"Setting C<append> to C<NULL> means I<no> additional options are passed "

"(libguestfs always adds a few of its own)."

msgstr ""

#. type: =head2

msgid "guestfs_set_attach_method"

msgstr ""

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

msgstr ""

#. type: textblock

msgid ""

"Set the method that libguestfs uses to connect to the back end guestfsd "

"daemon. Possible methods are:"

msgstr ""

#. type: textblock

msgid ""

"Launch an appliance and connect to it. This is the ordinary method and the "

"default."

msgstr ""

#. type: =item

msgid "C<unix:I<path>>"

msgstr ""

#. type: textblock

msgid "Connect to the Unix domain socket I<path>."

msgstr ""

#. type: textblock

msgid ""

"This method lets you connect to an existing daemon or (using virtio-serial) "

"to a live guest. For more information, see L<guestfs(3)/ATTACHING TO "

# type: =head2

#. type: =head2

msgid "guestfs_set_autosync"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

msgstr ""

#. type: textblock

msgid ""

"If C<autosync> is true, this enables autosync. Libguestfs will make a best "

"effort attempt to make filesystems consistent and synchronized when the "

# type: textblock

#. type: textblock

msgid ""

"This is enabled by default (since libguestfs 1.5.24, previously it was "

"disabled by default)."

# type: =head2

#. type: =head2

msgid "guestfs_set_direct"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"If the direct appliance mode flag is enabled, then stdin and stdout are "

"passed directly through to the appliance once it is launched."

# type: textblock

#. type: textblock

msgid ""

"One consequence of this is that log messages aren't caught by the library "

"and handled by C<guestfs_set_log_message_callback>, but go straight to "

# type: textblock

#. type: textblock

msgid "You probably don't want to use this unless you know what you are doing."

msgstr ""

# type: textblock

#. type: textblock

msgid "The default is disabled."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_set_e2label"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "

"C<label>. Filesystem labels are limited to 16 characters."

# type: textblock

#. type: textblock

msgid ""

"You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "

"the existing label on a filesystem."

# type: =head2

#. type: =head2

msgid "guestfs_set_e2uuid"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "

"C<uuid>. The format of the UUID and alternatives such as C<clear>, "

# type: textblock

#. type: textblock

msgid ""

"You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "

"the existing UUID of a filesystem."

# type: =head2

#. type: =head2

msgid "guestfs_set_memsize"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This sets the memory size in megabytes allocated to the qemu subprocess. "

"This only has any effect if called before C<guestfs_launch>."

# type: textblock

#. type: textblock

msgid ""

"You can also change this by setting the environment variable "

"C<LIBGUESTFS_MEMSIZE> before the handle is created."

# type: =head2

#. type: =head2

msgid "guestfs_set_network"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"If C<network> is true, then the network is enabled in the libguestfs "

"appliance. The default is false."

# type: textblock

#. type: textblock

msgid ""

"This affects whether commands are able to access the network (see L<guestfs"

"(3)/RUNNING COMMANDS>)."

# type: textblock

#. type: textblock

msgid ""

"You must call this before calling C<guestfs_launch>, otherwise it has no "

"effect."

# type: =head2

#. type: =head2

msgid "guestfs_set_path"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "Set the path that libguestfs searches for kernel and initrd.img."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"The default is C<$libdir/guestfs> unless overridden by setting "

"C<LIBGUESTFS_PATH> environment variable."

# type: textblock

#. type: textblock

msgid "Setting C<path> to C<NULL> restores the default path."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_set_qemu"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "Set the qemu binary that we will use."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"The default is chosen when the library was compiled by the configure script."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"You can also override this by setting the C<LIBGUESTFS_QEMU> environment "

"variable."

# type: textblock

#. type: textblock

msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Note that you should call this function as early as possible after creating "

"the handle. This is because some pre-launch operations depend on testing "

# type: =head2

#. type: =head2

msgid "guestfs_set_recovery_proc"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"If this is called with the parameter C<false> then C<guestfs_launch> does "

"not create a recovery process. The purpose of the recovery process is to "

# type: textblock

#. type: textblock

msgid ""

"This only has any effect if called before C<guestfs_launch>, and the default "

"is true."

# type: textblock

#. type: textblock

msgid ""

"About the only time when you would want to disable this is if the main "

"process will fork itself into the background (\"daemonize\" itself). In "

# type: =head2

#. type: =head2

msgid "guestfs_set_selinux"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This sets the selinux flag that is passed to the appliance at boot time. "

"The default is C<selinux=0> (disabled)."

# type: textblock

#. type: textblock

msgid ""

"Note that if SELinux is enabled, it is always in Permissive mode "

"(C<enforcing=0>)."

# type: =head2

#. type: =head2

msgid "guestfs_set_trace"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

msgstr ""

#. type: textblock

msgid ""

"If the command trace flag is set to 1, then libguestfs calls, parameters and "

"return values are traced."

# type: textblock

#. type: textblock

msgid ""

"If you want to trace C API calls into libguestfs (and other libraries) then "

"possibly a better way is to use the external ltrace(1) command."

# type: textblock

#. type: textblock

msgid ""

"Command traces are disabled unless the environment variable "

"C<LIBGUESTFS_TRACE> is defined and set to C<1>."

msgstr ""

#. type: textblock

msgid ""

"Trace messages are normally sent to C<stderr>, unless you register a "

"callback to send them somewhere else (see C<guestfs_set_event_callback>)."

# type: =head2

#. type: =head2

msgid "guestfs_set_verbose"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

msgstr ""

#. type: textblock

msgid "If C<verbose> is true, this turns on verbose messages."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Verbose messages are disabled unless the environment variable "

"C<LIBGUESTFS_DEBUG> is defined and set to C<1>."

msgstr ""

#. type: textblock

msgid ""

"Verbose messages are normally sent to C<stderr>, unless you register a "

"callback to send them somewhere else (see C<guestfs_set_event_callback>)."

# type: =head2

#. type: =head2

msgid "guestfs_setcon"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This sets the SELinux security context of the daemon to the string "

"C<context>."

# type: textblock

#. type: textblock

msgid "See the documentation about SELINUX in L<guestfs(3)>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_setxattr"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This call sets the extended attribute named C<xattr> of the file C<path> to "

"the value C<val> (of length C<vallen>). The value is arbitrary 8 bit data."

# type: textblock

#. type: textblock

msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_sfdisk"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This is a direct interface to the L<sfdisk(8)> program for creating "

"partitions on block devices."

# type: textblock

#. type: textblock

msgid "C<device> should be a block device, for example C</dev/sda>."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "

"sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"

# type: textblock

#. type: textblock

msgid ""

"C<lines> is a list of lines that we feed to C<sfdisk>. For more information "

"refer to the L<sfdisk(8)> manpage."

# type: textblock

#. type: textblock

msgid ""

"To create a single partition occupying the whole disk, you would pass "

"C<lines> as a single element list, when the single element being the string "

# type: textblock

#. type: textblock

msgid ""

"See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_sfdiskM"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This is a simplified interface to the C<guestfs_sfdisk> command, where "

"partition sizes are specified in megabytes only (rounded to the nearest "

# type: textblock

#. type: textblock

msgid ""

"See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "

"C<guestfs_part_disk>"

# type: =head2

#. type: =head2

msgid "guestfs_sfdisk_N"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This runs L<sfdisk(8)> option to modify just the single partition C<n> "

"(note: C<n> counts from 1)."

# type: textblock

#. type: textblock

msgid ""

"For other parameters, see C<guestfs_sfdisk>. You should usually pass C<0> "

"for the cyls/heads/sectors parameters."

# type: textblock

#. type: textblock

msgid "See also: C<guestfs_part_add>"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_sfdisk_disk_geometry"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This displays the disk geometry of C<device> read from the partition table. "

"Especially in the case where the underlying block device has been resized, "

# type: textblock

#. type: textblock

msgid "The result is in human-readable format, and not designed to be parsed."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_sfdisk_kernel_geometry"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid "This displays the kernel's idea of the geometry of C<device>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_sfdisk_l"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This displays the partition table on C<device>, in the human-readable output "

"of the L<sfdisk(8)> command. It is not intended to be parsed."

# type: textblock

#. type: textblock

msgid "See also: C<guestfs_part_list>"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_sh"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This call runs a command from the guest filesystem via the guest's C</bin/"

"sh>."

# type: textblock

#. type: textblock

msgid "This is like C<guestfs_command>, but passes the command to:"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" /bin/sh -c \"command\"\n"

# type: textblock

#. type: textblock

msgid ""

"Depending on the guest's shell, this usually results in wildcards being "

"expanded, shell expressions being interpolated and so on."

# type: textblock

#. type: textblock

msgid "All the provisos about C<guestfs_command> apply to this call."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_sh_lines"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This is the same as C<guestfs_sh>, but splits the result into a list of "

"lines."

# type: textblock

#. type: textblock

msgid "See also: C<guestfs_command_lines>"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_sleep"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "Sleep for C<secs> seconds."

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.41)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_stat"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" struct guestfs_stat *\n"

# type: textblock

#. type: textblock

msgid "This is the same as the C<stat(2)> system call."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_statvfs"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" struct guestfs_statvfs *\n"

# type: textblock

#. type: textblock

msgid ""

"Returns file system statistics for any mounted file system. C<path> should "

"be a file or directory in the mounted file system (typically it is the mount "

# type: textblock

#. type: textblock

msgid "This is the same as the C<statvfs(2)> system call."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "

"error. I<The caller must call C<guestfs_free_statvfs> after use>."

# type: =head2

#. type: =head2

msgid "guestfs_strings"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This runs the L<strings(1)> command on a file and returns the list of "

"printable strings found."

# type: =head2

#. type: =head2

msgid "guestfs_strings_e"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This is like the C<guestfs_strings> command, but allows you to specify the "

"encoding of strings that are looked for in the source file C<path>."

# type: textblock

#. type: textblock

msgid "Allowed encodings are:"

msgstr ""

# type: =item

#. type: =item

msgid "s"

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "

"ISO-8859-X (this is what C<guestfs_strings> uses)."

# type: =item

#. type: =item

msgid "S"

msgstr ""

# type: textblock

#. type: textblock

msgid "Single 8-bit-byte characters."

msgstr ""

# type: =item

#. type: =item

msgid "b"

msgstr ""

# type: textblock

#. type: textblock

msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."

msgstr ""

# type: =item

#. type: =item

msgid "l (lower case letter L)"

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"16-bit little endian such as UTF-16LE and UCS-2LE. This is useful for "

"examining binaries in Windows guests."

# type: =item

#. type: =item

msgid "B"

msgstr ""

# type: textblock

#. type: textblock

msgid "32-bit big endian such as UCS-4BE."

msgstr ""

# type: =item

#. type: =item

msgid "L"

msgstr ""

# type: textblock

#. type: textblock

msgid "32-bit little endian such as UCS-4LE."

msgstr ""

# type: textblock

#. type: textblock

msgid "The returned strings are transcoded to UTF-8."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_swapoff_device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command disables the libguestfs appliance swap device or partition "

"named C<device>. See C<guestfs_swapon_device>."

# type: =head2

#. type: =head2

msgid "guestfs_swapoff_file"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "This command disables the libguestfs appliance swap on file."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_swapoff_label"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command disables the libguestfs appliance swap on labeled swap "

"partition."

# type: =head2

#. type: =head2

msgid "guestfs_swapoff_uuid"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command disables the libguestfs appliance swap partition with the given "

"UUID."

# type: =head2

#. type: =head2

msgid "guestfs_swapon_device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command enables the libguestfs appliance to use the swap device or "

"partition named C<device>. The increased memory is made available for all "

# type: textblock

#. type: textblock

msgid ""

"Note that you should not swap to existing guest swap partitions unless you "

"know what you are doing. They may contain hibernation information, or other "

# type: =head2

#. type: =head2

msgid "guestfs_swapon_file"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command enables swap to a file. See C<guestfs_swapon_device> for other "

"notes."

# type: =head2

#. type: =head2

msgid "guestfs_swapon_label"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command enables swap to a labeled swap partition. See "

"C<guestfs_swapon_device> for other notes."

# type: =head2

#. type: =head2

msgid "guestfs_swapon_uuid"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command enables swap to a swap partition with the given UUID. See "

"C<guestfs_swapon_device> for other notes."

# type: =head2

#. type: =head2

msgid "guestfs_sync"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This syncs the disk, so that any writes are flushed through to the "

"underlying disk image."

# type: textblock

#. type: textblock

msgid ""

"You should always call this if you have modified a disk image, before "

"closing the handle."

# type: =head2

#. type: =head2

msgid "guestfs_tail"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This command returns up to the last 10 lines of a file as a list of strings."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_tail_n"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"If the parameter C<nrlines> is a positive number, this returns the last "

"C<nrlines> lines of the file C<path>."

# type: textblock

#. type: textblock

msgid ""

"If the parameter C<nrlines> is a negative number, this returns lines from "

"the file C<path>, starting with the C<-nrlines>th line."

# type: =head2

#. type: =head2

msgid "guestfs_tar_in"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "

"tar file) into C<directory>."

# type: textblock

#. type: textblock

msgid ""

"To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.0.3)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_tar_out"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command packs the contents of C<directory> and downloads it to local "

"file C<tarfile>."

# type: textblock

#. type: textblock

msgid ""

"To download a compressed tarball, use C<guestfs_tgz_out> or "

"C<guestfs_txz_out>."

# type: =head2

#. type: =head2

msgid "guestfs_tgz_in"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "

"tar file) into C<directory>."

# type: textblock

#. type: textblock

msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_tgz_out"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command packs the contents of C<directory> and downloads it to local "

"file C<tarball>."

# type: textblock

#. type: textblock

msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_touch"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"Touch acts like the L<touch(1)> command. It can be used to update the "

"timestamps on a file, or, if the file does not exist, to create a new zero-"

# type: textblock

#. type: textblock

msgid ""

"This command only works on regular files, and will fail on other file types "

"such as directories, symbolic links, block special etc."

# type: =head2

#. type: =head2

msgid "guestfs_truncate"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command truncates C<path> to a zero-length file. The file must exist "

"already."

# type: =head2

#. type: =head2

msgid "guestfs_truncate_size"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command truncates C<path> to size C<size> bytes. The file must exist "

"already."

# type: textblock

#. type: textblock

msgid ""

"If the current file size is less than C<size> then the file is extended to "

"the required size with zero bytes. This creates a sparse file (ie. disk "

# type: =head2

#. type: =head2

msgid "guestfs_tune2fs_l"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "

"C<device>."

# type: textblock

#. type: textblock

msgid ""

"It is the same as running C<tune2fs -l device>. See L<tune2fs(8)> manpage "

"for more details. The list of fields returned isn't clearly defined, and "

# type: =head2

#. type: =head2

msgid "guestfs_txz_in"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command uploads and unpacks local file C<tarball> (an I<xz compressed> "

"tar file) into C<directory>."

# type: =head2

#. type: =head2

msgid "guestfs_txz_out"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command packs the contents of C<directory> and downloads it to local "

"file C<tarball> (as an xz compressed tar archive)."

# type: =head2

#. type: =head2

msgid "guestfs_umask"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This function sets the mask used for creating new files and device nodes to "

"C<mask & 0777>."

# type: textblock

#. type: textblock

msgid ""

"Typical umask values would be C<022> which creates new files with "

"permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "

# type: textblock

#. type: textblock

msgid ""

"The default umask is C<022>. This is important because it means that "

"directories and device nodes will be created with C<0644> or C<0755> mode "

# type: textblock

#. type: textblock

msgid ""

"See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "

"C<guestfs_mkdir>."

# type: textblock

#. type: textblock

msgid "This call returns the previous umask."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_umount"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This unmounts the given filesystem. The filesystem may be specified either "

"by its mountpoint (path) or the device which contains the filesystem."

# type: =head2

#. type: =head2

msgid "guestfs_umount_all"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "This unmounts all mounted filesystems."

msgstr ""

# type: textblock

#. type: textblock

msgid "Some internal mounts are not unmounted by this call."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_upload"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."

msgstr ""

# type: textblock

#. type: textblock

msgid "See also C<guestfs_download>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_upload_offset"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"C<remotefilename> is overwritten starting at the byte C<offset> specified. "

"The intention is to overwrite parts of existing files or devices, although "

# type: textblock

#. type: textblock

msgid ""

"Note that there is no limit on the amount of data that can be uploaded with "

"this call, unlike with C<guestfs_pwrite>, and this call always writes the "

# type: textblock

#. type: textblock

msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_utimens"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "This command sets the timestamps of a file with nanosecond precision."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "

"from the epoch."

# type: textblock

#. type: textblock

msgid ""

"C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "

"nanoseconds from the epoch."

# type: textblock

#. type: textblock

msgid ""

"If the C<*nsecs> field contains the special value C<-1> then the "

"corresponding timestamp is set to the current time. (The C<*secs> field is "

# type: textblock

#. type: textblock

msgid ""

"If the C<*nsecs> field contains the special value C<-2> then the "

"corresponding timestamp is left unchanged. (The C<*secs> field is ignored "

# type: =head2

#. type: =head2

msgid "guestfs_version"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" struct guestfs_version *\n"

# type: textblock

#. type: textblock

msgid ""

"Return the libguestfs version number that the program is linked against."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Note that because of dynamic linking this is not necessarily the version of "

"libguestfs that you compiled against. You can compile the program, and then "

# type: textblock

#. type: textblock

msgid ""

"This call was added in version C<1.0.58>. In previous versions of "

"libguestfs there was no way to get the version number. From C code you can "

# type: textblock

#. type: textblock

msgid ""

"The call returns a structure with four elements. The first three (C<major>, "

"C<minor> and C<release>) are numbers and correspond to the usual version "

# type: textblock

#. type: textblock

msgid ""

"To construct the original version string: C<$major.$minor.$release$extra>"

msgstr ""

# type: textblock

#. type: textblock

msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"I<Note:> Don't use this call to test for availability of features. In "

"enterprise distributions we backport features from later versions into "

# type: textblock

#. type: textblock

msgid ""

"This function returns a C<struct guestfs_version *>, or NULL if there was an "

"error. I<The caller must call C<guestfs_free_version> after use>."

# type: textblock

#. type: textblock

msgid "(Added in 1.0.58)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vfs_label"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid "This returns the filesystem label of the filesystem on C<device>."

msgstr ""

# type: textblock

#. type: textblock

msgid "If the filesystem is unlabeled, this returns the empty string."

msgstr ""

# type: textblock

#. type: textblock

msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."

msgstr ""

# type: textblock

#. type: textblock

msgid "(Added in 1.3.18)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vfs_type"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This command gets the filesystem type corresponding to the filesystem on "

"C<device>."

# type: textblock

#. type: textblock

msgid ""

"For most filesystems, the result is the name of the Linux VFS module which "

"would be used to mount this filesystem if you mounted it without specifying "

# type: =head2

#. type: =head2

msgid "guestfs_vfs_uuid"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid "This returns the filesystem UUID of the filesystem on C<device>."

msgstr ""

# type: textblock

#. type: textblock

msgid "If the filesystem does not have a UUID, this returns the empty string."

msgstr ""

# type: textblock

#. type: textblock

msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vg_activate"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command activates or (if C<activate> is false) deactivates all logical "

"volumes in the listed volume groups C<volgroups>. If activated, then they "

# type: textblock

#. type: textblock

msgid "This command is the same as running C<vgchange -a y|n volgroups...>"

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Note that if C<volgroups> is an empty list then B<all> volume groups are "

"activated or deactivated."

# type: =head2

#. type: =head2

msgid "guestfs_vg_activate_all"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command activates or (if C<activate> is false) deactivates all logical "

"volumes in all volume groups. If activated, then they are made known to the "

# type: textblock

#. type: textblock

msgid "This command is the same as running C<vgchange -a y|n>"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vgcreate"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This creates an LVM volume group called C<volgroup> from the non-empty list "

"of physical volumes C<physvols>."

# type: =head2

#. type: =head2

msgid "guestfs_vglvuuids"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"Given a VG called C<vgname>, this returns the UUIDs of all the logical "

"volumes created in this volume group."

# type: textblock

#. type: textblock

msgid ""

"You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "

"associate logical volumes and volume groups."

# type: textblock

#. type: textblock

msgid "See also C<guestfs_vgpvuuids>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vgpvuuids"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"Given a VG called C<vgname>, this returns the UUIDs of all the physical "

"volumes that this volume group resides on."

# type: textblock

#. type: textblock

msgid ""

"You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "

"associate physical volumes and volume groups."

# type: textblock

#. type: textblock

msgid "See also C<guestfs_vglvuuids>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vgremove"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"This also forcibly removes all logical volumes in the volume group (if any)."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vgrename"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vgs"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"List all the volumes groups detected. This is the equivalent of the L<vgs(8)"

"> command."

# type: textblock

#. type: textblock

msgid ""

"This returns a list of just the volume group names that were detected (eg. "

"C<VolGroup00>)."

# type: textblock

#. type: textblock

msgid "See also C<guestfs_vgs_full>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_vgs_full"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" struct guestfs_lvm_vg_list *\n"

# type: textblock

#. type: textblock

msgid ""

"List all the volumes groups detected. This is the equivalent of the L<vgs(8)"

"> command. The \"full\" version includes all fields."

# type: textblock

#. type: textblock

msgid ""

"This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "

"was an error. I<The caller must call C<guestfs_free_lvm_vg_list> after use>."

# type: =head2

#. type: =head2

msgid "guestfs_vgscan"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This rescans all block devices and rebuilds the list of LVM physical "

"volumes, volume groups and logical volumes."

# type: =head2

#. type: =head2

msgid "guestfs_vguuid"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid "This command returns the UUID of the LVM VG named C<vgname>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_wait_ready"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "This function is a no op."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"In versions of the API E<lt> 1.0.71 you had to call this function just after "

"calling C<guestfs_launch> to wait for the launch to complete. However this "

# type: textblock

#. type: textblock

msgid ""

"If you see any calls to this function in code then you can just remove them, "

"unless you want to retain compatibility with older versions of the API."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_wc_c"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command counts the characters in a file, using the C<wc -c> external "

"command."

# type: =head2

#. type: =head2

msgid "guestfs_wc_l"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command counts the lines in a file, using the C<wc -l> external command."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_wc_w"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command counts the words in a file, using the C<wc -w> external command."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_write"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This call creates a file called C<path>. The content of the file is the "

"string C<content> (which can contain any 8 bit data)."

# type: =head2

#. type: =head2

msgid "guestfs_write_file"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This call creates a file called C<path>. The contents of the file is the "

"string C<content> (which can contain any 8 bit data), with length C<size>."

# type: textblock

#. type: textblock

msgid ""

"As a special case, if C<size> is C<0> then the length is calculated using "

"C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."

# type: textblock

#. type: textblock

msgid ""

"I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "

"I<not> work, even if the length is specified."

# type: textblock

#. type: textblock

msgid ""

"This function is deprecated. In new code, use the C<write> call instead."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zegrep"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This calls the external C<zegrep> program and returns the matching lines."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zegrepi"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This calls the external C<zegrep -i> program and returns the matching lines."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zero"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid "This command writes zeroes over the first few blocks of C<device>."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"How many blocks are zeroed isn't specified (but it's I<not> enough to "

"securely wipe the device). It should be sufficient to remove any partition "

# type: textblock

#. type: textblock

msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zero_device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This command writes zeroes over the entire C<device>. Compare with "

"C<guestfs_zero> which just zeroes the first few blocks of a device."

# type: textblock

#. type: textblock

msgid "(Added in 1.3.1)"

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zerofree"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" int\n"

# type: textblock

#. type: textblock

msgid ""

"This runs the I<zerofree> program on C<device>. This program claims to zero "

"unused inodes and disk blocks on an ext2/3 filesystem, thus making it "

# type: textblock

#. type: textblock

msgid "You should B<not> run this program if the filesystem is mounted."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"It is possible that using this program can damage the filesystem or data on "

"the filesystem."

# type: =head2

#. type: =head2

msgid "guestfs_zfgrep"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This calls the external C<zfgrep> program and returns the matching lines."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zfgrepi"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This calls the external C<zfgrep -i> program and returns the matching lines."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zfile"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char *\n"

# type: textblock

#. type: textblock

msgid ""

"This command runs C<file> after first decompressing C<path> using C<method>."

msgstr ""

# type: textblock

#. type: textblock

msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."

msgstr ""

# type: textblock

#. type: textblock

msgid ""

"Since 1.0.63, use C<guestfs_file> instead which can now process compressed "

"files."

# type: textblock

#. type: textblock

msgid ""

"This function is deprecated. In new code, use the C<file> call instead."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zgrep"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This calls the external C<zgrep> program and returns the matching lines."

msgstr ""

# type: =head2

#. type: =head2

msgid "guestfs_zgrepi"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" char **\n"

# type: textblock

#. type: textblock

msgid ""

"This calls the external C<zgrep -i> program and returns the matching lines."

msgstr ""

# type: textblock

#. type: textblock

#: ../fish/guestfish.pod:1183 ../test-tool/libguestfs-test-tool.pod:102

#: ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309

#: ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277

msgid ""

# type: textblock

#. type: textblock

#: ../fish/guestfish.pod:1188 ../test-tool/libguestfs-test-tool.pod:107

#: ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314

#: ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282

msgid ""

# type: textblock

#. type: textblock

#: ../fish/guestfish.pod:1193 ../test-tool/libguestfs-test-tool.pod:112

#: ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319

#: ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287

msgid ""

#: ../fish/guestfish-actions.pod:435 ../fish/guestfish-actions.pod:444

#: ../fish/guestfish-actions.pod:668 ../fish/guestfish-actions.pod:837

#: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:1233

msgid "Use C<-> instead of a filename to read/write from stdin/stdout."

msgstr ""

# type: =head2

#. type: =head2

msgid "mount-loop"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" mount-loop file mountpoint\n"

# type: =head2

#. type: =head2

msgid "mount-options"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" mount-options options device mountpoint\n"

# type: textblock

#. type: textblock

msgid ""

"This is the same as the L</mount> command, but it allows you to set the "

"mount options as for the L<mount(8)> I<-o> flag."

# type: =head2

#. type: =head2

msgid "mount-ro"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" mount-ro device mountpoint\n"

# type: textblock

#. type: textblock

msgid ""

"This is the same as the L</mount> command, but it mounts the filesystem with "

"the read-only (I<-o ro>) flag."

# type: =head2

#. type: =head2

msgid "mount-vfs"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" mount-vfs options vfstype device mountpoint\n"

# type: textblock

#. type: textblock

msgid ""

"This is the same as the L</mount> command, but it allows you to set both the "

"mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."

# type: =head2

#. type: =head2

msgid "mountpoints"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" mountpoints\n"

# type: textblock

#. type: textblock

msgid ""

"This call is similar to L</mounts>. That call returns a list of devices. "

"This one returns a hash table (map) of device name to directory where the "

# type: =head2

#. type: =head2

msgid "mounts"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" mounts\n"

# type: textblock

#. type: textblock

msgid "See also: L</mountpoints>"

msgstr ""

# type: =head2

#. type: =head2

msgid "mv"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" mv src dest\n"

# type: =head2

#. type: =head2

msgid "ntfs-3g-probe"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" ntfs-3g-probe true|false device\n"

# type: =head2

#. type: =head2

msgid "ntfsresize"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" ntfsresize device\n"

# type: =head2

#. type: =head2

msgid "ntfsresize-size"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" ntfsresize-size device size\n"

# type: textblock

#. type: textblock

msgid ""

"This command is the same as L</ntfsresize> except that it allows you to "

"specify the new size (in bytes) explicitly."

# type: =head2

#. type: =head2

msgid "part-add"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-add device prlogex startsect endsect\n"

# type: textblock

#. type: textblock

msgid ""

"This command adds a partition to C<device>. If there is no partition table "

"on the device, call L</part-init> first."

# type: textblock

#. type: textblock

msgid ""

"Creating a partition which covers the whole disk is not so easy. Use L</"

"part-disk> to do that."

# type: =head2

#. type: =head2

msgid "part-del"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-del device partnum\n"

# type: =head2

#. type: =head2

msgid "part-disk"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-disk device parttype\n"

# type: textblock

#. type: textblock

msgid ""

"This command is simply a combination of L</part-init> followed by L</part-"

"add> to create a single primary partition covering the whole disk."

# type: textblock

#. type: textblock

msgid ""

"C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "

"possible values are described in L</part-init>."

# type: =head2

#. type: =head2

msgid "part-get-bootable"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-get-bootable device partnum\n"

# type: textblock

#. type: textblock

msgid "See also L</part-set-bootable>."

msgstr ""

# type: =head2

#. type: =head2

msgid "part-get-mbr-id"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-get-mbr-id device partnum\n"

# type: textblock

#. type: textblock

msgid ""

"Note that only MBR (old DOS-style) partitions have type bytes. You will get "

"undefined results for other partition table types (see L</part-get-"

# type: =head2

#. type: =head2

msgid "part-get-parttype"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-get-parttype device\n"

# type: textblock

#. type: textblock

msgid ""

"Common return values include: C<msdos> (a DOS/Windows style MBR partition "

"table), C<gpt> (a GPT/EFI-style partition table). Other values are "

# type: =head2

#. type: =head2

msgid "part-init"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-init device parttype\n"

# type: textblock

#. type: textblock

msgid ""

"Initially there are no partitions. Following this, you should call L</part-"

"add> for each partition required."

# type: =head2

#. type: =head2

msgid "part-list"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-list device\n"

# type: textblock

#. type: textblock

msgid ""

"Start of the partition I<in bytes>. To get sectors you have to divide by "

"the device's sector size, see L</blockdev-getss>."

# type: =head2

#. type: =head2

msgid "part-set-bootable"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-set-bootable device partnum true|false\n"

# type: =head2

#. type: =head2

msgid "part-set-mbr-id"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-set-mbr-id device partnum idbyte\n"

# type: =head2

#. type: =head2

msgid "part-set-name"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-set-name device partnum name\n"

# type: =head2

#. type: =head2

msgid "part-to-dev"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" part-to-dev partition\n"

# type: textblock

#. type: textblock

msgid ""

"The named partition must exist, for example as a string returned from L</"

"list-partitions>."

# type: =head2

#. type: =head2

msgid "ping-daemon"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" ping-daemon\n"

# type: =head2

#. type: =head2

msgid "pread"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pread path count offset\n"

# type: textblock

#. type: textblock

msgid "See also L</pwrite>, L</pread-device>."

msgstr ""

# type: =head2

#. type: =head2

msgid "pread-device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pread-device device count offset\n"

# type: textblock

#. type: textblock

msgid "See also L</pread>."

msgstr ""

# type: =head2

#. type: =head2

msgid "pvcreate"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pvcreate device\n"

# type: =head2

#. type: =head2

msgid "pvremove"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pvremove device\n"

# type: =head2

#. type: =head2

msgid "pvresize"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pvresize device\n"

# type: =head2

#. type: =head2

msgid "pvresize-size"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pvresize-size device size\n"

# type: textblock

#. type: textblock

msgid ""

"This command is the same as L</pvresize> except that it allows you to "

"specify the new size (in bytes) explicitly."

# type: =head2

#. type: =head2

msgid "pvs"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pvs\n"

# type: textblock

#. type: textblock

msgid "See also L</pvs-full>."

msgstr ""

# type: =head2

#. type: =head2

msgid "pvs-full"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pvs-full\n"

# type: =head2

#. type: =head2

msgid "pvuuid"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pvuuid device\n"

# type: =head2

#. type: =head2

msgid "pwrite"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pwrite path content offset\n"

# type: textblock

#. type: textblock

msgid "See also L</pread>, L</pwrite-device>."

msgstr ""

# type: =head2

#. type: =head2

msgid "pwrite-device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" pwrite-device device content offset\n"

# type: textblock

#. type: textblock

msgid "See also L</pwrite>."

msgstr ""

# type: =head2

#. type: =head2

msgid "read-file"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" read-file path\n"

# type: textblock

#. type: textblock

msgid ""

"Unlike L</cat>, this function can correctly handle files that contain "

"embedded ASCII NUL characters. However unlike L</download>, this function "

# type: =head2

#. type: =head2

msgid "read-lines"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" read-lines path\n"

# type: textblock

#. type: textblock

msgid ""

"Note that this function cannot correctly handle binary files (specifically, "

"files containing C<\\0> character which is treated as end of line). For "

# type: =head2

#. type: =head2

msgid "readdir"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" readdir dir\n"

# type: textblock

#. type: textblock

msgid ""

"This function is primarily intended for use by programs. To get a simple "

"list of names, use L</ls>. To get a printable directory for human "

# type: =head2

#. type: =head2

msgid "readlink"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" readlink path\n"

# type: =head2

#. type: =head2

msgid "readlinklist"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" readlinklist path 'names ...'\n"

# type: =head2

#. type: =head2

msgid "realpath"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" realpath path\n"

# type: =head2

#. type: =head2

msgid "removexattr"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" removexattr xattr path\n"

# type: textblock

#. type: textblock

msgid "See also: L</lremovexattr>, L<attr(5)>."

msgstr ""

# type: =head2

#. type: =head2

msgid "resize2fs"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" resize2fs device\n"

# type: textblock

#. type: textblock

msgid ""

"I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "

"before calling this command. For unknown reasons C<resize2fs> sometimes "

msgstr ""

#. type: =head2

msgid "resize2fs-M"

msgstr ""

#. type: verbatim

#, no-wrap

msgid ""

" resize2fs-M device\n"

msgstr ""

#. type: textblock

msgid ""

"This command is the same as L</resize2fs>, but the filesystem is resized to "

"its minimum size. This works like the I<-M> option to the C<resize2fs> "

msgstr ""

#. type: textblock

msgid ""

"To get the resulting size of the filesystem you should call L</tune2fs-l> "

"and read the C<Block size> and C<Block count> values. These two numbers, "

# type: =head2

#. type: =head2

msgid "resize2fs-size"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" resize2fs-size device size\n"

# type: textblock

#. type: textblock

msgid ""

"This command is the same as L</resize2fs> except that it allows you to "

"specify the new size (in bytes) explicitly."

# type: =head2

#. type: =head2

msgid "rm"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" rm path\n"

# type: =head2

#. type: =head2

msgid "rm-rf"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" rm-rf path\n"

# type: =head2

#. type: =head2

msgid "rmdir"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" rmdir path\n"

# type: =head2

#. type: =head2

msgid "rmmountpoint"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" rmmountpoint exemptpath\n"

# type: textblock

#. type: textblock

msgid ""

"This calls removes a mountpoint that was previously created with L</"

"mkmountpoint>. See L</mkmountpoint> for full details."

# type: =head2

#. type: =head2

msgid "scrub-device"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" scrub-device device\n"

# type: =head2

#. type: =head2

msgid "scrub-file"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" scrub-file file\n"

# type: =head2

#. type: =head2

msgid "scrub-freespace"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" scrub-freespace dir\n"

# type: textblock

#. type: textblock

msgid ""

"This command creates the directory C<dir> and then fills it with files until "

"the filesystem is full, and scrubs the files as for L</scrub-file>, and "

# type: =head2

#. type: =head2

msgid "set-append"

msgstr ""

# type: =head2

#. type: =head2

msgid "append"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-append append\n"

msgstr ""

#. type: =head2

msgid "set-attach-method"

msgstr ""

#. type: =head2

msgid "attach-method"

msgstr ""

#. type: verbatim

#, no-wrap

msgid ""

" set-attach-method attachmethod\n"

# type: =head2

#. type: =head2

msgid "set-autosync"

msgstr ""

# type: =head2

#. type: =head2

msgid "autosync"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-autosync true|false\n"

# type: =head2

#. type: =head2

msgid "set-direct"

msgstr ""

# type: =head2

#. type: =head2

msgid "direct"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-direct true|false\n"

# type: textblock

#. type: textblock

msgid ""

"One consequence of this is that log messages aren't caught by the library "

"and handled by L</set-log-message-callback>, but go straight to stdout."

# type: =head2

#. type: =head2

msgid "set-e2label"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-e2label device label\n"

# type: textblock

#. type: textblock

msgid ""

"You can use either L</tune2fs-l> or L</get-e2label> to return the existing "

"label on a filesystem."

# type: =head2

#. type: =head2

msgid "set-e2uuid"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-e2uuid device uuid\n"

# type: textblock

#. type: textblock

msgid ""

"You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "

"UUID of a filesystem."

# type: =head2

#. type: =head2

msgid "set-memsize"

msgstr ""

# type: =head2

#. type: =head2

msgid "memsize"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-memsize memsize\n"

# type: textblock

#. type: textblock

msgid ""

"This sets the memory size in megabytes allocated to the qemu subprocess. "

"This only has any effect if called before L</launch>."

# type: =head2

#. type: =head2

msgid "set-network"

msgstr ""

# type: =head2

#. type: =head2

msgid "network"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-network true|false\n"

# type: textblock

#. type: textblock

msgid ""

"You must call this before calling L</launch>, otherwise it has no effect."

msgstr ""

# type: =head2

#. type: =head2

msgid "set-path"

msgstr ""

# type: =head2

#. type: =head2

msgid "path"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-path searchpath\n"

# type: =head2

#. type: =head2

msgid "set-qemu"

msgstr ""

# type: =head2

#. type: =head2

msgid "qemu"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-qemu qemu\n"

# type: =head2

#. type: =head2

msgid "set-recovery-proc"

msgstr ""

# type: =head2

#. type: =head2

msgid "recovery-proc"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-recovery-proc true|false\n"

# type: textblock

#. type: textblock

msgid ""

"If this is called with the parameter C<false> then L</launch> does not "

"create a recovery process. The purpose of the recovery process is to stop "

# type: textblock

#. type: textblock

msgid ""

"This only has any effect if called before L</launch>, and the default is "

"true."

# type: =head2

#. type: =head2

msgid "set-selinux"

msgstr ""

# type: =head2

#. type: =head2

msgid "selinux"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-selinux true|false\n"

# type: =head2

#. type: =head2

msgid "set-trace"

msgstr ""

# type: =head2

#. type: =head2

msgid "trace"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-trace true|false\n"

msgstr ""

#. type: textblock

msgid ""

"Trace messages are normally sent to C<stderr>, unless you register a "

"callback to send them somewhere else (see L</set-event-callback>)."

# type: =head2

#. type: =head2

msgid "set-verbose"

msgstr ""

# type: =head2

#. type: =head2

msgid "verbose"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" set-verbose true|false\n"

msgstr ""

#. type: textblock

msgid ""

"Verbose messages are normally sent to C<stderr>, unless you register a "

"callback to send them somewhere else (see L</set-event-callback>)."

# type: =head2

#. type: =head2

msgid "setcon"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" setcon context\n"

# type: =head2

#. type: =head2

msgid "setxattr"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" setxattr xattr val vallen path\n"

# type: textblock

#. type: textblock

msgid "See also: L</lsetxattr>, L<attr(5)>."

msgstr ""

# type: =head2

#. type: =head2

msgid "sfdisk"

msgstr ""

# type: verbatim

#. type: verbatim

#, no-wrap

msgid ""

" sfdisk device cyls heads sectors 'lines ...'\n"

# type: textblock

#. type: textblock