OS Manuals

/usr/bin/ceph-bluestore-tool

Ceph OSD (Object Storage Daemon)

From ceph-19-osd 19.2.7-r4 (enterprise-packages), captured 2026-11-08 by running ceph-bluestore-tool --help (exit 0). permalink

All options:

Options:
  -h [ --help ]                   produce help message
  -i arg                          OSD instance. Requires access to
                                  monitor/ceph.conf
  --path arg                      bluestore path
  --data-path arg                 --path alias, ignored if the latter is
                                  present
  --out-dir arg                   output directory
  --input-file arg                import file
  --dest-file arg                 destination file
  -l [ --log-file ] arg           log file
  --log-level arg                 log level (30=most, 20=lots, 10=some,
                                  1=little)
  --dev arg                       device(s)
  --devs-source arg               bluefs-dev-migrate source device(s)
  --dev-target arg                target/resulting device
  --deep arg                      deep fsck (read all data)
  -k [ --key ] arg                label metadata key name
  -v [ --value ] arg              label metadata value
  --allocator arg                 allocator to inspect: 'block'/'bluefs-wal'/'b
                                  luefs-db'
  --yes-i-really-really-mean-it   additional confirmation for dangerous
                                  commands
  --sharding arg                  new sharding to apply
  --resharding-ctrl arg           gives control over resharding procedure
                                  details
  --op arg                        --command alias, ignored if the latter is
                                  present
  --offset arg                    disk location

Positional options:
  --command arg                   fsck, qfsck, allocmap, restore_cfb, repair,
                                  quick-fix, bluefs-export, bluefs-import,
                                  bluefs-bdev-sizes, bluefs-bdev-expand,
                                  bluefs-bdev-new-db, bluefs-bdev-new-wal,
                                  bluefs-bdev-migrate, show-label,
                                  show-label-at, set-label-key, rm-label-key,
                                  prime-osd-dir, bluefs-super-dump,
                                  bluefs-log-dump, free-dump, free-score,
                                  free-fragmentation, bluefs-stats, reshard,
                                  show-sharding, zap-device
Options (22)
OptionDescriptionSource
-hproduce help messagehelp
-i argOperate as OSD osd_id.help + man
--path argSpecify an osd path.help + man
--data-path arg--path alias, ignored if the latter is presenthelp
--out-dir argOutput directory for bluefs-exporthelp + man
--input-file argimport filehelp
--dest-file argdestination filehelp
-l, --log-file logfile to log tohelp + man
--log-level arglog level (30=most, 20=lots, 10=some, 1=little)help + man
--dev argAdd device to the list of devices to considerhelp + man
--devs-source argAdd device to the list of devices to consider as sources for migrate operationhelp + man
--dev-target argSpecify target device migrate operation or device to add for adding new DB/WAL.help + man
--deep argdeep scrub/repair (read and validate object data, not just metadata)help + man
-k, --key keyLabel field or metadata key name.help + man
-v, --value valueValue to store for the key named by --key.help + man
--allocator argallocator to inspect: 'block'/'bluefs-wal'/'b luefs-db'help + man
--yes-i-really-really-mean-itadditional confirmation for dangerous commandshelp
--sharding argnew sharding to applyhelp
--resharding-ctrl arggives control over resharding procedure detailshelp + man
--op arg--command alias, ignored if the latter is presenthelp
--offset argdisk locationhelp
--command argfsck, qfsck, allocmap, restore_cfb, repair, quick-fix, bluefs-export, bluefs-import, bluefs-bdev-sizes, bluefs-bdev-expand, bluefs-bdev-new-db, bluefs-bdev-new-wal, bluefs-bdev-migrate, show-label,…help

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