Home Explore Blog CI



man-pages

30th chunk of `top.man`
49f18151e1d80fe3818d0fe7119436b8cd443425131f6df70000000100000ff7
 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

Title: Top Command: Searching and Filtering in a Window (Continued)
Summary
This section continues explaining the searching functionality within the 'top' command, and outlines factors that affect search success such as field visibility, scrolling, command-line visibility, and sort column stability. It introduces the 'Other Filter' feature for establishing selection criteria to determine visible tasks, detailing the basics of filter creation, keyboard shortcuts for establishing and managing filters, and the input requirements for filter criteria.