Merge branch 'linus' into oprofile-v2
[linux-2.6] / include / asm-frv / user.h
1 /* user.h: FR-V core file format stuff
2  *
3  * Copyright (C) 2003 Red Hat, Inc. All Rights Reserved.
4  * Written by David Howells (dhowells@redhat.com)
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version
9  * 2 of the License, or (at your option) any later version.
10  */
11 #ifndef _ASM_USER_H
12 #define _ASM_USER_H
13
14 #include <asm/page.h>
15 #include <asm/registers.h>
16
17 /* Core file format: The core file is written in such a way that gdb
18  * can understand it and provide useful information to the user (under
19  * linux we use the 'trad-core' bfd).  There are quite a number of
20  * obstacles to being able to view the contents of the floating point
21  * registers, and until these are solved you will not be able to view
22  * the contents of them.  Actually, you can read in the core file and
23  * look at the contents of the user struct to find out what the
24  * floating point registers contain.
25  *
26  * The actual file contents are as follows:
27  * UPAGE:
28  *   1 page consisting of a user struct that tells gdb what is present
29  *   in the file.  Directly after this is a copy of the task_struct,
30  *   which is currently not used by gdb, but it may come in useful at
31  *   some point.  All of the registers are stored as part of the
32  *   upage.  The upage should always be only one page.
33  *
34  * DATA:
35  *   The data area is stored.  We use current->end_text to
36  *   current->brk to pick up all of the user variables, plus any
37  *   memory that may have been malloced.  No attempt is made to
38  *   determine if a page is demand-zero or if a page is totally
39  *   unused, we just cover the entire range.  All of the addresses are
40  *   rounded in such a way that an integral number of pages is
41  *   written.
42  *
43  * STACK:
44  *   We need the stack information in order to get a meaningful
45  *   backtrace.  We need to write the data from (esp) to
46  *   current->start_stack, so we round each of these off in order to
47  *   be able to write an integer number of pages.  The minimum core
48  *   file size is 3 pages, or 12288 bytes.
49  */
50
51 /* When the kernel dumps core, it starts by dumping the user struct -
52  * this will be used by gdb to figure out where the data and stack segments
53  *  are within the file, and what virtual addresses to use.
54  */
55 struct user {
56         /* We start with the registers, to mimic the way that "memory" is returned
57          * from the ptrace(3,...) function.  */
58         struct user_context     regs;
59
60         /* The rest of this junk is to help gdb figure out what goes where */
61         unsigned long           u_tsize;        /* Text segment size (pages). */
62         unsigned long           u_dsize;        /* Data segment size (pages). */
63         unsigned long           u_ssize;        /* Stack segment size (pages). */
64         unsigned long           start_code;     /* Starting virtual address of text. */
65         unsigned long           start_stack;    /* Starting virtual address of stack area.
66                                                  * This is actually the bottom of the stack,
67                                                  * the top of the stack is always found in the
68                                                  * esp register.  */
69         long int                signal;         /* Signal that caused the core dump. */
70
71         unsigned long           magic;          /* To uniquely identify a core file */
72         char                    u_comm[32];     /* User command that was responsible */
73 };
74
75 #define NBPG                    PAGE_SIZE
76 #define UPAGES                  1
77 #define HOST_TEXT_START_ADDR    (u.start_code)
78 #define HOST_STACK_END_ADDR     (u.start_stack + u.u_ssize * NBPG)
79
80 #endif