Clone this repo:

Branches

  1. a4360e7 repo: add zx2c4 from Jason by Fengguang Wu · 3 days ago master
  2. 73e561e lib/job-init.sh: allow mount rt failed when use lkp-qemu to reproduce by Li Zhijian · 3 days ago
  3. cb83837 distro/depends/ndctl-dev: Fix No package 'bash-completion' found by Li Zhijian · 6 days ago
  4. 647928b distro/depends/piglit: add libdw-dev for test by leishaoting · 6 days ago
  5. 4dd85c4 repo: update belongs_to of alsa to be sof by Philip Li · 6 days ago

Linux Kernel Performance tests

Getting started

	git clone https://github.com/01org/lkp-tests.git

	cd lkp-tests
	make install

	lkp help

Install packages for a job

	# browse and select a job you want to run, for example, jobs/hackbench.yaml
	ls lkp-tests/jobs
	
	# install the common dependencies for lkp
	lkp install

Run one atomic job

	lkp split-job lkp-tests/jobs/hackbench.yaml
	# output is:
	# jobs/hackbench.yaml => ./hackbench-1600%-process-pipe.yaml
	# jobs/hackbench.yaml => ./hackbench-1600%-process-socket.yaml
	# jobs/hackbench.yaml => ./hackbench-1600%-threads-pipe.yaml
	# jobs/hackbench.yaml => ./hackbench-1600%-threads-socket.yaml
	# jobs/hackbench.yaml => ./hackbench-50%-process-pipe.yaml
	# jobs/hackbench.yaml => ./hackbench-50%-process-socket.yaml
	# jobs/hackbench.yaml => ./hackbench-50%-threads-pipe.yaml
	# jobs/hackbench.yaml => ./hackbench-50%-threads-socket.yaml

	# install the remaining dependencies for the splited job
	lkp install ./hackbench-50%-threads-socket.yaml

	lkp run ./hackbench-50%-threads-socket.yaml

Run your own benchmarks

To run your own benchmarks that are not part of lkp-tests, you can use mytest job.

	lkp split-job lkp-tests/jobs/mytest.yaml
	# output is:
	# jobs/mytest.yaml => ./mytest-defaults.yaml
	lkp run ./mytest-defaults.yaml -- <command> <argument> ...

Check result

	lkp result hackbench

Supported Distributions

Most test cases should install/run well in

  • Debian sid
  • Archlinux
  • CentOS7

There is however some initial support for:

  • OpenSUSE:
    • jobs/trinity.yaml
  • Fedora
  • Clear Linux(>=22640)

As for now, lkp-tests still needs to run as root.

Adding distribution support

If you want to add support for your Linux distribution you will need an installer file which allows us to install dependencies per job. For examples look at: distro/installer/* files.

Since packages can have different names we provide an adaptation mapping for a base Ubuntu package (since development started with that) to your own distribution package name, for example adaptation files see: distro/adaptation/*. For now adaptation files must have the architecture dependent packages (ie, that ends with the postfix :i386) towards the end of the adaptation file.

You will also want to add a case for your distribution on sync_distro_sources() on the file lib/install.sh.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request