^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) /* SPDX-License-Identifier: GPL-2.0 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) #ifndef _H8300_USER_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) #define _H8300_USER_H
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) #include <asm/page.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) /* Core file format: The core file is written in such a way that gdb
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) can understand it and provide useful information to the user (under
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) linux we use the 'trad-core' bfd). There are quite a number of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) obstacles to being able to view the contents of the floating point
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) registers, and until these are solved you will not be able to view the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) contents of them. Actually, you can read in the core file and look at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) the contents of the user struct to find out what the floating point
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) registers contain.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) The actual file contents are as follows:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) UPAGE: 1 page consisting of a user struct that tells gdb what is present
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) in the file. Directly after this is a copy of the task_struct, which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) is currently not used by gdb, but it may come in useful at some point.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) All of the registers are stored as part of the upage. The upage should
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) always be only one page.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) DATA: The data area is stored. We use current->end_text to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) current->brk to pick up all of the user variables, plus any memory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) that may have been malloced. No attempt is made to determine if a page
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) is demand-zero or if a page is totally unused, we just cover the entire
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) range. All of the addresses are rounded in such a way that an integral
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) number of pages is written.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) STACK: We need the stack information in order to get a meaningful
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) backtrace. We need to write the data from (esp) to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) current->start_stack, so we round each of these off in order to be able
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) to write an integer number of pages.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) The minimum core file size is 3 pages, or 12288 bytes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) /* This is the old layout of "struct pt_regs" as of Linux 1.x, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) is still the layout used by user (the new pt_regs doesn't have
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) all registers). */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) struct user_regs_struct {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) long er1, er2, er3, er4, er5, er6;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) long er0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) long usp;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) long orig_er0;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) long ccr;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) long pc;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) /* When the kernel dumps core, it starts by dumping the user struct -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) this will be used by gdb to figure out where the data and stack segments
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) are within the file, and what virtual addresses to use. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) struct user {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) /* We start with the registers, to mimic the way that "memory" is returned
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) from the ptrace(3,...) function. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) struct user_regs_struct regs; /* Where the registers are actually stored */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) /* ptrace does not yet supply these. Someday.... */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) /* The rest of this junk is to help gdb figure out what goes where */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) unsigned long int u_tsize; /* Text segment size (pages). */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) unsigned long int u_dsize; /* Data segment size (pages). */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) unsigned long int u_ssize; /* Stack segment size (pages). */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) unsigned long start_code; /* Starting virtual address of text. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) unsigned long start_stack; /* Starting virtual address of stack area.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) This is actually the bottom of the stack,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) the top of the stack is always found in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) esp register. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) long int signal; /* Signal that caused the core dump. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) int reserved; /* No longer used */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) unsigned long u_ar0; /* Used by gdb to help find the values for */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) /* the registers. */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) unsigned long magic; /* To uniquely identify a core file */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) char u_comm[32]; /* User command that was responsible */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) #define NBPG PAGE_SIZE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) #define UPAGES 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) #define HOST_TEXT_START_ADDR (u.start_code)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) #define HOST_STACK_END_ADDR (u.start_stack + u.u_ssize * NBPG)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) #endif