/src/fwupd/libfwupdplugin/fu-linear-firmware.c
Line | Count | Source |
1 | | /* |
2 | | * Copyright 2022 Richard Hughes <richard@hughsie.com> |
3 | | * |
4 | | * SPDX-License-Identifier: LGPL-2.1-or-later |
5 | | */ |
6 | | |
7 | | #include "config.h" |
8 | | |
9 | | #include "fu-byte-array.h" |
10 | | #include "fu-bytes.h" |
11 | | #include "fu-common.h" |
12 | | #include "fu-input-stream.h" |
13 | | #include "fu-linear-firmware.h" |
14 | | #include "fu-partial-input-stream.h" |
15 | | |
16 | | /** |
17 | | * FuLinearFirmware: |
18 | | * |
19 | | * A firmware made up of concatenated blobs of a different firmware type. |
20 | | * |
21 | | * Parsed firmware images can set `FU_FIRMWARE_FLAG_IS_LAST_IMAGE` to abort processing. |
22 | | * |
23 | | * NOTE: All the child images will be of the specified `GType`. |
24 | | * |
25 | | * See also: [class@FuFirmware] |
26 | | */ |
27 | | |
28 | | typedef struct { |
29 | | GType image_gtype; |
30 | | } FuLinearFirmwarePrivate; |
31 | | |
32 | 9.54k | G_DEFINE_TYPE_WITH_PRIVATE(FuLinearFirmware, fu_linear_firmware, FU_TYPE_FIRMWARE) |
33 | 9.54k | #define GET_PRIVATE(o) (fu_linear_firmware_get_instance_private(o)) |
34 | | |
35 | | enum { PROP_0, PROP_IMAGE_GTYPE, PROP_LAST }; |
36 | | |
37 | | static void |
38 | | fu_linear_firmware_export(FuFirmware *firmware, FuFirmwareExportFlags flags, XbBuilderNode *bn) |
39 | 0 | { |
40 | 0 | FuLinearFirmware *self = FU_LINEAR_FIRMWARE(firmware); |
41 | 0 | FuLinearFirmwarePrivate *priv = GET_PRIVATE(self); |
42 | 0 | fu_xmlb_builder_insert_kv(bn, "image_gtype", g_type_name(priv->image_gtype)); |
43 | 0 | } |
44 | | |
45 | | /** |
46 | | * fu_linear_firmware_get_image_gtype: |
47 | | * @self: a #FuLinearFirmware |
48 | | * |
49 | | * Gets the image #GType to use when parsing a byte buffer. |
50 | | * |
51 | | * Returns: integer |
52 | | * |
53 | | * Since: 1.8.2 |
54 | | **/ |
55 | | GType |
56 | | fu_linear_firmware_get_image_gtype(FuLinearFirmware *self) |
57 | 0 | { |
58 | 0 | FuLinearFirmwarePrivate *priv = GET_PRIVATE(self); |
59 | 0 | g_return_val_if_fail(FU_IS_LINEAR_FIRMWARE(self), G_TYPE_INVALID); |
60 | 0 | return priv->image_gtype; |
61 | 0 | } |
62 | | |
63 | | static gboolean |
64 | | fu_linear_firmware_build(FuFirmware *firmware, XbNode *n, GError **error) |
65 | 0 | { |
66 | 0 | FuLinearFirmware *self = FU_LINEAR_FIRMWARE(firmware); |
67 | 0 | FuLinearFirmwarePrivate *priv = GET_PRIVATE(self); |
68 | 0 | const gchar *tmp; |
69 | | |
70 | | /* simple properties */ |
71 | 0 | tmp = xb_node_query_text(n, "image_gtype", NULL); |
72 | 0 | if (tmp != NULL) { |
73 | 0 | priv->image_gtype = g_type_from_name(tmp); |
74 | 0 | if (priv->image_gtype == G_TYPE_INVALID) { |
75 | 0 | g_set_error(error, |
76 | 0 | FWUPD_ERROR, |
77 | 0 | FWUPD_ERROR_NOT_FOUND, |
78 | 0 | "GType %s not registered", |
79 | 0 | tmp); |
80 | 0 | return FALSE; |
81 | 0 | } |
82 | 0 | fu_firmware_add_image_gtype(firmware, priv->image_gtype); |
83 | 0 | } |
84 | | |
85 | | /* success */ |
86 | 0 | return TRUE; |
87 | 0 | } |
88 | | |
89 | | static gboolean |
90 | | fu_linear_firmware_parse(FuFirmware *firmware, |
91 | | GInputStream *stream, |
92 | | FuFirmwareParseFlags flags, |
93 | | GError **error) |
94 | 3.17k | { |
95 | 3.17k | FuLinearFirmware *self = FU_LINEAR_FIRMWARE(firmware); |
96 | 3.17k | FuLinearFirmwarePrivate *priv = GET_PRIVATE(self); |
97 | 3.17k | gsize offset = 0; |
98 | 3.17k | gsize streamsz = 0; |
99 | | |
100 | 3.17k | if (!fu_input_stream_size(stream, &streamsz, error)) |
101 | 0 | return FALSE; |
102 | 3.31k | while (offset < streamsz) { |
103 | 3.31k | g_autoptr(FuFirmware) img = g_object_new(priv->image_gtype, NULL); |
104 | 3.31k | g_autoptr(GInputStream) stream_tmp = NULL; |
105 | | |
106 | 3.31k | stream_tmp = fu_partial_input_stream_new(stream, offset, streamsz - offset, error); |
107 | 3.31k | if (stream_tmp == NULL) { |
108 | 0 | g_prefix_error_literal(error, "failed to cut linear image: "); |
109 | 0 | return FALSE; |
110 | 0 | } |
111 | 3.31k | if (!fu_firmware_parse_stream(img, |
112 | 3.31k | stream_tmp, |
113 | 3.31k | 0x0, |
114 | 3.31k | flags | FU_FIRMWARE_PARSE_FLAG_NO_SEARCH, |
115 | 3.31k | error)) { |
116 | 3.17k | g_prefix_error(error, "failed to parse at 0x%x: ", (guint)offset); |
117 | 3.17k | return FALSE; |
118 | 3.17k | } |
119 | 146 | fu_firmware_set_offset(img, offset); |
120 | 146 | if (!fu_firmware_add_image(firmware, img, error)) |
121 | 0 | return FALSE; |
122 | 146 | if (fu_firmware_get_size(img) == 0) { |
123 | 0 | g_set_error_literal(error, |
124 | 0 | FWUPD_ERROR, |
125 | 0 | FWUPD_ERROR_INVALID_DATA, |
126 | 0 | "child image had no defined size"); |
127 | 0 | return FALSE; |
128 | 0 | } |
129 | | |
130 | | /* next! */ |
131 | 146 | offset += fu_firmware_get_size(img); |
132 | | |
133 | | /* skip any padding */ |
134 | 146 | if (fu_firmware_has_flag(img, FU_FIRMWARE_FLAG_IS_LAST_IMAGE)) |
135 | 0 | break; |
136 | 146 | } |
137 | | |
138 | | /* this might be less than streamsz if padded */ |
139 | 1 | fu_firmware_set_size(firmware, offset); |
140 | | |
141 | | /* success */ |
142 | 1 | return TRUE; |
143 | 3.17k | } |
144 | | |
145 | | static GByteArray * |
146 | | fu_linear_firmware_write(FuFirmware *firmware, GError **error) |
147 | 0 | { |
148 | 0 | g_autoptr(GByteArray) buf = g_byte_array_new(); |
149 | 0 | g_autoptr(GPtrArray) images = fu_firmware_get_images(firmware); |
150 | | |
151 | | /* add each file */ |
152 | 0 | for (guint i = 0; i < images->len; i++) { |
153 | 0 | FuFirmware *img = g_ptr_array_index(images, i); |
154 | 0 | g_autoptr(GBytes) blob = NULL; |
155 | 0 | if (i == images->len - 1) |
156 | 0 | fu_firmware_add_flag(img, FU_FIRMWARE_FLAG_IS_LAST_IMAGE); |
157 | 0 | fu_firmware_set_offset(img, buf->len); |
158 | 0 | blob = fu_firmware_write(img, error); |
159 | 0 | if (blob == NULL) |
160 | 0 | return NULL; |
161 | 0 | fu_byte_array_append_bytes(buf, blob); |
162 | 0 | } |
163 | | |
164 | | /* success */ |
165 | 0 | return g_steal_pointer(&buf); |
166 | 0 | } |
167 | | |
168 | | static void |
169 | | fu_linear_firmware_get_property(GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) |
170 | 0 | { |
171 | 0 | FuLinearFirmware *self = FU_LINEAR_FIRMWARE(object); |
172 | 0 | FuLinearFirmwarePrivate *priv = GET_PRIVATE(self); |
173 | 0 | switch (prop_id) { |
174 | 0 | case PROP_IMAGE_GTYPE: |
175 | 0 | g_value_set_gtype(value, priv->image_gtype); |
176 | 0 | break; |
177 | 0 | default: |
178 | 0 | G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec); |
179 | 0 | break; |
180 | 0 | } |
181 | 0 | } |
182 | | |
183 | | static void |
184 | | fu_linear_firmware_set_property(GObject *object, |
185 | | guint prop_id, |
186 | | const GValue *value, |
187 | | GParamSpec *pspec) |
188 | 3.18k | { |
189 | 3.18k | FuLinearFirmware *self = FU_LINEAR_FIRMWARE(object); |
190 | 3.18k | FuLinearFirmwarePrivate *priv = GET_PRIVATE(self); |
191 | 3.18k | switch (prop_id) { |
192 | 3.18k | case PROP_IMAGE_GTYPE: |
193 | 3.18k | priv->image_gtype = g_value_get_gtype(value); |
194 | 3.18k | fu_firmware_add_image_gtype(FU_FIRMWARE(self), priv->image_gtype); |
195 | 3.18k | break; |
196 | 0 | default: |
197 | 0 | G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec); |
198 | 0 | break; |
199 | 3.18k | } |
200 | 3.18k | } |
201 | | |
202 | | static void |
203 | | fu_linear_firmware_init(FuLinearFirmware *self) |
204 | 3.18k | { |
205 | 3.18k | fu_firmware_set_images_max(FU_FIRMWARE(self), 1024); |
206 | 3.18k | fu_firmware_add_flag(FU_FIRMWARE(self), FU_FIRMWARE_FLAG_NO_AUTO_DETECTION); |
207 | 3.18k | } |
208 | | |
209 | | static void |
210 | | fu_linear_firmware_class_init(FuLinearFirmwareClass *klass) |
211 | 1 | { |
212 | 1 | FuFirmwareClass *firmware_class = FU_FIRMWARE_CLASS(klass); |
213 | 1 | GObjectClass *object_class = G_OBJECT_CLASS(klass); |
214 | 1 | GParamSpec *pspec; |
215 | | |
216 | 1 | object_class->get_property = fu_linear_firmware_get_property; |
217 | 1 | object_class->set_property = fu_linear_firmware_set_property; |
218 | 1 | firmware_class->parse = fu_linear_firmware_parse; |
219 | 1 | firmware_class->write = fu_linear_firmware_write; |
220 | 1 | firmware_class->export = fu_linear_firmware_export; |
221 | 1 | firmware_class->build = fu_linear_firmware_build; |
222 | | |
223 | | /** |
224 | | * FuLinearFirmware:image-gtype: |
225 | | * |
226 | | * The image #GType |
227 | | * |
228 | | * Since: 1.8.2 |
229 | | */ |
230 | 1 | pspec = |
231 | 1 | g_param_spec_gtype("image-gtype", |
232 | 1 | NULL, |
233 | 1 | NULL, |
234 | 1 | FU_TYPE_FIRMWARE, |
235 | 1 | G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_NAME); |
236 | 1 | g_object_class_install_property(object_class, PROP_IMAGE_GTYPE, pspec); |
237 | 1 | } |
238 | | |
239 | | /** |
240 | | * fu_linear_firmware_new: |
241 | | * @image_gtype: a #GType, e.g. %FU_TYPE_OPROM_FIRMWARE |
242 | | * |
243 | | * Creates a new #FuFirmware made up of concatenated images. |
244 | | * |
245 | | * Since: 1.8.2 |
246 | | **/ |
247 | | FuFirmware * |
248 | | fu_linear_firmware_new(GType image_gtype) |
249 | 3.18k | { |
250 | 3.18k | return g_object_new(FU_TYPE_LINEAR_FIRMWARE, "image-gtype", image_gtype, NULL); |
251 | 3.18k | } |