]> xenbits.xensource.com Git - people/aperard/qemu-dm.git/commit
rust: qom: add casting functionality
authorPaolo Bonzini <pbonzini@redhat.com>
Thu, 19 Dec 2024 13:32:16 +0000 (14:32 +0100)
committerPaolo Bonzini <pbonzini@redhat.com>
Thu, 19 Dec 2024 18:36:37 +0000 (19:36 +0100)
commitf50cd85c8475c16374d0e138efda222ce4455f53
tree667e354e3b92f81fa5c74b48da35c74382b96c49
parentc2f41c1b152bfe9aa72bbdf413c11c5ae9209f30
rust: qom: add casting functionality

Add traits that let client cast typecast safely between object types.
In particular, an upcast is compile-time guaranteed to succeed, and a
YOLO C-style downcast must be marked as unsafe.

The traits are based on an IsA<> trait that declares what
is a subclass of what, which is an idea taken from glib-rs
(https://docs.rs/glib/latest/glib/object/trait.IsA.html).
The four primitives are also taken from there
(https://docs.rs/glib/latest/glib/object/trait.Cast.html).  However,
the implementation of casting itself is a bit different and uses the
Deref trait.

This removes some pointer arithmetic from the pl011 device; it is also a
prerequisite for the definition of methods, so that they can be invoked
on all subclass structs.  This will use the IsA<> trait to detect the
structs that support the methods.

glib also has a "monadic" casting trait which could be implemented on
Option (as in https://docs.rs/glib/latest/glib/object/trait.CastNone.html)
and perhaps even Result.  For now I'm leaving it out, as the patch is
already big enough and the benefit seems debatable.

Reviewed-by: Zhao Liu <zhao1.liu@intel.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
rust/Cargo.toml
rust/hw/char/pl011/src/device.rs
rust/qemu-api/src/prelude.rs
rust/qemu-api/src/qdev.rs
rust/qemu-api/src/qom.rs
rust/qemu-api/src/sysbus.rs
rust/qemu-api/tests/tests.rs