def __del__ (self):
libguestfsmod.close (self._o)
+ def test0 (self, str, optstr, strlist, b, integer, filein, fileout):
+ return libguestfsmod.test0 (self._o, str, optstr, strlist, b, integer, filein, fileout)
+
+ def test0rint (self, val):
+ return libguestfsmod.test0rint (self._o, val)
+
+ def test0rinterr (self):
+ return libguestfsmod.test0rinterr (self._o)
+
+ def test0rint64 (self, val):
+ return libguestfsmod.test0rint64 (self._o, val)
+
+ def test0rint64err (self):
+ return libguestfsmod.test0rint64err (self._o)
+
+ def test0rbool (self, val):
+ return libguestfsmod.test0rbool (self._o, val)
+
+ def test0rboolerr (self):
+ return libguestfsmod.test0rboolerr (self._o)
+
+ def test0rconststring (self, val):
+ return libguestfsmod.test0rconststring (self._o, val)
+
+ def test0rconststringerr (self):
+ return libguestfsmod.test0rconststringerr (self._o)
+
+ def test0rstring (self, val):
+ return libguestfsmod.test0rstring (self._o, val)
+
+ def test0rstringerr (self):
+ return libguestfsmod.test0rstringerr (self._o)
+
+ def test0rstringlist (self, val):
+ return libguestfsmod.test0rstringlist (self._o, val)
+
+ def test0rstringlisterr (self):
+ return libguestfsmod.test0rstringlisterr (self._o)
+
+ def test0rintbool (self, val):
+ return libguestfsmod.test0rintbool (self._o, val)
+
+ def test0rintboolerr (self):
+ return libguestfsmod.test0rintboolerr (self._o)
+
+ def test0rpvlist (self, val):
+ return libguestfsmod.test0rpvlist (self._o, val)
+
+ def test0rpvlisterr (self):
+ return libguestfsmod.test0rpvlisterr (self._o)
+
+ def test0rvglist (self, val):
+ return libguestfsmod.test0rvglist (self._o, val)
+
+ def test0rvglisterr (self):
+ return libguestfsmod.test0rvglisterr (self._o)
+
+ def test0rlvlist (self, val):
+ return libguestfsmod.test0rlvlist (self._o, val)
+
+ def test0rlvlisterr (self):
+ return libguestfsmod.test0rlvlisterr (self._o)
+
+ def test0rstat (self, val):
+ return libguestfsmod.test0rstat (self._o, val)
+
+ def test0rstaterr (self):
+ return libguestfsmod.test0rstaterr (self._o)
+
+ def test0rstatvfs (self, val):
+ return libguestfsmod.test0rstatvfs (self._o, val)
+
+ def test0rstatvfserr (self):
+ return libguestfsmod.test0rstatvfserr (self._o)
+
+ def test0rhashtable (self, val):
+ return libguestfsmod.test0rhashtable (self._o, val)
+
+ def test0rhashtableerr (self):
+ return libguestfsmod.test0rhashtableerr (self._o)
+
def launch (self):
u"""Internally libguestfs is implemented by running a
virtual machine using qemu(1).
This is equivalent to the qemu parameter "-drive
file=filename".
+
+ Note that this call checks for the existence of
+ "filename". This stops you from specifying other types
+ of drive which are supported by qemu such as "nbd:" and
+ "http:" URLs. To specify those, use the general
+ "g.config" call instead.
"""
return libguestfsmod.add_drive (self._o, filename)
This is equivalent to the qemu parameter "-cdrom
filename".
+
+ Note that this call checks for the existence of
+ "filename". This stops you from specifying other types
+ of drive which are supported by qemu such as "nbd:" and
+ "http:" URLs. To specify those, use the general
+ "g.config" call instead.
"""
return libguestfsmod.add_cdrom (self._o, filename)
+ def add_drive_ro (self, filename):
+ u"""This adds a drive in snapshot mode, making it
+ effectively read-only.
+
+ Note that writes to the device are allowed, and will be
+ seen for the duration of the guestfs handle, but they
+ are written to a temporary file which is discarded as
+ soon as the guestfs handle is closed. We don't currently
+ have any method to enable changes to be committed,
+ although qemu can support this.
+
+ This is equivalent to the qemu parameter "-drive
+ file=filename,snapshot=on".
+
+ Note that this call checks for the existence of
+ "filename". This stops you from specifying other types
+ of drive which are supported by qemu such as "nbd:" and
+ "http:" URLs. To specify those, use the general
+ "g.config" call instead.
+ """
+ return libguestfsmod.add_drive_ro (self._o, filename)
+
def config (self, qemuparam, qemuvalue):
u"""This can be used to add arbitrary qemu command line
parameters of the form "-param value". Actually it's not
You can also override this by setting the
"LIBGUESTFS_QEMU" environment variable.
- The string "qemu" is stashed in the libguestfs handle,
- so the caller must make sure it remains valid for the
- lifetime of the handle.
-
Setting "qemu" to "NULL" restores the default qemu
binary.
"""
The default is "$libdir/guestfs" unless overridden by
setting "LIBGUESTFS_PATH" environment variable.
- The string "path" is stashed in the libguestfs handle,
- so the caller must make sure it remains valid for the
- lifetime of the handle.
-
Setting "path" to "NULL" restores the default path.
"""
return libguestfsmod.set_path (self._o, path)
"""
return libguestfsmod.get_path (self._o)
+ def set_append (self, append):
+ u"""This function is used to add additional options to the
+ guest kernel command line.
+
+ The default is "NULL" unless overridden by setting
+ "LIBGUESTFS_APPEND" environment variable.
+
+ Setting "append" to "NULL" means *no* additional options
+ are passed (libguestfs always adds a few of its own).
+ """
+ return libguestfsmod.set_append (self._o, append)
+
+ def get_append (self):
+ u"""Return the additional kernel options which are added to
+ the guest kernel command line.
+
+ If "NULL" then no options are added.
+ """
+ return libguestfsmod.get_append (self._o)
+
def set_autosync (self, autosync):
u"""If "autosync" is true, this enables autosync. Libguestfs
will make a best effort attempt to run "g.umount_all"
you would pass "lines" as a single element list, when
the single element being the string "," (comma).
+ See also: "g.sfdisk_l", "g.sfdisk_N"
+
This command is dangerous. Without careful use you can
easily destroy all your data.
"""
Subsequent elements are parameters. The list must be
non-empty (ie. must contain a program name).
+ The return value is anything printed to *stdout* by the
+ command.
+
+ If the command returns a non-zero exit status, then this
+ function returns an error message. The error message
+ string is the content of *stderr* from the command.
+
The $PATH environment variable will contain at least
"/usr/bin" and "/bin". If you require a program from
another location, you should provide the full path in
the correct places. It is the caller's responsibility to
ensure all filesystems that are needed are mounted at
the right locations.
+
+ Because of the message protocol, there is a transfer
+ limit of somewhere between 2MB and 4MB. To transfer
+ large files you should use FTP.
"""
return libguestfsmod.command (self._o, arguments)
into a list of lines.
This function returns a list of strings.
+
+ Because of the message protocol, there is a transfer
+ limit of somewhere between 2MB and 4MB. To transfer
+ large files you should use FTP.
"""
return libguestfsmod.command_lines (self._o, arguments)
"""
return libguestfsmod.hexdump (self._o, path)
+ def zerofree (self, device):
+ u"""This runs the *zerofree* program on "device". This
+ program claims to zero unused inodes and disk blocks on
+ an ext2/3 filesystem, thus making it possible to
+ compress the filesystem more effectively.
+
+ You should not run this program if the filesystem is
+ mounted.
+
+ It is possible that using this program can damage the
+ filesystem or data on the filesystem.
+ """
+ return libguestfsmod.zerofree (self._o, device)
+
+ def pvresize (self, device):
+ u"""This resizes (expands or shrinks) an existing LVM
+ physical volume to match the new size of the underlying
+ device.
+ """
+ return libguestfsmod.pvresize (self._o, device)
+
+ def sfdisk_N (self, device, n, cyls, heads, sectors, line):
+ u"""This runs sfdisk(8) option to modify just the single
+ partition "n" (note: "n" counts from 1).
+
+ For other parameters, see "g.sfdisk". You should usually
+ pass 0 for the cyls/heads/sectors parameters.
+
+ This command is dangerous. Without careful use you can
+ easily destroy all your data.
+ """
+ return libguestfsmod.sfdisk_N (self._o, device, n, cyls, heads, sectors, line)
+
+ def sfdisk_l (self, device):
+ u"""This displays the partition table on "device", in the
+ human-readable output of the sfdisk(8) command. It is
+ not intended to be parsed.
+ """
+ return libguestfsmod.sfdisk_l (self._o, device)
+
+ def sfdisk_kernel_geometry (self, device):
+ u"""This displays the kernel's idea of the geometry of
+ "device".
+
+ The result is in human-readable format, and not designed
+ to be parsed.
+ """
+ return libguestfsmod.sfdisk_kernel_geometry (self._o, device)
+
+ def sfdisk_disk_geometry (self, device):
+ u"""This displays the disk geometry of "device" read from
+ the partition table. Especially in the case where the
+ underlying block device has been resized, this can be
+ different from the kernel's idea of the geometry (see
+ "g.sfdisk_kernel_geometry").
+
+ The result is in human-readable format, and not designed
+ to be parsed.
+ """
+ return libguestfsmod.sfdisk_disk_geometry (self._o, device)
+
+ def vg_activate_all (self, activate):
+ u"""This command activates or (if "activate" is false)
+ deactivates all logical volumes in all volume groups. If
+ activated, then they are made known to the kernel, ie.
+ they appear as "/dev/mapper" devices. If deactivated,
+ then those devices disappear.
+
+ This command is the same as running "vgchange -a y|n"
+ """
+ return libguestfsmod.vg_activate_all (self._o, activate)
+
+ def vg_activate (self, activate, volgroups):
+ u"""This command activates or (if "activate" is false)
+ deactivates all logical volumes in the listed volume
+ groups "volgroups". If activated, then they are made
+ known to the kernel, ie. they appear as "/dev/mapper"
+ devices. If deactivated, then those devices disappear.
+
+ This command is the same as running "vgchange -a y|n
+ volgroups..."
+
+ Note that if "volgroups" is an empty list then all
+ volume groups are activated or deactivated.
+ """
+ return libguestfsmod.vg_activate (self._o, activate, volgroups)
+
+ def lvresize (self, device, mbytes):
+ u"""This resizes (expands or shrinks) an existing LVM
+ logical volume to "mbytes". When reducing, data in the
+ reduced part is lost.
+ """
+ return libguestfsmod.lvresize (self._o, device, mbytes)
+
+ def resize2fs (self, device):
+ u"""This resizes an ext2 or ext3 filesystem to match the
+ size of the underlying device.
+
+ *Note:* It is sometimes required that you run
+ "g.e2fsck_f" on the "device" before calling this
+ command. For unknown reasons "resize2fs" sometimes gives
+ an error about this and sometimes not. In any case, it
+ is always safe to call "g.e2fsck_f" before calling this
+ function.
+ """
+ return libguestfsmod.resize2fs (self._o, device)
+
+ def find (self, directory):
+ u"""This command lists out all files and directories,
+ recursively, starting at "directory". It is essentially
+ equivalent to running the shell command "find directory
+ -print" but some post-processing happens on the output,
+ described below.
+
+ This returns a list of strings *without any prefix*.
+ Thus if the directory structure was:
+
+ /tmp/a
+ /tmp/b
+ /tmp/c/d
+
+ then the returned list from "g.find" "/tmp" would be 4
+ elements:
+
+ a
+ b
+ c
+ c/d
+
+ If "directory" is not a directory, then this command
+ returns an error.
+
+ The returned list is sorted.
+
+ This function returns a list of strings.
+ """
+ return libguestfsmod.find (self._o, directory)
+
+ def e2fsck_f (self, device):
+ u"""This runs "e2fsck -p -f device", ie. runs the ext2/ext3
+ filesystem checker on "device", noninteractively ("-p"),
+ even if the filesystem appears to be clean ("-f").
+
+ This command is only needed because of "g.resize2fs"
+ (q.v.). Normally you should use "g.fsck".
+ """
+ return libguestfsmod.e2fsck_f (self._o, device)
+
git.annexia.org / libguestfs.git / blobdiff