From patchwork Fri Jun 20 17:13:18 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Philippe_Mathieu-Daud=C3=A9?= X-Patchwork-Id: 898338 Delivered-To: patch@linaro.org Received: by 2002:a5d:5f54:0:b0:3a4:ee3f:8f15 with SMTP id cm20csp1452404wrb; Fri, 20 Jun 2025 10:16:51 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCW8Sjd0yHBELQXwN9XM6ZRkKORp8W63LFn2qAxXi0S3i+sBblDNwhgSpJBmLuh0/Nyt1NsLrg==@linaro.org X-Google-Smtp-Source: AGHT+IG3+ISBhJyqxg/5knlYWR3u94NVi0lShCmANHv5/FZzamruGoMfbnILJX0t7gboU2Nkw19g X-Received: by 2002:ac8:6602:0:b0:4a7:1402:cce9 with SMTP id d75a77b69052e-4a781c9cb07mr10759611cf.7.1750439811174; Fri, 20 Jun 2025 10:16:51 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1750439811; cv=none; d=google.com; s=arc-20240605; b=lyiLwFr+GYCKYpXEU7p5hFLxVJ9xaSKr/ujZ1RDTJdfYTQXR+M5VO+t2N5MJeDpZpo T0ULRaA2UEdrtnLBLp8C0aJLw9val0aHMGUc4gU7o3FVI6rIB/3fDWdVQy8XK1GcGVcM 19TpA84WpW6upGs3SoPGoBf1jyuVoiV8h3vXUI4Nx9Y9CeafUi/3ZMaZvf44Ad+Prv64 GyDq/YvIAK9iUB3qfgBXlRmsaYdppwzGOZd6Uw3SYtXxggEbAV2siOR/ZgTq1Y6XBtqN oI00015ukzC4lkfJui4r9I7PRuTN2B+Zig5pL3Pu1Rui7wBC9GXEdJ0yxfXaCcrKqtTB JI5A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:dkim-signature; bh=7h4sfO68wbzpruBkUxQWCgRm12x3C8WvrPovqJx+6vY=; fh=8f2AL0Su0K9UlZksY2EEcc9O+An+AQ/T/SEdbs2pdSA=; b=OQxSRoESi+8e8+rkSmHAzRhRgh9HLjoL0XldFgiVCdoYgKLWzLjnP9qQN025l547DC Z5ayEsOCBja3g5ys49ITeZheV0t1NNDlNW8MZz7rO2BAk5zjIHEUl2sMc61yJ7+4NP5T H2RGtnJwxX37dtFNpsT2Q9K6uoMME2eajv/Y/rjVdui0iIVkCkSF0Cvc6YY5WkyyQfrM YkQclaFNR+Dq5oJnVf2VJz92nASvTSK+lVpQcuaYEzgszBzB/Uji8GGIZk28eSPBmYQ+ SoM3K7y5K00XsxZjNjArmdL3a4F7M778+gzEZeG/BRJt/oTWZ2tzTBRhSDPwzSCv5yqC 9QoA==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=JiXpMKIN; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org; dara=neutral header.i=@linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id d75a77b69052e-4a77a0eba12si20528671cf.648.2025.06.20.10.16.51 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Fri, 20 Jun 2025 10:16:51 -0700 (PDT) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=JiXpMKIN; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org; dara=neutral header.i=@linaro.org Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uSfLo-000314-2d; Fri, 20 Jun 2025 13:16:29 -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 1uSfLB-00025q-2k for qemu-devel@nongnu.org; Fri, 20 Jun 2025 13:15:50 -0400 Received: from mail-wm1-x331.google.com ([2a00:1450:4864:20::331]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1uSfL9-0004YJ-CF for qemu-devel@nongnu.org; Fri, 20 Jun 2025 13:15:48 -0400 Received: by mail-wm1-x331.google.com with SMTP id 5b1f17b1804b1-451d3f72391so19850935e9.3 for ; Fri, 20 Jun 2025 10:15:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1750439745; x=1751044545; 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=7h4sfO68wbzpruBkUxQWCgRm12x3C8WvrPovqJx+6vY=; b=JiXpMKINmWi2zglSVTBeDViCjBwzTsWXyxltcTkhkz1+IZaMmF9wli5tPNh3GG2nOf HpXS0zLVULsDMyHYjAbffNtntnke3rbfeq0QNEW4QNPxL2VdhTVgZevev+rc22z0hN1s X93HfCL2azT0pwO7uEtQapHwc1OvFmJmT7LogRsumbMRuGj65B7VqcERfi7V3iRgumBI WmHYgBmy5jeu8t357w8zqp9e4yV7CaflpP0XLRz2f52gVwzHYd8Kf8rZiStUchvF3aGi ZayJngL/rto/PzZ7wgD+uWXWd5pLr9OKa5fLHutgSE3ETeXiUKxaBBycEl4QpN+DqcTv 6FvQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750439745; x=1751044545; 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=7h4sfO68wbzpruBkUxQWCgRm12x3C8WvrPovqJx+6vY=; b=gxDlQTUms9qnUKzRSp++DKZKtYpGms9mC4Q4NA/Qd6GbMYFHkr/QvMmUK5btXkgd3Z swRlSN+z2N8WVrDgPsfGLEbi3h3sdiQttWFqWjdq89cHkey87GoqM6TEkAc9mffN9NQG /wA5QnM8Qr+nZ+Z2KhWUgbO6rxkA/RxoeEPv+ViB2fyOs8ajw8/e7C8I/ZrF7VQwx2Ag a2Ip4pACIphR6nYRfQTwG2pk/wTg2wEtmjI8Oz2efv8jnXL+dkXaDKuXyj2/q/G15Sy8 SerKlibxiQcW+odXMW+a/9J4GHplQ5JDEHycl9cBufXrmM4cWekO7uGvAmW+q23nw0lH otVg== X-Gm-Message-State: AOJu0Yz9UMoaSHKhJ925tXoAojNZtT0ezaGdDaLN+khREfqAH1bacmvV 9Mz0Yj4wsItBUhrfYrSQ2O6Sbd8AhmBwcyXJK1Gm8axeooU4jHm4UbZyDUShH3zanLB2wMUMJjq r4TBFThw= X-Gm-Gg: ASbGncuU1CDB8CJXHM1CUxJwA3X9VCqZ2FB0QzLvbAvsL9yuHmBdGg2Y5k3jF9d9OfN 1H0WVxVJBEilIqMCBlsJeneNwc1nD6IEqQzuZ4/TwUHgVHkxiGab6bqT4ll9mzLBspfFzAbEcor No9qcvFsOD6C1YzWalpft902IB2C79zBxYsp4MD6W5l9FX16JHdrx3thTmeCif4II7gi5Myq5hb ogkMo+nuQIY31WuTOtbAN1byLTDTlGj8gd1t/CMjIi/N5A5sjSEoHFAQGEdm4mTinVjLwaAXP3j M2QLE0Nje5jIkqdN+bwZkZ2ZL6SeICXhpyyj0tApVCujZUbfFfHR5xUf7mAFX9Jj9kTxKJzVq5n GA/F7FaepScx3Y2Fq0HTrrHia/xkaHiSbkGOl X-Received: by 2002:a05:600c:c10d:b0:43c:f87c:24ce with SMTP id 5b1f17b1804b1-4536877ffb5mr13683025e9.21.1750439745343; Fri, 20 Jun 2025 10:15:45 -0700 (PDT) Received: from localhost.localdomain (88-187-86-199.subs.proxad.net. [88.187.86.199]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3a6d0f104f6sm2675848f8f.12.2025.06.20.10.15.44 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Fri, 20 Jun 2025 10:15:44 -0700 (PDT) From: =?utf-8?q?Philippe_Mathieu-Daud=C3=A9?= To: qemu-devel@nongnu.org Cc: =?utf-8?q?Alex_Benn=C3=A9e?= , Alexander Graf , Richard Henderson , Pierrick Bouvier , Peter Maydell , Thomas Huth , Cameron Esfahani , Julian Armistead , Paolo Bonzini , "Edgar E. Iglesias" , =?utf-8?q?Philippe_Mathieu-?= =?utf-8?q?Daud=C3=A9?= Subject: [RFC PATCH v2 25/48] accel/system: Document cpu_synchronize_state() Date: Fri, 20 Jun 2025 19:13:18 +0200 Message-ID: <20250620171342.92678-26-philmd@linaro.org> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250620171342.92678-1-philmd@linaro.org> References: <20250620171342.92678-1-philmd@linaro.org> MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::331; envelope-from=philmd@linaro.org; helo=mail-wm1-x331.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, 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+patch=linaro.org@nongnu.org Sender: qemu-devel-bounces+patch=linaro.org@nongnu.org Signed-off-by: Philippe Mathieu-Daudé Reviewed-by: Richard Henderson --- include/system/accel-ops.h | 8 ++++++++ include/system/hw_accel.h | 13 +++++++++++-- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/include/system/accel-ops.h b/include/system/accel-ops.h index 5c5171ea5b5..f40098c1c92 100644 --- a/include/system/accel-ops.h +++ b/include/system/accel-ops.h @@ -45,6 +45,14 @@ struct AccelOpsClass { void (*synchronize_post_reset)(CPUState *cpu); void (*synchronize_post_init)(CPUState *cpu); + /** + * synchronize_state: + * synchronize_pre_loadvm: + * @cpu: The vCPU to synchronize. + * + * Request to synchronize QEMU vCPU registers from the hardware accelerator + * (the hardware accelerator is the reference). + */ void (*synchronize_state)(CPUState *cpu); void (*synchronize_pre_loadvm)(CPUState *cpu); void (*synchronize_pre_resume)(bool step_pending); diff --git a/include/system/hw_accel.h b/include/system/hw_accel.h index 380e9e640b6..574c9738408 100644 --- a/include/system/hw_accel.h +++ b/include/system/hw_accel.h @@ -17,9 +17,18 @@ #include "system/whpx.h" #include "system/nvmm.h" +/** + * cpu_synchronize_state: + * cpu_synchronize_pre_loadvm: + * @cpu: The vCPU to synchronize. + * + * Request to synchronize QEMU vCPU registers from the hardware accelerator + * (the hardware accelerator is the reference). + */ void cpu_synchronize_state(CPUState *cpu); -void cpu_synchronize_post_reset(CPUState *cpu); -void cpu_synchronize_post_init(CPUState *cpu); void cpu_synchronize_pre_loadvm(CPUState *cpu); +void cpu_synchronize_post_reset(CPUState *cpu); +void cpu_synchronize_post_init(CPUState *cpu); + #endif /* QEMU_HW_ACCEL_H */