1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
|
# iotop
Is your Linux server too slow or load is too high? One of the possible
causes of such symptoms may be high IO (input/output) waiting time,
which basically means that some of your processes need to read or write
to a hard drive while it is too slow and not ready yet, serving data for
some other processes.
Common practice is to use iostat -x in order to find out which block
device (hard drive) is slow, but this information is not always helpful.
It could help you much more if you knew which process reads or writes
the most data from your slow disk, so you could renice it using ionice
or even kill it.
iotop identifies processes that use high amount of input/output requests
on your machine. It is similar to the well known top utility, but
instead of showing you what consumes CPU the most, it lists
processes by their IO usage. Inspired by iotop Python script from
Guillaume Chazarain, rewritten in C by Vyacheslav Trushkin and improved
by Boian Bonev so it runs without Python at all.
iotop is licensed GPL-2.0+
[](https://repology.org/project/iotop-c/versions)
## Sample screenshot
## How to install from binary package
Many Linux distributions already include this program under the name iotop-c.
If your distribution is relatively new, chances are that it already has iotop packaged. Follow these instructions.
In case it is not available, follow the [How to build from source](#how-to-build-from-source) instructions.
<details>
<summary>Debian/Devuan/Ubuntu/other derivatives</summary>
Use the following command (note that `-y` disables confirmation prompts):
sudo apt install iotop-c -y
</details>
<details>
<summary>Fedora</summary>
Use the following command (note that `-y` disables confirmation prompts):
sudo dnf install iotop-c -y
</details>
<details>
<summary>CentOS 7/CentOS 8/RHEL 7/RHEL 8/RHEL 9</summary>
Use the following commands (note that `-y` disables confirmation prompts):
sudo yum install epel-release -y
sudo yum install iotop-c -y
</details>
<details>
<summary>Void Linux</summary>
Use the following command:
sudo xbps-install iotop-c
</details>
<details>
<summary>Arch Linux</summary>
Use the following command:
sudo pacman -S iotop-c
</details>
## How to build from source
Please note that the installation and the usage of this program require root access.
<details>
<summary>Debian/Devuan/Ubuntu/other derivatives</summary>
Use the following commands (note that `-y` disables confirmation prompts):
apt install git build-essential libncurses-dev libncursesw5-dev pkg-config -y
git clone https://github.com/Tomas-M/iotop
cd iotop
make -j
</details>
<details>
<summary>Fedora</summary>
Use the following commands (note that `-y` disables confirmation prompts):
dnf install git gcc make ncurses-devel pkgconfig -y
git clone https://github.com/Tomas-M/iotop
cd iotop
make -j
</details>
<details>
<summary>CentOS 8/RHEL 8/RHEL 9</summary>
Use the following commands (note that `-y` disables confirmation prompts):
yum install git gcc make ncurses-devel pkgconfig -y
git clone https://github.com/Tomas-M/iotop
cd iotop
make -j
</details>
<details>
<summary>CentOS 7/RHEL 7</summary>
*Note:* On CentOS 7/RHEL 7 `gcc` does not support `-Wdate-time` and needs a `-Wno-strict-overflow` to suppress a pile of bogus warnings.
Use the following commands (note that `-y` disables confirmation prompts):
yum install git gcc make ncurses-devel pkgconfig -y
git clone https://github.com/Tomas-M/iotop
cd iotop
sed -i 's/-Wdate-time/-Wno-strict-overflow/' Makefile
make -j
</details>
<details>
<summary>Void Linux</summary>
Use the following commands:
xbps-install git base-devel ncurses-devel
git clone https://github.com/Tomas-M/iotop
cd iotop
make -j
</details>
### How to install as a system command
sudo make install
### How to update to latest version
cd iotop && git checkout master && git pull && make clean && make -j
## Options
-v, --version show program's version number and exit
-h, --help show this help message and exit
-H, --help-type=TYPE set type of interactive help (none, win or inline)
-o, --only only show processes or threads actually doing I/O
--no-only show all processes or threads
-b, --batch non-interactive mode
-n NUM, --iter=NUM number of iterations before ending [infinite]
-d SEC, --delay=SEC delay between iterations [1 second]
-p PID, --pid=PID processes/threads to monitor [all]
-u USER, --user=USER users to monitor [all]
-P, --processes only show processes, not all threads
--threads show all threads
-a, --accumulated show accumulated I/O instead of bandwidth
--no-accumulated show bandwidth
-A, --accum-bw show accumulated bandwidth
--no-accum-bw show last iteration bandwidth
-k, --kilobytes use kilobytes instead of a human friendly unit
--no-kilobytes use human friendly unit
-t, --time add a timestamp on each line (implies --batch)
-c, --fullcmdline show full command line
--no-fullcmdline show program names only
-1, --hide-pid hide PID/TID column
--show-pid show PID/TID column
-2, --hide-prio hide PRIO column
--show-prio show PRIO column
-3, --hide-user hide USER column
--show-user show USER column
-4, --hide-read hide DISK READ column
--show-read show DISK READ column
-5, --hide-write hide DISK WRITE column
--show-write show DISK WRITE column
-6, --hide-swapin hide SWAPIN column
--show-swapin show SWAPIN column
-7, --hide-io hide IO column
--show-io show IO column
-8, --hide-graph hide GRAPH column
--show-graph show GRAPH column
-9, --hide-command hide COMMAND column
--show-command show COMMAND column
-g TYPE, --grtype=TYPE set graph data source (io, r, w, rw and sw)
-R, --reverse-graph reverse GRAPH column direction
--no-reverse-graph do not reverse GRAPH column direction
-q, --quiet print column names only on the first run (implies --batch)
a second -q will also suppress the first run column names
a third -q will suppress the I/O summary
-x, --dead-x show exited processes/threads with letter x
--no-dead-x show exited processes/threads with background
-e, --hide-exited hide exited processes
--show-exited show exited processes
-l, --no-color do not colorize values
--color colorize values
-T, --hide-time hide current time
--show-time show current time
--si use SI units of 1000 when printing values
--no-si use non-SI units of 1024 when printing values
--threshold=1..10 threshold to switch to next unit
--ascii disable using Unicode
--unicode use Unicode drawing chars
-N, --inverse use inverse interface (black on white)
--filter=REGEX filter processes by TID and COMMAND
-W, --write write preceding options to the config and exit
## Contribute
iotop was originally written by Vyacheslav Trushkin in 2014, distributed by Tomas Matejicek and later improved by Boian Bonev.
iotop is maintaned on GitHub at https://github.com/Tomas-M/iotop
The preferred way to contribute to the project is to file a pull request at GitHub.
Contacts of current maintainers are:
- Tomas Matejicek <[tomas@slax.org](mailto:tomas@slax.org)>
- Boian Bonev <[bbonev@ipacct.com](mailto:bbonev@ipacct.com)>
The iotop community gathers in #iotop on libera.chat:
- ircs://irc.libera.chat:6697/#iotop
- https://web.libera.chat/#iotop
Notable contributions (ordered by time of last contribution):
- Miko Larsson <[mikoxyzzz@gmail.com](mailto:mikoxyzzz@gmail.com)> - Control-flow integrity (CFI) fixes and testing
- Christian Heusel <[christian@heusel.eu](mailto:christian@heusel.eu)> - Arch Linux packaging and testing
- Leah Neukirchen <[leah@vuxu.org](mailto:leah@vuxu.org)> - Void Linux packaging and testing
- Vitaly Chikunov <[vt@altlinux.org](mailto:vt@altlinux.org)> - ALT Linux packaging and testing
- Matteo Bernardini <[ponce@slackbuilds.org](mailto:ponce@slackbuilds.org)> - SlackBuilds packaging and testing
- Jonathan Papineau <[jonathan@jontech.app](mailto:jonathan@jontech.app)> - OpenSUSE packaging and testing
- Vladi Belperchinov-Shabanski <[cade@noxrun.com](mailto:cade@noxrun.com)> - Scroller code improvement, multiple reviews and ideas
- Alexander Monakov <[amonakov@ispras.ru](mailto:amonakov@ispras.ru)> - Improvement of ncurses color handling
- Alexander Rezvov <[alex@rezvov.ru](mailto:alex@rezvov.ru)> - NixOS packaging and testing
- EinProfiSpieler - README.md, build system improvements
- Paul Wise <[pabs@debian.org](mailto:pabs@debian.org)> - Debian packaging, man page, multiple reviews and ideas
- Rumen Jekov <[rvjekov@gmail.com](mailto:rvjekov@gmail.com)> - Arch Linux packaging and testing
- Milan P. Stanić <[mps@arvanta.net](mailto:mps@arvanta.net)> - Alpine Linux packaging and testing
- Arthur Zamarin <[arthurzam+gentoo@gmail.com](mailto:arthurzam+gentoo@gmail.com)> - Gentoo packaging and testing
- Yuriy M. Kaminskiy <[yumkam@gmail.com](mailto:yumkam@gmail.com)> - Code fixes and improvements
- alicektx <[alicekot13@gmail.com](mailto:alicekot13@gmail.com)> - Documentation improvements
- Filip Kofron <[filip.kofron.cz@gmail.com](mailto:filip.kofron.cz@gmail.com)> - Build system improvements
**Thanks!** This project is what it is now because the steam you have put into it
*NB. In case you have contributed to the project and do not see your name in the list, please note that the above list is updated manually and it is an omission - notify the maintainers to fix it.*
|