From: Andrea Bolognani Date: Thu, 9 Dec 2021 14:27:35 +0000 (+0100) Subject: docs: Remove dependency on external resources X-Git-Tag: v8.0.0-rc1~110 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e1bfb2ad674803ff241d01fe805add9895fd924e;p=thirdparty%2Flibvirt.git docs: Remove dependency on external resources The internals/eventloop document uses two images for illustrative purposes, but unlike other graphics included in the documentation these are not part of libvirt.git but rather were added to libvirt-media.git with commit fae5622074cf5e18d190496f8a43260c614599b2 Author: Michal Privoznik Date: Mon Jun 6 17:27:50 2016 +0200 Add two event loop images These images are going to be used in our documentation of the event loop. Signed-off-by: Michal Privoznik https://gitlab.com/libvirt/libvirt-media/-/commit/fae5622074cf5e18d190496f8a43260c614599b2 and are requested directly from there. Specifically, the URLs point to the libvirt.org mirror of libvirt-media.git instead of the primary repository hosted on GitLab. Import the images into libvirt.git so that the website doesn't rely on external resources and can, if desired, be browsed entirely offline from installed packages. Signed-off-by: Andrea Bolognani Reviewed-by: Michal Privoznik --- diff --git a/docs/event_loop_simple.png b/docs/event_loop_simple.png new file mode 100644 index 0000000000..daf4338a16 Binary files /dev/null and b/docs/event_loop_simple.png differ diff --git a/docs/event_loop_simple.svg b/docs/event_loop_simple.svg new file mode 100644 index 0000000000..be25005002 --- /dev/null +++ b/docs/event_loop_simple.svg @@ -0,0 +1,398 @@ + + + + + + image/svg+xml + + + + + + + + + + + + + + + + quit? + + + quit? + + + + + + + + message := get_next_message() + + + + + message := get_next_message() + + + + + + + + + process_message(message) + + + process_message(message) + + + + + + + + + + + + quit := false + + + + + quit := false + + + + + + + + + + False + + + + + False + + + + + + + + + + + + True + + + + + True + + + + + + + + + exit() + + + exit() + + + + diff --git a/docs/event_loop_worker.png b/docs/event_loop_worker.png new file mode 100644 index 0000000000..1bec1ea598 Binary files /dev/null and b/docs/event_loop_worker.png differ diff --git a/docs/event_loop_worker.svg b/docs/event_loop_worker.svg new file mode 100644 index 0000000000..d824e2d585 --- /dev/null +++ b/docs/event_loop_worker.svg @@ -0,0 +1,708 @@ + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + quit? + + + quit? + + + + + + + + message := get_next_message() + + + + + message := get_next_message() + + + + + + + + + + + quit := false + + + + + quit := false + + + + + + + + + + False + + + + + False + + + + + + + + + + + + True + + + + + True + + + + + + + + + exit() + + + exit() + + + + + + + + quit? + + + quit? + + + + + + + + wait_for_message() + + + + + wait_for_message() + + + + + + + + + process_message() + + + process_message() + + + + + + + + + + + + + + + + exit() + + + exit() + + + + + + + + + + + True + + + + + True + + + + + + + + False + + + + + False + + + + + diff --git a/docs/internals/eventloop.html.in b/docs/internals/eventloop.html.in index 3e62d5ca53..aa22ba15cd 100644 --- a/docs/internals/eventloop.html.in +++ b/docs/internals/eventloop.html.in @@ -29,7 +29,7 @@ not waiting for direct user input and have no graphical interface. Such as Libvirt.

- event loop + event loop

In Libvirt this approach is used in combination with poll(2) as all the communication with its @@ -70,7 +70,7 @@ acceptable for Libvirt. Therefore we have came up with the following solution.

- event loop + event loop

The event loop does only necessary minimum and hand over message processing to another thread. In fact, there can be diff --git a/docs/meson.build b/docs/meson.build index 3aabb52950..3e708acf0e 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -10,6 +10,8 @@ docs_assets = [ 'android-chrome-256x256.png', 'apple-touch-icon.png', 'browserconfig.xml', + 'event_loop_simple.png', + 'event_loop_worker.png', 'favicon.ico', 'favicon-16x16.png', 'favicon-32x32.png',