summaryrefslogtreecommitdiff
path: root/Base/usr/share/man/man1/bt.md
blob: bbd398fb16cbfdfb88c1e5d6d118d66b055f7dfe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
## 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)](watch.md) to emit a backtrace of pid 124, every second:

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

## See also

* [`Inspector`(1)](Inspector.md)

* [`Profiler`(1)](Profiler.md)

* [`watch`(1)](watch.md)