162306a36Sopenharmony_ciperf-iostat(1) 262306a36Sopenharmony_ci=============== 362306a36Sopenharmony_ci 462306a36Sopenharmony_ciNAME 562306a36Sopenharmony_ci---- 662306a36Sopenharmony_ciperf-iostat - Show I/O performance metrics 762306a36Sopenharmony_ci 862306a36Sopenharmony_ciSYNOPSIS 962306a36Sopenharmony_ci-------- 1062306a36Sopenharmony_ci[verse] 1162306a36Sopenharmony_ci'perf iostat' list 1262306a36Sopenharmony_ci'perf iostat' <ports> \-- <command> [<options>] 1362306a36Sopenharmony_ci 1462306a36Sopenharmony_ciDESCRIPTION 1562306a36Sopenharmony_ci----------- 1662306a36Sopenharmony_ciMode is intended to provide four I/O performance metrics per each PCIe root port: 1762306a36Sopenharmony_ci 1862306a36Sopenharmony_ci- Inbound Read - I/O devices below root port read from the host memory, in MB 1962306a36Sopenharmony_ci 2062306a36Sopenharmony_ci- Inbound Write - I/O devices below root port write to the host memory, in MB 2162306a36Sopenharmony_ci 2262306a36Sopenharmony_ci- Outbound Read - CPU reads from I/O devices below root port, in MB 2362306a36Sopenharmony_ci 2462306a36Sopenharmony_ci- Outbound Write - CPU writes to I/O devices below root port, in MB 2562306a36Sopenharmony_ci 2662306a36Sopenharmony_ciOPTIONS 2762306a36Sopenharmony_ci------- 2862306a36Sopenharmony_ci<command>...:: 2962306a36Sopenharmony_ci Any command you can specify in a shell. 3062306a36Sopenharmony_ci 3162306a36Sopenharmony_cilist:: 3262306a36Sopenharmony_ci List all PCIe root ports. 3362306a36Sopenharmony_ci 3462306a36Sopenharmony_ci<ports>:: 3562306a36Sopenharmony_ci Select the root ports for monitoring. Comma-separated list is supported. 3662306a36Sopenharmony_ci 3762306a36Sopenharmony_ciEXAMPLES 3862306a36Sopenharmony_ci-------- 3962306a36Sopenharmony_ci 4062306a36Sopenharmony_ci1. List all PCIe root ports (example for 2-S platform): 4162306a36Sopenharmony_ci 4262306a36Sopenharmony_ci $ perf iostat list 4362306a36Sopenharmony_ci S0-uncore_iio_0<0000:00> 4462306a36Sopenharmony_ci S1-uncore_iio_0<0000:80> 4562306a36Sopenharmony_ci S0-uncore_iio_1<0000:17> 4662306a36Sopenharmony_ci S1-uncore_iio_1<0000:85> 4762306a36Sopenharmony_ci S0-uncore_iio_2<0000:3a> 4862306a36Sopenharmony_ci S1-uncore_iio_2<0000:ae> 4962306a36Sopenharmony_ci S0-uncore_iio_3<0000:5d> 5062306a36Sopenharmony_ci S1-uncore_iio_3<0000:d7> 5162306a36Sopenharmony_ci 5262306a36Sopenharmony_ci2. Collect metrics for all PCIe root ports: 5362306a36Sopenharmony_ci 5462306a36Sopenharmony_ci $ perf iostat -- dd if=/dev/zero of=/dev/nvme0n1 bs=1M oflag=direct 5562306a36Sopenharmony_ci 357708+0 records in 5662306a36Sopenharmony_ci 357707+0 records out 5762306a36Sopenharmony_ci 375083606016 bytes (375 GB, 349 GiB) copied, 215.974 s, 1.7 GB/s 5862306a36Sopenharmony_ci 5962306a36Sopenharmony_ci Performance counter stats for 'system wide': 6062306a36Sopenharmony_ci 6162306a36Sopenharmony_ci port Inbound Read(MB) Inbound Write(MB) Outbound Read(MB) Outbound Write(MB) 6262306a36Sopenharmony_ci 0000:00 1 0 2 3 6362306a36Sopenharmony_ci 0000:80 0 0 0 0 6462306a36Sopenharmony_ci 0000:17 352552 43 0 21 6562306a36Sopenharmony_ci 0000:85 0 0 0 0 6662306a36Sopenharmony_ci 0000:3a 3 0 0 0 6762306a36Sopenharmony_ci 0000:ae 0 0 0 0 6862306a36Sopenharmony_ci 0000:5d 0 0 0 0 6962306a36Sopenharmony_ci 0000:d7 0 0 0 0 7062306a36Sopenharmony_ci 7162306a36Sopenharmony_ci3. Collect metrics for comma-separated list of PCIe root ports: 7262306a36Sopenharmony_ci 7362306a36Sopenharmony_ci $ perf iostat 0000:17,0:3a -- dd if=/dev/zero of=/dev/nvme0n1 bs=1M oflag=direct 7462306a36Sopenharmony_ci 357708+0 records in 7562306a36Sopenharmony_ci 357707+0 records out 7662306a36Sopenharmony_ci 375083606016 bytes (375 GB, 349 GiB) copied, 197.08 s, 1.9 GB/s 7762306a36Sopenharmony_ci 7862306a36Sopenharmony_ci Performance counter stats for 'system wide': 7962306a36Sopenharmony_ci 8062306a36Sopenharmony_ci port Inbound Read(MB) Inbound Write(MB) Outbound Read(MB) Outbound Write(MB) 8162306a36Sopenharmony_ci 0000:17 358559 44 0 22 8262306a36Sopenharmony_ci 0000:3a 3 2 0 0 8362306a36Sopenharmony_ci 8462306a36Sopenharmony_ci 197.081983474 seconds time elapsed 8562306a36Sopenharmony_ci 8662306a36Sopenharmony_ciSEE ALSO 8762306a36Sopenharmony_ci-------- 8862306a36Sopenharmony_cilinkperf:perf-stat[1] 89