From nobody Tue Feb 10 12:40:45 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.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.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail(p=none dis=none) header.from=bytedance.com ARC-Seal: i=1; a=rsa-sha256; t=1672803051; cv=none; d=zohomail.com; s=zohoarc; b=DYTjGpyqlU8+n6xOcgNFhT16VcoXjHOenS8GN1b0jQAJdUlGZNmpZL3A6hapeTYOa9RHIbqnxWeWmnuvSBHSvLfJNyBDStH/cVImc9iz87Ta9Ekgy0Az+OxIQIgIB7Zpz1fPK7QJkBB3lZMHToXn59yKTgzHtJgWpC5sbGNNiyU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1672803051; h=Content-Type:Content-Transfer-Encoding:Cc: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=w1Ej6ofSaujA0OIHWVBfiYBJFJ2GJfGxHtxauffUd1Y=; b=gEP3v5WiLnYqEBwBbrnJSukmUhEWmex/AROK2VpMqKbw1qAdvClE1rnMSJ5k10VTDETaVL+iO75DblG0oNMdBLpMXVt9alPAPqou7BB92qV4LoGCy1OPj1/cRNlbxsNtuI5j4GW0/UGj81iyeO1id5shlPP1Xq2Q9Ei7ChlzmNg= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1672803051581667.8816294891204; Tue, 3 Jan 2023 19:30:51 -0800 (PST) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-434-I2bPruPiP0yZkmY_ep0pMw-1; Tue, 03 Jan 2023 22:30:48 -0500 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 3107F3811F35; Wed, 4 Jan 2023 03:30:46 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1194F1121319; Wed, 4 Jan 2023 03:29:58 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 136B619465B7; Wed, 4 Jan 2023 03:29:51 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 0947019465B5 for ; Wed, 4 Jan 2023 03:29:50 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id DE174492C18; Wed, 4 Jan 2023 03:29:49 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast04.extmail.prod.ext.rdu2.redhat.com [10.11.55.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id D6310492C14 for ; Wed, 4 Jan 2023 03:29:49 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-2.mimecast.com [205.139.110.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id AA3E4101A521 for ; Wed, 4 Jan 2023 03:29:49 +0000 (UTC) Received: from mail-pg1-f169.google.com (mail-pg1-f169.google.com [209.85.215.169]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_128_GCM_SHA256) id us-mta-382-y-_XLlaiP0SdTymFol4BBw-1; Tue, 03 Jan 2023 22:29:47 -0500 Received: by mail-pg1-f169.google.com with SMTP id f3so21426979pgc.2 for ; Tue, 03 Jan 2023 19:29:47 -0800 (PST) Received: from always-pc.bytedance.net ([61.213.176.6]) by smtp.gmail.com with ESMTPSA id 141-20020a621493000000b005815217e665sm14881863pfu.65.2023.01.03.19.29.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 03 Jan 2023 19:29:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1672803050; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc: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=w1Ej6ofSaujA0OIHWVBfiYBJFJ2GJfGxHtxauffUd1Y=; b=b2NHVG6Rpad5Jtj79PRiuiFW+qZ35bhKwzEAkx7ITB2PX4vhj98z3/pb1EwwhEZ9V5R6gC adJvOESGc1xL0HwwCnxODEaOxdmCg6Dtaw2qhYuXlYHYYAkiugdBXk7z5H5JG/Rq3n2Bq8 9OFoTHm5WBeE9VOf1So8GdQx6Ga3rfM= X-MC-Unique: I2bPruPiP0yZkmY_ep0pMw-1 X-Original-To: libvir-list@listman.corp.redhat.com X-MC-Unique: y-_XLlaiP0SdTymFol4BBw-1 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=w1Ej6ofSaujA0OIHWVBfiYBJFJ2GJfGxHtxauffUd1Y=; b=USjEK7Pq9chzwaGbrzE6dD+IOmRJTksKZmAlvVwDrb+DOS8I++kzbJ8IejUKz829UW SBfcCc43NOpO4BKN5n4qPv4uig1EuUx3qRehvg8v6CuzbYk3HW5dJ/6NrOJYtXhrmS76 oXRxg1EHQFpGSPxcIyYPkb0DipIPXzhkaooOFlbhPLyzBlbazhCN26DL+SILHBpkwvFr JsJ/ILLObiKuJ0sdMRlK9d5xkQoJQ1zN6GxSItvnMBMudXn3A0W2KYmweS1GIX33/hcQ O6DKDKB0mmeQkdeQV/m3sUPie1LL1hjz1qHUU9y0Z/svnnqeQbFCf1AFjAKyVKqh10od d7/Q== X-Gm-Message-State: AFqh2kp7nq5EG+RRBjw/xNjYemnAa2S4b3aLBkVUjNlfxylSJUmw+MM3 Y5ba0TWH2YE9F/+sbWpiA8UN2n/Q74N/VRpe X-Google-Smtp-Source: AMrXdXssvZ3RslCa5AVwsjukffNxbLtjkLIqw244o+fs6NwydEnGUNW17py+A43h+qrtsipDeZbr7Q== X-Received: by 2002:a05:6a00:2995:b0:581:65ab:8cba with SMTP id cj21-20020a056a00299500b0058165ab8cbamr727455pfb.31.1672802986631; Tue, 03 Jan 2023 19:29:46 -0800 (PST) From: zhenwei pi To: mprivozn@redhat.com Subject: [PATCH 1/7] docs: introduce crypto device Date: Wed, 4 Jan 2023 11:29:31 +0800 Message-Id: <20230104032937.3058144-2-pizhenwei@bytedance.com> In-Reply-To: <20230104032937.3058144-1-pizhenwei@bytedance.com> References: <20230104032937.3058144-1-pizhenwei@bytedance.com> MIME-Version: 1.0 X-Mimecast-Impersonation-Protect: Policy=CLT - Impersonation Protection Definition; Similar Internal Domain=false; Similar Monitored External Domain=false; Custom External Domain=false; Mimecast External Domain=false; Newly Observed Domain=false; Internal User Name=false; Custom Display Name List=false; Reply-to Address Mismatch=false; Targeted Threat Dictionary=false; Mimecast Threat Dictionary=false; Custom Threat Dictionary=false X-Scanned-By: MIMEDefang 3.1 on 10.11.54.9 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: libvir-list@redhat.com, helei.sig11@bytedance.com, zhenwei pi Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.3 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: 1672803053814100001 Content-Type: text/plain; charset="utf-8"; x-default="true" Introduce crypto device like:
Currently, crypto model supports virtio only, type supports qemu only (vhost-user in the plan). For the qemu type, backend supports modle builtin/lkcf, and the queues is optional. Signed-off-by: zhenwei pi --- docs/formatdomain.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index d7fffc6e0b..2b46f6c966 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -8225,6 +8225,27 @@ The optional ``driver`` element allows to specify vi= rtio options, see ... =20 =20 +Crypto +~~~~~~ + +A crypto device. The ``model`` attribute defaults to ``virtio``. +:since:`Since v9.0.0` ``model`` supports ``virtio`` only. The ``type`` att= ribute +defaults to ``qemu``. :since:`Since v9.0.0` ``type`` supports ``qemu`` onl= y. +The optional attribute ``backend`` is required if the ``type`` is ``qemu``= , the +``model`` attribute can be ``builtint`` and ``lkcf``, the optional attribu= te +``queues`` specifies the number of virt queues for virtio crypto. + +:: + + ... + + + + + + ... + + Security label -------------- =20 --=20 2.34.1