From nobody Sat Nov 23 05:23:33 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1681980576; cv=none; d=zohomail.com; s=zohoarc; b=VbHjmQRcR1umcBm0P461BvmTHhtRsf+gTuIJ+tvCXH+T3SPHe1oX4rF83XsogIxuTwKBfL3H1Wqqvj0i5KRgP+jWuxq92VbWbQBuK4QNbwvbRqGXRZvIQP2U6WZtXeLCiQTQkQ7FtrIhxotTnCn5BFSwC9zMWlPWRxJ09J1gwfc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1681980576; 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=tQw3FahZ/Q7dN42jvsrthghWARwN1cgqT8jutGITlmE=; b=MlDGTIw4M6wutO2c6aW11LTO3jeCcBOCUzzLBAW24qMa7x3/eHBzqFCKERvWV0l4//IOAePQ70Pn4JAvCrifV80jXFMNEe92jb9pCz5VM5v9G61kCRgWJgz891BYJfa9fppWLm5iphDvVdAsX1Exc97V4IoKQw8Xc86uMtS9UM8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1681980576261414.25838050970765; Thu, 20 Apr 2023 01:49:36 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-549-dg6B0CwpMaydkJWEAlbtkQ-1; Thu, 20 Apr 2023 04:49:32 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 71A30857FBA; Thu, 20 Apr 2023 08:49:30 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 27293492B05; Thu, 20 Apr 2023 08:49:29 +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 CE5021946A4D; Thu, 20 Apr 2023 08:49:27 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id B8FC119465B5 for ; Thu, 20 Apr 2023 08:49:26 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 9F28B40C201F; Thu, 20 Apr 2023 08:49:26 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast09.extmail.prod.ext.rdu2.redhat.com [10.11.55.25]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 9798340C2064 for ; Thu, 20 Apr 2023 08:49:26 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.120]) (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 79256281294E for ; Thu, 20 Apr 2023 08:49:26 +0000 (UTC) Received: from mail-ed1-f70.google.com (mail-ed1-f70.google.com [209.85.208.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-634-dLkuJeW_MAeUr_ajhPVg2g-1; Thu, 20 Apr 2023 04:49:25 -0400 Received: by mail-ed1-f70.google.com with SMTP id f2-20020a50d542000000b00502c2f26133so1225386edj.12 for ; Thu, 20 Apr 2023 01:49:24 -0700 (PDT) Received: from wheatley.localdomain (nat-pool-brq-t.redhat.com. [213.175.37.10]) by smtp.gmail.com with ESMTPSA id re4-20020a170906d8c400b0094a82a236cbsm471774ejb.129.2023.04.20.01.49.22 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 Apr 2023 01:49:23 -0700 (PDT) Received: from wheatley.. (wheatley.k8r.cz [127.0.0.1]) by wheatley.localdomain (Postfix) with ESMTP id 94EDDFB446B0 for ; Thu, 20 Apr 2023 10:49:22 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1681980575; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to: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=tQw3FahZ/Q7dN42jvsrthghWARwN1cgqT8jutGITlmE=; b=Qym8AHiEc0huaMutOTLEsl4qquY9jba5L0LkExTCbvebw7Cz+GYt20b0x92GfI8yTpXxwC X2RMJBsQgKwE9OVT6WWYcPS5mE6+MnI9L3qm2fCX/gudB7ndgvPJcWlilYXV6V7Ogn3+s/ MagFASeuU5yl0wblBg+4iLJ24KxgWqk= X-MC-Unique: dg6B0CwpMaydkJWEAlbtkQ-1 X-Original-To: libvir-list@listman.corp.redhat.com X-MC-Unique: dLkuJeW_MAeUr_ajhPVg2g-1 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1681980564; x=1684572564; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=tQw3FahZ/Q7dN42jvsrthghWARwN1cgqT8jutGITlmE=; b=Q+yVkAu8YHaRHSE9Rfi+GIrjuK/OBPk9KNCsGj0b7uJJTCsyY0gVmjJDzjyCw+k9iI uvM2HOqZ2JICEUJpz2n+4IlZSMtKjQvurcGjUJYsFuyABFi5UgTdXIxyQmePXgrhppwa 1citgpOknca0UU75zldkpOB/LtcoDy2vKobxqeMs5LLJjqVGEdHWts6tlunypSfvAj2f oZ3IQoFeeuvy6GXCwshB9Oma03Je0xwVNEm7vVVSfjV6/zkgfikOQd7AX/dR5/ucuI6X C8KIDb5+6je7hOsMXvg5aA5rGr3Z3/5GLJq5nhzD0CYkWmtlaPT1UariekVwI+U2yVDV 6tTg== X-Gm-Message-State: AAQBX9e7FN9T8j3nbgusOIui3oq3K4XOmpFYCQNtq4a9j+57j3Y9Q1Ii gubTxpwD4RRb97FvLoQFB0oIBbuSOGzNYR6/2tHV+3EOXy0Gu5sycF+hMkBoJ3YEsaCqW1elbWp /tFiJmYwaBX42n8A+HfeUtSRgx1z1zZVEfSDaeh1zHCCNnzSp1i1ns63zx6vtPQw4S5o7hIJSPJ IphdAHNQ== X-Received: by 2002:a17:906:2a90:b0:94f:7844:b0ca with SMTP id l16-20020a1709062a9000b0094f7844b0camr785247eje.52.1681980564020; Thu, 20 Apr 2023 01:49:24 -0700 (PDT) X-Google-Smtp-Source: AKy350bXMjYIZ+2n87fIRsZxv7EkxkUbceOAcJjMtWwz2PGmzFh+Q3jwzCRr/jG/Hwcexm8uEBZ0Og== X-Received: by 2002:a17:906:2a90:b0:94f:7844:b0ca with SMTP id l16-20020a1709062a9000b0094f7844b0camr785224eje.52.1681980563652; Thu, 20 Apr 2023 01:49:23 -0700 (PDT) From: Martin Kletzander To: libvir-list@redhat.com Subject: [PATCH 2/2] docs: Clarify restrictive numatune mode Date: Thu, 20 Apr 2023 10:49:19 +0200 Message-Id: <8f1f2d4e8214fb93eaeb5e340b9db769a827ad9e.1681980463.git.mkletzan@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.1 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: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.9 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: 1681980576934100001 Content-Type: text/plain; charset="utf-8"; x-default="true" Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=3D2185184 Signed-off-by: Martin Kletzander --- docs/formatdomain.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index c31c2fe35c76..cb3fe3dc1c33 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -1207,7 +1207,10 @@ NUMA Node Tuning '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 + elements (see quirk below). This exists solely for the purpose of bein= g able + to request movement of such memory for a running domain using ``virsh + numatune`` or ``virDomainSetNumaParameters` and is not guaranteed to ha= ppen. + 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 @@ -1227,6 +1230,12 @@ NUMA Node Tuning addresses guest NUMA node for which the settings are applied. Attributes ``mode`` and ``nodeset`` have the same meaning and syntax as in ``memor= y`` element. This setting is not compatible with automatic placement. + Note that for ``memnode`` this will only guide the memory access for th= e vCPU + threads or similar mechanism and is very hypervisor-specific. This doe= s not + guarantee the placement of the node's memory allocation. For proper + restriction other means should be used (e.g. different mode, preallocat= ed + hugepages). + :since:`QEMU Since 1.2.7` =20 =20 --=20 2.40.0