~ubuntu-branches/ubuntu/utopic/libunwind/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/unw_create_addr_space.tex

Committer: Bazaar Package Importer
Author(s): Matthieu Delahaye
Date: 2005-04-22 11:12:14 UTC
mto: (4.1.1 sid)
mto: This revision was merged to the branch mainline in revision 3.
Revision ID: james.westby@ubuntu.com-20050422111214-0m74olipxly1ra8a

Tags: upstream-0.98.5

Import upstream version 0.98.5

files added:
config

config/compile

config/config.guess

config/config.sub

config/depcomp

config/install-sh

config/ltmain.sh

config/missing

config/mkinstalldirs

doc/unw_strerror.man

doc/unw_strerror.tex

include/ia64/jmpbuf.h

include/libunwind-common.h.in

include/libunwind-x86_64.h

include/tdep-x86_64.h

include/x86/jmpbuf.h

include/x86_64

include/x86_64/dwarf-config.h

include/x86_64/jmpbuf.h

src/dwarf/Gexpr.c

src/dwarf/Gfde.c

src/dwarf/Gparser.c

src/dwarf/Gpe.c

src/dwarf/Gstep.c

src/dwarf/Lexpr.c

src/dwarf/Lfde.c

src/dwarf/Lparser.c

src/dwarf/Lpe.c

src/dwarf/Lstep.c

src/dwarf/global.c

src/hppa/Gget_proc_info.c

src/hppa/Gget_proc_name.c

src/hppa/Gget_reg.c

src/hppa/Ginit.c

src/hppa/Ginit_local.c

src/hppa/Gregs.c

src/hppa/Gstep.c

src/hppa/Lget_proc_info.c

src/hppa/Lget_proc_name.c

src/hppa/Lget_reg.c

src/hppa/Linit.c

src/hppa/Linit_local.c

src/hppa/Lregs.c

src/hppa/Lstep.c

src/hppa/global.c

src/hppa/siglongjmp.S

src/hppa/tables.c

src/ia64/Gcreate_addr_space.c

src/ia64/Gget_proc_info.c

src/ia64/Gget_save_loc.c

src/ia64/Gglobal.c

src/ia64/Ginit.c

src/ia64/Ginit_local.c

src/ia64/Ginit_remote.c

src/ia64/Ginstall_cursor.S

src/ia64/Gis_signal_frame.c

src/ia64/Gparser.c

src/ia64/Grbs.c

src/ia64/Gregs.c

src/ia64/Gresume.c

src/ia64/Gscript.c

src/ia64/Gstep.c

src/ia64/Gtables.c

src/ia64/Lcreate_addr_space.c

src/ia64/Lget_proc_info.c

src/ia64/Lget_save_loc.c

src/ia64/Lglobal.c

src/ia64/Linit.c

src/ia64/Linit_local.c

src/ia64/Linit_remote.c

src/ia64/Linstall_cursor.S

src/ia64/Lis_signal_frame.c

src/ia64/Lparser.c

src/ia64/Lrbs.c

src/ia64/Lregs.c

src/ia64/Lresume.c

src/ia64/Lscript.c

src/ia64/Lstep.c

src/ia64/Ltables.c

src/ia64/dyn_info_list.S

src/ia64/getcontext.S

src/ia64/longjmp.S

src/ia64/mk_Gcursor_i.c

src/ia64/mk_Lcursor_i.c

src/ia64/regname.c

src/ia64/setjmp.S

src/ia64/siglongjmp.S

src/ia64/sigsetjmp.S

src/mi/strerror.c

src/unwind/unwind-internal.h

src/x86/Gcreate_addr_space.c

src/x86/Gget_proc_info.c

src/x86/Gget_save_loc.c

src/x86/Gglobal.c

src/x86/Ginit.c

src/x86/Ginit_local.c

src/x86/Ginit_remote.c

src/x86/Gis_signal_frame.c

src/x86/Gregs.c

src/x86/Gresume.c

src/x86/Gstep.c

src/x86/Lcreate_addr_space.c

src/x86/Lget_proc_info.c

src/x86/Lget_save_loc.c

src/x86/Lglobal.c

src/x86/Linit.c

src/x86/Linit_local.c

src/x86/Linit_remote.c

src/x86/Lis_signal_frame.c

src/x86/Lregs.c

src/x86/Lresume.c

src/x86/Lstep.c

src/x86/is_fpreg.c

src/x86/regname.c

src/x86/siglongjmp.S

src/x86_64

src/x86_64/Gcreate_addr_space.c

src/x86_64/Gget_proc_info.c

src/x86_64/Gget_save_loc.c

src/x86_64/Gglobal.c

src/x86_64/Ginit.c

src/x86_64/Ginit_local.c

src/x86_64/Ginit_remote.c

src/x86_64/Gis_signal_frame.c

src/x86_64/Gregs.c

src/x86_64/Gresume.c

src/x86_64/Gstep.c

src/x86_64/Lcreate_addr_space.c

src/x86_64/Lget_proc_info.c

src/x86_64/Lget_save_loc.c

src/x86_64/Lglobal.c

src/x86_64/Linit.c

