hc
2024-11-01 2f529f9b558ca1c1bd74be7437a84e4711743404
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * UEFI Common Platform Error Record
 *
 * Copyright (C) 2010, Intel Corp.
 *    Author: Huang Ying <ying.huang@intel.com>
 */
 
#ifndef LINUX_CPER_H
#define LINUX_CPER_H
 
#include <linux/uuid.h>
#include <linux/trace_seq.h>
 
/* CPER record signature and the size */
#define CPER_SIG_RECORD                "CPER"
#define CPER_SIG_SIZE                4
/* Used in signature_end field in struct cper_record_header */
#define CPER_SIG_END                0xffffffff
 
/*
 * CPER record header revision, used in revision field in struct
 * cper_record_header
 */
#define CPER_RECORD_REV                0x0100
 
/*
 * CPER record length contains the CPER fields which are relevant for further
 * handling of a memory error in userspace (we don't carry all the fields
 * defined in the UEFI spec because some of them don't make any sense.)
 * Currently, a length of 256 should be more than enough.
 */
#define CPER_REC_LEN                    256
/*
 * Severity definition for error_severity in struct cper_record_header
 * and section_severity in struct cper_section_descriptor
 */
enum {
   CPER_SEV_RECOVERABLE,
   CPER_SEV_FATAL,
   CPER_SEV_CORRECTED,
   CPER_SEV_INFORMATIONAL,
};
 
/*
 * Validation bits definition for validation_bits in struct
 * cper_record_header. If set, corresponding fields in struct
 * cper_record_header contain valid information.
 */
#define CPER_VALID_PLATFORM_ID            0x0001
#define CPER_VALID_TIMESTAMP            0x0002
#define CPER_VALID_PARTITION_ID            0x0004
 
/*
 * Notification type used to generate error record, used in
 * notification_type in struct cper_record_header.  These UUIDs are defined
 * in the UEFI spec v2.7, sec N.2.1.
 */
 
/* Corrected Machine Check */
#define CPER_NOTIFY_CMC                            \
   GUID_INIT(0x2DCE8BB1, 0xBDD7, 0x450e, 0xB9, 0xAD, 0x9C, 0xF4,    \
         0xEB, 0xD4, 0xF8, 0x90)
/* Corrected Platform Error */
#define CPER_NOTIFY_CPE                            \
   GUID_INIT(0x4E292F96, 0xD843, 0x4a55, 0xA8, 0xC2, 0xD4, 0x81,    \
         0xF2, 0x7E, 0xBE, 0xEE)
/* Machine Check Exception */
#define CPER_NOTIFY_MCE                            \
   GUID_INIT(0xE8F56FFE, 0x919C, 0x4cc5, 0xBA, 0x88, 0x65, 0xAB,    \
         0xE1, 0x49, 0x13, 0xBB)
/* PCI Express Error */
#define CPER_NOTIFY_PCIE                        \
   GUID_INIT(0xCF93C01F, 0x1A16, 0x4dfc, 0xB8, 0xBC, 0x9C, 0x4D,    \
         0xAF, 0x67, 0xC1, 0x04)
/* INIT Record (for IPF) */
#define CPER_NOTIFY_INIT                        \
   GUID_INIT(0xCC5263E8, 0x9308, 0x454a, 0x89, 0xD0, 0x34, 0x0B,    \
         0xD3, 0x9B, 0xC9, 0x8E)
/* Non-Maskable Interrupt */
#define CPER_NOTIFY_NMI                            \
   GUID_INIT(0x5BAD89FF, 0xB7E6, 0x42c9, 0x81, 0x4A, 0xCF, 0x24,    \
         0x85, 0xD6, 0xE9, 0x8A)
/* BOOT Error Record */
#define CPER_NOTIFY_BOOT                        \
   GUID_INIT(0x3D61A466, 0xAB40, 0x409a, 0xA6, 0x98, 0xF3, 0x62,    \
         0xD4, 0x64, 0xB3, 0x8F)
/* DMA Remapping Error */
#define CPER_NOTIFY_DMAR                        \
   GUID_INIT(0x667DD791, 0xC6B3, 0x4c27, 0x8A, 0x6B, 0x0F, 0x8E,    \
         0x72, 0x2D, 0xEB, 0x41)
 
