| 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 */ |