1 #ifndef _ASM_IA64_UNWIND_H
2 #define _ASM_IA64_UNWIND_H
5 * Copyright (C) 1999-2000 Hewlett-Packard Co
6 * Copyright (C) 1999-2000 David Mosberger-Tang <davidm@hpl.hp.com>
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
16 struct task_struct; /* forward declaration */
17 struct switch_stack; /* forward declaration */
19 enum unw_application_register {
33 * The following declarations are private to the unwind
42 #define UNW_FLAG_INTERRUPT_FRAME (1UL << 0)
45 * No user of this module should every access this structure directly
46 * as it is subject to change. It is declared here solely so we can
47 * use automatic variables.
49 struct unw_frame_info {
50 struct unw_stack regstk;
51 struct unw_stack memstk;
56 /* current frame info: */
57 unsigned long bsp; /* backing store pointer value */
58 unsigned long sp; /* stack pointer value */
59 unsigned long psp; /* previous sp value */
60 unsigned long ip; /* instruction pointer value */
61 unsigned long pr; /* current predicate values */
62 unsigned long *cfm_loc; /* cfm save location (or NULL) */
64 struct task_struct *task;
65 struct switch_stack *sw;
67 /* preserved state: */
68 unsigned long *bsp_loc; /* previous bsp save location */
69 unsigned long *bspstore_loc;
70 unsigned long *pfs_loc;
71 unsigned long *rnat_loc;
72 unsigned long *rp_loc;
73 unsigned long *pri_unat_loc;
74 unsigned long *unat_loc;
75 unsigned long *pr_loc;
76 unsigned long *lc_loc;
77 unsigned long *fpsr_loc;
81 long type : 3; /* enum unw_nat_type */
82 signed long off : 61; /* NaT word is at loc+nat.off */
85 unsigned long *b1_loc, *b2_loc, *b3_loc, *b4_loc, *b5_loc;
86 struct ia64_fpreg *f2_loc, *f3_loc, *f4_loc, *f5_loc, *fr_loc[16];
90 * The official API follows below:
94 * Initialize unwind support.
96 extern void unw_init (void);
97 extern void unw_create_gate_table (void);
99 extern void *unw_add_unwind_table (const char *name, unsigned long segment_base, unsigned long gp,
100 const void *table_start, const void *table_end);
102 extern void unw_remove_unwind_table (void *handle);
105 * Prepare to unwind blocked task t.
107 extern void unw_init_from_blocked_task (struct unw_frame_info *info, struct task_struct *t);
109 extern void unw_init_frame_info (struct unw_frame_info *info, struct task_struct *t,
110 struct switch_stack *sw);
113 * Prepare to unwind the currently running thread.
115 extern void unw_init_running (void (*callback)(struct unw_frame_info *info, void *arg), void *arg);
118 * Unwind to previous to frame. Returns 0 if successful, negative
119 * number in case of an error.
121 extern int unw_unwind (struct unw_frame_info *info);
124 * Unwind until the return pointer is in user-land (or until an error
125 * occurs). Returns 0 if successful, negative number in case of
128 extern int unw_unwind_to_user (struct unw_frame_info *info);
130 #define unw_is_intr_frame(info) (((info)->flags & UNW_FLAG_INTERRUPT_FRAME) != 0)
133 unw_get_ip (struct unw_frame_info *info, unsigned long *valp)
140 unw_get_sp (struct unw_frame_info *info, unsigned long *valp)
147 unw_get_psp (struct unw_frame_info *info, unsigned long *valp)
154 unw_get_bsp (struct unw_frame_info *info, unsigned long *valp)
161 unw_get_cfm (struct unw_frame_info *info, unsigned long *valp)
163 *valp = *(info)->cfm_loc;
168 unw_set_cfm (struct unw_frame_info *info, unsigned long val)
170 *(info)->cfm_loc = val;
175 unw_get_rp (struct unw_frame_info *info, unsigned long *val)
179 *val = *info->rp_loc;
183 extern int unw_access_gr (struct unw_frame_info *, int, unsigned long *, char *, int);
184 extern int unw_access_br (struct unw_frame_info *, int, unsigned long *, int);
185 extern int unw_access_fr (struct unw_frame_info *, int, struct ia64_fpreg *, int);
186 extern int unw_access_ar (struct unw_frame_info *, int, unsigned long *, int);
187 extern int unw_access_pr (struct unw_frame_info *, unsigned long *, int);
190 unw_set_gr (struct unw_frame_info *i, int n, unsigned long v, char nat)
192 return unw_access_gr(i, n, &v, &nat, 1);
196 unw_set_br (struct unw_frame_info *i, int n, unsigned long v)
198 return unw_access_br(i, n, &v, 1);
202 unw_set_fr (struct unw_frame_info *i, int n, struct ia64_fpreg v)
204 return unw_access_fr(i, n, &v, 1);
208 unw_set_ar (struct unw_frame_info *i, int n, unsigned long v)
210 return unw_access_ar(i, n, &v, 1);
214 unw_set_pr (struct unw_frame_info *i, unsigned long v)
216 return unw_access_pr(i, &v, 1);
219 #define unw_get_gr(i,n,v,nat) unw_access_gr(i,n,v,nat,0)
220 #define unw_get_br(i,n,v) unw_access_br(i,n,v,0)
221 #define unw_get_fr(i,n,v) unw_access_fr(i,n,v,0)
222 #define unw_get_ar(i,n,v) unw_access_ar(i,n,v,0)
223 #define unw_get_pr(i,v) unw_access_pr(i,v,0)
225 #endif /* _ASM_UNWIND_H */