Development

From Perf Wiki
(Difference between revisions)
Jump to: navigation, search
(Installation Guide)
(Installation Guide)
Line 3: Line 3:
 
== Installation Guide ==
 
== Installation Guide ==
  
You'll need to install ''perf'' in your system. ''perf'' uses CPU performance counters( Performance Monitoring Counters or PMCs).  
+
You'll need to install 'perf' in your system. 'perf' uses CPU performance counters( Performance Monitoring Counters or PMCs).  
  
 
1) Install Required Packages like ''libelf-dev'' ''libdw-dev'' ''binutils-dev''   
 
1) Install Required Packages like ''libelf-dev'' ''libdw-dev'' ''binutils-dev''   
 
''libaudit-dev'' by using the following command  
 
''libaudit-dev'' by using the following command  
 
  sudo apt-get install build-essential libelf-dev libdw-dev binutils-dev  
 
  sudo apt-get install build-essential libelf-dev libdw-dev binutils-dev  
  libaudit-dev libtraceevent-dev systemtap-sdt-dev libunwind-dev libslang2-dev libperl-dev libzstd-dev libbabeltrace-ctf-dev
+
  libaudit-dev libtraceevent-dev systemtap-sdt-dev libunwind-dev libslang2-dev libperl-dev libzstd-dev libbabeltrace-ctf-dev flex bison
  
 
2) Download the Source code for perf-tools v6.3 using the following command
 
2) Download the Source code for perf-tools v6.3 using the following command
  git clone https://git.kernel.org/pub/scm/linux/kernel/git/acme/linux.git/
+
  git clone https://git.kernel.org/pub/scm/linux/kernel/git/perf/perf-tools-next.git/
  
 
3) Install perf. Perf command is available in packages ''linux-tools-common'', ''linux-intel-iotg-tools-common'', etc. Hence, install any of these.  
 
3) Install perf. Perf command is available in packages ''linux-tools-common'', ''linux-intel-iotg-tools-common'', etc. Hence, install any of these.  
  
4) Run ''make'' command to build the project
+
4) Run 'make' command to build the project
  
4.1) It may show an error since the config file is not set and has to be changed. Run following command.
+
4.1) It may show an error since the config file is not set and has to be changed. Run the following command.
 
  ''make xconfig''  
 
  ''make xconfig''  
  
Line 25: Line 25:
  
 
4.3) Check if qt5 has been installed properly using ''qmake --version''  
 
4.3) Check if qt5 has been installed properly using ''qmake --version''  
 +
 +
4.4) You might need to set "kernel.perf_event_paranoid = -1" because the "perf record" command may fail due to restricted access to performance monitoring features on your system.
 +
 +
  sudo sysctl -w kernel.perf_event_paranoid=-1
 +
  Note: this should not be done in production environment
 +
 
 +
 +
  
 
4.4) Now, Finally run ''make xconfig'' and it will work properly.
 
4.4) Now, Finally run ''make xconfig'' and it will work properly.

Revision as of 18:19, 12 March 2024

Contents

Development

Installation Guide

You'll need to install 'perf' in your system. 'perf' uses CPU performance counters( Performance Monitoring Counters or PMCs).

1) Install Required Packages like libelf-dev libdw-dev binutils-dev libaudit-dev by using the following command

sudo apt-get install build-essential libelf-dev libdw-dev binutils-dev 
libaudit-dev libtraceevent-dev systemtap-sdt-dev libunwind-dev libslang2-dev libperl-dev libzstd-dev libbabeltrace-ctf-dev flex bison 

2) Download the Source code for perf-tools v6.3 using the following command

git clone https://git.kernel.org/pub/scm/linux/kernel/git/perf/perf-tools-next.git/

3) Install perf. Perf command is available in packages linux-tools-common, linux-intel-iotg-tools-common, etc. Hence, install any of these.

4) Run 'make' command to build the project

4.1) It may show an error since the config file is not set and has to be changed. Run the following command.

make xconfig 

4.2) We will also need to install qt5 for this. Install it using sudo apt-get install qtbase5-dev OR sudo apt install qt5* and set the path using

export PKG_CONFIG_PATH=/usr/lib/x86_64-linux-gnu/pkgconfig:/usr/share/pkgconfig

4.3) Check if qt5 has been installed properly using qmake --version

4.4) You might need to set "kernel.perf_event_paranoid = -1" because the "perf record" command may fail due to restricted access to performance monitoring features on your system.

  sudo sysctl -w kernel.perf_event_paranoid=-1
  Note: this should not be done in production environment
  


4.4) Now, Finally run make xconfig and it will work properly.

5) Go to the root directory of the kernel and run perf test. You will see tests passing, skipping, or failing.

Maintainer Trees

Kernel

tip.git perf/core

Tool

perf-tools for the current release. Merged to linux-next.

perf-tools-next staging for the next release.

Design

design.txt


Latest source tar balls

mirror

Personal tools