From nobody Sat Feb 7 23:39:50 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) client-ip=205.139.110.61; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 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=1586461555; cv=none; d=zohomail.com; s=zohoarc; b=dYlw6RAAE+R3EqzrXNzxw9CJN9xY7UHcEMPBh3BgfKYXL9VKRNAVo2g0ql3QaNwybMAeesOQbJtwBbtGK6splJ0JEHND8PH4hM+TEjF9HisWUFIEF31flH7taAQQcctpgobhO06J+2ZqbnEAzVKxyMbtJBkoI7FHMvI6Vj+VpJY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586461555; 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=9Xg56V0WcsKE08DFipYtERdZyBgnEL+f/49pConq/G4=; b=EUqrNdEiueiTKXLfJ8YCnk/ShJIRgIwdu3xFGvjj8U2vaiquFk+lcHeeL9VyUqUhOC4C+neCgJ4SmxW5Sgd4g1qLS5lNrO4zg1vxUtQvRDzgP34NxElcDXHlYauYNBUbU7i03KtSCXoqQdTXqP/n7r6z303lD6gmcWWIl2QMmCk= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 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-1.mimecast.com (us-smtp-2.mimecast.com [205.139.110.61]) by mx.zohomail.com with SMTPS id 1586461554862520.9443686947848; Thu, 9 Apr 2020 12:45:54 -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-24-jTjkiZ-_PLasbVAyoC46uQ-1; Thu, 09 Apr 2020 15:45:49 -0400 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 A4160107ACCC; Thu, 9 Apr 2020 19:45:42 +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 882735DA7C; Thu, 9 Apr 2020 19:45:40 +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 9C7D19307A; Thu, 9 Apr 2020 19:45:38 +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 039JjbHs023051 for ; Thu, 9 Apr 2020 15:45:37 -0400 Received: by smtp.corp.redhat.com (Postfix) id EE946121860; Thu, 9 Apr 2020 19:45:36 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast06.extmail.prod.ext.rdu2.redhat.com [10.11.55.22]) by smtp.corp.redhat.com (Postfix) with ESMTPS id EAD9A12185E for ; Thu, 9 Apr 2020 19:45:34 +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 16A16185A78E for ; Thu, 9 Apr 2020 19:45:34 +0000 (UTC) Received: from mail-qk1-f173.google.com (mail-qk1-f173.google.com [209.85.222.173]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-25-Zub793LiPzGrKje8RlDXDA-1; Thu, 09 Apr 2020 15:45:28 -0400 Received: by mail-qk1-f173.google.com with SMTP id g74so5279371qke.13; Thu, 09 Apr 2020 12:45:28 -0700 (PDT) Received: from rekt.ibmuc.com ([2804:431:c7c7:d2c5:f255:8ae1:8c2f:ca7c]) by smtp.gmail.com with ESMTPSA id d4sm9144558qtc.48.2020.04.09.12.45.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 09 Apr 2020 12:45:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586461553; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=9Xg56V0WcsKE08DFipYtERdZyBgnEL+f/49pConq/G4=; b=RZD+LMhiZYbR4yve94pivEqiyOsScVlW2yhY3fCjA1adCsg2sazc4T6VFoAyo8nPGwJJgo HyG6IEAGLf3whrbgE+mI6X2d2CsoP1VvH/lHG9C4TpYPFhVvs132JkH4Koe2WL3SFDVhq8 MGu3thY5E1y/bXKJLWav5FCTsPd44Cc= X-MC-Unique: jTjkiZ-_PLasbVAyoC46uQ-1 X-MC-Unique: Zub793LiPzGrKje8RlDXDA-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=nuZOg9xEZxzovH5/86V9nJnufqfOxQiCFYeoE1TD39Y=; b=RbKNzrbglcQsg6BPQfjwWErn+S31XXeQfuSdpsrrR9WVPzITtRgS3lHgOMfn3PDJJ+ pe0cv4DWwLacIDDpkGvupwRgBuVUKvvPf5e3GefgluGUmws2/7TghWBhqCaXy85zaBrT kb6GxiB2lbLuZ/ZFnVjYr5Um8iq31lyCRxmA3FX0ieKKG9I+06NZ70qhCy1KSoUxdbp0 7+S3Fx4UuRqS1a/rjCBPfBtyiUW3BqJzcWuIL8EZZu7ss7PSVwONII3c23pyp81g5Xle jZKY1+hVuKtCoBX0IqLf7UE2vHlo0SHzRf24hSY/SWxLjpCOYL+ANGSYuicP7AEJCDR5 pFXA== X-Gm-Message-State: AGi0PuaQyKDibH+EZtdAjtrEAPh/K4AbnBcWn93k1LYXgGuR4bAVNaoR bMESKgl7plr6wvsKi5x7PEzb6W2X X-Google-Smtp-Source: APiQypJ2aFrOmWqVrGdlttrOi9ChZhKWN5e6GSO/4yBqAtpkgL9AR+FB2gI3YpnuAdGPrGBpW6Wiqw== X-Received: by 2002:a37:77c3:: with SMTP id s186mr564798qkc.6.1586461528105; Thu, 09 Apr 2020 12:45:28 -0700 (PDT) From: Daniel Henrique Barboza To: libvir-list@redhat.com Subject: [PATCH] formatdomain.html.in: document emulator/vcpu pin delay Date: Thu, 9 Apr 2020 16:45:17 -0300 Message-Id: <20200409194517.292036-1-danielhb413@gmail.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.11.54.5 X-MIME-Autoconverted: from quoted-printable to 8bit by lists01.pubmisc.prod.ext.phx2.redhat.com id 039JjbHs023051 X-loop: libvir-list@redhat.com Cc: mprivozn@redhat.com, Daniel Henrique Barboza 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 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" In a guest with only one vcpu, when pinning the emulator in say CPU184 and the vcpu0 in CPU0 of the host, the user might expect that only CPU0 and CPU184 of the host will be used by the guest. The reality is that Libvirt takes some time to honor the emulator and vcpu pinning, taking care of NUMA constraints first. This will result in other CPUs of the host being potentially used by the QEMU thread until the emulator/vcpu pinning is done. The user then might be confused by the output of 'virsh cpu-stats' in this scenario, showing around 200 microseconds of cycles being spent in other CPUs. Let's document this behavior, which is explained in detail in Libvirt commit v5.0.0-199-gf136b83139, in the cputune section of formatdomain.html.in. Signed-off-by: Daniel Henrique Barboza --- docs/formatdomain.html.in | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 47e10a836c..932bf8841f 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -808,6 +808,13 @@
The optional cputune element provides details regarding the CPU tunable parameters for the domain. + + Note: for the qemu driver, the optional vcpupin + and emulatorpin pinning settings are honored after + the emulator is launched and NUMA constraints considered. This + means that it is expected that other physical CPUs of the host + will be used during this time by the domain, which will be + reflected by the output of virsh cpu-stats. Since 0.9.0
vcpupin
--=20 2.25.1