1NICELOAD(1)                        parallel                        NICELOAD(1)
2
3
4

NAME

6       niceload - slow down a program when the load average is above a certain
7       limit
8

SYNOPSIS

10       niceload [-v] [-h] [-n nice] [-I io] [-L load] [-M mem] [-N] [--sensor
11       program] [-t time] [-s time|-f factor] ( command | -p PID [-p PID ...]
12       | --prg program )
13

DESCRIPTION

15       GNU niceload will slow down a program when the load average (or other
16       system activity) is above a certain limit. When the limit is reached
17       the program will be suspended for some time. Then resumed again for
18       some time.  Then the load average is checked again and we start over.
19
20       Instead of load average niceload can also look at disk I/O, amount of
21       free memory, or swapping activity.
22
23       If the load is 3.00 then the default settings will run a program like
24       this:
25
26       run 1 second, suspend (3.00-1.00) seconds, run 1 second, suspend
27       (3.00-1.00) seconds, run 1 second, ...
28

OPTIONS

30       -B
31       --battery
32                Suspend if the system is running on battery. Shorthand for: -l
33                -1 --sensor 'cat /sys/class/power_supply/BAT0/status
34                /proc/acpi/battery/BAT0/state 2>/dev/null | grep -i -q
35                discharging; echo $?'
36
37       -f FACTOR
38       --factor FACTOR
39                Suspend time factor. Dynamically set -s as amount over limit *
40                factor. Default is 1.
41
42       -H
43       --hard   Hard limit. --hard will suspend the process until the system
44                is under the limits. The default is --soft.
45
46       --io iolimit
47       -I iolimit
48                Limit for I/O. The amount of disk I/O will be computed as a
49                value 0 - 10, where 0 is no I/O and 10 is at least one disk is
50                100% saturated.
51
52                --io will set both --start-io and --run-io.
53
54       --load loadlimit
55       -L loadlimit
56                Limit for load average.
57
58                --load will set both --start-load and --run-load.
59
60       --mem memlimit
61       -M memlimit
62                Limit for free memory. This is the amount of bytes available
63                as free + cache. This limit is treated opposite other limits:
64                If the system is above the limit the program will run, if it
65                is below the limit the program will stop
66
67                memlimit can be postfixed with K, M, G, T, or P which would
68                multiply the size with 1024, 1048576, 1073741824, or
69                1099511627776 respectively.
70
71                --mem will set both --start-mem and --run-mem.
72
73       --noswap
74       -N       No swapping. If the system is swapping both in and out it is a
75                good indication that the system is memory stressed.
76
77                --noswap is over limit if the system is swapping both in and
78                out.
79
80                --noswap will set both --start-noswap and --run-noswap.
81
82       --net    Shorthand for --nethops 3.
83
84       --nethops h
85                Network nice. Pause if the internet connection is overloaded.
86
87                niceload find