ioreplay(1) IO traces replayer


ioreplay [OPERATION] -f <file> [OPTIONS]


Replicates all IO syscalls defined in file by -f option.

ioreplay is primary used to replicate recorded IO system calls. In order to do that, several other helper functionality exists.

Usage: ioreplay -c -f <file> [-F <format>] [-o <out>] [-v]

converts <file> in format <format> to binary form into file <out>

Usage: ioreplay -S -f <file> [-v]

displays some statistics about syscalls recorded in <file> (must be in strace format)

Usage: ioreplay -P -f <file> [-F <format>] [-v]

prints syscalls in normalized format

Usage: ioreplay -C -f <file> [-F <format>] [-i <file>] [-m <file>] [-v]

checks whether local enviroment is ready for replaying traces recorded in <file>.

Usage: ioreplay -r -f <file> [-F <format>] [-t <mode>] [-s <factor>] [-b <number>] [-i <file>] [-m <file>] [-v]

replicates traces recorded in <file>. Use -C prior to running this.
-b --bind <number>
bind replicating process to processor number <number>
-c --convert
file to binary form, see also -o
-C --check
checks that all operations recorded in the file specied by -f will succeed (ie. will result in same return code). It takes -i and -m into account. See also -p.
-d --dont-fix
turns off fixing of missing system calls (uncomplete strace output support)
-f --file <file>
sets filename to <file>
-F --format <fmt>
specifies input format of the file. Options: strace, bin. Check README for details. Default is strace.
-h --help
prints this message
-i --ignore <file>
sets file containing names which we should not touch during replaying. I.e. no syscall operation will be performed on given file.
-m --map <file>
sets containing file names mapping. When opening file, if there is mapping for it, it will open mapped file instead. See README for more information.
-o --output <file>
output filename when converting. Default: strace.bin.
-p --prepare
will prepare all files accesses recorded in file specified by -f, so every IO operation will return with same exit code as in original application. See also -i and/or -m parameters. Do nothing at the moment.
-P --print
prints recorded syscalls in normalized format regardless the format in which are the syscalls stored now
-r --replicate
will replicate every operation stored in file specified by -f
-s --scale <factor> scales delays between calls by the factor <factor>. Used with -r.
-S --stats
generate stats when processing the file. Can be combined with other options.
-t --timing
sets timing mode for replication. Options available: diff - default mode. makes sure that gaps between calls are the same as in the original run. asap - makes calls one just after another. exact - makes sure that calls are (approximately) done in the same time as in the original run
(relative from start of the application)
-v --verbose be more verbose (do nothing at the moment)
-V --version prints version and exits.


Written by Jiri Horky, 2010-2013


Copyright © 2010 Jiri Horky <[email protected]>

License GPLv2: GNU GPL version 2 <>
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.