From 47073dc19dc26185fea4af165d3e06cc0984590f Mon Sep 17 00:00:00 2001 From: Sage Weil Date: Wed, 10 Jan 2018 10:54:46 -0600 Subject: [PATCH] doc/man/8/ceph-conf: make not about ceph-conf's lack of mon config support Steer people toward the mon explicitly or the --show-config-value option. Signed-off-by: Sage Weil --- doc/man/8/ceph-conf.rst | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/doc/man/8/ceph-conf.rst b/doc/man/8/ceph-conf.rst index 9782e38988ad0..3743813e11931 100644 --- a/doc/man/8/ceph-conf.rst +++ b/doc/man/8/ceph-conf.rst @@ -20,10 +20,23 @@ Synopsis Description =========== -**ceph-conf** is a utility for getting information about a ceph +**ceph-conf** is a utility for getting information from a ceph configuration file. As with most Ceph programs, you can specify which Ceph configuration file to use with the ``-c`` flag. +Note that unlike other ceph tools, **ceph-conf** will *only* read from +config files (or return compiled-in default values)--it will *not* +fetch config values from the monitor cluster. For this reason it is +recommended that **ceph-conf** only be used in legacy environments +that are strictly config-file based. New deployments and tools should +instead rely on either querying the monitor explicitly for +configuration (e.g., ``ceph config get