README.md 1.22 KB
Newer Older
Søren Sandmann's avatar
Søren Sandmann committed
1
2
3
Sysprof is a sampling profiler that uses a kernel module to generate
stacktraces which are then interpreted by the userspace program
"sysprof".
Søren Sandmann Pedersen's avatar
Søren Sandmann Pedersen committed
4

5
See the [Sysprof homepage](http://sysprof.com/) for more information.
6

7
Questions, patches and bug reports should be sent to the sysprof
8
mailing list [sysprof-list@gnome.org](mailto:sysprof-list@gnome.org).
9

10
The list is archived in <https://mail.gnome.org/archives/sysprof-list/>.
Søren Sandmann's avatar
Søren Sandmann committed
11
12

Debugging symbols
13
-----------------
Søren Sandmann's avatar
Søren Sandmann committed
14

15
16
17
The programs and libraries you want to profile should be compiled
with `-fno-omit-frame-pointer` and have debugging symbols available,
or you won't get much usable information.
Alan Conway's avatar
Alan Conway committed
18
19
20
21
22
23
24
25


Building Sysprof
----------------

You need some packages installed. The package names may vary depending on your
distribution, the following command works on Fedora 25:

26
    sudo dnf install gcc gcc-c++ ninja-build gtk3-devel
Alan Conway's avatar
Alan Conway committed
27
28
29

Then do the following:

30
31
32
33
    meson --prefix=/usr build
    cd build
    ninja
    sudo ninja install
Alan Conway's avatar
Alan Conway committed
34

35
**WARNING**: `ninja install` will mostly install under the configured install
36
37
38
prefix but installs systemd service configuration directly in the system
default location `/usr/lib/systemd` so it won't work without root privileges,
even if the install prefix is a user-owned directory.