BIND 10 master, updated. f5cc3a37a155b140b4187a98028c1b8a5f79f9b9 [master] update docstring for ModuleCCSession
BIND 10 source code commits
bind10-changes at lists.isc.org
Wed Jun 29 20:06:58 UTC 2011
The branch, master has been updated
via f5cc3a37a155b140b4187a98028c1b8a5f79f9b9 (commit)
from 31bde63b8fae57143dd02d9db4798aa254494c77 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit f5cc3a37a155b140b4187a98028c1b8a5f79f9b9
Author: Jelte Jansen <jelte at isc.org>
Date: Wed Jun 29 22:06:26 2011 +0200
[master] update docstring for ModuleCCSession
mainly to add an explanation for handle_logging_config
-----------------------------------------------------------------------
Summary of changes:
src/lib/python/isc/config/ccsession.py | 21 ++++++++++++++++++---
1 files changed, 18 insertions(+), 3 deletions(-)
-----------------------------------------------------------------------
diff --git a/src/lib/python/isc/config/ccsession.py b/src/lib/python/isc/config/ccsession.py
index 0869160..bff4f58 100644
--- a/src/lib/python/isc/config/ccsession.py
+++ b/src/lib/python/isc/config/ccsession.py
@@ -142,14 +142,29 @@ class ModuleCCSession(ConfigData):
callbacks are called when 'check_command' is called on the
ModuleCCSession"""
- def __init__(self, spec_file_name, config_handler, command_handler, cc_session = None, handle_logging_config = False):
+ def __init__(self, spec_file_name, config_handler, command_handler, cc_session=None, handle_logging_config=False):
"""Initialize a ModuleCCSession. This does *NOT* send the
specification and request the configuration yet. Use start()
for that once the ModuleCCSession has been initialized.
- specfile_name is the path to the specification file
+
+ specfile_name is the path to the specification file.
+
config_handler and command_handler are callback functions,
see set_config_handler and set_command_handler for more
- information on their signatures."""
+ information on their signatures.
+
+ cc_session can be used to pass in an existing CCSession,
+ if it is None, one will be set up. This is mainly intended
+ for testing purposes.
+
+ handle_logging_config: if True, the module session will
+ automatically handle logging configuration for the module;
+ it will read the system-wide Logging configuration and call
+ the logger manager to apply it. It will also inform the
+ logger manager when the logging configuration gets updated.
+ The module does not need to do anything except intializing
+ its loggers, and provide log messages
+ """
module_spec = isc.config.module_spec_from_file(spec_file_name)
ConfigData.__init__(self, module_spec)
More information about the bind10-changes
mailing list