/*
 * Flags bits definitions for flags in struct cper_record_header
 * If set, the error has been recovered
 */
#define CPER_HW_ERROR_FLAGS_RECOVERED        0x1
/* If set, the error is for previous boot */
#define CPER_HW_ERROR_FLAGS_PREVERR        0x2
/* If set, the error is injected for testing */
#define CPER_HW_ERROR_FLAGS_SIMULATED        0x4
 
/*
 * CPER section header revision, used in revision field in struct
 * cper_section_descriptor
 */
#define CPER_SEC_REV                0x0100
 
/*
 * Validation bits definition for validation_bits in struct
 * cper_section_descriptor. If set, corresponding fields in struct
 * cper_section_descriptor contain valid information.
 */
#define CPER_SEC_VALID_FRU_ID            0x1
#define CPER_SEC_VALID_FRU_TEXT            0x2
 
/*
 * Flags bits definitions for flags in struct cper_section_descriptor
 *
 * If set, the section is associated with the error condition
 * directly, and should be focused on
 */
#define CPER_SEC_PRIMARY            0x0001
/*
 * If set, the error was not contained within the processor or memory
 * hierarchy and the error may have propagated to persistent storage
 * or network
 */
#define CPER_SEC_CONTAINMENT_WARNING        0x0002
/* If set, the component must be re-initialized or re-enabled prior to use */
#define CPER_SEC_RESET                0x0004
/* If set, Linux may choose to discontinue use of the resource */
#define CPER_SEC_ERROR_THRESHOLD_EXCEEDED    0x0008
/*
 * If set, resource could not be queried for error information due to
 * conflicts with other system software or resources. Some fields of
 * the section will be invalid
 */
#define CPER_SEC_RESOURCE_NOT_ACCESSIBLE    0x0010
/*
 * If set, action has been taken to ensure error containment (such as
 * poisoning data), but the error has not been fully corrected and the
 * data has not been consumed. Linux may choose to take further
 * corrective action before the data is consumed
 */
#define CPER_SEC_LATENT_ERROR            0x0020
 
/*
 * Section type definitions, used in section_type field in struct
 * cper_section_descriptor.  These UUIDs are defined in the UEFI spec
 * v2.7, sec N.2.2.
 */
 
/* Processor Generic */
#define CPER_SEC_PROC_GENERIC                        \
   GUID_INIT(0x9876CCAD, 0x47B4, 0x4bdb, 0xB6, 0x5E, 0x16, 0xF1,    \
         0x93, 0xC4, 0xF3, 0xDB)
/* Processor Specific: X86/X86_64 */
#define CPER_SEC_PROC_IA                        \
   GUID_INIT(0xDC3EA0B0, 0xA144, 0x4797, 0xB9, 0x5B, 0x53, 0xFA,    \
         0x24, 0x2B, 0x6E, 0x1D)
/* Processor Specific: IA64 */
#define CPER_SEC_PROC_IPF                        \
   GUID_INIT(0xE429FAF1, 0x3CB7, 0x11D4, 0x0B, 0xCA, 0x07, 0x00,    \
         0x80, 0xC7, 0x3C, 0x88, 0x81)
/* Processor Specific: ARM */
#define CPER_SEC_PROC_ARM                        \
   GUID_INIT(0xE19E3D16, 0xBC11, 0x11E4, 0x9C, 0xAA, 0xC2, 0x05,    \
         0x1D, 0x5D, 0x46, 0xB0)
/* Platform Memory */
#define CPER_SEC_PLATFORM_MEM                        \
   GUID_INIT(0xA5BC1114, 0x6F64, 0x4EDE, 0xB8, 0x63, 0x3E, 0x83,    \
         0xED, 0x7C, 0x83, 0xB1)
#define CPER_SEC_PCIE                            \
   GUID_INIT(0xD995E954, 0xBBC1, 0x430F, 0xAD, 0x91, 0xB4, 0x4D,    \
         0xCB, 0x3C, 0x6F, 0x35)
/* Firmware Error Record Reference */
#define CPER_SEC_FW_ERR_REC_REF                        \
   GUID_INIT(0x81212A96, 0x09ED, 0x4996, 0x94, 0x71, 0x8D, 0x72,    \
         0x9C, 0x8E, 0x69, 0xED)
