Scroll to navigation



ceph-conf - ceph conf file tool


ceph-conf -c conffile --list-all-sections
ceph-conf -c conffile -L
ceph-conf -c conffile -l prefix
ceph-conf key -s section1 ...
ceph-conf [-s section ] [-r] --lookup key
ceph-conf [-s section ] key


ceph-conf is a utility for getting information about a ceph configuration file. As with most Ceph programs, you can specify which Ceph configuration file to use with the -c flag.


ceph-conf performs one of the following actions:
-L, --list-all-sections
list all sections in the configuration file.

-l, --list-sections *prefix*
list the sections with the given prefix. For example, --list-sections mon would list all sections beginning with mon.

--lookup *key*
search and print the specified configuration setting. Note: --lookup is the default action. If no other actions are given on the command line, we will default to doing a lookup.

-h, --help
print a summary of usage.


-c *conffile*
the Ceph configuration file.

--filter-key *key*
filter section list to only include sections with given key defined.

--filter-key-value *key* ``=`` *value*
filter section list to only include sections with given key/value pair.

--name **
the Ceph name in which the sections are searched (default 'client.admin'). For example, if we specify --name osd.0, the following sections will be searched: [osd.0], [osd], [global]

-r, --resolve-search
search for the first file that exists and can be opened in the resulted comma delimited search list.

-s, --section
additional sections to search. These additional sections will be searched before the sections that would normally be searched. As always, the first matching entry we find will be returned.


To find out what value osd 0 will use for the "osd data" option:

ceph-conf -c foo.conf  --name osd.0 --lookup "osd data"

To find out what value will mds a use for the "log file" option:

ceph-conf -c foo.conf  --name mds.a "log file"

To list all sections that begin with "osd":

ceph-conf -c foo.conf -l osd

To list all sections:

ceph-conf -c foo.conf -L

To print the path of the "keyring" used by "client.0":

ceph-conf --name client.0 -r -l keyring


/etc/ceph/$cluster.conf, ~/.ceph/$cluster.conf, $cluster.conf

the Ceph configuration files to use if not specified.


ceph-conf is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at for more information.




2010-2019, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
March 3, 2019 dev