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 ] --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 will perform one of the following actions:

--list-all-sections or -L prints out a list of all the section names in the configuration file.

--list-sections or -l prints out a list of all the sections that begin with a given prefix. For example, --list-sections mon would list all sections beginning with mon.

--lookup will search the configuration for a given value. By default, the sections that are searched are determined by the Ceph name that we are using. The Ceph name defaults to client.admin. It can be specified with --name.

For example, if we specify --name osd.0, the following sections will be searched: [osd.0], [osd], [global]

You can specify additional sections to search with --section or -s. 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.

Note: --lookup is the default action. If no other actions are given on the command line, we will default to doing a lookup.


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


ceph-conf is part of the Ceph distributed storage system. Please refer to the Ceph documentation at for more information.

RELATED TO ceph-conf…


2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA