pub/scm/linux/kernel/git/wfg/lkp-tests.git  about / heads / tags
mirror of https://git.kernel.org/pub/scm/linux/kernel/git/wfg/lkp-tests.git/
$ git log --pretty=format:'%h %s (%cs)%d'
0d41faf9 pack/pft: Remove the pft method (2019-08-02)
	(HEAD -> master)
738790ba pft: convert pack to makepkg (2019-08-02)
c1f4edb4 stutter: add benchmark for all supported distributions (2019-08-02)
879e0ce2 pack/stutter: Remove the perf method (2019-08-02)
8d9aadd2 stutter: convert pack to makepkg (2019-08-02)
6500b20f stats/wrapper: use /tmp as tmp file dir (2019-08-01)
0b327f57 lib/result.sh: use /tmp as tmp file dir (2019-08-01)
39fbf8a9 stats/wrapper: remove tmpfile before exit (2019-08-01)
feddc462 oltp: add benchmark for all supported distributions (2019-08-01)
5f787546 kexec: disable kaslr to fix kexec fail on kernel >= v5.3-rc1 (2019-08-01)
...

$ git cat-file blob HEAD:README.md
# Linux Kernel Performance tests

## Getting started

```
	git clone https://github.com/intel/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 disk partitions

Specify disk partitions by defining hdd_partitions/sdd_partitions in host file
named with local hostname and then lkp split-job will write the disk partitions
information to split job file automatically.

Please note that disk partitions may be formatted/corrupted to run job.

```
	echo "hdd_partitions: /dev/sda /dev/sdb" >> lkp-tests/hosts/$(hostname | sed -r 's/-[0-9]+$//g' | sed -r 's/-[0-9]+-/-/g')
	lkp split-job lkp-tests/jobs/blogbench.yaml
	# output is:
	# lkp-tests/jobs/blogbench.yaml => ./blogbench-1HDD-ext4.yaml
	# lkp-tests/jobs/blogbench.yaml => ./blogbench-1HDD-xfs.yaml
	# ...
	lkp install ./blogbench-1HDD-ext4.yaml
	lkp run ./blogbench-1HDD-ext4.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

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       pack/pft: Remove the pft method (2019-08-02)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
# no tags, yet...

