summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorMark Schreiber <mark7@alumni.cmu.edu>2016-04-13 09:07:12 -0700
committerMark Schreiber <mark7@alumni.cmu.edu>2016-04-13 09:11:32 -0700
commit1e8dab273d8542366c098dfcda37756db6b2bcd7 (patch)
tree4c9fbbee9124a01a080c6b6ff635d8a5d5304093 /man
parentc094f47b457104c267dd55782efc34c47f05cf9d (diff)
Add CPU usage color thresholds
CPU usage had previously not supported the color option. Add support for a "degraded" state above which the degraded color is used, and a higher "bad" state above which the "bad" color is used. One possible use for these might be indicating whether one or all cores are saturated. Unlike the color settings for other, these are set high enough to be disabled by default. This is done because i3status determines CPU usage over only the last display interval, which means that, a user with a low refresh rate might see frequent, potentially-annoying color changes.
Diffstat (limited to 'man')
-rw-r--r--man/i3status.man15
1 files changed, 14 insertions, 1 deletions
diff --git a/man/i3status.man b/man/i3status.man
index 8508488..f5baa2f 100644
--- a/man/i3status.man
+++ b/man/i3status.man
@@ -381,12 +381,25 @@ specified thermal zone is getting too hot. Defaults to 75 degrees C.
=== CPU Usage
-Gets the percentual CPU usage from +/proc/stat+ (Linux) or +sysctl(3)+ (FreeBSD/OpenBSD).
+Gets the percentual CPU usage from +/proc/stat+ (Linux) or +sysctl(3)+
+(FreeBSD/OpenBSD).
+
+It is possible to define a max_threshold that will color the load
+value red in case the CPU average over the last interval is getting
+higher than the configured threshold. Defaults to 200 (i.e. off).
+
+It is possible to define a degraded_threshold that will color the load
+value yellow in case the CPU average over the last interval is getting
+higher than the configured threshold. Defaults to 150 (i.e. off).
*Example order*: +cpu_usage+
*Example format*: +%usage+
+*Example max_threshold*: +"200,0"+
+
+*Example degraded_threshold*: +"150,0"+
+
=== Load
Gets the system load (number of processes waiting for CPU time in the last