From a05439097f7c188d27f58241b8621b2132a780e1 Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Tue, 27 Jan 2026 15:25:08 +0000 Subject: [PATCH] docs: Add a diagram for the internals of sysupdate I had to sketch this out before I could get the internals of systemd-sysupdate straight in my head, particularly around how an `UpdateSet` points to one `Instance` from each of a set of `Resource`s, and those `Instance`s are either all sources or all targets. Hopefully this is useful to the next person to look at the code. Signed-off-by: Philip Withnall --- docs/sysupdate-objects.svg | 851 +++++++++++++++++++++++++++++++++++++ 1 file changed, 851 insertions(+) create mode 100644 docs/sysupdate-objects.svg diff --git a/docs/sysupdate-objects.svg b/docs/sysupdate-objects.svg new file mode 100644 index 0000000000..884cb65138 --- /dev/null +++ b/docs/sysupdate-objects.svg @@ -0,0 +1,851 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Instance + + pattern + + + + + Instance + + pattern + + + + + Instance + + pattern + + ⋮ + Resource + Partially loaded from .transfer file + + + + + + Instance + + pattern + + + + + Instance + + pattern + + + + + Instance + + pattern + + ⋮ + Resource + Partially loaded from .transfer file + + + Loaded from .transfer file + Transfer + source + target + + + + + Set of Instances taken from acrossall Transfers, matching a certainversion; either all source Instancesor all target Instances.For example: verity, root FS,and kernel boot image + UpdateSet + + + + + + + ⋮ + + + + + ⋮ + + + + + + + + + + ⋮ + + + + + ⋮ + + + + + + + + +