Merge git://git.kernel.org/pub/scm/linux/kernel/git/x86/linux-2.6-x86
[linux-2.6] / include / asm-ia64 / unwind.h
1 #ifndef _ASM_IA64_UNWIND_H
2 #define _ASM_IA64_UNWIND_H
3
4 /*
5  * Copyright (C) 1999-2000, 2003 Hewlett-Packard Co
6  *      David Mosberger-Tang <davidm@hpl.hp.com>
7  *
8  * A simple API for unwinding kernel stacks.  This is used for
9  * debugging and error reporting purposes.  The kernel doesn't need
10  * full-blown stack unwinding with all the bells and whitles, so there
11  * is not much point in implementing the full IA-64 unwind API (though
12  * it would of course be possible to implement the kernel API on top
13  * of it).
14  */
15
16 struct task_struct;     /* forward declaration */
17 struct switch_stack;    /* forward declaration */
18
19 enum unw_application_register {
20         UNW_AR_BSP,
21         UNW_AR_BSPSTORE,
22         UNW_AR_PFS,
23         UNW_AR_RNAT,
24         UNW_AR_UNAT,
25         UNW_AR_LC,
26         UNW_AR_EC,
27         UNW_AR_FPSR,
28         UNW_AR_RSC,
29         UNW_AR_CCV,
30         UNW_AR_CSD,
31         UNW_AR_SSD
32 };
33
34 /*
35  * The following declarations are private to the unwind
36  * implementation:
37  */
38
39 struct unw_stack {
40         unsigned long limit;
41         unsigned long top;
42 };
43
44 #define UNW_FLAG_INTERRUPT_FRAME        (1UL << 0)
45
46 /*
47  * No user of this module should every access this structure directly
48  * as it is subject to change.  It is declared here solely so we can
49  * use automatic variables.
50  */
51 struct unw_frame_info {
52         struct unw_stack regstk;
53         struct unw_stack memstk;
54         unsigned int flags;
55         short hint;
56         short prev_script;
57
58         /* current frame info: */
59         unsigned long bsp;              /* backing store pointer value */
60         unsigned long sp;               /* stack pointer value */
61         unsigned long psp;              /* previous sp value */
62         unsigned long ip;               /* instruction pointer value */
63         unsigned long pr;               /* current predicate values */
64         unsigned long *cfm_loc;         /* cfm save location (or NULL) */
65         unsigned long pt;               /* struct pt_regs location */
66
67         struct task_struct *task;
68         struct switch_stack *sw;
69
70         /* preserved state: */
71         unsigned long *bsp_loc;         /* previous bsp save location */
72         unsigned long *bspstore_loc;
73         unsigned long *pfs_loc;
74         unsigned long *rnat_loc;
75         unsigned long *rp_loc;
76         unsigned long *pri_unat_loc;
77         unsigned long *unat_loc;
78         unsigned long *pr_loc;
79         unsigned long *lc_loc;
80         unsigned long *fpsr_loc;
81         struct unw_ireg {
82                 unsigned long *loc;
83                 struct unw_ireg_nat {
84                         unsigned long type : 3;         /* enum unw_nat_type */
85                         signed long off : 61;           /* NaT word is at loc+nat.off */
86                 } nat;
87         } r4, r5, r6, r7;
88         unsigned long *b1_loc, *b2_loc, *b3_loc, *b4_loc, *b5_loc;
89         struct ia64_fpreg *f2_loc, *f3_loc, *f4_loc, *f5_loc, *fr_loc[16];
90 };
91
92 /*
93  * The official API follows below:
94  */
95
96 struct unw_table_entry {
97         u64 start_offset;
98         u64 end_offset;
99         u64 info_offset;
100 };
101
102 /*
103  * Initialize unwind support.
104  */
105 extern void unw_init (void);
106
107 extern void *unw_add_unwind_table (const char *name, unsigned long segment_base, unsigned long gp,
108                                    const void *table_start, const void *table_end);
109
110 extern void unw_remove_unwind_table (void *handle);
111
112 /*
113  * Prepare to unwind blocked task t.
114  */
115 extern void unw_init_from_blocked_task (struct unw_frame_info *info, struct task_struct *t);
116
117 extern void unw_init_frame_info (struct unw_frame_info *info, struct task_struct *t,
118                                  struct switch_stack *sw);
119
120 /*
121  * Prepare to unwind the currently running thread.
122  */
123 extern void unw_init_running (void (*callback)(struct unw_frame_info *info, void *arg), void *arg);
124
125 /*
126  * Unwind to previous to frame.  Returns 0 if successful, negative
127  * number in case of an error.
128  */
129 extern int unw_unwind (struct unw_frame_info *info);
130
131 /*
132  * Unwind until the return pointer is in user-land (or until an error
133  * occurs).  Returns 0 if successful, negative number in case of
134  * error.
135  */
136 extern int unw_unwind_to_user (struct unw_frame_info *info);
137
138 #define unw_is_intr_frame(info) (((info)->flags & UNW_FLAG_INTERRUPT_FRAME) != 0)
139
140 static inline int
141 unw_get_ip (struct unw_frame_info *info, unsigned long *valp)
142 {
143         *valp = (info)->ip;
144         return 0;
145 }
146
147 static inline int
148 unw_get_sp (struct unw_frame_info *info, unsigned long *valp)
149 {
150         *valp = (info)->sp;
151         return 0;
152 }
153
154 static inline int
155 unw_get_psp (struct unw_frame_info *info, unsigned long *valp)
156 {
157         *valp = (info)->psp;
158         return 0;
159 }
160
161 static inline int
162 unw_get_bsp (struct unw_frame_info *info, unsigned long *valp)
163 {
164         *valp = (info)->bsp;
165         return 0;
166 }
167
168 static inline int
169 unw_get_cfm (struct unw_frame_info *info, unsigned long *valp)
170 {
171         *valp = *(info)->cfm_loc;
172         return 0;
173 }
174
175 static inline int
176 unw_set_cfm (struct unw_frame_info *info, unsigned long val)
177 {
178         *(info)->cfm_loc = val;
179         return 0;
180 }
181
182 static inline int
183 unw_get_rp (struct unw_frame_info *info, unsigned long *val)
184 {
185         if (!info->rp_loc)
186                 return -1;
187         *val = *info->rp_loc;
188         return 0;
189 }
190
191 extern int unw_access_gr (struct unw_frame_info *, int, unsigned long *, char *, int);
192 extern int unw_access_br (struct unw_frame_info *, int, unsigned long *, int);
193 extern int unw_access_fr (struct unw_frame_info *, int, struct ia64_fpreg *, int);
194 extern int unw_access_ar (struct unw_frame_info *, int, unsigned long *, int);
195 extern int unw_access_pr (struct unw_frame_info *, unsigned long *, int);
196
197 static inline int
198 unw_set_gr (struct unw_frame_info *i, int n, unsigned long v, char nat)
199 {
200         return unw_access_gr(i, n, &v, &nat, 1);
201 }
202
203 static inline int
204 unw_set_br (struct unw_frame_info *i, int n, unsigned long v)
205 {
206         return unw_access_br(i, n, &v, 1);
207 }
208
209 static inline int
210 unw_set_fr (struct unw_frame_info *i, int n, struct ia64_fpreg v)
211 {
212         return unw_access_fr(i, n, &v, 1);
213 }
214
215 static inline int
216 unw_set_ar (struct unw_frame_info *i, int n, unsigned long v)
217 {
218         return unw_access_ar(i, n, &v, 1);
219 }
220
221 static inline int
222 unw_set_pr (struct unw_frame_info *i, unsigned long v)
223 {
224         return unw_access_pr(i, &v, 1);
225 }
226
227 #define unw_get_gr(i,n,v,nat)   unw_access_gr(i,n,v,nat,0)
228 #define unw_get_br(i,n,v)       unw_access_br(i,n,v,0)
229 #define unw_get_fr(i,n,v)       unw_access_fr(i,n,v,0)
230 #define unw_get_ar(i,n,v)       unw_access_ar(i,n,v,0)
231 #define unw_get_pr(i,v)         unw_access_pr(i,v,0)
232
233 #endif /* _ASM_UNWIND_H */