ladybird/Base/usr/share/man/man1/bt.md
kleines Filmröllchen 98c0c5e9e6 Help+Base: Add help://man URLs for links between man pages
The URLs of the form `help://man/<section>/<page>` link to another help
page inside the help application. All previous relative page links are
replaced by this new form. This doesn't change any behavior but it looks
much nicer :^)

Note that man doesn't handle these new links, but the previous relative
links didn't work either.
2022-01-11 00:24:57 +01:00

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