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 about 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

ACTIONS

23       ceph-conf performs one of the following actions:
24
25       -L, --list-all-sections
26              list all sections in the configuration file.
27
28       -l, --list-sections *prefix*
29              list   the   sections   with  the  given  prefix.  For  example,
30              --list-sections mon would list all sections beginning with mon.
31
32       --lookup *key*
33              search and print  the  specified  configuration  setting.  Note:
34              --lookup is the default action. If no other actions are given on
35              the command line, we will default to doing a lookup.
36
37       -h, --help
38              print a summary of usage.
39

OPTIONS

41       -c *conffile*
42              the Ceph configuration file.
43
44       --filter-key *key*
45              filter section list to only  include  sections  with  given  key
46              defined.
47
48       --filter-key-value *key* ``=`` *value*
49              filter   section  list  to  only  include  sections  with  given
50              key/value pair.
51
52       --name *type.id*
53              the Ceph name  in  which  the  sections  are  searched  (default
54              'client.admin').   For  example, if we specify --name osd.0, the
55              following sections will be searched: [osd.0], [osd], [global]
56
57       -r, --resolve-search
58              search for the first file that exists and can be opened  in  the
59              resulted comma delimited search list.
60
61       -s, --section
62              additional  sections  to search.  These additional sections will
63              be searched before the sections that would normally be searched.
64              As always, the first matching entry we find will be returned.
65

EXAMPLES

67       To find out what value osd 0 will use for the "osd data" option:
68
69          ceph-conf -c foo.conf  --name osd.0 --lookup "osd data"
70
71       To find out what value will mds a use for the "log file" option:
72
73          ceph-conf -c foo.conf  --name mds.a "log file"
74
75       To list all sections that begin with "osd":
76
77          ceph-conf -c foo.conf -l osd
78
79       To list all sections:
80
81          ceph-conf -c foo.conf -L
82
83       To print the path of the "keyring" used by "client.0":
84
85          ceph-conf --name client.0 -r -l keyring
86

FILES

88       /etc/ceph/$cluster.conf, ~/.ceph/$cluster.conf, $cluster.conf
89
90       the Ceph configuration files to use if not specified.
91

AVAILABILITY

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

SEE ALSO

98       ceph(8),
99

101       2010-2014,  Inktank Storage, Inc. and contributors. Licensed under Cre‐
102       ative Commons BY-SA
103
104
105
106
107dev                            October 30, 2018                   CEPH-CONF(8)
Impressum