usage: rados [options] [commands] POOL COMMANDS lspools list pools cppool copy content of a pool purge --yes-i-really-really-mean-it remove all objects from pool without removing the pool itself df show per-pool and total usage ls list objects in pool POOL SNAP COMMANDS lssnap list snaps mksnap create snap rmsnap remove snap OBJECT COMMANDS get [--offset offset] fetch object with start offset (default:0) put [--offset offset] write object with start offset (default:0) append append object truncate length truncate object create create object rm ... [--force-full] remove object(s), --force-full forces remove when cluster is full cp [target-obj] copy object listxattr list attrs of this object getxattr get the attribute of this object setxattr attr val rmxattr attr stat stat the named object stat2 stat2 the named object (with high precision time) touch [timestamp] change the named object modification time mapext rollback roll back object to snap listsnaps list the snapshots of this object bench write|seq|rand [-t concurrent_operations] [--no-cleanup] [--run-name run_name] [--no-hints] [--reuse-bench] default is 16 concurrent IOs and 4 MB ops default is to clean up after write benchmark default run-name is 'benchmark_last_metadata' seconds can be numeral or 'max' cleanup [--run-name run_name] [--prefix prefix] clean up a previous benchmark operation default run-name is 'benchmark_last_metadata' load-gen [options] generate load on the cluster listomapkeys list the keys in the object map listomapvals list the keys and vals in the object map getomapval [file] show the value for the specified key in the object's object map setomapval rmomapkey remove key from the object map of clearomap [obj-name2 obj-name3...] clear all the omap keys for the specified objects getomapheader [file] dump the hexadecimal value of the object map header of setomapheader set the value of the object map header of watch add watcher on this object notify notify watcher of this object with message listwatchers list the watchers of this object set-alloc-hint set allocation hint for an object set-redirect --target-pool [--with-reference] set redirect target set-chunk --target-pool [--with-reference] convert an object to chunked object tier-promote promote the object to the base tier unset-manifest unset redirect or chunked object tier-flush flush the chunked object tier-evict evict the chunked object IMPORT AND EXPORT export [filename] Serialize pool contents to a file or standard out. import [--dry-run] [--no-overwrite] < filename | - > Load pool contents from a file or standard in ADVISORY LOCKS lock list List all advisory locks on an object lock get [--lock-cookie locker-cookie] [--lock-tag locker-tag] [--lock-description locker-desc] [--lock-duration locker-dur] [--lock-type locker-type] Try to acquire a lock lock break [--lock-cookie locker-cookie] Try to break a lock acquired by another client lock info Show lock information options: --lock-tag Lock tag, all locks operation should use the same tag --lock-cookie Locker cookie --lock-description Description of lock --lock-duration Lock duration (in seconds) --lock-type Lock type (shared, exclusive) SCRUB AND REPAIR: list-inconsistent-pg list inconsistent PGs in given pool list-inconsistent-obj list inconsistent objects in given PG list-inconsistent-snapset list inconsistent snapsets in the given PG CACHE POOLS: (for testing/development only) cache-flush flush cache pool object (blocking) cache-try-flush flush cache pool object (non-blocking) cache-evict evict cache pool object cache-flush-evict-all flush+evict all objects cache-try-flush-evict-all try-flush+evict all objects GLOBAL OPTIONS: --object-locator object_locator set object_locator for operation -p pool --pool=pool select given pool by name --target-pool=pool select target pool by name --pgid PG id select given PG id -f [--format plain|json|json-pretty] --format=[--format plain|json|json-pretty] -b op_size set the block size for put/get ops and for write benchmarking -O object_size set the object size for put/get ops and for write benchmarking --max-objects set the max number of objects for write benchmarking --obj-name-file file use the content of the specified file in place of --omap-read-start-after set the start_after parameter for OMAP list benchmarking --omap-read-filter-prefix set the filter_prefix parameter for OMAP list benchmarking --omap-read-max-return set the max number of entries for OMAP list benchmarking -s name --snap name select given snap name for (read) IO --input-file file use the content of the specified file in place of --create create the pool or directory that was specified -N namespace --namespace=namespace specify the namespace to use for the object --all Use with ls to list objects in all namespaces Put in CEPH_ARGS environment variable to make this the default --default Use with ls to list objects in default namespace Takes precedence over --all in case --all is in environment --target-locator Use with cp to specify the locator of the new object --target-nspace Use with cp to specify the namespace of the new object --striper Use radostriper interface rather than pure rados Available for stat, get, put, truncate, rm, ls and all xattr related operations BENCH OPTIONS: -t N --concurrent-ios=N Set number of concurrent I/O operations --show-time prefix output with date/time --no-verify do not verify contents of read objects --object | --write-object (deprecated) read or write contents to the objects --omap | --write-omap (deprecated) read or write contents to the omap --xattr | write-xattr (deprecated) read or write contents to the extended attributes LOAD GEN OPTIONS: --num-objects total number of objects --min-object-size min object size --max-object-size max object size --min-op-len min io size of operations --max-op-len max io size of operations --max-ops max number of operations --max-backlog max backlog size --read-percent percent of operations that are read --target-throughput target throughput (in bytes) --run-length total time (in seconds) --offset-align at what boundary to align random op offsets CACHE POOLS OPTIONS: --with-clones include clones when doing flush or evict OMAP OPTIONS: --omap-key-file file read the omap key from a file GENERIC OPTIONS: --conf/-c FILE read configuration from the given configuration file --id ID set ID portion of my name --name/-n TYPE.ID set name --cluster NAME set cluster name (default: ceph) --setuser USER set uid to user or uid (and gid to user's gid) --setgroup GROUP set gid to group or gid --version show version and quit