README.md 1.36 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
8
9
10
Merge requests and bug reports should be sent to sysprof's [repository on
GNOME's GitLab instance](https://gitlab.gnome.org/GNOME/sysprof). For general
discussion and questions, you can create a new topic in [GNOME's
Discourse](https://discourse.gnome.org).
11

12
13
The former mailing list is archived in
<https://mail.gnome.org/archives/sysprof-list/>.
Søren Sandmann's avatar
Søren Sandmann committed
14
15

Debugging symbols
16
-----------------
Søren Sandmann's avatar
Søren Sandmann committed
17

18
19
20
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
21
22
23
24
25
26
27
28


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

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

29
    sudo dnf install gcc gcc-c++ ninja-build gtk3-devel
Alan Conway's avatar
Alan Conway committed
30
31
32

Then do the following:

33
34
35
36
    meson --prefix=/usr build
    cd build
    ninja
    sudo ninja install
Alan Conway's avatar
Alan Conway committed
37

38
**WARNING**: `ninja install` will mostly install under the configured install
39
40
41
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.