From 33b16fd04d9491d1e81432d29e518b12fef80517 Mon Sep 17 00:00:00 2001
From: Ilya Dryomov <idryomov@gmail.com>
Date: Sat, 26 Feb 2022 12:53:18 +0100
Subject: [PATCH] doc: document "ceph config get <who> <option>"

... and note the confusing asymmetry with "ceph config set <who>
<option> <value>".

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
---
 doc/rados/configuration/ceph-conf.rst | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/doc/rados/configuration/ceph-conf.rst b/doc/rados/configuration/ceph-conf.rst
index 3e11bcc19ab05..a4a7df17ce1d8 100644
--- a/doc/rados/configuration/ceph-conf.rst
+++ b/doc/rados/configuration/ceph-conf.rst
@@ -457,12 +457,17 @@ Commands
 
 The following CLI commands are used to configure the cluster:
 
-* ``ceph config dump`` will dump the entire configuration database for
-  the cluster.
+* ``ceph config dump`` will dump the entire monitors' configuration
+  database for the cluster.
 
-* ``ceph config get <who>`` will dump the configuration for a specific
-  daemon or client (e.g., ``mds.a``), as stored in the monitors'
-  configuration database.
+* ``ceph config get <who>`` will dump configuration options stored in
+  the monitors' configuration database for a specific daemon or client
+  (e.g., ``mds.a``).
+
+* ``ceph config get <who> <option>`` will show a configuration value
+  stored in the monitors' configuration database for a specific daemon
+  or client (e.g., ``mds.a``), or, if not present in the monitors'
+  configuration database, the compiled-in default value.
 
 * ``ceph config set <who> <option> <value>`` will set a configuration
   option in the monitors' configuration database.
@@ -482,6 +487,11 @@ The following CLI commands are used to configure the cluster:
   *output file*.  This command is useful for transitioning from legacy
   configuration files to centralized monitor-based configuration.
 
+Note that ``ceph config set <who> <option> <value>`` and ``ceph config get
+<who> <option>`` aren't symmetric because the latter also shows compiled-in
+default values.  In order to determine whether a configuration option is
+present in the monitors' configuration database, use ``ceph config dump``.
+
 
 Help
 ====
-- 
2.39.5