# OS_Halt

## Syntax

  `#include <nitro/os.h>`
  `void OS_Halt( void );`

## Arguments

None.

## Return Values

None.

## Description

This function puts the CPU in the HALT state.

If there is an interrupt to return from the `HALT` state, a return from the function occurs.

## Internal Operation

For ARM9, HALT status is caused by access to the CP15 register 7 of the system control coprocessor 15. For ARM7, HALT status is caused by calling the system call.

## See Also

`OS_Panic`, `OS_Terminate`

## Revision History

2004/04/22 Added Internal Operation
2004/04/05 Added description of returning from HALT state due to an interrupt
2004/02/17 Initial version.

CONFIDENTIAL