Newer
Older
minerva / Base / usr / share / man / man1 / bt.md
@minerva minerva on 13 Jul 871 bytes Initial commit
## Name

bt - view the backtrace of the specified process

## Synopsis

```**sh
$ bt <pid>
```

## Description

This program is used to inspect the current executable state of a process.
It will read the stack of each thread in the process, and symbolicate the
addresses for each frame in the stack producing a backtrace.

**NOTE**:

-   Kernel addresses will not be available unless you are super user.

-   If Kernel addresses are available, they will not be symbolicated unless
    the current user has access to the `/boot/Kernel` file.

## Arguments

-   `pid`: Process ID

## Examples

View all stacks of pid number 10:

```sh
$ bt 10
```

Use [`watch`(1)](help://man/1/watch) to emit a backtrace of pid 124, every second:

```sh
$ watch -n 1 -- bt 124
```

## See also

-   [`Profiler`(1)](help://man/1/Applications/Profiler)

-   [`watch`(1)](help://man/1/watch)