From: Alex Bennée <alex.bennee@linaro.org>
Date: Fri, 30 Jun 2023 18:04:08 +0000 (+0100)
Subject: include/migration: mark vmstate_register() as a legacy function
X-Git-Tag: v8.1.0-rc0~29^2~15
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=6caf1571a97f38b2c14eca855941a0455b461041;p=thirdparty%2Fqemu.git

include/migration: mark vmstate_register() as a legacy function

Mention that QOM-ified devices already have support for registering
the description.

Reviewed-by: Juan Quintela <quintela@redhat.com>
Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Acked-by: Peter Xu <peterx@redhat.com>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Message-Id: <20230630180423.558337-24-alex.bennee@linaro.org>
---

diff --git a/include/migration/vmstate.h b/include/migration/vmstate.h
index 084f5e784a3..d1b8abe08dd 100644
--- a/include/migration/vmstate.h
+++ b/include/migration/vmstate.h
@@ -1209,7 +1209,15 @@ int vmstate_register_with_alias_id(VMStateIf *obj, uint32_t instance_id,
                                    int required_for_version,
                                    Error **errp);
 
-/* Returns: 0 on success, -1 on failure */
+/**
+ * vmstate_register() - legacy function to register state
+ * serialisation description
+ *
+ * New code shouldn't be using this function as QOM-ified devices have
+ * dc->vmsd to store the serialisation description.
+ *
+ * Returns: 0 on success, -1 on failure
+ */
 static inline int vmstate_register(VMStateIf *obj, int instance_id,
                                    const VMStateDescription *vmsd,
                                    void *opaque)