From nobody Mon Feb 9 15:10:05 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as permitted sender) client-ip=63.128.21.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 63.128.21.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail(p=none dis=none) header.from=intel.com ARC-Seal: i=1; a=rsa-sha256; t=1616468354; cv=none; d=zohomail.com; s=zohoarc; b=QF+watgi6GpxVTbjkOvANuFJly/3bUm6LUivINwp+guAnensgmvcnU/yGAi4EQ9+EbVhfYFAt17OGN6NWZ0QUu/fUji9LP83ZKuQYzOZwCJtmFMs8wjsS4ryefTHiXBa+U20aWVHkxDVSKWdu/y6Y50UJ8yKKYmH5jXGr2phBHA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1616468354; 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=OJKO9fWJdw299Mbp6HhtLiMxrJ1IXZyx9OcMT0wM4Pw=; b=oAwFnLJxDF8xqOyS7V/dvmTIa4Ch6mUHWzuC6JCM3Q2zqiDcNJNu6b+cyaYRaHnM3JxboGntlCVJ6hT5W3kkqE9S4K5ZfDgcRhsu4tEKJE3rqf/mQCpMKubQH3AIEDqUMUdafFr++0pbl2sIZ7g/6Yz334e12UYgSd773kJqUgA= ARC-Authentication-Results: i=1; mx.zohomail.com; spf=pass (zohomail.com: domain of redhat.com designates 63.128.21.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 [63.128.21.124]) by mx.zohomail.com with SMTPS id 1616468354494622.3883490254295; Mon, 22 Mar 2021 19:59:14 -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-566-Hm8mwlbePWa3A7ZaC_sfHw-1; Mon, 22 Mar 2021 22:59:11 -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 BE172881276; Tue, 23 Mar 2021 02:59: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 295CA10023B0; Tue, 23 Mar 2021 02:59: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 C50BE1809C83; Tue, 23 Mar 2021 02:59:00 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 12N2wxsS009648 for ; Mon, 22 Mar 2021 22:58:59 -0400 Received: by smtp.corp.redhat.com (Postfix) id 1023D63A5E; Tue, 23 Mar 2021 02:58:59 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast05.extmail.prod.ext.rdu2.redhat.com [10.11.55.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 0880763ABE for ; Tue, 23 Mar 2021 02:58:56 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-1.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 60F5B80006E for ; Tue, 23 Mar 2021 02:58:56 +0000 (UTC) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-281-2xm-jhuaPwW-FZf4GNZvcQ-2; Mon, 22 Mar 2021 22:58:53 -0400 Received: from orsmga001.jf.intel.com ([10.7.209.18]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 Mar 2021 19:57:50 -0700 Received: from luyao-nuc7i7bnh.bj.intel.com ([10.238.154.184]) by orsmga001.jf.intel.com with ESMTP; 22 Mar 2021 19:57:49 -0700 X-MC-Unique: Hm8mwlbePWa3A7ZaC_sfHw-1 X-MC-Unique: 2xm-jhuaPwW-FZf4GNZvcQ-2 IronPort-SDR: NtYLA5efp3IhRsSA6ml+sG58vRV5eICr5+A5ULLiLoCnGUAMm4tOWCaSahm98W3WtkqCzwDY+B pWqm5q2XQe8A== X-IronPort-AV: E=McAfee;i="6000,8403,9931"; a="189792034" X-IronPort-AV: E=Sophos;i="5.81,270,1610438400"; d="scan'208";a="189792034" IronPort-SDR: FFWbiG6fWeLsIrzRoplv3wk677mEoYqkaAlwDnu46Cn2BZPu2s+5H9riuZ51Y4X4ekIXY250mg eGMiKzS1pFkg== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.81,270,1610438400"; d="scan'208";a="451956835" From: Luyao Zhong To: libvir-list@redhat.com Subject: [libvirt][PATCH v4 1/3] docs: add docs for 'restrictive' option for mode in numatune Date: Tue, 23 Mar 2021 10:59:03 +0800 Message-Id: <20210323025905.573299-2-luyao.zhong@intel.com> In-Reply-To: <20210323025905.573299-1-luyao.zhong@intel.com> References: <20210323025905.573299-1-luyao.zhong@intel.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.79 on 10.11.54.5 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.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-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" When user would like use cgroups to restrict the allowed memory nodes, and require not setting any specific memory policy, then 'restrictive' mode is useful. Reviewed-by: Daniel Henrique Barboza Signed-off-by: Luyao Zhong --- docs/formatdomain.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 9392c80113..08d3c727be 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1120,8 +1120,11 @@ NUMA Node Tuning ``memory`` The optional ``memory`` element specifies how to allocate memory for the domain process on a NUMA host. It contains several optional attributes. - Attribute ``mode`` is either 'interleave', 'strict', or 'preferred', de= faults - to 'strict'. Attribute ``nodeset`` specifies the NUMA nodes, using the = same + Attribute ``mode`` is either 'interleave', 'strict', 'preferred' or + 'restrictive', defaults to 'strict'. The value 'restrictive' specifies + using system default policy and only cgroups is used to restrict the + memory nodes, and it requires setting mode to 'restrictive' in ``memnod= e`` + elements. Attribute ``nodeset`` specifies the NUMA nodes, using the same syntax as attribute ``cpuset`` of element ``vcpu``. Attribute ``placeme= nt`` ( :since:`since 0.9.12` ) can be used to indicate the memory placement mo= de for domain process, its value can be either "static" or "auto", defaults to --=20 2.25.4