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)