doc: describe new macros

docu/mars-user-manual.lyx

@@ -4194,6 +4194,16 @@ comminfo
 \begin_layout Labeling
 \labelwidthstring 00.00.0000
 
+\family typewriter
+device-info
+\family default
+ When present, shows the status of /dev/mars/mydata in human-readyble form.
+ Shows the empty string when /dev/mars/mydata is not present.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
 \family typewriter
 diskstate
 \family default
@@ -31446,6 +31456,40 @@ dd
 , or by iSCSI, etc.
 \end_layout
 
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\family typewriter
+device-{ops,amount}-rate
+\family default
+ Show the number of current IOPS, esp.
+ the current throughput in KiB/s.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\family typewriter
+device-nrflying
+\family default
+ Show the number of currently flying IO requests.
+ This is an indicator of queueing at the low-level device.
+ When it is permenantly very high, it may point at IO problems, such as
+ RAID degradation.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\family typewriter
+device-error
+\family default
+ Show the negative Linux errno code of the last IO error.
+ It should be always zero.
+ When < 0 according to kernel return-code conventions, this typically indicates
+ a hardware (or network) problem.
+\end_layout
+
 \begin_layout Labeling
 \labelwidthstring 00.00.0000
 {potential,implemented,usable}-features Show a list of flag names, indicating
@@ -32223,6 +32267,16 @@ estimated
 \begin_layout Labeling
 \labelwidthstring 00.00.0000
 
+\family typewriter
+{sync,fetch,replay}-{ops,amount}-rate
+\family default
+ Show the current IOPS of sync / fetch / replay, or its corresponding throughput
+ in KiB/s.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
 \family typewriter
 summary-vector
 \family default

docu/marsadm.help

@@ -595,6 +595,8 @@ marsadm [<global_options>] view[-<macroname>] [<resource_names> | all ]
   default-global
   default-header
   default-resource
+  device-info
+  device-stats
   diskstate
   diskstate-1and1
   dstate
@@ -628,7 +630,8 @@ marsadm [<global_options>] view[-<macroname>] [<resource_names> | all ]
 <primitive_macroname> =
   count-{cluster,resource}-members
   deletable-size
-  device-opened
+  device-{opened,nrflying,error}
+  device-{ops-rate,amount-rate,rate}
   disabled-{log|net}-digests
   enabled-{log|net}-compressions
   errno-text
@@ -666,7 +669,7 @@ marsadm [<global_options>] view[-<macroname>] [<resource_names> | all ]
   {potential,implemented,usable}-features
   {sync,fetch,replay,work,syncpos}-{size,pos}
   {sync,fetch,replay,work}-{rest,{almost-,threshold-,}reached,percent,permille,vector}
-  {sync,fetch,replay}-{rate,remain}
+  {sync,fetch,replay}-{ops-rate,amount-rate,rate,remain}
   {time,real-time}
   {tree,features}-version