OS Manuals

/usr/bin/rbd-replay

Common utilities to mount and interact with a Ceph storage cluster

From ceph-19-common 19.2.7-r4 (enterprise-packages), captured 2026-11-08 by running rbd-replay --help (exit 0). permalink

Usage: /usr/bin/rbd-replay --conf=<config_file> <replay_file>
Options:
  -p, --pool-name <pool>          Name of the pool to use.  Default: rbd
  --latency-multiplier <float>    Multiplies inter-request latencies.  Default: 1
  --read-only                     Only perform non-destructive operations.
  --map-image <rule>              Add a rule to map image names in the trace to
                                  image names in the replay cluster.
  --dump-perf-counters            *Experimental*
                                  Dump performance counters to standard out before
                                  an image is closed. Performance counters may be dumped
                                  multiple times if multiple images are closed, or if
                                  the same image is opened and closed multiple times.
                                  Performance counters and their meaning may change between
                                  versions.

Image mapping rules:
A rule of image1@snap1=image2@snap2 would map snap1 of image1 to snap2 of
image2.
Options (6)
OptionDescriptionSource
-p, --pool-name, --pool poolInteract with the given pool.help + man
--latency-multiplier floatMultiplies inter-request latencies.help + man
--read-onlyOnly perform non-destructive operations.help + man
--map-image ruleAdd a rule to map image names in the trace to image names in the replay cluster.help + man
--dump-perf-counters*Experimental* Dump performance counters to standard out before an image is closed.help + man
-c, --conf ceph.confUse ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to determine monitor addresses during startup. (in the manual page but not in --help)man
Examples (2) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.