pub/scm/utils/cpu/mce/mce-test.git  about / heads / tags
Linux machine check test suite
$ git log --pretty=format:'%h %s (%cs)%d'
ab7e1c3 thugetlb: fix test case failure due to incorrect getopt_long() return handling (2025-05-28)
	(HEAD -> master)
d98eff2 random_offline: Fix 'syntax error' test failure on AArch64 (2025-05-28)
0c5bef3 run_hard.sh: Correct test name printed to match actual execution. (2025-05-27)
9cf753e gcov_merge.py/scov_merge.py: switch to python3 (2025-04-25)
78dfae9 ltp-pan: fix wait_handler declaration (2025-04-25)
9d11fc3 tprctl: enhance sighandler to explicitly print si_code (2023-06-01)
025014d tools: victim: fix timeout count with pre-decrement (2022-10-28)
8fe0310 edac/README: Some notes for EDAC test (2022-08-25)
23f95d5 edac.sh: Filter out incomplete EDAC message in EDAC test (2022-08-25)
110cfb5 edac.sh: Save more information to log and add retry in test specify address (2022-08-25)
...

$ git cat-file blob HEAD:README
MCE test suite
---------------

The MCE test suite is a collection of tools and test scripts for
testing the Linux RAS related features, including CPU/Memory error
containment and recovery, ACPI/APEI support etc.

For some more details on machine checks see http://www.mcelog.org

The goal is as follows:
1. cover most Linux kernel MCE processing code paths and features
2. cover functional test cases for all RAS related features
3. provide stress test cases for some RAS features, especially for
   memory part

In the Package
--------------

Here is a short description of what is included in the package

README
	This document

COPYING
	GNU General Public License

Makefile
	Top level make file for MCE test suite

bin/
	Some tools used by test drivers or test cases will be
	installed into this directory.

cases/*
	Contains all test cases, which may be organized in
	sub-directories, the interface of a class of test cases is a
	shell script under cases/, such as:
	   -- cases/soft-inj/panic/cases.sh
		is for test cases triggered by soft-inject and may cause system 
		panic during testing.
	   -- cases/apei-inj/ucr/cases.sh  
		is for test cases triggered by apei-inject.

doc/*
	Documentation for MCE test suites include howto and
	descriptions of every test case.

lib/*
	Contains some shell scripts, in which some common shell
	functions and variable definitions are defined to be used by
	multiple test drivers or test cases.

tools/*
	Some tools used by MCE test suites.

work/
	During test, some temporary file will be put in work directory.

groups/
	Where all scenarios files such as coverage/function/stress are placed

results/
	When test is done, the test log will be placed in this directory.
	Some test results such as coverage test result will be
	placed in sub-directory under results directory.

summary
	When test is done, a summary file in *date* format is placed here.

Test Instruction
----------------

Please refer to corresponding section in doc/howto.txt.

Very quick way to test this:
	1. be root
	2. make sure you have a kernel with CONFIG_X86_MCE_INJECT
	and CONFIG_HWPOISON_INJECT and soft-offlining support
	3. run "mcemenu"

Futher Information
------------------

For futher information about MCE test suite, please refer to documents
in doc sub-directory.

doc/howto.txt:		a more detailed HOWTO document. This doc is a little
			bit out of date.

doc/stress-howto.txt:	Detailed HOWTO document for MCE stress test suite

doc/cases/*.txt:	Description of every test case, including test
			objective, code patch tested, reference and
			expected results

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       thugetlb: fix test case failure due to incorrect getopt_long() return handling (2025-05-28)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
v1.0         new MCE-Test Suite release v1.0 (2015-01-21) tar.gz

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

git clone https://yhbt.net/lore/pub/scm/utils/cpu/mce/mce-test.git