From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org 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 smtp.lore.kernel.org (Postfix) with ESMTPS id 8A8E1C77B7C for ; Tue, 24 Jun 2025 17:54:24 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uU7qN-0002x4-6s; Tue, 24 Jun 2025 13:54: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 1uU7qJ-0002wl-GR for qemu-devel@nongnu.org; Tue, 24 Jun 2025 13:54:00 -0400 Received: from mail-pl1-x634.google.com ([2607:f8b0:4864:20::634]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1uU7qH-0002m0-7M for qemu-devel@nongnu.org; Tue, 24 Jun 2025 13:53:58 -0400 Received: by mail-pl1-x634.google.com with SMTP id d9443c01a7336-2363616a1a6so48632975ad.3 for ; Tue, 24 Jun 2025 10:53:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750787634; x=1751392434; darn=nongnu.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=LDtY3VYHW8ed7y/lzqSblD3MXgi/fhtDmtDUwDMMsfI=; b=cjLxR5TaUrY9pbnV4bitjSXfSEAgKfRqIjf/KZXuZVRI3ubACk1w1M2pQkZZMNVufr 5c30D8jjQAw2So70t4bHeLUEitr37yjvG4Fz7Wn3Ts+Q3QMNZknn7kDu2WX5XvJj5lRF XVg2+YBL6E7Wgbphl5yibgxmk+bPxWhoZRCXZSO8Ecih7sgRcI1fIzoES4fZoIQ7i0vw MBv99VLH75E6EyXnpC1tbou90Y1vOqi7T5ULmukLRnRXooTwLxfeV9P4Jfntb84lKu4w Bt2A4DEj55j7Xvovk8hM4N/NGz+IvVkO8Xi19a1dUYBo5qLzWGZLCMYdXYdR85smpAoM Ihfg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750787634; x=1751392434; 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=LDtY3VYHW8ed7y/lzqSblD3MXgi/fhtDmtDUwDMMsfI=; b=SQTaNBrw60xzs7oRtQEmir9FtYvn3EAcj7mjbei+SOcS4TL3v7+HO2Q55DhKr1DDe/ 7uFrGfDlp41qQotmW8bKZkqXV3ODYup2PvJtgUuj7y9idp5poqrTIpAlPMhjozDi5rF9 XNu4+T9X+Wt9vbp9DNJyC3J1NdEPNu1UG0wfHU85AWFBdthIUJGkAxvUeXyuUVYeNDC5 vtUQbHk4WwsRZY1g25tm3kA2UYANuYRY7zmA+Fq34gUProHw1nLK33R0Ar3tHWEK/f1d wlJfFFC6XIFTySsbkSSAanRVx17mRkG69GJ4BiYa7bNqrAFvD1gIpApJq5PUP1dtDJqI 3pcQ== X-Gm-Message-State: AOJu0Yw4knzmRORXstToy0wQP6ZzGyBpR8iZYyBhZRRMIozM3JTx3Ix4 JTesEOk5RQ1Fs4hxgQPKfa6eDjv49Kg50x+cPO0JUWBzJ5NGXr9voNOqFP7CPbD41Ug= X-Gm-Gg: ASbGncvS+44h24zzXXrMh6IxTeixEqh/V7hurE8Cu1b4T/1D7ngPX3tvrQ17FxYri/W lpaKS//T5FrUcu86eYMS+UYVwW05WZ2P20dM6/7hhSQnhe6uVQynHoj2y/rY07b3DmeEaUy2G96 LIMmv6dFI0v15Z/UDFVxuIZuTIFH/4yfJBEJDHFBXeey5Yyp4+Q1mhMjBAWyhRKLM5yqSscc+s+ NyC730KF4C7h1uq8aHIo8E6DFGNVxpS67siBJZxgPZOxPnOX/nBcgW9sJSwUcZiCmevtrRWH3ki z4pEDYFotYT3F67oIzJfwtMOH9fGq1uHcQRYNQP1Re3gJRNhiE1Q6t5Zd0XkDA== X-Google-Smtp-Source: AGHT+IFuTlGXVWrxHbbZkHbBhnIlJIwLuXZBCLIeHfqeIcCztKkQk7c28BS8j9pPETv7aBrejLnQiA== X-Received: by 2002:a17:902:f68f:b0:234:ed31:fc98 with SMTP id d9443c01a7336-2382406aaf8mr3137155ad.37.1750787634520; Tue, 24 Jun 2025 10:53:54 -0700 (PDT) Received: from shemhazi.lan ([50.46.174.34]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b31f12427b7sm9318153a12.40.2025.06.24.10.53.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 24 Jun 2025 10:53:54 -0700 (PDT) From: Rowan Hart To: qemu-devel@nongnu.org Cc: Pierrick Bouvier , Richard Henderson , Mahmoud Mandour , =?UTF-8?q?Alex=20Benn=C3=A9e?= , Paolo Bonzini , Marcel Apfelbaum , Yanan Wang , Alexandre Iooss , Eduardo Habkost , Zhao Liu , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Rowan Hart Subject: [PATCH v14 2/8] plugins: Add register write API Date: Tue, 24 Jun 2025 10:53:45 -0700 Message-ID: <20250624175351.440780-3-rowanbhart@gmail.com> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250624175351.440780-1-rowanbhart@gmail.com> References: <20250624175351.440780-1-rowanbhart@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2607:f8b0:4864:20::634; envelope-from=rowanbhart@gmail.com; helo=mail-pl1-x634.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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+qemu-devel=archiver.kernel.org@nongnu.org Sender: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org This patch adds a function to the plugins API to allow plugins to write register contents. It also moves the qemu_plugin_read_register function so all the register-related functions are grouped together in the file. Reviewed-by: Pierrick Bouvier Signed-off-by: Rowan Hart --- include/qemu/qemu-plugin.h | 54 ++++++++++++++++++++++++++------------ plugins/api.c | 26 +++++++++++++----- 2 files changed, 56 insertions(+), 24 deletions(-) diff --git a/include/qemu/qemu-plugin.h b/include/qemu/qemu-plugin.h index 3a850aa216..cfe1692ecb 100644 --- a/include/qemu/qemu-plugin.h +++ b/include/qemu/qemu-plugin.h @@ -871,7 +871,8 @@ struct qemu_plugin_register; /** * typedef qemu_plugin_reg_descriptor - register descriptions * - * @handle: opaque handle for retrieving value with qemu_plugin_read_register + * @handle: opaque handle for retrieving value with qemu_plugin_read_register or + * writing value with qemu_plugin_write_register * @name: register name * @feature: optional feature descriptor, can be NULL */ @@ -893,6 +894,41 @@ typedef struct { QEMU_PLUGIN_API GArray *qemu_plugin_get_registers(void); +/** + * qemu_plugin_read_register() - read register for current vCPU + * + * @handle: a @qemu_plugin_reg_handle handle + * @buf: A GByteArray for the data owned by the plugin + * + * This function is only available in a context that register read access is + * explicitly requested via the QEMU_PLUGIN_CB_R_REGS flag. + * + * Returns the size of the read register. The content of @buf is in target byte + * order. On failure returns -1. + */ +QEMU_PLUGIN_API +int qemu_plugin_read_register(struct qemu_plugin_register *handle, + GByteArray *buf); + +/** + * qemu_plugin_write_register() - write register for current vCPU + * + * @handle: a @qemu_plugin_reg_handle handle + * @buf: A GByteArray for the data owned by the plugin + * + * This function is only available in a context that register write access is + * explicitly requested via the QEMU_PLUGIN_CB_RW_REGS flag. + * + * The size of @buf must be at least the size of the requested register. + * Attempting to write a register with @buf smaller than the register size + * will result in a crash or other undesired behavior. + * + * Returns the number of bytes written. On failure returns 0. + */ +QEMU_PLUGIN_API +int qemu_plugin_write_register(struct qemu_plugin_register *handle, + GByteArray *buf); + /** * qemu_plugin_read_memory_vaddr() - read from memory using a virtual address * @@ -915,22 +951,6 @@ QEMU_PLUGIN_API bool qemu_plugin_read_memory_vaddr(uint64_t addr, GByteArray *data, size_t len); -/** - * qemu_plugin_read_register() - read register for current vCPU - * - * @handle: a @qemu_plugin_reg_handle handle - * @buf: A GByteArray for the data owned by the plugin - * - * This function is only available in a context that register read access is - * explicitly requested via the QEMU_PLUGIN_CB_R_REGS flag. - * - * Returns the size of the read register. The content of @buf is in target byte - * order. On failure returns -1. - */ -QEMU_PLUGIN_API -int qemu_plugin_read_register(struct qemu_plugin_register *handle, - GByteArray *buf); - /** * qemu_plugin_scoreboard_new() - alloc a new scoreboard * diff --git a/plugins/api.c b/plugins/api.c index 3c9d4832e9..6514f2c76a 100644 --- a/plugins/api.c +++ b/plugins/api.c @@ -433,6 +433,25 @@ GArray *qemu_plugin_get_registers(void) return create_register_handles(regs); } +int qemu_plugin_read_register(struct qemu_plugin_register *reg, GByteArray *buf) +{ + g_assert(current_cpu); + + return gdb_read_register(current_cpu, buf, GPOINTER_TO_INT(reg) - 1); +} + +int qemu_plugin_write_register(struct qemu_plugin_register *reg, + GByteArray *buf) +{ + g_assert(current_cpu); + + if (buf->len == 0 || qemu_plugin_get_cb_flags() != QEMU_PLUGIN_CB_RW_REGS) { + return -1; + } + + return gdb_write_register(current_cpu, buf->data, GPOINTER_TO_INT(reg) - 1); +} + bool qemu_plugin_read_memory_vaddr(uint64_t addr, GByteArray *data, size_t len) { g_assert(current_cpu); @@ -453,13 +472,6 @@ bool qemu_plugin_read_memory_vaddr(uint64_t addr, GByteArray *data, size_t len) return true; } -int qemu_plugin_read_register(struct qemu_plugin_register *reg, GByteArray *buf) -{ - g_assert(current_cpu); - - return gdb_read_register(current_cpu, buf, GPOINTER_TO_INT(reg) - 1); -} - struct qemu_plugin_scoreboard *qemu_plugin_scoreboard_new(size_t element_size) { return plugin_scoreboard_new(element_size); -- 2.49.0