From patchwork Mon Jun 28 11:30:43 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Daniel_P=2E_Berrang=C3=A9?= X-Patchwork-Id: 12347719 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.6 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 26178C2B9F4 for ; Mon, 28 Jun 2021 11:33:26 +0000 (UTC) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id BE8AB61C6C for ; Mon, 28 Jun 2021 11:33:25 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org BE8AB61C6C Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=redhat.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Received: from localhost ([::1]:54668 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lxpW0-0004y9-Vb for qemu-devel@archiver.kernel.org; Mon, 28 Jun 2021 07:33:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:43274) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lxpTj-0002bo-14 for qemu-devel@nongnu.org; Mon, 28 Jun 2021 07:31:03 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:54567) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lxpTg-0000o8-3S for qemu-devel@nongnu.org; Mon, 28 Jun 2021 07:31:02 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1624879859; h=from:from: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; bh=W58AYkOBPLX5Q2+BZqZtjiaH+COPpETXuvYdKOIJ478=; b=h1iGL7cfvg86yQ2T0x2sFVf8HJtEHVNXKzQqw12p0h3JFg5bdnlZ7zONXbipZ8mcPtxOvO 0rJhRJAZ/zGXDxEgEODgdkh5MDOgBg9KY9klXVuxiIx6AfaL3EvZu3Ud/Ew3c19GXhLL+J zLaZLQNtz/K0OTlMc3kXJLv8AS//Apo= 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-499-WP0kcjU3Mq-wWtm2QdceRg-1; Mon, 28 Jun 2021 07:30:54 -0400 X-MC-Unique: WP0kcjU3Mq-wWtm2QdceRg-1 Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 6AF04100B3AD; Mon, 28 Jun 2021 11:30:52 +0000 (UTC) Received: from localhost.localdomain.com (ovpn-115-35.ams2.redhat.com [10.36.115.35]) by smtp.corp.redhat.com (Postfix) with ESMTP id D2A1560C5F; Mon, 28 Jun 2021 11:30:49 +0000 (UTC) From: =?utf-8?q?Daniel_P=2E_Berrang=C3=A9?= To: qemu-devel@nongnu.org Subject: [PATCH 0/4] docs: improve -smp documentation Date: Mon, 28 Jun 2021 12:30:43 +0100 Message-Id: <20210628113047.462498-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=berrange@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Received-SPF: pass client-ip=216.205.24.124; envelope-from=berrange@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -31 X-Spam_score: -3.2 X-Spam_bar: --- X-Spam_report: (-3.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.375, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Andrew Jones , =?utf-8?q?Daniel_P=2E_Berrang=C3=A9?= , Eduardo Habkost , Richard Henderson , "wangyanan \(Y\)" , Paolo Bonzini , Igor Mammedov Errors-To: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Sender: "Qemu-devel" This is a spin off from this thread: https://lists.gnu.org/archive/html/qemu-devel/2021-06/msg06135.html to improve the documentation of the current behaviour of -smp arg. In that thread it is suggested that we change the behaviour to prefer use of cores over sockets, when topology is omitted. This documentation update explicitly notes that default topology is liable to change, to allow for this enhancement. Daniel P. Berrangé (4): docs: fix typo s/Intel/AMD/ in CPU model notes qemu-options: re-arrange CPU topology options qemu-options: tweak to show that CPU count is optional qemu-options: rewrite help for -smp options docs/system/cpu-models-x86.rst.inc | 2 +- qemu-options.hx | 37 ++++++++++++++++++++---------- 2 files changed, 26 insertions(+), 13 deletions(-) Reviewed-by: Andrew Jones