---
name: "ioreplay"
section: "1"
platform: "linux"
package: "ioapps"
version: "1.4r2-3"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/ioreplay"
---

# ioreplay(1)

IO traces replayer

## 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)**