[PATCH 1/2] doc: Add section about changing config values

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Signed-off-by: Colin McCabe <colin.mccabe@xxxxxxxxxxxxx>
---
 doc/dev/config.rst |   15 ++++++++++++++-
 1 files changed, 14 insertions(+), 1 deletions(-)

diff --git a/doc/dev/config.rst b/doc/dev/config.rst
index 59f1b92..a4fdb49 100644
--- a/doc/dev/config.rst
+++ b/doc/dev/config.rst
@@ -51,7 +51,7 @@ There are a few different metavariables:
  - $name: expands to $type.$id
 
 
-Interfacing with the Configuration Management System
+Readin configuration values
 ====================================================
 
 There are two ways for Ceph code to get configuration values. One way is to
@@ -75,3 +75,16 @@ The observer method should be preferred in new code because
 
 For these reasons, reading directly from g_conf should be considered deprecated
 and not done in new code.  Do not ever alter g_conf.
+
+Changing configuration values
+====================================================
+
+Configuration values can be changed by calling g_conf->set_val. After changing
+the configuration, you should call g_conf->apply_changes to re-run all the
+affected configuration observers. For convenience, you can call
+g_conf->set_val_or_die to make a configuration change which you think should
+never fail.
+
+Injectargs, parse_argv, and parse_env are three other functions which modify
+the configuration. Just like with set_val, you should call apply_changes after
+calling these functions to make sure your changes get applied.
-- 
1.7.2.5

--
To unsubscribe from this list: send the line "unsubscribe ceph-devel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [CEPH Users]     [Ceph Large]     [Information on CEPH]     [Linux BTRFS]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]
  Powered by Linux