diff options
author | nicolargo <nicolashennion@gmail.com> | 2024-06-29 19:19:26 +0200 |
---|---|---|
committer | nicolargo <nicolashennion@gmail.com> | 2024-06-29 19:19:26 +0200 |
commit | f4c7ca01fe6408d61be62399cc4ba0ea36c7e08e (patch) | |
tree | 46eb76b7d5764e7604747c9bfb83b9925235cfc5 /docs/api.rst | |
parent | 60591630df4200addf1b288ed7225de40d2ffb1d (diff) |
Correct codespell
Diffstat (limited to 'docs/api.rst')
-rw-r--r-- | docs/api.rst | 352 |
1 files changed, 165 insertions, 187 deletions
diff --git a/docs/api.rst b/docs/api.rst index f4353810..4bb72447 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -141,7 +141,7 @@ Get plugin stats:: "refresh": 3.0, "regex": True, "result": None, - "timer": 0.44504690170288086}, + "timer": 0.2482151985168457}, {"count": 0, "countmax": 20.0, "countmin": None, @@ -150,7 +150,7 @@ Get plugin stats:: "refresh": 3.0, "regex": True, "result": None, - "timer": 0.4449424743652344}] + "timer": 0.24815130233764648}] Fields descriptions: @@ -178,7 +178,7 @@ Get a specific item when field matches the given value:: "refresh": 3.0, "regex": True, "result": None, - "timer": 0.44504690170288086}]} + "timer": 0.2482151985168457}]} GET cloud --------- @@ -265,19 +265,19 @@ Get plugin stats:: # curl http://localhost:61208/api/4/cpu {"cpucore": 16, - "ctx_switches": 427467586, + "ctx_switches": 493080568, "guest": 0.0, - "idle": 93.0, - "interrupts": 359749831, - "iowait": 0.1, + "idle": 86.5, + "interrupts": 420997918, + "iowait": 0.5, "irq": 0.0, "nice": 0.0, - "soft_interrupts": 133597275, + "soft_interrupts": 155707720, "steal": 0.0, "syscalls": 0, - "system": 2.7, - "total": 6.6, - "user": 4.3} + "system": 3.5, + "total": 12.9, + "user": 9.4} Fields descriptions: @@ -310,7 +310,7 @@ Fields descriptions: Get a specific field:: # curl http://localhost:61208/api/4/cpu/total - {"total": 6.6} + {"total": 12.9} GET diskio ---------- @@ -320,10 +320,10 @@ Get plugin stats:: # curl http://localhost:61208/api/4/diskio [{"disk_name": "nvme0n1", "key": "disk_name", - "read_bytes": 7492967936, - "read_count": 277065, - "write_bytes": 24887440384, - "write_count": 1206489}, + "read_bytes": 10167291392, + "read_count": 391026, + "write_bytes": 31230641152, + "write_count": 1527146}, {"disk_name": "nvme0n1p1", "key": "disk_name", "read_bytes": 7558144, @@ -363,10 +363,10 @@ Get a specific item when field matches the given value:: # curl http://localhost:61208/api/4/diskio/disk_name/nvme0n1 {"nvme0n1": [{"disk_name": "nvme0n1", "key": "disk_name", - "read_bytes": 7492967936, - "read_count": 277065, - "write_bytes": 24887440384, - "write_count": 1206489}]} + "read_bytes": 10167291392, + "read_count": 391026, + "write_bytes": 31230641152, + "write_count": 1527146}]} GET folders ----------- @@ -393,13 +393,13 @@ Get plugin stats:: # curl http://localhost:61208/api/4/fs [{"device_name": "/dev/mapper/ubuntu--vg-ubuntu--lv", - "free": 896615452672, + "free": 897378041856, "fs_type": "ext4", "key": "mnt_point", "mnt_point": "/", - "percent": 5.9, + "percent": 5.8, "size": 1003736440832, - "used": 56058482688}] + "used": 55295893504}] Fields descriptions: @@ -420,13 +420,13 @@ Get a specific item when field matches the given value:: # curl http://localhost:61208/api/4/fs/mnt_point// {"/": [{"device_name": "/dev/mapper/ubuntu--vg-ubuntu--lv", - "free": 896615452672, + "free": 897378041856, "fs_type": "ext4", "key": "mnt_point", "mnt_point": "/", - "percent": 5.9, + "percent": 5.8, "size": 1003736440832, - "used": 56058482688}]} + "used": 55295893504}]} GET gpu ------- @@ -500,9 +500,9 @@ Get plugin stats:: # curl http://localhost:61208/api/4/load {"cpucore": 16, - "min1": 0.728515625, - "min15": 0.88916015625, - "min5": 0.81982421875} + "min1": 0.40185546875, + "min15": 0.587890625, + "min5": 0.638671875} Fields descriptions: @@ -514,7 +514,7 @@ Fields descriptions: Get a specific field:: # curl http://localhost:61208/api/4/load/min1 - {"min1": 0.728515625} + {"min1": 0.40185546875} GET mem ------- @@ -522,16 +522,16 @@ GET mem Get plugin stats:: # curl http://localhost:61208/api/4/mem - {"active": 8275505152, - "available": 4275773440, - "buffers": 116162560, - "cached": 4656115712, - "free": 4275773440, - "inactive": 5691351040, - "percent": 74.0, - "shared": 789377024, + {"active": 5094199296, + "available": 10908983296, + "buffers": 180162560, + "cached": 5800796160, + "free": 10908983296, + "inactive": 3735175168, + "percent": 33.6, + "shared": 622718976, "total": 16422486016, - "used": 12146712576} + "used": 5513502720} Fields descriptions: @@ -558,13 +558,13 @@ GET memswap Get plugin stats:: # curl http://localhost:61208/api/4/memswap - {"free": 3367235584, - "percent": 21.6, - "sin": 12087296, - "sout": 929779712, + {"free": 3836997632, + "percent": 10.7, + "sin": 186925056, + "sout": 1518604288, "time_since_update": 1, "total": 4294963200, - "used": 927727616} + "used": 457965568} Fields descriptions: @@ -589,15 +589,15 @@ Get plugin stats:: # curl http://localhost:61208/api/4/network [{"alias": None, "bytes_all": 0, - "bytes_all_gauge": 5602788085, + "bytes_all_gauge": 6286191015, "bytes_recv": 0, - "bytes_recv_gauge": 5324413260, + "bytes_recv_gauge": 5977645732, "bytes_sent": 0, - "bytes_sent_gauge": 278374825, + "bytes_sent_gauge": 308545283, "interface_name": "wlp0s20f3", "key": "interface_name", "speed": 0, - "time_since_update": 0.4488046169281006}] + "time_since_update": 0.2501566410064697}] Fields descriptions: @@ -626,15 +626,15 @@ Get a specific item when field matches the given value:: # curl http://localhost:61208/api/4/network/interface_name/wlp0s20f3 {"wlp0s20f3": [{"alias": None, "bytes_all": 0, - "bytes_all_gauge": 5602788085, + "bytes_all_gauge": 6286191015, "bytes_recv": 0, - "bytes_recv_gauge": 5324413260, + "bytes_recv_gauge": 5977645732, "bytes_sent": 0, - "bytes_sent_gauge": 278374825, + "bytes_sent_gauge": 308545283, "interface_name": "wlp0s20f3", "key": "interface_name", "speed": 0, - "time_since_update": 0.4488046169281006}]} + "time_since_update": 0.2501566410064697}]} GET now ------- @@ -642,7 +642,7 @@ GET now Get plugin stats:: # curl http://localhost:61208/api/4/now - {"custom": "2024-06-29 09:55:18 CEST", "iso": "2024-06-29T09:55:18+02:00"} + {"custom": "2024-06-29 19:17:41 CEST", "iso": "2024-06-29T19:17:41+02:00"} Fields descriptions: @@ -652,7 +652,7 @@ Fields descriptions: Get a specific field:: # curl http://localhost:61208/api/4/now/iso - {"iso": "2024-06-29T09:55:18+02:00"} + {"iso": "2024-06-29T19:17:41+02:00"} GET percpu ---------- @@ -663,7 +663,7 @@ Get plugin stats:: [{"cpu_number": 0, "guest": 0.0, "guest_nice": 0.0, - "idle": 36.0, + "idle": 21.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -671,12 +671,12 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 64.0, + "total": 79.0, "user": 1.0}, {"cpu_number": 1, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 23.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -684,7 +684,7 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 63.0, + "total": 77.0, "user": 0.0}] Fields descriptions: @@ -719,7 +719,7 @@ Get plugin stats:: "port": 0, "refresh": 30, "rtt_warning": None, - "status": 0.005775, + "status": 0.006275, "timeout": 3}] Fields descriptions: @@ -747,7 +747,7 @@ Get a specific item when field matches the given value:: "port": 0, "refresh": 30, "rtt_warning": None, - "status": 0.005775, + "status": 0.006275, "timeout": 3}]} GET processcount @@ -756,7 +756,7 @@ GET processcount Get plugin stats:: # curl http://localhost:61208/api/4/processcount - {"pid_max": 0, "running": 1, "sleeping": 281, "thread": 1660, "total": 426} + {"pid_max": 0, "running": 2, "sleeping": 277, "thread": 1508, "total": 412} Fields descriptions: @@ -769,7 +769,7 @@ Fields descriptions: Get a specific field:: # curl http://localhost:61208/api/4/processcount/total - {"total": 426} + {"total": 412} GET processlist --------------- @@ -777,62 +777,40 @@ GET processlist Get plugin stats:: # curl http://localhost:61208/api/4/processlist - [{"cmdline": ["/snap/firefox/4336/usr/lib/firefox/firefox", - "-contentproc", - "-childID", - "2", - "-isForBrowser", - "-prefsLen", - "28296", - "-prefMapSize", - "244444", - "-jsInitLen", - "231800", - "-parentBuildID", - "20240527194810", - "-greomni", - "/snap/firefox/4336/usr/lib/firefox/omni.ja", - "-appomni", - "/snap/firefox/4336/usr/lib/firefox/browser/omni.ja", - "-appDir", - "/snap/firefox/4336/usr/lib/firefox/browser", - "{01aadc3d-85fc-4851-9ca1-a43a1e81c3fa}", - "4591", - "true", - "tab"], + [{"cmdline": ["/snap/firefox/4336/usr/lib/firefox/firefox"], "cpu_percent": 0.0, - "cpu_times": {"children_system": 0.0, - "children_user": 0.0, + "cpu_times": {"children_system": 3.08, + "children_user": 3.33, "iowait": 0.0, - "system": 123.83, - "user": 2750.68}, + "system": 13.75, + "user": 34.7}, "gids": {"effective": 1000, "real": 1000, "saved": 1000}, - "io_counters": [8411136, 0, 0, 0, 0], + "io_counters": [393136128, 195969024, 0, 0, 0], "key": "pid", - "memory_info": {"data": 3653316608, + "memory_info": {"data": 681967616, "dirty": 0, "lib": 0, - "rss": 3612418048, - "shared": 128864256, + "rss": 443969536, + "shared": 222199808, "text": 987136, - "vms": 6200733696}, - "memory_percent": 21.996779564802278, - "name": "Isolated Web Co", + "vms": 3721211904}, + "memory_percent": 2.7034246554842674, + "name": "firefox", "nice": 0, - "num_threads": 28, - "pid": 4848, + "num_threads": 120, + "pid": 793506, "status": "S", "time_since_update": 1, "username": "nicolargo"}, {"cmdline": ["/snap/firefox/4336/usr/lib/firefox/firefox", "-contentproc", "-childID", - "3", + "2", "-isForBrowser", "-prefsLen", - "28296", + "28218", "-prefMapSize", - "244444", + "244440", "-jsInitLen", "231800", "-parentBuildID", @@ -843,31 +821,31 @@ Get plugin stats:: "/snap/firefox/4336/usr/lib/firefox/browser/omni.ja", "-appDir", "/snap/firefox/4336/usr/lib/firefox/browser", - "{0ae685c6-7105-4724-886c-98d4a4a9a4f8}", - "4591", + "{bc853380-6b8f-46ad-afe0-9da5ba832e62}", + "793506", "true", "tab"], "cpu_percent": 0.0, "cpu_times": {"children_system": 0.0, "children_user": 0.0, "iowait": 0.0, - "system": 52.38, - "user": 492.92}, + "system": 2.54, + "user": 19.25}, "gids": {"effective": 1000, "real": 1000, "saved": 1000}, - "io_counters": [2974720, 0, 0, 0, 0], + "io_counters": [1827840, 0, 0, 0, 0], "key": "pid", - "memory_info": {"data": 1961992192, + "memory_info": {"data": 412688384, "dirty": 0, "lib": 0, - "rss": 1941671936, - "shared": 121491456, + "rss": 440922112, + "shared": 111878144, "text": 987136, - "vms": 4457148416}, - "memory_percent": 11.823252180627705, + "vms": 2946224128}, + "memory_percent": 2.684868244493684, "name": "Isolated Web Co", "nice": 0, "num_threads": 28, - "pid": 4852, + "pid": 793778, "status": "S", "time_since_update": 1, "username": "nicolargo"}] @@ -902,18 +880,18 @@ GET quicklook Get plugin stats:: # curl http://localhost:61208/api/4/quicklook - {"cpu": 6.6, + {"cpu": 12.9, "cpu_hz": 4475000000.0, - "cpu_hz_current": 570218562.5, + "cpu_hz_current": 1666410624.9999998, "cpu_log_core": 16, "cpu_name": "13th Gen Intel(R) Core(TM) i7-13620H", "cpu_phys_core": 10, - "load": 5.6, - "mem": 74.0, + "load": 3.7, + "mem": 33.6, "percpu": [{"cpu_number": 0, "guest": 0.0, "guest_nice": 0.0, - "idle": 36.0, + "idle": 21.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -921,12 +899,12 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 64.0, + "total": 79.0, "user": 1.0}, {"cpu_number": 1, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 23.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -934,25 +912,25 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 63.0, + "total": 77.0, "user": 0.0}, {"cpu_number": 2, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 18.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", "nice": 0.0, "softirq": 0.0, "steal": 0.0, - "system": 0.0, - "total": 63.0, - "user": 0.0}, + "system": 1.0, + "total": 82.0, + "user": 5.0}, {"cpu_number": 3, "guest": 0.0, "guest_nice": 0.0, - "idle": 35.0, + "idle": 22.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -960,25 +938,25 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 65.0, - "user": 2.0}, + "total": 78.0, + "user": 0.0}, {"cpu_number": 4, "guest": 0.0, "guest_nice": 0.0, - "idle": 21.0, + "idle": 8.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", "nice": 0.0, "softirq": 0.0, "steal": 0.0, - "system": 2.0, - "total": 79.0, - "user": 15.0}, + "system": 1.0, + "total": 92.0, + "user": 14.0}, {"cpu_number": 5, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 23.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -986,64 +964,64 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 63.0, - "user": 1.0}, + "total": 77.0, + "user": 0.0}, {"cpu_number": 6, "guest": 0.0, "guest_nice": 0.0, - "idle": 21.0, - "iowait": 0.0, + "idle": 3.0, + "iowait": 1.0, "irq": 0.0, "key": "cpu_number", "nice": 0.0, "softirq": 0.0, "steal": 0.0, - "system": 1.0, - "total": 79.0, + "system": 4.0, + "total": 97.0, "user": 15.0}, {"cpu_number": 7, "guest": 0.0, "guest_nice": 0.0, - "idle": 38.0, + "idle": 23.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", "nice": 0.0, "softirq": 0.0, "steal": 0.0, - "system": 0.0, - "total": 62.0, + "system": 1.0, + "total": 77.0, "user": 0.0}, {"cpu_number": 8, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 19.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", "nice": 0.0, "softirq": 0.0, "steal": 0.0, - "system": 0.0, - "total": 63.0, - "user": 0.0}, + "system": 1.0, + "total": 81.0, + "user": 3.0}, {"cpu_number": 9, "guest": 0.0, "guest_nice": 0.0, - "idle": 38.0, - "iowait": 0.0, + "idle": 22.0, + "iowait": 1.0, "irq": 0.0, "key": "cpu_number", "nice": 0.0, "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 62.0, + "total": 78.0, "user": 0.0}, {"cpu_number": 10, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 22.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -1051,12 +1029,12 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 63.0, + "total": 78.0, "user": 0.0}, {"cpu_number": 11, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 23.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -1064,12 +1042,12 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 63.0, + "total": 77.0, "user": 0.0}, {"cpu_number": 12, "guest": 0.0, "guest_nice": 0.0, - "idle": 36.0, + "idle": 21.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -1077,12 +1055,12 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 1.0, - "total": 64.0, + "total": 79.0, "user": 1.0}, {"cpu_number": 13, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 23.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -1090,12 +1068,12 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 63.0, + "total": 77.0, "user": 0.0}, {"cpu_number": 14, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 22.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -1103,12 +1081,12 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 63.0, + "total": 78.0, "user": 0.0}, {"cpu_number": 15, "guest": 0.0, "guest_nice": 0.0, - "idle": 37.0, + "idle": 22.0, "iowait": 0.0, "irq": 0.0, "key": "cpu_number", @@ -1116,9 +1094,9 @@ Get plugin stats:: "softirq": 0.0, "steal": 0.0, "system": 0.0, - "total": 63.0, + "total": 78.0, "user": 0.0}], - "swap": 21.6} + "swap": 10.7} Fields descriptions: @@ -1156,14 +1134,14 @@ Get plugin stats:: "label": "Ambient", "type": "temperature_core", "unit": "C", - "value": 36, + "value": 39, "warning": 0}, {"critical": None, "key": "label", "label": "Ambient 3", "type": "temperature_core", "unit": "C", - "value": 31, + "value": 32, "warning": 0}] Fields descriptions: @@ -1224,7 +1202,7 @@ Get a specific item when field matches the given value:: "label": "Ambient", "type": "temperature_core", "unit": "C", - "value": 36, + "value": 39, "warning": 0}]} GET smart @@ -1255,7 +1233,7 @@ Fields descriptions: * **platform**: Platform (32 or 64 bits) (unit is *None*) * **linux_distro**: Linux distribution (unit is *None*) * **os_version**: Operating system version (unit is *None*) -* **hr_name**: Human readable operating sytem name (unit is *None*) +* **hr_name**: Human readable operating system name (unit is *None*) Get a specific field:: @@ -1268,7 +1246,7 @@ GET uptime Get plugin stats:: # curl http://localhost:61208/api/4/uptime - "19 days, 16:58:04" + "20 days, 2:20:27" GET version ----------- @@ -1276,7 +1254,7 @@ GET version Get plugin stats:: # curl http://localhost:61208/api/4/version - "4.1.0" + "4.2.0_beta01" GET wifi -------- @@ -1285,8 +1263,8 @@ Get plugin stats:: # curl http://localhost:61208/api/4/wifi [{"key": "ssid", - "quality_level": -58.0, - "quality_link": 52.0, + "quality_level": -59.0, + "quality_link": 51.0, "ssid": "wlp0s20f3"}] Get a specific field:: @@ -1298,8 +1276,8 @@ Get a specific item when field matches the given value:: # curl http://localhost:61208/api/4/wifi/ssid/wlp0s20f3 {"wlp0s20f3": [{"key": "ssid", - "quality_level": -58.0, - "quality_link": 52.0, + "quality_level": -59.0, + "quality_link": 51.0, "ssid": "wlp0s20f3"}]} GET all stats @@ -1344,34 +1322,34 @@ GET stats history History of a plugin:: # curl http://localhost:61208/api/4/cpu/history - {"system": [["2024-06-29T09:55:19.540650", 2.7], - ["2024-06-29T09:55:20.619021", 0.5], - ["2024-06-29T09:55:21.631678", 0.5]], - "user": [["2024-06-29T09:55:19.540644", 4.3], - ["2024-06-29T09:55:20.619018", 0.4], - ["2024-06-29T09:55:21.631673", 0.4]]} + {"system": [["2024-06-29T19:17:42.396270", 3.5], + ["2024-06-29T19:17:43.447397", 0.7], + ["2024-06-29T19:17:44.455830", 0.7]], + "user": [["2024-06-29T19:17:42.396268", 9.4], + ["2024-06-29T19:17:43.447396", 4.0], + ["2024-06-29T19:17:44.455825", 4.0]]} Limit history to last 2 values:: # curl http://localhost:61208/api/4/cpu/history/2 - {"system": [["2024-06-29T09:55:20.619021", 0.5], - ["2024-06-29T09:55:21.631678", 0.5]], - "user": [["2024-06-29T09:55:20.619018", 0.4], - ["2024-06-29T09:55:21.631673", 0.4]]} + {"system": [["2024-06-29T19:17:43.447397", 0.7], + ["2024-06-29T19:17:44.455830", 0.7]], + "user": [["2024-06-29T19:17:43.447396", 4.0], + ["2024-06-29T19:17:44.455825", 4.0]]} History for a specific field:: # curl http://localhost:61208/api/4/cpu/system/history - {"system": [["2024-06-29T09:55:18.389360", 2.7], - ["2024-06-29T09:55:19.540650", 2.7], - ["2024-06-29T09:55:20.619021", 0.5], - ["2024-06-29T09:55:21.631678", 0.5]]} + {"system": [["2024-06-29T19:17:41.318736", 3.5], + ["2024-06-29T19:17:42.396270", 3.5], + ["2024-06-29T19:17:43.447397", 0.7], + ["2024-06-29T19:17:44.455830", 0.7]]} Limit history for a specific field to last 2 values:: # curl http://localhost:61208/api/4/cpu/system/history - {"system": [["2024-06-29T09:55:20.619021", 0.5], - ["2024-06-29T09:55:21.631678", 0.5]]} + {"system": [["2024-06-29T19:17:43.447397", 0.7], + ["2024-06-29T19:17:44.455830", 0.7]]} GET limits (used for thresholds) -------------------------------- |