~ubuntu-branches/ubuntu/trusty/sysprof/trusty

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Ritesh Raj Sarraf
  • Date: 2011-06-13 23:05:39 UTC
  • mfrom: (8.1.2 experimental)
  • Revision ID: james.westby@ubuntu.com-20110613230539-426qhsc3k996edou
Tags: 1.1.6-2
Upload to unstable 

Show diffs side-by-side

added added

removed removed

Lines of Context:
17
17
 
18
18
 
19
19
 
20
 
 
21
20
Requirements:
22
21
 
23
 
- A Linux kernel version 2.6.11 or newer is required.
24
 
  Unlike Sysprof 0.9, this version should work fine on SMP systems.
 
22
- A Linux kernel version 2.6.9 or newer, compiled with profiling
 
23
  support, is required.
25
24
 
26
25
- GTK+ 2.6.0 or newer is required
27
26
 
28
 
- libglade 2.5.1 is required
 
27
- libglade 2.5.1 or newer is required
29
28
 
30
29
 
31
30
Compiling:
35
34
  system compiler, but if you have upgraded your kernel it is
36
35
  possible that the new kernel was compiled with a different compiler
37
36
 
38
 
  In that case, "modprobe sysprof-module" will produce this 
 
37
  If the module is compiled with a different compiler than the one 
 
38
  compiling the kernel, "modprobe sysprof-module" will produce this
39
39
  error message:
40
40
 
41
41
    insmod: error inserting './sysprof-module.o': -1 Invalid module format
42
42
 
43
43
 
44
 
 
45
44
Debugging symbols
46
45
 
47
 
- The programs you want to profile should have debugging symbols, or
48
 
  you won't get much usable information. On a Fedora Core system,
49
 
  installing the relevant -debuginfo package should be sufficient.
50
 
 
51
 
 
52
 
- X server.
 
46
- The programs and libraries you want to profile should have debugging
 
47
  symbols, or you won't get much usable information. On a Fedora Core system,
 
48
  installing the relevant <package>-debuginfo package should be sufficient.
 
49
  On Ubuntu and Debian, the debug packages are called <package>-dbg.
 
50
 
 
51
- X server
53
52
 
54
53
  The X server as shipped by most distributions uses its own home-rolled
55
54
  module loading system and Sysprof has no way to deal with that, so if you
56
 
  run sysprof with your normal X serverr you won't get any information about
 
55
  run sysprof with your normal X server you won't get any information about
57
56
  how time is spent inside the X server.
58
57
 
59
 
  To fix this you have to compile your own X server:
 
58
  On Ubuntu and Debian there is a package, xserver-xorg-dbg, containing a
 
59
  binary called Xorg-debug that is built in such a way that sysprof can use
 
60
  it. On other systems, to get an X server with usable symbols you
 
61
  have to compile your own:
60
62
 
61
63
  (1) Compile the X server to use ".so" modules:
62
64
 
64
66
          xc/config/cf/xorgsite.def. 
65
67
 
66
68
          If you are compiling the CVS version of the X server
67
 
          (the one that will eventually become 7.0), then this is
 
69
          (the one that will eventually become 6.9), then this is
68
70
          already the default.
69
71
 
70
72
        - "make World"
 
73
        
 
74
        - Don't run "make install" yet. (See below).
71
75
 
72
 
  (2) Install the X server making sure it can't see any ".a" files. If
73
 
      you install on top of an existing installation, just do
 
76
  (2) Make sure the new X server can't see any old ".a" files lying 
 
77
      around. If you install on top of an existing installation, just do
74
78
 
75
79
          find /usr/X11R6/lib/"*.a" | sudo xargs rm
76
80
 
77
 
      and install the newly compiled X server. 
 
81
      then run "make install" as root to install the newly compiled
 
82
      X server. 
78
83
 
79
84
      If a ".so" X server finds .a files in its module path it will
80
85
      try to load those in preference to .so files and this causes
87
92
      you why, but then I'd have to kill you.
88
93
 
89
94
 
90
 
 
91
 
 
92
95
Credits:
 
96
      Lorenzo Colitti for writing the sysprof-text program
93
97
      Diana Fong for the icon
94
98
      Mike Frysinger for x86-64 support
95
99
      Kristian H�gsberg for the first port to the 2.6 kernel.
96
100
      Owen Taylor for the symbol lookup code in memprof
97
 
        
 
101
 
98
102
 
99
103
S�ren   (sandmann@daimi.au.dk)