# OS_Set*ArenaHi

## C Specification

      #include <nitro/os.h>

      void OS_SetArenaHi( OSArenaId id, void* newHi );

      void OS_SetMainArenaHi( void* newHi );
      void OS_SetSubPrivArenaHi( void* newHi );
      void OS_SetMainExArenaHi( void* newHi );
      void OS_SetITCMArenaHi( void* newHi );
      void OS_SetDTCMArenaHi( void* newHi );
      void OS_SetSharedArenaHi( void* newHi );
      void OS_SetWramMainArenaHi( void* newHi );
      void OS_SetWramSubArenaHi( void* newHi );
      void OS_SetWramSubPrivArenaHi( void* newHi );

## Arguments

id | Arena ID
newHi | Address of the arena's upper boundary

## Return Values

None.

## Description

This function sets the arena's upper boundary. `id` specifies an arena using an arena ID. For details on arena ID see `OS_InitArena()`. For details on arena ID, see `OS_InitArena()`.

> (Example)
> `// Main Memory Arena Settings
> OS_SetArenaLo( OS_ARENA_MAIN, (void*)__bss_end__ );
> OS_SetArenaHi( OS_ARENA_MAIN, (void*)((u32)__bss_end__ + 0x3000) )`;

`OS_SetMainArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_MAIN, ... )`.
`OS_SetSubPrivArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_MAIN_SUBPRIV, ... )`.
`OS_SetMainExArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_MAINEX, ... )`.
`OS_SetITCMArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_ITCM, ... )`.
`OS_SetDTCMArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_DTCM, ... )`.
`OS_SetSharedArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_SHARED, ... )`.
`OS_SetWramMainArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_WRAM_MAIN, ... )`.
`OS_SetWramSubArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_WRAM_SUB, ... )`.
`OS_SetWramSubPrivArenaHi` is the inline function for `OS_SetArenaHi( OS_ARENA_WRAM_SUBPRIV, ... )`.

## See Also

`OS_InitArena, OS_SetArenaLo, OS_GetArenaHi
`

## Revision History

02/19/2004 Changed the number of arenas from 6 to 9
01/16/2004 Added MainEx
01/06/2004 Initial version