xref: /aosp_15_r20/external/trace-cmd/README (revision 58e6ee5f017f6a8912852c892d18457e4bafb554)
1
2
3  For more information on contributing please see: https://www.trace-cmd.org
4
5Note: The official repositiory for trace-cmd and KernelShark is here:
6
7 git://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git
8
9For bug reports and issues, please file it here:
10
11 https://bugzilla.kernel.org/buglist.cgi?component=Trace-cmd%2FKernelshark&product=Tools&resolution=---
12
13These files make up the code that create the trace-cmd programs.
14This includes the GUI interface application kernelshark as well
15as trace-graph and trace-view.
16
17These files also make up the code to create the libtracecmd library.
18
19The applications are licensed under the GNU General Public License 2.0
20(see COPYING) and the libraries are licensed under the GNU
21Lesser General Public License 2.1 (See COPYING.LIB).
22
23BUILDING:
24
25In order to install build dependencies on Debian / Ubuntu do the following:
26    sudo apt-get install build-essential git pkg-config -y
27    sudo apt-get install libtracefs-dev libtraceevent-dev -y
28
29In order to install build dependencies on Fedora, as root do the following:
30    dnf install gcc make git pkg-config -y
31    dnf install libtracefs-devel libtraceevent-devel -y
32
33In case your distribution does not have the required libtracefs and
34libtraceevent libraries, build and install them manually:
35
36    git clone https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/
37    cd libtraceevent
38    make
39    sudo make install
40
41    git clone https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git/
42    cd libtracefs
43    make
44    sudo make install
45
46To make trace-cmd
47    make
48
49To make the gui
50    make gui
51
52INSTALL:
53
54To install trace-cmd
55    make install
56
57To install the gui
58    make install_gui
59
60Note: The default install is relative to /usr/local
61    The default install directory is /usr/local/bin
62    The default plugin directory is /usr/local/lib/trace-cmd/plugins
63
64To change the default, you can set 'prefix', eg
65mkdir $HOME/test-trace
66make prefix=$HOME/test-trace
67make prefix=$HOME/test-trace install
68
69