src/x86_64/Linit_local.c

src/x86_64/Linit_remote.c

src/x86_64/Lis_signal_frame.c

src/x86_64/Lregs.c

src/x86_64/Lresume.c

src/x86_64/Lstep.c

src/x86_64/init.h

src/x86_64/is_fpreg.c

src/x86_64/regname.c

src/x86_64/siglongjmp.S

src/x86_64/ucontext_i.h

src/x86_64/unwind_i.h

tests/Gtest-bt.c

tests/Ltest-bt.c

tests/ia64-test-setjmp.c

tests/ident.c

tests/run-ptrace-misc

tests/test-init-remote.c

tests/test-ptrace-misc.c

tests/test-strerror.c

files removed:
aux

aux/config.guess

aux/config.sub

aux/depcomp

aux/install-sh

aux/ltmain.sh

aux/missing

aux/mkinstalldirs

include/libunwind-common.h

src/dwarf/Gexpr-dwarf.c

src/dwarf/Gfde-dwarf.c

src/dwarf/Gparser-dwarf.c

src/dwarf/Gpe-dwarf.c

src/dwarf/Gstep-dwarf.c

src/dwarf/Lexpr-dwarf.c

src/dwarf/Lfde-dwarf.c

src/dwarf/Lparser-dwarf.c

src/dwarf/Lpe-dwarf.c

src/dwarf/Lstep-dwarf.c

src/dwarf/global-dwarf.c

src/hppa/Gget_proc_info-hppa.c

src/hppa/Gget_reg-hppa.c

src/hppa/Ginit-hppa.c

src/hppa/Ginit_local-hppa.c

src/hppa/Gregs-hppa.c

src/hppa/Gstep-hppa.c

src/hppa/Lget_proc_info-hppa.c

src/hppa/Lget_proc_name-hppa.c

src/hppa/Lget_reg-hppa.c

src/hppa/Linit-hppa.c

src/hppa/Linit_local-hppa.c

src/hppa/Lregs-hppa.c

src/hppa/Lstep-hppa.c

src/hppa/global-hppa.c

src/hppa/siglongjmp-hppa.S

src/hppa/tables-hppa.c

src/ia64/Gcreate_addr_space-ia64.c

src/ia64/Gget_proc_info-ia64.c

src/ia64/Gget_save_loc-ia64.c

src/ia64/Gglobal-ia64.c

src/ia64/Ginit-ia64.c

src/ia64/Ginit_local-ia64.c

src/ia64/Ginit_remote-ia64.c

src/ia64/Ginstall_cursor-ia64.S

src/ia64/Gis_signal_frame-ia64.c

src/ia64/Gparser-ia64.c

src/ia64/Grbs-ia64.c

src/ia64/Gregs-ia64.c

src/ia64/Gresume-ia64.c

src/ia64/Gscript-ia64.c

src/ia64/Gstep-ia64.c

src/ia64/Gtables-ia64.c

src/ia64/Lcreate_addr_space-ia64.c

src/ia64/Lget_proc_info-ia64.c

src/ia64/Lget_save_loc-ia64.c

src/ia64/Lglobal-ia64.c

src/ia64/Linit-ia64.c

src/ia64/Linit_local-ia64.c

src/ia64/Linit_remote-ia64.c

src/ia64/Linstall_cursor-ia64.S

src/ia64/Lis_signal_frame-ia64.c

src/ia64/Lparser-ia64.c

src/ia64/Lrbs-ia64.c

src/ia64/Lregs-ia64.c

src/ia64/Lresume-ia64.c

src/ia64/Lscript-ia64.c

src/ia64/Lstep-ia64.c

src/ia64/Ltables-ia64.c

src/ia64/dyn_info_list-ia64.S

src/ia64/getcontext-ia64.S

src/ia64/mk_Gcursor_i-ia64.c

src/ia64/mk_Lcursor_i-ia64.c

src/ia64/regname-ia64.c

src/ia64/setjmp-ia64.S

src/ia64/siglongjmp-ia64.S

src/ia64/sigsetjmp-ia64.S

src/unwind-internal.h

src/x86/Gcreate_addr_space-x86.c

src/x86/Gget_proc_info-x86.c

src/x86/Gget_save_loc-x86.c

src/x86/Gglobal-x86.c

src/x86/Ginit-x86.c

src/x86/Ginit_local-x86.c

src/x86/Ginit_remote-x86.c

src/x86/Gis_signal_frame-x86.c

src/x86/Gregs-x86.c

src/x86/Gresume-x86.c

src/x86/Gstep-x86.c

src/x86/Lcreate_addr_space-x86.c

src/x86/Lget_proc_info-x86.c

src/x86/Lget_save_loc-x86.c

src/x86/Lglobal-x86.c

src/x86/Linit-x86.c

src/x86/Linit_local-x86.c

src/x86/Linit_remote-x86.c

src/x86/Lis_signal_frame-x86.c

src/x86/Lregs-x86.c

src/x86/Lresume-x86.c

src/x86/Lstep-x86.c

src/x86/is_fpreg-x86.c

src/x86/regname-x86.c

