From: Richard W.M. Jones <rjones@redhat.com>
Date: Fri, 13 Nov 2009 14:47:32 +0000 (+0000)
Subject: Docs: Add section on using multiple threads.
X-Git-Tag: 1.0.79~18
X-Git-Url: http://git.annexia.org/?a=commitdiff_plain;h=c2cbf9cd082e2cca69481e31ebd9bafda879fa22;p=libguestfs.git

Docs: Add section on using multiple threads.

This section was missing from the previous documentation.
---

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