README.md 1.2 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

Søren Sandmann's avatar
Søren Sandmann committed
5
See the Sysprof homepage:
Søren Sandmann Pedersen's avatar
Søren Sandmann Pedersen committed
6

7
        http://sysprof.com/
Søren Sandmann Pedersen's avatar
Søren Sandmann Pedersen committed
8

Søren Sandmann's avatar
Søren Sandmann committed
9
for more information
10

11
12
Questions, patches and bug reports should be sent to the sysprof
mailing list:
13

14
        sysprof-list@gnome.org
Søren Sandmann's avatar
Søren Sandmann committed
15

16
The list is archived here:
17

18
        https://mail.gnome.org/archives/sysprof-list/
Søren Sandmann's avatar
Søren Sandmann committed
19
20
21

Debugging symbols

22
- The programs and libraries you want to profile should be compiled
Mohammed Sadiq's avatar
Mohammed Sadiq committed
23
  with -fno-omit-frame-pointer and have debugging symbols available,
24
  or you won't get much usable information.
Alan Conway's avatar
Alan Conway committed
25
26
27
28
29
30
31
32


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

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

33
    sudo dnf install gcc gcc-c++ ninja-build gtk3-devel
Alan Conway's avatar
Alan Conway committed
34
35
36

Then do the following:

37
38
39
40
    meson --prefix=/usr build
    cd build
    ninja
    sudo ninja install
Alan Conway's avatar
Alan Conway committed
41

42
43
44
45
WARNING: `ninja install` will mostly install under the configured install
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.