Lines Matching +full:write +full:- +full:host
16 \-\- create address space for remote unwinding
35 address\-space and initializes it based on the call\-back routines
38 The call\-back routines are described in detail below. The
40 can be set to 0 to request the default byte\-order of
41 the unwind target. To request a particular byte\-order,
47 request little\-endian byte\-order and __BIG_ENDIAN
49 request big\-endian byte\-order. Whether or not a particular byte\-order
52 .SH CALL\-BACK ROUTINES
56 uses a set of call\-back routines to access the
57 information it needs to unwind a chain of stack\-frames. These
62 variable is copied into the newly\-created address space, so the
66 The first argument to every call\-back routine is an address\-space
69 application\-specified void\-pointer (arg).
71 call\-back routine, libunwind
74 address\-space on whose behalf the invocation is made and the arg
79 The synopsis and a detailed description of every call\-back routine
82 .SS CALL\-BACK ROUTINE SYNOPSIS
119 write,
131 write,
143 write,
172 call\-back to
175 argument is an instruction\-address inside the procedure whose
184 is zero if the call\-back does not need to
192 is non\-zero, valid values need to be returned
197 call\-back (see below).
200 call\-back must
203 error\-codes may be returned. In particular, this
204 call\-back may return \-UNW_ESTOPUNWIND
206 the frame\-chain.
212 call\-back to
217 set to a non\-zero value. The pip
232 call\-back to obtain the address of the head of the dynamic unwind\-info
241 address of the dynamic unwind\-info registration list. If no dynamic
242 unwind\-info registration list exist, the value pointed to by
248 enabled for the given address\-space. The cache can be cleared with a
252 call\-back must return zero. Otherwise, the negative value of one of
254 error\-codes may be returned.
260 call\-back to read
261 from or write to a word of memory in the target address\-space. The
264 sets argument write
268 write memory, libunwind
269 sets argument write
270 to a non\-zero
275 byte\-order of the host\-platform, regardless of the byte\-order of the
276 target. In other words, it is the responsibility of the call\-back
277 routine to convert between the target\&'s and the host\&'s byte\-order, if
281 call\-back must return zero. Otherwise, the negative value of one of
283 error\-codes may be returned.
289 call\-back to read
290 from or write to a scalar (non\-floating\-point) CPU register. The
295 write
298 the read value. To write a register, libunwind
300 write
301 to a non\-zero value and valp
304 points to is always in the byte\-order of the host\-platform, regardless
305 of the byte\-order of the target. In other words, it is the
306 responsibility of the call\-back routine to convert between the
307 target\&'s and the host\&'s byte\-order, if necessary.
310 call\-back must
313 error\-codes may be returned.
319 call\-back to read
320 from or write to a floating\-point CPU register. The index of the
324 sets argument write
329 receives the read value. To write a register, libunwind
331 argument write
332 to a non\-zero value and fpvalp
338 byte\-order of the host\-platform, regardless of the byte\-order of the
339 target. In other words, it is the responsibility of the call\-back
340 routine to convert between the target\&'s and the host\&'s byte\-order, if
344 call\-back must
347 error\-codes may be returned.
353 call\-back to resume
356 unwind\-cursor that identifies the stack\-frame in which execution
359 call\-back, it has already established the desired machine\- and
360 memory\-state via calls to the access_reg(),
363 call\-backs. Thus, all
364 the call\-back needs to do is perform whatever action is needed to
368 call\-back is invoked only in response to a call to
376 call\-back must return
379 error\-codes may be returned. As a special case,
380 when resuming execution in the local address space, the call\-back will
387 call\-back to
388 obtain the procedure\-name of a static (not dynamically generated)
390 is an instruction\-address within the
393 pointer to a character\-buffer used to return the procedure name. The
399 truncated to buf_len\-1
401 buffer set to the NUL character and \-UNW_ENOMEM
405 return the byte\-offset relative to the start of the procedure whose
417 call\-back must
420 error\-codes may be returned.
427 non\-NULL
429 address\-space. Otherwise, NULL
436 is thread\-safe but \fInot\fP
452 David Mosberger\-Tang