OS Manuals

/usr/bin/ceph-bluestore-tool

Ceph OSD (Object Storage Daemon)

From ceph-fips-18-osd 18.2.8-r9 (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'/'bluefs-db'
  --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

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,
                         set-label-key, rm-label-key, prime-osd-dir,
                         bluefs-log-dump, free-dump, free-score,
                         free-fragmentation, bluefs-stats, reshard,
                         show-sharding
Options (20)
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
-klabel metadata key namehelp
-vlabel metadata valuehelp
--allocator argallocator to inspect: 'block'/'bluefs-wal'/'bluefs-db'help + man
--sharding argnew sharding to applyhelp
--resharding-ctrl arggives control over resharding procedure detailshelp + man
--op arg--command alias, ignored if the latter is presenthelp
--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.