From nobody Mon Feb 9 02:12:34 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=1608081261; cv=none; d=zohomail.com; s=zohoarc; b=kp9ZM9BGh0j+K57AtXvLqsW769qlXKMViWhorhkRS58s0PPzF6nhkgjY8L8uidoeDNG4IJSxl3qpkVEnRgG+IetVd1vhO30Y60EyngofXhtUgP9zmiq173FMGHHW7cFURE9KdOZYntDZze4kPENO9UHX/LfNkM69+ZiKNQyLIHQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1608081261; 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=dGaatSZfsMEp9x0ThaQ97INqcVTEEQB8hDKKWtLuhik=; b=gB1YS5zWDI3EpaMvGbGhYvRbfNhfa/ZBK1IuDj/FMPaMK5wIZZ9UDcAJJCgnGYqid83pW3aYLsu1vXYuxXMhQcguRBT7JyORDrjG+dNEbd9zK+cHFVCVM9jJAVdiZvJB3zZzL4JsaNqRaeZoyi38pYrxyEndb2N1FlAYDYITsqE= 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 1608081261316662.9575475747333; Tue, 15 Dec 2020 17:14:21 -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-342-154VCeosMHeNYPq4DUrRHA-1; Tue, 15 Dec 2020 20:14:18 -0500 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 8ECFD1E7C4; Wed, 16 Dec 2020 01:14:12 +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 9B1C55D9E3; Wed, 16 Dec 2020 01:14:11 +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 23B9F18095C7; Wed, 16 Dec 2020 01:14:07 +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 0BG1E6mM025071 for ; Tue, 15 Dec 2020 20:14:06 -0500 Received: by smtp.corp.redhat.com (Postfix) id AD9282026D15; Wed, 16 Dec 2020 01:14:06 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast02.extmail.prod.ext.rdu2.redhat.com [10.11.55.18]) by smtp.corp.redhat.com (Postfix) with ESMTPS id A8C852026D5D for ; Wed, 16 Dec 2020 01:14:04 +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-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id DFF0980018D for ; Wed, 16 Dec 2020 01:14:04 +0000 (UTC) Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-505-u7yn3ni8PnOlEj6L39yQBg-2; Tue, 15 Dec 2020 20:14:02 -0500 Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 15 Dec 2020 17:14:01 -0800 Received: from luyao-nuc7i7bnh.bj.intel.com ([10.238.154.184]) by fmsmga002.fm.intel.com with ESMTP; 15 Dec 2020 17:14:01 -0800 X-MC-Unique: 154VCeosMHeNYPq4DUrRHA-1 X-MC-Unique: u7yn3ni8PnOlEj6L39yQBg-2 IronPort-SDR: pwYy4tx/KKtzCUckAfM6TQhrMF67LBqsY0nn3oWkmDDw4XSG3MzEtUOQ6vGToQ3VvJuSPGhYFB CQYTnTZaHYuA== X-IronPort-AV: E=McAfee;i="6000,8403,9836"; a="162728960" X-IronPort-AV: E=Sophos;i="5.78,423,1599548400"; d="scan'208";a="162728960" IronPort-SDR: iEuIOxMiMwI/9xPu1HI4ri9PxPq0ObbJ5dT+uS2Q98XRf171//0bObciJP0P28gpEH6bKqV0Co OaayvU/+zyIg== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.78,423,1599548400"; d="scan'208";a="385804159" From: Luyao Zhong To: libvir-list@redhat.com Subject: [libvirt][PATCH v1 1/3] docs: add docs for 'restrictive' option for mode in numatune Date: Wed, 16 Dec 2020 09:12:59 +0800 Message-Id: <20201216011301.3143844-2-luyao.zhong@intel.com> In-Reply-To: <20201216011301.3143844-1-luyao.zhong@intel.com> References: <20201216011301.3143844-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.4 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.14 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. --- docs/formatdomain.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index ff64996af2..90abe27d30 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