X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=guestfs.pod;h=a41fd27c6e726e44e7c5532e91adebc9cdbb9004;hp=f26880cfd178a21eb83d00152681ec2e59de7e5d;hb=7e34d2cf59c2c8098683967c32782ffd8ca66aa7;hpb=4aea83962337ac5e5847398e2128a9dbb8779247;ds=sidebyside diff --git a/guestfs.pod b/guestfs.pod index f26880c..a41fd27 100644 --- a/guestfs.pod +++ b/guestfs.pod @@ -205,6 +205,14 @@ search the current directory and then C. =head1 HIGH-LEVEL API ACTIONS +=head2 ABI GUARANTEE + +We guarantee the libguestfs ABI (binary interface), for public, +high-level actions as outlined in this section. Although we will +deprecate some actions, for example if they get replaced by newer +calls, we will keep the old actions forever. This allows you the +developer to program in confidence against libguestfs. + @ACTIONS@ =head1 STRUCTURES @@ -759,15 +767,29 @@ For example: LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish +Note that libguestfs also calls qemu with the -help and -version +options in order to determine features. + =head1 ENVIRONMENT VARIABLES =over 4 +=item LIBGUESTFS_APPEND + +Pass additional options to the guest kernel. + =item LIBGUESTFS_DEBUG Set C to enable verbose messages. This has the same effect as calling C. +=item LIBGUESTFS_MEMSIZE + +Set the memory allocated to the qemu process, in megabytes. For +example: + + LIBGUESTFS_MEMSIZE=700 + =item LIBGUESTFS_PATH Set the path that libguestfs uses to search for kernel and initrd.img. @@ -781,10 +803,6 @@ used. See also L above. -=item LIBGUESTFS_APPEND - -Pass additional options to the guest kernel. - =back =head1 SEE ALSO