src/x86/siglongjmp-x86.S

tests/bt.c

files modified:
Makefile.am

Makefile.in

NEWS

README

TODO

acinclude.m4

aclocal.m4

configure

configure.in

doc/Makefile.am

doc/Makefile.in

doc/libunwind-dynamic.man

doc/libunwind-ia64.man

doc/libunwind-ptrace.man

doc/libunwind-ptrace.tex

doc/libunwind-setjmp.man

doc/libunwind.man

doc/libunwind.tex

doc/unw_create_addr_space.man

doc/unw_create_addr_space.tex

doc/unw_destroy_addr_space.man

doc/unw_destroy_addr_space.tex

doc/unw_flush_cache.man

doc/unw_get_accessors.man

doc/unw_get_fpreg.man

doc/unw_get_proc_info.man

doc/unw_get_proc_info.tex

doc/unw_get_proc_info_by_ip.man

doc/unw_get_proc_name.man

doc/unw_get_reg.man

doc/unw_init_local.man

doc/unw_init_remote.man

doc/unw_is_signal_frame.man

doc/unw_resume.man

doc/unw_set_caching_policy.man

doc/unw_set_caching_policy.tex

doc/unw_set_fpreg.man

doc/unw_set_reg.man

doc/unw_step.man

include/config.h.in

include/dwarf.h

include/internal.h

include/tdep-ia64.h

include/tdep-x86.h

src/Makefile.am

src/Makefile.in

src/dwarf/Gfind_proc_info-lsb.c

src/ia64/unwind_i.h

src/longjmp.c

src/mi/Gfind_dynamic_proc_info.c

src/mi/_ReadSLEB.c

src/os-linux.h

src/ptrace/_UPT_find_proc_info.c

src/ptrace/_UPT_get_dyn_info_list_addr.c

src/ptrace/_UPT_reg_offset.c

src/setjmp.c

src/siglongjmp.c

src/sigsetjmp.c

src/unwind/Backtrace.c

src/unwind/DeleteException.c

src/unwind/FindEnclosingFunction.c

src/unwind/ForcedUnwind.c

src/unwind/GetBSP.c

src/unwind/GetCFA.c

src/unwind/GetDataRelBase.c

src/unwind/GetGR.c

src/unwind/GetIP.c

src/unwind/GetLanguageSpecificData.c

src/unwind/GetRegionStart.c

src/unwind/GetTextRelBase.c

src/unwind/RaiseException.c

src/unwind/Resume.c

src/unwind/Resume_or_Rethrow.c

src/unwind/SetGR.c

src/unwind/SetIP.c

src/x86/init.h

tests/Makefile.am

tests/Makefile.in

tests/check-namespace.sh.in

tests/flush-cache.S

tests/ia64-test-dyn1.c

tests/ia64-test-nat-asm.S

tests/ia64-test-sig.c

tests/test-ptrace.c

tests/test-static-link-gen.c

Show diffs side-by-side

added added

removed removed

doc/unw_create_addr_space.tex

\File{\#include $<$libunwind.h$>$}\\

\Type{int} \Func{unw\_create\_addr\_space}(\Type{unw\_accessors\_t~*}\Var{ap}, \Type{int} \Var{byteorder});\\

\Type{unw\_addr\_space\_t} \Func{unw\_create\_addr\_space}(\Type{unw\_accessors\_t~*}\Var{ap}, \Type{int} \Var{byteorder});\\

\section{Description}

\Var{byteorder} can be set to 0 to request the default byte-order of

the unwind target. To request a particular byte-order,

\Var{byteorder} can be set to any constant defined by

\File{$<$endian.h$>$}. In particular, \Const{\_\_LITTLE_ENDIAN} would

\File{$<$endian.h$>$}. In particular, \Const{\_\_LITTLE\_ENDIAN} would

request little-endian byte-order and \Const{\_\_BIG\_ENDIAN} would

request big-endian byte-order. Whether or not a particular byte-order

is supported depends on the target platform.

194

unwind-cursor that identifies the stack-frame in which execution

195

should resume. By the time \Prog{libunwind} invokes the \Func{resume}

196

call-back, it has already established the desired machine- and

197

memory-state via calls to the \Func{access_reg}(),

197

memory-state via calls to the \Func{access\_reg}(),

198

\Func{access\_fpreg}, and \Func{access\_mem}() call-backs. Thus, all

199

the call-back needs to do is perform whatever action is needed to

200

actually resume execution.

216

procedure. Argument \Var{addr} is an instruction-address within the

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

219

size of this buffer is specified in argument \Var{buf_len}. The

219

size of this buffer is specified in argument \Var{buf\_len}. The

220

returned name must be terminated by a NUL character. If the

221

procedure's name is longer than \Var{buf_len} bytes, it must be

221

procedure's name is longer than \Var{buf\_len} bytes, it must be

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

245

\Func{unw\_create\_addr\_space}() is thread-safe but \emph{not}

246

safe to use from a signal handler.

247

248

\end{Description}

249

250

248

\section{See Also}

251

249

252

250

\SeeAlso{\_U\_dyn\_register(3)},

Older »