xref: /aosp_15_r20/external/coreboot/util/cbfstool/cbfs.h (revision b9411a12aaaa7e1e6a6fb7c5e057f44ee179a49c)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 
3 #ifndef __CBFS_H
4 #define __CBFS_H
5 
6 #include "common.h"
7 #include <commonlib/bsd/cbfs_serialized.h>
8 
9 /* To make CBFS more friendly to ROM, fill -1 (0xFF) instead of zero. */
10 #define CBFS_CONTENT_DEFAULT_VALUE	(-1)
11 
12 #define CBFS_HEADPTR_ADDR_X86 0xFFFFFFFC
13 
14 /* cbfstool is allowed to use this constant freely since it's not part of the
15    CBFS image, so make an alias for the name that's a little less aggressive. */
16 #define METADATA_HASH_ANCHOR_MAGIC \
17 	DO_NOT_USE_METADATA_HASH_ANCHOR_MAGIC_DO_NOT_USE
18 
19 struct typedesc_t {
20 	uint32_t type;
21 	const char *name;
22 };
23 
24 static const struct typedesc_t types_cbfs_compression[] = {
25 	{CBFS_COMPRESS_NONE, "none"},
26 	{CBFS_COMPRESS_LZMA, "LZMA"},
27 	{CBFS_COMPRESS_LZ4, "LZ4"},
28 	{0, NULL},
29 };
30 
31 static struct typedesc_t filetypes[] unused = {
32 	{CBFS_TYPE_BOOTBLOCK, "bootblock"},
33 	{CBFS_TYPE_CBFSHEADER, "cbfs header"},
34 	{CBFS_TYPE_LEGACY_STAGE, "legacy stage"},
35 	{CBFS_TYPE_STAGE, "stage"},
36 	{CBFS_TYPE_SELF, "simple elf"},
37 	{CBFS_TYPE_FIT_PAYLOAD, "fit_payload"},
38 	{CBFS_TYPE_OPTIONROM, "optionrom"},
39 	{CBFS_TYPE_BOOTSPLASH, "bootsplash"},
40 	{CBFS_TYPE_RAW, "raw"},
41 	{CBFS_TYPE_VSA, "vsa"},
42 	{CBFS_TYPE_MBI, "mbi"},
43 	{CBFS_TYPE_MICROCODE, "microcode"},
44 	{CBFS_TYPE_INTEL_FIT, "intel_fit"},
45 	{CBFS_TYPE_FSP, "fsp"},
46 	{CBFS_TYPE_MRC, "mrc"},
47 	{CBFS_TYPE_CMOS_DEFAULT, "cmos_default"},
48 	{CBFS_TYPE_CMOS_LAYOUT, "cmos_layout"},
49 	{CBFS_TYPE_SPD, "spd"},
50 	{CBFS_TYPE_MRC_CACHE, "mrc_cache"},
51 	{CBFS_TYPE_MMA, "mma"},
52 	{CBFS_TYPE_EFI, "efi"},
53 	{CBFS_TYPE_STRUCT, "struct"},
54 	{CBFS_TYPE_DELETED, "deleted"},
55 	{CBFS_TYPE_NULL, "null"},
56 	{CBFS_TYPE_AMDFW, "amdfw"},
57 	{0, NULL}
58 };
59 
60 #define CBFS_SUBHEADER(_p) ((void *) ((((uint8_t *) (_p)) + be32toh((_p)->offset))))
61 
cbfs_file_attr_hash_size(enum vb2_hash_algorithm algo)62 static inline size_t cbfs_file_attr_hash_size(enum vb2_hash_algorithm algo)
63 {
64 	return offsetof(struct cbfs_file_attr_hash, hash.raw) +
65 	       vb2_digest_size(algo);
66 }
67 
68 /* cbfs_image.c */
69 uint32_t get_cbfs_entry_type(const char *name, uint32_t default_value);
70 uint32_t get_cbfs_compression(const char *name, uint32_t unknown);
71 
72 /* cbfs-mkpayload.c */
73 void xdr_segs(struct buffer *output,
74 	      struct cbfs_payload_segment *segs, int nseg);
75 void xdr_get_seg(struct cbfs_payload_segment *out,
76 		struct cbfs_payload_segment *in);
77 
78 /* platform_fixups.c */
79 typedef int (*platform_fixup_func)(struct buffer *buffer, size_t offset);
80 platform_fixup_func platform_fixups_probe(struct buffer *buffer, size_t offset,
81 					  const char *region_name);
82 
83 #endif
84