Coverage Report

Created: 2026-01-09 07:21

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/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
}