mirror of
https://github.com/libguestfs/libguestfs.git
synced 2026-03-21 22:53:37 +00:00
62e775c350
Rename guestfs_safe_malloc et al to guestfs___safe_malloc etc. To use the private functions, code now has to define -DGUESTFS_PRIVATE_FUNCTIONS=1. This will make it easier for us in future to work out which programs are using these functions and to minimize both the number of programs and the functions they are calling. Note that the Perl, Python, OCaml, Ruby and Java bindings use guestfs_safe_* calls. None of the other bindings do. This is a bug (in the bindings using those functions): these functions will call the out of memory callback on failure. This function defaults to abort(), and since this happens from a language binding, there is no way to change this default.
Sys::Guestfs ------------ This directory contains the Perl bindings for the libguestfs API. The basic libguestfs bindings have the name 'Sys::Guestfs'. As with all other language bindings, these bindings are generated automatically. See generator/ directory. Sys::Guestfs::Lib ----------------- Because we use Perl for writing lots of additional tools around libguestfs, the Perl bindings also contain an extra library of useful functions, called 'Sys::Guestfs::Lib'. This extra library is entirely optional, and only enhances the usefulness of the ordinary libguestfs API. One of the features of this library is tighter libvirt integration.