|
| 1 | +NVTOP |
| 2 | +===== |
| 3 | + |
| 4 | +What is NVTOP? |
| 5 | +-------------- |
| 6 | + |
| 7 | +Nvtop stands for NVidia TOP, a (h)top like task monitor for NVIDIA GPUs. It can |
| 8 | +handle multiple GPUs and print information about them in a htop familiar way. |
| 9 | + |
| 10 | +Because a picture is worth a thousand words: |
| 11 | + |
| 12 | + |
| 13 | + |
| 14 | +Dependencies |
| 15 | +------------ |
| 16 | + |
| 17 | +Three libraries are required: |
| 18 | + |
| 19 | +* The NVIDIA Management Library (NVML). |
| 20 | + * This queries the GPU for information. |
| 21 | +* The ncurses library driving the user interface. |
| 22 | + * This drives the screen. |
| 23 | + |
| 24 | +Limitations |
| 25 | +----------- |
| 26 | + |
| 27 | +The NVML library does not support some of the queries for GPUs coming before the |
| 28 | +Kepler microarchitecture. Anything starting at GeForce 600, GeForce 800M and |
| 29 | +successor should work fine. For more information about supported GPUs please |
| 30 | +take a look at the [NVML documentation](http://docs.nvidia.com/deploy/nvml-api/nvml-api-reference.html#nvml-api-reference). |
| 31 | + |
| 32 | +Build |
| 33 | +----- |
| 34 | + |
| 35 | +CMAKE is used as build manager. |
| 36 | + |
| 37 | +To build the binary on Linux: |
| 38 | + |
| 39 | +```bash |
| 40 | +mkdir build && cd build |
| 41 | +cmake .. |
| 42 | +make |
| 43 | +make install # You may need sufficent permission for that (root) |
| 44 | +``` |
| 45 | + |
| 46 | +The build system support multiple build type (-DCMAKE_BUILD_TYPE): |
| 47 | + |
| 48 | +* Release: Binary without debug information |
| 49 | +* RelWithDebInfo: Binary with debug information |
| 50 | +* Debug: Compile warning flags and address/undefined sanitizer (For development only) |
| 51 | +* Optimized: Build with architecture specific optimisations (May be not portable across machines with different processor) |
| 52 | + |
| 53 | +Build Options |
| 54 | +------------- |
| 55 | + |
| 56 | +None for the moment. |
| 57 | + |
| 58 | +License |
| 59 | +------- |
| 60 | + |
| 61 | +Nvtop is licensed under the GPLV3 licence or any later version. |
| 62 | +You will find a copy of the license inside the COPYING file of the repository or |
| 63 | +at the gnu website <[www.gnu.org/licenses/](http://www.gnu.org/licenses/)>. |
0 commit comments