"Fossies" - the Fresh Open Source Software Archive

Member "stress-ng-0.09.56/README" (15 Mar 2019, 3064 Bytes) of package /linux/privat/stress-ng-0.09.56.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "README": 0.09.55_vs_0.09.56.

    1 stress-ng
    2 
    3 stress-ng will stress test a computer system in various selectable ways. It
    4 was designed to exercise various physical subsystems of a computer as well as
    5 the various operating system kernel interfaces. Stress-ng features:
    6 
    7   * over 210 stress tests
    8   * over 50 CPU specific stress tests that exercise floating point, integer,
    9     bit manipulation and control flow
   10   * over 20 virtual memory stress tests
   11   * portable: builds on Linux, Solaris, *BSD, Minix, Android, MacOS X,
   12     Debian Hurd, Haiku, Windows Subsystem for Linux and SunOs/Dilos with
   13     gcc, clang, tcc and pcc.
   14 
   15 stress-ng was originally intended to make a machine work hard and trip hardware
   16 issues such as thermal overruns as well as operating system bugs that only
   17 occur when a system is being thrashed hard. Use stress-ng with caution as some
   18 of the tests can make a system run hot on poorly designed hardware and also can
   19 cause excessive system thrashing which may be difficult to stop.
   20 
   21 stress-ng can also measure test throughput rates; this can be useful to observe
   22 performance changes across different operating system releases or types of
   23 hardware. However, it has never been intended to be used as a precise benchmark
   24 test suite, so do NOT use it in this manner.
   25 
   26 Running stress-ng with root privileges will adjust out of memory settings on
   27 Linux systems to make the stressors unkillable in low memory situations, so use
   28 this judiciously. With the appropriate privilege, stress-ng can allow the ionice
   29 class and ionice levels to be adjusted, again, this should be used with care.
   30 
   31 To build, the following libraries will ensure a fully functional stress-ng
   32 build
   33 
   34 Debian, Ubuntu:
   35 
   36   * libaio-dev
   37   * libapparmor-dev
   38   * libattr1-dev
   39   * libbsd-dev
   40   * libcap-dev
   41   * libgcrypt11-dev
   42   * libipsec-mb-dev
   43   * libkeyutils-dev
   44   * libsctp-dev
   45   * zlib1g-dev
   46 
   47 RHEL, Fedora, Centos:
   48 
   49   * libaio-devel
   50   * libattr-devel
   51   * libbsd-devel
   52   * libcap-devel
   53   * libgcrypt-devel
   54   * keyutils-libs
   55   * libsctp-devel
   56   * zlib-devel
   57 
   58 NOTE: the build will try to detect build depedencies and will build an image
   59 with functionality disabled if the support libraries are not installed.
   60 
   61 To build on BSD systems, one requires gcc and GNU make:
   62         CC=gcc gmake clean
   63 	CC=gcc gmake
   64 
   65 To build on OS X systems, just use:
   66 	make clean
   67 	make
   68 
   69 To build on MINIX, gmake and clang are required:
   70 	CC=clang gmake clean
   71 	CC=clang gmake
   72 
   73 To build on SunOS, one requires GCC and GNU make, build using:
   74 	CC=gcc gmake clean
   75 	CC=gcc gmake
   76 
   77 To build on Dilos, one requires GCC and GNU make, build using:
   78 	CC=gcc gmake clean
   79 	CC=gcc gmake
   80 
   81 To build on Haiku Alpha 4:
   82 	make clean
   83 	make
   84 
   85 To build a static image (example, for Android), use:
   86 	make clean
   87 	STATIC=1 make
   88 
   89 To build with full warnings enabled:
   90 	make clean
   91 	PEDANTIC=1 make
   92 
   93 For more information, see: http://kernel.ubuntu.com/~cking/stress-ng/
   94 
   95 I am keen to add to the stress-ng project page any citations to research or
   96 projects that use stress-ng.  I also appreciate information concerning kernel
   97 bugs or performance regressions found with stress-ng.