ARM VERSION 1.2 - Manual (Page 315)

Directives Reference
ARM DUI 0068B Copyright © 2000, 2001 ARM Limited. All rights reserved. 7-33
7.5 Frame description directives
This section describes the following directives:
• FRAME ADDRESS on page 7-34
• FRAME POP on page 7-35
• FRAME PUSH on page 7-36
• FRAME REGISTER on page 7-37
• FRAME RESTORE on page 7-38
• FRAME SAVE on page 7-39
• FRAME STATE REMEMBER on page 7-40
• FRAME STATE RESTORE on page 7-41
• FUNCTION or PROC on page 7-42
• ENDFUNC or ENDP on page 7-43.
Correct use of these directives:
• helps you to avoid errors in function construction, particularly when you are
modifying existing code
• allows the assembler to alert you to errors in function construction
• enables backtracing of function calls during debugging
• allows the debugger to profile assembler functions.
If you require profiling of assembler functions, but do not need frame description
directives for other purposes:
• you must use the FUNCTION and ENDFUNC , or PROC and ENDP , directives
• you can omit the other FRAME directives
• you only need to use the FUNCTION and ENDFUNC directives for the functions you
want to profile.
In DWARF 2, the canonical frame address is an address on the stack specifying where
the call frame of an interrupted function is located.