summaryrefslogtreecommitdiff
path: root/README
blob: d85073ec78f74512f66a64585f169cb152e783f3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
Sysprof is a sampling profiler that uses a kernel module, sysprof-module.ko,
to generate stacktraces which are then interpreted by the userspace
program "sysprof".

See http://www.daimi.au.dk/~sandmann/sysprof/ for more information

- You need gtk+ 2.6.0 or better.

- You need a 2.6 kernel. On SMP kernels the module produces unreliable data.

- The module must be compiled with the same compiler that compiled the 
  kernel it is going to be used with. For most systems that is just
  the system compiler, but if you have upgraded your kernel it is
  possible the one was compiled with a different compiler.

  In that case, "insmod sysprof-module.ko" will produce this 
  error message:

    insmod: error inserting './sysprof-module.o': -1 Invalid module format

- The programs you want to profile should have debugging symbols, or
  you won't get much usable information. On a Fedora Core system,
  installing the relevant -debuginfo packages should do the trick.

- To get usable data on the X server:

  (1) Compile the X server to use ".so" modules:

	- Uncomment the line "MakeDllModules	Yes" in 
	  xc/config/cf/xorgsite.def

	- "make World"

  (2) Install the X server making sure it can't see any ".a" files. If
      you install on top of an existing installation, just do

	  find /usr/X11R6/lib/"*.a" | sudo xargs rm

      and install the newly compiled X server. 

      If a ".so" X server finds .a files in its module path it will
      try to load those in preference to .so files and this causes
      symbol resolution problems

  (3) Run your new X server

  (4) Run sysprof as root. This is necessary because the X server binary 
      for security reasons is not readable by regular users. I could tell
      you why, but then I'd have to kill you.


Credits:
      Diana Fong for the icon
      Kristian Høgsberg for the first port to the 2.6 kernel.
      Owen Taylor for the symbol lookup code in memprof
	

Søren   (sandmann@daimi.au.dk)