From nobody Fri May 3 09:47:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.81 as permitted sender) client-ip=207.211.31.81; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.81 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=1594732093; cv=none; d=zohomail.com; s=zohoarc; b=Jh9/mLfwKXmWXl3jH+Ip1pUV93WrpgveHj9eU4Y7M6tivByGQDq8j4UNCNKYZRFKe85fVqfoK44vOcrXgABRLCaDTK1S3McvBH967ykDRvd6mV9MykklgtuShmLc+o7GyKXPLHUDiEIhP63hTJVfqV4rbH/l/Q6TRtr0XXnjVkQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1594732093; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=c/nCHxlf9mYqH6MkOGP8DlELNKAYcuXQ5PBeX2VCHZ4=; b=fSA6j6fCJR5PrdPSLAjVkYDMlDdYcBzIgavgnrmMyZTaXxwBPbyUzcq8yxZJS+6rWhqAsArA5stYKYD0rF5WKGX4YvVIWzZR5QPa6ov/ga0zLAO2qmbaV6PjEzQ3MZMkHHJs+SOXKoX2YVL7DWiq8aB8PkoXf/RfsG4gwi08RxE= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.81 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-1.mimecast.com (us-smtp-2.mimecast.com [207.211.31.81]) by mx.zohomail.com with SMTPS id 1594732093058988.9411593942838; Tue, 14 Jul 2020 06:08:13 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-317-cAdrLKowNeuUXsIaNK4O3Q-1; Tue, 14 Jul 2020 09:08:02 -0400 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id AD3AE1083E8B; Tue, 14 Jul 2020 13:07:56 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id E5528710CB; Tue, 14 Jul 2020 13:07:55 +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 4D2EE180954D; Tue, 14 Jul 2020 13:07:54 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 06ED7ptp022637 for ; Tue, 14 Jul 2020 09:07:51 -0400 Received: by smtp.corp.redhat.com (Postfix) id 8D5E96FEDF; Tue, 14 Jul 2020 13:07:51 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.194.169]) by smtp.corp.redhat.com (Postfix) with ESMTPS id D0A5272E4F for ; Tue, 14 Jul 2020 13:07:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1594732091; 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: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=c/nCHxlf9mYqH6MkOGP8DlELNKAYcuXQ5PBeX2VCHZ4=; b=ZbK2YrsYrODof++QuRA62CNRZ1LO19bLR6BPqGamJldsViYLTTFwa6DX1pHtETlpunjfrc k/gLjfcEW7VgkSzNiyue5UX75cGIZpVIyrOLTA7ZsmFO1h6VievmsZBhs+2bZPRWT7mM81 UTRHI9hOhwbLrhHP47F9wiaD1XFQQks= X-MC-Unique: cAdrLKowNeuUXsIaNK4O3Q-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 1/5] docs: platforms: Add brief outline Date: Tue, 14 Jul 2020 15:07:39 +0200 Message-Id: <20200714130743.515094-2-abologna@redhat.com> In-Reply-To: <20200714130743.515094-1-abologna@redhat.com> References: <20200714130743.515094-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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.79 on 10.5.11.15 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" This will make the document look nicer, especially after we have converted it to reStructuredText. Signed-off-by: Andrea Bolognani Reviewed-by: Pavel Hrdina --- docs/platforms.html.in | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/platforms.html.in b/docs/platforms.html.in index 5c90f1dd7a..c50279bffd 100644 --- a/docs/platforms.html.in +++ b/docs/platforms.html.in @@ -6,12 +6,16 @@ =20
    =20 +

    + Libvirt aims to support building and executing on multiple host OS + platforms, as well as working with multiple hypervisors. This docume= nt + outlines which platforms are targeted for each of these areas. +

    +

    Build targets

    =20

    - Libvirt drivers aim to support building and executing on multiple - host OS platforms. This document outlines which platforms are the - major build targets. These platforms are used as the basis for decid= ing + These platforms are used as the basis for deciding upon the minimum required versions of 3rd party software libvirt dep= ends on. If a platform is not listed here, it does not imply that libvirt won't work. If an unlisted platform has comparable software versions --=20 2.25.4 From nobody Fri May 3 09:47:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.120 as permitted sender) client-ip=205.139.110.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.120 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=1594732106; cv=none; d=zohomail.com; s=zohoarc; b=BbmOrZv9b5oZhyrszZle4441KSL5kUewOW+T21+4yJclaHu0gl7dUmXje++lKxNHCZudYPlfzw8XYxjJQ5YO0PmGJLC09ZyO7TsCCwSPhXkaOvZhpXI/fDiQudllBXv2xZ+A6ADAtefDgCYYDrRa+RhVIyYC/mZ3iN58KfXlUA4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1594732106; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=ia0y1dqQBRBRnlQpC4nFVeRWDCMn7tpZ7DfuN/46sQs=; b=QxtIQk7oWdAWvChG5KR4nd8SeDrHPjTeHxTVqdTkkW5RWup1d3AScB2NMz9X6QZgNBOn+hOdymRXjBGxptoQWRuScO9dfgDvaSP5ioIWEgt57JnMJ3TMST1gqi1G/KG2DWlTCTpBlBgbLfu4kxvUH6X4UXv3uGPiFeMcswq3LMc= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.120]) by mx.zohomail.com with SMTPS id 1594732106027562.9841493952472; Tue, 14 Jul 2020 06:08:26 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-218-KHwGCde0P8aG1WZogPFSRw-1; Tue, 14 Jul 2020 09:08:08 -0400 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 C1CBB1005268; Tue, 14 Jul 2020 13:07:56 +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 9FBD91A837; Tue, 14 Jul 2020 13:07:56 +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 8923F94F09; Tue, 14 Jul 2020 13:07:54 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 06ED7qAg022653 for ; Tue, 14 Jul 2020 09:07:52 -0400 Received: by smtp.corp.redhat.com (Postfix) id DFA05724D4; Tue, 14 Jul 2020 13:07:52 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.194.169]) by smtp.corp.redhat.com (Postfix) with ESMTPS id EEDDB6FEDF for ; Tue, 14 Jul 2020 13:07:51 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1594732104; 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: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=ia0y1dqQBRBRnlQpC4nFVeRWDCMn7tpZ7DfuN/46sQs=; b=YWOr8XctdkjKhCFk0DjFhdD7pMr6Fj4DwfTZUxDjjsyGtNrJbYWBo9aYTSOo8vCZ8uUumJ aJUbo5b8wKtgS02PsGiGx8jyfP4APisXv28a55c4HNYsFSmm7UuYqGW1qAOSLNu++weUu/ XolKelPSIxbuR9ZSxmvcthRBGmgoBsU= X-MC-Unique: KHwGCde0P8aG1WZogPFSRw-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 2/5] docs: platforms: Convert to reStructuredText Date: Tue, 14 Jul 2020 15:07:40 +0200 Message-Id: <20200714130743.515094-3-abologna@redhat.com> In-Reply-To: <20200714130743.515094-1-abologna@redhat.com> References: <20200714130743.515094-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" Signed-off-by: Andrea Bolognani Reviewed-by: Pavel Hrdina --- docs/platforms.html.in | 119 ----------------------------------------- docs/platforms.rst | 100 ++++++++++++++++++++++++++++++++++ 2 files changed, 100 insertions(+), 119 deletions(-) delete mode 100644 docs/platforms.html.in create mode 100644 docs/platforms.rst diff --git a/docs/platforms.html.in b/docs/platforms.html.in deleted file mode 100644 index c50279bffd..0000000000 --- a/docs/platforms.html.in +++ /dev/null @@ -1,119 +0,0 @@ - - - - -

    Supported host platforms

    - -
      - -

      - Libvirt aims to support building and executing on multiple host OS - platforms, as well as working with multiple hypervisors. This docume= nt - outlines which platforms are targeted for each of these areas. -

      - -

      Build targets

      - -

      - These platforms are used as the basis for deciding - upon the minimum required versions of 3rd party software libvirt dep= ends - on. If a platform is not listed here, it does not imply that libvirt - won't work. If an unlisted platform has comparable software versions - to a listed platform, there is every expectation that it will work. - Bug reports are welcome for problems encountered on unlisted platfor= ms - unless they are clearly older vintage than what is described here. -

      - -

      - Note that when considering software versions shipped in distros as - support targets, libvirt considers only the version number, and assu= mes - the features in that distro match the upstream release with the same - version. In other words, if a distro backports extra features to the - software in their distro, libvirt upstream code will not add explicit - support for those backports, unless the feature is auto-detectable in - a manner that works for the upstream releases too. -

      - -

      - The Repology site is a useful resource to identify currently shipped - versions of software in various operating systems, though it does not - cover all distros listed below. -

      - - - - -

      Linux OS

      - -

      - For distributions with frequent, short-lifetime releases, the project - will aim to support all versions that are not end of life by their - respective vendors. For the purposes of identifying supported softwa= re - versions, the project will look at Fedora, Ubuntu, and openSUSE dist= ros. - Other short-lifetime distros will be assumed to ship similar software - versions. -

      - -

      - For distributions with long-lifetime releases, the project will aim = to - support the most recent major version at all times. Support for the - previous major version will be dropped 2 years after the new major - version is released. For the purposes of identifying supported softw= are - versions, the project will look at RHEL, Debian, Ubuntu LTS, and SLES - distros. Other long-lifetime distros will be assumed to ship similar - software versions. -

      - -

      Windows

      - -

      - The project supports building with current versions of the MinGW - toolchain, hosted on Linux. -

      - -

      macOS

      - -

      - The project aims to support the most recent major version - at all times. Support for the previous major version will - be dropped 2 years after the new major version is released. -

      - -

      - Note that to compile libvirt will require extra packages - to be made available on the macOS host. It is recommended - to use HomeBrew since this - is what libvirt CI tests with, however, MacPorts - is an alternative option that is likely to work. -

      - -

      FreeBSD

      - -

      - The project aims to support the most recent major version - at all times. Support for the previous major version will - be dropped 2 years after the new major version is released. -

      - -

      Virtualization platforms

      - -

      - For hypervisor drivers which execute - locally (QEMU, LXC, VZ, libxl, etc), the set of supported operating - system platforms listed above will inform choices as to the minimum - required versions of 3rd party libraries and hypervisor management - APIs. -

      -

      - If a hypervisor is not commonly shipped directly by any distro - listed above, (VMware ESX, HyperV, VZ), the project aims to - support versions up to 5 years, or until the vendor discontinues - support, whichever comes first. -

      - - - diff --git a/docs/platforms.rst b/docs/platforms.rst new file mode 100644 index 0000000000..2845ac40ea --- /dev/null +++ b/docs/platforms.rst @@ -0,0 +1,100 @@ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +Supported host platforms +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +.. contents:: + +Libvirt aims to support building and executing on multiple host OS platfor= ms, +as well as working with multiple hypervisors. This document outlines which +platforms are targeted for each of these areas. + + +Build targets +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +These platforms are used as the basis for deciding upon the minimum requir= ed +versions of 3rd party software libvirt depends on. If a platform is not li= sted +here, it does not imply that libvirt won't work. If an unlisted platform h= as +comparable software versions to a listed platform, there is every expectat= ion +that it will work. Bug reports are welcome for problems encountered on +unlisted platforms unless they are clearly older vintage than what is desc= ribed +here. + +Note that when considering software versions shipped in distros as support +targets, libvirt considers only the version number, and assumes the featur= es in +that distro match the upstream release with the same version. In other wor= ds, +if a distro backports extra features to the software in their distro, libv= irt +upstream code will not add explicit support for those backports, unless the +feature is auto-detectable in a manner that works for the upstream releases +too. + +The `Repology`_ site is a useful resource to identify currently shipped +versions of software in various operating systems, though it does not cove= r all +distros listed below. + +* `libvirt on Repology`_ +* `qemu on Repology`_ +* `qemu-kvm on Repology`_ + +Linux OS +-------- + +For distributions with frequent, short-lifetime releases, the project will= aim +to support all versions that are not end of life by their respective vendo= rs. +For the purposes of identifying supported software versions, the project w= ill +look at Fedora, Ubuntu, and openSUSE distros. Other short-lifetime distros +will be assumed to ship similar software versions. + +For distributions with long-lifetime releases, the project will aim to sup= port +the most recent major version at all times. Support for the previous major +version will be dropped 2 years after the new major version is released. F= or +the purposes of identifying supported software versions, the project will = look +at RHEL, Debian, Ubuntu LTS, and SLES distros. Other long-lifetime distros= will +be assumed to ship similar software versions. + +Windows +------- + +The project supports building with current versions of the MinGW toolchain, +hosted on Linux. + +macOS +----- + +The project aims to support the most recent major version at all times. Su= pport +for the previous major version will be dropped 2 years after the new major +version is released. + +Note that to compile libvirt will require extra packages to be made availa= ble +on the macOS host. It is recommended to use `HomeBrew`_ since this is what +libvirt CI tests with, however, `MacPorts`_ is an alternative option that = is +likely to work. + +FreeBSD +------- + +The project aims to support the most recent major version at all times. Su= pport +for the previous major version will be dropped 2 years after the new major +version is released. + + +Virtualization platforms +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +For `hypervisor drivers`_ which execute locally (QEMU, LXC, VZ, libxl, etc= ), +the set of supported operating system platforms listed above will inform +choices as to the minimum required versions of 3rd party libraries and +hypervisor management APIs. + +If a hypervisor is not commonly shipped directly by any distro listed abov= e, +(VMware ESX, HyperV, VZ), the project aims to support versions up to 5 yea= rs, +or until the vendor discontinues support, whichever comes first. + + +.. _HomeBrew: https://brew.sh/ +.. _MacPorts: https://www.macports.org/ +.. _Repology: https://repology.org/ +.. _hypervisor drivers: drivers.html +.. _libvirt on Repology: https://repology.org/metapackage/libvirt/versions +.. _qemu on Repology: https://repology.org/metapackage/qemu/versions +.. _qemu-kvm on Repology: https://repology.org/metapackage/qemu-kvm/versio= ns --=20 2.25.4 From nobody Fri May 3 09:47:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) client-ip=207.211.31.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 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=1594732153; cv=none; d=zohomail.com; s=zohoarc; b=RhkFqpIYlzjWwd8cRNGuVD8Fz54/hjIkbIh7vfqGCMe6Kx6MfIs5SnnDcCOvhHBTlkiy+wpiglmtcwXdkBT9v/Ti+JyQ2+GPdXOhc0D/azElgmb79j/J8rNGUx6ITUNzeM6ec0sW7nG03baadQUMSIBDqDjzjfBA8RXVdMWE46w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1594732153; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=l4o/qoFniCVX/QvEUgwDxXkE4T/9HroLfjKPYw9lCAA=; b=Ax/Ne4qivbELJiBI0EsecRA5KamDWstDdrJPimVtBEKcoe+5VNHtEP4cZiWKLGfDJGUXRlrszv0ugY8FSXOZnY/KN0+h6mRoMX7DjgITHoiueM2YRz0zCJsjfMLhG0+UlmQQDgjnvNJjxYz7a9eulkI2gsqS3g4auL6qsdNuu1c= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by mx.zohomail.com with SMTPS id 1594732153484765.4741335304722; Tue, 14 Jul 2020 06:09:13 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-267-t1SRztH7O0qhngm4xsh3xQ-1; Tue, 14 Jul 2020 09:08:16 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 173BC1090; Tue, 14 Jul 2020 13:08:03 +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 E92306FDD1; Tue, 14 Jul 2020 13:08:02 +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 B7E1A94F0C; Tue, 14 Jul 2020 13:08:02 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 06ED7sr7022662 for ; Tue, 14 Jul 2020 09:07:54 -0400 Received: by smtp.corp.redhat.com (Postfix) id 13C096FEDF; Tue, 14 Jul 2020 13:07:54 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.194.169]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 642F372E4F for ; Tue, 14 Jul 2020 13:07:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1594732152; 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: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=l4o/qoFniCVX/QvEUgwDxXkE4T/9HroLfjKPYw9lCAA=; b=aHgjFLik1Uid3FTRyGBEsXiO1/g0QR3IXcd5Kj10WrbdP/ASYSoo+OVGcyWckxmnQnObqx zbAVPFKQuM8rRZhXV6ovIjxi/ef7LGVNwWIKCYuS/+zod5UbNrqtpfBAHz1nEwGzkgebKP CU5cVYfBincCHz5sl6Bgqjl63xbJnLs= X-MC-Unique: t1SRztH7O0qhngm4xsh3xQ-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 3/5] docs: platforms: Simplify support policy Date: Tue, 14 Jul 2020 15:07:41 +0200 Message-Id: <20200714130743.515094-4-abologna@redhat.com> In-Reply-To: <20200714130743.515094-1-abologna@redhat.com> References: <20200714130743.515094-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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.79 on 10.5.11.13 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" We discuss Linux, FreeBSD and macOS separately, and we even go as far as splitting Linux distros into short-lifetime and long-lifetime, when ultimately the same two priciples apply everywhere: we don't want to support a platform longer than its vendor does, and in cases where the vendor support is extremely long we need to have a time-based escape hatch. Signed-off-by: Andrea Bolognani Reviewed-by: Pavel Hrdina --- docs/platforms.rst | 47 ++++++++++++++-------------------------------- 1 file changed, 14 insertions(+), 33 deletions(-) diff --git a/docs/platforms.rst b/docs/platforms.rst index 2845ac40ea..702d8d56d3 100644 --- a/docs/platforms.rst +++ b/docs/platforms.rst @@ -36,46 +36,27 @@ distros listed below. * `qemu on Repology`_ * `qemu-kvm on Repology`_ =20 -Linux OS --------- - -For distributions with frequent, short-lifetime releases, the project will= aim -to support all versions that are not end of life by their respective vendo= rs. -For the purposes of identifying supported software versions, the project w= ill -look at Fedora, Ubuntu, and openSUSE distros. Other short-lifetime distros -will be assumed to ship similar software versions. - -For distributions with long-lifetime releases, the project will aim to sup= port -the most recent major version at all times. Support for the previous major -version will be dropped 2 years after the new major version is released. F= or -the purposes of identifying supported software versions, the project will = look -at RHEL, Debian, Ubuntu LTS, and SLES distros. Other long-lifetime distros= will -be assumed to ship similar software versions. - -Windows -------- - -The project supports building with current versions of the MinGW toolchain, -hosted on Linux. - -macOS ------ +Linux, FreeBSD and macOS +------------------------ =20 The project aims to support the most recent major version at all times. Su= pport for the previous major version will be dropped 2 years after the new major -version is released. +version is released or when the vendor itself drops support, whichever com= es +first. =20 -Note that to compile libvirt will require extra packages to be made availa= ble -on the macOS host. It is recommended to use `HomeBrew`_ since this is what -libvirt CI tests with, however, `MacPorts`_ is an alternative option that = is -likely to work. +For the purposes of identifying supported software versions available on L= inux, +the project will look at CentOS, Debian, Fedora, openSUSE, RHEL, SLES and +Ubuntu LTS. Other distros will be assumed to ship similar software version= s. =20 -FreeBSD +For FreeBSD, decisions will be made based on the contents of the ports tre= e; +for macOS, `HomeBrew`_ will be used, although `MacPorts`_ is expected to c= arry +similar versions. + +Windows ------- =20 -The project aims to support the most recent major version at all times. Su= pport -for the previous major version will be dropped 2 years after the new major -version is released. +The project supports building with current versions of the MinGW toolchain, +hosted on Linux. =20 =20 Virtualization platforms --=20 2.25.4 From nobody Fri May 3 09:47:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) client-ip=207.211.31.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 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=1594732100; cv=none; d=zohomail.com; s=zohoarc; b=D4GnrNYK5yS6kWUq7ocfOvFwoLwfEwrgYk8htVUs2stKNfrA4ucFUg9UXmWNOi8b9YjUVJjsLljmXkwlINrd9hCJ8lA5L7u37RnbrJEKwfxsE0tf6f0X3mOZ+0DdszekUzkA3B0njRQvEoh5BUH5uJlCCdISSVvpOymESJn5Ywk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1594732100; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=YBLiaBr7U2xZXUvmUWMwLNi3KATdnjfjZk3kPW1yRNE=; b=R22rCHaXFi4OXDQTush1XwlZaL+aYqR78lq+PViFWpVRXRYTWxdd2Ds4HW38e7WPY0MeRqDaykAOwhtN9YJIEjiyM54OrU8I7ZQwKJjOxtuqUsEXi/ndQeCQKHCMmi4uOCBENorbD9dmdhkLuNNfwKZ9nMsEap5W4R57U+ay344= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by mx.zohomail.com with SMTPS id 1594732100461236.5819283012836; Tue, 14 Jul 2020 06:08:20 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-157-D6rqJnLpP5qSqeRofydX5w-1; Tue, 14 Jul 2020 09:08:17 -0400 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 10540108F; Tue, 14 Jul 2020 13:08:03 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id E0B2B60C84; Tue, 14 Jul 2020 13:08:02 +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 AE34A1809563; Tue, 14 Jul 2020 13:08:02 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 06ED7teZ022673 for ; Tue, 14 Jul 2020 09:07:55 -0400 Received: by smtp.corp.redhat.com (Postfix) id 406D26FEDF; Tue, 14 Jul 2020 13:07:55 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.194.169]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 9C2D5724D4 for ; Tue, 14 Jul 2020 13:07:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1594732099; 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: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=YBLiaBr7U2xZXUvmUWMwLNi3KATdnjfjZk3kPW1yRNE=; b=NJxdoUx9tdf2s/TkoGjDLQuWfy+oKCnWJqHDNDr2yiXhDyFGJnY77+gbpt+y+4RY3lCbk4 7kvY8MtXRVKsVUm3WwcaWI9KBGcwDqb1AUVCNJ4wP12oy0yQhn2QUd73LQJfcI862EWWqD kVyZtdfdC1i8btIWO+x5DEfpOa0+Lag= X-MC-Unique: D6rqJnLpP5qSqeRofydX5w-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 4/5] docs: platforms: Clarify stance on third-party LTS efforts Date: Tue, 14 Jul 2020 15:07:42 +0200 Message-Id: <20200714130743.515094-5-abologna@redhat.com> In-Reply-To: <20200714130743.515094-1-abologna@redhat.com> References: <20200714130743.515094-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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.79 on 10.5.11.12 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" Signed-off-by: Andrea Bolognani Reviewed-by: Pavel Hrdina --- docs/platforms.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/platforms.rst b/docs/platforms.rst index 702d8d56d3..4fcb458635 100644 --- a/docs/platforms.rst +++ b/docs/platforms.rst @@ -42,7 +42,8 @@ Linux, FreeBSD and macOS The project aims to support the most recent major version at all times. Su= pport for the previous major version will be dropped 2 years after the new major version is released or when the vendor itself drops support, whichever com= es -first. +first. In this context, third-party efforts to extend the lifetime of a di= stro +are not considered, even when they are endorsed by the vendor (eg. Debian = LTS). =20 For the purposes of identifying supported software versions available on L= inux, the project will look at CentOS, Debian, Fedora, openSUSE, RHEL, SLES and --=20 2.25.4 From nobody Fri May 3 09:47:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.120 as permitted sender) client-ip=205.139.110.120; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.120 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=1594732101; cv=none; d=zohomail.com; s=zohoarc; b=nhb5mUppdRsmH5tkMhAR8gwRkwVyvuu0X5csHJ4nzR76zZPp3fegYSNuMleD+ojyjZjE4B1hOKzlMKrGs6HT5gO7xzOWob/3NuP448c+0MfsDt3GgT1MY/yBO2xw7TmOnl4/aiSaAaHAz3NrFZZxS8oK8QrPdR3tDywYW9u6BH0= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1594732101; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=8z3zlTh4R2yzVI5/oNESdYTdsDWxO+h8sTWYFLZlWoE=; b=SqtDQq0VPTlpczkYRt/0yhZzm8Zhh4ZWS7W/mC0ptnKTnPBN79N02mbKv56apiA4QS71MPlF7cGE0GXVusdBZ30OVmNt0w4bzzNBnr/xYRJbQk0HU5h77zOg9eBrk4LksC+lCQM53IL33mvF8i4AFifT+VDZReJ/B8RH72Qynps= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.120 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.120]) by mx.zohomail.com with SMTPS id 1594732101501466.932412687569; Tue, 14 Jul 2020 06:08:21 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-314-uomNiWhnPQq9AFqQ--ElBw-1; Tue, 14 Jul 2020 09:08:16 -0400 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 DC4AD109A; Tue, 14 Jul 2020 13:08:05 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id B68072DE76; Tue, 14 Jul 2020 13:08:05 +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 844101809557; Tue, 14 Jul 2020 13:08:05 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 06ED7uHV022683 for ; Tue, 14 Jul 2020 09:07:56 -0400 Received: by smtp.corp.redhat.com (Postfix) id 7864C724D4; Tue, 14 Jul 2020 13:07:56 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.194.169]) by smtp.corp.redhat.com (Postfix) with ESMTPS id BB1DF6FEDF for ; Tue, 14 Jul 2020 13:07:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1594732100; 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: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=8z3zlTh4R2yzVI5/oNESdYTdsDWxO+h8sTWYFLZlWoE=; b=L9ZYcfXACDBhfAbuv5I+KTU82E5VEZdF2hPmBVZx29t7/GN+94RLYUAkDNcvTBXmfyF7VW l2Hb2CnRkCALbr7Svm9KX1hII5DZbm6cSkC+G4AbKwZR3T1o6zXcJzrea/3jUIohlNQcNy rKSUHll2TFxZyXpONPGj1W78Etc93CY= X-MC-Unique: uomNiWhnPQq9AFqQ--ElBw-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 5/5] docs: platforms: Mention Windows API target Date: Tue, 14 Jul 2020 15:07:43 +0200 Message-Id: <20200714130743.515094-6-abologna@redhat.com> In-Reply-To: <20200714130743.515094-1-abologna@redhat.com> References: <20200714130743.515094-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" Signed-off-by: Andrea Bolognani Reviewed-by: Pavel Hrdina --- docs/platforms.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/platforms.rst b/docs/platforms.rst index 4fcb458635..b0ce0c3737 100644 --- a/docs/platforms.rst +++ b/docs/platforms.rst @@ -59,6 +59,9 @@ Windows The project supports building with current versions of the MinGW toolchain, hosted on Linux. =20 +The version of the Windows API that's currently targeted is Vista / Server +2008. + =20 Virtualization platforms =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.25.4