From dd5b24727f3d99bee04f8b4300cad539fd1531b5 Mon Sep 17 00:00:00 2001
From: albert <>
Date: Wed, 11 Dec 2002 23:17:18 +0000
Subject: [PATCH] document u U -u -U

---
 NEWS  |  6 ++++++
 top.1 | 22 ++++++++++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/NEWS b/NEWS
index 81b2c061..75a0455e 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,9 @@
+procps-3.1.2 --> procps-3.1.3
+
+top: user selection
+sysctl: -e
+w: stdout, not stderr -- thanks to Sander van Malssen
+
 procps-3.1.1 --> procps-3.1.2
 
 better RPM generation
diff --git a/top.1 b/top.1
index bb5fc366..4520090e 100644
--- a/top.1
+++ b/top.1
@@ -258,6 +258,16 @@ When this toggle is \*F, tasks that are idled or zombied will not be displayed.
 Specifies the maximum number of iterations, or frames, \*(Me should
 produce before ending.
 
+.TP 5
+\-\fBu\fR :\fB Monitor by user\fR as:\fB\ \ -u somebody
+Monitor only processes with an effective UID or user name
+matching that given.
+
+.TP 5
+\-\fBU\fR :\fB Monitor by user\fR as:\fB\ \ -U somebody
+Monitor only processes with a UID or user name matching that given.
+This matches real, effective, saved, and filesystem UIDs.
+
 .TP 5
 \-\fBp\fR :\fB Monitor PIDs\fR as:\fB\ \ -pN1 -pN2 ...\fR\ \ or\fB\ \ -pN1, N2 [,...]
 Monitor only processes with specified process IDs.
@@ -627,6 +637,18 @@ When operating in 'Solaris mode' ('I' toggled \*F), a task's \*(Pu usage
 will be divided by the total number of \*(PUs.
 After issuing this command, you'll be informed of the new state of this toggle.
 
+.TP 7
+\ \ \'\fBu\fR\' :\fIselect a user\fR
+You will be prompted for a UID or username. Only processes
+belonging to the selected user will be displayed. This option
+matches on the effective UID.
+
+.TP 7
+\ \ \'\fBU\fR\' :\fIselect a user\fR
+You will be prompted for a UID or username. Only processes
+belonging to the selected user will be displayed. This option
+matches on the real, effective, saved, and filesystem UID.
+
 .TP 7
 *\ \'\fBk\fR\' :\fIKill_a_task\fR
 You will be prompted for a PID and then the signal to send.