Maxime Schmitt fae7d7f65d Update interface codebase
The interface layout selection has been updated to support the interface option.
The interface option stores which data that needs to be plotted for each
devices.

The plot drawing code now supports the reverse plotting option.

The interface uses the ring buffer, the updated version of
the layout computation and plots the data specified by the interface options.
2021-05-17 23:32:59 +02:00
2021-05-17 23:32:59 +02:00
2018-11-21 13:46:39 +01:00
2021-05-17 23:32:59 +02:00
2017-06-16 11:50:53 +02:00
2017-06-16 11:50:53 +02:00
2017-06-16 11:50:53 +02:00
2018-03-29 18:12:34 +02:00

NVTOP

What is NVTOP?

Nvtop stands for NVidia TOP, a (h)top like task monitor for NVIDIA GPUs. It can handle multiple GPUs and print information about them in a htop familiar way.

Because a picture is worth a thousand words:

NVTOP interface

Table of Contents

  1. NVTOP Options and Interactive Commands
  2. GPU Support
  3. Build
    1. Ubuntu / Debian
    2. Fedora / RedHat / CentOS
    3. OpenSUSE
    4. Arch Linux
    5. Gentoo
    6. NVTOP Build
  4. Troubleshoot
  5. License

NVTOP Options and Interactive Commands

NVTOP comes with a manpage!

man nvtop

For quick command line arguments help

nvtop -h
nvtop --help

GPU Support

The NVML library does not support some of the queries for GPUs coming before the Kepler microarchitecture. Anything starting at GeForce 600, GeForce 800M and successor should work fine. For more information about supported GPUs please take a look at the NVML documentation.

Build

Two libraries are required:

  • The NVIDIA Management Library (NVML) which comes with the GPU driver.
    • This queries the GPU for information.
  • The ncurses library driving the user interface.
    • This makes the screen look beautiful.

Distribution Specific Installation Process

Ubuntu / Debian

Ubuntu disco (19.04) / Debian buster (stable)

  • sudo apt install nvtop
    

Older

Fedora / RedHat / CentOS

  • NVIDIA drivers, CUDA required for nvml libraries (see RPM Fusion)
  • CMake, ncurses and git
    sudo dnf install cmake ncurses-devel git
    
  • NVTOP

OpenSUSE

Arch Linux

  • sudo pacman -S nvtop
    

Gentoo

  • sudo layman -a guru && sudo emerge -av nvtop
    

NVTOP Build

git clone https://github.com/Syllo/nvtop.git
mkdir -p nvtop/build && cd nvtop/build
cmake ..
make
make install # You may need sufficient permission for that (root)

If you use conda as environment manager and encounter an error while building nvtop, try conda deactivate before invoking cmake.

The build system supports multiple build type (e.g. -DCMAKE_BUILD_TYPE=RelWithDebInfo):

  • Release: Binary without debug information
  • RelWithDebInfo: Binary with debug information
  • Debug: Compile with warning flags and address/undefined sanitizers enabled (for development purposes)

Troubleshoot

  • The plot looks bad:
    • Verify that you installed the wide character version of the NCurses library (libncursesw5-dev for Debian / Ubuntu), clean the build directory and restart the build process.
  • Putty: Tell putty not to lie about its capabilities ($TERM) by setting the field Terminal-type string to putty in the menu Connection > Data > Terminal Details.

License

Nvtop is licensed under the GPLV3 license or any later version. You will find a copy of the license inside the COPYING file of the repository or at the gnu website <www.gnu.org/licenses/>.

Description
No description provided
Readme 7.3 MiB
Languages
C 91.3%
CMake 6%
C++ 1.1%
Objective-C 1%
Shell 0.4%
Other 0.2%