From 790eb8f5c4002d09f9efc482bdf68f6f60783c05 Mon Sep 17 00:00:00 2001 From: Andrew Cagney Date: Thu, 19 Sep 2002 15:43:49 +0000 Subject: [PATCH] 2002-09-19 Andrew Cagney * gdbint.texinfo (Target Architecture Definition): Revise description of STACK_ALIGN. Add description of FRAME_ALIGN. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdbint.texinfo | 27 +++++++++++++++++++++++++-- 2 files changed, 30 insertions(+), 2 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 2047963..44bf420 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2002-09-19 Andrew Cagney + + * gdbint.texinfo (Target Architecture Definition): Revise + description of STACK_ALIGN. Add description of FRAME_ALIGN. + 2002-09-19 Joel Brobecker * gdbint.texinfo (Target Conditionals): Document the new diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index b2e81a5..1c3743b 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -3175,6 +3175,23 @@ Define this to an expression that returns 1 if the function invocation represented by @var{fi} does not have a stack frame associated with it. Otherwise return 0. +@item frame_align (@var{address}) +@anchor{frame_align} +@findex frame_align +Define this to adjust @var{address} so that it meets the alignment +requirements for the start of a new stack frame. A stack frame's +alignment requirements are typically stronger than a target processors +stack alignment requirements (@pxref{STACK_ALIGN}). + +This function is used to ensure that, when creating a dummy frame, both +the initial stack pointer and (if needed) the address of the return +value are correctly aligned. + +Unlike @code{STACK_ALIGN}, this function always adjusts the address in +the direction of stack growth. + +By default, no frame based stack alignment is performed. + @item FRAME_ARGS_ADDRESS_CORRECT @findex FRAME_ARGS_ADDRESS_CORRECT See @file{stack.c}. @@ -3690,9 +3707,15 @@ declarations) into @value{GDBN} regnums. If not defined, no conversion will be done. @item STACK_ALIGN (@var{addr}) +@anchor{STACK_ALIGN} @findex STACK_ALIGN -Define this to adjust the address to the alignment required for the -processor's stack. +Define this to increase @var{addr} so that it meets the alignment +requirements for the processor's stack. + +Unlike @ref{frame_align}, this function always adjusts @var{addr} +upwards. + +By default, no stack alignment is performed. @item STEP_SKIPS_DELAY (@var{addr}) @findex STEP_SKIPS_DELAY -- 2.7.4