1 files changed, 27 insertions, 10 deletions
diff --git a/src/pidstat.md b/src/pidstat.md
index c17a2e6..8fb1106 100644
--- a/src/pidstat.md
+++ b/src/pidstat.md
@@ -1,13 +1,30 @@
 # pidstat(1)
 
-Trace minor/major page faults.
-```markdown
-pidstat -r -p <pid> [interval]
-  minor_pagefault: happens when the page needed is already in memory but not
-                   allocated to the faulting process, in that case the kernel
-                   only has to create a new page-table entry pointing to the
-                   shared physical page
-  major_pagefault: happends when the page needed is NOT in memory, the kernel
-                   has to create a new page-table entry and populate the
-                   physical page
+```markdown
+pidstat [opt] [interval] [cont]
+  -U [user]     show username instead UID, optionally only show for user
+  -r            memory statistics
+  -d            I/O statistics
+```
+
+# Page fault and memory utilization
+```markdown
+pidstat -r -p <pid> [interval] [count]
+```
+
+```markdown
+minor_pagefault: Happens when the page needed is already in memory but not
+                 allocated to the faulting process, in that case the kernel
+                 only has to create a new page-table entry pointing to the
+                 shared physical page (not required to load a memory page from
+                 disk).
+
+major_pagefault: Happens when the page needed is NOT in memory, the kernel
+                 has to create a new page-table entry and populate the
+                 physical page (required to load a memory page from disk).
+```
+
+# I/O statistics
+```markdown
+pidstat -d -p <pid> [interval] [count]
 ```