Home Explore Blog CI



man-pages

1st chunk of `top.man`
ab51b2b44bdbe7e9ebcabe0d0dad952c2781ebc25e0edff00000000100000fba
TOP(1)                                                                                                    User Commands                                                                                                   TOP(1)

NAME
       top - display Linux processes

SYNOPSIS
       top [options]

DESCRIPTION
       The  top  program  provides a dynamic real‐time view of a running system.  It can display system summary information as well as a list of processes or threads currently being managed by the Linux kernel.  The types of
       system summary information shown and the types, order and size of information displayed for processes are all user configurable and that configuration can be made persistent across restarts.

       The program provides a limited interactive interface for process manipulation as well as a much more extensive interface for personal configuration  --  encompassing every aspect of its operation.  And  while  top  is
       referred  to  throughout  this document, you are free to name the program anything you wish.  That new name, possibly an alias, will then be reflected on top’s display and used when reading and writing a configuration
       file.

OVERVIEW
   Documentation
       The remaining Table of Contents

           OVERVIEW
              Operation
              Linux Memory Types
           1. COMMAND-LINE Options
           2. SUMMARY Display
              a. UPTIME and LOAD Averages
              b. TASK and CPU States
              c. MEMORY Usage
           3. FIELDS / Columns Display
              a. DESCRIPTIONS of Fields
              b. MANAGING Fields
           4. INTERACTIVE Commands
              a. GLOBAL Commands
              b. SUMMARY AREA Commands
              c. TASK AREA Commands
                 1. Appearance
                 2. Content
                 3. Size
                 4. Sorting
              d. COLOR Mapping
           5. ALTERNATE-DISPLAY Provisions
              a. WINDOWS Overview
              b. COMMANDS for Windows
              c. SCROLLING a Window
              d. SEARCHING in a Window
              e. FILTERING in a Window
           6. FILES
              a. PERSONAL Configuration File
              b. ADDING INSPECT Entries
              c. SYSTEM Configuration File
              d. SYSTEM Restrictions File
           7. ENVIRONMENT VARIABLE(S)
           8. STUPID TRICKS Sampler
              a. Kernel Magic
              b. Bouncing Windows
              c. The Big Bird Window
              d. The Ol’ Switcheroo
           9. BUGS, 10. SEE Also

   Operation
       When operating top, the two most important keys are the help (h or ?)  key and quit (‘q’) key.  Alternatively, you could simply use the traditional interrupt key (^C) when you’re done.

       When started for the first time, you’ll be presented with these traditional elements on the main top screen: 1) Summary Area; 2) Fields/Columns Header; 3) Task Area.  Each of these will be  explored  in  the  sections
       that follow.  There is also an Input/Message line between the Summary Area and Columns Header which needs no further explanation.

       The  main  top  screen  is  generally  quite  adaptive  to changes in terminal dimensions under X‐Windows.  Other top screens may be less so, especially those with static text.  It ultimately depends, however, on your
       particular window manager and terminal emulator.  There may be occasions when their view of terminal size and current contents differs from top’s view, which is always based on operating system calls.

       Following any re‐size operation, if a top screen is corrupted, appears incomplete or disordered, simply typing something innocuous like a punctuation character or cursor motion key will usually restore it.  In extreme
       cases, the following sequence almost certainly will:
              key/cmd  objective
              ^Z       suspend top
              fg       resume top
              <Left>   force a screen

Title: Introduction to the `top` command
Summary
This document introduces the `top` command, a program that provides a dynamic real-time view of a running system in Linux. It covers the program's features, including displaying system summary information and managing processes/threads. It also highlights the interactive interface, configuration options, and various command-line options.