From nobody Sat Nov 15 22:32:03 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1747739310; cv=none; d=zohomail.com; s=zohoarc; b=OYw/tiQGZDvjIWOf92o2NtOspA0BLPd3IIFq1Thk2YgDyQG2QF68O42ox6oxWoydfqmEPtp2lwurCIePyFcMGy75bTYS10ewXgA76C2hXILyYWW6TVaxLPuNIX8bi4ZECq9dc/34yjrFL4rRb+SkJDFph2GYJwgNlQW3F1u69Ek= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1747739310; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=1mgYSHkWd+aIUzWuoObJiO8RMau0iMJObXQde7QL4iU=; b=VFnxhB5WykR8iKf461bFJfbo6UCOluUlDgfAtX2TgCxgkVKv0fs3Ip+3wW4YHvlrNtRTOadA2A3PrnWaLTgVYmMoxwfpbzEE6enbGIyOj+OPANod99vgqy67EMFfareD4CrFnNq7xvkJ9JBySrFCYG6oD6PtthFmO0z/0UuqtqQ= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1747739310181894.9869811298009; Tue, 20 May 2025 04:08:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uHKnN-0007RX-K0; Tue, 20 May 2025 07:06:05 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uHKnD-0007JH-KY for qemu-devel@nongnu.org; Tue, 20 May 2025 07:05:56 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uHKnB-00032Q-IW for qemu-devel@nongnu.org; Tue, 20 May 2025 07:05:55 -0400 Received: from mail-ej1-f72.google.com (mail-ej1-f72.google.com [209.85.218.72]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-258-cgbp4UobNWOKmtDlkXKfVw-1; Tue, 20 May 2025 07:05:50 -0400 Received: by mail-ej1-f72.google.com with SMTP id a640c23a62f3a-acb8f9f58ebso439027566b.2 for ; Tue, 20 May 2025 04:05:50 -0700 (PDT) Received: from [192.168.122.1] ([151.95.46.79]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-ad52d277a2esm715706866b.83.2025.05.20.04.05.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 20 May 2025 04:05:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1747739152; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=1mgYSHkWd+aIUzWuoObJiO8RMau0iMJObXQde7QL4iU=; b=hzZC52NMisCOiiqbLfVCoc4WvdvlJca/rUDLu36MUqR9RrjDDBkrpXzwXu21ijKxLp3tlS M4Jbs43I/fF7OSTABglCiEaZ1W2Am3nTB+1QBtkHduxztGsIr3RnHQuZhY/qxepTiMwZMI q9rWon8Hts8iEoxf4maoqesJCeYH9TI= X-MC-Unique: cgbp4UobNWOKmtDlkXKfVw-1 X-Mimecast-MFC-AGG-ID: cgbp4UobNWOKmtDlkXKfVw_1747739149 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1747739149; x=1748343949; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=1mgYSHkWd+aIUzWuoObJiO8RMau0iMJObXQde7QL4iU=; b=V/Czw8Rin2kgCKRmJKRqVhZthNfXxwar6Wzip4r+OnKXtjCQLQZIwaNPEbL+OulO+o dMKO4c7NWxPZ9YziURVEb5Jdzf6WnOIJEyz9Y0eL1k5+qolv8HIVoteW+IUNK2nOhDP0 pGDcD6GBrni7Egyrujz00g1jsPAPw/N7xpxEKf2aD9Fy5vZOTEmLlEQ3Jf0vxd3OcXJa NoglAguAhKwo5L1LaKgcDZgpGdhyHKWW1WWq7pomg8delGKNfMO+V2/5OsjjUAzPfiNi mua66QL5Qyk9ciFfnbU+vi09XLY/I/lCyG2r4V5D5pa1oOFLMCgOVSEex1D1b1ogh+HI eU4w== X-Gm-Message-State: AOJu0YwNarBwX2cs82HnPUCMV2yUXrD/83W49ucduZJfOCv9h/T8lz8/ YDXg/zGnrEfuqHgzBm1eBWw+emhGFKTjSUHmK984p/FseWYJUk5IQqbzL727kCt433AS31d4JUn ja5AyDSDTqUJoKwrILFpOHTImPj9kJawFuLbVcTRcYWxmx7Y85KbzqaiGZQoXhz41QphrW8vflK tloI0Lg2h3QKLO0Xx77aYlbKf7N8l2jlPDfHNrIhy8 X-Gm-Gg: ASbGncufSY7qt1U3+beBAubSWBa/msR3hqt4I/MCLW6gfRNbzhBpxStpbLj2uha2onS y6CaQf3OoSsNsP/YB3Fe1qALmf5WD5I+zTyRonNLSdYgUgq5TJHBIXq1wGWIP4oYBGN7mjlN6eH s7yRo25fLcvyPk6XuEJDcl+oI/eKXTzFnQFr1+tq5/Gpu7DSuFMfXtsaDvy7oobg5UGy4Fg8L4H /bIfOS+PNKybEz8actOLv6ALYFX870dXra55+1OVD9r/w0qYeTTwOjIT5gfaEE2yaQqDa/+EZKc s+3N1zYUHUvHuQ== X-Received: by 2002:a17:907:970b:b0:ad5:2bb1:8c85 with SMTP id a640c23a62f3a-ad52d511cd9mr1489706166b.29.1747739148728; Tue, 20 May 2025 04:05:48 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFwXGUSHs2/AQdu/ppolwpUvhDLe9nNqzyOxCKgqmwQ0A8DP7eC2uUz92OaD3mJfnI7w4O+Lw== X-Received: by 2002:a17:907:970b:b0:ad5:2bb1:8c85 with SMTP id a640c23a62f3a-ad52d511cd9mr1489702366b.29.1747739148218; Tue, 20 May 2025 04:05:48 -0700 (PDT) From: Paolo Bonzini To: qemu-devel@nongnu.org Cc: Zhao Liu , Markus Armbruster Subject: [PULL 08/35] qapi/misc-target: Fix the doc to distinguish query-sgx and query-sgx-capabilities Date: Tue, 20 May 2025 13:05:03 +0200 Message-ID: <20250520110530.366202-9-pbonzini@redhat.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250520110530.366202-1-pbonzini@redhat.com> References: <20250520110530.366202-1-pbonzini@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=pbonzini@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.487, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=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.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1747739312371116600 Content-Type: text/plain; charset="utf-8" From: Zhao Liu There're 2 QMP commands: query-sgx and query-sgx-capabilities, but their outputs are very similar and the documentation lacks clear differentiation. From the codes, query-sgx is used to gather guest's SGX capabilities (including SGX related CPUIDs and EPC sections' size, in SGXInfo), and if guest doesn't have SGX, then QEMU will report the error message. On the other hand, query-sgx-capabilities is used to gather host's SGX capabilities (descripted by SGXInfo as well). And if host doesn't support SGX, then QEMU will also report the error message. Considering that SGXInfo is already documented and both these 2 commands have enough error messages (for the exception case in their codes). Therefore the QAPI documentation for these two commands only needs to emphasize that one of them applies to the guest and the other to the host. Fix their documentation to reflect this difference. Reported-by: Markus Armbruster Suggested-by: Paolo Bonzini Signed-off-by: Zhao Liu Acked-by: Markus Armbruster Link: https://lore.kernel.org/r/20250513143131.2008078-3-zhao1.liu@intel.com Signed-off-by: Paolo Bonzini --- qapi/misc-target.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/qapi/misc-target.json b/qapi/misc-target.json index 6814708972d..f7ec695caad 100644 --- a/qapi/misc-target.json +++ b/qapi/misc-target.json @@ -361,7 +361,7 @@ ## # @query-sgx: # -# Returns information about SGX +# Returns information about configured SGX capabilities of guest # # Returns: @SgxInfo # @@ -380,7 +380,7 @@ ## # @query-sgx-capabilities: # -# Returns information from host SGX capabilities +# Returns information about SGX capabilities of host # # Returns: @SgxInfo # --=20 2.49.0