/* PCI/PCI-X Bus */
#define CPER_SEC_PCI_X_BUS                        \
   GUID_INIT(0xC5753963, 0x3B84, 0x4095, 0xBF, 0x78, 0xED, 0xDA,    \
         0xD3, 0xF9, 0xC9, 0xDD)
/* PCI Component/Device */
#define CPER_SEC_PCI_DEV                        \
   GUID_INIT(0xEB5E4685, 0xCA66, 0x4769, 0xB6, 0xA2, 0x26, 0x06,    \
         0x8B, 0x00, 0x13, 0x26)
#define CPER_SEC_DMAR_GENERIC                        \
   GUID_INIT(0x5B51FEF7, 0xC79D, 0x4434, 0x8F, 0x1B, 0xAA, 0x62,    \
         0xDE, 0x3E, 0x2C, 0x64)
/* Intel VT for Directed I/O specific DMAr */
#define CPER_SEC_DMAR_VT                        \
   GUID_INIT(0x71761D37, 0x32B2, 0x45cd, 0xA7, 0xD0, 0xB0, 0xFE,    \
         0xDD, 0x93, 0xE8, 0xCF)
/* IOMMU specific DMAr */
#define CPER_SEC_DMAR_IOMMU                        \
   GUID_INIT(0x036F84E1, 0x7F37, 0x428c, 0xA7, 0x9E, 0x57, 0x5F,    \
         0xDF, 0xAA, 0x84, 0xEC)
 
#define CPER_PROC_VALID_TYPE            0x0001
#define CPER_PROC_VALID_ISA            0x0002
#define CPER_PROC_VALID_ERROR_TYPE        0x0004
#define CPER_PROC_VALID_OPERATION        0x0008
#define CPER_PROC_VALID_FLAGS            0x0010
#define CPER_PROC_VALID_LEVEL            0x0020
#define CPER_PROC_VALID_VERSION            0x0040
#define CPER_PROC_VALID_BRAND_INFO        0x0080
#define CPER_PROC_VALID_ID            0x0100
#define CPER_PROC_VALID_TARGET_ADDRESS        0x0200
#define CPER_PROC_VALID_REQUESTOR_ID        0x0400
#define CPER_PROC_VALID_RESPONDER_ID        0x0800
#define CPER_PROC_VALID_IP            0x1000
 
#define CPER_MEM_VALID_ERROR_STATUS        0x0001
#define CPER_MEM_VALID_PA            0x0002
#define CPER_MEM_VALID_PA_MASK            0x0004
#define CPER_MEM_VALID_NODE            0x0008
#define CPER_MEM_VALID_CARD            0x0010
#define CPER_MEM_VALID_MODULE            0x0020
#define CPER_MEM_VALID_BANK            0x0040
#define CPER_MEM_VALID_DEVICE            0x0080
#define CPER_MEM_VALID_ROW            0x0100
#define CPER_MEM_VALID_COLUMN            0x0200
#define CPER_MEM_VALID_BIT_POSITION        0x0400
#define CPER_MEM_VALID_REQUESTOR_ID        0x0800
#define CPER_MEM_VALID_RESPONDER_ID        0x1000
#define CPER_MEM_VALID_TARGET_ID        0x2000
#define CPER_MEM_VALID_ERROR_TYPE        0x4000
#define CPER_MEM_VALID_RANK_NUMBER        0x8000
#define CPER_MEM_VALID_CARD_HANDLE        0x10000
#define CPER_MEM_VALID_MODULE_HANDLE        0x20000
#define CPER_MEM_VALID_ROW_EXT            0x40000
#define CPER_MEM_VALID_BANK_GROUP        0x80000
#define CPER_MEM_VALID_BANK_ADDRESS        0x100000
#define CPER_MEM_VALID_CHIP_ID            0x200000
 
#define CPER_MEM_EXT_ROW_MASK            0x3
#define CPER_MEM_EXT_ROW_SHIFT            16
 
#define CPER_MEM_BANK_ADDRESS_MASK        0xff
#define CPER_MEM_BANK_GROUP_SHIFT        8
 
#define CPER_MEM_CHIP_ID_SHIFT            5
 
