OS Manuals

/usr/bin/ceph-conf

Common utilities to mount and interact with a Ceph storage cluster

From ceph-fips-18-common 18.2.8-r9 (enterprise-packages), captured 2026-11-09 by running ceph-conf --help (exit 0) · terse output. permalink

did not load config file, using default settings.
2026-11-09T14:33:20.181+0000 7f673b44b040 -1 Errors while parsing config file!
2026-11-09T14:33:20.181+0000 7f673b44b040 -1 can't open ceph.conf: (2) No such file or directory
2026-11-09T14:33:20.181+0000 7f673b44b040 -1 Errors while parsing config file!
2026-11-09T14:33:20.181+0000 7f673b44b040 -1 can't open ceph.conf: (2) No such file or directory
Ceph configuration query tool

USAGE
ceph-conf <flags> <action>

ACTIONS
  -L|--list-all-sections          List all sections
  -l|--list-sections <prefix>     List sections with the given prefix
  --filter-key <key>              Filter section list to only include sections
                                  with given key defined.
  --filter-key-value <key>=<val>  Filter section list to only include sections
                                  with given key/value pair.
  --lookup <key>                  Print a configuration setting to stdout.
                                  Returns 0 (success) if the configuration setting is
                                  found; 1 otherwise.
  -r|--resolve-search             search for the first file that exists and
                                  can be opened in the resulted comma
                                  delimited search list.
  -D|--dump-all                   dump all variables.
  --show-config-value <key>       Print the corresponding ceph.conf value
                                  that matches the specified key. Also searches
                                  global defaults.

FLAGS
  --name name                     Set type.id
  [-s <section>]                  Add to list of sections to search
  [--format plain|json|json-pretty]
                                  dump variables in plain text, json or pretty
                                  json
  [--pid <pid>]                   Override the $pid when expanding options

If there is no action given, the action will default to --lookup.

EXAMPLES
$ ceph-conf --name mon.0 -c /etc/ceph/ceph.conf 'mon addr'
Find out what the value of 'mon addr' is for monitor 0.

$ ceph-conf -l mon
List sections beginning with 'mon'.

RETURN CODE
Return code will be 0 on success; error code otherwise.
Options (9)
OptionDescriptionSource
--filter-key keyFilter section list to only include sections with given key defined.help + man
--filter-key-value key>=<valFilter section list to only include sections with given key/value pair.help + man
--lookup keyPrint a configuration setting to stdout.help
--show-config-value keyPrint the corresponding ceph.conf value that matches the specified key.help
--name namethe Ceph name in which the sections are searched (default 'client.admin').help + man
-c conffilethe Ceph configuration file. (in the manual page but not in --help)man
--pid pidoverride the $pid when expanding options. (in the manual page but not in --help)man
-r, --resolve-searchsearch for the first file that exists and can be opened in the resulted comma delimited search list. (in the manual page but not in --help)man
-s, --sectionadditional sections to search. (in the manual page but not in --help)man
Examples (5) 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.