X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=guestfs.pod;fp=guestfs.pod;h=bfd472e4959cc1eb175e4848296e118768926205;hp=2ebcc090113a365e4be5f8eae6f90a5103117792;hb=c2cbf9cd082e2cca69481e31ebd9bafda879fa22;hpb=38d8943009e3a637e56af6adb43f6c12a7a357c7;ds=sidebyside

diff --git a/guestfs.pod b/guestfs.pod
index 2ebcc09..bfd472e 100644
--- a/guestfs.pod
+++ b/guestfs.pod
@@ -935,6 +935,15 @@ sort of connection control, when the daemon launches it sends an
 initial word (C<GUESTFS_LAUNCH_FLAG>) which indicates that the guest
 and daemon is alive.  This is what C<guestfs_launch> waits for.
 
+=head1 MULTIPLE HANDLES AND MULTIPLE THREADS
+
+All high-level libguestfs actions are synchronous.  If you want
+to use libguestfs asynchronously then you must create a thread.
+
+Only use the handle from a single thread.  Either use the handle
+exclusively from one thread, or provide your own mutex so that two
+threads cannot issue calls on the same handle at the same time.
+
 =head1 QEMU WRAPPERS
 
 If you want to compile your own qemu, run qemu from a non-standard