#define CPER_PCIE_VALID_PORT_TYPE        0x0001
#define CPER_PCIE_VALID_VERSION            0x0002
#define CPER_PCIE_VALID_COMMAND_STATUS        0x0004
#define CPER_PCIE_VALID_DEVICE_ID        0x0008
#define CPER_PCIE_VALID_SERIAL_NUMBER        0x0010
#define CPER_PCIE_VALID_BRIDGE_CONTROL_STATUS    0x0020
#define CPER_PCIE_VALID_CAPABILITY        0x0040
#define CPER_PCIE_VALID_AER_INFO        0x0080
 
#define CPER_PCIE_SLOT_SHIFT            3
 
#define CPER_ARM_VALID_MPIDR            BIT(0)
#define CPER_ARM_VALID_AFFINITY_LEVEL        BIT(1)
#define CPER_ARM_VALID_RUNNING_STATE        BIT(2)
#define CPER_ARM_VALID_VENDOR_INFO        BIT(3)
 
#define CPER_ARM_INFO_VALID_MULTI_ERR        BIT(0)
#define CPER_ARM_INFO_VALID_FLAGS        BIT(1)
#define CPER_ARM_INFO_VALID_ERR_INFO        BIT(2)
#define CPER_ARM_INFO_VALID_VIRT_ADDR        BIT(3)
#define CPER_ARM_INFO_VALID_PHYSICAL_ADDR    BIT(4)
 
#define CPER_ARM_INFO_FLAGS_FIRST        BIT(0)
#define CPER_ARM_INFO_FLAGS_LAST        BIT(1)
#define CPER_ARM_INFO_FLAGS_PROPAGATED        BIT(2)
#define CPER_ARM_INFO_FLAGS_OVERFLOW        BIT(3)
 
#define CPER_ARM_CACHE_ERROR            0
#define CPER_ARM_TLB_ERROR            1
#define CPER_ARM_BUS_ERROR            2
#define CPER_ARM_VENDOR_ERROR            3
#define CPER_ARM_MAX_TYPE            CPER_ARM_VENDOR_ERROR
 
#define CPER_ARM_ERR_VALID_TRANSACTION_TYPE    BIT(0)
#define CPER_ARM_ERR_VALID_OPERATION_TYPE    BIT(1)
#define CPER_ARM_ERR_VALID_LEVEL        BIT(2)
#define CPER_ARM_ERR_VALID_PROC_CONTEXT_CORRUPT    BIT(3)
#define CPER_ARM_ERR_VALID_CORRECTED        BIT(4)
#define CPER_ARM_ERR_VALID_PRECISE_PC        BIT(5)
#define CPER_ARM_ERR_VALID_RESTARTABLE_PC    BIT(6)
#define CPER_ARM_ERR_VALID_PARTICIPATION_TYPE    BIT(7)
#define CPER_ARM_ERR_VALID_TIME_OUT        BIT(8)
#define CPER_ARM_ERR_VALID_ADDRESS_SPACE    BIT(9)
#define CPER_ARM_ERR_VALID_MEM_ATTRIBUTES    BIT(10)
#define CPER_ARM_ERR_VALID_ACCESS_MODE        BIT(11)
 
#define CPER_ARM_ERR_TRANSACTION_SHIFT        16
#define CPER_ARM_ERR_TRANSACTION_MASK        GENMASK(1,0)
#define CPER_ARM_ERR_OPERATION_SHIFT        18
#define CPER_ARM_ERR_OPERATION_MASK        GENMASK(3,0)
#define CPER_ARM_ERR_LEVEL_SHIFT        22
#define CPER_ARM_ERR_LEVEL_MASK            GENMASK(2,0)
#define CPER_ARM_ERR_PC_CORRUPT_SHIFT        25
#define CPER_ARM_ERR_PC_CORRUPT_MASK        GENMASK(0,0)
#define CPER_ARM_ERR_CORRECTED_SHIFT        26
#define CPER_ARM_ERR_CORRECTED_MASK        GENMASK(0,0)
#define CPER_ARM_ERR_PRECISE_PC_SHIFT        27
#define CPER_ARM_ERR_PRECISE_PC_MASK        GENMASK(0,0)
#define CPER_ARM_ERR_RESTARTABLE_PC_SHIFT    28
#define CPER_ARM_ERR_RESTARTABLE_PC_MASK    GENMASK(0,0)
#define CPER_ARM_ERR_PARTICIPATION_TYPE_SHIFT    29
#define CPER_ARM_ERR_PARTICIPATION_TYPE_MASK    GENMASK(1,0)
#define CPER_ARM_ERR_TIME_OUT_SHIFT        31
#define CPER_ARM_ERR_TIME_OUT_MASK        GENMASK(0,0)
#define CPER_ARM_ERR_ADDRESS_SPACE_SHIFT    32
#define CPER_ARM_ERR_ADDRESS_SPACE_MASK        GENMASK(1,0)
#define CPER_ARM_ERR_MEM_ATTRIBUTES_SHIFT    34
#define CPER_ARM_ERR_MEM_ATTRIBUTES_MASK    GENMASK(8,0)
#define CPER_ARM_ERR_ACCESS_MODE_SHIFT        43
#define CPER_ARM_ERR_ACCESS_MODE_MASK        GENMASK(0,0)
 
