arch/powerpc/platforms/powernv/opal-fadump.h
Source file repositories/reference/linux-study-clean/arch/powerpc/platforms/powernv/opal-fadump.h
File Facts
- System
- Linux kernel
- Corpus path
arch/powerpc/platforms/powernv/opal-fadump.h- Extension
.h- Size
- 3939 bytes
- Lines
- 147
- Domain
- Architecture Layer
- Bucket
- arch/powerpc
- Inferred role
- Architecture Layer: implementation source
- Status
- source implementation candidate
Why This File Exists
CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
asm/reg.h
Detected Declarations
struct opal_fadump_mem_structstruct hdat_fadump_thread_hdrstruct hdat_fadump_reg_entryfunction opal_fadump_set_regval_regnumfunction opal_fadump_read_regs
Annotated Snippet
struct opal_fadump_mem_struct {
u8 version;
u8 reserved[3];
__be16 region_cnt; /* number of regions */
__be16 registered_regions; /* Regions registered for MPIPL */
__be64 fadumphdr_addr;
struct opal_mpipl_region rgn[FADUMP_MAX_MEM_REGS];
} __packed;
/*
* CPU state data
*
* CPU state data information is provided by f/w. The format for this data
* is defined in the HDAT spec. Version is used to keep a tab on the changes
* in this CPU state data format. Changes to this format are unlikely, but
* if there are any changes, please refer to latest HDAT specification.
*/
#define HDAT_FADUMP_CPU_DATA_VER 1
#define HDAT_FADUMP_CORE_INACTIVE (0x0F)
/* HDAT thread header for register entries */
struct hdat_fadump_thread_hdr {
__be32 pir;
/* 0x00 - 0x0F - The corresponding stop state of the core */
u8 core_state;
u8 reserved[3];
__be32 offset; /* Offset to Register Entries array */
__be32 ecnt; /* Number of entries */
__be32 esize; /* Alloc size of each array entry in bytes */
__be32 eactsz; /* Actual size of each array entry in bytes */
} __packed;
/* Register types populated by f/w */
#define HDAT_FADUMP_REG_TYPE_GPR 0x01
#define HDAT_FADUMP_REG_TYPE_SPR 0x02
/* ID numbers used by f/w while populating certain registers */
#define HDAT_FADUMP_REG_ID_NIP 0x7D0
#define HDAT_FADUMP_REG_ID_MSR 0x7D1
#define HDAT_FADUMP_REG_ID_CCR 0x7D2
/* HDAT register entry. */
struct hdat_fadump_reg_entry {
__be32 reg_type;
__be32 reg_num;
__be64 reg_val;
} __packed;
static inline void opal_fadump_set_regval_regnum(struct pt_regs *regs,
u32 reg_type, u32 reg_num,
u64 reg_val)
{
if (reg_type == HDAT_FADUMP_REG_TYPE_GPR) {
if (reg_num < 32)
regs->gpr[reg_num] = reg_val;
return;
}
switch (reg_num) {
case SPRN_CTR:
regs->ctr = reg_val;
break;
case SPRN_LR:
regs->link = reg_val;
break;
case SPRN_XER:
regs->xer = reg_val;
break;
case SPRN_DAR:
regs->dar = reg_val;
break;
case SPRN_DSISR:
regs->dsisr = reg_val;
break;
case HDAT_FADUMP_REG_ID_NIP:
regs->nip = reg_val;
break;
case HDAT_FADUMP_REG_ID_MSR:
regs->msr = reg_val;
break;
case HDAT_FADUMP_REG_ID_CCR:
regs->ccr = reg_val;
break;
}
}
static inline void opal_fadump_read_regs(char *bufp, unsigned int regs_cnt,
unsigned int reg_entry_size,
Annotation
- Immediate include surface: `asm/reg.h`.
- Detected declarations: `struct opal_fadump_mem_struct`, `struct hdat_fadump_thread_hdr`, `struct hdat_fadump_reg_entry`, `function opal_fadump_set_regval_regnum`, `function opal_fadump_read_regs`.
- Atlas domain: Architecture Layer / arch/powerpc.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.