"Fossies" - the Fresh Open Source Software Archive

Member "stress-1.0.5/doc/stress.txt" (2 Oct 2021, 3156 Bytes) of package /linux/privat/old/stress-1.0.5.tar.gz:


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.

    1 NAME
    2  stress - tool to impose load on and stress test a computer system
    3 
    4 SYNOPSIS
    5  stress [OPTIONS]
    6 
    7 DESCRIPTION
    8  stress is a tool that imposes a configurable amount of CPU, memory, I/O,
    9  or disk stress on a POSIX-compliant operating system and reports any errors
   10  it detects.
   11 
   12  stress is not a benchmark. It is a tool used by system administrators to
   13  evaluate how well their systems will scale, by kernel programmers to evaluate
   14  perceived performance characteristics, and by systems programmers to expose
   15  the classes of bugs which only or more frequently manifest themselves when
   16  the system is under heavy load.
   17 
   18 OPTIONS
   19  -?, --help         Show this help statement.
   20  --version          Show version statement.
   21  -v, --verbose      Be verbose.
   22  -q, --quiet        Be quiet.
   23  -n, --dry-run      Show what would have been done.
   24  -t, --timeout <N>  Timeout after N seconds. This option is ignored by -n.
   25  --backoff <N>      Wait for factor of microseconds before starting work.
   26  -c, --cpu <N>      Spawn N workers spinning on sqrt().
   27  -i, --io <N>       Spawn N workers spinning on sync().
   28  -m, --vm <N>       Spawn N workers spinning on malloc()/free().
   29  --vm-bytes <B>     Malloc B bytes per vm worker (default is 256MB).
   30  --vm-stride <B>    Touch a byte every B bytes (default is 4096).
   31  --vm-hang <N>      Sleep N secs before free (default none, 0 is inf).
   32  --vm-keep          Redirty memory instead of freeing and reallocating.
   33  -d, --hdd <N>      Spawn N workers spinning on write()/unlink().
   34  --hdd-bytes <B>    Write B bytes per hdd worker (default is 1GB). The file
   35                     will be created with mkstemp() in the current directory.
   36 
   37  Note: Numbers may be suffixed with s,m,h,d,y (time) or B,K,M,G (size).
   38 
   39 EXAMPLES
   40  The simple case is that you just want to bring the system load average up to an
   41  arbitrary value. The following forks 13 processes, each of which spins in a
   42  tight loop calculating the sqrt() of a random number acquired with rand().
   43 
   44     stress -c 13
   45 
   46  Long options are supported, as well as is making the output less verbose. The
   47  following forks 1024 processes, and only reports error messages if any.
   48 
   49     stress --quiet --cpu 1k
   50 
   51  To see how your system performs when it is I/O bound, use the -i switch. The
   52  following forks 4 processes, each of which spins in a tight loop calling
   53  sync(), which is a system call that flushes memory buffers to disk.
   54 
   55     stress -i 4
   56 
   57  Multiple hogs may be combined on the same command line. The following does
   58  everything the preceding examples did in one command, but also turns up the
   59  verbosity level as well as showing how to cause the command to self-terminate
   60  after 1 minute.
   61 
   62     stress -c 13 -i 4 --verbose --timeout 1m
   63 
   64  You can write a file of arbitrary length to disk. The file is created with
   65  mkstemp() in the current directory.
   66 
   67     stress -d 1 --hdd-bytes 13
   68 
   69     Large file support is enabled.
   70 
   71     stress -d 1 --hdd-bytes 3G
   72 
   73 AUTHOR
   74  stress was originally developed by Amos Waterland <apw@debian.org> and
   75  is maintained by some volunteers.
   76 
   77  Currently, source code and newer versions are available at
   78  https://github.com/resurrecting-open-source-projects/stress