From 5aacf360df6b32fe37434ee9b9a42d39f78e874a Mon Sep 17 00:00:00 2001
From: Ashish Shenoy <ashish1shenoy@gmail.com>
Date: Mon, 7 Oct 2019 00:20:39 +0000
Subject: [PATCH] powerstat: add page (#3334)

---
 pages/common/powerstat.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 pages/common/powerstat.md

diff --git a/pages/common/powerstat.md b/pages/common/powerstat.md
new file mode 100644
index 0000000000..4542cf244c
--- /dev/null
+++ b/pages/common/powerstat.md
@@ -0,0 +1,24 @@
+# powerstat
+
+> Measures the power consumption of a computer that has a battery power source or supports the RAPL interface.
+> More information: <http://manpages.ubuntu.com/manpages/bionic/man8/powerstat.8.html>.
+
+- Measure power with the default of 10 samples with an interval of 10 seconds:
+
+`powerstat`
+
+- Measure power with custom number of samples and interval duration:
+
+`powerstat {{interval}} {{number_of_samples}}`
+
+- Measure power using Intel's RAPL interface:
+
+`powerstat -R {{interval}} {{number_of_samples}}`
+
+- Show an histogram of the power measurements:
+
+`powerstat -H {{interval}} {{number_of_samples}}`
+
+- Enable all statistics gathering options:
+
+`powerstat -a {{interval}} {{number_of_samples}}`