SYNOPSIS

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

DESCRIPTION

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.

AUTHOR

Written by Jiri Horky, 2010-2013

COPYRIGHT

Copyright © 2010 Jiri Horky <[email protected]>

License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

RELATED TO ioreplay…

ioprofiler(1)