NAME

       ioreplay - IO traces replayer

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 <jiri.horky@gmail.com>

       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.

SEE ALSO

       ioprofiler(1)

ioreplay v1.4-r2, part of IOapps                  November 2013                                      IOREPLAY(1)