ladybird/Base/usr/share/man/man1/bt.md
kleines Filmröllchen 66a68a9523 Base: Move GUI application man pages into their own subsection
We do not want to move POSIX utilities into subsections since they have
standard names, but we can do whatever we want with Applications :^).
This is particularly advantageous as many applications contain several
images, which declutters the man1 directory.
2023-01-08 13:35:29 +01:00

48 lines
916 B
Markdown

## 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
* [`Inspector`(1)](help://man/1/Applications/Inspector)
* [`Profiler`(1)](help://man/1/Applications/Profiler)
* [`watch`(1)](help://man/1/watch)