/*
 * All tables and structs must be byte-packed to match CPER
 * specification, since the tables are provided by the system BIOS
 */
#pragma pack(1)
 
/* Record Header, UEFI v2.7 sec N.2.1 */
struct cper_record_header {
   char    signature[CPER_SIG_SIZE];    /* must be CPER_SIG_RECORD */
   u16    revision;            /* must be CPER_RECORD_REV */
   u32    signature_end;            /* must be CPER_SIG_END */
   u16    section_count;
   u32    error_severity;
   u32    validation_bits;
   u32    record_length;
   u64    timestamp;
   guid_t    platform_id;
   guid_t    partition_id;
   guid_t    creator_id;
   guid_t    notification_type;
   u64    record_id;
   u32    flags;
   u64    persistence_information;
   u8    reserved[12];            /* must be zero */
};
 
/* Section Descriptor, UEFI v2.7 sec N.2.2 */
struct cper_section_descriptor {
   u32    section_offset;        /* Offset in bytes of the
                    *  section body from the base
                    *  of the record header */
   u32    section_length;
   u16    revision;        /* must be CPER_RECORD_REV */
   u8    validation_bits;
   u8    reserved;        /* must be zero */
   u32    flags;
   guid_t    section_type;
   guid_t    fru_id;
   u32    section_severity;
   u8    fru_text[20];
};
 
/* Generic Processor Error Section, UEFI v2.7 sec N.2.4.1 */
struct cper_sec_proc_generic {
   u64    validation_bits;
   u8    proc_type;
   u8    proc_isa;
   u8    proc_error_type;
   u8    operation;
   u8    flags;
   u8    level;
   u16    reserved;
   u64    cpu_version;
   char    cpu_brand[128];
   u64    proc_id;
   u64    target_addr;
   u64    requestor_id;
   u64    responder_id;
   u64    ip;
};
 
/* IA32/X64 Processor Error Section, UEFI v2.7 sec N.2.4.2 */
struct cper_sec_proc_ia {
   u64    validation_bits;
   u64    lapic_id;
   u8    cpuid[48];
};
 
/* IA32/X64 Processor Error Information Structure, UEFI v2.7 sec N.2.4.2.1 */
struct cper_ia_err_info {
   guid_t    err_type;
   u64    validation_bits;
   u64    check_info;
   u64    target_id;
   u64    requestor_id;
   u64    responder_id;
   u64    ip;
};
 
/* IA32/X64 Processor Context Information Structure, UEFI v2.7 sec N.2.4.2.2 */
struct cper_ia_proc_ctx {
   u16    reg_ctx_type;
   u16    reg_arr_size;
   u32    msr_addr;
   u64    mm_reg_addr;
};
 
/* ARM Processor Error Section, UEFI v2.7 sec N.2.4.4 */
struct cper_sec_proc_arm {
   u32    validation_bits;
   u16    err_info_num;        /* Number of Processor Error Info */
   u16    context_info_num;    /* Number of Processor Context Info Records*/
   u32    section_length;
   u8    affinity_level;
   u8    reserved[3];        /* must be zero */
   u64    mpidr;
   u64    midr;
   u32    running_state;        /* Bit 0 set - Processor running. PSCI = 0 */
   u32    psci_state;
};
 
