1CEPH-CONF(8)                         Ceph                         CEPH-CONF(8)
2
3
4

NAME

6       ceph-conf - ceph conf file tool
7

SYNOPSIS

9       ceph-conf -c conffile --list-all-sections
10       ceph-conf -c conffile -L
11       ceph-conf -c conffile -l prefix
12       ceph-conf key -s section1 ...
13       ceph-conf [-s section ] [-r] --lookup key
14       ceph-conf [-s section ] key
15
16

DESCRIPTION

18       ceph-conf  is  a utility for getting information from a ceph configura‐
19       tion file. As with most Ceph programs, you can specify which Ceph  con‐
20       figuration file to use with the -c flag.
21
22       Note that unlike other ceph tools, ceph-conf will only read from config
23       files (or return compiled-in default values)--it will not fetch  config
24       values  from  the  monitor  cluster.  For this reason it is recommended
25       that ceph-conf only be used in legacy environments  that  are  strictly
26       config-file  based.   New  deployments and tools should instead rely on
27       either querying the monitor explicitly for  configuration  (e.g.,  ceph
28       config get <daemon> <option>) or use daemons themselves to fetch effec‐
29       tive  config  options  (e.g.,  ceph-osd  -i   123   --show-config-value
30       osd_data).   The  latter option has the advantages of drawing from com‐
31       piled-in defaults (which occasionally  vary  between  daemons),  config
32       files,  and  the  monitor's  config database, providing the exact value
33       that that daemon would be using if it were started.
34

ACTIONS

36       ceph-conf performs one of the following actions:
37
38       -L, --list-all-sections
39              list all sections in the configuration file.
40
41       -l, --list-sections *prefix*
42              list  the  sections  with  the  given   prefix.   For   example,
43              --list-sections mon would list all sections beginning with mon.
44
45       --lookup *key*
46              search  and  print  the  specified  configuration setting. Note:
47              --lookup is the default action. If no other actions are given on
48              the command line, we will default to doing a lookup.
49
50       -h, --help
51              print a summary of usage.
52

OPTIONS

54       -c *conffile*
55              the Ceph configuration file.
56
57       --filter-key *key*
58              filter  section  list  to  only  include sections with given key
59              defined.
60
61       --filter-key-value *key* ``=`` *value*
62              filter  section  list  to  only  include  sections  with   given
63              key/value pair.
64
65       --name *type.id*
66              the  Ceph  name  in  which  the  sections  are searched (default
67              'client.admin').  For example, if we specify --name  osd.0,  the
68              following sections will be searched: [osd.0], [osd], [global]
69
70       -r, --resolve-search
71              search  for  the first file that exists and can be opened in the
72              resulted comma delimited search list.
73
74       -s, --section
75              additional sections to search.  These additional  sections  will
76              be searched before the sections that would normally be searched.
77              As always, the first matching entry we find will be returned.
78

EXAMPLES

80       To find out what value osd 0 will use for the "osd data" option:
81
82          ceph-conf -c foo.conf  --name osd.0 --lookup "osd data"
83
84       To find out what value will mds a use for the "log file" option:
85
86          ceph-conf -c foo.conf  --name mds.a "log file"
87
88       To list all sections that begin with "osd":
89
90          ceph-conf -c foo.conf -l osd
91
92       To list all sections:
93
94          ceph-conf -c foo.conf -L
95
96       To print the path of the "keyring" used by "client.0":
97
98          ceph-conf --name client.0 -r -l keyring
99

FILES

101       /etc/ceph/$cluster.conf, ~/.ceph/$cluster.conf, $cluster.conf
102
103       the Ceph configuration files to use if not specified.
104

AVAILABILITY

106       ceph-conf is part of Ceph, a massively scalable, open-source,  distrib‐
107       uted  storage  system.   Please  refer  to  the  Ceph  documentation at
108       http://ceph.com/docs for more information.
109

SEE ALSO

111       ceph(8),
112
114       2010-2014, Inktank Storage, Inc. and contributors. Licensed under  Cre‐
115       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
116
117
118
119
120dev                              Apr 29, 2019                     CEPH-CONF(8)
Impressum