From nobody Mon May 6 03:00:33 2024 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; 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=gmail.com ARC-Seal: i=1; a=rsa-sha256; t=1623074372; cv=none; d=zohomail.com; s=zohoarc; b=WVbpbnR88fAobmBfVIdgKDD9c6deZEEvdU/e8G7RwkzzVFidhtdo671gTMqfR0XSGrvg/nil6lQedcyOlijh9bWtcwXXSLKlnZDQAzZpTEfZY2VA/pb0Mh0HKkpkyOL/UswhNNSaAXCuW4NZZh2F4O/inTNn4unhsak1i+BiNAE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1623074372; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=7Wp3rJeIvvLVHUmWsfqpxDGTY7Wjr4payX7oMbAlcT0=; b=lK89QFhsxMT4qKjVjfEu5kVc8JdeCucbmiqi7pZcjYiN3ZsSqMMEbykwVj/yFcTrhLIIAsWjHuS5IfsYAm+y8qRxMkT9EIZuHYQHdbe6G2QvThATBTG2petZnpxS78mpzgHYL4EP1B/ngDp2AwAARvvYIrrLQUChlzPp+WH9MP4= ARC-Authentication-Results: i=1; mx.zohomail.com; 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) header.from= 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 1623074372083155.75380590256293; Mon, 7 Jun 2021 06:59:32 -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-354-wepvZOfsNPm-w8CnuOF-5A-1; Mon, 07 Jun 2021 09:59:28 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id EADDF8042AC; Mon, 7 Jun 2021 13:59:23 +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 B767A10016FC; Mon, 7 Jun 2021 13:59:23 +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 7AEB84E9E2; Mon, 7 Jun 2021 13:59:23 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 157DoXS0002593 for ; Mon, 7 Jun 2021 09:50:33 -0400 Received: by smtp.corp.redhat.com (Postfix) id 421DE2044003; Mon, 7 Jun 2021 13:50:33 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast01.extmail.prod.ext.rdu2.redhat.com [10.11.55.17]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 3D29C2044002 for ; Mon, 7 Jun 2021 13:50:29 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-2.mimecast.com [207.211.31.81]) (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 B465190DE30 for ; Mon, 7 Jun 2021 13:50:29 +0000 (UTC) Received: from mail-wr1-f43.google.com (mail-wr1-f43.google.com [209.85.221.43]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-149-VrRmU0wNPgOi4Kg3tgcvgA-1; Mon, 07 Jun 2021 09:50:27 -0400 Received: by mail-wr1-f43.google.com with SMTP id l2so17744345wrw.6; Mon, 07 Jun 2021 06:50:26 -0700 (PDT) Received: from localhost ([51.15.41.238]) by smtp.gmail.com with ESMTPSA id b22sm11386025wmj.22.2021.06.07.06.50.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 07 Jun 2021 06:50:25 -0700 (PDT) X-MC-Unique: wepvZOfsNPm-w8CnuOF-5A-1 X-MC-Unique: VrRmU0wNPgOi4Kg3tgcvgA-1 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=elZnjsvb3yiUhT7Rg5vyX2cAO3tn4P/146XVSusHQis=; b=DEBglcn3JcDTCglF8sw8JhFmK17KUXuWB1RhW1eAupim7DeAOpa65UX3tVVWUwUYnS ahOMx6dhtEfESm6uZqfZYgv2mfCNyYsJ6Ft85fGev3vmAYf/VfSYa3Om+SSPV/iHWSCU xNbfhSIIx1psrlvk7mi+1+2GLq5xlUHQn5dapYHbBapcN7w1uvN6ALwfHxICUximHKyP 29slFoKYYqm/QapJvs5LzjrNfTd2ola20asjiIHqo4INK+lP0HhqK04wFr9BG4pDwx/A JcH0TLogHNkD3cZgPB+LAFV8H+bWohvMlC7Ockkj7nMTS7GZS6X4/OIXUxmkytAzNsz8 yg5g== X-Gm-Message-State: AOAM533pa5Sa2rYqRHuJg4b4NiOZsphqIhyqzm7GZorQgNapWYuLJqDW 1AeKe0pIDTiYlL68pib4plmO8rf9Z0u68Qvk X-Google-Smtp-Source: ABdhPJzTheYIGV21rQiwTJOu0jPNH+FrthqbHm9x+N6VbBok4MV9IW9L9jgifJCYnxxQsRcGllFIGA== X-Received: by 2002:adf:b34a:: with SMTP id k10mr17358725wrd.333.1623073825880; Mon, 07 Jun 2021 06:50:25 -0700 (PDT) From: Stefan Hajnoczi To: libvir-list@redhat.com Subject: [libvirt PATCH] docs: virtiofs: describe memfd memory backend Date: Mon, 7 Jun 2021 14:50:24 +0100 Message-Id: <20210607135024.99928-1-stefanha@gmail.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 2.78 on 10.11.54.4 X-MIME-Autoconverted: from base64 to 8bit by lists01.pubmisc.prod.ext.phx2.redhat.com id 157DoXS0002593 X-loop: libvir-list@redhat.com X-Mailman-Approved-At: Mon, 07 Jun 2021 09:59:22 -0400 Cc: Stefan Hajnoczi , =?UTF-8?q?J=C3=A1n=20Tomko?= , =?UTF-8?q?Michal=20Pr=C3=ADvozn=C3=ADk?= 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.22 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-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Nowadays memfd is the most convenient memory backend for vhost-user devices. Compared to file-backend memory and hugepages, there is no need to worry about configuring the location of the shm directory or allocating hugepages. Cc: Michal Pr=C3=ADvozn=C3=ADk Cc: J=C3=A1n Tomko Signed-off-by: Stefan Hajnoczi Reviewed-by: Michal Privoznik --- docs/kbase/virtiofs.rst | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/docs/kbase/virtiofs.rst b/docs/kbase/virtiofs.rst index 740b08d50d..8cf7567bf8 100644 --- a/docs/kbase/virtiofs.rst +++ b/docs/kbase/virtiofs.rst @@ -29,7 +29,11 @@ NUMA. As of QEMU 5.0.0 and libvirt 6.9.0, it is possible= to specify the memory backend without NUMA (using the so called memobject interface). =20 -Either of the following: +One of the following: + +* Use memfd memory + + No host setup is required when using the Linux memfd memory backend. =20 * Use file-backed memory =20 @@ -75,7 +79,20 @@ Guest setup =20 #. Specify the memory backend =20 - Either of the following: + One of the following: + + * memfd memory + + :: + + + ... + + + + + ... + =20 * File-backed memory =20 --=20 2.31.1