/* ARM Processor Error Information Structure, UEFI v2.7 sec N.2.4.4.1 */
struct cper_arm_err_info {
   u8    version;
   u8    length;
   u16    validation_bits;
   u8    type;
   u16    multiple_error;
   u8    flags;
   u64    error_info;
   u64    virt_fault_addr;
   u64    physical_fault_addr;
};
 
/* ARM Processor Context Information Structure, UEFI v2.7 sec N.2.4.4.2 */
struct cper_arm_ctx_info {
   u16    version;
   u16    type;
   u32    size;
};
 
/* Old Memory Error Section, UEFI v2.1, v2.2 */
struct cper_sec_mem_err_old {
   u64    validation_bits;
   u64    error_status;
   u64    physical_addr;
   u64    physical_addr_mask;
   u16    node;
   u16    card;
   u16    module;
   u16    bank;
   u16    device;
   u16    row;
   u16    column;
   u16    bit_pos;
   u64    requestor_id;
   u64    responder_id;
   u64    target_id;
   u8    error_type;
};
 
/* Memory Error Section (UEFI >= v2.3), UEFI v2.8 sec N.2.5 */
struct cper_sec_mem_err {
   u64    validation_bits;
   u64    error_status;
   u64    physical_addr;
   u64    physical_addr_mask;
   u16    node;
   u16    card;
   u16    module;
   u16    bank;
   u16    device;
   u16    row;
   u16    column;
   u16    bit_pos;
   u64    requestor_id;
   u64    responder_id;
   u64    target_id;
   u8    error_type;
   u8    extended;
   u16    rank;
   u16    mem_array_handle;    /* "card handle" in UEFI 2.4 */
   u16    mem_dev_handle;        /* "module handle" in UEFI 2.4 */
};
 
struct cper_mem_err_compact {
   u64    validation_bits;
   u16    node;
   u16    card;
   u16    module;
   u16    bank;
   u16    device;
   u16    row;
   u16    column;
   u16    bit_pos;
   u64    requestor_id;
   u64    responder_id;
   u64    target_id;
   u16    rank;
   u16    mem_array_handle;
   u16    mem_dev_handle;
   u8      extended;
};
 
static inline u32 cper_get_mem_extension(u64 mem_valid, u8 mem_extended)
{
   if (!(mem_valid & CPER_MEM_VALID_ROW_EXT))
       return 0;
   return (mem_extended & CPER_MEM_EXT_ROW_MASK) << CPER_MEM_EXT_ROW_SHIFT;
}
 
/* PCI Express Error Section, UEFI v2.7 sec N.2.7 */
struct cper_sec_pcie {
   u64        validation_bits;
   u32        port_type;
   struct {
       u8    minor;
       u8    major;
       u8    reserved[2];
   }        version;
   u16        command;
   u16        status;
   u32        reserved;
   struct {
       u16    vendor_id;
       u16    device_id;
       u8    class_code[3];
       u8    function;
       u8    device;
       u16    segment;
       u8    bus;
       u8    secondary_bus;
       u16    slot;
       u8    reserved;
   }        device_id;
   struct {
       u32    lower;
       u32    upper;
   }        serial_number;
   struct {
       u16    secondary_status;
       u16    control;
   }        bridge;
   u8    capability[60];
   u8    aer_info[96];
};
 
/* Firmware Error Record Reference, UEFI v2.7 sec N.2.10  */
struct cper_sec_fw_err_rec_ref {
   u8 record_type;
   u8 revision;
   u8 reserved[6];
   u64 record_identifier;
   guid_t record_identifier_guid;
};
 
/* Reset to default packing */
#pragma pack()
 
extern const char *const cper_proc_error_type_strs[4];
 
u64 cper_next_record_id(void);
const char *cper_severity_str(unsigned int);
const char *cper_mem_err_type_str(unsigned int);
void cper_print_bits(const char *prefix, unsigned int bits,
            const char * const strs[], unsigned int strs_size);
void cper_mem_err_pack(const struct cper_sec_mem_err *,
              struct cper_mem_err_compact *);
const char *cper_mem_err_unpack(struct trace_seq *,
               struct cper_mem_err_compact *);
void cper_print_proc_arm(const char *pfx,
            const struct cper_sec_proc_arm *proc);
void cper_print_proc_ia(const char *pfx,
           const struct cper_sec_proc_ia *proc);
 
#endif