Skip to content

Commit e037245

Browse files
committed
Add README
1 parent d9f62ba commit e037245

File tree

2 files changed

+63
-0
lines changed

2 files changed

+63
-0
lines changed

README.markdown

+63
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
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+
![NVTOP interface](/screenshot/NVTOP_ex1.png)
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/)>.

screenshot/NVTOP_ex1.png

29.8 KB
Loading

0 commit comments

Comments
 (0)