| 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. */ | 
| H. Peter Anvin | 6e16d89 | 2008-02-07 00:15:57 -0800 | [diff] [blame] | 66 | unsigned long u_ar0;		/* Used by gdb to help find the values for */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 67 | /* the registers. */ | 
|  | 68 | unsigned long magic;		/* To uniquely identify a core file */ | 
|  | 69 | char u_comm[32];		/* User command that was responsible */ | 
|  | 70 | }; | 
|  | 71 | #define NBPG PAGE_SIZE | 
|  | 72 | #define UPAGES 1 | 
|  | 73 | #define HOST_TEXT_START_ADDR (u.start_code) | 
|  | 74 | #define HOST_STACK_END_ADDR (u.start_stack + u.u_ssize * NBPG) | 
|  | 75 |  | 
|  | 76 | #endif /* _S390_USER_H */ |