IPC@CHIP® RTOS-PPC – API Documentation

Header image

Main page


#define setHeapIncrement ( size   )     initLinkerSymbol(__heap_increment, size)

This macro function controls the __heap_increment constant, which specifies the minimum amount of additional memory requested from the system when the program heap space needs to be increased. The default value is 8192 bytes.

For programs which are expected to use lots of heap space, attention should be given to carefully select both this constant and the __heap_initial_size constant. Otherwise system performance can be degraded due to excessive system heap fragmentation and application program page table size. Allocating a few large blocks places a lighter load on the system then would allocating many additional small memory blocks from the system.

Note that this constant plays no role when the program's heap has been recompiled with the HEAP_CAN_GROW compilation option disabled.

The size must be a constant expression.

Example:
This would be placed in one of your C files outside the scope of any module.

Since:
SC2x3 V1.00 - CLIB V1.00
Compatibility:
This macro does not exists in the SC1x, SC2x and SC1x3 C-Library.
See also:
setHeapInitialSize      setStackSize      setProgramAttributes
setSpaceReserve





Top of page | Main page

Copyright © 2017 Beck IPC GmbH
Generated on Thu Jan 26 16:21:36 2017 by Doxygen 1.6.1