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