.\" Manpage for nvtop
.\" Contact maxime.schmitt91@gmail.com

.TH nvtop 1 "January 2019" "Version @nvtop_VERSION_MAJOR@.@nvtop_VERSION_MINOR@.@nvtop_VERSION_PATCH@" "nvtop command"

.SH NAME
nvtop \- NVIDIA GPU top

.SH SYNOPSIS
.B nvtop
\fR[\fB\-hv\fR]
\fR[\fB\-si\fR \fIid1:id2:...\fR]
\fR[\fB\-d\fR \fIdelay\fR]

.SH DESCRIPTION
nvtop is a ncurses\-based GPU status viewer for NVIDIA GPUs.

.SH COMMAND\-LINE OPTIONS
.TP
.BR \-d ", " \-\-delay =\fIdelay\fR
Delay between updates, in tenths of seconds (\fIdelay\fR * 0.1s).
.TP
.BR \-h ", " \-\-help
Print the help and exit.
.TP
.BR \-s ", " \-\-gpu\-select =\fIid1:...\fR
Colon separated list of GPU IDs to be monitored by nvtop.
.TP
.BR \-i ", " \-\-gpu\-ignore =\fIid1:...\fR
Colon separated list of GPU IDs to be ignored by nvtop.
.TP
.BR \-C ", " \-\-no\-color
Monochrome mode.
.TP
.BR \-N ", " \-\-no\-cache
Disable the (process id, user name, command line) cache and query the system at each refresh.
.TP
.BR \-f ", " \-\-freedom\-unit
Use fahrenheit as temperature scale.
.TP
.BR \-E ", " \-\-encode\-hide =\fIseconds\fR
Modify the setting for the encode/decode auto-hide timer. Always visible if negative. Default to 30 seconds.
.TP
.BR \-p ", " \-\-no\-plot
Show only one bar plot corresponding to the maximum of all GPUs.
.TP
.BR \-v ", " \-\-version
Print the version and exit.

.SH INTERACTIVE COMMANDS
.TP
The following commands are available while in nvtop:
.TP
.BR Up
Select (highlight) the previous process.
.TP
.BR Down
Select (highlight) the next process.
.TP
.BR Left\ /\ Right
Scroll in the process row.
.TP
.BR +
Sort increasingly.
.TP
.BR -
Sort decreasingly.
.TP
.BR F1
"Kill" process: Select a signal to send to the highlighted process.
.TP
.BR F2
Sort: Select the field for sorting. The current sort field is highlighted inside the header bar.
.TP
.BR F3 ", " q ", " Esc
Quit.

.SH BUGS
.TP
.BR "Some fields are shown as N/A"
Ask NVIDIA for better support of your hardware!
.TP
.BR "Compatibility issues"
Does not work with nouveau driver stack and older NVIDIA GPU for the time being.
.SH AUTHOR
Written by Maxime Schmitt.
