perf/Documentation/perf-iostat.txt

1 perf-iostat(1)
5 ----
6 perf-iostat - Show I/O performance metrics
9 --------
12 'perf iostat' <ports> \-- <command> [<options>]
15 -----------
18 - Inbound Read   - I/O devices below root port read from the host memory, in MB
20 - Inbound Write  - I/O devices below root port write to the host memory, in MB
22 - Outbound Read  - CPU reads from I/O devices below root port, in MB
24 - Outbound Write - CPU writes to I/O devices below root port, in MB
27 -------
32 	List all PCIe root ports.
34 <ports>::
35 	Select the root ports for monitoring. Comma-separated list is supported.
38 --------
40 1. List all PCIe root ports (example for 2-S platform):
43    S0-uncore_iio_0<0000:00>
44    S1-uncore_iio_0<0000:80>
45    S0-uncore_iio_1<0000:17>
46    S1-uncore_iio_1<0000:85>
47    S0-uncore_iio_2<0000:3a>
48    S1-uncore_iio_2<0000:ae>
49    S0-uncore_iio_3<0000:5d>
50    S1-uncore_iio_3<0000:d7>
52 2. Collect metrics for all PCIe root ports:
54    $ perf iostat -- dd if=/dev/zero of=/dev/nvme0n1 bs=1M oflag=direct
56    357707+0 records out
71 3. Collect metrics for comma-separated list of PCIe root ports:
73    $ perf iostat 0000:17,0:3a -- dd if=/dev/zero of=/dev/nvme0n1 bs=1M oflag=direct
75    357707+0 records out
87 --------
88 linkperf:perf-stat[1]