--- iotop-1.22/iotop.8 +++ iotop-1.22/iotop.8 @@ -1,28 +1,28 @@ -.TH IOTOP "8" "July 8, 2022" +.TH IOTOP-C "8" "July 8, 2022" .SH NAME -iotop \- simple top\-like I/O monitor +iotop-c \- simple top\-like I/O monitor .SH SYNOPSIS .B iotop [\fIOPTIONS\fR] .SH DESCRIPTION -\fBiotop\fR watches I/O usage information available in the Linux kernel +\fBiotop-c\fR watches I/O usage information available in the Linux kernel (requires 2.6.20 or later) and displays a table of current I/O usage by processes or threads on the system. At least the CONFIG_TASK_DELAY_ACCT, CONFIG_TASK_IO_ACCOUNTING, CONFIG_TASKSTATS and CONFIG_VM_EVENT_COUNTERS options need to be enabled in your Linux kernel build configuration. .PP -Running \fBiotop\fR as non\-root user is possible by adding the NET_ADMIN +Running \fBiotop-c\fR as non\-root user is possible by adding the NET_ADMIN capability. This can be done by e.g.: .RS .B -$ sudo setcap 'cap_net_admin+eip' /iotop +$ sudo setcap 'cap_net_admin+eip' /iotop-c .RE Be warned that this will also allow other users to run it and get access to information that normally should not be available to them. .PP -\fBiotop\fR displays columns for the I/O bandwidth read and written by each +\fBiotop-c\fR displays columns for the I/O bandwidth read and written by each process/thread during the sampling period. It also displays the percentage of time the thread/process spent while swapping in and while waiting on I/O. For each process, its I/O priority (class/level) is shown. @@ -137,16 +137,16 @@ to be numeric are used as numeric .TP \fB\-P\fR, \fB\-\-processes\fR -Only show processes. Normally \fBiotop\fR shows processes and all threads +Only show processes. Normally \fBiotop-c\fR shows processes and all threads .TP \fB\-a\fR, \fB\-\-accumulated\fR -Show accumulated I/O instead of bandwidth. In this mode, \fBiotop\fR shows the -amount of I/O processes have done since \fBiotop\fR started +Show accumulated I/O instead of bandwidth. In this mode, \fBiotop-c\fR shows the +amount of I/O processes have done since \fBiotop-c\fR started .TP \fB\-k\fR, \fB\-\-kilobytes\fR Use kilobytes instead of a human friendly unit. -This mode is useful when scripting the batch mode of \fBiotop\fR. Instead of -choosing the most appropriate unit \fBiotop\fR will display all sizes in +This mode is useful when scripting the batch mode of \fBiotop-c\fR. Instead of +choosing the most appropriate unit \fBiotop-c\fR will display all sizes in kilobytes .TP \fB\-t\fR, \fB\-\-time\fR @@ -361,7 +361,7 @@ character under the cursor. .RE .SH ENVIRONMENT -As per the recommendation of \fBhttps://www.no-color.org/\fR iotop honors the +As per the recommendation of \fBhttps://www.no-color.org/\fR iotop-c honors the contents of the environment variable \fBNO_COLOR\fR and when it is set to a non empty string, all color output is suppressed. .SH SEE ALSO --- iotop-1.22/Makefile +++ iotop-1.22/Makefile @@ -93,8 +93,8 @@ $(E) STRIP $(TARGET) $(Q)$(STRIP) $(TARGET) $(E) INSTALL $(TARGET) - $(Q)$(INSTALL) -D -m 0755 $(TARGET) $(PREFIX)/sbin/$(TARGET) - $(Q)$(INSTALL) -D -m 0644 iotop.8 $(PREFIX)/share/man/man8/iotop.8 + $(Q)$(INSTALL) -D -m 0755 $(TARGET) $(PREFIX)/sbin/$(TARGET)-c + $(Q)$(INSTALL) -D -m 0644 iotop.8 $(PREFIX)/share/man/man8/iotop-c.8 uninstall: $(E) UNINSTALL $(TARGET)