doc: describe new marsadm macros

docu/mars-user-manual.lyx

@@ -5395,7 +5395,11 @@ Primary
 \family typewriter
 RemainsPrimary
 \family default
-, or 
+, 
+\family typewriter
+ForcedPrimary
+\family default
+ or 
 \family typewriter
 Secondary
 \family default
@@ -5428,6 +5432,25 @@ should
 /dev/mars/mydata
 \family default
  device is currently in use .
+ 
+\family typewriter
+ForcedPrimary
+\family default
+ indicates that 
+\emph on
+multiple
+\emph default
+ cluster hosts (see 
+\family typewriter
+%nr-primary{}
+\family default
+) are claiming to be in actual primary role, e.g.
+ when another one is in role 
+\family typewriter
+RemainsPrimary
+\family default
+, or when network interruption is preventing role change information from
+ propagating.
 \begin_inset Newline newline
 \end_inset
 
@@ -5539,7 +5562,7 @@ RemainsPrimary
 \begin_layout Plain Layout
 
 \family typewriter
-Primary
+Primary / ForcedPrimary
 \end_layout
 
 \end_inset
@@ -31389,6 +31412,27 @@ reference "subsec:Emergency-Mode"
 \begin_layout Labeling
 \labelwidthstring 00.00.0000
 
+\family typewriter
+nr-{attach,sync,fetch,replay,primary}
+\family default
+ Show the 
+\emph on
+total number
+\emph default
+ of cluster hosts which are in corresponding state 
+\family typewriter
+%is-
+\emph on
+$something
+\emph default
+{}
+\family default
+.
+\end_layout
+
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
 \family typewriter
 rest-space
 \family default

docu/marsadm.help

@@ -664,7 +664,7 @@ marsadm [<global_options>] view[-<macroname>] [<resource_names> | all ]
   {fetch,replay,work}-{lognr,logcount}
   {get,actual}-primary
   {implemented,usable}-{digests,compressions}
-  {is,todo}-{attach,sync,fetch,replay,primary}
+  {is,todo,nr}-{attach,sync,fetch,replay,primary}
   {my,all}-resources
   {potential,implemented,usable}-features
   {sync,fetch,replay,work,syncpos}-{size,pos}