# OS_CalcCallTraceLines

## Syntax

  `#include <nitro/os.h>`
  `int OS_CalcCallTraceLines( u32 size );`

## Arguments

size | Buffer size

## Return Values

The number of lines that can be reserved. 0 indicates that none can be reserved.

## Description

Gets how many lines of function call trace information can be reserved in a buffer of a specified size.

size has the same meaning as the value that is specified as the buffer size in `OS_InitCallTrace`. In addition to function call trace information, a region for recording a buffer terminator, current pointer, and the like also takes up space in the buffer. This function considers this type of information and obtains the number of lines of trace information that can be reserved in the specified buffer size.

If this function is compiled for debugging, it will function properly. However, if compiled for the final ROM version (FINALROM) library, it will always return 0.

## See Also

`OS_InitCallTrace, OS_CalcCallTraceBufferSize
`

## Revision History

2004/04/22 Initial version.

CONFIDENTIAL