arch/x86/include/asm/kgdb.h
Source file repositories/reference/linux-study-clean/arch/x86/include/asm/kgdb.h
File Facts
- System
- Linux kernel
- Corpus path
arch/x86/include/asm/kgdb.h- Extension
.h- Size
- 2143 bytes
- Lines
- 93
- Domain
- Architecture Layer
- Bucket
- arch/x86
- 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/ptrace.h
Detected Declarations
enum regnamesenum regnamesfunction arch_kgdb_breakpoint
Annotated Snippet
#ifndef _ASM_X86_KGDB_H
#define _ASM_X86_KGDB_H
/*
* Copyright (C) 2001-2004 Amit S. Kale
* Copyright (C) 2008 Wind River Systems, Inc.
*/
#include <asm/ptrace.h>
/*
* BUFMAX defines the maximum number of characters in inbound/outbound
* buffers at least NUMREGBYTES*2 are needed for register packets
* Longer buffer is needed to list all threads
*/
#define BUFMAX 1024
/*
* Note that this register image is in a different order than
* the register image that Linux produces at interrupt time.
*
* Linux's register image is defined by struct pt_regs in ptrace.h.
* Just why GDB uses a different order is a historical mystery.
*/
#ifdef CONFIG_X86_32
enum regnames {
GDB_AX, /* 0 */
GDB_CX, /* 1 */
GDB_DX, /* 2 */
GDB_BX, /* 3 */
GDB_SP, /* 4 */
GDB_BP, /* 5 */
GDB_SI, /* 6 */
GDB_DI, /* 7 */
GDB_PC, /* 8 also known as eip */
GDB_PS, /* 9 also known as eflags */
GDB_CS, /* 10 */
GDB_SS, /* 11 */
GDB_DS, /* 12 */
GDB_ES, /* 13 */
GDB_FS, /* 14 */
GDB_GS, /* 15 */
};
#define GDB_ORIG_AX 41
#define DBG_MAX_REG_NUM 16
#define NUMREGBYTES ((GDB_GS+1)*4)
#else /* ! CONFIG_X86_32 */
enum regnames {
GDB_AX, /* 0 */
GDB_BX, /* 1 */
GDB_CX, /* 2 */
GDB_DX, /* 3 */
GDB_SI, /* 4 */
GDB_DI, /* 5 */
GDB_BP, /* 6 */
GDB_SP, /* 7 */
GDB_R8, /* 8 */
GDB_R9, /* 9 */
GDB_R10, /* 10 */
GDB_R11, /* 11 */
GDB_R12, /* 12 */
GDB_R13, /* 13 */
GDB_R14, /* 14 */
GDB_R15, /* 15 */
GDB_PC, /* 16 */
GDB_PS, /* 17 */
GDB_CS, /* 18 */
GDB_SS, /* 19 */
GDB_DS, /* 20 */
GDB_ES, /* 21 */
GDB_FS, /* 22 */
GDB_GS, /* 23 */
};
#define GDB_ORIG_AX 57
#define DBG_MAX_REG_NUM 24
/* 17 64 bit regs and 5 32 bit regs */
#define NUMREGBYTES ((17 * 8) + (5 * 4))
#endif /* ! CONFIG_X86_32 */
static inline void arch_kgdb_breakpoint(void)
{
asm(" int $3");
}
#define BREAK_INSTR_SIZE 1
#define CACHE_FLUSH_IS_SAFE 1
#define GDB_ADJUSTS_BREAK_OFFSET
extern int kgdb_ll_trap(int cmd, const char *str,
struct pt_regs *regs, long err, int trap, int sig);
Annotation
- Immediate include surface: `asm/ptrace.h`.
- Detected declarations: `enum regnames`, `enum regnames`, `function arch_kgdb_breakpoint`.
- Atlas domain: Architecture Layer / arch/x86.
- 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.