# OS_Panic

## C Specification

  `#include <nitro/os.h>`
  `void OS_Panic( const char *fmt, ...`

## Arguments

fmt | Character string output format (character string format)
... | Variable number of arguments

## Return Values

None.

## Description

This function outputs a character string.

A variable number of arguments can be given using the format character string `fmt`.

The output format is:

`<filename>:<linenumber>` Panic: <string>

`<filename> <linenumber>` are the file name and line number describing this `OS_Halt()` function. `<string>` is created from `fmt` and the variable number of arguments.

This function is used for debugging, so the final ROM version (`FINALROM`) will only stop the program (just like `OS_Terminate()` ).

## Internal Operation

`OS_Panic()` is actually a `#define` of `OSi_Panic()`. `OSi_Panic()` is compiled with weak symbols. Therefore you can overwrite them with your own function definitions.

## See Also

`OS_Warning`, `OS_Terminate`

## Revision History

11/25/2004 Added description of weak symbols.
12/01/2003 Initial version