From b02db2d9203ccfd1c26e55f7d975f0c05caee0ce Mon Sep 17 00:00:00 2001 From: "Daniel P. Berrange" Date: Wed, 18 Mar 2015 17:25:45 +0000 Subject: io: add QIOTask class for async operations A number of I/O operations need to be performed asynchronously to avoid blocking the main loop. The caller of such APIs need to provide a callback to be invoked on completion/error and need access to the error, if any. The small QIOTask provides a simple framework for dealing with such probes. The API docs inline provide an outline of how this is to be used. Some functions don't have the ability to run asynchronously (eg getaddrinfo always blocks), so to facilitate their use, the task class provides a mechanism to run a blocking function in a thread, while triggering the completion callback in the main event loop thread. This easily allows any synchronous function to be made asynchronous, albeit at the cost of spawning a thread. In this series, the QIOTask class will be used for things like the TLS handshake, the websockets handshake and TCP connect() progress. The concept of QIOTask is inspired by the GAsyncResult interface / GTask class in the GIO libraries. The min version requirements on glib don't allow those to be used from QEMU, so QIOTask provides a facsimilie which can be easily switched to GTask in the future if the min version is increased. Signed-off-by: Daniel P. Berrange --- tests/.gitignore | 1 + 1 file changed, 1 insertion(+) (limited to 'tests/.gitignore') diff --git a/tests/.gitignore b/tests/.gitignore index 1e55722b6a..eec12cc2db 100644 --- a/tests/.gitignore +++ b/tests/.gitignore @@ -24,6 +24,7 @@ test-cutils test-hbitmap test-int128 test-iov +test-io-task test-mul64 test-opts-visitor test-qapi-event.[ch] -- cgit v1.2.3