Coverage Report

Created: 2025-06-22 06:29

/src/fwupd/libfwupdplugin/fu-efi-volume.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2021 Richard Hughes <richard@hughsie.com>
3
 *
4
 * SPDX-License-Identifier: LGPL-2.1-or-later
5
 */
6
7
13.2k
#define G_LOG_DOMAIN "FuEfiVolume"
8
9
#include "config.h"
10
11
#include "fu-byte-array.h"
12
#include "fu-bytes.h"
13
#include "fu-common.h"
14
#include "fu-efi-common.h"
15
#include "fu-efi-filesystem.h"
16
#include "fu-efi-struct.h"
17
#include "fu-efi-volume.h"
18
#include "fu-input-stream.h"
19
#include "fu-partial-input-stream.h"
20
#include "fu-sum.h"
21
22
/**
23
 * FuEfiVolume:
24
 *
25
 * A UEFI file volume.
26
 *
27
 * See also: [class@FuFirmware]
28
 */
29
30
typedef struct {
31
  guint16 attrs;
32
} FuEfiVolumePrivate;
33
34
G_DEFINE_TYPE_WITH_PRIVATE(FuEfiVolume, fu_efi_volume, FU_TYPE_FIRMWARE)
35
26.6k
#define GET_PRIVATE(o) (fu_efi_volume_get_instance_private(o))
36
37
static void
38
fu_efi_volume_export(FuFirmware *firmware, FuFirmwareExportFlags flags, XbBuilderNode *bn)
39
0
{
40
0
  FuEfiVolume *self = FU_EFI_VOLUME(firmware);
41
0
  FuEfiVolumePrivate *priv = GET_PRIVATE(self);
42
0
  fu_xmlb_builder_insert_kx(bn, "attrs", priv->attrs);
43
0
  if (flags & FU_FIRMWARE_EXPORT_FLAG_INCLUDE_DEBUG) {
44
0
    fu_xmlb_builder_insert_kv(bn,
45
0
            "name",
46
0
            fu_efi_guid_to_name(fu_firmware_get_id(firmware)));
47
0
  }
48
0
}
49
50
static gboolean
51
fu_efi_volume_validate(FuFirmware *firmware, GInputStream *stream, gsize offset, GError **error)
52
8.31M
{
53
8.31M
  return fu_struct_efi_volume_validate_stream(stream, offset, error);
54
8.31M
}
55
56
static gboolean
57
fu_efi_volume_parse(FuFirmware *firmware,
58
        GInputStream *stream,
59
        FuFirmwareParseFlags flags,
60
        GError **error)
