diff --git a/doc/unw_getcontext.man b/doc/unw_getcontext.man index 3ec0bf41..c13860bb 100644 --- a/doc/unw_getcontext.man +++ b/doc/unw_getcontext.man @@ -1,5 +1,5 @@ '\" t -.\" Manual page created with latex2man on Tue Jan 20 16:44:37 PST 2004 +.\" Manual page created with latex2man on Tue Mar 30 16:50:17 PST 2004 .\" NOTE: This file is generated, DO NOT EDIT. .de Vb .ft CW @@ -10,7 +10,7 @@ .fi .. -.TH "UNW\\_GETCONTEXT" "3" "20 January 2004" "Programming Library " "Programming Library " +.TH "UNW\\_GETCONTEXT" "3" "30 March 2004" "Programming Library " "Programming Library " .SH NAME unw_getcontext \-\- get initial machine\-state @@ -41,6 +41,27 @@ stack\-pointer, will be stored. This routine is normally implemented as a macro and applications should not attempt to take its address. .PP +.SH PLATFORM\-SPECIFIC NOTES + +.PP +On IA\-64, unw_context_t +has a layout that is compatible with +that of ucontext_t +and such structures can be initialized with +getcontext() +instead of unw_getcontext(). +However, the +reverse is \fInot\fP +true and it is \fInot\fP +safe to use structures +initialized by unw_getcontext() +in places where a structure +initialized by getcontext() +is expected. The reason for this +asymmetry is that unw_getcontext() +is optimized for maximum +performance and does not, for example, save the signal mask. +.PP .SH RETURN VALUE .PP