From patchwork Mon Dec 18 18:44:28 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Henrique Barboza X-Patchwork-Id: 850352 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=nongnu.org (client-ip=2001:4830:134:3::11; helo=lists.gnu.org; envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org; receiver=) Received: from lists.gnu.org (lists.gnu.org [IPv6:2001:4830:134:3::11]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3z0r200B55z9s1h for ; Tue, 19 Dec 2017 05:59:52 +1100 (AEDT) Received: from localhost ([::1]:55168 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eR0di-00019b-3w for incoming@patchwork.ozlabs.org; Mon, 18 Dec 2017 13:59:50 -0500 Received: from eggs.gnu.org ([208.118.235.92]:33566) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eR0PH-00022n-Kz for qemu-devel@nongnu.org; Mon, 18 Dec 2017 13:44:57 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eR0PD-0008Qz-F3 for qemu-devel@nongnu.org; Mon, 18 Dec 2017 13:44:55 -0500 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:56544) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eR0PD-0008PL-6x for qemu-devel@nongnu.org; Mon, 18 Dec 2017 13:44:51 -0500 Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.21/8.16.0.21) with SMTP id vBIIgYQr053124 for ; Mon, 18 Dec 2017 13:44:47 -0500 Received: from e15.ny.us.ibm.com (e15.ny.us.ibm.com [129.33.205.205]) by mx0a-001b2d01.pphosted.com with ESMTP id 2exhuk3snu-1 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=NOT) for ; Mon, 18 Dec 2017 13:44:46 -0500 Received: from localhost by e15.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Mon, 18 Dec 2017 13:44:45 -0500 Received: from b01cxnp22036.gho.pok.ibm.com (9.57.198.26) by e15.ny.us.ibm.com (146.89.104.202) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; Mon, 18 Dec 2017 13:44:42 -0500 Received: from b01ledav006.gho.pok.ibm.com (b01ledav006.gho.pok.ibm.com [9.57.199.111]) by b01cxnp22036.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id vBIIifWp49807364; Mon, 18 Dec 2017 18:44:41 GMT Received: from b01ledav006.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id C9A2BAC03F; Mon, 18 Dec 2017 13:45:45 -0500 (EST) Received: from localhost.localdomain (unknown [9.85.173.152]) by b01ledav006.gho.pok.ibm.com (Postfix) with ESMTP id 9426CAC03A; Mon, 18 Dec 2017 13:45:44 -0500 (EST) From: Daniel Henrique Barboza To: qemu-devel@nongnu.org Date: Mon, 18 Dec 2017 16:44:28 -0200 X-Mailer: git-send-email 2.13.6 In-Reply-To: <20171218184428.15074-1-danielhb@linux.vnet.ibm.com> References: <20171218184428.15074-1-danielhb@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 17121818-0036-0000-0000-0000029D676E X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00008223; HX=3.00000241; KW=3.00000007; PH=3.00000004; SC=3.00000244; SDB=6.00962122; UDB=6.00486632; IPR=6.00742117; BA=6.00005750; NDR=6.00000001; ZLA=6.00000005; ZF=6.00000009; ZB=6.00000000; ZP=6.00000000; ZH=6.00000000; ZU=6.00000002; MB=3.00018609; XFM=3.00000015; UTC=2017-12-18 18:44:43 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 17121818-0037-0000-0000-000042B44D8B Message-Id: <20171218184428.15074-2-danielhb@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:, , definitions=2017-12-18_14:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 impostorscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1709140000 definitions=main-1712180247 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-Received-From: 148.163.156.1 Subject: [Qemu-devel] [PATCH v2 1/1] qmp: marking qmp_cpu as deprecated X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Daniel Henrique Barboza , armbru@redhat.com Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: "Qemu-devel" qmp_cpu is a nop that was created a while ago in commit 755f196898 ("qapi: Convert the cpu command") for the sake of compatibility, due to the existence of hmp_cpu. Today, there is no need or requirement to keep it as is. QMP is meant to be as stateless as possible, thus any QMP command that needs a specific monitor CPU setup should provide it in its arguments, instead of relying in the current QMP monitor state. This patch flags qmp_cpu as deprecated in qemu-doc.texi, qapi-schema.json and changes qmp_cpu body to show a deprecation message if used. Signed-off-by: Daniel Henrique Barboza Reviewed-by: Daniel P. Berrange --- qapi-schema.json | 5 ++++- qemu-doc.texi | 10 ++++++++++ qmp.c | 2 +- 3 files changed, 15 insertions(+), 2 deletions(-) diff --git a/qapi-schema.json b/qapi-schema.json index 18457954a8..b51b89e19b 100644 --- a/qapi-schema.json +++ b/qapi-schema.json @@ -1052,7 +1052,10 @@ # # Since: 0.14.0 # -# Notes: Do not use this command. +# Notes: Do not use this command. It was deprecated in release 2.12.0 and will +# be removed, with no replacement, at any time in the future. QMP +# commands that rely on the current CPU monitor should specify it as a +# parameter. ## { 'command': 'cpu', 'data': {'index': 'int'} } diff --git a/qemu-doc.texi b/qemu-doc.texi index f7317dfc66..09e6c5046a 100644 --- a/qemu-doc.texi +++ b/qemu-doc.texi @@ -2516,6 +2516,16 @@ subsystem image. The ``convert -s snapshot_id_or_name'' argument is obsoleted by the ``convert -l snapshot_param'' argument instead. +@section System emulator machine protocol commands + +@subsection qmp_cpu (since 2.12.0) + +The ``qmp_cpu'' command was implemented in release 0.14.0 as a functional +no-op, remaining as such up to release 2.12.0 when it was deprecated and +flagged for future removal. No replacement will be provided: any QMP command +that uses the current CPU monitor should, instead, specify the CPU in its +parameters. + @section System emulator human monitor commands @subsection host_net_add (since 2.10.0) diff --git a/qmp.c b/qmp.c index e8c303116a..d8543d713d 100644 --- a/qmp.c +++ b/qmp.c @@ -115,7 +115,7 @@ void qmp_system_powerdown(Error **erp) void qmp_cpu(int64_t index, Error **errp) { - /* Just do nothing */ + error_setg(errp, "qmp_cpu is deprecated, do not use this command"); } void qmp_cpu_add(int64_t id, Error **errp)