X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;ds=sidebyside;f=perl%2Flib%2FSys%2FGuestfs.pm;h=ea82659256c01f5e1bba0cde3ef36afe9c1c9918;hb=79cdf81e2fb717ea4372a55170d16800cdbddf23;hp=bd8da0f2cfce97423f49090b168653cb00283652;hpb=170f262f0413de843af62b968f6d12c1c476ae7f;p=libguestfs.git diff --git a/perl/lib/Sys/Guestfs.pm b/perl/lib/Sys/Guestfs.pm index bd8da0f..ea82659 100644 --- a/perl/lib/Sys/Guestfs.pm +++ b/perl/lib/Sys/Guestfs.pm @@ -337,6 +337,49 @@ Because of the message protocol, there is a transfer limit of somewhere between 2MB and 4MB. To transfer large files you should use FTP. +=item $checksum = $h->checksum ($csumtype, $path); + +This call computes the MD5, SHAx or CRC checksum of the +file named C. + +The type of checksum to compute is given by the C +parameter which must have one of the following values: + +=over 4 + +=item C + +Compute the cyclic redundancy check (CRC) specified by POSIX +for the C command. + +=item C + +Compute the MD5 hash (using the C program). + +=item C + +Compute the SHA1 hash (using the C program). + +=item C + +Compute the SHA224 hash (using the C program). + +=item C + +Compute the SHA256 hash (using the C program). + +=item C + +Compute the SHA384 hash (using the C program). + +=item C + +Compute the SHA512 hash (using the C program). + +=back + +The checksum is returned as a printable string. + =item $h->chmod ($mode, $path); Change the mode (permissions) of C to C. Only @@ -426,6 +469,13 @@ Return the current search path. This is always non-NULL. If it wasn't set already, then this will return the default path. +=item $qemu = $h->get_qemu (); + +Return the current qemu binary. + +This is always non-NULL. If it wasn't set already, then this will +return the default qemu binary name. + =item $state = $h->get_state (); This returns the current state as an opaque integer. This is @@ -597,6 +647,23 @@ on the underlying device. The filesystem options C and C are set with this call, in order to improve reliability. +=item $h->mount_options ($options, $device, $mountpoint); + +This is the same as the C<$h-Emount> command, but it +allows you to set the mount options as for the +L I<-o> flag. + +=item $h->mount_ro ($device, $mountpoint); + +This is the same as the C<$h-Emount> command, but it +mounts the filesystem with the read-only (I<-o ro>) flag. + +=item $h->mount_vfs ($options, $vfstype, $device, $mountpoint); + +This is the same as the C<$h-Emount> command, but it +allows you to set both the mount options and the vfstype +as for the L I<-o> and I<-t> flags. + =item @devices = $h->mounts (); This returns the list of currently mounted filesystems. It returns @@ -676,6 +743,21 @@ must make sure it remains valid for the lifetime of the handle. Setting C to C restores the default path. +=item $h->set_qemu ($qemu); + +Set the qemu binary that we will use. + +The default is chosen when the library was compiled by the +configure script. + +You can also override this by setting the C +environment variable. + +The string C is stashed in the libguestfs handle, so the caller +must make sure it remains valid for the lifetime of the handle. + +Setting C to C restores the default qemu binary. + =item $h->set_ready (); This sets the state to C. This is only used when implementing @@ -737,6 +819,34 @@ underlying disk image. You should always call this if you have modified a disk image, before closing the handle. +=item $h->tar_in ($tarfile, $directory); + +This command uploads and unpacks local file C (an +I tar file) into C. + +To upload a compressed tarball, use C<$h-Etgz_in>. + +=item $h->tar_out ($directory, $tarfile); + +This command packs the contents of C and downloads +it to local file C. + +To download a compressed tarball, use C<$h-Etgz_out>. + +=item $h->tgz_in ($tarball, $directory); + +This command uploads and unpacks local file C (a +I tar file) into C. + +To upload an uncompressed tarball, use C<$h-Etar_in>. + +=item $h->tgz_out ($directory, $tarball); + +This command packs the contents of C and downloads +it to local file C. + +To download an uncompressed tarball, use C<$h-Etar_out>. + =item $h->touch ($path); Touch acts like the L command. It can be used to