1MCE Stress Test Suite 2===================== 3 4Oct 10th, 2009 5 6Haicheng Li 7 8 9About the MCE stress test suite 10------------------------------- 11 12The MCE stress test suite is a collection of tools and test scripts, which 13intends to achieve stress testing for Linux kernel MCA high level handlers 14that include HWPosion page recovery, soft page offline, and so on. 15 16In general, this test suite is designed to do stress testing thru various 17test interfaces, i.e. madvise syscall, HWPoison page injector, and APEI 18injector (see ACPI4.0 spec). And it's able to support most of popular 19Linux File Systems (FS), that is, there is an option (i.e. -f) for user to 20specify which FS type they want the test to be running on. 21 22 23Test Dependencies 24----------------- 25MCE stress test suite has following dependencies on kernel and other tools: 26 27* Linux Kernel: 28 Version 2.6.32 or newer, with MCA high level handlers enabled. 29 30* ltp-pan: 31 A test harness of Linux Test Project, http://ltp.sf.net. 32 33* page-types: 34 A tool to query page types, which is accompanied with Linux kernel 35 source (2.6.32 or newer, $KERNEL_SRC/Documentation/vm/page-types.c). 36 37Pls. refer to the HOWTO doc (../doc/stress-howto.txt) to setup your test 38enviroment. 39 40 41In the package 42--------------- 43Here is a short description of what is included in this test suite. 44 45README 46 This document. 47 48../doc/stress-howto.txt 49 HOWTO doc, including design details and usage guide. 50 51Makefile 52 Makefile for MCE stress test suite. 53 54hwposion.sh 55 Test driver. 56 57tools/* 58 Test workloads. 59 60 61Get Started 62----------- 63Pls. read through the HOWTO doc (../doc/stress-howto.txt) before you start 64the stress testing on your system. 65 66You can also get help on specific test options in following way: 67# ./hwpoison.sh -h 68 69 70Warning! 71-------- 72Be careful with these tests! 73 74Don't run them on production systems. They should not cause problems on 75properly functioning systems, they are intended to find (or cause) problems. 76