Mention OCaml & Perl bindings in introduction. Error handlers must copy 'msg' if...
authorRichard Jones <rjones@redhat.com>
Wed, 8 Apr 2009 12:46:05 +0000 (13:46 +0100)
committerRichard Jones <rjones@redhat.com>
Wed, 8 Apr 2009 12:46:05 +0000 (13:46 +0100)
guestfs.pod

index 7396644..07dfde5 100644 (file)
@@ -37,9 +37,8 @@ LVs, what filesystem is in each LV, etc.).  It can also run commands
 in the context of the guest.  Also you can access filesystems over FTP.
 
 Libguestfs is a library that can be linked with C and C++ management
 in the context of the guest.  Also you can access filesystems over FTP.
 
 Libguestfs is a library that can be linked with C and C++ management
-programs (or management programs written in other languages, if people
-contribute the language bindings).  You can also use it from shell
-scripts or the command line.
+programs (or management programs written in OCaml or Perl).
+You can also use it from shell scripts or the command line.
 
 You don't need to be root to use libguestfs, although obviously you do
 need enough permissions to access the disk images.
 
 You don't need to be root to use libguestfs, although obviously you do
 need enough permissions to access the disk images.
@@ -205,6 +204,10 @@ The callback C<cb> will be called if there is an error.  The
 parameters passed to the callback are an opaque data pointer and the
 error message string.
 
 parameters passed to the callback are an opaque data pointer and the
 error message string.
 
+Note that the message string C<msg> is freed as soon as the callback
+function returns, so if you want to stash it somewhere you must make
+your own copy.
+
 The default handler prints messages on C<stderr>.
 
 If you set C<cb> to C<NULL> then I<no> handler is called and the error
 The default handler prints messages on C<stderr>.
 
 If you set C<cb> to C<NULL> then I<no> handler is called and the error