doc: updated with library p-core/e-core identification

Signed-off-by: Jim Warner <james.warner@comcast.net>

diff --git a/NEWS b/NEWS
index c97ee699e54a52f40f39961f7bd218308d27be89..7a92ad44415c6fa833eb52a3d699940dc279c6c4 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -19,6 +19,8 @@ procps-ng-NEXT
   * top: will accept utf8 multi-byte input with support
          for full line editing and previous line recall
   * top: can show more than 2 abreast in summary display
+  * top: can distinguish P-Core and E-core cpus
+  * top: can filter both P-Core and E-core cpus
   * watch: Add equexit no-change and exit option           merge #153
 
 procps-ng-4.0.0

diff --git a/man/top.1 b/man/top.1
index 5561d5f271c3f9324caecbb702bc03c99a3cf943..f03ad8fc5c799ca827f1b7d114b443e44cbaa9eb 100644 (file)
--- a/man/top.1
+++ b/man/top.1
@@ -1283,7 +1283,7 @@ depending on the context in which they are issued.
         A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z,
         ^G, ^K, ^N, ^P, ^U, ^L, ^R
   4b.\fI Summary-Area-Commands \fR
-        C, l, t, m, 1, 2, 3, 4, !
+        C, l, t, m, 1, 2, 3, 4, 5, !
   4c.\fI Task-Area-Commands \fR
         Appearance:  b, J, j, x, y, z
         Content:     c, F, f, O, o, S, U, u, V, v, ^E
@@ -1702,7 +1702,28 @@ If one wished to quickly exit adjacent mode without cycling all the
 way to 8, simply use the `1' \*(CT.
 
 .TP 7
-\ \ \ \fB!\fR\ \ :\fICombine-Cpus-Mode \fR
+\ \ \ \fB5\fR\ \ :\fIDisplay-P-Cores-and-E-Cores\fR toggle \fR
+This \*(CT is only active when the `t' toggle is \*O and the `1', `2',
+`3' and `!' toggles are \*F, thus showing individual \*(PU results.
+It assumes a platform has multiple cores of two distinct types,
+either multi-threaded (P-Core) or single-threaded (E-Core).
+
+While normally each \*(Pu is displayed as `%Cpu0, %Cpu1, ...', this
+toggle can be used to identify and/or filter those \*(Pus by their
+core type, either P-Core (performance) or E-Core (efficient).
+
+The 1st time `5' is struck, each \*(PU is displayed as `%Cp\fBP\fR'
+or `%Cp\fBE\fR' representing the two core types.
+The 2nd time, only P-Cores (%Cp\fBP\fR) will be shown.
+The 3rd time, only E-Cores (%Cp\fBE\fR) are displayed.
+When this \*(CT is struck for the 4th time, the \*(PU display
+returns to the normal `%Cpu' convention.
+
+If separate\fI performance\fR and\fI efficient\fR categories are
+not present, this \*(CT will have no effect.
+
+.TP 7
+\ \ \ \fB!\fR\ \ :\fICombine-Cpus-Mode\fR toggle \fR
 This \*(CT is intended for massively parallel SMP environments where,
 even with the `4' \*(CT, not all processors can be displayed.
 With each press of `!' the number of additional \*(Pus combined is
@@ -1717,7 +1738,7 @@ Then the third '!' press, combining four additional \*(Pus, shows
 as `0-4, 5-9, ...', etc.
 
 Such progression continues until individual \*(Pus are again displayed
-and impacts both the `1' and `4' toggles (one or two columns).
+and impacts both the `1' and `4' toggles (one or muliple columns).
 Use the `=' command to exit \fBCombine Cpus\fR mode.
 
 .PP