From c2cbf9cd082e2cca69481e31ebd9bafda879fa22 Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Fri, 13 Nov 2009 14:47:32 +0000 Subject: [PATCH] Docs: Add section on using multiple threads. This section was missing from the previous documentation. --- guestfs.pod | 9 +++++++++ 1 file changed, 9 insertions(+) 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) which indicates that the guest and daemon is alive. This is what C 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 -- 1.8.3.1