Skip to content

Commit 1cf8423

Browse files
committed
Update the samply crate's internal README. Fixes #249.
1 parent 5b49668 commit 1cf8423

File tree

1 file changed

+9
-16
lines changed

1 file changed

+9
-16
lines changed

samply/README.md

Lines changed: 9 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,19 @@
11
# samply
22

3-
`samply` is intended to become a command line CPU profiler for macOS, Linux and Windows.
3+
samply is a command line CPU profiler which uses the [Firefox profiler](https://profiler.firefox.com/) as its UI.
44

5-
At the moment, the macOS implementation works best.
6-
The Linux implementation is extremely new and experimental.
7-
There is no Windows implementation yet.
5+
samply works on macOS, Linux, and Windows.
86

9-
samply is a work in progress and not ready for public consumption, but you can give it a try if you'd like:
7+
In order to profile the execution of `./my-application`, prepend `samply record` to the command invocation:
108

9+
```sh
10+
samply record ./my-application my-arguments
1111
```
12-
cargo install samply
1312

14-
samply record ./yourcommand args # This profiles yourcommand and then opens the profile in a viewer.
13+
On Linux, samply uses perf events. You can grant temporary access by running:
1514

16-
# Alternatively:
17-
samply record --save-only -o prof.json -- ./yourcommand args
18-
samply load prof.json
19-
20-
# You can also import Linux perf profiles:
21-
samply import perf.data
15+
```sh
16+
echo '1' | sudo tee /proc/sys/kernel/perf_event_paranoid
2217
```
2318

24-
See [the repo](https://github.com/mstange/samply/) for more information.
25-
26-
This project was formerly known as perfrecord.
19+
Visit [the git repository](https://github.com/mstange/samply/) for more information.

0 commit comments

Comments
 (0)