From nobody Tue Feb 10 04:13:30 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=1609670583; cv=none; d=zohomail.com; s=zohoarc; b=PYQPDK+x4nMML242PYj/zBUVCeUrJ+rBCPyDQYZvRrae95BWVhNrz5JjItbM8aDISTsO+Ip+x1rDPqHvSuVsv8O85KljxE5AjPdew4G9mVM3kQDK7culeblSBo6fa1mRXW+gljINuwkvVph9E84gfWufVonDA2xZgL5qKoJ39Mo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1609670583; 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=uXT4uQr62qZeblTSeZF8zM59fFCNgC6WgB2a8ieIQ3U=; b=K7EthrHedLfI6o/3ru78UeTA46seLTG1tg1XdpTo3ryTeUUg0xh/R0dM7Af5vwh0zHOEUC1nXOhCpg1CaDM7uUH9UIWXTFHn/X0nq69ijs/0+x+XejumVaZk8zdYjaTbMFQHz5tUZkTE0Lqk3HVv90bBKrS0vk250D4wF7zslMk= 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 1609670583467343.05863517642945; Sun, 3 Jan 2021 02:43:03 -0800 (PST) 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-229-vtTvOAHaMI2QdzNuokZBmg-1; Sun, 03 Jan 2021 05:42:00 -0500 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 621478015A4; Sun, 3 Jan 2021 10:41:54 +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 B77135F9AC; Sun, 3 Jan 2021 10:41:53 +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 9BD251809C9F; Sun, 3 Jan 2021 10:41:49 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.rdu2.redhat.com [10.11.54.6]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 103AfldV001037 for ; Sun, 3 Jan 2021 05:41:48 -0500 Received: by smtp.corp.redhat.com (Postfix) id D25482166B2A; Sun, 3 Jan 2021 10:41:47 +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 CD19D2166B27 for ; Sun, 3 Jan 2021 10:41:43 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-1.mimecast.com [205.139.110.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id C4686858EEC for ; Sun, 3 Jan 2021 10:41:43 +0000 (UTC) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-416-PxXruRuqNxK7N5qq3bx2fg-2; Sun, 03 Jan 2021 05:41:41 -0500 Received: from orsmga008.jf.intel.com ([10.7.209.65]) by fmsmga104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 03 Jan 2021 02:40:38 -0800 Received: from luyao-nuc7i7bnh.bj.intel.com ([10.238.154.184]) by orsmga008.jf.intel.com with ESMTP; 03 Jan 2021 02:40:38 -0800 X-MC-Unique: vtTvOAHaMI2QdzNuokZBmg-1 X-MC-Unique: PxXruRuqNxK7N5qq3bx2fg-2 IronPort-SDR: U8d3+O0BfxNH3TePB5pnWjSby7FgFP470840DgzElAXVqlZGgJAYs8X3Rl97Ir7ezOXfDN3bNW hWOlPjzfBQFw== X-IronPort-AV: E=McAfee;i="6000,8403,9852"; a="174284100" X-IronPort-AV: E=Sophos;i="5.78,471,1599548400"; d="scan'208";a="174284100" IronPort-SDR: k72sfOzvxVMzokQT2gtLdco5wQnDezHssS8f6MO7KUCTQjzoHmStSOAJh5zUhcbSApYFkpdEx4 VNv4wint2pXA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.78,471,1599548400"; d="scan'208";a="377967858" From: Luyao Zhong To: libvir-list@redhat.com Subject: [libvirt][PATCH v2 1/3] docs: add docs for 'restrictive' option for mode in numatune Date: Sun, 3 Jan 2021 18:39:15 +0800 Message-Id: <20210103103917.3931266-2-luyao.zhong@intel.com> In-Reply-To: <20210103103917.3931266-1-luyao.zhong@intel.com> References: <20210103103917.3931266-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.78 on 10.11.54.6 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.16 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 --- docs/formatdomain.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 512939679b..3b6d71219a 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1086,8 +1086,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