Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | #ifndef _I386_USER_H |
| 2 | #define _I386_USER_H |
| 3 | |
| 4 | #include <asm/page.h> |
| 5 | /* Core file format: The core file is written in such a way that gdb |
| 6 | can understand it and provide useful information to the user (under |
| 7 | linux we use the 'trad-core' bfd). There are quite a number of |
| 8 | obstacles to being able to view the contents of the floating point |
| 9 | registers, and until these are solved you will not be able to view the |
| 10 | contents of them. Actually, you can read in the core file and look at |
| 11 | the contents of the user struct to find out what the floating point |
| 12 | registers contain. |
| 13 | The actual file contents are as follows: |
| 14 | UPAGE: 1 page consisting of a user struct that tells gdb what is present |
| 15 | in the file. Directly after this is a copy of the task_struct, which |
| 16 | is currently not used by gdb, but it may come in useful at some point. |
| 17 | All of the registers are stored as part of the upage. The upage should |
| 18 | always be only one page. |
| 19 | DATA: The data area is stored. We use current->end_text to |
| 20 | current->brk to pick up all of the user variables, plus any memory |
| 21 | that may have been malloced. No attempt is made to determine if a page |
| 22 | is demand-zero or if a page is totally unused, we just cover the entire |
| 23 | range. All of the addresses are rounded in such a way that an integral |
| 24 | number of pages is written. |
| 25 | STACK: We need the stack information in order to get a meaningful |
| 26 | backtrace. We need to write the data from (esp) to |
| 27 | current->start_stack, so we round each of these off in order to be able |
| 28 | to write an integer number of pages. |
| 29 | The minimum core file size is 3 pages, or 12288 bytes. |
| 30 | */ |
| 31 | |
| 32 | /* |
| 33 | * Pentium III FXSR, SSE support |
| 34 | * Gareth Hughes <gareth@valinux.com>, May 2000 |
| 35 | * |
| 36 | * Provide support for the GDB 5.0+ PTRACE_{GET|SET}FPXREGS requests for |
| 37 | * interacting with the FXSR-format floating point environment. Floating |
| 38 | * point data can be accessed in the regular format in the usual manner, |
| 39 | * and both the standard and SIMD floating point data can be accessed via |
| 40 | * the new ptrace requests. In either case, changes to the FPU environment |
| 41 | * will be reflected in the task's state as expected. |
| 42 | */ |
| 43 | |
| 44 | struct user_i387_struct { |
| 45 | long cwd; |
| 46 | long swd; |
| 47 | long twd; |
| 48 | long fip; |
| 49 | long fcs; |
| 50 | long foo; |
| 51 | long fos; |
| 52 | long st_space[20]; /* 8*10 bytes for each FP-reg = 80 bytes */ |
| 53 | }; |
| 54 | |
| 55 | struct user_fxsr_struct { |
| 56 | unsigned short cwd; |
| 57 | unsigned short swd; |
| 58 | unsigned short twd; |
| 59 | unsigned short fop; |
| 60 | long fip; |
| 61 | long fcs; |
| 62 | long foo; |
| 63 | long fos; |
| 64 | long mxcsr; |
| 65 | long reserved; |
| 66 | long st_space[32]; /* 8*16 bytes for each FP-reg = 128 bytes */ |
| 67 | long xmm_space[32]; /* 8*16 bytes for each XMM-reg = 128 bytes */ |
| 68 | long padding[56]; |
| 69 | }; |
| 70 | |
| 71 | /* |
| 72 | * This is the old layout of "struct pt_regs", and |
| 73 | * is still the layout used by user mode (the new |
| 74 | * pt_regs doesn't have all registers as the kernel |
| 75 | * doesn't use the extra segment registers) |
| 76 | */ |
| 77 | struct user_regs_struct { |
H. Peter Anvin | 153d5f2 | 2008-01-30 13:30:56 +0100 | [diff] [blame] | 78 | unsigned long bx; |
| 79 | unsigned long cx; |
| 80 | unsigned long dx; |
| 81 | unsigned long si; |
| 82 | unsigned long di; |
| 83 | unsigned long bp; |
| 84 | unsigned long ax; |
| 85 | unsigned long ds; |
| 86 | unsigned long es; |
| 87 | unsigned long fs; |
| 88 | unsigned long gs; |
| 89 | unsigned long orig_ax; |
| 90 | unsigned long ip; |
| 91 | unsigned long cs; |
| 92 | unsigned long flags; |
| 93 | unsigned long sp; |
| 94 | unsigned long ss; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 95 | }; |
| 96 | |
| 97 | /* When the kernel dumps core, it starts by dumping the user struct - |
| 98 | this will be used by gdb to figure out where the data and stack segments |
| 99 | are within the file, and what virtual addresses to use. */ |
| 100 | struct user{ |
| 101 | /* We start with the registers, to mimic the way that "memory" is returned |
| 102 | from the ptrace(3,...) function. */ |
| 103 | struct user_regs_struct regs; /* Where the registers are actually stored */ |
| 104 | /* ptrace does not yet supply these. Someday.... */ |
| 105 | int u_fpvalid; /* True if math co-processor being used. */ |
| 106 | /* for this mess. Not yet used. */ |
| 107 | struct user_i387_struct i387; /* Math Co-processor registers. */ |
| 108 | /* The rest of this junk is to help gdb figure out what goes where */ |
| 109 | unsigned long int u_tsize; /* Text segment size (pages). */ |
| 110 | unsigned long int u_dsize; /* Data segment size (pages). */ |
| 111 | unsigned long int u_ssize; /* Stack segment size (pages). */ |
| 112 | unsigned long start_code; /* Starting virtual address of text. */ |
| 113 | unsigned long start_stack; /* Starting virtual address of stack area. |
| 114 | This is actually the bottom of the stack, |
| 115 | the top of the stack is always found in the |
| 116 | esp register. */ |
| 117 | long int signal; /* Signal that caused the core dump. */ |
| 118 | int reserved; /* No longer used */ |
| 119 | struct user_pt_regs * u_ar0; /* Used by gdb to help find the values for */ |
| 120 | /* the registers. */ |
| 121 | struct user_i387_struct* u_fpstate; /* Math Co-processor pointer. */ |
| 122 | unsigned long magic; /* To uniquely identify a core file */ |
| 123 | char u_comm[32]; /* User command that was responsible */ |
| 124 | int u_debugreg[8]; |
| 125 | }; |
| 126 | #define NBPG PAGE_SIZE |
| 127 | #define UPAGES 1 |
| 128 | #define HOST_TEXT_START_ADDR (u.start_code) |
| 129 | #define HOST_STACK_END_ADDR (u.start_stack + u.u_ssize * NBPG) |
| 130 | |
| 131 | #endif /* _I386_USER_H */ |