# associated public inboxes:
# (number on the left is used for dev purposes)
        187 lkml
         57 netdev
         55 qemu-devel
         40 stable
         39 u-boot
         35 linux-arm-kernel
         28 buildroot
         21 git
         21 oe-lkp
         20 dri-devel
         19 linux-wireless
         19 dpdk-dev
         19 intel-gfx
         18 linux-fsdevel
         18 linux-devicetree
         16 kvm
         14 openembedded-core
         11 linux-mm
         11 xen-devel
         10 linux-nfs
         10 linux-scsi
         10 amd-gfx
          9 linux-crypto
          9 alsa-devel
          9 linux-btrfs
          9 linuxppc-dev
          8 linux-xfs
          8 bpf
          8 linux-media
          8 linux-rdma
          8 linux-bluetooth
          8 openembedded-devel
          7 linux-mtd
          7 linux-acpi
          7 netfilter-devel
          7 linux-arm-msm
          7 selinux
          7 linux-ext4
          7 linux-serial
          7 linux-doc
          7 linux-spi
          7 linux-i2c
          7 linux-kbuild
          7 linux-arch
          6 linux-block
          6 linux-mediatek
          6 linux-mips
          6 ksummit-discuss
          6 linux-api
          6 linux-omap
          6 linux-sh
          6 ksummit
          6 ../../../../../../../igt-dev
          5 linux-samsung-soc
          5 linux-riscv
          5 linux-cifs
          5 linux-pm
          5 linux-input
          5 linux-usb
          5 linux-clk
          5 linux-gpio
          5 linux-ide
          5 linux-mmc
          5 linux-can
          5 linux-cxl
          5 linux-perf-users
          5 kernel-janitors
          5 ltp
          5 linux-patches
          5 qemu-riscv
          4 linux-iommu
          4 fstests
          4 kvmarm
          4 linux-kselftest
          4 linux-security-module
          4 linux-pci
          4 linux-tegra
          4 virtualization
          4 containers
          4 linux-rockchip
          4 target-devel
          4 linux-s390
          4 linux-staging
          4 yocto
          4 batman
          4 cluster-devel
          4 cgroups
          4 kvm-ppc
          3 linux-nvme
          3 linux-integrity
          3 kernel-hardening
          3 linux-iio
          3 linux-hyperv
          3 util-linux
          3 linux-wpan
          3 linux-man
          3 linux-raid
          3 platform-driver-x86
          3 openbmc
          3 keyrings
          3 linux-fbdev
          3 lustre-devel
          3 mptcp
          3 nvdimm
          3 bitbake-devel
          3 yocto-meta-virtualization
          3 yocto-meta-ti
          3 outreachy
          3 openrisc
          3 intel-wired-lan
          3 poky
          3 grub-devel
          3 lvm-devel
          2 linux-efi
          2 linux-edac
          2 linux-amlogic
          2 linux-erofs
          2 linux-nvdimm
          2 linux-rtc
          2 driverdev-devel
          2 dmaengine
          2 linux-next
          2 linux-f2fs-devel
          2 linux-modules
          2 linux-rt-users
          2 linux-watchdog
          2 linux-trace-devel
          2 selinux-refpolicy
          2 linux-m68k
          2 backports
          2 linux-unionfs
          2 linux-audit
          2 linux-sparse
          2 lttng-dev
          2 ceph-devel
          2 linux-hardening
          2 linux-sctp
          2 ocfs2-devel
          2 ath11k
          2 nouveau
          2 linux-coco
          2 linux-nfc
          2 iwd
          2 ofono
          2 yocto-meta-freescale
          2 yocto-toaster
          2 yocto-meta-arm
          2 ntb
          2 yocto-meta-arago
          2 xenomai
          2 kexec
          2 linux-trace-kernel
          2 oe-linux-nfc
          2 intel-xe
          2 linux-um
          2 virtio-dev
          2 virtio-comment
          2 v9fs
          2 linux-ia64
          2 cpufreq
          2 dccp
          2 linux-hams
          2 linux-hexagon
          2 reiserfs-devel
          2 linux-metag
          2 linux-x25
          2 virtio-fs
          2 ../../../../../../../fuego
          1 linux-fscrypt
          1 cocci
          1 live-patching
          1 linux-snps-arc
          1 linux-hwmon
          1 linux-renesas-soc
          1 linux-parisc
          1 linux-leds
          1 kernelnewbies
          1 linux-sgx
          1 workflows
          1 rcu
          1 linux-i3c
          1 linux-spdx
          1 wireguard
          1 io-uring
          1 linux-kernel-mentees
          1 linux-csky
          1 tpmdd-devel
          1 linux-firmware
          1 cip-dev
          1 linux-remoteproc
          1 linux-dash
          1 linux-bcache
          1 mm-commits
          1 linux-pwm
          1 linux-fpga
          1 xdp-newbies
          1 phone-devel
          1 linux-toolchains
          1 dash
          1 dm-devel
          1 soc
          1 rust-for-linux
          1 ath10k
          1 linux-phy
          1 sparclinux
          1 linux-sunxi
          1 regressions
          1 b43-dev
          1 historical-speck
          1 linux-bcachefs
          1 ath9k-devel
          1 ntfs3
          1 llvm
          1 fio
          1 ell
          1 yocto-docs
          1 chrome-platform
          1 damon
          1 asahi
          1 loongarch
          1 imx
          1 ath12k
          1 b4-sent
          1 oe-kbuild-all
          1 oe-chipsec
          1 ecryptfs
          1 kbd
          1 autofs
          1 devicetree-spec
          1 devicetree-compiler
          1 initramfs
          1 hail-devel
          1 kvm-ia64
          1 linux-8086
          1 kernel-testers
          1 linux-alpha
          1 linux-btrace
          1 linux-embedded
          1 linux-hotplug
          1 linux-laptop
          1 linux-sound
          1 trinity
          1 linux-nilfs
          1 lvs-devel
          1 netfilter
          1 linux-oxnas
          1 u-boot-amlogic
          1 lm-sensors
          1 acpica-devel
          1 bridge
          1 perfbook
          1 smatch
          1 ../../../../../../../wireless-regdb
          1 ../../../../../../../powertop

git clone https://yhbt.net/lore/pub/scm/linux/kernel/git/wfg/lkp-tests.git