aboutsummaryrefslogtreecommitdiff
path: root/gdb
diff options
context:
space:
mode:
authorAndrew Cagney <cagney@redhat.com>2002-09-19 15:43:49 +0000
committerAndrew Cagney <cagney@redhat.com>2002-09-19 15:43:49 +0000
commit790eb8f5c4002d09f9efc482bdf68f6f60783c05 (patch)
tree4d9b8cee52f855992f7469aa4c8f07f2690a8b97 /gdb
parent0e327d91faf4950ff0b7f5dd989991aef0538e3a (diff)
downloadgdb-790eb8f5c4002d09f9efc482bdf68f6f60783c05.zip
gdb-790eb8f5c4002d09f9efc482bdf68f6f60783c05.tar.gz
gdb-790eb8f5c4002d09f9efc482bdf68f6f60783c05.tar.bz2
2002-09-19 Andrew Cagney <ac131313@redhat.com>
* gdbint.texinfo (Target Architecture Definition): Revise description of STACK_ALIGN. Add description of FRAME_ALIGN.
Diffstat (limited to 'gdb')
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdbint.texinfo27
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 <ac131313@redhat.com>
+
+ * gdbint.texinfo (Target Architecture Definition): Revise
+ description of STACK_ALIGN. Add description of FRAME_ALIGN.
+
2002-09-19 Joel Brobecker <brobecker@gnat.com>
* 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