Appendix A: System Routines — Memory Management
863
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
HeapWalk
Declaration:
BOOL
HeapWalk
(WORD
Function
)
Category(ies):
Memory Management
Description:
Walk the heap to verify it is valid, print the status of the heap, print the size
of each heap block and its handle, or print the symbol table. The
HeapWalk
routine uses
LIO_SendData
to send the output to the link
cable. You can connect the TI
-
89 or TI
-
92 Plus through the gray-link cable
to a program like HyperTerminal to view the output.
Inputs:
H_WALK_VERIFY, H_WALK_STATUS, H_WALK_DUMP, H_WALK_SYM
Outputs:
TRUE is returned for functions H_WALK_VERIFY, H_WALK_STATUS,
and H_WALK_DUMP if the heap is valid or FALSE if there is an error in the
heap.
The resulting print to the link port depends on the input.
H_WALK_VERIFY — Prints nothing.
H_WALK_STATUS — Prints the total free space, maximum free block,
number of used and free blocks, and the number
of locked blocks.
H_WALK_DUMP — Prints the heap status and the size of the heap
block for each handle in the system.
H_WALK_SYM — Prints the entire symbol table.
Assumptions:
None
Side Effects:
None
Availability:
On AMS 2.00 and higher. H_WALK_SYM is only available on 2.04 and
above. See
SymFindFoldername
for the code that does H_WALK_SYM.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: HeapShuffle
(continued)