Writes and reads files that are similar to SAS files in order to measure file I/O throughput on Windows.
Requirements: | When you use the -sgio option, -pagesize must be a multiple of 4K on x86 systems and a multiple of 8K on x64 and IPF systems. |
If the -sgio option is present, then -numpages is required. | |
The filename argument must be the first argument. |
specifies the filename that is read or written and can include the file system path.
-w creates and writes the specified file.
Default | -w |
-seq reads sequentially from the specified file.
Default | -seq |
specifies the size of the file to write or read. For example, n can be 800K, 512K, 5MB, 2GB.
Default | If -filesize is not specified, the default is 1MB. |
specifies the size of the page for the I/O operation. For example, n can be 8K, 64K, 128K.
Default | If -pagesize is not specified, the default is 8K. |
specifies whether Scatter Gather (SGIO) Read and SGIO Write APIs are used for I/O operations. The following options are specific to SGIO:
specifies the number of pages to read or write for each SGIO operation.
specifies that the written pages bypass the file cache.
specifies to write through any intermediate cache and go directly to disk.
c:\m904_win>sasiotest test.out -w SAS I/O Test Utility: v1.0
WARNING: Filesize option not specified. Defaulting to 1 MB filesize. WARNING: Pagesize option not specified. Defaulting to 8K pagesize. Sequentially writing 1048576 bytes to file: test.out with a 8192 pagesize. Write Throughput: 71.100308 MB/Sec.
c:\m904_win>sasiotest test.out -w -pagesize 64k SAS I/O Test Utility: v1.0
WARNING: Filesize option not specified. Defaulting to 1 MB filesize. Sequentially writing 1048576 bytes to file: test.out with a 65536 pagesize. Write Throughput: 72.561777 MB/Sec.
c:\m904_win>sasiotest test.out -w -pagesize 4k -filesize 2M SAS I/O Test Utility: v1.0
Sequentially writing 2097152 bytes to file: test.out with a 4096 pagesize. Write Throughput: 45.795315 MB/Sec.
c:\m904_win>sasiotest test.out -r SAS I/O Test Utility: v1.0
WARNING: Filesize option not specified. Defaulting to 1 MB filesize. WARNING: Pagesize option not specified. Defaulting to 8K pagesize. Sequentially reading 1048576 bytes from file: test.out with a 8192 pagesize. Read Throughput: 258.301703 MB/Sec.
c:\m904_win>sasiotest test.out -r -pagesize 4k -filesize 2M -numpages 2 SAS I/O Test Utility: v1.0
Sequentially reading 2097152 bytes from file: test.out with a 4096 pagesize. Read Throughput: 237.732948 MB/Sec.
c:\m904_win>sasiotest test.out -w -sgio -pagesize 4k -filesize 2G -numpages 256 SAS I/O Test Utility: v1.0
Gather Writing 256 pages - 2 iterations to file: test.out with a 4096 pagesize. Write Throughput: 18.363657 MB/Sec.
c:\m904_win>sasiotest test.out -r -sgio -pagesize 4k -filesize 2G -numpages 256 SAS I/O Test Utility: v1.0
Scatter Reading 256 pages - 2 iterations from file: test.out with a 4096 pagesize. Read Throughput: 33.205119 MB/Sec.