diff options
author | 2021-05-09 14:20:58 -0400 | |
---|---|---|
committer | 2021-05-09 14:20:58 -0400 | |
commit | 5fd83771641d15c418f747bd343ba6738d3875f7 (patch) | |
tree | 5abf0f78f680d9837dbd93d4d4c3933bb7509599 /system_cmds/iosim.tproj/iosim.1 | |
download | apple_cmds-5fd83771641d15c418f747bd343ba6738d3875f7.tar.gz apple_cmds-5fd83771641d15c418f747bd343ba6738d3875f7.tar.zst apple_cmds-5fd83771641d15c418f747bd343ba6738d3875f7.zip |
Import macOS userland
adv_cmds-176
basic_cmds-55
bootstrap_cmds-116.100.1
developer_cmds-66
diskdev_cmds-667.40.1
doc_cmds-53.60.1
file_cmds-321.40.3
mail_cmds-35
misc_cmds-34
network_cmds-606.40.1
patch_cmds-17
remote_cmds-63
shell_cmds-216.60.1
system_cmds-880.60.2
text_cmds-106
Diffstat (limited to 'system_cmds/iosim.tproj/iosim.1')
-rw-r--r-- | system_cmds/iosim.tproj/iosim.1 | 100 |
1 files changed, 100 insertions, 0 deletions
diff --git a/system_cmds/iosim.tproj/iosim.1 b/system_cmds/iosim.tproj/iosim.1 new file mode 100644 index 0000000..a3e8719 --- /dev/null +++ b/system_cmds/iosim.tproj/iosim.1 @@ -0,0 +1,100 @@ +.\" Copyright (c) 2013, Apple Inc. All rights reserved. +.\" +.Dd Oct 9, 2013 +.Dt IOSIM 1 +.Sh NAME +.Nm iosim +.Nd A performance tool to simulate I/O workloads. +.Sh SYNOPSIS +.Pp +.Nm iosim +.Ar -c <number> +Burst Count. No. of I/Os performed in an I/O burst. +Default Value: 10 +Valid Range: [0, INT_MAX] +.Pp +.Nm iosim +.Ar -i <msecs> +Inter Burst Duration. Amount of time each thread sleeps between bursts (-1 indicates random durations between 0-100 msecs) +Default Value: 0 +Valid Range: [-1, INT_MAX] +.Pp +.Nm iosim +.Ar -d <msecs> +Inter I/O delay. Amount of time thread sleeps between issuing I/Os +Default Value: 0 +Valid Range: [0, INT_MAX] +.Pp +.Nm iosim +.Ar -t <number> +Thread count +Default Value: 1 +Valid Range: [0, 1000] +.Pp +.Nm iosim +.Ar -f <number> +Workload Type (0/1/2 : Read-Only/Write-Only/Mixed RW) +Default Value: 0 +Valid Range: [0, 2] +.Pp +.Nm iosim +.Ar -m <number> +I/O Pattern (0/1 : Sequential/Random) +Default Value: 0 +Valid Range: [0, 1] +.Pp +.Nm iosim +.Ar -j <bytes> +Size of I/O in bytes +Default Value: 4096 +Valid Range: [0, INT_MAX] +.Pp +.Nm iosim +.Ar -s <msecs> +Frequency of sync() calls +Default Value: 5000 +Valid Range: [0, INT_MAX] +.Pp +.Nm iosim +.Ar -l <number> +I/O Tier (0/1/2/3) +Default Value: 0 +Valid Range: [0, 3] +.Pp +.Nm iosim +.Ar -z <number> +Size of the file created specified in pages (Only used when the file is being created by the tool) +Default Value: 1 GB +Valid Range: [0, INT_MAX] +.Pp +.Nm iosim +.Ar -x <secs> +Test duration (0 indicates that the tool would wait for a Ctrl-C) +Default Value: 0 +Valid Range: [0, INT_MAX] +.Pp +.Nm iosim +.Ar -a number +I/O Caching behavior (0/1 : Non-cached/Cached) +Default Value: 0 +Valid Range: [0, 1] +.Pp +.Nm iosim +.Ar -n <filename> +Filename for I/Os (If this option is not specified, the tool would create files on its own) +Valid Range: Valid filename +.Sh DESCRIPTION +The +.Nm iosim +tool allows simulating workloads for I/O performance evaluation. The tool spawns 'n' threads which issue non-cached I/Os. If specified, it also creates a sync thread which issues system wide sync() calls to flush data and metadata to disk (emulates launchd behavior). The I/Os are issued at the specified I/O tier and the tool reports latency and throughput numbers. +.P +.nf +Following is an explanation of the results: +Avg. Latency : Avg. latency experienced by the I/Os. +Low Latency Histogram: Frequency distribution of I/O latency for low latency I/Os. +Latency Histogram: Frequency distribution of I/O latency. +Burst Avg. Latency Histogram: Frequency distribution of burst avg. latency. +Throughput timeline: Time windowed throughput distrbution. +.fi +.Sh SEE ALSO +.Xr fs_usage 1 |