> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QSH Trace

**Header:** `utils/inc/qshTrace.h`

## Functions

### `QSH_TRACE_ENABLE`

```cpp theme={null}
void QSH_TRACE_ENABLE(bool enable)
```

## Macros

### `ATRACE_TAG`

```c theme={null}
#define ATRACE_TAG ATRACE_TAG_ALWAYS
```

### `QSH_TRACE_INT64`

```c theme={null}
#define QSH_TRACE_INT64 ({\
    if (CC_UNLIKELY(qsh_trace_enabled)) { \
        ATRACE_INT64(name, value); \
    } \
})
```

### `QSH_TRACE_BEGIN`

```c theme={null}
#define QSH_TRACE_BEGIN ({\
    if (CC_UNLIKELY(qsh_trace_enabled)) { \
        ATRACE_BEGIN(name); \
    } \
})
```

### `QSH_TRACE_END`

```c theme={null}
#define QSH_TRACE_END ({\
    if (CC_UNLIKELY(qsh_trace_enabled)) { \
        ATRACE_END(); \
    } \
})
```

## Variables

### `qsh_trace_enabled`

```cpp theme={null}
bool qsh_trace_enabled
```