This is an old revision of the document!
This trap frees previously allocated space in a user heap.
|Call Parameters||Return Parameters|
|D1.L||Size of area to be linked (back) in to the user heap.||D1.L||Corrupted.|
|A0.L||Address of the area of heap/memory to link (back) in to the user heap (Relative A6).||A0.L||Corrupted.|
|A1.L||Pointer to pointer to free space (Relative A6) or zero.||A1.L||Corrupted.|
No errors are returned by this trap.
by a single job. The job can allocate areas of this user heap for its own needs, and deallocate them as required. This stops, or reduces fragmentation of the common heap which is used by every task in the system. See here for more information on heaps.
chunk of user heap back into the user heap's free space.
This example show the use of this, and other, heap manipulation traps.