61
9.53k
{
62
9.53k
  FuEfiVolume *self = FU_EFI_VOLUME(firmware);
63
9.53k
  FuEfiVolumePrivate *priv = GET_PRIVATE(self);
64
9.53k
  gsize blockmap_sz = 0;
65
9.53k
  gsize offset = 0;
66
9.53k
  gsize streamsz = 0;
67
9.53k
  guint16 hdr_length = 0;
68
9.53k
  guint32 attrs = 0;
69
9.53k
  guint64 fv_length = 0;
70
9.53k
  guint8 alignment;
71
9.53k
  g_autofree gchar *guid_str = NULL;
72
9.53k
  g_autoptr(GByteArray) st_hdr = NULL;
73
9.53k
  g_autoptr(GInputStream) partial_stream = NULL;
74
75
  /* parse */
76
9.53k
  st_hdr = fu_struct_efi_volume_parse_stream(stream, 0x0, error);
77
9.53k
  if (st_hdr == NULL)
78
0
    return FALSE;
79
80
  /* guid */
81
9.53k
  guid_str = fwupd_guid_to_string(fu_struct_efi_volume_get_guid(st_hdr),
82
9.53k
          FWUPD_GUID_FLAG_MIXED_ENDIAN);
83
9.53k
  g_debug("volume GUID: %s [%s]", guid_str, fu_efi_guid_to_name(guid_str));
84
85
  /* length */
86
9.53k
  if (!fu_input_stream_size(stream, &streamsz, error))
87
0
    return FALSE;
88
9.53k
  fv_length = fu_struct_efi_volume_get_length(st_hdr);
89
9.53k
  if (fv_length == 0x0) {
90
35
    g_set_error_literal(error,
91
35
            FWUPD_ERROR,
92
35
            FWUPD_ERROR_INTERNAL,
93
35
            "invalid volume length");
94
35
    return FALSE;
95
35
  }
96
9.49k
  fu_firmware_set_size(firmware, fv_length);
97
9.49k
  attrs = fu_struct_efi_volume_get_attrs(st_hdr);
98
9.49k
  alignment = (attrs & 0x00ff0000) >> 16;
99
9.49k
  if (alignment > FU_FIRMWARE_ALIGNMENT_2G) {
100
484
    g_set_error(error,
101
484
          FWUPD_ERROR,
102
484
          FWUPD_ERROR_NOT_FOUND,
103
484
          "0x%x invalid, maximum is 0x%x",
104
484
          (guint)alignment,
105
484
          (guint)FU_FIRMWARE_ALIGNMENT_2G);
106
484
    return FALSE;
107
484
  }
108
9.01k
  fu_firmware_set_alignment(firmware, alignment);
109
9.01k
  priv->attrs = attrs & 0xffff;
110
9.01k
  hdr_length = fu_struct_efi_volume_get_hdr_len(st_hdr);
111
9.01k
  if (hdr_length < st_hdr->len || hdr_length > fv_length || hdr_length > streamsz ||
112
9.01k
      hdr_length % 2 != 0) {
113
1.80k
    g_set_error(error,
114
1.80k
          FWUPD_ERROR,
115
1.80k
          FWUPD_ERROR_INTERNAL,
116
1.80k
          "invalid volume header length 0x%x",
117
1.80k
          (guint)hdr_length);
118
1.80k
    return FALSE;
119
1.80k
  }
120
121
  /* verify checksum */
122
7.20k
  if ((flags & FU_FIRMWARE_PARSE_FLAG_IGNORE_CHECKSUM) == 0) {
123
7.20k
    guint16 checksum_verify;
124
7.20k
    g_autoptr(GBytes) blob_hdr = NULL;
125
126
7.20k
    blob_hdr = fu_input_stream_read_bytes(stream, 0x0, hdr_length, NULL, error);
127
7.20k
    if (blob_hdr == NULL)
128
0
      return FALSE;
129
7.20k
    checksum_verify = fu_sum16w_bytes(blob_hdr, G_LITTLE_ENDIAN);
130
7.20k
    if (checksum_verify != 0) {
131
613
      g_set_error(error,
132
613
            FWUPD_ERROR,
133
613
            FWUPD_ERROR_INVALID_FILE,
134
613
            "checksum invalid, got %02x, expected %02x",
135
613
            checksum_verify,
136
613
            fu_struct_efi_volume_get_checksum(st_hdr));
137
613
      return FALSE;
138
613
    }
139
7.20k
  }
140
141
  /* extended header items */
142
6.59k
  if (fu_struct_efi_volume_get_ext_hdr(st_hdr) != 0) {
143
438
    g_autoptr(GByteArray) st_ext_hdr = NULL;
144
438
    goffset offset_ext = fu_struct_efi_volume_get_ext_hdr(st_hdr);
145
438
    st_ext_hdr =
146
438
        fu_struct_efi_volume_ext_header_parse_stream(stream, offset_ext, error);
147
438
    if (st_ext_hdr == NULL)
148
68
      return FALSE;
149
370
    offset_ext += fu_struct_efi_volume_ext_header_get_size(st_ext_hdr);
150
3.58k
    do {
151
3.58k
      g_autoptr(GByteArray) st_ext_entry = NULL;
152
3.58k
      st_ext_entry =
153
3.58k
          fu_struct_efi_volume_ext_entry_parse_stream(stream, offset_ext, error);
154
3.58k
      if (st_ext_entry == NULL)
155
187
        return FALSE;
156
3.40k
      if (fu_struct_efi_volume_ext_entry_get_size(st_ext_entry) == 0x0) {
157
39
        g_set_error_literal(error,
158
39
                FWUPD_ERROR,
159
39
                FWUPD_ERROR_INVALID_DATA,
160
39
                "EFI_VOLUME_EXT_ENTRY invalid size");
161
39
        return FALSE;
162
39
      }
163
3.36k
      if (fu_struct_efi_volume_ext_entry_get_size(st_ext_entry) == 0xFFFF)
164
31
        break;
165
3.33k
      offset_ext += fu_struct_efi_volume_ext_entry_get_size(st_ext_entry);
166
3.33k
    } while ((gsize)offset_ext < fv_length);
167
370
  }
168
169
  /* add image */
170
6.30k
  partial_stream =
171
6.30k
      fu_partial_input_stream_new(stream, hdr_length, fv_length - hdr_length, error);
172
6.30k
  if (partial_stream == NULL) {
173
306
    g_prefix_error(error, "failed to cut EFI volume: ");
174
306
    return FALSE;
175
306
  }
176
5.99k
  fu_firmware_set_id(firmware, guid_str);
177
5.99k
  fu_firmware_set_size(firmware, fv_length);
178
179
  /* parse, which might cascade and do something like FFS2 */
180
5.99k
  if (g_strcmp0(guid_str, FU_EFI_VOLUME_GUID_FFS2) == 0 ||
181
5.99k
      g_strcmp0(guid_str, FU_EFI_VOLUME_GUID_FFS3) == 0) {
182
2.23k
    g_autoptr(FuFirmware) img = fu_efi_filesystem_new();
183
2.23k
    fu_firmware_set_alignment(img, fu_firmware_get_alignment(firmware));
184
2.23k
    if (!fu_firmware_parse_stream(img,
185
2.23k
                partial_stream,
186
2.23k
                0x0,
187
2.23k
                flags | FU_FIRMWARE_PARSE_FLAG_NO_SEARCH,
188
2.23k
                error))
189
1.73k
      return FALSE;
190
500
    fu_firmware_add_image(firmware, img);
191
3.76k
  } else if (g_strcmp0(guid_str, FU_EFI_VOLUME_GUID_NVRAM_EVSA) == 0 ||
192
3.76k
       g_strcmp0(guid_str, FU_EFI_VOLUME_GUID_NVRAM_EVSA2) == 0) {
193
9
    g_debug("ignoring %s [%s] EFI FV", guid_str, fu_efi_guid_to_name(guid_str));
194
9
    if (!fu_firmware_set_stream(firmware, partial_stream, error))
195
0
      return FALSE;
196
3.75k
  } else {
197
3.75k
    g_warning("no idea how to parse %s [%s] EFI volume",
198
3.75k
        guid_str,
199
3.75k
        fu_efi_guid_to_name(guid_str));
200
3.75k
    if (!fu_firmware_set_stream(firmware, partial_stream, error))
201
0
      return FALSE;
202
3.75k
  }
203
204
  /* skip the blockmap */
205
4.26k
  offset += st_hdr->len;
206
395k
  while (offset < streamsz) {
207
395k
    guint32 num_blocks;
208
395k
    guint32 length;
209
395k
    g_autoptr(GByteArray) st_blk = NULL;
210
395k
    st_blk = fu_struct_efi_volume_block_map_parse_stream(stream, offset, error);
211
395k
    if (st_blk == NULL)
212
122
      return FALSE;
213
394k
    num_blocks = fu_struct_efi_volume_block_map_get_num_blocks(st_blk);
214
394k
    length = fu_struct_efi_volume_block_map_get_length(st_blk);
215
394k
    offset += st_blk->len;
216
394k
    if (num_blocks == 0x0 && length == 0x0)
217
3.91k
      break;
218
390k
    blockmap_sz += (gsize)num_blocks * (gsize)length;
219
390k
  }
220
4.13k
  if (blockmap_sz < (gsize)fv_length) {
221
75
    g_set_error_literal(error,
222
75
            FWUPD_ERROR,
223
75
            FWUPD_ERROR_INTERNAL,
224
75
            "blocks allocated is less than volume length");
225
75
    return FALSE;
226
75
  }
227
228
  /* success */
229
4.06k
  return TRUE;
230
4.13k
}
231
232
static GByteArray *
233
fu_efi_volume_write(FuFirmware *firmware, GError **error)
234
2.37k
{
235
2.37k
  FuEfiVolume *self = FU_EFI_VOLUME(firmware);
236
2.37k
  FuEfiVolumePrivate *priv = GET_PRIVATE(self);
237
2.37k
  g_autoptr(GByteArray) buf = fu_struct_efi_volume_new();
238
2.37k
  g_autoptr(GByteArray) st_blk = fu_struct_efi_volume_block_map_new();
239
2.37k
  fwupd_guid_t guid = {0x0};
240
2.37k
  guint32 hdr_length = 0x48;
241
2.37k
  guint64 fv_length;
242
2.37k
  g_autoptr(GBytes) img_blob = NULL;
243
2.37k
  g_autoptr(FuFirmware) img = NULL;
244
245
  /* sanity check */
246
2.37k
  if (fu_firmware_get_alignment(firmware) > FU_FIRMWARE_ALIGNMENT_1M) {
247
41
    g_set_error(error,
248
41
          FWUPD_ERROR,
249
41
          FWUPD_ERROR_INVALID_FILE,
250
41
          "alignment invalid, got 0x%02x",
251
41
          fu_firmware_get_alignment(firmware));
252
41
    return NULL;
253
41
  }
254
255
  /* GUID */
256
2.33k
  if (fu_firmware_get_id(firmware) == NULL) {
257
0
    g_set_error(error, FWUPD_ERROR, FWUPD_ERROR_INTERNAL, "no GUID set for EFI FV");
258
0
    return NULL;
259
0
  }
260
2.33k
  if (!fwupd_guid_from_string(fu_firmware_get_id(firmware),
261
2.33k
            &guid,
262
2.33k
            FWUPD_GUID_FLAG_MIXED_ENDIAN,
263
2.33k
            error))
264
0
    return NULL;
265
266
  /* length */
267
2.33k
  img = fu_firmware_get_image_by_id(firmware, NULL, NULL);
268
2.33k
  if (img != NULL) {
269
294
    img_blob = fu_firmware_write(img, error);
270
294
    if (img_blob == NULL) {
271
67
      g_prefix_error(error, "no EFI FV child payload: ");
272
67
      return NULL;
273
67
    }
274
2.04k
  } else {
275
2.04k
    img_blob = fu_firmware_get_bytes_with_patches(firmware, error);
276
2.04k
    if (img_blob == NULL) {
277
38
      g_prefix_error(error, "no EFI FV payload: ");
278
38
      return NULL;
279
38
    }
280
2.04k
  }
281
282
  /* pack */
283
2.23k
  fu_struct_efi_volume_set_guid(buf, &guid);
284
2.23k
  fv_length = fu_common_align_up(hdr_length + g_bytes_get_size(img_blob),
285
2.23k
               fu_firmware_get_alignment(firmware));
286
2.23k
  fu_struct_efi_volume_set_length(buf, fv_length);
287
2.23k
  fu_struct_efi_volume_set_attrs(buf,
288
2.23k
               priv->attrs |
289
2.23k
             ((guint32)fu_firmware_get_alignment(firmware) << 16));
290
2.23k
  fu_struct_efi_volume_set_hdr_len(buf, hdr_length);
291
292
  /* blockmap */
293
2.23k
  fu_struct_efi_volume_block_map_set_num_blocks(st_blk, fv_length);
294
2.23k
  fu_struct_efi_volume_block_map_set_length(st_blk, 0x1);
295
2.23k
  g_byte_array_append(buf, st_blk->data, st_blk->len);
296
2.23k
  fu_struct_efi_volume_block_map_set_num_blocks(st_blk, 0x0);
297
2.23k
  fu_struct_efi_volume_block_map_set_length(st_blk, 0x0);
298
2.23k
  g_byte_array_append(buf, st_blk->data, st_blk->len);
299
300
  /* fix up checksum */
301
2.23k
  fu_struct_efi_volume_set_checksum(buf,
302
2.23k
            0x10000 -
303
2.23k
                fu_sum16w(buf->data, buf->len, G_LITTLE_ENDIAN));
304
305
  /* pad contents to alignment */
306
2.23k
  fu_byte_array_append_bytes(buf, img_blob);
307
2.23k
  fu_byte_array_set_size(buf, fv_length, 0xFF);
308
309
  /* success */
310
2.23k
  return g_steal_pointer(&buf);
311
2.33k
}
312
313
static void
314
fu_efi_volume_init(FuEfiVolume *self)
315
14.7k
{
316
14.7k
  FuEfiVolumePrivate *priv = GET_PRIVATE(self);
317
14.7k
  priv->attrs = 0xfeff;
318
14.7k
  g_type_ensure(FU_TYPE_EFI_FILESYSTEM);
319
14.7k
}
320
321
static void
322
fu_efi_volume_class_init(FuEfiVolumeClass *klass)
323
3
{
324
3
  FuFirmwareClass *firmware_class = FU_FIRMWARE_CLASS(klass);
325
3
  firmware_class->validate = fu_efi_volume_validate;
326
3
  firmware_class->parse = fu_efi_volume_parse;
327
3
  firmware_class->write = fu_efi_volume_write;
328
3
  firmware_class->export = fu_efi_volume_export;
329
3
}
330
331
/**
332
 * fu_efi_volume_new:
333
 *
334
 * Creates a new #FuFirmware
335
 *
336
 * Since: 2.0.0
337
 **/
338
FuFirmware *
339
fu_efi_volume_new(void)
340
12.6k
{
341
12.6k
  return FU_FIRMWARE(g_object_new(FU_TYPE_EFI_VOLUME, NULL));
342
12.6k
}