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