Lines Matching refs:to
23 \Var{byteorder} can be set to 0 to request the default byte-order of
24 the unwind target. To request a particular byte-order,
25 \Var{byteorder} can be set to any constant defined by
33 \Prog{Libunwind} uses a set of call-back routines to access the
34 information it needs to unwind a chain of stack-frames. These
35 routines are specified via the \Var{ap} argument, which points to a
38 variable must remain valid only for the duration of the call to
41 The first argument to every call-back routine is an address-space
44 call-back routine, \Prog{libunwind} sets the \Var{as} argument to the
46 argument to the value that was specified when
79 \Prog{Libunwind} invokes the \Func{find\_proc\_info}() call-back to
80 locate the information need to unwind a particular procedure. The
82 information is needed. The \Var{pip} argument is a pointer to the
83 variable used to return the desired information. The type of this
86 \Var{need\_unwind\_info} is zero if the call-back does not need to
90 \Var{need\_unwind\_info} is non-zero, valid values need to be returned
98 call-back may return -\Const{UNW\_ESTOPUNWIND} to signal the end of
103 \Prog{Libunwind} invokes the \Func{put\_unwind\_info}() call-back to
104 release the resources (such as memory) allocated by a previous call to
106 set to a non-zero value. The \Var{pip} argument has the same value as
107 the argument of the same name in the previous matching call to
109 invoke \Func{put\_unwind\_info} for calls to \Func{find\_proc\_info}()
116 call-back to obtain the address of the head of the dynamic unwind-info
120 to a variable of type \Type{unw\_word\_t} which is used to return the
122 unwind-info registration list exist, the value pointed to by
123 \Var{dliap} must be cleared to zero. \Prog{Libunwind} will cache the
126 call to \Func{unw\_flush\_cache}().
134 \Prog{Libunwind} invokes the \Func{access\_mem}() call-back to read
135 from or write to a word of memory in the target address-space. The
136 address of the word to be accessed is passed in argument \Var{addr}.
137 To read memory, \Prog{libunwind} sets argument \Var{write} to zero and
138 \Var{valp} to point to the word that receives the read value. To
139 write memory, \Prog{libunwind} sets argument \Var{write} to a non-zero
140 value and \Var{valp} to point to the word that contains the value to
141 be written. The word that \Var{valp} points to is always in the
144 routine to convert between the target's and the host's byte-order, if
153 \Prog{Libunwind} invokes the \Func{access\_reg}() call-back to read
154 from or write to a scalar (non-floating-point) CPU register. The
155 index of the register to be accessed is passed in argument
156 \Var{regnum}. To read a register, \Prog{libunwind} sets argument
157 \Var{write} to zero and \Var{valp} to point to the word that receives
158 the read value. To write a register, \Prog{libunwind} sets argument
159 \Var{write} to a non-zero value and \Var{valp} to point to the word
160 that contains the value to be written. The word that \Var{valp}
161 points to is always in the byte-order of the host-platform, regardless
163 responsibility of the call-back routine to convert between the
172 \Prog{Libunwind} invokes the \Func{access\_fpreg}() call-back to read
173 from or write to a floating-point CPU register. The index of the
174 register to be accessed is passed in argument \Var{regnum}. To read a
175 register, \Prog{libunwind} sets argument \Var{write} to zero and
176 \Var{fpvalp} to point to a variable of type \Type{unw\_fpreg\_t} that
177 receives the read value. To write a register, \Prog{libunwind} sets
178 argument \Var{write} to a non-zero value and \Var{fpvalp} to point to
179 the variable of type \Type{unw\_fpreg\_t} that contains the value to
180 be written. The word that \Var{fpvalp} points to is always in the
183 routine to convert between the target's and the host's byte-order, if
192 \Prog{Libunwind} invokes the \Func{resume}() call-back to resume
197 memory-state via calls to the \Func{access\_reg}(),
199 the call-back needs to do is perform whatever action is needed to
202 The \Func{resume} call-back is invoked only in response to a call to
214 \Prog{Libunwind} invokes the \Func{get\_proc\_name}() call-back to
217 procedure whose name is to be obtained. The \Var{bufp} argument is a
218 pointer to a character-buffer used to return the procedure name. The
222 truncated to \Var{buf\_len}\Prog{-1} bytes, with the last byte in the
223 buffer set to the NUL character and -\Const{UNW\_ENOMEM} must be
224 returned. Argument \Var{offp} is a pointer to a word which is used to
225 return the byte-offset relative to the start of the procedure whose
228 \Var{addr} set to 0x40003080 should return a value of 0x80 in the word
229 pointed to by \Var{offp} (assuming the procedure is at least 0x80
246 safe to use from a signal handler.
