From nobody Mon Apr 29 18:18:44 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1639064576; cv=none; d=zohomail.com; s=zohoarc; b=H+sq/zKdEXRdWq6dq5YhcBtbZCxYRexdfZnCGKt0fbpoaE4gzwFFo+g9E3iDaFvQZP7eeH8i7hheyC1vFRsbDN/qitZ0Dbh15gvCEtmiMvuLtCJCVJfA8WTLd9CMQnt+GX787827iAnvn0I3WjWMKt/XAue27hoclf8zj76a5sk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1639064576; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=n21qhb+OpniCy7uyvr1wftkmJdOtAhfnDo/vmSYQvs8=; b=gCP3J8hFXUgCuZ0loTdOCmuhjTrgd7YKjK6DHixQzE4XRHmFx6nhqDTGiaKtpso0OmdRg5jymIxjJVEMR/6f6hA1fJY0+1sbtz4j/bH+CKlNQ4R9+C2/vs+2HpkUnpG4VJRni8E80TVOVTDmv+g7kEUSHXT4b0io2pBeTMEusGc= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1639064576424708.67475667056; Thu, 9 Dec 2021 07:42:56 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-479-dEXfMG5COOeyf_3gW6mXdA-1; Thu, 09 Dec 2021 10:42:51 -0500 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 61022101F005; Thu, 9 Dec 2021 15:42:45 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 8BEA519C59; Thu, 9 Dec 2021 15:42:43 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id B4DEF4BB7C; Thu, 9 Dec 2021 15:42:39 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 1B9Fgchl012287 for ; Thu, 9 Dec 2021 10:42:38 -0500 Received: by smtp.corp.redhat.com (Postfix) id 4392760C04; Thu, 9 Dec 2021 15:42:38 +0000 (UTC) Received: from kinshicho.usersys.redhat.com.homenet.telecomitalia.it (unknown [10.40.192.168]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 97EDB60C7F for ; Thu, 9 Dec 2021 15:42:31 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1639064575; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=n21qhb+OpniCy7uyvr1wftkmJdOtAhfnDo/vmSYQvs8=; b=fWHqBQz5JSLhTlOMpynFC/N5jUldcifjxsSPkjo9z9FMRXasgxHWEvQE03Hyrs/bh1tkRI +us0d8umAAIfINXWif4kSgFBiNW5CaNm5qdcyLF7NVDtVEa5foOaWqZvX7ici0Ybbb5r+9 spQQ8J68sDnQnaGlxoV1Zy+dUinat7E= X-MC-Unique: dEXfMG5COOeyf_3gW6mXdA-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [PATCH] docs: Remove dependency on external resources Date: Thu, 9 Dec 2021 16:42:29 +0100 Message-Id: <20211209154229.272599-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.84 on 10.5.11.23 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1639064578752100001 Content-Type: text/plain; charset="utf-8" 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/fae5622074cf5e18d190496= f8a43260c614599b2 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 --- Redacted to strip binary and binary-adjacent blobs. Full patch: https://gitlab.com/abologna/libvirt/-/commit/684805e3cf65ab3bb9= 3a92ada3b720331fae72ce docs/event_loop_simple.png | Bin 0 -> 16043 bytes docs/event_loop_simple.svg | 398 +++++++++++++++++ docs/event_loop_worker.png | Bin 0 -> 29696 bytes docs/event_loop_worker.svg | 708 +++++++++++++++++++++++++++++++ docs/internals/eventloop.html.in | 4 +- docs/meson.build | 2 + 6 files changed, 1110 insertions(+), 2 deletions(-) create mode 100644 docs/event_loop_simple.png create mode 100644 docs/event_loop_simple.svg create mode 100644 docs/event_loop_worker.png create mode 100644 docs/event_loop_worker.svg diff --git a/docs/event_loop_simple.png b/docs/event_loop_simple.png new file mode 100644 index 0000000000000000000000000000000000000000..daf4338a16bc1051aca0ca1c7ea= 13baa4e7179f1 [... PNG stuff here ...] diff --git a/docs/event_loop_simple.svg b/docs/event_loop_simple.svg new file mode 100644 index 0000000000..be25005002 [... SVG stuff here ...] diff --git a/docs/event_loop_worker.png b/docs/event_loop_worker.png new file mode 100644 index 0000000000000000000000000000000000000000..1bec1ea598b2806fea24ab25dc8= 25c9055c76ee6 [... PNG stuff here ...] diff --git a/docs/event_loop_worker.svg b/docs/event_loop_worker.svg new file mode 100644 index 0000000000..d824e2d585 [... SVG stuff here ...] diff --git a/docs/internals/eventloop.html.in b/docs/internals/eventloop.ht= ml.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.

=20 - 3D"event + 3D"event =20

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.

=20 - 3D"event + 3D"event =20

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 =3D [ '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', --=20 2.31.1