spaces, numbers, symbols and even forest view artwork.
Keying <Enter> with no input will effectively disable the ‘&’ key until a new search string is entered.
& :Locate‐next
Assuming a search string has been established, top will attempt to locate the next occurrence.
When a match is found, the current window is repositioned vertically so the task row containing that string is first. The scroll coordinates message can provide confirmation of such vertical repositioning (see the
‘C’ interactive command). Horizontal scrolling, however, is never altered via searching.
The availability of a matching string will be influenced by the following factors.
a. Which fields are displayable from the total available,
see topic 3b. MANAGING Fields.
b. Scrolling a window vertically and/or horizontally,
see topic 5c. SCROLLING a Window.
c. The state of the command/command‐line toggle,
see the ‘c’ interactive command.
d. The stability of the chosen sort column,
for example PID is good but %CPU bad.
If a search fails, restoring the ‘current’ window home (unscrolled) position, scrolling horizontally, displaying command‐lines or choosing a more stable sort field could yet produce a successful ‘&’ search.
The above interactive commands are always available in full-screen mode but never available in alternate-display mode if the ‘current’ window’s task display has been toggled Off.
5e. FILTERING in a Window
You can use this ‘Other Filter’ feature to establish selection criteria which will then determine which tasks are shown in the ‘current’ window. Such filters can be made persistent if preserved in the rcfile via the
‘W’ interactive command.
Establishing a filter requires: 1) a field name; 2) an operator; and 3) a selection value, as a minimum. This is the most complex of top’s user input requirements so, when you make a mistake, command recall will be
your friend. Remember the Up/Down arrow keys or their aliases when prompted for input.
Filter Basics
1. field names are case sensitive and spelled as in the header
2. selection values need not comprise the full displayed field
3. a selection is either case insensitive or sensitive to case
4. the default is inclusion, prepending ‘!’ denotes exclusions
5. multiple selection criteria can be applied to a task window
6. inclusion and exclusion criteria can be used simultaneously
7. the 1 equality and 2 relational filters can be freely mixed
8. separate unique filters are maintained for each task window
If a field is not turned on or is not currently in view, then your selection criteria will not affect the display. Later, should a filtered field become visible, the selection criteria will then be applied.
Keyboard Summary
O :Other‐Filter (upper case)
You will be prompted to establish a case sensitive filter.
o :Other‐Filter (lower case)
You will be prompted to establish a filter that ignores case when matching.
^O :Show‐Active‐Filters (Ctrl key + ‘o’)
This can serve as a reminder of which filters are active in the ‘current’ window. A summary will be shown on the message line until you press the <Enter> key.
= :Reset‐Filtering in current window
This clears all of your selection criteria in the ‘current’ window. It also has additional impact so please see topic 4a. GLOBAL Commands.
+ :Reset‐Filtering in all windows
This clears the selection criteria in all windows, assuming you are in alternate-display mode. As with the ‘=’ interactive command, it too has additional consequences so you might wish to see topic 5b. COMMANDS
for Windows.
Input Requirements